RasterImage‑klass

Summary: Represents a raster image supporting raster graphics operations.

Module: aspose.imaging

Full Name: aspose.imaging.RasterImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, Image

Properties

Name	Type	Access	Description
auto_adjust_palette	bool	r/w	Hämtar eller anger ett värde som indikerar om automatisk justering av palett.
background_color	Color	r/w	Hämtar eller anger ett värde för bakgrundsfärgen.
bits_per_pixel	int	r	Hämtar bildens bitar per pixel.
bounds	Rectangle	r	Hämtar bildens gränser.
buffer_size_hint	int	r/w	Hämtar eller anger en ledtråd för buffertstorlek som definierar maximal tillåten storlek för alla interna buffertar.
container	Image	r	Hämtar Image behållaren.
data_stream_container	StreamContainer	r	Hämtar objektets datastream.
disposed	bool	r	Hämtar ett värde som indikerar om den här instansen är frigjord.
exif_data	ExifData	r/w	Hämtar eller anger Exif-data.
file_format	FileFormat	r	Hämtar ett värde för filformatet
has_alpha	bool	r	Hämtar ett värde som indikerar om denna instans har alfa.
has_background_color	bool	r/w	Hämtar eller anger ett värde som indikerar om bilden har bakgrundsfärg.
has_transparent_color	bool	r/w	Hämtar eller anger ett värde som indikerar om denna RasterImage‑instans har en transparent färg.
height	int	r	Hämtar bildens höjd.
horizontal_resolution	float	r/w	Hämtar eller anger den horisontella upplösningen, i pixlar per tum, för denna RasterImage.
image_opacity	float	r	Hämtar opaciteten för denna bild.
interrupt_monitor	InterruptMonitor	r/w	Hämtar eller anger avbrottsövervakaren.
is_cached	bool	r	Hämtar ett värde som indikerar om objektets data för närvarande är cachad och ingen dataläsning krävs.
is_raw_data_available	bool	r	Hämtar ett värde som indikerar om rådatainläsning är tillgänglig.
metadata	ImageMetadata	r	Hämtar bildens metadata.
palette	IColorPalette	r/w	Hämtar eller anger färgpaletten. Färgpaletten används inte när pixlar representeras direkt.
premultiply_components	bool	r/w	Hämtar eller anger ett värde som indikerar om bildkomponenterna måste förmultipliceras.
raw_custom_color_converter	IColorConverter	r/w	Hämtar eller anger den anpassade färgkonvertern
raw_data_format	PixelDataFormat	r	Hämtar det råa dataformatet.
raw_data_settings	RawDataSettings	r	Hämtar de aktuella inställningarna för rådata. Observera att när dessa inställningar används laddas data utan konvertering.
raw_fallback_index	int	r/w	Hämtar eller anger reservindexet som ska användas när palettindexet är utanför gränserna
raw_indexed_color_converter	IIndexedColorConverter	r/w	Hämtar eller anger den indexerade färgkonvertern
raw_line_size	int	r	Hämtar den råa radstorleken i byte.
size	Size	r	Hämtar bildens storlek.
transparent_color	Color	r/w	Hämtar bildens transparenta färg.
update_xmp_data	bool	r/w	Hämtar eller anger ett värde som indikerar om XMP-metadata ska uppdateras.
use_palette	bool	r	Hämtar ett värde som indikerar om bildpaletten används.
use_raw_data	bool	r/w	Hämtar eller anger ett värde som indikerar om rådatainläsning ska användas när rådatainläsning är tillgänglig.
vertical_resolution	float	r/w	Hämtar eller anger den vertikala upplösningen, i pixlar per tum, för denna RasterImage.
width	int	r	Hämtar bildens bredd.
xmp_data	XmpPacketWrapper	r/w	Hämtar eller anger Xmp-data.

Methods

Name	Description
adjust_brightness(brightness)	Justering av ljushet för bilden.
adjust_contrast(contrast)	Bildkontrast
adjust_gamma(gamma)	Gammakorrigering av en bild.
adjust_gamma(gamma_red, gamma_green, gamma_blue)	Gammakorrigering av en bild.
analyze_percentage_digital_signature(password)	Beräknar procentuell likhet mellan den extraherade datan och det ursprungliga lösenordet.
auto_brightness_contrast()	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)	Binarisering av en bild med Bradleys adaptiva tröskelalgoritm med hjälp av integral‑bildtröskling
binarize_fixed(threshold)	Binärisering av en bild med fördefinierad tröskel
binarize_otsu()	Binärisering av en bild med Otsu-tröskelvärde
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()	Cachar data och säkerställer att ingen ytterligare dataladdning kommer att utföras från den underliggande DataStreamSupporter.data_stream_container.
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)	Beskär bild med förskjutningar.
crop(rectangle)	Beskär den angivna rektangeln.
dither(dithering_method, bits_count)	Utför dithering på den aktuella bilden.
dither(dithering_method, bits_count, custom_palette)	Utför dithering på den aktuella bilden.
embed_digital_signature(password)	Bädda in digital signatur baserad på angivet lösenord i bilden med hjälp av steganografi.
filter(rectangle, options)	Filtrerar den angivna rektangeln.
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()	Transformation av en bild till dess gråskalerepresentation
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)	Laddar 32-bitars ARGB-pixlar delvis i paket.
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 RasterImage.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.
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 original‑alfavä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 original‑alfavä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)	Ändrar storlek på bilden.
resize(new_width, new_height, settings)	Ändrar bildens storlek med utökade alternativ.
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)	Ändrar höjden proportionellt.
resize_height_proportionally(new_height, settings)	Ändrar höjden proportionellt.
resize_height_proportionally_settings(new_height, settings)	Ändrar höjden proportionellt.
resize_width_proportionally(new_width)	Ändrar bredden proportionellt. Standardvärdet ResizeType.NEAREST_NEIGHBOUR_RESAMPLE används.
resize_width_proportionally(new_width, resize_type)	Ändrar bredden proportionellt.
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 centrum.
rotate_flip(rotate_flip_type)	Rotera, vänd eller rotera och vänd bilden.
save()	Sparar bilddata till den underliggande strömmen.
save(file_path)	Sparar bilden till den angivna filsökvägen.
save(file_path, options)	Sparar objektets data till den angivna filsökvägen i det specificerade filformatet enligt sparalternativ.
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 objektets data till den angivna strömmen.
save(stream, options_base)	Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.
save(stream, options_base, bounds_rectangle)	Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.
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 pixlarna.
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)	Ställer in upplösningen för denna RasterImage.
try_set_metadata(metadata)	Försöker sätta en metadata-instans, om denna Image instans stöder och implementerar typen IImageMetadataFormat.
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.

Property: has_alpha

Hämtar ett värde som indikerar om denna instans har alfa.

See also:

Example # 1: The following example loads raster images and prints information about raw da…

Example # 2: The following example shows how to extract information about raw data format …

Property: premultiply_components

Hämtar eller anger ett värde som indikerar om bildkomponenterna måste förmultipliceras.

