ColorPaletteHelper Sınıfı

Summary: Helper class for color palettes manipulation.

Module: aspose.imaging

Full Name: aspose.imaging.ColorPaletteHelper

Methods

Name	Açıklama
create_4_bit()	4 bit renk paletini oluşturur.
create_4_bit_grayscale(min_is_white)	4 bit gri tonlamalı paleti oluşturur.
create_8_bit()	8 bit renk paletini oluşturur.
create_8_bit_grayscale(min_is_white)	8 bit gri tonlamalı paleti oluşturur.
create_grayscale(bits)	Belirtilen bit sayısının gri tonlamalı paletini alır. İzin verilen bit değerleri 1, 2, 4, 8’dir.
create_monochrome()	Yalnızca 2 renk içeren bir monokrom renk paleti oluşturur.
get_close_image_palette(image, dest_bounds, entries_count)	Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet mevcutsa, hesaplamalar yerine bu palet kullanılacaktır.
get_close_image_palette(image, dest_bounds, entries_count, use_image_palette)	Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet mevcutsa, hesaplamalar yerine bu palet kullanılacaktır.
get_close_image_palette(image, dest_bounds, entries_count, use_image_palette, alpha_blend_in_color)	Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet mevcutsa, hesaplamalar yerine bu palet kullanılacaktır.
get_close_image_palette(image, dest_bounds, entries_count, use_image_palette, alpha_blend_in_color, keep_transparency)	Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet mevcutsa, hesaplamalar yerine bu palet kullanılacaktır.
get_close_image_palette(image, entries_count)	Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet mevcutsa, hesaplamalar yerine bu palet kullanılacaktır.
get_close_image_palette(image, entries_count, palette_mining_method)	Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet, daha iyi indeksli görüntü kalitesi için optimize edilecek veya PaletteMiningMethod.UseCurrentPalette kullanıldığında “AS IS” alınacaktır.
get_close_image_palette_by_method(image, entries_count, palette_mining_method)	Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet, daha iyi indeksli görüntü kalitesi için optimize edilecek veya PaletteMiningMethod.UseCurrentPalette kullanıldığında “AS IS” alınacaktır.
get_close_image_palette_by_rect(image, dest_bounds, entries_count)	Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet mevcutsa, hesaplamalar yerine bu palet kullanılacaktır.
get_close_transparent_image_palette(image, entries_count)	Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet mevcutsa, hesaplamalar yerine bu palet kullanılacaktır.
get_downscale_palette(image)	İlk görüntü renk değerlerinin üst bitlerinden oluşan 256 renkli paleti al.
get_uniform_color_palette(image)	Tekdüzen 256 renkli paleti al.
has_transparent_colors(palette)	Belirtilen paletin şeffaf renkleri olup olmadığını belirler.

Method: create_4_bit() [static]

 create_4_bit() 

4 bit renk paletini oluşturur.

Returns

Tür	Açıklama
IColorPalette	4 bitlik renk paleti.

Method: create_4_bit_grayscale(min_is_white) [static]

 create_4_bit_grayscale(min_is_white) 

4 bit gri tonlamalı paleti oluşturur.

Parameters:

Parameter	Tür	Açıklama
min_is_white	bool	eğer true olarak ayarlanırsa palet beyaz renkle başlar, aksi takdirde siyah renkle başlar.

Returns

Tür	Açıklama
IColorPalette	4 bitlik gri tonlamalı palet.

Method: create_8_bit() [static]

 create_8_bit() 

8 bit renk paletini oluşturur.

Returns

Tür	Açıklama
IColorPalette	8 bitlik renk paleti.

Method: create_8_bit_grayscale(min_is_white) [static]

 create_8_bit_grayscale(min_is_white) 

8 bit gri tonlamalı paleti oluşturur.

Parameters:

Parameter	Tür	Açıklama
min_is_white	bool	eğer true olarak ayarlanırsa palet beyaz renkle başlar, aksi takdirde siyah renkle başlar.

Returns

Tür	Açıklama
IColorPalette	8 bitlik gri tonlamalı palet.

Method: create_grayscale(bits) [static]

 create_grayscale(bits) 

Belirtilen bit sayısının gri tonlamalı paletini alır. İzin verilen bit değerleri 1, 2, 4, 8’dir.

