DGKC Control Documentation


Skip Navigation Links.
Start page
Quick Start
Search Page
Installation
What is new
Licensing
Expand ModelsModels
Collapse DG Kernel ControlDG Kernel Control
Expand API ReferenceAPI Reference
Expand Samples and TutorialsSamples and Tutorials
Expand GraphicsGraphics
Expand Math ObjectsMath Objects
Expand DeprecatedDeprecated
Redistribution
Model Viewer
Support
Skip Navigation LinksHome Page > DG Kernel Control > Interactive Functionality > View of DGK Control > Global Axes Go to ActiveX docs Search Documentation


Global Axes

Global Axes, sometimes also called global frame, display orientation of the world. All objects are positioned and oriented relative to these global axes. 3D navigation using rotation or pan, on the other hand, changes only the point of view.

Visibility of the global frame is accessed at runtime via context menu of the control. Programmatically it is manipulated using the ShowGlobalAxes control property or the component context as described below

Global axes can also be viewed as a 3D icon at the left bottom corner of DGKC window. This icon is independent of the normal global axes

Appearance of global axes or the icon can be modified via the relevant IContext_DG interface. See below for details

Global Axes

To obtain access to properties of the global axes, query DGKC>GetView()> IView_DG> GetExtendedProperties() > IDictionary_DG > GetInterface("GlobalAxes") > IContext_DG

Global Axes Icon

IContext_DG interface for the icon can be acquired via: DGKC>GetView()>IView_DG>GetExtendedProperties() > IDictionary_DG > GetInterface("GlobalAxesIcon") > IContext_DG

To show/hide the icon call: IContext_DG>SetBool(0), or use the Boolean property id=19 of the DGKC context:

DGKC > GetView() > IView_DG > IView_DG.GetExtendedProperties() > IDictionary_DG > SetBool(19)

Properties

Size and face name of the font used to display axes names can be modified via IFont_DG queried from the IContext_DG.

The double properties below are adjustment factors applied to the automatically calculated dimension, not the actual dimensions.

Property Description Type Parameter ID Default
Visible Determines whether the axes are rendered Boolean 0 False
Solid If true axes are presented by cylinders of diameter adjustable via the WidthPointer property Boolean 1 False
Iconic Read-only. True for the axes icon Boolean 2 False
ShowNames If true axes names, as set by NameX etc properties (X,Y,Z default), are displayed Boolean 3 False
NameX Text displayed next to the X axis pointer when ShowNames is true String "X"
NameY Text displayed next to the Y axis pointer when ShowNames is true String 1 "Y"
NameZ Text displayed next to the Z axis pointer when ShowNames is true String 2 "Z"
PointerStyle 0 - Triangles, 1 - Cone Integer 0 0
IconSize Size of the icon in pixels when the axes are iconic. Ignored otherwise Integer 1 40
LengthAxis Total axis length factor. See the comment above Double 0 1.0
LengthPointer Pointer length factor. See the comment above Double 1 1.0
WidthPointer Pointer diameter factor. See the comment above Double 2 1.0
RadiusOrigin Radius of the sphere at the origin factor. Ignored if is Solid property is false. See the comment above. Double 3 1.0
ColorAxisX Color of the X axis Color 0 Red rgb(1,0,0)
ColorAxisY Color of the Y axis Color 1 Green rgb(0,1,0)
ColorAxisZ Color of the Z axis Color 2 Blue rgb(0,0,1)
ColorOrigin Color of the sphere at the origin. Ignored if is Solid property is false. Color 2 White rgb(1,1,1)
ColorTextX Color of the X axis name text Color 3 Red rgb(1,0,0)
ColorTextY Color of the Y axis name text Color 4 Green rgb(0,0.8,0)
ColorTextZ Color of the Z axis name text Color 5 Blue rgb(0,0,1)

See also: Customize Global Axes menu command in Lines sample