Axis

Valid Parents: Domain

Valid Children: None

Description

The Axis object reflects the coordinate system defined by the Domain object and provides a scale by which the graphed data can be measured.

Axis Resource tabs

Axis Resources

Axle Resource Set

The Axle resources allow you to change the axles for the currently selected 2D­ or 3D­axis.

The axle of an axis is simply a line drawn between the axis limits. A conventional X­axis has the axle drawn as a horizontal line, and a Y­axis drawn as a vertical line. If XuNxyOrientation (XY Orientation) of the Domain is changed to swapped XY ( xy ), then the X­axle is drawn as a vertical line. All resources associated with the previous horizontal X­axis are used to graph the vertical X­axis. In a polar coordinate system, the R­axle is simply a radial line and the T­axle is a circular arc spanning the axis limits.

New Resources

Axis/Axle Resource Set

Enabled(XuNaxle)
This resource controls the visibility of the axle. Setting it to false (Off) disables drawing of the entire axis.

  • Type: float
  • Default: true
  • Range: false,true

Color (XuNaxleColor)
The color of the axle. This color is also the default color for tickmarks and ticklines.

  • Type: float
  • Default: 1
  • Range:

Width (XuNaxleWidth)

  • Type: float
  • Default: Unset
  • Range: 0:5

Clearance (XuNaxleComponentInterspace)
Allows you to specify the minimum distance (interspace) separating the axle, axis labels, axis unit and axis text from each other. For a 2D axis, the interspace is specified as a percentage of the minimum dimension of the 2D workbox. If this 2D axis is projected, then the percentage is based on the minimum dimension of the side of the 3D workbox where the 2D axis is projected. For a 3D axis, the percentage is based on the minimum dimension of the 3D workbox. The choice of the interspace can be unset or any value between 0 and 20%. If this is unset, the interspace used is 50 percent of the height of the axis labels.

  • Type: float
  • Default: Unset
  • Range: 0:20

Date (XuNaxleCrossDate)
The cross date indicates the date where the specified axis starts or crosses the transverse combined date/time axis. The XuNaxleCrossTime (Cross Time) resource must also be set to specify the cross time value. Axle cross values can also be interactively set by selecting and dragging the axis with MB1.

  • Type: string
  • Default: Unset
  • Range: N/A

Date/Time (XuNaxleCrossDateTime)
The cross date/time indicates where the specified axis starts or crosses the transverse calendar or time axis. Note that this value refers to the Y­axis value when specifying the X­axis and to the X­axis value when specifying the Y­axis. This resource only appears when a 2D domain is selected. The cross date/time can be unset or any valid date or time value. If the cross date/time value is unset, then the Limits set in the Domain are used. Default cross date/time values: 1st 2D X­axis: 'Y min date/time' of Limits. 1st 2D Y­axis: 'X min date/time' of Limits. 2nd 2D X­axis: 'Y max date/time' of Limits. 2nd 2D Y­axis: 'X max date/time' of Limits Axle cross values can also be interactively set by selecting and dragging the axis with MB1.

  • Type: string
  • Default: Unset
  • Range: N/A

Time (XuNaxleCrossTime)
The cross date indicates the time where the specified axis starts or crosses the transverse combined date/time axis. The XuNaxleCrossDate (Cross Date) resource must also be set to specify the cross date value. Axle cross values can also be interactively set by selecting and dragging the axis with MB1.

  • Type: string
  • Default: Unset
  • Range: N/A

Cross Value (XuNaxleCrossValue)
The cross value indicates where the specified axis starts or crosses the transverse axis. Note that for a Cartesian axis, this value refers to the Y­axis value when specifying the X­axis; and the X­axis value when specifying the Y­axis. Likewise for a polar axis, this value refers to the T­axis value when specifying the R­axis; and the R­axis value when specifying the T­axis. The cross value can be unset or any value (except the 'undefined'). If the cross value is unset, then the Limits set in the Domain are used. Default Cartesian cross values: 1st 2D X­axis: 'Y minimum' of Limits. 1st 2D Y­axis: 'X minimum' of Limits. 2nd 2D X­axis: 'Y maximum' of Limits. 2nd 2D Y­axis: 'X maximum' of Limits. Default polar cross values: 1st R­axis: 'T minimum' of Limits. 1st T­axis: 'R maximum' of Limits. 2nd R­axis: 'T maximum' of Limits. 2nd T­axis: 'R minimum' of Limits. Axle cross values can also be interactively set by selecting and dragging the axis with MB1.

  • Type: float
  • Default: Unset
  • Range:

End Periods (XuNaxleEndPeriodsData)
Specifies the name of an array containing the end times of periods.

  • Type: string
  • Default: Unset
  • Range: N/A

Holiday (XuNaxleHolidays)
Allows you to set whether holidays should to be eliminated or included in the calendar axis. Note that this resource does not appear when the 2nd axis of a 2D domain is edited. Possible options:

Label Value Description
No Holidays "noHolidays" No user­defined holidays recognized.
Remove Holidays "removeHolidays" Removes all dated defined in XuNaxleHolidaysData (Holidays Data)
Include Holidays "includeHolidays" Includes all dated defined in XuNaxleHolidaysData (Holidays Data)Dates included as holidays can be colored differently from other dates using the XuNaxisLabelsHolsColor (Holiday Color) resource found in the Axis/Labels bundle.
  • Type: string
  • Default: "noHolidays"
  • Range: "noHolidays" ," removeHolidays" ,"includeHolidays"

Holiday Data (XuNaxleHolidaysData)
The name of the dataset containing dates of holidays. The dates must be in one of the date formats described in Date Data Type.

  • Type: string
  • Default: Unset
  • Range: N/A

Coordinate (XuNaxleLabelsCoordData)
The name of a float dataset containing the locations of the axis labels in world coordinates. The size of this dataset should match the size of the XuNaxleNumericLabelsData (Numeric Labels Data) dataset.

  • Type: float
  • Default: Unset
  • Range:

Major (XuNaxleMajorTickmarksData)
The name of a float dataset containing the locations of the major tickmarks in world coordinates.

  • Type: float
  • Default: Unset
  • Range:

Minor (XuNaxleMinorTIckmarksData)
The name of a float dataset containing the locations of the minor tickmarks in world coordinates.

  • Type: float
  • Default: Unset
  • Range:

Numeric (XuNaxleNumericLabelsData)
The name of a float dataset containing the axis labels. The size of this dataset should match the size of the XuNaxleLabelsCoordData (Labels Coordinate Data) dataset.

  • Type: string
  • Default: Unset
  • Range: N/A

Layout (XuNaxleScaleLayout)
The choices of calendar scale and date/time scale layout are:

Label Value Description
D/M/Y "D/M/Y" Day of the month, month and year used as axis labels.
D/M/Q/Y "D/M/Q/Y" Day of the month, month, quarter and year used as axis labels.
D/Y "D/Y" Day of the year and year used as axis labels.
D/W/Y "D/W/Y" Day of the week, week number and year used as axis labels.
ss/mm/hh/D/M/Y "ss/mm/hh/D/M/Y" Second, minute, hour, day number, month number, and year number used for combined date/time labels.
ss/mm/hh/D/M/Q/Y "ss/mm/hh/D/M/Q/Y" Second, minute, hour, day number, month number, quarter number, and year number used for combined date/time labels.
ss/mm/hh/D/Y "ss/mm/hh/D/Y" Second, minute, hour, day number, and year number used for combined date/time labels.
ss/mm/hh/D/W/Y "ss/mm/hh/D/M/Y" Second, minute, hour, day number, week number, and year number used for combined date/time labels.

