Вывод текста в графическом режиме видеоадаптера

С++ предоставляет пользователю широкие возможности по выводу текстовой информации в графических режимах. Во-первых, это все функции стандартного вывода.

Библиотека графики позволяет выводить на экран текст различными шрифтами. С++ имеет два типа шрифтов: битовый и сегментированный.

Каждому символу битового шрифта (bit-mapped font) ставится в соответствие матрица пикселов фиксированного размера. С++ использует в качестве битового шрифта таблицу знакогенератора для символов размером 8x8, установленную в компьютере перед инициализацией системы графики. Все изменения таблицы знакогенератора, сделанные, например, программами русификации, будут сохранены. Это позволяет, применяя функции, выводить текст русскими буквами и в графических режимах.

Другой тип шрифтов, используемый при выводе текста на экран, фактически задает правило "рисования" каждого символа. Он описывается как совокупность отрезков пря­мых линий, или сегментов. Этим и объясняется название шрифта - сегментированный (stroke font). Программа может задать масштаб для каждого символа, "растягивая" или "сжимая" его по высоте либо ширине. Однако использование сегментированного шрифта для вывода текста несколько замедляет работу видеосистемы.

В С++ доступны четыре сегментированных шрифта: Triplex, Small, Sans-Serif и Gothic. Файлы сегментированных шрифтов располагаются в файлах с расширением.CHR и, подобно.BGI-драйверам, загружаются как оверлеи во время исполнения программы. Библиотека графики дает возможность выводить текст в графических режимах слева направо и снизу вверх. Для вывода символов при использовании любого шрифта может быть задан масштаб знакоместа по от­ношению к знакоместу шрифта 8x8. При использовании сегментированного шрифта может быть задан размер знакоместа и в относительных единицах масштаба как по вертикали, так и по горизонтали. Кроме того, выводимые строки текста могут выравниваться по-разному: строка может быть "прижата" влево и вверх относительно точки, определенной как текущая точка отсчета, влево и вниз и т.п.

Поведение системы графики при выводе текста в графическом режиме задается целой группой значений внутренних переменных. Их текущие установки доступны после вызова функции gettextsettings().

 

void gettextsettings(struct textsettingstype *texttypeinfo)

 

Заполняет поля структурной переменной по шаблону textsettingstype ин­формацией о текущих шрифте, направлении вывода текста, размере знакоме­ста относительно шрифта по умолчанию и способе "прижатия" (выравнивания) шрифта в пределах знакоместа. Функции передается указатель texttypeinfo на описанную структурную переменную. Шаблон textsettingstype описывается в <graphlcs.h> так:

 

struct textsettingstype

{

int font; /* номер шрифта из перечислимого типа font_names[] */

int direction; /* направление вывода текста (гор. или верт.) */

int charsize; /* размер знакоместа относительно шрифта 8x8 */

int horiz; /* код выравнивания по горизонтали (влево, вправо) */

int vert; /* код выравнивания по вертикали (вверх, вниз) */

}

 

Интерпретация отдельных полей структурной переменной по шаблону textsettingstype приведена в описании функции settextstyle().

 

void settextstyle(int font, int direction, int charsize)

 

Выбирает шрифт, устанавливает направление и размер знакоместа для последующего вывода текстовой информации через функции библиотеки графики outtext() и outtextxy(). Значение font выбирает один из шрифтов Turbo С. Возможные типы шрифтов задаются либо целым числом, либо символической константой из перечислимого типа font_names. В табл. 3.4. приведены доступные шрифты, соответствующие им символические константы, числовые значения и имена файлов шрифтов.

 

Табл. 3.4. Шрифты, доступные в С++

Символическая константа из font_names	Зна­чение	Описание шрифта	Имя файла шрифта
DEFAULT FONT TRIPLEX_FONT SMALL_FONT SANS_SERIF_FONT GOTHIC_FONT		Битовый шрифт 8x8 Сегментированный шрифт Triplex Сегментированный шрифт Small Сегментированный шрифт Sans-Serif Сегментированный шрифт Gothic	- TRIP.CHR SMAL.CHR SANS.CHR GОТН.СHR

 

Значение direction позволяет специфицировать направление вывода. Если direction = HORIZ_DIR, текст будет выводиться горизонтально слева направо. Если direction = VERT_DIR, текст будет выводиться вертикально снизу вверх, а символы будут повернуты на 90 градусов против хода часовой стрелки.

Третий аргумент функции - charsize - задает масштаб каждого символа относительно знакоместа 8x8. Если, например, задать charsize равным 5, то символ будет изображаться в знакоместе 40 х 40. Если charsize равен 0, то для битового шрифта размер знакоместа изменяться не будет. Для сегментированного шрифта размер знакоместа будет определяться значениями, установленными функцией setusercharsize().

В случае ошибки функция settextstyle() устанавливает во внутренней пере­менной системы графики соответствующий код ошибки. Он доступен программе через обращение к функции graphresult().

 

