Area Image
|
QMedical Command Reference
Area Image
|
|
| QMed_ExportAreaImage(areaRef; targetPath; targetType):error | |||
|
|
areaRef | Longint | QMedical area reference |
|
targetPath | Text | Pathname to the target file |
|
|
targetType | String4 | 4-char image type identifier |
|
|
error | Longint | Error result |
Exports the image from a QMedical plug-in area to an image file.
The QMedical plug-in area is specified by areaRef. If areaRef is not a valid QMedical plug-in area reference, qmed_paramErr is returned.
The target (destination) file is specified by targetPath. The target file may not already exist, but its containing folder path must be valid. If targetPath points to an existing file, the latter will be replaced by the new file. If targetPath is empty, a file selection dialog is presented for the user to select the target directory and specify a file name.
The targetType parameter specifies the target file format. If targetPath is specified and targetType is passed an empty string, targetType defaults to "PICT". If targetPath is not specified, both the target path and type will have to be selected from the file selection dialog. In any other case, an error will be generated (qmed_ParamErr). If the user cancels the dialog, error qmed_userCancelErr is returned.
To get the list of avaliable export formats, call the QMed_GetExportTypes command. QMedical defines the following constants for the export formats supported by QuickTime 4/5.
| qmed_JPEGFile | "JPEG" | JPEG/JIFF file format |
| qmed_TIFFFile | "TIFF" | TIFF file format |
| qmed_PNGFile | "PNGf" | PNG file format |
| qmed_BMPFile | "BMPf" | BMP file format |
| qmed_PhotoshopFile | "8BPS" | Adobe Photoshop file format |
| qmed_PictureFile | "PICT" | Apple PICT file format |
| qmed_QTImageFile | "qtif" | QuickTime Image file format |
| qmed_TargaFile | "TPIC" | Truevision Targa file format |
| qmed_SGIImageFile | ".SGI" | Silicon Graphics SGI file format |
| qmed_MacPaintFile | "PNTG" | Apple MacPaint file format |
Example
`Export the area image to TIFF C_LONGINT($error)C_TEXT($destPath) $destPath:="Macintosh HD:image.tiff" $error:=QMed_ExportAreaImage (gAreaRef;$destPath;qmed_TIFFFile) |
Related commands
| QMed_GetExportTypes | Returns the list of available export types |