Core Graphics > CGAcquireDisplayFadeReservation(_:_:)
関数
CGAcquireDisplayFadeReservation(_:_:)
指定した時間間隔でフェードハードウェアを予約します。
宣言
パラメータ
| seconds | フェードハードウェアを予約する望みの秒数。アプリケーションは、間隔 (0,kCGMaxDisplayReservationInterval) 内の任意の値を指定できます。 |
| pNewToken | フェード予約トークンのための記憶域(呼び出し元によって提供されます) へのポインタ。返る時に、記憶域には新しいトークンが含まれます。 |
戻り値
他のフェード予約が有効な場合は、noneAvailable を返します。 それ以外の場合は、success を返します。
議論
フェード操作を実行する前に、アプリケーションは指定された時間、フェードハードウェアを予約しなければなりません。Quartz は、新しいフェード予約を表すトークンを返します。アプリケーションは、他のディスプレイのフェード関数へのその後の呼び出しで、このトークンを引数として使用します。
フェード予約している間隔中、アプリケーションにはフェードハードウェアを使用する排他的な権利があります。間隔の終わりには、トークンは無効になり、ハードウェアは自動的に通常の状態に戻ります。普通、アプリケーションは CGReleaseDisplayFadeReservation(_:) を呼び出して、フェード予約が期限切れになる前に解放します。