Tài liệu Oracle interMedia Reference pdf

Oracle® interMedia
Reference
10g Release 1 (10.1)
Part No. B10829-01
December 2003
Oracle interMedia ("interMedia") is a feature that enables
Oracle Database to store, manage, and retrieve images,
audio, video, or other heterogeneous media data in an
integrated fashion with other enterprise information.
Oracle interMedia extends Oracle Database reliability,
availability, and data management to multimedia content
in Internet, electronic commerce, and media-rich
applications.
Oracle interMedia Reference, 10g Release 1 (10.1)
Part No. B10829-01
Copyright © 1999, 2003 Oracle Corporation. All rights reserved.
Primary Author: Ingrid Stuart
Contributor: Rod Ward, Susan Mavris, Melli Annamalai, Todd Rowell, Raja Chatterjee, Robert Abbott,
Albert Landeck, Vishal Rao, Dongbai Guo, Fengting Chen, Manjari Yalavarthy, Joseph Mauro, Rabah
Mediouni, Sanjay Agarwal, Bill Voss, Susan Kotsovolos, Rosanne Toohey, Bill Beauregard, Susan
Shepard, Helen Grembowicz
The Programs (which include both the software and documentation) contain proprietary information of
Oracle Corporation; they are provided under a license agreement containing restrictions on use and
disclosure and are also protected by copyright, patent and other intellectual and industrial property
laws. Reverse engineering, disassembly or decompilation of the Programs, except to the extent required
to obtain interoperability with other independently created software or as specified by law, is prohibited.
The information contained in this document is subject to change without notice. If you find any problems
in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this
document is error-free. Except as may be expressly permitted in your license agreement for these
Programs, no part of these Programs may be reproduced or transmitted in any form or by any means,
electronic or mechanical, for any purpose, without the express written permission of Oracle Corporation.

If the Programs are delivered to the U.S. Government or anyone licensing or using the programs on
behalf of the U.S. Government, the following notice is applicable:
Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are "commercial
computer software" and use, duplication, and disclosure of the Programs, including documentation,
shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement.
Otherwise, Programs delivered subject to the Federal Acquisition Regulations are "restricted computer
software" and use, duplication, and disclosure of the Programs shall be subject to the restrictions in FAR
52.227-19, Commercial Computer Software - Restricted Rights (June, 1987). Oracle Corporation, 500
Oracle Parkway, Redwood City, CA 94065.
The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently
dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup,
redundancy, and other measures to ensure the safe use of such applications if the Programs are used for
such purposes, and Oracle Corporation disclaims liability for any damages caused by such use of the
Programs.
Oracle is a registered trademark, and Oracle Store, PL/SQL, and SQL*Plus are trademarks or registered
trademarks of Oracle Corporation. Other names may be trademarks of their respective owners.
iii
Contents
Send Us Your Comments
............................................................................................................... xvii
Preface
.......................................................................................................................................................... xix
Audience ............................................................................................................................................... xix
Documentation Accessibility .............................................................................................................. xx
Organization.......................................................................................................................................... xx
Related Documentation ..................................................................................................................... xxii
Conventions......................................................................................................................................... xxiii
Changes to This Guide...................................................................................................................... xxiv
1 Introduction to Oracle interMedia
1.1 Multimedia Object Types and Methods............................................................................. 1-1

1.2 Multimedia Storage............................................................................................................... 1-1
2 Ensuring Compatibility with Evolving interMedia Object Types
2.1 When and How to Call the Compatibility Initialization Function ................................ 2-2
compatibilityInit( ) ................................................................................................................ 2-3
3 Common Methods for interMedia Object Types
3.1 Embedded ORDSource Object ............................................................................................ 3-2
3.2 Important Notes .................................................................................................................... 3-2
3.3 Methods .................................................................................................................................. 3-3
clearLocal( ) ............................................................................................................................ 3-5
iv
closeSource( ).......................................................................................................................... 3-6
deleteContent( )...................................................................................................................... 3-8
export( )................................................................................................................................... 3-9
getBFile( ) .............................................................................................................................. 3-13
getContent( )......................................................................................................................... 3-15
getMimeType( ).................................................................................................................... 3-16
getSource( )........................................................................................................................... 3-18
getSourceLocation( )............................................................................................................ 3-20
getSourceName( ) ................................................................................................................ 3-22
getSourceType( ).................................................................................................................. 3-24
getUpdateTime( )................................................................................................................. 3-26
isLocal( )................................................................................................................................ 3-27
openSource( )........................................................................................................................ 3-28
processSourceCommand( ) ................................................................................................ 3-30
readFromSource( )............................................................................................................... 3-32
setLocal( ).............................................................................................................................. 3-35
setMimeType( ) .................................................................................................................... 3-37
setSource( )............................................................................................................................ 3-39
setUpdateTime( ) ................................................................................................................. 3-41
trimSource( )......................................................................................................................... 3-43

