Open CASCADE Technology 6.6.0
Public Member Functions | Protected Member Functions
Graphic3d_ArrayOfPrimitives Class Reference

This class furnish services to defined and fill an
array of primitives compatible with the use of
the OPENGl glDrawArrays() or glDrawElements() functions.
NOTE that the main goal of this kind of primitive
is to avoid multiple copies of datas between
each layer of the software.
So the array datas exist only one time and the use
of SetXxxxxx() methods enable to change dynamically
the aspect of this primitive.

Advantages are :
1) Decrease strongly the loading time.
2) Decrease strongly the display time using optimized Opengl
primitives.
3) Enable to change dynamically the components of the primitive
(vertice,normal,color,texture coordinates).
4) Add true triangle and quadrangle strips or fans capabilities.

#include <Graphic3d_ArrayOfPrimitives.hxx>

Inheritance diagram for Graphic3d_ArrayOfPrimitives:
Inheritance graph
[legend]

Public Member Functions

void Destroy ()
 ~Graphic3d_ArrayOfPrimitives ()
Standard_Integer AddVertex (const gp_Pnt &aVertice)
 Adds a vertice in the array.
returns the actual vertex number.

Standard_Integer AddVertex (const Standard_Real X, const Standard_Real Y, const Standard_Real Z)
 Adds a vertice in the array.
returns the actual vertex number.

Standard_Integer AddVertex (const Standard_ShortReal X, const Standard_ShortReal Y, const Standard_ShortReal Z)
 Adds a vertice in the array.
returns the actual vertex number.

Standard_Integer AddVertex (const gp_Pnt &aVertice, const Quantity_Color &aColor)
 Adds a vertice and vertex color in the vertex array.
returns the actual vertex number.
Warning: <aColor> is ignored when the <hasVColors>
constructor parameter is FALSE

Standard_Integer AddVertex (const gp_Pnt &aVertice, const Standard_Integer aColor)
 Adds a vertice and vertex color in the vertex array.
returns the actual vertex number.
Warning: <aColor> is ignored when the <hasVColors>
constructor parameter is FALSE
aColor = Alpha << 24 + Blue << 16 + Green << 8 + Red
On all architecture proccers type (x86 or SPARC) you can
use this byte order.

Standard_Integer AddVertex (const gp_Pnt &aVertice, const gp_Dir &aNormal)
 Adds a vertice and vertex normal in the vertex array.
returns the actual vertex number.
Warning: <aNormal> is ignored when the <hasVNormals>
constructor parameter is FALSE.

Standard_Integer AddVertex (const Standard_Real X, const Standard_Real Y, const Standard_Real Z, const Standard_Real NX, const Standard_Real NY, const Standard_Real NZ)
 Adds a vertice and vertex normal in the vertex array.
returns the actual vertex number.
Warning: <aNormal> is ignored when the <hasVNormals>
constructor parameter is FALSE.

Standard_Integer AddVertex (const Standard_ShortReal X, const Standard_ShortReal Y, const Standard_ShortReal Z, const Standard_ShortReal NX, const Standard_ShortReal NY, const Standard_ShortReal NZ)
 Adds a vertice and vertex normal in the vertex array.
returns the actual vertex number.
Warning: <aNormal> is ignored when the <hasVNormals>
constructor parameter is FALSE.

Standard_Integer AddVertex (const gp_Pnt &aVertice, const gp_Dir &aNormal, const Quantity_Color &aColor)
 Adds a vertice,vertex normal and color in the vertex array.
returns the actual vertex number.
Warning: <aNormal> is ignored when the <hasVNormals>
constructor parameter is FALSE.
<aColor> is ignored when the <hasVColors>
constructor parameter is FALSE

Standard_Integer AddVertex (const gp_Pnt &aVertice, const gp_Dir &aNormal, const Standard_Integer aColor)
 Adds a vertice,vertex normal and color in the vertex array.
