Пересечения (Intersections)

To find the intersection of nodes with bounds of the specified volume, you should use functions that have a bounding volume and a vector of nodes in arguments:Чтобы найти пересечение нод с границами указанного объема, вы должны использовать функции, которые имеют ограничивающий объем и вектор нод в аргументах:

• int getIntersection(const Math::WorldBoundBox & bb, Vector< Ptr<Node> > & nodes)
• int getIntersection(const Math::WorldBoundSphere & bs, Vector< Ptr<Node> > & nodes)
• int getIntersection(const Math::WorldBoundBox & bb, int type, Vector< Ptr<Node> > & nodes)
• int getIntersection(const Math::WorldBoundSphere & bs, int type, Vector< Ptr<Node> > & nodes)
• int getIntersection(const Math::WorldBoundFrustum & bf, int type, Vector< Ptr<Node> > & nodes)

Schematic visual representation of intersection with nodes in bounding volumeСхематическое визуальное представление пересечения с нодами в ограничивающем объеме

These functions return the value indicating the result of the intersection search: 1 if the intersection was found; otherwise, 0. Intersected nodes can be found in the vector that passed as an argument to the function.Эти функции возвращают значение, указывающее результат поиска пересечения: 1, если пересечение было найдено; в противном случае 0. Пересекающиеся ноды можно найти в векторе, который передается в качестве аргумента функции.

To clarify the nodes search, specify the type of node to search.Чтобы уточнить поиск, укажите тип нод для поиска.

The following functions can be used to perform the intersection search with objects:Для выполнения поиска пересечений с объектами можно использовать следующие функции:

• int getIntersection(const Math::Vec3 & p0, const Math::Vec3 & p1, Vector< Ptr<Object> > & objects, bool check_surface_flags)
• int getIntersection(const Math::WorldBoundBox & bb, Vector< Ptr<Object> > & objects)
• int getIntersection(const Math::WorldBoundSphere & bs, Vector< Ptr<Object> > & objects)
• int getIntersection(const Math::WorldBoundFrustum & bf, Vector< Ptr<Object> > & objects)
• bool getVisibleIntersection(const Math::Vec3& camera, const Math::WorldBoundFrustum& bf, Vector< Ptr<Object> > & objects, float max_distance)
• bool getVisibleIntersection(const Math::Vec3& camera, const Math::WorldBoundFrustum& bf, Node::TYPE type, Vector< Ptr<Node> > & nodes, float max_distance)

Schematic visual representation of intersection with objects in bounding volumeСхематическое визуальное представление пересечения с объектами в ограничивающем объеме

These functions return the value indicating the result of the intersection search: 1 if the intersection was found; otherwise, 0. You can pass the start (vec3 p0) and the end (vec3 p1) point of the intersecting line or pass the (BoundBox, BoundFrustum, BoundSphere) to get the intersection of objects with a line or with a bounding volume, respectively. Intersected nodes can be found in the vector that passed as an argument to the function.Эти функции возвращают значение, указывающее результат поиска пересечения: 1, если пересечение было найдено; в противном случае, 0. Вы можете передать начальную (vec3 p0) и конечную (vec3 p1) точки пересекающей линии или передать (BoundBox, BoundFrustum, BoundSphere), чтобы получить пересечение объектов с линией или с ограничивающим объемом соответственно. Пересеченные ноды можно найти в векторе, который передается в качестве аргумента функции.

For WorldBoundFrustum, there are two modes of getting intersections:Для WorldBoundFrustum существует два способа получения пересечений:

• Intersections with the objects that are visible inside the frustum — getVisibleIntersection()Пересечения с объектами, которые видны внутри пирамиды видимости — getVisibleIntersection()
• Intersections with all objects inside the frustum, both visible and invisible — getIntersection()Пересечения со всеми объектами внутри пирамиды видимости, как видимыми, так и невидимыми — getIntersection()

