Oracle Forms Developer – Form Builder Reference, Volume 1

WRITE_IMAGE_FILE built-in
Description
Writes the image from a Form Builder image item into the specified file.
Syntax
WRITE_IMAGE_FILE
(file_name VARCHAR2,
file_type VARCHAR2,
item_id ITEM,
compression_quality NUMBER,
image_depth NUMBER);
WRITE_IMAGE_FILE
(file_name VARCHAR2,
file_type VARCHAR2,
item_name VARCHAR2,
compression_quality NUMBER,
image_depth NUMBER);
Built-in Type unrestricted procedure
Enter Query Mode yes
Parameters
file_name The name of the file where the image is stored. The file name must adhere
to your operating system requirements.
file_type The file type of the image: BMP, CALS, GIF, JFIF, JPEG, PICT, RAS,
TIFF, or TPIC. The parameter takes a VARCHAR2 argument.
item_id The unique ID Form Builder assigned to the image item when you created
it. Use the FIND_ITEM built-in to return the ID to an appropriately typed
variable. Datatype is ITEM.
item_name The name you gave the image item when you defined it. Datatype is
VARCHAR2.
compression_quality The degree of compression Form Builder will apply to the image when it
stores it to the file (optional). Datatype is VARCHAR2. Valid values
are:NO_COMPRESSION, MINIMIZE_COMPRESSION,
LOW_COMPRESSION, MEDIUM_COMPRESSION,
HIGH_COMPRESSION, MAXIMIZE_COMPRESSION
image_depth The degree of depth Form Builder will apply to the image when it stores it
to the file (optional). Datatype is VARCHAR2. Valid values
are:ORIGINAL_DEPTH, MONOCHROME, GRAYSCALE, LUT
(Lookup Table), RGB (Red, Green, Blue)
WRITE_IMAGE_FILE restrictions
• The indicated file type must be compatible with the actual file type of the image.
• As with any file, if you write the image to an existing file, you overwrite the contents of that file
468