Physics helper library

Helper library — not core native API. These are stock PAWN helpers supplied as source for convenience. They are not CubiOS native functions.

PawnLibs/physics/PHYSICS_CIRCLE_DATA

Summary

Array with named fields which represents a round object.

Synopsis

1#define PHYSICS_CIRCLE_DATA .posX, .posY, .simplePosX, .simplePosY, .spdX, .spdY, .mass, .radius, .CoR, .module, .screen, .moduleT, .screenT,
2 

Description

Fields:

• posX - circle position on X axis (fixed point)
• posY - circle position on Y axis (fixed point)
• simplePosX - circle position on X axis
• simplePosY - circle position on Y axis
• spdX - circle X speed
• spdY - circle Y speed
• mass - circle mass (fixed point)
• radius - circle radius
• CoR - Coefficient of restitution (fixed point)
• module - module owner of this circle
• screen - screen owner of this circle
• moduleT - module transfer, last module owner. Can be used for resending messages
• screenT - screen transfer, last screen owner. Can be used for resending messages

PawnLibs/physics/Physics_Circle_vs_AABB_obj

Summary

Check if there is a collision between round object and the axis-aligned bounding box.

Synopsis

1stock Physics_Circle_vs_AABB_obj(circle[PHYSICS_CIRCLE_DATA], rectX, rectY, rectWidth, rectHeight, fakeCircle[PHYSICS_CIRCLE_DATA] = 0)
2 

Inputs

• circle - an object for whom collision is checked
• rectX, rectY, - coordinates of the AABB object
• rectWidth, rectHeight - dimensions of the AABB object

Outputs

• fakeCircle - collision point, can be used for resolving collision

Return value

True if collision happens, false otherwise.

See also

• Physics_Res_CvC_Coll_Mass()
• Physics_Res_CvC_Coll_Massless()

PawnLibs/physics/Physics_Circle_Vs_Circle_obj

Summary

Check if there is a collision between two round objects.

Synopsis

1stock Physics_Circle_Vs_Circle_obj(circle1[PHYSICS_CIRCLE_DATA], circle2[PHYSICS_CIRCLE_DATA])
2 

Inputs

• circle1, circle2 - objects for whom collision is checked

Return value

True if collision happens, false otherwise.

See also

• Physics_Res_CvC_Coll_Mass()
• Physics_Res_CvC_Coll_Massless()

PawnLibs/physics/Physics_Circle_Vs_LineSegment

Summary

Check if there is a collision between round object and the line.

Synopsis

1stock Physics_Circle_Vs_LineSegment(circle[PHYSICS_CIRCLE_DATA], lineSX, lineSY, lineEX, lineEY, fakeCircle[PHYSICS_CIRCLE_DATA] = 0)
2 

Inputs

• circle - an object for whom collision is checked
• lineSX, lineSY, lineEX, lineEY - the line start and end coordinates

Outputs

• fakeCircle - collision point, can be used for resolving collision

Return value

True if collision happens, false otherwise.

See also

• Physics_Res_CvC_Coll_Mass()
• Physics_Res_CvC_Coll_Massless()

PawnLibs/physics/Physics_DeserializeCircle

Summary

Deserialize circle object data received from network.

Synopsis

1stock Physics_DeserializeCircle(serializedData_1, serializedData_2, circle[PHYSICS_CIRCLE_DATA])
2 

Inputs

• serializedData_1, serializedData_2 - data to deserialize

Outputs

• circle - deserialized data

See also

• Physics_SerializeCircle()

PawnLibs/physics/Physics_Overlap

Summary

TBD: inner function

Synopsis

1stock Physics_Overlap(overlap, positionDifference, distance)
2 

PawnLibs/physics/Physics_Res_CvC_Coll_Mass

Summary

Resolve collision with mass

Synopsis

1stock Physics_Res_CvC_Coll_Mass(circle1[PHYSICS_CIRCLE_DATA], circle2[PHYSICS_CIRCLE_DATA])
2 

Outputs

• circle1, circle2 - objects for whom collision is resolved

See also

• Physics_Res_CvC_Coll_Massless()

PawnLibs/physics/Physics_Res_CvC_Coll_Massless

Summary

Resolve collision without mass.

Synopsis

1stock Physics_Res_CvC_Coll_Massless(circle1[PHYSICS_CIRCLE_DATA], circle2[PHYSICS_CIRCLE_DATA])
2 

Outputs

• circle1, circle2 - objects for whom collision is resolved

See also

• Physics_Res_CvC_Coll_Mass()

PawnLibs/physics/Physics_SerializeCircle

Summary

Serialize circle object data to send it over network.

Synopsis

1stock Physics_SerializeCircle(obj[PHYSICS_CIRCLE_DATA], &serializedData_1, &serializedData_2)
2 

Inputs

• obj - an object to serialize

Outputs

• serializedData_1, serializedData_2 - serialized data

See also

• Physics_DeserializeCircle()
• broadcastMessage()