For physically correct lighting, set this to 2. Creates a new PointLight.
hexadecimal color of the light. Default is 0xffffff (white).
numeric value of the light's strength/intensity. Default is 1.
Maximum range of the light. Default is 0 (no limit).
The amount the light dims along the distance of the light. Default is 1.
Creates a new Light. Note that this is not intended to be called directly (use one of derived classes instead).
numeric value of the light's strength/intensity. Default is 1.
The constructor takes no arguments.
Creates eventDispatcher object. It needs to be call with '.call' to add the functionality to an object.
The default setting for .matrixAutoUpdate for newly created Object3Ds.
The default .up direction for objects, also used as the default position for DirectionalLight, HemisphereLight and Spotlight (which creates lights shining from the top down). Set to ( 0, 1, 0 ) by default.
Array with object's animation clips.
Whether the object gets rendered into shadow map. Default is false.
Array with object's children. See Group for info on manually grouping objects.
Color of the light. Defaults to a new Color set to white, if not passed in the constructor.
Custom depth material to be used when rendering to the depth map. Can only be used in context of meshes. When shadow-casting with a DirectionalLight or SpotLight, if you are modifying vertex positions in the vertex shader you must specify a customDepthMaterial for proper shadows. Default is undefined.
Same as .customDepthMaterial, but used with PointLight. Default is undefined.
The amount the light dims along the distance of the light In physically correct mode, decay = 2 leads to physically realistic light falloff. Default is 1.
Default mode - When distance is zero, light does not attenuate. When distance is non-zero, light will attenuate linearly from maximum intensity at the light's position down to zero at this distance from the light. Physically correct mode - When distance is zero, light will attenuate according to inverse-square law to infinite distance. When distance is non-zero, light will attenuate according to inverse-square law until near the distance cutoff, where it will then attenuate quickly and smoothly to 0. Inherently, cutoffs are not physically correct. Default is 0.0.
When this is set, it checks every frame if the object is in the frustum of the camera before rendering the object. If set to false the object gets rendered every frame even if it is not in the frustum of the camera. Default is true.
The BufferGeometry
Unique number for this object instance.
The light's intensity. Default is 1. In physically correct mode, intensity is the luminous intensity of the light measured in candela (cd). Changing the intensity will also change the light's power.
Used to check whether this or derived classes are Object3Ds. Default is true. You should not change this, as it is used internally for optimisation.
The Material
The local transform matrix.
When this is set, it calculates the matrix of position, (rotation or quaternion) and scale every frame and also recalculates the matrixWorld property. Default is Object3D.DefaultMatrixAutoUpdate (true).
The global transform of the object. If the Object3D has no parent, then it's identical to the local transform .matrix.
When this is set, it calculates the matrixWorld in that frame and resets this property to false. Default is false.
This is passed to the shader and used to calculate the position of the object.
Optional name of the object (doesn't need to be unique). Default is an empty string.
This is passed to the shader and used to calculate lighting for the object. It is the transpose of the inverse of the upper left 3x3 sub-matrix of this object's modelViewMatrix. The reason for this special matrix is that simply using the modelViewMatrix could result in a non-unit length of normals (on scaling) or in a non-perpendicular direction (on non-uniform scaling). On the other hand the translation part of the modelViewMatrix is not relevant for the calculation of normals. Thus a Matrix3 is sufficient.
Object's parent in the scene graph. An object can have at most one parent.
A Vector3 representing the object's local position. Default is (0, 0, 0).
The light's power. In physically correct mode, power is the luminous power of the light measured in lumens (lm). Changing the power will also change the light's intensity.
Object's local rotation as a Quaternion.
Whether the material receives shadows. Default is false.
This value allows the default rendering order of scene graph objects to be overridden although opaque and transparent objects remain sorted independently. When this property is set for an instance of Group, all descendants objects will be sorted and rendered together. Sorting is from lowest to highest renderOrder. Default value is 0.
Object's local rotation (see Euler angles), in radians.
The object's local scale. Default is Vector3( 1, 1, 1 ).
A PointLightShadow used to calculate shadows for this light. The lightShadow's camera is set to a PerspectiveCamera with fov of 90, aspect of 1, near clipping plane at 0.5 and far clipping plane at 500.
This is used by the .lookAt method, for example, to determine the orientation of the result. Default is Object3D.DefaultUp - that is, ( 0, 1, 0 ).
An object that can be used to store custom data about the Object3D. It should not hold references to functions as these will not be cloned.
UUID of this object instance. This gets automatically assigned, so this shouldn't be edited.
Object gets rendered if true. Default is true.
Adds object as child of this object. An arbitrary number of objects may be added. Any current parent on an object passed in here will be removed, since an object can have at most one parent. See Group for info on manually grouping objects.
Adds a listener to an event type.
The type of event to listen to.
The that gets called when the event is fired.
Applies the rotation represented by the quaternion to the object.
Adds object as a child of this, while maintaining the object's world transform. Note: This method does not support scene graphs having non-uniformly-scaled nodes(s).
Removes all child objects.
if true, descendants of the object are also cloned. Default is true.
Returns a clone of this object and optionally all descendants.
Copy the given object into this object. Note: event listeners and user-defined callbacks (.onAfterRender and .onBeforeRender) are not copied.
if true, descendants of the object are also copied. Default is true.
Fire an event type.
Abstract dispose method for lights; implemented by subclasses that have disposable resources.
Note that ids are assigned in chronological order: 1, 2, 3, ..., incrementing by one for each new object.
Unique number of the object instance Searches through an object and its children, starting with the object itself, and returns the first with a matching id.
Searches through an object and its children, starting with the object itself, and returns the first with a matching name. Note that for most objects the name is an empty string by default. You will have to set it manually to make use of this method.
String to match to the children's Object3D.name property.
The result will be copied into this Quaternion.
Returns a quaternion representing the rotation of the object in world space.
Checks if listener is added to an event type.
The type of event to listen to.
The that gets called when the event is fired.
Optionally, the .x, .y and .z components of the world space position. Rotates the object to face a point in world space. This method does not support objects having non-uniformly-scaled parent(s).
A vector representing a position in world space.
An optional callback that is executed immediately after a 3D object is rendered. This function is called with the following parameters: renderer, scene, camera, geometry, material, group. Please notice that this callback is only executed for renderable 3D objects. Meaning 3D objects which define their visual appearance with geometries and materials like instances of Mesh, Line, Points or Sprite. Instances of Object3D, Group or Bone are not renderable and thus this callback is not executed for such objects.
An optional callback that is executed immediately before a 3D object is rendered. This function is called with the following parameters: renderer, scene, camera, geometry, material, group. Please notice that this callback is only executed for renderable 3D objects. Meaning 3D objects which define their visual appearance with geometries and materials like instances of Mesh, Line, Points or Sprite. Instances of Object3D, Group or Bone are not renderable and thus this callback is not executed for such objects.
Removes object as child of this object. An arbitrary number of objects may be removed.
Removes a listener from an event type.
The type of the listener that gets removed.
The listener that gets removed.
Removes this object from its current parent.
Rotate an object along an axis in object space. The axis is assumed to be normalized.
Rotate an object along an axis in world space. The axis is assumed to be normalized. Method Assumes no rotated parent.
Rotates the object around x axis in local space.
The angle to rotate in radians.
Rotates the object around y axis in local space.
The angle to rotate in radians.
Rotates the object around z axis in local space.
The angle to rotate in radians.
Calls setFromAxisAngle( axis, angle ) on the .quaternion.
Calls setRotationFromEuler( euler) on the .quaternion.
Calls setFromRotationMatrix( m) on the .quaternion. Note that this assumes that the upper 3x3 of m is a pure rotation matrix (i.e, unscaled).
Copy the given quaternion into .quaternion.
normalized Quaternion
Translate an object by distance along an axis in object space. The axis is assumed to be normalized.
Translates object along x axis in object space by distance units.
Distance.
Translates object along y axis in object space by distance units.
Distance.
Translates object along z axis in object space by distance units.
Distance.
Like traverse, but the callback will only be executed for visible objects. Descendants of invisible objects are not traversed. Note: Modifying the scene graph inside the callback is discouraged.
A function with as first argument an object3D object.
Updates the local transform.
Updates the global transform of the object and its descendants.
Updates the global transform of the object.
recursively updates global transform of ancestors.
recursively updates global transform of descendants.
Generated using TypeDoc
A light that gets emitted from a single point in all directions. A common use case for this is to replicate the light emitted from a bare lightbulb. This light can cast shadows - see PointLightShadow page for details.
See the ngx3js docs page for details. See the ngx light page for a live demo.
Examples
lights / pointlights | effects / anaglyph | geometry / text | lensflares
Code Example
Ngx3Js Code Example