TouchPanel2 - stingray.TouchPanel2 네임스페이스 참조 - Stingray Lua API 참조

stingray.TouchPanel2 네임스페이스 참조
함수 | 버튼 및 축 | 접점 | 제스처 | 사용되지 않는 함수
모두 확장 | 모두 축소

설명

두 번째로 연결된 터치패드 컨트롤러를 나타내는 전역 싱글톤입니다.

플랫폼이 지원하는 각 터치 패널마다 별도의 TouchPanel 오브젝트(TouchPanel1, TouchPanel2, ... TouchPanelN)가 있습니다.

Windows 플랫폼에서는 SimulatedTouchPanel1 인터페이스를 사용하여 마우스를 사용하는 터치 패널 입력을 시뮬레이션할 수도 있습니다.

Android

Android 버튼 이름

  • left, right: "soft left" 및 "soft right" 버튼.
  • home, back, call, end_call, volume_up, volume_down
  • dpad_up, dpad_down, dpad_left, dpad_right, dpad_center
  • media_play_pause, media_rewind, media_fast_forward

Android 축 이름

  • accelerometer: X, Y 및 Z축에서 가속도계로 측정한 힘 값입니다.

iOS

iOS 버튼 이름

없음.

iOS 축 이름

  • accelerometer: X, Y 및 Z축에서 가속도계로 측정한 힘 값입니다.

버튼 및 축으로부터 값 가져오기

모든 유형의 입력 제어기에는 이름이 정해진 버튼 및 "축" 세트가 내장되어 있어, 사용자가 다양한 방식으로 제어기에게 입력을 제공할 수 있습니다.

  • 각 버튼은 지정된 프레임 내에서 누르거나 놓을 수 있습니다. 이러한 이벤트는 pressed() 및 released()를 호출하여 감지할 수 있습니다. 제어기는 해당 버튼에 대해 0에서 1 사이의 값을 생성하기도 하는데, 이 값은 button()을 호출하여 검색할 수 있습니다.
  • 각 축은 Vector3 값을 생성할 수 있습니다. 경우에 따라 이 값은 표준화되기도 합니다. 보통 플레이어가 엄지스틱을 미는 방향과 같은 일부 유형의 배율에 따라 축이 나타내는 값이 변하는 경우 표준화됩니다. 예를 들어, 게임 패드의 엄지스틱을 왼쪽으로 완전히 밀거나(1,0,0), 위로 완전히 밀거나(0,1,0), 왼쪽 대각선 위로 미는(0.707107, 0.707107, 0) 경우 등이 있을 수 있습니다. 아니면, 때로는 축이 3D 공간 또는 2D 화면 공간에서 좌표 값을 생성하기도 합니다.

키보드 버튼 k가 눌렸는지 확인하려면 다음 함수를 사용하면 됩니다.

local k_key_id = stingray.Keyboard.button_id("k")      -- retrieve the button ID
local isPressed = stingray.Keyboard.button(k_key_id)   -- use the ID to access the value

마찬가지로, 2D 화면 공간에서 Windows 마우스 커서의 현재 위치를 확인하려면 다음 함수를 사용하면 됩니다.

local cursor_axis_id = stingray.Mouse.axis_id("cursor")    -- retrieve the axis ID
local value = stingray.Mouse.axis(cursor_axis_id)          -- use the ID to access to value

또는, 플레이어가 게임 패드의 오른쪽 엄지스틱을 어느 방향으로 미는지 확인하려면 다음 함수를 사용하면 됩니다.

local right_axis_id = stingray.Pad1.axis_id("right")
local value = stingray.Pad1.axis(right_axis_id)

모든 버튼 및 축 이름 가져오기

쿼리할 수 있는 버튼 및 축 이름은 제어기 종류마다 다르고, 플랫폼에 따라서도 다를 수 있습니다. 장치에 사용할 수 있는 버튼을 확인해야 하는 경우에는 편집기 상태 막대 또는 게임 프로젝트에서 다음 코드 조각을 실행하여 최신 목록을 검색하면 됩니다. 값을 확인하려는 컨트롤러 이름으로 Mouse를 대체하십시오.

-- get button names
local button_id = 0
while button_id < stingray.Mouse.num_buttons() do
    print(stingray.Mouse.button_name(button_id))
    button_id = button_id +1
end
-- get axis names
local axis_id = 0
while axis_id < stingray.Mouse.num_axes() do
    print(stingray.Mouse.axis_name(axis_id))
    axis_id = axis_id +1
end

터치 접점에서 값 가져오기

모든 유형의 컨트롤러에서 제공하는 버튼 및 축 외에 터치 패널에는 플레이어가 화면을 터치하는 위치를 나타내는 "접점" 세트가 있습니다. 이 접점은 contacts()를 호출하여 검색할 수 있는 숫자 ID로 식별됩니다. 이 ID를 아래의 접점에 나열된 다른 함수들로 전달해 각 접점에 관한 세부 정보를 쿼리할 수 있습니다.

터치 인터페이스 위치 값은 픽셀 단위로 측정되는 화면 공간 좌표로 제공됩니다.