The following functions are used to find the nearest intersected object with the traced line. You should specify the start point and the end point of the line, and the function detects if there are any object on the way of this line.Следующие функции используются для поиска ближайшего объекта, пересекающегося с линией трассировки. Вы должны указать начальную точку и конечную точку линии, и функция определит, есть ли какие-либо объекты на пути этой линии.

• Ptr<Object> getIntersection(const Math::Vec3 & p0, const Math::Vec3 & p1, int mask, Math::Vec3 * ret_point, Math::vec3 * ret_normal, Math::vec4 * ret_texcoord, int * ret_index, int * ret_surface)
• Ptr<Object> getIntersection(const Math::Vec3 & p0, const Math::Vec3 & p1, int mask, const Vector< Ptr<Node> > & exclude, Math::Vec3 * ret_point, Math::vec3 * ret_normal, Math::vec4 * ret_texcoord, int * ret_index, int * ret_surface)
• Ptr<Object> getIntersection(const Math::Vec3 & p0, const Math::Vec3 & p1, int mask, const Ptr<WorldIntersection> & v)
• Ptr<Object> getIntersection(const Math::Vec3 & p0, const Math::Vec3 & p1, int mask, const Ptr<WorldIntersectionNormal> & v)
• Ptr<Object> getIntersection(const Math::Vec3 & p0, const Math::Vec3 & p1, int mask, const Ptr<WorldIntersectionTexCoord> & v)
• Ptr<Object> getIntersection(const Math::Vec3 & p0, const Math::Vec3 & p1, int mask, const Vector< Ptr<Node> > & exclude, const Ptr<WorldIntersection> & v)
• Ptr<Object> getIntersection(const Math::Vec3 & p0, const Math::Vec3 & p1, int mask, const Vector< Ptr<Node> > & exclude, const Ptr<WorldIntersectionNormal> & v)
• Ptr<Object> getIntersection(const Math::Vec3 & p0, const Math::Vec3 & p1, int mask, const Vector< Ptr<Node> > & exclude, const Ptr<WorldIntersectionTexCoord> & v)

Schematic visual representation of intersection with objects and traced lineСхематическое визуальное представление пересечения с объектами и линией трассировки

These functions return an intersection information and a pointer to the nearest object to the start point (p0). Information about the intersection can be presented in standard vectors or in the following format that you pass to functions as arguments:Эти функции возвращают информацию о пересечении и указатель на ближайший объект к начальной точке (p0). Информация о пересечении может быть представлена в стандартных векторах или в следующем формате, который вы передаете функциям в качестве аргументов:

• WorldIntersection intersection — the WorldIntersection class instance. By using this class you can get the intersection point (coordinates), the index of the intersected triangle of the object and the index of the intersected surface.WorldIntersection intersection — экземпляр класса WorldIntersection. Используя этот класс, вы можете получить точку пересечения (координаты), индекс пересекаемого треугольника объекта и индекс пересекаемой поверхности.
• WorldIntersectionNormal normal — the WorldIntersectionNormal class instance. By using this class you can get only the normal of the intersection point.WorldIntersectionNormal normal — экземпляр класса WorldIntersectionNormal. Используя этот класс, вы можете получить только нормаль точки пересечения.
• WorldIntersectionTexCoord texcoord — the WorldIntersectionTexCoord class instance. By using this class you can get only the texture coordinates of the intersection point.WorldIntersectionTexCoord texcoord — экземпляр класса WorldIntersectionTexCoord. Используя этот класс, вы можете получить только текстурные координаты точки пересечения.

These functions detect intersection with surfaces (polygons) of meshes. But there are some conditions to detect the intersection with the surface:Эти функции обнаруживают пересечение с поверхностями (полигонами) сеток. Но есть некоторые условия для обнаружения пересечения с поверхностью:

1. The surface is enabled.Поверхность включена.
2. The surface has a material assigned.Поверхности присвоен материал.

3. Per-surface Intersection flag is enabled.Для каждой поверхности включен флаг Intersection.

   Примечание

   You can set this flag to the object's surface by using the Object.setIntersection() function.Вы можете установить этот флаг на поверхность объекта с помощью функции Object.setIntersection().

