Platform

Win32, x64

Purpose

To export a (%gr) drawing surface to an image file.

Syntax

INTEGER FUNCTION EXPORT_IMAGE@( FILENAME )
CHARACTER(*) FILENAME

Description

FILENAME is the name of a file. The file name extension determines the type of image file to be created and must be one of: .png, .jpg, .jpeg, .bmp, .gif, .emf, and .pcx.

Return value

The function returns a non-zero value when successful.

Notes

An active metafile is needed in order to export an EMF image. Other formats do not require a metafile. Metafiles are created by using %gr[metafile_resize] or by calling OPEN_METAFILE@.

The quality of a JPEG image exported by EXPORT_IMAGE@ can be changed by calling the function SET_JPEG_QUALITY@ as follows:

REAL(KIND=2) FUNCTION SET_JPEG_QUALITY@( Q )
REAL(KIND=2) Q

Q is an input value in the range from 0.01D0 to 1.0D0 (use steps of 0.01). The function returns the old value should you wish to restore it afterwards. The default value of Q is 0.75D0.

See also

IMPORT_IMAGE@