Camera3_capture_request 構造体のリファレンス

Camera3_capture_request 構造体のリファレンス

#include < camera3.h >

データフィールド

uint32_tフレーム番号
constカメラ_メタデータ_t *設定
カメラ3_ストリーム_バッファ_t *入力バッファ
uint32_t num_output_buffers
const Camera3_stream_buffer_t *出力バッファ

詳細な説明

カメラ3_キャプチャ_リクエスト_t:

process_capture_request() のフレームワークによってカメラ HAL デバイスに送信される、画像キャプチャ/バッファ再処理の 1 つのリクエスト。

リクエストには、このキャプチャに使用される設定と、結果の画像データを書き込むための出力バッファのセットが含まれています。オプションで入力バッファが含まれる場合があります。その場合、リクエストは、新しい画像データをキャプチャするのではなく、その入力バッファを再処理するためのものです。カメラセンサーによる画像。キャプチャは、frame_number によって識別されます。

応答として、カメラ HAL デバイスは process_capture_result() コールバックを使用して、 camera3_capture_result構造体をフレームワークに非同期的に送信する必要があります。

ファイルCamera3.h2135行目の定義。

フィールドドキュメント

uint32_t フレーム番号

フレーム番号は、このキャプチャを一意に識別するためにフレームワークによって設定される増分整数です。これは結果呼び出しで返される必要があり、 Camera3_callback_ops_t.notify()に送信される非同期通知でリクエストを識別するためにも使用されます。

ファイルCamera3.h2142行目の定義。

このリクエストに使用する入力ストリーム バッファー (存在する場合)。

input_buffer が NULL の場合、リクエストはイメージャからの新しいキャプチャです。 input_buffer が有効な場合、リクエストは input_buffer に含まれる画像を再処理するためのものです。

後者の場合、HAL は、process_capture_request() が戻る前に、input_buffer の release_fence を有効な同期フェンスに設定するか、HAL が同期をサポートしていない場合は -1 に設定する必要があります。

HAL は、入力バッファにアクセスする前に、入力バッファの取得同期フェンスを待機する必要があります。

<= CAMERA_DEVICE_API_VERSION_3_1:

ここに含まれる入力バッファは、リクエストに含める前に register_stream_buffers() を通じて HAL に登録されます。

>= CAMERA_DEVICE_API_VERSION_3_2:

バッファは HAL に事前登録されていません。後続のリクエストでは、バッファを再利用することも、まったく新しいバッファを提供することもできます。

ファイルCamera3.h2177行目の定義。

uint32_t num_output_buffers

このキャプチャリクエストの出力バッファの数。少なくとも 1 である必要があります。

ファイルCamera3.h2183行目の定義。

const Camera3_stream_buffer_t * Output_buffers

このキャプチャ/再処理からの画像データが格納される num_output_buffers ストリーム バッファーの配列。 HAL は、各ストリーム バッファに書き込む前に、その取得フェンスで待機する必要があります。

HAL は、output_buffers 内の実際のbuffer_handle_t エントリの所有権を取得します。フレームワークは、カメラ 3_capture_result_t で返されるまで、それらにアクセスしません。

<= CAMERA_DEVICE_API_VERSION_3_1:

ここに含まれるすべてのバッファは、リクエストに含める前に register_stream_buffers() を通じて HAL に登録されます。

>= CAMERA_DEVICE_API_VERSION_3_2:

ここに含まれるバッファの一部またはすべては、このリクエストではまったく新しいものである可能性があります (HAL がこれまで見たことがない)。

ファイルCamera3.h2204行目の定義。

const Camera_metadata_t * 設定

設定バッファには、リクエストのキャプチャおよび処理パラメータが含まれています。特殊なケースとして、NULL 設定バッファーは、設定が最後に送信されたキャプチャ リクエストと同一であることを示します。 NULL バッファーは、configure_streams() 呼び出し後に最初に送信されたリクエストとして使用できません。

ファイルCamera3.h2151行目の定義。


この構造体のドキュメントは次のファイルから生成されました。
  • ハードウェア/libhardware/include/hardware/camera3.h