132
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
  • Types
  • Variables
  • Examples
• Summary of OWA_IMAGE Subprograms

---

Using OWA_IMAGE

• Overview
• Types
• Variables
• Examples

---

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 132-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 132-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 132-3  GET_Y Procedure Parameters

Parameter	Description
p	The point where the user clicked.

Return Values

The Y coordinate as an integer.