UIImage


継承:NSObject(Class)

従属:NSSecureCodingNSObject(Protocol)

フレームワーク: iOS 2.0 以降の UIKit。関連情報...


概観


UIImage オブジェクトは、アプリ内のイメージデータを管理します。すべての種類のイメージデータを表すイメージオブジェクトを使用して、UIImage クラスは、基礎となるプラットフォームでサポートされているすべてのイメージフォーマットのデータを管理できます。イメージオブジェクトは不変ですので、ディスク上のイメージファイルやプログラムで作成したイメージデータのような、既存のイメージデータから、それらを作成します。イメージオブジェクトは、単一のイメージやアニメーションに使用するイメージのシーケンスを含んでいてもよいです。


いくつかの異なる方法でイメージオブジェクトを使用できます。


イメージオブジェクトは、すべてのプラットフォーム固有のイメージ形式をサポートしていますが、あなたのアプリの中で最も多くのイメージに PNG または JPEG ファイルの使用をお勧めします。イメージオブジェクトは、両方のフォーマットを読み取り、表示するために最適化され、またそれらのフォーマットは、他のほとんどのイメージフォーマットよりも優れたパフォーマンスを提供します。PNG フォーマットは損失がないため、特にあなたのアプリのインターフェイスで使用するイメージにお勧めします。


イメージ・オブジェクトの作成


このクラスのメソッドを使用してイメージオブジェクトを作成するときは、ファイルやデータ構造にある、既存のイメージデータを持っていなければなりません。空のイメージを作成し、その中にコンテンツを描画することはできません。特定の状況にそれぞれが最適な、イメージオブジェクトを作成するための多くのオプションがあります。


UIImage クラスの他のメソッドを使用すると、あなた自身で作成する Core Graohics イメージやイメージデータのような特定の種類のデータからアニメーションを作成できます。UIKit はまた、あなた自身で描画するコンテンツからイメージを作成するための UIGraphicsGetImageFromCurrentImageContext 関数を提供します。あなたの描画コマンドをキャプチャするために使用するビットマップベースのグラフィックスコンテキストに関連して、その関数を使用して下さい。



注意: イメージオブジェクトは不変なので、作成後、それらのプロパティを変更することはできません。ほとんどのイメージプロパティは、添付のイメージファイルやイメージデータのメタデータを使用して自動的に設定されています。イメージオブジェクトの不変の性質はまた、彼らが、全てのスレッドから使用しても安全であることを意味します。


イメージアセットは、あなたのアプリに同梱するイメージを管理する最も簡単な方法です。それぞれの新しい Xcode プロジェクトは、複数のイメージセットを追加することができるアセットライブラリを含んでいます。イメージセットは、あなたのアプリが使用する単一のイメージのバリエーションを含んでいます。単一のイメージセットは、(コンパクトまたは通常の) 異なる形質環境のためのさまざまなプラットフォーム用のイメージの異なるバージョンを提供し、異なるスケールファクタのために提供できます。


ディスクからのイメージのロードに加えて、UIImagePickerController オブジェクトを使用して、使用可能なカメラやフォトライブラリからイメージを供給するために、ユーザーに依頼することができます。イメージピッカーは、イメージを選択するためのカスタムユーザーインターフェイスを表示します。ユーザー提供のイメージにアクセスするにはユーザの明示的な許可が必要です。イメージピッカーを使用する詳細については、UIImagePickerController クラスリファレンス を参照してください。


伸縮可能イメージの定義


伸縮可能イメージは、基礎となるイメージデータが、美しく気持ちの良い方法で複製できる領域を定義するものです。伸縮可能イメージは、使用可能なスペースを埋めるために大きくなるか縮小できる背景を作成するために一般的に使用されます。


resizableImageWithCapInsets:resizableImageWithCapInsets:resizingMode: メソッドを使用して、既存のイメージに挿入部を追加することで、伸縮可能イメージを定義します。挿入部は、2 つ以上の部分に、イメージを細分化します。各々の挿入部のためにゼロ以外の値を指定すると、図 1 に示すように、イメージは、9 つの部分に分けられます。


図 1 伸縮可能領域を定義するため挿入部を使用する


image_insets_2x


それぞれの挿入部は、与えられた寸法に伸びていないイメージの1回分を定義します。イメージの上部と下部の挿入部内の領域は固定された高さを維持し、左と右の挿入部内の領域は、一定の幅を維持します。図 2 は、9 つの部分のイメージの各部分が、イメージ自体が使用可能なスペースを埋めるために伸びるイメージとしていかに伸びるかを示しています。それらが水平および垂直両方の挿入部内にあるため、イメージの角はサイズを変更しません。


図 2 9つの部分のイメージの伸縮可能な部分


image_stretching_2x


イメージの比較


isEqual: メソッドは、2 つのイメージが同じイメージデータを含んでいるかどうかを判断するための信頼できる唯一の方法です。作成したイメージオブジェクトは、キャッシュされた同じイメージデータでそれらを初期化する場合であっても、互いに異なるかも知れません。等しい事をを決定する唯一の方法は、実際のイメージデータとを比較する、isEqual: メソッドを使用することです。リスト 1 は、画像を比較するための正しい方法と、誤った方法を示しています。


リスト 1 2 つのイメージを比較する


    << OBJECTIVE-C >>

  1. // Load the same image twice.
  2. UIImage* image1 = [UIImage imageNamed:@"MyImage"];
  3. UIImage* image2 = [UIImage imageNamed:@"MyImage"];
  4. // The image objects may be different, but the contents are still equal
  5. if ([image1 isEqual:image2]) {
  6.         // Correct. This technique compares the image data correctly.
  7. }
  8. if (image1 == image2) {
  9.         // Incorrect! Direct object comparisons may not work.
  10. }

    << SWIFT >>

  1. let image1 = UIImage.init(named: "MyImage")
  2. let image2 = UIImage.init(named: "MyImage")
  3. if image1 != nil && image1!.isEqual(image2) {
  4.         // Correct. This technique compares the image data correctly.
  5. }
  6. if image1 == image2 {
  7.         // Incorrect! Direct object comparisons may not work.
  8. }

イメージデータへのアクセス


イメージオブジェクトは、その基礎となるイメージデータに直接アクセスを提供していません。しかし、あなたのアプリで使用するために他のフォーマットのイメージデータを取得することができます。具体的には、それぞれ Core Graphics と Core イメージと互換性のあるイメージのバージョンを取得するために CGImageCIImage プロパティを使用できます。また、PNG または JPEG 形式のいずれかでイメージデータを含む NSData オブジェクトを生成する UIImagePNGRepresentationUIImageJPEGRepresentation 関数を使用できます。


タスク


イメージのロードとキャッシング


+ imageNamed:inBundle:compatibleWithTraitCollection:


指定された形質コレクションとも互換性があるという名前のイメージを返します。


