Merge "Reduce ImageActor & RenderableActor APIs" into tizen
[platform/core/uifw/dali-toolkit.git] / docs / content / shared-javascript-and-cpp-documentation / scene-graph.md
1 # Scene Graph
2 ## What is a scene graph?
3 From wikipedia...
4   
5 A scene graph is a collection of nodes in a graph or tree structure.
6 A node may have many children but often only a single parent,
7 with the effect of a parent applied to all its child nodes;
8 an operation performed on a group automatically propagates
9 its effect to all of its members. In many programs, associating
10 a geometrical transformation matrix (see also transformation and matrix)
11 at each group level and concatenating such matrices together is an
12 efficient and natural way to process such operations. A common feature,
13 for instance, is the ability to group related shapes/objects into a
14 compound object that can then be moved, transformed, selected,
15 etc. as easily as a single object.
16
17  ### How does this relate to the Dali public API?
18
19  Actors are effectively nodes that receive input (touch events) and act as a
20  container for draw-able elements (which are also nodes) and other actors.