void far setrgbpalette(int num_color,int red,int green,int blue);
Аргумент num_color – номер входа расширенной палитры (0–255), по которому хранятся три цветовые компоненты – красная, зеленая и синяя – составляющие желаемый цвет. Функция позволяет записать по входу расширенной палитры с номером color цветовые компоненты red, green и blue. При этом реально используются только младшие шесть байт каждой компоненты. Таким образом, общее количество цветовых оттенков равно N_colors=64*64*64=256К.
Отметим некоторые особенности использования драйвера VGA. Значения элементов массива colors (кодов цветов) обычной внутренней палитры служат индексами для поиска нужного цвета в расширенной таблице, откуда происходит выбор нужного оттенка цвета.
Заметим, что функция setrgbpalette правильно работает только с дисплейными адаптерами VGA и IBM8514. На других конфигурациях ПК она игнорируется. Кстати, изменить палитру при работе с адаптером IBM8514 можно только при помощи функции setrgbpalette.
Рассмотрим теперь понятие текущего значения рисующего цвета (current drawing color). Рисующий цвет – это то значение, которое используется функциями рисования для записи в атрибуты пикселей. Значение рисующего цвета неотрицательно и не должно превышать значения, возвращаемого функцией getmaxcolor.
Существует функция, позволяющая явно изменять текущее значение рисующего цвета:
void far setcolor(int num_color_palette);При рисовании используется цвет, чей код записан по входу внутренней палитры с номером num_color_palette. Узнать текущее значение рисующего цвета можно при помощи функции
int far getcolor(void);Практически вся работа с графикой сводится к обмену данными между программой и видеобуфером дисплейного адаптера.
Доступ к отдельным пикселям активной страницы осуществляют две функции:
unsigned far getpixel(int x,int y);void far putpixel(int x,int y,int num_color_palette);Функция getpixel возвращает атрибут (вход во внутреннюю палитру) пикселя с координатами (x, y). А функция putpixel рисует пиксель в точке с координатами (x, y) цветом, чей код содержится по входу во внутреннюю палитру с номером num_color_palette.
Несмотря на то, что функциям getpixel и pupixel координаты пикселя задаются в системе координат графического окна, ничто не мешает указать координаты любого пикселя страницы, лежащего вне окна. При этом getpixel возвращает правильное значение атрибута указанного пикселя. Поведение функции putpixel зависит от режима отсечения, установленного с помощью последнего аргумента при вызове функции setviewport. Результаты работы функций getpixel и pupixel с выходящими за пределы страницы координатами точек непредсказуемы.
Кроме обмена с видеопамятью отдельными пикселями графическая библиотека предоставляет возможности для обмена целыми массивами пикселей. Это бывает полезно, например, когда нужно временно сохранить какой-то фрагмент страницы, чтобы в дальнейшем восстановить его на прежнем или новом месте. Обмен производится прямоугольными массивами, которые задаются координатами своих углов в системе координат текущего графического окна.
Прежде чем сохранить фрагмент страницы, необходимо определить требуемый для этого объем оперативной памяти. Все необходимые вычисления производит функция
unsigned far imagesize(int left,int top,int right,int bottom);Она получает в качестве аргументов координаты левого верхнего и правого нижнего угла сохраняемой области. Возвращаемое значение можно передавать одной из функций выделения памяти для резервирования необходимого пространства. Если объем памяти, требуемый для сохранения изображения, превосходит 64К-1, то функция все равно возвращает значение 0xFFFF, но при этом graphresult выдает значение -11.
После резервирования требуемого объема оперативной памяти, он может сохранить массив пикселей с помощью функции
void far getimage(int left,int top,int right,int bottom,void far *bitmap);Последний аргумент – указатель на область памяти, где будет сохраняться массив.
Для того чтобы массив пикселей, сохраненный с помощью функции getimage, снова записать на активную страницу, используется функция
void far putimage(int left, int top, void far *bitmap, int op);При этом можно не только указать новое местоположение массива пикселей (через координаты левого верхнего угла), но и вывести его на другую страницу видеопамяти, предварительно сделав ее активной при помощи функции setactivepage. Последний аргумент функции putimage указывает способ, которым атрибуты пикселей массива, выводимого из оперативной памяти на активную страницу, будут замещать уже находящиеся в видеобуфере значения. В простейшем случае, когда op = 0, происходит простое копирование атрибутов пикселей из памяти в видеопамять. Однако возможно выполнение одной из побитовых логических операций над содержимым оперативной памяти и видеобуфера для каждого пикселя массива. Полный набор таких операций задается перечислимым типом putimage_ops:
enum putimage_ops {COPY_PUT, XOR_PUT, OR_PUT, AND_PUT, NOT_PUT};При работе с функциями getimage и putimage действуют примерно те же правила относительно задаваемых координат, что и для функций getpixel и putpixel: хотя координаты задаются в системе графического окна, можно указать массив пикселей, расположенный в любом месте в пределах активной страницы. Различие между двумя функциями состоит в том, что getimage “схватит” этот массив, а функция putimage выведет массив на страницу так, как если бы никакого графического окна не существовало (т. е. игнорируется режим отсечения).
Если координаты задаваемого массива пикселей (весь массив или его часть) выходят за пределы страницы, то результат работы функций getimage и putimage непредсказуем.
Основное значение графических примитивов – обеспечить наличие программных средств для рисования всевозможных геометрических объектов. Условно можно разбить все графические примитивы по типу рисуемых ими графических объектов на две группы: контурные и площадные. Функции первой группы рисуют всевозможные контурные линии. Ко второй группе относятся функции, предназначенные для рисования геометрических фигур с закрашиванием ограничиваемых ими областей.
К группе контурных графических примитивов относятся функции:
void far line(int x1,int y1,int x2,int y2);void far linerel(int dx,int dy);void far lineto(int x,int y);void far rectangle(int left,int top,int right,intbottom);void far drawpoly(int num_points,int far *poly_points);void far circle(int x,int y,int radius);void far arc(int x,int y,int start_angle,int end_angle,int radius);void far ellipse(int x,int y, int start_angle,int end_angle,int x_radius,int y_radius);Первые пять рисуют кусочно-линейные объекты (в том числе и фигуры, составленные из отрезков прямых), остальные – кривые второго порядка (дуги окружностей и эллипсов).
Функции line, linerel и lineto соединяют две точки плоскости отрезком прямой. Для первой обе соединяемые точки указываются явно своими координатами. Функции linerel и lineto в качестве первой точки используют текущую графическую позицию CP, а вторую выбирают аналогично функциям moverel и moveto, т. е. через приращения координат или по явному указанию. Все три функции пользуются системой координат графического окна. Однако им можно передать координаты любых точек, даже лежащих за пределами страницы. Функция graphresult не сообщает об ошибке, а соединяющая линия проводится правильно. Если для окна установлен режим отсечения, то части линии, выходящие за пределы окна, не заносятся в видеопамять.
Функция rectangle рисует на странице видеопамяти контур прямоугольника по указанным координатам левого верхнего и правого нижнего угла.
Функция drawpoly рисует ломаную линию, соединяя точки на плоскости. В первом аргументе передается количество таких точек, а второй указывает на массив целых чисел. Каждая пара чисел из этого массива интерпретируется как пара координат (x, y) очередной точки. Для того чтобы нарисовать замкнутую ломаную линию (многоугольник), первая и последняя пары элементов массива должны быть одинаковыми.
Функция circle рисует окружность радиусом radius с центром в точке с координатами (x, y). Функция arc и ellipse вычерчивают дуги окружности и эллипса с центром в точке (x, y), соответственно ограниченные углами start_angle и end_engle. Для дуги окружности задается ее радиус radius, а для дуги эллипса радиусы по осям x_radius и y_radius. Оси эллипса всегда предполагаются параллельными осям координат страницы.
Углы, ограничивающие дуги, выражаются в градусах и отмеряются против часовой стрелки от направления, задаваемого осью X страницы. Дуга всегда проводится от угла start_angle к углу end_angle также против часовой стрелки.
Для функций rectangle, drawpoly, circle, arc и ellipse справедливы замечания относительно системы координат и режима отсечения, которые были сделаны относительно функций рисования линий.
С дугами окружностей связана функция
void far getarccoords(struct arccoordstype far *arccoords);Эта функция возвращает характеристики дуги окружности, построенной при последнем вызове функции arc. Характеристики дуги записываются в переменную *arccoords. Тип этой переменной определен следующим способом:
struct arccoordstype{int x, y;int x_start, y_start, x_end, y_end;};Первая пара чисел – это координаты центра окружности, вторая и третья – координаты начала и конца дуги. Значения координат привязаны к системе координат графического окна.
Существуют функции, которые позволяют варьировать внешний вид объектов, например толщину и тип линии, цвет и другие.
Все контурные графические примитивы прописывают пиксели в видеопамяти рисующим цветом, который можно изменить функцией setcolor.
Для кусочно-линейных графических примитивов, и только для них, имеется возможность указать способ, которым код рисующего цвета будет взаимодействовать с атрибутами пикселей, уже находящимися в видеопамяти на месте рисуемого объекта. Здесь действует механизм, описанный для функции putimage. Выбор способа осуществляется функцией