.\
cgaxis.pro
top cgAxis
Graphics
cgAxis [, xloc] [, yloc] [, zloc] [, CHARSIZE=float] [, COLOR=string/integer/long] [, /DATA] [, /DEVICE] [, FONT=integer] [, /NORMAL] [, /SAVE] [, /T3D] [, TITLE=string] [, XAXIS=integer] [, /XLOG] [, XTITLE=string] [, YAXIS=integer] [, /YLOG] [, YTITLE=string] [, /YNOZERO] [, ZAXIS=integer] [, /ZLOG] [, ZTITLE=string] [, /WINDOW] [, _REF_EXTRA=_REF_EXTRA]
Provides a device-independent and color-model-independent way to draw an axis into a graphics window. It is a wrapper to the AXIS command.
The program requires the Coyote Library to be installed on your machine.
Parameters
- xloc in optional type=depends
The X location of the axis.
- yloc in optional type=depends
The Y location of the axis.
- zloc in optional type=depends
The Z location of the axis.
Keywords
- CHARSIZE in optional type=float default=cgDefCharSize()
The character size for axes annotations. Uses cgDefCharSize to select default character size, unless !P.Charsize is set, in which case !P.Charsize is always used.
- COLOR in optional type=string/integer/long
The color of the text. Color names are those used with cgColor. By default, "black", unless the upper-right hand pixel in the display is black, then "white".
- DATA in optional type=boolean
Set this keyword to indicate xloc and yloc are in data coordinates. Data coordinates are the default, unless DEVICE or NORMAL is set.
- DEVICE in optional type=boolean
Set this keyword to indicate xloc and yloc are in device coordinates.
- FONT in optional type=integer default=!P.Font
The type of font desired. By default, !P.Font.
- NORMAL in optional type=boolean
Set this keyword to indicate xloc and yloc are in normalized coordinates.
- SAVE in optional type=boolean
Set this keyword to save the scaling parameters set by the axis for subsequent use.
- T3D in optional type=boolean default=0
Set this keyword to rotate the axis is the 3D data space set up with !P.T.
- TITLE in optional type=string
The title or annotation that appears on the axis.
- XAXIS in optional type=integer default=0
If set to 0, the axis is drawn under the plot with the tick marks pointing up; if set to 1, the axis is drawn on top of the plot with the tick marks pointing down.
- XLOG in optional type=boolean default=0
Set this keyword to specify a logarithmic axis type.
- XTITLE in optional type=string
An alternative way to set the
Title
keyword for X axes. UseTitle
instead.- YAXIS in optional type=integer default=0
If set to 0, the axis is drawn on the left of the plot with the tick marks pointing to the right. If set to 1, the axis is drawn on the right of the plot with the tick marks pointing to the left.
- YLOG in optional type=boolean default=0
Set this keyword to specify a logarithmic axis type.
- YTITLE in optional type=string
An alternative way to set the
Title
keyword for Y axes. UseTitle
instead.- YNOZERO in optional type=boolean default=0
Set this keyword to prevent the Y axis from starting at 0.
- ZAXIS in optional type=integer default=0
Set to 0-3 to position the Z axis in various locatons. See the AXIS documentation.
- ZLOG in optional type=boolean default=0
Set this keyword to specify a logarithmic axis type.
- ZTITLE in optional type=string
An alternative way to set the
Title
keyword for Z axes. UseTitle
instead.- WINDOW in optional type=boolean
Set this keyword to add the command to the in the current cgWindow application.
- _REF_EXTRA in optional
Any keywords appropriate for the AXIS command.
Examples
Used like the IDL AXIS command:
IDL> cgPlot, cgDemoData(1), YStyle=8, Position=[0.1, 0.1, 0.85, 0.9], /Window
IDL> cgAxis, /YAxis, Color='red', YRange=[-500, 500], /Save, /Window
Author information
- Author:
FANNING SOFTWARE CONSULTING:
David W. Fanning 1645 Sheely Drive Fort Collins, CO 80526 USA Phone: 970-221-0438 E-mail: david@idlcoyote.com Coyote's Guide to IDL Programming: http://www.idlcoyote.com
- Copyright:
Copyright (c) 2011, Fanning Software Consulting, Inc.
- History:
Change History:
Written, 25 Janauray 2011. DWF. Modified error handler to restore the entry decomposition state if there is an error. 17 March 2011. DWF Modifed the way I am handling brain dead AXIS command. 30 May 2011. DWF. Modified to use cgDefaultColor for default color selection. 24 Dec 2011. DWF. Added T3D keyword. 1 March 2012. DWF. Added the ability to use escape characters in plot titles to specify cgSymbol symbols. 27 July 2012. DWF.
File attributes
Modification date: | Fri Mar 27 11:07:39 2015 |
Lines: | 332 |
Docformat: | rst rst |