Oracle Forms Developer – Form Builder Reference, Volume 1

READ_IMAGE_FILE built-in
Description
Reads an image of the given type from the given file and displays it in the Form Builder image item.
Syntax
PROCEDURE READ_IMAGE_FILE
(file_name VARCHAR2,
file_type VARCHAR2,
item_id ITEM);
PROCEDURE READ_IMAGE_FILE
(file_name VARCHAR2,
file_type VARCHAR2,
item_name VARCHAR2);
Built-in Type unrestricted procedure
Enter Query Mode yes
Parameters
file_name Valid file name. The file name designation can include a full path
statement appropriate to your operating system.
file_type The valid image file type: BMP, CALS, GIF, JFIF, JPG, PICT, RAS,
TIFF, or TPIC. (Note: File type is optional, as Form Builder will attempt
to deduce it from the source image file. To optimize performance,
however, you should specify the file type.)
item_id The unique ID Form Builder assigns to the image item when it creates 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 created it. Datatype is
VARCHAR2.
Usage Notes
Form Builder searches for the image file along the same default path as it searches for an .FMX file. For
more information on the specific search path for your platform, refer to the Form Builder documentation
for your operating system.
READ_IMAGE_FILE examples
/* Read an image from the filesystem into an image item on the
** form. In this example, the scanned picture identification
** for each employee is NOT saved to the database, but is
** stored on the filesystem. An employee’s photo is a TIFF
** image stored in a file named .TIF Each employee’s
** Userid is unique.
** trigger: Post-Query
*/
DECLARE
tiff_image_dir VARCHAR2(80) := ’/usr/staff/photos/’;
photo_filename VARCHAR2(80);
331