Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

InputEventScreenDrag

繼承: InputEventFromWindow < InputEvent < Resource < RefCounted < Object

代表螢幕拖動事件。

說明

存放與螢幕拖動事件相關的資訊。見 Node._input()。

教學

屬性

int

index

0

bool

pen_inverted

false

Vector2

position

Vector2(0, 0)

float

pressure

0.0

Vector2

relative

Vector2(0, 0)

Vector2

screen_relative

Vector2(0, 0)

Vector2

screen_velocity

Vector2(0, 0)

Vector2

tilt

Vector2(0, 0)

Vector2

velocity

Vector2(0, 0)


屬性說明

int index = 0 🔗

  • void set_index(value: int)

  • int get_index()

多次拖動事件中的拖動事件索引。


bool pen_inverted = false 🔗

  • void set_pen_inverted(value: bool)

  • bool get_pen_inverted()

正在使用手寫筆的橡皮端時,會返回 true。


Vector2 position = Vector2(0, 0) 🔗

節點所在視埠中的拖動位置,使用該視埠的座標系。


float pressure = 0.0 🔗

  • void set_pressure(value: float)

  • float get_pressure()

表示使用者對筆施加的壓力。範圍從 0.0 到 1.0 。


Vector2 relative = Vector2(0, 0) 🔗

相對於前一位置(上一影格的位置)的拖動位置。

注意:relative 根據內容縮放係數自動縮放,內容縮放係數由專案的拉伸模式設定定義。這意味著在處理觸摸瞄准的腳本中使用 relative 時,觸摸靈敏度將根據解析度而有所不同。為了避免這種情況,請改用 screen_relative。


Vector2 screen_relative = Vector2(0, 0) 🔗

  • void set_screen_relative(value: Vector2)

  • Vector2 get_screen_relative()

相對於螢幕座標中的上一個位置(上一影格的位置)的未縮放拖動位置。該位置不根據內容縮放係數或呼叫 InputEvent.xformed_by() 進行縮放。無論專案的拉伸模式如何,對於觸摸瞄准來說,這都應該優先於 relative。


Vector2 screen_velocity = Vector2(0, 0) 🔗

  • void set_screen_velocity(value: Vector2)

  • Vector2 get_screen_velocity()

螢幕座標中未縮放的拖動速度(單位為每秒像素數)。該速度不會根據內容縮放係數或對 InputEvent.xformed_by() 的呼叫進行縮放。無論專案的拉伸模式如何,對於觸摸瞄准來說,這都應該優先於 velocity。


Vector2 tilt = Vector2(0, 0) 🔗

代表筆的傾斜角度。正的 X 座標值表示向右傾斜。正的Y座標值表示向使用者自身傾斜。兩個軸的範圍是 -1.0 到 1.0。


Vector2 velocity = Vector2(0, 0) 🔗

拖動速度。

注意:velocity 根據內容縮放係數自動縮放,內容縮放係數由專案的拉伸模式設定定義。這意味著在處理觸摸瞄准的腳本中使用 velocity 時,觸摸靈敏度將根據解析度而表現不同。為了避免這種情況,請改用 screen_velocity。