| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| en:orx:config:settings_structure:orxbody [2018/01/19 03:15 (6 years ago)] – Intro added from references sausage | en:orx:config:settings_structure:orxbody [2023/09/19 23:18 (7 months ago)] (current) – [Summary] sausage |
|---|
| === Body === | === Body === |
| |
| <code ini>[BodyTemplate] | <code ini> |
| PartList = BodyPartTemplate1#BodyPartTemplate2#... | [BodyTemplate] |
| AngularDamping = <float> | Inertia = <float> |
| CustomGravity = <vector> | Mass = <float> |
| Dynamic = <bool> | LinearDamping = <float> |
| FixedRotation = <bool> | AngularDamping = <float> |
| HighSpeed = <bool> | FixedRotation = <bool> |
| Inertia = <float> | HighSpeed = <bool> |
| LinearDamping = <float> | Dynamic = <bool> |
| Mass = <float></code> | CustomGravity = <vector> |
| | AllowSleep = <bool> |
| | AllowMoving = <bool> |
| | PartList = BodyPartTemplate1 # ... # BodyPartTemplateN |
| | </code> |
| |
| === BodyPart === | === BodyPart === |
| == Sphere == | == Sphere == |
| |
| <code ini>[BodyPartSphereTemplate] | <code ini> |
| | [BodyPartSphereTemplate] |
| Type = sphere | Type = sphere |
| Center = <vector> | full | Center = <vector> | full |
| Friction = <float> | Friction = <float> |
| Restitution = <float> | Restitution = <float> |
| Solid = <bool></code> | Solid = <bool> |
| | </code> |
| |
| == Box == | == Box == |
| Friction = <float> | Friction = <float> |
| Restitution = <float> | Restitution = <float> |
| Solid = <bool></code> | Solid = <bool> |
| | </code> |
| |
| == Mesh (polygon) == | == Mesh (polygon) == |
| Friction = <float> | Friction = <float> |
| Restitution = <float> | Restitution = <float> |
| Solid = <bool></code> | Solid = <bool> |
| | </code> |
| |
| | == Edge == |
| |
| | <code ini> |
| | [BodyPartEdgeTemplate] |
| | Type = edge |
| | VertexList = <vector> |
| | PreviousVertex = <vector> |
| | NextVertex = <vector> |
| | Friction = <float> |
| | Restitution = <float> |
| | Density = <float> |
| | SelfFlags = flags |
| | CheckMask = flags |
| | Solid = <bool> |
| | </code> |
| ==== Details ==== | ==== Details ==== |
| |
| * ''LinearDamping'': Damping of speed (linear velocity) for this body. By default its value is 0.0, which means no damping. | * ''LinearDamping'': Damping of speed (linear velocity) for this body. By default its value is 0.0, which means no damping. |
| * ''Mass'': Defines a mass, in kg, for this body. If parts are defined, the mass will be overridden by an automatically calculated value based of parts' sizes and positions. | * ''Mass'': Defines a mass, in kg, for this body. If parts are defined, the mass will be overridden by an automatically calculated value based of parts' sizes and positions. |
| | * ''AllowMoving'': This is only used by static bodies. If set to true, the static body can be moved via its speed/angular velocity accessors. Defaults to true. |
| | * ''AllowSleep'': Defaults to true. |
| |
| |
| * ''Type'': Defines the type of the body part. Available types are ''sphere'', ''box'' and ''mesh'' (ie. convex polygon). This property //needs// to be defined. | * ''Type'': Defines the type of the body part. Available types are ''sphere'', ''box'' and ''mesh'' (ie. convex polygon). This property //needs// to be defined. |
| * ''CheckMask/SelfFlags'': Both properties are flags expressed on 16bits. The ''SelfFlags'' defines this part identity whereas the ''CheckMask'' defines which parts are allowed to collide with it. For a collision to happen between two parts the expressions (Part1.CheckMask & Part2.SelfFlags) and (Part2.CheckMask & Part1.SelfFlags) have both to evaluate to ''true''. NB: Two parts of the same body won't collide whichever ''CheckMask/SelfFlags'' they have. ((Check [[http://www.box2d.org/manual.html#_Toc258082972|the documentation of Box2D]] for more information on filtering)) | * ''CheckMask/SelfFlags'': Both properties are flags expressed on 16bits. The ''SelfFlags'' defines this part identity whereas the ''CheckMask'' defines which parts are allowed to collide with it. For a collision to happen between two parts the expressions (Part1.CheckMask & Part2.SelfFlags) and (Part2.CheckMask & Part1.SelfFlags) have both to evaluate to ''true''. NB: Two parts of the same body won't collide whichever ''CheckMask/SelfFlags'' they have. ((Check [[http://www.box2d.org/manual.html#_Toc258082972|the documentation of Box2D]] for more information on filtering)) |
| * ''Density'': Defines the density of this part. Its default value is 0.0, which means it doesn't have any influence on the body's mass. | * ''Density'': Defines the density of this part, an influences the body's mass. Its default value is 1.0. |
| * ''Friction/Restitution'': Define the friction and restitution of this part, usually between 0.0 and 1.0. ((Check [[http://www.box2d.org/manual.html#_Toc258082972|the documentation of Box2D]] for more information on friction/restitution)) By default both their values are 0.0. Restitution is how much "Bounce" an object has. | * ''Friction/Restitution'': Define the friction and restitution of this part, usually between 0.0 and 1.0. ((Check [[http://www.box2d.org/manual.html#_Toc258082972|the documentation of Box2D]] for more information on friction/restitution)) By default both their values are 0.0. Restitution is how much "Bounce" an object has. |
| * ''Solid'': Defines if this part is solid or not. Only solid parts will trigger a reaction on their body when colliding with others. By default its value is ''false'' which means the collision info will be signaled through events, but the physics simulation of this body won't be automatically affected by it. | * ''Solid'': Defines if this part is solid or not. Only solid parts will trigger a reaction on their body when colliding with others. By default its value is ''false'' which means the collision info will be signaled through events, but the physics simulation of this body won't be automatically affected by it. |
| Here's a list of the available properties only available to sphere parts: | Here's a list of the available properties only available to sphere parts: |
| * ''Center'': Defines the center of the sphere (in 2D it's a circle, of course) in the parent's space (ie. in object's space). By default its value is ''full'' which means the center will match the object's one (ie. the center of its current graphic). | * ''Center'': Defines the center of the sphere (in 2D it's a circle, of course) in the parent's space (ie. in object's space). By default its value is ''full'' which means the center will match the object's one (ie. the center of its current graphic). |
| * ''Radius'': Defines the radius of the sphere (or 2D circle). By default its value is ''full'' which means the sphere's radius will match the biggest dimension of the parent object. You can find an example in the [[tutorials:spawner|spawner tutorial]] ((by looking directly at the config files as they're not covered in the wiki)). | * ''Radius'': Defines the radius of the sphere (or 2D circle). By default its value is ''full'' which means the sphere's radius will match the biggest dimension of the parent object. You can find an example in the [[en:tutorials:spawners:spawner|spawner tutorial]] ((by looking directly at the config files as they're not covered in the wiki)). |
| |
| == Box == | == Box == |
| |
| Here's a list of the available properties only available to box parts: | Here's a list of the available properties only available to box parts: |
| * ''TopLeft/BottomRight'': Define the extrema of the box (in 2D it's a rectangle, of course) in the parent's space (ie. in object's space). By default their values are ''full'' which means ''TopLeft'' and ''BottomRight'' will match the full rectangle defined by the parent object's current graphic. You can find an example in the [[tutorials:physics|physics tutorial]]. | * ''TopLeft/BottomRight'': Define the extrema of the box (in 2D it's a rectangle, of course) in the parent's space (ie. in object's space). By default their values are ''full'' which means ''TopLeft'' and ''BottomRight'' will match the full rectangle defined by the parent object's current graphic. You can find an example in the [[en:tutorials:physics:physics|physics tutorial]]. |
| |
| == Mesh (polygon) == | == Mesh (polygon) == |
| |
| Here's a list of the available properties only available to mesh ((convex polygon)) parts: | Here's a list of the available properties only available to mesh ((convex polygon)) parts: |
| * ''VertexList'': Provides a list of vertex coordinates in parent object's space. The resulting polygon //needs// to be convex. Up to 8 vertices can be defined and they //**have to be entered clockwise**//. You can find an example in the [[tutorials:spawner|spawner tutorial]] ((by looking directly at the config files as they're not covered in the wiki)). | * ''VertexList'': Provides a list of vertex coordinates in parent object's space. The resulting polygon //needs// to be convex. Up to 8 vertices can be defined and they //**have to be entered clockwise**//. You can find an example in the [[en:tutorials:spawners:spawner|spawner tutorial]] ((by looking directly at the config files as they're not covered in the wiki)). |
| |
| | == Edge == |
| | |
| | * ''VertexList'': This should contain exactly 2 vectors. |
| | * ''PreviousVertex'': Optional previous ghost vertex. |
| | * ''NextVertex'': Optional next ghost vertex. |
| | |
| | == Chain == |
| | |
| | * ''VertexList'': This should contain at least 2 vectors. |
| | * ''PreviousVertex'': Optional previous ghost vertex. |
| | * ''NextVertex'': Optional next ghost vertex. |
| | * ''Loop'': If true, the chain will be treated as a closed loop. Defaults to false. |
| |
| ==== Latest config settings for the Development Version ==== | ==== Latest config settings for the Development Version ==== |
| {{section>en:orx:config:developmentversion#&noheader&nofooter&noeditbutton}} | {{section>en:orx:config:developmentversion#&noheader&nofooter&noeditbutton}} |
