DicomImage‑klass

Summary: This Class implements Digital Imaging and Communications in Medicine
(DICOM) raster image format support and offers a comprehensive solution for
processing DICOM images with precision and flexibility. You can seamlessly
manipulate image pages, including operations to get, add, or remove pages, and
control the default and active pages. With capabilities to work with alpha channels,
embed XMP metadata, resize, rotate, crop, binarize, adjust, apply filters,
and convert to other raster formats. This API empowers developers to handle
DICOM images effectively while meeting diverse application requirements in
medical imaging contexts.

Module: aspose.imaging.fileformats.dicom

Full Name: aspose.imaging.fileformats.dicom.DicomImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, IMultipageImage, IMultipageImageExt, RasterCachedMultipageImage

Constructors

NameDescription
DicomImage(dicom_options, width, height)Initiera en ny instans av DicomImage‑klassen utan ansträngning med denna
konstruktor, som använder dicomOptions‑parametrar. Perfekt för utvecklare som vill
dyka ner i DicomImage objekt snabbt och effektivt i sina projekt.
DicomImage(stream)Skapa en ny instans av DicomImage‑klassen genom att använda en ström‑parameter
i denna konstruktor. Perfekt för utvecklare som söker ett förenklat sätt att initiera
DicomImage objekt från befintliga datastreams i sina projekt.
DicomImage(stream, load_options)Initiera en ny instans av DicomImage‑klassen smidigt genom att använda en ström och
loadOptions‑parametrar i denna konstruktor. Idealiskt för utvecklare som snabbt vill börja
arbeta med DicomImage objekt omedelbart och effektivt i sina projekt.

Properties

NameTypeAccessDescription
active_pageDicomPager/wHantera den aktiva sidan i bilden med denna intuitiva egenskap. Idealiskt för utvecklare
som vill dynamiskt växla mellan sidor i flersidiga bilder, vilket säkerställer effektiv
navigering och bearbetning.
active_page_indexintrHämta indexet för den aktiva sidan utan ansträngning med denna intuitiva egenskap.
Idealiskt för utvecklare som söker snabb åtkomst till det aktuella sidindexet i flersidiga
bilder, vilket säkerställer effektiv navigering och bearbetning.
auto_adjust_paletteboolr/wHämtar eller anger ett värde som indikerar om automatisk justering av palett.
background_colorColorr/wHämtar eller anger ett värde för bakgrundsfärgen.
bits_per_pixelintrHämtar bildens bitar per pixel.
boundsRectanglerHämtar objektets gränser.
buffer_size_hintintr/wHämtar eller anger en ledtråd för buffertstorlek som definierar maximal tillåten storlek för alla interna buffertar.
containerImagerHämtar Image behållaren.
data_stream_containerStreamContainerrHämtar objektets datastream.
dicom_pagesDicomPage[]rÅtkomst till bildens sidor med denna intuitiva egenskap. Idealisk för utvecklare
som vill interagera med enskilda sidor i bilden, vilket säkerställer sömlös
navigering och manipulation.
disposedboolrHämtar ett värde som indikerar om den här instansen är frigjord.
exif_dataExifDatar/wHämtar eller anger Exif-instans.
file_formatFileFormatrHämta filformatvärdet enkelt med denna intuitiva egenskap. Idealisk för
utvecklare som söker snabb åtkomst till formatet för bildfilen, vilket säkerställer effektiv
hantering och bearbetning baserat på filtypen.
file_infoDicomImageInforHämta värdefull headerinformation från DICOM-filen enkelt med denna
intuitiva egenskap. Idealisk för utvecklare som söker snabb åtkomst till väsentliga detaljer
som är inbäddade i DICOM-filen, vilket säkerställer effektiv dataextraktion och analys.
has_alphaboolrHämta om bilden har en alfa-kanal enkelt med denna intuitiva
egenskap. Idealisk för utvecklare som vill avgöra om bilden innehåller transparens
information, vilket säkerställer exakt hantering av alfa-kanaldatan i bildbehandlingsuppgifter.
has_background_colorboolr/wHämtar eller anger ett värde som indikerar om bilden har bakgrundsfärg.
has_transparent_colorboolr/wHämtar ett värde som indikerar om bilden har en transparent färg.
heightintrHämtar bildens höjd.
horizontal_resolutionfloatr/wHämtar eller anger den horisontella upplösningen, i pixlar per tum, för denna RasterImage.
image_opacityfloatrHämtar opaciteten för denna bild.
interrupt_monitorInterruptMonitorr/wHämtar eller anger avbrottsövervakaren.
is_cachedboolrHämtar ett värde som indikerar om bilddata för närvarande är cachad.
is_raw_data_availableboolrHämtar ett värde som indikerar om inläsning av rådata stöds.
metadataImageMetadatarHämtar eller anger XMP-data från ramen.
page_countintrHämta det totala antalet sidor i bilden med denna intuitiva egenskap. Idealisk för
utvecklare som söker snabb åtkomst till antalet sidor i en bild, vilket säkerställer
effektiv navigering och hantering.
pagesImage[]rÅtkomst till bildens sidor med denna intuitiva egenskap. Idealisk för utvecklare
som vill interagera med enskilda sidor i bilden, vilket säkerställer sömlös navigering
och manipulation.
paletteIColorPaletter/wHämtar eller anger färgpaletten. Färgpaletten används inte när pixlar representeras direkt.
premultiply_componentsboolr/wHämtar eller anger ett värde som indikerar om bildkomponenterna måste förmultipliceras.
raw_custom_color_converterIColorConverterr/wHämtar eller anger den anpassade färgkonvertern
raw_data_formatPixelDataFormatrHämtar det råa dataformatet.
raw_data_settingsRawDataSettingsrHämtar de aktuella inställningarna för rådata. Observera att när dessa inställningar används laddas data utan konvertering.
raw_fallback_indexintr/wHämtar eller anger reservindexet som ska användas när palettindexet är utanför gränserna
raw_indexed_color_converterIIndexedColorConverterr/wHämtar eller anger den indexerade färgkonvertern
raw_line_sizeintrHämtar den råa radstorleken i byte.
sizeSizerHämtar objektets storlek.
transparent_colorColorr/wHämtar bildens transparenta färg.
update_xmp_databoolr/wHämtar eller anger ett värde som indikerar om XMP-metadata ska uppdateras.
use_paletteboolrHämtar ett värde som indikerar om bildpaletten används.
use_raw_databoolr/wHämtar eller anger ett värde som indikerar om rådatainläsning ska användas när rådatainläsning är tillgänglig.
vertical_resolutionfloatr/wHämtar eller anger den vertikala upplösningen, i pixlar per tum, för denna RasterImage.
widthintrHämtar bildens bredd.
xmp_dataXmpPacketWrapperr/wHämtar eller anger Xmp-data.

Methods

NameDescription
add_page()Lägg till en ny sida i slutet av bildens sidlista med denna enkla metod.
Perfekt för utvecklare som vill dynamiskt expandera flersidiga bilder och säkerställa sömlös
integration och organisering av bildinnehåll.
add_page(page)Utöka din bildsamling genom att lägga till en ny sida med denna intuitiva metod.
Perfekt för utvecklare som vill dynamiskt lägga till sidor till flersidiga bilder,
vilket säkerställer sömlös expansion och organisering av bildinnehåll.
adjust_brightness(brightness)Förbättra bildens luminans med justeringen av brightness, en
parametriserad metod som låter utvecklare finjustera bildens ljusstyrka.
Denna användarvänliga funktion ger utvecklare möjlighet att sömlöst manipulera bildens
ljusstyrka, vilket erbjuder flexibilitet och kontroll över den visuella estetiken.
adjust_contrast(contrast)Förbättra Image kontrast med denna användarvänliga metod,
som justerar skillnaden mellan ljusa och mörka områden. Förbättra den visuella klarheten och
definitionen utan ansträngning, och ge utvecklare intuitiv kontroll över
bildkontrast för optimal rendering.
adjust_gamma(gamma)Förbättra bildkvaliteten och justera den med gamma‑korrektion, en kraftfull teknik
för finjustering av det visuella utseendet. Perfekt för utvecklare som vill optimera bild‑presentation, justera färgbalansen och säkerställa konsekvent rendering på olika
enheter och miljöer.
adjust_gamma(gamma_red, gamma_green, gamma_blue)Uppnå precisa färgjusteringar genom att tillämpa gamma‑korrektion oberoende
på de röda, gröna och blå komponenterna i en bild. Denna metod säkerställer exakt
färgbalans och optimal visuell output, och riktar sig till utvecklare som söker detaljerad
kontroll över bildrendering och färgprecision.
analyze_percentage_digital_signature(password)Beräknar procentuell likhet mellan den extraherade datan och det ursprungliga lösenordet.
auto_brightness_contrast()Utför automatisk adaptiv ljusstyrke‑ och kontrastnormalisering för hela bilden.
auto_rotate()Rotera automatiskt bilden baserat på orienteringsdata som extraheras från Exif
metadata. Denna metod säkerställer att bilder visas i korrekt orientering,
förbättrar användarupplevelsen och eliminerar behovet av manuella justeringar. Genom
att analysera Exif‑information roteras bilden därefter, vilket ger en sömlös
visningsupplevelse på olika plattformar och enheter. Denna automatiserade rotationsprocess
förenklar bildhantering och förbättrar den övergripande användbarheten, särskilt när
man hanterar stora bildsatser med varierande orienteringar.
binarize_bradley(brightness_difference)Binarisering av en bild med Bradleys adaptiva tröskelalgoritm med hjälp av integral‑bildtröskling
binarize_bradley(brightness_difference, window_size)Binarisera bilder med Bradleys adaptiva tröskelalgoritm, utnyttjande av integral‑
bildtröskling för förbättrad prestanda. Idealisk för utvecklare som vill
automatiskt segmentera bilder baserat på lokala variationer i ljusstyrka, vilket säkerställer
exakt objektdetektion och extraktion under varierande ljusförhållanden.
binarize_fixed(threshold)Konvertera enkelt bilden till ett binärt format med ett fördefinierat tröskelvärde med denna enkla metod. Idealisk för utvecklare som vill förenkla bild‑bearbetningsuppgifter genom att segmentera bilden i förgrunds‑ och bakgrundskomponenter baserat på angivna intensitetsnivåer.
binarize_otsu()Använd Otsu‑tröskling för att binarisera bilden, med automatisk bestämning av det optimala
tröskelvärdet baserat på bildens histogram. Perfekt för utvecklare som söker
en pålitlig metod för att segmentera bilder i förgrunds‑ och bakgrundsområden med
minimal manuell inblandning.
blend(origin, overlay, overlay_alpha)Blandar denna bildinstans med overlay-bilden.
blend(origin, overlay, overlay_area, overlay_alpha)Blandar denna bildinstans med overlay-bilden.
cache_data()Denna metod cachar data effektivt, optimerar prestanda och säkerställer snabb åtkomst
vid behov. Idealisk för utvecklare som vill förbättra hastigheten och effektiviteten i sina
applikationer genom intelligent hantering av dataresurser.
can_load(file_path)Bestämmer om bilden kan läsas in från den angivna filsökvägen.
can_load(file_path, load_options)Bestämmer om bilden kan läsas in från den angivna filsökvägen och eventuellt med de angivna öppningsalternativen.
can_load(stream)Bestämmer om bilden kan läsas in från den angivna strömmen.
can_load(stream, load_options)Bestämmer om bilden kan läsas in från den angivna strömmen och eventuellt med de angivna loadOptions.
can_load_stream(stream)Bestämmer om bilden kan läsas in från den angivna strömmen.
can_load_stream_with_options(stream, load_options)Bestämmer om bilden kan läsas in från den angivna strömmen och eventuellt med de angivna loadOptions.
can_load_with_options(file_path, load_options)Bestämmer om bilden kan läsas in från den angivna filsökvägen och eventuellt med de angivna öppningsalternativen.
can_save(options)Bestämmer om bilden kan sparas till det angivna filformatet som representeras av de medföljande sparalternativen.
create(files)Skapar flersidig bild som innehåller de angivna filerna.
create(files, throw_exception_on_load_error)Skapar flersidig bild som innehåller de angivna filerna.
create(image_options, width, height)Skapar en ny bild med de angivna skapandealternativen.
create(image_options, width, height, pixels)Skapar en RasterImage‑instans från den angivna pixelarrayen.

