stingray.Window 오브젝트 참조

설명

Win32 및 MacOS X에서의 응용프로그램 창을 나타냅니다.

다른 플랫폼에서는 창이 아닐 수도 있습니다.

Window 함수는 두 가지 방법으로 호출할 수 있습니다.

• 함수로 어떠한 Window 오브젝트도 전달하지 않습니다. 이 경우, 함수가 기본 응용프로그램 창에 영향을 미칩니다. 예:

  -- Sets the title of the main window
  Window.set_title("main window")
  

• 또는, 기존 Window 오브젝트를 함수로 전달합니다. 이 경우, 함수가 사용자가 전달하는 창에 영향을 미칩니다. 예:

  -- Creates a new window and sets its title
  win = Window.open()
  Window.set_title(win, "new window")
  

관련 샘플 코드

Appkit: /app.lua Appkit: /simple_project.lua 기본 템플릿: /main_menu.lua 캐릭터 템플릿: /main_menu.lua 차량 템플릿: /main_menu.lua Oculus VR 템플릿: /main_menu.lua 최소 템플릿: /boot.lua 마우스로 유닛 선택

기타 관련 참조 항목

	stingray.Application.back_buffer_size() stingray.Application.render_world() stingray.Camera.screen_to_world() stingray.Camera.world_to_screen() stingray.Gui.resolution() stingray.Profiler.render_stats()
	Core

관련 도움말 항목

게임플레이 생성 > Lua를 사용한 스크립팅 > 템플릿에서 Lua 시작: Appkit 사용 > Appkit을 통해 표준, 수준 및 카메라 관리

함수

clip_cursor ( window ) : booleanclip_cursor ( ) : boolean 창이 마우스 포인터가 경계 밖으로 이동하지 못하도록 막는지 여부를 나타냅니다.

매개변수

window :

stingray.Window

테스트할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.

반환하는 항목

boolean

창이 마우스 포인터를 경계 안쪽으로 가두는 경우 true를, 그렇지 않으면 false를 반환합니다.

close ( window ) close ( ) 지정한 창을 닫습니다.

매개변수

window :

stingray.Window

닫을 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.

반환하는 항목

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

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

get_dpi_scale ( ) : number DPI 배율을 가져옵니다.

매개변수

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

반환하는 항목

number

Windows DPI 배율입니다. 비-Windows 플랫폼의 경우 1.0입니다.

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

has_focus ( window ) : booleanhas_focus ( ) : boolean 창에 키보드 포커스가 있는지 여부를 나타냅니다.

매개변수

window :

stingray.Window

테스트할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.

반환하는 항목

boolean

창에 키보드 포커스가 있으면 true를, 그렇지 않으면 false를 반환합니다.

is_closing ( window ) : booleanis_closing ( ) : boolean 사용자가 지정된 창을 닫도록 요청했는지 여부를 나타냅니다.

매개변수

window :

stingray.Window

테스트할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.

반환하는 항목

boolean

사용자가 지정된 창에 대해 "닫기" 아이콘을 눌렀다면 true를 반환합니다.

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

is_resizable ( window ) : booleanis_resizable ( ) : boolean 창의 크기를 조절할 수 있는지 여부를 나타냅니다.

매개변수

window :

stingray.Window

테스트할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.

반환하는 항목

boolean

창의 경계를 크기 조절할 수 있다면 true를, 그렇지 않으면 false를 반환합니다.

maximize ( window ) maximize ( ) 창을 최대화합니다.

매개변수

window :

stingray.Window

최대화할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.

반환하는 항목

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

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

minimize ( window ) minimize ( ) 창을 작업 표시줄로 최소화합니다.

매개변수

window :

stingray.Window

최소화할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.

반환하는 항목

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

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

mouse_focus ( window ) : booleanmouse_focus ( ) : boolean 창에 마우스 포커스가 있는지 여부를 나타냅니다.

매개변수

window :

stingray.Window

테스트할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.

반환하는 항목

boolean

창에 마우스 포커스가 있으면 true를, 그렇지 않으면 false를 반환합니다.

창에 마우스 포커스가 있으면 사용자에게 보이지 않게 마우스 포인터를 숨기고 포인터가 창에서 벗어나지 않게 합니다.

open ( config ) 지정된 설정을 사용하여 새 창을 엽니다.

매개변수

config :

window_config?

선택 사항입니다. 새 창에 대한 설정을 제공하는 window_config 테이블입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

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

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

기타 관련 참조 항목

