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

stingray.Application 네임스페이스 참조
함수 | 개발 전용 | 새로운 표준 플래그 | 플랫폼 ID | Windows 및 Mac OS X
모두 확장 | 모두 축소

설명

전역 응용프로그램 기능에 액세스하는 인터페이스입니다.

이 응용프로그램은 싱글톤(응용프로그램이 하나뿐임)이기 때문에 어떠한 Application 오브젝트도 Application 함수로 전달할 필요가 없습니다. 모든 함수는 Application 싱글톤에서 작동합니다.

함수

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

string*

각 명령행 인수는 별도의 문자열로 반환됩니다.

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

window :

stingray.Window?

선택 사항입니다. PC에서 다수의 스왑 체인으로 렌더링할 때에만 사용됩니다.

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

number

픽셀로 나타낸 백 버퍼 해상도 폭입니다.

number

픽셀로 나타낸 백 버퍼 해상도 높이입니다.

이 명명된 "해상도"의 사용되지 않는 버전을 호출하지 마십시오.

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

integer

자동 로드된 리소스를 언로드할 간격띄우기입니다.

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

string

debug, dev or release 문자열 중 하나입니다.

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

string

엔진의 빌드 버전 번호를 식별하는 문자열입니다.

예: 2437 branch:release2.

엔진을 자체적으로 다시 빌드하는 경우 엔진 실행 프로그램을 빌드한 후에 사후 처리 단계에서 이 빌드 식별자를 설정할 수 있습니다. 빌드한 실행 프로그램에는 뒤에 0이 128개 붙는 a4e915264ceaa4424b3ed6d3d2fe5e1a 문자열이 포함됩니다. 0은 이 build_identifier() 함수가 반환하도록 할 원하는 문자열로 바꿀 수 있습니다.

매개변수

type :

string

검색할 리소스의 유형입니다.

name :

string

검색할 리소스의 이름입니다.

반환하는 항목

boolean

지정된 리소스가 사용 가능하면 true, 그렇지 않으면 false입니다.

매개변수

type :

string

오버라이드 중인 리소스의 유형입니다.

name :

string

오버라이드 중인 리소스의 이름입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수

name :

string

제거해야 하는 플래그입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수

command :

string

콘솔로 전송할 명령입니다.

parameters :

string*

명령과 함께 전달할 0개 이상의 추가 명령행 매개변수입니다.

* 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다.
반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

integer

콘솔의 포트 번호입니다.

매개변수

command :

console_commands

콘솔로 전송할 정보를 문자열-키 테이블로 표현한 것입니다.

data :

string?

전송할 이진 데이터에 대한 선택적 포인터입니다. 이 포인터가 제공될 경우 길이도 제공되어야 합니다.

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

length :

number?

이진 데이터의 길이(있는 경우)입니다.

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

이 함수를 사용하여 메시지, 경고 및 오류를 콘솔로 출력하거나 임의의 메시지를 엔진 콘솔 서버의 다른 클라이언트로 전송할 수 있습니다.

매개변수

world :

stingray.World

새로운 뷰포트에서 렌더링할 표준입니다.

viewport_template :

string

뷰포트의 특성을 결정하는 뷰포트 템플릿의 이름입니다.

반환하는 항목

stingray.Viewport

새롭게 생성된 Viewport입니다.

이 뷰포트를 사용하는 작업을 마치면 destroy_viewport()를 호출하여 이를 삭제해야 합니다.

매개변수

world :

stingray.World

삭제하려는 뷰포트에서 렌더링 중인 표준입니다.

viewport :

stingray.Viewport

삭제하려는 뷰포트입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수

offset :

integer

자동 로드된 리소스를 언로드할 간격띄우기입니다.

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

stingray.Entity

실행 중인 흐름 노드를 소유하는 엔티티입니다.

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

stingray.Level

실행 중인 흐름 노드를 소유하는 수준입니다.

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

stingray.Unit

실행 중인 흐름 노드를 소유하는 유닛입니다.

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

stingray.World

실행 중인 흐름 노드를 소유하는 표준입니다.

매개변수

indices :

any(integer, string)+

정수 또는 문자열일 수 있는 데이터에 대한 하나 이상의 색인입니다.

+ 표기는 지정된 유형의 인스턴스가 1개 이상 있을 수 있음을 나타냅니다.
any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
반환하는 항목

any

지정된 색인 시퀀스에 저장된 데이터 값입니다(해당하는 경우).

매개변수

