LightEmitter

The LightEmitter ModularScatter component allows for scatters to provide their own light based on numerous arguments. Most arguments are optional.

Performance warning #

This feature can be quite performance heavy if used on a scatter type that has a large amount of objects per quad. Less than 5-20 scatters per quad is alright, higher numbers will start to have a quite noticeable impact.

LandControl
{
    ...
    Scatters
    {
        Value
        {
            ...
            Components
            {
                LightEmitter
                {
                    type = Point
                    color = 0.85,0.88,1,1
                    range = 3000
                    intensity = 6
                    offset = 0,0,0
                }
            }
        }
    }
}

Property	Format	Description
type	LightType	The type of light to be emitted from the scatter. Values are Spot, Directional (more resource-intensive), Point, Rectangle (rectangle-shaped area light that affects only baked lightmaps and lightprobes), or Disc (disc-shaped area light that affects only baked lightmaps and lightprobes).
color	Color	The color of light to be emitted.
colorTemperature	Decimal	The color temperature of the light. Correlated Color Temperature (abbreviated as CCT) is multiplied with the color filter when calculating the final color of a light source. The color temperature of the electromagnetic radiation emitted from an ideal black body is defined as its surface temperature in Kelvin. White is 6500K according to the D65 standard. Candle light is 1800K.
intensity	Decimal	The intensity of the light.
bounceIntensity	Decimal	The intensity of the light after bouncing off a surface?
shadows	LightShadows	The shadow that the light should cast. Values are None, Hard, and Soft. Default is None.
shadowStrength	Decimal	The strength of the shadows formed by the light.
shadowResolution	LightShadowResolution	The resolution of the shadow map. Values are FromQualitySettings, Low, Medium, High, and VeryHigh.
shadowCustomResolution	Integer	The custom resolution of the shadow map. By default, shadow map resolution is computed from its importance on screen. Setting this property to a value greater than zero will override that behavior. Please note that the shadow map resolution will still be rounded to the nearest power of two and capped by memory and hardware limits.
shadowBias	Decimal	Shadow mapping constant bias. Shadow caster surfaces are pushed by this world-space amount away from the light, to help prevent self-shadowing ("shadow acne") artifacts.
shadowNormalBias	Decimal	Shadow mapping normal-based bias. Shadow caster surfaces are pushed inwards along their normals by this amount, to help prevent self-shadowing ("shadow acne") artifacts. Units of normal-based bias are expressed in terms of shadowmap texel size; typically values between 0.3-0.7 work well. Larger values prevent shadow acne better, at expense of making shadow shape smaller than the object actually is. Currently normal-based bias is only implemented for directional lights; it has no effect for other light types.
shadowNearPlane	Decimal	Near plane value to use for shadow frustums. This determines how close to the light shadows will stop being rendered from an object.
range	Decimal	The range of the light. (in meters?)
spotAngle	Decimal	The angle of the light's spotlight cone in degrees. This is used primarily for Spot lights and has no effect for Point lights.
innerSpotAngle	Decimal	The angle of the light's spotlight inner cone in degrees. This is only used for Spot lights.
cookieSize	Decimal	The size of a directional light's cookie.
cookie	File Path	The path to the cookie texture projected by the light. If the cookie is a cube map, the light will become a Point light. Note that cookies are only displayed for pixel lights.
flare	Flare	The flare asset to use for this light.
renderMode	LightRenderMode	How to render the light. Pixel lights render slower but look better, especially on not very highly tesselated geometry. Some effects (e.g. bumpmapping) are only displayed for pixel lights. Values are Auto, ForcePixel, and ForceVertex.
cullingMask	Integer	(Optional) This is used to light certain objects in the Scene selectively. An object will only be illuminated by a light if that light's cullingMask includes the layer chosen for the object (ie, the mask bit for the layer must be set to 1 for the object to receive any light).
useBoundingSphereOverride	Boolean	Whether to override the light bounding sphere for culling.
boundingSphereOverride	Vector4	Bounding sphere used to override the regular light bounding sphere during culling.
renderingLayerMask	Integer	Determines which rendering layer mask the light affects.
lightShadowCasterMode	LightShadowCasterMode	Allows you to override the global Shadowmask Mode per light. Values are Default, NonLightmappedOnly, and Everything.
layerShadowCullDistances	Float List	(Optional) A list of 32 per-light, per-layer shadow culling distances. Dynamic shadows can be cast into view from shadow casters that are very far away from the camera. At low incident light angles, this can lead to a lot of objects needing to cast dynamic shadows, which in turn can result in high rendering costs during shadow maps generation. Using layerShadowCullDistances lets you limit, on a per-layer basis, how far from the camera shadows casters are allowed to be before they get culled from shadow maps generation. The feature complements Camera.layerCullDistances, but only affects shadow casting, not regular object rendering. Just like Camera.layerCullDistances, layerShadowCullDistances requires that you assign a float array of exactly 32 values. A distance of 0 in a layer's index means keep current behaviour for that layer. Assigning null completely disables shadow distance culling, and is effectively the same as passing an array of 32 zeros.
offset	Vector3	(Optional) The offset of the light, relative to the center of the scatter object. Defaults to 0,0,0.