Руководство программиста в Photon (953920), страница 46
Текст из файла (страница 46)
c1.y += raw_canvas.ul.y;
PgSetFillColor(Pg_YELLOW);
PgDrawEllipse ( &c1, &r, Pg_DRAW_FILL );
Этот метод предпочтительный.
-
Вы можете установить преобразование, вызвав функцию PgSetTranslation() и передав ей координаты верхнего левого угла холста необработанного виджета:
PhPoint_t c1 = { 80, 60 };
PhPoint_t r = { 72, 52 };
PgSetTranslation (&raw_canvas.ul, Pg_RELATIVE);
PgSetFillColor(Pg_YELLOW);
PgDrawEllipse ( &c1, &r, Pg_DRAW_FILL );
Убедитесь, что Вы восстановили старое преобразование, перед тем как выйти из функции рисования необработанного виджета. Вот один из способов, как это сделать:
/* Восстановление преобразования извлечением координат холста необработанного виджета */
raw_canvas.ul.x *= -1;
raw_canvas.ul.y *= -1;
PgSetTranslation (&raw_canvas.ul, Pg_RELATIVE);
Отсечение
Как уже обсуждалось выше, в функции рисования виджета возможно рисование за пределами пространства необработанного виджета, но так делать нехорошо:
-
Это может загадить остальную часть интерфейса Вашего приложения
-
Если необработанное рисование вне пространства необработанного виджета окажется повреждённым, но сам необработанный виджет – нет, функция прорисовки необработанного виджета не будет вызвана, и повреждения не будут исправлены.
Можно написать функцию прорисовки, так чтобы это отсечение не было нужным, но это может сделать Ваш программный код более запутанным. Например, если Вы пытаетесь писать текст, который выходит за пределы холста необработанного виджета, Вам может понадобиться прорисовать части букв. Вам также надо иметь в виду, что произойдёт, если пользователь изменит размер необработанного виджета. Намного легче использовать функцию PtClipAdd(), чтобы установить область обрезки по холсту необработанного виджета и позволить графическому драйверу ограничивать прорисовку:
PtClipArea(widget, &raw_canvas);
Перед тем как выйти из функции прорисовки, вызовите функцию PtClipRemove(), чтобы отключить область обрезки:
PtClipRemove();
Использование повреждённых черепиц (tiles)
Если выполнение Вашей функции прорисовки необработанного виджета занимает много времени, Вы можете не захотеть перерисовать весь холст, когда повреждена только его малая часть. Вы можете ускорить восстановление, используя аргумент damage функции прорисовки [Прим. пер. – Да и зрительно это будет получше...]. Аргумент damage является указателем на связанный список структур PhTile_t (см. "Справочник библиотечных функций Photon'а"), каждая из которых включает такие члены:
rect Структура PhRect_t, определяющая повреждённую область
next Указатель на следующую черепицу в списке.
Повреждённые области являются относительными от родителя необработанного виджета. По крайней мере один из них перекрывает необработанный виджет, но некоторые из них могут и не перекрывать.
Если в связанном списке находится более одной черепицы, первая из них покрывает всю область, покрываемую остальными. Можно или использовать первую черепицу и игнорировать остальные, или игнорировать первую и использовать остальные:
void rawDrawFunction (PtWidget_t *widget, PhTile_t *damage) {
if (damage->next != NULL) {
/* Если имеется больше одной черепицы, пропустить первую. */
damage = damage->next;
}
while (damage != NULL) {
/* Проверка damage, чтобы посмотреть, надо ли делать какую-то прорисовку:
damage->rect.ul.x, damage->rect.ul.y,
damage->rect.lr.x, damage->rect.lr.y
*/
...
damage = damage->next; /* Переход к следующей черепице. */
}}
Следующие функции (описанные в "Справочнике библиотечных функций Photon'а") работают с черепицами:
| PhAddMergeTiles() | Объединение двух списков черепиц, исключающее наложение |
| PhClipTilings() | Обрезка одного списка черепиц другим |
| PhCoalesceTiles() | Комбинирование списка черепиц |
| PhCopyTiles() | Копирование списка черепиц |
| PhDeTranslateTiles() | Вычитание смещений по x и y из вершин списка черепиц |
| PhFreeTiles() | Возвращение списка черепиц во внутренний пул черепиц |
| PhGetTile() | Получение черепицы из внутреннего пула черепиц |
| PhIntersectTilings() | Определение пересечения двух списков черепиц |
| PhMergeTiles() | Удаление всех наложений из списка черепиц |
| PhRectsToTiles() | Создание списка черепиц из массива прямоугольников |
| PhSortTiles() PhTilesToRects () | Сортировка списка черепиц Создание массива прямоугольников из списка черепиц |
| PhTranslateTiles() | Добавление смещений по x и y к вершинам списка черепиц |
Использование модели для более сложного рисования
Если содержание необработанного виджета является статическим, Вы можете вызывать примитивы рисования Pg непосредственно из функции необработанной прорисовки. Если содержание является динамическим, Вам понадобится определить структуру данных или модель, которая это описывает.
Структура модели зависит от Вашего приложения; функция необработанного рисования должна быть в состоянии отследить модель и отрисовать требуемую графику. Для сохранения указателя на модель используйте ресурс необработанного виджета Pt_ARG_USER_DATA или Pt_ARG_POINTER.
Примеры простых функций прорисовки PtRaw
Эта функция прорисовки рисует пару эллипсов, один из которых обрезан:
void my_raw_draw_fn( PtWidget_t *widget, PhTile_t *damage ) {
PhRect_t raw_canvas;
PhPoint_t c1 = { 80, 60 };
PhPoint_t c2 = { 30, 210 };
PhPoint_t r = { 72, 52 };
PtSuperClassDraw( PtBasic, widget, damage);
PtCalcCanvas(widget, &raw_canvas);
/* Установка области обрезки по холсту необработанного виджета. */
PtClipAdd ( widget, &raw_canvas);
/* Рисование эллипсов. */
c1.x += raw_canvas.ul.x;
c1.y += raw_canvas.ul.y;
PgSetFillColor(Pg_YELLOW);
PgDrawEllipse ( &c1, &r, Pg_DRAW_FILL);
c2.x += raw_canvas.ul.x;
c2.y += raw_canvas.ul.y;
PgSetFillColor(Pg_RED);
PgDrawEllipse ( &c2, &r, Pg_DRAW_FILL);
/* Сброс области обрезки. */
PtClipRemove ();
}
Эта функция такая же, но она устанавливает преобразование:
void my_raw_draw_fn( PtWidget_t *widget, PhTile_t *damage ) {
PhRect_t raw_canvas;
PhPoint_t c1 = { 80, 60 };
PhPoint_t c2 = { 30, 210 };
PhPoint_t r = { 72, 52 };
PtSuperClassDraw( PtBasic, widget, damage);
PtCalcCanvas(widget, &raw_canvas);
/* Установка области обрезки по холсту необработанного виджета. */
PtClipAdd ( widget, &raw_canvas);
/* Установка преобразования, так что операции рисования выполняются
относительно холста необработанного виджета.
*/
PgSetTranslation (&raw_canvas.ul, Pg_RELATIVE);
/* Рисование эллипсов. */
PgSetFillColor(Pg_YELLOW);
PgDrawEllipse ( &c1, &r, Pg_DRAW_FILL);
PgSetFillColor(Pg_RED);
PgDrawEllipse ( &c2, &r, Pg_DRAW_FILL);
/* Восстановление преобразования путём получения координат
холста необработанного виджета.
*/
raw_canvas.ul.x *= -1;
raw_canvas.ul.y *= -1;
PgSetTranslation (&raw_canvas.ul, Pg_RELATIVE);
/* Сброс области обрезки. */
PtClipRemove ();
}
Цвет
В микроGUI Photon'а цвета задаются типом PgColor_t. Библиотека и графические драйверы интерпретируют этот тип данных в соответствии с текущей моделью цветности (описанной в документации по PgColor_t).
Принимаемая по умолчанию модель цветности Pg_CM_PRGB использует 32-битное RGB (красный-зелёный-синий) представление:
| Зарезервировано | Красный | Зелёный | Синий |
| 0000 0000 | r r r r r r r r | g g g g g g g g | b b b b b b b b |
Макросы для наиболее часто используемых цветов определены в <photon/Pg.h>.
Несмотря на то, что PgColor_t использует 32 бита, под цвет используется только 24 бита. Такое предоставление называется true color. МикроGUI Photon'а – это оконная система в true color; она использует это 24-битное RGB-предоставление внутренне.
Большинство современных графических карт использует true color (24 бита) или high color (16 бит). Однако некоторые графические драйверы используют достоинства палитры в более старых картах, основанных на палитре. В "Справочнике библиотечных функций Photon'а" описаны следующие типы данных и функции, относящиеся к работе с цветом:
| PgAlphaValue() | Получение альфа-компонента из значения цвета |
| PgARGB() | Преобразование значений альфа, красного, зелёного и синего в комбинированный формат цвета |
| PgBackgroundShadings() | Вычисление верхнего и нижнего оттенков цветов |
| PgBlueValue() | Получение синего компонента из значения цвета |
| PgCMY() | Преобразование голубого, пурпурного и жёлтого значений [CMY – cyan/magenta/yellow – Прим. пер.] в комбинированный формат цвета |
| PgColorHSV_t | Значение цвета HSV [Hue-Saturation-Value, т.е. Оттенок-Насыщеннось-Значение. Прим. пер.] |
| PgColorMatch() | Запрашивание наилучшего совпадения цвета |
| PgGetColorModel() | Получение текущей модели цветности |
| PgGetPalette() | Запрашивание текущей палитры цветов |
| PgGray() | Генерирование оттенков серого |
| PgGrayValue() | Получение яркости цвета |
| PgGreenValue() | Получение зелёной компоненты из значения цвета |
| PgHSV() | Преобразование оттенка, насыщенности и значения в комбинированный формат цвета |
| PgHSV2RGB() | Преобразование цветов HSV в RGB |
| PgRedValue() | Получение красного компонента из значения цвета |
| PgRGB() | Преобразование значений красного, зелёного и синего в комбинированный формат цвета |
| PgRGB2HSV() | Преобразование RGB-цветов в HSV |
| PgSetColorModel() | Установка текущей модели цветности |
| PgSetPalette() | Установка палитры цветов |
Атрибуты рисования
При выполнении необработанного рисования Вы можете устанавливать различные атрибуты, включая шрифты, палитры, цвета заполнения, цвета и стили линий и цвета текста. Установленные Вами атрибуты оказывают влияние на все операции необработанного рисования до тех пор, пока Вы не переустановите их. Например, цвет линии затрагивает все линии, пиксели и побитовые образы, которые вы рисуете, используя примитивы рисования.
Вам нет необходимости устанавливать эти атрибуты, если Вы используете виджеты; атрибуты прорисовки устанавливаются на основании определений и ресурсов виджетов.
Общие атрибуты
Функциями, устанавливающими общие атрибуты рисования, являются:
| PgDefaultMode() | Сброс режима прорисовки и маски плоскостей в значения, принимаемые по умолчанию |
| PgSetDrawMode() | Установка режима прорисовки |
| PgSetPlaneMask() | Защита видеопамяти от модифицирования |
Текстовые атрибуты
| PgDefaultText() | Сброс текстового атрибута к его системному значению, принимаемому по умолчанию |
| PgSetFont() | Установка текстового шрифта |
| PgSetTextColor() | Установка цвета текста |
| PgSetTextDither() | Установка шаблона сглаживания текста |
| PgSetTextTransPat() | Установка прозрачности рисования |
| PgSetTextXORColor() | Установка цвета в XOR-прорисовке |
| PgSetUnderline() | Установка цветов для подчёркнутого текста |
Атрибуты заполнения
Атрибуты заполнения оказывают влияние на всё рисование, которое Вы выполняете, вызывая функции примитивов, описанных в:
-
Дуги, эллипсы, многоугольники и прямоугольники
-
Текст
-
Побитовые образы
Функциями, устанавливающими атрибуты заполнения, являются:
| PgDefaultFill() | Сброс атрибута заполнения в его принимаемое по умолчанию значение |
| PgSetFillColor() | Установка точного цвета заполнения |
| PgSetFillDither() | Установка конкретного шаблона сглаживания и цветов |
| PgSetFillTransPat() | Установка прозрачности рисования |
| PgSetFillXORColor() | Установка цвета в XOR-прорисовке |
Атрибуты черты (линии)
Атрибуты черты оказывают влияние на всё рисование, которое Вы выполняете, вызывая функции примитивов, описанных в
-
Дуги, эллипсы, многоугольники и прямоугольники
-
Линии, пиксели и массивы пикселей
-
Текст
-
Побитовые образы
Функциями, устанавливающими атрибуты черты, являются:
| PgDefaultStroke() | Сброс атрибута черты в его системное принимаемое по умолчанию значение |
| PgSetStrokeCap() | Установка того, как выглядят концы линий |
| PgSetStrokeColor() | Установка цвета последующих контуров |
| PgSetStrokeDither() | Применение шаблона цвета к контурам |
| PgSetStrokeTransPat() | Использование шаблона маски к установке прозрачности рисования контуров |
| PgSetStrokeXORColor() | Использование XOR (исключающего ИЛИ) для цвета при рисовании контуров |
| PgSetStrokeDash() | Установка пунктирных линий |
| PgSetStroJoin() | Установка того, как линии соединяются |
| PgSetStrokeWidth() | Установка толщины линии |
| PgSetStrokeFWidth() | Установка толщины линии |
Дуги, эллипсы, многоугольники и прямоугольники
Библиотеки Photon'а включают группу функций примитивов, которые Вы можете использовать для рисования кривых, включая:
-
прямоугольники
-
прямоугольники со скруглёнными углами
-
прямоугольники с фасками, прямоугольники и стрелки
-
многоугольники
-
дуги, круги, хорды и сектора
-
спэны (spans) – сложные кривые
Не используйте эти примитивы рисования в интерфейсе, который использует виджеты; виджеты переотображают себя, когда повреждаются, так что всё, нарисованное поверх них, исчезнет. Чтобы отображать кривые, линии и прочая в каком-то интерфейсе:
-
Создайте виджет PtRaw и вызовите примитивы в его функции прорисовки. См. раздел "Виджет PtRaw" выше в этой главе.
или
-
Используйте соответствующий графический виджет. Более полная информация – в описании PtGraphic в "Справочнике виджетов Photon'а".
Пользуясь различными флагами примитива, Вы можете легко нарисовать контур (черта), нарисовать заполнение "внутри" (заполнение), или нарисовать сразу и то и другое как заполненный контур. Использованы атрибуты заполнения и черты. Более подробно см. "Атрибуты рисования" выше в этой главе.
| Чтобы: | Установите флаги в: |
| Заполнить примитив, используя текущие атрибуты заполнения | Pg_Draw_FILL |
| Очертить контур примитива, используя текущие атрибуты черты | Pg_DRAW_STROKE |
| Заполнить примитив и очертить его контур, используя текущие атрибуты заполнения и черты | Pg_DRAW_FILL_STROKE |
mx-версии этих функций размещают адрес примитива в буфере рисования пространства данных Вашего приложения. Когда буфер рисования сбрасывается, примитив копируется в графический драйвер. Не-mx-версии копируют в буфер рисования сам примитив.
Прямоугольники
Вы можете рисовать прямоугольники, используя текущие атрибуты рисования, путём вызова функций PgDrawIRect() или PgDrawRect().
![](https://s.studizba.com/z.php?f=/templates/si/i/noavatar.png&w=100&h=100&t=1"){kind=avatar}
