Существует перечислимый тип font_names, задающий символические имена для номеров пяти графических шрифтов (один матричный и четыре векторных из минимального набора):

enum font_names

{

DEFAULT_FONT=0, TRIPLEX_FONT, SMALL_FONT, SANS_SERIF_FONT, GOTHIC_FONT

};

Наиболее простым способом инициализации знакогенератора (загрузки определенной таблицы символов) является автоматическая загрузка с использованием функции

void far settextstyle(int font,int directon,int charsize);

Функция устанавливает основные параметры вывода графических текстов (шрифт, направление строк и размер символа). Эти параметры остаются неизменными до следующего вызова функции settextstyle.

Первый параметр font задает номер инициализируемого шрифта. Ему можно присвоить значение одной из констант перечислимого типа font_names. Набор символов матричного шрифта встроен в BIOS, и от функции не требуется дополнительных действий при его загрузке. Для векторных шрифтов при автоматической загрузке производится поиск соответствующего chr-файла. Сначала просматривается директория, указанная аргументом path_to_bgi функции initgraph, затем текущая директория. Если файл шрифта не найден, устанавливается отрицательный код ошибки. Найденный chr-файл считывается в автоматически выделяемую область памяти. При невозможности выделить необходимую память также устанавливается соответствующий код ошибки. При возникновении любой ошибочной ситуации функция settextstyle выполняется до конца, но инициализирует при этом встроенный матричный шрифт вместо заданного векторного шрифта.

Аргумент direction может принимать одно из значений, определенное константами HORIZ_DIR и VERT_DIR. Он задает направление выводимой строки текста: HORIZ_DIR определяет обычное направление (горизонтальная строка, символы идут слева направо), VERT_DIR разворачивает строку на 90 градусов против часовой стрелки. Использование вертикального расположения строки может привести к изменению пропорций выводимых символов - они становятся ниже и шире, чем в горизонтальной строке, что связано с эффектом “неквадратности” пикселя в некоторых дисплеях и никак неустранимо.

Последний аргумент charsize управляет масштабом выводимых символов. Диапазон допустимых значений: от 1 до 10 для всех графических шрифтов и дополнительное значение 0 только для векторных. Положительное значение charsize указывает на одинаковое увеличение символов по обеим осям. Если для векторных шрифтов задать charsize, равный USER_CHAR_SIZE (определена как 0), то при этом определяются два независимых коэффициента масштабирования - для ширины и высоты символа. По умолчанию в этом режиме знакогенератор рисует символы векторного шрифта в базовом варианте в соответствии с описанием из chr-файла. Однако есть возможность изменить масштаб с помощью функции

void far setusercharsize(int mult_x,int div_x,int mult_y,int div_y);

Данная функция устанавливает новые размеры символа, умножая ширину и высоту базового варианта каждого символа на значения выражения ((double)mult_x / div_x) и ((double)mult_y / div_y) соответственно.

Главным недостатком автоматической инициализации знакогенератора при помощи функции settextstyle является то, что она обращается к диску для чтения chr-файла во время выполнения программы. Альтернативой автоматической инициализации знакогенератора является статическое включение в программу таблицы символов векторных шрифтов. Для этого сначала нужно при помощи утилиты bgiobj.exe превратить chr-файлы в объектные файлы c расширением .obj. Затем их можно включить в программу как обычные объектные файлы.

Перед статической инициализацией знакогенератора необходима регистрация нужной таблицы векторных шрифтов, для чего предусмотрена функция, которой нужно передать местоположение в оперативной памяти таблицы символов шрифта:

int registerbgifont(void (*font)(void));

В качестве указателей используются имена, уже определенные в объектных файлах шрифтов. Ниже приведены описания тех имен, которые нужно употреблять для шрифтов из минимального набора:

void triplex_font(void);

void small_font(void);

void sansserif_font(void);

void gothic_font(void);