Установленные в системе графики значения высоты символа и его ширины можно получить через обращения к функциям textheight() и textwidth().

 

int textheight(char *textstring)

 

Возвращает высоту строки символов в пикселах, на которую указывает textstring. Использует информацию о текущем шрифте и установках масштаба знакоместа. Сама строка, на которую указывает textstring, на экран не выводится. Наиболее часто функция используется для установки нужных промежутков между строками текста, а также при вычислении таких масштабов для символов, которые позволяли бы уместить нужное число строк в фиксированной области экрана.

 

int textwidth (char far *textstring)

 

Возвращает ширину строки символов в пикселах, на которую указывает textstring. Использует информацию о текущем шрифте и установках масштаба знакоместа. Сама строка, на которую указывает textstring, на экран не выводится. Наиболее часто функция используется для установки нужных промежутков между символами текста, а также при вычислении таких масштабов для символов, которые позволяли бы уместить нужное число строк в фиксированной области экрана. В частности, обращение к функции

textwidth("A");

возвращает ширину символа 'А' в пикселах.

 

Еще одна установка системы графики, затрагивающая вывод текста в текстовом режиме, это выравнивание символов. Специальная функция библиотеки графики settextjustify() позволяет изменить установку по умолчанию для выравнивания символов при выводе текста в графических режимах.

 

void far settextjustify(int horiz,int vert)

 

Задает новую установку выравнивания символов текста в графических ре­жимах работы адаптера. Она выполняет выравнивание всей строки символов, выводимой функциями outtext() или outtextxy() относительно некоторой точки, называемой далее точкой отсчета. Координаты точки отсчета задаются либо явно функцией outtextxy(), либо используются текущие значения.

Аргумент horiz может принимать три значения, задаваемых символическими константами: LEFT_TEXT - левая граница строки "прижимается" справа к вертикальной линии, проведенной через точку отсчета; CENTER_TEXT - строка располагается так, что вертикальная линия, проведенная через ее середину, проходит через точку отсчета; RIGHT_ТЕХТ - правая граница строки "прижимается" слева к вертикальной линии, проведенной через точку отсчета.

Аргумент vert также может принимать три значения, задаваемых символиче­скими константами: ВОТТОМ_ТЕХТ - нижняя граница строки "прижимается" сверху к горизонтальной линии, проведенной через точку отсчета; CENTER_TEXT - строка располагается так, что горизонтальная линия, проведенная через ее середину, проходит через точку отсчета; ТОР_ТЕХТ - верхняя граница строки "прижимается" снизу к горизонтальной линии, проведенной через точку отсчета.

 

Отметим, что при выводе текста вертикально установки выравнивания по горизонтали LEFT_TEXT и RIGHT_TEXT не различаются библиотекой графики Turbo С и аналогичны RIGHT_TEXT.

После того, как заданы все необходимые параметры текста, можно выводить ASCII-строки, используя функцию outtext() или outtextxy().

 

void outtext (char *textstring)

 

Выводит ASCII-строку текста, на начало которой указывает textstring, ис­пользуя текущие позицию, цвет и установки направления, типа шрифта и выравнивания строки. В случае, когда текст выводится горизонтально и уста­новлено выравнивание LEFT_TEXT, функция outtext() продвигает координату X текущей позиции на значение, равное textwidth(textstring). В остальных случаях координата X текущей позиции остается неизменной. Если текст выводится в графическое окно с включенным усечением, текст усекается на границах окна. Для сегментированных шрифтов усечение производится с точностью до пикселов, для битовых шрифтов оно происходит с точностью до символа. Усечение строки может выполняться по одной границе или по обеим границам сразу в случае, когда задается выравнивание по центру.

 

void outtextxy (int x, int y, char *textstring)

 

Выводит ASCII-строку текста, на начало которой указывает textstring, ис­пользуя текущие цвет, установки направления, типа шрифта и выравнивания строки. Аргументы х и у явно специфицируют новую текущую позицию, ис­пользуемую для вывода строки. Координаты X и Y измеряются относительно координат левого верхнего угла текущего графического окна. В случае, когда текст выводится горизонтально и установлено выравнивание LEFT_TEXT, функция outtext() продвигает координату X текущей позиции на значение, равное textwidth(textstring). В остальных случаях координата X текущей позиции остается неизменной. Если текст выводится в графическое окно с включенным усечением, он усекается на границах окна. Для сегментированных шрифтов усечение производится с точностью до пикселов, для битовых шрифтов оно происходит с точностью до символа. В случае, когда установлено выравнивание CENTER_TEXT, но выводимая строка не помещается в текущем графическом окне, функция не выполняет вывод.

 

Функции способны выводить только нуль-терминированные строки, и для выполнения форматированного вывода в графических режимах выбранными сегментированными шрифтами поступают следующим образом. Сначала, ис­пользуя функцию стандартного вывода sprintf(), получают нужную форматную строку, а затем выводят ее с помощью функции outtextxy() выбранным шрифтом.