LowLagPhotoSequenceCapture クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
低いシャッター ラグの写真の迅速なシーケンスを取得するためのメソッドを提供します。
public ref class LowLagPhotoSequenceCapture sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class LowLagPhotoSequenceCapture final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class LowLagPhotoSequenceCapture
Public NotInheritable Class LowLagPhotoSequenceCapture
- 継承
- 属性
Windows の要件
デバイス ファミリ |
Windows 10 (10.0.10240.0 で導入)
|
API contract |
Windows.Foundation.UniversalApiContract (v1.0 で導入)
|
注釈
写真シーケンスモードは、写真の迅速なシーケンスを取ります。 写真シーケンスの重要なシナリオは、ユーザーが写真を撮る前の過去の写真を取得することです。 露出やフラッシュなどの設定が異なる一連の写真を撮る場合は、 VariablePhotoSequenceCapture を使用します。
MediaCapture.VideoDeviceController を使用して、キャプチャ デバイスの LowLagPhotoSequenceControl にアクセスできます。 LowLagPhotoSequenceControl は、フォト シーケンス セッションに関連する設定を管理するために使用されます。
LowLagPhotoSequenceControl.Supported をオンにすると、デバイスでフォト シーケンス モードがサポートされているかどうかを確認できます。
MediaCapture.PrepareLowLagPhotoSequenceCaptureAsync を使用して、写真シーケンス キャプチャを初期化します。 これは非同期呼び出しであり、完了時に LowLagPhotoSequenceCapture オブジェクトを返します。 これは StartAsync の前に呼び出す必要があります。
写真のキャプチャを開始するには、 StartAsync を呼び出します。 操作が停止するまで、アプリはデバイスから写真を受け取り続けます。
StopAsync は、 StartAsync を使用して再起動できる操作を停止します。
シーケンスでキャプチャされた写真を取得するために、 PhotoCaptured イベントにハンドラーを追加します。 PhotoCapturedEventArgs は、キャプチャされたフレームのデータを提供します。 PhotoCapturedEventArgs.Frame にはキャプチャされた写真が含まれ、 PhotoCapturedEventArgs.Thumbnail にはサムネイルが含まれています。
FinishAsync は、フォト シーケンス キャプチャ操作を停止し、写真シーケンス操作で使用される LowLagPhotoSequenceCapture オブジェクトとリソースを解放します。 FinishAsync を呼び出した後に写真シーケンス操作を再開する場合は、MediaCapture.PrepareLowLagPhotoSequenceCaptureAsync を呼び出して、新しい LowLagPhotoSequenceCapture オブジェクトを初期化する必要があります。
メディアの種類が変更された場合、または効果が追加された場合は、 MediaCapture.PrepareLowLagPhotoSequenceCaptureAsync を呼び出して、新しい LowLagPhotoCapture オブジェクトを作成する必要があります。
LowLagPhotoSequenceControl.GetCurrentFrameRate は、写真を撮影するフレーム レートを指定します。
PhotoCapturedEventArgs.CaptureTimeOffset を使用すると、フレームが将来、0 より大きいか、過去に 0 未満であったかを確認できます。
アプリで 1 秒あたりのフレーム数を制限する場合は、 LowLagPhotoSequenceControl.PhotosPerSecondLimit を使用できます。 これは、デバイス上のセンサーが 30fps を処理できるが、アプリで 4fps しか必要とできない状況で役立ちます。
サムネイルを有効にするには、 LowLagPhotoSequenceControl.ThumbnailEnabled を true に設定 します。
LowLagPhotoSequenceControl.DesiredThumbnailSize を使用して目的のサムネイル サイズを設定し、LowLagPhotoSequenceControl.ThumbnailFormat を使用してサムネイル形式を設定できます。
過去の写真の数は LowLagPhotoSequenceControl.MaxPastPhotos を超えることはできません。これは、ドライバーによってサポートされている過去の写真の最大数です。 返される過去の写真の数は、 LowLagPhotoSequenceControl.PastPhotoLimit、 LowLagPhotoSequenceControl.MaxPastPhotos、または現在使用可能な過去の写真の数の小さい値になります。
メソッド
FinishAsync() |
写真シーケンス キャプチャ操作で使用される LowLagPhotoSequenceCapture オブジェクトとリソースを非同期的に解放します。 |
StartAsync() |
写真のキャプチャを非同期的に開始します。 |
StopAsync() |
写真のキャプチャを非同期的に停止します。 |
イベント
PhotoCaptured |
写真がキャプチャされたときに発生します。 |