See also:

Example # 1: The following example creates a new raster image, saves the specified semi-tr…

Property: raw_data_format

Hämtar det råa dataformatet.

See also:

Example # 1: The following example loads raster images and prints information about raw da…

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

Justering av ljushet för bilden.

Parameters:

Parameter	Typ	Beskrivning
ljusstyrka	int	Ljusstyrkevärde.

See also:

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

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

Bildkontrast

Parameters:

Parameter	Typ	Beskrivning
kontrast	float	Kontrastvärde (i intervallet [-100; 100])

See also:

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

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

Gammakorrigering av en bild.

Parameters:

Parameter	Typ	Beskrivning
gamma	float	Gamma för röd, grön och blå kanalers koefficient

See also:

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

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

Gammakorrigering av en bild.

Parameters:

Parameter	Typ	Beskrivning
gamma_red	float	Gamma för röd kanal koefficient
gamma_green	float	Gamma för grön kanal koefficient
gamma_blue	float	Gamma för blå kanalkoefficient

See also:

Example # 1: The following example performs gamma-correction of an image applying differen…

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:

Parameter	Typ	Beskrivning
password	string	Lösenordet som används för att extrahera den inbäddade datan.

Returns

Typ	Beskrivning
int	Procentuell likhetsvärde.

See also:

Example # 1: The example illustrates how to determine the probability (from 0% to 100%) th…

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:

Parameter	Typ	Beskrivning
brightness_difference	float	Ljusstyrkeskillnaden mellan en pixel och medelvärdet av ett s × s‑fönster av pixlar centrerade kring denna pixel.

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size) 

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

Parameters:

Parameter	Typ	Beskrivning
brightness_difference	float	Ljusstyrkeskillnaden mellan en pixel och medelvärdet av ett s × s‑fönster av pixlar centrerade kring denna pixel.
window_size	int	Storleken på ett s x s fönster av pixlar centrerat kring denna pixel

See also:

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

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

Binärisering av en bild med fördefinierad tröskel

Parameters:

Parameter	Typ	Beskrivning
tröskelvärde	System.Byte	Tröskelvärde. Om motsvarande gråvärde för en pixel är större än tröskeln, tilldelas värdet 255, annars 0.

See also:

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

Method: blend(origin, overlay, overlay_alpha)

 blend(origin, overlay, overlay_alpha) 

Blandar denna bildinstans med overlay-bilden.

Parameters:

Parameter	Typ	Beskrivning
origin	Point	Bakgrundsbildens blandningsursprung.
overlay	RasterImage	Överlagringsbilden.
overlay_alpha	System.Byte	Alfa 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:

Parameter	Typ	Beskrivning
origin	Point	Bakgrundsbildens blandningsursprung.
overlay	RasterImage	Överlagringsbilden.
overlay_area	Rectangle	Överlagringsområdet.
overlay_alpha	System.Byte	Alfa 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:

Parameter	Typ	Beskrivning
file_path	string	Filsökvägen.

Returns

Typ	Beskrivning
bool	true 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:

Parameter	Typ	Beskrivning
file_path	string	Filsökvägen.
load_options	LoadOptions	Laddningsalternativen.

Returns

Typ	Beskrivning
bool	true 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:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strömmen att läsa från.

Returns

Typ	Beskrivning
bool	true 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:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strömmen att läsa från.
load_options	LoadOptions	Laddningsalternativen.

Returns

Typ	Beskrivning
bool	true 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:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strömmen att läsa från.

Returns

Typ	Beskrivning
bool	true 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:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strömmen att läsa från.
load_options	LoadOptions	Laddningsalternativen.

Returns

Typ	Beskrivning
bool	true 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:

Parameter	Typ	Beskrivning
file_path	string	Filsökvägen.
load_options	LoadOptions	Laddningsalternativen.

Returns

Typ	Beskrivning
bool	true 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:

Parameter	Typ	Beskrivning
options	ImageOptionsBase	Sparaalternativen att använda.

Returns

Typ	Beskrivning
bool	true 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:

Parameter	Typ	Beskrivning
files	string[]	Filerna.

Returns

Typ	Beskrivning
Image	Den 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:

Parameter	Typ	Beskrivning
files	string[]	Filerna.
throw_exception_on_load_error	bool	om den är inställd på true [throw exception on load error].

Returns

Typ	Beskrivning
Image	Den flersidiga bilden

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

 create(image_options, width, height) 

Skapar en ny bild med de angivna skapandealternativen.

Parameters:

Parameter	Typ	Beskrivning
image_options	ImageOptionsBase	Bildalternativen.
width	int	Bredden.
height	int	Höjden.

Returns

Typ	Beskrivning
Image	Den 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:

Parameter	Typ	Beskrivning
image_options	ImageOptionsBase	Alternativen som används för att skapa RasterImage.
width	int	Bredden på RasterImage.
height	int	Höjden på RasterImage.
pixlar	int[]	Arrayen med pixelvärden som används för att fylla bilden.

Returns

Typ	Beskrivning
Image	En 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:

Parameter	Typ	Beskrivning
images	Image[]	Bilderna.

Returns

Typ	Beskrivning
Image	Bilden som IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

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

Parameters:

Parameter	Typ	Beskrivning
images	Image[]	Bilderna.
dispose_images	bool	om den är inställd på true [dispose images].

Returns

Typ	Beskrivning
Image	Bilden som IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

Skapar de angivna flersidiga skapalternativen.

Parameters:

Parameter	Typ	Beskrivning
multipage_create_options	MultipageCreateOptions	Alternativen för att skapa flersidiga bilder.

Returns

Typ	Beskrivning
Image	Den 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:

Parameter	Typ	Beskrivning
files	string[]	Filerna.

Returns

Typ	Beskrivning
Image	Den 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:

Parameter	Typ	Beskrivning
files	string[]	Filerna.
throw_exception_on_load_error	bool	om den är inställd på true kasta undantag vid inläsningsfel.

Returns

Typ	Beskrivning
Image	Den flersidiga bilden

Method: create_from_images(images) [static]

 create_from_images(images) 

Skapar en ny bild med de angivna bilderna som sidor

Parameters:

Parameter	Typ	Beskrivning
images	Image[]	Bilderna.

Returns

Typ	Beskrivning
Image	Bilden 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:

Parameter	Typ	Beskrivning
images	Image[]	Bilderna.
dispose_images	bool	om den är inställd på true [dispose images].

Returns

Typ	Beskrivning
Image	Bilden som IMultipageImage

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

 crop(left_shift, right_shift, top_shift, bottom_shift) 

Beskär bild med förskjutningar.

Parameters:

Parameter	Typ	Beskrivning
left_shift	int	Vänsterskiftet.
right_shift	int	Högerskiftet.
top_shift	int	Översta skiftet.
bottom_shift	int	Nedersta skiftet.

See also:

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

Method: crop(rectangle)

 crop(rectangle) 

Beskär den angivna rektangeln.

Parameters:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln.

