# 3.7.5.29 Layer.Axis.Break

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
numeric

Starting axis break value.

numeric

Ending axis break value.

numeric

The position of axis break at % of axis length.

int

Specify the scale type of the axis region after the break.

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.

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.

int

Specify the major ticks type of the axis region after the break.

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).

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).

dataset

Only useful when major ticks type is set to By Dataset, (layer.axis.break.tickstype = 3), specify the dataset for major tick location after the break.

int

Only useful when major ticks type is set to By Plot Column Label, (layer.axis.break.tickstype = 4), specify the column label row for major tick location after the break.

int

Specify the minor ticks type of the axis region after the break.

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.

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.

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 = 3;
//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;