3.7.5.29 Layer.Axis.BreakLayer-Axis-Break-obj
LabTalk Object Type:
- Window
The break object is a sub-object of the layer.axis.breaks object.
You can use range notation to define a layer object:
- [winName!]layer[n].axis.breakm.property =
m here refers to the index of the break, if not specified, the first axis break will be used.
axis is the axis specification: X is the X axis (Top and Bottom), Y is the Y axis (Left and Right) and Z is the Z axis (Front and Back).
Note: This property is NOT supported in 3D Ternary graph.
Properties:
An axis break must exist for the following properties to be valid.
Property
|
Access
|
Description
|
layer.axis.breakm.from
|
Read/write, numeric
|
Starting axis break value.
|
layer.axis.breakm.to
|
Read/write, numeric
|
Ending axis break value.
|
layer.axis.breakm.pos
|
Read/write, numeric
|
The position of axis break at % of axis length.
|
layer.axis.breakm.space
|
Read/write, int
|
Specify the scale type of the axis region after the break.
|
layer.axis.breakm.formula
|
Read/write, string
|
Only useful when scale type is set to Custom Formula (layer.axis.break.space = 11), used to specify the direct formula of the custom axis scale after the break.
|
layer.axis.breakm.invformula
|
Read/write, string
|
Only useful when scale type is set to Custom Formula (layer.axis.break.space = 11), used to specify the inverse formula of the custom axis scale after the break.
|
layer.axis.breakm.tickstype
|
Read/write, int
|
Specify the major ticks type of the axis region after the break.
|
layer.axis.breakm.inc
|
Read/write, numeric
|
Only useful when major ticks type is set to By Increment, (layer.axis.break.tickstype = 1), specify major tick increment after the break (Major Ticks Value).
|
layer.axis.breakm.majorTICKS
|
Read/write, int
|
Only useful when major ticks type is set to By Counts, (layer.axis.break.tickstype = 2), specify number of major ticks after the break (Major Ticks Count).
|
layer.axis.breakm.ticksbydata
|
Read/write, dataset
|
Only useful when major ticks type is set to By Dataset, (layer.axis.break.tickstype = 4), specify the dataset for major tick location after the break.
|
layer.axis.breakm.ticksbylabel
|
Read/write, int
|
Only useful when major ticks type is set to By Plot Column Label, (layer.axis.break.tickstype = 5), specify the column label row for major tick location after the break.
|
layer.axis.breakm.mtickstype
|
Read/write, int
|
Specify the minor ticks type of the axis region after the break.
|
layer.axis.breakm.minorTicks
|
Read/write, int
|
Only useful when minor ticks type is set to By Count,(layer.axis.break.mtickstype = 1). specify the number of minor ticks between adjacent major ticks after the break.
|
layer.axis.breakm.mticksbydata
|
Read/write, dataset
|
Only useful when minor ticks type is set to By Dataset, (layer.axis.break.mtickstype = 2), specify the dataset for minor tick location after the break.
|
layer.axis.breakm.autoscale
|
Read/write, int
|
Specify whether to auto scale the axis in the region(s) after the break(s). 1=autoscale, 0=Do not autoscale.
|
Examples:
The following example shows how to enable and customize two axis breaks in an empty graph window:
//Create an empty graph window
win -t plot;
//Enable two axis breaks in x axis
layer.x.breaks.enable = 1;
layer.x.breaks.count = 2;
//Customize the first axis break
//Set the break to be from 2 to 4
layer.x.break1.from = 2;
layer.x.break1.to = 4;
//Change the axis break position to be at 40%
layer.x.break1.pos = 40;
//Change the increment after the first axis break to be 0.5
layer.x.break1.inc = 1;
//Customize the second axis break
//Set the break's from and to values to be from 6 to 6.5
layer.x.break2.from = 6;
layer.x.break2.to = 6.5;
//Change the major tick type to be "By Dataset" after the second break
layer.x.break2.tickstype = 4;
//Define a dataset and use it as major tick location after break
layer.x.break2.ticksbydata$ = 6.7 7.1 7.9 8.5 9.6;
|