宣言

<< SWIFT >>

                   init?(named name: String,
                     inBundle bundle: NSBundle?,
compatibleWithTraitCollection traitCollection: UITraitCollection?)

<< OBJECTIVE-C >>
+ (UIImage *)imageNamed:(NSString *)name
               inBundle:(NSBundle *)bundle
compatibleWithTraitCollection:(UITraitCollection *)traitCollection


パラメーター

nameイメージの名前。アセットカタログ内のイメージの場合、イメージアセットの名前を指定します。PNG イメージファイルの場合、ファイル名拡張子なしのファイル名を指定します。他のすべてのイメージファイル形式の場合、名前にファイル名の拡張子を含めます。
bundleイメージファイルやアセット・カタログを含むバンドル。アプリのメインバンドルを検索するには nil を指定します。
traitCollectionイメージのための意図した環境に関連付けられた形質。イメージの正しいバリアントがロードされていることを確実にするために、このパラメータを使用します。nil を指定した場合、このメソッドは、メインスクリーンに関連付けられた形質を使用します。

戻り値

与えられた名前と希望の形質で最高に一致するイメージオブジェクト。もし適切なイメージが見つからなかった場合は、nil


議論

このメソッドは、指定された名前を持つイメージオブジェクトのためのシステムキャッシュを調べ、指定された形質コレクションに最高に一致するイメージのバリアントを返します。一致するイメージオブジェクトがキャッシュに存在しない場合は、このメソッドはディスクか、利用可能なアセット・カタログからイメージデータを検索しロードし、その結果のオブジェクトを返します。


システムは、メモリを解放するために、いつでもキャッシュされたイメージデータをパージできます。パージはキャッシュのみで起こりますが、現在は使用されていないイメージでも発生します。


iOS 9 以降では、このメソッドはスレッドセーフです。


利用可能

iOS 8.0 以降で利用可能。





+ imageNamed:


指定したファイル名に関連するイメージオブジェクトを返します。


宣言

<< SWIFT >>

init?(named name: String)

<< OBJECTIVE-C >>
+ (UIImage *)imageNamed:(NSString *)name


パラメーター

nameファイルの名前。イメージがロードされるのが初めての場合、このメソッドは、アプリのメインバンドル内の指定された名前を持つイメージを検索します。PNG イメージの場合は、ファイル名の拡張子を省略できます。他のすべてのファイル形式の場合は、必ずファイル名拡張子を含めて下さい。

戻り値

指定されたファイルのイメージオブジェクト、またはメソッドが、指定されたイメージを見つけられなかった場合 nil


議論

このメソッドは、指定された名前を持つイメージオブジェクトのためのシステムキャッシュ内を検索し、メインスクリーンに最適なイメージのバリアントを返します。一致するイメージオブジェクトがキャッシュに存在しない場合は、このメソッドは、ディスクから、または利用可能なアセット・カタログからイメージデータを検索し、ロードし、その結果のオブジェクトを返します。


システムは、メモリを解放するために、いつでもキャッシュされたイメージデータをパージできます。パージはキャッシュのみで行われますが、現在は使用されていないイメージでも発生します。


iOS 9 以降では、このメソッドはスレッドセーフです。


特別な考慮事項

一度だけ表示されるイメージファイルを持っており、それはシステムキャッシュに追加されていないことを確認したい場合は、代わりに imageWithContentsOfFile: を使用してイメージを作成する必要があります。これは、あなたのアプリのメモリ使用特性を潜在的に改善する、システム・イメージ・キャッシュの一回だけ使うイメージを維持します。


利用可能

iOS 2.0 以降で利用可能。





イメージオブジェクトの作成と初期化


+ imageWithContentsOfFile:


指定したパスにあるファイルからイメージデータをロードして、イメージオブジェクトを作成し返します。


宣言

<< OBJECTIVE-C >>

+ (UIImage *)imageWithContentsOfFile:(NSString *)path


パラメーター

pathファイルへの完全または部分的なパス。

戻り値

指定されたファイル用の新しいイメージオブジェクト、またはメソッドが、指定したファイルからイメージを初期化できなかった場合 nil


議論

このメソッドは、イメージオブジェクトをキャッシュしません。


利用可能

iOS 2.0 以降で利用可能。





+ imageWithData:


指定されたイメージデータを使用したイメージオブジェクトを作成し、返します。


宣言

<< OBJECTIVE-C >>

+ (UIImage *)imageWithData:(NSData *)data


パラメーター

dataイメージデータ。これは、プログラムで作成できる、ファイルやデータからのデータです。

戻り値

指定されたデータ用の新しいイメージオブジェクト、またはメソッドが、指定されたデータから画像を初期化できなかった場合 nil


議論

このメソッドはイメージオブジェクトをキャッシュしません。


利用可能

iOS 2.0 以降で利用可能。





+ imageWithData:scale:


指定されたイメージデータとスケールファクタを使用してイメージオブジェクトを作成し、返します。


宣言

<< OBJECTIVE-C >>

+ (UIImage *)imageWithData:(NSData *)data
                     scale:(CGFloat)scale


パラメーター

dataイメージデータ。これは、プログラムで作成した、ファイルからのデータやデータです。
scaleイメージデータを解釈するときに使用するスケール係数。 1.0 のスケールファクタを適用すると、そのサイズは、イメージのピクセルベースの寸法に一致するサイズであるイメージの中に結果します。size プロパティで報告されるように、異なるスケールファクタを適用すると、イメージのサイズを変更します。

戻り値

指定されたデータ用の新しいイメージオブジェクト、またはメソッドが、指定されたデータから画像を初期化できなかった場合 nil


議論

このメソッドはイメージオブジェクトをキャッシュしません。


利用可能

iOS 6.0 以降で利用可能。





+ imageWithCGImage:


指定された Quartz イメージを表す画像オブジェクトを作成し、返します。


宣言

<< OBJECTIVE-C >>

+ (UIImage *)imageWithCGImage:(CGImageRef)cgImage


パラメーター

cgImageQuartz イメージオブジェクト。

戻り値

指定された Quartz イメージの新しいイメージオブジェクト、またはメソッドが、指定されたイメージの参照からイメージを初期化できなかった場合 nil


議論

このメソッドは、イメージオブジェクトをキャッシュしません。Quartz のイメージ参照を作成するために、Core Graphics フレームワークのメソッドを使用できます。


利用可能

iOS 2.0 以降で利用可能。





+ imageWithCGImage:scale:orientation:


指定されたスケールと向きの因子でイメージオブジェクトを作成し、返します。


宣言

<< OBJECTIVE-C >>

+ (UIImage *)imageWithCGImage:(CGImageRef)imageRef
                        scale:(CGFloat)scale
                  orientation:(UIImageOrientation)orientation


パラメーター

