SoftwareBitmap Класс

Определение

Пространство имен:

Windows.Graphics.Imaging

Представляет несжатое растровое изображение.

public ref class SoftwareBitmap sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.GCPressure]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Graphics.Imaging.ISoftwareBitmapFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class SoftwareBitmap final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.GCPressure]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Graphics.Imaging.ISoftwareBitmapFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SoftwareBitmap : System.IDisposable

function SoftwareBitmap(format, width, height, alpha)

Public NotInheritable Class SoftwareBitmap
Implements IDisposable

Наследование

Object Platform::Object IInspectable SoftwareBitmap

Атрибуты

ActivatableAttribute ContractVersionAttribute GCPressureAttribute MarshalingBehaviorAttribute ThreadingAttribute

Реализации

IClosable IDisposable

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

Примеры приложений, использующих этот класс, включают пример кадров камеры.

Пример кода, показывающий, как получить доступ к данным в пикселях, см. в разделе Свойство WriteableBitmap.PixelBuffer (см. также CopyToBuffer и CopyFromBuffer).

Комментарии

Этот класс предоставляет представление растрового рисунка, что упрощает его использование с различными API-интерфейсами создания образов. Используйте GetSoftwareBitmapAsync , чтобы создать SoftwareBitmap из ресурса потока, например файла изображения.

Используйте CopyToBuffer и CopyFromBuffer для копирования данных о пикселях между SoftwareBitmap и PixelBufferобъекта WriteableBitmap. Используйте CreateCopyFromSurfaceAsync для создания SoftwareBitmap из IDirect3DSurface. Используйте ISoftwareBitmapNativeFactory::CreateFromMF2DBuffer2 для создания SoftwareBitmap из IMF2DBuffer2. Используйте ISoftwareBitmapNativeFactory::CreateFromIWICBitmap для создания SoftwareBitmap на основе IWICBitmap.

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

SoftwareBitmap(BitmapPixelFormat, Int32, Int32)	Инициализирует новый экземпляр класса SoftwareBitmap .
SoftwareBitmap(BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	Инициализирует новый экземпляр класса SoftwareBitmap .

Свойства

BitmapAlphaMode	Возвращает альфа-режим программного растрового изображения.
BitmapPixelFormat	Возвращает формат пикселей программного растрового изображения.
DpiX	Получает или задает точки на дюйм программного растрового изображения в направлении X.
DpiY	Получает или задает точки на дюйм программного растрового изображения в направлении Y.
IsReadOnly	Возвращает значение, указывающее, можно ли изменить точечный рисунок программного обеспечения.
PixelHeight	Возвращает высоту программного растрового изображения в пикселях.
PixelWidth	Возвращает ширину программного растрового изображения в пикселях.

Методы

Close()	Удаляет объект и связанные с ним ресурсы.
Convert(SoftwareBitmap, BitmapPixelFormat)	Преобразует существующий объект SoftwareBitmap в SoftwareBitmap с другим форматом пикселей.
Convert(SoftwareBitmap, BitmapPixelFormat, BitmapAlphaMode)	Преобразует существующий объект SoftwareBitmap в SoftwareBitmap с другим форматом пикселей или альфа-режимом.
Copy(SoftwareBitmap)	Создает копию предоставленного объекта SoftwareBitmap .
CopyFromBuffer(IBuffer)	Копирует данные о пикселях из IBuffer в SoftwareBitmap.
CopyTo(SoftwareBitmap)	Копирует текущий объект SoftwareBitmap в предоставленный объект SoftwareBitmap .
CopyToBuffer(IBuffer)	Копирует данные пикселей программного растрового изображения в указанный IBuffer.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32)	Создает новый объект SoftwareBitmap , выполняя глубокую копию предоставленного буфера. Изменения данных в новой программе SoftwareBitmap не повлияют на буфер, из которого они были созданы.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	Создает новый объект SoftwareBitmap , выполняя глубокую копию предоставленного буфера. Изменения данных в новой программе SoftwareBitmap не повлияют на буфер, из которого они были созданы.
CreateCopyFromSurfaceAsync(IDirect3DSurface)	Асинхронно создает новый объект SoftwareBitmap , выполняя глубокую копию предоставленного IDirect3DSurface. Изменения данных в новой программе SoftwareBitmap не повлияют на поверхность, из которой они были созданы.
CreateCopyFromSurfaceAsync(IDirect3DSurface, BitmapAlphaMode)	Асинхронно создает новый объект SoftwareBitmap , выполняя глубокую копию предоставленного IDirect3DSurface. Изменения данных в новой программе SoftwareBitmap не повлияют на поверхность, из которой они были созданы.
Dispose()	Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.
GetReadOnlyView()	Возвращает доступное только для чтения представление объекта SoftwareBitmap .
LockBuffer(BitmapBufferAccessMode)	Возвращает объект BitmapBuffer , который позволяет работать непосредственно с данными точечного изображения программного обеспечения.

См. также раздел

• IClosable
• Пример кадров камеры