4D Doc Center : READ PICTURE FILE

Home

4D v14.3

READ PICTURE FILE


READ PICTURE FILE ( fileName ; picture {; *} )

Parameter	Type	Description
fileName	String	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.