Référence de structure camera3_capture_request
#include < camera3.h >
Champs de données | |
| uint32_t | Numéro de cadre |
| const camera_metadata_t * | paramètres |
| camera3_stream_buffer_t * | tampon_entrée |
| uint32_t | num_output_buffers |
| const camera3_stream_buffer_t * | tampons_de sortie |
Description détaillée
camera3_capture_request_t :
Une seule demande de capture d'image/retraitement du tampon, envoyée au périphérique Camera HAL par le framework dans process_capture_request().
La requête contient les paramètres à utiliser pour cette capture et l'ensemble des tampons de sortie dans lesquels écrire les données d'image résultantes. Elle peut éventuellement contenir un tampon d'entrée, auquel cas la demande concerne le retraitement de ce tampon d'entrée au lieu de capturer un nouveau tampon d'entrée. image avec le capteur de la caméra. La capture est identifiée par le frame_number.
En réponse, le périphérique HAL de la caméra doit envoyer une structure camera3_capture_result de manière asynchrone au framework, à l'aide du rappel process_capture_result().
Documentation de terrain
| uint32_t numéro_cadre |
Le numéro de trame est un entier incrémentiel défini par le framework pour identifier de manière unique cette capture. Il doit être renvoyé dans l'appel de résultat et est également utilisé pour identifier la demande dans les notifications asynchrones envoyées à camera3_callback_ops_t.notify() .
| camera3_stream_buffer_t * input_buffer |
Tampon de flux d'entrée à utiliser pour cette requête, le cas échéant.
Si input_buffer est NULL, alors la demande concerne une nouvelle capture depuis l'imageur. Si input_buffer est valide, la requête concerne le retraitement de l'image contenue dans input_buffer.
Dans ce dernier cas, la HAL doit définir le release_fence du input_buffer sur une clôture de synchronisation valide, ou sur -1 si la HAL ne prend pas en charge la synchronisation, avant le retour de process_capture_request().
Le HAL doit attendre la clôture de synchronisation d'acquisition du tampon d'entrée avant d'y accéder.
<= CAMERA_DEVICE_API_VERSION_3_1 :
Tout tampon d'entrée inclus ici aura été enregistré auprès du HAL via register_stream_buffers() avant son inclusion dans une requête.
>= CAMERA_DEVICE_API_VERSION_3_2 :
Les buffers n'auront pas été pré-enregistrés auprès de la HAL. Les requêtes ultérieures peuvent réutiliser des tampons ou fournir des tampons entièrement nouveaux.
| uint32_t num_output_buffers |
| const camera3_stream_buffer_t * output_buffers |
Un tableau de tampons de flux num_output_buffers, à remplir avec les données d'image de cette capture/retraitement. Le HAL doit attendre les barrières d'acquisition de chaque tampon de flux avant d'y écrire.
Le HAL s'approprie les entrées réelles buffer_handle_t dans output_buffers ; le framework n'y accède pas tant qu'ils ne sont pas renvoyés dans un camera3_capture_result_t.
<= CAMERA_DEVICE_API_VERSION_3_1 :
Tous les tampons inclus ici auront été enregistrés auprès du HAL via register_stream_buffers() avant leur inclusion dans une requête.
>= CAMERA_DEVICE_API_VERSION_3_2 :
Tout ou partie des tampons inclus ici peuvent être tout nouveaux dans cette requête (n'ayant jamais été vus auparavant par HAL).
| const camera_metadata_t * paramètres |
Le tampon de paramètres contient les paramètres de capture et de traitement de la requête. Comme cas particulier, un tampon de paramètres NULL indique que les paramètres sont identiques à la demande de capture soumise la plus récemment. Un tampon NULL ne peut pas être utilisé comme première requête soumise après un appel configure_streams().
La documentation de cette structure a été générée à partir du fichier suivant :
- matériel/libhardware/include/hardware/ camera3.h