Validerar att den angivna bredden och höjden matchar dimensionerna på pixeldata.
Denna metod kan endast användas när biblioteket är i licensierat läge.
create(images)Skapar en ny bild med de angivna bilderna som sidor
create(images, dispose_images)Skapar en ny bild från de angivna bilderna som sidor.
create(multipage_create_options)Skapar de angivna flersidiga skapalternativen.
create_from_files(files)Skapar den flersidiga bilden som innehåller de angivna filerna som sidor med fördröjd inläsning.
create_from_files(files, throw_exception_on_load_error)Skapar den flersidiga bilden som innehåller de angivna filerna som sidor med fördröjd inläsning.
create_from_images(images)Skapar en ny bild med de angivna bilderna som sidor
create_from_images(images, dispose_images)Skapar en ny bild från de angivna bilderna som sidor.
crop(left_shift, right_shift, top_shift, bottom_shift)Justera beskärningsområdet för bilden genom att tillämpa förskjutningar med denna mångsidiga metod.
Perfekt för utvecklare som behöver exakt kontroll över beskärningsprocessen, vilket säkerställer
att viktiga detaljer behålls samtidigt som onödiga element elimineras.
crop(rectangle)Beskär bilden för att ta bort oönskade områden och fokusera på väsentligt innehåll med denna
enkla metod. Idealisk för utvecklare som vill anpassa den visuella sammansättningen av
bilder, så att de förmedlar det önskade budskapet effektivt.
dither(dithering_method, bits_count)Utför dithering på den aktuella bilden.
dither(dithering_method, bits_count, custom_palette)Förbättra den aktuella bilden genom att applicera ditheringseffekter med denna enkla
metod. Perfekt för utvecklare som vill lägga till textur och djup i bilder,
vilket förbättrar deras visuella kvalitet och övergripande attraktionskraft.
embed_digital_signature(password)Bädda in digital signatur baserad på angivet lösenord i varje sida av bilden.
filter(rectangle, options)Förbättra enkelt specifika områden i din bild genom att applicera filter på utsedda
rektanglar. Denna metod ger utvecklare exakt kontroll över
bildmanipulation, vilket möjliggör riktade justeringar för att uppnå önskade
visuella effekter med lätthet.
get_argb_32_pixel(x, y)Hämtar en bildpixel i 32-bitars ARGB.
get_default_argb_32_pixels(rectangle)Hämtar standardarrayen för 32-bitars ARGB-pixlar.
get_default_options(args)Hämtar standardalternativen.
get_default_pixels(rectangle, partial_pixel_loader)Hämtar standardpixelarrayen med partiell pixel‑laddare.
get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)Hämtar standardarrayen för rådata med partiell pixel‑laddare.
get_default_raw_data(rectangle, raw_data_settings)Hämtar standardarrayen för rådata.
get_file_format(file_path)Hämtar filformatet.
get_file_format(stream)Hämtar filformatet.
get_file_format_of_stream(stream)Hämtar filformatet.
get_fitting_rectangle(rectangle, pixels, width, height)Hämtar rektangeln som passar den aktuella bilden.
get_fitting_rectangle(rectangle, width, height)Hämtar rektangeln som passar den aktuella bilden.
get_modify_date(use_default)Hämtar datum och tid då resursbilden senast ändrades.
get_original_options()Hämtar alternativen baserat på de ursprungliga filinställningarna.
Detta kan vara användbart för att behålla bitdjup och andra parametrar i den ursprungliga bilden oförändrade.
Till exempel, om vi laddar en svart‑vit PNG‑bild med 1 bit per pixel och sedan sparar den med hjälp av
DataStreamSupporter.save(file_path) metoden, kommer en PNG‑bild med 8‑bit per pixel att genereras.
För att undvika detta och spara PNG‑bilden med 1‑bit per pixel, använd denna metod för att hämta motsvarande sparalternativ och skicka dem
till Image.save(file_path, options) metoden som den andra parametern.
get_pixel(x, y)Hämtar en bildpixel.
get_proportional_height(width, height, new_width)Hämtar en proportionell höjd.
get_proportional_width(width, height, new_height)Hämtar en proportionell bredd.
get_serialized_stream(image_options, clipping_rectangle, page_number)Konverterar till aps.
get_skew_angle()Hämtar snedvinkeln.
Denna metod är tillämplig på skannade textdokument för att bestämma snedvinkeln vid skanning.
grayscale()Omvandla enkelt bilder till deras gråskalerepresentation, vilket förenklar visuell
analys och bearbetningsuppgifter. Perfekt för utvecklare som vill förbättra bildens klarhet,
minska komplexiteten och underlätta effektiva gråskalebaserade algoritmer
för olika tillämpningar.
insert_page(page_index)Infoga en ny sida i bildens sidlista på ett angivet index med denna intuitiva
metod. Idealisk för utvecklare som söker exakt kontroll över arrangemanget av sidor i
flersidiga bilder, vilket säkerställer sömlös organisering och anpassning av bildinnehåll.
is_digital_signed(password, percentage_threshold)Utför en snabb kontroll för att avgöra om bilden är digitalt signerad, med det angivna lösenordet och tröskelvärdet.
load(file_path)Läser in en ny bild från den angivna filsökvägen eller URL:en.
Om filePath är en filsökväg öppnar metoden bara filen.
Om filePath är en URL laddar metoden ner filen, sparar den som en temporär och öppnar den.
load(file_path, load_options)Läser in en ny bild från den angivna filsökvägen eller URL:en.
Om filePath är en filsökväg öppnar metoden bara filen.
Om filePath är en URL laddar metoden ner filen, sparar den som en temporär och öppnar den.
load(stream)Läser in en ny bild från den angivna strömmen.
load(stream, load_options)Läser in en ny bild från den angivna strömmen.
load_argb_32_pixels(rectangle)Läser in 32-bitars ARGB‑pixlar.
load_argb_64_pixels(rectangle)Läser in 64-bitars ARGB‑pixlar.
load_cmyk_32_pixels(rectangle)Läser in pixlar i CMYK‑format.
load_cmyk_pixels(rectangle)Läser in pixlar i CMYK‑format.
Denna metod är föråldrad. Använd den mer effektiva RasterImage.load_cmyk_32_pixels(rectangle) metoden.
load_partial_argb_32_pixels(rectangle, partial_pixel_loader)Läser in 32-bitars ARGB‑pixlar delvis (i block).
load_partial_argb_64_pixels(rectangle, partial_pixel_loader)Läser in 64-bitars ARGB‑pixlar delvis i paket.
load_partial_pixels(desired_rectangle, pixel_loader)Läser in pixlar delvis i paket.
load_pixels(rectangle)Läser in pixlar.
load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)Läser in rådata.
load_raw_data(rectangle, raw_data_settings, raw_data_loader)Läser in rådata.
load_stream(stream)Läser in en ny bild från den angivna strömmen.
load_stream_with_options(stream, load_options)Läser in en ny bild från den angivna strömmen.
load_with_options(file_path, load_options)Läser in en ny bild från den angivna filsökvägen eller URL:en.
Om filePath är en filsökväg öppnar metoden bara filen.
Om filePath är en URL laddar metoden ner filen, sparar den som en temporär och öppnar den.
normalize_angle()Normaliserar vinkeln.
Denna metod är tillämplig på skannade textdokument för att bli av med snedvriden skanning.
Metoden använder RasterImage.get_skew_angle() och RasterImage.rotate(angle) metoder.
normalize_angle(resize_proportionally, background_color)Normaliserar vinkeln.
Denna metod är tillämplig på skannade textdokument för att bli av med snedvriden skanning.
Metoden använder RasterImage.get_skew_angle() och RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color) metoder.
normalize_histogram()Normaliserar bildens histogram — justera pixelvärden för att använda hela tillgängliga intervallet.
read_argb_32_scan_line(scan_line_index)Läser hela skanningsraden enligt det angivna skanningsradindexet.
read_scan_line(scan_line_index)Läser hela skanningsraden enligt det angivna skanningsradindexet.
remove_metadata()Tar bort metadata för denna bildinstans genom att sätta detta IHasXmpData.xmp_data värde till None.
remove_page(page_index)Ta bort sidan på det angivna indexet från sidlistan med denna praktiska metod.
Idealisk för utvecklare som söker exakt kontroll över hanteringen av flersidiga bilder,
vilket säkerställer sömlös organisering och anpassning av bildinnehåll.
replace_argb(old_color_argb, old_color_diff, new_color_argb)Ersätter en färg med en annan med tillåten skillnad och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.
replace_color(old_color, old_color_diff, new_color)Ersätter en färg med en annan med tillåten skillnad och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.
replace_color(old_color_argb, old_color_diff, new_color_argb)Ersätter en färg med en annan med tillåten skillnad och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.
replace_non_transparent_colors(new_color)Ersätter alla icke‑transparenta färger med en ny färg och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.
Obs: om du använder den på bilder utan transparens, kommer alla färger att ersättas med en enda.
replace_non_transparent_colors(new_color_argb)Ersätter alla icke‑transparenta färger med en ny färg och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.
Obs: om du använder den på bilder utan transparens, kommer alla färger att ersättas med en enda.
resize(new_width, new_height)Ändrar bildens storlek. Standardvärdet ResizeType.NEAREST_NEIGHBOUR_RESAMPLE används.
resize(new_width, new_height, resize_type)Ändra bildens storlek samtidigt som bildförhållandet bevaras med denna praktiska metod. Idealisk
för utvecklare som vill justera bildens dimensioner proportionellt, vilket säkerställer
konsistens och bevarar originalinnehållets proportioner.
Den proportionella storleksändringen kommer att ändra varje ram enligt förhållandet newWidth/width och newHeight/height.
resize(new_width, new_height, settings)Justera storleken på din bild med denna enkla storleksändringsmetod. Oavsett om du behöver
minska eller förstora din bild, säkerställer denna funktion att dina storleksändringsbehov uppfylls
effektivt och exakt, vilket gör den perfekt för utvecklare som söker snabba och enkla
bildstorleksjusteringar.
resize_by_settings(new_width, new_height, settings)Ändrar storlek på bilden.
resize_by_type(new_width, new_height, resize_type)Ändrar storlek på bilden.
resize_height_proportionally(new_height)Ändrar höjden proportionellt. Standardvärdet ResizeType.NEAREST_NEIGHBOUR_RESAMPLE används.
resize_height_proportionally(new_height, resize_type)Justera bildens höjd samtidigt som du behåller dess bildförhållande med denna
användarvänliga metod. Perfekt för utvecklare som vill dynamiskt ändra storlek på bilder
samtidigt som de bevarar deras proportioner, vilket säkerställer optimal visning och användbarhet
i deras applikationer.
resize_height_proportionally(new_height, settings)Ändrar höjden proportionellt.
resize_height_proportionally_settings(new_height, settings)Ändrar höjden proportionellt.
resize_proportional(new_width, new_height, resize_type)Ändra bildens storlek samtidigt som bildförhållandet bevaras med denna praktiska metod. Idealisk
för utvecklare som vill justera bildens dimensioner proportionellt, vilket säkerställer
konsistens och bevarar originalinnehållets proportioner.
Den proportionella storleksändringen kommer att ändra varje ram enligt förhållandet newWidth/width och newHeight/height.
resize_width_proportionally(new_width)Ändrar bredden proportionellt. Standardvärdet ResizeType.NEAREST_NEIGHBOUR_RESAMPLE används.
resize_width_proportionally(new_width, resize_type)Justera bildens bredd samtidigt som du behåller dess bildförhållande med denna praktiska
metod. Idealisk för utvecklare som vill ändra storlek på bilder proportionellt, vilket säkerställer
konsekventa och visuellt tilltalande resultat över olika visningsmiljöer.
resize_width_proportionally(new_width, settings)Ändrar bredden proportionellt.
resize_width_proportionally_settings(new_width, settings)Ändrar bredden proportionellt.
rotate(angle)Rotera bilden kring centrum.
rotate(angle, resize_proportionally, background_color)Rotera bilden kring dess centrum med denna praktiska metod. Idealisk för utvecklare
som vill justera bildens orientering dynamiskt, vilket säkerställer optimal presentation och
justering i deras applikationer.
rotate_flip(rotate_flip_type)Manipulera enkelt den aktiva ramen genom att rotera, vända eller utföra båda åtgärderna
samtidigt med denna enkla metod. Idealisk för utvecklare som behöver
dynamiskt justera orienteringen av specifika ramar i sina bildsekvenser,
vilket säkerställer optimal presentation och justering.
rotate_flip_all(rotate_flip)Roterar alla flip.
save()Sparar bilddata till den underliggande strömmen.
save(file_path)Sparar bilden till den angivna filsökvägen.
save(file_path, options)Bevara objektets data genom att spara det till den angivna filen (indexer + filnamn)
plats tillsammans med specificerat filformat och alternativ. Idealisk för utvecklare som vill
säkert lagra data i olika format samtidigt som de behåller flexibilitet och kontroll över
sparparametrar.
save(file_path, options, bounds_rectangle)Sparar objektets data till den angivna filsökvägen i det specificerade filformatet enligt sparalternativ.
save(file_path, over_write)Sparar objektets data till den angivna filsökvägen.
save(stream)Sparar data.
save(stream, options_base)Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.
save(stream, options_base, bounds_rectangle)Spara enkelt dina bilddata till en specificerad ström i önskat filformat
med hjälp av denna praktiska metod. Oavsett om du arbetar med JPEG, PNG eller ett annat format,
säkerställer denna funktion att dina bilddata sparas effektivt och exakt,
vilket gör den idealisk för utvecklare som vill förenkla sina fil‑sparprocesser.
save_all(file_path, options)Bevara objektets data genom att spara det till den angivna filen (indexer + filnamn)
plats tillsammans med specificerat filformat och alternativ. Idealisk för utvecklare som vill
säkert lagra data i olika format samtidigt som de behåller flexibilitet och kontroll över
sparparametrar.
save_argb_32_pixels(rectangle, pixels)Sparar de 32‑bitars ARGB‑pixlarna.
save_cmyk_32_pixels(rectangle, pixels)Sparar pixlarna.
save_cmyk_pixels(rectangle, pixels)Sparar pixlarna.
Denna metod är föråldrad. Använd den mer effektiva RasterImage.save_cmyk_32_pixels(rectangle, pixels) metoden.
save_pixels(rectangle, pixels)Sparar pixlar (formatspecifik metod).
save_raw_data(data, data_offset, rectangle, raw_data_settings)Sparar rådata.
save_to_stream(stream)Sparar objektets data till den angivna strömmen.
save_to_stream_with_options(stream, options_base)Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.
save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.
save_with_options(file_path, options)Sparar objektets data till den angivna filsökvägen i det specificerade filformatet enligt sparalternativ.
save_with_options_rect(file_path, options, bounds_rectangle)Sparar objektets data till den angivna filsökvägen i det specificerade filformatet enligt sparalternativ.
set_argb_32_pixel(x, y, argb_32_color)Ställer in en bildpixel i 32-bit ARGB för den angivna positionen.
set_palette(palette, update_colors)Ställer in bildpaletten.
set_pixel(x, y, color)Ställer in en bildpixel för den angivna positionen.
set_resolution(dpi_x, dpi_y)Justera upplösningen för denna RasterImage med precision genom att använda denna
enkla metod. Idealisk för utvecklare som vill anpassa bildens upplösning till
specifika krav, vilket säkerställer optimal visningskvalitet och filstorlekshantering.
try_set_metadata(metadata)Försöker sätta en metadata-instans, om detta Image-instans stödjer och implementerar IImageMetadataFormat-instansen.
write_argb_32_scan_line(scan_line_index, argb_32_pixels)Skriver hela skanningsraden till det angivna skanningsradindexet.
write_scan_line(scan_line_index, pixels)Skriver hela skanningsraden till det angivna skanningsradindexet.

