прогинг. Гущин_SDL. Аа нн
 Скачать 1.04 Mb.
|
|
1. Основные возможности библиотеки семейства SDL В качестве одного из примеров библиотек, позволяющих соз-давать программы с графическим пользовательским интерфейсом для современных ОС без изучения во всех подробностях особен-ностей построения данных операционных систем, рассмотрим основные возможности библиотеки SDL и ряда надстроек над ней, существенно упрощающих написание программ. Simple DirectMedia Layer (сокращенно SDL) – это свободная кроссплатформенная библиотека, реализующая единый интерфейс к графической подсистеме, устройствам ввода и звуковой под- системе, официально поддерживающая операционные системы Linux, Microsoft Windows и Mac OS X на уровне как исходных текстов, так и скомпонованных библиотек, а платформы iOS и Android – на уровне исходных текстов. SDL написана на языке C и может использоваться программами на большом числе языков программирования с различными парадигмами, для многих из которых необходимые расширения предоставляются разработ-чиками библиотеки. Данная библиотека активно используется при написании кроссплатформенных мультимедийных приложений, в основном компьютерных игр. Основная часть SDL содержит лишь весьма ограниченный, базовый набор возможностей, а допол-нительные функции (такие, как графические примитивы или вывод текста) обеспечиваются расширениями библиотеки. Сле-дует отметить, что, начиная с версии 2.0 (для объединения всех версий SDL 2.x и отличия их от SDL 1.x часто используется обозначение SDL2), SDL распространяется по лицензии zlib, а не LGPL, что позволяет более свободно использовать ее в ком-мерческих программах. Однако еще не все расширения переве-дены на распространение под данной лицензией, поэтому в учебных целях будем считать, что все компоненты SDL (в том числе дополнительные, не входящие в основной комплект поставки) распространяются на условиях LGPL. Следовательно, программы, 9 написанные с ее использованием, должны или рас-пространяться с полными исходными текстами, или применять динамическую компоновку с программой модулей библиотеки SDL (с помощью .dll в Microsoft Windows или .so в Linux). Структурно SDL (как и большинство графических библиотек, например современные библиотеки-эмуляторы Borland Graphics Interface для многозадачных ОС) можно рассматривать как отно-сительно «тонкую» прослойку между конкретной прикладной программой и конкретными программными интерфейсами кон-кретных операционных систем для работы с соответствующей аппаратурой (например, при работе с графикой скрывать от разра-ботчика прикладной программы особенности работы с DirectX или GDI в Microsoft Windows, Xlib или framebuffer в Linux и т.п.). Основные возможности SDL – поддержка операций над двумер-ными плоскостями пикселей (включая создание окон), обработка событий (от клавиатуры, мыши и таймера), а также работа со звуком и абстрагирование доступа к файлам. Далее будут рассматриваться только основные возможности SDL для работы с изображениями на двумерных плоскостях, а также базовые возможности ряда дополнительных библиотек, а именно SDL_ttf для вывода текста (от разработчиков SDL) и SDL_draw для вывода базовых графических примитивов, таких как линии, эллипсы и прямоугольники (от группы отдельных раз-работчиков). Поскольку еще не все они полностью поддерживают SDL2, а во второй версии SDL несколько изменена логика работы с окнами и поверхностями рисования (в том числе для поддержки многооконного режима и нескольких дисплеев), то работа с ними будет рассматриваться на примере библиотек предыдущего поко-ления, а именно SDL 1.2.15, SDL_draw 1.2.13 и SDL_ttf 2.0.11. 2. Начало работы с SDL 1.2.15, SDL_draw 1.2.13 и SDL_ttf 2.0.11 в интегрированной среде разработки Dev-Cpp 4.9.9.2 под управлением Windows XP Предположим, что исходно имеется персональный компьютер под управлением операционной системы Microsoft Windows XP, на котором установлена среда разработки Dev-Cpp 4.9.9.2 для всех пользователей. При этом установка была произведена в каталог C:\Dev-Cpp\, в дальнейшем именуемый «каталогом среды разра-ботки Dev-Cpp», в качестве языка пользовательского интерфейса выбран русский и включена возможность анализа заголовочных файлов для поиска функций, классов переменных и т.п. Предположим также, что для упрощения работы с архивами на компьютере установлен свободно распространяемый файловый менеджер FAR 3.0 с модулем расширения arclite для работы с архивами в форматах zip, tar и tar.gz. Для подготовки среды разработки Dev-Cpp с библиотеками SDL 1.2 и возможности выполнения созданных приложений в дальнейшем вне среды разработки потребуются следующие сво-бодно распространяемые файлы: SDL-1.2.15.zip – исходные тексты библиотеки SDL. Если не заниматься их сборкой, то из данного файла понадобятся лишь заголовочные файлы. SDL-1.2.15-devel-1.2.15-mingw32.tar.gz – архив с файлами для разработки программ в окружении mingw32 (такое же исполь-зуется в Dev-Cpp), содержит уже собранную динамическую биб-лиотеку SDL.dll для программ, использующих Win32 API, а также необходимые для ее подключения статические библиотеки. SDL_draw-1.2.13.tar.gz – исходные тексты библиотеки графи-ческих примитивов SDL_draw. Потребуется собирать библиотеку средствами Dev-Cpp, соответствующий проект входит в состав архива. SDL_ttf-2.0.11.zip – исходные тексты библиотеки SDL_ttf. Если не заниматься их сборкой, то из данного файла понадобятся лишь заголовочные файлы. SDL_ttf-2.0.11-win32.zip – архив с уже собранной динами-ческой библиотекой SDL_ttf для программ, использующих Win32 API и с используемыми ею другими динамическими библиоте- ками: libfreetyp-6.dll и zlib1.dll. К двум последним прилагаются файлы лицензий. CharisSILR.ttf – свободно распространяемый шрифт, включающий символы русского алфавита. 10 Подключение к среде разработки Dev-Cpp библиотеки SDL-1.2.15: 1. Выделяем в архиве SDL-1.2.15.zip все файлы вида SDL-1.2.15\include\*.h и копируем выделенные файлы в подка-талог \include каталога среды разработки Dev-Cpp. 2. Выделяем в архиве SDL-1.2.15-devel-1.2.15-mingw32.tar.gz все файлы вида SDL-1.2.15- devel-1.2.15-mingw32.tar\SDL-1.2.15 \lib\libSDL*.* и копируем три выделенных файла в подкаталог \lib каталога среды разработки Dev-Cpp. Пример создания проекта, использующего только биб-лиотеку SDL-1.2.15 с динамическим связыванием: 1. Создаем новый каталог для проекта, например C:\SDLtest. 2. Запускаем среду разработки Dev-Cpp, создаем новый C-проект типа Console Application с именем, например SDLtest, сохраняем файл проекта SDLtest.dev в каталоге C:\SDLtest. 3. В файле main.c вместо автоматически созданной заготовки текста программы вводим следующий текст: #include SDL_Surface *screen; SDL_Event event; SDL_Rect dst; if (SDL_Init(SDL_INIT_VIDEO)) return 1; screen=SDL_SetVideoMode(640, 480, 32, SDL_ANYFORMAT); if (!screen){ SDL_Quit(); return 1; } dst.x = 10; dst.y = 10; dst.w = 50; dst.h = 50; SDL_FillRect(screen, &dst, SDL_MapRGB(screen->format,0,255,0)); SDL_Flip(screen); while(SDL_WaitEvent(&event)){ if(event.type == SDL_QUIT || (event.type == SDL_KEYDOWN && event.key.keysym.sym == SDLK_ESCAPE)) { SDL_Quit(); return 0; } } SDL_Quit(); return 2; } 4. Из архива SDL-1.2.15-devel-1.2.15-mingw32.tar.gz копируем файл SDL-1.2.15-devel-1.2.15- mingw32.tar\SDL-1.2.15\bin\SDL.dll в каталог с созданным проектом (C:\SDLtest). 5. В параметрах проекта (меню «Проект/Параметры проекта») на вкладке «Параметры» добавляем в столбец «Компоновщик» строку: -lmingw32 -lSDLmain -lSDL 6. Собираем и запускаем проект по клавише F9, и он успешно запускается: в верхнем левом углу с небольшим отступом от края на черном фоне – ярко-зеленый квадрат. Выход из программы по нажатию клавиши Esc или щелчку по системной кнопке закрытия окна в его заголовке. Подключение к среде разработки Dev-Cpp библиотеки SDL_ttf-2.0.11: 1. Из архива SDL_ttf-2.0.11.zip копируем файл SDL_ttf-2.0.11 \SDL_ttf.h в подкаталог \include каталога среды разработки Dev-Cpp. 2. Из архива SDL_ttf-2.0.11-win32.zip копируем файл SDL_ttf.dll в подкаталог \lib каталога среды разработки Dev-Cpp. 11 Пример создания проекта, использующего библиотеки SDL-1.2.15 и SDL_ttf-2.0.11 с динамическим связыванием: 1. Создаем новый каталог для проекта, например C:\SDLttftest. 2. Запускаем среду разработки Dev-Cpp, создаем новый C-проект типа Console Application с именем, например SDLttftest, сохраняем файл проекта SDLttftest.dev в каталоге C:\SDLttftest. 3. В файле main.c вместо автоматически созданной заготовки текста программы вводим следующий текст: #include #include { SDL_Surface *screen; SDL_Event event; TTF_Font *fnt = NULL; SDL_Color text_color; SDL_Rect dest; SDL_Surface *text_surface = NULL; /* Строка "Привет, Мир!" в кодировке utf8 */ char hello_world[]="Привет, Мир!"; if (SDL_Init(SDL_INIT_VIDEO)) return 1; if (TTF_Init()) return 1; if(!(screen=SDL_SetVideoMode(640,480,32,SDL_ANYFORMAT))){ TTF_Quit(); SDL_Quit(); return 1; } if(!(fnt = TTF_OpenFont("CharisSILR.ttf", 29))){ TTF_Quit(); SDL_Quit(); return 3; } dest.x = 200; dest.y = 100; dest.w = 1; dest.h = 1; text_color.r = 0; text_color.g = 0; text_color.b = 255; if(text_surface = TTF_RenderUTF8_Solid(fnt, hello_world, text_color)){ SDL_BlitSurface(text_surface, NULL, screen, &dest); SDL_FreeSurface(text_surface); text_surface = NULL; } SDL_Flip(screen); while(SDL_WaitEvent(&event)){ if(event.type == SDL_QUIT || (event.type == SDL_KEYDOWN && event.key.keysym.sym == SDLK_ESCAPE)) { TTF_CloseFont(fnt); TTF_Quit(); SDL_Quit(); return 0; } } TTF_CloseFont(fnt); TTF_Quit(); SDL_Quit(); return 2; 12 } 4. Из архива SDL-1.2.15-devel-1.2.15-mingw32.tar.gz копируем файл SDL-1.2.15-devel-1.2.15- mingw32.tar\SDL-1.2.15\bin\SDL.dll в каталог с созданным проектом (C:\SDLttftest). 5. Выделяем в архиве SDL_ttf-2.0.11-win32.zip все файлы вида *.dll и копируем в каталог с созданным проектом (C:\SDLttftest). 6. В параметрах проекта (меню «Проект/Параметры проекта»), на вкладке «Параметры» добавляем в столбец «Компоновщик» строку -lmingw32 -lSDLmain –lSDL –lSDL_ttf 7. Копируем файл CharisSILR.ttf в каталог с созданным проектом (C:\SDLttftest). 8. Собираем и запускаем проект по клавише F9, и он успешно запускается: на экран выводится ярко-синяя надпись «Привет, Мир!». Выход из программы – по нажатию клавиши Esc или щелчку по системной кнопке закрытия окна в его заголовке. Сборка библиотеки SDL_draw-1.2.13 из исходных текстов: 1. Из архива SDL_draw-1.2.13.tar.gz копируем каталог SDL_draw-1.2.13.tar\SDL_draw-1.2.13 в корень диска C: – получаем каталог C:\SDL_draw-1.2.13\ (диск C: приведен для примера; вместо него возможно любое другое расположение, но далее будет рассматриваться именно такой пример). 2. В каталоге C:\SDL_draw-1.2.13\Dev-Cpp\ открываем проект SDL_draw_static.dev. 3. Выполняем в среде разработки Dev-Cpp команду «Перестроить все» (меню «Выполнить/Перестроить все»). В каталоге C:\SDL_draw-1.2.13\Dev-Cpp\ появляется новый файл libSDL_draw.a (статическая библиотека). Закрываем проект. 4. В каталоге C:\SDL_draw-1.2.13\Dev-Cpp\ открываем проект SDL_draw_dynamic.dev. 5. В параметрах проекта (меню «Проект/Параметры проекта»), на вкладке «Параметры», в столбце «Компоновщик» заменяем вторую строку на следующую: –lSDL 6. Выполняем в среде разработки Dev-Cpp команду «Перестроить все» (меню «Выполнить/Перестроить все»). В каталоге C:\SDL_draw-1.2.13\Dev-Cpp\ появляется новый файл SDL_draw.dll (динамическая библиотека). Закрываем проект. Подключение к среде разработки Dev-Cpp библиотеки SDL_draw-1.2.13: 1. Из каталога C:\SDL_draw-1.2.13\include копируем файл SDL_draw.h в подкаталог \include каталога среды разработки Dev-Cpp. 2. Из каталога C:\SDL_draw-1.2.13\Dev-Cpp\ копируем файл SDL_draw.dll в подкаталог \lib каталога среды разработки Dev-Cpp. Пример создания проекта, использующего библиотеки SDL-1.2.15 и SDL_draw-1.2.13 с динамическим связыванием: 1. Создаем новый каталог для проекта, например C:\SDLdrawtest. 2. Запускаем среду разработки Dev-Cpp, создаем новый C-проект типа Console Application с именем, например SDLdrawtest, сохраняем файл проекта SDLdrawtest.dev в каталоге C:\ SDLdrawtest. 3. В файле main.c вместо автоматически созданной заготовки текста программы вводим следующий текст: #include #include { SDL_Surface *screen; SDL_Event event; if (SDL_Init(SDL_INIT_VIDEO)) return 1; screen = SDL_SetVideoMode(640,480,32,SDL_ANYFORMAT); if (!screen){ SDL_Quit(); 13 return 1; } Draw_FillEllipse(screen, 320, 240, 300, 200, SDL_MapRGB(screen->format, 128, 128, 128)); SDL_Flip(screen); while(SDL_WaitEvent(&event)){ if(event.type == SDL_QUIT || (event.type == SDL_KEYDOWN && event.key.keysym.sym == SDLK_ESCAPE)) { SDL_Quit(); return 0; } } SDL_Quit(); return 2; } 4. Из архива SDL-1.2.15-devel-1.2.15-mingw32.tar.gz копируем файл SDL-1.2.15-devel-1.2.15- mingw32.tar\SDL-1.2.15\bin\SDL.dll в каталог с созданным проектом (C:\SDLdrawtest). 5. Из каталога C:\SDL_draw-1.2.13\Dev-Cpp\ копируем файл SDL_draw.dll в каталог с созданным проектом (C:\SDLdrawtest). 6. В параметрах проекта (меню «Проект/Параметры проекта», комбинация клавиш Alt+P), на вкладке «Параметры», добавляем в столбец «Компоновщик» строку: -lmingw32 -lSDLmain –lSDL –lSDL_draw 7. Собираем и запускаем проект по клавише F9, и он успешно запускается: на черном фоне отображается серый закрашенный эллипс. Выход из программы – по нажатию клавиши Esc или щелчку по системной кнопке закрытия окна в его заголовке. Создание проектов, использующих библиотеки SDL-1.2.15, SDL_draw-1.2.13 и SDL_ttf- 2.0.11 с динамическим связыванием: 1. Сам проект создается аналогично вышеприведенным примерам, в папку с проектом помещаются все требуемые файлы динамических библиотек и используемых шрифтов (см. примеры). 2. В параметрах проекта (меню «Проект/Параметры проекта», комбинация клавиш Alt+P), на вкладке «Параметры», в столбец «Компоновщик» добавляется строка, подключающая все три библиотеки: -lmingw32 -lSDLmain –lSDL –lSDL_draw –lSDL_ttf 3. Подключение и инициализация библиотеки SDL Для возможности вызова в программе функций из библиотеки SDL необходимо подключить заголовочный файл SDL.h (обращаем внимание, что путь к каталогу с ним уже включен в список дополнительных путей поиска заголовочных файлов согласно разд. 2): #include "SDL.h" Данный заголовочный файл включает в себя все остальные заголовочные файлы библиотеки SDL, поэтому подключения других не требуется. Заголовочные файлы всех рассматриваемых библиотек содержат для большинства функций достаточно подробные комментарии на английском языке, в том числе явное указание на то, какие функции являются «публичными» – для использования пользователями библиотеки, а какие лишь для ее реализации. При использовании среды разработки Dev-Cpp 4.9.9.2 следует также обратить внимание на то, что использование библиотеки SDL приводит к переопределению стандартного потока вывода stdout и стандартного потока ошибок stderr на одноименные файлы stdout и stderr в каталоге с исполняемым файлом программы. Также обращаем внимание на необходимость определения функ-ции main в соответствии с сигнатурой, используемой в библиотеке SDL, а именно следующим образом: int main(int argc, char *argv[]) 14 { /* тело функции main*/ } Непосредственно перед использованием функций библиотеки SDL необходимо инициализировать соответствующие ее подсистемы с помощью функции SDL_Init: extern DECLSPEC int SDLCALL SDL_Init(Uint32 flags); Важным является тип аргумента flags – целое число без знака, представленное 32 битами (4 байта). Для переносимости между платформами и различными компиляторами он объявлен как самостоятельный тип с помощью директив препроцессора, обес-печивающих условную трансляцию. С помощью данного парамет-ра указывается, какие именно подсистемы библиотеки требуется инициализировать и какие глобальные режимы использовать. Для этого объявлен ряд флагов, которые можно комбинировать с помощью операции побитового ИЛИ. Например, для ини- циализации подсистемы работы с дисплеем служит флаг SDL_INIT_VIDEO, для работы с таймером – SDL_INIT_TIMER, а для работы с подсистемой обработки звука – SDL_INIT_AUDIO. Для инициализации всех подсистем (вместо комбинации соот- ветствующих флагов) служит специальный флаг SDL_INIT_EVERYTHING. Поскольку каждый отдельный флаг устанавливает лишь один бит в параметре flags, а значение SDL_INIT_EVERYTHING объявлено как 0x0000FFFF, то его можно рассматривать как указание на инициализацию всех доступных подсистем SDL. Результат, возвращаемый функцией SDL_Init, указывает на успешность инициализации, если он равен нулю, или на ошибку инициализации в противном случае. При ошибке можно получить описание ошибки (также на английском языке) с помощью функции SDL_GetError: extern DECLSPEC char * SDLCALL SDL_GetError(void); Такое объявление позволяет использовать ее для формиро-вания сообщений о произошедших ошибках. Например, для вывода в поток stderr с помощью функции fprintf: /* объявление переменных */ if (SDL_Init(SDL_INIT_VIDEO)) /* инициализация SDL */ { /* При ошибке формируем сообщение и выходим */ fprintf(stderr,"Ошибка в SDL_Init: %s\n",SDL_GetError()); return 1; } Если инициализация была успешно выполнена, при последую-щем завершении работы программы необходимо вызвать функцию SDL_Quit (не имеющую параметров и не возвращающую никаких значений). Для гарантии вызова данной функции при любом завершении программы желательно установить ее как функцию, автоматически вызываемую при выходе из программы: /* Cразу после вышеприведенного фрагмента. Оператор выполняется при безошибочной инициализации SDL*/ atexit(SDL_Quit); Отображение графической информации в библиотеке SDL основано на понятии «поверхность». Поверхность логически представляет собой прямоугольную матрицу, состоящую из пик-селей определенного формата, на которой можно рисовать, изме-няя состояние пикселей. Набор возможных состояний пикселя определяется его форматом. Все пиксели одной поверхности име-ют одинаковый формат. Поэтому его также можно считать «фор-матом поверхности». Возможно и более сложное использование поверхностей, например для формирования изображения нало-жением изображений разных поверхностей. В программе каждая поверхность представляется указателем на структуру SDL_Surface. Данный указатель возвращают функции, создающие поверхности как объекты программы, и впоследствии они используются для указания поверхности при всех операциях с ними. Основное окно программы, возможно полноэкранное, 15 также является поверх-ностью, однако создающейся специальной функцией установки видеорежима SDL_SetVideoMode: extern DECLSPEC SDL_Surface * SDLCALL SDL_SetVideoMode (int width, int height, int bpp, Uint32 flags); Она возвращает либо корректный указатель на структуру SDL_Surface, соответствующую поверхности окна программы (или всего экрана), либо NULL в случае ошибки. Это позволяет контролировать возникновение ошибок при установке видео-режима в простейшем случае опять же с помощью функции SDL_GetError: /* в соответствующем месте объявляем указатель на поверхность: */ SDL_Surface *screen; /* ... */ /* После инициализации собственно SDL и установки atexit(SDL_Quit): */ screen=SDL_SetVideoMode(800,600,32,SDL_ANYFORMAT); if (!screen) { fprintf(stderr,"SDL mode failed: %s\n",SDL_GetError()); return 1; } Приведенный фрагмент также иллюстрирует параметры функции SDL_SetVideoMode. Первый параметр задает ширину окна или разрешение по горизонтали для полноэкранного режима, второй – высоту окна или разрешение по вертикали. Третий пара-метр задает глубину цвета – количество бит для представления цвета одного пикселя (BPP – bit-per-pixel). Если в качестве значе-ния третьего параметра указать ноль, то будет выбрана оптималь-ная глубина цвета для указанного разрешения (т.е. обеспечи-вающая наибольшее количество цветов при наименьших затратах на дополнительные программные преобразования, что определя-ется возможностями сочетания используемой в конкретном устройстве аппаратной части и ее драйверов). Четвертый параметр предназначен для указания специальных флагов задания видео-режима (часть из них применима и к другим поверхностям для рисования), в частности для указания на полноэкранный видео-режим, возможность изменения размера окна пользователем (по умолчанию отключено), определение расположения поверхности в системной памяти или видеопамяти, возможности асинхронного обновления. В простых случаях при использовании современных видеоадаптеров достаточно указать флаг SDL_ANYFORMAT, заставляющий инициализировать поверхность, даже если запро- шенная глубина цвета не поддерживается: практически любой современный видеоадаптер для персональных компьютеров, включая встраиваемые или интегрированные с процессором, поддерживают разрешение до 1920 на 1080 пикселей с глубиной цвета 32 бита на пиксель. Основным отличием поверхности, создаваемой функцией SDL_SetVideoMode, является соответствие каждому ее пикселю единственного пикселя окна программы (его рабочей области) или всего дисплея (при использовании полноэкранного режима). При вызове специальных функций обновления, рассматриваемых далее, это позволяет однозначно изменять состояние видимых на дисплее пикселей в соответствии с состоянием пикселей данной поверхности. Обратное неверно, поскольку, например, при много-оконном пользовательском интерфейсе часть окна программы может быть перекрыта окном другой программы и при его отобра-жении будет утрачена информация, оказавшаяся перекрытой другим окном. Но соответствующая окну поверхность остается неизменной, что позволяет после смещения перекрывшего окна другой программы полностью восстановить изображение в окне программы на дисплее повторным вызовом функции обновления. Библиотека SDL предусматривает также ряд функций, позво-ляющих проверить поддерживаемые аппаратной частью конкрет-ного компьютера видеорежимы, список видеорежимов или полу-чить параметры для «оптимального» видеорежима. Это функции SDL_GetVideoInfo, SDL_VideoModeOK, SDL_ListModes, которые рекомендуется рассмотреть самостоятельно. После инициализации видеорежима имеет смысл установить заголовок окна, соответствующий создаваемой программе. Для этого служит функция SDL_WM_SetCaption: extern DECLSPEC void SDLCALL SDL_WM_SetCaption (const char *title, const char *icon); 16 Первый параметр – указатель на начало последовательности байтов, заканчивающейся нулем и представляющей текст нового заголовка окна в кодировке utf-8, второй параметр – аналогичный указатель для используемого в некоторых операционных системах текста пиктограммы окна. Если второй параметр равен NULL, то текст пиктограммы не изменяется. Для поддерживаемых ОС семейства Microsoft Windows второй параметр игнориру- ется. Однако для предотвращения нежелательных эффектов его следует задавать равным NULL. Существует обратная функция SDL_WM_GetCaption, позволяющая получить текущий заголовок окна и текст пиктограммы окна. Фактическое поведение данных функций может зависеть от конкретной операционной системы и режима работы приложения. Например, понятие «заголовок окна» отсутствует в полноэкранном режиме или при задании соответ-ствующих параметров функции SDL_SetVideoMode. Непосредственное рисование на поверхности путем изменения состояния пикселей – достаточно трудоемкий процесс: требуется вычислить представление каждого компонента цвета для соответ-ствующей данной поверхности глубины цвета и положение битовых последовательностей, отвечающих за соответствующие компоненты конкретного пикселя для их изменения. Приведем лишь пример функции, обеспечивающей установку на поверх-ности screen для пикселя с координатами (x, y) цвета, заданного своими компонентами (R, G, B). Данная функция основана на примерах из введения в SDL (www.libsdl.org). По аналогии с Uint32, типы Uint8 и Uint16 соответствуют целым числам без знака, представляемым одним или двумя байтами. Функция SDL_MapRGB возвращает число, соответствующее ближайшему представимому в формате данной поверхности цвету, заданному своими компонентами. Формат поверхности (формат пикселей поверхности) можно получить с помощью компонента format структуры SDL_Surface. Этот компонент представляет собой указатель на структуру типа SDL_PixelFormat, описывающую формат пикселя поверхности, объем памяти, занимаемой одним пикселем, используемую для преобразования цветов (при необходимости) палитру. Возвращенное функцией SDL_MapRGB число может быть непосредственно записано в область памяти, отвечающую за цвет конкретного пикселя. Система координат в окне или на экране – ось X слева направо, ось Y сверху вниз, верхний левый угол имеет координаты (0,0), нижний правый – на единицу меньше ширины и высоты окна (разрешения экрана). Определение функции DrawPixel будет выглядеть следующим образом: void DrawPixel(SDL_Surface *screen, int x, int y, Uint8 R, Uint8 G, Uint8 B) { Uint32 color = SDL_MapRGB(screen->format, R, G, B); switch (screen->format->BytesPerPixel) { case 1: // Используем 8-bpp (бит на пиксель) { Uint8 *bufp = (Uint8 *)screen->pixels + /* pixels – указатель на начало области данных, описывающей состояние пикселей поверхности screen */ y*screen->pitch + x; /* pitch – количество байтов, занимаемых данными о пикселях одной строки */ *bufp = color; } break; case 2: // Возможно 15-bpp или 16-bpp { Uint16 *bufp = (Uint16 *)screen->pixels + y*screen->pitch/2 + x; /* Поскольку (Uint16 *)screen->pixels возвращает указатель на целое число, занимающее в памяти 2 байта, при вычислении смещения делим длину строки в байтах на 2 */ *bufp = color; } break; case 3: // Медленный режим 24-bpp, обычно не применяется { Uint8 *bufp = (Uint8 *)screen->pixels + 17 y*screen->pitch + x * 3; if(SDL_BYTEORDER == SDL_LIL_ENDIAN) { /* Учет возможного различия в порядке следования байтов в машинном слове различных процессорных архитектур */ bufp[0] = color; bufp[1] = color >> 8; bufp[2] = color >> 16; } else { bufp[2] = color; bufp[1] = color >> 8; bufp[0] = color >> 16; } } break; case 4: // Возможно 32-bpp... { Uint32 *bufp = (Uint32 *)screen->pixels + y*screen->pitch/4 + x; /* Поскольку (Uint32 *)screen->pixels возвращает указатель на целое число, занимающее в памяти 4 байта, при вычислении смещения делим длину строки в байтах на 4 */ *bufp = color; } break; } } |