See also:

Example # 1: The following example crops a raster 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:

Parameter	Typ	Beskrivning
dithering_method	DitheringMethod	Dithermetoden.
bits_count	int	Det slutgiltiga bitantalet för dithering.

See also:

Example # 1: The following example loads a raster image and performs threshold and Floyd d…

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette) 

Utför dithering på den aktuella bilden.

Parameters:

Parameter	Typ	Beskrivning
dithering_method	DitheringMethod	Dithermetoden.
bits_count	int	Det slutgiltiga bitantalet för dithering.
custom_palette	IColorPalette	Den 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 bilden med hjälp av steganografi.

Parameters:

Parameter	Typ	Beskrivning
password	string	Lösenordet som används för att generera digitala signaturdata.

See also:

Example # 1: The example shows how to embed digital signature based on provided password i…

Method: filter(rectangle, options)

 filter(rectangle, options) 

Filtrerar den angivna rektangeln.

Parameters:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln.
options	FilterOptionsBase	Alternativen.

See also:

Example # 1: The following example applies various types of filters to a raster image.

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y) 

Hämtar en bildpixel i 32-bitars ARGB.

Parameters:

Parameter	Typ	Beskrivning
x	int	Pixelns x‑position.
y	int	Pixelns y‑position.

Returns

Typ	Beskrivning
int	Den 32‑bitars ARGB-pixeln för den angivna platsen.

See also:

Example # 1: The following example shows how image caching affects performance. In general…

Example # 2: The following example loads a raster image and obtains the color of an arbitr…

Method: get_default_argb_32_pixels(rectangle)

 get_default_argb_32_pixels(rectangle) 

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

Parameters:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln för att hämta pixlar.

Returns

Typ	Beskrivning
int[]	Standardpixelarrayen.

Method: get_default_options(args)

 get_default_options(args) 

Hämtar standardalternativen.

Parameters:

Parameter	Typ	Beskrivning
args	System.Object	Argumenten.

Returns

Typ	Beskrivning
ImageOptionsBase	Standardalternativ

Method: get_default_pixels(rectangle, partial_pixel_loader)

 get_default_pixels(rectangle, partial_pixel_loader) 

Hämtar standardpixelarrayen med partiell pixel‑laddare.

Parameters:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln för att hämta pixlar.
partial_pixel_loader	IPartialArgb32PixelLoader	Den 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:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln för att hämta pixlar.
partial_raw_data_loader	IPartialRawDataLoader	Den partiella rådata‑laddaren.
raw_data_settings	RawDataSettings	Instä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:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln för att hämta rådata.
raw_data_settings	RawDataSettings	Inställningarna för rådata.

Returns

Typ	Beskrivning
System.Byte	Standardrådataarrayen.

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

Hämtar filformatet.

Parameters:

Parameter	Typ	Beskrivning
file_path	string	Filsökvägen.

Returns

Typ	Beskrivning
FileFormat	Det bestämda filformatet.

Method: get_file_format(stream) [static]

 get_file_format(stream) 

Hämtar filformatet.

Parameters:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strömmen.

Returns

Typ	Beskrivning
FileFormat	Det bestämda filformatet.

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

Hämtar filformatet.

Parameters:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strömmen.

Returns

Typ	Beskrivning
FileFormat	Det 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:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln för att hämta en passande rektangel.
pixlar	int[]	De 32-bitars ARGB-pixlarna.
width	int	Objektets bredd.
height	int	Objektets höjd.

Returns

Typ	Beskrivning
Rectangle	Den 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:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln för att hämta en passande rektangel.
width	int	Objektets bredd.
height	int	Objektets höjd.

Returns

Typ	Beskrivning
Rectangle	Den 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:

Parameter	Typ	Beskrivning
use_default	bool	Om den är satt till true används informationen från FileInfo som standardvärde.

Returns

Typ	Beskrivning
System.DateTime	Datumet 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

Typ	Beskrivning
ImageOptionsBase	Alternativen baserade på de ursprungliga filinställningarna.

Method: get_pixel(x, y)

 get_pixel(x, y) 

Hämtar en bildpixel.

Parameters:

Parameter	Typ	Beskrivning
x	int	Pixelns x‑position.
y	int	Pixelns y‑position.

Returns

Typ	Beskrivning
Color	Pixelns färg för den angivna platsen.

See also:

Example # 1: The following example loads a raster image and obtains the color of an arbitr…

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

 get_proportional_height(width, height, new_width) 

Hämtar en proportionell höjd.

Parameters:

Parameter	Typ	Beskrivning
width	int	Bredden.
height	int	Höjden.
new_width	int	Den nya bredden.

Returns

Typ	Beskrivning
int	Den 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:

Parameter	Typ	Beskrivning
width	int	Bredden.
height	int	Höjden.
new_height	int	Den nya höjden.

Returns

Typ	Beskrivning
int	Den 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:

Parameter	Typ	Beskrivning
image_options	ImageOptionsBase	Bildalternativen.
clipping_rectangle	Rectangle	Klippningsrektangeln.
page_number	int[]	Sidnumret.

Returns

Typ	Beskrivning
_io.BufferedRandom	Den 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

Typ	Beskrivning
float	Snedvinkeln, i grader.

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:

Parameter	Typ	Beskrivning
password	string	Lösenordet för att kontrollera signeringen.
percentage_threshold	int	Trö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

Typ	Beskrivning
bool	Sant om bilden är signerad, annars falskt.

See also:

Example # 1: The example shows how to validate that the embedded digital signature matches…

Example # 2: The example demonstrates how to verify that the embedded digital signature ma…

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:

Parameter	Typ	Beskrivning
file_path	string	Filvägen eller URL:en att ladda bilden från.

Returns

Typ	Beskrivning
Image	Den 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:

Parameter	Typ	Beskrivning
file_path	string	Filvägen eller URL:en att ladda bilden från.
load_options	LoadOptions	Laddningsalternativen.

Returns

Typ	Beskrivning
Image	Den inlästa bilden.

Method: load(stream) [static]

 load(stream) 

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

Parameters:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strömmen att ladda bilden från.

Returns

Typ	Beskrivning
Image	Den 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:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strömmen att ladda bilden från.
load_options	LoadOptions	Laddningsalternativen.

Returns

Typ	Beskrivning
Image	Den inlästa bilden.

Method: load_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle) 

Läser in 32-bitars ARGB‑pixlar.

Parameters:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln att ladda pixlar från.

Returns

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

See also:

Example # 1: The following example shows how to load and process pixels of a raster image….

Method: load_argb_64_pixels(rectangle)

 load_argb_64_pixels(rectangle) 

Läser in 64-bitars ARGB‑pixlar.

Parameters:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln att ladda pixlar från.

Returns

Typ	Beskrivning
int[]	Den laddade 64-bit ARGB-pixelarrayen.

See also:

Example # 1: The following example shows how to load and process pixels of a raster image….

Method: load_cmyk_32_pixels(rectangle)

 load_cmyk_32_pixels(rectangle) 

