QPx_CreateImageFileThumbnail
| QPx_CreateImageFileThumbnail(sourceFilePath; sourceFilePath; sourceFilePath; sourceFilePath; sourceFilePath; sourceFilePath):error | |||
|---|---|---|---|
 |
sourceFilePath | Text | Full path to image file |
 |
thumbnailPict | Picture | The thumbnail picture |
|
targetWidth | Longint | Target width of thumbnail |
|
targetHeight | Longint | Target height of thumbnail |
|
thumbnailDepth | Longint | Thumbnail depth (optional) |
|
thumbnailOptions | Longint | Thumbnail options (optional) |
|
error | Longint | Error result |
Create high-quality thumbnail of an image file
The image file is specified by imagePath. 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.
The thumbnail is returned in the thumbnailPict picture variable.
Target dimensions for the thumbnail are specified by targetWidth and targetHeight, and need not be proportional to the original; QPix will automatically downscale the image proportionally to fit the target dimensions. This command cannot be used for upscaling.
Thumbnail pixel depth is specified in the thumbnailDepth parameter. The optional pixelDepth parameter must be in the 0...40 range (values greater than 32 denote grayscale). If omitted or set to zero, QPix will use the original pixel depth (recommended).
The thumbnailOptions optional parameter can be used to specify additional options for the thumbnail creation. The following constants can be combined with bitwise "OR".
| qpx_ThumbWithProgress | 0x0001 | Display progress dialog during long thumbnail creation operations. |
| qpx_ThumbStandardQuality | 0x0004 | Create a standard quality thumbnail. Faster than the default high quality operation. |
Related commands
| QPx_GetImageFileEmbeddedThumb | Get the thumbnail enbedded in an image file |