QPx_ReadImageFileInPicture

QPx_ReadImageFileInPicture(imagePath; imagePict):error
imagePath Text Full path to image file
imagePict Picture 4D picture variable
error Longint Error result

Reads an image file into a 4D picture variable.

The image file is specified by imagePath. If it contains a valid image, it will be converted to a QuickDraw picture and returned in the imagePict parameter.

If imagePath is empty, QPix presents a file selection dialog where the user can preview and select an image file. If the user selects a file, its full pathname is returned in imagePath, otherwise error qpx_userCancelErr is returned.

Warning: Graphic files can be very big, depending on image dimensions, resolution and pixel depth. Before reading image files into 4D pictures, make sure there is enough memory available to 4D to avoid crashes and data loss.

Example

  `Get an image into a 4D picture
  `The user is asked for the image file
 
C_LONGINT($error)
C_TEXT($imagePath)
C_PICTURE($pict)
 
$imagePath:="" `This will bring up the file selection dialog
 
$error:=QPx_ReadImageFileInPicture ($imagePath;$pict)
 
If ($error#qpx_noErr)
   `Handle the error
End if

QPix © Escape
Generated by QDoc 2.8 on Wed, Feb 17, 2010 17:43:02