Läser in pixlar i CMYK‑format.

Parameters:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln att ladda pixlar från.

Returns

Typ	Beskrivning
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:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln att ladda pixlar från.

Returns

Typ	Beskrivning
CmykColor[]	Den laddade CMYK-pixelarrayen.

Method: load_partial_argb_32_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_32_pixels(rectangle, partial_pixel_loader) 

Laddar 32-bitars ARGB-pixlar delvis i paket.

Parameters:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Den önskade rektangeln.
partial_pixel_loader	IPartialArgb32PixelLoader	Den 32-bitars ARGB-pixelinläsaren.

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:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Den önskade rektangeln.
partial_pixel_loader	IPartialArgb64PixelLoader	Den 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:

Parameter	Typ	Beskrivning
desired_rectangle	Rectangle	Den önskade rektangeln.
pixel_loader	IPartialPixelLoader	Pixelinläsaren.

Method: load_pixels(rectangle)

 load_pixels(rectangle) 

Läser in pixlar.

Parameters:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln att ladda pixlar från.

Returns

Typ	Beskrivning
Color[]	Den laddade pixelarrayen.

See also:

Example # 1: This example shows how to load a pixels information in an array of Color, man…

Example # 2: The following example shows how to load and process pixels of a raster image….

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:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln att ladda rådata från.
dest_image_bounds	Rectangle	Målbildens gränser.
raw_data_settings	RawDataSettings	Instä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_loader	IPartialRawDataLoader	Rå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:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln att ladda rådata från.
raw_data_settings	RawDataSettings	Instä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_loader	IPartialRawDataLoader	Rådatainläsaren.

Method: load_stream(stream) [static]

 load_stream(stream) 

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

Parameters:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strömmen att ladda bilden från.

Returns

Typ	Beskrivning
Image	Den 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:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strömmen att ladda bilden från.
load_options	LoadOptions	Laddningsalternativen.

Returns

Typ	Beskrivning
Image	Den 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:

Parameter	Typ	Beskrivning
file_path	string	Filvägen eller URL:en att ladda bilden från.
load_options	LoadOptions	Laddningsalternativen.

Returns

Typ	Beskrivning
Image	Den 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 RasterImage.rotate(angle, resize_proportionally, background_color) metoder.

Parameters:

Parameter	Typ	Beskrivning
resize_proportionally	bool	Om 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_color	Color	Bakgrundens färg.

See also:

Example # 1: Skew is an artifact that might appear during document scanning process when t…

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:

Parameter	Typ	Beskrivning
scan_line_index	int	Nollbaserat index för skanningslinjen.

Returns

Typ	Beskrivning
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:

Parameter	Typ	Beskrivning
scan_line_index	int	Nollbaserat index för skanningslinjen.

Returns

Typ	Beskrivning
Color[]	Skanningslinjens pixel-färgvärdearray.

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:

Parameter	Typ	Beskrivning
old_color_argb	int	Gammalt färg-ARGB-värde att ersätta.
old_color_diff	System.Byte	Tillåten skillnad i gammal färg för att kunna bredda den ersatta färgtonen.
new_color_argb	int	Nytt 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:

Parameter	Typ	Beskrivning
old_color	Color	Gammal färg att ersätta.
old_color_diff	System.Byte	Tillåten skillnad i gammal färg för att kunna bredda den ersatta färgtonen.
new_color	Color	Ny färg att ersätta den gamla färgen med.

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:

Parameter	Typ	Beskrivning
old_color_argb	int	Gammalt färg-ARGB-värde att ersätta.
old_color_diff	System.Byte	Tillåten skillnad i gammal färg för att kunna bredda den ersatta färgtonen.
new_color_argb	int	Nytt 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 original‑alfavä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:

Parameter	Typ	Beskrivning
new_color	Color	Ny färg att ersätta icke‑transparenta färger med.

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 original‑alfavä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:

Parameter	Typ	Beskrivning
new_color_argb	int	Nytt 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:

Parameter	Typ	Beskrivning
new_width	int	Den nya bredden.
new_height	int	Den nya höjden.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

Ändrar storlek på bilden.

Parameters:

Parameter	Typ	Beskrivning
new_width	int	Den nya bredden.
new_height	int	Den nya höjden.
resize_type	ResizeType	Resize-typen.

See also:

Example # 1: This example loads a raster image and resizes it using various resizing methods.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

Ändrar bildens storlek med utökade alternativ.

Parameters:

Parameter	Typ	Beskrivning
new_width	int	Den nya bredden.
new_height	int	Den nya höjden.
settings	ImageResizeSettings	Resize-inställningarna.

See also:

Example # 1: This example loads a raster image and resizes it using various resizing setti…

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

Ändrar storlek på bilden.

Parameters:

Parameter	Typ	Beskrivning
new_width	int	Den nya bredden.
new_height	int	Den nya höjden.
settings	ImageResizeSettings	Resize-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:

Parameter	Typ	Beskrivning
new_width	int	Den nya bredden.
new_height	int	Den nya höjden.
resize_type	ResizeType	Resize-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:

Parameter	Typ	Beskrivning
new_height	int	Den nya höjden.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

Ändrar höjden proportionellt.

Parameters:

Parameter	Typ	Beskrivning
new_height	int	Den nya höjden.
resize_type	ResizeType	Typ av storleksändring.

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

Ändrar höjden proportionellt.

Parameters:

Parameter	Typ	Beskrivning
new_height	int	Den nya höjden.
settings	ImageResizeSettings	Instä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:

Parameter	Typ	Beskrivning
new_height	int	Den nya höjden.
settings	ImageResizeSettings	Inställningarna för bildstorleksändring.

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

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

Parameters:

Parameter	Typ	Beskrivning
new_width	int	Den nya bredden.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

Ändrar bredden proportionellt.

Parameters:

Parameter	Typ	Beskrivning
new_width	int	Den nya bredden.
resize_type	ResizeType	Typ av storleksändring.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

Ändrar bredden proportionellt.

Parameters:

Parameter	Typ	Beskrivning
new_width	int	Den nya bredden.
settings	ImageResizeSettings	Inställningarna för bildstorleksändring.

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

Ändrar bredden proportionellt.

Parameters:

Parameter	Typ	Beskrivning
new_width	int	Den nya bredden.
settings	ImageResizeSettings	Inställningarna för bildstorleksändring.

Method: rotate(angle)

 rotate(angle) 

Rotera bilden kring centrum.

Parameters:

Parameter	Typ	Beskrivning
vinkel	float	Rotationsvinkeln i grader. Positiva värden roterar medurs.

Method: rotate(angle, resize_proportionally, background_color)

 rotate(angle, resize_proportionally, background_color) 

Rotera bilden kring centrum.

Parameters:

Parameter	Typ	Beskrivning
vinkel	float	Rotationsvinkeln i grader. Positiva värden roterar medurs.
resize_proportionally	bool	Om 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_color	Color	Bakgrundens färg.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