Constructor: DicomImage(dicom_options, width, height)

 DicomImage(dicom_options, width, height) 

Initiera en ny instans av DicomImage‑klassen utan ansträngning med denna
konstruktor, som använder dicomOptions‑parametrar. Perfekt för utvecklare som vill
dyka ner i DicomImage objekt snabbt och effektivt i sina projekt.

Parameters:

ParameterTypBeskrivning
dicom_optionsDicomOptionsDICOM-alternativen.
widthintBredden.
heightintHöjden.

Constructor: DicomImage(stream)

 DicomImage(stream) 

Skapa en ny instans av DicomImage‑klassen genom att använda en ström‑parameter
i denna konstruktor. Perfekt för utvecklare som söker ett förenklat sätt att initiera
DicomImage objekt från befintliga datastreams i sina projekt.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen.

See also:

Example # 1: This example shows how to load a DICOM image from a file stream.

Constructor: DicomImage(stream, load_options)

 DicomImage(stream, load_options) 

Initiera en ny instans av DicomImage‑klassen smidigt genom att använda en ström och
loadOptions‑parametrar i denna konstruktor. Idealiskt för utvecklare som snabbt vill börja
arbeta med DicomImage objekt omedelbart och effektivt i sina projekt.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen.
load_optionsLoadOptionsLaddningsalternativen.

