This page has been translated automatically.
Видеоуроки
Интерфейс
Основы
Продвинутый уровень
Подсказки и советы
Основы
Программирование на C#
Рендеринг
Профессиональный уровень (SIM)
Принципы работы
Свойства (properties)
Компонентная Система
Рендер
Физика
Редактор UnigineEditor
Обзор интерфейса
Работа с ассетами
Контроль версий
Настройки и предпочтения
Работа с проектами
Настройка параметров ноды
Setting Up Materials
Настройка свойств
Освещение
Sandworm
Использование инструментов редактора для конкретных задач
Расширение функционала редактора
Встроенные объекты
Ноды (Nodes)
Объекты (Objects)
Эффекты
Декали
Источники света
Geodetics
World-ноды
Звуковые объекты
Объекты поиска пути
Player-ноды
Программирование
Основы
Настройка среды разработки
Примеры использования
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Плагины
Форматы файлов
Материалы и шейдеры
Rebuilding the Engine Tools
Интерфейс пользователя (GUI)
VR Development
Двойная точность координат
API
Animations-Related Classes
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
VR-Related Classes
Работа с контентом
Оптимизация контента
Материалы
Визуальный редактор материалов
Сэмплы материалов
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Учебные материалы
Внимание! Эта версия документация УСТАРЕЛА, поскольку относится к более ранней версии SDK! Пожалуйста, переключитесь на самую актуальную документацию для последней версии SDK.
Внимание! Эта версия документации описывает устаревшую версию SDK, которая больше не поддерживается! Пожалуйста, обновитесь до последней версии SDK.

Unigine::Plugins::LeapMotion::Hand Struct

Notice
LeapMotion plugin must be loaded.

Hands are the main entity tracked by the Leap Motion controller. The controller maintains an inner model of the human hand and validates the data from its sensors against this model. This allows the controller to track finger positions even when a finger is not completely visible.

Notice
It is possible for movement or changes in position to be lost when a finger is behind or directly in front of the hand (from the point of view of the controller).

The Leap Motion software matches the internal model against the existing data. In some cases, the software can make an incorrect match – for example, identifying a right hand as a left hand.

This structure represents a physical hand detected by the Leap and provides access to its attributes describing the hand position, orientation, and movement. All coordinates are relative to the origin of the Leap Motion coordinate system.

The Hand structure is declared as follows:

Source code (C++)
struct Hand
{
	int id;
	int type;
	int is_valid;
	float palm_width;
	Unigine::Math::vec3 palm_position;
	Unigine::Math::vec3 palm_stabilized_position;
	Unigine::Math::vec3 wrist_position;
	Unigine::Math::vec3 palm_velocity;
	Unigine::Math::vec3 palm_normal;
	Unigine::Math::vec3 direction;
	Unigine::Math::mat4 basis;

	Arm arm;
	Unigine::Map<int, Finger> fingers;
};

struct Hand

Fields

  • int id - Identifier of the hand.
  • int type - Type of the hand:
    • 0 - left hand
    • 1 - right hand
  • float palm_width - Width of the palm when the hand is in a flat position, in meters.
  • Math::vec3 palm_position - Coordinates of the position of the palm.
    Notice
    All coordinates are relative to the origin of the Leap Motion coordinate system.
  • Math::vec3 palm_stabilized_position - Coordinates of the modified palm position with some additional smoothing and stabilization applied. Smoothing and stabilization is performed in order to make this value more suitable for interaction with 2D content. The stabilized position lags behind the palm position by a variable amount, depending primarily on the speed of movement.
    Notice
    All coordinates are relative to the origin of the Leap Motion coordinate system.
  • Math::vec3 wrist_position - Coordinates of the position of the wrist.
    Notice
    All coordinates are relative to the origin of the Leap Motion coordinate system.
  • Math::vec3 palm_velocity - Rate of change of the palm position, in m/s.
  • Math::vec3 palm_normal - Coordinates of the normal vector to the palm. If a hand is flat, this vector will point downward, or "out" of the front surface of your palm.
    Notice
    All coordinates are relative to the origin of the Leap Motion coordinate system.
  • Math::vec3 direction - Normalized direction from the palm position toward the fingers.
    Notice
    All coordinates are relative to the origin of the Leap Motion coordinate system.
  • Math::mat4 basis - Orthonormal basis vectors for this Bone as a Matrix.

    Basis vectors specify the orientation of a bone:

    • X - Perpendicular to the longitudinal axis of the bone; exits the sides of the finger.
    • Y (or up vector) - Perpendicular to the longitudinal axis of the bone; exits the top and bottom of the finger. More positive in the upward direction.
    • Z - Aligned with the longitudinal axis of the bone. More positive toward the base of the finger.

    The basis provided for the right hand use the right-hand rule; those for the left hand use the left-hand rule. Thus, the positive direction of the x-basis is to the right for the right hand and to the left for the left hand. You can change from right-hand to left-hand rule by multiplying the z basis vector by -1.

    You can use the basis vectors for such purposes as measuring complex finger poses and skeletal animation.

    Notice
    Converting the basis vectors directly into a quaternion representation is not mathematically valid. If you use quaternions, create them from the derived rotation matrix not directly from the basis.
  • int is_valid - 1 if the hand contains valid tracking data; otherwise, 0.
  • LeapMotion::Arm arm - Arm of the hand.
  • Unigine::Map<int, Finger> finger - List of all fingers of the hand.
Last update: 19.12.2023
Build: ()