Rotera, vänd eller rotera och vänd bilden.

Parameters:

Parameter	Typ	Beskrivning
rotate_flip_type	RotateFlipType	Typ av rotate flip.

Method: save(file_path)

 save(file_path) 

Sparar bilden till den angivna filsökvägen.

Parameters:

Parameter	Typ	Beskrivning
file_path	string	Filvägen för att spara bilden till.

Method: save(file_path, options)

 save(file_path, options) 

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

Parameters:

Parameter	Typ	Beskrivning
file_path	string	Filsökvägen.
options	ImageOptionsBase	Alternativen.

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:

Parameter	Typ	Beskrivning
file_path	string	Filsökvägen.
options	ImageOptionsBase	Alternativen.
bounds_rectangle	Rectangle	Må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:

Parameter	Typ	Beskrivning
file_path	string	Filvägen för att spara objektets data till.
over_write	bool	om den är satt till true skriv över filinnehållet, annars kommer data att läggas till.

Method: save(stream)

 save(stream) 

Sparar objektets data till den angivna strömmen.

Parameters:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strömmen att spara objektets 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:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strömmen att spara bildens data till.
options_base	ImageOptionsBase	Sparalternativen.

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

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

Parameters:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strömmen att spara bildens data till.
options_base	ImageOptionsBase	Sparalternativen.
bounds_rectangle	Rectangle	Målbildens avgränsningsrektangel. Ställ in den tomma rektangeln för att använda källans avgränsningar.

Method: save_argb_32_pixels(rectangle, pixels)

 save_argb_32_pixels(rectangle, pixels) 

Sparar de 32‑bitars ARGB‑pixlarna.

Parameters:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln att spara pixlar till.
pixlar	int[]	32-bitars ARGB-pixelarrayen.

See also:

Example # 1: The following example fills the central area of a raster image with black pix…

Method: save_cmyk_32_pixels(rectangle, pixels)

 save_cmyk_32_pixels(rectangle, pixels) 

Sparar pixlarna.

Parameters:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln att spara pixlar till.
pixlar	int[]	CMYK-pixlar presenterade som 32-bitars heltalsvärden.

See also:

Example # 1: The following example fills the central area of a raster image with black pix…

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:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln att spara pixlar till.
pixels	CmykColor[]	CMYK-pixelarrayen.

Method: save_pixels(rectangle, pixels)

 save_pixels(rectangle, pixels) 

Sparar pixlarna.

Parameters:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln att spara pixlar till.
pixels	Color[]	Pixelarrayen.

See also:

Example # 1: This example shows how to load a pixels information in an array of Color, man…

Example # 2: The following example fills the central area of a raster image with black pix…

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:

Parameter	Typ	Beskrivning
data	System.Byte	Rådata.
data_offset	int	Startoffset för rådata.
rectangle	Rectangle	Rådatarektangeln.
raw_data_settings	RawDataSettings	Rådatainställningarna som datan är i.

Method: save_to_stream(stream)

 save_to_stream(stream) 

Sparar objektets data till den angivna strömmen.

Parameters:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strö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:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strömmen att spara bildens data till.
options_base	ImageOptionsBase	Sparalternativen.

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:

Parameter	Typ	Beskrivning
ström	_io.BufferedRandom	Strömmen att spara bildens data till.
options_base	ImageOptionsBase	Sparalternativen.
bounds_rectangle	Rectangle	Må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:

Parameter	Typ	Beskrivning
file_path	string	Filsökvägen.
options	ImageOptionsBase	Alternativen.

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:

Parameter	Typ	Beskrivning
file_path	string	Filsökvägen.
options	ImageOptionsBase	Alternativen.
bounds_rectangle	Rectangle	Må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:

Parameter	Typ	Beskrivning
x	int	Pixelns x‑position.
y	int	Pixelns y‑position.
argb_32_color	int	Den 32-bitars ARGB-pixeln för den angivna positionen.

See also:

Example # 1: The following example loads a raster image, and sets the color of an arbitrar…

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

Ställer in bildpaletten.

Parameters:

Parameter	Typ	Beskrivning
palette	IColorPalette	Paletten att ställa in.
update_colors	bool	Om 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:

Parameter	Typ	Beskrivning
x	int	Pixelns x‑position.
y	int	Pixelns y‑position.
color	Color	Pixelns färg för den angivna positionen.

See also:

Example # 1: The following example loads a raster image, and sets the color of an arbitrar…

Method: set_resolution(dpi_x, dpi_y)

 set_resolution(dpi_x, dpi_y) 

Ställer in upplösningen för denna RasterImage.

Parameters:

Parameter	Typ	Beskrivning
dpi_x	float	Den horisontella upplösningen, i punkter per tum, för RasterImage.
dpi_y	float	Den 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 denna Image instans stöder och implementerar typen IImageMetadataFormat.

Parameters:

Parameter	Typ	Beskrivning
metadata	IImageMetadataFormat	Metadata.

Returns

Typ	Beskrivning
bool	Sant, om Image instansen stöder och implementerar typen IImageMetadataFormat; 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:

Parameter	Typ	Beskrivning
scan_line_index	int	Nollbaserat index för skanningslinjen.
argb_32_pixels	int[]	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:

Parameter	Typ	Beskrivning
scan_line_index	int	Nollbaserat index för skanningslinjen.
pixels	Color[]	Pixel‑färgarrayen att skriva.

Examples

This example shows how to load a pixels information in an array of Color, manipulates the array and set it back to the image. To perform these operations, this example creates a new Image file (in GIF format) using MemoryStream object.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Color
from aspose.imaging.externsions import StreamExtensions as strm_ext
from aspose.imaging.imageoptions import GifOptions
from aspose.imaging.sources import StreamSource

# Skapa en instans av MemoryStream
with strm_ext.create_memory_stream() as stream:
	#Skapa en instans av GifOptions och ange dess olika egenskaper, inklusive Source‑egenskapen
	with GifOptions() as gifOptions:
		gifOptions.source = StreamSource(stream)

		# Skapa en instans av Image
		with as_of(Image.create(gifOptions, 500, 500), RasterImage) as image:
			# Hämta bildens pixlar genom att ange området som bildens gräns
			pixels = image.load_pixels(image.bounds)

			yellow_color = Color.yellow
			blue_color = Color.blue
			#Iterera över arrayen och ange färg för alternerande indexerade pixlar
			for index in range(pixel.length):
				if index % 2 == 0:
					#Ange den indexerade pixelns färg till gul
					pixels[index] = yellow_color
				else:
					#Ange den indexerade pixelns färg till blå
					pixels[index] = blue_color

			#Applicera pixeländringarna på bilden
			image.save_pixels(image.bounds, pixels)

			# spara alla ändringar.
			image.save()

	# Skriv MemoryStream till fil
	stream.seek(0)
	with open(r"C:\temp\output.gif", "wb") as fileStream:
		fileStream.write(stream.read())
}

The following example shows how image caching affects performance. In general case, reading cached data is performed faster than reading non-cached data.

