스크립트 소개

기능 설명

Canvas 스크립트 편집기는 사용자가 프로젝트의 동작을 좀 더 사용자화하고 세세하게 컨트롤하는데 사용하기 용이한 기능입니다. 스크립트 기능은 디버깅 기능을 제공하여 런타임에서 스크립트 오류가 발생했을 때 사용자에게 그 내용을 전달할 수도 있습니다. 스크립트 편집기는 JavaScript ES5를 기반으로 하며, 그 외 Canvas 고유의 함수를 제공합니다.

Canvas 스크립트 편집기는 JavaScript ES5를 사용합니다. 해당 언어에 대한 상세 내용은 ECMAScript Documentation 을 참고하여 주시기 바랍니다. 단, Document Object Model (DOM) 관련 기능은 지원하지 않습니다

Canvas에서는 최대 100개의 스크립트를 동시에 실행할 수 있습니다. 동시에 100개를 초과하는 스크립트를 실행하려고 하는 경우 스크립트가 실행되지 않으며 경고가 발생합니다.

디자이너 기능

스크립트 편집기

스크립트 편집기는 도구 > 스크립트 편집기 또는 툴바에서 **스크립트 편집기 열기…**를 이용해 열 수 있습니다. 편집기에는 생성된 스크립트의 모든 목록을 표시하며 선택한 스크립트의 내용 또한 확인, 수정이 가능합니다. 스크립트 파일 내보내기 또는 불러오기 또한 가능합니다.

스크립트/명령 생성

스크립트를 생성하려면 스크립트 편집기에서 + 아이콘을 클릭합니다. 드롭다운 목록에서 새 스크립트 작성 또는 새 명령 생성을 클릭할 수 있습니다. 둘 중 하나의 옵션을 선택하면 해당 기능을 위한 설정 화면이 표시됩니다.

새 스크립트 작성을 클릭하면 스크립트의 이름, 실행 타입, 실행 주기 (ms)를 설정할 수 있는 창이 표시됩니다. 실행 타입으로는 수동, 자동, 정주기가 있습니다. 스크립트가 자동으로 설정되었다면 런타임이 실행되는 순간에 자동으로 1회 실행됩니다. 정주기로 설정되었다면 런타임 시작 이후부터 실행 주기에 지정된 시간 마다 스크립트를 계속해서 실행합니다. 입력 가능한 주기는 0 에서 2147483647 ms 입니다. 수동으로 설정되었다면 사용자가 런타임 사용 중 수동으로 스크립트를 호출할 때만 1회 실행됩니다. 수동 스크립트의 예시로는 오브젝트에 설정 가능한 동작 탭의 스크립트 및 명령이 있습니다. 누를 때, 놓을 때, 더블클릭 시에만 스크립트 또는 명령이 수행되며, 이를 수동 실행 타입이라고 지칭합니다.

새 명령 생성을 클릭하면 명령 편집기가 실행됩니다. 사용자는 명령 편집기에서 사용하고자 하는 명령의 목록을 확인 및 활용할 수 있습니다. 명령 생성 시, 사용자는 로컬 또는 글로벌 명령으로 종류 지정을 할 수 있습니다. 로컬 명령의 경우에는 오브젝트의 동작 탭을 통해서만 생성이 가능하며, 그 오브젝트에서만 사용이 가능합니다. 다른 오브젝트 또는 기능에서 사용할 수 없습니다. 특정한 명령들을 여러 위치에서 사용하고자 한다면 종류를 글로벌 명령으로 설정해야 합니다.

스크립트 편집

스크립트를 편집하려면 스크립트의 이름을 더블클릭 합니다. 선택된 스크립트의 편집 가능한 화면이 편집기의 우측에 표시됩니다. 이 화면에서 스크립트의 내용을 수정할 수 있습니다. 변경사항은 수정하는 즉시 반영됩니다. 스크립트의 내용은 유효성 검사 버튼을 눌러 저장 전 검토를 할 수 있습니다.

찾기 및 바꾸기

찾기 및 바꾸기 기능은 현재 화면에 표시된 스크립트 내에서 특정 내용을 찾고 그 내용을 바꿀 수 있는 기능입니다. 스크립트 내에 일괄적으로 수정해야 하는 항목이 있거나, 문제가 발생한 부분을 빠르게 찾아내기 위해 사용하기 용이합니다. 더 정확한 검색을 위해 대/소문자 일치, 정규직, 단어 단위 등의 조건을 추가할 수 있습니다.

명령 호출

Canvas 오브젝트에 On Press, On Release, 또는 On Double Click 동작 속성이 허용되는 경우, 해당 객체를 누르거나 떼는 것으로 스크립트를 수동으로 실행할 수 있습니다.

스크립트 호출

스크립트 호출 명령을 사용하면 스크립트 편집기에서 생성된 기존 스크립트를 수동으로 실행할 수 있습니다.

별도 스레드에서 실행 확인란을 활성화하면 스크립트가 비동기적으로 실행됩니다. 즉, 스크립트가 주 프로그램 스레드와 별개로 실행됩니다.

사용자 지정 스크립트 삽입

T사용자 지정 스크립트 삽입 명령은 선택한 객체에 한정된 사용자 지정 스크립트를 생성합니다. 이는 해당 스크립트가 객체 내에만 존재하며 스크립트 편집기 에는 나타나지 않음을 의미합니다..