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 can 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)
Size and face name of the font used to display axes names can be modified via IDIFont queried from the 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 |
0 |
"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
|