from aspose.imaging import Image, Rectangle
from aspose.imaging.imageoptions import PngOptions
from os.path import join as path_join

directory = r"c:\temp"

# Läs in en bild från en PNG‑fil.
with Image.load(path_join(directory, "sample.png")) as image:
	# Cacha all pixeldata så att ingen ytterligare dataladdning utförs från den underliggande dataströmmen
	image.cache_daata()

	start_time = timedelta()

	# Att läsa alla pixlar är ganska snabbt.
	rasterImage = as_of(image, RasterImage)
	for y in range(image.height):
		for x in range(image.width):
			color = rasterImage.get_argb_32_pixel(x, y)
			
	end_time = timedelta()
	time = (end_time.microseconds - start_time.microseconds) / 1000000
	print(f"Reading all cached pixels took {time} ms.")


# Läs in en bild från en PNG-fil
with Image.load(path_join(directory, "sample.png")) as image:
	start_time = timedelta()

	# Att läsa alla pixlar är inte lika snabbt som vid cachning
	rasterImage = as_of(image, RasterImage)
	for y in range(image.height):
		for x in range(image.width):
			color = rasterImage.get_argb_32_pixel(x, y)

	end_time = timedelta()
	time = (end_time.microseconds - start_time.microseconds) / 1000000
	print(f"Reading all pixels without preliminary caching took {time} ms.")

# Utdata kan se ut så här:
# Att läsa alla cachade pixlar tog 1500 ms.
# Att läsa alla pixlar utan föregående cachning tog 150000 ms.

The following example creates a new raster image, saves the specified semi-transparent pixels, then loads those pixels and gets final colors in the premultiplied form.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Color
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.sources import StreamSource
from aspose.imaging.fileformats.png import PngColorType

image_width = 3
image_height = 2

colors = [
	Color.from_argb(127, 255, 0, 0),
	Color.from_argb(127, 0, 255, 0),
	Color.from_argb(127, 0, 0, 255),
	Color.from_argb(127, 255, 255, 0),
	Color.from_argb(127, 255, 0, 255),
	Color.from_argb(127, 0, 255, 255)
]

create_options = PngOptions()
create_options.source = StreamSource()
create_options.color_type = PngColorType.TRUECOLOR_WITH_ALPHA

with Image.create(create_options, image_width, image_height) as image:
	raster_image = as_of(image, RasterImage)

	# Spara pixlar för hela bilden.
	raster_image.save_pixels(raster_image.bounds, colors)

	# Pixlarna lagras i den ursprungliga bilden i icke-förmultiplicerad form.
	# Du måste ange motsvarande alternativ explicit för att erhålla förmultiplicerade färgkomponenter.
	# De förmultiplicerade färgkomponenterna beräknas med formlerna:
	# red = original_red * alpha / 255;
	# green = original_green * alpha / 255;
	# blue = original_blue * alpha / 255;
	raster_image.premultiply_components = True
	premultiplied_colors = raster_image.load_pixels(raster_image.bounds)
	for i in range(len(colors)):
		print(f"Original color: {colors[i]}")
		print(f"Premultiplied color: {premultiplied_colors[i]}")

The following example loads raster images and prints information about raw data format and alpha channel.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage

# Bildfilerna att läsa in.
fileNames = (r"c:\temp\sample.bmp", r"c:\temp\alpha.png")

for fileName in fileNames:
	with Image.load(fileName) as image:
		raster_image = as_of(image, RasterImage)
		print(f"ImageFile={fileName}, FileFormat={raster_image.raw_data_format}, HasAlpha={raster_image.has_alpha}")

# Utdata kan se ut så här:
# ImageFile=c:\temp\sample.bmp, FileFormat=Rgb24Bpp, använda kanaler: 8,8,8, HasAlpha=False
# ImageFile=c:\temp\alpha.png, FileFormat=RGBA32Bpp, använda kanaler: 8,8,8,8, HasAlpha=True

The following example loads a raster image and performs threshold and Floyd dithering using different palette depth.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, DitheringMethod
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Utför tröskel-dithering med en 4-bitars färgpalett som innehåller 16 färger.
	# Ju fler bitar som anges, desto högre kvalitet och desto större storlek på utdata bilden.
	# Observera att endast 1-bitars, 4-bitars och 8-bitars paletter stöds för närvarande.
	rasterImage.dither(DitheringMethod.THRESHOLD_DITHERING, 4)

	rasterImage.save(join_path(directory, "sample.ThresholdDithering4.png"))

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)

	# Utför Floyd-dithering med en 1-bitars färgpalett som endast innehåller 2 färger – svart och vit.
	# Ju fler bitar som anges, desto högre kvalitet och desto större storlek på utdata bilden.
	# Observera att endast 1-bitars, 4-bitars och 8-bitars paletter stöds för närvarande.
	rasterImage.dither(DitheringMethod.FLOYD_STEINBERG_DITHERING, 1)
	rasterImage.save(join_path(directory, "sample.FloydSteinbergDithering1.png"))

The following example loads a raster image and obtains the color of an arbitrary pixel represented as a 32-bit integer value.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage

with Image.load("sample.png") as image:
	rasterImage = as_of(image, RasterImage)

	# Hämta en heltalsrepresentation av färgen på bildens övre vänstra pixel.
	color = rasterImage.get_argb_32_pixel(0, 0)

	# För att erhålla värdena för de enskilda färgkomponenterna, skifta färgvärdet med ett motsvarande antal bitar
	alpha = (color >> 24) & 0xff
	red = (color >> 16) & 0xff
	green = (color >> 8) & 0xff
	blue = (color >> 0) & 0xff

	print(f"The color of the pixel(0,0) is A={alpha},R={red},G={green},B={blue}")

The following example loads a raster image and obtains the color of an arbitrary pixel.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage

with Image.load("sample.png") as image:
	rasterImage = as_of(image, RasterImage)
	# Hämta färgen på bildens övre vänstra pixel.
	color = rasterImage.get_pixel(0, 0)

	# Erhåll värdena för de enskilda färgkomponenterna
	alpha = color.a
	red = color.r
	green = color.g
	blue = color.b

	print(f"The color of the pixel(0,0) is A={alpha},R={red},G={green},B={blue}")

The following example loads a raster image, and sets the color of an arbitrary pixel.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Color

with Image.load("sample.png") as image:
	rasterImage = as_of(image, RasterImage)
	# Sätter färgen på den övre vänstra pixeln.
	rasterImage.set_argb_32_pixel(0, 0, Color.aqua.to_argb())
	# Ett annat sätt är att skicka en instans av aspose.imaging.Color direkt
	rasterImage.set_pixel(0, 0, Color.aqua)

The following example shows how to load and process pixels of a raster image. The pixels are represented as 32-bit integer values. For example, consider a problem of counting of fully transparent pixels of an image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage

