InputEventMouseMotion
Данные движения мыши или пера: смещение, скорость и поля пера.
Событие движения содержит разные величины. Position — точка в пространстве получателя, Relative — смещение за событие, Velocity — скорость в секунду. ScreenRelative и ScreenVelocity сохраняются при XformedBy, тогда как Relative и Velocity преобразуются базисом. Не умножайте готовое смещение на delta повторно.
При накоплении ввода несколько движений могут объединиться: не считайте один callback одним аппаратным измерением. Отключение Input.UseAccumulatedInput меняет накопление, но не гарантирует фиксированную частоту или точность устройства.
Pressure, Tilt и PenInverted зависят от данных оборудования. Их можно заполнить вручную; сеттеры Pressure и Tilt не ограничивают диапазон. Проверка синтетического события не подтверждает поддержку планшета на конкретной платформе.
Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.
Конструкторы1
InputEventMouseMotionКонструктор
public InputEventMouseMotion();Создаёт событие движения с нулевыми Relative, ScreenRelative, Velocity, ScreenVelocity, Tilt и Pressure; PenInverted = false. Не считывает мышь и не перемещает указатель.
Свойства7
PenInvertedСвойство
public bool PenInverted { get; set; }Флаг использования обратного конца пера, если устройство и драйвер предоставляют такие данные. Вручную установленный true — только поле события, не доказательство наличия ластика или пера.
PressureСвойство
public float Pressure { get; set; }Давление пера, обычно нормированное оборудованием в 0..1. Сеттер хранит число без ограничения диапазона: синтетическое значение 1.5 сохраняется как 1.5. Валидируйте собственные данные; значение 0 само не определяет тип устройства.
RelativeСвойство
public Vector2 Relative { get; set; }Приращение позиции мыши за событие. Преобразование события может масштабировать его: в проверке масштаб 2 изменил (3, 4) на (6, 8). Это смещение, не скорость и не абсолютная точка.
ScreenRelativeСвойство
public Vector2 ScreenRelative { get; set; }Экранное приращение мыши, сохраняемое при преобразовании события. В проверке осталось (3, 4), когда Relative стало (6, 8). Подходит для расчёта чувствительности обзора без повторного масштабирования viewport.
ScreenVelocityСвойство
public Vector2 ScreenVelocity { get; set; }Экранная скорость, сохраняемая при преобразовании события. Не путайте со ScreenRelative: скорость и смещение за событие требуют разных расчётов времени.
TiltСвойство
public Vector2 Tilt { get; set; }Вектор наклона пера; ожидаемый диапазон данных устройства — от -1 до 1 по осям. Сеттер не нормализует и не ограничивает компоненты; синтетические значения вне диапазона сохраняются. Нулевой вектор сам не подтверждает поддержку наклона оборудованием.
VelocityСвойство
public Vector2 Velocity { get; set; }Скорость движения в пикселях в секунду в преобразованном пространстве события. XformedBy применяет к ней базис преобразования без переноса; ScreenVelocity сохраняется отдельно. Это не смещение за событие: для непосредственного поворота от движения используйте Relative или ScreenRelative без дополнительного умножения на delta.
Методы14
GetPenInvertedbool
public bool GetPenInverted();Возвращает флаг обратного конца пера из свойства PenInverted. Не выполняет нового опроса устройства.
boolТекущее значение PenInverted; единицы и ограничения описаны у свойства.
GetPressurefloat
public float GetPressure();Возвращает давление пера из свойства Pressure. Не выполняет нового опроса устройства.
floatТекущее значение Pressure; единицы и ограничения описаны у свойства.
GetRelativeVector2
public Vector2 GetRelative();Возвращает смещение за событие из свойства Relative. Не выполняет нового опроса устройства.
Vector2Текущее значение Relative; единицы и ограничения описаны у свойства.
GetScreenRelativeVector2
public Vector2 GetScreenRelative();Возвращает экранное смещение за событие из свойства ScreenRelative. Не выполняет нового опроса устройства.
Vector2Текущее значение ScreenRelative; единицы и ограничения описаны у свойства.
GetScreenVelocityVector2
public Vector2 GetScreenVelocity();Возвращает экранную скорость в пикселях в секунду из свойства ScreenVelocity. Не выполняет нового опроса устройства.
Vector2Текущее значение ScreenVelocity; единицы и ограничения описаны у свойства.
GetTiltVector2
public Vector2 GetTilt();Возвращает вектор наклона пера из свойства Tilt. Не выполняет нового опроса устройства.
Vector2Текущее значение Tilt; единицы и ограничения описаны у свойства.
GetVelocityVector2
public Vector2 GetVelocity();Возвращает скорость в пикселях в секунду из свойства Velocity. Не выполняет нового опроса устройства.
Vector2Текущее значение Velocity; единицы и ограничения описаны у свойства.
SetPenInvertedvoid
public void SetPenInverted(bool penInverted);Устанавливает флаг обратного конца пера в PenInverted по правилам свойства. Не генерирует движение устройства.
| Имя | Тип | По умолчанию |
|---|---|---|
penInverted | bool | — |
penInvertedНовое значение PenInverted в единицах свойства.
SetPressurevoid
public void SetPressure(float pressure);Устанавливает давление пера в Pressure по правилам свойства. Не генерирует движение устройства.
| Имя | Тип | По умолчанию |
|---|---|---|
pressure | float | — |
pressureНовое значение Pressure в единицах свойства.
SetRelativevoid
public void SetRelative(Vector2 relative);Устанавливает смещение за событие в Relative по правилам свойства. Не генерирует движение устройства.
| Имя | Тип | По умолчанию |
|---|---|---|
relative | Vector2 | — |
relativeНовое значение Relative в единицах свойства.
SetScreenRelativevoid
public void SetScreenRelative(Vector2 relative);Устанавливает экранное смещение за событие в ScreenRelative по правилам свойства. Не генерирует движение устройства.
| Имя | Тип | По умолчанию |
|---|---|---|
relative | Vector2 | — |
relativeНовое значение ScreenRelative в единицах свойства.
SetScreenVelocityvoid
public void SetScreenVelocity(Vector2 velocity);Устанавливает экранную скорость в пикселях в секунду в ScreenVelocity по правилам свойства. Не генерирует движение устройства.
| Имя | Тип | По умолчанию |
|---|---|---|
velocity | Vector2 | — |
velocityНовое значение ScreenVelocity в единицах свойства.
SetTiltvoid
public void SetTilt(Vector2 tilt);Устанавливает вектор наклона пера в Tilt по правилам свойства. Не генерирует движение устройства.
| Имя | Тип | По умолчанию |
|---|---|---|
tilt | Vector2 | — |
tiltНовое значение Tilt в единицах свойства.
SetVelocityvoid
public void SetVelocity(Vector2 velocity);Устанавливает скорость в пикселях в секунду в Velocity по правилам свойства. Не генерирует движение устройства.
| Имя | Тип | По умолчанию |
|---|---|---|
velocity | Vector2 | — |
velocityНовое значение Velocity в единицах свойства.