Parameters:

Parameter	Tür	Açıklama
bitler	int	Bit sayısı.

Returns

Tür	Açıklama
IColorPalette	Gri tonlamalı palet.

Method: create_monochrome() [static]

 create_monochrome() 

Yalnızca 2 renk içeren bir monokrom renk paleti oluşturur.

Returns

Tür	Açıklama
IColorPalette	Monokrom görüntüler için renk paleti.

Method: get_close_image_palette(image, dest_bounds, entries_count) [static]

 get_close_image_palette(image, dest_bounds, entries_count) 

Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet mevcutsa, hesaplamalar yerine bu palet kullanılacaktır.

Parameters:

Parameter	Tür	Açıklama
image	RasterImage	Raster görüntü.
dest_bounds	Rectangle	Hedef görüntü sınırları.
entries_count	int	İstenen giriş sayısı.

Returns

Tür	Açıklama
IColorPalette	En sık kullanılan renklerle image öğesinden başlayan ve entriesCount giriş içeren renk paleti.

Method: get_close_image_palette(image, dest_bounds, entries_count, use_image_palette) [static]

 get_close_image_palette(image, dest_bounds, entries_count, use_image_palette) 

Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet mevcutsa, hesaplamalar yerine bu palet kullanılacaktır.

Parameters:

Parameter	Tür	Açıklama
image	RasterImage	Raster görüntü.
dest_bounds	Rectangle	Hedef görüntü sınırları.
entries_count	int	İstenen giriş sayısı.
use_image_palette	bool	Ayarlanırsa, mevcutsa kendi görüntü paletini kullanacaktır.

Returns

Tür	Açıklama
IColorPalette	En sık kullanılan renklerle image öğesinden başlayan ve entriesCount giriş içeren renk paleti.

Method: get_close_image_palette(image, dest_bounds, entries_count, use_image_palette, alpha_blend_in_color) [static]

 get_close_image_palette(image, dest_bounds, entries_count, use_image_palette, alpha_blend_in_color) 

Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet mevcutsa, hesaplamalar yerine bu palet kullanılacaktır.

Parameters:

Parameter	Tür	Açıklama
image	RasterImage	Raster görüntü.
dest_bounds	Rectangle	Hedef görüntü sınırları.
entries_count	int	İstenen giriş sayısı.
use_image_palette	bool	Ayarlanırsa, mevcutsa kendi görüntü paletini kullanacaktır.
alpha_blend_in_color	Color	Yarı saydam alfa değişimi için arka plan rengi olarak kullanılacak renk.

Returns

Tür	Açıklama
IColorPalette	En sık kullanılan renklerle image öğesinden başlayan ve entriesCount giriş içeren renk paleti.

Method: get_close_image_palette(image, dest_bounds, entries_count, use_image_palette, alpha_blend_in_color, keep_transparency) [static]

 get_close_image_palette(image, dest_bounds, entries_count, use_image_palette, alpha_blend_in_color, keep_transparency) 

Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet mevcutsa, hesaplamalar yerine bu palet kullanılacaktır.

Parameters:

Parameter	Tür	Açıklama
image	RasterImage	Raster görüntü.
dest_bounds	Rectangle	Hedef görüntü sınırları.
entries_count	int	İstenen giriş sayısı.
use_image_palette	bool	Ayarlanırsa, mevcutsa kendi görüntü paletini kullanacaktır.
alpha_blend_in_color	Color	Yarı saydam alfa değişimi için arka plan rengi olarak kullanılacak renk.
keep_transparency	bool	Ayarlanırsa, görüntü renklerinin alfa kanal bitlerini dikkate alacaktır.

Returns

Tür	Açıklama
IColorPalette	En sık kullanılan renklerle image öğesinden başlayan ve entriesCount giriş içeren renk paleti.

Method: get_close_image_palette(image, entries_count) [static]

 get_close_image_palette(image, entries_count) 

Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet mevcutsa, hesaplamalar yerine bu palet kullanılacaktır.

Parameters:

Parameter	Tür	Açıklama
image	RasterImage	Raster görüntü.
entries_count	int	İstenen giriş sayısı.

Returns

