Represents a spotlight. More...

#include <gz/rendering/Light.hh>

Public Member Functions
virtual	~SpotLight ()
	Destructor.

virtual math::Vector3d	Direction () const =0
	Get direction of the light.

virtual double	Falloff () const =0
	Get the falloff of the spotlight.

virtual math::Angle	InnerAngle () const =0
	Get the inner angle of the spotlight.

virtual math::Angle	OuterAngle () const =0
	Get the outer angle of the spotlight.

virtual void	SetDirection (const math::Vector3d &_dir)=0
	Set the direction of the light.

virtual void	SetDirection (double _x, double _y, double _z)=0
	Set the direction of the light.

virtual void	SetFalloff (double _falloff)=0
	Set the falloff of the spotlight.

virtual void	SetInnerAngle (const math::Angle &_angle)=0
	Set the inner angle of the spotlight.

virtual void	SetInnerAngle (double _radians)=0
	Set the inner angle of the spotlight.

virtual void	SetOuterAngle (const math::Angle &_angle)=0
	Set the outer angle of the spotlight.

virtual void	SetOuterAngle (double _radians)=0
	Set the outer angle of the spotlight.

Public Member Functions inherited from Light
virtual	~Light ()
	Destructor.

virtual double	AttenuationConstant () const =0
	Get the attenuation constant value.

virtual double	AttenuationLinear () const =0
	Get the attenuation linear value.

virtual double	AttenuationQuadratic () const =0
	Get the attenuation quadratic value.

virtual double	AttenuationRange () const =0
	Get the attenuation range.

virtual bool	CastShadows () const =0
	Determine if this light cast shadows.

virtual math::Color	DiffuseColor () const =0
	Get the diffuse color.

virtual double	Intensity () const =0
	Get the light intensity.

virtual void	SetAttenuationConstant (double _value)=0
	Set the attenuation constant value.

virtual void	SetAttenuationLinear (double _value)=0
	Set the attenuation linear value.

virtual void	SetAttenuationQuadratic (double _value)=0
	Set the attenuation quadratic value.

virtual void	SetAttenuationRange (double _range)=0
	Set the attenuation range.

virtual void	SetCastShadows (bool _castShadows)=0
	Specify if this light should cast shadows.

virtual void	SetDiffuseColor (const math::Color &_color)=0
	Set the diffuse color.

virtual void	SetDiffuseColor (double _r, double _g, double _b, double _a=1.0)=0
	Set the diffuse color.

virtual void	SetIntensity (double _intensity)=0
	Set the light intensity.

virtual void	SetSpecularColor (const math::Color &_color)=0
	Set the specular color.

virtual void	SetSpecularColor (double _r, double _g, double _b, double _a=1.0)=0
	Set the specular color.

virtual math::Color	SpecularColor () const =0
	Get the specular color.

Public Member Functions inherited from Node
virtual	~Node ()
	Destructor.

virtual void	AddChild (NodePtr _child)=0
	Add the given node to this node. If the given node is already a child, no work will be done.

virtual NodePtr	ChildById (unsigned int _id) const =0
	Get node with given ID. If no child exists with given ID, NULL will be returned.

virtual NodePtr	ChildByIndex (unsigned int _index) const =0
	Get node at given index. If no child exists at given index, NULL will be returned.

virtual NodePtr	ChildByName (const std::string &_name) const =0
	Get node with given name. If no child exists with given name, NULL will be returned.

virtual unsigned int	ChildCount () const =0
	Get number of child nodes.

virtual bool	HasChild (ConstNodePtr _child) const =0
	Determine if given node is an attached child.

virtual bool	HasChildId (unsigned int _id) const =0
	Determine if node with given ID is an attached child.

virtual bool	HasChildName (const std::string &_name) const =0
	Determine if node with given name is an attached child.

virtual bool	HasParent () const =0
	Determine if this Node is attached to another Node.

virtual bool	HasUserData (const std::string &_key) const =0
	Check if node has custom data.

virtual bool	InheritScale () const =0
	Determine if this node inherits scale from this parent.

virtual math::Pose3d	InitialLocalPose () const =0
	Get the initial local pose.

virtual math::Pose3d	LocalPose () const =0
	Get the local pose.

virtual math::Vector3d	LocalPosition () const =0
	Get the local position.

virtual math::Quaterniond	LocalRotation () const =0
	Get the local rotation.

virtual math::Vector3d	LocalScale () const =0
	Get the local scale.

virtual math::Vector3d	Origin () const =0
	Get position of origin.

virtual NodePtr	Parent () const =0
	Get the parent Node.