with Image.load("alpha.png") as image:
	rasterImage = as_of(image, RasterImage)

	# Läs in pixlar för hela bilden. Alla rektangulära delar av bilden kan anges som en parameter till metoden aspose.imaging.RasterImage.load_argb_32_pixels(rectangle).
	pixels = rasterImage.load_argb_32_pixels(rasterImage.bounds)

	count = 0
	for pixel in pixels:
		alpha = (pixel >> 24) & 0xff
		if alpha == 0:
			count += 1

	print(f"The number of fully transparent pixels is {count}")
	print(f"The total number of pixels is {image.width * image.height}")

The following example shows how to load and process pixels of a raster image. The pixels are represented as 64-bit integer values. For example, consider a problem of counting of fully transparent pixels of an image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage

with Image.load("16rgba.png") as image:
	rasterImage = as_of(image, RasterImage)
	# Läs in pixlar för hela bilden. Alla rektangulära delar av bilden kan anges som en parameter till metoden aspose.imaging.RasterImage.load_argb_64_pixels.
	# Observera att själva bilden måste ha 16 bitar per prov, eftersom aspose.imaging.RasterImage.load_argb_64_pixels inte fungerar med 8 bitar per prov.
	# För att arbeta med 8 bitar per prov, använd den gamla goda metoden aspose.imaging.RasterImage.load_argb_64_pixels.
	pixels = rasterImage.load_argb_64_pixels(rasterImage.bounds)

	count = 0
	for pixel in pixels:
		# Observera att alla färgkomponenter inklusive alfa representeras av 16-bitars värden, så deras tillåtna värden ligger i intervallet [0, 63535].
		alpha = (pixel >> 48) & 0xffff
		if alpha == 0:
			count += 1

	print(f"The number of fully transparent pixels is {count}")
	print(f"The total number of pixels is {image.width * image.height}")

The following example shows how to load and process pixels of a raster image. For example, consider a problem of counting of fully transparent pixels of an image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage

with Image.load("alpha.png") as image:
	rasterImage = as_of(image, RasterImage)
	# Läs in pixlar för hela bilden. Alla rektangulära delar av bilden kan anges som en parameter till metoden aspose.imaging.RasterImage.load_pixels.
	pixels = rasterImage.load_pixels(rasterImage.bounds)

	count = 0
	for pixel in pixels:
		if pixel.a == 0:
			count += 1

	print(f"The number of fully transparent pixels is {count}")
	print(f"The total number of pixels is {image.width * image.height}")

