WriteableBitmap 클래스

정의

네임스페이스:

Windows.UI.Xaml.Media.Imaging

쓰고 업데이트할 수 있는 BitmapSource를 제공합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Imaging.WriteableBitmap(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

public ref class WriteableBitmap sealed : BitmapSource

/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Xaml.Media.Imaging.IWriteableBitmapFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class WriteableBitmap final : BitmapSource

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Xaml.Media.Imaging.IWriteableBitmapFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class WriteableBitmap final : BitmapSource

[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Xaml.Media.Imaging.IWriteableBitmapFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class WriteableBitmap : BitmapSource

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Xaml.Media.Imaging.IWriteableBitmapFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class WriteableBitmap : BitmapSource

Public NotInheritable Class WriteableBitmap
Inherits BitmapSource

상속

Object IInspectable DependencyObject ImageSource BitmapSource WriteableBitmap

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

C#, C++/WinRT 및 C++/CX의 코드 예제는 다음을 참조하세요 WriteableBitmap.PixelBuffer.

설명

WriteableBitmap의 이미지 원본 데이터는 기본 픽셀 버퍼입니다.

반환된 WriteableBitmap.PixelBuffer IBuffer는 직접 쓸 수 없습니다. 그러나 언어별 기술을 사용하여 버퍼의 기본 픽셀 콘텐츠에 쓸 수 있습니다. 자세한 내용은 의 설명 섹션 WriteableBitmap.PixelBuffer을 참조하세요.

이전 XAML 프레임워크에서 WriteableBitmap 클래스를 사용했을 수 있는 시나리오 중 일부는 대신 클래스를 사용하여 RenderTargetBitmap Windows 런타임 수행할 수 있습니다. 자세한 내용은 RenderTargetBitmap 를 참조하세요.

생성자

WriteableBitmap(Int32, Int32)

WriteableBitmap 클래스의 새 인스턴스를 초기화합니다.

속성

Dispatcher	이 개체가 CoreDispatcher 연결된 개체를 가져옵니다. 코드 CoreDispatcher 가 비 UI 스레드에서 시작되는 경우에도 UI 스레드에 액세스할 DependencyObject 수 있는 기능을 나타냅니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.Dispatcher(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
PixelBuffer	각 픽셀이 기록되는 직접 버퍼에 WriteableBitmap 대한 액세스를 가져옵니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Imaging.WriteableBitmap.PixelBuffer(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
PixelHeight	비트맵의 높이를 픽셀 단위로 가져옵니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Imaging.BitmapSource.PixelHeight(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 BitmapSource)
PixelWidth	비트맵의 너비를 픽셀 단위로 가져옵니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Imaging.BitmapSource.PixelWidth(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 BitmapSource)

메서드

ClearValue(DependencyProperty)	종속성 속성의 로컬 값을 지웁니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.ClearValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	애니메이션이 활성화되지 않은 경우에 적용되는 종속성 속성에 대해 설정된 기본 값을 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.GetAnimationBaseValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
GetValue(DependencyProperty)	에서 종속성 속성 DependencyObject의 현재 유효 값을 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.GetValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
Invalidate()	전체 비트맵의 그리기 또는 다시 그리기를 요청합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Imaging.WriteableBitmap.Invalidate(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ReadLocalValue(DependencyProperty)	로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.ReadLocalValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	이 DependencyObject 인스턴스의 특정 DependencyProperty 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.RegisterPropertyChangedCallback(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
SetSource(IRandomAccessStream)	스트림에 액세스하여 원본 BitmapSource 이미지를 설정합니다. 대부분의 호출자는 대신 사용해야 SetSourceAsync 합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Imaging.BitmapSource.SetSource(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 BitmapSource)
SetSourceAsync(IRandomAccessStream)	스트림에 BitmapSource 액세스하고 결과를 비동기적으로 처리하여 원본 이미지를 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Imaging.BitmapSource.SetSourceAsync(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 BitmapSource)
SetValue(DependencyProperty, Object)	에 종속성 속성 DependencyObject의 로컬 값을 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.SetValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	를 호출 RegisterPropertyChangedCallback하여 이전에 등록한 변경 알림을 취소합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.UnregisterPropertyChangedCallback(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)

추가 정보

• BitmapSource
• PixelBuffer
• BitmapDecoder
• Windows.Graphics.Imaging
• XAML 이미지 샘플
• 카메라 미리 보기 프레임 샘플(Windows 10)