writeToSource( )................................................................................................................... 3-45
4 ORDAudio
ORDAudio Object Type........................................................................................................ 4-3
ORDAudio Constructors...................................................................................................... 4-8
init( ) for ORDAudio...................................................................................................... 4-9
init(srcType,srcLocation,srcName) for ORDAudio................................................. 4-11
ORDAudio Methods ........................................................................................................... 4-13
checkProperties( )......................................................................................................... 4-15
getAllAttributes( ) ........................................................................................................ 4-17
getAttribute( ) ............................................................................................................... 4-19
v
getAudioDuration( ) .................................................................................................... 4-21
getCompressionType( ) ............................................................................................... 4-22
getContentLength( )..................................................................................................... 4-23
getContentInLob( )....................................................................................................... 4-24
getDescription( )........................................................................................................... 4-26
getEncoding( )............................................................................................................... 4-27
getFormat( )................................................................................................................... 4-28
getNumberOfChannels( )............................................................................................ 4-29
getSampleSize( ) ........................................................................................................... 4-30
getSamplingRate( )....................................................................................................... 4-31
import( )......................................................................................................................... 4-32
importFrom( ) ............................................................................................................... 4-35
processAudioCommand( ).......................................................................................... 4-38
setAudioDuration( )..................................................................................................... 4-40
setCompressionType( )................................................................................................ 4-41
setDescription( ) ........................................................................................................... 4-42
setEncoding( ) ............................................................................................................... 4-44
setFormat( ) ................................................................................................................... 4-45
setKnownAttributes( )................................................................................................. 4-47

setNumberOfChannels( ) ............................................................................................ 4-49
setProperties( ).............................................................................................................. 4-50
setSamplingRate( ) ....................................................................................................... 4-52
setSampleSize( )............................................................................................................ 4-53
5 ORDDoc
ORDDoc Object Type............................................................................................................ 5-3
ORDDoc Constructors.......................................................................................................... 5-6
init( ) for ORDDoc.......................................................................................................... 5-7
init(srcType,srcLocation,srcName) for ORDDoc....................................................... 5-9
ORDDoc Methods ............................................................................................................... 5-11
getContentInLob( )....................................................................................................... 5-12
vi
getContentLength( )..................................................................................................... 5-14
getFormat( )................................................................................................................... 5-15
import( ) ......................................................................................................................... 5-16
importFrom( )................................................................................................................ 5-19
setFormat( ) ................................................................................................................... 5-22
setProperties( ) .............................................................................................................. 5-24
6 ORDImage and ORDImageSignature
ORDImage Object Type........................................................................................................ 6-3
ORDImage Constructors ............................................................................................... 6-7
init( ) for ORDImage............................................................................................... 6-8
init(srcType,srcLocation,srcName) for ORDImage.......................................... 6-10
ORDImage Methods .................................................................................................... 6-12
checkProperties( ).................................................................................................. 6-13
copy( ) ..................................................................................................................... 6-15
getCompressionFormat( ) .................................................................................... 6-17
getContentFormat( ).............................................................................................. 6-18
getContentLength( ).............................................................................................. 6-19
getFileFormat( ) ..................................................................................................... 6-20

