SvgImage klass

Summary: Manipulate Scalar Vector Graphics (SVG) image files with our API, utilizing
the power of XML-based text format for seamless customization and scalability.
Easily load SVG images, rasterize vector elements, and convert to other formats,
while controlling compression levels to optimize file size and quality for your projects.

Module: aspose.imaging.fileformats.svg

Full Name: aspose.imaging.fileformats.svg.SvgImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, VectorImage

Constructors

NameDescription
SvgImage(path)Instansierar ett nytt objekt av klassen SvgImage, med hjälp av den
angivna sökvägen för att hitta och läsa in bilden. Denna konstruktor underlättar
skapandet av SVG-bildinstanser från externa filer, vilket möjliggör sömlös
integration i mjukvarusystem och arbetsflöden.
SvgImage(stream)Skapar en ny instans av klassen SvgImage, som läser in bilden
från den angivna strömmen. Denna konstruktor möjliggör direkt inläsning av SVG-
bilder från strömmar, vilket ökar flexibiliteten och effektiviteten vid hantering av bild-
resurser i mjukvaruapplikationer.
SvgImage(svg_options, width, height)Skapar en ny instans av klassen SvgImage med angivna SVG-
alternativ, bildens bredd- och höjdpunktsparametrar. Denna konstruktor möjliggör
för utvecklare att initiera SVG-bilder med anpassade alternativ och dimensioner,
vilket ger flexibilitet i hantering av SVG-innehåll och layout.
SvgImage(width, height)Instansierar ett nytt SvgImage-objekt med angiven bredd och
höjd. Denna konstruktor låter utvecklare skapa SVG-bilder med fördefinierade
dimensioner, vilket underlättar exakt kontroll över bildens storlek under
initiering.

Properties

NameTypeAccessDescription
auto_adjust_paletteboolr/wHämtar eller anger ett värde som indikerar om automatisk justering av palett.
background_colorColorr/wHämtar eller anger ett värde för bakgrundsfärgen.
bits_per_pixelintrHämtar antalet bitar per pixel för bilden. Det är viktigt att notera att
denna parameter inte gäller för vektorbilder, eftersom de inte mäts i
pixlar. Denna egenskap ger viktig information om bildens färgdjup,
vilket underlättar bearbetnings- och manipuleringsuppgifter.
boundsRectanglerHämtar objektets gränser.
buffer_size_hintintr/wHämtar eller anger en ledtråd för buffertstorlek som definierar maximal tillåten storlek för alla interna buffertar.
containerImagerHämtar Image behållaren.
data_stream_containerStreamContainerrHämtar objektets datastream.
disposedboolrHämtar ett värde som indikerar om den här instansen är frigjord.
exif_dataExifDatar/wHämtar eller anger Exif-instans.
file_formatFileFormatrHämtar bildens filformat och tillhandahåller väsentlig metadata för
bearbetning och kompatibilitetskontroller. Denna egenskap är avgörande för
att bestämma lämpliga avkodnings- och kodningsstrategier för att hantera
bilddata effektivt över olika system och applikationer.
has_background_colorboolr/wHämtar eller anger ett värde som indikerar om bilden har bakgrundsfärg.
heightintrHämtar bildens höjd.
height_ffloatrHämtar objektets höjd i tum.
interrupt_monitorInterruptMonitorr/wHämtar eller anger avbrottsövervakaren.
is_cachedboolrHämtar ett booleskt värde som indikerar om objektets data för närvarande
är cachad, vilket eliminerar behovet av ytterligare läsoperationer. Denna
egenskap ger insikt i den aktuella cachestatusen och optimerar
datahämtning och bearbetningsflöden för förbättrad prestanda och effektivitet.
metadataImageMetadatarHämtar bildens metadata.
paletteIColorPaletter/wHämtar eller anger färgpaletten. Färgpaletten används inte när pixlar representeras direkt.
sizeSizerHämtar objektets storlek.
size_fSizeFrHämtar objektets storlek i tum.
use_paletteboolrHämtar ett värde som indikerar om bildpaletten används.
widthintrHämtar bildens bredd.
width_ffloatrHämtar objektets bredd i tum.
xmp_dataXmpPacketWrapperr/wHämtar eller anger Xmp-data.

Methods

