void far setwritemode(int mode);
Аргумент этой функции должен принимать значение 0 (простое копирование кода атрибута пикселя в видеопамять) и 1 (операция “исключающее или”).
Функция
void far setlinestyle(int line_style,unsigned user_pattern,int thickness);устанавливает характер и толщину линий геометрических объектов. Аргумент thickness воздействует на контурные графические примитивы, а аргументы line_style и user_pattern – только на кусочно-линейные.
Аргумент thickness принимает значения NORM_WIDTH (толщина равна 1 пиксель) и THICK_WIDTH (толщина равна 3 пикселям). Аргумент linestyle задает характер рисуемой линии. Значения аргумента должны выбираться из констант перечислимого типа line_styles (например SOLID_LINE означает сплошную линию):
enum line_styles{SOLID_LINE=0,DOTTED_LINE,CENTER_LINE,DASHED_LINE,USERBIT_LINE};Если значение аргумента line_style равно USERBIT_LINE, то это значит, что при построении кусочно-линейных примитивов будет использоваться шаблон, заданный программистом и переданный функции setlinestyle при помощи аргумента user_pattern. С помощью шаблона можно задать периодически повторяющийся рисунок линии с периодом до 16 пикселей. Если некоторый бит шаблона user_pattern равен 1, то соответствующий пиксель линии рисуется, в противном случае – нет.
Установки, сделанные при помощи функции setlinestyle, сохраняются до нового ее вызова. Для выяснения текущей установки характеристик линий предусмотрена функция
void far getlinesettingstype(struct linesettingstype far *line_info);Данная функция заносит информацию в структуру, имеющую описание
struct linesettingstype{int linestyle;unsigned upattern;int thickness;}Группа площадных графических функций имеет прототипы:
void far bar(int left, int top, int right, int bottom);void far bar3d(int left, int top, int right, int bottom, int depth, int top_flag);void far fillpoly(int num_points, int far *poly_points);void far fillellipse(int x, int y, int x_radius, int y_radius);void far pieslice(int x, int y, int start_angle, int end_angle, int radius);void far sector(int x, int y, int start_angle, int end_angle, int x_ radius, int y_radius);void far floodfill(int x, int y, int num_color_palette);Функции bar и bar3d строят прямоугольники, координаты которых заданы первыми четырьмя аргументами функций и закрашивают его внутреннюю область. Функция bar не выводит внешний контур прямоугольника, а функция bar3d дополнительно обрамляет прямоугольник контура и тем же контуром дорисовывает проекцию параллелепипеда, построенного на базе этого прямоугольника. Глубина проекции задается аргументом depth, аргумент top_flag указывает, рисовать (если не нуль) или не рисовать (если нуль) верхние ребра параллелепипеда.
Функция fillpoly получает аргументы аналогично функции drawpoly, рисует контур и заполняет его внутренность. Однако если функция drawpoly допускает незамкнутые контуры, то функция fillpoly всегда соединяет последнюю точку в полученном списке с первой, автоматически замыкая контур.
Функция fillellipse заполняет эллипс с центром в точке (x, y) и радиусами x_radius и y_radius. Кроме того, она рисует контур эллипса.
Функции pieslice и sector похожи тем, что обе закрашивают указанные сектора, только pieslice делает это для кругового сектора, а sector для эллиптического. Аргументы, которые им передаются, те же, что и для функций arc и ellipse соответственно. После того как сектор закрашен, рисуется его контур. В отличие от функций arc и ellipse, функции pieslice и sector строят сектор от меньшего значения угла к большему (а не от start_angle к end_angle). Из-за этого невозможно заставить функции pieslice и sector изобразить сектор, пересекающий положительное направление оси X.
Функция floodfill используется для закрашивания областей, уже существующих на странице. Для правильной работы функции необходимо, чтобы контур был замкнут и состоял из пикселей, имеющих значение атрибута, совпадающее с аргументом num_color_palette (номер входа внутренней палитры). Кроме кода контура, функция floodfill получает точку, от которой начинается заполнение области. Эта точка должна находиться внутри контура.
Все контуры в видеопамяти прописываются пикселями рисующего цвета, который можно изменить функцией setcolor. Желаемый режим изображения контура (например толщина линии) устанавливается так, как это делается для контурных примитивов.
Для управления видом заполнения внутренней области служит функция
void far setfillstyle(int pattern,int num_color_palette);Данная функция одновременно устанавливает тип двумерного шаблона заполнения и код заполнения (номер входа во внутреннюю палитру). Нужно отметить, что при заполнении области нет возможности выполнять побитовые логические операции между кодами шаблона и атрибутами пикселей области, т. е. всегда происходит копирование в атрибуты пикселей области соответствующих кодов шаблона. Аргумент pattern указывает на тип устанавливаемого шаблона. Существует несколько заранее определенных типов, их символические имена определяются перечислимым типом fill_patterns:
enum fill_pattern{EMPTY_FILL=0,SOLID_FILL,LINE_FILL,LTSLASH_FILL,SLASH_FILL,BKSLASH_FILL,LTBKSLASH_FILL,HATCH_FILL,XHATCH_FILL,INTERLEAVE_FILL,WIDE_DOT_FILL, CLOSE_DOT_FILL,USER_FILL};Аргумент pattern может принимать любые значения, кроме USER_FILL. Значение этой константы используется только при обработке информации, получаемой функцией getfillsettings (см. далее).
Шаблон условно можно представить в виде матрицы размером 8 х 8 элементов. Элементы матрицы шаблона имеют значения 0 или 1. Если элемент равен 1, то атрибуту соответствующего пикселя области будет присвоено значение num_color_palette, в противном случае атрибут пикселя получит значение кода фона.
Возможно создание дополнительных шаблонов непосредственно в прикладной программе. Для этого следует воспользоваться функцией
void far setfillpattern(char far *user_pattern,int num_color_palette);Параметр user_patternуказывает на область, содержащую шаблон заполнения, описанный в программе. Второй параметр этой функции аналогичен такому же параметру функции setfillstyle. Данная область состоит из восьми последовательных байтов, цепочка битов каждого байта является соответствующей строкой матрицы шаблона.
Площадные графические примитивы используют параметры заполнения, установленные при последнем вызове функции функций setfillstyle или setfillpatern. Для того чтобы узнать текущие назначения для параметров заполнения областей, предусмотрены две функции
void far getfillsettings(struct fillsettingstype far *fill_info);void far getfillpattern(char far *user_pattern);Первая возвращает в область памяти по указателю fill_info информацию о текущем заполнении. Информация заносится в структуру следующего типа:
struct fillsettingstype{int pattern;int color;};Элемент структуры pattern указывает тип шаблона (если он равен USER_FILL, то это значит, что шаблон задан пользователем), элемент color содержит код заполнения (номер входа во внутреннюю палитру). Вторая функция по переданному ей адресу записывает матрицу шаблона, установленную пользователем.
Следующий набор функций предназначен для формирования на страницах видеопамяти текстовых сообщений с использованием специальных шрифтов.
Чтобы воспользоваться предоставляемыми шрифтами в программе, прежде всего необходимо инициализировать знакогенератор графической системы. Инициализацию графического знакогенератора выполняет функция settextstyle.
В Borland C предусмотрена работа в графическом режиме с двумя принципиально различными типами графических шрифтов: матричными (bit-mapped) и векторными (stroked). Первый тип представляется только одним шрифтом, изначально встроенным в BIOS компьютера. Шрифтов второго типа может быть несколько.
Набор символов матричного шрифта включает все 256 допустимых ASCII-кода. Каждый символ шрифта представлен в виде матрицы (битовой карты) размером 8 х 8 пикселей. Так как этот набор символов встроен в BIOS, то не требуется загрузки никакой дополнительной информации для его инициализации.
Другой принципиально отличный тип графических шрифтов подразумевает рисование символов тонкими линиями. Поэтому шрифты данного типа можно назвать векторными. Каждый символ представлен последовательностью управляющих кодов, которые заставляют генератор рисовать отрезки прямых линий, соединяющих характеристические точки символа. Таблицы символов векторных шрифтов поставляются в закодированном виде в специальных файлах шрифтов, имеющих расширение .chr. Далеко не все векторные шрифты имеют полный набор 256-ти кодов. Общими для всех шрифтов являются символы с кодами от 32 до 126. Разные символы одного и того же шрифта могут иметь разные размеры в зависимости от ширины конкретного символа.
Существует перечислимый тип 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 градусов против часовой стрелки. Использование вертикального расположения строки может привести к изменению пропорций выводимых символов – они становятся ниже и шире, чем в горизонтальной строке, что связано с эффектом “неквадратности” пикселя в некоторых дисплеях и никак неустранимо.