Home | History | Annotate | Download | only in camera
      1 /*
      2  * Copyright (C) 2012 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 #ifndef CAMERA_H_
     18 #define CAMERA_H_
     19 
     20 #include <pthread.h>
     21 #include <hardware/hardware.h>
     22 #include <hardware/camera3.h>
     23 
     24 namespace default_camera_hal {
     25 // Camera represents a physical camera on a device.
     26 // This is constructed when the HAL module is loaded, one per physical camera.
     27 // It is opened by the framework, and must be closed before it can be opened
     28 // again.
     29 class Camera {
     30     public:
     31         // id is used to distinguish cameras. 0 <= id < NUM_CAMERAS.
     32         // module is a handle to the HAL module, used when the device is opened.
     33         Camera(int id);
     34         ~Camera();
     35 
     36         // Common Camera Device Operations (see <hardware/camera_common.h>)
     37         int open(const hw_module_t *module, hw_device_t **device);
     38         int close();
     39 
     40         // Camera v3 Device Operations (see <hardware/camera3.h>)
     41         int initialize(const camera3_callback_ops_t *callback_ops);
     42         int configureStreams(camera3_stream_configuration_t *stream_list);
     43         int registerStreamBuffers(const camera3_stream_buffer_set_t *buf_set);
     44         const camera_metadata_t *constructDefaultRequestSettings(int type);
     45         int processCaptureRequest(camera3_capture_request_t *request);
     46         void getMetadataVendorTagOps(vendor_tag_query_ops_t *ops);
     47         void dump(int fd);
     48 
     49         // Camera device handle returned to framework for use
     50         camera3_device_t mDevice;
     51 
     52     private:
     53         // Identifier used by framework to distinguish cameras
     54         const int mId;
     55         // Busy flag indicates camera is in use
     56         bool mBusy;
     57         // Camera device operations handle shared by all devices
     58         const static camera3_device_ops_t sOps;
     59         // Methods used to call back into the framework
     60         const camera3_callback_ops_t *mCallbackOps;
     61         // Lock protecting the Camera object for modifications
     62         pthread_mutex_t mMutex;
     63 };
     64 } // namespace default_camera_hal
     65 
     66 #endif // CAMERA_H_
     67