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 <dali-toolkit/devel-api/focus-manager/keyinput-focus-manager.h>
  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 <vector>
  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    * @brief Constructor.
  63    * @param[in]  application A reference to the Application class.
  64    */
  65   ContactCardController(Application& application)
  66   : mApplication(application)
  67   {
  68     // Connect to the Application's Init signal
  69     mApplication.InitSignal().Connect(this, &ContactCardController::Create);
  70   }
  71
  72 private:
  73   /**
  74    * @brief Called to initialise the application content
  75    * @param[in] application A reference to the Application class.
  76    */
  77   void Create(Application& application)
  78   {
  79     // Set the window background color and connect to the window's key signal to allow Back and Escape to exit.
  80     Window window = application.GetWindow();
  81     window.SetBackgroundColor(WINDOW_COLOR);
  82     window.KeyEventSignal().Connect(this, &ContactCardController::OnKeyEvent);
  83
  84     // Add all the contacts to the layouter
  85     for(size_t i = 0; i < ContactData::TABLE_SIZE; ++i)
  86     {
  87       mContactCardLayouter.AddContact(window, ContactData::TABLE[i].name, ContactData::TABLE[i].address, ContactData::TABLE[i].imagePath);
  88     }
  89   }
  90
  91   /**
  92    * @brief Called when any key event is received
  93    *
  94    * Will use this to quit the application if Back or the Escape key is received
  95    * @param[in] event The key event information
  96    */
  97   void OnKeyEvent(const KeyEvent& event)
  98   {
  99     if(event.GetState() == KeyEvent::DOWN)
 100     {
 101       KeyInputFocusManager keyInputFocusManager = KeyInputFocusManager::Get();
 102       if(!keyInputFocusManager.GetCurrentFocusControl()) // Don't quit if a control has focus
 103       {
 104         if(IsKey(event, Dali::DALI_KEY_ESCAPE) || IsKey(event, Dali::DALI_KEY_BACK))
 105         {
 106           mApplication.Quit();
 107         }
 108       }
 109     }
 110   }
 111
 112   Application&        mApplication;         ///< Reference to the application class.
 113   ContactCardLayouter mContactCardLayouter; ///< The contact card layouter.
 114 };
 115
 116 int DALI_EXPORT_API main(int argc, char** argv)
 117 {
 118   Application           application = Application::New(&argc, &argv, THEME_PATH);
 119   ContactCardController contactCardController(application);
 120   application.MainLoop();
 121   return 0;
 122 }