virtual NodePtr	RemoveChild (NodePtr _child)=0
	Remove (detach) the given node from this node. If the given node is not a child of this node, no work will be done.

virtual NodePtr	RemoveChildById (unsigned int _id)=0
	Remove (detach) the node with the given ID from this node. If the specified node is not a child of this node, no work will be done.

virtual NodePtr	RemoveChildByIndex (unsigned int _index)=0
	Remove (detach) the node at the given index from this node. If the specified node is not a child of this node, no work will be done.

virtual NodePtr	RemoveChildByName (const std::string &_name)=0
	Remove (detach) the node with the given name from this node. If the specified node is not a child of this node, no work will be done.

virtual void	RemoveChildren ()=0
	Remove all child nodes from this node This detaches all the child nodes but does not destroy them.

virtual void	RemoveParent ()=0
	Detach this Node from its parent. If this Node does not have a parent, no work will be done.

virtual void	Scale (const math::Vector3d &_scale)=0
	Scale the current scale by the given scalars.

virtual void	Scale (double _scale)=0
	Scale the current scale by the given scalar. The given scalar will be assigned to the x, y, and z coordinates.

virtual void	Scale (double _x, double _y, double _z)=0
	Scale the current scale by the given scalars.

virtual void	SetInheritScale (bool _inherit)=0
	Specify if this node inherits scale from its parent.

virtual void	SetLocalPose (const math::Pose3d &_pose)=0
	Set the local pose.

virtual void	SetLocalPosition (const math::Vector3d &_position)=0
	Set the local position.

virtual void	SetLocalPosition (double _x, double _y, double _z)=0
	Set the local position.

virtual void	SetLocalRotation (const math::Quaterniond &_rotation)=0
	Set the local rotation.

virtual void	SetLocalRotation (double _r, double _p, double _y)=0
	Set the local rotation.

virtual void	SetLocalRotation (double _w, double _x, double _y, double _z)=0
	Set the local rotation.

virtual void	SetLocalScale (const math::Vector3d &_scale)=0
	Set the local scale.

virtual void	SetLocalScale (double _scale)=0
	Set the local scale. The given scale will be assigned to the x, y, and z coordinates.

virtual void	SetLocalScale (double _x, double _y, double _z)=0
	Set the local scale.

virtual void	SetOrigin (const math::Vector3d &_origin)=0
	Set position of origin. The position should be relative to the original origin of the geometry.

virtual void	SetOrigin (double _x, double _y, double _z)=0
	Set position of origin. The position should be relative to the original origin of the geometry.

virtual void	SetUserData (const std::string &_key, Variant _value)=0
	Store any custom data associated with this node.

virtual void	SetWorldPose (const math::Pose3d &_pose)=0
	Set the world pose.

virtual void	SetWorldPosition (const math::Vector3d &_position)=0
	Set the world position.

virtual void	SetWorldPosition (double _x, double _y, double _z)=0
	Set the world position.

virtual void	SetWorldRotation (const math::Quaterniond &_rotation)=0
	Set the world rotation.

virtual void	SetWorldRotation (double _r, double _p, double _y)=0
	Set the world rotation.

virtual void	SetWorldRotation (double _w, double _x, double _y, double _z)=0
	Set the world rotation.

virtual void	SetWorldScale (const math::Vector3d &_scale)=0
	Set the world scale.

virtual void	SetWorldScale (double _scale)=0
	Set the world scale. The given scale will be assigned to the x, y, and z coordinates.

virtual void	SetWorldScale (double _x, double _y, double _z)=0
	Set the world scale.

virtual Variant	UserData (const std::string &_key) const =0
	Get custom data stored in this node.

virtual math::Pose3d	WorldPose () const =0
	Get the world pose.

virtual math::Vector3d	WorldPosition () const =0
	Get the world position.

virtual math::Quaterniond	WorldRotation () const =0
	Get the world rotation.

virtual math::Vector3d	WorldScale () const =0
	Get the world scale.

virtual math::Pose3d	WorldToLocal (const math::Pose3d &_pose) const =0
	Convert given world pose to local pose.

Public Member Functions inherited from Object
virtual	~Object ()
	Destructor.

virtual void	Destroy ()=0
	Destroy any resources associated with this object. Invoking any other functions after destroying an object will result in undefined behavior.

virtual unsigned int	Id () const =0
	Get the object ID. This ID will be unique across all objects inside a given scene, but necessarily true for objects across different scenes.

virtual std::string	Name () const =0
	Get the object name. This name will be unique across all objects inside a given scene, but necessarily true for objects across different scenes.