To clarify the object search, perform the following:Чтобы уточнить поиск объекта, выполните следующие действия:

• Use an Intersection mask. An intersection is found only if an object is matching the Intersection mask.Используйте маску Intersection. Пересечение обнаруживается только в том случае, если объект соответствует маске Intersection.
• Specify the list of objects (nodes) to exclude and pass to the function as an argument.Укажите список объектов (нод) для исключения и передачи функции в качестве аргумента.

The following example shows how you can get the intersection information by using the PhysicsIntersection class. In this example we specify a line from the point of the camera (vec3 p0) to the point of the mouse pointer (vec3 p1). The executing sequence is the following:В следующем примере показано, как вы можете получить информацию о пересечении с помощью класса PhysicsIntersection. В этом примере мы задаем линию от точки камеры (vec3 p0) до точки указателя мыши (vec3 p1). Последовательность выполнения следующая:

1. Define and initialize two points (p0 and p1) by using the Player::getDirectionFromScreen() function.Определите и инициализируйте две точки (p0 и p1) с помощью функции Player::getDirectionFromScreen().
2. Create an instance of the PhysicsIntersection class to get the intersection information.Создайте экземпляр класса PhysicsIntersection, чтобы получить информацию о пересечении.
3. Check if there is an intersection with an object with a shape or a collision object. The getIntersection() function returns an intersected object when the object intersects with the traced line.Проверьте, есть ли пересечение с объектом с формой или объектом столкновения. Функция getIntersection() возвращает пересеченный объект, когда объект пересекается с линией трассировки.
4. When the object intersects with the traced line, all surfaces of the intersected object change their material parameters. If the object has a shape, its information will be shown in console. The PhysicsIntersection class instance gets the coordinates of the intersection point and the Shape class object. You can get all these fields by using getShape(), getPoint() functions.Когда объект пересекается с линией трассировки, все поверхности пересекаемого объекта изменяют свои материальные параметры. Если объект имеет форму, его информация будет отображена в консоли. Экземпляр класса PhysicsIntersection получает координаты точки пересечения и объекта класса Shape. Вы можете получить все эти поля с помощью функций getShape(), getPoint().

#include "AppWorldLogic.h"
#include <UnigineObjects.h>
#include <UnigineEditor.h>
#include <UnigineGame.h>
#include <UniginePhysics.h>

using namespace Unigine;
using namespace Math;

int AppWorldLogic::init()
{
	// create a Mesh instance with a box surface
	MeshPtr mesh = Mesh::create();
	mesh->addBoxSurface("box", vec3(0.2f));

	// create a new dynamic mesh from the Mesh instance
	ObjectMeshDynamicPtr dynamic_mesh = ObjectMeshDynamic::create(mesh);

	dynamic_mesh->setWorldTransform(translate(Vec3(0.0f, 0.0f, 2.0f)));

	// assign a body and a shape to the dynamic mesh
	BodyRigidPtr body = BodyRigid::create(dynamic_mesh);
	ShapeBoxPtr shape = ShapeBox::create(body, vec3(0.2f)); 

	return 1;
}

////////////////////////////////////////////////////////////////////////////////
// start of the main loop
////////////////////////////////////////////////////////////////////////////////

