4D v13.4
CONVERT PICTURE
- 4D Language Reference
-
- Pictures
-
- Pictures
- BLOB TO PICTURE
- COMBINE PICTURES
- CONVERT PICTURE
- CREATE THUMBNAIL
- Equal picturesNew
- Get picture file nameNew
- GET PICTURE FROM LIBRARY
- GET PICTURE KEYWORDSNew
- GET PICTURE METADATA
- Is picture file
- PICTURE CODEC LIST
- PICTURE LIBRARY LIST
- PICTURE PROPERTIES
- Picture size
- PICTURE TO BLOB
- PICTURE TO GIF
- PICTURE TYPE LIST
- QT COMPRESS PICTURE
- QT COMPRESS PICTURE FILE
- QT LOAD COMPRESS PICTURE FROM FILE
- READ PICTURE FILE
- REMOVE PICTURE FROM LIBRARY
- SAVE PICTURE TO FILE
- SET PICTURE FILE NAMENew
- SET PICTURE METADATA
- SET PICTURE TO LIBRARY
- TRANSFORM PICTURE
- WRITE PICTURE FILE
CONVERT PICTURE
| CONVERT PICTURE ( picture ; codec {; compression} ) | ||||||||
| Parameter | Type | Description | ||||||
| picture | Picture |
|
Picture to be converted | |||||
|
Converted picture | |||||||
| codec | String |
|
Picture Codec ID | |||||
| compression | Real |
|
Quality of compression | |||||
The CONVERT PICTURE command converts picture into a new type.
The codec parameter indicates the type of picture to be generated. A Codec can be an extension (for example, “.gif”), a Mime type (for example, “image/jpeg”) or a 4-character QuickTime code (for example, “PNTG”). You can get a list of Codecs that are available using the PICTURE CODEC LIST command.
If the picture field or variable is a compound type (if, for example, it is the result of a copy-paste action), only the information corresponding to the codec type are preserved in the resulting picture.
Note: If the type of codec requested is the same as the original type of the picture, no conversion is carried out and the picture is returned "as is" (except when the compression parameter is used, see below).
The optional compression parameter, if passed, can be used to specify the compression quality to be applied to the resulting picture when a compatible Codec is used. In compression, pass a value between 0 and 1 to specify the quality of the compression, where 0 is the most mediocre quality (high compression) and 1 the best quality (low compression). This parameter is only taken into account when the Codec supports compression (for example JPEG or HDPhoto) and is supported by the WIC and ImageIO APIs. Consequently, it cannot be used with Codecs that are managed by QuickTime only. For more information about picture management APIs in 4D, please refer to the Pictures section. By default, if you omit the compression parameter, the best quality is applied (compression =1).
Conversion of the vpPhoto picture to the jpeg format:
CONVERT PICTURE(vpPhoto;".jpg")Conversion of a picture with 60% quality:
CONVERT PICTURE(vPicture;".JPG";0.6)
Product: 4D
Theme: Pictures
Number:
1002
Created: 4D v11 SQL
Modified: 4D v12
Compression***
