QPxObs_SetImporterQuality

QPxObs_SetImporterQuality(importerRef; drawingQuality):error
importerRef Longint Reference to a graphics importer instance
drawingQuality Longint Drawing quality
error Longint Error result

Do not use this command in QPix v3 or later

This command is preserved in QPix v3 for backward compatibility reasons. The graphics importer quality has no meaning in QPix v3 and later.


Sets the drawing quality property of a graphics importer instance. This will be used by the importer when drawing the image in a QPix plug-in area or in thumbnails.

The graphics importer instance is specified by importerRef.

The drawingQuality value is in the range of 0..1024. Some graphics importers ignore this value to improve performance.

QPix defines the following drawing quality constants:

qpx_MinQuality 0 Minimal quality
qpx_LowQuality 256 Low quality
qpx_NormalQuality 512 Normal quality
qpx_HighQuality 768 High quality
qpx_MaxQuality 1023 Maximum quality
qpx_LosslessQuality 1024 Lossless quality

If drawingQuality is not in the 0...1024 range or importerRef is not an existing graphics importer instance, the qpx_paramErr error code is returned.

Example

  `Set quality to maximum
 
C_LONGINT($error)
C_LONGINT(gQPixImporter)
 
$error:=QPx_SetImporterQuality (gQPixImporter;qpx_LosslessQuality)
 
If ($error#qpx_noErr)
   `Handle the error
End if

Related commands

QPxObs_GetImporterQuality Returns the drawing quality property of a graphics importer (obsolete)

QPix © Escape
Generated by QDoc 2.8 on Wed, Feb 17, 2010 17:47:00