Введение

Продолжаем третью часть статьи по графическому индикатору WG12864B-YGH-VN, в которой научимся выводит отдельно символы и целые строки.

Напишем программу по выводу символа на экран.



Результатом выполнения программы будет слово test:

Первый результат. Выводим символ



Функция принимает 4 параметра:

character – код символа по кодировке ASCII. Например U – 0x55 (85), 7 – 0x73 (55). Эти коды можно посмотреть, открыв таблицу символов Windows

(нужно выбрать из списка набор символов строчку Windows: кириллица и в строке состояния посмотреть hex код символа).

x, y – координаты вывода одного символа. Это означает, в каком месте экрана будет выведен один символ.
Inv – инвертирование вывода символа.
          • Если inv = 0, то темный символ на светлом фоне.
          • Если inv = 255, то светлый символ на темном фоне.

Полный код функции:



Мы знаем что дисплей WG12864B-YGH-VN имеет два контроллера и соответственно два полуэкрана. В область полуэкрана 64*64 можно вывести 10 символов. Однако есть нюанс: последний символ приходится на границу полуэкрана. Чтобы исключить данный нюанс, нужно сделать так, чтобы символ выводился от левого края с небольшим отступом, например, 4 точки. Этот вариант организован в функции goto_xy:



x, y – Указываем координаты вывода символа.

Как видно, функция принимает 2 аргумента и возвращает результат: в каком полуэкране выводить символы.

Полный код функции:



В операторе if(){}else{} проверяем, если х<10, то переменной cs присваивается значение 0, переменной textcs присваивается 0, в противном случае переменной cs присваивается значение 1, переменной textcs присваивается 64. Вся основная расчетная математика является аргументом функции glcd_xy, которую рассматривали ранее.



Это часть кода позволяет автоматически переходить на новую строку по мере заполнения. Я думаю объяснения не нужны...

Основным элементом функции является оператор цикла с постусловием do{}while();, в котором происходит взаимодействие функции write_data_glcd с двухмерным массивов символов charsets[160][6]:



Он эквивалентен такой записи:



Разберемся, как функция взаимодействует с двухмерным массивом, в котором содержатся символы, цифры, латиница и кирилица.

Немного вспомним или освоим, что же такое многомерный массив. Это массив массивов, т.е. массив, элементами которого являются массивы. Размерность массива – это количество индексов, используемых для ссылки на конкретный элемент массива. Двухмерный массив charsets, который содержится в заголовочном файле GenerateCode.h содержит 160 индексов, указывающих на массивы из 6-ти элементов по 1 байту:

Первым индексом массива является символ пробела, потом восклицательный знак и т.д. Как оговаривалось выше, все символы Windows имеют кодировку ASCII. Для того, чтобы связать массив символов с кодировкой Win-символов используются два оператора if с проверкой диапазона кода символа:



Если код Win-символа меньше 0х7F, то от переменной character вычитаем число 0х20 и получаем индекс массива charsets. В следующем операторе проверяем если код Win-символа больше 0хBF, то от переменной character вычитаем число 0х60 и получаем индекс массива charsets:

- Charsets = 0x48 (72),   значит будем вычитать 0х20 (32), и в итоге получим число 40   – индекс массива символа H (англ.)
- Charsets = 0xE5 (229), значит будем вычитать 0х60 (96), и в итоге получим число 133 – индекс массива символа е (русс.)

по коду:



Как видно, совершенно не сложно, простое вычисление чисел.

Второй результат. Выводим строки

Поскольку мы разобрались как выводить символ, разберемся как выводить строку.
Основная программа по выводу строковой информации на экран:

Ну а теперь собственно функции по выводу строки:



Названия putsf, puts, putchar взял из стандартной библиотеки LCD.H CodeVisionAVR, т.к. они более привычны глазу.

Функция вывода строки, аргументом которой является непосредственно текст записанный в ковычках:



str[] – массив, который будет проинициализирован текстом. Тип flash указывает, что символы массива будут помещены компилятором во flash память микроконтроллера.
x, y – координаты вывода строки. Это означает, в какого места экрана будет выведена строка.
Inv – инвертирование вывода строки.

Полный код функции:



Немного Си теории

В Си/С++, в отличие от многих других языков, отсутствует специальный строковый тип. Вместо этого строки представляются как массив типа char, в конце которого помещен символ "\0" или нуль-терминатор. В этом случае массив называется строкой в формате ASCII (ASCII строка). При объявлении массива, под строку необходимо предусмотреть место для нуль-терминатора, которым заканчивается любая строка. Пример объявления строкового массива:



при такой инициализации массива, нуль-терминатор указывается символом конца строки.



При такой инициализации массива, текст, помещенный в кавычки, будет рассматриваться как строка, и поэтому компилятор автоматически добавит нуль-терминатор. Исходя из данного определения строкового массива, воспользуемся нуль-терминатором для определения конца строки. Например функция glcd_putsf с текстом:



В этом случае массив в flash char str[] будет проинициализирован 12-ю символами букв + 13-й символ нуль - терминатор:



Раз массив определяется в формате ASCII, то по сути каждый символ букв, будет представлен кодом:



по элементу массива:



Рассмотрим смысл работы функции glcd_putsf. Основным элементом функции является оператор цикла с постусловием:



Весь процесс работы цикла состоит в том, что переменной k присваивается значение элементов массива str, которые выбираются по инкременту переменной j. Оператор if проверяет, не содержит ли переменная k нуль-терминатор (0х00). Если содержит, то прерывается цикл do{}while(); оператором break. Все коды символов кроме \0, которые содержала переменная k, передаются в функцию glcd_putchar, пока выполняется цикл.

Функция вывода строки, аргументом которой является переменная:



*str – переменная типа указатель на объект символьного типа char, которая хранит адрес элемента памяти.

Компилятор выделит память как для строки, так и для размещения значения указателя. например, записать можно так:



или так



x, y – координаты вывода строки.
Inv – инвертирование вывода строки.

Полный код функции:



Пример вывода строк, которые заполняют весь экран графического индикатора. Конечно получается некрасиво, но это только для наглядности: