<ul class="toc">\r
<li><a href="#types">Types of Actors</a></li>\r
<li><a href="#actors">Actors and Stage</a></li>\r
- <li><a href="#coordinate">Coordinate System</a></li>\r
<li><a href="#position">Positioning Actors</a></li>\r
<li><a href="#event">Event Handling for Actors</a></li>\r
</ul>\r
<ul>\r
<li><strong>UI Components</strong> are used to organize the appearance of applications. Please see <a href="ui_components_n.htm">UI Components: Creating the Application Layout</a> for more details.</li>\r
<li><strong>Image Actor</strong> is used to display an image. Please see API reference for <span style="font-family: Courier New,Courier,monospace;">Dali::ImageActor</span> (in <a href="../../../../org.tizen.native.mobile.apireference/classDali_1_1ImageActor.html">mobile</a> and <a href="../../../../org.tizen.native.wearable.apireference/classDali_1_1ImageActor.html">wearable</a>) for more details.</li>\r
-<li><strong>Camera Actor</strong> determines which view of the entire scene DALi renders. By default, it looks at the xy plane from the positive z position for default unit 1 to be 1 pixel. A user usually doesn't need to change properties of Camera Actor for 2D applications. Please see API reference for <span style="font-family: Courier New,Courier,monospace;">Dali::CameraActor</span> (in <a href="../../../../org.tizen.native.mobile.apireference/classDali_1_1CameraActor.html">mobile</a> and <a href="../../../../org.tizen.native.wearable.apireference/classDali_1_1CameraActor.html">wearable</a>) for more details.</li>\r
+<li><strong>Camera Actor</strong> by default looks at the xy plane from the positive z position for default unit 1 to be 1 pixel. You don't need to change properties of Camera Actor for 2D applications. Please see API reference for <span style="font-family: Courier New,Courier,monospace;">Dali::CameraActor</span> (in <a href="../../../../org.tizen.native.mobile.apireference/classDali_1_1CameraActor.html">mobile</a> and <a href="../../../../org.tizen.native.wearable.apireference/classDali_1_1CameraActor.html">wearable</a>) for more details.</li>\r
<li><strong>Layer</strong> provides a mechanism for overlaying groups of actors on top of each other. Please see API reference for <span style="font-family: Courier New,Courier,monospace;">Dali::Layer</span> (in <a href="../../../../org.tizen.native.mobile.apireference/classDali_1_1Layer.html">mobile</a> and <a href="../../../../org.tizen.native.wearable.apireference/classDali_1_1Layer.html">wearable</a>) for more details.</li>\r
</ul>\r
\r
<h2 id="actors" name="actors">Actors and Stage</h2>\r
\r
-<p>Stage is a top-level object that represents the entire scene or screen. It is used for displaying a hierarchy of actors managed by the <a href="http://en.wikipedia.org/wiki/Scene_graph" target="_blank">scene graph</a> structure. An actor inherits a position relative to its parent, and can be moved in relation to this point.</p>\r
+<p>Stage is a top-level object that represents the entire screen. It is used for displaying a hierarchy of actors managed by the <a href="http://en.wikipedia.org/wiki/Scene_graph" target="_blank">scene graph</a> structure. An actor inherits a position relative to its parent, and can be moved in relation to this point.</p>\r
+\r
+The stage instance is a singleton object (the only instance of its class during the lifetime of the program), so you can get it using a static function.\r
\r
<p>To display the contents of an actor, it must be added to a stage. The following example shows how to connect a new actor to the stage:</p>\r
\r
Stage::GetCurrent().Add(actor);\r
</pre>\r
\r
-<h2 id="coordinate" name="coordinate">Coordinate System</h2>\r
-\r
-<p>The stage has a 2D size that matches the size of the application window. The default unit 1 is 1 pixel with default camera.</p>\r
-\r
-<p>DALi uses a left-handed coordinate system with the origin at the top-left corner, with positive X to right, positive Y going downwards, and positive Z going outside the screen. This is convenient when creating 2D views.</p>\r
-\r
-<p class="figure">Figure: DALi coordinate system</p> \r
- <p align="center"><img alt="DALi coordinate system" src="../../images/actor_coordinates.png"/></p> \r
- \r
\r
<h2 id="position" name="position">Positioning Actors</h2>\r
<p>An actor inherits its parent's position. The relative position between the actor & parent is determined by the following properties:</p>\r
<h1>DALi Overview: Getting Started with DALi UI Programming</h1>\r
\r
<p>Dynamic Animation Library (DALi) internally defines a virtual 3D world (space) and maintains hierarchical objects in the 3D world. The hierarchical object tree is known as the <a href="http://en.wikipedia.org/wiki/Scene_graph" target="_blank">scene graph</a>. A node in the scene graph can have several children but often only a single parent, with the effect of a parent applied to all its child nodes; an operation performed on a group automatically propagates its effect to all of its members.</p>\r
-<p>There are various types of nodes, such as image, text, and 3D object.</p>\r
+<p>There are various types of nodes, such as image, text, and buttons.</p>\r
\r
<h2 id="dali" name="dali">DALi Fundamentals</h2>\r
\r
<p>Signal events are emitted when a certain action or event occurs. The application can connect using these signals. Standard C-style functions can be used to connect to these signals if no local data needs to be accessed, otherwise a class method can also be connected.</p>\r
<p>Applications can manually disconnect from signals when required. However, DALi also provides safe signal disconnection. This means that when the connecting object is deleted, the signal is automatically disconnected.</p>\r
\r
+<h3 id="coordinate" name="coordinate">Coordinate System</h3>\r
+\r
+<p>The stage has a 2D size that matches the size of the application window. The default unit 1 is 1 pixel with default camera.</p>\r
+\r
+<p>DALi uses a left-handed coordinate system with the origin at the top-left corner, with positive X to right, positive Y going downwards, and positive Z going outside the screen with default camera. This is convenient when creating 2D views.</p>\r
+\r
+<p class="figure">Figure: DALi coordinate system</p> \r
+ <p align="center"><img alt="DALi coordinate system" src="../../images/actor_coordinates.png"/></p> \r
+ \r
<h3>DALi Internal Structure</h3>\r
\r
<p>DALi consists of the following modules:</p>\r