returns the actual vertex number.
Warning: <aNormal> is ignored when the <hasVNormals>
constructor parameter is FALSE.
<aColor> is ignored when the <hasVColors>
constructor parameter is FALSE
aColor = Alpha << 24 + Blue << 16 + Green << 8 + Red
On all architecture proccers type (x86 or SPARC) you can
use this byte order.

Standard_Integer AddVertex (const gp_Pnt &aVertice, const gp_Pnt2d &aTexel)
 Adds a vertice and vertex texture in the vertex array.
returns the actual vertex number.
<aTexel> is ignored when the <hasVTexels>
constructor parameter is FALSE.

Standard_Integer AddVertex (const Standard_Real X, const Standard_Real Y, const Standard_Real Z, const Standard_Real TX, const Standard_Real TY)
 Adds a vertice and vertex texture coordinates in the vertex array.
returns the actual vertex number.
<aTexel> is ignored when the <hasVTexels>
constructor parameter is FALSE.

Standard_Integer AddVertex (const Standard_ShortReal X, const Standard_ShortReal Y, const Standard_ShortReal Z, const Standard_ShortReal TX, const Standard_ShortReal TY)
 Adds a vertice and vertex texture coordinates in the vertex array.
returns the actual vertex number.
<aTexel> is ignored when the <hasVTexels>
constructor parameter is FALSE.

Standard_Integer AddVertex (const gp_Pnt &aVertice, const gp_Dir &aNormal, const gp_Pnt2d &aTexel)
 Adds a vertice,vertex normal and texture in the vertex array.
returns the actual vertex number.
Warning: <aNormal> is ignored when the <hasVNormals>
constructor parameter is FALSE.
<aTexel> is ignored when the <hasVTexels>
constructor parameter is FALSE.

Standard_Integer AddVertex (const Standard_Real X, const Standard_Real Y, const Standard_Real Z, const Standard_Real NX, const Standard_Real NY, const Standard_Real NZ, const Standard_Real TX, const Standard_Real TY)
 Adds a vertice,vertex normal and texture in the vertex array.
returns the actual vertex number.
Warning: <aNormal> is ignored when the <hasVNormals>
constructor parameter is FALSE.
<aTexel> is ignored when the <hasVTexels>
constructor parameter is FALSE.

Standard_Integer AddVertex (const Standard_ShortReal X, const Standard_ShortReal Y, const Standard_ShortReal Z, const Standard_ShortReal NX, const Standard_ShortReal NY, const Standard_ShortReal NZ, const Standard_ShortReal TX, const Standard_ShortReal TY)
 Adds a vertice,vertex normal and texture in the vertex array.
returns the actual vertex number.
Warning: <aNormal> is ignored when the <hasVNormals>
constructor parameter is FALSE.
<aTexel> is ignored when the <hasVTexels>
constructor parameter is FALSE.

Standard_Integer AddBound (const Standard_Integer edgeNumber)
 Adds a bound of length <edgeNumber> in the bound array
returns the actual bounds number.

Standard_Integer AddBound (const Standard_Integer edgeNumber, const Quantity_Color &aBColor)
 Adds a bound of length <edgeNumber> and bound color
<aBColor> in the bound array.
returns the actual bounds number.
Warning: <aBColor> is ignored when the <hasBColors>
constructor parameter is FALSE

Standard_Integer AddBound (const Standard_Integer edgeNumber, const Standard_Real R, const Standard_Real G, const Standard_Real B)
 Adds a bound of length <edgeNumber> and bound color
coordinates in the bound array.
returns the actual bounds number.
Warning: <R,G,B> are ignored when the <hasBColors>
constructor parameter is FALSE

Standard_Integer AddEdge (const Standard_Integer vertexIndex, const Standard_Boolean isVisible=Standard_True)
 Adds an edge in the range [1,VertexNumber()] in the array,
if <isVisible> is FALSE the edge between <vertexIndex> and
the next edge will not be visible even if the SetEdgeOn() method
is activated in Graphic3d_AspectFillArea3d class.
returns the actual edges number.
Warning: <isVisible> is ignored when the <hasEdgeInfos>
constructor parameter is FALSE.

