Merge "Add descriptions and example codes" into devel/master
[platform/core/uifw/dali-toolkit.git] / dali-toolkit / internal / visuals / gradient / gradient-visual.cpp
1 /*
2  * Copyright (c) 2016 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 "gradient-visual.h"
20
21 // EXTERNAL INCLUDES
22 #include <typeinfo>
23 #include <dali/integration-api/debug.h>
24 #include <dali/public-api/common/dali-vector.h>
25 #include <dali/public-api/images/buffer-image.h>
26 #include <dali/public-api/object/property-array.h>
27 #include <dali/devel-api/scripting/enum-helper.h>
28 #include <dali/devel-api/scripting/scripting.h>
29
30 // INTERNAL INCLUDES
31 #include <dali-toolkit/public-api/visuals/gradient-visual-properties.h>
32 #include <dali-toolkit/internal/visuals/visual-factory-impl.h>
33 #include <dali-toolkit/internal/visuals/visual-factory-cache.h>
34 #include <dali-toolkit/internal/visuals/visual-string-constants.h>
35 #include <dali-toolkit/internal/visuals/gradient/linear-gradient.h>
36 #include <dali-toolkit/internal/visuals/gradient/radial-gradient.h>
37 #include <dali-toolkit/internal/visuals/visual-base-data-impl.h>
38
39 namespace Dali
40 {
41
42 namespace Toolkit
43 {
44
45 namespace Internal
46 {
47
48 namespace
49 {
50 // properties: linear gradient
51 const char * const START_POSITION_NAME("startPosition"); // Property::VECTOR2
52 const char * const END_POSITION_NAME("endPosition"); // Property::VECTOR2
53
54 // properties: radial gradient
55 const char * const CENTER_NAME("center"); // Property::VECTOR2
56 const char * const RADIUS_NAME("radius"); // Property::FLOAT
57
58 // properties: linear&radial gradient
59 const char * const STOP_OFFSET_NAME("stopOffset"); // Property::Array FLOAT
60 const char * const STOP_COLOR_NAME("stopColor"); // Property::Array VECTOR4
61 const char * const UNITS_NAME("units"); // Property::String  "userSpaceOnUse | objectBoundingBox"
62 const char * const SPREAD_METHOD_NAME("spreadMethod"); // Property::String  "pad | reflect | repeat"
63
64 DALI_ENUM_TO_STRING_TABLE_BEGIN( UNITS )
65 DALI_ENUM_TO_STRING_WITH_SCOPE( Toolkit::GradientVisual::Units, OBJECT_BOUNDING_BOX )
66 DALI_ENUM_TO_STRING_WITH_SCOPE( Toolkit::GradientVisual::Units, USER_SPACE )
67 DALI_ENUM_TO_STRING_TABLE_END( UNITS )
68
69 DALI_ENUM_TO_STRING_TABLE_BEGIN( SPREAD_METHOD )
70 DALI_ENUM_TO_STRING_WITH_SCOPE( Toolkit::GradientVisual::SpreadMethod, PAD )
71 DALI_ENUM_TO_STRING_WITH_SCOPE( Toolkit::GradientVisual::SpreadMethod, REFLECT )
72 DALI_ENUM_TO_STRING_WITH_SCOPE( Toolkit::GradientVisual::SpreadMethod, REPEAT )
73 DALI_ENUM_TO_STRING_TABLE_END( SPREAD_METHOD )
74
75 // uniform names
76 const char * const UNIFORM_ALIGNMENT_MATRIX_NAME( "uAlignmentMatrix" );
77
78 // default offset value
79 const unsigned int DEFAULT_OFFSET_MINIMUM = 0.0f;
80 const unsigned int DEFAULT_OFFSET_MAXIMUM = 1.0f;
81
82 VisualFactoryCache::ShaderType GetShaderType( GradientVisual::Type type, Toolkit::GradientVisual::Units::Type units )
83 {
84   if( type == GradientVisual::LINEAR )
85   {
86    if( units == Toolkit::GradientVisual::Units::USER_SPACE )
87    {
88      return VisualFactoryCache::GRADIENT_SHADER_LINEAR_USER_SPACE;
89    }
90    return VisualFactoryCache::GRADIENT_SHADER_LINEAR_BOUNDING_BOX;
91   }
92   else if( units == Toolkit::GradientVisual::Units::USER_SPACE )
93   {
94     return VisualFactoryCache::GRADIENT_SHADER_RADIAL_USER_SPACE;
95   }
96
97   return VisualFactoryCache::GRADIENT_SHADER_RADIAL_BOUNDING_BOX;
98 }
99
100 const char* VERTEX_SHADER[] =
101 {
102 // vertex shader for gradient units as OBJECT_BOUNDING_BOX
103  DALI_COMPOSE_SHADER(
104   attribute mediump vec2 aPosition;\n
105   uniform mediump mat4 uMvpMatrix;\n
106   uniform mediump vec3 uSize;\n
107   uniform mediump mat3 uAlignmentMatrix;\n
108   varying mediump vec2 vTexCoord;\n
109   \n
110   void main()\n
111   {\n
112     mediump vec4 vertexPosition = vec4(aPosition, 0.0, 1.0);\n
113     vTexCoord = (uAlignmentMatrix*vertexPosition.xyw).xy;\n
114     \n
115     vertexPosition.xyz *= uSize;\n
116     gl_Position = uMvpMatrix * vertexPosition;\n
117   }\n
118 ),
119
120 // vertex shader for gradient units as USER_SPACE
121 DALI_COMPOSE_SHADER(
122   attribute mediump vec2 aPosition;\n
123   uniform mediump mat4 uMvpMatrix;\n
124   uniform mediump vec3 uSize;\n
125   uniform mediump mat3 uAlignmentMatrix;\n
126   varying mediump vec2 vTexCoord;\n
127   \n
128   void main()\n
129   {\n
130     mediump vec4 vertexPosition = vec4(aPosition, 0.0, 1.0);\n
131     vertexPosition.xyz *= uSize;\n
132     gl_Position = uMvpMatrix * vertexPosition;\n
133     \n
134     vTexCoord = (uAlignmentMatrix*vertexPosition.xyw).xy;\n
135   }\n
136 )
137 };
138
139 const char* FRAGMENT_SHADER[] =
140 {
141 // fragment shader for linear gradient
142 DALI_COMPOSE_SHADER(
143   uniform sampler2D sTexture;\n // sampler1D?
144   uniform lowp vec4 uColor;\n
145   varying mediump vec2 vTexCoord;\n
146   \n
147   void main()\n
148   {\n
149     gl_FragColor = texture2D( sTexture, vec2( vTexCoord.y, 0.5 ) ) * uColor;\n
150   }\n
151 ),
152
153 // fragment shader for radial gradient
154 DALI_COMPOSE_SHADER(
155   uniform sampler2D sTexture;\n // sampler1D?
156   uniform lowp vec4 uColor;\n
157   varying mediump vec2 vTexCoord;\n
158   \n
159   void main()\n
160   {\n
161     gl_FragColor = texture2D( sTexture, vec2( length(vTexCoord), 0.5 ) ) * uColor;\n
162   }\n
163 )
164 };
165
166 Dali::WrapMode::Type GetWrapMode( Toolkit::GradientVisual::SpreadMethod::Type spread )
167 {
168   switch(spread)
169   {
170     case Toolkit::GradientVisual::SpreadMethod::REPEAT:
171     {
172       return Dali::WrapMode::REPEAT;
173     }
174     case Toolkit::GradientVisual::SpreadMethod::REFLECT:
175     {
176       return Dali::WrapMode::MIRRORED_REPEAT;
177     }
178     case Toolkit::GradientVisual::SpreadMethod::PAD:
179     default:
180     {
181       return Dali::WrapMode::CLAMP_TO_EDGE;
182     }
183   }
184 }
185
186 } // unnamed namespace
187
188
189 GradientVisual::GradientVisual( VisualFactoryCache& factoryCache )
190 : Visual::Base( factoryCache ),
191   mGradientType( LINEAR )
192 {
193   mImpl->mFlags |= Impl::IS_PREMULTIPLIED_ALPHA;
194 }
195
196 GradientVisual::~GradientVisual()
197 {
198 }
199
200 void GradientVisual::DoInitialize( Actor& actor, const Property::Map& propertyMap )
201 {
202   Toolkit::GradientVisual::Units::Type gradientUnits = Toolkit::GradientVisual::Units::OBJECT_BOUNDING_BOX;
203
204   Property::Value* unitsValue = propertyMap.Find( Toolkit::GradientVisual::Property::UNITS, UNITS_NAME );
205   if( unitsValue )
206   {
207     Scripting::GetEnumerationProperty( *unitsValue, UNITS_TABLE, UNITS_TABLE_COUNT, gradientUnits );
208   }
209
210   mGradientType = LINEAR;
211   if( propertyMap.Find( Toolkit::GradientVisual::Property::RADIUS, RADIUS_NAME ) )
212   {
213     mGradientType = RADIAL;
214   }
215
216   if( NewGradient( mGradientType, propertyMap ) )
217   {
218     mGradient->SetGradientUnits( gradientUnits );
219     mGradientTransform = mGradient->GetAlignmentTransform();
220   }
221   else
222   {
223     DALI_LOG_ERROR( "Fail to provide valid properties to create a GradientVisual object\n" );
224   }
225 }
226
227 void GradientVisual::SetSize( const Vector2& size )
228 {
229   Visual::Base::SetSize( size );
230 }
231
232 void GradientVisual::DoSetOnStage( Actor& actor )
233 {
234   InitializeRenderer();
235 }
236
237 void GradientVisual::DoCreatePropertyMap( Property::Map& map ) const
238 {
239   map.Clear();
240   map.Insert( Toolkit::Visual::Property::TYPE, Toolkit::Visual::GRADIENT );
241   map.Insert( Toolkit::GradientVisual::Property::UNITS, mGradient->GetGradientUnits() );
242   map.Insert( Toolkit::GradientVisual::Property::SPREAD_METHOD, mGradient->GetSpreadMethod() );
243
244   const Vector<Gradient::GradientStop>& stops( mGradient->GetStops() );
245   Property::Array offsets;
246   Property::Array colors;
247   for( unsigned int i=0; i<stops.Count(); i++ )
248   {
249     offsets.PushBack( stops[i].mOffset );
250     if( EqualsZero(stops[i].mStopColor.a) )
251     {
252       colors.PushBack( Vector4::ZERO );
253     }
254     else
255     {
256       colors.PushBack( Vector4( stops[i].mStopColor.r / stops[i].mStopColor.a,
257                                 stops[i].mStopColor.g / stops[i].mStopColor.a,
258                                 stops[i].mStopColor.b / stops[i].mStopColor.a,
259                                 stops[i].mStopColor.a));
260     }
261   }
262
263   map.Insert( Toolkit::GradientVisual::Property::STOP_OFFSET, offsets );
264   map.Insert( Toolkit::GradientVisual::Property::STOP_COLOR, colors );
265
266   if( &typeid( *mGradient ) == &typeid(LinearGradient) )
267   {
268     LinearGradient* gradient = static_cast<LinearGradient*>( mGradient.Get() );
269     map.Insert( Toolkit::GradientVisual::Property::START_POSITION, gradient->GetStartPosition() );
270     map.Insert( Toolkit::GradientVisual::Property::END_POSITION, gradient->GetEndPosition() );
271   }
272   else // if( &typeid( *mGradient ) == &typeid(RadialGradient) )
273   {
274     RadialGradient* gradient = static_cast<RadialGradient*>( mGradient.Get() );
275     map.Insert( Toolkit::GradientVisual::Property::CENTER, gradient->GetCenter() );
276     map.Insert( Toolkit::GradientVisual::Property::RADIUS, gradient->GetRadius() );
277   }
278 }
279
280 void GradientVisual::InitializeRenderer()
281 {
282   Geometry geometry = mFactoryCache.GetGeometry( VisualFactoryCache::QUAD_GEOMETRY );
283   if( !geometry )
284   {
285     geometry =  VisualFactoryCache::CreateQuadGeometry();
286     mFactoryCache.SaveGeometry( VisualFactoryCache::QUAD_GEOMETRY, geometry );
287   }
288
289   Toolkit::GradientVisual::Units::Type gradientUnits = mGradient->GetGradientUnits();
290   VisualFactoryCache::ShaderType shaderType = GetShaderType( mGradientType, gradientUnits );
291   Shader shader = mFactoryCache.GetShader( shaderType );
292   if( !shader )
293   {
294     shader = Shader::New( VERTEX_SHADER[gradientUnits], FRAGMENT_SHADER[ mGradientType ] );
295     mFactoryCache.SaveShader( shaderType, shader );
296   }
297
298   //Set up the texture set
299   TextureSet textureSet = TextureSet::New();
300   Dali::Texture lookupTexture = mGradient->GenerateLookupTexture();
301   textureSet.SetTexture( 0u, lookupTexture );
302   Dali::WrapMode::Type wrap = GetWrapMode( mGradient->GetSpreadMethod() );
303   Sampler sampler = Sampler::New();
304   sampler.SetWrapMode(  wrap, wrap  );
305   textureSet.SetSampler( 0u, sampler );
306
307   mImpl->mRenderer = Renderer::New( geometry, shader );
308   mImpl->mRenderer.SetTextures( textureSet );
309
310   mImpl->mRenderer.RegisterProperty( UNIFORM_ALIGNMENT_MATRIX_NAME, mGradientTransform );
311 }
312
313 bool GradientVisual::NewGradient(Type gradientType, const Property::Map& propertyMap)
314 {
315   if( gradientType == LINEAR )
316   {
317     Property::Value* startPositionValue = propertyMap.Find( Toolkit::GradientVisual::Property::START_POSITION, START_POSITION_NAME );
318     Property::Value* endPositionValue = propertyMap.Find( Toolkit::GradientVisual::Property::END_POSITION, END_POSITION_NAME );
319     Vector2 startPosition;
320     Vector2 endPosition;
321
322     if( startPositionValue && startPositionValue->Get(startPosition)
323      && endPositionValue && endPositionValue->Get( endPosition ) )
324     {
325       mGradient = new LinearGradient( startPosition, endPosition );
326     }
327     else
328     {
329       return false;
330     }
331   }
332   else // type==RADIAL
333   {
334     Property::Value* centerValue = propertyMap.Find( Toolkit::GradientVisual::Property::CENTER, CENTER_NAME );
335     Property::Value* radiusValue = propertyMap.Find( Toolkit::GradientVisual::Property::RADIUS, RADIUS_NAME );
336     Vector2 center;
337     float radius;
338     if( centerValue && centerValue->Get(center)
339         && radiusValue && radiusValue->Get(radius) )
340     {
341       mGradient = new RadialGradient( center, radius );
342     }
343     else
344     {
345       return false;
346     }
347   }
348
349   unsigned int numValidStop = 0u;
350   Property::Value* stopOffsetValue = propertyMap.Find( Toolkit::GradientVisual::Property::STOP_OFFSET, STOP_OFFSET_NAME );
351   Property::Value* stopColorValue = propertyMap.Find( Toolkit::GradientVisual::Property::STOP_COLOR, STOP_COLOR_NAME );
352   if( stopColorValue )
353   {
354     Vector<float> offsetArray;
355     Property::Array* colorArray = stopColorValue->GetArray();
356     if( colorArray )
357     {
358       GetStopOffsets( stopOffsetValue, offsetArray );
359       unsigned int numStop = offsetArray.Count() < colorArray->Count() ?
360                              offsetArray.Count() : colorArray->Count();
361       Vector4 color;
362       for( unsigned int i=0; i<numStop; i++ )
363       {
364         if( (colorArray->GetElementAt(i)).Get(color) )
365         {
366           mGradient->AddStop( offsetArray[i], Vector4(color.r*color.a, color.g*color.a, color.b*color.a, color.a));
367           numValidStop++;
368         }
369       }
370     }
371   }
372
373   if( numValidStop < 1u ) // no valid stop
374   {
375     return false;
376   }
377
378   Property::Value* spread = propertyMap.Find( Toolkit::GradientVisual::Property::SPREAD_METHOD, SPREAD_METHOD_NAME );
379   // The default spread method is PAD. Only need to set new spread if it's anything else.
380   if( spread )
381   {
382     Toolkit::GradientVisual::SpreadMethod::Type spreadMethod = Toolkit::GradientVisual::SpreadMethod::PAD;
383     if( Scripting::GetEnumerationProperty( *spread, SPREAD_METHOD_TABLE, SPREAD_METHOD_TABLE_COUNT, spreadMethod ) );
384     {
385       mGradient->SetSpreadMethod( spreadMethod );
386     }
387   }
388
389   return true;
390 }
391
392 void GradientVisual::GetStopOffsets(const Property::Value* value, Vector<float>& stopOffsets)
393 {
394
395   if ( value ) // Only check valve type if a valid Property has been passed in
396   {
397     switch ( value->GetType() )
398     {
399       case Property::VECTOR2:
400       {
401         Vector2 offset2;
402         value->Get( offset2 );
403         stopOffsets.PushBack( offset2.x );
404         stopOffsets.PushBack( offset2.y );
405         break;
406       }
407       case Property::VECTOR3:
408       {
409         Vector3 offset3;
410         value->Get( offset3 );
411         stopOffsets.PushBack( offset3.x );
412         stopOffsets.PushBack( offset3.y );
413         stopOffsets.PushBack( offset3.z );
414         break;
415       }
416       case Property::VECTOR4:
417       {
418         Vector4 offset4;
419         value->Get( offset4 );
420         stopOffsets.PushBack( offset4.x );
421         stopOffsets.PushBack( offset4.y );
422         stopOffsets.PushBack( offset4.z );
423         stopOffsets.PushBack( offset4.w );
424         break;
425       }
426       case Property::ARRAY:
427       {
428         Property::Array* offsetArray = value->GetArray();
429         if( offsetArray )
430         {
431           unsigned int numStop = offsetArray->Count();
432           float offset;
433           for( unsigned int i=0; i<numStop; i++ )
434           {
435             if( offsetArray->GetElementAt(i).Get(offset) )
436             {
437               stopOffsets.PushBack( offset );
438             }
439           }
440         }
441         break;
442       }
443       default:
444       {
445         DALI_LOG_WARNING("GetStopOffsets passed unsupported Property Map\n");
446         // Unsupported Type
447       }
448     }
449   }
450
451   if ( stopOffsets.Empty() )
452   {
453     // Set default offset if none set by Property system, need a minimum and maximum
454     stopOffsets.PushBack( DEFAULT_OFFSET_MINIMUM );
455     stopOffsets.PushBack( DEFAULT_OFFSET_MAXIMUM );
456   }
457 }
458
459 } // namespace Internal
460
461 } // namespace Toolkit
462
463 } // namespace Dali