NameDescription
cache_data()Cacha data och garantera att ingen ytterligare data laddas från
den underliggande DataStreamSupporter.data_stream_container. Denna
optimering förbättrar prestanda genom att eliminera redundanta datahämtningar,
särskilt fördelaktigt i scenarier som kräver frekvent åtkomst till
bilddata.
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.
create_from_stream(stream)Initierar en ny instans av klassen SvgImage.
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 SVG-sektionen.
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)Ändra storleken på bilden så att den passar de angivna dimensionerna samtidigt som bildförhållandet
bevaras. Denna metod erbjuder ett bekvämt sätt att justera bildens storlek
utan att förvränga dess proportioner, vilket säkerställer optimal visning eller lagring
enligt de önskade dimensionerna.
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_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)Applicerar en specificerad palett på bilden, vilket möjliggör anpassning av färg
scheman för estetiska eller funktionella ändamål. Denna metod ger flexibilitet
i hanteringen av färgpaletter för att passa olika design- eller applikationskrav.
try_set_metadata(metadata)Försöker sätta en metadata-instans, om detta Image-instans stödjer och implementerar IImageMetadataFormat-instansen.

Constructor: SvgImage(path)

 SvgImage(path) 

Instansierar ett nytt objekt av klassen SvgImage, med hjälp av den
angivna sökvägen för att hitta och läsa in bilden. Denna konstruktor underlättar
skapandet av SVG-bildinstanser från externa filer, vilket möjliggör sömlös
integration i mjukvarusystem och arbetsflöden.

Parameters:

ParameterTypBeskrivning
sökvägstringSökvägen för att läsa in bilden från och initiera pixel‑ och palettdata med.

Constructor: SvgImage(stream)

 SvgImage(stream) 

Skapar en ny instans av klassen SvgImage, som läser in bilden
från den angivna strömmen. Denna konstruktor möjliggör direkt inläsning av SVG-
bilder från strömmar, vilket ökar flexibiliteten och effektiviteten vid hantering av bild-
resurser i mjukvaruapplikationer.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen för att läsa in bilden från och initiera pixel‑ och palettdata med.

See also:

Example # 1: This example shows how to load an SVG image from a file stream and rasterize …

Constructor: SvgImage(svg_options, width, height)

 SvgImage(svg_options, width, height) 

Skapar en ny instans av klassen SvgImage med angivna SVG-
alternativ, bildens bredd- och höjdpunktsparametrar. Denna konstruktor möjliggör
för utvecklare att initiera SVG-bilder med anpassade alternativ och dimensioner,
vilket ger flexibilitet i hantering av SVG-innehåll och layout.

Parameters:

ParameterTypBeskrivning
svg_optionsSvgOptionsSVG-alternativen.
widthintBildbredd.
heightintBildhöjd.

Constructor: SvgImage(width, height)

 SvgImage(width, height) 

Instansierar ett nytt SvgImage-objekt med angiven bredd och
höjd. Denna konstruktor låter utvecklare skapa SVG-bilder med fördefinierade
dimensioner, vilket underlättar exakt kontroll över bildens storlek under
initiering.

Parameters:

ParameterTypBeskrivning
widthintBildens bredd.
heightintBildens höjd.

Method: can_load(file_path) [static]

 can_load(file_path) 

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

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.

Returns

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

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

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

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
load_optionsLoadOptionsLaddningsalternativen.

Returns

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

Method: can_load(stream) [static]

 can_load(stream) 

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

Parameters:

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

Returns

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

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

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

Parameters:

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

Returns

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

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

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

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
load_optionsLoadOptionsLaddningsalternativen.

Returns

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

Method: can_save(options)

 can_save(options) 

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

Parameters:

ParameterTypBeskrivning
optionsImageOptionsBaseSparaalternativen att använda.

Returns

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

Method: create(files) [static]

 create(files) 

Skapar flersidig bild som innehåller de angivna filerna.

Parameters:

ParameterTypBeskrivning
filesstring[]Filerna.

Returns

TypBeskrivning
ImageDen flersidiga bilden

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error) 

Skapar flersidig bild som innehåller de angivna filerna.

Parameters:

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

Returns

TypBeskrivning
ImageDen flersidiga bilden

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

 create(image_options, width, height) 

Skapar en ny bild med de angivna skapandealternativen.

Parameters:

ParameterTypBeskrivning
image_optionsImageOptionsBaseBildalternativen.
widthintBredden.
heightintHöjden.

Returns

TypBeskrivning
ImageDen nyss skapade bilden.

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

 create(image_options, width, height, pixels) 

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

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

Parameters:

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

Returns

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

Method: create(images) [static]

 create(images) 

Skapar en ny bild med de angivna bilderna som sidor

Parameters:

ParameterTypBeskrivning
imagesImage[]Bilderna.

Returns

TypBeskrivning
ImageBilden som IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

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

Parameters:

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

Returns

TypBeskrivning
ImageBilden som IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

Skapar de angivna flersidiga skapalternativen.

Parameters:

ParameterTypBeskrivning
multipage_create_optionsMultipageCreateOptionsAlternativen för att skapa flersidiga bilder.

Returns

TypBeskrivning
ImageDen flersidiga bilden

Method: create_from_files(files) [static]

 create_from_files(files) 

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

