modules/camera/Camera.h

   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 #include "Stream.h"
  24
  25 namespace default_camera_hal {
  26 // Camera represents a physical camera on a device.
  27 // This is constructed when the HAL module is loaded, one per physical camera.
  28 // It is opened by the framework, and must be closed before it can be opened
  29 // again.
  30 class Camera {
  31     public:
  32         // id is used to distinguish cameras. 0 <= id < NUM_CAMERAS.
  33         // module is a handle to the HAL module, used when the device is opened.
  34         Camera(int id);
  35         ~Camera();
  36
  37         // Common Camera Device Operations (see <hardware/camera_common.h>)
  38         int open(const hw_module_t *module, hw_device_t **device);
  39         int close();
  40
  41         // Camera v3 Device Operations (see <hardware/camera3.h>)
  42         int initialize(const camera3_callback_ops_t *callback_ops);
  43         int configureStreams(camera3_stream_configuration_t *stream_list);
  44         int registerStreamBuffers(const camera3_stream_buffer_set_t *buf_set);
  45         const camera_metadata_t *constructDefaultRequestSettings(int type);
  46         int processCaptureRequest(camera3_capture_request_t *request);
  47         void getMetadataVendorTagOps(vendor_tag_query_ops_t *ops);
  48         void dump(int fd);
  49
  50         // Camera device handle returned to framework for use
  51         camera3_device_t mDevice;
  52
  53     private:
  54         // Reuse a stream already created by this device
  55         Stream *reuseStream(camera3_stream_t *astream);
  56         // Destroy all streams in a stream array, and the array itself
  57         void destroyStreams(Stream **array, int count);
  58         // Verify a set of streams is valid in aggregate
  59         bool isValidStreamSet(Stream **array, int count);
  60         // Calculate usage and max_bufs of each stream
  61         void setupStreams(Stream **array, int count);
  62         // Copy new settings for re-use and clean up old settings.
  63         void setSettings(const camera_metadata_t *new_settings);
  64         // Verify settings are valid for a capture
  65         bool isValidCaptureSettings(const camera_metadata_t *settings);
  66         // Verify settings are valid for reprocessing an input buffer
  67         bool isValidReprocessSettings(const camera_metadata_t *settings);
  68
  69         // Identifier used by framework to distinguish cameras
  70         const int mId;
  71         // Busy flag indicates camera is in use
  72         bool mBusy;
  73         // Camera device operations handle shared by all devices
  74         const static camera3_device_ops_t sOps;
  75         // Methods used to call back into the framework
  76         const camera3_callback_ops_t *mCallbackOps;
  77         // Lock protecting the Camera object for modifications
  78         pthread_mutex_t mMutex;
  79         // Array of handles to streams currently in use by the device
  80         Stream **mStreams;
  81         // Number of streams in mStreams
  82         int mNumStreams;
  83         // Most recent request settings seen, memoized to be reused
  84         camera_metadata_t *mSettings;
  85 };
  86 } // namespace default_camera_hal
  87
  88 #endif // CAMERA_H_