indices :

any(integer, string)+

정수 또는 문자열일 수 있는 데이터에 대한 하나 이상의 색인입니다.

+ 표기는 지정된 유형의 인스턴스가 1개 이상 있을 수 있음을 나타냅니다.
any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

stingray.World

가장 중요한 것으로 결정된 World입니다.

이 표준은 일반적으로 어떤 일이 일어나는 표준이며, 이 표준에서 입자 효과, 사운드 등을 테스트해볼 수 있습니다.

"가장 중요한" 표준은 대부분의 유닛이 포함된 마지막 프레임으로 렌더링된 표준으로 정의됩니다.

매개변수

values :

any+

해시 생성 시 사용할 값입니다. 이 목록에는 하나 이상의 값이 포함되어야 합니다. 숫자, nil, 문자열, 그리고 문자열로 표현된 16진수가 허용됩니다.

+ 표기는 지정된 유형의 인스턴스가 1개 이상 있을 수 있음을 나타냅니다.
반환하는 항목

string

64비트 16진수 해시입니다.

매개변수

flags :

integer*

새로운 표준의 특성을 설정하는 모든 New World Flags입니다.

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

stingray.World

새롭게 생성된 표준입니다.

원하는 수만큼 게임 표준을 생성할 수 있습니다. 화면 또는 인벤토리 룸 로드와 같은 작업에는 게임 표준이 여러 개인 것이 유용할 수 있습니다.

참고: 생성한 표준을 모두 사용한 후에는 항상 release_world()를 호출하여 모든 표준의 점유를 풀어주십시오.

매개변수

url :

string

열려는 URL입니다.

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

string

WIN32 또는 ANDROID 등 Application 오브젝트의 플랫폼 상수 중 하나입니다.

매개변수

exit_code :

integer?

제공된 경우 응용프로그램 종료 코드를 지정합니다.

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

이 함수는 SDK로부터의 종료 요청 없이는 종료하는 것이 금지되어 있기 때문에 PlayStation 3에는 없습니다.

매개변수

package :

stingray.ResourcePackage

삭제해야 하는 패키지입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수

world :

stingray.World

삭제하려는 World입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.

이 함수는 특정 표준을 사용한 작업을 완전히 끝냈을 때 호출해야 합니다.

매개변수

caps :

string+

상태를 검색할 하나 이상의 렌더 캡입니다.

+ 표기는 지정된 유형의 인스턴스가 1개 이상 있을 수 있음을 나타냅니다.
반환하는 항목

boolean+

각 인수마다 별도의 부울 값을 반환합니다.

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

world :

stingray.World

렌더링하려는 World입니다.

camera :

stingray.Camera

렌더링의 관점을 정의하는 Camera입니다.

viewport :

stingray.Viewport

렌더링을 포함할 Viewport입니다.

shading_environment :

stingray.ShadingEnvironment

렌더링 특성을 결정하는 ShadingEnvironment입니다. 참고: 표준에 로드된 어느 수준에든 음영처리 환경 엔티티가 존재하는 경우 이 매개변수가 사용되지 않습니다. 대신 엔티티로부터 설정을 읽어옵니다.

window :

stingray.Window?

선택 사항입니다. PC에서 다수의 스왑 체인으로 렌더링할 때에만 사용됩니다.

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

name :

string

새 리소스 패키지 생성 시 사용할 .package 파일의 파일 이름입니다.

반환하는 항목

stingray.ResourcePackage

새 리소스 패키지입니다.

참고: 리소스 패키지를 모두 사용한 후에는 항상 release_resource_package()를 호출하여 모든 리소스 패키지의 점유를 풀어주십시오.

매개변수

name :

string

새 리소스 패키지 생성 시 사용할 번들 파일의 URL입니다.

반환하는 항목

stingray.ResourcePackage

새 리소스 패키지입니다.

참고: 리소스 패키지를 모두 사용한 후에는 항상 release_resource_package()를 호출하여 모든 리소스 패키지의 점유를 풀어주십시오.

매개변수

local_filename :

string?

선택 사항입니다. 지정되어 있는 경우 새 로그가 이 경로를 사용합니다. 지정되어 있지 않으면 마지막 로그를 덮어씁니다.

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

remote_filename :

string?

선택 사항입니다. 지정되어 있는 경우 새 원격 로그가 이 경로를 사용합니다. 지정되어 있지 않으면 마지막 원격 로그를 덮어씁니다.

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

