camera_device_ops 結構參考資料

資料欄位
camera_device_ops 結構體參考資料

#include < camera.h >

資料欄位

int(*  set_preview_window )(struct camera_device *, struct preview_stream_ops *window)
 
void(*  set_callbacks )(struct camera_device *, camera_notify_callback notify_cb, camera_data_callback data_cb, camera_data_timestamp_callback data_cb_timestamp, camera_request_memory get_memory, void *user)
 
void(*  enable_msg_type )(struct camera_device *, int32_t msg_type)
 
void(*  disable_msg_type )(struct camera_device *, int32_t msg_type)
 
int(*  msg_type_enabled )(struct camera_device *, int32_t msg_type)
 
int(*  start_preview )(struct camera_device *)
 
void(*  stop_preview )(struct camera_device *)
 
int(*  preview_enabled )(struct camera_device *)
 
int(*  store_meta_data_in_buffers )(struct camera_device *, int enable)
 
int(*  start_recording )(struct camera_device *)
 
void(*  stop_recording )(struct camera_device *)
 
int(*  recording_enabled )(struct camera_device *)
 
void(*  release_recording_frame )(struct camera_device *, const void *opaque)
 
int(*  auto_focus )(struct camera_device *)
 
int(*  cancel_auto_focus )(struct camera_device *)
 
int(*  take_picture )(struct camera_device *)
 
int(*  cancel_picture )(struct camera_device *)
 
int(*  set_parameters )(struct camera_device *, const char *parms)
 
char *(*  get_parameters )(struct camera_device *)
 
void(*  put_parameters )(struct camera_device *, char *)
 
int(*  send_command )(struct camera_device *, int32_t cmd, int32_t arg1, int32_t arg2)
 
void(*  release )(struct camera_device *)
 
int(*  dump )(struct camera_device *, int fd)
 

詳細說明

定義位於檔案 camera.h 的 99 行。

欄位說明文件

int(* auto_focus)(struct camera_device *)

開始自動對焦，在對焦完成時，系統會使用 CAMERA_MSG_FOCUS 呼叫通知回呼例行程序。如果需要其他自動對焦，系統會再次呼叫 autoFocus()。

定義位於檔案 camera.h 的 227 行。

int(* cancel_auto_focus)(struct camera_device *)

取消自動對焦功能。如果自動對焦功能仍在進行，此函式會取消該功能。無論是否正在進行自動對焦，這個函式都會將對焦位置設回預設值。如果相機不支援自動對焦，則不會執行此操作。

定義位於檔案 camera.h 的 235 行。

int(* cancel_picture)(struct camera_device *)

取消使用 takePicture 啟動的拍照作業。在未拍攝相片時呼叫此方法會導致無操作。

定義位於檔案 camera.h 的 246 行。

void(* disable_msg_type)(struct camera_device *, int32_t msg_type)

停用單一或多則訊息。

收到對 disableMsgType(CAMERA_MSG_VIDEO_FRAME) 的呼叫後，相機 HAL 不應依賴其用戶端呼叫 releaseRecordingFrame()，以便在 disableMsgType(CAMERA_MSG_VIDEO_FRAME) 呼叫前後釋放相機 HAL 傳送的錄影影格。呼叫 disableMsgType(CAMERA_MSG_VIDEO_FRAME) 後，攝影機 HAL 用戶端不得修改/存取任何錄影影格。

定義位於檔案 camera.h 的 132 行。

int(* dump)(struct camera_device *, int fd)

傾印相機硬體狀態

定義位於檔案 camera.h 的 282 行。

void(* enable_msg_type)(struct camera_device *, int32_t msg_type)

以下三個函式都會使用 msg_type，這是在 include/ui/Camera.h 中定義的訊息位元遮罩，可啟用訊息或一組訊息。

定義位於檔案 camera.h 的 120 行。

char*(* get_parameters)(struct camera_device *)

擷取相機參數。如果 put_parameters 不為空值，則攝影機 HAL 傳回的緩衝區必須透過 put_parameters 傳回。

定義位於檔案 camera.h 的 258 行。

int(* msg_type_enabled)(struct camera_device *, int32_t msg_type)

查詢訊息或一組訊息是否已啟用。請注意，這項運算會以 AND 運算方式運作，如果查詢的任何訊息都關閉，這項運算會傳回 false。

定義位於檔案 camera.h 的 139 行。

int(* preview_enabled)(struct camera_device *)

如果已啟用預覽功能，則傳回 true。

定義位於檔案 camera.h 的 154 行。

void(* put_parameters)(struct camera_device *, char *)