getHeight( ) ............................................................................................................ 6-21
getWidth( ) ............................................................................................................. 6-22
import( ).................................................................................................................. 6-23
importFrom( ) ........................................................................................................ 6-25
process( )................................................................................................................. 6-28
processCopy( ) ....................................................................................................... 6-34
setProperties( )....................................................................................................... 6-36
setProperties( ) for foreign images...................................................................... 6-38
ORDImageSignature Object Type..................................................................................... 6-42
ORDImageSignature Constructor.............................................................................. 6-44
init( ) for ORDImageSignature............................................................................ 6-45
ORDImageSignature Methods ................................................................................... 6-47
vii
evaluateScore( ) ..................................................................................................... 6-48
generateSignature( ).............................................................................................. 6-51
isSimilar( ) .............................................................................................................. 6-53
ORDImageSignature Operators................................................................................. 6-56
IMGSimilar( )......................................................................................................... 6-57
IMGScore( )............................................................................................................ 6-62
7 SQL/MM Still Image
SQL Functions and Procedures ........................................................................................... 7-3
Example Media Table and User Definition ....................................................................... 7-4
SI_AverageColor Object Type ............................................................................................. 7-5
SI_AverageColor Constructors .................................................................................... 7-7
SI_AverageColor(averageColorSpec) .................................................................. 7-8
SI_AverageColor(sourceImage).......................................................................... 7-10
SI_AverageColor Method ........................................................................................... 7-12
SI_Score( ) for SI_AverageColor ......................................................................... 7-13
SI_Color Object Type .......................................................................................................... 7-15
SI_Color Constructor ................................................................................................... 7-16

SI_Color Method .......................................................................................................... 7-17
SI_RGBColor( ) ...................................................................................................... 7-18
SI_ColorHistogram Object Type ....................................................................................... 7-20
SI_ColorHistogram Constructors .............................................................................. 7-22
SI_ColorHistogram(colors, frequencies)............................................................ 7-23
SI_ColorHistogram(firstColor, frequency)........................................................ 7-26
SI_ColorHistogram(sourceImage)...................................................................... 7-28
SI_ColorHistogram Methods...................................................................................... 7-30
SI_Append( ).......................................................................................................... 7-31
SI_Score( ) for SI_ColorHistogram ..................................................................... 7-33
SI_FeatureList Object Type ................................................................................................ 7-36
SI_FeatureList Constructor ......................................................................................... 7-39
SI_FeatureList( ) .................................................................................................... 7-40
viii
SI_FeatureList Methods............................................................................................... 7-44
SI_AvgClrFtr( ) ...................................................................................................... 7-45
SI_AvgClrFtrWght( ) ............................................................................................ 7-47
SI_ClrHstgrFtr( ).................................................................................................... 7-49
SI_ClrHstgrFtrWght( ).......................................................................................... 7-51
SI_PstnlClrFtr( )..................................................................................................... 7-53
SI_PstnlClrFtrWght( ) ........................................................................................... 7-55
SI_Score( ) for SI_FeatureList .............................................................................. 7-57
SI_SetFeature(averageColorFeature, averageColorFeatureWeight).............. 7-60
SI_SetFeature(colorHistogramFeature, colorHistogramFeatureWeight) ..... 7-62
SI_SetFeature(positionalColorFeature, positionalColorFeatureWeight) ...... 7-64
SI_SetFeature(textureFeature, textureFeatureWeight) .................................... 7-66
SI_TextureFtr( )...................................................................................................... 7-68
SI_TextureFtrWght( )............................................................................................ 7-70
SI_PositionalColor Object Type......................................................................................... 7-72
SI_PositionalColor Constructor.................................................................................. 7-73

SI_PositionalColor( )............................................................................................. 7-74
SI_PositionalColor Method......................................................................................... 7-76
SI_Score( ) for SI_PositionalColor ....................................................................... 7-77
SI_StillImage Object Type .................................................................................................. 7-79
SI_StillImage Constructors.......................................................................................... 7-82
SI_StillImage(content)........................................................................................... 7-83
SI_StillImage(content, explicitFormat)............................................................... 7-87
SI_StillImage(content, explicitFormat, height, width)..................................... 7-91
SI_StillImage Methods................................................................................................. 7-95
SI_ClearFeatures( )................................................................................................ 7-96
SI_InitFeatures( ) ................................................................................................... 7-98
SI_ChangeFormat( ) ............................................................................................ 7-100
SI_Content( ) ........................................................................................................ 7-103
SI_ContentLength( )............................................................................................ 7-105
SI_Format( ).......................................................................................................... 7-107
ix
SI_Height( ) .......................................................................................................... 7-109
SI_RetainFeatures( )............................................................................................ 7-111
SI_SetContent( )................................................................................................... 7-113
SI_Thumbnail( )................................................................................................... 7-116
SI_Thumbnail(height,width)............................................................................. 7-118
SI_Width( ) ........................................................................................................... 7-121
SI_Texture Object Type .................................................................................................... 7-123
SI_Texture Constructor ............................................................................................. 7-124
SI_Texture( )......................................................................................................... 7-125
SI_Texture Method..................................................................................................... 7-127
SI_Score( ) for SI_Texture................................................................................... 7-128
Views................................................................................................................................... 7-130
Internal Helper Types....................................................................................................... 7-133
8 ORDVideo