See also:

Example # 1: This example shows how to load a DICOM image from a file stream to stay withi…

Method: add_page()

 add_page() 

Lägg till en ny sida i slutet av bildens sidlista med denna enkla metod.
Perfekt för utvecklare som vill dynamiskt expandera flersidiga bilder och säkerställa sömlös
integration och organisering av bildinnehåll.

Returns

TypBeskrivning
DicomPageDen nyss skapade DicomPage.

Method: add_page(page)

 add_page(page) 

Utöka din bildsamling genom att lägga till en ny sida med denna intuitiva metod.
Perfekt för utvecklare som vill dynamiskt lägga till sidor till flersidiga bilder,
vilket säkerställer sömlös expansion och organisering av bildinnehåll.

Parameters:

ParameterTypBeskrivning
pageRasterImageSidan att lägga till.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

Förbättra bildens luminans med justeringen av brightness, en
parametriserad metod som låter utvecklare finjustera bildens ljusstyrka.
Denna användarvänliga funktion ger utvecklare möjlighet att sömlöst manipulera bildens
ljusstyrka, vilket erbjuder flexibilitet och kontroll över den visuella estetiken.

Parameters:

ParameterTypBeskrivning
ljusstyrkaintLjusstyrkevärde.

See also:

Example # 1: The following example performs brightness correction of a DICOM image.

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

Förbättra Image kontrast med denna användarvänliga metod,
som justerar skillnaden mellan ljusa och mörka områden. Förbättra den visuella klarheten och
definitionen utan ansträngning, och ge utvecklare intuitiv kontroll över
bildkontrast för optimal rendering.

Parameters:

ParameterTypBeskrivning
kontrastfloatKontrastvärde (i intervallet [-100; 100])

See also:

Example # 1: The following example performs contrast correction of a DICOM image.

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

Förbättra bildkvaliteten och justera den med gamma‑korrektion, en kraftfull teknik
för finjustering av det visuella utseendet. Perfekt för utvecklare som vill optimera bild‑presentation, justera färgbalansen och säkerställa konsekvent rendering på olika
enheter och miljöer.

Parameters:

ParameterTypBeskrivning
gammafloatGamma för röd, grön och blå kanalers koefficient

See also:

Example # 1: The following example performs gamma-correction of a DICOM image.

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

Uppnå precisa färgjusteringar genom att tillämpa gamma‑korrektion oberoende
på de röda, gröna och blå komponenterna i en bild. Denna metod säkerställer exakt
färgbalans och optimal visuell output, och riktar sig till utvecklare som söker detaljerad
kontroll över bildrendering och färgprecision.

Parameters:

ParameterTypBeskrivning
gamma_redfloatGamma för röd kanal koefficient
gamma_greenfloatGamma för grön kanal koefficient
gamma_bluefloatGamma för blå kanalkoefficient

See also:

Example # 1: The following example performs gamma-correction of a DICOM image applying dif…

Method: analyze_percentage_digital_signature(password)

 analyze_percentage_digital_signature(password) 

Beräknar procentuell likhet mellan den extraherade datan och det ursprungliga lösenordet.

Parameters:

ParameterTypBeskrivning
passwordstringLösenordet som används för att extrahera den inbäddade datan.

Returns

TypBeskrivning
intProcentuell likhetsvärde.

Method: binarize_bradley(brightness_difference)

 binarize_bradley(brightness_difference) 

Binarisering av en bild med Bradleys adaptiva tröskelalgoritm med hjälp av integral‑bildtröskling

Parameters:

ParameterTypBeskrivning
brightness_differencefloatLjusstyrkeskillnaden mellan pixeln och medelvärdet av ett s x s fönster av pixlar
centrerat kring denna pixel.

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size) 

Binarisera bilder med Bradleys adaptiva tröskelalgoritm, utnyttjande av integral‑
bildtröskling för förbättrad prestanda. Idealisk för utvecklare som vill
automatiskt segmentera bilder baserat på lokala variationer i ljusstyrka, vilket säkerställer
exakt objektdetektion och extraktion under varierande ljusförhållanden.

Parameters:

ParameterTypBeskrivning
brightness_differencefloatLjusstyrkeskillnaden mellan pixeln och medelvärdet av ett s x s fönster av pixlar
centrerat kring denna pixel.
window_sizeintStorleken på ett s x s fönster av pixlar centrerat kring denna pixel

See also:

Example # 1: The following example binarizes a DICOM image with Bradley’s adaptive thresho…

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

Konvertera enkelt bilden till ett binärt format med ett fördefinierat tröskelvärde med denna enkla metod. Idealisk för utvecklare som vill förenkla bild‑bearbetningsuppgifter genom att segmentera bilden i förgrunds‑ och bakgrundskomponenter baserat på angivna intensitetsnivåer.

Parameters:

ParameterTypBeskrivning
tröskelvärdeSystem.ByteTröskelvärde. Om motsvarande gråvärde för en pixel är större än tröskeln, tilldelas ett värde av
255 till den, annars 0.

See also:

Example # 1: The following example binarizes a DICOM image with the predefined threshold. …

Method: blend(origin, overlay, overlay_alpha)

 blend(origin, overlay, overlay_alpha) 

Blandar denna bildinstans med overlay-bilden.

Parameters:

ParameterTypBeskrivning
originPointBakgrundsbildens blandningsursprung.
overlayRasterImageÖverlagringsbilden.
overlay_alphaSystem.ByteAlfa för överlagring.

Method: blend(origin, overlay, overlay_area, overlay_alpha)

 blend(origin, overlay, overlay_area, overlay_alpha) 

Blandar denna bildinstans med overlay-bilden.

Parameters:

ParameterTypBeskrivning
originPointBakgrundsbildens blandningsursprung.
overlayRasterImageÖverlagringsbilden.
overlay_areaRectangleÖverlagringsområdet.
overlay_alphaSystem.ByteAlfa för överlagring.

Method: can_load(file_path) [static]

 can_load(file_path) 

Bestämmer om bilden kan läsas in från den angivna filsökvägen.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.

Returns

TypBeskrivning
booltrue om bilden kan laddas från den angivna filen; annars false.

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

Bestämmer om bilden kan läsas in från den angivna filsökvägen och eventuellt med de angivna öppningsalternativen.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
booltrue om bilden kan laddas från den angivna filen; annars false.

Method: can_load(stream) [static]

 can_load(stream) 

Bestämmer om bilden kan läsas in från den angivna strömmen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att läsa från.

Returns

TypBeskrivning
booltrue om bilden kan laddas från den angivna strömmen; annars false.

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

Bestämmer om bilden kan läsas in från den angivna strömmen och eventuellt med de angivna loadOptions.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att läsa från.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
booltrue om bilden kan laddas från den angivna strömmen; annars false.

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

Bestämmer om bilden kan läsas in från den angivna strömmen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att läsa från.

Returns

TypBeskrivning
booltrue om bilden kan laddas från den angivna strömmen; annars false.

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

Bestämmer om bilden kan läsas in från den angivna strömmen och eventuellt med de angivna loadOptions.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att läsa från.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
booltrue om bilden kan laddas från den angivna strömmen; annars false.

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

Bestämmer om bilden kan läsas in från den angivna filsökvägen och eventuellt med de angivna öppningsalternativen.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
booltrue om bilden kan laddas från den angivna filen; annars false.

Method: can_save(options)

 can_save(options) 

Bestämmer om bilden kan sparas till det angivna filformatet som representeras av de medföljande sparalternativen.

Parameters:

ParameterTypBeskrivning
optionsImageOptionsBaseSparaalternativen att använda.

Returns

TypBeskrivning
booltrue om bilden kan sparas till det angivna filformatet som representeras av de överförda sparaalternativen; annars false.

Method: create(files) [static]

 create(files) 

Skapar flersidig bild som innehåller de angivna filerna.

Parameters:

ParameterTypBeskrivning
filesstring[]Filerna.

Returns

TypBeskrivning
ImageDen flersidiga bilden

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error) 

Skapar flersidig bild som innehåller de angivna filerna.

Parameters:

ParameterTypBeskrivning
filesstring[]Filerna.
throw_exception_on_load_errorboolom den är inställd på true [throw exception on load error].

Returns

TypBeskrivning
ImageDen flersidiga bilden

Method: create(image_options, width, height) [static]

 create(image_options, width, height) 

Skapar en ny bild med de angivna skapandealternativen.

Parameters:

ParameterTypBeskrivning
image_optionsImageOptionsBaseBildalternativen.
widthintBredden.
heightintHöjden.

Returns

TypBeskrivning
ImageDen nyss skapade bilden.

Method: create(image_options, width, height, pixels) [static]

 create(image_options, width, height, pixels) 

Skapar en RasterImage‑instans från den angivna pixelarrayen.

Validerar att den angivna bredden och höjden matchar dimensionerna på pixeldata.
Denna metod kan endast användas när biblioteket är i licensierat läge.

Parameters:

ParameterTypBeskrivning
image_optionsImageOptionsBaseAlternativen som används för att skapa RasterImage.
widthintBredden på RasterImage.
heightintHöjden på RasterImage.
pixlarint[]Arrayen med pixelvärden som används för att fylla bilden.

Returns

TypBeskrivning
ImageEn RasterImage som är fylld med den angivna pixeldata.

Method: create(images) [static]

 create(images) 

Skapar en ny bild med de angivna bilderna som sidor

Parameters:

ParameterTypBeskrivning
imagesImage[]Bilderna.

Returns

TypBeskrivning
ImageBilden som IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

Skapar en ny bild från de angivna bilderna som sidor.

Parameters:

ParameterTypBeskrivning
imagesImage[]Bilderna.
dispose_imagesboolom den är inställd på true [dispose images].

Returns

TypBeskrivning
ImageBilden som IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