imageRefQuartz イメージオブジェクト。
scaleイメージデータを解釈するときに使用するスケール係数。1.0 のサイズファクターを適用すると、イメージのピクセルベースの寸法に一致するサイズのイメージを結果します。size プロパティで報告されるように、異なるスケールファクタを適用すると、イメージのサイズを変更します。
orientationイメージデータの向き。イメージに適用される全ての向きの要素を指定するには、このパラメータを使用できます。

戻り値

指定された Quartz イメージのための新しいイメージオブジェクト、またはメソッドが、指定されたイメージの参照からイメージを初期化できなかった場合 nil


議論

このメソッドは、イメージオブジェクトをキャッシュしません。Quartz のイメージ参照を作成するために、Core Graphics フレームワークのメソッドを使用できます。


利用可能

iOS 4.0 以降で利用可能。





+ imageWithCIImage:


Core Image オブジェクトを含むイメージオブジェクトを作成し、返します。


宣言

<< OBJECTIVE-C >>

+ (UIImage *)imageWithCIImage:(CIImage *)ciImage


パラメーター

ciImageカプセル化すべき Core Image オブジェクト。

戻り値

新しいイメージオブジェクト。


利用可能

iOS 5.0 以降で利用可能。





+ imageWithCIImage:scale:orientation:


Core Image オブジェクトと指定された属性に基づいてイメージオブジェクトを作成し、返します。


宣言

<< OBJECTIVE-C >>

+ (UIImage *)imageWithCIImage:(CIImage *)ciImage
                        scale:(CGFloat)scale
                  orientation:(UIImageOrientation)orientation


パラメーター

ciImageカプセル化すべき Core Image オブジェクト。
scaleイメージデータを解釈するときに使用するスケール係数。1.0 のサイズファクターを適用すると、イメージのピクセルベースの寸法に一致するサイズのイメージを結果します。size プロパティで報告されるように、異なるスケールファクタを適用すると、イメージのサイズを変更します。
orientationイメージデータの向き。イメージに適用される全ての向きの要素を指定するには、このパラメータを使用できます。

戻り値

新しいイメージオブジェクト。


利用可能

iOS 6.0 以降で利用可能。





– initWithContentsOfFile:


指定されたファイルの内容でイメージオブジェクトを初期化し、返します。


宣言

<< SWIFT >>

init?(contentsOfFile path: String)

<< OBJECTIVE-C >>
- (instancetype)initWithContentsOfFile:(NSString *)path


パラメーター

pathファイルへのパス。このパスは、イメージデータの種類を識別するファイル名の拡張子を含める必要があります。

戻り値

初期化された UIImage オブジェクト、またはメソッドが、ファイルを見つけるか、その内容からイメージを初期化できなかった場合 nil


議論

このメソッドは、メモリにイメージデータをロードし、パージ可能としてそれをマークします。データをパージし、再度ロードする必要がある場合は、イメージオブジェクトは指定したパスから再びそのデータをロードします。


利用可能

iOS 2.0 以降で利用可能。





– initWithData:


宣言

<< SWIFT >>

init?(data data: NSData)

<< OBJECTIVE-C >>
- (instancetype)initWithData:(NSData *)data


パラメーター

dataイメージデータを含むデータオブジェクト。

戻り値

初期化された UIImage オブジェクト、またはメソッドが、指定されたデータからイメージを初期化できなかった場合 nil


議論

data パラメータのデータは、システムがサポートしているイメージ型の一つのファイル形式と一致するようにフォーマットされなければなりません。


利用可能

iOS 2.0 以降で利用可能。





– initWithData:scale:


指定されたデータとスケールファクタでイメージオブジェクトを初期化し、返します。


宣言

<< SWIFT >>

init?(data data: NSData,
     scale scale: CGFloat)

<< OBJECTIVE-C >>
- (instancetype)initWithData:(NSData *)data
                       scale:(CGFloat)scale


パラメーター

dataイメージデータを含むデータオブジェクト。
scaleイメージデータを解釈する際前提とするスケールファクタ。1.0 のサイズファクターを適用すると、イメージのピクセルベースの寸法に一致するサイズのイメージを結果します。size プロパティで報告されるように、異なるスケールファクタを適用すると、イメージのサイズを変更します。

戻り値

初期化された UIImage オブジェクト、またはメソッドが、指定されたデータからイメージを初期化できなかった場合 nil


議論

data パラメータのデータは、システムがサポートしているイメージ型の一つのファイル形式と一致するようにフォーマットされなければなりません。


利用可能

iOS 6.0 以降で利用可能。





– initWithCGImage:


指定された Quartz イメージの参照で、イメージオブジェクトを初期化し、返します。


宣言

<< SWIFT >>

init(CGImage cgImage: CGImage)

<< OBJECTIVE-C >>
- (instancetype)initWithCGImage:(CGImageRef)CGImage


パラメーター

CGImageQuartz イメージの参照。

戻り値

初期化された UIImage オブジェクト、またはメソッドが、指定されたデータからイメージを初期化できなかった場合 nil


利用可能

iOS 2.0 以降で利用可能。





– initWithCGImage:scale:orientation:


指定されたスケールと向きの因子でイメージオブジェクトを初期化し、返します。


宣言

<< SWIFT >>

init(CGImage cgImage: CGImage,
       scale scale: CGFloat,
 orientation orientation: UIImageOrientation)

<< OBJECTIVE-C >>
- (instancetype)initWithCGImage:(CGImageRef)imageRef
                          scale:(CGFloat)scale
                    orientation:(UIImageOrientation)orientation


パラメーター

imageRefQuartz イメージオブジェクト。
scaleイメージデータを解釈する際前提とするスケールファクタ。1.0 のサイズファクターを適用すると、イメージのピクセルベースの寸法に一致するサイズのイメージを結果します。size プロパティで報告されるように、異なるスケールファクタを適用すると、イメージのサイズを変更します。
orientationイメージデータの向き。イメージに適用される全ての向きの要素を指定するには、このパラメータを使用できます。

戻り値

初期化された UIImage オブジェクト、またはメソッドが、指定されたデータからイメージを初期化できなかった場合 nil


利用可能

iOS 4.0 以降で利用可能。





– initWithCIImage:


指定された Core Image オブジェクトでイメージオブジェクトを初期化し、返します。


宣言

<< SWIFT >>

init(CIImage ciImage: CIImage)

<< OBJECTIVE-C >>
- (instancetype)initWithCIImage:(CIImage *)ciImage


パラメーター

ciImageCore Image オブジェクト。

戻り値

初期化された UIImage オブジェクト、またはメソッドが、指定されたデータから画像を初期化できなかった場合 nil


利用可能

iOS 5.0 以降で利用可能。





– initWithCIImage:scale:orientation:


指定された Core Image オブジェクトとプロパティでイメージオブジェクトを初期化し、返します。


宣言

<< SWIFT >>

