SCNShadable

Константы

• SCNShaderModifierEntryPointGeometry

  SCNShaderModifierEntryPointGeometry

  Используйте эту точку входа, чтобы деформировать поверхность геометрии или изменить ее атрибуты вершины.

  Модификаторы программы построения теней для этой точки входа выполняются в стадии обработки вершины.

  Точка входа геометрии объявляет следующую структуру GLSL:

  • struct SCNShaderGeometry {
  • vec3 position;
  • vec3 normal;
  • vec4 tangent;
  • vec2 texcoords[kSCNTexcoordCount];
  • } _geometry;

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

  position, normal, и tangent поля выражены в пространстве модели. Можно использовать универсальные формы SceneKit (такой как u_modelViewTransform) для работы в различном координатном пространстве но необходимо преобразовать назад в пространство модели прежде, чем записать результаты.

  kSCNTexcoordCount переменная является постоянным целым числом, соответствующим числу геометрии источников координаты текстуры. Каждый набор координат в texcoords поле содержит необработанные значения от геометрии — SceneKit применяется contentsTransform трансформация (если таковые имеются) после модификатора программы построения теней геометрии завершается.

  Ниже модификатора программы построения теней производит анимированную синусоидальную деформацию:

  • uniform float Amplitude = 0.1;
  • _geometry.position +=
  • _geometry.normal *
  • (Amplitude*_geometry.position.y*_geometry.position.x) *
  • sin(1.0 * u_time);

  Доступный в OS X v10.9 и позже.

• SCNShaderModifierEntryPointSurface

  SCNShaderModifierEntryPointSurface

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

  Модификаторы программы построения теней для этой точки входа выполняются в стадии обработки фрагмента.

  Поверхностная точка входа определяет следующую структуру GLSL:

  • struct SCNShaderSurface {
  • vec3 view; // Direction from the point on the surface toward the camera (V)
  • vec3 position; // Position of the fragment
  • vec3 normal; // Normal of the fragment (N)
  • vec3 tangent; // Tangent of the fragment
  • vec3 bitangent; // Bitangent of the fragment
  • vec4 ambient; // Ambient property of the fragment
  • vec2 ambientTexcoord; // Ambient texture coordinates
  • vec4 diffuse; // Diffuse property of the fragment. Alpha contains the opacity.
  • vec2 diffuseTexcoord; // Diffuse texture coordinates
  • vec4 specular; // Specular property of the fragment
  • vec2 specularTexcoord; // Specular texture coordinates
  • vec4 emission; // Emission property of the fragment
  • vec2 emissionTexcoord; // Emission texture coordinates
  • vec4 multiply; // Multiply property of the fragment
  • vec2 multiplyTexcoord; // Multiply texture coordinates
  • vec4 transparent; // Transparent property of the fragment
  • vec2 transparentTexcoord; // Transparent texture coordinates
  • vec4 reflective; // Reflective property of the fragment
  • float shininess; // Shininess property of the fragment.
  • float fresnel; // Fresnel property of the fragment.
  • } _surface;

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

  Геометрические поля (такой как position и normal) выражены в поле зрения пространство. Можно использовать универсальные формы SceneKit (такой как u_inverseViewTransform) для работы в различном координатном пространстве но необходимо преобразовать назад для просмотра пространства прежде, чем записать результаты.

  Другие поля типа vec4 цвета, предоставленные содержанием соответствия SCNMaterialProperty объект. Поля координаты текстуры содержат значения, преобразованные соответствующей материальной собственностью contentsTransform трансформация.

  Ниже модификатора программы построения теней производит черные и белые дорожки на поверхности:

  • uniform float Scale = 12.0;
  • uniform float Width = 0.25;
  • uniform float Blend = 0.3;
  • vec2 position = fract(_surface.diffuseTexcoord * Scale);
  • float f1 = clamp(position.y / Blend, 0.0, 1.0);
  • float f2 = clamp((position.y - Width) / Blend, 0.0, 1.0);
  • f1 = f1 * (1.0 - f2);
  • f1 = f1 * f1 * 2.0 * (3. * 2. * f1);
  • _surface.diffuse = mix(vec4(1.0), vec4(0.0), f1);

  Доступный в OS X v10.9 и позже.

• SCNShaderModifierEntryPointLightingModel

  SCNShaderModifierEntryPointLightingModel

  Используйте эту точку входа для обеспечения пользовательского уравнения освещения.

  Модификаторы программы построения теней для этой точки входа могут выполниться или в вершине или в стадии обработки фрагмента. Если litPerPixel свойство материала, затронутого модификатором программы построения теней, YEStrue, отрывок выполняется в стадии обработки фрагмента; иначе отрывок выполняется в стадии обработки вершины.

  Поверхностная точка входа определяет следующие структуры GLSL:

  • struct SCNShaderLightingContribution {
  • vec3 ambient;
  • vec3 diffuse;
  • vec3 specular;
  • } _lightingContribution;
  • struct SCNShaderLight {
  • vec4 intensity;
  • vec3 direction; // Direction from the point on the surface toward the light (L)
  • } _light;

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

  Все поля в _lightingContribution структура и intensity поле в _light структура является цветами. direction поле выражено в поле зрения пространство.

  Модификатор программы построения теней ниже оберток рассеянное освещение — т.е. это увеличивает все входные стоимости освещения 0.5, и если получающееся значение больше, чем 1.0 это «повторяется» назад к 0.0:

  • uniform float WrapFactor = 0.5;
  • float dotProduct = (WrapFactor + max(0.0, dot(_surface.normal,_light.direction))) / (1 + WrapFactor);
  • _lightingContribution.diffuse += (dotProduct * _light.intensity.rgb);
  • vec3 halfVector = normalize(_light.direction + _surface.view);
  • dotProduct = max(0.0, pow(max(0.0, dot(_surface.normal, halfVector)), _surface.shininess));
  • _lightingContribution.specular += (dotProduct * _light.intensity.rgb);

  Доступный в OS X v10.9 и позже.

• SCNShaderModifierEntryPointFragment

  SCNShaderModifierEntryPointFragment

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

  Модификаторы программы построения теней для этой точки входа выполняются в стадии обработки фрагмента.

  Точка входа фрагмента определяет следующую структуру GLSL:

  • struct SCNShaderOutput {
  • vec4 color;
  • } _output;

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

  Этот модификатор программы построения теней инвертирует цвет вывода:

  • _output.color.rgb = vec3(1.0) - _output.color.rgb;

  Доступный в OS X v10.9 и позже.