virtual void	PostRender ()=0
	Post process this object and any of its children after rendering.

virtual void	PreRender ()=0
	Prepare this object and any of its children for rendering. This should be called for each object in a scene just before rendering, which can be achieved by a single call to Scene::PreRender.

virtual ScenePtr	Scene () const =0
	Get the Scene that created this object.

Detailed Description

Represents a spotlight.

Constructor & Destructor Documentation

◆ ~SpotLight()

virtual ~SpotLight ( )

virtual

Destructor.

Member Function Documentation

◆ Direction()

virtual math::Vector3d Direction ( ) const

pure virtual

Get direction of the light.

Returns: The direction of the light

Implemented in OgreSpotLight, and Ogre2SpotLight.

◆ Falloff()

virtual double Falloff ( ) const

pure virtual

Get the falloff of the spotlight.

Returns: The falloff of the spotlight

Implemented in OgreSpotLight, and Ogre2SpotLight.

◆ InnerAngle()

virtual math::Angle InnerAngle ( ) const

pure virtual

Get the inner angle of the spotlight.

Returns: The inner angle of the spotlight

Implemented in OgreSpotLight, and Ogre2SpotLight.

◆ OuterAngle()

virtual math::Angle OuterAngle ( ) const

pure virtual

Get the outer angle of the spotlight.

Returns: The outer angle of the spotlight

Implemented in OgreSpotLight, and Ogre2SpotLight.

◆ SetDirection() [1/2]

virtual void SetDirection ( const math::Vector3d & _dir )

pure virtual

Set the direction of the light.

Parameters

[in] _dir New direction vector

Implemented in OgreSpotLight, Ogre2SpotLight, BaseSpotLight< T >, BaseSpotLight< Ogre2Light >, and BaseSpotLight< OgreLight >.

◆ SetDirection() [2/2]

virtual void SetDirection	(	double	_x,
		double	_y,
		double	_z
	)

pure virtual

Set the direction of the light.

Parameters

[in]	_x	X-component of direction vector
[in]	_y	Y-component of direction vector
[in]	_z	Z-component of direction vector

Implemented in BaseSpotLight< T >, BaseSpotLight< Ogre2Light >, and BaseSpotLight< OgreLight >.

◆ SetFalloff()

virtual void SetFalloff ( double _falloff )

pure virtual

Set the falloff of the spotlight.

Parameters

[in] _falloff New falloff of the spotlight

Implemented in OgreSpotLight, Ogre2SpotLight, BaseSpotLight< T >, BaseSpotLight< Ogre2Light >, and BaseSpotLight< OgreLight >.

◆ SetInnerAngle() [1/2]

virtual void SetInnerAngle ( const math::Angle & _angle )

pure virtual

Set the inner angle of the spotlight.

Parameters

[in] _angle New inner angle of the spotlight

Implemented in OgreSpotLight, Ogre2SpotLight, BaseSpotLight< T >, BaseSpotLight< Ogre2Light >, and BaseSpotLight< OgreLight >.

◆ SetInnerAngle() [2/2]

virtual void SetInnerAngle ( double _radians )

pure virtual

Set the inner angle of the spotlight.

Parameters

[in] _radians New inner angle of the spotlight in radians

Implemented in BaseSpotLight< T >, BaseSpotLight< Ogre2Light >, and BaseSpotLight< OgreLight >.

◆ SetOuterAngle() [1/2]

virtual void SetOuterAngle ( const math::Angle & _angle )

pure virtual

Set the outer angle of the spotlight.

Parameters

[in] _angle New outer angle of the spotlight

Implemented in OgreSpotLight, Ogre2SpotLight, BaseSpotLight< T >, BaseSpotLight< Ogre2Light >, and BaseSpotLight< OgreLight >.

◆ SetOuterAngle() [2/2]

virtual void SetOuterAngle ( double _radians )

pure virtual

Set the outer angle of the spotlight.

Parameters

[in] _radians New outer angle of the spotlight in radians

Implemented in BaseSpotLight< T >, BaseSpotLight< Ogre2Light >, and BaseSpotLight< OgreLight >.

The documentation for this class was generated from the following file:

Light.hh

Gazebo Rendering

API Reference

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ~SpotLight()

Member Function Documentation

◆ Direction()

◆ Falloff()

◆ InnerAngle()

◆ OuterAngle()

◆ SetDirection() [1/2]

◆ SetDirection() [2/2]

◆ SetFalloff()

◆ SetInnerAngle() [1/2]

◆ SetInnerAngle() [2/2]

◆ SetOuterAngle() [1/2]

◆ SetOuterAngle() [2/2]