Lysa  0.0
Lysa 3D Engine
RayCast Class Reference

Detailed Description

A ray in 3D space, used to find the first CollisionObject it intersects.

+ Inheritance diagram for RayCast:

Public Member Functions

 RayCast (const float3 &target, collision_layer layer, const std::string &name=TypeNames[RAYCAST])
 
 RayCast (const std::string &name=TypeNames[RAYCAST])
 
auto isColliding () const
 
auto getCollider () const
 
auto getCollisionPoint () const
 
auto setExcludeParent (const bool exclude)
 
auto forceUpdate ()
 
auto setTarget (const float3 &target)
 
const auto & getTarget () const
 
void setCollisionLayer (collision_layer layer)
 
- Public Member Functions inherited from Node
 Node (const Node &node)
 
 Node (const std::string &name=TypeNames[NODE], Type type=NODE)
 
auto getId () const
 
virtual void onReady ()
 
virtual void onEnterScene ()
 
virtual void onExitScene ()
 
virtual void onProcess (const float alpha)
 
virtual void onPhysicsProcess (const float delta)
 
virtual bool onInput (InputEvent &inputEvent)
 
void setTransformLocal (const float4x4 &transform)
 
const float4x4 & getTransformGlobal () const
 
const float4x4 & getTransform () const
 
virtual void setPosition (const float3 &position)
 
virtual void setPosition (const float x, const float y, const float z)
 
float3 getPosition () const
 
void translate (const float3 &localOffset)
 
void translate (float x, float y, float z)
 
virtual void setPositionGlobal (const float3 &position)
 
virtual void setPositionGlobal (const float x, const float y, const float z)
 
float3 getPositionGlobal () const
 
void rotateX (float angle)
 
void rotateY (float angle)
 
void rotateZ (float angle)
 
quaternion getRotation () const
 
quaternion getRotationGlobal () const
 
float3 getRotationEulerAngles () const
 
float3 getRotationEulerAnglesGlobal () const
 
virtual void scale (float scale)
 
void setRotation (const quaternion &quat)
 
void setRotationGlobal (const quaternion &quat)
 
void setRotationX (float angle)
 
void setRotationY (float angle)
 
void setRotationZ (float angle)
 
float getRotationX () const
 
float getRotationY () const
 
float getRotationZ () const
 
float3 getScale () const
 
float3 getScaleGlobal () const
 
auto * getParent () const
 
bool addChild (std::shared_ptr< Node > child, bool async=false)
 
bool removeChild (const std::shared_ptr< Node > &child, bool async=false)
 
void removeAllChildren (bool async=false)
 
bool haveChild (const std::shared_ptr< Node > &child, bool recursive) const
 
void lookAt (const float3 &target)
 
template<typename T = Node>
std::shared_ptr< T > getChild (const std::string &name) const
 
template<typename T = Node>
std::shared_ptr< T > getChildByPath (const std::string &path) const
 
template<typename T = Node>
std::shared_ptr< T > findFirstChild (const std::string &name) const
 
template<typename T >
std::shared_ptr< T > findFirstChild (const bool recursive=true) const
 
template<typename T >
std::list< std::shared_ptr< T > > findAllChildren (const bool recursive=true) const
 
template<typename T = Node>
std::list< std::shared_ptr< T > > findAllChildren (const std::string &name, const bool recursive=true) const
 
template<typename T = Node>
std::list< std::shared_ptr< T > > findAllChildrenByGroup (const std::string &groupName, const bool recursive=true) const
 
const std::list< std::shared_ptr< Node > > & getChildren () const
 
const std::list< std::string > & getGroups () const
 
void addToGroup (const std::string &group)
 
void removeFromGroup (const std::string &group)
 
bool isVisible () const
 
virtual void setVisible (bool visible=true)
 
auto isInGroup (const std::string &group) const
 
void setProcessMode (const ProcessMode mode)
 
bool isProcessed () const
 
auto getType () const
 
auto getViewport () const
 
const std::string & getName () const
 
std::string getPath () const
 
virtual void setProperty (const std::string &property, const std::string &value)
 
void printTree (int tab=0) const
 
std::shared_ptr< Node > duplicate (bool recursiveFilter=false) const
 
float3 toGlobal (const float3 &local) const
 
float3 toLocal (const float3 &global) const
 
float3 getRightVector () const
 
float3 getLeftVector () const
 
