DESIGN (xvisual) functions


LIBRARY ROUTINE

xvw_create_image - create an image object

LIBRARY CALL

xvobject xvw_create_image(
   xvobject parent,
   char     *name)

INPUT

OUTPUT

none

RETURN VALUE

The image object on success, NULL on failure

DESCRIPTION

The image visual object provides a mechanism with which to easily display an image. If the input file has an associated colormap, that colormap will be used to display the image.

8 bit and 24 bit displays are fully supported by the image object; monochrome and 4 bit displays may be used but are not recommended.

Bit images, greyscale images, and RGB images are also supported. The image object is completely flexible as to the data type of the image data; all data types, including signed and unsigned bit, byte, short, int, float, double, and complex data types are supported.

The image object will react to changes in the input image; that is, if the contents of the input image change, the image object will immediately update to display the new image.

The image object supports the reading/writing of a variety of file formats, including: Viff (Khoros 1.0.5 format) Kdf (Khoros 2.1 data format) Gdbm (Khoros 2.0 gdbm format) Portable Any Map (PNM) format (including PPM, PGM, etc) ASCII format X Bitmap (XBM) format X Pixel Map (XPM) format X Window Dump (XWD) format Application Visualization System (AVS) format

In addition to those listed above, the following formats are supported for write only: Encapsulated PostScript (eps) format

In addition to those listed above, the following formats are supported for read only: Raw (headerless) format

In the future, we also hope to support a number of additional formats, including: Tagged Image File Format (TIFF)

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DESIGN/objects/library/xvisual/src/Image.c

SEE ALSO

xvisual(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.