Overview     Modules     Class Hierarchy     Classes     Members  
tlp::GlScene Class Reference

Tulip scene class. More...

#include <GlScene.h>

Public Member Functions

 GlScene (GlLODCalculator *calculator=NULL)
 Constructor By default GlScene use a GlCPULODCalculator to compute LOD but you can change this default lod calculator, to do that : put your calculator in constructor parameters Available calculators are : GlCPULODCalculator and GlQuadTreeLODCalculator.
 ~GlScene ()
void initGlParameters ()
void prerenderMetaNodes ()
void draw ()
void centerScene ()
void computeAjustSceneToSize (int width, int height, Coord *center, Coord *eye, float *sceneRadius, float *xWhiteFactor, float *yWhiteFactor, BoundingBox *sceneBoundingBox=NULL, float *zoomFactor=NULL)
void ajustSceneToSize (int width, int height)
void zoomXY (int step, const int x, const int y)
void zoom (float factor, const Coord &dest)
void zoom (int step)
void translateCamera (const int x, const int y, const int z)
void rotateScene (const int x, const int y, const int z)
bool selectEntities (RenderingEntitiesFlag type, int x, int y, int h, int w, GlLayer *layer, std::vector< unsigned long > &selectedEntities)
void outputSVG (unsigned int size, const std::string &filename)
void outputEPS (unsigned int size, const std::string &filename)
unsigned char * getImage ()
void setViewport (Vector< int, 4 > &newViewport)
void setViewport (int x, int y, int width, int height)
Vector< int, 4 > getViewport ()
void setBackgroundColor (const Color &color)
Color getBackgroundColor ()
void setViewOrtho (bool viewOrtho)
bool isViewOrtho ()
void setViewLabel (bool viewLabel)
void addLayer (GlLayer *layer)
bool insertLayerBefore (GlLayer *layer, const std::string &name)
bool insertLayerAfter (GlLayer *layer, const std::string &name)
GlLayergetLayer (const std::string &name)
void removeLayer (const std::string &name, bool deleteLayer)
void removeLayer (GlLayer *layer, bool deleteLayer)
std::vector< std::pair
< std::string, GlLayer * > > * 
getLayersList ()
void clearLayersList ()
void notifyModifyLayer (const std::string &name, GlLayer *layer)
void notifyModifyEntity (GlSimpleEntity *entity)
void getXML (std::string &out)
void setWithXML (std::string &in, Graph *graph)
GlLODCalculator * getCalculator ()
void setCalculator (GlLODCalculator *calculator)
BoundingBox getBoundingBox ()
void setViewportZoom (int zoom=1, int xDec=0, int yDec=0)
void getViewportZoom (int &zoom, int &xDec, int &yDec)
void addGlGraphCompositeInfo (GlLayer *layer, GlGraphComposite *glGraphComposite)
GlGraphCompositegetGlGraphComposite ()
GlLayergetGraphLayer ()
CameragetCamera ()
void setCamera (const Camera &camera)
void setNoClearBackground (bool clear)
bool getNoClearBackground () const

Detailed Description

Tulip scene class.

The GlScene class is the core of the tulip rendering system This class is used to render entities and graph in OpenGL If you want to render entities and graph, you have to use GlLayer system. You just have to create GlLayer and add entities in.

Warning
GlScene work with only one graph, if you add a GlGraphComposite you have to call the addGlGraphCompositeInfo(GlLayer *, GlGraphComposite *) After adding layers you can do a centerScene() and a draw()
GlLayer *mainLayer=new GlLayer("Main");
GlGraphComposite *graphComposite=new GlGraphComposite(graph);
mainLayer->addGlEntity(graphComposite,"graph");
GlLayer *otherLayer=new GlLayer("Other");
GlCircle *circle=new GlCircle();
otherLayer->addGlEntity(circle,"circle");
glScene.addLayer(mainLayer);
glScene.addLayer(otherLayer);
glScene.addGlGraphCompositeInfo(mainLayer,graphComposite);
glScene.centerScene();
glScene.draw();