Parameters:

ParameterTypBeskrivning
filesstring[]Filerna.

Returns

TypBeskrivning
ImageDen flersidiga bilden

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error) 

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

Parameters:

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

Returns

TypBeskrivning
ImageDen flersidiga bilden

Method: create_from_images(images) [static]

 create_from_images(images) 

Skapar en ny bild med de angivna bilderna som sidor

Parameters:

ParameterTypBeskrivning
imagesImage[]Bilderna.

Returns

TypBeskrivning
ImageBilden som IMultipageImage

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

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

Parameters:

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

Returns

TypBeskrivning
ImageBilden som IMultipageImage

Method: create_from_stream(stream) [static]

 create_from_stream(stream) 

Initierar en ny instans av klassen SvgImage.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen för att läsa in bilden från och initiera pixel‑ och palettdata med.

Returns

TypBeskrivning
SvgImage

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:

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

Method: crop(rectangle)

 crop(rectangle) 

Beskär den angivna rektangeln.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln.

Method: get_default_options(args)

 get_default_options(args) 

Hämtar standardalternativen för bild.

Parameters:

ParameterTypBeskrivning
argsSystem.ObjectArgumenten.

Returns

TypBeskrivning
ImageOptionsBaseStandardalternativen för bild.

Method: get_embedded_images()

 get_embedded_images() 

Hämtar de inbäddade bilderna.

Returns

TypBeskrivning
EmbeddedImage[]Array av bilder

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

Hämtar filformatet.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.

Returns

TypBeskrivning
FileFormatDet bestämda filformatet.

Method: get_file_format(stream) [static]

 get_file_format(stream) 

Hämtar filformatet.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen.

Returns

TypBeskrivning
FileFormatDet bestämda filformatet.

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

Hämtar filformatet.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen.

Returns

TypBeskrivning
FileFormatDet bestämda filformatet.

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

 get_fitting_rectangle(rectangle, pixels, width, height) 

Hämtar rektangeln som passar den aktuella bilden.

Parameters:

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

Returns

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

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

 get_fitting_rectangle(rectangle, width, height) 

Hämtar rektangeln som passar den aktuella bilden.

Parameters:

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

Returns

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

Method: get_original_options()

 get_original_options() 

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

Returns

TypBeskrivning
ImageOptionsBaseAlternativen baserade på de ursprungliga filinställningarna.

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

 get_proportional_height(width, height, new_width) 

Hämtar en proportionell höjd.

Parameters:

ParameterTypBeskrivning
widthintBredden.
heightintHöjden.
new_widthintDen nya bredden.

Returns

TypBeskrivning
intDen proportionella höjden.

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

 get_proportional_width(width, height, new_height) 

Hämtar en proportionell bredd.

Parameters:

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

Returns

TypBeskrivning
intDen proportionella bredden.

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number) 

Konverterar till aps.

Parameters:

ParameterTypBeskrivning
image_optionsImageOptionsBaseBildalternativen.
clipping_rectangleRectangleKlippningsrektangeln.
page_numberint[]Sidnumret.

Returns

TypBeskrivning
_io.BufferedRandomDen serialiserade strömmen

Method: load(file_path) [static]

 load(file_path) 

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

Parameters:

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

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

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

Parameters:

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

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load(stream) [static]

 load(stream) 

Läser in SVG-sektionen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandom

Returns

TypBeskrivning
Image

Method: load(stream, load_options) [static]

 load(stream, load_options) 

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

Parameters:

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

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load_stream(stream) [static]

 load_stream(stream) 

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

Parameters:

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

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load_stream_with_options(stream, load_options) [static]

 load_stream_with_options(stream, load_options) 

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

Parameters:

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

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options) 

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

Parameters:

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

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: remove_background(settings)

 remove_background(settings) 

Tar bort bakgrunden.

Parameters:

ParameterTypBeskrivning
settingsRemoveBackgroundSettingsInställningarna.

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

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

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
new_heightintDen nya höjden.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

Ändra storleken på bilden så att den passar de angivna dimensionerna samtidigt som bildförhållandet
bevaras. Denna metod erbjuder ett bekvämt sätt att justera bildens storlek
utan att förvränga dess proportioner, vilket säkerställer optimal visning eller lagring
enligt de önskade dimensionerna.

Parameters:

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

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

Ändrar bildens storlek med utökade alternativ.

Parameters:

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

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

Ändrar storlek på bilden.

Parameters:

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

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type) 

Ändrar storlek på bilden.

Parameters:

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

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height) 

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

Parameters:

ParameterTypBeskrivning
new_heightintDen nya höjden.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

Ändrar höjden proportionellt.

Parameters:

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

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

Ändrar höjden proportionellt.

Parameters:

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

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings) 