При успешной регистрации шрифта возвращаемое значение неотрицательно. Далее для инициализации знакогенератора используется функция settextstyle с необходимыми установками для шрифта. Тогда в присутствии на диске chr-файла отпадает всякая необходимость.

Графическая система позволяет позиционировать на странице видеопамяти выводимый текст с точностью до пикселя, для этого функциям вывода текста нужно некоторую опорную точку. Расположением выводимой строки относительно опорной точки управляет функция

void far settextjustify(int horiz,int vert);

Ее аргументы могут принимать значения констант перечислимого типа text_just:

enum text_just

{

LEFT_TEXT=0, CENTER_TEXT, RIGHT_TEXT,

BOTTOM_TEXT, TOP_TEXT

};

В случае ошибки функция settextjustify устанавливает код ошибки, равный -11, и сохраняет предыдущий режим позиционирования.

Позиционирование горизонтальных строк происходит следующим образом. Если представить прямоугольник, в который вписана выводимая строка, то пара аргументов horiz и vert описывают положение опорной точки в прямоугольнике.

При инициализации графического режима опорная точка всех строк располагается в левом верхнем углу прямоугольника, в который вписывается горизонтальная строка.

В позиционировании вертикальных строк имеются некоторые особенности. Нужно помнить, что функция settextjustify управляет размещением относительно опорной точки именно прямоугольника, содержащего текст. Из этого следует, что по отношению к самому тексту (поскольку он повернут на 90 градусов) позиционирование справа и слева от опорной точки определяется аргументом vert, а сверху или снизу - аргументом horiz. Аргумент vert обрабатывается так же, как и для горизонтальной строки. Аргумент horiz ведет себя по-другому. При значениях LEFT_TEXT и RIGHT_TEXT он дает одинаковый результат - текстовый прямоугольник располагается слева от опорной точки.

В графической библиотеке существует функция, позволяющая получить информацию о текущем режиме вывода графических текстовых сообщений:

void far gettextsettings(struct textsettingstype far *texttypeinfo);

Информация заносится в область памяти, выделенную в программе и содержащую следующую структуру:

struct textsettingstype

{

int font,direction,charsize;

int horiz,vert;

};

Для правильного размещения текста на странице необходимо знать размеры занимаемого им пространства, которое зависит от типа шрифта и его масштабирования. Эту информацию выдают функции:

int far textheight(char far *text_string);

int far textwidth(char far *text_string);

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

При своей работе функции вывода текста создают в видеопамяти рисунок символов строки, используя таблицу выбранного шрифта. Код, который при этом заносится в атрибуты пикселей, есть текущее значение рисующего цвета (номер входа во внутреннюю палитру), устанавливаемое функцией setcolor. Никаких битовых операций с атрибутами пикселей видеопамяти не предусмотрено. Линии, которыми рисуются символы векторных шрифтов, всегда сплошные тонкие, они не могут модифицироваться функцией setlinestyle.

В отличие от текстового режима, фон выводимых символов (цвет прямоугольника, в который вписана строка) не изменяется. Если нужно вывести строку на каком-либо фоне, то фон нужно нарисовать отдельно, например с помощью функции bar. Другим важным отличием графического режима от текстового является отсутствие режима мигания символа. Можно имитировать процесс мигания, управляя внутренней палитрой с помощью функции setpalette.

Функций вывода текста две:

void far outtext(char far *text_string);

void far outtextxy(int x,int y,char far *text_string);

Обе в качестве аргумента получают указатель на выводимую строку символов. Отличие между этими функциями состоит в выборе опорной точки при позиционировании сообщения на странице. Функция outtext использует для этого текущую графическую позицию. Функция outtextxy получает координаты опорной точки через аргументы x и y. Координаты задаются в системе координат текущего графического окна. При установке режима отсечения изображения за пределами окна обе функции также обеспечивают отсечение фрагментов текста, выходящего за пределы графического окна.

Страницы: 1, 2, 3, 4, 5, 6