window_config

rect ( window ) : number, number, number, number 직사각형 창을 반환합니다.

반환하는 항목

number	창의 X 좌표
number	창의 Y 좌표
number	창의 폭
number	창의 높이

restore ( window ) restore ( ) 최대화한 창의 크기를 원래대로 복원하거나 최소화 상태의 창을 원래대로 복원합니다.

매개변수

window :

stingray.Window

최대화 또는 최소화 상태에서 원래대로 복원할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.

반환하는 항목

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

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

set_clip_cursor ( window, doClip ) set_clip_cursor ( doClip ) 창이 마우스 포인터가 경계 밖으로 이동하지 못하도록 막는지 여부를 결정합니다.

매개변수

window :	stingray.Window	커서 설정을 설정할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.
doClip :	boolean	창이 마우스 포인터를 경계 안쪽으로 가두도록 하려면 true를, 그렇지 않으면 false를 전달합니다.

반환하는 항목

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

관련 샘플 코드

Appkit: /simple_project.lua

set_cursor ( window, cursor ) set_cursor ( cursor ) 창에 대해 어떤 유형의 마우스 커서 리소스를 사용할지 결정합니다.

매개변수

window :	stingray.Window	마우스 커서를 설정할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.
cursor :	string	이 창에 대해 사용할 마우스 커서 리소스의 이름입니다.

반환하는 항목

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

이 커서는 창에 포커스가 있고, 창이 커서를 표시(show_cursor() 및 set_show_cursor() 참조)하도록 설정되어 있을 때 사용됩니다.

cursor 매개변수는 프로젝트 데이터 디렉토리에 있는 확장자가 .mouse_cursor인 리소스 파일의 이름이어야 합니다. 이 파일은 커서 이미지에 사용할 .texture 리소스를 가리키는 단일 texture 매개변수를 포함해야 합니다.

예를 들어 다음 행을 포함하는 content/camera.mouse_cursor라는 리소스를 만드는 경우입니다.

texture = "core/editor_slave/resources/gui/thumbnail_over"

다음을 호출하여 창에 할당할 수 있습니다.

stingray.Window.set_cursor("content/camera")

set_focus ( window ) set_focus ( ) 창에 키보드 포커스를 제공합니다.

매개변수

window :

stingray.Window

포커스를 설정할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.

반환하는 항목

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

set_ime_enabled ( window, isEnabled ) set_ime_enabled ( isEnabled ) 지정된 창에 대해 IME(입력기)를 활성화할지 여부를 결정합니다.

매개변수

window :	stingray.Window	구성할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.
isEnabled :	boolean	이 창에 대해 IME를 활성화해야 하는 경우 true, 그렇지 않으면 false로 설정합니다.

반환하는 항목

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

IME는 기본적으로 표시됩니다.

set_keystroke_enabled ( window, key, isEnabled ) set_keystroke_enabled ( key, isEnabled ) 지정된 창에 대해 특정 키 입력 또는 키 조합을 활성화할지 여부를 결정합니다.

매개변수

window :	stingray.Window	더 이상 사용되지 않음 - 이 창 매개변수는 무시되며, 구현 시 기본 응용프로그램 창을 사용합니다.
key :	integer	활성화하거나 비활성화할 키 입력 또는 키 조합입니다.
isEnabled :	boolean	이 창에 대해 지정된 키를 활성화해야 하는 경우 true, 그렇지 않으면 false로 설정합니다.

반환하는 항목

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

Window 오브젝트에 정의되어 있는 모든 키 입력 상수(KEYSTROKE_WINDOWS, KEYSTROKE_ALT_TAB, KEYSTROKE_ALT_ENTER 또는 KEYSTROKE_ALT_F4)가 허용됩니다.

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

set_mouse_focus ( window, focus ) set_mouse_focus ( focus ) 창에 마우스 포커스가 있어야 하는지 여부를 결정합니다.

매개변수

window :	stingray.Window	포커스를 설정할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.
focus :	boolean	창에 마우스 포커스를 제공하려면 true를 전달하고, 마우스 포커스를 제거하려면 false를 전달합니다.

반환하는 항목

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

관련 샘플 코드

Appkit: /simple_project.lua

set_rect ( window, x, y, width, height ) 직사각형 창을 설정합니다.

매개변수

x :	number	창의 X 좌표
y :	number	창의 Y 좌표
width :	number	창의 폭
height :	number	창의 높이

반환하는 항목

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

