Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release
, bukan aosp-main
, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Referensi Struct camera3_capture_request
#include <
camera3.h
>
camera3_capture_request_t:
Satu permintaan untuk pemrosesan ulang buffering/pengambilan gambar, yang dikirim ke perangkat HAL Kamera oleh framework di process_capture_request().
Permintaan berisi setelan yang akan digunakan untuk pengambilan ini, dan kumpulan buffering output untuk menulis data gambar yang dihasilkan. Secara opsional, buffer input dapat berisi buffer input, dalam hal ini permintaannya adalah untuk memproses ulang buffer input tersebut, bukan mengambil gambar baru dengan sensor kamera. Rekaman diidentifikasi oleh frame_number.
Sebagai respons, perangkat HAL kamera harus mengirim
struktur
camera3_capture_result
secara asinkron ke framework, menggunakan callback process_capture_result().
Definisi di baris
2135
file
camera3.h
.
Nomor frame adalah bilangan bulat yang bertambah yang ditetapkan oleh framework untuk mengidentifikasi rekaman ini secara unik. ID ini harus ditampilkan dalam panggilan hasil, dan juga digunakan untuk mengidentifikasi permintaan dalam notifikasi asinkron yang dikirim ke
camera3_callback_ops_t.notify()
.
Definisi di baris
2142
dari file
camera3.h
.
Buffer aliran input yang akan digunakan untuk permintaan ini, jika ada.
Jika input_buffer adalah NULL, permintaan tersebut adalah untuk pengambilan gambar baru dari pemindai gambar. Jika input_buffer valid, permintaan tersebut adalah untuk memproses ulang gambar yang terdapat dalam input_buffer.
Dalam kasus terakhir, HAL harus menetapkan release_fence dari input_buffer ke fence sinkronisasi yang valid, atau ke -1 jika HAL tidak mendukung sinkronisasi, sebelum process_capture_request() ditampilkan.
HAL diwajibkan untuk menunggu pagar sinkronisasi akuisisi buffer input sebelum mengaksesnya.
<= CAMERA_DEVICE_API_VERSION_3_1:
Setiap buffering input yang disertakan di sini akan terdaftar dengan HAL melalui register_stream_buffers() sebelum disertakan dalam permintaan.
>= CAMERA_DEVICE_API_VERSION_3_2:
Buffer tidak akan dipradaftarkan dengan HAL. Permintaan berikutnya dapat menggunakan kembali buffering, atau menyediakan buffering yang sepenuhnya baru.
Definisi di baris
2177
dari file
camera3.h
.
uint32_t num_output_buffers
|
Jumlah buffering output untuk permintaan pengambilan ini. Minimal harus 1.
Definisi di baris
2183
dari file
camera3.h
.
Array buffer streaming num_output_buffers, yang akan diisi dengan data gambar dari pengambilan/pemrosesan ulang ini. HAL harus menunggu pagar akuisisi dari setiap buffering streaming sebelum menulis ke buffer tersebut.
HAL mengambil kepemilikan entri buffer_handle_t yang sebenarnya di output_buffers; framework tidak mengaksesnya hingga ditampilkan dalam camera3_capture_result_t.
<= CAMERA_DEVICE_API_VERSION_3_1:
Semua buffering yang disertakan di sini akan terdaftar dengan HAL melalui register_stream_buffers() sebelum disertakan dalam permintaan.
>= CAMERA_DEVICE_API_VERSION_3_2:
Setiap atau semua buffering yang disertakan di sini mungkin baru dalam permintaan ini (belum pernah dilihat oleh HAL).
Definisi di baris
2204
dari file
camera3.h
.
Buffer setelan berisi parameter pengambilan dan pemrosesan untuk permintaan. Sebagai kasus khusus, buffering setelan NULL menunjukkan bahwa setelan tersebut identik dengan permintaan pengambilan yang baru saja dikirim. Buffer NULL tidak dapat digunakan sebagai permintaan pertama yang dikirim setelah panggilan configure_streams().
Definisi di baris
2151
dari file
camera3.h
.
Dokumentasi untuk struct ini dibuat dari file berikut:
-
hardware/libhardware/include/hardware/
camera3.h
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-27 UTC."],[],[],null,["# Android Hardware Abstraction Layer: camera3_capture_request Struct Reference\n\ncamera3_capture_request Struct Reference\n========================================\n\n[Data Fields](#pub-attribs) \ncamera3_capture_request Struct Reference \n\n`\n#include \u003c\n`[camera3.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h)`\n\u003e\n`\n\n|----------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------|\n| Data Fields ----------- ||\n| uint32_t | [frame_number](/reference/hal/structcamera3__capture__request#a57cc7f4d579276167efca6cf047839b2) |\n| ||\n| const [camera_metadata_t](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera_common.h) \\* | [settings](/reference/hal/structcamera3__capture__request#adccd8702a549b9f5fb98afa0c4b44a62) |\n| ||\n| [camera3_stream_buffer_t](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h) \\* | [input_buffer](/reference/hal/structcamera3__capture__request#ac1c94bbde71f06911c6abe85f3a44593) |\n| ||\n| uint32_t | [num_output_buffers](/reference/hal/structcamera3__capture__request#a70d2093ddb1078b68c6688b6cf923380) |\n| ||\n| const [camera3_stream_buffer_t](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h) \\* | [output_buffers](/reference/hal/structcamera3__capture__request#ab1d50229b27a7cf28ff1374be6650fb6) |\n| ||\n\n\nDetailed Description\n--------------------\n\n\ncamera3_capture_request_t:\n\n\nA single request for image capture/buffer reprocessing, sent to the Camera HAL device by the framework in process_capture_request().\n\n\nThe request contains the settings to be used for this capture, and the set of output buffers to write the resulting image data in. It may optionally contain an input buffer, in which case the request is for reprocessing that input buffer instead of capturing a new image with the camera sensor. The capture is identified by the frame_number.\n\n\nIn response, the camera HAL device must send a\n[camera3_capture_result](/reference/hal/structcamera3__capture__result)\nstructure asynchronously to the framework, using the process_capture_result() callback.\n\n\nDefinition at line\n[2135](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h)\nof file\n[camera3.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h)\n.\n\nField Documentation\n-------------------\n\n\n|-----------------------|\n| uint32_t frame_number |\n\n\nThe frame number is an incrementing integer set by the framework to uniquely identify this capture. It needs to be returned in the result call, and is also used to identify the request in asynchronous notifications sent to\n[camera3_callback_ops_t.notify()](/reference/hal/structcamera3__callback__ops#a6d702d6e962f95105b984b17462619b3)\n.\n\n\nDefinition at line\n[2142](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h)\nof file\n[camera3.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h)\n.\n\n|-----------------------------------------------------------------------------------------------------------------------------------------------|\n| [camera3_stream_buffer_t](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h) \\* input_buffer |\n\n\nThe input stream buffer to use for this request, if any.\n\n\nIf input_buffer is NULL, then the request is for a new capture from the imager. If input_buffer is valid, the request is for reprocessing the image contained in input_buffer.\n\n\nIn the latter case, the HAL must set the release_fence of the input_buffer to a valid sync fence, or to -1 if the HAL does not support sync, before process_capture_request() returns.\n\n\nThe HAL is required to wait on the acquire sync fence of the input buffer before accessing it.\n\n\n\\\u003c= CAMERA_DEVICE_API_VERSION_3_1:\n\n\nAny input buffer included here will have been registered with the HAL through register_stream_buffers() before its inclusion in a request.\n\n\n\\\u003e= CAMERA_DEVICE_API_VERSION_3_2:\n\n\nThe buffers will not have been pre-registered with the HAL. Subsequent requests may reuse buffers, or provide entirely new buffers.\n\n\nDefinition at line\n[2177](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h)\nof file\n[camera3.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h)\n.\n\n|-----------------------------|\n| uint32_t num_output_buffers |\n\n\nThe number of output buffers for this capture request. Must be at least 1.\n\n\nDefinition at line\n[2183](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h)\nof file\n[camera3.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h)\n.\n\n|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| const [camera3_stream_buffer_t](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h) \\* output_buffers |\n\n\nAn array of num_output_buffers stream buffers, to be filled with image data from this capture/reprocess. The HAL must wait on the acquire fences of each stream buffer before writing to them.\n\n\nThe HAL takes ownership of the actual buffer_handle_t entries in output_buffers; the framework does not access them until they are returned in a camera3_capture_result_t.\n\n\n\\\u003c= CAMERA_DEVICE_API_VERSION_3_1:\n\n\nAll the buffers included here will have been registered with the HAL through register_stream_buffers() before their inclusion in a request.\n\n\n\\\u003e= CAMERA_DEVICE_API_VERSION_3_2:\n\n\nAny or all of the buffers included here may be brand new in this request (having never before seen by the HAL).\n\n\nDefinition at line\n[2204](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h)\nof file\n[camera3.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h)\n.\n\n|-------------------------------------------------------------------------------------------------------------------------------------------------|\n| const [camera_metadata_t](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera_common.h) \\* settings |\n\n\nThe settings buffer contains the capture and processing parameters for the request. As a special case, a NULL settings buffer indicates that the settings are identical to the most-recently submitted capture request. A NULL buffer cannot be used as the first submitted request after a configure_streams() call.\n\n\nDefinition at line\n[2151](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h)\nof file\n[camera3.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h)\n.\n\n*** ** * ** ***\n\nThe documentation for this struct was generated from the following file:\n\n- hardware/libhardware/include/hardware/ [camera3.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/camera3.h)"]]