141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev/* 241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Copyright (C) 2010-2011 The Android Open Source Project 341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * 441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Licensed under the Apache License, Version 2.0 (the "License"); 541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * you may not use this file except in compliance with the License. 641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * You may obtain a copy of the License at 741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * 841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * http://www.apache.org/licenses/LICENSE-2.0 941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * 1041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Unless required by applicable law or agreed to in writing, software 1141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * distributed under the License is distributed on an "AS IS" BASIS, 1241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * See the License for the specific language governing permissions and 1441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * limitations under the License. 1541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 1641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 1741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev#ifndef ANDROID_INCLUDE_CAMERA_H 1841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev#define ANDROID_INCLUDE_CAMERA_H 1941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 208bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala#include "camera_common.h" 2141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 2241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev/** 23ddc026e39344169f64f4696174a4d1269d069557Eino-Ville Talvala * Camera device HAL, initial version [ CAMERA_DEVICE_API_VERSION_1_0 ] 248bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 25b5459839759300ce7b6fca3313ac130e1ed9c309Eino-Ville Talvala * DEPRECATED. New devices should use Camera HAL v3.2 or newer. 26b5459839759300ce7b6fca3313ac130e1ed9c309Eino-Ville Talvala * 27b5459839759300ce7b6fca3313ac130e1ed9c309Eino-Ville Talvala * Supports the android.hardware.Camera API, and the android.hardware.camera2 28b5459839759300ce7b6fca3313ac130e1ed9c309Eino-Ville Talvala * API in legacy mode only. 298bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 308bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Camera devices that support this version of the HAL must return a value in 318bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * the range HARDWARE_DEVICE_API_VERSION(0,0)-(1,FF) in 32ddc026e39344169f64f4696174a4d1269d069557Eino-Ville Talvala * camera_device_t.common.version. CAMERA_DEVICE_API_VERSION_1_0 is the 33ddc026e39344169f64f4696174a4d1269d069557Eino-Ville Talvala * recommended value. 348bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 358bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Camera modules that implement version 2.0 or higher of camera_module_t must 368bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * also return the value of camera_device_t.common.version in 378bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * camera_info_t.device_version. 388bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 398bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * See camera_common.h for more details. 4041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 4141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 428bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala__BEGIN_DECLS 4341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 4424b325e614747266c2488f2f973a03c501bcfe9cIliyan Malchevstruct camera_memory; 4524b325e614747266c2488f2f973a03c501bcfe9cIliyan Malchevtypedef void (*camera_release_memory)(struct camera_memory *mem); 4624b325e614747266c2488f2f973a03c501bcfe9cIliyan Malchev 4741693fa555101e348a4ab80990b21197347892c1Iliyan Malchevtypedef struct camera_memory { 4841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev void *data; 4941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev size_t size; 5041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev void *handle; 5124b325e614747266c2488f2f973a03c501bcfe9cIliyan Malchev camera_release_memory release; 5241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev} camera_memory_t; 5341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 5424b325e614747266c2488f2f973a03c501bcfe9cIliyan Malchevtypedef camera_memory_t* (*camera_request_memory)(int fd, size_t buf_size, unsigned int num_bufs, 5524b325e614747266c2488f2f973a03c501bcfe9cIliyan Malchev void *user); 5641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 5741693fa555101e348a4ab80990b21197347892c1Iliyan Malchevtypedef void (*camera_notify_callback)(int32_t msg_type, 5841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int32_t ext1, 5941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int32_t ext2, 6041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev void *user); 6141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 6241693fa555101e348a4ab80990b21197347892c1Iliyan Malchevtypedef void (*camera_data_callback)(int32_t msg_type, 6324b325e614747266c2488f2f973a03c501bcfe9cIliyan Malchev const camera_memory_t *data, unsigned int index, 6437ea6f730e9775fca95f688fec34d8627da992b6Wu-cheng Li camera_frame_metadata_t *metadata, void *user); 6541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 6641693fa555101e348a4ab80990b21197347892c1Iliyan Malchevtypedef void (*camera_data_timestamp_callback)(int64_t timestamp, 6741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int32_t msg_type, 6824b325e614747266c2488f2f973a03c501bcfe9cIliyan Malchev const camera_memory_t *data, unsigned int index, 6941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev void *user); 7041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 7141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev#define HAL_CAMERA_PREVIEW_WINDOW_TAG 0xcafed00d 7241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 7341693fa555101e348a4ab80990b21197347892c1Iliyan Malchevtypedef struct preview_stream_ops { 7441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*dequeue_buffer)(struct preview_stream_ops* w, 754deb188904e3fa3c35e26dd71f45ebb1aa34ea26Iliyan Malchev buffer_handle_t** buffer, int *stride); 7641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*enqueue_buffer)(struct preview_stream_ops* w, 7741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev buffer_handle_t* buffer); 7841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*cancel_buffer)(struct preview_stream_ops* w, 7941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev buffer_handle_t* buffer); 8041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*set_buffer_count)(struct preview_stream_ops* w, int count); 8141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*set_buffers_geometry)(struct preview_stream_ops* pw, 8241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int w, int h, int format); 8341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*set_crop)(struct preview_stream_ops *w, 8441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int left, int top, int right, int bottom); 8541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*set_usage)(struct preview_stream_ops* w, int usage); 8641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*set_swap_interval)(struct preview_stream_ops *w, int interval); 8741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*get_min_undequeued_buffer_count)(const struct preview_stream_ops *w, 8841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int *count); 89ac0e067896c44b15c654800d6b232d6d2f813bf8Sundar Raman int (*lock_buffer)(struct preview_stream_ops* w, 90ac0e067896c44b15c654800d6b232d6d2f813bf8Sundar Raman buffer_handle_t* buffer); 917c50e9bad4173cddff6dfc49ee0d4e10053867b4Eino-Ville Talvala // Timestamps are measured in nanoseconds, and must be comparable 927c50e9bad4173cddff6dfc49ee0d4e10053867b4Eino-Ville Talvala // and monotonically increasing between two frames in the same 937c50e9bad4173cddff6dfc49ee0d4e10053867b4Eino-Ville Talvala // preview stream. They do not need to be comparable between 947c50e9bad4173cddff6dfc49ee0d4e10053867b4Eino-Ville Talvala // consecutive or parallel preview streams, cameras, or app runs. 957c50e9bad4173cddff6dfc49ee0d4e10053867b4Eino-Ville Talvala int (*set_timestamp)(struct preview_stream_ops *w, int64_t timestamp); 9641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev} preview_stream_ops_t; 9741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 9841693fa555101e348a4ab80990b21197347892c1Iliyan Malchevstruct camera_device; 9941693fa555101e348a4ab80990b21197347892c1Iliyan Malchevtypedef struct camera_device_ops { 10041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** Set the ANativeWindow to which preview frames are sent */ 10141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*set_preview_window)(struct camera_device *, 10241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev struct preview_stream_ops *window); 10341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 10441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** Set the notification and data callbacks */ 10541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev void (*set_callbacks)(struct camera_device *, 10641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev camera_notify_callback notify_cb, 10741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev camera_data_callback data_cb, 10841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev camera_data_timestamp_callback data_cb_timestamp, 10941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev camera_request_memory get_memory, 11041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev void *user); 11141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 11241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 11341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * The following three functions all take a msg_type, which is a bitmask of 11441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * the messages defined in include/ui/Camera.h 11541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 11641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 11741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 11841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Enable a message, or set of messages. 11941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 12041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev void (*enable_msg_type)(struct camera_device *, int32_t msg_type); 12141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 12241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 12341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Disable a message, or a set of messages. 12441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * 12541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Once received a call to disableMsgType(CAMERA_MSG_VIDEO_FRAME), camera 12641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * HAL should not rely on its client to call releaseRecordingFrame() to 12741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * release video recording frames sent out by the cameral HAL before and 12841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * after the disableMsgType(CAMERA_MSG_VIDEO_FRAME) call. Camera HAL 12941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * clients must not modify/access any video recording frame after calling 13041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * disableMsgType(CAMERA_MSG_VIDEO_FRAME). 13141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 13241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev void (*disable_msg_type)(struct camera_device *, int32_t msg_type); 13341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 13441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 13541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Query whether a message, or a set of messages, is enabled. Note that 13641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * this is operates as an AND, if any of the messages queried are off, this 13741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * will return false. 13841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 13941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*msg_type_enabled)(struct camera_device *, int32_t msg_type); 14041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 14141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 14241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Start preview mode. 14341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 14441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*start_preview)(struct camera_device *); 14541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 14641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 14741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Stop a previously started preview. 14841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 14941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev void (*stop_preview)(struct camera_device *); 15041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 15141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 15241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Returns true if preview is enabled. 15341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 15441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*preview_enabled)(struct camera_device *); 15541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 15641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 15741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Request the camera HAL to store meta data or real YUV data in the video 15841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * buffers sent out via CAMERA_MSG_VIDEO_FRAME for a recording session. If 15941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * it is not called, the default camera HAL behavior is to store real YUV 16041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * data in the video buffers. 16141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * 16241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * This method should be called before startRecording() in order to be 16341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * effective. 16441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * 16541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * If meta data is stored in the video buffers, it is up to the receiver of 16641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * the video buffers to interpret the contents and to find the actual frame 16741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * data with the help of the meta data in the buffer. How this is done is 16841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * outside of the scope of this method. 16941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * 17041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Some camera HALs may not support storing meta data in the video buffers, 17141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * but all camera HALs should support storing real YUV data in the video 17241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * buffers. If the camera HAL does not support storing the meta data in the 17341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * video buffers when it is requested to do do, INVALID_OPERATION must be 17441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * returned. It is very useful for the camera HAL to pass meta data rather 17541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * than the actual frame data directly to the video encoder, since the 17641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * amount of the uncompressed frame data can be very large if video size is 17741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * large. 17841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * 17941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * @param enable if true to instruct the camera HAL to store 18041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * meta data in the video buffers; false to instruct 18141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * the camera HAL to store real YUV data in the video 18241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * buffers. 18341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * 18441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * @return OK on success. 18541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 18641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*store_meta_data_in_buffers)(struct camera_device *, int enable); 18741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 18841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 18941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Start record mode. When a record image is available, a 19041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * CAMERA_MSG_VIDEO_FRAME message is sent with the corresponding 19141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * frame. Every record frame must be released by a camera HAL client via 19241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * releaseRecordingFrame() before the client calls 19341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * disableMsgType(CAMERA_MSG_VIDEO_FRAME). After the client calls 19441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * disableMsgType(CAMERA_MSG_VIDEO_FRAME), it is the camera HAL's 19541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * responsibility to manage the life-cycle of the video recording frames, 19641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * and the client must not modify/access any video recording frames. 19741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 19841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*start_recording)(struct camera_device *); 19941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 20041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 20141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Stop a previously started recording. 20241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 20341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev void (*stop_recording)(struct camera_device *); 20441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 20541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 20641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Returns true if recording is enabled. 20741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 20841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*recording_enabled)(struct camera_device *); 20941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 21041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 21141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Release a record frame previously returned by CAMERA_MSG_VIDEO_FRAME. 21241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * 21341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * It is camera HAL client's responsibility to release video recording 21441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * frames sent out by the camera HAL before the camera HAL receives a call 21541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * to disableMsgType(CAMERA_MSG_VIDEO_FRAME). After it receives the call to 21641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * disableMsgType(CAMERA_MSG_VIDEO_FRAME), it is the camera HAL's 21741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * responsibility to manage the life-cycle of the video recording frames. 21841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 21941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev void (*release_recording_frame)(struct camera_device *, 22041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev const void *opaque); 22141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 22241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 22341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Start auto focus, the notification callback routine is called with 22441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * CAMERA_MSG_FOCUS once when focusing is complete. autoFocus() will be 22541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * called again if another auto focus is needed. 22641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 22741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*auto_focus)(struct camera_device *); 22841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 22941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 23041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Cancels auto-focus function. If the auto-focus is still in progress, 23141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * this function will cancel it. Whether the auto-focus is in progress or 23241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * not, this function will return the focus position to the default. If 23341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * the camera does not support auto-focus, this is a no-op. 23441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 23541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*cancel_auto_focus)(struct camera_device *); 23641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 23741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 23841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Take a picture. 23941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 24041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*take_picture)(struct camera_device *); 24141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 24241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 24341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Cancel a picture that was started with takePicture. Calling this method 24441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * when no picture is being taken is a no-op. 24541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 24641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*cancel_picture)(struct camera_device *); 24741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 24841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 24941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Set the camera parameters. This returns BAD_VALUE if any parameter is 25041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * invalid or not supported. 25141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 25241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*set_parameters)(struct camera_device *, const char *parms); 25341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 2542280003113fec21d89fdd44a086e8d602df7c105Iliyan Malchev /** Retrieve the camera parameters. The buffer returned by the camera HAL 2552280003113fec21d89fdd44a086e8d602df7c105Iliyan Malchev must be returned back to it with put_parameters, if put_parameters 2562280003113fec21d89fdd44a086e8d602df7c105Iliyan Malchev is not NULL. 2572280003113fec21d89fdd44a086e8d602df7c105Iliyan Malchev */ 25841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev char *(*get_parameters)(struct camera_device *); 25941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 2602280003113fec21d89fdd44a086e8d602df7c105Iliyan Malchev /** The camera HAL uses its own memory to pass us the parameters when we 2612280003113fec21d89fdd44a086e8d602df7c105Iliyan Malchev call get_parameters. Use this function to return the memory back to 2622280003113fec21d89fdd44a086e8d602df7c105Iliyan Malchev the camera HAL, if put_parameters is not NULL. If put_parameters 2632280003113fec21d89fdd44a086e8d602df7c105Iliyan Malchev is NULL, then you have to use free() to release the memory. 2642280003113fec21d89fdd44a086e8d602df7c105Iliyan Malchev */ 2652280003113fec21d89fdd44a086e8d602df7c105Iliyan Malchev void (*put_parameters)(struct camera_device *, char *); 2662280003113fec21d89fdd44a086e8d602df7c105Iliyan Malchev 26741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 26841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Send command to camera driver. 26941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 27041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*send_command)(struct camera_device *, 27141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int32_t cmd, int32_t arg1, int32_t arg2); 27241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 27341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 27441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Release the hardware resources owned by this object. Note that this is 27541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * *not* done in the destructor. 27641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 27741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev void (*release)(struct camera_device *); 27841693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 27941693fa555101e348a4ab80990b21197347892c1Iliyan Malchev /** 28041693fa555101e348a4ab80990b21197347892c1Iliyan Malchev * Dump state of the camera hardware 28141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev */ 28241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev int (*dump)(struct camera_device *, int fd); 28341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev} camera_device_ops_t; 28441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 28541693fa555101e348a4ab80990b21197347892c1Iliyan Malchevtypedef struct camera_device { 2868bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 2878bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * camera_device.common.version must be in the range 288ddc026e39344169f64f4696174a4d1269d069557Eino-Ville Talvala * HARDWARE_DEVICE_API_VERSION(0,0)-(1,FF). CAMERA_DEVICE_API_VERSION_1_0 is 289ddc026e39344169f64f4696174a4d1269d069557Eino-Ville Talvala * recommended. 2908bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 29141693fa555101e348a4ab80990b21197347892c1Iliyan Malchev hw_device_t common; 29241693fa555101e348a4ab80990b21197347892c1Iliyan Malchev camera_device_ops_t *ops; 29341693fa555101e348a4ab80990b21197347892c1Iliyan Malchev void *priv; 29441693fa555101e348a4ab80990b21197347892c1Iliyan Malchev} camera_device_t; 29541693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 29641693fa555101e348a4ab80990b21197347892c1Iliyan Malchev__END_DECLS 29741693fa555101e348a4ab80990b21197347892c1Iliyan Malchev 2988bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala#endif /* #ifdef ANDROID_INCLUDE_CAMERA_H */ 299