Руководство программиста в Photon (1037671), страница 46

Просмтор этого файла доступен только зарегистрированным пользователям. Но у нас супер быстрая регистрация: достаточно только электронной почты!

Текст из файла (страница 46)

PtSuperClassDraw( PtBasic, widget, damage );

}

Вызов функции PtSuperClassDraw() (описанный в "Руководстве по созданию своих собственных виджетов") вызывает функцию рисования PtBasic'а, которая рисует границы необработанного виджета, заполняет виджет, и всё прочее, как задано его ресурсами. Необработанный виджет может делать всё это самостоятельно, но использование функции PtSuperClassDraw() снижает сложность функции необработанного рисования.

При обсуждении функции необработанного рисования следует отметить несколько вопросов:

• Вам необходимо знать холст (canvas) необработанного виджета.

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

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

• Функции прорисовки передаётся список повреждённых областей, что может использоваться для увеличения скорости восстановления.

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

 Не вызывайте функцию PtBkgdHandlerProcess() в функции рисования виджета PtRaw.

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

Определение холста необработанного виджета

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

PhRect_t raw_canvas;

PtCalcCanvas(widget, &raw_canvas);

Вам понадобится это холст при выполнении каких-либо требующихся преобразований и обрезаний.

Преобразование координат

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

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

• Добавлять координаты верхнего левого угла холста необработанного виджета ко всем координатам, передаваемым в примитивы рисования. Например, чтобы нарисовать эллипс с центром в координатах (80, 60) относительно холста необработанного виджета, необходимо сделать так:

PhPoint_t c1 = { 80, 60 };

PhPoint_t r = { 72, 52 };

c1.x += raw_canvas.ul.x;

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'а") работают с черепицами:

Использование модели для более сложного рисования

Если содержание необработанного виджета является статическим, Вы можете вызывать примитивы рисования 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 (красный-зелёный-синий) представление:

Макросы для наиболее часто используемых цветов определены в <photon/Pg.h>.

Несмотря на то, что PgColor_t использует 32 бита, под цвет используется только 24 бита. Такое предоставление называется true color. МикроGUI Photon'а – это оконная система в true color; она использует это 24-битное RGB-предоставление внутренне.

Большинство современных графических карт использует true color (24 бита) или high color (16 бит). Однако некоторые графические драйверы используют достоинства палитры в более старых картах, основанных на палитре. В "Справочнике библиотечных функций Photon'а" описаны следующие типы данных и функции, относящиеся к работе с цветом:

Атрибуты рисования

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

Характеристики

Список файлов учебной работы