platform_hardware_libhardware/modules/camera/3_4/v4l2_camera.h
Ari Hausman-Cohen 9e6fd98945 Add format querying.
Query formats, sizes, and frame rates.

BUG: https://b/29394024, https://b/30605346
TEST: Test java program shows a bunch of formats & rates,
can take pictures in different sizes now.

Change-Id: I203fd8f200dda79cf6946c58f130548b05269fbd
2016-08-08 16:29:21 -07:00

137 lines
5.2 KiB
C++

/*
* Copyright (C) 2016 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.
*/
// Loosely based on hardware/libhardware/modules/camera/ExampleCamera.h
#ifndef V4L2_CAMERA_HAL_V4L2_CAMERA_H_
#define V4L2_CAMERA_HAL_V4L2_CAMERA_H_
#include <array>
#include <string>
#include <vector>
#include <system/camera_metadata.h>
#include "camera.h"
#include "common.h"
#include "metadata/array_vector.h"
#include "v4l2_gralloc.h"
#include "v4l2_wrapper.h"
namespace v4l2_camera_hal {
// V4L2Camera is a specific V4L2-supported camera device. The Camera object
// contains all logic common between all cameras (e.g. front and back cameras),
// while a specific camera device (e.g. V4L2Camera) holds all specific
// metadata and logic about that device.
class V4L2Camera : public default_camera_hal::Camera {
public:
// Use this method to create V4L2Camera objects. Functionally equivalent
// to "new V4L2Camera", except that it may return nullptr in case of failure.
static V4L2Camera* NewV4L2Camera(int id, const std::string path);
~V4L2Camera();
private:
// Constructor private to allow failing on bad input.
// Use NewV4L2Camera instead.
V4L2Camera(int id, std::shared_ptr<V4L2Wrapper> v4l2_wrapper);
// default_camera_hal::Camera virtual methods.
// Connect to the device: open dev nodes, etc.
int connect() override;
// Disconnect from the device: close dev nodes, etc.
void disconnect() override;
// Initialize static camera characteristics for individual device.
int initStaticInfo(camera_metadata_t** out) override;
// Initialize device info: facing, orientation, resource cost,
// and conflicting devices (/conflicting devices length).
void initDeviceInfo(camera_info_t* info) override;
// Initialize whole device (templates/etc) when opened.
int initDevice() override;
// Verify stream configuration is device-compatible.
bool isSupportedStreamSet(default_camera_hal::Stream** streams,
int count, uint32_t mode) override;
// Set up the device for a stream, and get the maximum number of
// buffers that stream can handle (max_buffers is an output parameter).
int setupStream(default_camera_hal::Stream* stream,
uint32_t* max_buffers) override;
// Verify settings are valid for a capture with this device.
bool isValidCaptureSettings(const camera_metadata_t* settings) override;
// Enqueue a buffer to receive data from the camera.
int enqueueBuffer(const camera3_stream_buffer_t* camera_buffer) override;
// Get the shutter time and updated settings for the most recent frame.
// The metadata parameter is both an input and output; frame-specific
// result fields should be appended to what is passed in.
int getResultSettings(camera_metadata_t** metadata, uint64_t* timestamp);
// V4L2 helper.
std::shared_ptr<V4L2Wrapper> mV4L2Device;
std::unique_ptr<V4L2Wrapper::Connection> mConnection;
bool mTemplatesInitialized;
int initTemplates();
// Camera characteristics.
bool mCharacteristicsInitialized; // If false, characteristics are invalid.
// Fixed characteristics.
float mAperture;
float mFilterDensity;
float mFocalLength;
int32_t mOrientation;
std::array<float, 2> mPhysicalSize; // {width, height}, in mm.
std::array<int32_t, 4> mPixelArraySize; // {xmin, ymin, width, height}.
uint8_t mCropType;
float mMaxZoom;
std::array<int32_t, 2> mAeCompensationRange; // {min, max}.
camera_metadata_rational mAeCompensationStep;
uint8_t mAeLockAvailable;
uint8_t mAwbLockAvailable;
uint8_t mFlashAvailable;
float mFocusDistance;
int32_t mMaxRawOutputStreams;
int32_t mMaxStallingOutputStreams;
int32_t mMaxNonStallingOutputStreams;
int32_t mMaxInputStreams;
std::vector<int32_t> mSupportedFormats;
// Variable characteristics available options.
std::vector<uint8_t> mAeModes;
std::vector<uint8_t> mAeAntibandingModes;
std::vector<uint8_t> mAfModes;
std::vector<uint8_t> mAwbModes;
std::vector<uint8_t> mSceneModes;
std::vector<uint8_t> mControlModes;
std::vector<uint8_t> mEffects;
std::vector<uint8_t> mLeds;
std::vector<uint8_t> mOpticalStabilizationModes;
std::vector<uint8_t> mVideoStabilizationModes;
// {format, width, height, direction} (input or output).
ArrayVector<int32_t, 4> mStreamConfigs;
// {format, width, height, duration} (duration in ns).
ArrayVector<int64_t, 4> mMinFrameDurations;
int64_t mMaxFrameDuration;
// {format, width, height, duration} (duration in ns).
ArrayVector<int64_t, 4> mStallDurations;
// {min, max} (in fps).
ArrayVector<int32_t, 2> mFpsRanges;
// Initialize characteristics and set mCharacteristicsInitialized to True.
int initCharacteristics();
DISALLOW_COPY_AND_ASSIGN(V4L2Camera);
};
} // namespace v4l2_camera_hal
#endif // V4L2_CAMERA_HAL_V4L2_CAMERA_H