VisualizationFoundation CATSupport

Usage: you must use this class as is. You should never derive it.


public class CATSupport

Base class .


Constructor and Destructor Index


o CATSupport(int,int,void*)
Constructs the class from a width and an height.
o CATSupport(CATSupport&)
Copy Constructor.
o ~CATSupport()

Method Index


o AddClippingPlane(int,float*,float*,int)
Adds a clipping plane(you cannot define more than six clipping planes).
o AddViewpoint(CATViewpoint*,int)
Adds a given viewpoint.
o Clear()
Clears the screen.
o Draw(void)
Draws the scene.
o GetAntiAliasingMode()
Returns whether or not the antialiasing mode for lines is active.
o GetBackgroundColor(float*,float*,float*)
Retreives the background color.
o GetColorMap()
Returns the indexed color map.
o GetCullVanishingRatio()
Returns the culling vanishing ratio
o GetCullingPrecision()
Returns the minimum pixel size.
o GetCullingPrecisionf()
Returns the minimum pixel size.
o GetDefaultMaterialProperties(float&,float&,float&)
Retreives default material properties.
o GetGlobalAmbientLight(float*,float*,float*)
Retreives the global ambient light color.
o GetMMInSupportUnit()
Returns the millimeter size in pixel size.
o GetPointToPixelScale()
Returns the point to pixel scale (used for text and UI size regarding screen quality).
o GetRatioWH()
Returns the ration heigth/width of one pixel.
o GetSagPrecision()
Returns the sag precision.
o GetStereoMode(int*,float*)
Retreives the stereo mode.
o GetViewMode(void)
Returns the current viewer mode of the current CATSupport.
o GetWidthAndHeight(float&,float&)
Retreives the heigth and width of the current CATSupport.
o IsAmbientActivated()
Returns whether or not ambient light is active.
o IsClipped(float**,float**,int*)
Returns the number of clipping planes.
o IsFogOn()
Returns whether or not fog is active.
o RemoveClippingPlane()
Resets all the clipping planes.
o RemoveViewpoint(CATViewpoint*)
Removess a given viewpoint.
o SetAmbientActivation(unsigned int)
Activates or Deactivates the global ambient light.
o SetAntiAliasingMode(int)
Sets the antialiasing mode for lines.
o SetBackgroundColor(float,float,float)
Sets the background color.
o SetCullVanishingRatio(float)
Sets the culling vanishing ratio
Role: Objects which size is greater that ratio * total scene size are never culled by pixel culling
o SetCullingPrecision(int)
Gives the minimum pixel size for objects to be drawn.
o SetCullingPrecisionf(float)
Gives the minimum pixel size for objects to be drawn.
o SetDefaultMaterialProperties(float,float,float)
Sets default material properties.
o SetFogMode(int)
Sets the fog mode.
o SetGlobalAmbientLight(float,float,float)
Sets the global ambient light color.
o SetMMInSupportUnit(float)
Sets one millimeter size in pixel size.
o SetPointToPixelScale(float)
Returns whether the point to pixel scale can be changed on current CATSupport
o SetRatioWH(float)
Sets the ratio heigth/width of one pixel.
o SetSagPrecision(float)
Sets the sag in pixel size.
o SetStereoMode(int,float)
Sets the stereo mode.
o SetViewMode(int,int)
Sets the viewmode for viewer enclosed in the current CATSupport.
o SetWidthAndHeight(float,float)
Sets the heigth and width of the current CATSupport.
o Swap()
Swaps back buffer to front buffer.
o SwitchBack()
Sets the back buffer as active : we are drawing into it.
o SwitchBackLeft()
Sets the left back buffer as active when working in stereo mode: we are drawing into it.
o SwitchBackRight()
Sets the right back buffer as active when working in stereo mode: we are drawing into it.
o SwitchFront()
Sets the front buffer as active : we are drawing into it.
o SwitchFrontLeft()
Sets the left front buffer as active when working in stereo mode: we are drawing into it.
o SwitchFrontRight()
Sets the right front buffer as active when working in stereo mode: we are drawing into it.
o SynchronizeSlaveWindows()
Synchronize slave windows together in Multi GPU case.
o ViewMode(int)
Returns whether or not the given mode is active.

Constructor and Destructor


o CATSupport
public CATSupport( const width,
const height,
const display= NULL)
Constructs the class from a width and an height.
Parameters:
width
pixel width.
height
pixelheight.
display
diplay X. Must be NULL on WINDOWS.
o CATSupport
public CATSupport( const )
Copy Constructor.
o ~CATSupport
public virtual ~CATSupport()

Methods


