PngOptions Classe

Summary: Create high-quality Portable Network Graphics (PNG) raster images effortlessly
with our API, offering customizable options for compression levels,
bits per pixel depths, and alpha bits. Seamlessly process XMP metadata containers,
ensuring comprehensive image metadata management, and empowering you to tailor
PNG images to your exact specifications with ease.

Module: aspose.imaging.imageoptions

Full Name: aspose.imaging.imageoptions.PngOptions

Inheritance: IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, ImageOptionsBase

Constructors

Name	Descrizione
PngOptions()	Inizializza una nuova istanza della classe PngOptions.
PngOptions(png_options)	Inizializza una nuova istanza della classe PngOptions.

Properties

Name	Type	Access	Descrizione
DEFAULT_COMPRESSION_LEVEL [static]	PngCompressionLevel	r	Il livello di compressione predefinito.
bit_depth	System.Byte	r/w	Ottiene o imposta i valori di profondità di bit nell’intervallo 1, 2, 4, 8, 16. Tenere presente i seguenti limiti: PngColorType.INDEXED_COLOR supporta una profondità di bit di 1, 2, 4, 8. PngColorType.GRAYSCALE, PngColorType.GRAYSCALE_WITH_ALPHA supportano una profondità di bit di 8. PngColorType.TRUECOLOR, PngColorType.TRUECOLOR_WITH_ALPHA supportano una profondità di bit di 8, 16.
buffer_size_hint	int	r/w	Ottiene o imposta il suggerimento della dimensione del buffer, che è definito come dimensione massima consentita per tutti i buffer interni.
color_type	PngColorType	r/w	Ottiene o imposta il tipo di colore.
compression_level	int	r/w	Ottiene o imposta il livello di compressione del PngImage.
eliminato	bool	r	Ottiene un valore che indica se questa istanza è stata eliminata.
exif_data	ExifData	r/w	Ottiene o imposta i dati Exif.
filter_type	PngFilterType	r/w	Ottiene o imposta il tipo di filtro utilizzato durante il processo di salvataggio del file png.
full_frame	bool	r/w	Ottiene o imposta un valore che indica se [full frame].
keep_metadata	bool	r/w	Ottiene un valore che indica se mantenere i metadati originali dell’immagine durante l’esportazione.
multi_page_options	MultiPageOptions	r/w	Le opzioni multipagina
palette	IColorPalette	r/w	Ottiene o imposta la tavolozza dei colori.
png_compression_level	PngCompressionLevel	r/w	Ottiene o imposta il livello di compressione del PngImage.
progressive	bool	r/w	Ottiene o imposta un valore che indica se un PngImage è progressivo.
resolution_settings	ResolutionSetting	r/w	Ottiene o imposta le impostazioni di risoluzione.
source	Source	r/w	Ottiene o imposta la sorgente in cui creare l’immagine.
vector_rasterization_options	VectorRasterizationOptions	r/w	Ottiene o imposta le opzioni di rasterizzazione vettoriale.
xmp_data	XmpPacketWrapper	r/w	Ottiene o imposta il contenitore dei metadati XMP.

Methods

Name	Descrizione
clone()	Crea una clonazione membro per membro di questa istanza.
try_set_metadata(metadata)	Cerca di impostare un’istanza metadata, se questa istanza di Image supporta e implementa l’istanza IImageMetadataFormat.

Constructor: PngOptions()

 PngOptions()

Inizializza una nuova istanza della classe PngOptions.

Constructor: PngOptions(png_options)

 PngOptions(png_options)

Inizializza una nuova istanza della classe PngOptions.

Parameters:

Parametro	Tipo	Descrizione
png_options	PngOptions	Le opzioni PNG.

Property: color_type

Ottiene o imposta il tipo di colore.

See also:

Example # 1: The following example shows how to compress a PNG image, using indexed color …

Property: compression_level

Ottiene o imposta il livello di compressione del PngImage.

See also:

Example # 1: The following example shows how to compress a PNG image, using indexed color …

Property: progressive

Ottiene o imposta un valore che indica se un PngImage è progressivo.

See also:

Example # 1: The following example shows how to compress a PNG image, using indexed color …

Method: clone()

 clone()

Crea una clonazione membro per membro di questa istanza.

Returns

Tipo	Descrizione
ImageOptionsBase	Una clonazione membro per membro di questa istanza.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata)

Cerca di impostare un’istanza metadata, se questa istanza di Image supporta e implementa l’istanza IImageMetadataFormat.

Parameters:

Parametro	Tipo	Descrizione
metadata	IImageMetadataFormat	I metadati.

Returns

Tipo	Descrizione
bool	True, se l’istanza IMetadataContainer supporta e/o implementa l’istanza IImageMetadataFormat; altrimenti, false.

Examples

This example uses Graphics class to create primitive shapes on the Image surface. To demonstrate the operation, the example creates a new Image in PNG format and draw primitive shapes on Image surface using Draw methods exposed by Graphics class


from aspose.imaging import Image, RotateFlipType, Graphics, Color, Pen, Rectangle, Point, Size,\
	Font, PointF
from aspose.imaging.brushes import SolidBrush
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.psd import CompressionMethod, ColorModes
from aspose.imaging.sources import StreamSource

from os.path import join as path_join

