BitmapEncoder BitmapEncoder BitmapEncoder BitmapEncoder Class

Определение

Кодирует коллекцию объектов BitmapFrame в поток изображений.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
Наследование
Производный

Примеры

В следующем примере показано, как использовать производный TiffBitmapEncoder класс для кодирования изображения.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)

Комментарии

Производный кодек может также предоставлять поддержку специализированных свойств кодировки, которые используются для определения способа кодирования битовой карты.A derived codec may also provide support for specialized encoding properties, which are used to determine how a bitmap is encoded. Например, кодек может поддерживать специализированные подпрограммы сжатия или чересстрочную развертку закодированного изображения.For example, a codec may support specialized compression routines or interlacing of an encoded image.

Можно указать несколько кадров для любого производного кодировщика, даже если формат точечных рисунков поддерживает только один кадр.You can specify multiple frames for any derived encoder, even if the bitmap format only supports one frame. В этом случае сохраняется только первый кадр.In this case, only the first frame is saved.

Коллекцию фреймов можно закодировать по одной за раз в любое количество файловых потоков.The collection of frames can be encoded one at a time to any number of file streams.

Кодирование не работает при частичном доверии.Encoding does not work in partial trust. Сведения о частичном доверии см. в разделе Безопасность частичного доверия в WPF .See WPF Partial Trust Security for information on partial trust.

Конструкторы

BitmapEncoder() BitmapEncoder() BitmapEncoder() BitmapEncoder()

Инициализирует новый экземпляр класса BitmapEncoder.Initializes a new instance of the BitmapEncoder class.

Свойства

CodecInfo CodecInfo CodecInfo CodecInfo

Получает сведения, описывающие этот кодек.Gets information that describes this codec.

ColorContexts ColorContexts ColorContexts ColorContexts

Получает или задает значение, представляющее профиль цветов, привязанный к данному кодировщику.Gets or sets a value that represents the color profile that is associated with this encoder.

Dispatcher Dispatcher Dispatcher Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
Frames Frames Frames Frames

Получает или задает отдельные фреймы для изображения.Gets or sets the individual frames within an image.

Metadata Metadata Metadata Metadata

Получает или задает метаданные, которые будут связаны с этой битовой картой во время кодирования.Gets or sets the metadata that will be associated with this bitmap during encoding.

Palette Palette Palette Palette

Возвращает или задает значение, представляющее палитру BitmapPalette закодированного растрового изображения.Gets or sets a value that represents the BitmapPalette of an encoded bitmap.

Preview Preview Preview Preview

Возвращает или задает BitmapSource, представляющий глобальный предварительный просмотр растрового изображения, если он определен.Gets or sets a BitmapSource that represents the global preview of a bitmap, if there is one.

Thumbnail Thumbnail Thumbnail Thumbnail

Возвращает или задает объект BitmapSource, который представляет глобальный внедренный эскиз.Gets or sets a BitmapSource that represents the global embedded thumbnail.

Методы

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
Create(Guid) Create(Guid) Create(Guid) Create(Guid)

Создает BitmapEncoder из объекта Guid, который идентифицирует необходимый формат растрового изображения.Creates a BitmapEncoder from a Guid that identifies the desired bitmap format.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Save(Stream) Save(Stream) Save(Stream) Save(Stream)

Кодирует растровое изображение в указанный поток Stream.Encodes a bitmap image to a specified Stream.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Применяется к

Дополнительно