Ändrar höjden proportionellt.

Parameters:

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

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

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

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

Ändrar bredden proportionellt.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
resize_typeResizeTypeTyp av storleksändring.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

Ändrar bredden proportionellt.

Parameters:

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

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

Ändrar bredden proportionellt.

Parameters:

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

Method: rotate(angle)

 rotate(angle) 

Rotera bilden kring centrum.

Parameters:

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

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

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

Parameters:

ParameterTypBeskrivning
rotate_flip_typeRotateFlipTypeTyp av rotate flip.

Method: save(file_path)

 save(file_path) 

Sparar bilden till den angivna filsökvägen.

Parameters:

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

Method: save(file_path, options)

 save(file_path, options) 

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

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
optionsImageOptionsBaseAlternativen.

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle) 

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

Parameters:

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

Method: save(file_path, over_write)

 save(file_path, over_write) 

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

Parameters:

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

Method: save(stream)

 save(stream) 

Sparar data.

Parameters:

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

Method: save(stream, options_base)

 save(stream, options_base) 

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

Parameters:

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

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

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

Parameters:

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

Method: save_to_stream(stream)

 save_to_stream(stream) 

Sparar objektets data till den angivna strömmen.

Parameters:

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

Method: save_to_stream_with_options(stream, options_base)

 save_to_stream_with_options(stream, options_base) 

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

Parameters:

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

Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

 save_to_stream_with_options_rect(stream, options_base, bounds_rectangle) 

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

Parameters:

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

Method: save_with_options(file_path, options)

 save_with_options(file_path, options) 

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

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
optionsImageOptionsBaseAlternativen.

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle) 

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

Parameters:

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

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

Applicerar en specificerad palett på bilden, vilket möjliggör anpassning av färg
scheman för estetiska eller funktionella ändamål. Denna metod ger flexibilitet
i hanteringen av färgpaletter för att passa olika design- eller applikationskrav.

Parameters:

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

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

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

Parameters:

ParameterTypBeskrivning
metadataIImageMetadataFormatMetadata.

Returns

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

Examples

This example shows how to load an SVG image from a file stream and rasterize it to PNG.

import aspose.pycore as aspycore
from os.path import join
from aspose.imaging.fileformats.svg import SvgImage
from aspose.imaging.imageoptions import PngOptions, SvgRasterizationOptions

dir_: str = "c:\\temp"
# Läs in en SVG-bild från en filström.
with open(join(dir_, "test.svg"), "rb") as stream:
	with SvgImage(stream) as svg_image:
		# För att rasterisera SVG måste vi ange rasteriseringsalternativ.
		rasterization_options = SvgRasterizationOptions()
		save_options = PngOptions()
		save_options.vector_rasterization_options = rasterization_options
		svg_image.save(join(dir_, "test.output.png"), save_options)

The following example shows how to convert compressed images (.emz,.wmz, *.svgz) to a raster format

from aspose.imaging import Image, Color
from aspose.imaging.imageoptions import PngOptions, VectorRasterizationOptions
from os.path import join
from aspose.pycore import as_of

files = ["example.emz", "example.wmz", "example.svgz"]
base_folder: str = join("D:", "Compressed")
for file in files:
	input_file: str = join(base_folder, file)
	out_file: str = input_file + ".png"
	with Image.load(input_file) as image:
		vector_rasterization_options = aspycore.as_of(image.get_default_options([Color.white, image.width, image.height]), VectorRasterizationOptions)
		obj_init = PngOptions()
		obj_init.vector_rasterization_options = vector_rasterization_options
		image.save(out_file, obj_init)

The following example shows how to convert a svgz images to svg fromat

import aspose.pycore as aspycore
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import SvgRasterizationOptions, SvgOptions
from os.path import join

file: str = "example.svgz"
base_folder: str = join("D:", "Compressed")
input_file: str = join(base_folder, file)
out_file: str = input_file + ".svg"
with Image.load(input_file) as image:
	obj_init = SvgRasterizationOptions()
	obj_init.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = SvgOptions()
	obj_init2.vector_rasterization_options = obj_init
	image.save(out_file, obj_init2)

The following example shows how to convert a svg images to svgz format


from os.path import join as path_combine
import aspose.pycore as aspycore
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import SvgRasterizationOptions, SvgOptions

file = "juanmontoya_lingerie.svg"
base_folder = path_combine("D:", "Compressed")
input_file = path_combine(base_folder, file)
out_file = input_file + ".svgz"
with Image.load(input_file) as image:
	vector_rasterization_options = SvgRasterizationOptions()
	vector_rasterization_options.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = SvgOptions()
	obj_init2.vector_rasterization_options = vector_rasterization_options
	obj_init2.compress = True
	image.save(out_file, obj_init2)