set_resizable ( window, resizeable ) set_resizable ( resizeable ) 창의 크기를 조절할 수 있는지 여부를 결정합니다.

매개변수

window :	stingray.Window	경계를 설정할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.
resizeable :	boolean	창의 경계를 크기 조절할 수 있어야 한다면 true를, 그렇지 않으면 false를 전달합니다.

반환하는 항목

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

set_resolution ( window, width, height ) : booleanset_resolution ( width, height ) : boolean 지정된 창의 해상도를 설정합니다.

매개변수

window :	stingray.Window	해상도를 설정할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.
width :	integer	창의 가로 폭(픽셀)입니다.
height :	integer	창의 세로 폭(픽셀)입니다.

반환하는 항목

boolean

해상도가 올바로 설정되었으면 true를, 그렇지 않으면 false를 반환합니다.

set_show_cursor ( window, do_show, restore_cursor_pos ) set_show_cursor ( doShow ) 창에 포커스가 있을 때 마우스 포인터를 표시할지 여부를 결정합니다.

매개변수

window :	stingray.Window	커서 설정을 설정할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.
do_show :	boolean	창에 포커스가 있을 때 마우스 포인터를 표시하려면 true를, 그렇지 않으면 false를 전달합니다.
restore_cursor_pos :	boolean	커서를 숨긴 후에 표시할 경우 커서가 마지막 표시되었던 위치에 나타나도록 하려면 이 매개변수에 true를 전달합니다. 커서가 운영 체제에 의해 추적되는 위치에 나타나도록 하려면 false를 전달합니다. 선택 사항입니다. 지정하지 않으면 true가 기본값으로 지정됩니다.

반환하는 항목

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

관련 샘플 코드

기본 템플릿: /main_menu.lua 캐릭터 템플릿: /main_menu.lua 차량 템플릿: /main_menu.lua Oculus VR 템플릿: /main_menu.lua

기타 관련 참조 항목

stingray.Window.set_cursor()

set_title ( window, title ) set_title ( title ) 창의 제목을 설정합니다.

매개변수

window :	stingray.Window	제목을 설정할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.
title :	string	창의 새 제목입니다.

반환하는 항목

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

show_cursor ( window ) : booleanshow_cursor ( ) : boolean 창에 포커스가 있을 때 마우스 커서를 표시하는지 여부를 나타냅니다.

매개변수

window :

stingray.Window

테스트할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.

반환하는 항목

boolean

창이 마우스 커서를 표시하도록 설정되어 있으면 true를, 그렇지 않으면 false를 반환합니다.

관련 샘플 코드

마우스로 유닛 선택

기타 관련 참조 항목

stingray.Window.set_cursor()

sync_layered_window ( window, x, y, width, height, visible, opacity ) 레이어드 창 직사각형 및 알파 상태를 설정합니다.

매개변수

x :	number	창의 X 좌표
y :	number	창의 Y 좌표
width :	number	창의 폭
height :	number	창의 높이
visible :	boolean	창이 숨겨지거나 표시되는지 여부를 나타냅니다.
opacity :	number	레이어드 창 투명도를 설정합니다.

반환하는 항목

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

trigger_resize ( window ) trigger_resize ( ) 지정된 창에 대해 'on_resize'를 수동으로 트리거합니다.

매개변수

window :

stingray.Window

크기 복원을 트리거할 창입니다. 선택 사항입니다. 지정하지 않으면 기본 응용프로그램 창을 사용합니다.

반환하는 항목

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

마지막으로 트리거한 이후 크기가 변경되지 않았다면 이 함수는 아무 효과가 없습니다. Windows 플랫폼에서만 사용할 수 있습니다.

Window 키 조합

창과 상호작용하는 키 입력 및 키 조합을 나타내는 데 사용되는 상수입니다.

KEYSTROKE_ALT_ENTER : integer Alt+Enter 키 조합을 나타냅니다.

기타 관련 참조 항목

stingray.Window.set_keystroke_enabled()

KEYSTROKE_ALT_F4 : integer Alt+F4 키 조합을 나타냅니다.

기타 관련 참조 항목

stingray.Window.set_keystroke_enabled()

KEYSTROKE_ALT_TAB : integer Alt+Tab 키 조합을 나타냅니다.

기타 관련 참조 항목

stingray.Window.set_keystroke_enabled()

KEYSTROKE_WINDOWS : integer Windows 키를 나타냅니다.

기타 관련 참조 항목

stingray.Window.set_keystroke_enabled()