Standard_Boolean Orientate (const gp_Dir &aNormal)
 Orientate correctly all vertexs & normals of this array
according to the <aNormal> parameter and
returns TRUE when something has change in the array.
Warning: When the array has edges this method is apply
on edge sub array instead on vertex sub array.

Standard_Boolean Orientate (const Standard_Integer aBoundIndex, const gp_Dir &aNormal)
 Orientate correctly all vertexs & normal of the bound <aBound>
according to the <aNormal> parameter and
returns TRUE when something has change in the array.
Warning: When the array has edges this method is apply
on edge sub array instead on vertex sub array.
When this array has no bound, <aBoundIndex> design the item number

void SetVertice (const Standard_Integer anIndex, const gp_Pnt &aVertice)
 Change the vertice of rank <anIndex> in the array.

void SetVertice (const Standard_Integer anIndex, const Standard_ShortReal X, const Standard_ShortReal Y, const Standard_ShortReal Z)
 Change the vertice of rank <anIndex> in the array.

void SetVertexColor (const Standard_Integer anIndex, const Quantity_Color &aColor)
 Change the vertex color of rank <anIndex> in the array.

void SetVertexColor (const Standard_Integer anIndex, const Standard_Real R, const Standard_Real G, const Standard_Real B)
 Change the vertex color of rank <anIndex> in the array.

void SetVertexColor (const Standard_Integer anIndex, const Standard_Integer aColor)
 Change the vertex color of rank <anIndex> in the array.
aColor = Alpha << 24 + Blue << 16 + Green << 8 + Red
On all architecture proccers type (x86 or SPARC) you can
use this byte order.

void SetVertexNormal (const Standard_Integer anIndex, const gp_Dir &aNormal)
 Change the vertex normal of rank <anIndex> in the array.

void SetVertexNormal (const Standard_Integer anIndex, const Standard_Real NX, const Standard_Real NY, const Standard_Real NZ)
 Change the vertex normal of rank <anIndex> in the array.

void SetVertexTexel (const Standard_Integer anIndex, const gp_Pnt2d &aTexel)
 Change the vertex texel of rank <anIndex> in the array.

void SetVertexTexel (const Standard_Integer anIndex, const Standard_Real TX, const Standard_Real TY)
 Change the vertex texel of rank <anIndex> in the array.

void SetBoundColor (const Standard_Integer anIndex, const Quantity_Color &aColor)
 Change the bound color of rank <anIndex> in the array.

void SetBoundColor (const Standard_Integer anIndex, const Standard_Real R, const Standard_Real G, const Standard_Real B)
 Change the bound color of rank <anIndex> in the array.

Graphic3d_PrimitiveArray Array () const
 Returns the array address.

Graphic3d_TypeOfPrimitiveArray Type () const
 Returns the type of this primitive

Standard_CString StringType () const
 Returns the string type of this primitive

Standard_Boolean HasVertexNormals () const
 Returns TRUE when vertex normals array is defined.

Standard_Boolean HasVertexColors () const
 Returns TRUE when vertex colors array is defined.

Standard_Boolean HasVertexTexels () const
 Returns TRUE when vertex texels array is defined.

Standard_Integer VertexNumber () const
 Returns the number of defined vertex

gp_Pnt Vertice (const Standard_Integer aRank) const
 Returns the vertice at rank <aRank>
from the vertex table if defined.

void Vertice (const Standard_Integer aRank, Standard_Real &X, Standard_Real &Y, Standard_Real &Z) const
 Returns the vertice coordinates at rank <aRank>
from the vertex table if defined.

Quantity_Color VertexColor (const Standard_Integer aRank) const
 Returns the vertex color at rank <aRank>
from the vertex table if defined.

void VertexColor (const Standard_Integer aRank, Standard_Real &R, Standard_Real &G, Standard_Real &B) const
 Returns the vertex color values at rank <aRank>
from the vertex table if defined.

