src/type3_AndroidCloud/anbox-master/android/camera/fake-pipeline2/Scene.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 /**
  18  * The Scene class implements a simple physical simulation of a scene, using the
  19  * CIE 1931 colorspace to represent light in physical units (lux).
  20  *
  21  * It's fairly approximate, but does provide a scene with realistic widely
  22  * variable illumination levels and colors over time.
  23  *
  24  */
  25
  26 #ifndef HW_EMULATOR_CAMERA2_SCENE_H
  27 #define HW_EMULATOR_CAMERA2_SCENE_H
  28
  29 #include "utils/Timers.h"
  30
  31 namespace android {
  32
  33 class Scene {
  34   public:
  35     Scene(int sensorWidthPx,
  36             int sensorHeightPx,
  37             float sensorSensitivity);
  38     ~Scene();
  39
  40     // Set the filter coefficients for the red, green, and blue filters on the
  41     // sensor. Used as an optimization to pre-calculate various illuminance
  42     // values. Two different green filters can be provided, to account for
  43     // possible cross-talk on a Bayer sensor. Must be called before
  44     // calculateScene.
  45     void setColorFilterXYZ(
  46         float rX, float rY, float rZ,
  47         float grX, float grY, float grZ,
  48         float gbX, float gbY, float gbZ,
  49         float bX, float bY, float bZ);
  50
  51     // Set time of day (24-hour clock). This controls the general light levels
  52     // in the scene. Must be called before calculateScene
  53     void setHour(int hour);
  54     // Get current hour
  55     int getHour();
  56
  57     // Set the duration of exposure for determining luminous exposure.
  58     // Must be called before calculateScene
  59     void setExposureDuration(float seconds);
  60
  61     // Calculate scene information for current hour and the time offset since
  62     // the hour. Must be called at least once before calling getLuminousExposure.
  63     // Resets pixel readout location to 0,0
  64     void calculateScene(nsecs_t time);
  65
  66     // Set sensor pixel readout location.
  67     void setReadoutPixel(int x, int y);
  68
  69     // Get sensor response in physical units (electrons) for light hitting the
  70     // current readout pixel, after passing through color filters. The readout
  71     // pixel will be auto-incremented. The returned array can be indexed with
  72     // ColorChannels.
  73     const uint32_t* getPixelElectrons();
  74
  75     enum ColorChannels {
  76         R = 0,
  77         Gr,
  78         Gb,
  79         B,
  80         Y,
  81         Cb,
  82         Cr,
  83         NUM_CHANNELS
  84     };
  85
  86   private:
  87     // Sensor color filtering coefficients in XYZ
  88     float mFilterR[3];
  89     float mFilterGr[3];
  90     float mFilterGb[3];
  91     float mFilterB[3];
  92
  93     int mOffsetX, mOffsetY;
  94     int mMapDiv;
  95
  96     int mHandshakeX, mHandshakeY;
  97
  98     int mSensorWidth;
  99     int mSensorHeight;
 100     int mCurrentX;
 101     int mCurrentY;
 102     int mSubX;
 103     int mSubY;
 104     int mSceneX;
 105     int mSceneY;
 106     int mSceneIdx;
 107     uint32_t *mCurrentSceneMaterial;
 108
 109     int mHour;
 110     float mExposureDuration;
 111     float mSensorSensitivity;
 112
 113     enum Materials {
 114         GRASS = 0,
 115         GRASS_SHADOW,
 116         HILL,
 117         WALL,
 118         ROOF,
 119         DOOR,
 120         CHIMNEY,
 121         WINDOW,
 122         SUN,
 123         SKY,
 124         MOON,
 125         NUM_MATERIALS
 126     };
 127
 128     uint32_t mCurrentColors[NUM_MATERIALS*NUM_CHANNELS];
 129
 130     /**
 131      * Constants for scene definition. These are various degrees of approximate.
 132      */
 133
 134     // Fake handshake parameters. Two shake frequencies per axis, plus magnitude
 135     // as a fraction of a scene tile, and relative magnitudes for the frequencies
 136     static const float kHorizShakeFreq1;
 137     static const float kHorizShakeFreq2;
 138     static const float kVertShakeFreq1;
 139     static const float kVertShakeFreq2;
 140     static const float kFreq1Magnitude;
 141     static const float kFreq2Magnitude;
 142
 143     static const float kShakeFraction;
 144
 145     // RGB->YUV conversion
 146     static const float kRgb2Yuv[12];
 147
 148     // Aperture of imaging lens
 149     static const float kAperture;
 150
 151     // Sun, moon illuminance levels in 2-hour increments. These don't match any
 152     // real day anywhere.
 153     static const uint32_t kTimeStep = 2;
 154     static const float kSunlight[];
 155     static const float kMoonlight[];
 156     static const int kSunOverhead;
 157     static const int kMoonOverhead;
 158
 159     // Illumination levels for various conditions, in lux
 160     static const float kDirectSunIllum;
 161     static const float kDaylightShadeIllum;
 162     static const float kSunsetIllum;
 163     static const float kTwilightIllum;
 164     static const float kFullMoonIllum;
 165     static const float kClearNightIllum;
 166     static const float kStarIllum;
 167     static const float kLivingRoomIllum;
 168
 169     // Chromaticity of various illumination sources
 170     static const float kIncandescentXY[2];
 171     static const float kDirectSunlightXY[2];
 172     static const float kDaylightXY[2];
 173     static const float kNoonSkyXY[2];
 174     static const float kMoonlightXY[2];
 175     static const float kSunsetXY[2];
 176
 177     static const uint8_t kSelfLit;
 178     static const uint8_t kShadowed;
 179     static const uint8_t kSky;
 180
 181     static const float kMaterials_xyY[NUM_MATERIALS][3];
 182     static const uint8_t kMaterialsFlags[NUM_MATERIALS];
 183
 184     static const int kSceneWidth;
 185     static const int kSceneHeight;
 186     static const uint8_t kScene[];
 187 };
 188
 189 }
 190
 191 #endif // HW_EMULATOR_CAMERA2_SCENE_H