[dali_1.9.18] Merge branch 'devel/master'
[platform/core/uifw/dali-core.git] / 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   mNode( NULL ),
165   mType( DEFAULT_TYPE ),
166   mProjectionMode( DEFAULT_MODE ),
167   mInvertYAxis( DEFAULT_INVERT_Y_AXIS ),
168   mFieldOfView( DEFAULT_FIELD_OF_VIEW ),
169   mAspectRatio( DEFAULT_ASPECT_RATIO ),
170   mLeftClippingPlane( DEFAULT_LEFT_CLIPPING_PLANE ),
171   mRightClippingPlane( DEFAULT_RIGHT_CLIPPING_PLANE ),
172   mTopClippingPlane( DEFAULT_TOP_CLIPPING_PLANE ),
173   mBottomClippingPlane( DEFAULT_BOTTOM_CLIPPING_PLANE ),
174   mNearClippingPlane( DEFAULT_NEAR_CLIPPING_PLANE ),
175   mFarClippingPlane( DEFAULT_FAR_CLIPPING_PLANE ),
176   mTargetPosition( DEFAULT_TARGET_POSITION ),
177   mViewMatrix(),
178   mProjectionMatrix(),
179   mInverseViewProjection( Matrix::IDENTITY )
180 {
181 }
182
183 Camera* Camera::New()
184 {
185   return new Camera();
186 }
187
188 Camera::~Camera()
189 {
190 }
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
274
275 void VectorReflectedByPlane(Vector4 &out, Vector4 &in, Vector4 &plane)
276 {
277   float d = float(2.0) * plane.Dot(in);
278   out.x = static_cast<float>(in.x - plane.x*d);
279   out.y = static_cast<float>(in.y - plane.y*d);
280   out.z = static_cast<float>(in.z - plane.z*d);
281   out.w = static_cast<float>(in.w - plane.w*d);
282 }
283
284 void Camera::AdjustNearPlaneForPerspective( Matrix& perspective, const Vector4& clipPlane )
285 {
286   Vector4    q;
287   float* v = perspective.AsFloat();
288
289   q.x = (Sign(clipPlane.x) + v[8]) / v[0];
290   q.y = (Sign(clipPlane.y) + v[9]) / v[5];
291   q.z = -1.0f;
292   q.w = (1.0f + v[10]) / v[14];
293
294   // Calculate the scaled plane vector
295   Vector4 c = clipPlane * (REFLECTION_NORMALIZED_DEVICE_COORDINATE_PARAMETER_A / q.Dot( clipPlane));
296
297   // Replace the third row of the projection v
298   v[2] = c.x;
299   v[6] = c.y;
300   v[10] = c.z + REFLECTION_NORMALIZED_DEVICE_COORDINATE_PARAMETER_D;
301   v[14] = c.w;
302 }
303
304 void Camera::SetReflectByPlane( const Vector4& plane )
305 {
306   float* v = mReflectionMtx.AsFloat();
307   float _2ab = -2.0f * plane.x * plane.y;
308   float _2ac = -2.0f * plane.x * plane.z;
309   float _2bc = -2.0f * plane.y * plane.z;
310
311   v[0] = 1.0f - 2.0f * plane.x * plane.x;
312   v[1] = _2ab;
313   v[2] = _2ac;
314   v[3] = 0.0f;
315
316   v[4] = _2ab;
317   v[5] = 1.0f - 2.0f * plane.y * plane.y;
318   v[6] = _2bc;
319   v[7] = 0.0f;
320
321   v[8] = _2ac;
322   v[9] = _2bc;
323   v[10] = 1.0f - 2.0f * plane.z * plane.z;
324   v[11] = 0.0f;
325
326   v[12] =    - 2 * plane.x * plane.w;
327   v[13] =    - 2 * plane.y * plane.w;
328   v[14] =    - 2 * plane.z * plane.w;
329   v[15] = 1.0f;
330
331   mUseReflection = true;
332   mReflectionPlane = plane;
333   mUpdateViewFlag = UPDATE_COUNT;
334 }
335
336 const Matrix& Camera::GetProjectionMatrix( BufferIndex bufferIndex ) const
337 {
338   return mProjectionMatrix[ bufferIndex ];
339 }
340
341 const Matrix& Camera::GetViewMatrix( BufferIndex bufferIndex ) const
342 {
343   return mViewMatrix[ bufferIndex ];
344 }
345
346 const Matrix& Camera::GetInverseViewProjectionMatrix( BufferIndex bufferIndex ) const
347 {
348   return mInverseViewProjection[ bufferIndex ];
349 }
350
351 const PropertyInputImpl* Camera::GetProjectionMatrix() const
352 {
353   return &mProjectionMatrix;
354 }
355
356 const PropertyInputImpl* Camera::GetViewMatrix() const
357 {
358   return &mViewMatrix;
359 }
360
361 void Camera::Update( BufferIndex updateBufferIndex )
362 {
363   // if owning node has changes in world position we need to update camera for next 2 frames
364   if( mNode->IsLocalMatrixDirty() )
365   {
366     mUpdateViewFlag = UPDATE_COUNT;
367   }
368   if( mNode->GetDirtyFlags() & NodePropertyFlags::VISIBLE )
369   {
370     // If the visibility changes, the projection matrix needs to be re-calculated.
371     // It may happen the first time an actor is rendered it's rendered only once and becomes invisible,
372     // in the following update the node will be skipped leaving the projection matrix (double buffered)
373     // with the Identity.
374     mUpdateProjectionFlag = UPDATE_COUNT;
375   }
376
377   // if either matrix changed, we need to recalculate the inverse matrix for hit testing to work
378   uint32_t viewUpdateCount = UpdateViewMatrix( updateBufferIndex );
379   uint32_t projectionUpdateCount = UpdateProjection( updateBufferIndex );
380
381   // if model or view matrix changed we need to either recalculate the inverse VP or copy previous
382   if( viewUpdateCount > COPY_PREVIOUS_MATRIX || projectionUpdateCount > COPY_PREVIOUS_MATRIX )
383   {
384     // either has actually changed so recalculate
385     Matrix::Multiply( mInverseViewProjection[ updateBufferIndex ], mViewMatrix[ updateBufferIndex ], mProjectionMatrix[ updateBufferIndex ] );
386     UpdateFrustum( updateBufferIndex );
387
388     // ignore the error, if the view projection is incorrect (non inversible) then you will have tough times anyways
389     static_cast< void >( mInverseViewProjection[ updateBufferIndex ].Invert() );
390   }
391   else if( viewUpdateCount == COPY_PREVIOUS_MATRIX || projectionUpdateCount == COPY_PREVIOUS_MATRIX )
392   {
393     // neither has actually changed, but we might copied previous frames value so need to
394     // copy the previous inverse and frustum as well
395     mInverseViewProjection[updateBufferIndex] = mInverseViewProjection[updateBufferIndex ? 0 : 1];
396     mFrustum[ updateBufferIndex ] = mFrustum[ updateBufferIndex ? 0 : 1 ];
397   }
398 }
399
400 bool Camera::ViewMatrixUpdated()
401 {
402   return 0u != mUpdateViewFlag;
403 }
404
405 uint32_t Camera::UpdateViewMatrix( BufferIndex updateBufferIndex )
406 {
407   uint32_t retval( mUpdateViewFlag );
408   if( 0u != mUpdateViewFlag )
409   {
410     if( COPY_PREVIOUS_MATRIX == mUpdateViewFlag )
411     {
412       // The projection matrix was updated in the previous frame; copy it
413       mViewMatrix.CopyPrevious( updateBufferIndex );
414     }
415     else // UPDATE_COUNT == mUpdateViewFlag
416     {
417       switch( mType )
418       {
419         // camera orientation taken from node - i.e. look in abitrary, unconstrained direction
420         case Dali::Camera::FREE_LOOK:
421         {
422           Matrix& viewMatrix = mViewMatrix.Get( updateBufferIndex );
423           viewMatrix = mNode->GetWorldMatrix( updateBufferIndex );
424
425           if (mUseReflection)
426           {
427             const Matrix& owningNodeMatrix( mNode->GetWorldMatrix( updateBufferIndex ) );
428             Vector3 position{}, scale{};
429             Quaternion orientation{};
430             owningNodeMatrix.GetTransformComponents( position, orientation, scale );
431             mReflectionEye = position;
432             mUseReflectionClip = true;
433
434             Matrix& viewMatrix = mViewMatrix.Get( updateBufferIndex );
435             Matrix oldViewMatrix( viewMatrix );
436             Matrix::Multiply(viewMatrix, oldViewMatrix, mReflectionMtx);
437           }
438
439           viewMatrix.Invert();
440           mViewMatrix.SetDirty( updateBufferIndex );
441           break;
442         }
443
444         // camera orientation constrained to look at a target
445         case Dali::Camera::LOOK_AT_TARGET:
446         {
447           const Matrix& owningNodeMatrix( mNode->GetWorldMatrix( updateBufferIndex ) );
448           Vector3 position, scale;
449           Quaternion orientation;
450           owningNodeMatrix.GetTransformComponents( position, orientation, scale );
451           Matrix& viewMatrix = mViewMatrix.Get( updateBufferIndex );
452
453           if (mUseReflection)
454           {
455             Vector3 up = orientation.Rotate( Vector3::YAXIS );
456             Vector4 position4 = Vector4(position);
457             Vector4 target4 = Vector4(mTargetPosition);
458             Vector4 up4 = Vector4(up);
459             Vector4 positionNew;
460             Vector4 targetNew;
461             Vector4 upNew;
462             Vector3 positionNew3;
463             Vector3 targetNewVector3;
464             Vector3 upNew3;
465
466             // eye
467             VectorReflectedByPlane(positionNew, position4, mReflectionPlane);
468             VectorReflectedByPlane(targetNew, target4, mReflectionPlane);
469             VectorReflectedByPlane(upNew, up4, mReflectionPlane);
470
471             positionNew3     = Vector3(positionNew);
472             targetNewVector3 = Vector3(targetNew);
473             upNew3           = Vector3(upNew);
474             LookAt(viewMatrix, positionNew3, targetNewVector3, upNew3 );
475
476             Matrix oldViewMatrix( viewMatrix );
477             Matrix tmp;
478             tmp.SetIdentityAndScale(Vector3(-1.0, 1.0,1.0));
479             Matrix::Multiply(viewMatrix, oldViewMatrix, tmp);
480
481             mReflectionEye = positionNew;
482             mUseReflectionClip = true;
483           }
484           else
485           {
486             LookAt( viewMatrix, position, mTargetPosition, orientation.Rotate( Vector3::YAXIS ) );
487           }
488           mViewMatrix.SetDirty( updateBufferIndex );
489           break;
490         }
491       }
492     }
493     --mUpdateViewFlag;
494   }
495   return retval;
496 }
497
498 void Camera::UpdateFrustum( BufferIndex updateBufferIndex, bool normalize )
499 {
500
501   // Extract the clip matrix planes
502   Matrix clipMatrix;
503   Matrix::Multiply( clipMatrix, mViewMatrix[ updateBufferIndex ], mProjectionMatrix[ updateBufferIndex ] );
504
505   const float* cm = clipMatrix.AsFloat();
506   FrustumPlanes& planes = mFrustum[ updateBufferIndex ];
507
508   // Left
509   planes.mPlanes[ 0 ].mNormal.x = cm[ 3 ]  + cm[ 0 ]; // column 4 + column 1
510   planes.mPlanes[ 0 ].mNormal.y = cm[ 7 ]  + cm[ 4 ];
511   planes.mPlanes[ 0 ].mNormal.z = cm[ 11 ] + cm[ 8 ];
512   planes.mPlanes[ 0 ].mDistance = cm[ 15 ] + cm[ 12 ];
513
514   // Right
515   planes.mPlanes[ 1 ].mNormal.x = cm[ 3 ]  - cm[ 0 ]; // column 4 - column 1
516   planes.mPlanes[ 1 ].mNormal.y = cm[ 7 ]  - cm[ 4 ];
517   planes.mPlanes[ 1 ].mNormal.z = cm[ 11 ] - cm[ 8 ];
518   planes.mPlanes[ 1 ].mDistance = cm[ 15 ] - cm[ 12 ];
519
520   // Bottom
521   planes.mPlanes[ 2 ].mNormal.x = cm[ 3 ]  + cm[ 1 ]; // column 4 + column 2
522   planes.mPlanes[ 2 ].mNormal.y = cm[ 7 ]  + cm[ 5 ];
523   planes.mPlanes[ 2 ].mNormal.z = cm[ 11 ] + cm[ 9 ];
524   planes.mPlanes[ 2 ].mDistance = cm[ 15 ] + cm[ 13 ];
525
526   // Top
527   planes.mPlanes[ 3 ].mNormal.x = cm[ 3 ]  - cm[ 1 ]; // column 4 - column 2
528   planes.mPlanes[ 3 ].mNormal.y = cm[ 7 ]  - cm[ 5 ];
529   planes.mPlanes[ 3 ].mNormal.z = cm[ 11 ] - cm[ 9 ];
530   planes.mPlanes[ 3 ].mDistance = cm[ 15 ] - cm[ 13 ];
531
532   // Near
533   planes.mPlanes[ 4 ].mNormal.x = cm[ 3 ]  + cm[ 2 ]; // column 4 + column 3
534   planes.mPlanes[ 4 ].mNormal.y = cm[ 7 ]  + cm[ 6 ];
535   planes.mPlanes[ 4 ].mNormal.z = cm[ 11 ] + cm[ 10 ];
536   planes.mPlanes[ 4 ].mDistance = cm[ 15 ] + cm[ 14 ];
537
538   // Far
539   planes.mPlanes[ 5 ].mNormal.x = cm[ 3 ]  - cm[ 2 ]; // column 4 - column 3
540   planes.mPlanes[ 5 ].mNormal.y = cm[ 7 ]  - cm[ 6 ];
541   planes.mPlanes[ 5 ].mNormal.z = cm[ 11 ] - cm[ 10 ];
542   planes.mPlanes[ 5 ].mDistance = cm[ 15 ] - cm[ 14 ];
543
544   if ( normalize )
545   {
546     for ( uint32_t i = 0; i < 6; ++i )
547     {
548       // Normalize planes to ensure correct bounding distance checking
549       Plane& plane = planes.mPlanes[ i ];
550       float l = 1.0f / plane.mNormal.Length();
551       plane.mNormal *= l;
552       plane.mDistance *= l;
553
554       planes.mSign[i] = Vector3( Sign(plane.mNormal.x), Sign(plane.mNormal.y), Sign(plane.mNormal.z) );
555     }
556   }
557   else
558   {
559     for ( uint32_t i = 0; i < 6; ++i )
560     {
561       planes.mSign[i] = Vector3( Sign(planes.mPlanes[ i ].mNormal.x), Sign(planes.mPlanes[ i ].mNormal.y), Sign(planes.mPlanes[ i ].mNormal.z) );
562     }
563   }
564   mFrustum[ updateBufferIndex ? 0 : 1 ] = planes;
565 }
566
567 bool Camera::CheckSphereInFrustum( BufferIndex bufferIndex, const Vector3& origin, float radius )
568 {
569   const FrustumPlanes& planes = mFrustum[ bufferIndex ];
570   for ( uint32_t i = 0; i < 6; ++i )
571   {
572     if ( ( planes.mPlanes[ i ].mDistance + planes.mPlanes[ i ].mNormal.Dot( origin ) ) < -radius )
573     {
574       return false;
575     }
576   }
577   return true;
578 }
579
580 bool Camera::CheckAABBInFrustum( BufferIndex bufferIndex, const Vector3& origin, const Vector3& halfExtents )
581 {
582   const FrustumPlanes& planes = mFrustum[ bufferIndex ];
583   for ( uint32_t i = 0; i < 6; ++i )
584   {
585     if( planes.mPlanes[ i ].mNormal.Dot( origin + (halfExtents * planes.mSign[i]) ) > -(planes.mPlanes[ i ].mDistance) )
586     {
587       continue;
588     }
589
590     return false;
591   }
592   return true;
593 }
594
595 uint32_t Camera::UpdateProjection( BufferIndex updateBufferIndex )
596 {
597   uint32_t retval( mUpdateProjectionFlag );
598   // Early-exit if no update required
599   if ( 0u != mUpdateProjectionFlag )
600   {
601     if ( COPY_PREVIOUS_MATRIX == mUpdateProjectionFlag )
602     {
603       // The projection matrix was updated in the previous frame; copy it
604       mProjectionMatrix.CopyPrevious( updateBufferIndex );
605     }
606     else // UPDATE_COUNT == mUpdateProjectionFlag
607     {
608       switch( mProjectionMode )
609       {
610         case Dali::Camera::PERSPECTIVE_PROJECTION:
611         {
612           Matrix &projectionMatrix = mProjectionMatrix.Get( updateBufferIndex );
613           Perspective( projectionMatrix,
614                        mFieldOfView,
615                        mAspectRatio,
616                        mNearClippingPlane,
617                        mFarClippingPlane,
618                        mInvertYAxis );
619
620           //need to apply custom clipping plane
621           if (mUseReflectionClip)
622           {
623             Matrix& viewMatrix = mViewMatrix.Get( updateBufferIndex );
624             Matrix viewInv = viewMatrix;
625             viewInv.Invert();
626             viewInv.Transpose();
627
628             Dali::Vector4 adjReflectPlane = mReflectionPlane;
629             float d = mReflectionPlane.Dot(mReflectionEye);
630             if (d < 0)
631             {
632               adjReflectPlane.w = -adjReflectPlane.w;
633             }
634
635             Vector4 customClipping = viewInv * adjReflectPlane;
636             AdjustNearPlaneForPerspective(projectionMatrix, customClipping);
637
638             // Invert Z
639             Matrix matZ;
640             matZ.SetIdentity();
641             float* vZ = matZ.AsFloat();
642             vZ[10] = -vZ[10];
643             Matrix::Multiply(projectionMatrix, projectionMatrix , matZ);
644           }
645           break;
646         }
647         case Dali::Camera::ORTHOGRAPHIC_PROJECTION:
648         {
649           Matrix &projectionMatrix = mProjectionMatrix.Get( updateBufferIndex );
650           Orthographic( projectionMatrix,
651                         mLeftClippingPlane,   mRightClippingPlane,
652                         mBottomClippingPlane, mTopClippingPlane,
653                         mNearClippingPlane,   mFarClippingPlane,
654                         mInvertYAxis );
655           break;
656         }
657       }
658
659       mProjectionMatrix.SetDirty( updateBufferIndex );
660     }
661     --mUpdateProjectionFlag;
662   }
663   return retval;
664 }
665
666 } // namespace SceneGraph
667
668 } // namespace Internal
669
670 } // namespace Dali