WriteImageFile

Release:	… • 4.6 • 5.0 • 5.1 • 5.2 • 5.3 • 5.4 • • 6.0 • 6.1 • 6.2 • 6.3 • 6.4 • 6.5 • 6.6 • 7.0 • 7.1 • 7.2

Requires Analytica Developer edition or better.

WriteImageFile( filename, image, showDialog, warn, mimeType, title, download, extensionFilter )

Writes an in-memory image to a file.

«filename»: When a full (absolute) filename is not supplied, the file name is relative to the CurrentDataFolder.
When «filename» is "<>", the image is written to an in-memory binary data term.
«image»: An image, obtained from the (Pict Of «obj») attribute, or from a function that returns an image such as ReadImageFile, ReadFromUrl, or CanvasImage.
«showDialog»: (Optional) When True, the file finder dialog is always presented to the user. When False, the dialog is never presented to the user. When omitted, the dialog is shown only if the file cannot be written to «filename», or if the file already exists and you haven't specified warn:False.
«warn»: (Optional) When True, a warning is issued if showDialog:False and the file exists. This warning will only be shown when Show Result Warnings is enabled.
«mimeType»: (Optional) Specifies the preferred file type, such as 'PNG', 'JPG', etc., for the image.
«title»: (Optional) A custom caption shown in the file selector when the file selector is displayed.
«download»: (Option) When True and running in ACP, the image downloaded to the end user's computer as an image file with the name «filename».

«extensionFilter»: (Optional) Overrides the file types offered in the file-selector dialog. Specify the filter(s) as a text in any of these forms: a display-format text such as "Image Files (*.png, *.jpg, *.tif); All Files (*.*)"; a list of "Description|patterns" filters such as ["Images|*.png;*.jpg;*.tif", "All files|*.*"]; or just patterns such as "*.png;*.jpg;*.gif;*.tif". An "All files (*.*)" entry is appended automatically unless your list already includes one; when omitted, the default file types are shown.