Tür	Açıklama
IColorPalette	En sık kullanılan renklerle image öğesinden başlayan ve entriesCount giriş içeren renk paleti.

See also:

Example # 1: The following example shows how to set a palette to a BMP image to reduce its…

Example # 2: The following example loads a BMP image and saves it back to BMP using variou…

Method: get_close_image_palette(image, entries_count, palette_mining_method) [static]

 get_close_image_palette(image, entries_count, palette_mining_method) 

Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet, daha iyi indeksli görüntü kalitesi için optimize edilecek veya PaletteMiningMethod.UseCurrentPalette kullanıldığında “AS IS” alınacaktır.

Parameters:

Parameter	Tür	Açıklama
image	RasterImage	Raster görüntü.
entries_count	int	İstenen giriş sayısı.
palette_mining_method	PaletteMiningMethod	Palet çıkarma yöntemi.

Returns

Tür	Açıklama
IColorPalette	En sık kullanılan renklerle image öğesinden başlayan ve entriesCount giriş içeren renk paleti.

See also:

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

Method: get_close_image_palette_by_method(image, entries_count, palette_mining_method) [static]

 get_close_image_palette_by_method(image, entries_count, palette_mining_method) 

Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet, daha iyi indeksli görüntü kalitesi için optimize edilecek veya PaletteMiningMethod.UseCurrentPalette kullanıldığında “AS IS” alınacaktır.

Parameters:

Parameter	Tür	Açıklama
image	RasterImage	Raster görüntü.
entries_count	int	İstenen giriş sayısı.
palette_mining_method	PaletteMiningMethod	Palet çıkarma yöntemi.

Returns

Tür	Açıklama
IColorPalette	En sık kullanılan renklerle image öğesinden başlayan ve entriesCount giriş içeren renk paleti.

Method: get_close_image_palette_by_rect(image, dest_bounds, entries_count) [static]

 get_close_image_palette_by_rect(image, dest_bounds, entries_count) 

Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet mevcutsa, hesaplamalar yerine bu palet kullanılacaktır.

Parameters:

Parameter	Tür	Açıklama
image	RasterImage	Raster görüntü.
dest_bounds	Rectangle	Hedef görüntü sınırları.
entries_count	int	İstenen giriş sayısı.

Returns

Tür	Açıklama
IColorPalette	En sık kullanılan renklerle image öğesinden başlayan ve entriesCount giriş içeren renk paleti.

Method: get_close_transparent_image_palette(image, entries_count) [static]

 get_close_transparent_image_palette(image, entries_count) 

Görüntünün bir paleti yoksa raster görüntüden renk paletini alır (görüntüyü paletler). Palet mevcutsa, hesaplamalar yerine bu palet kullanılacaktır.

Parameters:

Parameter	Tür	Açıklama
image	RasterImage	Raster görüntü.
entries_count	int	İstenen giriş sayısı.

Returns

Tür	Açıklama
IColorPalette	En sık kullanılan renklerle image öğesinden başlayan ve entriesCount giriş içeren renk paleti.

Method: get_downscale_palette(image) [static]

 get_downscale_palette(image) 

İlk görüntü renk değerlerinin üst bitlerinden oluşan 256 renkli paleti al.

Parameters:

Parameter	Tür	Açıklama
image	RasterImage	Görüntü.

Returns

Tür	Açıklama
ColorPalette	Bu ColorPalette.

Method: get_uniform_color_palette(image) [static]

 get_uniform_color_palette(image) 

Tekdüzen 256 renkli paleti al.

Parameters:

Parameter	Tür	Açıklama
image	RasterImage	Görüntü.

Returns

Tür	Açıklama
ColorPalette	Bu ColorPalette.

Method: has_transparent_colors(palette) [static]

 has_transparent_colors(palette) 

Belirtilen paletin şeffaf renkleri olup olmadığını belirler.

Parameters:

Parameter	Tür	Açıklama
palette	IColorPalette	Palet.

Returns

Tür	Açıklama
bool	true eğer belirtilen palet şeffaf renklere sahipse; aksi takdirde false.

Examples

The following example shows how to set a palette to a BMP image to reduce its output size.