float3 getFrontVector () const
 
float3 getBackVector () const
 
float3 getUpVector () const
 
float3 getDownVector () const
 
void setName (const std::string &nodeName)
 
template<typename T >
std::shared_ptr< TweencreatePropertyTween (typename PropertyTween< T >::Setter set, const T initial, const T final, float duration, const TransitionType ttype=TransitionType::LINEAR, const Tween::Callback &callback=nullptr)
 
void killTween (const std::shared_ptr< Tween > &tween)
 
auto getSharedPtr ()
 
 ~Node () override = default
 
- Public Member Functions inherited from Object
void connect (const Signal::signal &name, const Signal::Handler &handler)
 
void connect (const Signal::signal &name, const std::function< void ()> &handler)
 
void emit (const Signal::signal &name, void *params=nullptr)
 
virtual std::string toString () const
 
 Object () = default
 
virtual ~Object () = default
 
- Public Member Functions inherited from Updatable
auto isUpdated () const
 
void decrementUpdates ()
 
void setUpdated ()
 
void setMaxUpdates (const uint32 maxUpdates)
 

Protected Member Functions

void physicsProcess (float delta) override
 
- Protected Member Functions inherited from Node
virtual std::shared_ptr< Node > duplicateInstance () const
 
virtual void updateGlobalTransform ()
 
virtual void ready ()
 
virtual void process (float alpha)
 
virtual void enterScene ()
 
virtual void exitScene ()
 
virtual void attachToViewport (Viewport *viewport)
 
virtual void detachFromViewport ()
 
virtual void pause ()
 
virtual void resume ()
 

Protected Attributes

float3 target {}
 
float3 hitPoint {}
 
collision_layer collisionLayer {}
 
bool excludeParent {true}
 
std::shared_ptr< CollisionObjectcollider {nullptr}
 
- Protected Attributes inherited from Node
float4x4 localTransform {}
 
float4x4 globalTransform {}
 

Additional Inherited Members

- Public Types inherited from Node
enum  Type {
  ANIMATION_PLAYER, CAMERA, CHARACTER, COLLISION_AREA,
  COLLISION_OBJECT, DIRECTIONAL_LIGHT, ENVIRONMENT, KINEMATIC_BODY,
  LIGHT, MESH_INSTANCE, NODE, OMNI_LIGHT,
  PHYSICS_BODY, RAYCAST, RIGID_BODY, SKYBOX,
  SPOT_LIGHT, STATIC_BODY, VIEWPORT
}
 Node type. More...
 
- Public Attributes inherited from Updatable
uint32 pendingUpdates {0}
 
uint32 maxUpdates {0}
 
- Static Public Attributes inherited from Node
static constexpr auto TypeNames
 

Constructor & Destructor Documentation

RayCast ( const float3 &  target,
collision_layer  layer,
const std::string &  name = TypeNames[RAYCAST] 
)

Creates a RayCast

Parameters
targetThe ray's destination point, relative to the RayCast's position
layerThe ray's collision layer
nameThe node's name
RayCast ( const std::string &  name = TypeNames[RAYCAST])

Creates a RayCast with a [0.0, 0.0, 0.0] target

Parameters
nameThe node's name

Member Function Documentation

auto forceUpdate ( )
inline

Updates the collision information for the ray immediately, without waiting for the next physics update

auto getCollider ( ) const
inline

Returns the first object that the ray intersects, or nullptr if no object is intersecting the ray

auto getCollisionPoint ( ) const
inline

Returns the collision point at which the ray intersects the closest object, in the global coordinate system

const auto& getTarget ( ) const
inline

Returns the ray target

auto isColliding ( ) const
inline

Returns whether any object is intersecting with the ray's vector (considering the vector length).

void physicsProcess ( float  delta)
overrideprotectedvirtual

Reimplemented from lysa::Node::physicsProcess()

void setCollisionLayer ( collision_layer  layer)
auto setExcludeParent ( const bool  exclude)
inline

If true, collisions will be ignored for this RayCast's immediate parent.

auto setTarget ( const float3 &  target)
inline

Sets the ray's destination point, relative to the RayCast's position.

Member Data Documentation

std::shared_ptr<CollisionObject> collider {nullptr}
protected
collision_layer collisionLayer {}
protected
bool excludeParent {true}
protected
float3 hitPoint {}
protected
float3 target {}
protected