Version: Unity 6.7 Beta (6000.7)
LanguageEnglish
  • C#

PhysicsWorld.CastShapeProxy

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Declaration

public NativeArray<WorldCastResult> CastShapeProxy(ShapeProxy shapeProxy, Vector2 translation, QueryFilter filter, WorldCastMode castMode, Allocator allocator);

Parameters

Parameter Description
shapeProxy The shape proxy to use. This must be in world-space.
translation The translation relative to the shape proxy defining the direction the shape proxy will move through the world.
filter The filter to control what results are returned.
castMode Controls how many and in what order the results are returned.
allocator The memory allocator to use for the results. This can only be Allocator.Temp, Allocator.TempJob or Allocator.Persistent.

Returns

NativeArray<WorldCastResult> The query cast results. This NativeArray must be disposed of after use otherwise leaks will occur. The exception to this is if the array is empty.

Description

Returns the shape(s) that intersect the specified shape proxy as it is cast through the world. Neither PhysicsShape.ShapeType.Segment or PhysicsShape.ShapeType.ChainSegment shape types are supported. See QueryFilter, WorldCastMode, WorldCastResult and Allocator.


Declaration

public NativeArray<WorldCastResult> CastShapeProxy(ShapeProxy shapeProxy, Vector2 origin, Vector2 translation, QueryFilter filter, WorldCastMode castMode, Allocator allocator);

Parameters

Parameter Description
shapeProxy The shape proxy to use. This must be in local-space, relative to origin.
origin The point, in world space, that the shape proxy is defined relative to. This lets the proxy be authored in a local frame instead of being translated into world space before the cast. It has no effect on translation, which is a direction.
translation The translation relative to the shape proxy defining the direction the shape proxy will move through the world.
filter The filter to control what results are returned.
castMode Controls how many and in what order the results are returned.
allocator The memory allocator to use for the results. This can only be Allocator.Temp, Allocator.TempJob or Allocator.Persistent.

Returns

NativeArray<WorldCastResult> The query cast results. This NativeArray must be disposed of after use otherwise leaks will occur. The exception to this is if the array is empty.

Description

Returns the shape(s) that intersect the specified shape proxy as it is cast through the world. Neither PhysicsShape.ShapeType.Segment or PhysicsShape.ShapeType.ChainSegment shape types are supported. See QueryFilter, WorldCastMode, WorldCastResult and Allocator.