particle_get_info

此函数返回结构，其中包含有关使用粒子系统编辑器创建的粒子系统资源的信息。

返回的结构是一个粒子系统信息结构，其中包含一个由粒子发射器信息结构组成的数组。这些发射器结构中的每个结构都存储有关发射器在其parttype变量中使用的粒子类型的信息，该变量包含一个粒子类型信息结构。

警告如果没有向函数传递有效的粒子系统资源，GameMaker将抛出错误。

简而言之，该函数返回的结构内容如下所示：

part_sys_info_struct =
{
    emitters:
    [
        {
            parttype:
            {
                // Particle type properties...
            }
            // All other particle emitter properties...
        }
        // More emitters...
    ]
    // All other particle system properties...
};

下表列出了这三个结构中每个结构中可用的所有变量。

粒子系统信息粒子系统信息

粒子发射器信息粒子发射器信息

粒子类型信息粒子类型信息

最后，粒子发射器模式还有一个常量：

语法:

particle_get_info(partsys);

返回:

粒子系统信息结构

示例1：粒子类型信息

var _particle_info = particle_get_info(ps_Clouds);
var _asset_name = _particle_info.name;

var _arr_emitters = _particle_info.emitters;
if (array_length(_arr_emitters) > 0)
{
    var _type_info = _arr_emitters[0].parttype;
   
    if (_type_info.additive)
    {
        show_debug_message("The first emitter in {0} creates shiny particles!", _asset_name);
    }
}

上述代码首先使用 particle_get_info 从现有的 Particle System Assetps_Clouds 获取信息，并将返回的结构分配给临时变量 _particle_info。 然后，它通过 Particle System Info Struct 的 emitters 变量查找粒子系统中的发射器。 如果粒子系统包含任何发射器 (即数组的长度大于 0)， 第一个发射器的 parttype 变量被分配给临时变量 _type_info，并检查加性混合 (bm_add)。最后，如果添加混合用于粒子类型，则会显示调试消息。

示例2：列出发射器名称

var _particle_info = particle_get_info(ps_Environment);
var _asset_name = _particle_info.name;

var _emitter_names = array_map(_particle_info.emitters, function(_element, _index) { return _element.name; });
_emitter_names = string_join_ext(", ", _emitter_names);

show_debug_message("{0} contains the following particle emitters: {1}", _asset_name, _emitter_names);

上面的代码首先调用 particle_get_info 以检索有关现有粒子系统资源 ps_Environment 的信息。资产名称存储在临时变量_asset_name中。之后，从粒子系统信息结构的emitters变量生成发射器名称数组，并使用 string_join_ext 将其转换为列出所有名称的字符串，以逗号分隔。最后，调试消息以可读的形式显示信息。