이 함수로 전달하는 경로 및 파일 이름에는 자동으로 확장되는 다음 변수가 포함될 수 있습니다.

  • %%APPDATA%%: 사용자 데이터 저장을 위한 플랫폼별 폴더입니다. 예를 들어, Windows에서는 C:\Users\<username>\AppData, Mac OS에서는 ~/Library/Application Support입니다.
  • %%HOSTNAME%%: 컴퓨터의 호스트 이름입니다.
  • %%DATE%%: YYYY-MM-DD 형식의 현재 날짜입니다.
  • %%TIME%%: HH.MM.SS 형식의 현재 시간입니다.
  • %%RANDOM%%: 8개의 임의 문자입니다.
  • %%OBBPATH%%: Android에서 OBB 파일 디렉토리의 경로입니다.
매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.

경로 및 파일 이름은 settings.ini 파일의 win32.user_settings 또는 macosx.user_settings 키에 의해 결정됩니다. 파일 이름의 문자열 %%APPDATA%%는 사용자의 AppData 또는 Application Support 폴더로 확장됩니다. 예를 들면 다음과 같습니다.

win32 = {
user_settings = "%%APPDATA%%\\CompanyName\\GameTitle\\user_settings.config"
}

macosx = {
user_settings = "%%APPDATA%%/CompanyName/GameTitle/user_settings.config"
}
매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

table

settings.ini 파일의 script_data 설정에서 읽어온 데이터를 포함하고 있는 테이블입니다.

매개변수

isEnabled :

boolean

자동 로드를 활성화하려면 true, 아니면 false로 설정합니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.

활성화한 경우 패키지 시스템이 비활성화되고, 액세스하는 모든 리소스가 자동으로 로드됩니다.

매개변수

indices :

any(integer, string)

정수 또는 문자열일 수 있는 데이터에 대한 하나 이상의 색인입니다.

any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.

value :

any

저장할 값입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.

나중에 동일한 색인을 get_data() 호출에 전달하여 데이터를 검색할 수 있습니다.

매개변수

type :

string

오버라이드할 리소스의 유형입니다.

name :

string

오버라이드할 리소스의 이름입니다.

override :

string

대체해야 하는 리소스입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.

즉, 엔진 시스템이 리소스 name을 요청할 때마다 리소스 override가 대신 반환됩니다. 오버라이드를 제거하려면 clear_resource_override()를 사용합니다.

매개변수

flag :

string

우선 순위를 설정해야 하는 플래그입니다.

priority :

integer

플래그의 우선 순위입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.

이 값은 리소스 오버라이드를 런타임 플래그로 컴파일할 때 사용됩니다. 리소스가 요청되면 해당 플래그에 해당하는 오버라이드 중 가장 높은 우선순위를 가지는 오버라이드가 사용됩니다. 기준 리소스(플래그 없음)는 우선순위가 0인 것으로 간주됩니다. 오버라이드 플래그를 제거하려면 clear_resource_override_flag()를 사용합니다.

매개변수

properties :

number

정의된 Pen Service Properties 값의 임의의 조합일 수 있습니다. (예: stingray.Input.TabletPenServiceProperty.DISABLE_PRESSANDHOLD + Input.TabletPenServiceProperty.DISABLE_SMOOTHSCROLLING).

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수

params :

any+

구성 매개변수와 해당 값의 목록입니다.

+ 표기는 지정된 유형의 인스턴스가 1개 이상 있을 수 있음을 나타냅니다.
반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.