A week always starts on a Monday and ends on a Sunday. The weeks within the year are numbered from 1 up to 53. The first week of the year is the one that includes the first Thursday of that year. Note that to invoke this resource, the Domain resource XuNxDataType (X Data Type) must be set to 'date' (Date) or 'dateTime' (Date and Time).

  • Type: string
  • Default: "D/M/Y"
  • Range: "D/M/Y" ," D/M/Q/Y" ," D/Y" ,"D/W/Y" ," ss/mm/hh/D/M/Y" ,"ss/mm/hh/D/M/Q/Y" ,"ss/mm/hh/D/Y" ,"ss/mm/hh/D/W/Y"

Start Periods (XuNaxleStartPeriodsData)
Specifies the name of an array containing the start times of periods.

  • Type: string
  • Default: Unset
  • Range: N/A

Time Periods (XuNaxleTimePeriods)
Controls how time periods should be handled. Possible options:

Label Value Description
No Time Periods "noTimePeriods" No user­defined holidays recognized.
Remove Time Periods "removeTimePeriods" The periods specified by XuNaxleStartPeriodsData (Start Periods Data) and XuNaxleEndPeriodsData (End Periods Data) are excluded from the axis.
Include Time Periods "includeTimePeriods" Only the periods specified by XuNaxleStartPeriodsData (Start Periods Data) and XuNaxleEndPeriodsData (End Periods Data) are included on the axis.
  • Type: string
  • Default: "noTimePeriods"
  • Range: "noTimePeriods" ,"removeTimePeriods" ,"includeTimePeriods"

Type (XuNaxleType)
Sets the type of axis scale. Possible options are:

Label Value Description
Linear "linear" Linear distribution of axis scale.
Logarithmic "logarithmic" Logarithmic distribution of axis scale.
User­labeled "userLabeled" A discontinuous linear scale, labeled by with N axis labels specified by XuNaxleUserLabelsData (User­Labels Data).This type of scale is normally used for data which is independent and discrete, for example, name of persons, places, animals, objects, etc.
User­defined "userDefined" The scales tickmark layout is user defined according to the coordinates in XuNaxleLabelsCoordData (Labels Coordinate Data).
  • Type: string
  • Default: "linear"
  • Range: "linear" ," logarithmic" ,"userLabeled" ," userDefined"

User (XuNaxleUserLabelsData)
The name of a dataset that contains a single column of text strings to be used as user­labels for the currently edited axes.

  • Type: string
  • Default: Unset
  • Range: N/A

Weekend (XuNaxleWeekends)
Sets the weekends status of the calendar axis. Note that this resource does not appear when the 2nd axis of a 2D domain is currently selected. Possible options:

Label Value Description
Include Weekends "includeWeekends" Includes Saturdays and Sundays.
Remove Weekends "removeWeekends" Removes Saturdays and Sundays. Tickmarks, axis labels and ticklines indicating weekends are eliminated from the axis. Eliminated dates contained in a dataset are treated as 'undefined' when it is drawn.
Remove Sundays "removeSundays" Removes only Sundays from the calendar axis.
Remove Saturdays "removeSaturdays" Removes only Saturdays from the calendar axis.

Weekend dates can be colored differently from other dates using the XuNaxisLabelsSatColor (Saturday Color) and XuNaxisLabelsSunColor (Sunday Color) resources found in the Axis/Labels bundle. XuNaxleWidth (Axle Width) Controls the width of the axle. If the axle width is unset, then the width used is based on the dimensions of the workbox and the height of the axis labels. Tickmarks and ticklines widths that are unset will be based on the axle width.

  • Type: string
  • Default: "includeWeekends"
  • Range: "includeWeekends" ,"removeWeekends" ,"removeSundays" ,"removeSaturdays"

Labels Resource Set

The Labels resource set contains resources related to axis scale labels.

A linear or logarithmic axis has numeric labels to indicate the axis values of the major tickmarks. The number of axis labels is normally dependent upon the length of the axis and the height of the axis labels.

For a user­labeled axis, the axis labels that you supply are used to annotate the major tickmarks or the intervals between the major tickmarks. If you specify axis labels, all labels are drawn. The height of the axis labels is reduced successively until all labels can fit nicely along the axle. This feature is controlled by the XuNaxisLabelsIterateHeight (Iterate Height) resource.

The calendar axis can use up to four levels of axis labels and the time axis three levels to annotate the axis scale. A combined date and time axis can use up to seven levels of axis labels.For example, to label the days of the month, months, quarters and years four levels are needed. The innermost (closest to the axle) level is level 1 and outermost level is level 4. By default, the actual number of levels and the number of axis labels drawn are dependent on the length of the axis and the height of the axis labels. The visibility of each label level can be set independently, starting with XuNaxisLabelsLevel1Format (­ Format). The first level of the axis labels of a calendar axis refers to the first date element of the choice of the XuNaxleScaleLayout (Scale Layout). For example, the scale layout of 'D/M/Y' has day as the first time element and therefore, the first level of the axis labels has day of the month as labels.

For the time axis, the first level refers to the time element 'second' as axis labels, second level to the 'minute' axis labels and the third level to the 'hour' axis labels.

New Resources

Axis/Labels Resource Set

Abbr. Days (XuNaxisLabelsAbbrDayNames)
The name of a dataset containing seven day abbreviations for the 'D/W/Y' calendar scale. If the abbreviated and full names are not specified, the default for day of the week is a number between 1 (Monday) and 7 (Sunday). The abbreviated day names are the same as the full day names if only one set of day names is specified.

  • Type: string
  • Default: Unset
  • Range: N/A

Abbr. Months (XuNaxisLabelsAbbrMonthNames)
The name of a dataset containing the 12 month abbreviations. If the full and abbreviated names are not specified, the first three characters (uppercase) of the month names in English are used. Note that the abbreviated month names are the same as the full month names if only one set of month names is specified.

  • Type: string
  • Default: Unset
  • Range: N/A

Abbr. Quarters (XuNaxisLabelsAbbrQuarterNames)
The name of a dataset containing either four names of quarter of the year to be used as abbreviated quarter names, or one name to be used as abbreviated quarter designator. If the abbreviated and full quarter names or designators are not specified, the abbreviated quarter designator 'Q' is used. Note that the same dataset is used for both full and abbreviated quarter names if only one name dataset is specified.

  • Type: string
  • Default: Unset
  • Range: N/A

Abbr. Weeks (XuNaxisLabelsAbbrWeekDesignator)
A text string or a dataset containing a text string to replace the default abbreviated name 'W'. The abbreviated week designator is the same as the full week designator if only one designator is specified.

  • Type: string
  • Default: Unset
  • Range: N/A

Log Pattern (XuNaxisLabelsBasicLogPattern)
Defines how log axes are labeled. Possible options:

Label Value Description
Default "default" Attempt to label all major tickmarks, constrained by the height of the axis labels.
1­10 "1­10" A 1­10 pattern will only generate labels like 0.001, 0.01, 0.1, 1.0, 10.0, 100.0, etc.
  • Type: string
  • Default: "default"
  • Range: "default" ,"1­10"

Boldness (XuNaxisLabelsBoldness)
The relative boldness of the text. The value must be in the range of 0. ­ 20. and expresses a percentage of the character height. Vector fonts are by default represented by one pixel wide vectors on the screen and by a boldness of 10% of the character height on hardcopy devices. With polygon fonts, the boldness factor affects the outline of the fonts. By default the outline has no width. The character has a width but the line outlining it has no width. By setting the boldness factor, the width of the line surrounding the character is increased.

  • Type: float
  • Default: 0
  • Range: 0:20

Color (XuNaxisLabelsColor)
The color of a label text. Calendar and time axes have several levels of axis labels. This resource always sets the color of axis labels of level 1. Other levels use the same color as level 1 if their specific label color resources are unset.

  • Type: float
  • Default: 1
  • Range:

