Scilab Home page | Wiki | Bug tracker | Forge | Mailing list archives | ATOMS | File exchange
Please login or create an account
Change language to: English - Português - 日本語 - Русский

Please note that the recommended version of Scilab is 6.0.0. This page might be outdated.
See the recommended documentation of this function

Aide de Scilab >> Graphiques > lighting > light properties

light properties

Light overview

Description

The light entity contains the properties to change lighting appearance. Lights aren't visible in the axes but they affect the surface appearance (see lighting for a detailed explanation about lighting).

Lights can be created using light function, and deleted using delete function.

Light properties list

visible:

This field defines if the light is enabled "on" or disabled "off".

light_type:

This field defines the type of light used. There are two types available:"directional" and "point". Directional lights are positioned infinitely far from the surface thus emitting parallel rays.

Point lights are defined as a point in space thus emitting rays in all directions. The default value is "point".

direction:

This field defines the ray direction for directional light. The direction can be chaged using a 3 element vector "[x, y, z]" representing a vector starting from the origin.

The default value is "[0 0 1]".

position:

This field defines the light position for point light. The position can be changed using a 3 element vector "[x, y, z]".

The default value is "[0 0 1]".

ambient_color:

This field defines the ambient color of the light. The color is defined by a 3 element vector "[red, green, blue]" with each element in the range [0, 1].

The default value is "[0.1 0.1 0.1]".

diffuse_color:

This field defines the diffuse color of the light. The color is defined by a 3 element vector "[red, green, blue]" with each element in the range [0, 1].

The default value is "[1 1 1]".

specular_color:

This field defines the specular color of the light. The color is defined by a 3 element vector "[red, green, blue]" with each element in the range [0, 1].

The default value is "[1 1 1]".

Examples

// point light
plot3d;l=light();s=gce();
for i=0:1000
    sleep(5);
    x = 2*cos(i*%pi/180);
    y = 2*sin(i*%pi/180);
    z = 2;
    l.position = [x y z];
end

// change light to directional mode
l.light_type = "directional";
l.direction = [1 0 1];
l.ambient_color = [0.1 0.1 0.1];
s.diffuse_color = [0.4 0.4 0.4];
s.use_color_material = "off";
s.color_flag = 0;
s.thickness = 0;
s.hiddencolor = -1;
s.specular_color = [0.6 0.6 0.6];
sleep(5000);

l2 = light(ambient_color=[0 0 0], diffuse_color = [0.8 0.8 1], type="point", position=[0 3 4]);
sleep(5000);
delete(l);
l2.specular_color = [1 0.6 0];

See Also

  • lighting — Lighting overview
  • light — creates a light object in the given axes
  • delete — delete a graphic entity and its children.
Scilab Enterprises
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Thu Oct 02 13:54:34 CEST 2014