void VertexColor (const Standard_Integer aRank, Standard_Integer &aColor) const
 Returns the vertex color values at rank <aRank>
from the vertex table if defined.

gp_Dir VertexNormal (const Standard_Integer aRank) const
 Returns the vertex normal at rank <aRank>
from the vertex table if defined.

void VertexNormal (const Standard_Integer aRank, Standard_Real &NX, Standard_Real &NY, Standard_Real &NZ) const
 Returns the vertex normal coordinates at rank <aRank>
from the vertex table if defined.

gp_Pnt2d VertexTexel (const Standard_Integer aRank) const
 Returns the vertex texture at rank <aRank>
from the vertex table if defined.

void VertexTexel (const Standard_Integer aRank, Standard_Real &TX, Standard_Real &TY) const
 Returns the vertex texture coordinates at rank <aRank>
from the vertex table if defined.

Standard_Boolean HasEdgeInfos () const
 Returns TRUE when edge visibillity array is defined.

Standard_Integer EdgeNumber () const
 Returns the number of defined edges

Standard_Integer Edge (const Standard_Integer aRank) const
 Returns the vertex index at rank <aRank>
in the range [1,VertexNumber()]

Standard_Boolean EdgeIsVisible (const Standard_Integer aRank) const
 Returns TRUE when the edge at rank <aRank>
is visible.

Standard_Boolean HasBoundColors () const
 Returns TRUE when bound colors array is defined.

Standard_Integer BoundNumber () const
 Returns the number of defined bounds

Standard_Integer Bound (const Standard_Integer aRank) const
 Returns the edge number at rank <aRank>.

Quantity_Color BoundColor (const Standard_Integer aRank) const
 Returns the bound color at rank <aRank>
from the bound table if defined.

void BoundColor (const Standard_Integer aRank, Standard_Real &R, Standard_Real &G, Standard_Real &B) const
 Returns the bound color values at rank <aRank>
from the bound table if defined.

Standard_Integer ItemNumber () const
 Returns the number of total items according to
the array type.

Standard_Boolean IsValid ()
 Returns TRUE only when the contains of this array is
available.

Protected Member Functions

 Graphic3d_ArrayOfPrimitives (const Graphic3d_TypeOfPrimitiveArray aType, const Standard_Integer maxVertexs, const Standard_Integer maxBounds, const Standard_Integer maxEdges, const Standard_Boolean hasVNormals, const Standard_Boolean hasVColors, const Standard_Boolean hasBColors, const Standard_Boolean hasTexels, const Standard_Boolean hasEdgeInfos)
 Warning
You must use a coherent set of AddVertex() methods according to the
<hasVNormals>,<hasVColors>,<hasVTexels>,<hasBColors>
User is responsible of confuse vertex and bad normal orientation.
You must use AddBound() method only if the <maxBounds>
constructor parameter is > 0.
You must use AddEdge() method only if the <maxEdges>
constructor parameter is > 0.
You must use a coherent set of AddEdge() methods according to the
<hasEdgeInfos> constructor parameter.


Constructor & Destructor Documentation

Graphic3d_ArrayOfPrimitives::~Graphic3d_ArrayOfPrimitives ( ) [inline]
Graphic3d_ArrayOfPrimitives::Graphic3d_ArrayOfPrimitives ( const Graphic3d_TypeOfPrimitiveArray  aType,
const Standard_Integer  maxVertexs,
const Standard_Integer  maxBounds,
const Standard_Integer  maxEdges,
const Standard_Boolean  hasVNormals,
const Standard_Boolean  hasVColors,
const Standard_Boolean  hasBColors,
const Standard_Boolean  hasTexels,
const Standard_Boolean  hasEdgeInfos 
) [protected]

Member Function Documentation