當我們呼叫 get_parameters 時，相機 HAL 會使用自己的記憶體傳遞參數。如果 put_parameters 不是 NULL，請使用這個函式將記憶體傳回至相機 HAL。如果 put_parameters 為空值，您必須使用 free() 釋放記憶體。

定義位於檔案 camera.h 的 265 行。

int(* recording_enabled)(struct camera_device *)

如果已啟用錄製功能，則會傳回 true。

定義位於檔案 camera.h 的 208 行。

void(* release)(struct camera_device *)

釋出此物件擁有的硬體資源。請注意，這並 不是在析構函式中執行。

定義位於檔案 camera.h 的 277 行。

void(* release_recording_frame)(struct camera_device *, const void *opaque)

釋放先前由 CAMERA_MSG_VIDEO_FRAME 傳回的記錄影格。

在相機 HAL 接收 disableMsgType(CAMERA_MSG_VIDEO_FRAME) 的呼叫之前，相機 HAL 用戶端必須釋放相機 HAL 傳送的錄影影格。接收到呼叫 disableMsgType(CAMERA_MSG_VIDEO_FRAME) 後，相機 HAL 就負責管理錄影影格生命週期。

定義位於檔案 camera.h 的 219 行。

int(* send_command)(struct camera_device *, int32_t cmd, int32_t arg1, int32_t arg2)

將指令傳送至相機驅動程式。

定義位於檔案 camera.h 的 270 行。

void(* set_callbacks)(struct camera_device *, camera_notify_callback notify_cb, camera_data_callback data_cb, camera_data_timestamp_callback data_cb_timestamp, camera_request_memory get_memory, void *user)

設定通知和資料回呼

定義位於檔案 camera.h 的 105 行。

int(* set_parameters)(struct camera_device *, const char *parms)

設定攝影機參數。如果任何參數無效或不受支援，這個函式會傳回 BAD_VALUE。

定義位於檔案 camera.h 的 252 行。

int(* set_preview_window)(struct camera_device *, struct preview_stream_ops *window)

設定要將預覽影格傳送至哪個 ANativeWindow

定義位於檔案 camera.h 的 101 行。

int(* start_preview)(struct camera_device *)

啟動預覽模式。

定義位於檔案 camera.h 的 144 行。

int(* start_recording)(struct camera_device *)

開始錄製模式。當可使用記錄影像時，系統會傳送 CAMERA_MSG_VIDEO_FRAME 訊息，並附上對應的影格。在用戶端呼叫 disableMsgType(CAMERA_MSG_VIDEO_FRAME) 之前，每個記錄影格都必須由相機 HAL 用戶端透過 releaseRecordingFrame() 釋出。在用戶端呼叫 disableMsgType(CAMERA_MSG_VIDEO_FRAME) 後，攝影機 HAL 就負責管理錄影影格生命週期，用戶端不得修改/存取任何錄影影格。

定義位於檔案 camera.h 的 198 行。

void(* stop_preview)(struct camera_device *)

停止先前啟動的預覽。

定義位於檔案 camera.h 的 149 行。

void(* stop_recording)(struct camera_device *)

停止先前開始的錄影作業。

定義位於檔案 camera.h 的 203 行。

int(* store_meta_data_in_buffers)(struct camera_device *, int enable)

要求相機 HAL 在錄影期間透過 CAMERA_MSG_VIDEO_FRAME 傳送的視訊緩衝區中儲存中繼資料或實際 YUV 資料。如果未呼叫，預設相機 HAL 行為會在影片緩衝區中儲存實際的 YUV 資料。

為了確保有效，請先呼叫這個方法，再呼叫 startRecording()。

如果中繼資料儲存在影片緩衝區中，則影片緩衝區的接收端必須解讀內容，並利用緩衝區中的中繼資料找出實際影格資料。這項操作的執行方式不在本方法的討論範圍內。

部分相機 HAL 可能不支援在影片緩衝區中儲存中繼資料，但所有相機 HAL 都應支援在影片緩衝區中儲存實際的 YUV 資料。如果相機 HAL 在收到要求時不支援在影片緩衝區中儲存中繼資料，就必須傳回 INVALID_OPERATION。在影片大小很大的情況下，未壓縮的框架資料量可能會非常大，因此讓相機 HAL 直接將中繼資料，而非實際的框架資料傳遞給影片編碼器，是非常實用的做法。

參數
啟用 如果設為 true，則會指示相機 HAL 將中繼資料儲存在視訊緩衝區中；如果設為 false，則會指示相機 HAL 將實際的 YUV 資料儲存在視訊緩衝區中。
退貨
OK 表示成功。

定義位於檔案 camera.h 的 186 行。

int(* take_picture)(struct camera_device *)

拍照。

定義位於檔案 camera.h 的 240 行。

這個結構體的說明文件是由下列檔案產生：