예를 들면, location()을 호출하여 접점 위치의 (X,Y) 화면 좌표를 가져올 수 있습니다.

local contacts = {stingray.TouchPanel1.contacts()} -- the {} puts the return values into a table
for _, id in ipairs(contacts) do
    if stingray.TouchPanel1.is_touch_down(id) then       -- when the screen is touched
        local pos = stingray.TouchPanel1.location(id)    -- get the position
    end
end

함수

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

stingray.Vector3

컨트롤러의 가속도계 해상도입니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

boolean

컨트롤러가 활성 상태이면 true를, 그렇지 않으면 false를 반환합니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

boolean

컨트롤러가 이 프레임에 연결되었으면 true를, 그렇지 않으면 false를 반환합니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

boolean

컨트롤러가 이 프레임에서 분리되었으면 true를, 그렇지 않으면 false를 반환합니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

string

컨트롤러의 고유한 이름을 포함하고 있는 문자열입니다.

대부분의 경우 이 이름은 type()에 의해 반환된 문자열에 추가 카운터가 붙어서 변형된 문자열입니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

string

컨트롤러 장치의 유형을 설명하는 문자열입니다.

일부 예외는 있지만 이 식별자는 동일 모델의 모든 제어기에서 같습니다(예: xbox_controller, logitech_mx518_mouse 또는 generic_105_key_keyboard). 일부 플랫폼에서는 이 값이 입력 장치 모델에 관계없이 같을 수도 있습니다.

버튼 및 축

이 그룹의 함수는 이 컨트롤러가 추적하는 버튼 및 축으로부터 값을 가져옵니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

integer?

플레이어가 이 프레임에서 누른 첫 번째 버튼의 ID를 반환하거나, 아무 버튼도 누르지 않은 경우에는 nil을 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

그런 경우에는 플레이어가 누른 첫 번째 버튼의 ID를 반환합니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

integer?

플레이어가 이 프레임에서 놓은 첫 번째 버튼의 ID를 반환하거나, 아무 버튼도 놓지 않은 경우에는 nil을 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

그런 경우에는 플레이어가 놓은 첫 번째 버튼의 ID를 반환합니다.

매개변수

id :

integer

값을 검색할 축의 ID입니다.

dead_zone_mode :

integer?

컨트롤러로부터 읽어 온 값을 반환하기 전에 적용할 데드 존 유형을 지정합니다. 이 값은 dead zone mode 상수 중 어느 값이든 될 수 있습니다. 이 매개변수를 지정하는 경우 dead_zone_size 역시 지정해야 합니다. 이를 생략하는 경우 [InputController.set_dead_zone()]을 사용하여 설정한 기본 데드 존 값이 사용됩니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

dead_zone_size :

number?

컨트롤러로부터 읽어 온 값에 적용할 데드 존 크기입니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
반환하는 항목

stingray.Vector3

지정된 ID를 가지는 축에 대한 컨트롤러의 입력 값입니다.

데드 존 구성 컨트롤은 비-터치식 인터페이스에만 사용할 수 있습니다.

매개변수

name :

string

ID를 검색하려는 축의 이름입니다.

반환하는 항목

integer

축의 ID를 반환하거나, 이름이 일치하는 축이 없으면 nil을 반환합니다.

매개변수

id :

integer

이름을 검색하려는 축의 ID입니다.

반환하는 항목

string

축의 이름입니다.

매개변수

id :

integer

값을 검색하려는 버튼의 ID입니다.

반환하는 항목

number

0에서 1 사이의 값으로 표현되는 버튼의 현재 값입니다.

매개변수

name :

string

ID를 검색하려는 버튼의 이름입니다.

반환하는 항목

integer

버튼의 ID를 반환하거나, 이름이 일치하는 버튼이 없으면 nil을 반환합니다.

매개변수

id :

integer

이름을 검색하려는 버튼의 ID입니다.

반환하는 항목

string

버튼의 이름이거나, ID가 일치하는 버튼을 찾을 수 없는 경우 빈 문자열입니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

integer

컨트롤러에 있는 축의 수입니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

integer

컨트롤러에 있는 버튼의 수입니다.

매개변수

id :

integer

테스트하려는 버튼의 ID입니다.

반환하는 항목

boolean

플레이어가 이 프레임 중에 버튼을 눌렀으면 true를, 그렇지 않으면 false를 반환합니다.

매개변수

id :

integer

테스트하려는 버튼의 ID입니다.

반환하는 항목

boolean

플레이어가 이 프레임 중에 버튼을 놓았으면 true를, 그렇지 않으면 false를 반환합니다.

접점

이 그룹의 함수는 터치 컨트롤러로부터 손가락 터치 데이터를 가져오는 데 사용됩니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

integer*

모든 현재 접점의 색인을 반환합니다.

* 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다.
매개변수

contact_id :

integer

테스트할 접점의 ID입니다.

반환하는 항목

string?

이 접점이 터치 패널의 가장자리에서 비롯된 경우 이 문자열은 TOP, BOTTOM, RIGHT 또는 LEFT 중 하나의 값이 됩니다. 이 접점이 가장자리에서 비롯되지 않은 경우, 또는 가장자리 감지가 이 장치에서 지원되지 않는 경우에는 이 함수가 nil을 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

