GNU Octave: Axes Properties

Next: Line Properties, Previous: Figure Properties, Up: Graphics Object Properties [Contents][Index]

#### 15.3.3.3 Axes Properties

The `axes` properties are:

`__modified__`: `"off"` | {`"on"`}
`activepositionproperty`: {`"outerposition"`} | `"position"`
`alim`: def. `[0 1]`

  Transparency is not yet implemented for axes objects. `alim` is unused.

`alimmode`: {`"auto"`} | `"manual"`
`ambientlightcolor`: def. `[1 1 1]`

  Light is not yet implemented for axes objects. `ambientlightcolor` is unused.

`beingdeleted`: {`"off"`} | `"on"`
`box`: `"off"` | {`"on"`}

  Control whether the axes has a surrounding box.

`busyaction`: `"cancel"` | {`"queue"`}
`buttondownfcn`: string | function handle, def. `[](0x0)`
`cameraposition`: three-element vector, def. `[0.50000 0.50000 9.16025]`
`camerapositionmode`: {`"auto"`} | `"manual"`
`cameratarget`: three-element vector, def. `[0.50000 0.50000 0.50000]`
`cameratargetmode`: {`"auto"`} | `"manual"`
`cameraupvector`: three-element vector, def. `[-0 1 0]`
`cameraupvectormode`: {`"auto"`} | `"manual"`
`cameraviewangle`: scalar, def. `6.6086`
`cameraviewanglemode`: {`"auto"`} | `"manual"`
`children` (read-only): vector of graphics handles, def. `[](0x1)`

  Graphics handles of the axes’s children.

`clim`: two-element vector, def. `[0 1]`

  Define the limits for the color axis of image children. Setting `clim` also forces the `climmode` property to be set to `"manual"`. See pcolor function.

`climmode`: {`"auto"`} | `"manual"`
`clipping`: `"off"` | {`"on"`}

  `clipping` is unused.

`color`: colorspec, def. `[1 1 1]`

  Color of the axes background. See colorspec.

`colororder`: N-by-3 RGB matrix, def. 7-by-3 double

  RGB values used by plot function for automatic line coloring.

`createfcn`: string | function handle, def. `[](0x0)`

  Callback function executed immediately after axes has been created. Function is set by using default property on root object, e.g., `set (0, "defaultaxescreatefcn", 'disp ("axes created!")')`.

`currentpoint`: 2-by-3 matrix, def. 2-by-3 double

  Matrix `[xf, yf, zf; xb, yb, zb]` which holds the coordinates (in axes data units) of the point over which the mouse pointer was when the mouse button was pressed. If a mouse callback function is defined, `currentpoint` holds the pointer coordinates at the time the mouse button was pressed. For 3-D plots, the first row of the returned matrix specifies the point nearest to the current camera position and the second row the furthest point. The two points forms a line which is perpendicular to the screen.

`dataaspectratio`: three-element vector, def. `[1 1 1]`

  Specify the relative height and width of the data displayed in the axes. Setting `dataaspectratio` to `[1, 2]` causes the length of one unit as displayed on the x-axis to be the same as the length of 2 units on the y-axis. Setting `dataaspectratio` also forces the `dataaspectratiomode` property to be set to `"manual"`.

`dataaspectratiomode`: {`"auto"`} | `"manual"`
`deletefcn`: string | function handle, def. `[](0x0)`

  Callback function executed immediately before axes is deleted.

`drawmode`: `"fast"` | {`"normal"`}
`fontangle`: `"italic"` | {`"normal"`} | `"oblique"`
`fontname`: string, def. `"*"`

  Name of the font used for axes annotations.

`fontsize`: scalar, def. `10`

  Size of the font used for axes annotations. See fontunits property.

`fontunits`: `"centimeters"` | `"inches"` | `"normalized"` | `"pixels"` | {`"points"`}

  Unit used to interpret `fontsize` property.

