Preface

Oracle interMedia Annotator is a Java API that extracts metadata from audio, image, and video sources of certain formats and inserts the metadata, along with the media source file, into an Oracle database.

Audience

This guide is intended for anyone who is interested in extracting metadata from a multimedia file and storing both the metadata and the multimedia file in an Oracle database. Users who want to integrate the Annotator engine with their applications should be familiar with Java and JDBC. Users who want to write their own PL/SQL Upload Templates should be familiar with PL/SQL. Users who want to write their own annotation types or parsers should be familiar with Java and XML.

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle Corporation is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at

http://www.oracle.com/accessibility/

Accessibility of Code Examples in Documentation

JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle Corporation does not own or control. Oracle Corporation neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Organization

This guide contains 8 chapters and 5 appendixes:

Book Element	Description
Chapter 1	Introduces Oracle interMedia Annotator.
Chapter 2	Describes how to set up your environment and the basic steps needed to use Oracle interMedia Annotator.
Chapter 3	Contains a full-length example of a Java application using the Annotator engine.
Chapter 4	Contains reference information on the Java API associated with the Annotator engine.
Chapter 5	Contains instructions for writing a PL/SQL Upload Template to upload your annotation to an Oracle database.
Chapter 6	Contains a full-length example of a custom parser.
Chapter 7	Contains reference information on the Java API associated with writing custom parsers.
Chapter 8	Contains information on creating your own annotation types.
Appendix A	Contains information on using Oracle Text to query stored annotations.
Appendix B	Contains reference information on supported formats.
Appendix C	Contains reference information on annotation attributes.
Appendix D	Contains information about deprecated and obsolete features.
Appendix E	Contains answers to frequently asked questions.

Related Documentation

For information about related topics, see the following documentation:

• Oracle interMedia User's Guide and Reference

• Oracle Text Application Developer's Guide

In North America, printed documentation is available for sale in the Oracle Store at

http://oraclestore.oracle.com/

Customers in Europe, the Middle East, and Africa (EMEA) can purchase documentation from

http://www.oraclebookshop.com/

To download free release notes, installation documentation, white papers, or other collateral, go to the Oracle Technology Network (OTN). You must register online before using OTN; registration is free and can be done at

http://otn.oracle.com/admin/account/membership.html

If you already have a user name and password for OTN, then you can go directly to the documentation section of the OTN Web site at

http://otn.oracle.com/docs/index.htm

To access the database documentation search engine directly, go to

http://tahiti.oracle.com

Conventions

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 java.lang.String object is sometimes abbreviated as String.

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 either a term defined in the text, the glossary, or in both locations; or a window name, button name, menu name, or menu item.
monospace font	Monospace font in text indicates a code example, a URL, or an absolute path name.
italic font	Italic font in examples indicates a user-supplied name.
[ ]	Brackets enclose optional clauses from which you can choose one or none.