If you want to create a widget with a visualisation is better to use GlMainWidget class (this class use a GlScene inside)

Constructor & Destructor Documentation

tlp::GlScene::GlScene ( GlLODCalculator *  calculator = NULL)

Constructor By default GlScene use a GlCPULODCalculator to compute LOD but you can change this default lod calculator, to do that : put your calculator in constructor parameters Available calculators are : GlCPULODCalculator and GlQuadTreeLODCalculator.

tlp::GlScene::~GlScene ( )

Member Function Documentation

void tlp::GlScene::addGlGraphCompositeInfo ( GlLayer layer,
GlGraphComposite glGraphComposite 
)
inline

This function must be call when you had a glGraphComposite in a layer in the scene

void tlp::GlScene::addLayer ( GlLayer layer)

Add a layer in the scene The layer name is contain in the GlLayer object

void tlp::GlScene::ajustSceneToSize ( int  width,
int  height 
)

Ajust camera to have entities near borders

void tlp::GlScene::centerScene ( )

Center scene to have all the visibles entities displayed

void tlp::GlScene::clearLayersList ( )
inline

Clear layers list Layers will not be deleted in this function

void tlp::GlScene::computeAjustSceneToSize ( int  width,
int  height,
Coord *  center,
Coord *  eye,
float *  sceneRadius,
float *  xWhiteFactor,
float *  yWhiteFactor,
BoundingBox *  sceneBoundingBox = NULL,
float *  zoomFactor = NULL 
)

Compute informations for ajustSceneToSize

Parameters
width: request width
height: request height
center: the result center will be stored in (if center != NULL)
eye: the result eye will be stored in (if eye != NULL)
sceneRadius: the result sceneRadius will be stored in (if sceneRadius != NULL)
xWhiteFactor: xWhiteFactor is the white part on x borders (left and right), the result xWhiteFactor will be stored in (if xWhiteFactor != NULL)
yWhiteFactor: yWhiteFactor is the white part on y borders (top and bottom), the result yWhiteFactor will be stored in (if yWhiteFactor != NULL)
sceneBoundingBox: the result sceneBoundingBox will be stored in (if sceneBoundingBox != NULL)
void tlp::GlScene::draw ( )

Draw the scene, this function is the most important function of GlScene. If you want to render a scene into an OpenGL widget : call this function

Color tlp::GlScene::getBackgroundColor ( )
inline

Get the background color of the scene

BoundingBox tlp::GlScene::getBoundingBox ( )

Return the bouding box of the scene (in 3D coordinates)

Warning
This bounding box is compute in rendering, so if you add an entity in a layer the bounding box include this entity if a draw is call
GlLODCalculator* tlp::GlScene::getCalculator ( )
inline

Return lod calculator used to render this scene

Camera& tlp::GlScene::getCamera ( )
inline

At default the most important layer is the layer with name : "main" This function return the camera of this layer

GlGraphComposite* tlp::GlScene::getGlGraphComposite ( )
inline

Return the current GlGraphComposite used by the scene

GlLayer* tlp::GlScene::getGraphLayer ( )
inline

Return the layer containing the current GlGraphComposite

unsigned char* tlp::GlScene::getImage ( )

Return the RGB image of OpenGL view

GlLayer* tlp::GlScene::getLayer ( const std::string &  name)

Return the layer with name : name

std::vector<std::pair<std::string, GlLayer*> >* tlp::GlScene::getLayersList ( )
inline

Return the layer list

bool tlp::GlScene::getNoClearBackground ( ) const
inline
Vector<int, 4> tlp::GlScene::getViewport ( )
inline

Get the viewport of the scene The viewport must be in many case the size of the widget containing the scene

void tlp::GlScene::getViewportZoom ( int &  zoom,
int &  xDec,
int &  yDec 
)

Get a zoom level and a xDec/yDec, this parameters change viewport of the scene

void tlp::GlScene::getXML ( std::string &  out)

Get XML description of the scene and children and store it in out string

void tlp::GlScene::initGlParameters ( )

Init scene's OpenGL parameters, this function is call when you do a draw