`fontweight`: `"bold"` | `"demi"` | `"light"` | {`"normal"`}
`gridlinestyle`: `"-"` | `"--"` | `"-."` | {`":"`} | `"none"`
`handlevisibility`: `"callback"` | `"off"` | {`"on"`}

  If `handlevisibility` is `"off"`, the axes’s handle is not visible in its parent’s "children" property.

`hittest`: `"off"` | {`"on"`}
`interpreter`: `"latex"` | {`"none"`} | `"tex"`
`interruptible`: `"off"` | {`"on"`}
`layer`: {`"bottom"`} | `"top"`

  Control whether the axes is drawn below child graphics objects (ticks, labels, etc. covered by plotted objects) or above.

`linestyleorder`: def. `"-"`
`linewidth`: def. `0.50000`
`minorgridlinestyle`: `"-"` | `"--"` | `"-."` | {`":"`} | `"none"`
`mousewheelzoom`: scalar in the range (0, 1), def. `0.50000`

  Fraction of axes limits to zoom for each wheel movement.

`nextplot`: `"add"` | {`"replace"`} | `"replacechildren"`
`outerposition`: four-element vector, def. `[0 0 1 1]`

  Specify the position of the plot including titles, axes, and legend. The four elements of the vector are the coordinates of the lower left corner and width and height of the plot, in units normalized to the width and height of the plot window. For example, `[0.2, 0.3, 0.4, 0.5]` sets the lower left corner of the axes at (0.2, 0.3) and the width and height to be 0.4 and 0.5 respectively. See position property.

`parent`: graphics handle

  Handle of the parent graphics object.

`plotboxaspectratio`: def. `[1 1 1]`
`plotboxaspectratiomode`: {`"auto"`} | `"manual"`
`position`: four-element vector, def. `[0.13000 0.11000 0.77500 0.81500]`

  Specify the position of the plot excluding titles, axes, and legend. The four elements of the vector are the coordinates of the lower left corner and width and height of the plot, in units normalized to the width and height of the plot window. For example, `[0.2, 0.3, 0.4, 0.5]` sets the lower left corner of the axes at (0.2, 0.3) and the width and height to be 0.4 and 0.5 respectively. See outerposition property.

`projection`: {`"orthographic"`} | `"perspective"`
`selected`: {`"off"`} | `"on"`
`selectionhighlight`: `"off"` | {`"on"`}
`tag`: string, def. `""`

  A user-defined string to label the graphics object.

`tickdir`: {`"in"`} | `"out"`

  Control whether axes tick marks project "in" to the plot box or "out".

`tickdirmode`: {`"auto"`} | `"manual"`
`ticklength`: two-element vector, def. `[0.010000 0.025000]`

  Two-element vector `[2Dlen 3Dlen]` specifying the length of the tickmarks relative to the longest visible axis.

`tightinset` (read-only): def. `[0.042857 0.038106 0.000000 0.023810]`
`title`: graphics handle

  Graphics handle of the title text object.

`type` (read-only): string

  Class name of the graphics object. `type` is always `"axes"`

`uicontextmenu`: graphics handle, def. `[](0x0)`

  Graphics handle of the uicontextmenu object that is currently associated to this axes object.

`units`: `"centimeters"` | `"characters"` | `"inches"` | {`"normalized"`} | `"pixels"` | `"points"`
`userdata`: Any Octave data, def. `[](0x0)`

  User-defined data to associate with the graphics object.

`view`: two-element vector, def. `[0 90]`

  Two-element vector `[azimuth elevation]` specifying the viewpoint for three-dimensional plots

`visible`: `"off"` | {`"on"`}

  If `visible` is `"off"`, the axes is not rendered on screen.

`xaxislocation`: {`"bottom"`} | `"top"` | `"zero"`
`xcolor`: {colorspec} | `"none"`, def. `[0 0 0]`

  Color of the x-axis. See colorspec.