init(CIImage ciImage: CIImage,
       scale scale: CGFloat,
 orientation orientation: UIImageOrientation)

<< OBJECTIVE-C >>
- (instancetype)initWithCIImage:(CIImage *)ciImage
                          scale:(CGFloat)scale
                    orientation:(UIImageOrientation)orientation


パラメーター

ciImageCore Image オブジェクト。
scaleイメージデータを解釈する際前提とするスケールファクタ。1.0 のサイズファクターを適用すると、イメージのピクセルベースの寸法に一致するサイズのイメージを結果します。size プロパティで報告されるように、異なるスケールファクタを適用すると、イメージのサイズを変更します。
orientationイメージデータの向き。イメージに適用される全てのの向きの要素を指定するには、このパラメータを使用できます。

戻り値

初期化された UIImage オブジェクト、またはメソッドが、指定されたデータから画像を初期化できなかった場合 nil


利用可能

iOS 6.0 以降で利用可能。





特殊なイメージオブジェクトの作成


+ animatedImageNamed:duration:


アニメーション化されたイメージを作成し、返します。


宣言

<< SWIFT >>

class func animatedImageNamed(_ name: String,
                     duration duration: NSTimeInterval) -> UIImage?

<< OBJECTIVE-C >>
+ (UIImage *)animatedImageNamed:(NSString *)name
                       duration:(NSTimeInterval)duration


パラメーター

nameファイル(サンセリフの接尾辞) への完全な、または部分的なパス。
durationアニメーションの継続時間。

戻り値

新しいイメージオブジェクト。


議論

このメソッドは、name パラメータで提供される基本ファイル名に一連の番号を付加することによって、一連のファイルをロードします。例えば、name パラメータが、その内容として'image' を持っていた場合、このメソッドは、名前'image0'、'image1' など、'image1024' までのすべての名前を持つファイルからイメージをロードしようとします。アニメーション化されたイメージに含まれるすべてのイメージは、同じサイズとスケールを共有する必要があります。


利用可能

iOS 5.0 以降で利用可能。





+ animatedImageWithImages:duration:


イメージの既存のセットからアニメーション化されたイメージを作成し、返します。


宣言

<< SWIFT >>

class func animatedImageWithImages(_ images: [UIImage],
                          duration duration: NSTimeInterval) -> UIImage?

<< OBJECTIVE-C >>
+ (UIImage *)animatedImageWithImages:(NSArray<UIImage *> *)images
                            duration:(NSTimeInterval)duration


パラメーター

imagesUIImage オブジェクトの配列。
durationアニメーションの継続時間。

戻り値

新しいイメージオブジェクト。


議論

アニメーション化されたイメージに含まれるすべてのイメージは、同じサイズとスケールを共有する必要があります。


利用可能

iOS 5.0 以降で利用可能。





+ animatedResizableImageNamed:capInsets:duration:


エンドキャップを持つアニメーションイメージを作成し、返します。


宣言

<< SWIFT >>

class func animatedResizableImageNamed(_ name: String,
                             capInsets capInsets: UIEdgeInsets,
                              duration duration: NSTimeInterval) -> UIImage?

<< OBJECTIVE-C >>
+ (UIImage *)animatedResizableImageNamed:(NSString *)name
                               capInsets:(UIEdgeInsets)capInsets
                                duration:(NSTimeInterval)duration


パラメーター

nameファイル(サンセリフの接尾辞) への完全な、または部分的なパス。
capInsetsキャップインセット用に使用する値。
durationアニメーションの継続時間。

戻り値

新しいイメージオブジェクト。


議論

このメソッドは、name パラメータで提供される基本ファイル名に一連の番号を付加することによって、一連のファイルをロードします。例えば、name パラメータが、その内容として'image' を持っていた場合、このメソッドは、名前'image0'、'image1' など、'image1024' までのすべての名前を持つファイルからイメージをロードしようとします。アニメーション化されたイメージに含まれるすべてのイメージは、同じサイズとスケールを共有する必要があります。


アニメーションの各フレームは、resizableImageWithCapInsets: メソッドによって作成されたサイズ変更可能なイメージの規則に従います。


利用可能

iOS 5.0 以降で利用可能。


以下も見よ

+ animatedResizableImageNamed:capInsets:resizingMode:duration:
– resizableImageWithCapInsets :resizingMode:
– resizableImageWithCapInsets:




+ animatedResizableImageNamed:capInsets:resizingMode:duration:


エンドキャップと、特定のサイズ変更モードでアニメーション化されたイメージを作成し、返します。


宣言

<< SWIFT >>

class func animatedResizableImageNamed(_ name: String,
                             capInsets capInsets: UIEdgeInsets,
                          resizingMode resizingMode: UIImageResizingMode,
                              duration duration: NSTimeInterval) -> UIImage?

<< OBJECTIVE-C >>
+ (UIImage *)animatedResizableImageNamed:(NSString *)name
                               capInsets:(UIEdgeInsets)capInsets
                            resizingMode:(UIImageResizingMode)resizingMode
                                duration:(NSTimeInterval)duration


パラメーター

nameファイル(サンセリフの接尾辞) への完全な、または部分的なパス。
capInsetsキャップインセットに使用する値。
resizingModeイメージの内部のサイズが変更されるモード。
durationアニメーションの継続時間。

戻り値

指定されたキャップインセットとサイズ変更モードを使用して新しいアニメーション化されたイメージオブジェクト。


議論

このメソッドは、新しいイメージオブジェクトのサイズ変更モードを明示的に宣言できることを除いて、その相手の animatedResizableImageNamed:capInsets:duration: と全く同じです。画像のサイズ変更モードは、デフォルトで UIImageResizingModeTile なので、このメソッドは、UIImageResizingModeStretch サイズ変更モードでリサイズする必要があるアニメーション化されたイメージを作成するために、その相手の代わりにだけ使用する必要があります。


利用可能

iOS 6.0 以降で利用可能。


以下も見よ

+ animatedResizableImageNamed:capInsets:duration:
– resizableImageWithCapInsets :resizingMode:
– resizableImageWithCapInsets:




– imageFlippedForRightToLeftLayoutDirection


それが右から左へのレイアウトの時水平に反転する準備をされた現在のイメージを返します。


宣言

<< SWIFT >>

func imageFlippedForRightToLeftLayoutDirection() -> UIImage

<< OBJECTIVE-C >>
- (UIImage *)imageFlippedForRightToLeftLayoutDirection


戻り値

それが右から左へのレイアウトの場合、水平方向に反転する準備された現在の画像。


議論

右から左へのレイアウトで反転するべきイメージを指定するには、このメソッドを使用します。ほとんどのイメージは右から左へのレイアウトで反転する必要はないことに注意してください。


