visu_rendering
Methods to create and add new rendering methods.
The way visu renders its data is done by modules. They are called
rendering methods and they describes how data are drawn on
the screen. Many can be defined but only one is used at a
time to render the data.
One or more file type are associated with a rendering method. And
a rendering method must specify the way to load the data it needs.
Taking the example of a spin system representation, there are two kinds
of file. The first kind describes the position the spin and the second
contains their orientations.
To create a new rendering method, use renderingMethod_new(). The name is
mandatory and must be unique. The description is not compulsory. The number of file
kinds is also required. Use renderingMethodSet_fileType() to associated a #GList
of #FileFormat. In our example of spin system, the first kind of file is about
positions, and the associated file formats are *.ascii, *.d3 and *.xyz.
The #RenderingMethod_struct has to two pointers on methods that are important. The first,
createOpenGLElementFunc() is called when V_Sim needs to create an OpenGL list corresponding
to the #VisuElement given as argument. This list then can be used to render each node and
thus accelerating the rendering operations. The second method is createOpenGLNodeFunc()
and is called by V_Sim for each node of the system when the main OpenGL list (the one
for the nodes) is created. Thus, in the contrary of the first method, thios one should
not create an OpenGL list but directly call OpenGL routines to draw the node. This
method is also responsible to put the node at the right position. Use visuDataGet_nodePosition()
to retrieve the position and translate the node accordingly.
@name:
@printName:
@description:
@icon:
@nbFilesType:
@fileType:
@fileTypeLabel:
@loadMethod:
@createElement:
@createNode:
@getExtensForElement:
@name:
@fmt:
@load:
@priority:
@data:
@filename:
@format:
@error:
@Returns:
@RENDERING_ERROR_METHOD:
@RENDERING_ERROR_FILE:
@RENDERING_ERROR_FORMAT:
@name:
@printName:
@description:
@nbFileType:
@loadMethod:
@Returns:
@method:
@method:
@path:
@method:
@fileTypeList:
@fileType:
@name:
@method:
@Returns:
@method:
@fileType:
@Returns:
@method:
@fileType:
@Returns:
@method:
@ele:
@Returns:
@method:
@fmt:
@fileType:
@a:
@b:
@Returns:
@method:
@data:
@format:
@error:
@Returns:
@visuData:
@ele:
@Returns:
@visuData:
@node:
@ele:
@ele:
@Returns:
@method:
@createElement:
@createNode:
@getSize:
@method:
@name:
@Returns:
@Returns:
@Returns:
@Returns: