A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release
anziché aosp-main
per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Riferimento alla struttura camera3_capture_request
#include <
camera3.h
>
camera3_capture_request_t:
Una singola richiesta di elaborazione di nuovo del buffer/dell'acquisizione di immagini, inviata al dispositivo HAL della fotocamera dal framework in process_capture_request().
La richiesta contiene le impostazioni da utilizzare per questa acquisizione e l'insieme di buffer di output in cui scrivere i dati delle immagini risultanti. Se vuoi, può contenere un buffer di input, nel qual caso la richiesta riguarda la rielaborazione di questo buffer anziché l'acquisizione di una nuova immagine con il sensore della fotocamera. L'acquisizione è identificata dal numero di frame.
In risposta, il dispositivo HAL della fotocamera deve inviare al framework una struttura
camera3_capture_result
in modo asincrono, utilizzando il callback process_capture_result().
Definizione nella riga
2135
del file
camera3.h
.
Il numero di frame è un numero intero incrementale impostato dal framework per identificare in modo univoco questa acquisizione. Deve essere restituito nella chiamata del risultato e viene utilizzato anche per identificare la richiesta nelle notifiche asincrone inviate a
camera3_callback_ops_t.notify()
.
Definizione nella riga
2142
del file
camera3.h
.
Il buffer dello stream di input da utilizzare per questa richiesta, se presente.
Se input_buffer è NULL, la richiesta riguarda una nuova acquisizione dall'imager. Se input_buffer è valido, la richiesta riguarda la rielaborazione dell'immagine contenuta in input_buffer.
In quest'ultimo caso, l'HAL deve impostare release_fence dell'input_buffer su una barriera di sincronizzazione valida o su -1 se l'HAL non supporta la sincronizzazione prima del ritorno di process_capture_request().
L'HAL è tenuto ad attendere la recinzione di sincronizzazione di acquisizione del buffer di input prima di accedervi.
<= CAMERA_DEVICE_API_VERSION_3_1:
Qualsiasi buffer di input incluso qui sarà stato registrato nell'HAL tramite register_stream_buffers() prima di essere incluso in una richiesta.
>= CAMERA_DEVICE_API_VERSION_3_2:
I buffer non saranno stati preregistrati con l'HAL. Le richieste successive possono riutilizzare i buffer o fornire buffer completamente nuovi.
Definizione nella riga
2177
del file
camera3.h
.
uint32_t num_output_buffers
|
Il numero di buffer di output per questa richiesta di acquisizione. Deve essere almeno 1.
Definizione nella riga
2183
del file
camera3.h
.
Un array di num_output_buffers stream buffer, da compilare con i dati delle immagini di questa acquisizione/rielaborazione. L'HAL deve attendere le recinti di acquisizione di ogni buffer dello stream prima di scrivere.
L'HAL acquisisce la proprietà delle voci buffer_handle_t effettive in output_buffers; il framework non vi accede finché non vengono restituite in camera3_capture_result_t.
<= CAMERA_DEVICE_API_VERSION_3_1:
Tutti i buffer inclusi qui saranno stati registrati nell'HAL tramite register_stream_buffers() prima della loro inclusione in una richiesta.
>= CAMERA_DEVICE_API_VERSION_3_2:
Uno o tutti i buffer inclusi qui potrebbero essere nuovi in questa richiesta (non sono mai stati visti dall'HAL).
Definizione nella riga
2204
del file
camera3.h
.
Il buffer delle impostazioni contiene i parametri di acquisizione ed elaborazione per la richiesta. Come caso speciale, un buffer delle impostazioni NULL indica che le impostazioni sono identiche alla richiesta di acquisizione inviata più di recente. Un buffer NULL non può essere utilizzato come prima richiesta inviata dopo una chiamata a configure_streams().
Definizione nella riga
2151
del file
camera3.h
.
La documentazione di questa struttura è stata generata dal seguente file:
-
hardware/libhardware/include/hardware/
camera3.h
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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)"]]