CmxImage-klass

Summary: The API for Corel Metafile Exchange (CMX) vector image format with metadata
descriptions support is a comprehensive solution for developers working
with CMX files. This API allows for the seamless loading of CMX images,
extracting metadata such as bits per pixel, object dimensions, and more.
With additional functionalities like resizing, rotating, setting
palettes, and converting to other formats, this API empowers developers
to efficiently manipulate and customize CMX vector images to meet their
specific application requirements.

Module: aspose.imaging.fileformats.cmx

Full Name: aspose.imaging.fileformats.cmx.CmxImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, IMultipageImage, ICmxImage, VectorMultipageImage

Constructors

Name	Description
CmxImage(stream_container, load_options)	Börja arbeta med klassen CmxImage sömlöst genom att initiera en ny instans med parametrarna streamContainer och loadOptions. Idealiskt för utvecklare som söker ett bekvämt sätt att läsa in CMX-bilder från olika datakällor samtidigt som de anpassar inläsningsprocessen efter behov.

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ämta bildens bitdjup enkelt med denna användarvänliga egenskap. Idealiskt för utvecklare som vill fastställa detaljnivån eller färgdjupet i sina bilder, vilket säkerställer korrekt bearbetning och manipulation.
bounds	Rectangle	r	Hämtar objektets 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.
cmx_page	CmxPage	r	Hämta enkelt CMX-sidan för bilden med denna intuitiva egenskap. Idealiskt för utvecklare som söker snabb åtkomst till enskilda sidor i CMX-bilder, vilket säkerställer effektiv navigering och hantering.
container	Image	r	Hämtar Image behållaren.
data_stream_container	StreamContainer	r	Hämtar objektets datastream.
default_page	Image	r	Hämta enkelt standard sidan för bilden med denna intuitiva egenskap. Idealiskt för utvecklare som söker snabb åtkomst till bildens huvudsida, vilket säkerställer effektiv navigering och hantering.
disposed	bool	r	Hämtar ett värde som indikerar om den här instansen är frigjord.
document	CmxDocument	r	Hämta CMX-dokumentet enkelt med denna intuitiva egenskap. Idealiskt för utvecklare som vill komma åt eller modifiera CMX-bilder, vilket säkerställer flexibilitet och effektivitet i deras applikationer.
exif_data	ExifData	r/w	Hämtar eller anger Exif-instans.
file_format	FileFormat	r	Hämta bildens filformat enkelt med denna användarvänliga egenskap. Idealiskt för utvecklare som vill bestämma formatet på sina bilder dynamiskt, vilket säkerställer kompatibilitet och korrekt bearbetning i deras applikationer.
has_background_color	bool	r/w	Hämtar eller anger ett värde som indikerar om bilden har bakgrundsfärg.
height	int	r	Hämtar bildens höjd.
height_f	float	r	Få enkelt objektets höjd, mätt i tum, med denna användarvänliga egenskap. Idealiskt för utvecklare som söker exakt dimensionell information för effektiv layout och presentation i sina applikationer.
interrupt_monitor	InterruptMonitor	r/w	Hämtar eller anger avbrottsövervakaren.
is_cached	bool	r	Bestäm om objektets data för närvarande är cachade, vilket eliminerar behovet av dataläsning. Idealiskt för utvecklare som vill optimera prestanda genom att effektivt utnyttja cachade data, vilket säkerställer snabbare åtkomst till objektinformation.
metadata	ImageMetadata	r	Hämtar bildens metadata.
page_count	int	r	Hämta det totala antalet sidor i bilden med denna intuitiva egenskap. Idealiskt för utvecklare som vill hantera flersidiga bilder dynamiskt, vilket säkerställer effektiv navigering och manipulation av bildinnehållet.
pages	Image[]	r	Hämta bildens sidor sömlöst med denna intuitiva egenskap. Idealiskt för utvecklare som vill komma åt och manipulera enskilda sidor i flersidiga bilder, vilket säkerställer effektiv navigering och bearbetning.
palette	IColorPalette	r/w	Hämtar eller anger färgpaletten. Färgpaletten används inte när pixlar representeras direkt.
size	Size	r	Hämtar objektets storlek.
size_f	SizeF	r	Hämtar objektets storlek i tum.
use_palette	bool	r	Hämtar ett värde som indikerar om bildpaletten används.
width	int	r	Hämtar bildens bredd.
width_f	float	r	Hämta objektets bredd i tum med denna intuitiva egenskap. Idealiskt för utvecklare som söker precisa mått på objekt i sina applikationer, vilket säkerställer korrekt layout och presentation.
xmp_data	XmpPacketWrapper	r/w	Hämtar eller anger Xmp-data.

