Input

설치

스크립트 에디터의 소재(Matrials) 섹션 아래에 새로운 스크립트 칸을 생성하고, 스크립트 본문을 복사하여 추가 삽입해주시기 바랍니다. 스크립트는 Main 위에 있어야 합니다.

특징

• 전체키 입력 지원
• 마우스 포인터 표시
• 마우스 입력
• 스마트 무브 기능 (자동 이동)
• 마우스 휠로 스크롤 다운 가능
• 목적지 좌표 표시 기능
• 유니코드 처리

사용법

특정 키가 눌린 상태인지 체크합니다. 인자 값은 문자열, 심볼, 가상 키 코드 값 중 하나를 받습니다. 예를 들면, 인자 값에 'A'를 넘기면 해당 가상 키코드 값 65를 체크합니다.

p "]" if Input.press?("]")
p "[" if Input.press?("[")
p ";" if Input.press?(";")
p '"' if Input.press?('"')
p ">" if Input.press?(">")
p "<" if Input.press?("<")
p "?" if Input.press?("?")
p "\\" if Input.press?("\\")
p "-" if Input.press?("-")
p "+" if Input.press?("+")
p "~" if Input.press?("~")

가상 키 코드 값을 숫자 값으로 직접 입력하는 방법도 있습니다. 키 코드 221 은 자판 ']' 와 같습니다.

p "]" if Input.trigger?(221)

심볼을 사용할 경우, 다음 코드처럼 사용하면 됩니다. 보시는 것처럼, 심볼이라는 건 콜론(:) 문자로 시작합니다.

p "backspace" if Input.press?(:VK_BACK)

모든 가상 키 코드 값은 164 행을 참고하세요.

Input.trigger?(Symbol)
Input.repeat?(Symbol)
Input.release?(Symbol)
Input.press?(Symbol)
Input.trigger?(String)
Input.repeat?(String)
Input.release?(String)
Input.press?(String)
Input.mouse_trigger?(0)
Input.mouse_trigger?(1)
Input.mouse_trigger?(2)
Input.mouse_release?(0)
Input.mouse_release?(1)
Input.mouse_release?(2)
Input.mouse_press?(0)
Input.mouse_press?(1)
Input.mouse_press?(2)
Input.mouse_x
Input.mouse_y
TouchInput.x
TouchInput.y
TouchInput.z                  # 마우스 휠; 양수(+)면 휠을 위로 올리는 중. 음수(-)면 휠을 아래로 내리는 중. 기본 상태는 0;
TouchInput.wheel             # 마우스 휠; 양수(+)면 휠을 위로 올리는 중. 음수(-)면 휠을 아래로 내리는 중. 기본 상태는 0;
TouchInput.trigger?(:LEFT)
TouchInput.trigger?(:RIGHT)
TouchInput.trigger?(:MIDDLE)
TouchInput.press?(:LEFT)
TouchInput.press?(:RIGHT)
TouchInput.press?(:MIDDLE)
TouchInput.release?(:LEFT)
TouchInput.release?(:RIGHT)
TouchInput.release?(:MIDDLE)

소소한 팁

본 스크립트는 바닐라 상태의 RPG Maker VX Ace에서 사용하기 적합합니다. 하지만 본 스크립트는 Windows 플랫폼 용이기 때문에 윈도우즈에서만 돌아가며, Ruby/SDL 기반의 네코 플레이어나 MKXP에서 돌아가도록 설계되지 않았습니다. 또한 대부분의 입력 스크립트가 마우스 왼쪽 버튼을 클릭할 때 마치 결정키를 누른 것처럼 취급을 하는데요. 이 스크립트는 해당 스크립트들처럼 fake 키를 삽입하는 식으로 동작하지 않습니다.

마우스 입력과 키보드 입력은 정확히 구분되어야 합니다. 예를 들면, Window_Selectable을 부모로 가지고 있지 않은 Window에서는 마우스 왼쪽 버튼 클릭 여부를 검사하고자 할 땐 TouchInput.trigger?(:LEFT)나 TouchInput.press?(:LEFT) 등의 메소드를 이용하여 직접 체크하여야 합니다.

