Oracle InterMedia Annotator. User’s Guide

Oracle interMedia Annotator is a utility 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.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. Advanced users who want to write their own PL/SQL Upload Templates should be familiar with PL/SQL. Advanced users who want to write their own annotation types or parsers should be familiar with Java and XML.

---

Table of contents :
User’s Guide……Page 1
Send Us Your Comments……Page 11
Preface……Page 13
1.1 Purpose……Page 17
1.2 interMedia Annotator Operations Overview……Page 19
1.3 Prerequisites……Page 21
Part I interMedia Annotator GUI……Page 23
2.1 GUI Overview……Page 25
2.2 Configuration……Page 29
2.2.1 Set Connection to the Database……Page 30
2.2.2 Create Tables……Page 31
2.2.3 Check the Proxy Settings……Page 32
2.2.4 Connect to a CDDB……Page 33
2.2.5 Install Helper Applications……Page 35
3.1 Creating an Annotation……Page 39
3.2 Editing Attribute Values……Page 42
3.3 Adding and Deleting Attributes to the Annotation……Page 43
3.4 Adding and Deleting an Annotation……Page 44
3.5.1 Text Tracks from a QuickTime Movie……Page 46
3.5.2 Video Tracks from a QuickTime Movie……Page 47
3.5.3 Audio Tracks from a CD……Page 48
3.6 Saving an Annotation……Page 49
3.7 Opening a Saved Annotation……Page 50
3.8.3 Text Sample……Page 51
4.1.1 Connection Panel Window……Page 53
4.1.2 Upload Method Window……Page 54
4.1.3 Table Selection Window……Page 56
4.1.4 Upload Details Window……Page 57
4.1.5 Column Selection Window……Page 58
4.1.6 Row Selection Window……Page 59
4.1.7 Generate Button……Page 60
4.2 Using Upload Templates to Upload to the Database……Page 61
4.3 Editing Existing PL/SQL Upload Templates……Page 62
Part II interMedia Annotator Java-Based Engine……Page 63
5 interMedia Annotator Engine Example……Page 65
5.2 Class Definition and Instance Variables……Page 66
5.3 main( ) Method……Page 67
5.4 init( ) Method……Page 68
5.5 parse( ) Method……Page 69
5.6 parsePerformed( ) Method……Page 70
5.7 extractionPerformed( ) Method……Page 71
5.8 insertionPerformed( ) Method……Page 72
5.10 errorOccured( ) Method……Page 73
5.13 report(Annotation) Method……Page 74
5.15 reportError( ) Method……Page 75
6.1 Class oracle.ord.media.annotator.annotations.Annotation……Page 77
addSubAnnotation( )……Page 78
getAttribute( )……Page 79
getAttributes( )……Page 80
getDescriptor( )……Page 81
getName( )……Page 82
getNumSubAnnotations( )……Page 83
getParent( )……Page 84
getSampleAnns( )……Page 85
getSubAnnotations( )……Page 86
getURL( )……Page 87
isDescendantOf( )……Page 88
removeAttribute( )……Page 89
removeSampleAnns( )……Page 90
removeSubAnnotation( )……Page 91
setAttribute( )……Page 92
6.2 Class oracle.ord.media.annotator.descriptors.AnnotationDesc……Page 93
getAncestors( )……Page 94
getAttributeDesc( )……Page 95
getSuppAttributes( )……Page 96
6.3 Class oracle.ord.media.annotator.descriptors.ParserDesc……Page 97
getOperationDesc( )……Page 98
getOperations( )……Page 99
isEnabledAndExecutable( )……Page 100
6.4 Class oracle.ord.media.annotator.handlers.AnnTaskMonitor……Page 101
getMessage( )……Page 102
getTaskCurrent( )……Page 103
getTaskEnd( )……Page 104
getTaskStart( )……Page 105
isDone( )……Page 106
isInitialized( )……Page 107
6.5 Class oracle.ord.media.annotator.handlers.AnnotationHandler……Page 108
AnnotationHandler( )……Page 109
AnnotationHandler(int)……Page 110
createAnnotationByName( )……Page 111
exportToXML( )……Page 112
extractMedia( )……Page 113
getAnnotationNames( )……Page 114
getParserNames( )……Page 115
getRelVersion( )……Page 116
importFromXML( )……Page 117
insertMedia(Annotation,OrdMapping,AnnListener)……Page 118
insertMedia(Annotation,OrdMapping,AnnListener,Connection)……Page 119
isExtractable( )……Page 121
isPlayable( )……Page 122
parseMedia(InputStream,String,AnnListener)……Page 123
parseMedia(String,AnnListener)……Page 124
playMedia( )……Page 125
6.6 Class oracle.ord.media.annotator.handlers.db.OrdFileMapping……Page 126
generateStatement( )……Page 127
OrdFileMapping( )……Page 128
6.7 Class oracle.ord.media.annotator.listener.AnnListener……Page 129
errorOccured( )……Page 130
extractionPerformed( )……Page 131
insertionPerformed( )……Page 132
parsePerformed( )……Page 133
warningOccured( )……Page 134
6.8 Class oracle.ord.media.annotator.listener.OutputListener……Page 135
ConsoleOutput( )……Page 136
6.9 Class oracle.ord.media.annotator.utils.Preferences……Page 137
clone( )……Page 138
getPrefs( )……Page 139
getProperty( )……Page 140
Preferences( )……Page 141
saveToFile( )……Page 142
setPreferences( )……Page 143
setProperty( )……Page 144
6.10 Class oracle.ord.media.annotator.utils.Status……Page 145
GetOutputMode( )……Page 146
getStatus( )……Page 147
initStatus( )……Page 148
Report( )……Page 149
ReportError(short, Object, String, int, String)……Page 150
ReportError(short,Throwable)……Page 151
SetOutputMode( )……Page 152
7.1.1 Structure of Upload Templates……Page 153
7.1.2.2 ${MANN_BEGIN_ITERATE} and ${MANN_END_ITERATE}……Page 154
7.1.2.5 ${MANN_BEGIN_IFEQUALS} and ${MANN_END_IFEQUALS}……Page 155
7.1.2.7 ${MANN_UPLOAD_XML}……Page 156
7.1.4 Complete PL/SQL Upload Template Example……Page 157
7.2 Editing Existing PL/SQL Upload Templates……Page 158
Part III interMedia Annotator Extensibility……Page 159
8.1 Parser Creation Overview……Page 161
8.2 AU File Structure……Page 162
8.4 Class Definition and Instance Variables……Page 163
8.5 FormatInfo Class……Page 165
8.7 parse( ) Method……Page 166
8.8 saveToAnnotation( ) Method……Page 169
8.9 extractSamples( ) Method……Page 170
8.10 FillFormatHashTable( ) Method……Page 171
9.1 Class oracle.ord.media.annotator.handlers.AnnTaskManager……Page 173
addIterCounter( )……Page 175
decrIterCounter( )……Page 176
done( )……Page 177
getIterCounter( )……Page 178
getMessage( )……Page 179
getTaskCurrent( )……Page 180
getTaskEnd( )……Page 181
getTaskStart( )……Page 182
incrIterCounter( )……Page 183
incrTaskCurrent( )……Page 184
isDone( )……Page 185
isInitialized( )……Page 186
setIterCounter( )……Page 187
setMessage( )……Page 188
setTask( )……Page 189
setTaskCurrent(int)……Page 190
setTaskCurrent(int,String)……Page 191
9.2 Class oracle.ord.media.annotator.handlers.annotation.AnnotationFactory……Page 192
createAnnotationByName( )……Page 193
9.3 Class oracle.ord.media.annotator.parsers.Parser……Page 194
extractSamples( )……Page 195
parse( )……Page 196
saveToAnnotation( )……Page 197
9.4 Class oracle.ord.media.annotator.utils.MADataInputStream……Page 198
available( )……Page 199
close( )……Page 200
endBlock( )……Page 201
getBytesRead( )……Page 202
getLeft( )……Page 203
isLittleEndian( )……Page 204
mark( )……Page 205
read(byte[ ])……Page 206
read(byte[ ], int, int)……Page 207
readAVILanguage( )……Page 209
readByte( )……Page 210
readByteArray(byte[ ],int)……Page 211
readByteArray(int)……Page 212
readColor48( )……Page 213
readDate( )……Page 214
readDate(int,String)……Page 215
readExtended( )……Page 216
readFixedPoint16( )……Page 217
readFixedPoint32( )……Page 218
readFourCC( )……Page 219
readInt( )……Page 220
readLong( )……Page 221
readPascalString( )……Page 222
readPascalString(int)……Page 223
readPascalString(Short)……Page 224
readQTLanguage( )……Page 225
readRectangle( )……Page 226
readShort( )……Page 227
readString( )……Page 228
readUnsignedByte( )……Page 229
readUnsignedInt( )……Page 230
readUnsignedShort( )……Page 231
reset( )……Page 232
setLittleEndian( )……Page 233
skipBytes(int)……Page 234
skipBytes(long)……Page 235
startBlock( )……Page 236
10.1.1 AnnotationProperties Element……Page 237
10.1.2 AttributeDescriptors Element……Page 238
10.1.3 Element Hierarchy……Page 239
10.2 Using a New Annotation Type……Page 240
Part IV Appendixes……Page 241
A Querying Stored Annotations……Page 243
B Supported Formats……Page 245
C Defined Annotation Attributes……Page 247
D Frequently Asked Questions……Page 253
Index……Page 255