Day Names (XuNaxisLabelsDayNames)
The name of a dataset containing the seven names of day of the week to be used as full names for the 'D/W/Y' calendar scale. If the full and abbreviated names are not specified, the default for day of the week is a number between 1 (Monday) and 7 (Sunday). Note that the full day names are the same as the abbreviated day names if only one set of day names is specified.

  • Type: string
  • Default: Unset
  • Range: N/A

Decimal (XuNaxisLabelsDecimalPoint)
The default decimal point symbol is the period (.) character. You can specify any character as a replacement.

  • Type: string
  • Default: "."
  • Range: .

Decimals (XuNaxisLabelsDecimals)
This specifies how many digits are drawn to the right of the decimal point. Zero decimals means that the numeric labels are drawn as whole numbers without the decimal points. The choice can be unset or any value between 0 and 5. If this resource is unset (default), an appropriate number of decimals used is based on the numeric values of the axis labels. This resource has no effect on user­labeled, calendar or time axes.

  • Type: float
  • Default: Unset
  • Range: 0:5

Expansion (XuNaxisLabelsExpansion)
The width of the character body. To produce wider­than­normal characters set the expansion to greater than 1. Narrower characters are achieved by setting expansion to less than 1.

  • Type: float
  • Default: 1
  • Range: 0.2:2

First Quarter (XuNaxisLabelsFirstQuarterMonth)
The month number where the first quarter of the year should start. By default the first quarter month number is 1 (January). This means that the first, second, third and fourth quarter start on the first of January, April, July and October, respectively.

  • Type: string
  • Default: "january"
  • Range: "january" ," january:'december'"

Font (XuNaxisLabelsFont)
The font for the axis labels. The default font is determined by the textoption font resource. See textoption and XuNfont (Font).

  • Type: string
  • Default: Unset
  • Range: " simp" ,"carg" ,"cart" ,"cenb" ,"cobo" ,"comp" ,"coub" ,"couo" ,"cour" ,"cyri" ,"dupl" ,"futu" ,"gote" ,"gotg" ,"goti" ,"gree" ,"hebo" ,"helb" ,"helo" ,"helv" ,"ital" ,"matr" ,"psim" ,"scri" ,"simg" ,"sims" ,"smag" ,"smai" ,"smal" ,"swib" ,"swil" ,"swim" ,"tem","tibi","tibo","tiit","tiro","trii","trip","utbi","utob","utoi","utor","vsim"

Height (XuNaxisLabelsHeightActual)
The height of the axis labels. The height effectively defines the number of major tickmarks and axis labels for linear, logarithmic, calendar and time axes. If the height is unset, a default height of 3 percent is used. Calendar and time axes have several levels of axis labels. This resource always sets the height of the axis label level closest to the axle. Thus the axis label height of level 2, 3 or 4 can be superseded by the innermost axis label height. This happens when the innermost level of the axis labels falls on level 2, 3, or 4. Note that other levels use the same height as the innermost level if they are unset.

  • Type: float
  • Default: 3
  • Range: 0.001:20

Holiday (XuNaxisLabelsHolsColor)
The color of axis labels (level 1) indicating user­defined holidays. The choice can be unset or any color presented in the popup color panel. The default color is specified in the resource XuNaxisLabelsColor (Color).

  • Type: float
  • Default: Unset
  • Range:

Iterate Height (XuNaxisLabelsIterateHeight)
This resource is only relevant for user­labeled axes. If the height of the axis labels is such that the labels overlap, even if the labels are rotated, then the height is reduced successively by 20 percent until no labels overlap. The default is to iterate for the height.

  • Type: float
  • Default: true
  • Range: false,true

Enabled (XuNaxisLabelsLabels)
Controls the visibility of axis labels.

  • Type: float
  • Default: true
  • Range: false,true

Format (XuNaxisLabelsLevel1Format)
Set the format string for date/time axis labels. Using the default format string, the axis labels contain the names/numbers appropriate for the given axis level. The default label format can be overridden by specifying a format string consisting of format characters each preceded by the percent sign (%). A format character is substituted for the corresponding date/time element. Format characters are defined below.

Character

Date/Time element

a Day of the week
C Year with Century (1601­)
d Day of the month (01­31)
D Day of the month (1­31)
h Hour of 24 hour clock (00­24)
H Hour of 24 hour clock (0­24)
i Hour of 12 hour clock (00­12)
I Hour of 12 hour clock (0­12)
j Day of the year (001­366)
J Day of the year (1­366)
m Minute (00­59)
M Minute (0­59)
o Month
P A.M. or P.M
q Quarter
s Second (00­59)
S Second (0­59)
w Week number of the year (00­53)
W Week number of the year (0­53)
y Year without century (00­99)
Y Year without century (0­99)

%

%

Any non­format characters, or format characters not appropriate for a given level, will be printed as ordinary characters. Axis label format characters.

Examples:

Format String Label
%o%d 05/06
%d%o%C 06/05/1999
%h:%m:%s 10:58:30
%d­%m­%C %h:%m 06­MAY­1999 10:58
  • Type: string
  • Default: Unset
  • Range: N/A

Enabled (XuNaxisLabelsLevel1Labels)
Controls visibility of the innermost level of axis labels. Innermost labels are closest to the tickmarks. XuNtickmarksMajorLabelLevel (­ Label Level) on page8­42 can be used to set which label level is innermost.

  • Type: float
  • Default: true
  • Range: false,true

Suppression (XuNaxisLabelsLevel1Suppression)
See XuNaxisLabelsSuppression (Suppression).

  • Type: string
  • Default: Unset
  • Range: " firstLabel" ," lastLabel" ,"bothLabels"

Color (XuNaxisLabelsLevel2Color)
Allows you to set the color of the axis labels for this level. You can select unset or any color presented in the popup color panel. The default color is set by the resource XuNaxisLabelsColor (Color).

  • Type: float
  • Default: Unset
  • Range:

Format (XuNaxisLabelsLevel2Format)
See XuNaxisLabelsLevel1Format (­ Format).

  • Type: string
  • Default: Unset
  • Range: N/A

Height (XuNaxisLabelsLevel2Height)
The height of the axis labels for this level. The height can be superseded if the innermost level is Level 2. Possible settings include: unset or any value between 0 and 20 percent. The default height is set by the resource

  • Type: float
  • Default: Unset
  • Range: 0.001:20

Height (XuNaxisLabelsHeightActual)

  • Type: float
  • Default: 3
  • Range: 0.001:20

Enabled (XuNaxisLabelsLevel2Labels)
Controls the visibility of second level axis labels.

  • Type: float
  • Default: true
  • Range: false,true

Suppression (XuNaxisLabelsLevel2Suppression)
See XuNaxisLabelsSuppression (Suppression).

  • Type: string
  • Default: Unset
  • Range: " firstLabel" ," lastLabel" ,"bothLabels"

Color (XuNaxisLabelsLevel3Color)
See XuNaxisLabelsLevel2Color (­ Color).

  • Type: float
  • Default: Unset
  • Range:

Format (XuNaxisLabelsLevel3Format)
See XuNaxisLabelsLevel1Format (­ Format).

  • Type: string
  • Default: Unset
  • Range: N/A

Height (XuNaxisLabelsLevel3Height)
See XuNaxisLabelsLevel2Height (­ Height).

  • Type: float
  • Default: Unset
  • Range: 0.001:20

Enabled (XuNaxisLabelsLevel3Labels)
See XuNaxisLabelsLevel2Labels (Level 2 Labels).

  • Type: float
  • Default: true
  • Range: false,true

