호환성 스크립트 설명서

게임메이커의 이전 버전에서 넘어온 사용자에게는 프로젝트 자산, 편집 및 코딩 방식에서 변경 사항이 있어 다소 혼란스럽게 느껴질 수 있습니다. 이 문서에서는 호환성 스크립트에 대해 설명하고, 활용 예제를 제시하겠습니다.

호환성 스크립트란?

호환성 스크립트는 이전 버전에서 사용된 기능을 새로운 메소드로 변환하는 스크립트입니다. 게임메이커는 프로젝트를 가져올 때 모든 구식 함수와 변수를 분석하고, 해당 함수 이름을 사용하여 일련의 스크립트를 생성합니다. 이 스크립트는 새로운 실행 시간 함수 또는 구식 함수와 동일한 작업을 수행하는 짧은 스크립트를 포함합니다.

호환성 보고서

게임메이커 프로젝트를 처음 가져오면 호환성 보고서가 표시됩니다. 보고서의 주요 내용은 어떤 객체 및 스크립트가 영향을 받았는지 보여줍니다. 보고서 하단에는 생성된 스크립트 목록이 포함되어 있습니다. 스크립트에 대해 더 알고 싶으면 중간 마우스 버튼을 클릭하거나 스크립트를 선택해서 열 수 있습니다.

특정 스크립트 주의

이름 앞에 더블 언더바(__)가 붙은 스크립트는 IDE에 의해 생성된 호환성 스크립트입니다. 이러한 스크립트는 수정해서는 안 되며, 다른 호환성 스크립트가 정상 작동하는 데 필요합니다.

활용 예제

예제 1: 구식 함수 사용하기

구식 함수 legacy_function()을 사용할 때, 호환성 스크립트를 통해 새로운 메소드로 변환됩니다. 다음은 구식 함수를 사용하는 코드입니다.

result = legacy_function(arg1, arg2);

호환성 스크립트에서 이는 다음과 같이 변환됩니다.

result = new_function(arg1, arg2);

예제 2: 호환성 스크립트 수정

호환성 스크립트가 필요없어진 경우, 새로운 기능으로 프로젝트를 업데이트하고 호환성 스크립트를 제거할 수 있습니다.

// 기존 호환성 스크립트 제거
if (exists(__global_object_depths)) {
    instance_destroy(__global_object_depths);
}

이렇게 하면 성능을 개선할 수 있습니다.

예제 3: 노트 섹션 활용

변경 사항을 확인하여 수정할 필요가 있을때는 에셋 브라우저의 노트 섹션을 통해 다시 접근할 수 있습니다.

// 프로젝트 내에서 노트 섹션 확인
notes = asset_browser_get_notes();

결론

호환성 스크립트는 이전 버전의 게임메이커에서 사용한 함수를 현대적인 메소드로 변환하여 호환성을 유지합니다. 성능 향상을 위해 가능하다면 호환성 스크립트 대신 새로운 메소드를 사용하는 것이 좋습니다.