Version: Unity 6.5 Alpha (6000.5)
LanguageEnglish
  • C#

PhysicsComposer

struct in UnityEngine.LowLevelPhysics2D

Leave feedback
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

Description

Provides the ability to compose geometry using specific operations on layers in a specific order.

Static Properties

Property Description
DefaultCurveStride The default curve stride used when composing geometry with curves, in radians. Lower values produce more vertices, larger values fewer vertices.
MinCurveStride The minimum curve stride, in radians.

Properties

Property Description
isValid Check if a Physics Composer is valid.
layerCount Get the number of layers currently added to the Physics Composer.
layerHandles Get the layer handles added to the Physics Composer.
maxPolygonVertices Get/Set the maximum number of polygon vertices to be used when composing polygon output. This should be in the range of 3 to UnityEngine.LowLevelPhysics2D.PhysicsConstants.MaxPolygonVertices. The default is UnityEngine.LowLevelPhysics2D.PhysicsConstants.MaxPolygonVertices.
rejectedGeometryCount Get the number of geometries that were rejected during the last Geometry Composition. Geometry can be rejected for a number of reasons such as vertices being collinear or too close etc. Whilst "pure" geometry is always valid, this geometry is meant to be used by physics which has constraints on what it can accept. All geometry successfully created will always be valid when used by physics. If you notice thin/small gaps in the composition, this is likely to be rejected geometry. Checking this property will help determine that.
useDelaunay Get/Set if Delaunay tessellation is to be used.

Public Methods

Method Description
AddLayer Add a Circle Geometry layer to the Physics Composer.
CreateChainGeometry Create ChainGeometry from the composition by iterating all the layers added to the composition in the layer order specified, applying each operation specified. A limit is imposed on small vertex distances so it is recommended that scaling is applied here rather than on the returned geometry so geometry is not discarded due to it being invalid.
CreateConvexHulls Create ConvexHull from the composition by iterating all the layers added to the composition in the layer order specified, applying each operation specified.
CreatePolygonGeometry Create PolygonGeometry from the composition by iterating all the layers added to the composition in the layer order specified, applying each operation specified. A limit is imposed on small vertex distances so it is recommended that scaling is applied here rather than on the returned geometry so geometry is not discarded due to it being invalid.
Destroy Destroy the Physics Composer.
GetGeometryIslands Get the geometry islands from a previous polygon geometry composition i.e. a call to PhysicsComposer.CreatePolygonGeometry or PhysicsComposer.CreateConvexHulls. Each generated polygon or convex-hull belongs to a unique island defining a set of polygons that are connected together as they share edges. The array returned contains a series of ranges where each range is a unique connected island where the range indicates both the start index and length of the original polygon indices. The number of discovered unique islands is defined by the size of the returned array.
RemoveLayer Remove a layer from the Physics Composer.

Static Methods

Method Description
Create Create a Physics Composer.
Copyright © 2023 Unity Technologies
优美缔软件（上海）有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961