version 6.7
WRITE PICTURE FILE (fileName; picture{; format})
Parameter | Type | Description | |
fileName | String | Name or full pathname of the file to write, | |
or empty string | |||
picture | Picture | 4D Picture field or variable to write | |
format | String (4) | Quicktime code for picture export format | |
(4 characters), PICT by default |
Description
The WRITE PICTURE FILE command allows you to save the picture passed in the picture parameter in the defined format to disk.
Warning: This command uses QuickTime conversion routines (version 4 or above recommended) for Mac OS and Windows. If QuickTime is not installed, the command creates a PICT file by default.
You can pass in fileName the full pathname to the file to create, or a file name only. If you just pass the file name, the file will be located next to the database structure file. Under Windows, the file extension has to be indicated.
If an empty string ("") is passed in fileName, the standard Save file dialog box is displayed and the user can indicate the name, location and format of the file to create.
You will pass in picture the picture variable or field which contains the picture to save on disk.
The optional parameter format defines the picture saving format. This parameter should contain a 4-characters QuickTime code. You can get the list of available formats using the PICTURE TYPE LIST command. Refer to the PICTURE TYPE LIST command to get a description for QuickTime 4 standard format codes.
If the format parameter is omitted or if QuickTime is not installed, the picture file is created with a PICT format.
If the command is executed successfully, the system variable Document contains the full pathname to the file created and the system variable OK is set to 1. Otherwise, OK is set to 0.
See Also
PICTURE TO BLOB, PICTURE TYPE LIST, Pictures, READ PICTURE FILE.