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