Suppression (XuNaxisLabelsLevel3Suppression)
See XuNaxisLabelsSuppression (Suppression).

  • Type: string
  • Default: Unset
  • Range: " firstLabel" ," lastLabel" ,"bothLabels"

Color (XuNaxisLabelsLevel4Color)
See XuNaxisLabelsLevel2Color (­ Color).

  • Type: float
  • Default: Unset
  • Range:

Format (XuNaxisLabelsLevel4Format)
See XuNaxisLabelsLevel1Format (­ Format).

  • Type: string
  • Default: Unset
  • Range: N/A

Height (XuNaxisLabelsLevel4Height)
See XuNaxisLabelsLevel2Height (­ Height).

  • Type: float
  • Default: Unset
  • Range: 0.001:20

Enabled (XuNaxisLabelsLevel4Labels)
See XuNaxisLabelsLevel2Labels (Level 2 Labels).

  • Type: float
  • Default: true
  • Range: false,true

Suppression (XuNaxisLabelsLevel4Suppression)
See XuNaxisLabelsSuppression (Suppression).

  • Type: string
  • Default: Unset
  • Range: " firstLabel" ," lastLabel" ,"bothLabels"

Color (XuNaxisLabelsLevel5Color)
See XuNaxisLabelsLevel2Color (­ Color).

  • Type: float
  • Default: Unset
  • Range:

Format (XuNaxisLabelsLevel5Format)
See XuNaxisLabelsLevel1Format (­ Format).

  • Type: string
  • Default: Unset
  • Range: N/A

Height (XuNaxisLabelsLevel5Height)
See XuNaxisLabelsLevel2Height (­ Height).

  • Type: float
  • Default: Unset
  • Range: 0.001:20

Enabled (XuNaxisLabelsLevel5Labels)
See XuNaxisLabelsLevel2Labels (Level 2 Labels).

  • Type: float
  • Default: true
  • Range: false,true

Suppression (XuNaxisLabelsLevel5Suppression)
See XuNaxisLabelsSuppression (Suppression).

  • Type: string
  • Default: Unset
  • Range: " firstLabel" ," lastLabel" ,"bothLabels"

Color (XuNaxisLabelsLevel6Color)
See XuNaxisLabelsLevel2Color (­ Color).

  • Type: float
  • Default: Unset
  • Range:

Format (XuNaxisLabelsLevel6Format)
See XuNaxisLabelsLevel1Format (­ Format).

  • Type: string
  • Default: Unset
  • Range: N/A

Height (XuNaxisLabelsLevel6Height)
See XuNaxisLabelsLevel2Height (­ Height).

  • Type: float
  • Default: Unset
  • Range: 0.001:20

Enabled (XuNaxisLabelsLevel6Labels)
See XuNaxisLabelsLevel2Labels (Level 2 Labels).

  • Type: float
  • Default: true
  • Range: false,true

Suppression (XuNaxisLabelsLevel6Suppression)
See XuNaxisLabelsSuppression (Suppression).

  • Type: string
  • Default: Unset
  • Range: " firstLabel" ," lastLabel" ,"bothLabels"

Color (XuNaxisLabelsLevel7Color)
See XuNaxisLabelsLevel2Color (­ Color).

  • Type: float
  • Default: Unset
  • Range:

Format (XuNaxisLabelsLevel7Format)
See XuNaxisLabelsLevel1Format (­ Format).

  • Type: string
  • Default: Unset
  • Range: N/A

Height (XuNaxisLabelsLevel7Height)
See XuNaxisLabelsLevel2Height (­ Height).

  • Type: float
  • Default: Unset
  • Range: 0.001:20

Enabled (XuNaxisLabelsLevel7Labels)
See XuNaxisLabelsLevel2Labels (Level 2 Labels).

  • Type: float
  • Default: true
  • Range: false,true

Suppression (XuNaxisLabelsLevel7Suppression)
See XuNaxisLabelsSuppression (Suppression).

  • Type: string
  • Default: Unset
  • Range: " firstLabel" ," lastLabel" ,"bothLabels"

Minus Sign (XuNaxisLabelsMinusSign)
The character that will precede all negative numbers.

  • Type: string
  • Default: "­"
  • Range: ­

Month Names (XuNaxisLabelsMonthNames)
The name of a dataset containing the 12 names of month of the year to be used as full names. If the full and abbreviated names are not specified, uppercase full month names in English are used. The month names are used for two calendar scale types, 'D/M/Y' and 'D/M/Q/Y'. Note that the full month names are the same as the abbreviated month names if only one set of month names is specified.

  • Type: string
  • Default: Unset
  • Range: N/A

Name Format (XuNaxisLabelsNameFormat)
Allows you to set the format of the calendar axis scale. This resource affects only the names of day of the week, week designator, month and quarter. Possible options:

Label Value Description
Default "default" The full names of the calendar elements are used if there is sufficient space along the axis, otherwise the abbreviated names are used.
Full Names "fullNames" The full names of the calendar elements are used, such as JANUARY, WEEK1, QUARTER1.
Abbreviated Names "abbreviatedNames" The abbreviated names of the calendar elements are used, such as JAN, W1, Q1.
  • Type: string
  • Default: "default"
  • Range: "default" ," fullNames" ,"abbreviatedNames"

Number Format (XuNaxisLabelsNumberFormat)
Allows you to set the format of the numeric axis labels. Possible options:

Label Value Description
Default "default" The total number of digits used to represent the axis labels is a minimum and this criterion results in axis labels being drawn as X, X.X, X.X *10N or *10N.
X.X EE "decimal_ee" Decimal exponential number format. Example: 10.0 drawn as 1E+01.
X.X *10 "decimal_log10" Decimal log10 number format. Example: 10.0 drawn as 1*10 1 .
EE "ee" Exponential number format. Example: 10.0 drawn as E+01
*10 "log10" Log10 number format. Example: 10.0 drawn as 10 1 .

This resource has no effect on user­labeled, calendar or time axes.

  • Type: string
  • Default: "default"
  • Range: "default" ," decimal_ee" ,"decimal_log10" ," ee" ," log10"

Placement (XuNaxisLabelsPlacement)
Controls positioning on axis labels relative to major tickmarks. This resource is only relevant for 1st 2D and 3D user­labeled, calendar and time axes. Possible options:

Label Value Description
Tickmarks "tickmarks" Each axis label is centered relative to its major tickmark.
Intervals "intervals" Each axis label is placed in the interval between tickmarks.

Level 1 date and time labels are always drawn against the major tickmarks. Tickmarks: For a calendar axis, the axis labels from level two onwards are drawn at positions corresponding to the first day of the week, month, quarter and year. For a time axis, the minute and hour axis labels are drawn at positions corresponding to the zero second for minute labels and zero minute and second for hour labels.If no such start date or time exists within the axis limits, then the label is drawn at the minimum limit of the axis. Intervals: For a date axis, the axis labels from level two onwards are drawn at positions corresponding to the middle of the week, month, quarter and year. For a time axis, the minute and hour axis labels are drawn at positions corresponding to the zero second for minute labels and zero minute and second for hour labels. If no such middle date or time exists within the calendar axis limits, then the label is drawn in the middle of the period.

  • Type: string
  • Default: "tickmarks"
  • Range: "tickmarks" ," intervals" ,""

Plus Sign (XuNaxisLabelsPlusSign)
The character that will precede all positive numbers.

  • Type: string
  • Default: Unset
  • Range: N/A

Power (XuNaxisLabelsPowerFactor)
This specifies the integer value N of the scale factor (10 N ) used in the axis unit component. The relationship between the axis value and the axis unit and axis label numeric representations is expressed as: Axis label × Axis unit = axis value The choice can be unset or any value between ­25 and 25. A 0 power factor (scale factor=1) suppresses the inclusion of the scale factor in the axis unit's text string. Furthermore, the axis label numeric representations are drawn with at least one decimal place. This resource has no effect on user­labeled, calendar or time axes.

  • Type: float
  • Default: Unset
  • Range: ­25:25

