stingray.TouchPanel 네임스페이스 참조

설명

더 이상 사용되지 않습니다. stingray.TouchPanel1을 사용하십시오.

기타 관련 참조 항목

User Input

함수

accelerator_resolution ( ) : stingray.Vector3 컨트롤러의 가속도계 해상도를 검색합니다.

매개변수

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

반환하는 항목

stingray.Vector3

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

active ( ) : boolean 컨트롤러가 active 상태, 즉 기대한 대로 연결되어 작동 중인지 여부를 나타냅니다.

매개변수

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

반환하는 항목

boolean

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

connected ( ) : boolean 컨트롤러가 이 프레임에 연결되었는지 여부를 나타냅니다.

매개변수

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

반환하는 항목

boolean

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

disconnected ( ) : boolean 컨트롤러가 이 프레임에서 분리되었는지 여부를 나타냅니다.

매개변수

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

반환하는 항목

boolean

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

name ( ) : string 컨트롤러의 고유한 이름(예: "Xbox Controller 1")을 반환합니다.

매개변수

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

반환하는 항목

string

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

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

type ( ) : string 이 컨트롤러에 사용되는 하드웨어 장치의 설명을 반환합니다.

매개변수

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

반환하는 항목

string

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

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

기타 관련 참조 항목

stingray.TouchPanel.name()

버튼 및 축

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

any_pressed ( ) : integer? 플레이어가 현재 프레임에서 어떤 버튼을 눌렀는지 여부를 나타냅니다.

매개변수

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

반환하는 항목

integer?

플레이어가 이 프레임에서 누른 첫 번째 버튼의 ID를 반환하거나, 아무 버튼도 누르지 않은 경우에는 nil을 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

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

any_released ( ) : integer? 플레이어가 현재 프레임에서 어떤 버튼을 놓았는지 여부를 나타냅니다.

매개변수

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

반환하는 항목

integer?

플레이어가 이 프레임에서 놓은 첫 번째 버튼의 ID를 반환하거나, 아무 버튼도 놓지 않은 경우에는 nil을 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

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

axis ( id, dead_zone_mode, dead_zone_size ) : stingray.Vector3 컨트롤러의 단일 축에 대한 입력 값을 반환합니다.

매개변수

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를 가지는 축에 대한 컨트롤러의 입력 값입니다.

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

axis_id ( name ) : integer 컨트롤러에서 지정된 이름의 축 ID(있는 경우)를 검색합니다.

매개변수

name :

string

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

반환하는 항목

integer

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

기타 관련 참조 항목

stingray.TouchPanel.axis_index()

axis_name ( id ) : string 컨트롤러에서 지정된 ID의 축 이름을 검색합니다.

매개변수

id :

integer

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

반환하는 항목

string

축의 이름입니다.

button ( id ) : number 지정된 ID를 가진 버튼의 현재 입력 값을 반환합니다.

매개변수

id :

integer

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

반환하는 항목

number

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

button_id ( name ) : integer 컨트롤러에서 지정된 이름의 버튼 ID(있는 경우)를 검색합니다.

매개변수

name :

string

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

반환하는 항목

integer

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

기타 관련 참조 항목

stingray.TouchPanel.button_index()

button_name ( id ) : string 컨트롤러에서 지정된 ID의 버튼 이름을 검색합니다.

매개변수

id :

integer

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

반환하는 항목

string

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

num_axes ( ) : integer 컨트롤러에 있는 축의 수를 반환합니다.

매개변수

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

반환하는 항목

integer

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

num_buttons ( ) : integer 컨트롤러에 있는 버튼의 수를 반환합니다.

매개변수

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

반환하는 항목

integer

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

pressed ( id ) : boolean 플레이어가 이 프레임 중에 지정된 ID의 버튼을 눌렀는지 여부를 나타냅니다.

매개변수

id :

integer

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

반환하는 항목

boolean

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

released ( id ) : boolean 플레이어가 이 프레임 중에 지정된 ID의 버튼을 놓았는지 여부를 나타냅니다.

매개변수

id :

integer

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

반환하는 항목

boolean

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

접점

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

contacts ( ) : integer* 현재 컨트롤러에서 활성화된 모든 접점을 검색합니다.

매개변수

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

반환하는 항목

integer*

모든 현재 접점의 색인을 반환합니다. * 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다.

edge ( contact_id ) : string? 이 접점이 비롯된 가장자리(있는 경우)를 나타냅니다.

매개변수

contact_id :

integer

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

반환하는 항목

string?

이 접점이 터치 패널의 가장자리에서 비롯된 경우 이 문자열은 TOP, BOTTOM, RIGHT 또는 LEFT 중 하나의 값이 됩니다. 이 접점이 가장자리에서 비롯되지 않은 경우, 또는 가장자리 감지가 이 장치에서 지원되지 않는 경우에는 이 함수가 nil을 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

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

has_contact ( contact_id ) : boolean 지정된 ID의 접점이 존재하는지 여부를 나타냅니다.

매개변수

contact_id :

integer

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

반환하는 항목

boolean

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

is_primary ( contact_id ) : boolean 지정된 ID의 접점이 기본 접점으로 간주되는지 여부를 나타냅니다.

매개변수

contact_id :

integer

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

반환하는 항목

boolean

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

