Open CASCADE Technology  6.5.4
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines
Public Member Functions | Protected Member Functions
AIS_TexturedShape Class Reference

This class allows to map textures on shapes
Textures are image files.
The texture itself is parametrized in (0,1)x(0,1).
Each face of a shape located in
UV space is provided with these parameters:
More...

#include <AIS_TexturedShape.hxx>

Inheritance diagram for AIS_TexturedShape:
Inheritance graph
[legend]

Public Member Functions

 AIS_TexturedShape (const TopoDS_Shape &shap)
 Initializes the textured shape ashape.

virtual void SetTextureFileName (const TCollection_AsciiString &TextureFileName)
 Sets the name of the texture file to map. The accepted
file types are those used in AlienImage with extensions
such as xwd, bmp, gif, rgb, ras, rs and more.

virtual void SetTextureRepeat (const Standard_Boolean RepeatYN, const Standard_Real URepeat=1.0, const Standard_Real VRepeat=1.0)
 Sets the number of occurrences of
the texture on each face. The texture itself is parameterized
in (0,1) by (0,1) . Each face of the shape to be textured is
parameterized in UV space (Umin,Umax) by (Vmin,Vmax). If
RepeatYN is set to false, texture coordinates are clamped in the
range (0,1)x(0,1) of the face.

virtual void SetTextureOrigin (const Standard_Boolean SetTextureOriginYN, const Standard_Real UOrigin=0.0, const Standard_Real VOrigin=0.0)
 Use this method to change the origin of the
texture. The texel (0,0) will be mapped to the
surfel (UOrigin,VOrigin)


virtual void SetTextureScale (const Standard_Boolean SetTextureScaleYN, const Standard_Real ScaleU=1.0, const Standard_Real ScaleV=1.0)
 Use this method to scale the texture (percent of
the face).
You can specify a scale factor for both U and V.

example : if you set ScaleU and ScaleV to 0.5 and
you enable texture repeat, the texture will appear
twice on the face in each direction.


virtual void ShowTriangles (const Standard_Boolean ShowTrianglesYN=Standard_False)
 Use this method to show the triangulation of
the shape. This is not very esthetic but can be
usefull for debug ...


void SetTextureMapOn ()
 Enables texture mapping


void SetTextureMapOff ()
 Disables texture mapping


void EnableTextureModulate ()
 Enables texture modulation


void DisableTextureModulate ()
 Disables texture modulation


void UpdateAttributes ()
 Use this method to display the textured shape
without recomputing the whole presentation.
Use this method when ONLY the texture has been changed.
ie : myTShape->UpdateAttributes()

If other parameters (ie: scale factors,
texture origin, texture repeat ...) have changed,
the whole presentation has to be recomputed.
ie : if (myShape->DisplayMode() == 3)
myAISContext->RecomputePrsOnly(myShape);
else
{
myAISContext->SetDisplayMode(myShape,3,Standard_False);
myAISContext->Display(myShape, Standard_True);
}


Standard_Boolean TextureMapState () const
Standard_Real URepeat () const
Standard_Boolean TextureRepeat () const
Standard_Real Deflection () const
Standard_CString TextureFile () const
Standard_Real VRepeat () const
Standard_Boolean ShowTriangles () const
Standard_Real TextureUOrigin () const
Standard_Real TextureVOrigin () const
Standard_Real TextureScaleU () const
Standard_Real TextureScaleV () const
Standard_Boolean TextureScale () const
Standard_Boolean TextureOrigin () const
Standard_Boolean TextureModulate () const

Protected Member Functions

virtual void Compute (const Handle< PrsMgr_PresentationManager3d > &aPresentationManager, const Handle< Prs3d_Presentation > &aPresentation, const Standard_Integer aMode=0)
 Calculates the 3D view aPresentation and its
updates. The latter are managed by aPresentationManager.
aPresentableObject has the display mode aMode;
this has the default value of 0, that is, the wireframe display mode.


Detailed Description

the number of occurences of the texture on the face


Constructor & Destructor Documentation


Member Function Documentation

virtual void AIS_TexturedShape::Compute ( const Handle< PrsMgr_PresentationManager3d > &  aPresentationManager,
const Handle< Prs3d_Presentation > &  aPresentation,
const Standard_Integer  aMode = 0 
) [protected, virtual]

Reimplemented from AIS_Shape.

virtual void AIS_TexturedShape::SetTextureFileName ( const TCollection_AsciiString TextureFileName) [virtual]
virtual void AIS_TexturedShape::SetTextureOrigin ( const Standard_Boolean  SetTextureOriginYN,
const Standard_Real  UOrigin = 0.0,
const Standard_Real  VOrigin = 0.0 
) [virtual]
virtual void AIS_TexturedShape::SetTextureRepeat ( const Standard_Boolean  RepeatYN,
const Standard_Real  URepeat = 1.0,
const Standard_Real  VRepeat = 1.0 
) [virtual]
virtual void AIS_TexturedShape::SetTextureScale ( const Standard_Boolean  SetTextureScaleYN,
const Standard_Real  ScaleU = 1.0,
const Standard_Real  ScaleV = 1.0 
) [virtual]

The documentation for this class was generated from the following file: