2015년 8월 31일 (월) 15:27 판

LXVM

개요

LXVM 클래스는 피니엔진 에디터 및 런타임에서 루아로 컴파일된 LNX 를 구동시키기 위한 일종의 가상 머신 클래스입니다.

스크립트 불러오기 실행 호출 및, 리턴값 반환 등, 코드 구동에 핵심적인 기능만 포함되어 있습니다.

보통 vm 이라는 인자로 전달되며, pini.XVM 으로도 접근할 수 있습니다.

LXVM 에서는 여러개의 콜 스택을 허용하며, 각각의 콜 스택을 "루프" 라고 부릅니다.

따라서, LXVM 에서는 루프를 생성하거나 일시정지하고, 삭제하는 기능 등을 제공합니다.

또한, 저장과 불러오기 기능을 위한 덤프 및 복구 기능도 제공하고, 그것을 위한 구조로 구성되어 있습니다.

전역 상수

이름	설명
OnPreview	에디터인지 리모트인지를 알려주는 상수입니다. true 이면 에디터이고, false이면 리모트입니다.

전역 함수

이름	설명
_VM_LOOP_(fname,fns,stckInfo,new_arg,del_arg,start_i,rets,scall)	LNX 매크로를 실제로 돌려주는 함수입니다.

전역 변수

이름	설명
_LNXF	LNX 스크립트 및 매크로가 들어있는 테이블입니다.
_LNXB	북마크 위치가 들어있는 테이블입니다.
_LNXVT	변수 트리거 정보가 들어있는 테이블입니다.
_LNXG	변수 정보를 읽고 쓸 수 있게 되어있는 테이블입니다. 일반적인 읽기 쓰기는 이것으로 접근합니다.
_LNXGP	변수 정보가 실제로 들어가있는 테이블입니다. 특수한 읽기 쓰기일 경우에만 이것으로 접근합니다.

멤버 변수

이름	설명
loops	현재 존재하는 모든 루프를 저장하는 테이블의 배열
currentLoop	현재 실행중인 loops 의 테이블을 가르킴

멤버 함수

이름	설명
init()	vm 을 초기화하는 함수입니다. 단, 현재 vm 으로 실행중인 코드는 중지하지 않습니다.
_return()	현재 실행중인 매크로를 종료합니다.
returnValue(ret)	현재 실행중인 매크로가 ret 를 반환하게 합니다.
returnValueOnThread(ret,idx)	지정한 idx 루프번호에서 진행중인 매크로가 ret 를 반환하게 합니다. 결과를 반환해야 하지만 즉시 반환하지는 않고, pause 등을 사용해서 결과가 지연될 경우에 사용합니다.
ARGU(fname, arg, default)	fname 매크로의 arg 인자를 가져옵니다. 존재하지 않는다면, 기본 값을 가져옵니다. 둘 다 존재하지 않는다면, default 를 반환합니다.
currentLoopIdx()	현재 돌고있는 루프의 번호를 가져옵니다.
removeLoop(infotable)	infotable에 해당되는 루프를 loops 에서 제거합니다.
stop()	현재 루프를 일시정지합니다. 그리고, 루프번호를 반환합니다.
resume(idx)	stop 에서 반환받은 번호를 idx 로 전달해 주면, 일시정지를 해제합니다.
sleep(time)	지정한 time초 만큼 루프를 일시정지합니다.
GotoBookmark(bmk)	지정한 북마크로 이동합니다.
GotoBookmarkNewCall(bmk)	지정한 북마크 위치부터 시작하는 새로운 매크로를 호출합니다.
resumeAndGoBookmark(idx,bmk)	지정한 idx 루프번호로 현재 루프를 전환한 뒤, 지정한 묵마크로 이동합니다.
OpenLNX(file)	지정한 file 을 로드합니다. file 은 .lua 또는 .lnx 파일입니다. 대소문자에 맞게 확장자까지 모두 적어주어야 하며, .lnx 의 경우 실행하지는 않지만, .lua 인 경우, 코드 자체는 한번 실행 합니다.
call(stckName, start_i, fcall)	지정한 매크로를 실행하는 새로운 루프를 생성하고 실행합니다.
registVariableTrigger(id,varName,func)	변수트리거를 등록합니다. id,varName,func 는 차례대로 아이디, 변수이름, 실행할 함수입니다.
unregistVariableTrigger(id)	변수트리거를 등록 해제합니다.
getState()	세이브를 위한 상태 덤프용 함수입니다.
setState(state, targetStck)	덤프한 데이터를 기반으로 상태를 복구합니다.