このメソッドは、flipsForRightToLeftLayoutDirection プロパティ設定を YES にして、現在の UIImage オブジェクトを返します。反転したイメージは返しません。返されたイメージは、(レイアウト方向は、システムの言語によって設定されている、またはイメージビューの semanticContentAttribute プロパティが UISemanticContentAttributeForceRightToLeft に設定されているため)、右から左へのレイアウト方向に UIImageView オブジェクトに表示された時、イメージは反転して表示されます。返されるイメージは、左から右のコンテキストで表示されている場合は、反転されずに表示されます。


利用可能

iOS 9.0 以降で利用可能。





– imageWithRenderingMode:


指定されたレンダリングモードで新しいイメージオブジェクトを作成し、返します。


宣言

<< SWIFT >>

func imageWithRenderingMode(_ renderingMode: UIImageRenderingMode) -> UIImage

<< OBJECTIVE-C >>
- (UIImage *)imageWithRenderingMode:(UIImageRenderingMode)renderingMode


パラメーター

renderingMode新しいイメージのために使用するレンダリングモード。

戻り値

指定されたレンダリングモードを使用した新しいイメージオブジェクト。


利用可能

iOS 7.0 以降で利用可能。


以下も見よ

renderingMode




– imageWithAlignmentRectInsets:


指定された位置合わせインセットを使用して、イメージの新しいバージョンを返します。


宣言

<< SWIFT >>

func imageWithAlignmentRectInsets(_ alignmentInsets: UIEdgeInsets) -> UIImage

<< OBJECTIVE-C >>
- (UIImage *)imageWithAlignmentRectInsets:(UIEdgeInsets)alignmentInsets


パラメーター

alignmentInsets新しいイメージに適用するアライメントメタデータ。

戻り値

新しいイメージオブジェクト。


利用可能

iOS 6.0 以降で利用可能。


以下も見よ

alignmentRectInsets




– resizableImageWithCapInsets:


指定されたキャップインセットで新しいイメージオブジェクトを作成し、返します。


宣言

<< SWIFT >>

func resizableImageWithCapInsets(_ capInsets: UIEdgeInsets) -> UIImage

<< OBJECTIVE-C >>
- (UIImage *)resizableImageWithCapInsets:(UIEdgeInsets)capInsets


パラメーター

capInsetsキャップインセットに使用する値。

戻り値

指定されたキャップインセットを持つ新しいイメージオブジェクト。


議論

イメージにキャップインセットを追加したり、イメージの既存のキャップインセットを変更するには、このメソッドを使用します。両方のケースとも、新しいイメージを取り戻すと、元の画像は手つかずのまま残ります。たとえば、境界線と角のボタンの背景イメージを作成するには、このメソッドを使用できます。ボタンのサイズが変更されたときに、イメージの角は変更されませんが、境界やイメージの中心は、新しいサイズをカバーするために展開します。


iOSは、イメージの各サイズ変更可能な領域のサイズに応じて、異なるパフォーマンス特性を有する、異なるレンダリング技術を使用します。


直接サイズ変更可能モードを代わりに制御するには、resizableImageWithCapInsets:resizingMode: を使用して下さい。


利用可能

iOS 5.0 以降で利用可能。





– resizableImageWithCapInsets:resizingMode:


指定されたキャップインセットおよびオプションを使用して新しいイメージオブジェクトを作成し、返します。


宣言

<< SWIFT >>

func resizableImageWithCapInsets(_ capInsets: UIEdgeInsets,
                    resizingMode resizingMode: UIImageResizingMode) -> UIImage

<< OBJECTIVE-C >>
- (UIImage *)resizableImageWithCapInsets:(UIEdgeInsets)capInsets
                            resizingMode:(UIImageResizingMode)resizingMode


パラメーター

capInsetsキャップインセットに使用する値。
resizingModeイメージ内のサイズが変更されるモード。

戻り値

指定されたキャップインセットとサイズ変更モードを使用した新しいイメージオブジェクト。


議論

このメソッドは、新しいイメージオブジェクトのサイズ変更モードは明示的に宣言することができること以外は、その相手の resizableImageWithCapInsets: と完全に同じです。具体的にあなたのイメージを UIImageResizingModeStretch サイズ変更モードでサイズ変更したい場合にのみ、その相手の代わりにこのメソッドを呼び出す必要があります。


利用可能

iOS 6.0 以降で利用可能。





– stretchableImageWithLeftCapWidth:topCapHeight:

(iOS 5.0)


指定されたキャップの値で新しいイメージオブジェクトを作成し、返します。


旧式の文

旧式です。代わりに resizableImageWithCapInsets: を使用し、内部は 1x1 の領域であるようにキャップインセットを指定します。


宣言

<< SWIFT >>

func stretchableImageWithLeftCapWidth(_ leftCapWidth: Int,
                         topCapHeight topCapHeight: Int) -> UIImage

<< OBJECTIVE-C >>
- (UIImage *)stretchableImageWithLeftCapWidth:(NSInteger)leftCapWidth
                                 topCapHeight:(NSInteger)topCapHeight


パラメーター

leftCapWidth左のキャップ幅に使用する値。イメージ全体を水平方向に伸縮可能にする場合は 0 を指定します。ゼロでない値がイメージにどのように影響するかの議論については、 leftCapWidth プロパティを参照してください。
topCapHeightトップキャップの高さに使用する値。イメージ全体がを上下方向に伸縮可能にする場合は 0 を指定します。ゼロでない値がイメージにどのように影響するかの議論については、 topCapHeight プロパティを参照してください。

戻り値

指定されたキャップ値を含む新しいイメージオブジェクト。


議論

イメージの拡大縮小やサイズ変更時には、キャップで覆われた領域は拡大縮小またはサイズ変更されません。代わりに、各方向にキャップで覆われていない 1 ピクセル幅の領域が拡大縮小またはサイズ変更されるものです。この技術は、多くの場合、同じ丸角を保持するが中央領域が必要に応じて拡大縮小する、可変幅のボタンを作成するために使用されます。


イメージにキャップ値を追加したり、イメージの既存のキャップ値を変更するには、このメソッドを使用します。両方のケースとも、新しいイメージを取り戻すと、元のイメージは変更されないまま残ります。


利用可能

iOS 2.0 以降で利用可能。

iOS 5.0 で旧式となる。





イメージの属性


imageOrientation プロパティ


受信者のイメージの方向。(読み取り専用)


宣言

<< SWIFT >>

var imageOrientation: UIImageOrientation { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) UIImageOrientation imageOrientation


議論

イメージの方向は、描画されたときにイメージデータが表示される方法に影響します。デフォルトでは、イメージは"上" 方向で表示されます。イメージが、メタデータ(例えば、EXIF の情報など) を伴ってている場合は、しかし、このプロパティは、そのメタデータによって示された方向を含んでいます。このプロパティに指定できる値のリストについては、UIImageOrientation を参照してください。


利用可能

iOS 2.0 以降で利用可能。





size プロパティ


