![]() |
![]() |
![]() |
V_Sim API - Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
enum VisuRenderingModeId; void openGLInit_renderingMode (void
); gboolean openGLSet_globalRenderingMode (VisuRenderingModeId value
); VisuRenderingModeId openGLGet_globalRenderingOption (void
); gboolean openGLGet_renderingFromName (const char *name
,VisuRenderingModeId *id
); const char** openGLGet_allRenderingModes (void
); const char** openGLGet_allRenderingModesI18n (void
); void openGLApply_renderingMode (VisuRenderingModeId mode
);
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.
typedef enum { Wireframe, Flat, Smooth, SmoothAndEdge, nb_renderingModes, followGeneralSetting } VisuRenderingModeId;
Implemented mode to draw objects.
objects are rendered with lines only ; | |
objects are rendered with polygons whose colours are uniform on each polygon ; | |
objects are rendered with polygons whose colours are shaded to be smooth all along the object. | |
objects are rendered with lines hightlighting the contours of polygons. | |
number of rendering mode. | |
use this value not to choose any rendering mode. |
void openGLInit_renderingMode (void
);
This method is used by opengl.c to initialise this module (declare config file options...). It should not be called elsewhere.
gboolean openGLSet_globalRenderingMode (VisuRenderingModeId value
);
This function change the value of the parameter renderingOption. It controls how V_Sim renders objects, in wireframe for example.
|
an integer to represent the method of rendering. |
Returns : |
TRUE if the signal OpenGLAskForReDraw should be emitted. |
VisuRenderingModeId openGLGet_globalRenderingOption (void
);
This function retrieve the value of the parameter renderingOption.
Returns : |
the identifier of the current rendering option. |
gboolean openGLGet_renderingFromName (const char *name
,VisuRenderingModeId *id
);
This function retrieve the rendering mode id associated to the name.
|
a string ; |
|
a location to store the resulting id. |
Returns : |
TRUE if the name exists. |
const char** openGLGet_allRenderingModes (void
);
This function retrieve al the names of available rendering modes.
Returns : |
an array of string, NULL terminated that is private (not to be freed). |
const char** openGLGet_allRenderingModesI18n (void
);
This function retrieve al the names (translated) of available rendering modes.
Returns : |
an array of string, NULL terminated that is private (not to be freed). |
void openGLApply_renderingMode (VisuRenderingModeId mode
);
Change the rendering mode of current OpenGL context.
|
an integer. |