ORDVideo Object Type ........................................................................................................ 8-3
ORDVideo Constructors ...................................................................................................... 8-8
init( ) for ORDVideo ...................................................................................................... 8-9
init(srcType,srcLocation,srcName) for ORDVideo ................................................. 8-11
ORDVideo Methods............................................................................................................ 8-13
checkProperties( )......................................................................................................... 8-15
getAllAttributes( ) ........................................................................................................ 8-17
getAttribute( ) ............................................................................................................... 8-19
getBitRate( )................................................................................................................... 8-21
getCompressionType( ) ............................................................................................... 8-22
getContentInLob( )....................................................................................................... 8-23
getContentLength( )..................................................................................................... 8-25
getDescription( )........................................................................................................... 8-26
getFormat( )................................................................................................................... 8-27
getFrameRate( ) ............................................................................................................ 8-28
getFrameResolution( ) ................................................................................................. 8-29
x
getFrameSize( ) ............................................................................................................. 8-30
getNumberOfColors( )................................................................................................. 8-32
getNumberOfFrames( ) ............................................................................................... 8-33
getVideoDuration( ) ..................................................................................................... 8-34
import( ) ......................................................................................................................... 8-35
importFrom( )................................................................................................................ 8-37
processVideoCommand( )........................................................................................... 8-40
setBitRate( ) ................................................................................................................... 8-42
setCompressionType( )................................................................................................ 8-43
setDescription( )............................................................................................................ 8-44
setFormat( ) ................................................................................................................... 8-46
setFrameRate( ) ............................................................................................................. 8-48
setFrameResolution( ).................................................................................................. 8-49

setFrameSize( ).............................................................................................................. 8-50
setKnownAttributes( ) ................................................................................................. 8-52
setNumberOfColors( ) ................................................................................................. 8-55
setNumberOfFrames( )................................................................................................ 8-56
setProperties( ) .............................................................................................................. 8-57
setVideoDuration( )...................................................................................................... 8-59
9 interMedia Relational Interface Reference
Static Methods for the Relational Interface........................................................................ 9-3
Static Methods Common to All Object Types ................................................................... 9-4
export( )............................................................................................................................ 9-5
importFrom( ).................................................................................................................. 9-9
importFrom( ) (all attributes)...................................................................................... 9-12
Static Methods Unique to the ORDAudio Object Type Relational Interface.............. 9-15
getProperties( ) for BLOBs .......................................................................................... 9-18
getProperties( ) (all attributes) for BLOBs ................................................................ 9-20
getProperties( ) for BFILEs.......................................................................................... 9-24
getProperties( ) (all attributes) for BFILEs ................................................................ 9-26
xi
Static Methods Unique to the ORDDoc Object Type Relational Interface.................. 9-29
getProperties( ) for BLOBs .......................................................................................... 9-31
getProperties( ) (all attributes) for BLOBs ................................................................ 9-33
getProperties( ) for BFILEs.......................................................................................... 9-36
getProperties( ) (all attributes) for BFILEs................................................................ 9-38
Static Methods Unique to the ORDImage Object Type Relational Interface.............. 9-40
getProperties( ) for BLOBs .......................................................................................... 9-43
getProperties( ) (all attributes) for BLOBs ................................................................ 9-45
getProperties( ) for BFILEs.......................................................................................... 9-48
getProperties( ) (all attributes) for BFILEs................................................................ 9-50
process( )........................................................................................................................ 9-53
processCopy( ) for BLOBs........................................................................................... 9-55