Standard_Integer Graphic3d_ArrayOfPrimitives::AddBound ( const Standard_Integer  edgeNumber)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddBound ( const Standard_Integer  edgeNumber,
const Quantity_Color aBColor 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddBound ( const Standard_Integer  edgeNumber,
const Standard_Real  R,
const Standard_Real  G,
const Standard_Real  B 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddEdge ( const Standard_Integer  vertexIndex,
const Standard_Boolean  isVisible = Standard_True 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const gp_Pnt aVertice)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const Standard_Real  X,
const Standard_Real  Y,
const Standard_Real  Z,
const Standard_Real  NX,
const Standard_Real  NY,
const Standard_Real  NZ,
const Standard_Real  TX,
const Standard_Real  TY 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const Standard_ShortReal  X,
const Standard_ShortReal  Y,
const Standard_ShortReal  Z,
const Standard_ShortReal  NX,
const Standard_ShortReal  NY,
const Standard_ShortReal  NZ,
const Standard_ShortReal  TX,
const Standard_ShortReal  TY 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const Standard_ShortReal  X,
const Standard_ShortReal  Y,
const Standard_ShortReal  Z 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const Standard_ShortReal  X,
const Standard_ShortReal  Y,
const Standard_ShortReal  Z,
const Standard_ShortReal  NX,
const Standard_ShortReal  NY,
const Standard_ShortReal  NZ 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const Standard_Real  X,
const Standard_Real  Y,
const Standard_Real  Z,
const Standard_Real  NX,
const Standard_Real  NY,
const Standard_Real  NZ 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const gp_Pnt aVertice,
const gp_Dir aNormal,
const Quantity_Color aColor 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const gp_Pnt aVertice,
const Quantity_Color aColor 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const gp_Pnt aVertice,
const gp_Dir aNormal,
const Standard_Integer  aColor 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const Standard_Real  X,
const Standard_Real  Y,
const Standard_Real  Z 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const gp_Pnt aVertice,
const Standard_Integer  aColor 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const gp_Pnt aVertice,
const gp_Pnt2d aTexel 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const Standard_Real  X,
const Standard_Real  Y,
const Standard_Real  Z,
const Standard_Real  TX,
const Standard_Real  TY 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const gp_Pnt aVertice,
const gp_Dir aNormal 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const Standard_ShortReal  X,
const Standard_ShortReal  Y,
const Standard_ShortReal  Z,
const Standard_ShortReal  TX,
const Standard_ShortReal  TY 
)
Standard_Integer Graphic3d_ArrayOfPrimitives::AddVertex ( const gp_Pnt aVertice,
const gp_Dir aNormal,
const gp_Pnt2d aTexel 
)
Graphic3d_PrimitiveArray Graphic3d_ArrayOfPrimitives::Array ( ) const
Standard_Integer Graphic3d_ArrayOfPrimitives::Bound ( const Standard_Integer  aRank) const
void Graphic3d_ArrayOfPrimitives::BoundColor ( const Standard_Integer  aRank,
Standard_Real R,
Standard_Real G,
Standard_Real B 
) const
Quantity_Color Graphic3d_ArrayOfPrimitives::BoundColor ( const Standard_Integer  aRank) const
Standard_Integer Graphic3d_ArrayOfPrimitives::BoundNumber ( ) const
void Graphic3d_ArrayOfPrimitives::Destroy ( )
Standard_Integer Graphic3d_ArrayOfPrimitives::Edge ( const Standard_Integer  aRank) const
Standard_Boolean Graphic3d_ArrayOfPrimitives::EdgeIsVisible ( const Standard_Integer  aRank) const
Standard_Integer Graphic3d_ArrayOfPrimitives::EdgeNumber ( ) const
Standard_Boolean Graphic3d_ArrayOfPrimitives::HasBoundColors ( ) const
Standard_Boolean Graphic3d_ArrayOfPrimitives::HasEdgeInfos ( ) const
Standard_Boolean Graphic3d_ArrayOfPrimitives::HasVertexColors ( ) const
Standard_Boolean Graphic3d_ArrayOfPrimitives::HasVertexNormals ( ) const
Standard_Boolean Graphic3d_ArrayOfPrimitives::HasVertexTexels ( ) const
Standard_Boolean Graphic3d_ArrayOfPrimitives::IsValid ( )
Standard_Integer Graphic3d_ArrayOfPrimitives::ItemNumber ( ) const
Standard_Boolean Graphic3d_ArrayOfPrimitives::Orientate ( const gp_Dir aNormal)
Standard_Boolean Graphic3d_ArrayOfPrimitives::Orientate ( const Standard_Integer  aBoundIndex,
const gp_Dir aNormal 
)
void Graphic3d_ArrayOfPrimitives::SetBoundColor ( const Standard_Integer  anIndex,
const Quantity_Color aColor 
)
void Graphic3d_ArrayOfPrimitives::SetBoundColor ( const Standard_Integer  anIndex,
const Standard_Real  R,
const Standard_Real  G,
const Standard_Real  B 
)
void Graphic3d_ArrayOfPrimitives::SetVertexColor ( const Standard_Integer  anIndex,
const Standard_Real  R,
const Standard_Real  G,
const Standard_Real  B 
)
void Graphic3d_ArrayOfPrimitives::SetVertexColor ( const Standard_Integer  anIndex,
const Quantity_Color aColor 
)
void Graphic3d_ArrayOfPrimitives::SetVertexColor ( const Standard_Integer  anIndex,
const Standard_Integer  aColor 
)
void Graphic3d_ArrayOfPrimitives::SetVertexNormal ( const Standard_Integer  anIndex,
const Standard_Real  NX,
const Standard_Real  NY,
const Standard_Real  NZ 
)
void Graphic3d_ArrayOfPrimitives::SetVertexNormal ( const Standard_Integer  anIndex,
const gp_Dir aNormal 
)
void Graphic3d_ArrayOfPrimitives::SetVertexTexel ( const Standard_Integer  anIndex,
const Standard_Real  TX,
const Standard_Real  TY 
)
void Graphic3d_ArrayOfPrimitives::SetVertexTexel ( const Standard_Integer  anIndex,
const gp_Pnt2d aTexel 
)
void Graphic3d_ArrayOfPrimitives::SetVertice ( const Standard_Integer  anIndex,
const gp_Pnt aVertice 
)
void Graphic3d_ArrayOfPrimitives::SetVertice ( const Standard_Integer  anIndex,
const Standard_ShortReal  X,
const Standard_ShortReal  Y,
const Standard_ShortReal  Z 
)
Standard_CString Graphic3d_ArrayOfPrimitives::StringType ( ) const
Graphic3d_TypeOfPrimitiveArray Graphic3d_ArrayOfPrimitives::Type ( ) const
void Graphic3d_ArrayOfPrimitives::VertexColor ( const Standard_Integer  aRank,
Standard_Real R,
Standard_Real G,
Standard_Real B 
) const
Quantity_Color Graphic3d_ArrayOfPrimitives::VertexColor ( const Standard_Integer  aRank) const
void Graphic3d_ArrayOfPrimitives::VertexColor ( const Standard_Integer  aRank,
Standard_Integer aColor 
) const
gp_Dir Graphic3d_ArrayOfPrimitives::VertexNormal ( const Standard_Integer  aRank) const
void Graphic3d_ArrayOfPrimitives::VertexNormal ( const Standard_Integer  aRank,
Standard_Real NX,
Standard_Real NY,
Standard_Real NZ 
) const
Standard_Integer Graphic3d_ArrayOfPrimitives::VertexNumber ( ) const
gp_Pnt2d Graphic3d_ArrayOfPrimitives::VertexTexel ( const Standard_Integer  aRank) const
void Graphic3d_ArrayOfPrimitives::VertexTexel ( const Standard_Integer  aRank,
Standard_Real TX,
Standard_Real TY 
) const
void Graphic3d_ArrayOfPrimitives::Vertice ( const Standard_Integer  aRank,
Standard_Real X,
Standard_Real Y,
Standard_Real Z 
) const
gp_Pnt Graphic3d_ArrayOfPrimitives::Vertice ( const Standard_Integer  aRank) const

The documentation for this class was generated from the following file:
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines