Code.org p5.play
p5.OrientedBoundingBoxCollider
An Oriented Bounding Box (OBB) collision shape, used to detect overlap and compute minimum displacement vectors with other collision shapes.
Table of Contents
- Methods
- Properties
- Static Methods
Constructor
p5.OrientedBoundingBoxCollider
-
center -
width -
height -
rotation
Parameters:
-
centerp5.Vectorof the rectangle in world-space
-
widthNumberof the rectangle (when not rotated)
-
heightNumberof the rectangle (when not rotated)
-
rotationNumberabout center, in radians
Methods
_getCandidateAxes
()
Array.Compute candidate separating axes relative to another object.
Returns:
_getMinRadius
-
axis
When checking for tunneling through a OrientedBoundingBoxCollider use a worst-case of zero (e.g. if the other sprite is passing through a corner).
Parameters:
-
axisp5.Vector
Returns:
_getRadiusOnAxis
-
axis
Get this shape's radius (half-width of its projection) along the given axis.
Parameters:
-
axisp5.Vector
Returns:
_onTransformChanged
()
Recalculate cached properties, relevant vectors, etc. when at least one of the shape's transforms changes. The base CollisionShape (and PointCollider) only need to recompute the shape's center, but other shapes may need to override this method and do additional recomputation.
Compute the smallest movement needed to move this collision shape out of another collision shape. If the shapes are not overlapping, returns a zero vector to indicate that no displacement is necessary.
Parameters:
-
otherp5.CollisionShape
Returns:
draw
-
sketch
Debug-draw this collider.
Parameters:
-
sketchP5- p5 instance to use for drawing
getBoundingBox
()
Top: number, bottom: number, left: number, right: number, width: number, height: number
Get world-space axis-aligned bounds information for this collision shape. Used primarily for the quadtree.
Returns:
}
overlap
-
other
Check whether this shape overlaps another.
Parameters:
-
otherp5.CollisionShape
Returns:
setParentTransform
-
parent
Update this collider's parent transform, which will in turn adjust its position, rotation and scale in world-space and recompute cached values if necessary. If a Sprite is passed as the 'parent' then a new transform will be computed from the sprite's position/rotation/scale and used.
Parameters:
-
parentp5.Transform2D | Sprite
updateFromSprite
-
sprite
Update this collider based on the properties of a parent Sprite.
Parameters:
-
spriteSprite
updateSweptColliderFromSprite
-
sprite
Assuming this collider is a sprite's swept collider, update it based on the properties of the parent sprite so that it encloses the sprite's current position and its projected position.
Parameters:
-
spriteSprite
Properties
_halfDiagonals
Array.Cached half-diagonals, used for computing a projected radius. Already transformed into world-space.
_localTransform
p5.Transform2D
protected
Transform of this shape relative to its parent. If there is no parent, this is pretty much the world-space transform. This should stay consistent with _offset, _rotation and _scale properties.
_offset
p5.Vector
private
The center of the collision shape in local-space; also, the offset of the collision shape's center from its parent sprite's center.
_parentTransform
p5.Transform2D
protected
Transform of whatever parent object (probably a sprite) this shape is associated with. If this is a free-floating shape, the parent transform will remain an identity matrix.
_potentialAxes
Array.Cached separating axes this shape contributes to a collision.
_rotation
Number
private
Rotation in radians in local space (relative to parent). Note that this will only be meaningful for shapes that can rotate, i.e. Oriented Bounding Boxes
_scale
p5.Vector
private
Scale X and Y in local space. Note that this will only be meaningful for shapes that have dimensions (e.g. not for point colliders)
_width
Number
private
Unscaled box width.
_width
Number
private
Unscaled box height.
center
p5.Vector
The center of the collision shape in world-space. Note: You can set this property with a value in world-space, but it will actually modify the collision shape's local transform.
getsDimensionsFromSprite
Boolean
If true, when calling updateFromSprite this collider will adopt the
base dimensions of the sprite in addition to adopting its transform.
If false, only the transform (position/rotation/scale) will be adopted.
halfDiagonals
Array.Two vectors representing adjacent half-diagonals of the box at its current dimensions and orientation.
height
Number
The unrotated height of the box collider. Recomputes diagonals when set.
offset
p5.Vector
The center of the collision shape in local-space - if this collider is owned by a sprite, the offset of the collider center from the sprite center.
rotation
Number
The local-space rotation of the collider, in radians.
width
Number
The unrotated width of the box collider. Recomputes diagonals when set.
Static Methods
p5.OrientedBoundingBoxCollider.createFromSprite
-
sprite -
offset -
width -
height -
rotation
Construct a new AxisAlignedBoundingBoxCollider with given offset for the given sprite.