레이어 스크립트 시작 가져오기
이 문서는 layer_get_script_begin 함수에 대해 설명합니다. 이 함수는 레이어의 시작 렌더링 시 실행할 스크립트 함수의 인덱스를 반환합니다. 레이어를 생성할 때 얻은 레이어 핸들 또는 레이어 이름을 인자로 사용합니다. 만약 레이어에 할당된 함수가 없다면 -1을 반환합니다.
함수 설명
- 함수 이름:
layer_get_script_begin - 문법:
layer_get_script_begin(layer_id);
인자 설명
| 인자 이름 | 타입 | 설명 |
|---|---|---|
| layer_id | 문자열 또는 레이어 ID | 타겟 레이어의 핸들(또는 문자열로 된 레이어 이름) |
반환 값
- 스크립트 함수 인덱스 또는 -1 (할당된 함수가 없는 경우)
활용 예제
다음은 layer_get_script_begin 함수를 활용하는 예제입니다.
if (layer_get_script_begin(layer) == -1) {
layer_script_begin(layer, scr_SetShaderValues);
}
위 코드는 현재 인스턴스가 속한 레이어에 스크립트 함수가 할당되어 있는지 확인하고, 할당되어 있지 않다면 scr_SetShaderValues 함수를 할당합니다.
추가 활용 및 응용 예제
- 레이어에 스크립트 함수 할당하기
gml var layer = layer_create("MyLayer"); layer_script_begin(layer, scr_InitLayer); - 스크립트 함수가 할당되어 있는지 확인하기
gml if (layer_get_script_begin(layer) != -1) { // 스크립트 함수가 할당되어 있음 } - 스크립트 함수 제거하기
gml if (layer_get_script_begin(layer) != -1) { layer_script_end(layer); } - 여러 레이어에 스크립트 함수 할당하기
gml var layer1 = layer_create("Layer1"); var layer2 = layer_create("Layer2"); layer_script_begin(layer1, scr_UpdateLayer1); layer_script_begin(layer2, scr_UpdateLayer2); - 스크립트 함수의 결과에 따라 다른 동작 수행하기
gml var result = layer_get_script_begin(layer); if (result != -1) { // 할당된 스크립트 함수 실행 script_execute(result); } else { // 다른 동작 수행 }
이와 같이 layer_get_script_begin 함수는 레이어의 스크립트 관리에 유용하게 사용될 수 있습니다.