renderingMode

renderingMode — Controls the way OpenGL renders objects.

Synopsis




enum        RenderingModeId;
void        openGLInit_renderingMode        ();
gboolean    openGLSet_globalRenderingMode   (RenderingModeId value);
RenderingModeId openGLGet_globalRenderingOption
                                            ();
void        openGLApply_renderingMode       (RenderingModeId mode);

Description

This modules creates an interface to access to the way OpenGL renders the objects (glPolygonMode() and glShadeModel() functions). There are then three rendering modes available in V_Sim: wireframe, flat and smooth. They are controls by an enum RenderingModeId. When openGLApply_renderingMode() is called, the current rendering mode is changed for all future drawing calls that uses polygons.

Details

enum RenderingModeId

typedef enum
  {
    Wireframe,
    Flat,
    Smooth,
/*     SmoothAndEdge, */
    nb_renderingModes
  } RenderingModeId;

Implemented mode to draw objects.

Wireframe objects are rendered with lines only ;
Flat objects are rendered with polygons whose colours are uniform on each polygon ;
Smooth objects are rendered with polygons whose colours are shaded to be smooth all along the object.
nb_renderingModes number of rendering mode.

openGLInit_renderingMode ()

void        openGLInit_renderingMode        ();

This method is used by opengl.c to initialise this module (declare config file options...). It should not be called elsewhere.

openGLSet_globalRenderingMode ()

gboolean    openGLSet_globalRenderingMode   (RenderingModeId value);

This function change the value of the parameter renderingOption. It controls how V_Sim renders objects, in wireframe for example.

value : an integer to represent the method of rendering.
Returns : TRUE if the signal OpenGLAskForReDraw should be emitted.

openGLGet_globalRenderingOption ()

RenderingModeId openGLGet_globalRenderingOption
                                            ();

This function retrieve the value of the parameter renderingOption.

Returns : the identifier of the current rendering option.

openGLApply_renderingMode ()

void        openGLApply_renderingMode       (RenderingModeId mode);

Change the rendering mode of current OpenGL context.

mode : an integer.