dali/internal/update/render-tasks/scene-graph-camera.cpp

   1 /*
   2  * Copyright (c) 2018 Samsung Electronics Co., Ltd.
   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 // CLASS HEADER
  19 #include <dali/internal/update/render-tasks/scene-graph-camera.h>
  20
  21 // EXTERNAL INCLUDES
  22 #include <stdint.h>
  23
  24 // INTERNAL INCLUDES
  25 #include <dali/integration-api/debug.h>
  26 #include <dali/public-api/common/dali-common.h>
  27 #include <dali/public-api/math/math-utils.h>
  28 #include <dali/internal/update/nodes/node.h>
  29
  30 namespace // unnamed namespace
  31 {
  32 const uint32_t UPDATE_COUNT        = 2u;  // Update projection or view matrix this many frames after a change
  33 const uint32_t COPY_PREVIOUS_MATRIX = 1u; // Copy view or projection matrix from previous frame
  34
  35 //For reflection and clipping plane
  36 const float REFLECTION_NORMALIZED_DEVICE_COORDINATE_PARAMETER_A = 2.0f;
  37 const float REFLECTION_NORMALIZED_DEVICE_COORDINATE_PARAMETER_D = 1.0f;
  38 }
  39
  40 namespace Dali
  41 {
  42
  43 namespace Internal
  44 {
  45
  46 namespace SceneGraph
  47 {
  48
  49 namespace
  50 {
  51
  52 template< typename T >
  53 T Sign( T value )
  54 {
  55   return T( T(0) < value ) - T( value < T(0) );
  56 }
  57
  58 void LookAt(Matrix& result, const Vector3& eye, const Vector3& target, const Vector3& up)
  59 {
  60   Vector3 vZ = target - eye;
  61   vZ.Normalize();
  62
  63   Vector3 vX = up.Cross(vZ);
  64   vX.Normalize();
  65
  66   Vector3 vY = vZ.Cross(vX);
  67   vY.Normalize();
  68
  69   result.SetInverseTransformComponents(vX, vY, vZ, eye);
  70 }
  71
  72 void Frustum(Matrix& result, float left, float right, float bottom, float top, float near, float far, bool invertYAxis)
  73 {
  74   float deltaZ = far - near;
  75   if ((near <= 0.0f) || (far <= 0.0f) || Equals(right, left) || Equals(bottom, top) || (deltaZ <= 0.0f))
  76   {
  77     DALI_LOG_ERROR("Invalid parameters passed into Frustum!\n");
  78     DALI_ASSERT_DEBUG("Invalid parameters passed into Frustum!");
  79     return;
  80   }
  81
  82   float deltaX = right - left;
  83   float deltaY = invertYAxis ? bottom - top : top - bottom;
  84
  85   result.SetIdentity();
  86
  87   float* m = result.AsFloat();
  88   m[0] = -2.0f * near / deltaX;
  89   m[1] = m[2] = m[3] = 0.0f;
  90
  91   m[5] = -2.0f * near / deltaY;
  92   m[4] = m[6] = m[7] = 0.0f;
  93
  94   m[8] = (right + left) / deltaX;
  95   m[9] = (top + bottom) / deltaY;
  96   m[10] = (near + far) / deltaZ;
  97   m[11] = 1.0f;
  98
  99   m[14] = -2.0f * near * far / deltaZ;
 100   m[12] = m[13] = m[15] = 0.0f;
 101 }
 102
 103 void Perspective(Matrix& result, float fovy, float aspect, float near, float far, bool invertYAxis )
 104 {
 105   float frustumH = tanf( fovy * 0.5f ) * near;
 106   float frustumW = frustumH * aspect;
 107
 108   Frustum(result, -frustumW, frustumW, -frustumH, frustumH, near, far, invertYAxis);
 109 }
 110
 111 void Orthographic(Matrix& result, float left, float right, float bottom, float top, float near, float far, bool invertYAxis)
 112 {
 113   if ( Equals(right, left) || Equals(top, bottom) || Equals(far, near) )
 114   {
 115     DALI_LOG_ERROR( "Cannot create orthographic projection matrix with a zero dimension.\n" );
 116     DALI_ASSERT_DEBUG( "Cannot create orthographic projection matrix with a zero dimension." );
 117     return;
 118   }
 119
 120   float deltaX = right - left;
 121   float deltaY = invertYAxis ? bottom - top : top - bottom;
 122   float deltaZ = far - near;
 123
 124   float *m = result.AsFloat();
 125   m[0] = -2.0f / deltaX;
 126   m[1] = 0.0f;
 127   m[2] = 0.0f;
 128   m[3] = 0.0f;
 129
 130   m[4] = 0.0f;
 131   m[5] = -2.0f / deltaY;
 132   m[6] = 0.0f;
 133   m[7] = 0.0f;
 134
 135   m[8] = 0.0f;
 136   m[9] = 0.0f;
 137   m[10] = 2.0f / deltaZ;
 138   m[11] = 0.0f;
 139   m[12] = -(right + left) / deltaX;
 140   m[13] = -(top + bottom) / deltaY;
 141   m[14] = -(near + far)   / deltaZ;
 142   m[15] = 1.0f;
 143 }
 144
 145 } // unnamed namespace
 146
 147 const Dali::Camera::Type Camera::DEFAULT_TYPE( Dali::Camera::FREE_LOOK );
 148 const Dali::Camera::ProjectionMode Camera::DEFAULT_MODE( Dali::Camera::PERSPECTIVE_PROJECTION );
 149 const bool  Camera::DEFAULT_INVERT_Y_AXIS( false );
 150 const float Camera::DEFAULT_FIELD_OF_VIEW( 45.0f*(Math::PI/180.0f) );
 151 const float Camera::DEFAULT_ASPECT_RATIO( 4.0f/3.0f );
 152 const float Camera::DEFAULT_LEFT_CLIPPING_PLANE(-240.0f);
 153 const float Camera::DEFAULT_RIGHT_CLIPPING_PLANE(240.0f);
 154 const float Camera::DEFAULT_TOP_CLIPPING_PLANE(-400.0f);
 155 const float Camera::DEFAULT_BOTTOM_CLIPPING_PLANE(400.0f);
 156 const float Camera::DEFAULT_NEAR_CLIPPING_PLANE( 800.0f ); // default height of the screen
 157 const float Camera::DEFAULT_FAR_CLIPPING_PLANE( DEFAULT_NEAR_CLIPPING_PLANE + 2.f * DEFAULT_NEAR_CLIPPING_PLANE );
 158 const Vector3 Camera::DEFAULT_TARGET_POSITION( 0.0f, 0.0f, 0.0f );
 159
 160
 161 Camera::Camera()
 162 : mUpdateViewFlag( UPDATE_COUNT ),
 163   mUpdateProjectionFlag( UPDATE_COUNT ),
 164   mProjectionRotation( 0 ),
 165   mNode( nullptr ),
 166   mType( DEFAULT_TYPE ),
 167   mProjectionMode( DEFAULT_MODE ),
 168   mInvertYAxis( DEFAULT_INVERT_Y_AXIS ),
 169   mFieldOfView( DEFAULT_FIELD_OF_VIEW ),
 170   mAspectRatio( DEFAULT_ASPECT_RATIO ),
 171   mLeftClippingPlane( DEFAULT_LEFT_CLIPPING_PLANE ),
 172   mRightClippingPlane( DEFAULT_RIGHT_CLIPPING_PLANE ),
 173   mTopClippingPlane( DEFAULT_TOP_CLIPPING_PLANE ),
 174   mBottomClippingPlane( DEFAULT_BOTTOM_CLIPPING_PLANE ),
 175   mNearClippingPlane( DEFAULT_NEAR_CLIPPING_PLANE ),
 176   mFarClippingPlane( DEFAULT_FAR_CLIPPING_PLANE ),
 177   mTargetPosition( DEFAULT_TARGET_POSITION ),
 178   mViewMatrix(),
 179   mProjectionMatrix(),
 180   mInverseViewProjection( Matrix::IDENTITY ),
 181   mFinalProjection( Matrix::IDENTITY )
 182 {
 183 }
 184
 185 Camera* Camera::New()
 186 {
 187   return new Camera();
 188 }
 189
 190 Camera::~Camera() = default;
 191
 192 void Camera::SetNode( const Node* node )
 193 {
 194   mNode = node;
 195 }
 196
 197 const Node* Camera::GetNode() const
 198 {
 199   return mNode;
 200 }
 201
 202 void Camera::SetType( Dali::Camera::Type type )
 203 {
 204   mType = type;
 205 }
 206
 207 void Camera::SetProjectionMode( Dali::Camera::ProjectionMode mode )
 208 {
 209   mProjectionMode = mode;
 210   mUpdateProjectionFlag = UPDATE_COUNT;
 211 }
 212
 213 void Camera::SetInvertYAxis( bool invertYAxis )
 214 {
 215   mInvertYAxis = invertYAxis;
 216   mUpdateProjectionFlag = UPDATE_COUNT;
 217 }
 218
 219 void Camera::SetFieldOfView( float fieldOfView )
 220 {
 221   mFieldOfView = fieldOfView;
 222   mUpdateProjectionFlag = UPDATE_COUNT;
 223 }
 224
 225 void Camera::SetAspectRatio( float aspectRatio )
 226 {
 227   mAspectRatio = aspectRatio;
 228   mUpdateProjectionFlag = UPDATE_COUNT;
 229 }
 230
 231 void Camera::SetLeftClippingPlane( float leftClippingPlane )
 232 {
 233   mLeftClippingPlane = leftClippingPlane;
 234   mUpdateProjectionFlag = UPDATE_COUNT;
 235 }
 236
 237 void Camera::SetRightClippingPlane( float rightClippingPlane )
 238 {
 239   mRightClippingPlane = rightClippingPlane;
 240   mUpdateProjectionFlag = UPDATE_COUNT;
 241 }
 242
 243 void Camera::SetTopClippingPlane( float topClippingPlane )
 244 {
 245   mTopClippingPlane = topClippingPlane;
 246   mUpdateProjectionFlag = UPDATE_COUNT;
 247 }
 248
 249 void Camera::SetBottomClippingPlane( float bottomClippingPlane )
 250 {
 251   mBottomClippingPlane = bottomClippingPlane;
 252   mUpdateProjectionFlag = UPDATE_COUNT;
 253 }
 254
 255 void Camera::SetNearClippingPlane( float nearClippingPlane )
 256 {
 257   mNearClippingPlane = nearClippingPlane;
 258   mUpdateProjectionFlag = UPDATE_COUNT;
 259 }
 260
 261 void Camera::SetFarClippingPlane( float farClippingPlane )
 262 {
 263   mFarClippingPlane = farClippingPlane;
 264   mUpdateProjectionFlag = UPDATE_COUNT;
 265 }
 266
 267 void Camera::SetTargetPosition( const Vector3& targetPosition )
 268 {
 269   mTargetPosition = targetPosition;
 270   mUpdateViewFlag = UPDATE_COUNT;
 271 }
 272
 273 void VectorReflectedByPlane(Vector4 &out, Vector4 &in, Vector4 &plane)
 274 {
 275   float d = float(2.0) * plane.Dot(in);
 276   out.x = static_cast<float>(in.x - plane.x*d);
 277   out.y = static_cast<float>(in.y - plane.y*d);
 278   out.z = static_cast<float>(in.z - plane.z*d);
 279   out.w = static_cast<float>(in.w - plane.w*d);
 280 }
 281
 282 void Camera::AdjustNearPlaneForPerspective( Matrix& perspective, const Vector4& clipPlane )
 283 {
 284   Vector4    q;
 285   float* v = perspective.AsFloat();
 286
 287   q.x = (Sign(clipPlane.x) + v[8]) / v[0];
 288   q.y = (Sign(clipPlane.y) + v[9]) / v[5];
 289   q.z = -1.0f;
 290   q.w = (1.0f + v[10]) / v[14];
 291
 292   // Calculate the scaled plane vector
 293   Vector4 c = clipPlane * (REFLECTION_NORMALIZED_DEVICE_COORDINATE_PARAMETER_A / q.Dot( clipPlane));
 294
 295   // Replace the third row of the projection v
 296   v[2] = c.x;
 297   v[6] = c.y;
 298   v[10] = c.z + REFLECTION_NORMALIZED_DEVICE_COORDINATE_PARAMETER_D;
 299   v[14] = c.w;
 300 }
 301
 302 void Camera::SetReflectByPlane( const Vector4& plane )
 303 {
 304   float* v = mReflectionMtx.AsFloat();
 305   float _2ab = -2.0f * plane.x * plane.y;
 306   float _2ac = -2.0f * plane.x * plane.z;
 307   float _2bc = -2.0f * plane.y * plane.z;
 308
 309   v[0] = 1.0f - 2.0f * plane.x * plane.x;
 310   v[1] = _2ab;
 311   v[2] = _2ac;
 312   v[3] = 0.0f;
 313
 314   v[4] = _2ab;
 315   v[5] = 1.0f - 2.0f * plane.y * plane.y;
 316   v[6] = _2bc;
 317   v[7] = 0.0f;
 318
 319   v[8] = _2ac;
 320   v[9] = _2bc;
 321   v[10] = 1.0f - 2.0f * plane.z * plane.z;
 322   v[11] = 0.0f;
 323
 324   v[12] =    - 2 * plane.x * plane.w;
 325   v[13] =    - 2 * plane.y * plane.w;
 326   v[14] =    - 2 * plane.z * plane.w;
 327   v[15] = 1.0f;
 328
 329   mUseReflection = true;
 330   mReflectionPlane = plane;
 331   mUpdateViewFlag = UPDATE_COUNT;
 332 }
 333
 334 void Camera::RotateProjection( int rotationAngle )
 335 {
 336   mProjectionRotation = rotationAngle;
 337   mUpdateViewFlag = UPDATE_COUNT;
 338 }
 339
 340 const Matrix& Camera::GetProjectionMatrix( BufferIndex bufferIndex ) const
 341 {
 342   return mProjectionMatrix[ bufferIndex ];
 343 }
 344
 345 const Matrix& Camera::GetViewMatrix( BufferIndex bufferIndex ) const
 346 {
 347   return mViewMatrix[ bufferIndex ];
 348 }
 349
 350 const Matrix& Camera::GetInverseViewProjectionMatrix( BufferIndex bufferIndex ) const
 351 {
 352   return mInverseViewProjection[ bufferIndex ];
 353 }
 354
 355 const Matrix& Camera::GetFinalProjectionMatrix( BufferIndex bufferIndex ) const
 356 {
 357   return mFinalProjection[ bufferIndex ];
 358 }
 359
 360 const PropertyInputImpl* Camera::GetProjectionMatrix() const
 361 {
 362   return &mProjectionMatrix;
 363 }
 364
 365 const PropertyInputImpl* Camera::GetViewMatrix() const
 366 {
 367   return &mViewMatrix;
 368 }
 369
 370 void Camera::Update( BufferIndex updateBufferIndex )
 371 {
 372   // if owning node has changes in world position we need to update camera for next 2 frames
 373   if( mNode->IsLocalMatrixDirty() )
 374   {
 375     mUpdateViewFlag = UPDATE_COUNT;
 376   }
 377   if( mNode->GetDirtyFlags() & NodePropertyFlags::VISIBLE )
 378   {
 379     // If the visibility changes, the projection matrix needs to be re-calculated.
 380     // It may happen the first time an actor is rendered it's rendered only once and becomes invisible,
 381     // in the following update the node will be skipped leaving the projection matrix (double buffered)
 382     // with the Identity.
 383     mUpdateProjectionFlag = UPDATE_COUNT;
 384   }
 385
 386   // if either matrix changed, we need to recalculate the inverse matrix for hit testing to work
 387   uint32_t viewUpdateCount = UpdateViewMatrix( updateBufferIndex );
 388   uint32_t projectionUpdateCount = UpdateProjection( updateBufferIndex );
 389
 390   // if model or view matrix changed we need to either recalculate the inverse VP or copy previous
 391   if( viewUpdateCount > COPY_PREVIOUS_MATRIX || projectionUpdateCount > COPY_PREVIOUS_MATRIX )
 392   {
 393     // either has actually changed so recalculate
 394     Matrix::Multiply( mInverseViewProjection[ updateBufferIndex ], mViewMatrix[ updateBufferIndex ], mProjectionMatrix[ updateBufferIndex ] );
 395     UpdateFrustum( updateBufferIndex );
 396
 397     // ignore the error, if the view projection is incorrect (non inversible) then you will have tough times anyways
 398     static_cast< void >( mInverseViewProjection[ updateBufferIndex ].Invert() );
 399   }
 400   else if( viewUpdateCount == COPY_PREVIOUS_MATRIX || projectionUpdateCount == COPY_PREVIOUS_MATRIX )
 401   {
 402     // neither has actually changed, but we might copied previous frames value so need to
 403     // copy the previous inverse and frustum as well
 404     mInverseViewProjection[updateBufferIndex] = mInverseViewProjection[updateBufferIndex ? 0 : 1];
 405     mFrustum[ updateBufferIndex ] = mFrustum[ updateBufferIndex ? 0 : 1 ];
 406   }
 407 }
 408
 409 bool Camera::ViewMatrixUpdated()
 410 {
 411   return 0u != mUpdateViewFlag;
 412 }
 413
 414 uint32_t Camera::UpdateViewMatrix( BufferIndex updateBufferIndex )
 415 {
 416   uint32_t retval( mUpdateViewFlag );
 417   if( 0u != mUpdateViewFlag )
 418   {
 419     if( COPY_PREVIOUS_MATRIX == mUpdateViewFlag )
 420     {
 421       // The projection matrix was updated in the previous frame; copy it
 422       mViewMatrix.CopyPrevious( updateBufferIndex );
 423     }
 424     else // UPDATE_COUNT == mUpdateViewFlag
 425     {
 426       switch( mType )
 427       {
 428         // camera orientation taken from node - i.e. look in abitrary, unconstrained direction
 429         case Dali::Camera::FREE_LOOK:
 430         {
 431           Matrix& viewMatrix = mViewMatrix.Get( updateBufferIndex );
 432           viewMatrix = mNode->GetWorldMatrix( updateBufferIndex );
 433
 434           if (mUseReflection)
 435           {
 436             const Matrix& owningNodeMatrix( mNode->GetWorldMatrix( updateBufferIndex ) );
 437             Vector3 position{}, scale{};
 438             Quaternion orientation{};
 439             owningNodeMatrix.GetTransformComponents( position, orientation, scale );
 440             mReflectionEye = position;
 441             mUseReflectionClip = true;
 442
 443             Matrix& viewMatrix = mViewMatrix.Get( updateBufferIndex );
 444             Matrix oldViewMatrix( viewMatrix );
 445             Matrix::Multiply(viewMatrix, oldViewMatrix, mReflectionMtx);
 446           }
 447
 448           viewMatrix.Invert();
 449           mViewMatrix.SetDirty( updateBufferIndex );
 450           break;
 451         }
 452
 453         // camera orientation constrained to look at a target
 454         case Dali::Camera::LOOK_AT_TARGET:
 455         {
 456           const Matrix& owningNodeMatrix( mNode->GetWorldMatrix( updateBufferIndex ) );
 457           Vector3 position, scale;
 458           Quaternion orientation;
 459           owningNodeMatrix.GetTransformComponents( position, orientation, scale );
 460           Matrix& viewMatrix = mViewMatrix.Get( updateBufferIndex );
 461
 462           if (mUseReflection)
 463           {
 464             Vector3 up = orientation.Rotate( Vector3::YAXIS );
 465             Vector4 position4 = Vector4(position);
 466             Vector4 target4 = Vector4(mTargetPosition);
 467             Vector4 up4 = Vector4(up);
 468             Vector4 positionNew;
 469             Vector4 targetNew;
 470             Vector4 upNew;
 471             Vector3 positionNew3;
 472             Vector3 targetNewVector3;
 473             Vector3 upNew3;
 474
 475             // eye
 476             VectorReflectedByPlane(positionNew, position4, mReflectionPlane);
 477             VectorReflectedByPlane(targetNew, target4, mReflectionPlane);
 478             VectorReflectedByPlane(upNew, up4, mReflectionPlane);
 479
 480             positionNew3     = Vector3(positionNew);
 481             targetNewVector3 = Vector3(targetNew);
 482             upNew3           = Vector3(upNew);
 483             LookAt(viewMatrix, positionNew3, targetNewVector3, upNew3 );
 484
 485             Matrix oldViewMatrix( viewMatrix );
 486             Matrix tmp;
 487             tmp.SetIdentityAndScale(Vector3(-1.0, 1.0,1.0));
 488             Matrix::Multiply(viewMatrix, oldViewMatrix, tmp);
 489
 490             mReflectionEye = positionNew;
 491             mUseReflectionClip = true;
 492           }
 493           else
 494           {
 495             LookAt( viewMatrix, position, mTargetPosition, orientation.Rotate( Vector3::YAXIS ) );
 496           }
 497           mViewMatrix.SetDirty( updateBufferIndex );
 498           break;
 499         }
 500       }
 501     }
 502     --mUpdateViewFlag;
 503   }
 504   return retval;
 505 }
 506
 507 void Camera::UpdateFrustum( BufferIndex updateBufferIndex, bool normalize )
 508 {
 509
 510   // Extract the clip matrix planes
 511   Matrix clipMatrix;
 512   Matrix::Multiply( clipMatrix, mViewMatrix[ updateBufferIndex ], mProjectionMatrix[ updateBufferIndex ] );
 513
 514   const float* cm = clipMatrix.AsFloat();
 515   FrustumPlanes& planes = mFrustum[ updateBufferIndex ];
 516
 517   // Left
 518   planes.mPlanes[ 0 ].mNormal.x = cm[ 3 ]  + cm[ 0 ]; // column 4 + column 1
 519   planes.mPlanes[ 0 ].mNormal.y = cm[ 7 ]  + cm[ 4 ];
 520   planes.mPlanes[ 0 ].mNormal.z = cm[ 11 ] + cm[ 8 ];
 521   planes.mPlanes[ 0 ].mDistance = cm[ 15 ] + cm[ 12 ];
 522
 523   // Right
 524   planes.mPlanes[ 1 ].mNormal.x = cm[ 3 ]  - cm[ 0 ]; // column 4 - column 1
 525   planes.mPlanes[ 1 ].mNormal.y = cm[ 7 ]  - cm[ 4 ];
 526   planes.mPlanes[ 1 ].mNormal.z = cm[ 11 ] - cm[ 8 ];
 527   planes.mPlanes[ 1 ].mDistance = cm[ 15 ] - cm[ 12 ];
 528
 529   // Bottom
 530   planes.mPlanes[ 2 ].mNormal.x = cm[ 3 ]  + cm[ 1 ]; // column 4 + column 2
 531   planes.mPlanes[ 2 ].mNormal.y = cm[ 7 ]  + cm[ 5 ];
 532   planes.mPlanes[ 2 ].mNormal.z = cm[ 11 ] + cm[ 9 ];
 533   planes.mPlanes[ 2 ].mDistance = cm[ 15 ] + cm[ 13 ];
 534
 535   // Top
 536   planes.mPlanes[ 3 ].mNormal.x = cm[ 3 ]  - cm[ 1 ]; // column 4 - column 2
 537   planes.mPlanes[ 3 ].mNormal.y = cm[ 7 ]  - cm[ 5 ];
 538   planes.mPlanes[ 3 ].mNormal.z = cm[ 11 ] - cm[ 9 ];
 539   planes.mPlanes[ 3 ].mDistance = cm[ 15 ] - cm[ 13 ];
 540
 541   // Near
 542   planes.mPlanes[ 4 ].mNormal.x = cm[ 3 ]  + cm[ 2 ]; // column 4 + column 3
 543   planes.mPlanes[ 4 ].mNormal.y = cm[ 7 ]  + cm[ 6 ];
 544   planes.mPlanes[ 4 ].mNormal.z = cm[ 11 ] + cm[ 10 ];
 545   planes.mPlanes[ 4 ].mDistance = cm[ 15 ] + cm[ 14 ];
 546
 547   // Far
 548   planes.mPlanes[ 5 ].mNormal.x = cm[ 3 ]  - cm[ 2 ]; // column 4 - column 3
 549   planes.mPlanes[ 5 ].mNormal.y = cm[ 7 ]  - cm[ 6 ];
 550   planes.mPlanes[ 5 ].mNormal.z = cm[ 11 ] - cm[ 10 ];
 551   planes.mPlanes[ 5 ].mDistance = cm[ 15 ] - cm[ 14 ];
 552
 553   if ( normalize )
 554   {
 555     for ( uint32_t i = 0; i < 6; ++i )
 556     {
 557       // Normalize planes to ensure correct bounding distance checking
 558       Plane& plane = planes.mPlanes[ i ];
 559       float l = 1.0f / plane.mNormal.Length();
 560       plane.mNormal *= l;
 561       plane.mDistance *= l;
 562
 563       planes.mSign[i] = Vector3( Sign(plane.mNormal.x), Sign(plane.mNormal.y), Sign(plane.mNormal.z) );
 564     }
 565   }
 566   else
 567   {
 568     for ( uint32_t i = 0; i < 6; ++i )
 569     {
 570       planes.mSign[i] = Vector3( Sign(planes.mPlanes[ i ].mNormal.x), Sign(planes.mPlanes[ i ].mNormal.y), Sign(planes.mPlanes[ i ].mNormal.z) );
 571     }
 572   }
 573   mFrustum[ updateBufferIndex ? 0 : 1 ] = planes;
 574 }
 575
 576 bool Camera::CheckSphereInFrustum( BufferIndex bufferIndex, const Vector3& origin, float radius )
 577 {
 578   const FrustumPlanes& planes = mFrustum[ bufferIndex ];
 579   for ( uint32_t i = 0; i < 6; ++i )
 580   {
 581     if ( ( planes.mPlanes[ i ].mDistance + planes.mPlanes[ i ].mNormal.Dot( origin ) ) < -radius )
 582     {
 583       return false;
 584     }
 585   }
 586   return true;
 587 }
 588
 589 bool Camera::CheckAABBInFrustum( BufferIndex bufferIndex, const Vector3& origin, const Vector3& halfExtents )
 590 {
 591   const FrustumPlanes& planes = mFrustum[ bufferIndex ];
 592   for ( uint32_t i = 0; i < 6; ++i )
 593   {
 594     if( planes.mPlanes[ i ].mNormal.Dot( origin + (halfExtents * planes.mSign[i]) ) > -(planes.mPlanes[ i ].mDistance) )
 595     {
 596       continue;
 597     }
 598
 599     return false;
 600   }
 601   return true;
 602 }
 603
 604 uint32_t Camera::UpdateProjection( BufferIndex updateBufferIndex )
 605 {
 606   uint32_t retval( mUpdateProjectionFlag );
 607   // Early-exit if no update required
 608   if ( 0u != mUpdateProjectionFlag )
 609   {
 610     if ( COPY_PREVIOUS_MATRIX == mUpdateProjectionFlag )
 611     {
 612       // The projection matrix was updated in the previous frame; copy it
 613       mProjectionMatrix.CopyPrevious( updateBufferIndex );
 614     }
 615     else // UPDATE_COUNT == mUpdateProjectionFlag
 616     {
 617       switch( mProjectionMode )
 618       {
 619         case Dali::Camera::PERSPECTIVE_PROJECTION:
 620         {
 621           Matrix &projectionMatrix = mProjectionMatrix.Get( updateBufferIndex );
 622           Perspective( projectionMatrix,
 623                        mFieldOfView,
 624                        mAspectRatio,
 625                        mNearClippingPlane,
 626                        mFarClippingPlane,
 627                        mInvertYAxis );
 628
 629           //need to apply custom clipping plane
 630           if (mUseReflectionClip)
 631           {
 632             Matrix& viewMatrix = mViewMatrix.Get( updateBufferIndex );
 633             Matrix viewInv = viewMatrix;
 634             viewInv.Invert();
 635             viewInv.Transpose();
 636
 637             Dali::Vector4 adjReflectPlane = mReflectionPlane;
 638             float d = mReflectionPlane.Dot(mReflectionEye);
 639             if (d < 0)
 640             {
 641               adjReflectPlane.w = -adjReflectPlane.w;
 642             }
 643
 644             Vector4 customClipping = viewInv * adjReflectPlane;
 645             AdjustNearPlaneForPerspective(projectionMatrix, customClipping);
 646
 647             // Invert Z
 648             Matrix matZ;
 649             matZ.SetIdentity();
 650             float* vZ = matZ.AsFloat();
 651             vZ[10] = -vZ[10];
 652             Matrix::Multiply(projectionMatrix, projectionMatrix , matZ);
 653           }
 654           break;
 655         }
 656         case Dali::Camera::ORTHOGRAPHIC_PROJECTION:
 657         {
 658           Matrix &projectionMatrix = mProjectionMatrix.Get( updateBufferIndex );
 659           Orthographic( projectionMatrix,
 660                         mLeftClippingPlane,   mRightClippingPlane,
 661                         mBottomClippingPlane, mTopClippingPlane,
 662                         mNearClippingPlane,   mFarClippingPlane,
 663                         mInvertYAxis );
 664           break;
 665         }
 666       }
 667
 668       mProjectionMatrix.SetDirty( updateBufferIndex );
 669
 670       Matrix &finalProjection = mFinalProjection[ updateBufferIndex ];
 671       finalProjection.SetIdentity();
 672
 673       Quaternion rotationAngle;
 674       switch( mProjectionRotation )
 675       {
 676         case 90:
 677         {
 678           rotationAngle = Quaternion( Dali::ANGLE_90, Vector3::ZAXIS );
 679           break;
 680         }
 681         case 180:
 682         {
 683           rotationAngle = Quaternion( Dali::ANGLE_180, Vector3::ZAXIS );
 684           break;
 685         }
 686         case 270:
 687         {
 688           rotationAngle = Quaternion( Dali::ANGLE_270, Vector3::ZAXIS );
 689           break;
 690         }
 691         default:
 692           rotationAngle = Quaternion( Dali::ANGLE_0, Vector3::ZAXIS );
 693           break;
 694       }
 695
 696       Matrix rotation;
 697       rotation.SetIdentity();
 698       rotation.SetTransformComponents( Vector3( 1.0f, 1.0f, 1.0f ), rotationAngle, Vector3( 0.0f, 0.0f, 0.0f ) );
 699
 700       Matrix::Multiply( finalProjection, mProjectionMatrix.Get( updateBufferIndex ), rotation );
 701     }
 702     --mUpdateProjectionFlag;
 703   }
 704   return retval;
 705 }
 706
 707 } // namespace SceneGraph
 708
 709 } // namespace Internal
 710
 711 } // namespace Dali