BitmapDecoder 클래스

정의

비트맵 프레임의 컨테이너를 나타냅니다.Represents a container for bitmap frames. 각 비트맵 프레임은 BitmapSource입니다.Each bitmap frame is a BitmapSource. 이 추상 클래스는 파생된 모든 디코더 개체에 대한 기본 기능 집합을 제공합니다.This abstract class provides a base set of functionality for all derived decoder objects.

public ref class BitmapDecoder abstract : System::Windows::Threading::DispatcherObject
public abstract class BitmapDecoder : System.Windows.Threading.DispatcherObject
type BitmapDecoder = class
    inherit DispatcherObject
Public MustInherit Class BitmapDecoder
Inherits DispatcherObject
상속
BitmapDecoder
파생

예제

다음 예제에서는 Create(Uri, BitmapCreateOptions, BitmapCacheOption) 메서드를 사용 하 여 지정 된 이미지에 대 한 디코더를 만드는 방법을 보여 줍니다.The following example demonstrates how to use the Create(Uri, BitmapCreateOptions, BitmapCacheOption) method to create a decoder for a given image. 이미지의 첫 번째 BitmapFrameImage 컨트롤의 소스로 사용 됩니다.The first BitmapFrame of the image is used as the source of an Image control.

BitmapDecoder uriBitmap = BitmapDecoder.Create(
   new Uri("sampleImages/waterlilies.jpg", UriKind.Relative),
   BitmapCreateOptions.None,
   BitmapCacheOption.Default);

// Create an image element;
Image uriImage = new Image();
uriImage.Width = 200;
// Set image source.
uriImage.Source = uriBitmap.Frames[0];
Dim uriBitmap As BitmapDecoder = BitmapDecoder.Create(New Uri("sampleImages/waterlilies.jpg", UriKind.Relative), BitmapCreateOptions.None, BitmapCacheOption.Default)

' Create an image element;
Dim uriImage As New Image()
uriImage.Width = 200
' Set image source.
uriImage.Source = uriBitmap.Frames(0)

다음 코드 예제에서는 기본 제공 TiffBitmapDecoder를 사용 하 여 TIFF(Tagged Image File Format)Tagged Image File Format (TIFF) 비트맵을 열고 디코딩하는 방법을 보여 줍니다.The following code example demonstrates how to use the built in TiffBitmapDecoder to open and decode a TIFF(Tagged Image File Format)Tagged Image File Format (TIFF) bitmap. 결과 BitmapSource Image 요소의 Source 사용 됩니다.The resulting BitmapSource is used as the Source of an Image element.


// Open a Stream and decode a TIFF image
Stream imageStreamSource = new FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read);
TiffBitmapDecoder decoder = new TiffBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource = decoder.Frames[0];

// Draw the Image
Image myImage1 = new Image();
myImage1.Source = bitmapSource;
myImage1.Stretch = Stretch.None;
myImage1.Margin = new Thickness(20);
' Open a Stream and decode a TIFF image
Dim imageStreamSource As New FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim decoder As New TiffBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource As BitmapSource = decoder.Frames(0)

' Draw the Image
Dim myImage1 As New Image()
myImage1.Source = bitmapSource
myImage1.Stretch = Stretch.None
myImage1.Margin = New Thickness(20)

설명

BitmapDecoder BitmapFrame 자체가 아닙니다. 대신 BitmapFrame 개체에 대 한 컨테이너입니다.BitmapDecoder is not a BitmapFrame itself; rather, it is a container for BitmapFrame objects. 컨테이너의 각 BitmapFrame에는 다양 한 크기, 해상도 또는 색상표를 비롯 한 다양 한 특성이 있을 수 있습니다.Each BitmapFrame in the container can potentially have different attributes, including different sizes, resolutions, or palettes.

특정 코덱을 선택 하지 않는 한 WPF(Windows Presentation Foundation)Windows Presentation Foundation (WPF) 자동 런타임 검색을 사용 하 여 이미지의 형식을 식별 하 고 적절 한 코덱에 일치 시킵니다.Unless a specific codec is selected, WPF(Windows Presentation Foundation)Windows Presentation Foundation (WPF) uses automatic run-time discovery to identify the format of an image and match it with the appropriate codec. 이 검색 프로세스를 통해 ISV(Independent Software Vendor)independent software vendor (ISV)에서 개발한 코덱을 시스템에서 자동으로 검색할 수 있습니다.This discovery process allows a codec developed by an ISV(Independent Software Vendor)independent software vendor (ISV) to be automatically discoverable by the system. 특정 코덱을 선택 하려면 파생 된 BitmapDecoder 또는 BitmapEncoder(예: TiffBitmapDecoder 클래스)를 사용 해야 합니다.To select a specific codec, the derived BitmapDecoder or BitmapEncoder, such as the TiffBitmapDecoder class, should be used.