ポイントで測定したイメージの論理的な寸法。(読み取り専用)


宣言

<< SWIFT >>

var size: CGSize { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) CGSize size


議論

この値は、イメージの論理サイズを反映し、イメージの現在の方向を考慮に入れます。イメージのピクセルでの寸法を取得するために、scale プロパティの値によってサイズの値を乗算します。


利用可能

iOS 2.0 以降で利用可能。





scale プロパティ


イメージのスケールファクタ。(読み取り専用)


宣言

<< SWIFT >>

var scale: CGFloat { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) CGFloat scale


議論

名前が @2x の修飾子を含むファイルからイメージをロードする場合、スケールは 2.0 に設定されます。また、Core Graphics のイメージからイメージを初期化するとき、明示的なスケールファクタを指定できます。他のすべてのイメージは、1.0 のスケールファクタを持つものと仮定されます。


このプロパティの値によって(size プロパティに格納されている) イメージの論理サイズを掛ける場合、ピクセル単位でイメージの寸法を取得します。


利用可能

iOS 4.0 以降で利用可能。





flipsForRightToLeftLayoutDirection プロパティ


イメージが右から左へのレイアウトで反転するかどうかを示すブール値。(読み取り専用)


宣言

<< SWIFT >>

var flipsForRightToLeftLayoutDirection: Bool { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) BOOL flipsForRightToLeftLayoutDirection


利用可能

iOS 9.0 以降で利用可能。





resizingMode プロパティ


イメージのサイズ変更モード。(読み取り専用)


宣言

<< SWIFT >>

var resizingMode: UIImageResizingMode { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) UIImageResizingMode resizingMode


議論

このプロパティのデフォルト値は UIImageResizingModeTile です。しかしながら、望みの外観を維持しながら、UIImage は、サイズ変更モードを可能な限り最速の方法に実装します。これは、サイズ変更する領域を、1 ピクセルの領域として、このプロパティは UIImageResizingModeTile に設定されており、2 つの物は、そのサイズの領域を仮想的に区別できず、延伸されるのは、分割よりも大幅に高速である代わりに領域が延伸されることを意味します。このプロパティの値を設定するには、animatedResizableImageNamed :capInsets:resizingMode:duration: または resizableImageWithCapInsets :resizingMode: いずれかを呼び出す必要があり、resizingMode パラメータを使用してサイズ変更モードを指定します。このプロパティに指定できる値のリストについては、UIImageResizingMode を参照してください。


利用可能

iOS 6.0 以降で利用可能。





CGImage プロパティ


基礎となる Quartz イメージデータ。(読み取り専用)


宣言

<< SWIFT >>

var CGImage: CGImage? { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) CGImageRef CGImage


議論

イメージデータは、メモリの制約のためパージされている場合、このメソッドを呼び出すとデータをメモリに戻してロードすることを強制します。画像データをリロードすると、パフォーマンスの低下が発生する場合があります。


UIImage オブジェクトは CIImage オブジェクトを使用して初期化された場合は、プロパティの値は NULL です。


利用可能

iOS 2.0 以降で利用可能。





CIImage プロパティ


基礎となる Core Image データ。(読み取り専用)


宣言

<< SWIFT >>

var CIImage: CIImage? { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) CIImage *CIImage


議論

UIImage オブジェクトが CGImageRef を使って初期化された場合は、プロパティの値は nil です。


利用可能

iOS 5.0 以降で利用可能。





images プロパティ


アニメーション化されたイメージの場合、このプロパティは、アニメーションを構成する UIImage オブジェクトの完全な配列を保持します。(読み取り専用)


宣言

<< SWIFT >>

var images: [UIImage]? { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) NSArray <UIImage *> *images


議論

アニメーション化されていないイメージの場合、このプロパティの値は nil です。


利用可能

iOS 5.0 以降で利用可能。





duration プロパティ


アニメーション化されたイメージを表示するために使用される時間間隔を返します。(読み取り専用)


宣言

<< SWIFT >>

var duration: NSTimeInterval { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) NSTimeInterval duration


議論

アニメーション化されていないイメージの場合、このプロパティの値は 0.0 です。


利用可能

iOS 5.0 以降で利用可能。





capInsets プロパティ


エンドキャップのはめ込み。(読み取り専用)


宣言

<< SWIFT >>

var capInsets: UIEdgeInsets { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) UIEdgeInsets capInsets


議論

エンドキャップは、イメージが引き伸ばされたときにサイズ変更されるべきではないイメージの一部を指定します。この技術は、ボタンや他のサイズ変更可能なイメージベースのインターフェース要素を実装するために使用されます。エンドキャップでボタンのサイズが変更されると、サイズ変更はエンドキャップの間の領域では、ボタンの中間のみで発生します。エンドキャップ自体は元のサイズと外観を保ちます。


このプロパティは、すべての 4 つのエンドキャップのサイズを指定します。中間の(伸縮性のある) 部分は、エンドキャップに含まれていないすべてのピクセルで構成されています。これらのピクセルは、左から右へ、上から下へ、残りのスペースを埋めるために、分割されています。


サイズ変更可能でないイメージでは、このプロパティは UIEdgeInsetsZero に設定されています。イメージは、エンドキャップを使用しておらず、イメージ全体が伸縮の対象となります。このプロパティのゼロでない値を使用して新しいイメージを作成するには、resizableImageWithCapInsets: メソッドを使用して下さい。あなたのアプリケーションが capInsets パラメータとして UIEdgeInsetsZero を指定した場合、イメージ全体が分割されます。


利用可能

iOS 5.0 以降で利用可能。





alignmentRectInsets プロパティ


レイアウト中にイメージを配置するために使用される整列用メタデータ。(読み取り専用)


宣言

<< SWIFT >>

var alignmentRectInsets: UIEdgeInsets { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) UIEdgeInsets alignmentRectInsets


議論

より正確にイメージの内容を指定するヒントとしてインセット値を使用できます。例えば、明るさの効果を含む、20×20 ピクセルのアイコンを持っている場合、明るさの効果のない基本的なアイコンの位置を示すために {{2,2}、{16、16}} にインセットを設定するかもしれません。


イメージを含むオブジェクトは、それらのコンテンツ内のイメージを適切に配置するために、これらのインセットを使用できます。


利用可能

iOS 6.0 以降で利用可能。





imageAsset プロパティ


イメージに関連するイメージアセット(もしあれば) への参照を返します。(読み取り専用)


宣言

<< SWIFT >>

var imageAsset: UIImageAsset? { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) UIImageAsset *imageAsset


議論

イメージアセットからロードされたイメージの場合、このプロパティは、イメージの他のバリアントを取得するために使用できるイメージアセットオブジェクトを含んでいます。イメージアセットを使用してイメージオブジェクトを作成しなかった場合、このプロパティの値は nil です。このプロパティは、CIImage オブジェクトを使用して作成した画像に対しては常に nil です。


