![]() |
![]() |
![]() |
V_Sim API - Reference Manual | ![]() |
---|---|---|---|---|
void (*setColorFunc) (VisuData *visuData, float rgba[4], VisuElement *ele, VisuNode *node); VisuData; VisuData* visuDataNew (); VisuData* visuDataNew_withOpenGLView (OpenGLView *view); int visuDataAdd_VisuElement (VisuData *data, VisuElement *ele, double x, double y, double z, int number); int visuDataAdd_int (VisuData *data, int position, double x, double y, double z, int number); VisuNode* visuDataGet_nodeFromNumber (VisuData *data, int number); VisuNode* visuDataGet_nodeFromId (VisuData *data, int eleId, int posId); int visuDataGet_objectList (VisuData *data); int visuDataSet_population (VisuData *data, int nbOfTypes, int *nbOfNodesPerVisuElement, VisuElement **visuElementUsed); void visuDataFree_population (VisuData *data); GenericRenderingWindow visuDataGet_renderingWindow (VisuData *data); void visuDataConvert_boxCoordinatestoXYZ (VisuData *data, float xyz[3], float boxCoord[3]); void visuDataConvert_XYZtoBoxCoordinates (VisuData *data, float boxCoord[3], float xyz[3]); float visuDataGet_boxGeometry (VisuData *data, int vector); void visuDataSet_boxGeometry (VisuData *data, float geometry[6], gboolean periodic); gboolean visuDataGet_periodic (VisuData *data); float* visuDataGet_XYZtranslation (VisuData *data); int visuDataSet_XYZtranslation (VisuData *data, float xyz[3]); void visuDataGet_boxMatrix (VisuData *data, float matrix[3][3]); int visuData_constrainedElementInTheBox (VisuData *data, VisuElement *element); int visuData_constrainedInTheBox (VisuData *data); int visuData_constrainedFree (VisuData *data); void visuDataGet_nodePosition (VisuData *data, VisuNode *node, float coord[3]); void visuDataSet_nodeProperty (VisuData *data, VisuNode *node, char *key, gpointer value); gpointer visuDataGet_nodeProperty (VisuData *data, VisuNode *node, char *key); void visuDataAdd_nodeProperty (VisuData *data, char *key, GDestroyNotify freeFunc); void visuDataRemove_nodeProperty (VisuData *data, char *key); gboolean visuData_compareElements (VisuData *data1, VisuData *data2); void visuDataSet_changeElementFlag (VisuData *data, gboolean changeElement); gboolean visuDataGet_changeElementFlag (VisuData *data); void visuDataSet_property (VisuData *data, char *key, gpointer value); gpointer visuDataGet_property (VisuData *data, char *key); void visuDataRemove_property (VisuData *data, char *key); guint visuDataAdd_timeout (VisuData *data, guint time, GSourceFunc func, gpointer user_data); gboolean visuDataRemove_timeout (VisuData *data, guint timeoutId); void visuDataAdd_file (VisuData *data, gchar *file, int kind, FileFormat *format); gchar* visuDataGet_file (VisuData *data, int kind, FileFormat **format); void visuDataRemove_allFiles (VisuData *data); void visuDataSet_fileCommentary (VisuData *data, gchar *commentary); gchar* visuDataGet_fileCommentary (VisuData *data); void visuDataSet_ColorFunc (VisuData *data, setColorFunc func); GList* visuDataGet_allObjects (); void visuData_createNode (VisuData *data, VisuNode *node); void visuData_createNodes (VisuData *data, VisuElement *ele); void visuData_createAllNodes (VisuData *data); void visuData_createAllElements (VisuData *data); void visuDataEmit_askForShowHideNodes (VisuData *data, gboolean *redraw); void visuDataEmit_elementRenderedChange (VisuData *data, VisuElement *element); void visuDataEmit_facettesChanged (VisuData *data); void visuDataEmit_nodePositionChanged (VisuData *data); void visuDataEmit_nodeRenderedChange (VisuData *data); void visuDataEmit_observeMovement (VisuData *data, gboolean start); OpenGLView* visuDataGet_openGLView (VisuData *data); int visuDataSet_angleOfView (VisuData *data, float valueTheta, float valuePhi, float valueOmega, int mask); int visuDataSet_perspectiveOfView (VisuData *data, float value); int visuDataSet_positionOfView (VisuData *data, float valueX, float valueY, int mask); void visuDataSet_propertyWithDestroyFunc (VisuData *data, char *key, gpointer value, GDestroyNotify freeFunc); void visuDataSet_renderingWindow (VisuData *data, GenericRenderingWindow window); int visuDataSet_sizeOfView (VisuData *data, guint width, guint height); int visuDataSet_zoomOfView (VisuData *data, float value);
The main goal of V_Sim is to draw lists of elements. For example, when used to render atoms, a box that contains 24 silicon atoms and 46 germanium atoms is a box with two elements (silicon and germanium) where the silicon element has 24 nodes and the germanium element has 46 nodes. This module gives then methods to create nodes (see VisuElement to create and managed elements).
A node is characterised by its position in the space and its orientation. When rendered, a specific translation can be applied. It has also one number that is its position in the read input file and one boolean to control if it is rendered on screen. One can associate whatever properties using visuDataSet_nodeProperty()
. These properties can be retrieved with visuDataGet_nodeProperty()
. But before using these methods, the needed space must be allocated using visuDataAdd_nodeProperty()
. The stored properties must be pointers on something.
All nodes are stored in a structure called VisuData. V_Sim uses one VisuData per input file(s). A pointer currentVisuData
points to the current rendered VisuData. This structure contains a list of pointers on all the VisuElement used in this file. It also contains the list of all VisuNodes of this file (or these files).
void (*setColorFunc) (VisuData *visuData, float rgba[4], VisuElement *ele, VisuNode *node);
This prototype is used to specify an optional method to associate a color with external values to each node.
|
a pointer to the calling object ; |
|
an 4 allocated float area to store the return values. |
|
a VisuElement ; |
|
a VisuNode ; |
typedef struct { GObject parent; /********************/ /* Nodes attributes */ /********************/ /* Number of VisuElements used by these data. */ int ntype; /* This hashtable gives access to the good array of VisuNodes when one has the VisuElement. */ GHashTable *fromVisuElementToInt; /* This is a corresponding table from the nodes array indice to the associated VisuElement. */ VisuElement **fromIntToVisuElement; /* This array gives access to the good VisuNode when one has its number. */ VisuNode **fromNumberToVisuNode; /* The total of stored VisuNodes. */ int nbOfAllStoredNodes; /* Number of nodes allocated (size of the nodes array) per VisuElement. */ int* numberOfNodes; /* Number of nodes physically present in the array per VisuElement. */ int* numberOfStoredNodes; /* Coordinates of all these nodes. */ VisuNode **nodes; /* Define a method to set the color of each node. If this method is NULL, the color of the element is used. */ setColorFunc setColor; VisuData_private *privateDt; } VisuData;
This structure describes a VisuData object.
GObject |
an object to inherit from (NULL here). |
int |
number of VisuElement used in this object. |
GHashTable * |
give the number of the VisuElement when its pointer is known. |
VisuElement ** |
give the pointer of a ViosuElement when its number is known. |
VisuNode ** |
give the VisuNode knowing its element number and its own position. |
int |
number of registered VisuNode in this object. |
int * |
give the number of allocated VisuNode for each VisuElement. |
int * |
give the number of stored VisuNode for each VisuElement. |
VisuNode ** |
array that stores all the nodes. |
setColorFunc |
method called before drawing each node (can be NULL). |
VisuData_private * |
a pointer to the private data. |
VisuData* visuDataNew ();
This creates an empty VisuData object.
Returns : |
a newly created VisuData object (its ref count is set to 1). |
VisuData* visuDataNew_withOpenGLView (OpenGLView *view);
This creates an empty VisuData object with values for its veiw taken
from the given view
argument (the argument is indeed copied).
|
an OpenGLView object. |
Returns : |
a newly created VisuData object (its ref count is set to 1). |
int visuDataAdd_VisuElement (VisuData *data, VisuElement *ele, double x, double y, double z, int number);
This method adds a new VisuNode to the specified VisuData.
|
the VisuData where to add the new VisuNode ; |
|
the VisuElement kind of the new VisuNode ; |
|
its x coordinate ; |
|
its y coordinate ; |
|
its z coordinate ; |
|
its position in the input file (or anything else that can uniqualy identify this new VisuNode). |
Returns : |
0 if everything is allright. |
int visuDataAdd_int (VisuData *data, int position, double x, double y, double z, int number);
This method adds a new VisuNode to the specified VisuData. Position must be chosen between 0 and (ntype - 1) and corresponds to the position of the array of VisuNodes of a VisuElement.
|
the VisuData where to add the new VisuNode ; |
|
a integer corresponding to the position of a VisuElement in the array **nodes in the structure; |
|
its x coordinate ; |
|
its y coordinate ; |
|
its z coordinate ; |
|
its position in the input file (or anything else that can uniqualy identify this new VisuNode). |
Returns : |
0 if everything is alright. |
VisuNode* visuDataGet_nodeFromNumber (VisuData *data, int number);
This methods retrieves the VisuNode identified by the integer number
.
The number must be strictly positive. No eror is raised if no node corresponds
to the given number.
VisuNode* visuDataGet_nodeFromId (VisuData *data, int eleId, int posId);
|
|
|
|
|
|
Returns : |
int visuDataGet_objectList (VisuData *data);
All the drawned nodes are stored in an OpenGL list. The identifier of this list can be access with the present method.
|
a valid VisuObject ; |
Returns : |
an integer that identifies the OpenGL list of all drawn nodes. |
int visuDataSet_population (VisuData *data, int nbOfTypes, int *nbOfNodesPerVisuElement, VisuElement **visuElementUsed);
This method allocates the storing part of the given VisuData structure and store all the VisuNodes.
|
a VisuData object ; |
|
number of VisuElement ; |
|
number of VisuNode per VisuElement ; |
|
pointers to VisuElement in the same order that
nbOfNodesPerVisuElement .
|
Returns : |
1 if everything goes right. |
void visuDataFree_population (VisuData *data);
This method frees only the allocated memory that deals with the nodes (i.e. everything except the data of the files, the properties and the setColor method.
|
a VisuData to be freed. |
GenericRenderingWindow visuDataGet_renderingWindow (VisuData *data);
The VisuData objects can be rendered into a window. They are attached
to one using visuRenderingWindowSet_visuData()
method. The actual method is
then used to retrieve the window the argument data
is attached to.
|
a VisuData object. |
Returns : |
the window the data argument is attached to, or NULL
if the object has not yet been attached or if the rendering
is done off-screen.
|
void visuDataConvert_boxCoordinatestoXYZ (VisuData *data, float xyz[3], float boxCoord[3]);
Use this method to transform box coordinates into cartesian.
|
a VisuData object ; |
|
an array of floating point values to store the result ; |
|
an array of floating point values that describes the box coordinates. |
void visuDataConvert_XYZtoBoxCoordinates (VisuData *data, float boxCoord[3], float xyz[3]);
Use this method to transform cartesian coordinates to the box coordinates.
|
a VisuData object ; |
|
an array of floating point values to store the result ; |
|
an array of floating point values describing coordinates in cartesian. |
float visuDataGet_boxGeometry (VisuData *data, int vector);
Retrieve the value of a vector defining the bounding box. The vector is chosen with an int, see the visuData_boxVector enum for more details.
|
a VisuData object ; |
|
an int corresponding to a vector of the box. |
Returns : |
the value of the required vector (always a positive value), a negative value if something goes wrong. |
void visuDataSet_boxGeometry (VisuData *data, float geometry[6], gboolean periodic);
This methods set the size of the box that defines the viewport. If the periodic
argument is TRUE, the box is also the limit of a periodic system.
|
a VisuData object ; |
|
a 6 floating point array ; |
|
a boolean. |
gboolean visuDataGet_periodic (VisuData *data);
The bounding box can be just useful to set the OpenGl viewport, or it can define a limit for periodic conditions.
|
a VisuData object. |
Returns : |
if the box is a periodic limit or not. |
float* visuDataGet_XYZtranslation (VisuData *data);
The nodes are rendered at thier coordinates plus a translation. This method allows to retrieve that translation.
|
a VisuData object. |
Returns : |
a newly allocated array of 3 floats. It should be freed with a call
to free() after use.
|
int visuDataSet_XYZtranslation (VisuData *data, float xyz[3]);
This set the translations of the specified VisuData whatever previous values. The translation is done in the orthonormal referential, not the referential of the box.
|
a VisuData object ; |
|
an array of floating point values. |
Returns : |
if returns 1, visuData_createAllNodes() should be called and
the 'NodePositionChanged' should be emitted.
|
void visuDataGet_boxMatrix (VisuData *data, float matrix[3][3]);
This method is used when the box matrix is required. This matrix can transform
a vector given in box coordinates into a cartesian vector. If a simple vector
multication is required, then the use of visuDataConvert_boxCoordinatestoXYZ()
should be prefered.
|
a VisuData object ; |
|
an area to store the matrix. |
int visuData_constrainedElementInTheBox (VisuData *data, VisuElement *element);
Check all the nodes of the specified element
and change their coordinates if they are out
of the bounding box. The position of each node is the result of the
sum of their own position and of the box translation.
|
a VisuData object ; |
|
a VisuElement object. |
Returns : |
1 if visuData_createAllNodes() should be called and
the 'NodePositionChanged' should be emitted.
|
int visuData_constrainedInTheBox (VisuData *data);
It does the same things that visuData_constrainedElementInTheBox()
but for all
the VisuElement of the given data
. I.e. it checks all the nodes and changes
their coordinates if they are out of the bounding box.
The position of each node is the result of the
sum of their own position and of the box translation.
|
a VisuData object. |
Returns : |
1 if visuData_createAllNodes() should be called and
the 'NodePositionChanged' should be emitted.
|
int visuData_constrainedFree (VisuData *data);
Return all the nodes to their original position, except for the global translation.
|
a VisuData object. |
Returns : |
1 if visuData_createAllNodes() should be called and
the 'NodePositionChanged' should be emitted.
|
void visuDataGet_nodePosition (VisuData *data, VisuNode *node, float coord[3]);
Position of nodes are subject to various translations and different transformations. Their coordinates should not be access directly through node.[xyz]. This method is used to retrieve the given node position.
void visuDataSet_nodeProperty (VisuData *data, VisuNode *node, char *key, gpointer value);
This method is used to store some values associated with
the given node
of the given data
. These values are anything allocated and will be
freed (with free()
) when the node is deleted. These values
are described by the key
, and can be retrieved with the
visuDataGet_nodeProperty method. The key
is used by the VisuData
and should not be freed. Moreover it is not freed when the node
is destroyed.
gpointer visuDataGet_nodeProperty (VisuData *data, VisuNode *node, char *key);
This method is used to retrieve some data associated to
the specified node
, stored in the given data
. These return data
should not be freed after used.
void visuDataAdd_nodeProperty (VisuData *data, char *key, GDestroyNotify freeFunc);
This method adds and allocates a new area to store nodes associated data that
could be retrieve with the key
. When the property is removed with the
visuDataRemove_nodePropertry the area is freed and freeFunc
is called for
each token.
|
a VisuData object ; |
|
a string ; |
|
a method to free each token. |
void visuDataRemove_nodeProperty (VisuData *data, char *key);
This method remove all the data associated with the string key
, of all nodes.
They are freed.
|
a VisuData object ; |
|
a string. |
gboolean visuData_compareElements (VisuData *data1, VisuData *data2);
This method is used to compare the composition of the given two VisuData objects. The test is only done on VisuElement lists.
void visuDataSet_changeElementFlag (VisuData *data, gboolean changeElement);
This method is mainly used by internal gears to set a flag. This flag control
if the data
object has the same VisuElement objects than the previously rendered one.
|
a VisuData object ; |
|
a boolean. |
gboolean visuDataGet_changeElementFlag (VisuData *data);
V_Sim can use a flag set on data
object to know if data
has exactly the same
VisuElement list than the previously rendered one.
|
a VisuData object. |
Returns : |
TRUE if the previously rendered VisuData object has had the same VisuElement list than the given one, FALSE otherwise. |
void visuDataSet_property (VisuData *data, char *key, gpointer value);
This method is used to store some values associated with
the given data
. These values are anything allocated and will be
freed (with free()
) when the data
is deleted. These values
are described by the key
, and can be retrieved with the
#visuDataGet_property()
method. The key
is used by the VisuData
and should not be freed. Moreover it is not freed when the node
is destroyed.
|
a VisuData object ; |
|
a string ; |
|
an allocated area to store data. |
gpointer visuDataGet_property (VisuData *data, char *key);
This method is used to retrieve some data associated to
the specified data
. These return data should not be freed after used.
|
a VisuData object ; |
|
a string. |
Returns : |
some data associated to the key. |
void visuDataRemove_property (VisuData *data, char *key);
This method remove the data associated with the string key
.
They are freed.
|
a VisuData object ; |
|
a string. |
guint visuDataAdd_timeout (VisuData *data, guint time, GSourceFunc func, gpointer user_data);
This method is used to add the func
method to be called regularly at the period
time
. This methos calls in fact g_timeout_add()
with the given arguments. But
the source id is stored internaly and the timeout function is removed automatically
when the object data
is destroyed. It is convienient to add a method working
on the VisuData object that is called periodically during the life of te object.
|
a valid VisuData object ; |
|
the period of call in milliseconds ; |
|
the callback function to be called ; |
|
a pointer to some user defined informations. |
Returns : |
the source id if the calling method need to work with it. To remove
the callback, don't use g_source_remove() but visuDataRemove_timeout()
to inform the VisuData object that this source has been removed and
not to remove it when the object will be destroyed.
|
gboolean visuDataRemove_timeout (VisuData *data, guint timeoutId);
This method is used to remove a timeout that has been associated to the given
data
(see visuDataAdd_timeout()
).
|
a valid VisuData object ; |
|
a source id. |
Returns : |
TRUE if the source has been found and removed. |
void visuDataAdd_file (VisuData *data, gchar *file, int kind, FileFormat *format);
This method is used to add files
of type kind
to the data
. The file
attribute is copied. The format
argument can be null.
|
a VisuData object ; |
|
a string that points to a file ; |
|
an integer to qualify the file to add ; |
|
a file format. |
gchar* visuDataGet_file (VisuData *data, int kind, FileFormat **format);
This prototype is used to retrieve stored
files identify by their kind
.
|
a VisuData object. |
|
an integer to qualify the required file ; |
|
a location for a file format (can be NULL). |
Returns : |
the name of a file (it should not be deleted). |
void visuDataRemove_allFiles (VisuData *data);
This method is used to empty the list of
known file from the given data
.
|
a VisuData object. |
void visuDataSet_fileCommentary (VisuData *data, gchar *commentary);
This method is used to store a description of the given data
. This
string is copied and commentary
can be freed.
|
a VisuData object ; |
|
the message to be stored (null terminated). |
gchar* visuDataGet_fileCommentary (VisuData *data);
Get the commentary associated to the given data
.
|
a VisuData object. |
Returns : |
a string description or NULL. This string is own by V_Sim and should not be freed. |
void visuDataSet_ColorFunc (VisuData *data, setColorFunc func);
This is a little trick to colorized the nodes. It should not be used since it will probably be different in future release.
|
a VisuData object ; |
|
a method that colorize the nodes. |
GList* visuDataGet_allObjects ();
This methods is used to retrieve all VisuObject currently allocated in V_Sim. It is usefull to apply some changes on all objects (resources for example).
Returns : |
a list of V_Sim own VisuData objects. |
void visuData_createNode (VisuData *data, VisuNode *node);
This method call the createNode method of the current rendering method for the given node. It also calls the list of the material associated to the given node.
void visuData_createNodes (VisuData *data, VisuElement *ele);
This create the glObjectList registered at (identifierAllNodes
+ the position
of the ele
in the data
object + 1) that contains all the nodes of the given VisuElement.
|
a VisuData object ; |
|
a VisuElement object. |
void visuData_createAllNodes (VisuData *data);
This create the glObjectList registered at identifierAllNodes
that contains all the nodes. This glObjectList is made of all
nodes of all element that has a flag rendered
at true translated
to their own positions.
This method doesn't ask for redraw and signal OpenGLAskForReDraw
should be emitted manually.
|
a VisuData object. |
void visuData_createAllElements (VisuData *data);
This method will call the createOpenGLElementFunc()
method of the current RenderingMethod
on all the nodes of the given VisuData.
|
a VisuData object. |
void visuDataEmit_askForShowHideNodes (VisuData *data, gboolean *redraw);
This methods is used to emit the 'NodeAskForShowHide' signal. This
signal asks all modules that may hide nodes to recompute their
hiding scheme and put in redraw
if they have changed something. Since
all listeners write in redraw
, they should modify it with an union.
redraw
is initialised at FALSE before the signal is emitted.
|
a valid VisuData object ; |
|
a pointer to a location to store if redraw
is needed after all listeners have modified the
nodes of the given data .
|
void visuDataEmit_elementRenderedChange (VisuData *data, VisuElement *element);
This method is used to emit the 'ElementRenderedChanged' signal. This signal asks
all modules that are dependent of the given element
visibility to recompute their
OpenGL lists.
|
a valid VisuData object ; |
|
a valid VisuElement object. |
void visuDataEmit_facettesChanged (VisuData *data);
Emit the 'OpenGLFacetteChanged' signal.
|
a valid VisuData object. |
void visuDataEmit_nodePositionChanged (VisuData *data);
This method is used to emit the 'NodePositionChanged' signal. This signal asks all modules that are dependent of the nodes' positions to recompute their OpenGL lists.
|
a valid VisuData object. |
void visuDataEmit_nodeRenderedChange (VisuData *data);
This method is used to emit the 'NodeRenderedChanged' signal. This signal asks
all modules that are dependent of the nodes' visibility to recompute their
OpenGL lists. This signal is usualy emitted after a call to
visuDataEmit_askForShowHideNodes()
.
|
a valid VisuData object. |
void visuDataEmit_observeMovement (VisuData *data, gboolean start);
This method is used to emit the 'OpenGLObserveMovement' signal. This signal signify that an observe movement has been initiated or has just finished.
|
a valid VisuData object ; |
|
TRUE to signify a starting movement, FALSE for an ending one. |
OpenGLView* visuDataGet_openGLView (VisuData *data);
Once the object data
has been initialised, an OpenGLView object
is automattically attached and this method can be used to retrieve
it.
|
a VisuData object. |
Returns : |
the OpenGLView attached to the given data .
|
int visuDataSet_angleOfView (VisuData *data, float valueTheta, float valuePhi, float valueOmega, int mask);
This method is used to change the camera orientation for the given data
.
If necessary, this method will emit the 'OpenGLThetaPhiOmega' signal.
|
a VisuData object ; |
|
a floatinf point value in degrees ; |
|
a floating point value in degrees ; |
|
a floating point value in degrees ; |
|
to specified what values will be changed. |
Returns : |
1 if the 'OpenGLAskForReDraw' signal should be emitted. |
int visuDataSet_perspectiveOfView (VisuData *data, float value);
This method is used to change the camera perspective for the given data
.
If necessary, this method will emit the 'OpenGLPersp' signal and
the 'OpenGLFacetteChanged' signal.
|
a VisuData object ; |
|
a positive floating point value (> 1.1). |
Returns : |
1 if the 'OpenGLAskForReDraw' signal should be emitted. |
int visuDataSet_positionOfView (VisuData *data, float valueX, float valueY, int mask);
This method is used to change the camera position for the given data
.
If necessary, this method will emit the 'OpenGLXsYs' signal.
|
a VisuData object ; |
|
a floatinf point value in the bounding box scale (1 is the size of the bounding box) ; |
|
a floating point value in bounding box scale ; |
|
to specified what values will be changed. |
Returns : |
1 if the 'OpenGLAskForReDraw' signal should be emitted. |
void visuDataSet_propertyWithDestroyFunc (VisuData *data, char *key, gpointer value, GDestroyNotify freeFunc);
Same method as visuDataSet_property()
but giving a free method when
the data is removed.
|
a VisuData object ; |
|
a string ; |
|
an allocated area to store data ; |
|
a method to free each token. |
void visuDataSet_renderingWindow (VisuData *data, GenericRenderingWindow window);
This method is used to tell the data
object which
window is used to render it. Normally, one has not to use
this method, using visuRenderingWindowSet_visuData()
calls it
already.
|
a VisuData object ; |
|
a pointer to a rendering window (can be NULL). |
int visuDataSet_sizeOfView (VisuData *data, guint width, guint height);
It changes the size of the OpenGl area and reccompute the OpenGL viewport. Warning : it doesn't change the size of the window.
|
a valid VisuData object ; |
|
the new horizontal size ; |
|
the new vertical size. |
Returns : |
1 if the 'OpenGLAskForReDraw' signal should be emitted. |
int visuDataSet_zoomOfView (VisuData *data, float value);
This method is used to change the camera zoom for the given data
.
If necessary, this method will emit the 'OpenGLGross' signal and
the 'OpenGLFacetteChanged' signal.
|
a VisuData object ; |
|
a positive floating point value. |
Returns : |
1 if the 'OpenGLAskForReDraw' signal should be emitted. |