TIFF(Tagged Image File Format)Tagged Image File Format (TIFF) GIF(Graphics Interchange Format)Graphics Interchange Format (GIF)는 여러 프레임을 지 원하는 유일한 구현 된 이미지 형식입니다.and GIF(Graphics Interchange Format)Graphics Interchange Format (GIF) are the only implemented image formats that support multiple frames.

생성자

BitmapDecoder()

BitmapDecoder의 새 인스턴스를 초기화합니다.Initializes a new instance of BitmapDecoder.

속성

CodecInfo

이 코덱을 설명하는 정보를 가져옵니다.Gets information that describes this codec.

ColorContexts

정의된 경우 비트맵에 연결된 색 프로필을 나타내는 값을 가져옵니다.Gets a value that represents the color profile associated with a bitmap, if one is defined.

Dispatcher

Dispatcher와 연결된 DispatcherObject를 가져옵니다.Gets the Dispatcher this DispatcherObject is associated with.

(다음에서 상속됨 DispatcherObject)
Frames

비트맵 내 개별 프레임의 콘텐츠를 가져옵니다.Gets the content of an individual frame within a bitmap.

IsDownloading

디코더가 현재 콘텐츠를 다운로드하는 중인지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates if the decoder is currently downloading content.

Metadata

메타데이터가 정의된 경우 이 비트맵과 연결된 전역 메타데이터를 나타내는 BitmapMetadata의 인스턴스를 가져옵니다.Gets an instance of BitmapMetadata that represents the global metadata associated with this bitmap, if metadata is defined.

Palette

이 디코더와 연결된 BitmapPalette를 가져옵니다.Gets the BitmapPalette associated with this decoder.

Preview

이 비트맵의 전역 미리 보기(정의된 경우)를 나타내는 BitmapSource 를 가져옵니다.Gets a BitmapSource that represents the global preview of this bitmap, if one is defined.

Thumbnail

정의된 경우 비트맵의 미리 보기를 나타내는 BitmapSource를 가져옵니다.Gets a BitmapSource that represents the thumbnail of the bitmap, if one is defined.

메서드

CheckAccess()

호출 스레드가 이 DispatcherObject에 액세스할 수 있는지 여부를 확인합니다.Determines whether the calling thread has access to this DispatcherObject.

(다음에서 상속됨 DispatcherObject)
Create(Stream, BitmapCreateOptions, BitmapCacheOption)

지정된 BitmapDecoderStream을 사용하여 BitmapCreateOptions에서 BitmapCacheOption를 만듭니다.Creates a BitmapDecoder from a Stream by using the specified BitmapCreateOptions and BitmapCacheOption.

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

지정된 BitmapDecoderUri을 사용하여 BitmapCreateOptions에서 BitmapCacheOption를 만듭니다.Creates a BitmapDecoder from a Uri by using the specified BitmapCreateOptions and BitmapCacheOption.

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

지정된 BitmapDecoder, Uri, BitmapCreateOptionsBitmapCacheOption를 사용하여 RequestCachePolicy를 만듭니다.Creates a BitmapDecoder from a Uri by using the specified BitmapCreateOptions, BitmapCacheOption and RequestCachePolicy.

CreateInPlaceBitmapMetadataWriter()

비트맵의 메타데이터를 업데이트하는 데 사용할 수 있는 InPlaceBitmapMetadataWriter의 인스턴스를 만듭니다.Creates an instance of InPlaceBitmapMetadataWriter, which can be used to update the metadata of a bitmap.

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
Finalize()

가비지 컬렉션에 의해 BitmapDecoder가 회수되기 전에 리소스를 해제하고 기타 정리 작업을 수행합니다.Frees resources and performs other cleanup operations before the BitmapDecoder is reclaimed by garbage collection.

GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
ToString()

BitmapDecoder의 현재 값을 String으로 변환합니다.Converts the current value of a BitmapDecoder to a String.

VerifyAccess()

호출 스레드에서 이 DispatcherObject에 액세스할 수 있는지 확인합니다.Enforces that the calling thread has access to this DispatcherObject.

(다음에서 상속됨 DispatcherObject)

이벤트

DownloadCompleted

BitmapDecoder에서 비트맵 콘텐츠 다운로드가 완료되면 발생합니다.Occurs when a BitmapDecoder has finished downloading bitmap content.

DownloadFailed

비트맵 콘텐츠 다운로드가 실패하면 발생합니다.Occurs when bitmap content failed to download.

DownloadProgress

BitmapDecoder에서 비트맵 콘텐츠를 다운로드하는 중이면 발생합니다.Occurs when a BitmapDecoder has made progress downloading bitmap content.

적용 대상

추가 정보