PhysicsRayQueryParameters3D — C# API

class PhysicsRayQueryParameters3DReckfellSharpInherits RefCounted

From and To are world endpoints of one segment. CollisionMask filters candidate Layers; CollideWithBodies/CollideWithAreas choose categories. Exclude holds physics-object RIDs, not instance IDs.

Parameters are not automatically inherited from a camera/weapon. Validate finite coordinates, a positive distance when computing endpoints and the intended world. Account for HitFromInside and geometry limitations separately; backface detection does not fill a concave surface.

Guide and example.

Declarations checked against C# SDK 1.0.0. Expand a name to see declarations and documentation.

Constructors1

PhysicsRayQueryParameters3DConstructor

# PhysicsRayQueryParameters3D

C#
public PhysicsRayQueryParameters3D();

Properties8

CollideWithAreasProperty

# CollideWithAreas

C#
public bool CollideWithAreas { get; set; }

If true, the query will take Area3Ds into account.

CollideWithBodiesProperty

# CollideWithBodies

C#
public bool CollideWithBodies { get; set; }

If true, the query will take PhysicsBody3Ds into account.

CollisionMaskProperty

# CollisionMask

C#
public uint CollisionMask { get; set; }

The physics layers the query will detect (as a bitmask). By default, all collision layers are detected. See Collision layers and masks in the documentation for more information.

ExcludeProperty

# Exclude

C#
public Reckfell.Collections.Array<Rid> Exclude { get; set; }

Physics-object RIDs excluded from the query. Obtain them with CollisionObject.GetRid; GetInstanceId and visual mesh references are not those RIDs.

FromProperty

# From

C#
public Vector3 From { get; set; }

The starting point of the ray being queried for, in global coordinates.

HitBackFacesProperty

# HitBackFaces

C#
public bool HitBackFaces { get; set; }

If true, the query will hit back faces with concave polygon shapes with back face enabled or heightmap shapes.

HitFromInsideProperty

# HitFromInside

C#
public bool HitFromInside { get; set; }

If true, the query will detect a hit when starting inside shapes. In this case the collision normal will be Vector3(0, 0, 0). Does not affect concave polygon shapes or heightmap shapes.

ToProperty

# To

C#
public Vector3 To { get; set; }

The ending point of the ray being queried for, in global coordinates.

Methods17

CreatePhysicsRayQueryParameters3D

# Create

C#
public static PhysicsRayQueryParameters3D Create(Vector3 from, Vector3 to, uint collisionMask = 4294967295, Reckfell.Collections.Array<Rid> exclude = null);

Returns a new, pre-configured PhysicsRayQueryParameters3D object. Use it to quickly create query parameters using the most common options.

Parameters
Name	Type	Default
`from`	`Vector3`	—
`to`	`Vector3`	—
`collisionMask`	`uint`	`4294967295`
`exclude`	`Reckfell.Collections.Array<Rid>`	`null`

Returns PhysicsRayQueryParameters3D

GetCollisionMaskuint

# GetCollisionMask

C#
public uint GetCollisionMask();

Returns uint

GetExcludeReckfell.Collections.Array<Rid>

# GetExclude

C#
public Reckfell.Collections.Array<Rid> GetExclude();

Returns Reckfell.Collections.Array<Rid>

GetFromVector3

# GetFrom

C#
public Vector3 GetFrom();

Returns Vector3

GetToVector3

# GetTo

C#
public Vector3 GetTo();

Returns Vector3

IsCollideWithAreasEnabledbool

# IsCollideWithAreasEnabled

C#
public bool IsCollideWithAreasEnabled();

Returns bool

IsCollideWithBodiesEnabledbool

# IsCollideWithBodiesEnabled

C#
public bool IsCollideWithBodiesEnabled();

Returns bool

IsHitBackFacesEnabledbool

# IsHitBackFacesEnabled

C#
public bool IsHitBackFacesEnabled();

Returns bool

IsHitFromInsideEnabledbool

# IsHitFromInsideEnabled

C#
public bool IsHitFromInsideEnabled();

Returns bool

SetCollideWithAreasvoid

# SetCollideWithAreas

C#
public void SetCollideWithAreas(bool enable);

Parameters
Name	Type	Default
`enable`	`bool`	—

SetCollideWithBodiesvoid

# SetCollideWithBodies

C#
public void SetCollideWithBodies(bool enable);

Parameters
Name	Type	Default
`enable`	`bool`	—

SetCollisionMaskvoid

# SetCollisionMask

C#
public void SetCollisionMask(uint collisionMask);

Parameters
Name	Type	Default
`collisionMask`	`uint`	—

SetExcludevoid

# SetExclude

C#
public void SetExclude(Reckfell.Collections.Array<Rid> exclude);

Parameters
Name	Type	Default
`exclude`	`Reckfell.Collections.Array<Rid>`	—

SetFromvoid

# SetFrom

C#
public void SetFrom(Vector3 from);

Parameters
Name	Type	Default
`from`	`Vector3`	—

SetHitBackFacesvoid

# SetHitBackFaces

C#
public void SetHitBackFaces(bool enable);

Parameters
Name	Type	Default
`enable`	`bool`	—

SetHitFromInsidevoid

# SetHitFromInside

C#
public void SetHitFromInside(bool enable);

Parameters
Name	Type	Default
`enable`	`bool`	—

SetTovoid

# SetTo

C#
public void SetTo(Vector3 to);

Parameters
Name	Type	Default
`to`	`Vector3`	—