o AddClippingPlane
public AddClippingPlane( const iNbPlanes,
const iPoint,
const iNnormal,
const iCappingPlaneSeen= 1)
Adds a clipping plane(you cannot define more than six clipping planes).
Parameters:
iNbPlanes
number of planes.
iPoint
array of 3xiNbPlanes of coordinates. Each (x,y,z) represents a point belonging to a clipping plane. And there is only one point per plane.
iNnormal
array of 3xiNbPlanes of coordinates. Each (x,y,z) represents a normal to one plane. And there is only one normal per plane.
iCappingPlaneSeen
  1. 0 = intersection between clipping planes and volumic graphical representations is not filled in
  2. 1 = intersection between clipping planes and volumic graphical representations is filled in
o AddViewpoint
public virtual AddViewpoint( iVpt,
iPlace= 1 )
Adds a given viewpoint.
Parameters:
iVpt
the viewpoint.
iPlace
integer value
  1. 1 = Foreground
  2. 0 = Background
o Clear
public virtual Clear()
Clears the screen.
o Draw
public virtual Draw( )
Draws the scene.
o GetAntiAliasingMode
public GetAntiAliasingMode()
Returns whether or not the antialiasing mode for lines is active.
Returns:
integer
  1. 0 = antialiasing is off
  2. 1 = antialiasing is on
o GetBackgroundColor
public GetBackgroundColor( oR,
oG,
oB)
Retreives the background color.
Parameters:
oR
the red composant color.
oG
the green composant color.
oB
the blue composant color.
o GetColorMap
public GetColorMap()
Returns the indexed color map.
See also:
o GetCullVanishingRatio
public GetCullVanishingRatio()
Returns the culling vanishing ratio
o GetCullingPrecision
public GetCullingPrecision()
Returns the minimum pixel size.
o GetCullingPrecisionf
public GetCullingPrecisionf()
Returns the minimum pixel size.
o GetDefaultMaterialProperties
public GetDefaultMaterialProperties( oDiffAmbCoef,
oSpecCoef,
oShininess)
Retreives default material properties.
Parameters:
oDiffAmbCoef
the diffuse and ambient coefficient.
oSpecCoef
the specular coefficient.
oShininess
the shininess.
o GetGlobalAmbientLight
public GetGlobalAmbientLight( oR,
oG,
oB)
Retreives the global ambient light color.
Parameters:
oR
the red composant color.
oG
the green composant color.
oB
the blue composant color.
o GetMMInSupportUnit
public GetMMInSupportUnit()
Returns the millimeter size in pixel size.
o GetPointToPixelScale
public GetPointToPixelScale()
Returns the point to pixel scale (used for text and UI size regarding screen quality).
o GetRatioWH
public GetRatioWH()
Returns the ration heigth/width of one pixel.
o GetSagPrecision
public GetSagPrecision()
Returns the sag precision.
o GetStereoMode
public GetStereoMode( oMode,
oEyeGap)
Retreives the stereo mode.
Parameters:
oMode
  1. 0 = off
  2. 1 = manual
  3. 2 = automatic
oEyeGap
gap between the eyes (model unit). Avaible only in manual mode.
o GetViewMode
public GetViewMode( )
Returns the current viewer mode of the current CATSupport.
See also:
o GetWidthAndHeight
public GetWidthAndHeight( oWidth,
oHeight)
Retreives the heigth and width of the current CATSupport.
Parameters:
oWidth
the width.
oHeight
the height.
o IsAmbientActivated
public IsAmbientActivated()
Returns whether or not ambient light is active.
Returns:
integer
  1. 1 = ambient ligh is active
  2. 0 = ambient ligh is not active
o IsClipped
public IsClipped( oPoint,
oNormal,
oCappingPlaneSeen)
Returns the number of clipping planes.
Parameters:
oPoint
pointer to an array of 3xiNbPlanes of coordinates. Each (x,y,z) represents a point belonging to a clipping plane. And there is only one point per plane.
oNnormal
pointer to an array of 3xiNbPlanes of coordinates. Each (x,y,z) represents a normal to one plane. And there is only one normal per plane.
oCappingPlaneSeen
  1. 0 = intersection between clipping planes and volumic graphical representations is not filled in
  2. 1 = intersection between clipping planes and volumic graphical representations is filled in
o IsFogOn
public IsFogOn()
Returns whether or not fog is active.
Returns:
integer
  1. 1 = fog is active
  2. 0 = fog is not active
o RemoveClippingPlane
public RemoveClippingPlane()
Resets all the clipping planes.
o RemoveViewpoint
public virtual RemoveViewpoint( iVpt)
Removess a given viewpoint.
Parameters:
iVpt
the viewpoint.
o SetAmbientActivation
public SetAmbientActivation( iOnOff)
Activates or Deactivates the global ambient light.
Parameters:
iOnOff
0 = off. 1 = on.
o SetAntiAliasingMode
public SetAntiAliasingMode( const iAntialiasingMode)
Sets the antialiasing mode for lines.
Parameters:
iAntialiasingMode
  1. 0 = antialiasing is off
  2. 1 = antialiasing is on