@@ 1번째 줄: / 1번째 줄: @@
-=Pini API=
+=LXVM=
-피니엔진은 루아스크립트를 사용하여 개발 범위를 확장할 수 있습니다. 루아는 5.1.4를 사용하고 있으며 루아의 기본 기능은 물론 루아소켓, 루아 암호화 모듈 등을 사용할 수도 있습니다. 루아로 게임을 확장할 때 루아의 기능들을 활용하는 것도 좋지만 피니API를 사용하여 게임을 개발하는 것도 가능합니다.
-루아[http://ko.wikipedia.org/wiki/%EB%A3%A8%EC%95%84_(%ED%94%84%EB%A1%9C%EA%B7%B8%EB%9E%98%EB%B0%8D_%EC%96%B8%EC%96%B4)] 를 사용하기 때문에 본 위키에서는 루아 문법에 대해서 숙지하고 있다고 가정하겠습니다.
-또한, 현재 피니엔진은 지속적으로 개발중인 엔진이기 때문에 지원하는 Pini API 의 종류 및 스펙 등이 추가되거나 삭제 또는 변경될 수 있는 점 양해 바라겠습니다.
+==개요==
+LXVM 클래스는 피니엔진 에디터 및 런타임에서 루아로 컴파일된 LNX 를 구동시키기 위한 일종의 가상 머신 클래스입니다.
+스크립트 불러오기 실행 호출 및, 리턴값 반환 등, 코드 구동에 핵심적인 기능만 포함되어 있습니다.
-==루아 확장 시작하기==
+보통 vm 이라는 인자로 전달되며, pini.XVM 으로도 접근할 수 있습니다.
-* [[PiniApi:tuto_make_simple_module|간단한 모듈 만들기]]
-==피니API 클래스==
+LXVM 에서는 여러개의 콜 스택을 허용하며, 각각의 콜 스택을 "루프" 라고 부릅니다.
-===VM===
-* [[PiniApi:LXVM|LXVM]]
-===PiniAPI 클래스===
+따라서, LXVM 에서는 루프를 생성하거나 일시정지하고, 삭제하는 기능 등을 제공합니다.
-* [[PiniApi:Shader|Shader]]
-* [[PiniApi:Node|Node]]
-* [[PiniApi:Sprite|Sprite]]
-* [[PiniApi:Slider|Slider]]
-* [[PiniApi:Scene|Scene]]
-* [[PiniApi:ColorLayer|ColorLayer]]
-* [[PiniApi:Label|Label]]
-* [[PiniApi:VideoPlayer|VideoPlayer]]
-* [[PiniApi:TextInput|TextInput]]
-* [[PiniApi:RenderTexture|RenderTexture]]
-* [[PiniApi:Timer|Timer]]
-* [[PiniApi:TouchManager|TouchManager]]
-* [[PiniApi:Backlog|Backlog]]
-* [[PiniApi:Dialog|Dialog]]
-* [[PiniApi:pini|pini]]
-== 예제 ==
+또한, 저장과 불러오기 기능을 위한 덤프 및 복구 기능도 제공하고, 그것을 위한 구조로 구성되어 있습니다.
-* [[PiniApi:MathExample|수학 라이브러리]]
+==전역 상수==
+{| class="wikitable"
+| style="width:100px; background-color:#f0f0f0"|이름
+| style="background-color:#f0f0f0"|설명
+|-
+|OnPreview||에디터인지 리모트인지를 알려주는 상수입니다. true 이면 에디터이고, false이면 리모트입니다.
+|}
+==전역 함수==
+{| class="wikitable"
+| style="width:100px; background-color:#f0f0f0"|이름
+| style="background-color:#f0f0f0"|설명
+|-
+|_VM_LOOP_(fname,fns,stckInfo,new_arg,del_arg,start_i,rets,scall)||LNX 매크로를 실제로 돌려주는 함수입니다.
+|}
+==전역 변수==
+{| class="wikitable"
+| style="width:100px; background-color:#f0f0f0"|이름
+| style="background-color:#f0f0f0"|설명
+|-
+|_LNXF||LNX 스크립트 및 매크로가 들어있는 테이블입니다.
+|-
+|_LNXB||북마크 위치가 들어있는 테이블입니다.
+|-
+|_LNXVT||변수 트리거 정보가 들어있는 테이블입니다.
+|-
+|_LNXG||변수 정보를 읽고 쓸 수 있게 되어있는 테이블입니다. 일반적인 읽기 쓰기는 이것으로 접근합니다.
+|-
+|_LNXGP||변수 정보가 실제로 들어가있는 테이블입니다. 특수한 읽기 쓰기일 경우에만 이것으로 접근합니다.
+|}
+==멤버 변수==
+{| class="wikitable"
+| style="width:100px; background-color:#f0f0f0"|이름
+| style="background-color:#f0f0f0"|설명
+|-
+|loops||현재 존재하는 모든 루프를 저장하는 테이블의 배열
+|-
+|currentLoop||현재 실행중인 loops 의 테이블을 가르킴
+|}
+==멤버 함수==
+{| class="wikitable"
+| style="width:100px; background-color:#f0f0f0"|이름
+| style="background-color:#f0f0f0"|설명
+|-
+|init()||vm 을 초기화하는 함수입니다. 단, 현재 vm 으로 실행중인 코드는 중지하지 않습니다.
+|-
+|_return()||현재 실행중인 매크로를 종료합니다.
+|-
+|returnValue(ret)||현재 실행중인 매크로가 ret 를 반환하게 합니다.
+|-
+|returnValueOnThread(ret,idx)||지정한 idx 루프번호에서 진행중인 매크로가 ret 를 반환하게 합니다. 결과를 반환해야 하지만 즉시 반환하지는 않고, pause 등을 사용해서 결과가 지연될 경우에 사용합니다.
+|-
+|ARGU(fname, arg, default)||fname 매크로의 arg 인자를 가져옵니다. 존재하지 않는다면, 기본 값을 가져옵니다. 둘 다 존재하지 않는다면, default 를 반환합니다.
+|-
+|currentLoopIdx()||현재 돌고있는 루프의 번호를 가져옵니다.
+|-
+|removeLoop(infotable)||infotable에 해당되는 루프를 loops 에서 제거합니다.
+|-
+|stop()||현재 루프를 일시정지합니다. 그리고, 루프번호를 반환합니다.
+|-
+|resume(idx)||stop 에서 반환받은 번호를 idx 로 전달해 주면, 일시정지를 해제합니다.
+|-
+|sleep(time)||지정한 time초 만큼 루프를 일시정지합니다.
+|-
+|GotoBookmark(bmk)||지정한 북마크로 이동합니다.
+|-
+|GotoBookmarkNewCall(bmk)||지정한 북마크 위치부터 시작하는 새로운 매크로를 호출합니다.
+|-
+|resumeAndGoBookmark(idx,bmk)||지정한 idx 루프번호로 현재 루프를 전환한 뒤, 지정한 묵마크로 이동합니다.
+|-
+|OpenLNX(file)||지정한 file 을 로드합니다. file 은 .lua 또는 .lnx 파일입니다. 대소문자에 맞게 확장자까지 모두 적어주어야 하며, .lnx 의 경우 실행하지는 않지만, .lua 인 경우, 코드 자체는 한번 실행 합니다.
+|-
+|call(stckName, start_i, fcall)||지정한 매크로를 실행하는 새로운 루프를 생성하고 실행합니다.
+|-
+|registVariableTrigger(id,varName,func)||변수트리거를 등록합니다. id,varName,func 는 차례대로 아이디, 변수이름, 실행할 함수입니다.
+|-
+|unregistVariableTrigger(id)||변수트리거를 등록 해제합니다.
+|-
+|getState()||세이브를 위한 상태 덤프용 함수입니다.
+|-
+|setState(state, targetStck)||덤프한 데이터를 기반으로 상태를 복구합니다.
+|}

"Piniapi"의 두 판 사이의 차이