251 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:

See Also:

For more information about implementation of this package:

OWA_IMAGE Overview

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

OWA_IMAGE Types

This datatype (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

OWA_IMAGE 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.

OWA_IMAGE Examples

This example shows use of OWA_IMAGE. 

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

This table lists the OWA_IMAGE subprograms and briefly describes them.

Table 251-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;

OWA_IMAGE.GET_X(
   p        IN        point)
 RETURN INTEGER PARALLEL_ENABLE DETERMINISTIC;

Parameters

Table 251-2 GET_X Function 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;

OWA_IMAGE.GET_Y(
   p        IN        point)
 RETURN INTEGER PARALLEL_ENABLE DETERMINISTIC;

Parameters

Table 251-3 GET_Y Function Parameters

Parameter Description

p

The point where the user clicked.

Return Values

The Y coordinate as an integer.