processCopy( ) for BFILEs .......................................................................................... 9-57
Static Methods Unique to the ORDVideo Object Type Relational Interface .............. 9-59
getProperties( ) for BLOBs .......................................................................................... 9-62
getProperties( ) (all attributes) for BLOBs ................................................................ 9-64
getProperties( ) for BFILEs.......................................................................................... 9-68
getProperties( ) (all attributes) for BFILEs................................................................ 9-70
10 ORDSource
ORDSource Object Type..................................................................................................... 10-2
ORDSource Methods .......................................................................................................... 10-6
clearLocal( )................................................................................................................... 10-8
close( ) ............................................................................................................................ 10-9
deleteLocalContent( )................................................................................................. 10-11
export( )........................................................................................................................ 10-12
getBFile( )..................................................................................................................... 10-15
getContentInTempLob( )........................................................................................... 10-16
getContentLength( )................................................................................................... 10-18
getLocalContent( )...................................................................................................... 10-19
getSourceAddress( )................................................................................................... 10-20
xii
getSourceInformation( )............................................................................................. 10-22
getSourceLocation( ) .................................................................................................. 10-23
getSourceName( )....................................................................................................... 10-24
getSourceType( )......................................................................................................... 10-25
getUpdateTime( )........................................................................................................ 10-26
import( ) ....................................................................................................................... 10-27
importFrom( ).............................................................................................................. 10-29
isLocal( )....................................................................................................................... 10-31
open( ) .......................................................................................................................... 10-32
processCommand( ) ................................................................................................... 10-34
read( ) ........................................................................................................................... 10-36

setLocal( )..................................................................................................................... 10-38
setSourceInformation( )............................................................................................. 10-39
setUpdateTime( )........................................................................................................ 10-41
trim( )............................................................................................................................ 10-42
write( ).......................................................................................................................... 10-44
A Audio File and Compression Formats
A.1 Supported AIFF Data Formats............................................................................................. A-1
A.2 Supported AIFF-C Data Formats ........................................................................................ A-2
A.3 Supported AU Data Formats ............................................................................................... A-2
A.4 Supported Audio MPEG Data Formats ............................................................................. A-4
A.4.1 Supported MPEG1 and MPEG2 Data Formats .......................................................... A-4
A.4.2 Supported MPEG4 Data Formats................................................................................. A-5
A.5 Supported RealNetworks Real Audio Data Format......................................................... A-5
A.6 Supported WAV Data Formats ........................................................................................... A-6
B Image File and Compression Formats
B.1 Image File Formats ................................................................................................................ B-1
B.2 Image Compression Formats............................................................................................... B-7
B.3 Summary of Image File Format and Image Compression Format............................... B-11
xiii
C Video File and Compression Formats
C.1 Apple QuickTime 3.0 Data Formats ................................................................................... C-1
C.2 Microsoft Video for Windows (AVI) Data Formats ......................................................... C-2
C.3 RealNetworks Real Video Data Format ............................................................................. C-3
C.4 Supported Video MPEG Data Formats.............................................................................. C-3
C.4.1 Supported MPEG1 and MPEG2 Data Formats.......................................................... C-3
C.4.2 Supported MPEG4 Data Formats ................................................................................ C-3
D Image process( ) and processCopy( ) Operators
D.1 Common Concepts................................................................................................................ D-1
D.1.1 Source and Destination Images.................................................................................... D-1
D.1.2 process( ) and processCopy( ) ...................................................................................... D-2