is_touch_down ( contact_id ) : boolean 지정된 ID의 접점이 이 프레임에서 초기화되었는지 여부를 나타냅니다.

매개변수

contact_id :

integer

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

반환하는 항목

boolean

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

is_touch_up ( contact_id ) : boolean 지정된 ID의 접점이 이 프레임에서 해제되었는지 여부를 나타냅니다.

매개변수

contact_id :

integer

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

반환하는 항목

boolean

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

location ( contact_id ) : stingray.Vector3 터치 패널에서 지정된 접점의 위치를 검색합니다.

매개변수

contact_id :

integer

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

반환하는 항목

stingray.Vector3

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

location_delta ( contact_id ) : stingray.Vector3 이전 프레임의 접점 위치와 현재 프레임의 현재 접점 위치 간 차이를 검색합니다.

매개변수

contact_id :

integer

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

반환하는 항목

stingray.Vector3

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

major_axis_size ( contact_id ) : number 장축(접점 영역의 더 긴 차원)을 따라 지정된 접점의 크기를 검색합니다.

매개변수

contact_id :

integer

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

반환하는 항목

number

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

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

minor_axis_size ( contact_id ) : number 단축(접점 영역의 더 짧은 차원)을 따라 지정된 접점의 크기를 검색합니다.

매개변수

contact_id :

integer

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

반환하는 항목

number

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

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

num_contacts ( ) : integer 현재 컨트롤러에 활성화되어 있는 터치 접점의 수를 검색합니다.

매개변수

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

반환하는 항목

integer

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

pressure ( contact_id ) : number 지정된 접점이 터치 패널의 표면에 가하는 압력을 검색합니다.

매개변수

contact_id :

integer

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

반환하는 항목

number

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

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

resolution ( ) : stingray.Vector3 컨트롤러에 대한 입력 좌표의 해상도를 검색합니다.

매개변수

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

반환하는 항목

stingray.Vector3

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

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

size ( contact_id ) : number 지정된 접점의 크기를 검색합니다.

매개변수

contact_id :

integer

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

반환하는 항목

number

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

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

제스처

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

gesture_long_press ( ) : stingray.Vector2? 길게 누르기 제스처가 발생하지 않으면 nil을 반환하고, 그렇지 않으면 제스처가 시작된 위치를 반환합니다.

매개변수

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

반환하는 항목

stingray.Vector2?

길게 누르기 제스처가 시작된 위치를 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

gesture_pinch ( ) : boolean?, boolean?, stingray.Vector2?, number?, number? 활성 집기 제스처가 없으면 nil을 반환하고, 그렇지 않으면 집기 제스처와 연관된 모든 값을 반환합니다.

매개변수

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

반환하는 항목

boolean?	마지막 프레임 중에 제스처가 시작되었는지 여부를 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
boolean?	마지막 프레임 중에 제스처가 종료되었는지 여부를 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
stingray.Vector2?	제스처가 시작된 중심 위치를 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
number?	집기 제스처의 현재 배율 값을 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
number?	집기 제스처의 현재 scale_per_second 값을 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

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

gesture_rotate ( ) : boolean?, boolean?, stingray.Vector2?, number?, number? 활성 회전 제스처가 없으면 nil을 반환하고, 그렇지 않으면 회전 제스처와 연관된 모든 값을 반환합니다.

매개변수

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

반환하는 항목

boolean?	마지막 프레임 중에 제스처가 시작되었는지 여부를 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
boolean?	마지막 프레임 중에 제스처가 종료되었는지 여부를 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
stingray.Vector2?	제스처가 시작된 중심 위치를 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
number?	라디안으로 표시되는 제스처의 총 누적 회전 값을 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
number?	제스처의 현재 초당 회전 값을 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

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

gesture_swipe ( ) : stingray.SwipeDirection? 살짝 밀기 제스처가 없으면 nil을 반환하고, 그렇지 않으면 살짝 밀기 제스처의 방향을 반환합니다.

매개변수

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

반환하는 항목

stingray.SwipeDirection?

살짝 밀기의 방향을 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

gesture_tap ( ) : stingray.Vector2? 누르기가 발생하지 않았으면 nil을 반환하고, 그렇지 않으면 가장 최근에 발생한 비연속 누르기의 위치를 반환합니다.

매개변수

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

반환하는 항목

stingray.Vector2?

가장 최근에 발생한 비연속 누르기의 위치를 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

gesture_tap_sequence ( ) : number?, stingray.Vector2? 누르기가 발생하지 않았으면 nil을 반환하고, 그렇지 않으면 잇따라 발생한 것으로 확정된 후속 누르기 수를 반환합니다. 여기에서 더 이상 후속 누르기가 없는 것으로 확정되려면 각 누르기 이후 0.35초가 지나야 합니다.

매개변수

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

반환하는 항목

number?	후속 누르기 수를 반환합니다. (iOS에서는 2-5, Android에서는 무제한) ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
stingray.Vector2?	가장 최근에 발생한 누르기의 위치를 반환합니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

사용되지 않는 함수

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

axis_index ( name ) : integer 더 이상 사용되지 않습니다.

매개변수

name :

string

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

반환하는 항목

integer

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

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

button_index ( name ) : integer 더 이상 사용되지 않습니다.

매개변수

name :

string

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

반환하는 항목

integer

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

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