/* * Copyright (C) 2019 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 ANDROID_EMULATOR_CAMERA_EXIF_UTILS_H #define ANDROID_EMULATOR_CAMERA_EXIF_UTILS_H #include "hwl_types.h" namespace android { struct SensorCharacteristics; using google_camera_hal::HalCameraMetadata; /* * Orientation value: * 1 2 3 4 5 6 7 8 * * 888888 888888 88 88 8888888888 88 88 8888888888 * 88 88 88 88 88 88 88 88 88 88 88 88 * 8888 8888 8888 8888 88 8888888888 8888888888 88 * 88 88 88 88 * 88 88 888888 888888 */ enum ExifOrientation : uint16_t { ORIENTATION_UNDEFINED = 0x0, ORIENTATION_0_DEGREES = 0x1, ORIENTATION_90_DEGREES = 0x6, ORIENTATION_180_DEGREES = 0x3, ORIENTATION_270_DEGREES = 0x8, }; // This is based on the camera HIDL shim implementation, which was in turned // based on original ChromeOS ARC implementation of a V4L2 HAL class ExifUtils { public: virtual ~ExifUtils(); static ExifUtils* Create(SensorCharacteristics sensor_chars); // Initialize() can be called multiple times. The setting of Exif tags will be // cleared. virtual bool Initialize() = 0; // Set all known fields from a metadata structure virtual bool SetFromMetadata(const HalCameraMetadata& metadata, size_t image_width, size_t image_height) = 0; // Sets the len aperture. // Returns false if memory allocation fails. virtual bool SetAperture(float aperture) = 0; // sets the color space. // Returns false if memory allocation fails. virtual bool SetColorSpace(uint16_t color_space) = 0; // Sets the date and time of image last modified. It takes local time. The // name of the tag is DateTime in IFD0. // Returns false if memory allocation fails. virtual bool SetDateTime(const struct tm& t) = 0; // Sets make & model virtual bool SetMake(const std::string& make) = 0; virtual bool SetModel(const std::string& model) = 0; // Sets the digital zoom ratio. If the numerator is 0, it means digital zoom // was not used. // Returns false if memory allocation fails. virtual bool SetDigitalZoomRatio(uint32_t crop_width, uint32_t crop_height, uint32_t sensor_width, uint32_t sensor_height) = 0; // Sets the exposure bias. // Returns false if memory allocation fails. virtual bool SetExposureBias(int32_t ev, uint32_t ev_step_numerator, uint32_t ev_step_denominator) = 0; // Sets the exposure mode set when the image was shot. // Returns false if memory allocation fails. virtual bool SetExposureMode(uint8_t exposure_mode) = 0; // Sets the exposure time, given in seconds. // Returns false if memory allocation fails. virtual bool SetExposureTime(float exposure_time) = 0; // Sets the status of flash. // Returns false if memory allocation fails. virtual bool SetFlash(uint8_t flash_available, uint8_t flash_state, uint8_t ae_mode) = 0; // Sets the F number. // Returns false if memory allocation fails. virtual bool SetFNumber(float f_number) = 0; // Sets the focal length of lens used to take the image in millimeters. // Returns false if memory allocation fails. virtual bool SetFocalLength(float focal_length) = 0; // Sets the focal length of lens for 35mm film used to take the image in // millimeters. Returns false if memory allocation fails. virtual bool SetFocalLengthIn35mmFilm(float focal_length, float sensor_size_x, float sensor_size_y) = 0; // Sets the altitude in meters. // Returns false if memory allocation fails. virtual bool SetGpsAltitude(double altitude) = 0; // Sets the latitude with degrees minutes seconds format. // Returns false if memory allocation fails. virtual bool SetGpsLatitude(double latitude) = 0; // Sets the longitude with degrees minutes seconds format. // Returns false if memory allocation fails. virtual bool SetGpsLongitude(double longitude) = 0; // Sets GPS processing method. // Returns false if memory allocation fails. virtual bool SetGpsProcessingMethod(const std::string& method) = 0; // Sets GPS date stamp and time stamp (atomic clock). It takes UTC time. // Returns false if memory allocation fails. virtual bool SetGpsTimestamp(const struct tm& t) = 0; // Sets the height (number of rows) of main image. // Returns false if memory allocation fails. virtual bool SetImageHeight(uint32_t length) = 0; // Sets the width (number of columns) of main image. // Returns false if memory allocation fails. virtual bool SetImageWidth(uint32_t width) = 0; // Sets the ISO speed. // Returns false if memory allocation fails. virtual bool SetIsoSpeedRating(uint16_t iso_speed_ratings) = 0; // Sets the smallest F number of the lens. // Returns false if memory allocation fails. virtual bool SetMaxAperture(float aperture) = 0; // Sets image orientation. // Returns false if memory allocation fails. virtual bool SetOrientation(uint16_t degrees) = 0; // Sets image orientation. // Returns false if memory allocation fails. virtual bool SetOrientationValue(ExifOrientation orientation_value) = 0; // Sets the shutter speed. // Returns false if memory allocation fails. virtual bool SetShutterSpeed(float exposure_time) = 0; // Sets the distance to the subject, given in meters. // Returns false if memory allocation fails. virtual bool SetSubjectDistance(float diopters) = 0; // Sets the fractions of seconds for the tag. // Returns false if memory allocation fails. virtual bool SetSubsecTime(const std::string& subsec_time) = 0; // Sets the white balance mode set when the image was shot. // Returns false if memory allocation fails. virtual bool SetWhiteBalance(uint8_t white_blanace) = 0; // Generates APP1 segment. // Returns false if generating APP1 segment fails. virtual bool GenerateApp1(unsigned char* thumbnail_buffer, uint32_t size) = 0; // Gets buffer of APP1 segment. This method must be called only after calling // GenerateAPP1(). virtual const uint8_t* GetApp1Buffer() = 0; // Gets length of APP1 segment. This method must be called only after calling // GenerateAPP1(). virtual unsigned int GetApp1Length() = 0; }; } // namespace android #endif // ANDROID_EMULATOR_CAMERA_EXIF_UTILS_H