이 함수는 다음 매개변수를 수용합니다.

  • "variable": 엔진이 가변 시간 단계를 사용하도록 구성합니다. 이것이 기본 시간 단계 설정입니다.
  • "fixed", fps: 엔진이 지정된 프레임 속도에서 고정 시간 단계로 실행되도록 구성합니다. 결국 취해진 시간 단계가 항상 1/fps의 배수가 됩니다. 엔진이 지정된 프레임 속도보다 빠르게 실행되면 0 길이 시간 단계를 취함으로써 이를 상쇄합니다.
  • "throttle", fps: 엔진을 지정된 프레임 속도까지 스로틀합니다. 엔진이 요청된 속도로 실행되도록 늦춰집니다. 이는 프레임 속도가 느린 경우에만 나타나는 문제를 디버깅하는 데 사용할 수도 있습니다.
  • "no_throttle": 스로틀링을 비활성화합니다. 기본 설정입니다.
  • "variable": 스로틀링을 비활성화합니다. 기본값입니다.
  • "smoothing", frames, outliers, lerp: 엔진이 평균화 시간 단계를 사용하도록 구성합니다. 가변 시간 단계를 사용할 때에는 다수의 프레임에서 시간 단계를 평균화하면 게임이 버벅거리는 느낌이 덜해질 수 있습니다. frames 값이 평균화할 프레임 수를 지정합니다. outliers 값이 몇 개의 극한 값을 제거할지 지정합니다. 예를 들어, 값이 2일 경우 평균을 계산하기 전에 최고값 2개와 최저값 2개를 제거합니다. lerp 값이 계산된 평균에서 얼마나 빠르게 변할 수 있는지를 지정합니다. 값이 낮을수록 더 평균화되고, 값이 높을수록 덜 평균화됩니다. 기본값은 11, 2, 0.1입니다.
  • "no_smoothing": 시간 단계 평균화를 비활성화합니다.
  • "debt_payback", frames: 0이 아닌 값으로 설정하는 경우 타이머가 시간 빚(time debt), 즉 평균화 등으로 인해 게임 시간이 외부 표준 시간과 얼마나 차이가 났는지를 계속 추적합니다. 그리고 추가 시간을 더하여 지정된 프레임 수에 걸쳐 시간 빚을 청산하려고 노력합니다. 그렇게 하지 않으면 게임이 시간을 "잃어버릴" 수 있으므로 네트워킹 등의 목적에서 게임을 외부 시간과 동기화시켜야 하는 경우에는 이 설정이 유용할 수 있습니다. 기본값은 0입니다.
  • "external_step_range", min, max: 외부 표준 시간이 시스템에 입력되기 전에 이를 지정된 범위로 고정시키도록 지정합니다. 디버거를 확인할 때 시스템이 정말 큰 시간 단계를 취하지 못하게 하는 데 유용합니다. 기본값은 0, 0.2입니다.
  • "external_multiplier", multiplier: 디버깅을 위해 시간을 가속화하거나 감속하는 데 사용할 수 있는 승수를 설정합니다. 기본값은 1입니다.
  • "system_step_range", min, max: 게임이 취할 수 있는 최소 및 최대 단계를 지정합니다. 기본값은 0, 0.2입니다.
  • "clear_history": 누적된 시간 빚 기록, 평균화 기록 등을 지웁니다.
  • "jump", time: 지정된 시간(초)만큼 타이머가 다음 프레임으로 건너뜁니다. 긴 애니메이션을 미리볼 때 유용합니다.
매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

string

게임을 실행하는 하드웨어를 설명하는 문자열입니다.

이는 대개 오류가 발생한 하드웨어에 관한 추가 정보를 더하기 위해 오류 메시지에 사용됩니다. 해당 정보는 오류 진단 및 해결에 도움이 될 수 있습니다.

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

number

경과 시간(초)입니다.

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

boolean

사용자 설정 파일이 존재하지만 로드할 수 없는 경우 true, 그렇지 않으면 false입니다.

이 함수가 true를 반환하면 파일이 손상되었을 수 있습니다. 이 경우 기본 문자열이 사용됩니다. 데이터 파일 누락은 로드 오류로 인식되지 않습니다.

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

stingray.World[]

World 오브젝트의 테이블입니다.

[] 표기는 이 유형이 어레이임을 나타냅니다. 어레이는 구성원의 키가 순차적인 정수이며, 각 요소의 값이 표시된 유형의 인스턴스인 테이블입니다.

개발 전용

이 그룹의 요소는 개발 빌드에서만 사용할 수 있습니다.

최종 빌드에서는 사용하지 마십시오.

매개변수

name :

string

로드할 패키지입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.

set_autoload_enabled()를 참조하십시오.

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

string

새로운 전역 고유 식별자입니다.

Windows 플랫폼에서 개발자 빌드 또는 Xbox One에서만 사용할 수 있습니다.

매개변수

milliseconds :

number

잠들 시간(밀리초)입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수

enabled :

boolean

개발 전용 경고를 활성화해야 하는 경우 true입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.

새로운 표준 플래그

이 그룹에 나열되어 있는 상수는 Application.new_world() 호출 시 인수로 전달될 수 있습니다.

이 플래그를 Application.new_world()로 전달하는 경우 리소스 예산에 대한 원하는 값을 나타내는 추가 인수도 전달해야 합니다.

DISABLE_APEX_CLOTH : integer

표준에서 Apex 의상 시뮬레이션을 비활성화합니다.