Skapar de angivna flersidiga skapalternativen.

Parameters:

ParameterTypBeskrivning
multipage_create_optionsMultipageCreateOptionsAlternativen för att skapa flersidiga bilder.

Returns

TypBeskrivning
ImageDen flersidiga bilden

Method: create_from_files(files) [static]

 create_from_files(files) 

Skapar den flersidiga bilden som innehåller de angivna filerna som sidor med fördröjd inläsning.

Parameters:

ParameterTypBeskrivning
filesstring[]Filerna.

Returns

TypBeskrivning
ImageDen flersidiga bilden

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error) 

Skapar den flersidiga bilden som innehåller de angivna filerna som sidor med fördröjd inläsning.

Parameters:

ParameterTypBeskrivning
filesstring[]Filerna.
throw_exception_on_load_errorboolom den är inställd på true kasta undantag vid inläsningsfel.

Returns

TypBeskrivning
ImageDen flersidiga bilden

Method: create_from_images(images) [static]

 create_from_images(images) 

Skapar en ny bild med de angivna bilderna som sidor

Parameters:

ParameterTypBeskrivning
imagesImage[]Bilderna.

Returns

TypBeskrivning
ImageBilden som IMultipageImage

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

Skapar en ny bild från de angivna bilderna som sidor.

Parameters:

ParameterTypBeskrivning
imagesImage[]Bilderna.
dispose_imagesboolom den är inställd på true [dispose images].

Returns

TypBeskrivning
ImageBilden som IMultipageImage

Method: crop(left_shift, right_shift, top_shift, bottom_shift)

 crop(left_shift, right_shift, top_shift, bottom_shift) 

Justera beskärningsområdet för bilden genom att tillämpa förskjutningar med denna mångsidiga metod.
Perfekt för utvecklare som behöver exakt kontroll över beskärningsprocessen, vilket säkerställer
att viktiga detaljer behålls samtidigt som onödiga element elimineras.

Parameters:

ParameterTypBeskrivning
left_shiftintVänsterskiftet.
right_shiftintHögerskiftet.
top_shiftintÖversta skiftet.
bottom_shiftintNedersta skiftet.

See also:

Example # 1: The following example crops a DICOM image. The cropping area is specified via…

Method: crop(rectangle)

 crop(rectangle) 

Beskär bilden för att ta bort oönskade områden och fokusera på väsentligt innehåll med denna
enkla metod. Idealisk för utvecklare som vill anpassa den visuella sammansättningen av
bilder, så att de förmedlar det önskade budskapet effektivt.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln.

See also:

Example # 1: The following example crops a DICOM image. The cropping area is be specified …

Method: dither(dithering_method, bits_count)

 dither(dithering_method, bits_count) 

Utför dithering på den aktuella bilden.

Parameters:

ParameterTypBeskrivning
dithering_methodDitheringMethodDithermetoden.
bits_countintDet slutgiltiga bitantalet för dithering.

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette) 

Förbättra den aktuella bilden genom att applicera ditheringseffekter med denna enkla
metod. Perfekt för utvecklare som vill lägga till textur och djup i bilder,
vilket förbättrar deras visuella kvalitet och övergripande attraktionskraft.

Parameters:

ParameterTypBeskrivning
dithering_methodDitheringMethodDithermetoden.
bits_countintDet slutgiltiga bitantalet för dithering.
custom_paletteIColorPaletteDen anpassade paletten för dithering.

Method: embed_digital_signature(password)

 embed_digital_signature(password) 

Bädda in digital signatur baserad på angivet lösenord i varje sida av bilden.

Parameters:

ParameterTypBeskrivning
passwordstringLösenordet som används för att generera digitala signaturdata.

Method: filter(rectangle, options)

 filter(rectangle, options) 

Förbättra enkelt specifika områden i din bild genom att applicera filter på utsedda
rektanglar. Denna metod ger utvecklare exakt kontroll över
bildmanipulation, vilket möjliggör riktade justeringar för att uppnå önskade
visuella effekter med lätthet.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln.
optionsFilterOptionsBaseAlternativen.

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y) 

Hämtar en bildpixel i 32-bitars ARGB.

Parameters:

ParameterTypBeskrivning
xintPixelns x‑position.
yintPixelns y‑position.

Returns

TypBeskrivning
intDen 32‑bitars ARGB-pixeln för den angivna platsen.

Method: get_default_argb_32_pixels(rectangle)

 get_default_argb_32_pixels(rectangle) 

Hämtar standardarrayen för 32-bitars ARGB-pixlar.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln för att hämta pixlar.

Returns

TypBeskrivning
int[]Standardpixelarrayen.

Method: get_default_options(args)

 get_default_options(args) 

Hämtar standardalternativen.

Parameters:

ParameterTypBeskrivning
argsSystem.ObjectArgumenten.

Returns

TypBeskrivning
ImageOptionsBaseStandardalternativ

Method: get_default_pixels(rectangle, partial_pixel_loader)

 get_default_pixels(rectangle, partial_pixel_loader) 

Hämtar standardpixelarrayen med partiell pixel‑laddare.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln för att hämta pixlar.
partial_pixel_loaderIPartialArgb32PixelLoaderDen partiella pixel‑laddaren.

Method: get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)

 get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings) 

Hämtar standardarrayen för rådata med partiell pixel‑laddare.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln för att hämta pixlar.
partial_raw_data_loaderIPartialRawDataLoaderDen partiella rådata‑laddaren.
raw_data_settingsRawDataSettingsInställningarna för rådata.

Method: get_default_raw_data(rectangle, raw_data_settings)

 get_default_raw_data(rectangle, raw_data_settings) 

Hämtar standardarrayen för rådata.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln för att hämta rådata.
raw_data_settingsRawDataSettingsInställningarna för rådata.

Returns

TypBeskrivning
System.ByteStandardrådataarrayen.

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

Hämtar filformatet.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.

Returns

TypBeskrivning
FileFormatDet bestämda filformatet.

Method: get_file_format(stream) [static]

 get_file_format(stream) 

Hämtar filformatet.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen.

Returns

TypBeskrivning
FileFormatDet bestämda filformatet.

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

Hämtar filformatet.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen.

Returns

TypBeskrivning
FileFormatDet bestämda filformatet.

Method: get_fitting_rectangle(rectangle, pixels, width, height) [static]

 get_fitting_rectangle(rectangle, pixels, width, height) 

Hämtar rektangeln som passar den aktuella bilden.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln för att hämta en passande rektangel.
pixlarint[]De 32-bitars ARGB-pixlarna.
widthintObjektets bredd.
heightintObjektets höjd.

Returns

TypBeskrivning
RectangleDen passande rektangeln eller ett undantag om ingen passande rektangel kan hittas.

Method: get_fitting_rectangle(rectangle, width, height) [static]

 get_fitting_rectangle(rectangle, width, height) 

Hämtar rektangeln som passar den aktuella bilden.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln för att hämta en passande rektangel.
widthintObjektets bredd.
heightintObjektets höjd.

Returns

TypBeskrivning
RectangleDen passande rektangeln eller ett undantag om ingen passande rektangel kan hittas.

Method: get_modify_date(use_default)

 get_modify_date(use_default) 

Hämtar datum och tid då resursbilden senast ändrades.

Parameters:

ParameterTypBeskrivning
use_defaultboolOm den är satt till true används informationen från FileInfo som standardvärde.

Returns

TypBeskrivning
System.DateTimeDatumet och tiden då resursbilden senast ändrades.

Method: get_original_options()

 get_original_options() 

Hämtar alternativen baserat på de ursprungliga filinställningarna.
Detta kan vara användbart för att behålla bitdjup och andra parametrar i den ursprungliga bilden oförändrade.
Till exempel, om vi laddar en svart‑vit PNG‑bild med 1 bit per pixel och sedan sparar den med hjälp av
DataStreamSupporter.save(file_path) metoden, kommer en PNG‑bild med 8‑bit per pixel att genereras.
För att undvika detta och spara PNG‑bilden med 1‑bit per pixel, använd denna metod för att hämta motsvarande sparalternativ och skicka dem
till Image.save(file_path, options) metoden som den andra parametern.

Returns

TypBeskrivning
ImageOptionsBaseAlternativen baserade på de ursprungliga filinställningarna.

Method: get_pixel(x, y)

 get_pixel(x, y) 

Hämtar en bildpixel.

Parameters:

ParameterTypBeskrivning
xintPixelns x‑position.
yintPixelns y‑position.

Returns

TypBeskrivning
ColorPixelns färg för den angivna platsen.

Method: get_proportional_height(width, height, new_width) [static]

 get_proportional_height(width, height, new_width) 

Hämtar en proportionell höjd.

Parameters:

ParameterTypBeskrivning
widthintBredden.
heightintHöjden.
new_widthintDen nya bredden.

Returns

TypBeskrivning
intDen proportionella höjden.

Method: get_proportional_width(width, height, new_height) [static]

 get_proportional_width(width, height, new_height) 

Hämtar en proportionell bredd.

Parameters:

ParameterTypBeskrivning
widthintBredden.
heightintHöjden.
new_heightintDen nya höjden.

Returns

TypBeskrivning
intDen proportionella bredden.

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number) 

Konverterar till aps.

Parameters:

ParameterTypBeskrivning
image_optionsImageOptionsBaseBildalternativen.
clipping_rectangleRectangleKlippningsrektangeln.
page_numberint[]Sidnumret.

Returns

TypBeskrivning
_io.BufferedRandomDen serialiserade strömmen

Method: get_skew_angle()

 get_skew_angle() 

Hämtar snedvinkeln.
Denna metod är tillämplig på skannade textdokument för att bestämma snedvinkeln vid skanning.

Returns

TypBeskrivning
floatSnedvinkeln, i grader.

Method: insert_page(page_index)

 insert_page(page_index) 

