J Oracle Multimedia Deprecated API Components

This appendix lists deprecated components and components that will not be enhanced. This appendix includes these sections:

Note:

For detailed information about deprecated Oracle Multimedia API components and other features, see the Oracle Multimedia documentation in the Oracle Database Online Documentation Library. Specifically, see the documentation for releases previous to the release when the component was deprecated.

J.1 Image Processing Operators

The image processing operators dither and interleave were deprecated in Oracle Database 11g Release 1 (11.1). Although these operators still function, Oracle recommends that you stop using them as soon as possible. The dither operator has been replaced with the quantize operator. The interleave operator has been replaced with the contentFormat operator. See Chapter 5 and Appendix D for more information about the quantize and contentFormat operators.

J.2 ORDImageSignature Methods

All ORDImageSignature methods were deprecated in Oracle Database 11g Release 1 (11.1).

J.3 ORDImage Support for DICOM

Oracle Database 10g Release 2 (10.2) added the Digital Imaging and Communications in Medicine (DICOM) feature to Oracle Multimedia. This Oracle Multimedia feature enhanced the previous behavior of the Oracle Multimedia ORDImage object type by enabling Oracle Multimedia to recognize DICOM content and extract a subset of embedded DICOM attributes relating to patient, study, and series.

In Oracle Database 11g Release 1 (11.1), Oracle introduced new and substantially enhanced features to support DICOM content. As a result, beginning with Oracle Database 11g Release 2 (11.2), the DICOM support in ORDImage objects that was introduced in Oracle Database 10g Release 2 (10.2) was not enhanced, is deprecated in Oracle Database 12c Release 1 (12.1), and may be desupported in a future release.

These subsections provide more information about the deprecated DICOM support:

J.3.1 Important Notes About DICOM Support in ORDImage Objects

Oracle recommends taking these actions for medical imaging applications.

For New Applications

Use the DICOM support that was introduced in Oracle Database 11g Release 1 (11.1). This support is documented in Oracle Multimedia DICOM Developer's Guide.

For Existing Applications That Use the DICOM Support in ORDImage Objects

Migrate from the DICOM support in ORDImage objects that was introduced in Oracle Database 10g Release 2 (10.2) to the DICOM support that was introduced in Oracle Database 11g Release 1 (11.1). See Oracle Multimedia DICOM Developer's Guide for instructions on migrating from Oracle Database 10g Release 2 (10.2) DICOM support.

See Also:

J.3.2 Deprecated ORDImage Methods

These ORDImage methods, which are described in this appendix, are deprecated in this release:

Note:

For complete information about these deprecated methods, see Oracle Multimedia Reference and Oracle Multimedia User's Guide in the Oracle Database Online Documentation Library for 11g Release 1 (11.1).

getDicomMetadata( )

Format

getDicomMetadata(optionString IN VARCHAR2) RETURN XMLType;

Description

Returns an XML representation of the metadata extracted from the DICOM image stored in the ORDImage object.

See <ORACLE_HOME>/ord/xml/xsd/orddcmim.xsd for information about the XML schema for DICOM.

Parameters

optionString

A string that specifies the type of DICOM metadata to extract. For this release, the only valid value is imageGeneral. All other values are ignored.

Usage Notes

The DICOM standard defines many sets of rules for encoding a DICOM object in a binary stream.

For more information about DICOM encoding rules, see the DICOM standard, which is available on the Web site for the National Electrical Manufacturers Association (NEMA) at

http://medical.nema.org/dicom/2003.html

Pragmas

None.

Exceptions

ORDImageExceptions.NULL_LOCAL_DATA

This exception is raised when source.localData is NULL.

ORDImageExceptions.NULL_SOURCE

This exception is raised when the value of the ORDImage.source attribute is NULL.

See Section G.3 for more information about these exceptions.

Examples

None.

getDicomMetadata( ) for BFILEs

Format

getDicomMetadata(imageBfile IN BFILE, optionString IN VARCHAR2) RETURN XMLType;

Description

Returns an XML representation of the metadata extracted from the DICOM image stored in the BFILE.

See <ORACLE_HOME>/ord/xml/xsd/orddcmim.xsd for information about the XML schema for DICOM.

Parameters

imageBfile

The DICOM image data represented as a BFILE.

optionString

A string that specifies the type of DICOM metadata to extract. For this release, the only valid value is imageGeneral. All other values are ignored.

Usage Notes

The DICOM standard defines many sets of rules for encoding a DICOM object in a binary stream.

For more information about DICOM encoding rules, see the DICOM standard, which is available on the Web site for the National Electrical Manufacturers Association (NEMA) at

http://medical.nema.org/dicom/2003.html

Pragmas

None.

Exceptions

ORDImageExceptions.NULL_CONTENT

This exception is raised when the image is NULL.

See Section G.3 for more information about this exception.

Examples

None.

getDicomMetadata( ) for BLOBs

Format

getDicomMetadata(imageBlob IN BLOB, optionString IN VARCHAR2) RETURN XMLType;

Description

Returns an XML representation of the metadata extracted from the DICOM image stored in the BLOB.

See <ORACLE_HOME>/ord/xml/xsd/orddcmim.xsd for information about the XML schema for DICOM.

Parameters

imageBlob

The DICOM image data represented as a BLOB.

optionString

A string that specifies the type of DICOM metadata to extract. For this release, the only valid value is imageGeneral. All other values are ignored.

Usage Notes

The DICOM standard defines many sets of rules for encoding a DICOM object in a binary stream.

For more information about DICOM encoding rules, see the DICOM standard, which is available on the Web site for the National Electrical Manufacturers Association (NEMA) at

http://medical.nema.org/dicom/2003.html

Pragmas

None.

Exceptions

ORDImageExceptions.NULL_CONTENT

This exception is raised when the image is NULL.

See Section G.3 for more information about this exception.

Examples

None.