#Crea un'istanza di flusso file
with open(r"C:\temp\output.png", "w+b") as stream:
	#Crea un'istanza di PngOptions e imposta le sue varie proprietà
	pngOptions = PngOptions()
	#Imposta la sorgente per PngOptions
	pngOptions.source = StreamSource(stream)
	#Crea un'istanza di Image 
	with Image.create(pngOptions, 500, 500) as image:
		#Crea e inizializza un'istanza della classe Graphics
		graphics = Graphics(image)
		#Cancella la superficie Graphics
		graphics.clear(Color.wheat);
		#Disegna un arco specificando l'oggetto Pen con colore Nero, 
		#un rettangolo che circonda l'arco, angolo di partenza e angolo di sweep
		graphics.draw_arc(Pen(Color.black, 2.0), Rectangle(200, 200, 100, 200), 0, 300)
		#Disegna un Bezier specificando l'oggetto Pen con colore Blu e i punti di coordinate.
		graphics.draw_bezier(Pen(Color.blue, 2.0), Point(250, 100), Point(300, 30), Point(450, 100), Point(235, 25))
		#Disegna una curva specificando l'oggetto Pen con colore Verde e un array di Points
		graphics.draw_curve(Pen(Color.green, 2.0), [Point(100, 200), Point(100, 350), Point(200, 450)])
		#Disegna un'ellisse usando l'oggetto Pen e un Rectangle circostante
		graphics.draw_ellipse(Pen(Color.yellow, 2.0), Rectangle(300, 300, 100, 100))
		#Disegna una linea
		graphics.draw_line(Pen(Color.violet, 2.0), Point(100, 100), Point(200, 200))
		#Disegna un segmento di torta
		graphics.draw_pie(Pen(Color.silver, 2.0), Rectangle(Point(200, 20), Size(200, 200)), 0, 45);
		#Disegna un poligono specificando l'oggetto Pen con colore Rosso e un array di Points
		graphics.draw_polygon(Pen(Color.red, 2.0), [Point(20, 100), Point(20, 200), Point(220, 20)])
		#Disegna un Rectangle
		graphics.draw_rectangle(Pen(Color.orange, 2.0), Rectangle(Point(250, 250), Size(100, 100)))
		#Crea un oggetto SolidBrush e imposta le sue varie proprietà
		brush = SolidBrush()
		brush.color = Color.purple
		#Disegna una String usando l'oggetto SolidBrush e Font, in un Point specifico
		graphics.draw_string("This image is created by Aspose.Imaging API", Font("Times New Roman", 16),
							 brush, PointF(50.0, 400.0))
		# salva tutte le modifiche.
		image.save();

This example demonstrates the use of different classes from `imageoptions` package for export purposes. A gif image is loaded as an instance of Image and then exported out to several formats.


from aspose.imaging import Image
from aspose.imaging.imageoptions import BmpOptions, JpegOptions, PngOptions, TiffOptions
from aspose.imaging.fileformats.tiff.enums import TiffExpectedFormat
from os.path import join as path_join

directory = "c:\\temp\\"
#Carica un'immagine gif esistente come istanza della classe Image
with Image.load(path_join(directory, "sample.gif")) as image:
	# Esporta nel formato file BMP utilizzando le opzioni predefinite
	image.save(path_join(directory, "output.bmp"), BmpOptions())
	# Esporta nel formato file JPEG utilizzando le opzioni predefinite
	image.save(path_join(directory, "output.jpg"), JpegOptions())
	# Esporta nel formato file PNG utilizzando le opzioni predefinite
	image.save(path_join(directory, "output.png"), PngOptions())
	# Esporta nel formato file TIFF utilizzando le opzioni predefinite
	image.save(path_join(directory, "output.tif"), TiffOptions(TiffExpectedFormat.DEFAULT))

The following example shows how to compress a PNG image, using indexed color with best fit palette


from aspose.pycore import as_of
from aspose.imaging import Image, ColorPaletteHelper, RasterImage, PaletteMiningMethod
from aspose.imaging.fileformats.png import PngColorType

# Carica immagine PNG        
sourceFilePath = "OriginalRings.png"
outputFilePath = "OriginalRingsOutput.png"
with Image.load(sourceFilePath) as image:
	png_options = PngOptions()
	png_options.progressive = True
	# Usa il tipo di colore indicizzato
	png_options.color_type = PngColorType.INDEXED_COLOR
	# Usa compressione massima
	png_options.compression_level = 9
	# Ottieni la tavolozza di colori a 8 bit più vicina, coprendo il maggior numero possibile di pixel, in modo che un'immagine
	# con palette sia quasi indistinguibile visivamente da un'immagine senza palette.
	png_options.palette = ColorPaletteHelper.get_close_image_palette(
						as_of(image, RasterImage), 256, 
						PaletteMiningMethod.HISTOGRAM)
		 
	image.save(outputFilePath, png_options);
}
# La dimensione del file di output dovrebbe essere notevolmente ridotta

Classe PdfOptions Classe PsdOptions

PngOptions Classe

Constructors

Properties

Methods

Constructor: PngOptions()

Constructor: PngOptions(png_options)

Property: color_type

Property: compression_level

Property: progressive

Method: clone()

Method: try_set_metadata(metadata)

Examples

This example uses Graphics class to create primitive shapes on the Image surface. To demonstrate the operation, the example creates a new Image in PNG format and draw primitive shapes on Image surface using Draw methods exposed by Graphics class

This example demonstrates the use of different classes from imageoptions package for export purposes. A gif image is loaded as an instance of Image and then exported out to several formats.

The following example shows how to compress a PNG image, using indexed color with best fit palette

This example demonstrates the use of different classes from `imageoptions` package for export purposes. A gif image is loaded as an instance of Image and then exported out to several formats.