The following example fills the central area of a raster image with black pixels using the aspose.imaging.RasterImage.save_argb_32_pixels method.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Rectangle, Color
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Den svarta kvadraten
	pixel_count = ((rasterImage.width // 2) * (rasterImage.height // 2))
	black_color = Color.black.to_argb()
	pixels = [black_color] * pixel_count

	# Rita den svarta kvadraten i bildens centrum.
	area = Rectangle(rasterImage.width // 4, rasterImage.height // 4, rasterImage.width // 2, rasterImage.height // 2)
	rasterImage.save_argb_32_pixels(area, pixels)

	rasterImage.save(join_path(directory, "sample.SaveArgb32Pixels.png"))

The following example fills the central area of a raster image with black pixels using the aspose.imaging.RasterImage.save_pixels method.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Rectangle, Color
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Den svarta kvadraten
	pixel_count = ((rasterImage.width // 2) * (rasterImage.height // 2))
	black_color = Color.black
	pixels = [black_color] * pixel_count

	# Rita den svarta kvadraten i bildens centrum.
	area = Rectangle(rasterImage.width // 4, rasterImage.height // 4, rasterImage.width // 2, rasterImage.height // 2)
	rasterImage.save_pixels(area, pixels)

	rasterImage.save(join_path(directory, "sample.SavePixels.png"))

The following example fills the central area of a raster image with black pixels using the aspose.imaging.RasterImage.save_cmyk_32_pixels method.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Rectangle, Color, CmykColorHelper
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Hämta en heltalsrepresentation av svart i CMYK-färgrymden.
	blackCmyk = CmykColorHelper.to_cmyk(Color.black)
	# Den svarta kvadraten.
	pixel_count = (rasterImage.width // 2) * (rasterImage.height // 2)
	pixels = [blackCmyk] * pixel_count
	# Rita den svarta kvadraten i bildens centrum.
	area = Rectangle(rasterImage.width // 4, rasterImage.height // 4, rasterImage.width // 2, rasterImage.height // 2)
	rasterImage.save_cmyk_32_pixels(area, pixels)

	rasterImage.save(join_path(directory, "sample.SaveCmyk32Pixels.png"))

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

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Rectangle
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Beskär bilden. Beskärningsområdet är bildens rektangulära centrala område.
	area = Rectangle(rasterImage.width // 4, rasterImage.height // 4, rasterImage.width // 2, rasterImage.height // 2)
	rasterImage.crop(area)
	# Spara den beskurna bilden som PNG
	rasterImage.save(join_path(directory, "sample.Crop.png"))

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

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Rectangle, Color
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Beskär igen. Ställ in en marginal på 10 % av bildens storlek.
	horizontalMargin = rasterImage.width // 10
	verticalMargin = rasterImage.height // 10
	rasterImage.crop(horizontalMargin, horizontalMargin, verticalMargin, verticalMargin)
	# Spara den beskurna bilden som PNG.
	rasterImage.save(join_path(directory, "sample.Crop.png"))

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

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# 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.
	rasterImage.binarize_fixed(127)
	rasterImage.save(join_path(directory, "sample.BinarizeFixed.png"))

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

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# 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.
	rasterImage.binarize_bradley(5, 10)
	rasterImage.save(join_path(directory, "sample.BinarizeBradley5_10x10.png"))

The following example performs gamma-correction of an image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Ställ in gamma‑koefficient för röd, grön och blå kanal.
	rasterImage.adjust_gamma(2.5f)
	rasterImage.save(join_path(directory, "sample.AdjustGamma.png"))

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

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Ställ in gamma‑koefficient för röd, grön och blå kanal.
	rasterImage.adjust_gamma(1.5f, 2.5f, 3.5f)
	rasterImage.save(join_path(directory, "sample.AdjustGamma.png"))

The following example performs brightness correction of an image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Ställ in ljushetsvärdet. Godkända värden för ljushet ligger i intervallet [-255, 255].
	rasterImage.adjust_brightness(50)
	rasterImage.save(join_path(directory, "sample.AdjustBrightness.png"))

The following example performs contrast correction of an image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Ställ in kontrastvärdet. Godkända värden för kontrast ligger i intervallet [-100f, 100f].
	rasterImage.adjust_contrast(50)
	rasterImage.save(join_path(directory, "sample.AdjustContrast.png"))

The following example applies various types of filters to a raster image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from aspose.imaging.imagefilters.filteroptions import *
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Applicera ett medianfilter med en rektangelstorlek på 5 på hela bilden.
	rasterImage.filter(rasterImage.bounds, MedianFilterOptions(5))
	rasterImage.save(join_path(directory, "sample.MedianFilter.png"))

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Applicera ett bilateralt utjämningsfilter med en kärnstorlek på 5 på hela bilden.
	rasterImage.filter(rasterImage.bounds, BilateralSmoothingFilterOptions(5))
	rasterImage.save(join_path(directory, "sample.BilateralSmoothingFilter.png"))

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Applicera ett Gaussiskt oskärpefilter med en radie på 5 och ett sigma‑värde på 4,0 på hela bilden.
	rasterImage.filter(rasterImage.bounds, GaussianBlurFilterOptions(5, 4.0))
	rasterImage.save(join_path(directory, "sample.GaussianBlurFilter.png"))

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Applicera ett Gauss‑Wiener-filter med en radie på 5 och ett slätningsvärde på 4,0 på hela bilden.
	rasterImage.filter(rasterImage.bounds, GaussWienerFilterOptions(5, 4.0))
	rasterImage.save(join_path(directory, "sample.GaussWienerFilter.png"))

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Applicera ett rörelse‑Wiener-filter med en längd på 5, ett slätningsvärde på 4,0 och en vinkel på 90,0 grader på hela bilden.
	rasterImage.filter(rasterImage.bounds, MotionWienerFilterOptions(10, 1.0, 90.0))
	rasterImage.save(join_path(directory, "sample.MotionWienerFilter.png"))
}

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Applicera ett skärpefilter med en kärnstorlek på 5 och ett sigma‑värde på 4,0 på hela bilden.
	rasterImage.filter(rasterImage.bounds, SharpenFilterOptions(5, 4.0))
	rasterImage.save(join_path(directory, "sample.SharpenFilter.png"))

This example loads a raster image and resizes it using various resizing methods.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, ResizeType
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.gif")) as image:
	rasterImage = as_of(image, RasterImage)
	# Skala upp med 2 gånger med närmaste granne-omprovning.
	rasterImage.resize(image.width * 2, image.height * 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
	image.save(join_path(directory, "upsample.nearestneighbour.gif"))

with Image.load(join_path(directory, "sample.gif")) as image:
	rasterImage = as_of(image, RasterImage)
	# Skala ner med 2 gånger med närmaste granne-omprovning.
	rasterImage.resize(image.width // 2, image.height // 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE);
	image.Save(dir + "downsample.nearestneighbour.gif");

with Image.load(join_path(directory, "sample.gif")) as image:
	rasterImage = as_of(image, RasterImage)
	# Skala upp med 2 gånger med bilinjär omprovning.
	rasterImage.resize(image.width * 2, image.height * 2, ResizeType.BILINEAR_RESAMPLE)
	image.save(join_path(directory, "upsample.bilinear.gif"))

with Image.load(join_path(directory, "sample.gif")) as image:
	rasterImage = as_of(image, RasterImage)
	# Skala ner med 2 gånger med bilinjär omprovning.
	rasterImage.resize(image.width // 2, image.height // 2, ResizeType.BILINEAR_RESAMPLE)
	image.Save(dir + "downsample.bilinear.gif");

This example loads a raster image and resizes it using various resizing settings.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, ImageResizeSettings, ResizeType,\
	ImageFilterType, ColorQuantizationMethod, ColorCompareMethod
from os.path import join as join_path

directory = r"c:\temp"

resizeSettings = ImageResizeSettings()
# Den adaptiva algoritmen baserad på viktad och blandad rationell funktion och lanczos3-interpolation.
resizeSettings.mode = ResizeType.ADAPTIVE_RESAMPLE
# Det lilla rektangulära filtret
resizeSettings.filter_type = ImageFilterType.SMALL_RECTANGULAR
# Antalet färger i paletten.
resizeSettings.entries_count = 256
# Färgkvantisering används inte
resizeSettings.color_quantization_method = ColorQuantizationMethod.NONE
# Den euklidiska metoden
resizeSettings.color_compare_method = ColorCompareMethod.EUCLIDIAN

with Image.load(join_path(directory, "sample.gif")) as image:
	rasterImage = as_of(image, RasterImage)
	# Skala ner med 2 gånger med adaptiv omprovning.
	rasterImage.resize(image.width // 2, image.height // 2, resizeSettings)
	image.save(join_path(directory, "downsample.adaptive.gif"))

The following example shows how to extract information about raw data format and alpha channel from a BMP image.

from aspose.imaging.fileformats.bmp import BmpImage

# Skapa en 32-bpp BMP-bild på 100 x 100 px.
with BmpImage(100, 100, 32, None) as bmp_image:
	print("FileFormat={0}, RawDataFormat={1}, HasAlpha={2}".format(bmp_image.file_format.name, bmp_image.raw_data_format, bmp_image.has_alpha))


# Skapa en 24-bpp BMP-bild på 100 x 100 px.
with BmpImage(100, 100, 24, None) as bmp_image:
	print("FileFormat={0}, RawDataFormat={1}, HasAlpha={2}".format(bmp_image.file_format.name, bmp_image.raw_data_format, bmp_image.has_alpha))

# Generellt stödjer inte BMP alfakanal, så resultatet kommer att se ut så här:
# FileFormat = BMP, RawDataFormat = Rgb32Bpp, använda kanaler: 8,8,8,8, HasAlpha = False
# FileFormat = BMP, RawDataFormat = Rgb24Bpp, använda kanaler: 8,8,8, HasAlpha = False

Skew is an artifact that might appear during document scanning process when the text/images of the document get rotated at a slight angle. It can have various causes but the most common is that the paper get misplaced during a scan. Therefore, deskew is the process of detecting and fixing this issue on scanned files(i.e. bitmap) so deskewed documents will have the text/images correctly and horizontally adjusted.

from aspose.imaging import Image, RasterImage, Color
from aspose.pycore import as_of

dir_: str = "c:\\3567\\"
input_file_path: str = dir_ + "skewed.png"
output_file_path: str = dir_ + "skewed.out.png"
# Bli av med den snedvridna skanningen med standardparametrar
with as_of(Image.load(input_file_path), RasterImage) as image:
	# Raka upp
	image.normalize_angle(False, Color.light_gray)
	image.save(output_file_path)

The example shows how to validate that the embedded digital signature matches the provided password.

from aspose.imaging import Image

with Image.load(output_path) as image:
	is_signed = image.is_digital_signed(password, -1)

The example shows how to embed digital signature based on provided password into image pixel data.

from aspose.imaging import Image

image_file_path = "ball.png"
password = "veryStr0ngPassword"
with Image.load(image_file_path) as image:
	image.embed_digital_signature(password)
	image.save(output_path)

The example demonstrates how to verify that the embedded digital signature matches the provided password against the specified probability threshold.

from aspose.imaging import Image
  
threshold = 100
with Image.load(output_path) as image:
	is_signed = image.is_digital_signed(password, threshold)

The example illustrates how to determine the probability (from 0% to 100%) that an image contains a digital signature created with the specified password.

from aspose.imaging import Image

with Image.load(output_path) as image:
	signed_percentage = image.analyze_percentage_digital_signature(password)