Preface

This guide describes how to use Oracle8i interMedia Audio, Image, and Video Java Client.

Oracle8i interMedia Audio, Image, and Video Java Client requires Oracle8i Enterprise Edition. Oracle8i and Oracle8i Enterprise Edition have the same basic features. However, several advanced features are available only with the Enterprise Edition, and some of these features are optional.

For information about the differences between Oracle8i and Oracle8i Enterprise Edition and the features and options that are available to you, see Getting to Know Oracle8i.

Intended Audience

This guide is intended for developers or database administrators who are interested in storing, retrieving, and manipulating audio, image, and video data in an Oracle database, including developers of audio, image, or video specialization cartridges. Users of this guide should have experience with the Java programming language.

Structure

This guide contains the following chapters and appendixes:

Chapter 1	Contains a general introduction.
Chapter 2	Contains examples of the audio, image, and video application programming interfaces (APIs).
Chapter 3	Contains reference information on the ORDMultiMedia and BindToTableParams classes.
Chapter 4	Contains reference information on the ORDSource class.
Chapter 5	Contains reference information on the ORDAudio class.
Chapter 6	Contains reference information on the ORDImage class.
Chapter 7	Contains reference information on the ORDVideo and FrameDimension classes.
Chapter 8	Contains reference information on the DataSource class.
Appendix A	Contains information about the MediaAnnotator sample program.
Appendix B	Contains information on possible exceptions and errors.
Appendix C	Contains reference information on which methods operate on the client-side object or the server-side object.

Related Documents

Note:
For information added after the release of this guide, refer to one of the online README.TXT files in your ORACLE_HOME directory. Depending on your operating system, the files may be named as follows:

$ORACLE_HOME/ord/im/admin/README.TXT (general information)

$ORACLE_HOME/ord/aud/admin/README.TXT (audio-specific information)

$ORACLE_HOME/ord/img/admin/README.TXT (image-specific information)

$ORACLE_HOME/ord/vid/admin/README.TXT (video-specific information)

Please see your operating-system specific installation guide for more information.

For more information on Oracle8i interMedia Audio, Image, and Video Options on the server side, see Oracle8i interMedia Audio, Image, and Video User's Guide and Reference.

For more information about using these data options in a development environment, see the following documents in the Oracle8i documentation set:

Conventions

In this guide, Oracle8i interMedia Audio, Image, and Video Java Client is sometimes referred to as interMedia Java Client. Oracle8i interMedia Audio, Image and Video is sometimes referred to as interMedia.

In examples, an implied carriage return occurs at the end of each line, unless otherwise noted. You must press the Return key at the end of a line of input.

The following conventions are also used in this guide:

Convention Meaning

.
.
.

Vertical ellipsis points in an example mean that information not directly related to the example has been omitted.

. . .

Horizontal ellipsis points in statements or commands mean that parts of the statement or command not directly related to the example have been omitted.

boldface text

Boldface text indicates a term defined in the text, the glossary, or in both locations.

italic text

Italic text is used for emphasis and for book titles.

< >

Angle brackets enclose user-supplied names.

[ ]

Brackets enclose optional clauses from which you can choose one or none.

Convention	Meaning
. . .	Vertical ellipsis points in an example mean that information not directly related to the example has been omitted.
. . .	Horizontal ellipsis points in statements or commands mean that parts of the statement or command not directly related to the example have been omitted.
boldface text	Boldface text indicates a term defined in the text, the glossary, or in both locations.
italic text	Italic text is used for emphasis and for book titles.
< >	Angle brackets enclose user-supplied names.
[ ]	Brackets enclose optional clauses from which you can choose one or none.