Oracle InterMedia. User's Guide and Reference

User’s Guide and Reference......Page 1
List of Examples......Page 18
List of Figures......Page 20
List of Tables......Page 21
Send Us Your Comments......Page 23
Audience......Page 25
Organization......Page 26
Conventions......Page 27
Changes to This Guide......Page 28
Documentation Accessibility......Page 29
1.1 Object Relational Technology......Page 31
1.2 Multimedia Content Management......Page 32
1.3 Audio Concepts......Page 35
1.4 ORDDoc or Heterogeneous Media Data Concepts......Page 36
1.5 Image Concepts......Page 37
1.5.2 Image Components......Page 38
1.6.2 Video Components......Page 39
1.8 Multimedia Storage......Page 40
1.8.1 Storing Multimedia Data......Page 41
1.9 Extending Oracle interMedia......Page 42
1.9.1 Supporting Other External Sources and Other Media Data Formats......Page 43
1.9.3 Supporting Video Data Processing......Page 44
1.11 Loading Multimedia Data into Oracle9i Using interMedia......Page 45
1.12 Reading Data from a LOB......Page 46
1.13 interMedia Architecture......Page 47
1.13.1 Oracle interMedia Java Classes......Page 51
1.13.2 Oracle interMedia Java Classes for Servlets and JSPs......Page 52
1.13.3 Annotation Services for Multimedia Data......Page 53
1.13.4 Streaming Content from an Oracle Database......Page 54
1.13.6 Geocoding Services......Page 55
2.1 Overview and Benefits......Page 59
2.2 How Content-Based Retrieval Works......Page 60
2.2.1 Color......Page 63
2.2.3 Shape......Page 65
2.3.2 Score......Page 66
2.3.3 Similarity Calculation......Page 67
2.3.4 Threshold Value......Page 69
2.4 Using an Index to Compare Signatures......Page 70
2.5 Preparing or Selecting Images for Useful Matching......Page 71
3.1 Audio Data Examples......Page 75
3.1.3 Creating a List Object Containing a List of References to Songs......Page 76
3.1.5 Creating a CD Object and a CD Table......Page 77
3.1.6 Inserting a Song into the SongsTable Table......Page 78
3.1.8 Loading a Song into the SongsTable Table......Page 79
3.1.9 Inserting a Reference to a Song Object into the Songs List in the CdTable Table......Page 80
3.1.11 Retrieving Audio Data from a Song in a CD......Page 82
3.1.13 Extending interMedia with a New Type......Page 83
3.1.14 Using Audio Types with Object Views......Page 84
3.1.15 Scripts for Creating and Populating an Audio Table from a BFILE Data Source......Page 85
3.2 Media Data Examples......Page 93
3.2.1 Defining a Media Object......Page 94
3.2.4 Defining the Implementation of the documentList Object......Page 95
3.2.5 Creating a Library Object and a Library Table......Page 96
3.2.6 Inserting Media into the DocumentsTable Table......Page 97
3.2.8 Loading Media into the DocumentsTable Table......Page 98
3.2.9 Inserting a Reference to a Document Object into the Documents List in the LibraryTable Table......Page 99
3.2.10 Adding a Library Reference to a Document......Page 100
3.2.11 Extending interMedia to Support a New Media Data Format......Page 101
3.2.13 Using Document Types with Object Views......Page 102
3.2.14 Using the ORDDoc Object Type as a Repository......Page 103
3.2.15 Scripts for Creating and Populating a Media Table from a BFILE Data Source......Page 108
3.3 Image Data Examples......Page 115
3.3.2 Adding Image Types to a New Table......Page 116
3.3.3 Inserting a Row Using BLOB Images......Page 117
3.3.4 Populating a Row Using BLOB Images......Page 118
3.3.5 Inserting a Row Using BFILE Images......Page 119
3.3.7 Querying a Row......Page 120
3.3.8 Importing an Image from an External File into the Database......Page 121
3.3.9 Retrieving an Image......Page 122
3.3.10 Retrieving Images Similar to a Comparison Image (Content-Based Retrieval)......Page 124
3.3.11 Creating a Domain Index......Page 126
3.3.13 Copying an Image......Page 127
3.3.15 Copying and Converting in One Step......Page 128
3.3.16 Extending interMedia with a New Type......Page 129
3.3.17 Using Image Types with Object Views......Page 131
3.3.18 Scripts for Creating and Populating an Image Table from a BFILE Data Source......Page 133
3.3.19 Scripts for Populating an Image Table from an HTTP Data Source......Page 140
3.3.20 Addressing Globalization Support Issues......Page 142
3.4 Video Data Examples......Page 143
3.4.2 Creating an Object Table ClipsTable......Page 144
3.4.5 Creating a Video Object and a Video Table......Page 145
3.4.6 Inserting a Video Clip into the ClipsTable Table......Page 146
3.4.8 Loading a Video into the ClipsTable Table......Page 147
3.4.9 Inserting a Reference to a Clip Object into the Clips List in the VideoTable Table......Page 148
3.4.10 Inserting a Reference to a Video Object into the Clip......Page 149
3.4.12 Extending interMedia to Support a New Video Data Format......Page 150
3.4.14 Using Video Types with Object Views......Page 151
3.4.15 Scripts for Creating and Populating a Video Table from a BFILE Data Source......Page 153
3.5 Extending interMedia to Support a New Data Source......Page 160
4.1 When and How to Call the Compatibility Initialization Function......Page 163
compatibilityInit( )......Page 165
5 Common Methods for interMedia Object Types Reference Information......Page 169
5.1 Important Notes......Page 170
5.2 Methods......Page 171
clearLocal( )......Page 173
closeSource( )......Page 174
deleteContent( )......Page 176
export( )......Page 177
getBFILE( )......Page 181
getContent( )......Page 183
getMimeType( )......Page 185
getSource( )......Page 187
getSourceLocation( )......Page 189
getSourceName( )......Page 190
getSourceType( )......Page 191
getUpdateTime( )......Page 193
isLocal( )......Page 194
openSource( )......Page 195
processSourceCommand( )......Page 197
readFromSource( )......Page 200
setLocal( )......Page 202
setMimeType( )......Page 203
setSource( )......Page 205
setUpdateTime( )......Page 207
trimSource( )......Page 208
writeToSource( )......Page 210
6 ORDAudio Reference Information......Page 213
6.1 Object Types......Page 214
ORDAudio Object Type......Page 215
6.2 Constructors......Page 219
init( )......Page 220
init(srcType,srcLocation,srcName)......Page 222
6.3 Methods......Page 224
6.3.1 Example Table Definitions......Page 228
checkProperties( )......Page 229
getAllAttributes( )......Page 231
getAttribute( )......Page 233
getAudioDuration( )......Page 235
getContentLength( )......Page 236
getCompressionType( )......Page 237
getContentInLob( )......Page 238
getDescription( )......Page 240
getEncoding( )......Page 241
getFormat( )......Page 242
getNumberOfChannels( )......Page 243
getSampleSize( )......Page 244
getSamplingRate( )......Page 245
import( )......Page 246
importFrom( )......Page 248
processAudioCommand( )......Page 251
setAudioDuration( )......Page 254
setCompressionType( )......Page 255
setDescription( )......Page 256
setEncoding( )......Page 258
setFormat( )......Page 259
setKnownAttributes( )......Page 261
setNumberOfChannels( )......Page 263
setProperties( )......Page 264
setSamplingRate( )......Page 266
setSampleSize( )......Page 267
6.4.1 ORDPLUGINS.ORDX_DEFAULT_AUDIO Package......Page 268
6.4.2 Extending interMedia to Support a New Audio Data Format......Page 271
7 ORDDoc Reference Information......Page 275
7.1 Object Types......Page 276
ORDDoc Object Type......Page 277
7.2 Constructors......Page 279
init( )......Page 280
init(srcType,srcLocation,srcName)......Page 282
7.3 Methods......Page 284
7.3.1 Example Table Definitions......Page 286
getContentInLob( )......Page 288
getContentLength( )......Page 290
getFormat......Page 291
import( )......Page 292
importFrom( )......Page 295
setFormat( )......Page 298
setProperties( )......Page 300
7.4.1 ORDPLUGINS.ORDX_DEFAULT_DOC Package......Page 303
7.4.2 Extending interMedia to Support a New Media Data Format......Page 304
8 Image Object Types Reference Information......Page 305
8.1 ORDImage Object Types......Page 306
ORDImage Object Type......Page 307
8.1.1 Constructors......Page 310
init( ) for ORDImage......Page 311
init(srcType,srcLocation,srcName) for ORDImage......Page 313
8.1.2 Methods......Page 314
8.1.3 Example Table Definitions......Page 317
checkProperties......Page 319
copy( )......Page 320
getCompressionFormat......Page 322
getContentFormat......Page 323
getContentLength......Page 324
getFileFormat......Page 325
getHeight......Page 326
getWidth......Page 327
import( )......Page 328
importFrom( )......Page 330
process( )......Page 333
processCopy( )......Page 338
setProperties......Page 340
setProperties( ) for Foreign Images......Page 342
8.2 ORDImageSignature Object Type......Page 344
8.2.1 Constructors......Page 346
init( ) for ORDImageSignature......Page 348
8.2.2 Methods......Page 349
evaluateScore( )......Page 350
generateSignature( )......Page 352
isSimilar( )......Page 353
8.2.3 ORDImageSignature Operators......Page 355
IMGSimilar Operator......Page 356
IMGScore Operator......Page 360
9 ORDVideo Reference Information......Page 363
9.1 Object Types......Page 364
ORDVideo Object Type......Page 365
9.2 Constructors......Page 370
init( )......Page 371
init(srcType,srcLocation,srcName)......Page 373
9.3 Methods......Page 375
9.3.1 Example Table Definitions......Page 379
checkProperties( )......Page 380
getAllAttributes( )......Page 382
getAttribute( )......Page 384
getBitRate......Page 386
getCompressionType......Page 387
getContentInLob( )......Page 388
getContentLength( )......Page 390
getDescription......Page 391
getFormat......Page 392
getFrameRate......Page 394
getFrameResolution......Page 395
getFrameSize( )......Page 396
getNumberOfColors......Page 398
getNumberOfFrames......Page 399
getVideoDuration......Page 400
import( )......Page 401
importFrom( )......Page 403
processVideoCommand( )......Page 406
setBitRate( )......Page 409
setCompressionType( )......Page 410
setDescription( )......Page 411
setFormat( )......Page 413
setFrameRate( )......Page 415
setFrameResolution( )......Page 416
setFrameSize( )......Page 417
setKnownAttributes( )......Page 419
setNumberOfColors( )......Page 422
setNumberOfFrames( )......Page 423
setProperties( )......Page 424
setVideoDuration( )......Page 426
9.4.1 ORDPLUGINS.ORDX_DEFAULT_VIDEO Package......Page 427
9.4.2 Extending interMedia to Support a New Video Data Format......Page 430
10 interMedia Relational Interface Reference......Page 435
10.1.2 Static Methods Uniquely Associated with Each Object Type......Page 436
10.2 Static Methods Common to All Object Types......Page 438
export( )......Page 439
importFrom( )......Page 442
importFrom( ) (all attributes)......Page 445
10.3 Static Methods Unique to the ORDAudio Object Type Relational Interface......Page 447
10.3.1 Example Table Definitions......Page 448
getProperties( ) for BLOBs......Page 450
getProperties( ) (all attributes) for BLOBs......Page 452
getProperties( ) for BFILEs......Page 456
getProperties( ) (all attributes) for BFILEs......Page 458
10.4 Static Methods Unique to the ORDDoc Object Type Relational Interface......Page 460
10.4.1 Example Table Definitions......Page 462
getProperties( ) for BLOBs......Page 463
getProperties( ) (all attributes) for BLOBs......Page 465
getProperties( ) for BFILEs......Page 468
getProperties( ) (all attributes) for BFILEs......Page 470
10.5 Static Methods Unique to the ORDImage Object Type Relational Interface......Page 472
10.5.1 Example Table Definitions......Page 473
getProperties( ) for BLOBs......Page 475
getProperties( ) (all attributes) for BLOBs......Page 477
getProperties( ) for BFILEs......Page 480
getProperties( ) (all attributes) for BFILEs......Page 482
process( )......Page 485
processCopy( ) for BLOBs......Page 487
processCopy( ) for BFILEs......Page 489
10.6 Static Methods Unique to the ORDVideo Object Type Relational Interface......Page 490
10.6.1 Example Table Definitions......Page 492
getProperties( ) for BLOBs......Page 494
getProperties( ) (all attributes) for BLOBs......Page 496
getProperties( ) for BFILEs......Page 500
getProperties( ) (all attributes) for BFILEs......Page 502
11 Tuning Tips for the DBA......Page 507
11.1 Setting Database Initialization Parameters......Page 508
11.2.1 Initializing Internal interMedia Column Objects Containing BLOBs to NULL or EMPTY......Page 514
11.2.2 Specifying Tablespace and Storage Characteristics for interMedia Column Objects Containin.........Page 515
11.2.3 Segment Attributes and Physical Attributes......Page 521
11.2.4 Accommodating Temporary LOBs in the Buffer Cache......Page 522
11.2.6 LOB Buffering for Client Applications......Page 523
11.3 Improving Multimedia Data INSERT Performance in interMedia Objects Containing LOBs......Page 524
11.6 Reading Data from an ORDVideo Object Using the interMedia readFromSource( ) Method in a PL/.........Page 531
11.7 Reading Results of an interMedia Benchmark......Page 532
11.8 Getting the Best Performance Results......Page 534
11.9 Improving Multimedia LOB Data Retrieval and Update Performance......Page 535
A.1 Supported Audio File and Compression Formats......Page 537
B.1.1 Image File Formats......Page 543
B.1.2 Image Compression Formats......Page 549
B.1.3 Summary of Image File Format and Image Compression Format......Page 553
C.1 Supported Video File and Compression Formats......Page 559
D.1.1 Source and Destination Images......Page 563
D.2 Image Formatting Operators......Page 564
D.2.2 ContentFormat......Page 565
D.2.3 CompressionFormat......Page 566
D.2.4 CompressionQuality......Page 567
D.3.3 XScale......Page 568
D.3.6 MaxScale......Page 569
D.4.1 ChannelOrder......Page 570
D.4.5 InputChannels......Page 571
D.4.7 Page......Page 572
D.4.8 Tiled......Page 573
E.1 Raw Pixel Introduction......Page 575
E.2 Raw Pixel Image Structure......Page 576
E.3 Raw Pixel Header Field Descriptions......Page 577
E.4 Raw Pixel Post-Header Gap......Page 581
E.5.2 Pixel Ordering......Page 582
E.5.3 Band Interleaving......Page 583
E.5.4 N-Band Data......Page 584
E.6 Raw Pixel Header “C” Structure......Page 585
E.7 Raw Pixel Header “C” Constants......Page 586
E.9 Raw Pixel Images Using CCITT Compression......Page 587
E.10 Foreign Image Support and the Raw Pixel Format......Page 588
F.1 Sample Audio Scripts......Page 591
F.3 Sample Program for Modifying Images or Testing the Image Installation......Page 592
F.3.2 Running the Demo......Page 593
F.4 Sample Video Scripts......Page 594
F.5 Java Demo......Page 595
G Frequently Asked Questions......Page 597
H.1.1 ORDAudioExceptions Exceptions......Page 599
H.1.3 ORDImageExceptions Exceptions......Page 601
H.1.4 ORDVideoExceptions Exceptions......Page 602
H.1.5 ORDSourceExceptions Exceptions......Page 603
H.2 ORDAudio Error Messages......Page 604
H.3 ORDImage Error Messages......Page 605
H.4 ORDVideo Error Messages......Page 623
I ORDSource Reference Information......Page 625
I.1 Object Types......Page 626
I.2 Methods......Page 630
I.3 Packages or PL/SQL Plug-ins......Page 671
I.3.1 ORDPLUGINS.ORDX_FILE_SOURCE Package......Page 672
I.3.2 ORDPLUGINS.ORDX_HTTP_SOURCE Package......Page 674
I.3.4 Extending interMedia to Support a New Data Source......Page 676
J.1 Deprecated Audio and Video Methods......Page 681
Index......Page 685