CGImageDestination 類別

定義

命名空間:

ImageIO

組件:

Xamarin.iOS.dll

使用此類別來儲存影像，並詳細控制影像的儲存方式。

public class CGImageDestination : IDisposable, ObjCRuntime.INativeObject

type CGImageDestination = class
    interface INativeObject
    interface IDisposable

繼承

Object

CGImageDestination

實作

INativeObject IDisposable

備註

您可以藉由呼叫其中一個 Factory 方法來建立 的新實例 CGImageDestination 。   有三個版本：

• 將產生的影像儲存到 NSUrl 所指向的檔案中。
• 將產生的映射儲存至 NSMutableData
• 將產生的映射儲存至 CGDataConsumer

在傳統 API 中，這些方法分別稱為 FromUrl、FromData 和 Create。   但此命名不正確，因為它實際上並未從 URL 或資料建立影像目的地。  在整合 API 中，它們全都已轉換成 Create(NSMutableData, String, Int32, CGImageDestinationOptions) 方法。

建立映射之後，您可以呼叫 M：ImageIO.CGImageDestination.AddImage*或 AddImageAndMetadata(CGImage, CGImageMetadata, CGImageDestinationOptions) 新增一或多個映射。

若要寫出映射，您必須呼叫 Close() 方法。

// The following example shows how to store an image into
// an in-memory PNG file stored inside an NSData.

NSData ImageToPng (CGImage image)
{
   var storage = new NSMutableData ()
   var dest = CGImageDestination.Create (storage, MobileCoreServices.UTType.PNG, imageCount: 1);
   dest.AddImage (image);
   dest.Close (); 
   return storage;
}

屬性

Handle	處理 unmanaged 物件標記法) (指標。
TypeIdentifiers	使用此類別來儲存影像，並詳細控制影像的儲存方式。

方法

AddAuxiliaryDataInfo(CGImageAuxiliaryDataType, CGImageAuxiliaryDataInfo)	使用此類別來儲存影像，並詳細控制影像的儲存方式。
AddImage(CGImage, CGImageDestinationOptions)	使用此類別來儲存影像，並詳細控制影像的儲存方式。
AddImage(CGImage, NSDictionary)	使用此類別來儲存影像，並詳細控制影像的儲存方式。
AddImage(CGImageSource, Int32, CGImageDestinationOptions)	使用此類別來儲存影像，並詳細控制影像的儲存方式。
AddImage(CGImageSource, Int32, NSDictionary)	使用此類別來儲存影像，並詳細控制影像的儲存方式。
AddImageAndMetadata(CGImage, CGImageMetadata, CGImageDestinationOptions)	使用此類別來儲存影像，並詳細控制影像的儲存方式。
AddImageAndMetadata(CGImage, CGImageMetadata, NSDictionary)	使用此類別來儲存影像，並詳細控制影像的儲存方式。
Close()	將影像寫入目的地，並處置 物件。
CopyImageSource(CGImageSource, CGCopyImageSourceOptions, NSError)	使用此類別來儲存影像，並詳細控制影像的儲存方式。
CopyImageSource(CGImageSource, NSDictionary, NSError)	使用此類別來儲存影像，並詳細控制影像的儲存方式。
Create(CGDataConsumer, String, Int32, CGImageDestinationOptions)	使用此類別來儲存影像，並詳細控制影像的儲存方式。
Create(NSMutableData, String, Int32, CGImageDestinationOptions)	使用此類別來儲存影像，並詳細控制影像的儲存方式。
Create(NSUrl, String, Int32)	使用此類別來儲存影像，並詳細控制影像的儲存方式。
Dispose()	釋放 CGImageDestination 物件所使用的資源。
Dispose(Boolean)	釋放 CGImageDestination 物件所使用的資源。
Finalize()	CGImageDestination 物件的完成項
GetTypeID()	ImageIO.CGImageDestination 類型的類型識別碼。
SetProperties(NSDictionary)	使用此類別來儲存影像，並詳細控制影像的儲存方式。