fx_get_parameter 함수 설명
fx_get_parameter 함수는 FX 구조체에서 특정 파라미터의 값을 가져오는 데 사용됩니다. 이 함수는 FX 구조체와 파라미터 이름을 문자열로 입력받아 해당 파라미터의 현재 값을 반환합니다. 반환되는 값은 실수일 수도 있고, 벡터와 같은 배열일 수도 있습니다. 예를 들어, avec4는 RGBA 색상을 저장하는 벡터입니다.
문법
fx_get_parameter(filter_or_effect, parameter_name);
인수 설명
| 인수 | 타입 | 설명 |
|---|---|---|
| filter_or_effect | FX Struct | 파라미터를 가져올 FX 구조체 |
| parameter_name | String | 값을 가져올 파라미터의 이름 (문자열 형식) |
반환 값
- 실수 또는 배열
예제
var _fx_struct = layer_get_fx("TintEffect");
var _tint_colour = fx_get_parameter(_fx_struct, "g_TintCol");
show_debug_message("The currently active tint colour is: " + string(_tint_colour));
위의 코드는 "Colour Tint" 필터가 적용된 레이어에서 FX 구조체를 가져오고, 그 구조체의 "g_TintCol" 파라미터 값을 가져옵니다. 이 값은 색상 조정에 대한 4개의 값을 포함하는 배열로 반환되며, 이후 출력 로그에 그 값을 출력합니다.
활용 예제
- 효과의 색상 조정
gml var _fx_struct = layer_get_fx("ColorEffect"); var _color_value = fx_get_parameter(_fx_struct, "g_Color"); // 색상 값을 사용하여 추가적인 로직 수행 - 효과의 강도 조절
gml var _fx_struct = layer_get_fx("BlurEffect"); var _blur_strength = fx_get_parameter(_fx_struct, "g_Strength"); // 블러 강도를 기반으로 다른 효과 적용 - 효과의 투명도 확인
gml var _fx_struct = layer_get_fx("OpacityEffect"); var _opacity_value = fx_get_parameter(_fx_struct, "g_Opacity"); // 투명도 값을 사용하여 객체의 상태 변경 - 효과의 위치 조정
gml var _fx_struct = layer_get_fx("PositionEffect"); var _position_vector = fx_get_parameter(_fx_struct, "g_Position"); // 위치 벡터를 사용하여 객체 이동
이와 같이 fx_get_parameter 함수를 활용하여 다양한 효과의 파라미터 값을 가져오고, 이를 기반으로 추가적인 로직을 구현할 수 있습니다.