CBCGPChartDiagram3D

Detailed Description

The CBCGPChartDiagram3D class manages transformations and states for 3D scenes. Currently an instance of this class is automatically created by CBCGPChartVisualObject and can be retrieved with CBCGPChartVisualObject::GetDiagram3D.

You can set the following parameters for a 3D scene:

• X rotation - the angle between X axis and vertical axis in range [0 - 360] degrees (SetPosition()).
• Y rotation - the angle between Y axis and horizontal plane in range [-90 - 90] degrees (SetPosition()).
• Perspective percent - a double value in range [0 - 1] (SetPosition())
• Depth scale - a double value in range [0.1 - 10] (SetDepthScalePercent()).
• Height scale - a double value in range [0.1 - 10] (SetHeightScalePercent()).
• Front distance - a double value in range [0 - 0.9], which defines a placement of chart object within Z unit (SetFrontDistancePercent()).
• Proportional scale flag - a boolean value that defines how the normalized 1x1x1 cube is scaled to fit the view (SetProportionalScale()).

Scene objects should be defined in normalized coordinates in range [-1, 1]. Call TransformPoint() to convert normalized coordinates to screen coordinates. It takes into account scene rotation, perspective and view size.

You can switch between software and hardware-accelerated rendering engines (OpenGL) at the runtime by calling SetRenderingType() or SetEngine3D() (call the later is for custom rendering engines).

See also

CBCGPEngine3D, CBCGPEngine3DOpenGL

Public Types
enum	DrawWallOptions
enum	ExplicitGrouping

Public Member Functions
	AdjustLayout	Called to adjust layout or 3D diagram area.
	EnableChangePerspectiveByMouseWheel	Enables or disables changing 3D chart perspective by the mouse wheel.
	EnableRotationByMouse	Enables or disables chart rotation by mouse.
	GetBaseDepthPercent	Returns base depth percent for the current chart type.
	GetDepthScalePercent	Returns depth scale percent.
	GetDiagramRect	Returns bounding rectangle of diagram.
	GetDrawWallOptions	Returns the current wall drawing options.
	GetEngine3D	Returns a pointer to 3D rendering engine.
	GetExplicitGrouping	Returns the current explicit grouping option.
	GetFrontDistancePercent	Returns front distance percent.
	GetHeightScalePercent	Returns height scale percent.
	GetMouseRationFlags	Gets mouse ration flags.
	GetPerspectivePercent	Returns current perspective percent.
	GetScrollOffset	Returns the current scroll offset.
	GetXRotation	Returns X rotation, in degrees.
	GetYRotation	Returns Y rotation, in degrees.
	GetZoomFactor	Returns the current zoom factor.
	GetZRotation	Returns Z rotation.
	IsCalculateNormals	Tells whether calculation of normals is enabled.
	IsChangePerspectiveByMouseWheelEnabled	Tells whether changing 3D chart perspective by the mouse wheel is enabled.
	IsRotationByMouseEnabled	Tells whether chart rotation by mouse is enabled.
	IsShowBackfaces	Tells whether a diagram shows shape backfaces.
	IsThickWallsAndFloor	Specifies whether a 3D chart displays thick walls and floor.
	IsWallIgnoreRotation	Tells whether the walls are repositioned when the scene rotation is changed.
	OnBegin3DDraw	Called when 3D rendering is started.
	OnDraw	Called by the chart to draw the floor and walls.
	OnDrawFloor	Called to draw the floor.
	OnDrawWalls	Called to draw the floor.
	OnEnd3DDraw	Called when 3D rendering is finished.
	Reset	Resets current position and perspective to default values.
	ScalePoint	Converts a point from normalized to screen coordinates.
	SetBaseDepthPercent	This is an internal class method.
	SetCalculateNormals	Specifies whether polygon normals should be calculated during rendering.
	SetDepthScalePercent	Sets depth scale percent.
	SetDrawWallOptions	Sets the floor and wall drawing options.
	SetEngine3D	Allows to set a custom rendering engine.
	SetExplicitGrouping	Call this method to set the current explicit grouping option. The "explicit grouping" forces a 3D chart to show series on Z axis as grouped (maximum Z coordinate is always 1) or non-grouped (Z coordinate is set to the number of series, e.g. each series has its own Z coordinate).
	SetFrontDistancePercent	Sets front distance.
	SetHeightScalePercent	Sets height scale percent.
	SetPosition	Sets diagram rotation and perspective.
	SetProportionalScale	Defines scaling type or 3D scene.
	SetRenderingType	Sets rendering type for 3D scene.
	SetScrollOffset	Sets scroll offset of rendered scene.
	SetShowBackfaces	Includes or excludes back-faces to/from 3D scene.
	SetThickWallsAndFloor	Sets an option to display thick or thin walls and floor.
	SetWallsIgnoreRotation	Ignores reposition of walls when the scene is rotated.
	SetZoomFactor	Zooms the scene in or out.
	SetZRotation	Set Z rotation.
	StripWallsAndAxes	Hides or shows walls and vertical axes.
	TransformPoint	Transforms point in normalized 3D coordinates.
	TranslateDistance	Converts X and Y values in screen coordinates to normalized coordinates.

Public Attributes
	m_formatWalls	Contains walls and floor formatting options.