int AppWorldLogic::update()
{
	// initialize points of the mouse direction
	Vec3 p0, p1;

	// get the current player (camera)
	PlayerPtr player = Game::getPlayer();
	if (player.get() == NULL)
		return 0;
	// get width and height of the main application window
	Math::ivec2 winsize = WindowManager::getMainWindow()->getClientSize();
	int width = winsize.x;
	int height = winsize.y;
	// get the current X and Y coordinates of the mouse pointer
	int mouse_x = Gui::getCurrent()->getMouseX();
	int mouse_y = Gui::getCurrent()->getMouseY();
	// get the mouse direction from the player's position (p0) to the mouse cursor pointer (p1)
	player->getDirectionFromScreen(p0, p1, mouse_x, mouse_y, 0, 0, width, height);

	// create the instance of the PhysicsIntersection object to save the information about the intersection
	PhysicsIntersectionPtr intersection = PhysicsIntersection::create();
	// get an intersection
	ObjectPtr object = Physics::getIntersection(p0, p1, 1, intersection);

	// if the intersection has occurred, change the parameter of the object's material    
	if (object)
	{
		for (int i = 0; i < object->getNumSurfaces(); i++)
		{
			object->setMaterialParameterFloat4("albedo_color", vec4(1.0f, 1.0f, 0.0f, 1.0f), i);
		}

		// if the intersected object has a shape, show the information about the intersection   
		ShapePtr shape = intersection->getShape();
		if (shape)
		{
			Log::message("physics intersection info: point: (%f %f %f) shape: %s\n", intersection->getPoint().x, intersection->getPoint().y, intersection->getPoint().z, shape->getTypeName());
		}
	}

	return 1;
}

The following example shows how you can get the intersection point (vec3) of the cylinder between two points with an obstacle. We'll do the following:В следующем примере показано, как вы можете получить точку пересечения (vec3) цилиндра между двумя точками с препятствием. мы сделаем следующее:

1. Create an instance of the ObstacleBox class on the application initialization.Создайте экземпляр класса ObstacleBox при инициализации приложения.
2. Define two points (p1 and p2) that specify the beginning and the end of the cylinder.Определите две точки (p1 и p2) , которые определяют начало и конец цилиндра.
3. Create an instance of the GameIntersection class to get the intersection point coordinates.Создайте экземпляр класса GameIntersection, чтобы получить координаты точки пересечения.
4. Check if there is an intersection with an obstacle. The Game::getIntersection() function returns an intersected obstacle when the obstacle appears in the area of the cylinder.Проверьте, есть ли пересечение с препятствием. Функция Game::getIntersection() возвращает пересеченное препятствие, когда препятствие появляется в области цилиндра.
5. When the GameIntersection instance intersects with an obstacle, you can get its name using the getName() function or any other details using the corresponding functions.Когда экземпляр GameIntersection пересекается с препятствием, вы можете получить его имя, используя функцию getName(), или любые другие сведения, используя соответствующие функции.

#include "AppWorldLogic.h"
#include <UnigineObjects.h>
#include <UnigineEditor.h>

#include <UniginePathFinding.h>
#include <UnigineGame.h>

using namespace Unigine;
using namespace Math;

int AppWorldLogic::init()
{
	Visualizer::setEnabled(true);

		// create an obstacle
	obstacle_box = ObstacleBox::create(vec3(1.0f));
	obstacle_box->setName("main_obstacle");
	
	return 1;
}

int AppWorldLogic::update()
{

	// make the obstacle box move inside and outside the game intersection area
	Vec3 new_pos = Vec3(0, 0, 2 + Math::sin(Game::getTime()));
	obstacle_box->setWorldPosition(new_pos);
	Visualizer::renderPoint3D(new_pos, 0.15f, vec4(1, 0, 1, 1));

	// calculate the cylinder height (equals to the distance between the start and end points)
	Visualizer::renderPoint3D(p1, 0.15f, vec4(0, 0, 1, 1));
	Visualizer::renderPoint3D(p2, 0.15f, vec4(0, 1, 1, 1));

	// create an instance of the GameIntersection class
	GameIntersectionPtr intersection = GameIntersection::create();
	ObstaclePtr obstacle = Game::getIntersection(p1, p2, radius, 1, intersection);

	//visualize the cylinder that represents the game intersection area
	Visualizer::renderCylinder(radius, (p2 - p1).length(), setTo(p1 + (p2 - p1) / 2, p2, vec3_up, AXIS_Z), vec4(1, 1, 1, 1));

	// check if the intersection of the cylinder with the obstacle has occurred
	if (obstacle)
	{
		obstacle->renderVisualizer();
		Log::message("The name of the obstacle is: (%s)\n", obstacle->getName());

	}
	return 1;

}