Обнаружение функциональности

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

Независимо от какой функциональности Вы проверяете на, подход является тем же. Необходимо вызвать функцию OpenGL glGetString дважды. В первый раз передают GL_VERSION постоянный. Функция возвращает строку, указывающую версию OpenGL. Во второй раз, передача GL_EXTENSIONS постоянный. Функция возвращает указатель на дополнительную строку имени. Дополнительная строка имени является разделенным пробелами списком расширений OpenGL, поддерживающихся текущим средством рендеринга. Эта строка может быть довольно длинной, не выделяйте строку фиксированной длины для возвращаемого значения glGetString функция. Используйте указатель и оцените строку на месте.

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

Если расширение становится частью базового OpenGL API, OpenGL продолжает экспортировать строки имени способствовавших расширений. Это также продолжает поддерживать предыдущие версии любого расширения, экспортированного в более ранних версиях OS X. Поскольку расширения обычно не удаляются, методология, которую Вы используете сегодня для проверки на функцию, работает в будущих версиях OS X.

Проверка функциональность, несмотря на то, что довольно прямой, включает запись большого блока кода. Лучший способ проверить на функциональность OpenGL состоит в том, чтобы реализовать функцию проверки возможностей, которую Вы вызываете, когда Ваша программа запускает, и затем любое время изменения средства рендеринга. Перечисление 8-1 показывает выборку кода что проверки на несколько расширений. Подробное объяснение каждой строки кода появляется после перечисления.

  Проверка перечисления 8-1 функциональность OpenGL

GLint maxRectTextureSize;

GLint myMaxTextureUnits;

GLint myMaxTextureSize;

const GLubyte * strVersion;

const GLubyte * strExt;

float myGLVersion;

GLboolean isVAO, isTexLOD, isColorTable, isFence, isShade,

          isTextureRectangle;

strVersion = glGetString (GL_VERSION); // 1

sscanf((char *)strVersion, "%f", &myGLVersion);

strExt = glGetString (GL_EXTENSIONS); // 2

glGetIntegerv(GL_MAX_TEXTURE_UNITS, &myMaxTextureUnits); // 3

glGetIntegerv(GL_MAX_TEXTURE_SIZE, &myMaxTextureSize); // 4

isVAO =

    gluCheckExtension ((const GLubyte*)"GL_APPLE_vertex_array_object",strExt); // 5

isFence = gluCheckExtension ((const GLubyte*)"GL_APPLE_fence", strExt); // 6

isShade =

     gluCheckExtension ((const GLubyte*)"GL_ARB_shading_language_100", strExt); // 7

isColorTable =

     gluCheckExtension ((const GLubyte*)"GL_SGI_color_table", strExt) ||

             gluCheckExtension ((const GLubyte*)"GL_ARB_imaging", strExt); // 8

isTexLOD =

     gluCheckExtension ((const GLubyte*)"GL_SGIS_texture_lod", strExt) ||

                                  (myGLVersion >= 1.2); // 9

isTextureRectangle = gluCheckExtension ((const GLubyte*)

                                 "GL_EXT_texture_rectangle", strExt);

if (isTextureRectangle)

      glGetIntegerv (GL_MAX_RECTANGLE_TEXTURE_SIZE_EXT, &maxRectTextureSize);

else

     maxRectTextureSize = 0; // 10

Вот то, что делает код:

1. Получает строку, указывающую версию OpenGL.

2. Получает дополнительную строку имени.

3. Вызывает функцию OpenGL glGetIntegerv получить значение атрибута передало ему, который, в этом случае, является максимальным количеством модулей текстуры.

4. Получает максимальный размер текстуры.

5. Проверки, поддерживаются ли объекты массива вершины.

6. Проверки на расширение предела Apple.

7. Проверки на поддержку версии 1.0 языка штриховки OpenGL.

8. Проверки на поддержку таблицы цветов RGBA-формата. В этом случае код должен проверить на специфичную для поставщика строку и на строку ARB. Если любой присутствует, функциональность поддерживается.

9. Проверки на расширение имели отношение к параметру уровня детализации текстуры (ЛОД). В этом случае код должен проверить на специфичную для поставщика строку и на версию OpenGL. Если строка поставщика присутствует, или версия OpenGL больше, чем или равна 1,2, функциональность поддерживается.

10. Получает предел OpenGL для прямоугольных текстур. Для некоторых расширений, таких как прямоугольное расширение текстуры, может не быть достаточно проверить, поддерживается ли функциональность. Вы, возможно, также должны проверить пределы. Можно использовать glGetIntegerv и связанные функции (glGetBooleanv, glGetDoublev, glGetFloatv) получить множество значений параметров.