Quarter Names (XuNaxisLabelsQuarterNames)
The name of a dataset containing either four names of quarter of the year to be used as full quarter names, or one name to be used as full quarter designator. If the full and abbreviated quarter names or designators are not specified, the full quarter designator 'QUARTER' is used. Note that the same dataset is used for both full and abbreviated quarter names if only one name dataset is specified.

  • Type: string
  • Default: Unset
  • Range: N/A

Rotation (XuNaxisLabelsRotation)
The rotation angle of the text relative to the base line. The angle of rotation of is always measured counterclockwise.

  • Type: float
  • Default: Unset
  • Range: ­360:360

Saturday (XuNaxisLabelsSatColor)
The color of axis labels (level 1) indicating Saturdays. The choice can be unset or any color presented in the popup color panel. The default color is specified in the resource XuNaxisLabelsColor (Color).

  • Type: float
  • Default: Unset
  • Range:

Scale (XuNaxisLabelsScale)
Sets the precision of the axis scale. Possible options:

Label Value Description
Coarse "coarse" A Coarse axis scale is one where every major tickmark has a corresponding axis label.
Fine "fine" A Fine axis scale uses extra major tickmarks to give a more detailed division of the axis. These unlabeled extra major tickmarks are thinned and shortened by 30 percent. A fine axis scale may generate less labeled major tickmarks than a coarse axis scale.

This resource has no effect on user­labeled axes.

  • Type: string
  • Default: "coarse"
  • Range: "coarse" ," fine"

Scale Factor (XuNaxisLabelsScaleFactor)
Before labels are drawn the actual value is multiplied with the scale factor. The default scale factor is 1. This resource has no effect on user­labeled, calendar or time axes.

  • Type: float
  • Default: 1
  • Range: 0:100

Skewing (XuNaxisLabelsSkewing)
The skewing angle of the text.The skew angle is measured counterclockwise from the character base line. The skew angle must be between 10 and 170 degrees. The default value is 90, i.e., no skewing.

  • Type: float
  • Default: 90
  • Range: 10:170

Spacing (XuNaxisLabelsSpacingMode)
Controls the spacing between characters. Possible options:

Label Value Description
Kerned "kerned" The spacing between characters in minimized to produce typeset­like spacing.
Fixed "fixed" The width of each character is the same.
Proportional "proportional" The width of each character is proportional to the character body.
  • Type: string
  • Default: "kerned"
  • Range: "kerned" ," fixed" ," proportional"

Sunday (XuNaxisLabelsSunColor)
The color of axis labels (level 1) indicating Sundays. The choice can be unset or any color presented in the popup color panel. The default is set to unset. The default color is specified in the resource XuNaxisLabelsColor (Color).

  • Type: float
  • Default: Unset
  • Range:

Suppression (XuNaxisLabelsSuppression)
Controls suppression of the first and last axis labels. A suppressed label is not drawn. Possible options:

Label Value Description
None "none" No labels are suppressed.
First Label "firstLabel" First label is suppressed.
Last Label "lastLabel" Last label is suppressed
Both Labels "bothLabels" Both first and last labels are suppressed.
  • Type: float
  • Default: "none"
  • Range: "firstLabel" ,"bothLabels"

Digit Spacer (XuNaxisLabelsThreeDigitSpacer)
The character that will appear between each third digit in a number.The default is none.

  • Type: string
  • Default: Unset
  • Range: N/A

Time (XuNaxisLabelsTimePeriodsColor)
The color of axis labels (level 1) indicating user-defined time periods included with XuNaxleTimePeriods. The choice can be unset or any color presented in the popup color panel. The default is set to unset. The default color is specified in the resource XuNaxisLabelsColor (Color).

  • Type: float
  • Default: Unset
  • Range:

Trailing Zeroes (XuNaxisLabelsTrailingZeros)
Allows you to include or truncate trailing zeros of the numeric axis labels. Possible options:

Label Value Description
Truncated "truncated" All superfluous trailing zeros are removed from the fraction.
Untouched "untouched" All trailing zeros are drawn.
With Decimal "withDecimal" All trailing zeros are removed.
Without Decimal "withoutDecimal" All trailing zeros and the decimal point are removed.

This resource has no effect on user­labeled, calendar or time axes.

  • Type: string
  • Default: "truncated"
  • Range: "truncated" ," untouched", "withDecimal", "withoutDecimal"

Week Name (XuNaxisLabelsWeekDesignator)
A text string or a dataset containing a text string to replace the default full name 'WEEK'. The full week designator is the same as the abbreviated week designator if only one designator is specified.

  • Type: string
  • Default: Unset
  • Range: N/A

Text Resources Set

The Text resources define the axis title and its text attributes for the currently edited 2D axis or 3D axes. This text string usually expresses the name of the variable along the axis, e.g. Pressure, Torque, Velocity, etc.

The axis text is by default placed in the middle and drawn parallel to the axle.

New Resources

Axis/Text Resource Set

Boldness (XuNaxisTextBoldness)
The relative boldness of the text. The value must be in the range of 0. ­ 20. and expresses a percentage of the character height. Vector fonts are by default represented by one pixel wide vectors on the screen and by a boldness of 10% of the character height on hardcopy devices. With polygon fonts, the boldness factor affects the outline of the fonts. By default the outline has no width. The character has a width but the line outlining it has no width. By setting the boldness factor, the width of the line surrounding the character is increased.

  • Type: float
  • Default: 0
  • Range: 0:20

Color (XuNaxisTextColor)
The color of the axis title text.

  • Type: float
  • Default: 1
  • Range:

Expansion (XuNaxisTextExpansion)
The width of the character body. To produce wider­than­normal characters set the expansion to greater than 1. Narrower characters are achieved by setting expansion to less than 1.

  • Type: float
  • Default: 1
  • Range: 0.2:2

Font (XuNaxisTextFont)
The font for the axis title text. The default font is determined by the textoption font resource. See textoption and XuNfont (Font).

  • Type: string
  • Default: Unset
  • Range: " simp" ,"carg" ,"cart" ,"cenb" ,"cobo" ,"comp" ,"coub" ,"couo" ,"cour" ,"cyri" ,"dupl" ,"futu" ,"gote" ,"gotg" ,"goti" ,"gree" ,"hebo" ,"helb" ,"helo" ,"helv" ,"ital" ,"matr" ,"psim" ,"scri" ,"simg" ,"sims" ,"smag" ,"smai" ,"smal" ,"swib" ,"swil" ,"swim" ,"tem","tibi","tibo","tiit","tiro","trii","trip","utbi","utob","utoi","utor","vsim"

Height (XuNaxisTextHeight)
For a 2D axis, the height is specified as a percentage of the minimum dimension of the 2D workbox. If this 2D axis is projected, then the percentage is based on the minimum dimension of the side of the 3D workbox where the 2D axis is projected. For a 3D axis, the percentage is based on the minimum dimension of the 3D workbox. The height is defined to be the distance measured between the center of the baseline and capline of the character box. The height can be unset or set to any positive value but it must not be greater than 20 percent. If the height is unset, the height of the axis labels is used.

  • Type: float
  • Default: Unset
  • Range: 0.001:20

Horizontal (XuNaxisTextHorizontalJustification)
Sets the horizontal insertion point of text within a bounding box. Possible options:

Label Value Description
Left "left" Insertion point is the left edge of the box.
Center "center" Insertion point is the center of the box.
Right "right" Insertion point is the right edge of the box.
  • Type: string
  • Default: "left"
  • Range: "left" ," center" ," right"

