fx_get_parameter_names 함수 설명

이 문서에서는 fx_get_parameter_names 함수에 대해 설명하고, 다양한 활용 및 응용 예제를 제공합니다. 이 함수는 필터 또는 효과에 존재하는 모든 매개변수의 이름을 가져오는 데 사용됩니다.

함수 설명

문법

fx_get_parameter_names(filter_or_effect);

인수

반환값

• 문자열 배열: 필터의 매개변수 이름을 포함하는 배열

예제

다음 코드는 레이어의 FX 구조체를 가져오고, 해당 매개변수 이름을 배열로 얻은 후, 각 매개변수를 출력 로그에 표시합니다.

var _fx_struct = layer_get_fx("EffectLayer");
var _param_names = fx_get_parameter_names(_fx_struct);
for (var i = 0; i < array_length(_param_names); i++) {
    show_debug_message("Parameter " + string(i) + ": " + _param_names[i]);
}

활용 예제

예제 1: 모든 매개변수 이름 출력하기

var _fx_struct = layer_get_fx("MyLayer");
var _param_names = fx_get_parameter_names(_fx_struct);
for (var i = 0; i < array_length(_param_names); i++) {
    show_debug_message("Parameter Name: " + _param_names[i]);
}

예제 2: 특정 매개변수 값 설정하기

var _fx_struct = layer_get_fx("MyLayer");
var _param_names = fx_get_parameter_names(_fx_struct);
if (array_length(_param_names) > 0) {
    var param_index = 0; // 첫 번째 매개변수
    var param_value = 0.5; // 설정할 값
    fx_set_parameter(_fx_struct, _param_names[param_index], param_value);
}

예제 3: 매개변수 값 가져오기

var _fx_struct = layer_get_fx("MyLayer");
var _param_names = fx_get_parameter_names(_fx_struct);
if (array_length(_param_names) > 0) {
    var param_index = 0; // 첫 번째 매개변수
    var current_value = fx_get_parameter(_fx_struct, _param_names[param_index]);
    show_debug_message("Current Value of " + _param_names[param_index] + ": " + string(current_value));
}

예제 4: 매개변수 이름을 배열로 저장하기

var _fx_struct = layer_get_fx("MyLayer");
var _param_names = fx_get_parameter_names(_fx_struct);
var param_array = [];
for (var i = 0; i < array_length(_param_names); i++) {
    array_push(param_array, _param_names[i]);
}

이러한 예제들은 fx_get_parameter_names 함수를 활용하여 필터 및 효과의 매개변수를 관리하는 방법을 보여줍니다.