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

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

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

/* Стандартные хеадеры */

#include <stdio.h>

#include <stdlib.h>

#include <unistd.h>

#include <string.h>

/* Инструментальные хеадеры */

#include <Ph.h>

#include <Pt.h>

#include <Ap.h>

/* Локальные хеадеры */

#include "globals.h"

#include "abimport.h"

#include "proto.h"

int display_image( PtWidget_t *widget, ApInfo_t *apinfo, PtCallbackInfo_t *cbinfo ) {

/* предотвращает предупреждения (варнинги) об отсутствии ссылок */

widget = widget, apinfo = apinfo, cbinfo = cbinfo;

cur_image++;

if (cur_image >= num_images) cur_image=0;

PtSetResource (ABW_base_image, Pt_ARG_LABEL_IMAGE, images[cur_image], 0 );

PtFlush ();

return( Pt_CONTINUE );

}

ABW_base_image – это имя виджета PtLabel, в котором появляется мультипликация.

Исключение мерцания в мультипликации

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

• Создать PtOSContainer (некий контейнер внеэкранного контекста) и сделать его родителем всех виджетов в области, где будет выполняться мультипликация

или

• Использовать функции контекстной памяти PmMem...(), чтобы собирать образ в памяти и отображать его по завершении сборки.

PtOSContainer

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

 Виджет типа PtRaw (так же, как любой другой виджет) может быть порождённым от PtOSContainer. Это означает, что Вы можете получить немерцающую мультипликацию даже тогда, когда используются примитивы рисования Photon'а.

Функции контекста памяти

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

Начните с создания контекста памяти:

PmMemoryContext_t * PmMemCreateMC(

PhImage_t *image,

PhDim_t *dim,

PhPoint_t *translation );

В структуре image должны быть заданы по меньшей мере члены type и size. Буфер данных образа является необязательным, но если Вы хотите иметь его в памяти совместного доступа, Вы должны его обеспечить. Член type должен иметь значение Pg_IMAGE_DIRECT_888 или Pg_IMAGE_PALETTE_BYTE.

Сразу после того, как Вы создали контекст памяти:

• Вызовите функцию PmMemStart(), чтобы установить контекст текущей прорисовки в контекст памяти

• Вызовите функцию PmMemStop(), когда закончите Вашу прорисовку, чтобы вернуться в принимаемый по умолчанию контекст прорисовки

• Вызовите функцию PmMemFlush(), чтобы получить результирующий образ.

Козда Вам больше не нужен контекст памяти, вызовите функцию PmMemReleaseMC().

Режим рисования с прямым доступом

В обычном (не "напрямую") режиме, приложение отсылает запросы на прорисовку в менеджер Photon'а. Графический драйвер блокируется менеджером Photon'а.

Связь в обычном (не прямого доступа) режиме

Когда приложение входит в режим прямого доступа, оно требует, чтобы графический драйвер получал поток данных прорисовки и служебные сообщения напрямую от приложения, а не от менеджера Photon'а. Драйвер блокируется на получении данных от приложения, которое теперь ответственно за то, чтобы указывать драйверу, что делать.

Связь в режиме прямого доступа