Path (XuNaxisTextPath)
The text path is the direction of the path along which text characters are drawn. Possible options:

Label Value Description
Right "right" Characters progress from left to right.
Down "down" Characters are positioned one underneath the other. Only suitable for vertical axes.
  • Type: string
  • Default: "right"
  • Range: "right" ," down"

R Position (XuNaxisTextRPosition)
The position of axis title text for polar radius axis.

  • Type: float
  • Default: Unset
  • Range:

Rotation (XuNaxisTextRotation)
The rotation angle of the text relative to the base line. The angle of rotation of is always measured counterclockwise.

  • Type: float
  • Default: Unset
  • Range: ­360:360

Skewing (XuNaxisTextSkewing)
The skewing angle of the text.The skew angle is measured counterclockwise from the character base line. The skew angle must be between 10 and 170 degrees. The default value is 90, i.e., no skewing.

  • Type: float
  • Default: 90
  • Range:

Spacing (XuNaxisTextSpacingMode)
Controls the spacing between characters. Possible options:

Label Value Description
Kerned "kerned" The spacing between characters in minimized to produce typeset­like spacing.
Fixed "fixed" The width of each character is the same.
Proportional "proportional" The width of each character is proportional to the character body.
  • Type: string
  • Default: "kerned"
  • Range: "kerned" ," fixed" ," proportional"

T Position (XuNaxisTextTPosition)
The position of axis title text for polar theta axis.

  • Type: float
  • Default: Unset
  • Range:

Text (XuNaxisTextText)
Allows you to add a text string (or a dataset containing a text string) to the axis to give a name to the quantity measured along the axis. If the text is not set, then no axis text is displayed.

  • Type: string
  • Default: Unset
  • Range: N/A

Vertical (XuNaxisTextVerticalJustification)
The vertical insertion point of the text's bounding box. Possible options:

Label Value Description
Font Bottom "fontBottom" Insertion point is the bottom of the font box.
fontBase "fontBase" Insertion point is the baseline of the font.
Center "fontHalf" Insertion point is the half of the font box.
Font Cap "fontCap" Insertion point is the cap of the font.
Font Top "fontTop" Insertion point is the top of the font box.
Physical Bottom "physicalBottom" Insertion point is the physical bottom of the text string.
Physical Half "physicalHalf" Insertion point is the physical half of the text string.
Physical Top "physicalTop" Insertion point is the physical top of the text string.
  • Type: string
  • Default: "fontBottom"
  • Range: "fontBottom" ," fontBase" ,"fontHalf" ," fontCap" ," fontTop" ,"physicalBottom" ," physicalHalf" ,"physicalTop"

X Date (XuNaxisTextXDatePosition)
The X position of the axis title text in date coordinates.

  • Type: string
  • Default: Unset
  • Range: N/A

X Date/Time (XuNaxisTextXDateTimePosition)
The X position of the axis title text in date/time coordinates.

  • Type: string
  • Default: Unset
  • Range: N/A

X Position (XuNaxisTextXPosition)
The X position of the axis title text in world coordinates.

  • Type: float
  • Default: Unset
  • Range:

X Time (XuNaxisTextXTimePosition)
The X position of the axis title text in time coordinates.

  • Type: string
  • Default: Unset
  • Range: N/A

Y Date (XuNaxisTextYDatePosition)
The Y position of the axis title text in date coordinates.

  • Type: string
  • Default: Unset
  • Range: N/A

Y Date/Time (XuNaxisTextYDateTimePosition)
The Y position of the axis title text in date/time coordinates.

  • Type: string
  • Default: Unset
  • Range: N/A

Y Position (XuNaxisTextYPosition)
The Y position of the axis title text in world coordinates.

  • Type: float
  • Default: Unset
  • Range:

Y Time (XuNaxisTextYTimePosition)
The Y position of the axis title text in time coordinates.

  • Type: string
  • Default: Unset
  • Range: N/A

Ticklines Resource Set

The Ticklines resources allow you to control major and minor ticklines. A major or minor tickline is a line of certain length drawn at right­angles to the axle. The length is determined by the transverse axle length, for example, the length of the major and minor 2D X­ticklines is determined by the 2D Y­axle length.

The intersections of the major and minor ticklines with the axle coincide with the major and minor tickmarks along the axle. Thus, a 'legible' grid net can be constructed from the ticklines.

New Resources

Axis/Ticklines Resource Set

Enabled (XuNticklinesMajor)
Controls the visibility of major ticklines. By default ticklines are not drawn.

  • Type: float
  • Default: true
  • Range: false,true

Color (XuNticklinesMajorColor)
The color of the major ticklines. The default color is the set by XuNtickmarksMajorColor (­ Color).

  • Type: float
  • Default: Unset
  • Range:

Style (XuNticklinesMajorStyle)
The line style of the major ticklines. The default style is a solid line. All possible line styles are shown in the table below.

Label Value Description
--------------- "lineStyle0" Solid line.
.................. "lineStyle1" Fine dotted line.
­ ­ ­ ­ ­ ­ ­ ­ ­ "lineStyle2" Fine dashed line.
-- -- -- -- -- -- -- -- "lineStyle3" Medium dashed line.
--- . --- . --- . "lineStyle4" Single dash­dot line.
-- ­ -- ­ -- ­ -- ­ "lineStyle5" Medium­fine dashed line.
. . . . . . . . . . . "lineStyle6" Coarse dotted line.
--- --- --- --- --- "lineStyle7" Coarse dashed line.
-- -- -- -- -- -- -- -- "lineStyle8" Double medium dashed line.
-- -- .. -- -- .. -- -- .. "lineStyle9" Double medium dash­dot line.
--- ... --- ... --- ... "lineStyle10" Coarse dash­dot line.
--- .... --- .... --- .... "lineStyle11" Very coarse dash­dot line.
  • Type: string
  • Default: "lineStyle0"
  • Range: "lineStyle0" ,"lineStyle0:'lineStyle11'"

Width (XuNticklinesMajorWidth)
The line width of the major ticklines. The default line width is set by XuNtickmarksMajorWidth (­ Width).

  • Type: float
  • Default: Unset
  • Range: 0:5

Enabled (XuNticklinesMinor)
Controls the visibility of minor ticklines. By default ticklines are not drawn.

  • Type: float
  • Default: true
  • Range: false,true

Color (XuNticklinesMinorColor)
The color of the major ticklines. The default color is the set by XuNtickmarksMinorColor (­ Color).

  • Type: float
  • Default: Unset
  • Range:

Style (XuNticklinesMinorStyle)
The line style of the minor ticklines. The default style is a solid line. Refer to the table on page 8­37 for an example of all possible line styles.

  • Type: string
  • Default: "lineStyle0"
  • Range: "lineStyle0" ,"lineStyle0:'lineStyle11'"

Width (XuNticklinesMinorWidth)
The line width of the major ticklines. The default line width is set by XuNtickmarksMinorWidth (­ Width).

  • Type: float
  • Default: Unset
  • Range: 0:5

Tickmarks Resource Set

The Tickmarks resources allow you to control major and minor tickmarks. A major tickmark is a line of arbitrary length at right­angles to the axle. Major tickmarks are placed judiciously along the axle so that the implicit axis value associated with each major tickmark can be deduced from the axis labels. Unless the major tickmarks step value is specifically set by the user, the initial step value of the major tickmarks is treated as a function of the axis labels height.

To distinguish major tickmarks with corresponding axis labels from those without, the latter are thinned and shortened by 30 percent.

Minor tickmarks are also drawn at right angles to the axle and are normally shorter and thinner than any of the major tickmarks. Minor tickmarks are used to divide the interval formed by two consecutive major tickmarks into sub­intervals.