`xdir`: {`"normal"`} | `"reverse"`
`xgrid`: {`"off"`} | `"on"`

  Control whether major x grid lines are displayed.

`xlabel`: graphics handle

  Graphics handle of the x label text object.

`xlim`: two-element vector, def. `[0 1]`

  Two-element vector `[xmin xmax]` specifying the limits for the x-axis. Setting `xlim` also forces the `xlimmode` property to be set to `"manual"`. See xlim function.

`xlimmode`: {`"auto"`} | `"manual"`
`xminorgrid`: {`"off"`} | `"on"`

  Control whether minor x grid lines are displayed.

`xminortick`: {`"off"`} | `"on"`
`xscale`: {`"linear"`} | `"log"`
`xtick`: vector

  Position of x tick marks. Setting `xtick` also forces the `xtickmode` property to be set to `"manual"`.

`xticklabel`: string | cell array of strings, def. 1-by-6 cell

  Labels of x tick marks. Setting `xticklabel` also forces the `xticklabelmode` property to be set to `"manual"`.

`xticklabelmode`: {`"auto"`} | `"manual"`
`xtickmode`: {`"auto"`} | `"manual"`
`yaxislocation`: {`"left"`} | `"right"` | `"zero"`
`ycolor`: {colorspec} | `"none"`, def. `[0 0 0]`

  Color of the y-axis. See colorspec.

`ydir`: {`"normal"`} | `"reverse"`
`ygrid`: {`"off"`} | `"on"`

  Control whether major y grid lines are displayed.

`ylabel`: graphics handle

  Graphics handle of the y label text object.

`ylim`: two-element vector, def. `[0 1]`

  Two-element vector `[ymin ymax]` specifying the limits for the y-axis. Setting `ylim` also forces the `ylimmode` property to be set to `"manual"`. See ylim function.

`ylimmode`: {`"auto"`} | `"manual"`
`yminorgrid`: {`"off"`} | `"on"`

  Control whether minor y grid lines are displayed.

`yminortick`: {`"off"`} | `"on"`
`yscale`: {`"linear"`} | `"log"`
`ytick`: vector

  Position of y tick marks. Setting `ytick` also forces the `ytickmode` property to be set to `"manual"`.

`yticklabel`: string | cell array of strings, def. 1-by-6 cell

  Labels of y tick marks. Setting `yticklabel` also forces the `yticklabelmode` property to be set to `"manual"`.

`yticklabelmode`: {`"auto"`} | `"manual"`
`ytickmode`: {`"auto"`} | `"manual"`
`zcolor`: {colorspec} | `"none"`, def. `[0 0 0]`

  Color of the z-axis. See colorspec.

`zdir`: {`"normal"`} | `"reverse"`
`zgrid`: {`"off"`} | `"on"`

  Control whether major z grid lines are displayed.

`zlabel`: graphics handle

  Graphics handle of the z label text object.

`zlim`: two-element vector, def. `[0 1]`

  Two-element vector `[zmin zmaz]` specifying the limits for the z-axis. Setting `zlim` also forces the `zlimmode` property to be set to `"manual"`. See zlim function.

`zlimmode`: {`"auto"`} | `"manual"`
`zminorgrid`: {`"off"`} | `"on"`

  Control whether minor z grid lines are displayed.

`zminortick`: {`"off"`} | `"on"`
`zscale`: {`"linear"`} | `"log"`
`ztick`: vector

  Position of z tick marks. Setting `ztick` also forces the `ztickmode` property to be set to `"manual"`.

`zticklabel`: string | cell array of strings, def. 1-by-6 cell

  Labels of z tick marks. Setting `zticklabel` also forces the `zticklabelmode` property to be set to `"manual"`.

`zticklabelmode`: {`"auto"`} | `"manual"`
`ztickmode`: {`"auto"`} | `"manual"`

Next: Line Properties, Previous: Figure Properties, Up: Graphics Object Properties [Contents][Index]