D.1.3 Operator and Value ....................................................................................................... D-2
D.1.4 Combining Operators.................................................................................................... D-2
D.2 Image Formatting Operators ............................................................................................... D-2
D.2.1 fileFormat ........................................................................................................................ D-3
D.2.2 contentFormat................................................................................................................. D-3
D.2.3 compressionFormat ....................................................................................................... D-7
D.2.4 compressionQuality....................................................................................................... D-9
D.3 Image Processing Operators................................................................................................ D-9
D.3.1 contrast ............................................................................................................................ D-9
D.3.2 cut ................................................................................................................................... D-10
D.3.3 flip................................................................................................................................... D-10
D.3.4 gamma ........................................................................................................................... D-11
D.3.5 mirror............................................................................................................................. D-11
D.3.6 page ................................................................................................................................ D-11
D.3.7 quantize ......................................................................................................................... D-11
D.3.8 rotate .............................................................................................................................. D-13
D.3.9 Scaling Operators ......................................................................................................... D-14
D.3.9.1 fixedScale................................................................................................................ D-14
D.3.9.2 maxScale................................................................................................................. D-14
D.3.9.3 scale......................................................................................................................... D-15
D.3.9.4 xScale ...................................................................................................................... D-15
D.3.9.5 yScale ...................................................................................................................... D-16
D.3.10 tiled................................................................................................................................. D-16
xiv
D.4 Format-Specific Operators ................................................................................................ D-16
D.4.1 channelOrder ............................................................................................................... D-16
D.4.2 pixelOrder .................................................................................................................... D-16
D.4.3 scanlineOrder............................................................................................................... D-17
D.4.4 inputChannels.............................................................................................................. D-17
E Image Raw Pixel Format

E.1 Raw Pixel Introduction ......................................................................................................... E-1
E.2 Raw Pixel Image Structure................................................................................................... E-2
E.3 Raw Pixel Header Field Descriptions................................................................................. E-3
E.4 Raw Pixel Post-Header Gap................................................................................................. E-8
E.5 Raw Pixel Data Section and Pixel Data Format ................................................................ E-8
E.5.1 Scanline Ordering........................................................................................................... E-8
E.5.2 Pixel Ordering................................................................................................................. E-9
E.5.3 Band Interleaving ......................................................................................................... E-10
E.5.4 N-Band Data.................................................................................................................. E-11
E.6 Raw Pixel Header - C Language Structure ...................................................................... E-12
E.7 Raw Pixel Header - C Language Constants..................................................................... E-12
E.8 Raw Pixel PL/SQL Constants............................................................................................ E-13
E.9 Raw Pixel Images Using CCITT Compression................................................................ E-14
E.10 Foreign Image Support and the Raw Pixel Format ........................................................ E-14
F Exceptions and Error Messages
F.1 ORDAudioExceptions Exceptions ...................................................................................... F-1
F.2 ORDDocExceptions Exceptions........................................................................................... F-3
F.3 ORDImageExceptions Exceptions....................................................................................... F-3
F.4 ORDVideoExceptions Exceptions....................................................................................... F-4
F.5 ORDSourceExceptions Exceptions...................................................................................... F-5
F.6 ORDImageSIExceptions Exceptions ................................................................................... F-7
G Deprecated Audio and Video Methods
Index
xv
List of Figures
D–1 Syntax Diagram for MONOCHROME contentFormat ................................................... D-4
D–2 Syntax Diagram for LUT contentFormat ........................................................................... D-5
D–3 Syntax Diagram for GRAYSCALE contentFormat........................................................... D-6
D–4 Syntax Diagram for Direct RGB contentFormat ............................................................... D-7
xvi

List of Tables
6–1 Image Processing Operators ............................................................................................. 6-28
6–2 Additional Image Processing Operators for Raw Pixel and Foreign Images ............ 6-31
6–3 Image Characteristics for Foreign Files........................................................................... 6-39
7–1 SI_IMAGE_FORMATS View .......................................................................................... 7-130
7–2 SI_IMAGE_FORMAT_CONVERSIONS View............................................................. 7-130
7–3 SI_IMAGE_FORMAT_FEATURES View...................................................................... 7-131
7–4 SI_THUMBNAIL_FORMATS View .............................................................................. 7-131
7–5 SI_VALUES View ............................................................................................................. 7-132
A–1 Supported AIFF-C Data Compression Formats and Types ........................................... A-2
A–2 AU Data Compression Formats and Types...................................................................... A-3
A–3 Audio MPEG1 and MPEG2 Compression Formats and Types ..................................... A-5
A–4 WAV Data Compression Formats and Types .................................................................. A-6
B–1 I/O Support for Image File Content Format Characteristics ....................................... B-12
B–2 I/O Support for Image File Compression Formats ....................................................... B-13
B–3 I/O Support for Image File Formats Other Than Content and Compression........... B-15
C–1 Supported Apple QuickTime 3.0 Data Compression Formats ...................................... C-1
C–2 Supported AVI Data Compression Formats..................................................................... C-2
E–1 Raw Pixel Image Header Structure.................................................................................... E-2
xvii
Send Us Your Comments
Oracle interMedia Reference, 10g Release 1 (10.1)
Part No. B10829-01
Oracle Corporation welcomes your comments and suggestions on the quality and usefulness of this
publication. Your input is an important part of the information used for revision.
■
Did you find any errors?
■
Is the information clearly presented?
■

