BitmapPalette 建構函式

定義

命名空間:

System.Windows.Media.Imaging

組件:

PresentationCore.dll

初始化 BitmapPalette 類別的新執行個體。

多載

BitmapPalette(IList<Color>)	使用指定的色彩，初始化 BitmapPalette 類別的新執行個體。
BitmapPalette(BitmapSource, Int32)	根據指定的 BitmapSource，初始化 BitmapPalette 類別的新執行個體。 新的 BitmapPalette 限制為指定的最大色彩計數。

BitmapPalette(IList<Color>)

使用指定的色彩，初始化 BitmapPalette 類別的新執行個體。

public:
 BitmapPalette(System::Collections::Generic::IList<System::Windows::Media::Color> ^ colors);

public BitmapPalette (System.Collections.Generic.IList<System.Windows.Media.Color> colors);

new System.Windows.Media.Imaging.BitmapPalette : System.Collections.Generic.IList<System.Windows.Media.Color> -> System.Windows.Media.Imaging.BitmapPalette

Public Sub New (colors As IList(Of Color))

參數

colors

IList<Color>

要加入至自訂調色盤的色彩。

例外狀況

ArgumentNullException

colors 參數為 null。

InvalidOperationException

colors 參數小於 1 或大於 256。

範例

下列範例示範如何定義自訂 BitmapPalette ，並將其套用至新的 BitmapSource 。

int width = 128;
int height = width;
int stride = width/8;
byte[] pixels = new byte[height*stride];

// Try creating a new image with a custom palette.
List<System.Windows.Media.Color> colors = new List<System.Windows.Media.Color>();
colors.Add(System.Windows.Media.Colors.Red);
colors.Add(System.Windows.Media.Colors.Blue);
colors.Add(System.Windows.Media.Colors.Green);
BitmapPalette myPalette = new BitmapPalette(colors);

// Creates a new empty image with the pre-defined palette

BitmapSource image = BitmapSource.Create(
    width,
    height,
    96,
    96,
    PixelFormats.Indexed1,
    myPalette, 
    pixels, 
    stride);

FileStream stream = new FileStream("empty.tif", FileMode.Create);
TiffBitmapEncoder encoder = new TiffBitmapEncoder();
TextBlock myTextBlock = new TextBlock();
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString();
encoder.Frames.Add(BitmapFrame.Create(image));
MessageBox.Show(myPalette.Colors.Count.ToString());
encoder.Save(stream);

Dim width As Integer = 128
Dim height As Integer = width
Dim stride As Integer = CType(width / 8, Integer)
Dim pixels(height * stride) As Byte

' Try creating a new image with a custom palette.
Dim colors As New List(Of System.Windows.Media.Color)()
colors.Add(System.Windows.Media.Colors.Red)
colors.Add(System.Windows.Media.Colors.Blue)
colors.Add(System.Windows.Media.Colors.Green)
Dim myPalette As New BitmapPalette(colors)

' Creates a new empty image with the pre-defined palette
Dim image As BitmapSource = System.Windows.Media.Imaging.BitmapSource.Create(width, height, 96, 96, PixelFormats.Indexed1, myPalette, pixels, stride)
Dim stream As New FileStream("empty.tif", FileMode.Create)
Dim encoder As New TiffBitmapEncoder()
Dim myTextBlock As New TextBlock()
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString()
encoder.Frames.Add(BitmapFrame.Create(image))
MessageBox.Show(myPalette.Colors.Count.ToString())
encoder.Save(stream)

另請參閱

• Colors

BitmapPalette(BitmapSource, Int32)

根據指定的 BitmapSource，初始化 BitmapPalette 類別的新執行個體。 新的 BitmapPalette 限制為指定的最大色彩計數。

public:
 BitmapPalette(System::Windows::Media::Imaging::BitmapSource ^ bitmapSource, int maxColorCount);

public BitmapPalette (System.Windows.Media.Imaging.BitmapSource bitmapSource, int maxColorCount);

new System.Windows.Media.Imaging.BitmapPalette : System.Windows.Media.Imaging.BitmapSource * int -> System.Windows.Media.Imaging.BitmapPalette

Public Sub New (bitmapSource As BitmapSource, maxColorCount As Integer)

參數

bitmapSource

BitmapSource

從中讀取或建構調色盤的來源點陣圖。

maxColorCount

Int32

新 BitmapPalette 可使用的最大色彩數目。

例外狀況

ArgumentNullException

bitmapSource 參數為 null。

範例

下列範例示範如何從映射擷取 BitmapPalette 。

// Get the palette from an image
BitmapImage image2 = new BitmapImage();
image2.BeginInit();
image2.UriSource = new Uri("tulipfarm.tif", UriKind.RelativeOrAbsolute);
image2.EndInit();
BitmapPalette myPalette3 = new BitmapPalette(image2, 256);

//Draw the third Image
Image myImage2 = new Image();
myImage2.Source = image2;
myImage2.Stretch = Stretch.None;
myImage2.Margin = new Thickness(20);

' Get the palette from an image
Dim image2 As New BitmapImage()
image2.BeginInit()
image2.UriSource = New Uri("tulipfarm.tif", UriKind.RelativeOrAbsolute)
image2.EndInit()
Dim myPalette3 As New BitmapPalette(image2, 256)

'Draw the third Image
Dim myImage2 As New Image()
myImage2.Source = image2
myImage2.Stretch = Stretch.None
myImage2.Margin = New Thickness(20)

備註

bitmapSource如果 已經有已定義的調色盤，則會傳回對應的調色盤。 否則，會從點陣圖的分析建構新的調色盤。

另請參閱

• BitmapPalettes