Препроцессинг в GLSL (OpenGL Shading Language) – это механизм обработки кода перед его компиляцией. Он позволяет управлять кодом шейдера с помощью макросов, условных конструкций и подключения расширений. Это особенно полезно для оптимизации, кроссплатформенности и гибкой настройки шейдеров.
В этой статье мы разберем, как работает препроцессинг в GLSL, какие директивы доступны и где его можно применять.
Основные директивы препроцессора
Препроцессор в GLSL работает по принципу текстовой подстановки: он заменяет или удаляет части кода перед тем, как шейдер будет скомпилирован. Рассмотрим основные директивы, доступные в GLSL.
1. #version – указание версии GLSL
Каждый шейдер должен начинаться с указания версии языка:
Эта строка сообщает компилятору, какую версию GLSL использовать. Если версия не указана, компилятор может выбрать устаревший стандарт, который не поддерживает современные возможности.
2. #define – макросы
Позволяет объявлять константы или заменять выражения перед компиляцией.
float getCircleArea(float radius) {
return PI * radius * radius;
}
Также можно использовать #define для создания “псевдо-функций”:
float lengthSquared(vec3 v) {
return SQR(v.x) + SQR(v.y) + SQR(v.z);
}
3. #undef – удаление макроса
Если нужно отменить ранее объявленный #define, можно использовать #undef:
#undef USE_TEXTURE
После #undef USE_TEXTURE код больше не будет считать USE_TEXTURE определенным.
4. #ifdef, #ifndef, #endif – условная компиляция
Позволяет включать или исключать части кода в зависимости от наличия определенного макроса.
#ifdef USE_LIGHTING
uniform vec3 lightColor;
#endif
Если USE_LIGHTING определен, переменная lightColor будет объявлена. Если нет – этот код игнорируется.
Аналогично работает #ifndef, но наоборот – блок кода компилируется только если макрос НЕ определен
// Код, который выполняется, только если DEBUG_MODE не включен
#endif
5. #if, #elif, #else, #endif – условия на основе значений
Позволяют проверять значения макросов и менять код в зависимости от их значений.
#if QUALITY == 1
vec3 color = vec3(0.5);
#elif QUALITY == 2
vec3 color = vec3(1.0);
#else
vec3 color = vec3(0.0);
#endif
Если QUALITY == 1, будет использован один вариант кода, если QUALITY == 2 – другой, а в остальных случаях – третий.
6. #error – вызов ошибки
Если нужно прервать компиляцию с сообщением об ошибке, используется #error:
#error "Макрос MAX_LIGHTS не определен!"
#endif
Компилятор выдаст сообщение “Макрос MAX_LIGHTS не определен!”, если он не был объявлен.
7. #pragma – директивы компилятора
Эта директива используется для управления поведением компилятора, но в стандартном GLSL редко встречается. Пример из OpenGL ES:
8. #extension – подключение расширений
Некоторые возможности OpenGL требуют включения расширений. Это делается с помощью `#extension`:
Синтаксис:
Режимы:
- – enable – включает расширение
- – require – требует его наличия (иначе ошибка)
- – disable – отключает
- – warn – выдаёт предупреждение при использовании
Где используется препроцессинг?
Препроцессор в GLSL применяется в разных сценариях:
- Оптимизация производительности
Можно отключать ненужные эффекты в зависимости от аппаратных возможностей или настроек игрока. - Разные конфигурации шейдеров
Например, можно менять количество источников света или качество рендеринга без редактирования самого кода. - Кроссплатформенная разработка
Разные GPU и версии OpenGL могут поддерживать разные возможности. С помощью `#ifdef` можно писать универсальные шейдеры. - Удобство отладки
Можно добавлять отладочные макросы, чтобы включать и выключать дополнительные проверки.
#ifdef DEBUG_MODE
vec3 debugColor = vec3(1.0, 0.0, 0.0); // Красный цвет для отладки
#endif
Заключение
Препроцессинг в GLSL – мощный инструмент, который позволяет гибко управлять кодом шейдеров. С его помощью можно:
- Оптимизировать шейдеры
- Создавать адаптивные эффекты
- Делать код более удобным и читаемым