Infoga en ny sida i bildens sidlista på ett angivet index med denna intuitiva
metod. Idealisk för utvecklare som söker exakt kontroll över arrangemanget av sidor i
flersidiga bilder, vilket säkerställer sömlös organisering och anpassning av bildinnehåll.

Parameters:

ParameterTypBeskrivning
page_indexintSidans index.

Returns

TypBeskrivning
DicomPageDen nyss skapade DicomPage.

Method: is_digital_signed(password, percentage_threshold)

 is_digital_signed(password, percentage_threshold) 

Utför en snabb kontroll för att avgöra om bilden är digitalt signerad, med det angivna lösenordet och tröskelvärdet.

Parameters:

ParameterTypBeskrivning
passwordstringLösenordet för att kontrollera signeringen.
percentage_thresholdintTröskelvärdet (i procent)[0-100] som avgör om bilden anses vara signerad.
Om det inte anges, kommer ett standardtröskelvärde (75) att tillämpas.

Returns

TypBeskrivning
boolSant om bilden är signerad, annars falskt.

Method: load(file_path) [static]

 load(file_path) 

Läser in en ny bild från den angivna filsökvägen eller URL:en.
Om filePath är en filsökväg öppnar metoden bara filen.
Om filePath är en URL laddar metoden ner filen, sparar den som en temporär och öppnar den.

Parameters:

ParameterTypBeskrivning
file_pathstringFilvägen eller URL:en att ladda bilden från.

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

Läser in en ny bild från den angivna filsökvägen eller URL:en.
Om filePath är en filsökväg öppnar metoden bara filen.
Om filePath är en URL laddar metoden ner filen, sparar den som en temporär och öppnar den.

Parameters:

ParameterTypBeskrivning
file_pathstringFilvägen eller URL:en att ladda bilden från.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load(stream) [static]

 load(stream) 

Läser in en ny bild från den angivna strömmen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att ladda bilden från.

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load(stream, load_options) [static]

 load(stream, load_options) 

Läser in en ny bild från den angivna strömmen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att ladda bilden från.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle) 

Läser in 32-bitars ARGB‑pixlar.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda pixlar från.

Returns

TypBeskrivning
int[]Den inlästa 32-bitars ARGB-pixelarrayen.

Method: load_argb_64_pixels(rectangle)

 load_argb_64_pixels(rectangle) 

Läser in 64-bitars ARGB‑pixlar.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda pixlar från.

Returns

TypBeskrivning
int[]Den laddade 64-bit ARGB-pixelarrayen.

Method: load_cmyk_32_pixels(rectangle)

 load_cmyk_32_pixels(rectangle) 

Läser in pixlar i CMYK‑format.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda pixlar från.

Returns

TypBeskrivning
int[]Den laddade CMYK-pixlarna presenteras som 32-bitars heltalsvärden.

Method: load_cmyk_pixels(rectangle)

 load_cmyk_pixels(rectangle) 

Läser in pixlar i CMYK‑format.
Denna metod är föråldrad. Använd den mer effektiva RasterImage.load_cmyk_32_pixels(rectangle) metoden.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda pixlar från.

Returns

TypBeskrivning
CmykColor[]Den laddade CMYK-pixelarrayen.

Method: load_partial_argb_32_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_32_pixels(rectangle, partial_pixel_loader) 

Läser in 32-bitars ARGB‑pixlar delvis (i block).

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda pixlar från.
partial_pixel_loaderIPartialArgb32PixelLoaderDen partiella pixel‑laddaren.

Method: load_partial_argb_64_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_64_pixels(rectangle, partial_pixel_loader) 

Läser in 64-bitars ARGB‑pixlar delvis i paket.

Parameters:

ParameterTypBeskrivning
rectangleRectangleDen önskade rektangeln.
partial_pixel_loaderIPartialArgb64PixelLoaderDen 64-bit ARGB-pixelinläsaren.

Method: load_partial_pixels(desired_rectangle, pixel_loader)

 load_partial_pixels(desired_rectangle, pixel_loader) 

Läser in pixlar delvis i paket.

Parameters:

ParameterTypBeskrivning
desired_rectangleRectangleDen önskade rektangeln.
pixel_loaderIPartialPixelLoaderPixelinläsaren.

Method: load_pixels(rectangle)

 load_pixels(rectangle) 

Läser in pixlar.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda pixlar från.

Returns

TypBeskrivning
Color[]Den laddade pixelarrayen.

Method: load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader) 

Läser in rådata.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda rådata från.
dest_image_boundsRectangleMålbildens gränser.
raw_data_settingsRawDataSettingsInställningarna för rådata att använda för laddade data. Observera att om data inte är i det angivna formatet kommer datakonvertering att utföras.
raw_data_loaderIPartialRawDataLoaderRådatainläsaren.

Method: load_raw_data(rectangle, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, raw_data_settings, raw_data_loader) 

Läser in rådata.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda rådata från.
raw_data_settingsRawDataSettingsInställningarna för rådata att använda för laddade data. Observera att om data inte är i det angivna formatet kommer datakonvertering att utföras.
raw_data_loaderIPartialRawDataLoaderRådatainläsaren.

Method: load_stream(stream) [static]

 load_stream(stream) 

Läser in en ny bild från den angivna strömmen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att ladda bilden från.

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load_stream_with_options(stream, load_options) [static]

 load_stream_with_options(stream, load_options) 

Läser in en ny bild från den angivna strömmen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att ladda bilden från.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options) 

Läser in en ny bild från den angivna filsökvägen eller URL:en.
Om filePath är en filsökväg öppnar metoden bara filen.
Om filePath är en URL laddar metoden ner filen, sparar den som en temporär och öppnar den.

Parameters:

ParameterTypBeskrivning
file_pathstringFilvägen eller URL:en att ladda bilden från.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: normalize_angle(resize_proportionally, background_color)

 normalize_angle(resize_proportionally, background_color) 

Normaliserar vinkeln.
Denna metod är tillämplig på skannade textdokument för att bli av med snedvriden skanning.
Metoden använder RasterImage.get_skew_angle() och RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color) metoder.

Parameters:

ParameterTypBeskrivning
resize_proportionallyboolOm den är inställd på true kommer bildens storlek att ändras enligt den roterade rektangelns (hörnpunkternas) projektioner, annars lämnas dimensionerna oförändrade och endast bildens innehåll roteras.
background_colorColorBakgrundens färg.

Method: read_argb_32_scan_line(scan_line_index)

 read_argb_32_scan_line(scan_line_index) 

Läser hela skanningsraden enligt det angivna skanningsradindexet.

Parameters:

ParameterTypBeskrivning
scan_line_indexintNollbaserat index för skanningslinjen.

Returns

TypBeskrivning
int[]Skanningslinjens 32-bit ARGB-färgvärdearray.

Method: read_scan_line(scan_line_index)

 read_scan_line(scan_line_index) 

Läser hela skanningsraden enligt det angivna skanningsradindexet.

Parameters:

ParameterTypBeskrivning
scan_line_indexintNollbaserat index för skanningslinjen.

Returns

TypBeskrivning
Color[]Skanningslinjens pixel-färgvärdearray.

Method: remove_page(page_index)

 remove_page(page_index) 

Ta bort sidan på det angivna indexet från sidlistan med denna praktiska metod.
Idealisk för utvecklare som söker exakt kontroll över hanteringen av flersidiga bilder,
vilket säkerställer sömlös organisering och anpassning av bildinnehåll.

Parameters:

ParameterTypBeskrivning
page_indexintSidans index.

Method: replace_argb(old_color_argb, old_color_diff, new_color_argb)

 replace_argb(old_color_argb, old_color_diff, new_color_argb) 

Ersätter en färg med en annan med tillåten skillnad och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.

Parameters:

ParameterTypBeskrivning
old_color_argbintGammalt färg-ARGB-värde att ersätta.
old_color_diffSystem.ByteTillåten skillnad i gammal färg för att kunna bredda den ersatta färgtonen.
new_color_argbintNytt färg-ARGB-värde att ersätta gammal färg med.

Method: replace_color(old_color, old_color_diff, new_color)

 replace_color(old_color, old_color_diff, new_color) 

Ersätter en färg med en annan med tillåten skillnad och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.

Parameters:

ParameterTypBeskrivning
old_colorColor
old_color_diffSystem.ByteTillåten skillnad i gammal färg för att kunna bredda den ersatta färgtonen.
new_colorColor

Method: replace_color(old_color_argb, old_color_diff, new_color_argb)

 replace_color(old_color_argb, old_color_diff, new_color_argb) 

Ersätter en färg med en annan med tillåten skillnad och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.

Parameters:

ParameterTypBeskrivning
old_color_argbintGammalt färg-ARGB-värde att ersätta.
old_color_diffSystem.ByteTillåten skillnad i gammal färg för att kunna bredda den ersatta färgtonen.
new_color_argbintNytt färg-ARGB-värde att ersätta gammal färg med.

Method: replace_non_transparent_colors(new_color)

 replace_non_transparent_colors(new_color) 

Ersätter alla icke‑transparenta färger med en ny färg och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.
Obs: om du använder den på bilder utan transparens, kommer alla färger att ersättas med en enda.

Parameters:

ParameterTypBeskrivning
new_colorColor

Method: replace_non_transparent_colors(new_color_argb)

 replace_non_transparent_colors(new_color_argb) 

Ersätter alla icke‑transparenta färger med en ny färg och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.
Obs: om du använder den på bilder utan transparens, kommer alla färger att ersättas med en enda.

Parameters:

ParameterTypBeskrivning
new_color_argbintNytt färg-ARGB-värde att ersätta icke-transparenta färger med.

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

Ändrar bildens storlek. Standardvärdet ResizeType.NEAREST_NEIGHBOUR_RESAMPLE används.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
new_heightintDen nya höjden.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