Когда приложение входит в режим рисования с прямым доступом, приложение получает полный контроль над дисплеем, так что никакие другие приложения графическим драйвером не обслуживаются. Зона графического драйвера также больше не чувствительна к событиям рисования (так что менеджер Photon'а аннулирует все запросы других приложений к службам построения изображения этого драйвера). Другим достоинством этого режима является то, что графические услуги больше не пересылаются через пространтство событий Photon'а, что улучшает производительность. Недостатком этого режима является то, что приложения, ожидающее захвата событий рисования, не могут записать визуальное представление приложения.

В целях удобства работы создан новый тип контекста PdDirectContext_t. Этот контекст, будучи активирован, становится контекстом по умолчанию для приложения, так что в этом режиме корректно работают вызовы всех остальных функций Photon'а Pg_*.

 В этом режиме начальной точкой отсчёта для всех операций рисования является верхний левый угол экрана, поскольку запросы больше не обрезаются и не преобразуются пространством событий Photon'а. Ваше приложение, если необходимо, по-прежнему может преобразовывать и обрезать события, вызывая функции PgSetTranslation() и PgSetClipping().

Следующие функции имеют дело с режимом рисования с прямым доступом:

Вот несколько соображений, которые надо иметь в виду:

• Когда Вы входите или выходите из режима рисования с прямым доступом, все контексты видеопамяти (за исключением дисплея) на стороне драйвера уничтожаются (драйвер генерирует событие OSINFO, так что приложение уведомляется об этом и может реинициализировать какие-либо контексты видеопамяти). Это включает видеопамять, использовавшуюся структурами PdOffscreenContext_t и всё то, что использовалось видеоверлеем программного интерфейса приложения.

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

• Когда Вы находитесь в режиме рисования с прямым доступом, область графического драйвера больше не чувствительна к событиям рисования (так что менеджер Photon'а не накапливает огромный список событий рисования, обрабатываемых из других приложений).

• Если у Вас включено автоматическое двойное буферирование (например,
  devg-banshee -B...), оно отключается, пока Вы пребываете в режиме рисования с прямым доступом (чтобы позволить приложению самому управлять двойным буферированием). [ Хотя здесь и множественное число: "applicationS", очевидно, что только одному приложению. Прим. пер]

Пример

Вот как получить адрес какого-либо контекста видео-памяти (включая дисплей, который можно также рассматривать как видеопамять). Если Вы создали контекст прямого доступа, вызвав функцию PdCreateDirectContext(), и затем вошли в режим прямого доступа, вызвав функцию PdDirectStart(), Ваше приложение "присваивает" графический драйвер (PgFlush() проходит непосредственно на видеодрайвер, минуя сервер Photon'а).

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

/* Создание контекста прямого доступа */

direct_context = PdCreateDirectContext();

/* Запуск режима прямого доступа */

PdDirectStart(direct_context);

/* Получение основного дисплея */

primary_display = PdCreateOffscreenContext( 0, 0, 0, Pg_OSC_MAIN_DISPLAY);

/* Получение указателя на дисплей */

vidptr = PdGetOffscreenContextPtr(primary_display);

/* Убеждаемся, что драйвер Photon'а ничего не делает

(этого не может быть в данной точке, но мы просто убеждаемся, что

у нас нет продвинутости движка прорисовки видеокарты)

(??? it shouldn't be at this point but this is just to

be sure that we haven't gotten ahead of the video card's draw engine). */

PgWaitHWIdle();

/* Делаем то, что мы делаем в памяти */

Do_something(vidptr);

/* Выход из режима прямого доступа, и удаление контекста прямого доступа

(альтернативой может быть функция PdDirectStop(),

если мы не хотим уничтожать контекст*/

PdReleaseDirectContext(direct_mode);

Внеэкранная видеопамять

Эти вызовы программного интерфейса приложения позволяют Вам использовать остаточную (leftover) память видеокарты. Когда видеокарта находится в видеорежиме, это обычно остаток видеопамяти, который не используется областью дисплея. Эти области памяти могут использоваться для выполнения различных графических операций, хотя используются ещё акселератором видеокарты. В микроGUI Photon'а они в основном рассматриваются в качестве возможности, аналогичной использованию контекста памяти, но их использование будет более быстрым, поскольку для этих областей имеется аппаратное ускорение. Функции и структуры данных включают:

Вот некий простой код, который создаёт и формирует изображение во внеэкранном буфере, а затем копирует данные на экран. Он создаёт два внеэкранных контекста объёмом 100х100, выполняет какую-то прорисовку, блитинг, и затем блитирует результат в текущую область (т.е. в область, принадлежащую PtWindow). В этом примере предполагается, что Вы уже создали окно и вызвали функцию PgSetRegion(), чтобы указать, что область окна вызывает появление событий прорисовки:

#include <Pt.h>

PtInit( NULL );

/* ... */

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

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