3.1.2 Lighting

There are several functions for setup lighting. The general function is Light(bool) which switch on/off the lighting for overall plot. It influence only for graphics which created after Light() call (with one exception, mglGraphGL). Generally MathGL support up to 10 independent light sources. But in OpenGL mode only 8 of light sources is used due to OpenGL limitations. The position, color, brightness of each light source can be set separately. By default only one light source is active. It is source number 0 with white color, located at top of the plot.

Method on mglGraph (C++, Python): bool Light (bool enable)

C function: void mgl_set_light (HMGL gr, int enable)

Sets the using of light on/off for overall plot. Function returns previous value of lighting. Default value is lightning off.

Method on mglGraph (C++, Python): void Light (int n, bool enable)

C function: void mgl_set_light_n (HMGL gr, int n, int enable)

Switch on/off n-th light source separately.

Method on mglGraph (C++, Python): void AddLight (int n, float x, float y, float z, char c='w')

Method on mglGraph (C++): void Light (int n, mglPoint p, char c='w', float bright=0.5, bool infty=true)

Method on mglGraph (C++): void Light (int n, mglPoint p, mglColor c, float bright=0.5, bool infty=true)

C function: void mgl_add_light (HMGL gr, int n, float x, float y, float z, char c)

The function adds a light source with identification n at position p with color c and with brightness bright (which must be in range [0,1]). Flag infty=true puts the source to infinite distance (for the faster drawing).

Method on mglGraph (C++, Python): void Ambient (float bright=0.5)

C function: void mgl_set_ambbr (HMGL gr, float bright)

Sets the brightness of ambient light. The value should be in range [0,1].