Content creators can define values for the lighting parameters in the JSON configuration file.
Each lighting option has specific sub-parameters to adjust how the lighting interacts with a scene. The following sub-parameters are available for multiple lighting options:
- auto_updating_lighting – determines if the scene should use ARKit’s scene lighting calculations to adjust the intensity based on lighting in the real environment
- color – color of the light in RGB; defaults to 255, 255, 255 (white)
- direction – direction of the light as an Euler vector with X, Y, and Z coordinates in radians; defaults to -1.57, 0, 0
- The value -1.57 represents -π/2. The default direction points directly down from the origin.
- intensity – intensity of the light in lumens; defaults to 1000
- position – position of the light with respect to the origin; defaults to 0, 0, 0 (origin)
- temperature – temperature of the light in Kelvin; defaults to 6500
ambient_lighting
|
An ambient light is a soft light without a source or a direction. It illuminates a scene without casting shadows.
There can only be one ambient light in a scene.
|
- auto_updating_lighting
- enabled
- true
- false – Disables all ambient lighting, including the standard ARKit lighting
- auto (default) – Ignores custom parameters and uses the default standard ARKit ambient lighting
- intensity
|
directional_lighting
|
A directional light is a light source pointing in a specific direction.
There can be multiple directional lights in a scene.
|
- auto_updating_lighting
- color
- direction
- intensity
- temperature
|
omni_lighting
|
An omni light is a light source pointing in every direction.
There can be multiple omni lights in a scene.
|
- auto_updating_lighting
- color
- intensity
- position
- temperature
|
spot_lighting
|
A spot light is a light source pointing at a target object composed of two concentric cones. The inner cone illuminates the target at maximum brightness. The outer cone partially illuminates the target and defines the maximum area of illumination.
There can be multiple spotlights in a scene.
|
- auto_updating_lighting
- color
- direction
- inner_angle – angle of the inner cone in degrees
- intensity
- outer_angle – angle of the outer cone in degrees
- position
- temperature
|