DISABLE_PHYSICS : integer

표준에서 물리적 요소를 비활성화합니다.

DISABLE_RENDERING : integer

표준에서 렌더링을 비활성화합니다.

DISABLE_SOUND : integer

표준에서 사운드 재생을 비활성화합니다.

개발 빌드에서만 사용할 수 있습니다.

플랫폼 ID

stingray.Application.platform()

IOS = "ios" : string

iOS 플랫폼을 내부적으로 나타내는 데 사용하는 문자열입니다.

LINUX = "linux" : string

Linux 플랫폼을 내부적으로 나타내는 데 사용하는 문자열입니다.

MACOSX = "macosx" : string

Mac OS 플랫폼을 내부적으로 나타내는 데 사용하는 문자열입니다.
기본 템플릿: /main_menu.lua
캐릭터 템플릿: /main_menu.lua
차량 템플릿: /main_menu.lua
Oculus VR 템플릿: /main_menu.lua

UWP = "uwp" : string

UWP 플랫폼을 내부적으로 나타내는 데 사용하는 문자열입니다.

WEB = "web" : string

웹 플랫폼을 내부적으로 나타내는 데 사용하는 문자열입니다.
stingray.Application.platform()
기본 템플릿: /main_menu.lua
캐릭터 템플릿: /main_menu.lua
차량 템플릿: /main_menu.lua
Oculus VR 템플릿: /main_menu.lua

Windows 및 Mac OS X

이 그룹의 함수는 Windows 및 Mac OS X 플랫폼에서만 사용할 수 있습니다.

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

table

각각 단일 디스플레이 모드를 설명하는 Vector3 오브젝트의 테이블입니다. 각 Vector3에는 해당 정보가 (width, height, screen_index)와 같이 저장됩니다.

참고: 이 함수는 더 이상 사용되지 않는 것으로, 단지 이전 버전과의 호환성 유지를 위해서만 존재합니다. 새로운 모든 개발에서는 대신 DisplayAdapter 인터페이스를 사용하십시오.

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

integer

프로세스 ID입니다.

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

시작 후에 PC에 새로 연결된 PS4 컨트롤러는 자동으로 감지되지 않습니다. 연결된 컨트롤러를 감지 및 설정하고, 분리된 컨트롤러에 대한 참조를 제거하려면 이 함수를 사용합니다.

이 함수를 호출하면 컨트롤러 순서가 변경될 수 있기 때문에 각 PS4Pad1 인터페이스가 서로 다른 물리적 장치를 나타낼 수도 있습니다.

이 함수를 호출한 후에 처음으로 감지된 PS4 컨트롤러가 PS4Pad1로 사용되고, 두 번째가 PS4Pad2로 사용되는 식입니다. 이 함수를 여러 번 호출하는 경우 컨트롤러 순서가 유지된다는 보장이 없습니다. 즉, 이전에 PS4Pad3으로 감지된 컨트롤러가 이제 PS4Pad1이 될 수도 있습니다.

이 함수는 Windows에만 있습니다.

매개변수

frames :

number

최대 프레임 수이거나, 프레임 스태킹을 비활성화하려는 경우에는 -1입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.

이 함수는 라운드 로빈 방식으로 프레임마다 한 번씩 D3D11_QUERY_EVENT를 발행하여 구현하고, 그러면 모든 프레임이 대기열에서 가장 오래 된 이벤트를 대기합니다.

이 기능은 성능이 느린 시스템에서 "마우스 랙"을 줄이기 위한 기능입니다. Windows 플랫폼에서만 사용할 수 있습니다.

참고: 꼭 필요한 경우가 아니면 이 기능은 사용하지 않는 것이 가장 좋습니다. 단지 최후의 수단으로만 생각해야 합니다.

매개변수

indices :

any(integer, string)

정수 또는 문자열일 수 있는 데이터에 대한 하나 이상의 색인입니다.

any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.

value :

any

저장할 값입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.

나중에 동일한 색인을 user_setting() 호출에 전달하여 데이터를 검색할 수 있습니다. 디스크에 대한 변경 사항을 유지하려면 save_user_settings()도 참조하십시오.

매개변수

indices :

any(integer, string)+

정수 또는 문자열일 수 있는 데이터에 대한 하나 이상의 색인입니다.

+ 표기는 지정된 유형의 인스턴스가 1개 이상 있을 수 있음을 나타냅니다.
any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
Please send us your comment about this page