Unigine.Shape Class

Shape Class

Properties

bool IsIdentity#

mat4 BodyShapeTransform#

Mat4 Transform#

vec3 CenterOfMass#

mat3 Inertia#

float Volume#

vec3 Area#

float Restitution#

float Friction#

float Density#

float Mass#

int ExclusionMask#

int CollisionMask#

int IntersectionMask#

string Name#

bool IsContinuous#

bool IsEnabledSelf#

bool IsEnabled#

Body Body#

int Number#

string TypeName#

int Type#

int ID#

Members

int GetCollision ( Contact[] contacts, float ifps ) #

Collisions with the surface can be found only if the following conditions are fulfilled:

1. The surface is enabled.
2. Per-surface Collision flag is enabled.
3. The surface has a material assigned.

Arguments

• Contact[] contacts - Output buffer containing information on all detected physical contacts for the shape (if any). Information on each contact can be handled via the Contact class.
• float ifps - Inverse FPS value.

Return value

int GetCollision ( Object object, Contact[] contacts, float ifps ) #

Collisions with the surface can be found only if the following conditions are fulfilled:

1. The surface is enabled.
2. Per-surface Collision flag is enabled.
3. The surface has a material assigned.

Arguments

• Object object - Contact object instance.
• Contact[] contacts - Output buffer containing information on all detected physical contacts for the shape (if any). Information on each contact can be handled via the Contact class.
• float ifps - Inverse FPS value.

Return value

int GetIntersection ( Vec3 p0, Vec3 p1, PhysicsIntersectionNormal intersection ) #

Performs tracing from the p0 point to the p1 point to find a shape intersected by this line. Intersection is found only for objects with a matching intersection mask.

Arguments

• Vec3 p0 - Start point of the line.
• Vec3 p1 - End point of the line.
• PhysicsIntersectionNormal intersection - PhysicsIntersectionNormal class instance containing intersection information

Return value

int GetIntersection ( Vec3 p0, Vec3 p1, PhysicsIntersection intersection ) #

Performs tracing from the p0 point to the p1 point to find a shape intersected by this line. Intersection is found only for objects with a matching intersection mask.

Usage Example

The following example shows how you can get the intersection information by using the PhysicsIntersection class. In this example the line is an invisible traced line from the point of the camera (vec3 p0) to the point of the mouse pointer (vec3 p1). It is supposed that you have a dynamic mesh with a body and a shape assigned. The executing sequence is the following:

• Define and initialize two points (p0 and p1) by using the Player.getDirectionFromScreen() function.
• Create an instance of the PhysicsIntersection class to get the information of the intersection point.
• Check, if there is a intersection with a shape and save the result in the integer variable.
• In this example, if there is an intersection of mouse direction with a shape, the PhysicsIntersection class instance gets the intersection point. The result is shown in the console.

/* ... */
// initialize points of the mouse direction
Vec3 p0, p1;

// get the current player (camera)
Player player = Game.get().getPlayer();
if (player == null)
	return 0;
// get width and height of the current application window
int width = App.get().getWidth();
int height = App.get().getHeight();
// get the current X and Y coordinates of the mouse pointer
int mouse_x = App.get().getMouseX();
int mouse_y = App.get().getMouseY();
// get the mouse direction from the player's position (p0) to the mouse cursor pointer (p1)
player.getDirectionFromScreen(out p0, out p1, mouse_x, mouse_y, width, height);

// create the instance of the PhysicsIntersection object to save the information about the intersection
PhysicsIntersection intersection = new PhysicsIntersection();
// create an integer variable to check the result of intersection
int result = 0;
result = shape.getIntersection(p0, p1, intersection);
// if there was an intersection, show the message in console
if (result != 0)
{
	Log.message("Intersection point: ({0} {1} {2}) \n", intersection.getPoint().x, intersection.getPoint().y, intersection.getPoint().z);
}
/* ... */

Arguments

• Vec3 p0 - Start point of the line.
• Vec3 p1 - End point of the line.
• PhysicsIntersection intersection - PhysicsIntersection class instance containing intersection information.

Return value

int GetIntersection ( Vec3 p0, Vec3 p1, Vec3[] ret_point, vec3[] ret_normal ) #

Performs tracing from the p0 point to the p1 point to find a shape intersected by this line. Intersection is found only for objects with a matching intersection mask.

Arguments

• Vec3 p0 - Start point of the line (in world coordinates).
• Vec3 p1 - End point of the line (in world coordinates).
• Vec3[] ret_point - Container to which contact point coordinates (if any) shall be put (in world coordinate system).
• vec3[] ret_normal - Container to which contact point normal coordinates (if any) shall be put (in world coordinate system).

Return value

Shape GetShape ( ) #

Return value

void SetPosition ( Vec3 position ) #

Arguments

• Vec3 position - New shape's position, in world coordinates.

string GetTypeName ( int type ) #

Arguments

• int type - Shape type ID. One of the SHAPE_* values.

Return value

void SetVelocity ( vec3 velocity, float ifps ) #

Arguments

• vec3 velocity - Velocity vector, each component represents shape's velocity along the corresponding axis, in units per second.
• float ifps - Inverse FPS value.

vec3 GetVelocity ( ) #

Return value

Shape Clone ( ) #

Return value

void RenderVisualizer ( vec4 color ) #

Arguments

• vec4 color - Color, in which the shape will be rendered.

int RestoreState ( Stream stream ) #

• If a node is a parent for other nodes, states of these child nodes need to be restored manually.
• To save the state into a buffer, file or a message from a socket, make sure the stream is opened. If necessary, you can set a position for writing for buffers and files.

Arguments

• Stream stream - Stream with saved node state data.

Return value

int SaveState ( Stream stream ) #

• If a node is a parent for other nodes, states of these child nodes need to be saved manually.
• To save the state from a buffer, file or a message from a socket, make sure the stream is opened. For buffers and files, you also need to set the proper position for reading.

Arguments

• Stream stream - Stream to save node state data.

Return value

void Swap ( Shape shape ) #

Arguments

• Shape shape - A shape to swap.

Shape CreateShape ( int type ) #

Arguments

• int type - Body type. One of the SHAPE_* values.

Return value

Shape CreateShape ( string type_name ) #

Arguments

• string type_name - Shape type name.

Return value