Class SceneNode

Class SceneNode#

Inheritance Relationships#

Base Type#

Derived Types#

Class Documentation#

class SceneNode : public Karana::Core::BaseWithVars#

Base for objects with a transform i n the scene hierarchy.

See Scene layer for more discussion on the scene layer.

Subclassed by Karana::Scene::CollisionSceneNode, Karana::Scene::GraphicalSceneNode, Karana::Scene::ProxySceneNode, Karana::Scene::ScenePart

Public Functions

virtual ~SceneNode()#

Destructor.

SceneNode(const SceneNode&) = delete#
SceneNode &operator=(const SceneNode&) = delete#
inline virtual bool isScenePart() const#

Return true if this scene node is a scene part.

Returns:

true if the node is a scene part

virtual void setTranslation(const Karana::Math::Vec3 &translation)#

Set position of the node relative to its parent.

Parameters:

translation – - The relative translation

virtual void setUnitQuaternion(const Karana::Math::UnitQuaternion &quaternion)#

Set rotation of the node relative to its parent.

Parameters:

quaternion – - The relative rotation as a unit quaternion

double getScale() const#

Get uniform scale of the node relative to its parent.

Returns:

The relative uniform scale

virtual void setScale(double scale)#

Set uniform of the node relative to its parent.

Parameters:

scale – - The relative uniform scale

const Karana::Math::SimTran &getSimTransform() const#

Get similarity transform of the node relative to its parent.

Returns:

The similarity transform

virtual void setSimTransform(const Karana::Math::SimTran &transform)#

Set similarity transform of the node relative to its parent.

Parameters:

transform – - The similarity transform

const Karana::Math::SimTran &getWorldSimTransform() const#

Get similarity transform of the node relative to the scene’s root.

Returns:

The similarity transform

const Karana::Core::ks_ptr<SceneNode> &parent() const#

Get the parent node.

Returns:

The parent node or nullptr

virtual void attachTo(const Karana::Core::ks_ptr<SceneNode> &parent, bool maintain_world_sim_transform = false)#

Attach to a parent node.

Parameters:

  • parent – - The parent node

  • maintain_world_sim_transform – - If true, update the node’s relative transform so that its overall world transform doesn’t change after attaching it to the parent

virtual void detach(bool maintain_world_sim_transform = false)#

Detach the node from its parent.

Parameters:

maintain_world_sim_transform – - If true, update the node’s relative transform so that its overall world transform doesn’t change after detaching

const std::vector<kc::ks_ptr<SceneNode>> &childrenNodes() const#

Get the node’s children nodes.

Returns:

A list of the node’s children nodes

Karana::Core::RegistryList<SceneNode> children() const#

Get the node’s children registry.

Returns:

A list of the node’s children registry

virtual void setVisible(bool visible)#

Set whether the object is visible.

Parameters:

visible – - The visibility flag

bool getVisible() const#

Get whether the object is visible.

Returns:

The visibility flag

Karana::Core::ks_ptr<SceneNode> getManager() const#

Get a SceneNode managing this one.

Returns:

The managing scene node or nullptr

void setManager(const Karana::Core::ks_ptr<SceneNode> &manager)#

Assign a managing scene node.

Parameters:

manager – The scene node managing this one (nullable)

Public Static Functions

static Karana::Core::ks_ptr<SceneNode> create(std::string_view name, const Karana::Core::ks_ptr<Scene> &scene)#

Create a scene node.

Parameters:

  • name – - Name of the node.

  • scene – - The scene to add the node to.

Returns:

Shared pointer to a scene node

Protected Functions

SceneNode(std::string_view name, const Karana::Core::ks_ptr<Scene> &scene)#

SceneNode Constructor.

Parameters:

  • name – - Name of the node.

  • scene – - The scene to add the node to.

virtual Karana::Core::ks_ptr<Karana::Core::BaseVars> _getVars() const override#

Create the vars for this object.

Returns:

The vars for this object.

virtual void _computeWorldTransform(Karana::Math::SimTran &transform) const#

Helper to compute the node’s world transform.

Parameters:

transform – - The new relative transform

void _discard(Karana::Core::ks_ptr<Base> &base) override#

Discard the provided SceneNode.

Parameters:

base – - Base pointer to the SceneNode to discard.

Protected Attributes

Karana::Core::ks_ptr<Karana::Core::DataCache<Karana::Math::SimTran>> _world_sim_transform_cache#

Cache to lazily recompute the world transform as needed.

std::weak_ptr<SceneNode> _manager#

The SceneNode managing this one (if any).

std::weak_ptr<Scene> _scene#

Weak pointer to the scene. Used for discard.

Contents