Difference between revisions of "B2.Body:setActive"

From GiderosMobile
m (Text replacement - "</source" to "</syntaxhighlight")
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
 +
<languages />
 
'''Available since:''' Gideros 2011.6<br/>
 
'''Available since:''' Gideros 2011.6<br/>
 +
'''Class:''' [[Special:MyLanguage/b2.Body|b2.Body]]<br/>
 +
 
=== Description ===
 
=== Description ===
<br />
+
Sets the active state of the body. An inactive body is not simulated and cannot be collided with or woken up.
Sets the active state of the body. An inactive body is not simulated and cannot be collided with or woken up. <br />
+
 
If you pass a flag of true, all fixtures will be added to the broad-phase. If you pass a flag of false,<br />
+
If you pass a flag of true, all fixtures will be added to the broad-phase. If you pass a flag of false, all fixtures will be removed from the broad-phase and all contacts will be destroyed. Fixtures and joints are otherwise unaffected. You may continue to create/destroy fixtures and joints on inactive bodies.
all fixtures will be removed from the broad-phase and all contacts will be destroyed. Fixtures and joints are <br />
+
 
otherwise unaffected. You may continue to create/destroy fixtures and joints on inactive bodies. <br />
+
Fixtures on an inactive body are implicitly inactive and will not participate in collisions, ray-casts, or queries.
Fixtures on an inactive body are implicitly inactive and will not participate in collisions, ray-casts, or queries. <br />
+
 
Joints connected to an inactive body are implicitly inactive. An inactive body is still owned by a [[b2.World]] object and <br />
+
Joints connected to an inactive body are implicitly inactive. An inactive body is still owned by a [[b2.World]] object and remains in the body list.
remains in the body list.<br />
+
<syntaxhighlight lang="lua">
<br />
+
b2.Body:setActive(flag)
<source lang="lua">
+
</syntaxhighlight>
b2.Body:setActive(flag)
+
 
</source>
+
=== Parameters ===
'''flag''': (boolean) active flag ''''''<br/>
+
'''flag''': (boolean) active flag <br/>
 +
 
 +
{{B2.Body}}

Latest revision as of 17:23, 12 July 2023


Available since: Gideros 2011.6
Class: b2.Body

Description

Sets the active state of the body. An inactive body is not simulated and cannot be collided with or woken up.

If you pass a flag of true, all fixtures will be added to the broad-phase. If you pass a flag of false, all fixtures will be removed from the broad-phase and all contacts will be destroyed. Fixtures and joints are otherwise unaffected. You may continue to create/destroy fixtures and joints on inactive bodies.

Fixtures on an inactive body are implicitly inactive and will not participate in collisions, ray-casts, or queries.

Joints connected to an inactive body are implicitly inactive. An inactive body is still owned by a b2.World object and remains in the body list.

b2.Body:setActive(flag)

Parameters

flag: (boolean) active flag




LiquidFun