Ändra bildens storlek samtidigt som bildförhållandet bevaras med denna praktiska metod. Idealisk
för utvecklare som vill justera bildens dimensioner proportionellt, vilket säkerställer
konsistens och bevarar originalinnehållets proportioner.
Den proportionella storleksändringen kommer att ändra varje ram enligt förhållandet newWidth/width och newHeight/height.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
new_heightintDen nya höjden.
resize_typeResizeTypeResize-typen.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

Justera storleken på din bild med denna enkla storleksändringsmetod. Oavsett om du behöver
minska eller förstora din bild, säkerställer denna funktion att dina storleksändringsbehov uppfylls
effektivt och exakt, vilket gör den perfekt för utvecklare som söker snabba och enkla
bildstorleksjusteringar.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
new_heightintDen nya höjden.
settingsImageResizeSettingsResize-inställningarna.

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

Ändrar storlek på bilden.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
new_heightintDen nya höjden.
settingsImageResizeSettingsResize-inställningarna.

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type) 

Ändrar storlek på bilden.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
new_heightintDen nya höjden.
resize_typeResizeTypeResize-typen.

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height) 

Ändrar höjden proportionellt. Standardvärdet ResizeType.NEAREST_NEIGHBOUR_RESAMPLE används.

Parameters:

ParameterTypBeskrivning
new_heightintDen nya höjden.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

Justera bildens höjd samtidigt som du behåller dess bildförhållande med denna
användarvänliga metod. Perfekt för utvecklare som vill dynamiskt ändra storlek på bilder
samtidigt som de bevarar deras proportioner, vilket säkerställer optimal visning och användbarhet
i deras applikationer.

Parameters:

ParameterTypBeskrivning
new_heightintDen nya höjden.
resize_typeResizeTypeTyp av storleksändring.

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

Ändrar höjden proportionellt.

Parameters:

ParameterTypBeskrivning
new_heightintDen nya höjden.
settingsImageResizeSettingsInställningarna för bildstorleksändring.

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings) 

Ändrar höjden proportionellt.

Parameters:

ParameterTypBeskrivning
new_heightintDen nya höjden.
settingsImageResizeSettingsInställningarna för bildstorleksändring.

Method: resize_proportional(new_width, new_height, resize_type)

 resize_proportional(new_width, new_height, resize_type) 

Ändra bildens storlek samtidigt som bildförhållandet bevaras med denna praktiska metod. Idealisk
för utvecklare som vill justera bildens dimensioner proportionellt, vilket säkerställer
konsistens och bevarar originalinnehållets proportioner.
Den proportionella storleksändringen kommer att ändra varje ram enligt förhållandet newWidth/width och newHeight/height.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
new_heightintDen nya höjden.
resize_typeResizeTypeResize-typen.

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

Ändrar bredden proportionellt. Standardvärdet ResizeType.NEAREST_NEIGHBOUR_RESAMPLE används.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

Justera bildens bredd samtidigt som du behåller dess bildförhållande med denna praktiska
metod. Idealisk för utvecklare som vill ändra storlek på bilder proportionellt, vilket säkerställer
konsekventa och visuellt tilltalande resultat över olika visningsmiljöer.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
resize_typeResizeTypeTyp av storleksändring.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

Ändrar bredden proportionellt.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
settingsImageResizeSettingsInställningarna för bildstorleksändring.

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

Ändrar bredden proportionellt.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
settingsImageResizeSettingsInställningarna för bildstorleksändring.

Method: rotate(angle)

 rotate(angle) 

Rotera bilden kring centrum.

Parameters:

ParameterTypBeskrivning
vinkelfloatRotationsvinkeln i grader. Positiva värden roterar medurs.

Method: rotate(angle, resize_proportionally, background_color)

 rotate(angle, resize_proportionally, background_color) 

Rotera bilden kring dess centrum med denna praktiska metod. Idealisk för utvecklare
som vill justera bildens orientering dynamiskt, vilket säkerställer optimal presentation och
justering i deras applikationer.

Parameters:

ParameterTypBeskrivning
vinkelfloatRotationsvinkeln i grader. Positiva värden roterar medurs.
resize_proportionallyboolom den är satt till true kommer bildens storlek att ändras
enligt den roterade rektangelns (hörnpunkternas) projektioner i annat
fall lämnas dimensionerna orörda och endast
internal bildinnehåll roteras.
background_colorColorBakgrundens färg.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

Manipulera enkelt den aktiva ramen genom att rotera, vända eller utföra båda åtgärderna
samtidigt med denna enkla metod. Idealisk för utvecklare som behöver
dynamiskt justera orienteringen av specifika ramar i sina bildsekvenser,
vilket säkerställer optimal presentation och justering.

Parameters:

ParameterTypBeskrivning
rotate_flip_typeRotateFlipTypeRotationsvändningstypen.

See also:

Example # 1: This example loads a DICOM image, rotates it by 90 degrees clockwise and opti…

Method: rotate_flip_all(rotate_flip)

 rotate_flip_all(rotate_flip) 

Roterar alla flip.

Parameters:

ParameterTypBeskrivning
rotate_flipRotateFlipTypeRotationsvändning.

Method: save(file_path)

 save(file_path) 

Sparar bilden till den angivna filsökvägen.

Parameters:

ParameterTypBeskrivning
file_pathstringFilvägen för att spara bilden till.

Method: save(file_path, options)

 save(file_path, options) 

Bevara objektets data genom att spara det till den angivna filen (indexer + filnamn)
plats tillsammans med specificerat filformat och alternativ. Idealisk för utvecklare som vill
säkert lagra data i olika format samtidigt som de behåller flexibilitet och kontroll över
sparparametrar.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
optionsImageOptionsBaseAlternativen.

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle) 

Sparar objektets data till den angivna filsökvägen i det specificerade filformatet enligt sparalternativ.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
optionsImageOptionsBaseAlternativen.
bounds_rectangleRectangleMålbildernas avgränsningsrektangel. Ställ in den tomma rektangeln för att använda källans avgränsning.

Method: save(file_path, over_write)

 save(file_path, over_write) 

Sparar objektets data till den angivna filsökvägen.

Parameters:

ParameterTypBeskrivning
file_pathstringFilvägen för att spara objektets data till.
over_writeboolom den är satt till true skriv över filinnehållet, annars kommer data att läggas till.

Method: save(stream)

 save(stream) 

Sparar data.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att spara data till.

Method: save(stream, options_base)

 save(stream, options_base) 

Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att spara bildens data till.
options_baseImageOptionsBaseSparalternativen.

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

Spara enkelt dina bilddata till en specificerad ström i önskat filformat
med hjälp av denna praktiska metod. Oavsett om du arbetar med JPEG, PNG eller ett annat format,
säkerställer denna funktion att dina bilddata sparas effektivt och exakt,
vilket gör den idealisk för utvecklare som vill förenkla sina fil‑sparprocesser.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att spara bildens data till.
options_baseImageOptionsBaseSparalternativen.
bounds_rectangleRectangleMålbildernas avgränsningsrektangel. Ställ in den tomma rektangeln för att använda källans avgränsning.

See also:

Example # 1: The following example loads a DICOM image from a file, then saves the image t…

Method: save_all(file_path, options)

 save_all(file_path, options) 

Bevara objektets data genom att spara det till den angivna filen (indexer + filnamn)
plats tillsammans med specificerat filformat och alternativ. Idealisk för utvecklare som vill
säkert lagra data i olika format samtidigt som de behåller flexibilitet och kontroll över
sparparametrar.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
optionsImageOptionsBaseAlternativen.

Method: save_argb_32_pixels(rectangle, pixels)

 save_argb_32_pixels(rectangle, pixels) 

Sparar de 32‑bitars ARGB‑pixlarna.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att spara pixlar till.
pixlarint[]32-bitars ARGB-pixelarrayen.

Method: save_cmyk_32_pixels(rectangle, pixels)

 save_cmyk_32_pixels(rectangle, pixels) 

Sparar pixlarna.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att spara pixlar till.
pixlarint[]CMYK-pixlar presenterade som 32-bitars heltalsvärden.

Method: save_cmyk_pixels(rectangle, pixels)

 save_cmyk_pixels(rectangle, pixels) 

Sparar pixlarna.
Denna metod är föråldrad. Använd den mer effektiva RasterImage.save_cmyk_32_pixels(rectangle, pixels) metoden.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att spara pixlar till.
pixelsCmykColor[]CMYK-pixelarrayen.

Method: save_pixels(rectangle, pixels)

 save_pixels(rectangle, pixels) 

Sparar pixlar (formatspecifik metod).

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att spara pixlar till.
pixelsColor[]Pixelarrayen.

Method: save_raw_data(data, data_offset, rectangle, raw_data_settings)

 save_raw_data(data, data_offset, rectangle, raw_data_settings) 

Sparar rådata.

Parameters:

ParameterTypBeskrivning
dataSystem.ByteRådata.
data_offsetintStartoffset för rådata.
rectangleRectangleRådatarektangeln.
raw_data_settingsRawDataSettingsRådatainställningarna som datan är i.

Method: save_to_stream(stream)

 save_to_stream(stream) 

Sparar objektets data till den angivna strömmen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att spara objektets data till.

Method: save_to_stream_with_options(stream, options_base)

 save_to_stream_with_options(stream, options_base) 

Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att spara bildens data till.
options_baseImageOptionsBaseSparalternativen.

Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

 save_to_stream_with_options_rect(stream, options_base, bounds_rectangle) 

Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att spara bildens data till.
options_baseImageOptionsBaseSparalternativen.
bounds_rectangleRectangleMålbildens avgränsningsrektangel. Ställ in den tomma rektangeln för att använda källans avgränsningar.

Method: save_with_options(file_path, options)

 save_with_options(file_path, options) 

Sparar objektets data till den angivna filsökvägen i det specificerade filformatet enligt sparalternativ.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
optionsImageOptionsBaseAlternativen.

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle) 

