NewLights_settings

NewLights_settings is an e0 available in Black Mesa. This entity uses to dynamically change some settings for Black Mesa new light entities. For better understanding of this page - recommended at first familiarize yourself with new lights.

← Black Mesa Level Creation

Keyvalues

Name (targetname) <string>

The name that other entities refer to this entity by.

TargetNewLightEntity_Name (TargetNewLightEntity) <string>

Target Light Entity name

Here you enter name of new light source for which you want to apply changes. Works with multiple lights if they have the same name.

TransitionTime (TransitionTime) <integer>

TransitionTime in secs ( 0 for instant ) to transition into new settings. Its a lerp operation A + (B-A)*TimeFactor

LightType (LightType) <choices>

Type of light source for which you want to apply settings. Entity will not apply settings for spot lights if selected Point Light and will not apply settings for point lights if selected Spot Light.

• 0: Point Light
• 1: Spot Light

Enabled (Enabled) <integer>

Light Enabled or Disabled

Determines if the light turns on or turns off. 1 - turns on, 0 - turns off.

Light Ambient Color (LightColorAmbient) <color255>

This is the ambient color of the sunlight.

Determines color of shadows that light source creates.

Examples

0 0 0 255 0 0 255 128 128

Light Color (LightColor) <color255>

This is the color of the sunlight.

Determines color of light.

Appearance (FlareStyle) <choices>

Template:Light appearances

Light Intensity (Intensity) <float>

RGB * Intensity.

Brightness of the light.

Note:With 0 will not draw, process and specular shader be disabled.

SpecularMultiplier (SpecMultiplier) <float>

0 to 1 RGB * Intensity * SpecularMultiplier.

Brightness of the specular shader from this light source.

Examples

SpecularMultiplier - 1 SpecularMultiplier - 10 SpecularMultiplier - 20

Range (Range) <float>

Range.

How far the light source illuminates. Measured in Hammer Units.

Important:It greatly affects optimization, less is better.

Examples

Range - 150 Range - 300 Range - 500

falloffQuadratic (falloffQuadratic) <float> 

Deprecated.
falloffQuadratic

falloffLinear (falloffLinear) <float> 

Deprecated.
falloffLinear

falloffConstant (falloffConstant) <float> 

Deprecated.
falloffConstant

OuterAngle (phi) <float>

OuterAngle

Sets outer angle for spot light.

InnerAngle (theta) <float>

InnerAngle

Inner angle value for spot light.

AngularFallOff (angularFallOff) <float>

AngularFallOff

Sets angular falloff.

Note:Results depend on values of OuterAngle and InnerAngle.

Examples

AngularFallOff - 1 (OuterAngle - 60, InnerAngle - 30) AngularFallOff - 30 (OuterAngle - 60, InnerAngle - 30) AngularFallOff - 60 (OuterAngle - 60, InnerAngle - 30)

Inputs

InputApplySettings <void>

InputApplySettings Trigger to apply settings

See also

• godrays_settings
• newLight_Point
• newLight_Spot
• env_lensflare
• newLight_Dir
• env_cascade_light
• Lighting
• Adding Light
• Intermediate Lighting
• Advanced Lighting
• Effect flags (dynamic light effects)
• Tool textures (for Block light)
• BlackMesa XenEngine: Part 4 – Lighting & Shadows (page from Black Mesa developer about new lights)
• BlackMesa XenEngine: Part2 – How a Frame is Rendered (page from Black Mesa developer about how a frame rendered)
• BlackMesa XenEngine: Part1 – Heavily Modified Source Engine (page from Black Mesa developer about Black Mesa engine, better known as Xengine)

Todo: Clean up english. Add more issues if you'll find.