For a given number of minor tickmarks per tickmark interval, the minor tickmarks are drawn so that the interval is equally divided.

New Resources

Axis/Tickmarks Resource Set

Enabled (XuNtickmarksMajor)
Controls the visibility of major tickmarks. By default the major tickmarks are drawn.

  • Type: float
  • Default: true
  • Range: false,true

Log Pattern (XuNtickmarksMajorBasicLogPattern)
A basic logarithmic pattern for the major tickmarks. Possible options:

Label Value Description
Default "default" The selection of a suitable pattern is based on the height of the axis labels.
1­2­3­4­5­6­7­8­9­10 "labelPattern0" Major tickmarks at 1, 2, 3,4, 5, 6, 7, 8, 9, 10, 20, 30etc.
1­2­4­6­8­10 "labelPattern1" Major tickmarks at 1, 2, 4, 6, 8, 10, 20, 40, 60, 80, 100, etc.
1­2­4­7­10 "labelPattern2" Major tickmarks at 1, 2, 4, 7, 10, 20, 40, 70, 100, etc.
1­3­6­10 "labelPattern3" Major tickmarks at 1, 3, 6, 10, 30, 60, 100, etc.
1­5­10 "labelPattern4" Major tickmarks at 1, 5, 10, 50, 100, etc.
1­10 "labelPattern5" Major tickmarks at 1, 10, 100, etc.

These patterns are only valid for logarithmic axes where the difference between the two extreme axis limit exponents is greater than 1. For an exponent difference less than 1, no pattern used, the scale is similar to a linear scale. If a non­default major tickmarks pattern is specified, the choice of coarse or fine axis scale, XuNaxisLabelsScale (Scale), is ignored.

  • Type: string
  • Default: "default"
  • Range: "default" ," labelPattern0" ,"labelPattern1" ," labelPattern2" ,"labelPattern3" ," labelPattern4" ,"labelPattern5"

Color (XuNtickmarksMajorColor)
The color of the major tickmarks. The default color used is XuNaxleColor (Axle Color).

  • Type: float
  • Default: Unset
  • Range:

Justification (XuNtickmarksMajorJustification)
The tickmarks' justification relative to the position and direction of the axle. Possible options:

Label Value Description
Right "right" Tickmarks are right justified in relation to the axle.
Left "left" Tickmarks are left justified in relation to the axle.
Center "center" Tickmarks are center justified in relation to the axle.

The default justification depends on the Domain axis scale location resource, for example XuN1st2DXAxisScaleLocation (­ Scale Location).

  • Type: string
  • Default: "right"
  • Range: "right" ," left" ," center"

Label Level (XuNtickmarksMajorLabelLevel)
The level of the axis labels that is related to the major tickmarks. The maximum selectable level is dictated by the maximum number of levels for a given scale layout. The default level used depends on the height of the axis labels. The level of the axis labels of a date and time axis refers to the elements of XuNaxleScaleLayout (Scale Layout) on page8­11. For example, the date scale layout of 'D/M/Y' has day as the first time element, month as the second time element, etc. If 'Label Level' is set to Level 2, then the major tickmarks indicate months instead of days or years.

  • Type: string
  • Default: Unset
  • Range: " level1" ," level2" ," level3" ,"level4" ," level5" ," level6" ," level7"

Length (XuNtickmarksMajorLength)
Relative major tickmark length. The default length is 90 percent of the height of the axis labels.

  • Type: float
  • Default: Unset
  • Range: 0:100

Reference Date (XuNtickmarksMajorReferenceDate)
Defines a reference tickmark date upon which major tickmarks are calculated for a combined date/time axis.

  • Type: string
  • Default: Unset
  • Range: N/A

Reference (XuNtickmarksMajorReferenceDateTime)
Defines a reference tickmark upon which major tickmarks are calculated. Major tickmarks and axis labels on both sides of the reference value are generated appropriately. Note that this resource required the 'Label Level' to be specified as well. The choice can be unset or any valid date or time within the axis limits. If the 'Reference Date/Time' value is unset, then the start date is used for a calendar axis. For a time axis, the reference value used is based on the step value, start time and 00:00:00 (beginning of a day).

  • Type: string
  • Default: Unset
  • Range: N/A

Reference Time (XuNtickmarksMajorReferenceTime)
Defines a reference tickmark time upon which major tickmarks are calculated for a combined date/time axis.

  • Type: string
  • Default: Unset
  • Range: N/A

Reference (XuNtickmarksMajorReferenceValue)
Defines a reference tickmark upon which major tickmarks are calculated. Major tickmarks and axis labels on both sides of the reference value are generated appropriately. The choice can be unset or any value within the axis limits. This resource has no effect on logarithmic or user­labeled axes.

  • Type: float
  • Default: Unset
  • Range: 0:100

Step (XuNtickmarksMajorStepDateTime)
The major tickmarks step value for a calendar or time axis. Note that this resource required the 'Label Level' to be specified in order that the time element (day, month, year, and so on) associated with this step value is defined. By specifying this step value, you effectively set the minimum axis labels step value for a Fine axis scale, or the actual axis labels step value for a Coarse axis scale. The choice can be unset or any whole number greater than 0. If the step value is unset, the value used depends on the height of the axis labels and the value of the 'Label Level'.

  • Type: float
  • Default: Unset
  • Range: 0:100

Step (XuNtickmarksMajorStepValue)
The major tickmarks step value for linear axes. By specifying this value, you effectively set the minimum axis labels step value for a fine axis scale or the actual axis labels step value for a coarse axis scale. The choice can be unset or any number greater than 0. If the step value is unset, then the initial trial value is based on the axis labels height. The initial step value is increased judiciously if the resultant number of major tickmarks between two axis labels is too large. The specified major tickmarks step value must be less than or equal to the difference in the axis limits, otherwise the step value is ignored. This resource has no effect on logarithmic or user­labeled axes.

  • Type: float
  • Default: Unset
  • Range: 0:100

Width (XuNtickmarksMajorWidth)
The line width of the major tickmarks. The default line width is

  • Type: float
  • Default: Unset
  • Range: 0:5

Enabled (XuNtickmarksMinor)
Controls visibility of minor tickmarks. By default minor tickmarks are drawn.

  • Type: float
  • Default: true
  • Range: false,true

Color (XuNtickmarksMinorColor)
The color of the minor tickmarks. The default color is the same as XuNaxleColor (Axle Color).

  • Type: float
  • Default: Unset
  • Range:

Justification (XuNtickmarksMinorJustification)
See XuNtickmarksMajorJustification (­ Justification). (­ Justification).

  • Type: string
  • Default: "right"
  • Range: "right" ," left" ," center"

Length (XuNtickmarksMinorLength)
The relative length of the minor tickmarks. The default length is 50% of the length of the major tickmarks.

  • Type: float
  • Default: Unset
  • Range: 0:100

Number (XuNtickmarksMinorNumber)
The number of minor tickmarks between a pair of major tickmarks. The choice can be any value between 1 and 100. The default value is 1.

  • Type: float
  • Default: 1
  • Range: 1:100

Range (XuNtickmarksMinorRange)
The range of minor tickmark. This resource is only relevant for a linear axis. Possible options:

Label Value Description
Normal "normal" Minor tickmarks are drawn between the first major tickmark and the last major tickmark
Extended "extended" Includes the normal range and the two intervals formed by the first and last major tickmarks with the ends of the axle, if space permits.
  • Type: string
  • Default: "normal"
  • Range: "normal" ," extended"

Width (XuNtickmarksMinorWidth)
The line width of the minor tickmarks. The default width is 50 percent of the width of the major tickmarks.

  • Type: float
  • Default: Unset
  • Range: 0:5