利用可能

iOS 8.0 以降で利用可能。





traitCollection プロパティ


イメージを記述する形質コレクションを返します。(読み取り専用)


宣言

<< SWIFT >>

@NSCopying var traitCollection: UITraitCollection { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly, copy) UITraitCollection *traitCollection


利用可能

iOS 8.0 以降で利用可能。





renderingMode プロパティ


イメージをレンダリングする方法を決定します。(読み取り専用)


宣言

<< SWIFT >>

var renderingMode: UIImageRenderingMode { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) UIImageRenderingMode renderingMode


議論

デフォルトのレンダリングモードは UIImageRenderingModeAutomatic です


利用可能

iOS 7.0 以降で利用可能。





leftCapWidth プロパティ

(iOS 5.0)


水平方向のエンドキャップサイズ。(読み取り専用)


旧式の文

代わりに capInsets プロパティを使用してください。


宣言

<< SWIFT >>

var leftCapWidth: Int { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) NSInteger leftCapWidth


議論

エンドキャップは、イメージが引き伸ばされたときにサイズ変更されるべきではないイメージの一部を指定します。この技術は、ボタンや他のサイズ変更可能なイメージベースのインターフェース要素を実装するために使用されます。エンドキャップでボタンのサイズが変更されると、サイズ変更はエンドキャップの間の領域では、ボタンの中間のみで発生します。エンドキャップ自体は元のサイズと外観を保ちます。


このプロパティは、左のエンドキャップのサイズを指定します。中間の(伸縮性のある) 部分は、1 ピクセルの幅と仮定されます。右のエンドキャップは、したがって、左エンドキャップと中央部分のサイズを加えることによって計算され、その後イメージの幅からその値が差し引かれます。


rightCapWidth = image.size.width - (image.leftCapWidth + 1);


デフォルトでは、このプロパティは 0 に設定されていて、イメージがエンドキャップを使用しておらず、イメージ全体が伸縮の対象であることを示しています。このプロパティにゼロでない値を使用して新しいイメージを作成するには、stretchableImageWithLeftCapWidth:topCapHeight: メソッドを使用します。


利用可能

iOS 2.0 以降で利用可能。

iOS 5.0 で旧式となる。


以下も見よ

– stretchableImageWithLeftCapWidth:topCapHeight:




topCapHeight プロパティ

(iOS 5.0)


垂直方向のエンドキャップサイズ。(読み取り専用)


旧式の文

代わりに capInsets プロパティを使用してください。


宣言

<< SWIFT >>

var topCapHeight: Int { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) NSInteger topCapHeight


議論

エンドキャップは、イメージが引き伸ばされたときにサイズ変更されるべきではないイメージの一部を指定します。この技術は、ボタンや他のサイズ変更可能なイメージベースのインターフェース要素を実装するために使用されます。エンドキャップでボタンのサイズが変更されると、サイズ変更はエンドキャップの間の領域では、ボタンの中間のみで発生します。エンドキャップ自体は元のサイズと外観を保ちます。


このプロパティは、上のエンドキャップのサイズを指定します。中間の(伸縮性のある) 部分は、1 ピクセルの幅と仮定されます。下のエンドキャップは、したがって、上のエンドキャップと中央部分のサイズを加えることによって計算され、その後イメージの高さからその値が差し引かれます。


bottomCapWidth = image.size.height - (image.topCapHeight + 1);


デフォルトでは、このプロパティは 0 に設定されていて、イメージがエンドキャップを使用しておらず、イメージ全体が伸縮の対象であることを示しています。このプロパティにゼロでない値を使用して新しいイメージを作成するには、stretchableImageWithLeftCapWidth:topCapHeight: メソッドを使用します。


利用可能

iOS 2.0 以降で利用可能。

iOS 5.0 で旧式となる。


以下も見よ

– stretchableImageWithLeftCapWidth:topCapHeight:




イメージの描画


– drawAtPoint:


現在のコンテキスト内の指定されたポイントにイメージを描画します。


宣言

<< SWIFT >>

func drawAtPoint(_ point: CGPoint)

<< OBJECTIVE-C >>
- (void)drawAtPoint:(CGPoint)point


パラメーター

pointイメージの左上隅を描画するべき点。

議論

このメソッドは、イメージの方向の設定を尊重して、現在のグラフィックスコンテキスト内でイメージ全体を描画します。デフォルトの座標系では、イメージが下に置かれ、指定された点の右に位置します。しかし、このメソッドは、現在のグラフィックスコンテキストに適用される全ての変換を尊重します。


このメソッドは、kCGBlendModeNormal ブレンドモードを使用して、完全に不透明なモードでイメージを描画します。


利用可能

iOS 2.0 以降で利用可能。





– drawAtPoint:blendMode:alpha:


カスタム合成オプションを使用して、指定された点でイメージ全体を描画します。


宣言

<< SWIFT >>

func drawAtPoint(_ point: CGPoint,
       blendMode blendMode: CGBlendMode,
           alpha alpha: CGFloat)

<< OBJECTIVE-C >>
- (void)drawAtPoint:(CGPoint)point
          blendMode:(CGBlendMode)blendMode
              alpha:(CGFloat)alpha


パラメーター

pointイメージの左上隅を描画すべき点。
blendMode画像を合成する際に使用するブレンドモード。
alpha0.0 と 1.0 の間の値として指定された、イメージの望みの不透明度。0.0 の値は完全に透明なイメージをレンダリングし、1.0 は、完全に不透明にレンダリングします。1.0 より大きい値は 1.0 と解釈されます。

議論

このメソッドは、イメージの方向の設定を尊重して、現在のグラフィックスコンテキスト内でイメージ全体を描画します。デフォルトの座標系では、イメージが下に置かれ、指定された点の右に位置します。しかし、このメソッドは、現在のグラフィックスコンテキストに適用される全ての変換を尊重します。


利用可能

iOS 2.0 以降で利用可能。





- drawInRect:


必要に応じてフィットするようにそれを拡大縮小して、指定された長方形にイメージ全体を描画します。


宣言

<< SWIFT >>

func drawInRect(_ rect: CGRect)

<< OBJECTIVE-C >>
- (void)drawInRect:(CGRect)rect


パラメーター

rectその中でイメージを描画する長方形(グラフィックスコンテキストの座標系の中で)。

議論

このメソッドは、イメージの方向の設定を尊重して、現在のグラフィックスコンテキスト内でイメージ全体を描画します。デフォルトの座標系では、イメージが下に置かれ、指定された長方形の原点の右に位置します。しかし、このメソッドは、現在のグラフィックスコンテキストに適用される全ての変換を尊重します。


このメソッドは、kCGBlendModeNormal ブレンドモードを使用して、完全な不透明でイメージを描画します。


利用可能

iOS 2.0 以降で利用可能。