Methods

Name	Description
cache_data()	Cacha data för att förhindra ytterligare inläsning från den underliggande källan DataStreamSupporter.data_stream_container med denna praktiska metod. Idealiskt för utvecklare som vill optimera prestanda genom att förladda data, vilket säkerställer snabbare åtkomst och smidigare drift i deras applikationer.
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.
get_default_options(args)	Hämtar standardalternativen för bild.
get_embedded_images()	Hämtar de inbäddade bilderna.
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_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_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.
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_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.
remove_background()	Tar bort bakgrunden.
remove_background(settings)	Tar bort bakgrunden.
remove_metadata()	Tar bort metadata.
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 storlek på bilden.
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_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 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)	Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.
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_palette(palette, update_colors)	Anpassa bildens färgpalett med denna intuitiva metod. Perfekt för utvecklare som vill tillämpa specifika färgscheman eller justeringar dynamiskt, vilket ger exakt kontroll över bildens visuella utseende.
try_set_metadata(metadata)	Försöker sätta en metadata-instans, om detta Image-instans stödjer och implementerar IImageMetadataFormat-instansen.

Constructor: CmxImage(stream_container, load_options)

 CmxImage(stream_container, load_options) 

Börja arbeta med klassen CmxImage sömlöst genom att initiera
en ny instans med parametrarna streamContainer och loadOptions. Idealiskt för utvecklare
som söker ett bekvämt sätt att läsa in CMX-bilder från olika datakällor samtidigt som
de anpassar inläsningsprocessen efter behov.

Parameters:

Parameter	Typ	Beskrivning
stream_container	StreamContainer	Strömbehållaren.
load_options	LoadOptions	Laddningsalternativen.

Property: pages

Hämta bildens sidor sömlöst med denna intuitiva egenskap.
Idealiskt för utvecklare som vill komma åt och manipulera enskilda sidor
i flersidiga bilder, vilket säkerställer effektiv navigering och bearbetning.

See also:

Example # 1: The following example shows how to cache all pages of a CMX image.

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.

Method: crop(rectangle)

 crop(rectangle) 

Beskär den angivna rektangeln.

Parameters:

Parameter	Typ	Beskrivning
rectangle	Rectangle	Rektangeln.

Method: get_default_options(args)

 get_default_options(args) 

Hämtar standardalternativen för bild.

Parameters:

Parameter	Typ	Beskrivning
args	System.Object	Argumenten.

Returns

Typ	Beskrivning
ImageOptionsBase	Standardalternativen för bild.

Method: get_embedded_images()

 get_embedded_images() 

Hämtar de inbäddade bilderna.

Returns

Typ	Beskrivning
EmbeddedImage[]	Array av bilder

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_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_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: 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_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: remove_background(settings)

 remove_background(settings) 

Tar bort bakgrunden.

Parameters:

Parameter	Typ	Beskrivning
settings	RemoveBackgroundSettings	Inställningarna.

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.

Method: resize(new_width, new_height, settings)

 resize(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_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_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 data.

Parameters:

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

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_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_palette(palette, update_colors)

 set_palette(palette, update_colors) 

Anpassa bildens färgpalett med denna intuitiva metod. Perfekt för
utvecklare som vill tillämpa specifika färgscheman eller justeringar dynamiskt,
vilket ger exakt kontroll över bildens visuella utseende.

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

Parameter	Typ	Beskrivning
metadata	IImageMetadataFormat	Metadata.

Returns

Typ	Beskrivning
bool	Sant om metadata inte är null och IMetadataContainer‑instansen stöder och/eller implementerar IImageMetadataFormat‑instansen; annars falskt.

Examples

The following example shows how to cache all pages of a CMX image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.cmx import CmxImage
from os.path import join

dir_: str = "c:\\temp"
# Läs in en bild från en CMX-fil.
with aspycore.as_of(Image.load(join(dir_, "sample.cmx")), CmxImage) as image:
	# Detta anrop cachar endast standardsidan.
	image.cache_data()
	# Cacha alla sidor så att ingen ytterligare dataladdning utförs från den underliggande datastreamen.
	for page in image.pages:
		page.cache_data()