xcall AUI, AUI_IMAGE, IMGOP_INFO, handle, status, imginfo {,filespec}

MAP1 IMGINFO             ! Image info packet

   MAP2 IMG'OWIDTH,F     ! Original image width (pixels)

   MAP2 IMG'OLENGTH,F    ! Original image length (pixels)

   MAP2 IMG'DWIDTH,F     ! Display width (pixels)

   MAP2 IMG'DLENGTH,F    ! Display length (pixels)

   MAP2 IMG'BPP,F        ! Bits per pixel

 

IMGOP_INFO (5) retrieves some information about a previously opened image (by specifying the image handle), or from the disk file filespec. The information is reasonably self-explanatory. Note that the operation can also be used merely to verify if a particular handle value is valid.

We may be adding fields to this structure in the future to accommodate additional pieces of information that developers discover a need for. The routine will however always be smart enough to look at the size of the packet you pass so as to not overrun the packet if new fields are added but not yet mapped in existing programs.

History

2006 April, A-Shell 4.9.955: Add support for the filespec parameter.