DG Kernel Documentation


Skip Navigation Links.
Skip Navigation LinksHome Page > DG Kernel Components > Interactive Functionality > View of DGK Control > Global Axes 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 DG Kernel window. This icon is independent of the normal global axes

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

Global Axes

To obtain access to properties of the global axes, query DG Kernel>GetView()>IView>IPropertyArray>GetProperty("GlobalAxes")>IKCContext

Global Axes Icon

IKCContext interface for the icon cab be acquired via: DG Kernel>GetView()>IView>IPropertyArray>GetProperty("GlobalAxesIcon")>IKCContext

To show/hide the icon call: IKCContext>SetBoolParam(0), or use the Boolean property id=19 of the DG Kernel context:

DG Kernel>GetView()>IView>IKCContext>SetBoolParam(19)

Properties

The color properties below are accessible via IKCContext2 (queried from IKCContext)

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
PresentationType 0 - Axes, 1 - Compass showing -z direction independently of view point Integer 2 0
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)