BitmapEncoder Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Кодирует коллекцию BitmapFrame объектов в поток изображений.
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 класс для кодирования изображения.
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)
Комментарии
Производный кодек также может обеспечить поддержку специализированных свойств кодирования, которые используются для определения кодирования растрового изображения. Например, кодек может поддерживать специализированные процедуры сжатия или чередовку закодированного изображения.
Можно указать несколько кадров для любого производного кодировщика, даже если формат растрового изображения поддерживает только один кадр. В этом случае сохраняется только первый кадр.
Коллекция кадров может быть закодирована по одному в любое количество файловых потоков.
Кодировка не работает в частичном доверии. Сведения о частичном доверии см. в разделе "Безопасность частичного доверия WPF ".
Конструкторы
| Имя | Описание |
|---|---|
| BitmapEncoder() |
Инициализирует новый экземпляр класса BitmapEncoder. |
Свойства
| Имя | Описание |
|---|---|
| CodecInfo |
Возвращает сведения, описывающие этот кодек. |
| ColorContexts |
Возвращает или задает значение, представляющее цветовой профиль, связанный с этим кодировщиком. |
| Dispatcher |
Dispatcher Возвращает это DispatcherObject значение, с которым связано. (Унаследовано от DispatcherObject) |
| Frames |
Возвращает или задает отдельные кадры в изображении. |
| Metadata |
Возвращает или задает метаданные, которые будут связаны с этим растровым изображением во время кодирования. |
| Palette |
Возвращает или задает значение, представляющее BitmapPalette закодированное растровое изображение. |
| Preview |
Возвращает или задает объект BitmapSource , представляющий глобальную предварительную версию растрового изображения, если он есть. |
| Thumbnail |
Возвращает или задает объект BitmapSource , представляющий глобальный внедренный эскиз. |
Методы
| Имя | Описание |
|---|---|
| CheckAccess() |
Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject) |
| Create(Guid) |
Создает из BitmapEncoder объекта, Guid определяющего нужный формат растрового изображения. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| Save(Stream) |
Кодирует растровое изображение в указанный Streamобъект. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| VerifyAccess() |
Принудительно применяет, что вызывающий поток имеет доступ к этому DispatcherObject. (Унаследовано от DispatcherObject) |