4D v13.4
BLOB TO 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
BLOB TO PICTURE
| BLOB TO PICTURE ( pictureBlob ; picture {; codec} ) | ||||||||
| Parameter | Type | Description | ||||||
| pictureBlob | BLOB |
|
BLOB containing a picture | |||||
| picture | Picture |
|
Picture from BLOB | |||||
| codec | String |
|
Picture codec ID | |||||
The BLOB TO PICTURE command inserts a picture stored in a BLOB into a 4D picture variable or field, regardless its original format.
This command is similar to the command READ PICTURE FILE, it just applies to a BLOB instead of a file. It allows you to display pictures stored in native format into BLOBs. You can load a picture into a BLOB using, for example, the command DOCUMENT TO BLOB oder PICTURE TO BLOB.
A BLOB variable or field containing a picture is passed in the pictureBlob parameter. The picture can be in any format supported natively by 4D or any QuickTime supported format. You can obtain the list of available formats using the PICTURE CODEC LIST command. If you pass the optional codec parameter, 4D will use the value provided in this parameter to decode the BLOB (see the specific functioning of the command with this third parameter below).
Pass in the picture parameter the 4D picture field or variable which should display the picture.
Note: The internal picture format will be stored within the 4D variable or field. In the case of custom formats using QuickTime, it will be necessary to have QuickTime to subsequently read the picture within 4D.
Once the command has been executed, if the BLOB was correctly decoded, the picture parameter contains the picture to display.
The optional codec parameter lets you specify the codec to be used for decoding the BLOB.
If you pass a codec recognized by 4D in codec (returned by the PICTURE CODEC LIST command), it is applied to the BLOB and the picture is returned in the picture field or variable.
If you pass a codec that is not recognized by 4D in codec, a new codec is recorded dynamically with the ID passed in the parameter. 4D then returns a picture that encapsulates the BLOB and the OK variable is set to 1. In this case, to retrieve the BLOB, you will need to use the PICTURE TO BLOB command with the same custom ID. This particular mechanism can be used to meet two specific needs:
- encapsulation of a BLOB (that is not a picture) into a picture,
- loading a picture without using a codec.
The implementation of these mechanisms allows, more specifically, the creation of "BLOB arrays" via picture arrays. This technique must be used with caution because, since the arrays are loaded entirely into memory, working with large sized BLOBs can affect the functioning of the application.
Note: A BLOB created by the VARIABLE TO BLOB command is managed automatically; it is not necessary to pass a codec to encapsulate it since the BLOB is "signed." In this case, for the opposite operation, you will need to pass ".4DVarBlob" to the PICTURE TO BLOB command as the codec ID.
If the command has been executed correctly, the system variable OK is set to 1. If the conversion has failed (QuickTime is not installed, the BLOB does not contain a readable picture, the codec parameter recognized but BLOB not validated, etc.), OK is set to 0 and the 4D picture variable or field is returned empty.
Product: 4D
Theme: Pictures
Number:
682
Modified: 4D v11 SQL Release 2
PICTURE CODEC LIST
PICTURE TO BLOB
PICTURE TYPE LIST
READ PICTURE FILE