Можно расширить этот пример для создания проверяющей полную функциональность подпрограммы для приложения. Для получения дополнительной информации посмотрите GLCheck.c файл в Какао пример приложения OpenGL.

Код в Перечислении 8-2 показывает один способ запросить текущее средство рендеринга. Это использует API CGL, который можно вызвать из приложений Какао. В действительности необходимо выполнить итерации по всем дисплеям и всем средствам рендеринга для каждого дисплея для получения истинного изображения функциональности OpenGL, доступной в определенной системе. Также необходимо обновить функциональность, создают снимки каждый раз список дисплеев или выводят на экран изменения конфигурации.

Перечисление 8-2  , Настраивающее допустимый контекст рендеринга для получения информацию функциональности средства рендеринга

#include <OpenGL/OpenGL.h>

#include <ApplicationServices/ApplicationServices.h>

CGDirectDisplayID display = CGMainDisplayID (); // 1

CGOpenGLDisplayMask myDisplayMask =

                CGDisplayIDToOpenGLDisplayMask (display); // 2

{ // Check capabilities of display represented by display mask

    CGLPixelFormatAttribute attribs[] = {kCGLPFADisplayMask,

                             myDisplayMask,

                             0}; // 3

    CGLPixelFormatObj pixelFormat = NULL;

    GLint numPixelFormats = 0;

    CGLContextObj myCGLContext = 0;

    CGLContextObj curr_ctx = CGLGetCurrentContext (); // 4

    CGLChoosePixelFormat (attribs, &pixelFormat, &numPixelFormats); // 5

    if (pixelFormat) {

        CGLCreateContext (pixelFormat, NULL, &myCGLContext); // 6

        CGLDestroyPixelFormat (pixelFormat); // 7

        CGLSetCurrentContext (myCGLContext); // 8

        if (myCGLContext) {

            // Check for capabilities and functionality here

        }

    }

    CGLDestroyContext (myCGLContext); // 9

    CGLSetCurrentContext (curr_ctx); // 10

}

Вот то, что делает код:

1. Получает дисплей ID основного дисплея.

2. Отображает дисплей ID на маску OpenGL.

3. Заполняется формат пикселя приписывает массив с атрибутом маски дисплея и значением маски.

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

5. Получает объект формата пикселя для дисплея. numPixelFormats параметр указывает, сколько форматов пикселя перечислено в объекте формата пикселя.

6. Создает контекст на основе первого формата пикселя в списке, предоставленном объектом формата пикселя. Только одно средство рендеринга будет связано с этим контекстом.

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

7. Уничтожает объект формата пикселя, когда он больше не необходим.

8. Устанавливает текущий контекст в недавно создаваемый, контекст единственного средства рендеринга. Теперь Вы готовы проверить на функциональность, поддерживаемую текущим средством рендеринга. См. Перечисление 8-1 для примера проверяющего функциональность кода.

9. Уничтожает контекст, потому что он больше не необходим.

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

Инструкции для кода, проверяющего на функциональность

Инструкции в этом разделе гарантируют, что Ваш проверяющий функциональность код полон все же эффективный.

• Не полагайтесь на то, что находится в заголовочном файле. Объявление функции в заголовочном файле не гарантирует, что функция поддерживается текущим средством рендеринга. Ни один не делает соединение против тупиковой библиотеки, экспортирующей функцию.

• Удостоверьтесь, что средство рендеринга присоединено к допустимому контексту рендеринга перед проверкой функциональности того средства рендеринга.

• Проверьте версию API или дополнительную строку имени для текущего средства рендеринга перед выдачей команд OpenGL.

• Проверьте только один раз на средство рендеринга. После того, как Вы решили, что текущее средство рендеринга поддерживает команду OpenGL, Вы не должны проверять на ту функциональность снова для того средства рендеринга.

• Удостоверьтесь, что Вы знаете, используется ли функция как часть Ядра OpenGL API или как расширение. Когда опция реализована и как часть базового OpenGL API и как расширение, это использует различные константы и имена функций.

Средство рендеринга OpenGL зависящие от реализации значения

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

Несмотря на то, что спецификация обеспечивает всесторонний список этих ограничений, некоторые выделяются в большинстве приложений OpenGL. Табличные 8-1 списки оценивают это, приложения должны протестировать, если они требуют больше, чем минимальные значения в спецификации.

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