o SetBackgroundColor
public virtual SetBackgroundColor( const iR,
const iG,
const iB)
Sets the background color.
Parameters:
iR
the red composant color.
iG
the green composant color.
iB
the blue composant color.
o SetCullVanishingRatio
public SetCullVanishingRatio( iRatio)
Sets the culling vanishing ratio
Role: Objects which size is greater that ratio * total scene size are never culled by pixel culling
o SetCullingPrecision
public SetCullingPrecision( const iCullingPrecision)
Gives the minimum pixel size for objects to be drawn.
Role: Objects which size is less than the iCullingPrecision are not drawn.
Parameters:
iCullingPrecision
the minimum pixel size for objects to be drawn.
o SetCullingPrecisionf
public SetCullingPrecisionf( const iCullingPrecision)
Gives the minimum pixel size for objects to be drawn.
Role: Objects which size is less than the iCullingPrecision are not drawn.
Parameters:
iCullingPrecision
the minimum pixel size for objects to be drawn.
o SetDefaultMaterialProperties
public SetDefaultMaterialProperties( iDiffAmbCoef,
iSpecCoef,
iShininess)
Sets default material properties.
Parameters:
iDiffAmbCoef
the diffuse and ambient coefficient.
iSpecCoef
the specular coefficient.
iShininess
the shininess.
o SetFogMode
public SetFogMode( const iFogMode)
Sets the fog mode.
Parameters:
iFogMode
  1. 0 = fog is off
  2. 1= fog is on
o SetGlobalAmbientLight
public virtual SetGlobalAmbientLight( const iR,
const iG,
const iB)
Sets the global ambient light color.
Parameters:
iR
the red composant color.
iG
the green composant color.
iB
the blue composant color.
o SetMMInSupportUnit
public SetMMInSupportUnit( const iSize)
Sets one millimeter size in pixel size.
Parameters:
iSize
the pixel size .
o SetPointToPixelScale
public virtual SetPointToPixelScale( const iScale)
Returns whether the point to pixel scale can be changed on current CATSupport
Parameters:
iScale
the new point to pixel scale factor.
o SetRatioWH
public SetRatioWH( const iRatio)
Sets the ratio heigth/width of one pixel.
Role: it is useful when pixel is not a squarre. It is screen-dependant.
o SetSagPrecision
public SetSagPrecision( const iSagPrecision)
Sets the sag in pixel size.
Role: sag is used for determining which level of details to use.
Parameters:
iSagPrecision
the sagprecision.
o SetStereoMode
public virtual SetStereoMode( const iMode,
const iEyeGap)
Sets the stereo mode.
Parameters:
iMode
  1. 0 = off
  2. 1 = manual
  3. 2 = automatic
iEyeGap
gap between the eyes (model unit). Avaible only in manual mode.
o SetViewMode
public virtual SetViewMode( const iMode,
const iActive)
Sets the viewmode for viewer enclosed in the current CATSupport.
Parameters:
iMode:
The viewer mode. Legal values:
iActive
0 = off. 1 = on.
o SetWidthAndHeight
public SetWidthAndHeight( const iWidth,
const iHeight)
Sets the heigth and width of the current CATSupport.
Parameters:
iWidth
the width.
iHeight
the height.
o Swap
public virtual Swap()
Swaps back buffer to front buffer.
o SwitchBack
public virtual SwitchBack()
Sets the back buffer as active : we are drawing into it.
o SwitchBackLeft
public virtual SwitchBackLeft()
Sets the left back buffer as active when working in stereo mode: we are drawing into it.
o SwitchBackRight
public virtual SwitchBackRight()
Sets the right back buffer as active when working in stereo mode: we are drawing into it.
o SwitchFront
public virtual SwitchFront()
Sets the front buffer as active : we are drawing into it.
Role: when you are in furtive mode you draw graphical representations into the front buffer.
o SwitchFrontLeft
public virtual SwitchFrontLeft()
Sets the left front buffer as active when working in stereo mode: we are drawing into it.
o SwitchFrontRight
public virtual SwitchFrontRight()
Sets the right front buffer as active when working in stereo mode: we are drawing into it.
o SynchronizeSlaveWindows
public virtual SynchronizeSlaveWindows()
Synchronize slave windows together in Multi GPU case. This method is only available in the new render engine.
Returns:
E_FAIL it all windows fail to synchronize. S_OK if all succeed, S_FALSE if there are failure but at least one is OK.
o ViewMode
public ViewMode( const iMode)
Returns whether or not the given mode is active.
Parameters:
iMode
the viewer mode.
Legal values:

This object is included in the file: CATSupport.h
If needed, your Imakefile.mk should include the module: CATVisFoundation

Copyright © 1999-2015, Dassault Systèmes. All rights reserved.