bool tlp::GlScene::insertLayerAfter ( GlLayer layer,
const std::string &  name 
)

Add a layer just after layer with given name Return true if insert is ok and false if layer with given name is not find

bool tlp::GlScene::insertLayerBefore ( GlLayer layer,
const std::string &  name 
)

Add a layer just before layer with given name Return true if insert is ok and false if layer with given name is not find

bool tlp::GlScene::isViewOrtho ( )
inline

Scene is render in orthogonal mode ?

void tlp::GlScene::notifyModifyEntity ( GlSimpleEntity entity)

This function is called by GlComposite to send entity modification event

void tlp::GlScene::notifyModifyLayer ( const std::string &  name,
GlLayer layer 
)

This function is called by GlLayer and GlComposite to send layer modification event

void tlp::GlScene::outputEPS ( unsigned int  size,
const std::string &  filename 
)

Output the scene in EPS

void tlp::GlScene::outputSVG ( unsigned int  size,
const std::string &  filename 
)

Output the scene in SVG

void tlp::GlScene::prerenderMetaNodes ( )

Prerender meta nodes, this function create data structure and render meta nodes to futur use

void tlp::GlScene::removeLayer ( const std::string &  name,
bool  deleteLayer 
)

Remove the layer with name and delete it (if bool deleteLayer == true)

void tlp::GlScene::removeLayer ( GlLayer layer,
bool  deleteLayer 
)

Remove a layer and delete it (if bool deleteLayer == true)

void tlp::GlScene::rotateScene ( const int  x,
const int  y,
const int  z 
)

Rotate camera by (x,y,z) with : x : rotation over X axis in degree y : rotation over Y axis in degree z : rotation over Z axis in degree

bool tlp::GlScene::selectEntities ( RenderingEntitiesFlag  type,
int  x,
int  y,
int  h,
int  w,
GlLayer layer,
std::vector< unsigned long > &  selectedEntities 
)

Select entities with selection flag : type (SelectSimpleEntities,SelectNodes,SelectEdges) Select at position x,y with heigh : h and width : w Select in GlLayer : layer And store result in selectedEntities vector

void tlp::GlScene::setBackgroundColor ( const Color &  color)
inline

Set the background color of the scene

void tlp::GlScene::setCalculator ( GlLODCalculator *  calculator)
inline

Set a new lod calculator used to render this scene

void tlp::GlScene::setCamera ( const Camera camera)
inline

At default the most important layer is the layer with name : "main" This function set the camera of this layer

void tlp::GlScene::setNoClearBackground ( bool  clear)
inline

If true, color buffer will not be cleared before drawing the scene.

void tlp::GlScene::setViewLabel ( bool  viewLabel)
inline

Render the nodes/edges label

void tlp::GlScene::setViewOrtho ( bool  viewOrtho)
inline

Set if scene is render in orthogonal mode

void tlp::GlScene::setViewport ( Vector< int, 4 > &  newViewport)
inline

Set the viewport of the scene with a vector The viewport must be in many case the size of the widget containing the scene

void tlp::GlScene::setViewport ( int  x,
int  y,
int  width,
int  height 
)
inline

Set the viewport of the scene with 4 int The viewport must be in many case the size of the widget containing the scene

void tlp::GlScene::setViewportZoom ( int  zoom = 1,
int  xDec = 0,
int  yDec = 0 
)

Set a zoom level and a xDec/yDec, this parameters change viewport of the scene

void tlp::GlScene::setWithXML ( std::string &  in,
Graph *  graph 
)

Set scene's data and children with a XML

void tlp::GlScene::translateCamera ( const int  x,
const int  y,
const int  z 
)

Translate camera by (x,y,z)

void tlp::GlScene::zoom ( float  factor,
const Coord &  dest 
)

Zoom to given world coordinate

Warning
factor parameter isn't be used
void tlp::GlScene::zoom ( int  step)

Zoom

void tlp::GlScene::zoomXY ( int  step,
const int  x,
const int  y 
)

Zoom to given x,y screen coordinates



Tulip Software by LaBRI Visualization Team    2001 - 2012