IM_PUT_TITLE

im_put_title - store new image title in KUIM image

Synopsis

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

Description

The im_put_title routine copies the specified title string into the title field of an open KUIM image. This information can later be read using im_get_title and eventually written to disk when im_write is called. The parameters to this routine are:

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

Title - This is a null-terminated string which contains the new image title to be stored. 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 Image data structure is updated. Upon occurrence of any error condition, a message is printed and the program exits.