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)

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

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