Filter

此类实现滤镜相关功能

add_pass

version 130

void add_pass (number filter_group_id, string target, mapdata pass)

在指定滤镜组中增加一个滤镜

Parameters

• filter_group_id | number : 滤镜组的id
• target | string : 滤镜的某一层，包括（reality_target，virtual_target，mix_target）三种
• pass | mapdata : 滤镜（可以根据滤镜说明中的例子配置）

sample:
local mapData = ae.MapData:new()
mapData:put_string("pass_id", "2") -- 如果有相同的pass_id 则没有效果
mapData:put_string("pass_type", "look_up")
mapData:put_string("source_type", "picture")
mapData:put_string("source_file", "/res/filter/lookup_2.png")

Filter:add_pass(500007,"virtual_target",mapData)
Filter:update(500007)

adjust

version 130

void adjust (string target, string pass_id, FilterAdjustData data)

调节当前滤镜中的参数

Parameters

• target | string : 滤镜的某一层，包括（reality_target，virtual_target，mix_target）三种
• pass_id | string : 滤镜id
• data | FilterAdjustData : FilterAdjustData类型的数据

sample:
local d1 = FilterAdjustData:put_float("brightness",0.3)
Filter:adjust("virtual_target","1",d1)  

delete_pass

version 130

void delete_pass (number filter_group_id, string target, string pass_id)

更新滤镜组中的某一个滤镜

Parameters

• filter_group_id number : 滤镜组的id
• target string : 滤镜的某一层，包括（reality_target，virtual_target，mix_target"）三种
• pass_id string : 滤镜id

sample:
Filter:delete_pass(500007,"virtual_target","1")
Filter:update(500007)

disable_filter_group

version 130

void disable_filter_group (number filter_group_id, number disable)

启用或者禁用某一个滤镜组

Parameters

• filter_group_id | number : 滤镜组的id
• disable | number : 1：禁用，0：启用

sample:
Filter:disable_filter_group(100001,1)

disable_target

version 130

void disable_target (number filter_group_id, string target, number disable)

启用或者禁用某一层上的滤镜组

Parameters

• filter_group_id | number : 滤镜的id
• target | string : 滤镜的某一层，包括（reality_target，virtual_target，mix_target"）三种 disable | number : 1；禁用，0：启用

sample:
Filter:disable_target(500004,"virtual_target",1)

put_float

version 130

FilterAdjustData put_float (string key, string value)

获取一个float类型的可调节滤镜数据

Parameters

• key | string : 需要修改的参数名称
• value | string : 需要修改的参数值

Returns

• FilterAdjustData

sample:
local d1 = FilterAdjustData:put_put_float("brightness",0.1)

put_int

version 130

FilterAdjustData put_int (string key, string value)

获取一个int类型的可调节滤镜数据

Parameters

• key | string : 需要修改的参数名称
• value | string : 需要修改的参数值

Returns

• FilterAdjustData

sample:
local d1 = FilterAdjustData:put_int("brightness",1)

put_map_data

version 130

FilterAdjustData put_map_data (FilterAdjustData data)

获取几个map_data类型的可调节滤镜数据

Parameters

• data | FilterAdjustData : 需要修改的参数名称

Returns

• FilterAdjustData

sample:
local d1 = FilterAdjustData:put_float("brightness",string value)
local d2 = FilterAdjustData:put_mat3("mat3","0,1,1,1,1,1,1,1,1")
local d3 = FilterAdjustData:put_mat4("mat4","0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1")

local d4 = FilterAdjustData:put_map_data(d1,d2,d3)

put_mat3

version 130

FilterAdjustData put_mat3 (string key, string value)

获取一个mat3类型的可调节滤镜数据

Parameters

• key | string : 需要修改的参数名称
• value | string : 需要修改的参数值

Returns

• FilterAdjustData

sample:
local d1 = FilterAdjustData:put_mat3("brightness","0,0,0,0,0,0,0,0,0")

put_mat4

version 130

FilterAdjustData put_mat4 (string key, string value)

获取一个mat4类型的可调节滤镜数据

Parameters

• key | string : 需要修改的参数名称
• value | string : 需要修改的参数值

Returns

• FilterAdjustData

sample:
local d1 = FilterAdjustData:put_mat4("brightness","0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0")

put_point

version 130

FilterAdjustData put_point (string key, string value)

获取一个point类型的可调节滤镜数据

Parameters

• key | string : 需要修改的参数名称
• value | string : 需要修改的参数值

Returns

• FilterAdjustData

sample:
local d1 = FilterAdjustData:put_point("brightness","0,0")

put_vec3

version 130

FilterAdjustData put_vec3 (string key, string value)

获取一个vec3类型的可调节滤镜数据

Parameters

• key | string : 需要修改的参数名称
• value | string : 需要修改的参数值

Returns

• FilterAdjustData

sample:
local d1 = FilterAdjustData:put_vec3("brightness","0,0,0")

put_vec4

version 130

FilterAdjustData put_vec3 (string key, string value)

获取一个vec4类型的可调节滤镜数据

Parameters

• key | string : 需要修改的参数名称
• value | string : 需要修改的参数值

Returns

• FilterAdjustData

sample:
local d1 = FilterAdjustData:put_vec4("brightness","0,0,0")

start

version 130

void start ()

开始滤镜，配置在json中start的位置

sample:
Filter:start()

stop

version 130

void stop ()

停止所有滤镜组

sample:
Filter:stop()

update

version 130

void update (number filter_group_id)

切换到到指定滤镜组

Parameters

• filter_group_id | number : 滤镜组的id

sample:
Filter:update(500007)

update_pass

version 130

void update_pass (number filter_group_id, string target, mapdata pass)

更新滤镜组中的某一个滤镜

Parameters

• filter_group_id | number : 滤镜组的id
• target | string : 滤镜的某一层，包括（reality_target，virtual_target，mix_target"）三种
• pass | mapdata : 滤镜 （可以根据滤镜说明中的例子配置）

sample:
local mapData = ae.MapData:new()
mapData:put_string("pass_id", "1") -- 如果无对应的pass_id 则没有效果
mapData:put_string("pass_type", "look_up")
mapData:put_string("source_type", "picture")
mapData:put_string("source_file", "/res/filter/lookup_2.png")

Filter:update_pass(500007,"virtual_target",mapData)
Filter:update(500007)