READ PICTURE FILE
READ PICTURE FILE ( fileName ; picture {; *} )
| Parameter | Type | Description | |
|---|---|---|---|
| fileName | Text | → | Name or full pathname of the file to read, or empty string |
| picture | Picture | ← | Field or variable receiving picture |
| * | Operator | → | If passed = accept any type of file |
Description
The READ PICTURE FILE command opens the picture saved in the fileName disk file and loads it in the picture 4D field or variable.
You can pass in fileName the full pathname of the file to read, or a file name only. If you pass only the file name, it should be located next to the database structure file. Under Windows, the file extension must be indicated.
If an empty string ("") is passed in fileName, the standard Open file dialog box appears and the user selects the file to be read, as well as the available formats.
You can get the list of available formats using the PICTURE CODEC LIST command.
You pass in picture the picture variable or field which will receive the picture read.
Note: The internal picture format is stored within the 4D variable or field.
If you pass the optional * parameter, the command will accept any type of file. This means that you can work with pictures without necessarily having the suitable codecs (see the description of the BLOB TO PICTURE command).
System variables and sets
If the command is executed successfully, the system variable Document contains the full pathname to the open file and the system variable OK is set to 1. Otherwise, OK is set to 0.
See also
BLOB TO PICTURE
PICTURE CODEC LIST
Pictures
WRITE PICTURE FILE
Properties
| Command number | 678 |
| Thread safe | ✓ |
| Modifies variables | OK, Document |