Android 플랫폼에서만 사용할 수 있습니다.

매개변수

contact_id :

integer

테스트할 접점의 ID입니다.

반환하는 항목

boolean

접점이 존재하면 true를, 그렇지 않으면 false를 반환합니다.

매개변수

contact_id :

integer

테스트할 접점의 ID입니다.

반환하는 항목

boolean

해당 접점이 기본 접점이면 true를 반환합니다.

매개변수

contact_id :

integer

테스트할 접점의 ID입니다.

반환하는 항목

boolean

접점이 이 프레임에서 초기화되었으면 true를 반환합니다.

매개변수

contact_id :

integer

테스트할 접점의 ID입니다.

반환하는 항목

boolean

접점이 이 프레임에서 해제되었으면 true를 반환합니다.

매개변수

contact_id :

integer

테스트할 접점의 ID입니다.

반환하는 항목

stingray.Vector3

현재 접점 위치의 X,Y 좌표입니다.

매개변수

contact_id :

integer

테스트할 접점의 ID입니다.

반환하는 항목

stingray.Vector3

이 프레임에서 이루어진 접점의 X,Y 좌표 변경 사항입니다.

매개변수

contact_id :

integer

테스트할 접점의 ID입니다.

반환하는 항목

number

장축에서의 지정된 접점의 크기(픽셀)입니다.

Android 플랫폼에서만 사용할 수 있습니다.

매개변수

contact_id :

integer

테스트할 접점의 ID입니다.

반환하는 항목

number

단축에서의 지정된 접점의 크기(픽셀)입니다.

Android 플랫폼에서만 사용할 수 있습니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

integer

현재 활성화되어 있는 터치 접점의 수입니다.

매개변수

contact_id :

integer

테스트할 접점의 ID입니다.

반환하는 항목

number

터치 패널에 가해지는 지정된 접점의 압력입니다.

Android 플랫폼에서만 사용할 수 있습니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

stingray.Vector3

컨트롤러에 대한 입력 좌표의 해상도입니다.

대개 X 및 Y축의 픽셀에 1:1로 매핑됩니다. Z축 좌표에는 접점의 최대 압력 값이 포함됩니다.

매개변수

contact_id :

integer

테스트할 접점의 ID입니다.

반환하는 항목

number

지정된 접점의 크기입니다.

이 값은 장치가 감지할 수 있는 가능한 최대의 터치 접점을 기준으로 정규화된 값입니다. 가능한 최소의 정규화된 크기는 0.0(접점이 없거나 측정할 수 없음)이며 가능한 최대의 정규화된 크기는 1.0(센서 영역이 포화 상태임)입니다. Android 플랫폼에서만 사용할 수 있습니다.

제스처

이 그룹의 함수는 터치 컨트롤러로부터 제스처 데이터를 가져오는 데 사용됩니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

stingray.Vector2?

길게 누르기 제스처가 시작된 위치를 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

boolean?

마지막 프레임 중에 제스처가 시작되었는지 여부를 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

boolean?

마지막 프레임 중에 제스처가 종료되었는지 여부를 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

stingray.Vector2?

제스처가 시작된 중심 위치를 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

number?

집기 제스처의 현재 배율 값을 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

number?

집기 제스처의 현재 scale_per_second 값을 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

낮은 프레임 속도에서는 begin과 ended 모두 동일한 호출에서 true를 반환할 수 있습니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

boolean?

마지막 프레임 중에 제스처가 시작되었는지 여부를 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

boolean?

마지막 프레임 중에 제스처가 종료되었는지 여부를 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

stingray.Vector2?

제스처가 시작된 중심 위치를 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

number?

라디안으로 표시되는 제스처의 총 누적 회전 값을 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

number?

제스처의 현재 초당 회전 값을 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

낮은 프레임 속도에서는 begin과 ended 모두 동일한 호출에서 true를 반환할 수 있습니다.

매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

stingray.SwipeDirection?

살짝 밀기의 방향을 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

stingray.Vector2?

가장 최근에 발생한 비연속 누르기의 위치를 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

number?

후속 누르기 수를 반환합니다. (iOS에서는 2-5, Android에서는 무제한)

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

stingray.Vector2?

가장 최근에 발생한 누르기의 위치를 반환합니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

사용되지 않는 함수

대신 해당 함수의 _id 버전을 사용하십시오.

매개변수

name :

string

ID를 검색하려는 축의 이름입니다.

반환하는 항목

integer

축의 색인을 반환하거나, 이름이 일치하는 축이 없으면 nil을 반환합니다.

축은 색인이 아닌 ID로 참조되어야 합니다. 대신 axis_id()를 사용하십시오.

매개변수

name :

string

ID를 검색하려는 버튼의 이름입니다.

반환하는 항목

integer

버튼의 색인을 반환하거나, 이름이 일치하는 버튼이 없으면 nil을 반환합니다.

버튼은 색인이 아닌 ID로 참조되어야 합니다. 대신 button_id()를 사용하십시오.

Please send us your comment about this page