Поделиться через


SoftwareBitmap Класс

Определение

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

public ref class SoftwareBitmap sealed : IClosable
/// [Windows.Foundation.Metadata.Activatable(Windows.Graphics.Imaging.ISoftwareBitmapFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class SoftwareBitmap final : 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.Activatable(typeof(Windows.Graphics.Imaging.ISoftwareBitmapFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class SoftwareBitmap : System.IDisposable
[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
Атрибуты
Реализации

Требования к 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 , который позволяет работать непосредственно с данными точечного изображения программного обеспечения.

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

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