Global Variables

프로젝트 전역에서 사용하는 변수를 설명합니다.

전역변수(Global Variables)는 프로젝트 전반에서 공유되는 변수입니다. 동작 자체는 Variables – Script 변수와 차이가 없지만, 다음 두 가지 용도로 사용됩니다.

  • 사용자 DLL에서 자동 등록되는 변수
  • 프로젝트 전반에서 공유해서 쓰는 변수

사용 방법

전역변수는 일반 변수와 똑같이 명령어 인자에서 [name] 형태로 참조합니다. 별도의 prefix가 없으므로 사용자가 작성한 표현식 안에서 어떤 변수가 전역인지를 신경 쓸 필요가 없습니다.

값을 갱신할 때도 Set 명령어를 그대로 사용합니다.

스크립트에서 사용하는 모든 입력의 [ ] 는 변수로 판단되므로, 일반 변수든 전역변수든 표기는 완전히 동일합니다.

Variables – Script와의 관계

비교 항목Variables – ScriptGlobal Variables
등록 위치스크립트 단위 Variables 패널프로젝트 단위 전역변수 영역
공유 범위해당 스크립트 안에서만프로젝트 전반
자동 등록수동 등록사용자 DLL이 자동 등록 가능
참조 문법[name][name]
영속성프로젝트 파일에 저장프로젝트 파일에 저장

언제 전역변수를 쓰면 좋은가

  • 여러 스크립트가 같은 값을 참조해야 할 때 — 예를 들어 장비 IP, 작업 디렉터리, API 키 등은 한 곳에서 관리하면 변경 비용이 줄어듭니다.
  • 사용자 DLL이 등록하는 결과 변수 — DLL이 자체적으로 등록한 변수는 별도 선언 없이도 모든 스크립트에서 같은 이름으로 접근할 수 있습니다.
  • 프로젝트 단위 환경 설정 — 디버그 모드 플래그, 시험 회차 번호처럼 프로젝트 전체의 동작을 좌우하는 값.

DLL이 사용하는 변수를 흐름마다 일일이 등록하는 대신 전역변수에 한 번 등록해두면, 같은 프로젝트 내 모든 스크립트가 동일한 값을 즉시 공유합니다.

다음 단계

  • 변수 종류 전체와 [varname] 참조 문법은 Variables 페이지에서 다룹니다.
  • 표현식·연산자 사용법은 Expression을 확인하세요.