from aspose.pycore import as_of
from aspose.imaging import Point, Color, Graphics, ColorPaletteHelper
from aspose.imaging.brushes import LinearGradientBrush
from aspose.imaging.fileformats.bmp import BmpImage
from aspose.imaging.imageoptions import BmpOptions
from os.path import join as path_join

# 100 x 100 piksel boyutunda bir BMP görüntüsü oluştur.
with BmpImage(100, 100) as bmpImage:
	# Görüntünün sol üst köşesinden sağ alt köşesine uzanan lineer degrade.
	brush = LinearGradientBrush(Point(0, 0), Point(bmpImage.width, bmpImage.height),
								Color.red,
								Color.green)
	# Tüm görüntüyü lineer degrade fırçası ile doldur.
	gr = Graphics(bmpImage)
	gr.fill_rectangle(brush, bmpImage.bounds)
	# Mümkün olduğunca çok pikseli kapsayan en yakın 8-bit renk paletini al, böylece paletli bir görüntü
	# paletsiz bir bmp'den neredeyse görsel olarak ayırt edilemez olur
	palette = ColorPaletteHelper.get_close_image_palette(bmpImage, 256)
	# 8-bit palet en fazla 256 renk içerir.
	saveOptions = BmpOptions()
	saveOptions.palette = palette
	saveOptions.bits_per_pixel = 8
	
	with stream_ext.create_memory_stream() as stream:
		bmpImage.save(stream, saveOptions)
		print(f"The size of image with palette is {stream.tell()} bytes.")
		stream.seek(0)
		bmpImage.save(stream)
		print(f"The size of image without palette is {stream.tell()} bytes.")

# Çıktı şu şekilde görünür:
# Paletli görüntünün boyutu 11078 bayttır.
# Paletsiz görüntünün boyutu 40054 bayttır.

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

# png görüntüsü yükler        
sourceFilePath = "OriginalRings.png"
outputFilePath = "OriginalRingsOutput.png"
with Image.load(sourceFilePath) as image:
	png_options = PngOptions()
	png_options.progressive = True
	# Dizine dayalı renk türünü kullan
	png_options.color_type = PngColorType.INDEXED_COLOR
	# Maksimum sıkıştırmayı kullan
	png_options.compression_level = 9
	# Mümkün olduğunca çok pikseli kapsayan en yakın 8-bit renk paletini al, böylece bir görüntü
	# paletli, paletsiz bir görüntüden neredeyse görsel olarak ayırt edilemez.
	png_options.palette = ColorPaletteHelper.get_close_image_palette(
						as_of(image, RasterImage), 256, 
						PaletteMiningMethod.HISTOGRAM)
		 
	image.save(outputFilePath, png_options);
}
# Çıktı dosya boyutu önemli ölçüde azaltılmalıdır.

The following example loads a BMP image and saves it back to BMP using various save options.

from aspose.imaging import Image, RasterImage, ColorPaletteHelper, ResolutionSetting
from aspose.imaging.imageoptions import BmpOptions
from aspose.imaging.fileformats.bmp import BitmapCompression
import os
import aspose.pycore as aspycore

directory = "c:\\temp\\"

with Image.load(os.path.join(directory, "sample.bmp")) as image:
	
	rasterImage = aspycore.as_of(image, RasterImage)

	# BmpOptions oluştur
	saveOptions = BmpOptions()

	# Çıktı görüntüsünün boyutunu azaltmak için piksel başına 8 bit kullan.
	saveOptions.bits_per_pixel = 8

	# Görüntü piksellerinin en yüksek sayısını kapsayan en yakın 8-bit renk paletini ayarla, böylece paletli bir görüntü
	# neredeyse görsel olarak paletlenmemiş birine fark edilemez.
	saveOptions.palette = ColorPaletteHelper.get_close_image_palette(rasterImage, 256)

	# Sıkıştırma olmadan kaydet.
	# Çıktı görüntüsünün boyutunu azaltmak için RLE-8 sıkıştırmasını da kullanabilirsiniz.
	saveOptions.compression = BitmapCompression.RGB

	# Yatay ve dikey çözünürlüğü 96 dpi olarak ayarlayın.
	saveOptions.resolution_settings = ResolutionSetting(96.0, 96.0)

	image.save(os.path.join(directory, "sample.bmpoptions.bmp"), saveOptions)