174 OWA_IMAGE

The OWA_IMAGE package provides an interface to access the coordinates where a user clicked on an image.

The chapter contains the following topics:


Using OWA_IMAGE


Overview

Use this package when you have any image map whose destination links invoke the PL/SQL Gateway.


Types

This data type (point) contain the X and Y values of a coordinate, and so provides the coordinates of a user's click on an imagemap. It is defined as:

TYPE POINT IS TABLE OF VARCHAR2(32767) INDEX BY BINARY_INTEGER

Variables

This package variable (null_point) of TYPE POINT is used to default point parameters. Both the X and the Y fields of this variable are NULL.


Examples

CREATE OR REPLACE PROCEDURE process_image
    (my_img in OWA_IMAGE.POINT)
    AS
    x integer := OWA_IMAGE.GET_X(my_img);
    y integer := OWA_IMAGE.GET_Y(my_img);
BEGIN
    /* process the coordinate */
END

Summary of OWA_IMAGE Subprograms

Table 174-1 OWA_IMAGE Package Subprograms

Subprogram Description

GET_X Function

Gets the X value of a point type

GET_Y Function

Gets the Y value of a point type



GET_X Function

This function returns the X coordinate of the point where the user clicked on an image map.

Syntax

OWA_IMAGE.GET_X(
   p        IN        point)
 RETURN INTEGER;

Parameters

Table 174-2 GET_X Procedure Parameters

Parameter Description

p

The point where the user clicked.


Return Values

The X coordinate as an integer.


GET_Y Function

This function returns the Y coordinate of the point where the user clicked on an image map.

Syntax

OWA_IMAGE.GET_Y(
   p        IN        point)
 RETURN INTEGER;

Parameters

Table 174-3 GET_Y Procedure Parameters

Parameter Description

p

The point where the user clicked.


Return Values

The Y coordinate as an integer.