BitmapPalette Classe

Definizione

Spazio dei nomi:

System.Windows.Media.Imaging

Assembly:

PresentationCore.dll

Definisce la tavolozza dei colori disponibili per un tipo di immagine supportato.

public ref class BitmapPalette sealed : System::Windows::Threading::DispatcherObject

public sealed class BitmapPalette : System.Windows.Threading.DispatcherObject

type BitmapPalette = class
    inherit DispatcherObject

Public NotInheritable Class BitmapPalette
Inherits DispatcherObject

Ereditarietà

Object

DispatcherObject

BitmapPalette

Esempio

Nell'esempio seguente viene illustrato come definire un oggetto personalizzato BitmapPalette e applicarlo a un nuovo BitmapSourceoggetto .

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)

Nell'esempio seguente viene illustrato come recuperare un BitmapPalette oggetto da un'immagine.

// 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)

Commenti

Solo i formati di immagine TIFF (Tagged Image File Format) e GIF (Graphics Interchange Format) supportano le tavolozze delle immagini. Tuttavia, è possibile usare altri tipi di immagine per definire un oggetto BitmapPalette. Il tentativo di definire un BitmapPalette oggetto per un formato bitmap non supportato non genera un'eccezione. L'oggetto designato BitmapPalette viene semplicemente ignorato.

Windows Presentation Foundation (WPF) supporta sia le tavolozze dei colori personalizzate che le tavolozze predefinite definite dalla BitmapPalettes classe .

Costruttori

BitmapPalette(BitmapSource, Int32)	Inizializza una nuova istanza della classe BitmapPalette in base all'oggetto BitmapSource specificato. La nuova BitmapPalette è limitata a un numero massimo di colori specificato.
BitmapPalette(IList<Color>)	Inizializza una nuova istanza della classe BitmapPalette con i colori specificati.

Proprietà

Colors	Ottiene i colori definiti in una tavolozza.
Dispatcher	Ottiene l'oggetto Dispatcher associato a DispatcherObject. (Ereditato da DispatcherObject)

Metodi

CheckAccess()	Determina se il thread chiamante ha accesso a DispatcherObject. (Ereditato da DispatcherObject)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
VerifyAccess()	Impone che il thread chiamante abbia accesso a DispatcherObject. (Ereditato da DispatcherObject)

Vedi anche

• BitmapPalettes