또한 한글 입력의 경우, 이것은 한글 입력 스크립트가 아니기 떄문에 한글 입력 스크립트가 포함되어있지 않습니다. 한글 입력의 경우, 별도의 애드온을 필요로 합니다. 한글 입력의 경우, DLL을 통해 Windows가 조합해주는 한글 문자를 가져오는 방식을 사용합니다.

Github RAW : RS_HangulNameInputProcessing.rb

DLL : RSEditHost.dll

이렇게 구현한 이유는 영어, 중국어, 일본어, 아랍어 등 여러가지 언어를 입력할 수 있게 하기 위함이며 한글 조합의 경우 많은 케이스를 필요로 하며 꽤 복잡합니다. 개인적으로 구현해보기도 했지만 혹 놓쳐 버린 버그로 인해 실제 게임에선 사용하진 않으며 사용 시 품질 저하로 이어질 수 있기 때문입니다.

다운로드

스크립트 : RS_Input.rb

Windows에서 마우스의 Wheel 값을 가져 오려면, 창을 생성할 때 등록된 윈도우 프로시저 함수를 서브 클래싱하여 휠 값에 해당하는 메시지를 처리해서 가져와야 합니다. 이러한 작업을 별도의 DLL 없이도 수행할 수는 있으나 루비로 구현하면 심각한 속도 저하 문제가 있습니다. 따라서 마우스 휠 값은 별도의 DLL에서 처리합니다.

DLL (마우스 휠 사용) : RS- InputCore.dll

인증 받지 않은 DLL 파일의 경우, 악성 코드로 오진하여 백신이 삭제하는 경우가 종종 있습니다. 인증서가 비싸기 대문에 별도로 인증서는 없습니다. 직접 빌드해서 사용하시려면 아래 링크에 있는 모든 파일을 받은 후, Visual Studio 2015 이상에서 RS-InputCore.sln 파일을 실행하여 Release 모드로 빌드를 해주시기 바랍니다.

DLL 소스 : 링크

마우스 휠 값 획득은 다음과 같이 C++로 작성된 코드이며 코드가 DLL로 빌드되고, 최종적으로 Input::RSGetWheelDelta.call을 통해 가져오게 됩니다.

LRESULT CALLBACK SuperProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
	switch (uMsg)
	{
	case WM_LBUTTONDOWN:
		SetFocus(g_hRGSSPlayer);
		break;
	case WM_MOUSEWHEEL:
		g_nWheelDelta = (SHORT(HIWORD(wParam)) > 0) ? 1 : -1;
		break;
	}
	return CallWindowProc(OldProc, hWnd, uMsg, wParam, lParam);
}

마우스 휠을 사용하고 싶지 않은 경우에 대해서는 선택권이 없습니다. 휠 처리를 사용하고 싶지 않다면 별도로 스크립트를 수정하셔야 합니다.

버전 로그

# v1.0.0 (2018.10.29) - First Release.
# v1.0.1 (2018.10.29) : 
# - Fixed the bug that causes an error when clicking the right button of the mouse.
# - Added the TouchInput feature that is the same as RPG Maker MV.
# - Fixed the issue that did not play the cursor sound when selecting the button using mouse
# v1.0.2 (2018.11.11)
# - Added the feature such as a path finding in RPG Maker MV
# - Added the destination sprite such as RPG Maker MV
# v1.0.3 (2019.01.20) :
# - Added the feature that can use the mouse wheel in the Save and Load scenes.
# v1.0.4 (2019.01.21) :
# - In the selectable window, Added the feature that can use the mouse wheel.
# v1.0.5 (2019.02.02) :
# - Added feature that can use the mouse left button in the Window_DebugRight
# v1.0.6 (2019.03.25) :
# - Added the repeat? method into Input class.
# v1.0.7 (2019.11.13) :
# - 마우스 왼쪽 클릭으로 비행선을 탑승할 수 없었던 문제를 수정하였습니다.
# - 목적지 스프라이트를 화면에서 감출 수 있는 기능을 추가하였습니다.
# - 비행선 탑승 후, 마우스 자동 이동 시 한 칸만 움직이고 멈추는 현상을 수정하였습니다.
# - TouchInput.update를 추가하였습니다.

사용 조건

상업적인 게임 및 비상업적인 게임에서 모두 무료로 이용 가능합니다.

단, 크레딧에 러닝은빛 또는 biud436을 기입해야 합니다.

참고

Lectures on Game Programming - 링크