/*
 * Copyright (C) 2012 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef HW_EMULATOR_CAMERA_EMULATED_BASE_CAMERA_H
#define HW_EMULATOR_CAMERA_EMULATED_BASE_CAMERA_H

#include <hardware/camera_common.h>
#include <utils/Errors.h>
#include "CameraConfiguration.h"
#include "guest/libs/platform_support/api_level_fixes.h"
#if VSOC_PLATFORM_SDK_BEFORE(O_MR1)
#include <camera/CameraParameters.h>
#else
#include <CameraParameters.h>
using ::android::hardware::camera::common::V1_0::helper::CameraParameters;
#endif

namespace android {

/*
 * Contains declaration of a class EmulatedBaseCamera that encapsulates
 * functionality common to all emulated camera device versions ("fake",
 * "webcam", "video file", etc.).  Instances of this class (for each emulated
 * camera) are created during the construction of the EmulatedCameraFactory
 * instance.  This class serves as an entry point for all camera API calls that
 * are common across all versions of the camera_device_t/camera_module_t
 * structures.
 */

class EmulatedBaseCamera {
 public:
  EmulatedBaseCamera(int cameraId, uint32_t cameraVersion,
                     struct hw_device_t* device, struct hw_module_t* module);

  virtual ~EmulatedBaseCamera();

  /****************************************************************************
   * Public API
   ***************************************************************************/

 public:
  /* Initializes EmulatedCamera instance.
   * Return:
   *  NO_ERROR on success, or an appropriate error status on failure.
   */
  virtual status_t Initialize(const cvd::CameraDefinition& params) = 0;

  /****************************************************************************
   * Camera API implementation
   ***************************************************************************/

 public:
  /* Creates connection to the emulated camera device.
   * This method is called in response to hw_module_methods_t::open callback.
   * NOTE: When this method is called the object is locked.
   * Note that failures in this method are reported as negative EXXX statuses.
   */
  virtual status_t connectCamera(hw_device_t** device) = 0;

  /* Plug the connection for the emulated camera. Until it's plugged in
   * calls to connectCamera should fail with -ENODEV.
   */
  virtual status_t plugCamera();

  /* Unplug the connection from underneath the emulated camera.
   * This is similar to closing the camera, except that
   * all function calls into the camera device will return
   * -EPIPE errors until the camera is reopened.
   */
  virtual status_t unplugCamera();

#if VSOC_PLATFORM_SDK_AFTER(J_MR2)
  virtual camera_device_status_t getHotplugStatus();
#endif

  /* Closes connection to the emulated camera.
   * This method is called in response to camera_device::close callback.
   * NOTE: When this method is called the object is locked.
   * Note that failures in this method are reported as negative EXXX statuses.
   */
  virtual status_t closeCamera() = 0;

  /* Gets camera information.
   * This method is called in response to camera_module_t::get_camera_info
   * callback.
   * NOTE: When this method is called the object is locked.
   * Note that failures in this method are reported as negative EXXX statuses.
   */
  virtual status_t getCameraInfo(struct camera_info* info) = 0;

  /* Gets camera parameters.
   * This method is called to collect metadata for (currently) taken picture.
   */
  virtual const CameraParameters* getCameraParameters() {
      return NULL;
  }

  /* Set torch mode.
   * This method is called in response to camera_module_t::set_torch_mode
   * callback.
   */
  virtual status_t setTorchMode(bool enabled);

  /****************************************************************************
   * Data members
   ***************************************************************************/

 protected:
  /* Fixed camera information for camera2 devices. Must be valid to access if
   * mCameraDeviceVersion is >= HARDWARE_DEVICE_API_VERSION(2,0)  */
  camera_metadata_t* mCameraInfo;

  /* Zero-based ID assigned to this camera. */
  int mCameraID;

 private:
  /* Version of the camera device HAL implemented by this camera */
  int mCameraDeviceVersion;
};

} /* namespace android */

#endif /* HW_EMULATOR_CAMERA_EMULATED_BASE_CAMERA_H */