API Docs for:
Show:

LS.SceneNode Class

Defined in: ../src/sceneNode.js:3
Module: LS

The SceneNode class represents and object in the scene Is the base class for all objects in the scene as meshes, lights, cameras, and so

Constructor

LS.SceneNode

(
  • name
)

Defined in ../src/sceneNode.js:3

Parameters:

  • name String

    the name for this node (otherwise a random one is computed)

Methods

clone

() Object

Defined in ../src/sceneNode.js:948

remember clones this node and returns the new copy (you need to add it to the scene to see it)

Returns:

Object:

returns a cloned version of this node

configure

(
  • info
)

Defined in ../src/sceneNode.js:970

Configure this node from an object containing the info

Parameters:

  • info Object

    the object with all the info (comes from the serialize method)

destroy

()

Defined in ../src/sceneNode.js:305

Destroys this node

getLocator

(
  • property_name
)
String

Defined in ../src/sceneNode.js:320

Returns the locator string of this node

Parameters:

  • property_name String

    [optional] you can pass the name of a property in this node to get the locator of that one

Returns:

String:

the locator string of this node

getPropertyInfo

(
  • locator
)
Object

Defined in ../src/sceneNode.js:333

Returns and object with info about a property given a locator

Parameters:

  • locator String

Returns:

Object:

object with { node, target, name, value and type }

getPropertyInfoFromPath

(
  • path
)
Object

Defined in ../src/sceneNode.js:345

Returns and object with info about a property given a locator in path format

Parameters:

  • path Array

    a locator in path format (split by /)

Returns:

Object:

object with { node, target, name, value and type }

getPropertyValue

(
  • locaator
)

Defined in ../src/sceneNode.js:508

Returns the value of a property given a locator in string format

Parameters:

  • locaator String

Returns:

:

the value of that property

getPropertyValueFromPath

(
  • locator
)

Defined in ../src/sceneNode.js:520

Returns the value of a property given a locator in path format

Parameters:

  • locator Array

    in path format (array)

Returns:

:

the value of that property

getResources

(
  • res
  • include_children
)
Object

Defined in ../src/sceneNode.js:727

Returns all the resources used by this node and its components (you can include the resources from the children too)

Parameters:

  • res Object

    object where to store the resources used (in "res_name":LS.TYPE format)

  • include_children Boolean

    if you want to add also the resources used by the children nodes

Returns:

Object:

the same object passed is returned

insidePrefab

() Object

Defined in ../src/sceneNode.js:931

Returns the root node of the prefab incase it is inside a prefab, otherwise null

Returns:

Object:

returns the node where the prefab starts

isInLayer

(
  • num
)
Boolean

Defined in ../src/sceneNode.js:906

checks if this node is in the given layer

Parameters:

  • num Number

    layer number

Returns:

Boolean:

true if belongs to this layer

reloadFromPrefab

()

Defined in ../src/sceneNode.js:862

Apply prefab info (skipping the root components) to node, so all children will be removed and components lost and overwritten It is called from prefab.applyToNodes when a prefab is loaded in memory

serialize

(
  • ignore_prefab
)
Object

Defined in ../src/sceneNode.js:1119

Serializes this node by creating an object with all the info it contains info about the components too

Parameters:

  • ignore_prefab Bool

    serializing wont returns children if it is a prefab, if you set this to ignore_prefab it will return all the info

Returns:

Object:

returns the object with the info

setLayer

(
  • num
  • value
)

Defined in ../src/sceneNode.js:892

Assigns this node to one layer

Parameters:

  • num Number

    layer number

  • value Boolean

setMesh

(
  • mesh_name
  • submesh_id
)

Defined in ../src/sceneNode.js:795

Simple way to assign a mesh to a node, it created a MeshRenderer component or reuses and existing one and assigns the mesh

Parameters:

  • mesh_name String

    the name of the mesh (path to the file)

  • submesh_id Number

    if you want to assign a submesh

setName

(
  • new_name
)
Object

Defined in ../src/sceneNode.js:91

changes the node name

Parameters:

  • new_name String

    the new name

Returns:

Object:

returns true if the name changed

setPropertyValue

(
  • locator
  • value
)

Defined in ../src/sceneNode.js:622

assigns a value to a property given the locator for that property

Parameters:

  • locator String
  • value

setPropertyValueFromPath

(
  • path
  • value
  • [optional]
)

Defined in ../src/sceneNode.js:634

given a locator in path mode (array) and a value, it searches for the corresponding value and applies it

Parameters:

  • path Array
  • value
  • [optional] Number optional

    offset used to skip the firsst positions in the array

Properties

className

String

Defined in ../src/sceneNode.js:278

Events

name_changed

Defined in ../src/sceneNode.js:260

Node changed name

Event Payload:

  • new_name String

transformChanged

Defined in ../src/sceneNode.js:49