Skip to main content

light_barn

Point Entity

A cinematic barn door style light

Keyvalues

  • Units (brightness_units) <Choices>
    Brightness Units

    • Lumens (1)
    • EV (0)
    • Legacy (3)

  • Brightness (EV) (brightness) <Float>
    Brightness (EV)

  • Legacy (brightness_legacy) <Float>
    Legacy brightness value

  • Enabled (enabled) <Boolean>

  • Color (color) <Color255>

  • Color Temperature (K) (colortemperature) <Float>

  • Brightness (Lumens) (brightness_lumens) <Float>
    Brightness in lumens. (See Light Units group for alternative units of measurement).

  • Range (range) <Float>
    Clamps the distance that a light can reach.

  • Far Falloff (skirt) <Float>
    Controls the light falloff based on the set Range.

  • Near Falloff (skirt_near) <Float>
    Controls the light falloff from the light source.

  • Indirect Light Type (bouncelight) <Choices>
    How Indirect (bounce) light should be represented

    • None (0)
    • Static (1)

  • Indirect Light Multiplier (bouncescale) <Float>
    Increases the intensity of a lights' Indirect (bounce) light

  • Area Light Size (luminaire_size) <Float>
    Light source area size, this affects how light/shadows are diffused as they falloff from the light source - Larger sizes produce softer lighting. NOTE: Light Source Type: Point ignores this setting as it is not an area light

  • Area Light Width (luminaire_anisotropy) <Float>
    Scales the light source shape non-uniformly in x/y. NOTE: Light Source Type: Point ignores this setting as it is not an area light

  • Aperture Size(x,y,angle) (size_params) <Vector>
    Controls the size & shape of the barn light's aperture, allowing for emulation of many different light types.

  • Aperture Shape (shape) <Float>
    Blends between a circular or rectangular aperture

  • Aperture Softness X (soft_x) <Float>

  • Aperture Softness Y (soft_y) <Float>

  • Angle Shear (shear) <Vector2d>
    Skews the light angle in x/y.

  • Cookie (lightcookie) <Resource>
    Choose a light cookie texture (.vtex) to represent your light shape.

  • Bake Specular to Cubemaps (bakespeculartocubemaps) <Choices>
    Bake specular into cubemaps. Only works when Direct Lighting Type is set to Baked.

    • None (0)
    • Disk (2)
    • Rectangle (1)

  • Bake Specular to Cubemaps Size (bakespeculartocubemaps_size) <Vector>

  • Specular Softness (minroughness) <Float>
    USE WITH CAUTION: Artificially softens direct specular (not cubemaps) to simulate cheap, soft area lights. Note: Direct Lighting must be set to Stationary or Dynamic for this to have an effect.

  • Shadow Map Resolution (shadowmapsize) <Choices>

    • 4096 (4096)
    • 3584 (3584)
    • 3072 (3072)
    • 2560 (2560)
    • 2048 (2048)
    • 1536 (1536)
    • 1024 (1024)
    • 512 (512)
    • Default (-1)

  • Shadow Priority (shadowpriority) <Choices>

    • Highest (100)
    • High (10)
    • Medium (5)
    • Low (-5)
    • Default (-1)

  • Transmit Shadow Casters to Client (pvs_modify_entity) <Boolean>
    When this light is visible to a player, add its shadow casters to the player's PVS.

  • Shadow Fade Out Start Size (shadowfade_size_start) <Float>
    Screen size where the shadows will begin fading out

  • Shadow Fade Out End Size (shadowfade_size_end) <Float>
    Screen size where the shadows will be fully faded out

  • Render Light in Cubemaps (rendertocubemaps) <Boolean>
    If true, illumination from this light renders into baked cube maps.

  • Brightness Scale (brightnessscale) <Float>
    Scale brightness by this amount, used for scripting direct light behaviour. NOTE: Only works on lights with Direct Lighting type set to Dynamic or Stationary.

  • Light Fade Out Start Size (fade_size_start) <Float>
    Screen size where the light will begin fading out

  • Light Fade Out End Size (fade_size_end) <Float>
    Screen size where the light will be fully faded out

  • Style (light_style) <VDataChoice>
    Light Style

  • Style Output Event 0 (light_style_output_event0) <VDataChoice>
    Name of the event that triggers the OnStyleEvent0 output.

  • Style Output Event 1 (light_style_output_event1) <VDataChoice>
    Name of the event that triggers the OnStyleEvent1 output.

  • Style Output Event 2 (light_style_output_event2) <VDataChoice>
    Name of the event that triggers the OnStyleEvent2 output.

  • Style Output Event 3 (light_style_output_event3) <VDataChoice>
    Name of the event that triggers the OnStyleEvent3 output.

  • Style Target 0 (light_style_target0) <TargetDestination>
    Sets $light_emissive for use in material expressions. The emissive geometry's surface area should be approximately equal to the area light's surface area.

  • Style Target 1 (light_style_target1) <TargetDestination>
    Sets $light_emissive for use in material expressions. The emissive geometry's surface area should be approximately equal to the area light's surface area.

  • Style Target 2 (light_style_target2) <TargetDestination>
    Sets $light_emissive for use in material expressions. The emissive geometry's surface area should be approximately equal to the area light's surface area.

  • Style Target 3 (light_style_target3) <TargetDestination>
    Sets $light_emissive for use in material expressions. The emissive geometry's surface area should be approximately equal to the area light's surface area.

  • Color Mode (colormode) <Choices>
    How to calculate the light's color

    • Color (0)
    • Color Temperature (1)
    • Color (0)
    • Color Temperature (1)

  • Create Client-Only Entity (clientSideEntity) <Choices>

    • No (0)
    • Yes (1)

  • Cast Shadows (castshadows) <Choices>
    Whether this light casts shadow

    • No (0)
    • Baked & Dynamic (1)
    • Baked Only (2)
    • No (0)
    • Static & Dynamic (1)
    • Static Only (2)

  • Force Shadows Enabled (forceshadowsenabled) <Boolean>
    Always enable shadows for this light, regardless of any global settings.

  • Direct Lighting Type (directlight) <Choices>
    How direct lighting should be represented: Static=Fully baked into lightmap (cheapest), Stationary=Dynamic direct light with baked shadows, Dynamic=Fully dynamic (Most expensive)

    • None (0)
    • Static (1)
    • Stationary (3)
    • Dynamic (2)
    • None (0)
    • Static (1)
    • Stationary (3)
    • Dynamic (2)

  • Light Source Type (luminaire_shape) <Choices>
    Point or area light shapes. Point produces sharp shadows whereas Disk and Rectangle are area lights, with shadow softness/falloff influenced by the Area Light Size/Width.

    • Disk (Area Light) (1)
    • Rectangle (Area Light) (2)
    • Point (0)
    • Disk (Area Light) (1)
    • Rectangle (Area Light) (2)

Inputs

  • Enable <Void>
    Turn on the light.

  • Disable <Void>
    Turn off the light.

  • Toggle <Void>
    Toggle the light.

  • SetColor <Color255>
    Set the light's color.

  • SetColorTemperature <Float>
    Set the light's color temperature in Kelvin.

  • SetBrightness <Float>
    Set the light's brightness in EV.

  • SetBrightnessScale <Float>
    Set the light's brightness multiplier, which defaults to 1.

  • SetStyle <String>
    ',' separated list of styles from light_styles.vdata to play in sequence. The last entry will loop. The last style can be 'on'/'off' to enable/disable the light with no light style.

  • SetFogStrength <Float>
    Set the fog strength.

  • SetFogScale <Float>
    Set the fog multiplier, which defaults to 1.

Outputs

  • OnStyleEvent0 <Void>
    Fired when the current light style plays an event of the type specified by Style Output Event 0.

  • OnStyleEvent1 <Void>
    Fired when the current light style plays an event of the type specified by Style Output Event 1.

  • OnStyleEvent2 <Void>
    Fired when the current light style plays an event of the type specified by Style Output Event 2.

  • OnStyleEvent3 <Void>
    Fired when the current light style plays an event of the type specified by Style Output Event 3.