DESIGN (xvisual) functions
LIBRARY ROUTINE
xvw_create_printmapval - create a printmapval xvobject
LIBRARY CALL
xvobject xvw_create_printmapval(
xvobject parent,
char *name)
INPUT
- parent - the parent object; NULL will cause a
default toplevel to be created automatically
- name - a name for this particular instance of the printmapval
object (for use in app-defaults files, etc)
OUTPUT
none
RETURN VALUE
The printmapval xvobject on success, NULL otherwise
DESCRIPTION
A printmapval object provides a mechanism which will track
pointer movement in an image object and print the values of
the map data indexed by the pixel under the pointer.
It was designed for use in conjunction with an image object,
and is only useful with data objects having a map segment.
The printmapval object is made up of one or more
(width x height) sets of label objects; typically, there
will be three such sets, one each for the Red, Green, and
Blue columns of the colormap. The background of each label
is the color defined by the values of the map columns at that
pixel, and the value displayed is the value of the
corresponding map column.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$DESIGN/objects/library/xvisual/src/PrintMapVal.c
SEE ALSO
xvisual(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.