IM_GET_TITLE

im_get_title - read image title from KUIM image

Synopsis

void im_get_title(Image, Title)
   IM_TYPE *Image;
   char *Title;

Description

The im_get_title routine copies the title field of an open KUIM image to the specified title string. This information was previously written using im_put_title. The parameters to this routine are:

Image - This is a pointer to a IM_TYPE data structure which was previously initialized using im_open or im_create.

Title - This is a null-terminated string which contains the current image title. At present this field is limited to 128 characters.

Files

Source is in $KUIM/src/libIM

See Also

im_create, im_open, im_read, im_write, im_get_title, im_put_title, im_get_cmap, im_put_cmap, im_alloc1D, im_alloc2D, im_alloc3D, im_free1D, im_free2D, im_free3D.

Author

John M. Gauch
Electrical Engineering and Computer Science
University of Kansas

Diagnostics

When this routine succeeds, the Title string is updated. Upon occurrence of any error condition, a message is printed and the program exits.