Layer.Axis.Break
Layer-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;
|