SoftwareBitmapSource 클래스

정의

네임스페이스:

Windows.UI.Xaml.Media.Imaging

비트맵 형식 이미지 원본을 SoftwareBitmap사용하는 속성에 대해 원본 개체를 지원합니다.

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

public ref class SoftwareBitmapSource sealed : ImageSource, IClosable

/// [Windows.Foundation.Metadata.Activatable(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 SoftwareBitmapSource final : ImageSource, IClosable

/// [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(65536, "Windows.Foundation.UniversalApiContract")]
class SoftwareBitmapSource final : ImageSource, IClosable

[Windows.Foundation.Metadata.Activatable(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 SoftwareBitmapSource : ImageSource, System.IDisposable

[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(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SoftwareBitmapSource : ImageSource, System.IDisposable

Public NotInheritable Class SoftwareBitmapSource
Inherits ImageSource
Implements IDisposable

상속

Object IInspectable DependencyObject ImageSource SoftwareBitmapSource

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

구현

IClosable IDisposable

Windows 요구 사항

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

설명

SoftwareBitmapSource를 사용하면 컨트롤을 SoftwareBitmap 사용 ImageBrush 하거나 컨트롤에 Image 직접 표시할 이미지 원본으로 사용할 수 있습니다. 예를 들어 SoftwareBitmapSource를 사용하여 클래스를 사용하여 디바이스의 카메라에서 방금 찍은 사진을 표시하거나, 메서드를 사용하여 LowLagPhotoCapture BitmapDecoder.GetSoftwareBitmapAsync 수동으로 디코딩한 이미지를 표시하거나, 이미지 메모리를 수동으로 관리하려는 고급 C++ 시나리오에서 사용자 지정 IWICBitmap 을 표시할 수 있습니다.

XAML 앱에 표시되는 형식 SoftwareBitmap 은 미리 곱한 알파 값이 있는 BGRA 픽셀 형식이어야 합니다.

SoftwareBitmap 일반적으로 압축되지 않은 이미지 데이터를 저장합니다. 즉, PNG(이식 가능한 네트워크 그래픽) 또는 JPEG 파일과 같은 압축된 형식에 비해 시스템 메모리가 많이 필요할 수 있습니다. 따라서 a를 SoftwareBitmap 사용하면 앱에서 사용하는 시스템 메모리의 양이 증가하여 앱의 성능에 영향을 줄 수 있습니다. 압축되지 않은 이미지 데이터를 저장하면 많은 메모리를 사용할 수 있으므로 Dispose(C#/VB) 또는 Close (C++) 메서드를 호출하여 더 이상 필요하지 않을 때 SoftwareBitmap 메모리 사용량을 줄일 수 있습니다. 이로 인해 가비지 수집을 기다리지 않고 연결된 시스템 리소스가 즉시 해제됩니다.

생성자

SoftwareBitmapSource()

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

속성

Dispatcher

이 개체가 CoreDispatcher 연결된 개체를 가져옵니다. 코드 CoreDispatcher 가 비 UI 스레드에서 시작되는 경우에도 UI 스레드에 액세스할 DependencyObject 수 있는 기능을 나타냅니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.Dispatcher(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)

메서드

ClearValue(DependencyProperty)	종속성 속성의 로컬 값을 지웁니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.ClearValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
Close()	개체 및 연결된 리소스를 삭제합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Imaging.SoftwareBitmapSource.Close(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
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)
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)
SetBitmapAsync(SoftwareBitmap)	이미지 원본으로 사용할 원본 SoftwareBitmap 을 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Imaging.SoftwareBitmapSource.SetBitmapAsync(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
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)

추가 정보

• ImageSource
• IClosable