plslabelfunc.3plplot

Langue: en

Autres versions - même langue

Version: July, 2010 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

NAME

plslabelfunc - Assign a function to use for generating custom axis labels

SYNOPSIS

plslabelfunc(label_func, label_data)

DESCRIPTION

This function allows a user to provide their own function to provide axis label text. The user function is given the numeric value for a point on an axis and returns a string label to correspond with that value. Custom axis labels can be enabled by passing appropriate arguments to plenv(3plplot), plbox(3plplot), plbox3(3plplot) and similar functions. This function is used in example 19.

ARGUMENTS

label_func (void (*) (PLINT, PLFLT, char *, PLINT, void *), input)
This is the custom label function. In order to reset to the default labeling, set this to NULL. The labeling function parameters are, in order: .TP axis This indicates which axis a label is being requested for. The value will be one of PL_X_AXIS, PL_Y_AXIS or PL_Z_AXIS.
value
This is the value along the axis which is being labeled.
label_text
The string representation of the label value.
length
The maximum length in characters allowed for label_text.
label_data (void *, input)
This parameter may be used to pass data to the label_func function.

AUTHORS

Geoffrey Furnish and Maurice LeBrun wrote and maintain PLplot. This man page was automatically generated from the DocBook source of the PLplot documentation, maintained by Alan W. Irwin and Rafael Laboissiere.

SEE ALSO

PLplot documentation at http://plplot.sourceforge.net/resources.