From: Yoonsang Lee <ysang114.lee@samsung.com>
Date: Thu, 16 Jul 2015 06:02:45 +0000 (+0900)
Subject: [DALi][DOC-213] Update Actors
X-Git-Tag: tizen_3.0/TD_SYNC/20161201~702^2
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=e72b991e4e7b3341a8d8960df66cd96e22515918;p=sdk%2Fonline-doc.git

[DALi][DOC-213] Update Actors

Signed-off-by: Yoonsang Lee <ysang114.lee@samsung.com>
Change-Id: I0c483e98b29b3d4499bfaa09eb21d234ddbd5c4c
---

diff --git a/org.tizen.ui.guides/html/native/dali/actors_n.htm b/org.tizen.ui.guides/html/native/dali/actors_n.htm
index edd92e0..8d8f930 100755
--- a/org.tizen.ui.guides/html/native/dali/actors_n.htm
+++ b/org.tizen.ui.guides/html/native/dali/actors_n.htm
@@ -55,13 +55,13 @@ Actor has several concrete types as follows:
 <ul>
 <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>
 <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>
-<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>
+<li><strong>Camera Actor</strong> determines which view of the whole virtual 3D world is rendered in the screen. By default, it is best suited for 2D applications so you don't need to care about it in this case. 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>
 <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>
 </ul>
 
 <h2 id="actors" name="actors">Actors and Stage</h2>
 
-<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>
+<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, which means an actor inherits a position relative to its parent, and can be moved in relation to this point.</p>
 
 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.
 
@@ -75,32 +75,39 @@ Stage::GetCurrent().Add(actor);
 <h2 id="position" name="position">Positioning Actors</h2>
 <p>An actor inherits its parent&#39;s position. The relative position between the actor &amp; parent is determined by the following properties:</p>
 <ul>
-<li>Parent origin
+<li><strong>Parent origin</strong>
 <p>This Vector3 property defines a point within the parent actor&#39;s area.</p>
 
 <p class="figure">Figure: Parent origin</p>  
 	<p align="center"><img alt="Parent origin" src="../../images/parent_origin.png"/></p> 
  
-<p>The default is top-left, which can be visualized in 2D as (0, 0), but is actually Vector3 (0, 0, 0.5) in the 3D DALi world. The actor position is relative to this point.</p></li>
-<li>Anchor point
+<p>The default is top-left (<span style="font-family: Courier New,Courier,monospace;">Dali::ParentOrigin::TOP_LEFT</span>), which can be visualized in 2D as (0, 0), but is actually Vector3 (0, 0, 0.5) in the 3D DALi world. The actor position is relative to this point.</p>
+<p>Please see API reference for <span style="font-family: Courier New,Courier,monospace;">Dali::Actor::SetParentOrigin()</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.</p>
+</li>
+
+<li><strong>Anchor point</strong>
 <p>This Vector3 property defines a point within the child actor area.</p>
 
 <p class="figure">Figure: Anchor point</p>  
 	<p align="center"><img alt="Anchor point" src="../../images/anchor_point.png"/></p> 
  
-<p>The default is center, which can be visualized in 2D as (0.5, 0.5), but is actually Vector3 (0.5, 0.5, 0.5) in the 3D DALi world. The actor position is also relative to this point.</p></li>
+<p>The default is center (<span style="font-family: Courier New,Courier,monospace;">Dali::AnchorPoint::CENTER</span>), which can be visualized in 2D as (0.5, 0.5), but is actually Vector3 (0.5, 0.5, 0.5) in the 3D DALi world. The actor position is also relative to this point.</p>
+<p>Please see API reference for <span style="font-family: Courier New,Courier,monospace;">Dali::Actor::SetAnchorPoint()</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.</p>
+</li>
 
-<li>Position
+<li><strong>Position</strong>
 <p>This is the position vector between the parent origin and anchor point.</p>
 
 <p class="figure">Figure: Position</p>  
 	<p align="center"><img alt="Position" src="../../images/actor_position.png"/></p> 
  
-<p>By default, an actor&#39;s position is the distance between its center and the top-left corner of its parent.</p>
+<p>Therefore by default, an actor&#39;s position indicates the vector to its center from the top-left corner of its parent.</p>
 
-<p>An actor added directly to the stage with position (X = stageWidth*0.5, Y = stageHeight*0.5) appears in the center of the screen. Likewise, an actor with the position (X = actorWidth*0.5, Y = actorWidth*0.5) appears at the top-left corner of the screen.</p>
-
-<p>Since DALi is a 3D toolkit, this behavior is the result of a default perspective camera setup.</p> 
+<p>For example (with the default camera),</p>
+<ul>
+	<li>An actor added directly to the stage with position (X = stageWidth*0.5, Y = stageHeight*0.5) appears in the center of the screen.</li>
+	<li>An actor with the position (X = actorWidth*0.5, Y = actorWidth*0.5) appears at the top-left corner of the screen.</li>
+</ul>
 
 </li>
 </ul>