examples/contact-cards/contact-cards-example.cpp

   1 /*
   2  * Copyright (c) 2020 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 // EXTERNAL INCLUDES
  19 #include <vector>
  20 #include <dali/public-api/adaptor-framework/application.h>
  21 #include <dali/public-api/adaptor-framework/key.h>
  22 #include <dali/public-api/events/key-event.h>
  23 #include <dali-toolkit/devel-api/focus-manager/keyinput-focus-manager.h>
  24
  25 // INTERNAL INCLUDES
  26 #include "contact-card-layouter.h"
  27 #include "contact-data.h"
  28
  29 using namespace Dali;
  30 using namespace Dali::Toolkit;
  31
  32 namespace
  33 {
  34 const Vector4 WINDOW_COLOR( 211.0f / 255.0f, 211.0f / 255.0f, 211.0f / 255.0f, 1.0f ); ///< The color of the window
  35 const char * const THEME_PATH( DEMO_STYLE_DIR "contact-cards-example-theme.json" ); ///< The theme used for this example
  36 } // unnamed namespace
  37
  38 /**
  39  * @brief Creates several contact cards that animate between a folded and unfolded state.
  40  *
  41  * This demonstrates how different animations can start and stop at different times within the same Animation function.
  42  * Additionally, this also shows how to morph between two different geometries.
  43  *
  44  * ContactCardLayouter: This class is used to lay out the different contact cards on the screen.
  45  *                      This takes window size into account but does not support relayouting.
  46  * ContactCard: This class represents each contact card on the screen.
  47  *              Two animations are set up in this class which animate several properties with multiple start and stop times.
  48  *              An overview of the two animations can be found in contact-card.cpp.
  49  * ContactCardLayoutInfo: This is a structure to store common layout information and is created by the ContactCardLayouter and used by each ContactCard.
  50  * ContactData: This namespace contains a table which has the contact information we use to populate the contact cards.
  51  * ClippedImage: This namespace provides a helper function which creates an ImageView which is added to a control that has clipping.
  52  *               This clipping comes in the form of a Circle or Quad.
  53  *               The Vertex shader mixes in the Circle and Quad geometry depending on the value of a uniform float.
  54  *               Animating this float between CIRCLE_GEOMETRY and QUAD_GEOMETRY is what enables the morphing between the two geometries.
  55  * MaskedImage: This namespace provides a helper function which creates an ImageView with a mask that matches the Circle geometry provided by ClippedImage.
  56  *              Using a mask yields much better quality than when using an image with a circle geometry, so this is ONLY used when the contact card is folded.
  57  */
  58 class ContactCardController : public ConnectionTracker // Inherit from ConnectionTracker so that our signals can be automatically disconnected upon our destruction.
  59 {
  60 public:
  61
  62   /**
  63    * @brief Constructor.
  64    * @param[in]  application A reference to the Application class.
  65    */
  66   ContactCardController( Application& application )
  67   : mApplication( application )
  68   {
  69     // Connect to the Application's Init signal
  70     mApplication.InitSignal().Connect( this, &ContactCardController::Create );
  71   }
  72
  73 private:
  74
  75   /**
  76    * @brief Called to initialise the application content
  77    * @param[in] application A reference to the Application class.
  78    */
  79   void Create( Application& application )
  80   {
  81     // Set the window background color and connect to the window's key signal to allow Back and Escape to exit.
  82     Window window = application.GetWindow();
  83     window.SetBackgroundColor( WINDOW_COLOR );
  84     window.KeyEventSignal().Connect( this, &ContactCardController::OnKeyEvent );
  85
  86     // Add all the contacts to the layouter
  87     for( size_t i = 0; i < ContactData::TABLE_SIZE; ++i )
  88     {
  89       mContactCardLayouter.AddContact( window, ContactData::TABLE[ i ].name, ContactData::TABLE[ i ].address, ContactData::TABLE[ i ].imagePath );
  90     }
  91   }
  92
  93   /**
  94    * @brief Called when any key event is received
  95    *
  96    * Will use this to quit the application if Back or the Escape key is received
  97    * @param[in] event The key event information
  98    */
  99   void OnKeyEvent( const KeyEvent& event )
 100   {
 101     if( event.state == KeyEvent::Down )
 102     {
 103       KeyInputFocusManager keyInputFocusManager = KeyInputFocusManager::Get();
 104       if( ! keyInputFocusManager.GetCurrentFocusControl() ) // Don't quit if a control has focus
 105       {
 106         if ( IsKey( event, Dali::DALI_KEY_ESCAPE ) || IsKey( event, Dali::DALI_KEY_BACK ) )
 107         {
 108           mApplication.Quit();
 109         }
 110       }
 111     }
 112   }
 113
 114   Application& mApplication; ///< Reference to the application class.
 115   ContactCardLayouter mContactCardLayouter; ///< The contact card layouter.
 116 };
 117
 118 int DALI_EXPORT_API main( int argc, char **argv )
 119 {
 120   Application application = Application::New( &argc, &argv, THEME_PATH );
 121   ContactCardController contactCardController( application );
 122   application.MainLoop();
 123   return 0;
 124 }