DicomOptions Classe

Summary: The API for Digital Imaging and Communications in Medicine (DICOM) raster image
format creation is a specialized tool tailored for medical device applications.
It enables the seamless generation of DICOM images, crucial for storing medical
data and containing vital identification information. With features to
and set compression, define color types, and embed XMP metadata, developers
can ensure compliance and flexibility in managing DICOM images for medical
imaging purposes.

Module: aspose.imaging.imageoptions

Full Name: aspose.imaging.imageoptions.DicomOptions

Inheritance: IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, ImageOptionsBase

Constructors

NameDescription
DicomOptions()Initialise une nouvelle instance de la classe DicomOptions.

Properties

NameTypeAccessDescription
buffer_size_hintintr/wObtient ou définit l’indice de taille du tampon, qui correspond à la taille maximale autorisée pour tous les tampons internes.
color_typeColorTyper/wObtient ou définit le type de couleur.
compressionCompressionr/wObtient ou définit la compression.
libéréboolrObtient une valeur indiquant si cette instance est libérée.
exif_dataExifDatar/wObtient ou définit les données Exif.
full_frameboolr/wObtient ou définit une valeur indiquant si [full frame].
keep_metadataboolr/wObtient une valeur indiquant s’il faut conserver les métadonnées d’image originales lors de l’exportation.
multi_page_optionsMultiPageOptionsr/wLes options multipages
paletteIColorPaletter/wObtient ou définit la palette de couleurs.
resolution_settingsResolutionSettingr/wObtient ou définit les paramètres de résolution.
sourceSourcer/wObtient ou définit la source dans laquelle créer l’image.
vector_rasterization_optionsVectorRasterizationOptionsr/wObtient ou définit les options de rasterisation vectorielle.
xmp_dataXmpPacketWrapperr/wObtient ou définit le conteneur de métadonnées XMP.

Methods

NameDescription
clone()Crée un clone membre à membre de cette instance.
try_set_metadata(metadata)Essaie de définir une instance metadata, si cette instance Image prend en charge et implémente l’instance IImageMetadataFormat.

Constructor: DicomOptions()

 DicomOptions() 

Initialise une nouvelle instance de la classe DicomOptions.

Property: color_type

Obtient ou définit le type de couleur.

See also:

Example # 1: Use JPEG compression in DICOM image.

Example # 2: Use JPEG 2000 compression in DICOM image.

Example # 3: Use RLE compression in DICOM image.

Example # 4: Change the color type in DICOM compression.

Property: compression

Obtient ou définit la compression.

See also:

Example # 1: Use JPEG compression in DICOM image.

Example # 2: Use JPEG 2000 compression in DICOM image.

Example # 3: Use RLE compression in DICOM image.

Example # 4: Change the color type in DICOM compression.

Method: clone()

 clone() 

Crée un clone membre à membre de cette instance.

Returns

TypeDescription
ImageOptionsBaseUn clone membre à membre de cette instance.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

Essaie de définir une instance metadata, si cette instance Image prend en charge et implémente l’instance IImageMetadataFormat.

Parameters:

ParamètreTypeDescription
metadataIImageMetadataFormatLes métadonnées.

Returns

TypeDescription
boolVrai, si l’instance IMetadataContainer prend en charge et/ou implémente l’instance IImageMetadataFormat ; sinon, faux.

Examples

The following example shows export to DICOM file format (single and multipage).


from aspose.imaging import Image
from aspose.imaging.imageoptions import DicomOptions

fileName = "sample.jpg"
inputFileNameSingle = fileName
inputFileNameMultipage = "multipage.tif"
outputFileNameSingleDcm = "output.dcm"
outputFileNameMultipageDcm = "outputMultipage.dcm"

# L'exemple de code suivant convertit l'image JPEG au format de fichier DICOM
with Image.load(inputFileNameSingle) as image:
	image.save(outputFileNameSingleDcm, DicomOptions())

# Le format DICOM prend en charge les images multipages. Vous pouvez convertir des images GIF ou TIFF en DICOM de la même manière que les images JPEG.
with Image.load(inputFileNameMultipage) as image_multiple:
	image_multiple.save(outputFileNameMultipageDcm, DicomOptions())

Use JPEG compression in DICOM image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.imageoptions import JpegOptions, DicomOptions
from aspose.imaging.fileformats.jpeg import JpegCompressionMode, SampleRoundingMode
from aspose.imaging.imageoptions import DicomOptions
from aspose.imaging.fileformats.dicom import Compression, ColorType, CompressionType

with Image.load("original.jpg") as input_image:
	obj_init = JpegOptions()
	obj_init.compression_type = JpegCompressionMode.BASELINE
	obj_init.sample_rounding_mode = SampleRoundingMode.TRUNCATE
	obj_init.quality = 50
	obj_init2 = Compression()
	obj_init2.type = CompressionType.JPEG
	obj_init2.jpeg = obj_init
	options = DicomOptions()
	options.color_type = ColorType.RGB_24_BIT
	options.compression = obj_init2
	input_image.save("original_JPEG.dcm", options)

Use JPEG 2000 compression in DICOM image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.imageoptions import Jpeg2000Options, DicomOptions
from aspose.imaging.fileformats.jpeg2000 import Jpeg2000Codec, Compression, CompressionType, ColorType

with Image.load("original.jpg") as input_image:
	obj_init = Jpeg2000Options()
	obj_init.codec = Jpeg2000Codec.JP2
	obj_init.irreversible = False
	obj_init2 = Compression()
	obj_init2.type_ = CompressionType.JPEG2000
	obj_init2.jpeg2000 = obj_init
	options = DicomOptions()
	options.color_type = ColorType.RGB_24_BIT
	options.compression = obj_init2
	input_image.save("original_JPEG2000.dcm", options)

Use RLE compression in DICOM image.


from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import Compression, CompressionType, ColorType
from aspose.imaging.imageoptions import DicomOptions

with Image.load("original.jpg") as input_image:
	compr = Compression()
	compr.type_ = CompressionType.RLE
	options = DicomOptions()
	options.color_type = ColorType.RGB_24_BIT
	options.compression = compr
	input_image.save("original_RLE.dcm", options)

Change the color type in DICOM compression.


from aspose.imaging import Image
from aspose.imaging.imageoptions import DicomOptions
from aspose.imaging.fileformats.dicom import ColorType

with Image.load("original.jpg") as inputImage:
	options = DicomOptions()
	options.color_type = ColorType.GRAYSCALE_8_BIT
	inputImage.save("original_8Bit.dcm", options)