gis_render_sm_alloc()

Создание контекста движка рендеринга.

Прототип:

#include <gis/gis_surfacemanager.h>
int gis_render_sm_alloc( gis_render_sm_context_t *sm_ctx, gis_data_engine_context_t ctx, uint32_t surface_extension_px, double blit_region_rate, uint32_t flags );

Аргументы:

sm_ctx
Указатель на контекст движка рендеринга Surface Manager.
ctx
Указатель на контекст движка рендеринга Data Engine.
surface_extension_px
Величина расширения поверхности относительно видимой области виджета в пикселях.
blit_region_rate
Коэффициент, задающий размер области блиттинга (зоны нечувствительности), при перемещении в которой не будет повторно рисоваться поверхность. Задаётся в пределах от 0 до 1.0. Режимы работы: 0 — Область блиттинга совпадает с областью поверхности. 1 — Область блиттинга совпадает с областью виджета.
flags
Флаги, определяющие режим работы Surface Manager. Возможные варианты: GIS_RENDER_SM_ALLOC_RAM — поверхности для рендеринга будут выделены в RAM памяти.

Библиотека:

gisrender

Описание:

Функция создаёт контекст движка рендеринга Surface Manager и инициализирует его переданными параметрами.

Возвращаемое значение:

EOK
Успешное завершение
EINVAL
Некорректные параметры функции
EFAULT
Не удалось инициализировать контекст Surface Manager
ENOMEM
Недостаточно памяти
ENOENT
Некорректный режим движка рендеринга Data Engine

Примеры использования:

gis_render_sm_context_t sm_ctx;
gis_data_engine_context_t ctx;
uint32_t offscreen_ext_px = 1000;
uint32_t flags = 0;
if ( gis_render_sm_alloc( &sm_ctx, ctx, offscreen_ext_px, 0.5, flags ) != EOK ) {
printf( "gis_render_sm_alloc() failed.\n" );
return (-1);
}

Классификация:

Картографический фреймворк для ЗОСРВ "Нейтрино"

Способ использования Использование разрешено
Обработчик прерывания Нет
Обработчик сигналов Нет
В потоке Да

Тематические ссылки:

gis_render_sm_context_t, gis_render_sm_move(), gis_render_sm_free()




Предыдущий раздел: Описание API картографического фреймворка