Light element enables users to add sources of light for their 3D animations.
However, if you need to modify the default lighting, you can add your own sources of light and control their position, color, direction (optionally) and attenuation.
AnyLogic provides you with the predefined and ready for use standard types of the light source:
To add a source of light onto presentation
Please note that the light is shining on the 3D scene "from above" when angle X is positive.
Name – The name of this source of light. It is used to identify the source and to access it from code.
Ignore – If selected, the source of light will be excluded from the model.
Visible on upper agent – If selected, the source will also shine on the upper agent where this agent lives.
Predefined type – Here you can choose one of the standard types of the sources of light: Street light, Car headlight, Daylight, Moonlight, or Custom (in this case you can manually configure all light source properties, which you will find below).
Color – [Visible if Custom is not chosen for Predefined type] Here you can define the color of the light source.
Light source type – [Visible if Predefined type is set to Custom] The type of the light source: Ambient, Directional, Point, and Spot.
- [Visible if
Light source type
Here you can define the attenuation factor for the point/spot source of
light. To be precise, you define the following components of
Linear. Below you can find the formula that is used to calculate the attenuation factor:
where = constant attenuation
= linear attenuation.
Cut off angle - [Visible if Light source type is Spot] Here you can define the maximum angle of light dispersion. In particular, you specify the half of the angle in the vertex of the cone of light created by this source (the value is specified in degrees, from 0 to 90).
Drop off rate
- [Visible if
Light source type
Here you can specify how quickly the light will fade as we move from
the axis of the cone of the light. 0 means there is no drop off and the
light will have uniform intensity everywhere in the cone.
Level – Level where this light source belongs to.
X – * The x-coordinate of the source.
Y – * The y-coordinate of the source.
Z – * The z-coordinate of the source.
Angle X – ** The angle that light direction composes with YZ plane (starting from inverted Y axis, clockwise, in degrees).
– ** The angle that light direction composes with XY plane (starting from inverted Y axis, clockwise, in degrees).
* – Enabled if the type of the light source is set to Street light, Car headlight, Custom: Point, Custom: Spot.
** – Enabled if the type of the light source is set to Car headlight, Custom: Directional, Custom: Spot.
Enabled – Here you can specify Boolean expression determining whether the source of light is enabled (if the expression returns true) or disabled (if it returns false).
Show name – If selected, the name of this element will be displayed on the presentation diagram.
AnyLogic supports four types of light sources: Ambient, Directional, Point and Spot.
Shapes lit by ambient light look like 2D shapes. The reason is that the source of ambient light can be considered as a set of uniformly distributed sources of lights all over the 3D space.
Directional source of light is located in some infinitely distant point. It shines in the specified direction (it is defined using light's advanced properties Angle X and Angle Z). The Sun is a good example of a directional source of light.
To switch a directional source of light
Point source of light is located in one particular point of space. It shines uniformly in all directions. You can define an attenuation coefficient for this kind of source of light.
Spot source of light is a particular case of a point light. Spot source creates a beam of light that gradually becomes wider and makes a cone of light. You can think of a spot source of light as a searchlight or a car headlight.
API Reference: Light3D Class