screen_fill()

Заливает цветом указанный буфер

Прототип:

#include <screen/screen.h>
 
int screen_fill( screen_context_t ctx,
                 screen_buffer_t  dst,
                 const int        *attribs );

Аргументы:

ctx

Дескриптор контекста, определяющий соединение с оконной подсистемой Screen.

dst

Буфер, куда будут скопированы данные.

attribs

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

Библиотека:

libscreen

Описание:

Тип функции: Исполняемые отложенно

Функция выполняет заливку прямоугольной области буфера назначения сплошным цветом. Для выполнения операции по возможности привлекается аппаратный блиттер.

Аргумент attribs может быть равен NULL или быть пустым (содержать один элемент, установленный в SCREEN_BLIT_END). Для пустого аргумента attribs применяются следующие параметры по умолчанию:

• вертикальная и горизонтальная позиции конечного прямоугольника равны 0
• конечный прямоугольник включает весь конечный буфер
• альфа-значение выставляется в 255 (или непрозрачное)
• цвет заливки выставляется в #ffffff (белый)

Чтобы изменить параметры по умолчанию, установите с помощью attribs пару макрос-значение:

• SCREEN_BLIT_DESTINATION_X
• SCREEN_BLIT_DESTINATION_Y
• SCREEN_BLIT_DESTINATION_WIDTH
• SCREEN_BLIT_DESTINATION_HEIGHT
• SCREEN_BLIT_GLOBAL_ALPHA
• SCREEN_BLIT_COLOR

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

0

Операция блиттинга успешно помещена в очередь.

-1

В случае ошибки, код ошибки записывается в errno.

Коды ошибок:

EINVAL

Некорректный аргумент.

EFAULT

Добавление команды в очередь завершилось с ошибкой.

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

Графическая подсистема ЗОСРВ «Нейтрино», Screen

Безопасность использования

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Да

Предыдущий раздел: Буферы