Do you need more information? If so, where?
■
Are the examples correct? Do you need more examples?
■
What features did you like most about this manual?
If you find any errors or have any other suggestions for improvement, please indicate the title and
part number of the documentation and the chapter, section, and page number (if available). You can
send comments to us in the following ways:
■
Electronic mail:
■
FAX: 603.897.3825 Attn: Oracle interMedia Documentation
■
Postal service:
Oracle Corporation
Oracle interMedia Documentation
One Oracle Drive
Nashua, NH 03062
USA
If you would like a reply, please give your name, address, telephone number, and electronic mail
address (optional).
If you have problems with the software, please contact your local Oracle Support Services.
xviii
xix
Preface
This guide describes how to use Oracle interMedia ("interMedia"), which ships with
Oracle Database.
For information about Oracle Database and the latest features and options that are
available to you, see Oracle Database New Features.
Audience

This guide is for application developers and database administrators who are
interested in storing, retrieving, and manipulating audio, image, and video data in
Oracle Database, including developers of audio, image, and video specialization
options. Before using this reference, you should familiarize yourself with the
concepts presented in Oracle interMedia User's Guide.
If you are interested in only one particular object type, see Chapter 1 for general
introductory information, then, for a description of the methods that are common
for all object types, refer to Chapter 3. If, for example, you are interested in the
ORDImage object type, refer to Chapter 6, the ORDImage reference chapter for a
description of the image-specific methods.
For a description of using the relational interface with images, see Chapter 9.
For information on supported image content and compression formats, see
Appendix B. For information about using image processing methods, see
Appendix D. Finally, for information about the raw pixel image format, see
Appendix E.
xx
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
/>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 the following chapters and appendixes:
Chapter 1, "Introduction to Oracle interMedia"
Introduces multimedia and Oracle interMedia.
Chapter 2, "Ensuring Compatibility with Evolving interMedia Object Types"
Provides compatibility information for ensuring future compatibility with evolving
object types.
Chapter 3, "Common Methods for interMedia Object Types"
Provides reference information about methods that are common to ORDAudio,
ORDDoc, ORDImage, and ORDVideo object types.
xxi
Chapter 4, "ORDAudio"
Provides reference information on Oracle interMedia ORDAudio object type and
methods.
Chapter 5, "ORDDoc"
Provides reference information on Oracle interMedia ORDDoc object type and
methods.
Chapter 6, "ORDImage and ORDImageSignature"
Provides reference information on Oracle interMedia ORDImage object type and
methods.
Chapter 7, "SQL/MM Still Image"
Provides reference information on SQL/MM Still Image object types, methods, SQL

functions and procedures, and views that identify the supported image formats and
implementation-defined values
Chapter 8, "ORDVideo"
Provides reference information on Oracle interMedia ORDVideo object type and
methods.
Chapter 9, "interMedia Relational Interface Reference"
Provides reference information on Oracle interMedia relational interface methods
for the ORDAudio, ORDDoc, ORDImage, and ORDVideo object types.
Chapter 10, "ORDSource"
Provides reference information on Oracle interMedia ORDSource object type and
methods.
Appendix A, "Audio File and Compression Formats"
Describes the supported audio data formats.
Appendix B, "Image File and Compression Formats"
Describes the supported image data formats.
Appendix C, "Video File and Compression Formats"
Describes the supported video data formats.
xxii
Appendix D, "Image process( ) and processCopy( ) Operators"
Describes the process( ) and processCopy( ) operators.
Appendix E, "Image Raw Pixel Format"
Describes the raw pixel format.
Appendix F, "Exceptions and Error Messages"
Lists exceptions raised, their causes, and user actions to correct them.
Appendix G, "Deprecated Audio and Video Methods"
Lists the ORDAudio and ORDVideo get methods that were deprecated in release
8.1.6
Related Documentation
For more information about using interMedia in a development environment, see
the following documents in the Oracle Database software documentation set:

