필터 및 효과 함수

개요

GML 함수는 방 내의 레이어에서 필터 및 효과를 생성, 수정 및 제거하는 데 사용할 수 있습니다. 이를 통해 실시간으로 효과를 쉽게 관리하여 사실적이고 동적인 필터 및 효과를 만들 수 있습니다. 코드에서 필터/효과를 지정하는 방법은 문자열 리터럴을 직접 함수 인수로 지정할 때만 작동합니다. 즉, 변수를 사용하거나 필터/효과 이름 문자열을 생성하는 논리를 사용하면 자산 컴파일러가 이를 감지하지 못하고 필터/효과가 로드되지 않습니다.

예제

// 이 코드는 독립적으로 작동합니다.
var _fxshake = fx_create("_filter_screenshake");

// 이 코드는 독립적으로 작동하지 않습니다.
var _myfilters = { screenshake: "_screenshake" }
var _filter_to_use = "_filter" + _myfilters.screenshake;
var _fxshake = fx_create(_filter_to_use);

후자의 방법이 작동하도록 하려면 프로젝트의 적어도 하나의 방에 필터를 추가하거나, 필터 이름을 문자열 상수로 사용하여 fx_create()가 프로젝트의 어디에서든 호출되도록 해야 합니다.

함수 목록

다음 함수는 효과 데이터를 포함하는 "FX 구조체"를 생성하고 관리하는 데 사용됩니다:

다음 함수는 FX 구조체를 사용하여 필터/효과가 포함된 레이어를 수정하는 데 사용됩니다:

런타임에서 FX 수정

런타임에서 필터/효과를 수정하려면 다음 단계를 따릅니다:

1. 수정할 레이어에서 FX 구조체를 가져옵니다: layer_get_fx()
2. 새 FX 구조체를 생성하여 레이어에 적용합니다: fx_create() 및 layer_set_fx()
3. 파라미터 구조체를 가져옵니다: fx_get_parameters()
4. 필요한 대로 파라미터를 수정합니다.
5. 수정된 구조체를 FX 구조체에 다시 적용합니다: fx_set_parameters()

여기서 layer_set_fx()를 호출할 필요는 없습니다. FX 구조체를 직접 수정하면 이미 할당된 레이어에 영향을 미칩니다.

예제 코드

// 생성 이벤트
pixelate_fx = layer_get_fx("Effect_1");
pixelate_fx_params = fx_get_parameters(pixelate_fx);

// 단계 이벤트
pixelate_fx_params.g_CellSize = round((mouse_x / room_width) * 64);
pixelate_fx_params[$ "g_CellSize"] = round((mouse_x / room_width) * 64);
fx_set_parameters(pixelate_fx, pixelate_fx_params);

FX 런타임 파라미터

FX 유형 및 파라미터 페이지는 모든 필터/효과와 그들의 런타임 파라미터를 나열합니다. 런타임 파라미터 이름은 다음 세 가지 방법으로 사용할 수 있습니다 (예: "g_CellSize" 파라미터 사용):

1. FX 구조체에서 파라미터 수정: gml fx_set_parameter(fx_struct,"g_CellSize", 8);
2. 파라미터 구조체에서 변수 수정: gml params_struct.g_CellSize= 8; 참고: 먼저 fx_get_parameters()로 파라미터 구조체를 가져와야 합니다.
3. 문자열을 사용하여 파라미터 구조체에서 변수 수정: gml params_struct[$"g_CellSize"] = 8;

단일 레이어 모드

기본적으로 필터/효과는 할당된 레이어와 그 아래의 모든 레이어에 적용됩니다. 그러나 fx_set_single_layer()를 사용하여 필터/효과의 단일 레이어 모드를 활성화하면 할당된 레이어에만 적용되도록 할 수 있습니다.

룸 편집기에서 검사기를 사용하여 단일 레이어 효과를 활용할 수도 있습니다.