– drawInRect:blendMode:alpha:


指定された長方形と指定された合成オプションを使用してイメージ全体を描画します。


宣言

<< SWIFT >>

func drawInRect(_ rect: CGRect,
      blendMode blendMode: CGBlendMode,
          alpha alpha: CGFloat)

<< OBJECTIVE-C >>
- (void)drawInRect:(CGRect)rect
         blendMode:(CGBlendMode)blendMode
             alpha:(CGFloat)alpha


パラメーター

rectその中でイメージを描画する長方形(グラフィックスコンテキストの座標系の中で)。
blendModeイメージを合成する際に使用するブレンドモード。
alpha0.0 と 1.0 の間の値として指定された、イメージの望みの不透明度。0.0 の値は完全に透明なイメージをレンダリングし、1.0 は、完全に不透明にレンダリングします。1.0 より大きい値は 1.0 と解釈されます。

議論

このメソッドは、指定した長方形にフィットするようにするために、必要に応じてイメージを拡大縮小します。このメソッドは、イメージの方向の設定を尊重して、現在のグラフィックスコンテキスト内でイメージを描画します。デフォルトの座標系では、イメージが下に置かれ、指定された長方形の原点の右側に位置しています。しかし、このメソッドは、現在のグラフィックスコンテキストに適用される全ての変換を尊重します。


利用可能

iOS 2.0 以降で利用可能。





– drawAsPatternInRect:


受信者の内容を分割のパターンとして使用し、分割した Quartz パターンを描画します。


宣言

<< SWIFT >>

func drawAsPatternInRect(_ rect: CGRect)

<< OBJECTIVE-C >>
- (void)drawAsPatternInRect:(CGRect)rect


パラメーター

rectその中でイメージを描画すべき長方形(グラフィックスコンテキストの座標系の中の)。

議論

このメソッドは、指定された長方形内のイメージを分割するのに Quartz パターンを使用します。イメージは隙間なく分割されており、塗りつぶしの色は無視されます。デフォルトの座標系ではイメージの分割は下に置かれ、指定された長方形の原点の右側に位置しています。しかし、このメソッドは、現在のグラフィックスコンテキストに適用される全ての変換を尊重します。


利用可能

iOS 2.0 以降で利用可能。





定数


UIImageOrientation


イメージの可能な方向を指定します。


宣言

<< SWIFT >>

enum UIImageOrientation : Int {
    case Up
    case Down
    case Left
    case Right
    case UpMirrored
    case DownMirrored
    case LeftMirrored
    case RightMirrored
}

<< OBJECTIVE-C >>
typedef enum {
   UIImageOrientationUp,
   UIImageOrientationDown ,   // 180 deg rotation 
   UIImageOrientationLeft ,   // 90 deg CW 
   UIImageOrientationRight ,   // 90 deg CCW 
   UIImageOrientationUpMirrored ,    // as above but image mirrored along 
   // other axis. horizontal flip 
   UIImageOrientationDownMirrored ,  // horizontal flip 
   UIImageOrientationLeftMirrored ,  // vertical flip 
   UIImageOrientationRightMirrored , // vertical flip 
} UIImageOrientation;


定数

Import 文

<< OBJECTIVE-C >>

@import UIKit;


<< SWIFT >>

import UIKit


利用可能

iOS 2.0 以降で利用可能。





UIImageResizingMode


イメージの可能なサイズ変更モードを指定します。


宣言

<< SWIFT >>

enum UIImageResizingMode : Int {
    case Tile
    case Stretch
}

<< OBJECTIVE-C >>
typedef enum {
   UIImageResizingModeTile,
   UIImageResizingModeStretch,
} UIImageResizingMode;


定数

Import 文

<< OBJECTIVE-C >>

@import UIKit;


<< SWIFT >>

import UIKit


利用可能

iOS 6.0 以降で利用可能。





UIImageRenderingMode


イメージの可能なレンダリングモードを指定します。


宣言

<< SWIFT >>

enum UIImageRenderingMode : Int {
    case Automatic
    case AlwaysOriginal
    case AlwaysTemplate
}

<< OBJECTIVE-C >>
typedef enum : NSInteger {
   UIImageRenderingModeAutomatic,
   UIImageRenderingModeAlwaysOriginal,
   UIImageRenderingModeAlwaysTemplate,
} UIImageRenderingMode;


定数

議論

テンプレートのイメージの議論については、UIKit ユーザー・インタフェース・カタログテンプレートイメージ を参照してください。


Import 文

<< OBJECTIVE-C >>

@import UIKit;


<< SWIFT >>

import UIKit


利用可能

iOS 7.0 以降で利用可能。





次の章
目次
Xcode の新機能

  • UIImage
  • 概観
  • イメージ・オブジェクトの作成
    伸縮可能イメージの定義
    イメージの比較
    イメージデータへのアクセス
  • タスク
  • イメージのロードとキャッシング
  • imageNamed:inBundle:compatible
    WithTraitCollection:

    imageNamed:
  • イメージオブジェクトの作成と初期化
  • imageWithContentsOfFile:
    imageWithData:
    imageWithData:scale:
    imageWithCGImage:
    imageWithCGImage:scale:orientation:
    imageWithCIImage:
    imageWithCIImage:scale:orientation:
    initWithContentsOfFile:
    initWithData:
    initWithData:scale:
    initWithCGImage:
    initWithCGImage:scale:orientation:
    initWithCIImage:
    initWithCIImage:scale:orientation:
  • 特殊なイメージオブジェクトの作成
  • animatedImageNamed:duration:
    animatedImageWithImages:duration:
    animatedResizableImageNamed :capInsets:duration:
    animatedResizableImageNamed :capInsets:resizingMode:duration:
    imageFlippedForRightToLeftLayout
    Direction

    imageWithRenderingMode:
    imageWithAlignmentRectInsets:
    resizableImageWithCapInsets:
    resizableImageWithCapInsets :resizingMode:
    stretchableImageWithLeftCapWidth :topCapHeight:
  • イメージの属性
  • imageOrientation プロパティ
    size プロパティ
    scale プロパティ
    flipsForRightToLeftLayoutDirection プロパティ
    resizingMode プロパティ
    CGImage プロパティ
    CIImage プロパティ
    images プロパティ
    duration プロパティ
    capInsets プロパティ
    alignmentRectInsets プロパティ
    imageAsset プロパティ
    traitCollection プロパティ
    renderingMode プロパティ
    leftCapWidth プロパティ
    topCapHeight プロパティ
  • イメージの描画
  • drawAtPoint:
    drawAtPoint:blendMode:alpha:
    drawInRect:
    drawInRect:blendMode:alpha:
    drawAsPatternInRect:
  • 定数
  • UIImageOrientation
    UIImageResizingMode
    UIImageRenderingMode
    文書改定履歴












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)












    トップへ(UIImage)