■
Oracle interMedia User's Guide
■
Oracle Call Interface Programmer's Guide
■
Oracle Streams Advanced Queuing User's Guide and Reference
■
Oracle Database Application Developer's Guide - Large Objects
■
Oracle Database Concepts
■
PL/SQL User's Guide and Reference
■
Oracle interMedia Java Classes Reference
Oracle error message documentation is available in HTML only. If you have access
to the Oracle Database 10g Documentation CD-ROM only, you can browse the error
Note:
For information added after the release of this guide, refer
to the online README.txt file in your <ORACLE_HOME>
directory. Depending on your operating system, this file may be in:
<ORACLE_HOME>/ord/im/admin/README.txt
Please see your operating system-specific installation guide for
more information.
xxiii
messages by range. Once you find the specific range, use your browser's "find in
page" feature to locate the specific message.
When connected to the Internet, you can search for a specific error message using
the error message search feature of the Oracle online documentation.
For information about Oracle Locator, see Oracle Spatial User's Guide and Reference.
For reference information on both Oracle interMedia Java Classes and Oracle

interMedia Java Classes for Servlets and JSP in Javadoc format, see the Oracle API
documentation (also known as Javadoc). The API documentation is available on the
Oracle Database 10g Documentation CD-ROM and also from the documentation
section of the Oracle Technology Network (OTN) Web site at
/>Note that the information in the reference sections of Oracle interMedia Java Classes
Reference supersedes the Javadoc documentation.
Many of the examples in this book use the sample schemas of the seed database,
which is installed by default when you install Oracle. Refer to Oracle Database
Sample Schemas for information on how these schemas were created and how you
can use them yourself.
Printed documentation is available for sale in the Oracle Store at
/>To download free release notes, installation documentation, white papers, or other
collateral, please visit the Oracle Technology Network (OTN). You must register
online before using OTN; registration is free and can be done at
/>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
/>Conventions
In this guide, Oracle interMedia 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.
xxiv
The following conventions are also used in this guide:
Changes to This Guide
The following substantive changes have been made to this guide since release 9.0.1:
■
Documentation for new image objects that comply with the first edition of the
ISO/IEC 13249-5:2001 SQL MM Part5:StillImage standard (commonly referred
to as the SQL/MM Still Image standard) is added. See Chapter 7.
■
The following information has been moved to Oracle interMedia User's Guide:

– Extending Oracle interMedia (previously in Chapter 1)
– interMedia architecture (previously in Chapter 1)
– Content-based retrieval concepts (previously Chapter 2)
– interMedia examples (previously Chapter 3)
– Tuning tips for the DBA (previously Chapter 11)
– Sample programs (previously Appendix F)
– Packages or PL/SQL plug-ins (previously included at the end of the
chapters that describe ORDAudio, ORDDoc, ORDVideo, and ORDSource)
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.
italic text Italic text is used for emphasis, book titles, and usr-supplied
information.
< > Angle brackets enclose user-supplied names.
[ ] Brackets enclose optional clauses from which you can choose one or
none.
Introduction to Oracle interMedia 1-1
1
Introduction to Oracle interMedia
Oracle interMedia ("interMedia") is a feature that enables Oracle Database to store,
manage, and retrieve images, audio, video, or other heterogeneous media data in an
integrated fashion with other enterprise information. Oracle interMedia extends
Oracle Database reliability, availability, and data management to multimedia

content in traditional, Internet, electronic commerce, and media-rich applications.
See Oracle interMedia User's Guide for conceptual information and information on
application development.
1.1 Multimedia Object Types and Methods
Oracle interMedia provides the ORDAudio, ORDDoc, ORDImage,
ORDImageSignature, ORDVideo, and SI_StillImage object types and methods for:
■
Extracting metadata and attributes from multimedia data
■
Getting and managing multimedia data from Oracle interMedia, Web servers,
file systems, and other servers
■
Performing manipulation operations on image data
1.2 Multimedia Storage
Oracle interMedia provides the ORDSource object type and methods for multimedia
data source manipulation. The ORDAudio, ORDDoc, ORDImage, and ORDVideo
object types all contain an attribute of type ORDSource.