Sparar objektets data till den angivna filsökvägen i det specificerade filformatet enligt sparalternativ.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
optionsImageOptionsBaseAlternativen.
bounds_rectangleRectangleMålbildernas avgränsningsrektangel. Ställ in den tomma rektangeln för att använda källans avgränsning.

Method: set_argb_32_pixel(x, y, argb_32_color)

 set_argb_32_pixel(x, y, argb_32_color) 

Ställer in en bildpixel i 32-bit ARGB för den angivna positionen.

Parameters:

ParameterTypBeskrivning
xintPixelns x‑position.
yintPixelns y‑position.
argb_32_colorintDen 32-bitars ARGB-pixeln för den angivna positionen.

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

Ställer in bildpaletten.

Parameters:

ParameterTypBeskrivning
paletteIColorPalettePaletten att ställa in.
update_colorsboolOm den är inställd på true kommer färgerna att uppdateras enligt den nya paletten; annars förblir färgindex oförändrade. Observera att oförändrade index kan krascha bilden vid inläsning om vissa index saknar motsvarande palettposter.

Method: set_pixel(x, y, color)

 set_pixel(x, y, color) 

Ställer in en bildpixel för den angivna positionen.

Parameters:

ParameterTypBeskrivning
xintPixelns x‑position.
yintPixelns y‑position.
colorColorPixelns färg för den angivna positionen.

Method: set_resolution(dpi_x, dpi_y)

 set_resolution(dpi_x, dpi_y) 

Justera upplösningen för denna RasterImage med precision genom att använda denna
enkla metod. Idealisk för utvecklare som vill anpassa bildens upplösning till
specifika krav, vilket säkerställer optimal visningskvalitet och filstorlekshantering.

Parameters:

ParameterTypBeskrivning
dpi_xfloatDen horisontella upplösningen, i punkter per tum, för RasterImage.
dpi_yfloatDen vertikala upplösningen, i punkter per tum, för RasterImage.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

Försöker sätta en metadata-instans, om detta Image-instans stödjer och implementerar IImageMetadataFormat-instansen.

Parameters:

ParameterTypBeskrivning
metadataIImageMetadataFormatMetadata.

Returns

TypBeskrivning
boolSant om metadata inte är null och IMetadataContainer‑instansen
stöder och/eller implementerar IImageMetadataFormat‑instansen; annars falskt.

Method: write_argb_32_scan_line(scan_line_index, argb_32_pixels)

 write_argb_32_scan_line(scan_line_index, argb_32_pixels) 

Skriver hela skanningsraden till det angivna skanningsradindexet.

Parameters:

ParameterTypBeskrivning
scan_line_indexintNollbaserat index för skanningslinjen.
argb_32_pixelsint[]Den 32-bitars ARGB-färgarrayen att skriva.

Method: write_scan_line(scan_line_index, pixels)

 write_scan_line(scan_line_index, pixels) 

Skriver hela skanningsraden till det angivna skanningsradindexet.

Parameters:

ParameterTypBeskrivning
scan_line_indexintNollbaserat index för skanningslinjen.
pixelsColor[]Pixel‑färgarrayen att skriva.

Examples

This example shows how to load a DICOM image from a file stream.

from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_: str = "c:\\temp"
# Läs in en DICOM-bild från en filström.
with open(join(dir_, "sample.dicom"), "rb") as stream:
	with DicomImage(stream) as dicom_image:
		# Spara varje sida som en individuell PNG-bild.
		for dicom_page in dicom_image.dicom_pages:
			# Generera ett filnamn baserat på sidindexet.
			file_name = "sample.{0}.png".format(dicom_page.index)
			# En DICOM-sida är en rasterbild, så alla tillåtna operationer med en rasterbild är tillämpliga på en DICOM-sida.
			dicom_page.save(join(dir_, file_name), PngOptions())

This example shows how to load a DICOM image from a file stream to stay within the specified memory limit.

from aspose.imaging import LoadOptions, Image
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.dicom import DicomImage
from os.path import join as path_join


dir_: str = "c:\\temp"
# Läs in en DICOM-bild från en filström.
with open(path_join(dir_, "multiframe.dicom"), "rb") as stream:
	# Den maximalt tillåtna storleken för alla interna buffertar är 256 KB.
	load_options = LoadOptions()
	load_options.buffer_size_hint = 256 * 1024
	with DicomImage(stream, load_options) as dicom_image:
		# Spara varje sida som en individuell PNG-bild.
		for dicom_page in dicom_image.dicom_pages:
			# Generera ett filnamn baserat på sidindexet.
			file_name = "multiframe.{0}.png".format(dicom_page.index)
			# En DICOM-sida är en rasterbild, så alla tillåtna operationer med en rasterbild är tillämpliga på en DICOM-sida.
			dicom_page.save(path_join(dir_, file_name), PngOptions())

This example loads a DICOM image, rotates it by 90 degrees clockwise and optionally flips the image horizontally and(or) vertically.


from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image, RotateFlipType
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions

dir_: str = "c:\\temp"
rotate_flip_types = [RotateFlipType.ROTATE_90_FLIP_NONE, RotateFlipType.ROTATE_90_FLIP_X, RotateFlipType.ROTATE_90_FLIP_XY, RotateFlipType.ROTATE_90_FLIP_Y]
for rotate_flip_type in rotate_flip_types:
	# Rotera, vänd och spara till utdatafilen.
	with aspycore.as_of(Image.load(join(dir_, "sample.dicom")), DicomImage) as image:
		image.rotate_flip(rotate_flip_type)
		image.save(join(dir_, "sample." + rotate_flip_type + ".png"), PngOptions())

The following example loads a DICOM image from a file, then saves the image to a PNG file stream.


from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image, Rectangle
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions     

dir_: str = "c:\\temp"
with aspycore.as_of(Image.load(join(dir_, "sample.dicom")), DicomImage) as image:
	save_options = PngOptions()
	bounds = Rectangle(0, 0, image.width // 2, image.height // 2)
	with open(join(dir_, "output.png"), "wb") as output_stream:
		# Spara den övre vänstra kvarten av bilden till en filström.
		image.save(output_stream, save_options, bounds)

The following example crops a DICOM image. The cropping area is be specified via aspose.imaging.Rectangle.


from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image, Rectangle
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions    


dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.dicom")) as image:
	dicom_image = aspycore.as_of(image, DicomImage)
	# Beskär bilden. Beskärningsområdet är bildens rektangulära centrala område.
	area = Rectangle(dicom_image.width // 4, dicom_image.height // 4, dicom_image.width // 2, dicom_image.height // 2)
	dicom_image.crop(area)
	# Spara den beskurna bilden som PNG
	dicom_image.save(join(dir_, "sample.Crop.png"), PngOptions())

The following example crops a DICOM image. The cropping area is specified via Left, Top, Right, Bottom margins.

from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions

dir_: str = r"c:\temp"
with Image.load(join(dir_, "sample.dicom")) as image:
	dicom_image = aspycore.as_of(image, DicomImage)
	# Beskär igen. Ställ in en marginal på 10 % av bildens storlek.
	horizontal_margin = dicom_image.width // 10
	vertical_margin = dicom_image.height // 10
	dicom_image.crop(horizontal_margin, horizontal_margin, vertical_margin, vertical_margin)
	# Spara den beskurna bilden som PNG.
	dicom_image.save(join(dir_, "sample.Crop.png"), PngOptions())

The following example binarizes a DICOM image with the predefined threshold. Binarized images contain only 2 colors - black and white.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.dicom import DicomImage
from os.path import join

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.dicom")) as image:
	dicom_image = aspycore.as_of(image, DicomImage)
	# Binärisera bilden med ett tröskelvärde på 127.
	# Om ett motsvarande gråvärde för en pixel är större än 127, tilldelas värdet 255, annars 0.
	dicom_image.binarize_fixed(127)
	dicom_image.save(join(dir_, "sample.BinarizeFixed.png"), PngOptions())

The following example binarizes a DICOM image with Bradley’s adaptive thresholding algorithm with the specified window size. Binarized images contain only 2 colors - black and white.


from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.dicom")) as image:
	dicom_image = aspycore.as_of(image, DicomImage)
	# Binärisera bilden med en ljushetsdifferens på 5. Ljusheten är skillnaden mellan en pixel och medelvärdet av ett 10 × 10‑fönster av pixlar centrerat kring denna pixel.
	dicom_image.binarize_bradley(5, 10)
	dicom_image.save(join(dir_, "sample.BinarizeBradley5_10x10.png"), PngOptions())

The following example performs gamma-correction of a DICOM image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join


dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.dicom")) as image:
	dicom_image = aspycore.as_of(image, DicomImage)
	# Ställ in gamma‑koefficient för röd, grön och blå kanal.
	dicom_image.adjust_gamma(2.5)
	dicom_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

The following example performs gamma-correction of a DICOM image applying different coefficients for color components.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.dicom")) as image:
	dicom_image = aspycore.as_of(image, DicomImage)
	# Ställ in individuella gamma‑koefficienter för röd, grön och blå kanal.
	dicom_image.adjust_gamma(1.5, 2.5, 3.5)
	dicom_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

The following example performs brightness correction of a DICOM image.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.dicom")) as image:
	dicom_image = aspycore.as_of(image, DicomImage)
	# Ställ in ljushetsvärdet. Godkända värden för ljushet ligger i intervallet [-255, 255].
	dicom_image.adjust_brightness(50)
	dicom_image.save(join(dir_, "sample.AdjustBrightness.png"), PngOptions())

The following example performs contrast correction of a DICOM image.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.dicom")) as image:
	dicom_image = aspycore.as_of(image, DicomImage)
	# Ställ in kontrastvärdet. Godkända värden för kontrast ligger i intervallet [-100f, 100f].
	dicom_image.adjust_contrast(50.0)
	dicom_image.save(join(dir_, "sample.AdjustContrast.png"), PngOptions())

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)