BitmapEncoder Klasa

Definicja

Koduje kolekcję BitmapFrame obiektów w strumieniu obrazu.Encodes a collection of BitmapFrame objects to an image stream.

public ref class BitmapEncoder abstract : System::Windows::Threading::DispatcherObject
public abstract class BitmapEncoder : System.Windows.Threading.DispatcherObject
type BitmapEncoder = class
    inherit DispatcherObject
Public MustInherit Class BitmapEncoder
Inherits DispatcherObject
Dziedziczenie
BitmapEncoder
Pochodne

Przykłady

Poniższy przykład ilustruje sposób użycia TiffBitmapEncoder klasy pochodnej do kodowania obrazu.The following example demonstrates how to use the derived TiffBitmapEncoder class to encode an image.

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

Uwagi

Pochodny koder-dekoder może również zapewnić obsługę wyspecjalizowanych właściwości kodowania, które są używane do określania sposobu kodowania mapy bitowej.A derived codec may also provide support for specialized encoding properties, which are used to determine how a bitmap is encoded. Na przykład koder-dekoder może obsługiwać wyspecjalizowane procedury kompresji lub przeplatanie zaszyfrowanego obrazu.For example, a codec may support specialized compression routines or interlacing of an encoded image.

Można określić wiele ramek dla dowolnego kodera pochodnego, nawet jeśli format mapy bitowej obsługuje tylko jedną ramkę.You can specify multiple frames for any derived encoder, even if the bitmap format only supports one frame. W takim przypadku tylko pierwsza ramka jest zapisywana.In this case, only the first frame is saved.

Kolekcje ramek można zakodować pojedynczo do dowolnej liczby strumieni plików.The collection of frames can be encoded one at a time to any number of file streams.

Kodowanie nie działa w częściowej relacji zaufania.Encoding does not work in partial trust. Aby uzyskać informacje dotyczące częściowej relacji zaufania, zobacz temat zabezpieczenia częściowej relacji zaufania WPF .See WPF Partial Trust Security for information on partial trust.

Konstruktory

BitmapEncoder()

Inicjuje nowe wystąpienie klasy BitmapEncoder.Initializes a new instance of the BitmapEncoder class.

Właściwości

CodecInfo

Pobiera informacje opisujące ten koder-dekoder.Gets information that describes this codec.

ColorContexts

Pobiera lub ustawia wartość reprezentującą profil koloru skojarzony z tym koderem.Gets or sets a value that represents the color profile that is associated with this encoder.

Dispatcher

Pobiera Dispatcher ten DispatcherObject program jest skojarzony z.Gets the Dispatcher this DispatcherObject is associated with.

(Odziedziczone po DispatcherObject)
Frames

Pobiera lub ustawia poszczególne ramki w obrazie.Gets or sets the individual frames within an image.

Metadata

Pobiera lub ustawia metadane, które będą skojarzone z tą mapą bitową podczas kodowania.Gets or sets the metadata that will be associated with this bitmap during encoding.

Palette

Pobiera lub ustawia wartość reprezentującą BitmapPalette zakodowaną mapę bitową.Gets or sets a value that represents the BitmapPalette of an encoded bitmap.

Preview

Pobiera lub ustawia wartość BitmapSource reprezentującą globalną wersję zapoznawczą mapy bitowej, jeśli istnieje.Gets or sets a BitmapSource that represents the global preview of a bitmap, if there is one.

Thumbnail

Pobiera lub ustawia wartość BitmapSource reprezentującą globalną miniaturę osadzoną.Gets or sets a BitmapSource that represents the global embedded thumbnail.

Metody

CheckAccess()

Określa, czy wątek wywołujący ma dostęp do tego DispatcherObject .Determines whether the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
Create(Guid)

Tworzy obiekt BitmapEncoder z Guid , który identyfikuje żądany format mapy bitowej.Creates a BitmapEncoder from a Guid that identifies the desired bitmap format.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
Save(Stream)

Koduje obraz mapy bitowej do określonego Stream .Encodes a bitmap image to a specified Stream.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
VerifyAccess()

Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject .Enforces that the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)

Dotyczy

Zobacz też