Unit Resource Set

The resources in the Unit bundle allow you to append a text string to the axis unit giving the units denomination. The axis unit is drawn as a text string that expresses the scale factor and the unit of measurement for the axis. The scale factor is represented as *10 N , where N is the power factor. The scale factor is generated automatically if XuNaxisLabelsPowerFactor (Power Factor)  is unset and it is applicable to the labelling. It can be also specified by setting the power factor to a non­zero value. A 0 power factor (scale factor=1) suppresses the inclusion of the scale factor in the axis unit's text string. Note that this function is only relevant for linear and logarithmic axes.The axis unit is by default placed in the middle of a horizontal axis and at the top of a vertical axis.

New Resources

Axis/Unit Resource Set

Boldness (XuNaxisUnitBoldness)
The relative boldness of the text. The value must be in the range of 0. ­ 20. and expresses a percentage of the character height. Vector fonts are by default represented by one pixel wide vectors on the screen and by a boldness of 10% of the character height on hardcopy devices. With polygon fonts, the boldness factor affects the outline of the fonts. By default the outline has no width. The character has a width but the line outlining it has no width. By setting the boldness factor, the width of the line surrounding the character is increased.

  • Type: float
  • Default: 0
  • Range: 0:20

Color (XuNaxisUnitColor)
The color of the unit text string.

  • Type: float
  • Default: 1
  • Range:

Expansion (XuNaxisUnitExpansion)
The width of the character body. To produce wider­than­normal characters set the expansion to greater than 1. Narrower characters are achieved by setting expansion to less than 1.

  • Type: float
  • Default: 1
  • Range: 0.2:2

Font (XuNaxisUnitFont)
The font of the unit text string. The default font is determined by the textoption font resource. Refer to the table on page 8­167.

  • Type: string
  • Default: Unset
  • Range:  " simp" ,"carg" ,"cart" ,"cenb" ,"cobo" ,"comp" ,"coub" ,"couo" ,"cour" ,"cyri" ,"dupl" ,"futu" ,"gote" ,"gotg" ,"goti" ,"gree" ,"hebo" ,"helb" ,"helo" ,"helv" ,"ital" ,"matr" ,"psim" ,"scri" ,"simg" ,"sims" ,"smag" ,"smai" ,"smal" ,"swib" ,"swil" ,"swim" ,"tem","tibi","tibo","tiit","tiro","trii","trip","utbi","utob","utoi","utor","vsim"

Height (XuNaxisUnitHeight)
The height of the unit text string. The default unit height equals the height of the axis labels.

  • Type: float
  • Default: Unset,0.001:20
  • Range:

Horizontal (XuNaxisUnitHorizontalJustification)
Sets the horizontal insertion point of text within a bounding box. Possible options:

Label Value Description
Left "left" Insertion point is the left edge of the box.
Center "center" Insertion point is the center of the box.
Right "right" Insertion point is the right edge of the box.
  • Type: string
  • Default: "left'center',"
  • Range: "left" ,"center" ," right"

R Position (XuNaxisUnitRPosition)
The position of axis unit text for polar radius axis.

  • Type: float
  • Default: Unset
  • Range:

Rotation (XuNaxisUnitRotation)
The rotation angle of the text relative to the base line. The angle of rotation of is always measured counterclockwise.

  • Type: float
  • Default: Unset
  • Range: ­360:360

Skewing (XuNaxisUnitSkewing)
The skewing angle of the text.The skew angle is measured counterclockwise from the character base line. The skew angle must be between 10 and 170 degrees. The default value is 90, i.e., no skewing.

  • Type: float
  • Default: 90
  • Range:

Spacing (XuNaxisUnitSpacingMode)
Controls the spacing between characters. Possible options:

Label Value Description
Kerned "kerned" The spacing between characters in minimized to produce typeset­like spacing.
Fixed "fixed" The width of each character is the same.
Proportional "proportional" The width of each character is proportional to the character body.
  • Type: string
  • Default: "kerned"
  • Range: "kerned" ," fixed" ," proportional"

T Position (XuNaxisUnitTPosition)
The position of axis unit text for polar theta axis.

  • Type: float
  • Default: Unset
  • Range:

Text (XuNaxisUnitText)
A text string (or a dataset containing a text string) to denote the unit of the axis values which is appended to the scale factor. For example, if the unit is 'mm' and the scale factor is 0.01, then the axis unit drawn is: * 10 ­2 mm. If the scale factor is not applicable, then only the unit symbol is displayed, if specified.

  • Type: string
  • Default: Unset
  • Range: N/A

Vertical (XuNaxisUnitVerticalJustification)
The vertical insertion point of the text's bounding box. Possible options:

Label Value Description
Font Bottom "fontBottom" Insertion point is the bottom of the font box.
fontBase "fontBase" Insertion point is the baseline of the font.
Center "fontHalf" Insertion point is the half of the font box.
Font Cap "fontCap" Insertion point is the cap of the font.
Font Top "fontTop" Insertion point is the top of the font box.
Physical Bottom "physicalBottom" Insertion point is the physical bottom of the text string.
Physical Half "physicalHalf" Insertion point is the physical half of the text string.
Physical Top "physicalTop" Insertion point is the physical top of the text string.
  • Type: string
  • Default: "fontBottom"
  • Range: "fontBottom" ," fontBase" ,"fontHalf" ," fontCap" ," fontTop" ,"physicalBottom" ," physicalHalf" ,"physicalTop"

X Date (XuNaxisUnitXDatePosition)
The X position of the axis unit text in date coordinates.

  • Type: string
  • Default: Unset
  • Range: N/A

X Date/Time (XuNaxisUnitXDateTimePosition)
The X position of the axis unit text in date/time coordinates.

  • Type: string
  • Default: Unset
  • Range: N/A

X Position (XuNaxisUnitXPosition)
The X position of the axis unit text in world coordinates.

  • Type: float
  • Default: Unset
  • Range:

X Time (XuNaxisUnitXTimePosition)
The X position of the axis unit text in time coordinates.

  • Type: string
  • Default: Unset
  • Range: N/A

Y Date (XuNaxisUnitYDatePosition)
The Y position of the axis unit text in date coordinates.

  • Type: string
  • Default: Unset
  • Range: N/A

Y Date/Time (XuNaxisUnitYDateTimePosition)
The Y position of the axis unit text in date/time coordinates.

  • Type: string
  • Default: Unset
  • Range: N/A

Y Position (XuNaxisUnitYPosition)
The Y position of the axis unit text in world coordinates.

  • Type: float
  • Default: Unset
  • Range:

Y Time (XuNaxisUnitYTimePosition)
The Y position of the axis unit text in time coordinates.

  • Type: string
  • Default: Unset
  • Range: N/A

Inherited Resources

Controls Resource Set

Immutable (XuNimmutable)
This resource controls whether the object can be modified. Values are true (On) for non­modifiable, or false (Off) for modifiable. By default it is set to modifiable. Setting this resource to on locks the currents settings for the object and disables any further changes to the object, including resetting this resource.

  • Type: float
  • Default: false
  • Range: false,true

Object Name (XuNname)
The name of the object. If not explicitly set, a default name with the format _ will be generated.

  • Type: string
  • Default: Unset
  • Range: N/A

Include in Saved GSL (XuNsave)
This resource controls whether the object is included in saved GSL. Values are true (On) to include in saved GSL or false (Off) to omit from GSL. By default objects are included in saved GSL.

  • Type: float
  • Default: true
  • Range: false,true

User Data (XuNuserData)
A dataset name or pointer which the user can associate with the object. The dataset is for user use and will not be used by Gsharp.

  • Type: string
  • Default: Unset
  • Range: N/A

Return to Graphic Objects.