美摄SDK For iOS  3.10.0
特效名称列表

特效名称列表

1、特效概述

1.1、内建音频特效(Builtin Audio Fx)

  • Audio Echo（回声）
  • Male Voice（男声）
  • Female Voice（女声）
  • Cartoon Voice（卡通）
  • Fast Cartoon Voice（快速卡通）
  • Monster Voice（怪兽）
  • Audio Reverb（混响）
  • Audio Wahwah（电子）

1.2、内建视频特效(Builtin Video Fx)

  • Sage（明快）
  • Maid（少女时代）
  • Mace（锐利）
  • Lace（蕾丝）
  • Mall（时尚）
  • Sap（元气）
  • Sara（调皮）
  • Pinky（草莓薄荷）
  • Sweet（粉嫩）
  • Fresh（清爽）
  • Beauty

说明：美颜。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Reddening FLOAT 1.0 0.0 0.0 美红
002 Whitening FLOAT 1.0 0.0 0.0 美白
003 Strength FLOAT 1.0 0.0 0.0 磨皮
  • Color Property

说明：颜色属性。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Brightness FLOAT 10.0 0.0 1.0 亮度
002 Saturation FLOAT 10.0 0.0 1.0 饱和度
003 Contrast FLOAT 10.0 0.0 1.0 对比度
  • Transform 2D

说明：2D变换。Anchor X，Anchor Y，Trans X，Trans Y置认处于标准坐标系，如果Is Normalized Coord为true，则处于归一化坐标系。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 范围 说 明
001 Scale X FLOAT 1000.0 -1000.0 1.0 横向缩放
002 Scale Y FLOAT 1000.0 -1000.0 1.0 纵向缩放
003 Rotation FLOAT 3600000.0 -3600000.0 0.0 Z轴旋转角度
004 Rotation X FLOAT 3600000.0 -3600000.0 0.0 X轴旋转角度
005 Rotation Y FLOAT 3600000.0 -3600000.0 0.0 Y轴旋转角度
006 Anchor X FLOAT 100000.0 -100000.0 0.0 横向定位
007 Anchor Y FLOAT 100000.0 100000.0 0.0 纵向定位
008 Trans X FLOAT 100000.0 -100000.0 0.0 横向平移
009 Trans Y FLOAT 100000.0 -100000.0 0.0 纵向平移
010 Opacity FLOAT 1.0 0.0 1.0 透明度
011 Tex Wrap Mode Menu Clamp To Edge Clamp To Edge,Mirrored Repeat,Repeat 纹理贴图循环模式
012 Tex Anchor X FLOAT 100.0 -100.0 0.0 纹理贴图横向定位（纹理坐标系）
013 Tex Anchor Y FLOAT 100.0 -100.0 0.0 纹理贴图纵向定位（纹理坐标系）
014 Tex Scale X FLOAT 1000.0 -1000.0 1.0 纹理贴图X向缩放
015 Tex Scale Y FLOAT 1000.0 -1000.0 1.0 纹理贴图Y向缩放
016 Tex Rotation FLOAT 3600000.0 -3600000.0 0.0 纹理贴图顺时针旋转角度
017 Tex Trans X FLOAT 100000.0 -100000.0 0.0 纹理贴图横向平移（纹理坐标系）
018 Tex Trans Y FLOAT 100000.0 -100000.0 0.0 纹理贴图纵向平移（纹理坐标系）
019 Multisample BOOL FALSE 多重采样
020 Is Normalized Coord BOOL FALSE 是否为归一化坐标系
  • CC Basic

说明：颜色基本处理。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Is Process Other Tones BOOL FALSE 是否处理其他色调。值为FALSE，只有全色调(Master)生效，设置其他色调如阴影色调(Shadows),中间色调(Midtones),高光色调(Highlights)无效；值为true,其他色调才会生效。
002 Master Saturation FLOAT 10.0 0.0 1.0 饱和度
003 Master Contrast FLOAT 10.0 0.0 1.0 对比度
004 Master Balance Hue FLOAT 360.0 0.0 0.0 平衡色调
005 Master Balance Strength FLOAT 10.0 0.0 0.0 平衡强度
006 Master Gain Master FLOAT 10.0 0.0 1.0 全通道增益。注：全通道增益分别与R,G,B值相乘。
007 Master Gain Red FLOAT 10.0 0.0 1.0 红色增益
008 Master Gain Green FLOAT 10.0 0.0 1.0 绿色增益
009 Master Gain Blue FLOAT 10.0 0.0 1.0 蓝色增益
010 Master Offset Master FLOAT 10.0 -10.0 0.0 通道偏移量。注：全通道偏移量分别与R,G,B值相加。
011 Master Offset Red FLOAT 10.0 -10.0 0.0 Red偏移量
012 Master Offset Green FLOAT 10.0 -10.0 0.0 Green偏移量
013 Master Offset Blue FLOAT 10.0 -10.0 0.0 Blue偏移量
014 Shadows Saturation FLOAT 10.0 0.0 1.0 饱和度
015 Shadows Contrast FLOAT 10.0 0.0 1.0 对比度
016 Shadows Balance Hue FLOAT 360.0 0.0 0.0 平衡色调
017 Shadows Balance Strength FLOAT 10.0 0.0 0.0 平衡强度
018 Shadows Gain Master FLOAT 10.0 0.0 1.0 全通道增益。注：全通道增益分别与R,G,B值相乘。
019 Shadows Gain Red FLOAT 10.0 0.0 1.0 Red增益
020 Shadows Gain Green FLOAT 10.0 0.0 1.0 Green增益
021 Shadows Gain Blue FLOAT 10.0 0.0 1.0 Blue增益
022 Shadows Offset Master FLOAT 10.0 -10.0 0.0 全通道偏移量。注：全通道偏移量分别与R,G,B值相加
023 Shadows Offset Red FLOAT 10.0 -10.0 0.0 Red偏移量
024 Shadows Offset Green FLOAT 10.0 -10.0 0.0 Green偏移量
025 Shadows Offset Blue FLOAT 10.0 -10.0 0.0 Blue偏移量
026 Midtones Saturation FLOAT 10.0 0.0 1.0 饱和度
027 Midtones Contrast FLOAT 10.0 0.0 1.0 对比度
028 Midtones Balance Hue FLOAT 360.0 0.0 0.0 平衡色调
029 Midtones Balance Strength FLOAT 10.0 0.0 0.0 平衡强度
030 Midtones Gain Master FLOAT 10.0 0.0 1.0 全通道增益。注：全通道增益分别与R,G,B值相乘。
031 Midtones Gain Red FLOAT 10.0 0.0 1.0 Red增益
032 Midtones Gain Green FLOAT 10.0 0.0 1.0 Green增益
033 Midtones Gain Blue FLOAT 10.0 0.0 1.0 Blue增益
034 Midtones Offset Master FLOAT 10.0 -10.0 0.0 全通道偏移量。注：全通道偏移量分别与R,G,B值相加。
035 Midtones Offset Red FLOAT 10.0 -10.0 0.0 Red偏移量。
036 Midtones Offset Green FLOAT 10.0 -10.0 0.0 Green偏移量
037 Midtones Offset Blue FLOAT 10.0 -10.0 0.0 Blue偏移量
038 Highlights Saturation FLOAT 10.0 0.0 1.0 饱和度
039 Highlights Contrast FLOAT 10.0 0.0 1.0 对比度
040 Highlights Balance Hue FLOAT 360.0 0.0 0.0 平衡色调
041 Highlights Balance Strength FLOAT 10.0 0.0 0.0 平衡强度
042 Highlights Gain Master FLOAT 10.0 0.0 1.0 全通道增益。注：全通道增益分别与R,G,B值相乘。
043 Highlights Gain Red FLOAT 10.0 0.0 1.0 Red增益。
044 Highlights Gain Green FLOAT 10.0 0.0 1.0 Green增益
045 Highlights Gain Blue FLOAT 10.0 0.0 1.0 Blue增益
046 Highlights Offset Master FLOAT 10.0 -10.0 0.0 全通道偏移量。注：全通道偏移量分别与R,G,B值相加
047 Highlights Offset Red FLOAT 10.0 -10.0 0.0 Red偏移量
048 Highlights Offset Green FLOAT 10.0 -10.0 0.0 Green偏移量
049 Highlights Offset Blue FLOAT 10.0 -10.0 0.0 Blue偏移量
  • Lut

说明：Lut滤镜。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Data File Path STRING lut文件路径。传入.mslut格式文件或者png
002 Intensity FLOAT 4.0 0.0 1.0 强度
  • BasicImageAdjust

说明：图像调节。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Exposure FLOAT 1.0 -1.0 0.0 曝光
002 Highlight FLOAT 1.0 -1.0 0.0 高光
003 Shadow FLOAT 1.0 -1.0 0.0 阴影
004 Brightness FLOAT 1.0 -1.0 0.0 亮度
005 Contrast FLOAT 1.0 -1.0 0.0 对比度
006 Blackpoint FLOAT 10.0 -10.0 0.0 黑点
007 Saturation FLOAT 1.0 -1.0 0.0 饱和度
008 Vibrance FLOAT 1.0 -1.0 0.0 自然饱和度
009 Video Mode BOOL FALSE 开启视频模式，该模式下会保证效果的帧间连续性
  • Tint

说明：色温，色调。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Temperature FLOAT 1.0 -1.0 0.0 色温
002 Tint FLOAT 1.0 -1.0 0.0 色调
  • Denoise

说明：去噪。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Intensity FLOAT 1.0 0.0 0.8 强度
  • Sharpen

说明：锐化。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Radius FLOAT 10.0 0.0 5.1 半径
002 Amount FLOAT 5.0 0.0 1.0 锐化量
  • Vignette

说明：暗角。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Degree FLOAT 1.0 0.0 0.0 程度
002 Color COLOR 0.0 0.0 0.0 1.0 颜色
003 Min Alpha FLOAT 1.0 0.0 0.0 最小透明度
004 Max Alpha FLOAT 1.0 0.0 1.0 最大透明度
  • Definition

说明：清晰度。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Intensity FLOAT 1.0 0.0 0.5 强度
002 Highlight Boost FLOAT 1.0 0.0 0.5 高光增益
  • AR Scene /*!*/

说明：AR Scene。支持的功能有道具，美颜，美型和美妆。仅带有人体检测功能的SDK支持，程序初始化阶段需要加载相应检测模型。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Scene Id STRING 道具包ID
002 Description File STRING 道具包描述文件路径
003 Single Buffer Mode BOOL ANDROID为TRUE,iOS为FALSE 单buffer模式，检测与渲染是否使用同一buffer；单buffer模式会丢弃AR Scene之前特效渲染结果；双buffer时如果两个buffer不一致（Android）会导致画面效果有延时
004 Face Camera Fovy FLOAT 179 1 45 摄像机张角
005 Beauty Effect BOOL FALSE 美颜开启（美颜）
006 Beauty Strength FLOAT 1 0 0.5 磨皮强度（美颜）
007 Default Beauty Enabled BOOL TRUE 默认美颜Lut开启（美颜）
008 Default Intensity FLOAT 1 0 1 默认美颜Lut强度（美颜）
009 Default Beauty Lut File STRING 默认美颜Lut文件路径（美颜）
010 Beauty Whitening FLOAT 1 0 0.5 美白强度（美颜）
011 Whitening Lut Enabled BOOL FALSE 美白Lut开启（美颜）
012 Whitening Lut File STRING 美白Lut文件路径（美颜）
013 Beauty Reddening FLOAT 1 0 0.5 红润强度（美颜）
014 Reddening Lut File STRING 红润Lut文件路径（美颜）
015 Default Sharpen Enabled BOOL FALSE 默认锐化已启用
016 Beauty Fast Mode Enabled BOOL FALSE 美颜极速模式（美颜）
017 Lut Data File Path STRING Lut文件路径
018 Lut Intensity FLOAT 4 0 1 Lut效果强度
019 Unified Max Faces INT 8 1 5 最多检测人脸数
020 Max Faces Respect Min  BOOL FALSE 多个资源包都有最多人脸数限制时，是否采用最少的那个
021 Advanced Beauty Enable BOOL FALSE 高级美颜开启
022 Advanced Beauty Intensity FLOAT 1 0 1 高级美颜磨皮强度
023 Advanced Beauty Type INT 2 0 0 高级美颜类型：0是标准效果，1是标准效果+肤色蒙版，2是男性效果
024 Advanced Beauty Remove Dark Circles Intensity FLOAT 1 0 0 高级美颜祛黑眼圈强度
025 Advanced Beauty Remove Nasolabial Folds Intensity FLOAT 1 0 0 高级美颜祛法令纹强度
026 Advanced Beauty Brighten Eyes Intensity FLOAT 1 0 0 高级美颜亮眼强度
027 Advanced Beauty Brighten Eyes Lut File STRING 高级美颜亮眼Lut文件路径
028 Advanced Beauty Whiten Teeth Intensity FLOAT 1 0 0 高级美颜白牙强度
029 Advanced Beauty Whiten Teeth Lut File STRING 高级美颜白牙Lut文件路径
030 Advanced Beauty Matte Intensity FLOAT 1 0 0 高级美颜哑光（去油光）强度
031 Advanced Beauty Matte Fill Radius FLOAT 30 3 15 高级美颜哑光（去油光）填充半径
032 Face Mesh Internal Enabled  BOOL FALSE 美型开启
033 Face Mesh Eye Size Degree FLOAT 1 -1 0 大眼程度
034 Face Mesh Eye Corner Stretch Degree FLOAT 1 -1 0 眼角拉向外伸程度
035 Face Mesh Face Size Degree FLOAT 1 -1 0 瘦脸程度
036 Face Mesh Face Width Degree FLOAT 1 -1 0 窄脸程度
037 Face Mesh Face Length Degree FLOAT 1 -1 0 小脸（短脸）程度
038 Face Mesh Forehead Height Degree FLOAT 1 -1 0 额头高度
039 Face Mesh Malar Width Degree FLOAT 1 -1 0 颧骨变窄程度
040 Face Mesh Jaw Width Degree FLOAT 1 -1 0 下颌变窄程度
041 Face Mesh Chin Length Degree FLOAT 1 -1 0 下巴缩短程度
042 Face Mesh Eye Distance Degree FLOAT 1 -1 0 眼间距变窄程度
043 Face Mesh Nose Length Degree FLOAT 1 -1 0 鼻子拉长程度
044 Face Mesh Nose Width Degree FLOAT 1 -1 0 鼻子变窄程度
045 Face Mesh Mouth Size Degree FLOAT 1 -1 0 嘴部缩小程度
046 Face Mesh Mouth Corner Lift Degree FLOAT 1 -1 0 嘴角上拉程度
047 Face Mesh Temple Width Degree FLOAT 1 -1 0 太阳穴增宽程度
048 Face Mesh Head Size Degree FLOAT 1 -1 0 头部缩小程度
049 Face Mesh Eye Angle Degree FLOAT 1 -1 0 眼睛角度旋转程度（外眼角向上，内眼角向下）
050 Face Mesh Nose Bridge Width Degree FLOAT 1 -1 0 鼻梁变窄程度
051 Face Mesh Philtrum Length Degree FLOAT 1 -1 0 人中缩短程度
052 Face Mesh Eye Arc Degree FLOAT 1 -1 0 眼睛弧形程度（眼角向上）
053 Face Mesh Eye Width Degree FLOAT 1 -1 0 眼睛宽度变大程度
054 Face Mesh Eye Height Degree FLOAT 1 -1 0 眼睛高度变大程度
055 Face Mesh Eye Y Offset Degree FLOAT 1 -1 0 眼睛向上偏移程度
056 Face Mesh Eyebrow Angle Degree FLOAT 1 -1 0 眉毛角度旋转程度（外眼角向上，内眼角向下）
057 Face Mesh Eyebrow Thickness Degree FLOAT 1 -1 0 眉毛变粗程度
058 Face Mesh Eyebrow X Offset Degree FLOAT 1 -1 0 眉毛间距变宽程度
059 Face Mesh Eyebrow Y Offset Degree FLOAT 1 -1 0 眉毛向上偏移程度
060 Face Mesh Nose Head Width Degree FLOAT 1 -1 0 鼻头变窄程度
061 Face Mesh Eye Size Custom Package Id STRING 大眼美型包ID
062 Face Mesh Eye Corner Stretch Custom Package Id STRING 眼角拉向外伸美型包ID
063 Face Mesh Face Size Custom Package Id STRING 瘦脸美型包ID
064 Face Mesh Face Width Custom Package Id STRING 窄脸美型包ID
065 Face Mesh Face Length Custom Package Id STRING 小脸（短脸）美型包ID
066 Face Mesh Forehead Height Custom Package Id STRING 额头高度美型包ID
067 Face Mesh Malar Width Custom Package Id STRING 颧骨变窄美型包ID
068 Face Mesh Jaw Width Custom Package Id STRING 下颌变窄美型包ID
069 Face Mesh Chin Length Custom Package Id STRING 下巴缩短美型包ID
070 Face Mesh Eye Distance Custom Package Id STRING 眼间距变窄美型包ID
071 Face Mesh Nose Length Custom Package Id STRING 鼻子拉长美型包ID
072 Face Mesh Nose Width Custom Package Id STRING 鼻子变窄美型包ID
073 Face Mesh Mouth Size Custom Package Id STRING 嘴部缩小美型包ID
074 Face Mesh Mouth Corner Lift Custom Package Id STRING 嘴角上拉美型包ID
075 Face Mesh Temple Width Custom Package Id STRING 太阳穴增宽美型包ID
076 Face Mesh Head Size Custom Package Id STRING 头部缩小美型包ID
077 Face Mesh Eye Angle Custom Package Id STRING 眼睛角度旋转美型包ID
078 Face Mesh Nose Bridge Width Custom Package Id STRING 鼻梁变窄美型包ID
079 Face Mesh Philtrum Length Custom Package Id STRING 人中缩短美型包ID
080 Face Mesh Eye Arc Custom Package Id STRING 眼睛弧形美型包ID
081 Face Mesh Eye Width Custom Package Id STRING 眼睛宽度变大美型包ID
082 Face Mesh Eye Height Custom Package Id STRING 眼睛高度变高美型包ID
083 Face Mesh Eye Y Offset Custom Package Id STRING 眼睛向上偏移美型包ID
084 Face Mesh Eyebrow Angle Custom Package Id STRING 眉毛角度旋转美型包ID
085 Face Mesh Eyebrow Thickness Custom Package Id STRING 眉毛变粗美型包ID
086 Face Mesh Eyebrow X Offset Custom Package Id STRING 眉毛间距变宽美型包ID
087 Face Mesh Eyebrow Y Offset Custom Package Id STRING 毛向上偏移美型包ID
088 Face Mesh Nose Head Width Custom Package Id STRING 鼻头变窄美型包ID
  • Mask Generator

说明：蒙版特效。如果Text Mask Description String不为空，则使用该字符串生成蒙版，同时忽略除“Is Caption”外的其他参数。Feather Width默认会随蒙版尺寸变化，如果Fixed Feather Width为TRUE，则Feather Width会固定下来。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Region Info ARBDATA 区域信息，具体坐标系由Coordinate System指定，参见(NvsMaskRegionInfo)。
002 Feather Width FLOAT 1000.0 0.0 0.0 羽化宽度程度，不属于任何坐标系
003 Fixed Feather Width BOOL FALSE 固定羽化半径
004 Feather Compensation BOOL TRUE 抗锯齿
005 Keep RGB BOOL FALSE 在输入图像上应用蒙版，否则只输出蒙版
006 Inverse Region BOOL FALSE 区域反转
007 Coordinate System STRING NDC 坐标系类型：Timeline, NDC
008 Text Mask Description String STRING 蒙版的storyboard描述字符串,
009 Is Caption BOOL FALSE 蒙版描述字符串是否为文字效果
  • Gaussian Blur

说明：高斯模糊。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Radius FLOAT 64.0 0.0 64.0 模糊半径（标准坐标系）
  • Dir Blur

说明：方向模糊。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Length FLOAT 1000.0 0.0 15.0 模糊长度（标准坐标系）
002 Angle FLOAT 3600000.0 - 3600000.0 0.0 逆时针模糊角度，0为水平模糊
  • Zoom Blur

说明：缩放模糊。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Length FLOAT 1000.0 0.0 50.0 模糊长度（标准坐标系）
002 Center X FLOAT 1.0 -1.0 0.0 模糊中心点X值（标准坐标系）
003 Center Y FLOAT 1.0 -1.0 0.0 模糊中心点Y值（标准坐标系）
004 Mipmap BOOL FALSE 启用多级模糊处理，更加平滑，但耗时多
  • Spiral Blur

说明：螺旋模糊。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Center X FLOAT 1.0 -1.0 0.0 模糊中心点X值（归一化坐标系）
002 Center Y FLOAT 1.0 -1.0 0.0 模糊中心点Y值（归一化坐标系）
003 Radius FLOAT 10000.0 0.0 2000.0 模糊半径（标准坐标系）
004 Angle FLOAT 3600000.0 - 3600000.0 0.0 模糊角度
005 Rotation Angle FLOAT 3600000.0 - 3600000.0 0.0 图像逆时针旋转角度
006 Full Screen BOOL FALSE 是否全屏，全屏下参数Radius失效
  • Shape

说明：该特技能够实现矢量图形的绘制，诸如矩形，椭圆以及path，并且能以单色或者渐变色的方式对shape进行填充。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Type MENU Rectangle 绘制形状类型：可以为 Rectangle，Ellipse，Path
002 AnchorX FLOAT 100000.0 -100000.0 0.0 shape二维变换锚点X
002 AnchorY FLOAT 100000.0 -100000.0 0.0 shape二维变换锚点Y
002 ScaleX FLOAT 1000.0 -1000.0 0.0 水平缩放系数
002 ScaleY FLOAT 1000.0 -1000.0 0.0 垂直缩放系数
002 RotZ FLOAT 3600000.0 -3600000.0 0.0 旋转角度
002 TransX FLOAT 100000.0 -100000.0 0.0 水平平移
002 TransY FLOAT 100000.0 -100000.0 0.0 垂直平移
002 CenterX FLOAT 100000.0 -100000.0 0.0 中心点X坐标 仅在Rectangle和Ellipse有效
002 CenterY FLOAT 100000.0 -100000.0 0.0 中心点Y坐标，适用范围同上
002 Width FLOAT 100000.0 0.0 0.0 shape宽度，同上
002 Height FLOAT 100000.0 0.0 0.0 shape高度，同上
002 BorderRadius FLOAT 100000.0 0.0 0.0 圆角半径，仅Rectangle
002 PathDesc STRING 用于描述Path构成，仅Path
002 FillMode MENU 填充模式
002 Color COLOR 1.0:1.0:1.0:1.0 填充颜色，仅在FillMode为Color生效
002 GradientDesc STRING 填充渐变色，仅在FillMode为Gradient生效
002 Antialiasing BOOL TRUE 抗锯齿
  • Water Ripple

说明：水波纹。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Pattern Path STRING 样式文件路径
  • Line Effect

说明：毛刺特技。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Angle FLOAT 360.0 0.0 0.0 线条变化方向的角度值，取值仅限0，90，180，270
002 Progress FLOAT 1.0 0.0 0.0 条变化进度
003 Style STRING swipe 风格:swipe或blur
  • Set Alpha

说明：设置输入图像或颜色的alpha通道。需要两个输入，依次为原图像与alpha图像。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Invert Alpha BOOL FALSE 反转alpha图像
002 Use Alpha Channel BOOL FALSE 输出图像的alpha通道为alpha图像的alpha通道，否则为alpha图像的R通道。
003 Use Solid Src Color BOOL FALSE 使用纯色作为原图像
004 Src Color Red FLOAT 1.0 0.0 1.0 纯色的R分量（仅Use Solid Src Color为TRUE时有意义）
005 Src Color Green FLOAT 1.0 0.0 1.0 纯色的G分量（仅Use Solid Src Color为TRUE时有意义）
006 Src Color Blue FLOAT 1.0 0.0 1.0 纯色的B分量（仅Use Solid Src Color为TRUE时有意义）
007 Src Color Alpha FLOAT 1.0 0.0 1.0 纯色的A分量（仅Use Solid Src Color为TRUE时有意义）
  • Mosaic

说明：马赛克。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Unit Size FLOAT 1.0 0.0 0.05 模糊单元大小
002 Align Center BOOL FALSE 是否居中对齐
  • Glitter

说明：闪光。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Quantity FLOAT 1.0 0.0 0.5 闪光数量
002 Source Path STRING 闪光纹理文件路径
003 Minus Thresh FLOAT 1.0 0.0 0.15 阈值
004 Glitter Size FLOAT 1.0 0.0 0.5 闪光尺寸
  • Cartoon

说明：卡通。Grayscale，Stroke Only同时为TRUE时，启用Stroke Only

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Grayscale BOOL FALSE 只画轮廓
002 Stroke Only BOOL FALSE 是否是灰度圈
003 Lut File STRING Lut文件路径
  • Positioner

说明：属性特技是videoclip自带的一个特技，默认是关闭，通过enablePropertyVideoFx接口开启或者关闭属性特技。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 取 值 范 围 说 明
001 Fill Mode Menu AspectFit "PanAndScan"：Pan&Scan模式。 "AspectFit"：fit模式。 "Stretch"：拉伸。 "Fill"：填充 图像的填充模式
002 Scan Value FLOAT 1.0 -1.0 0.0 缩放（仅Pan&Scan模式有效）
003 Pan Value FLOAT -1.0 0.0 平移（仅Pan&Scan模式有效）
004 Scale X FLOAT 1000.0 -1000.0 0 X方向水平缩放
005 Scale Y FLOAT 1000.0 - 1000.0 1.0 Y方向垂直缩放
006 Rotation FLOAT 3600000.0 - 3600000.0 0.0 旋转角度
007 Anchor X FLOAT 100000.0 -100000.0 0.0 水平锚点
008 Anchor Y FLOAT 100000.0 - 100000.0 0.0 垂直锚点
009 Trans X FLOAT 100000.0 - 100000.0 0.0 X方向平移
010 Trans Y FLOAT 100000.0 - 100000.0 0.0 Y方向平移
011 Enable MultiSample BOOL FALSE 是否开启重采样
012 Opacity FLOAT 1.0 0.0 1.0 不透明度
013 Wrap Mode Menu Clamp To Edge "Clamp To Edge"：边缘裁剪 "Mirrored Repeat"：镜像循环 "Repeat"：循环 边缘模式
014 Background Mode Menu Color Solid "Color Solid"：颜色 "Blur"：模糊 "Image File"：图片 背景模式
015 Background Color COLOR 0.0.0.0 设置背景颜色（仅颜色模式有效）
016 Background Image STRING 设置背景图片路径（仅图片模式有效）
017 Background Image Pan FLOAT 1.0 -1.0 0.0 设置背景图片平移（仅图片模式有效）
018 Background Blur Radius FLOAT 64.0 0.0 0.0 设置背景模糊度（仅模糊模式有效）
019 Enable Background Rotation BOOL FALSE 设置背景模糊图像是否跟随前景图像旋转
020 Package Id STRING 空字符串 设置滤镜资源包id（特技范围仅原始画面）
021 Description File STRING 故事版特技的描述文件路径（特技范围仅原始画面）
022 Description String STRING 故事版特技的描述内容（特技范围仅原始画面）
023 Is Storyboard 3D BOOL FALSE 是否是三维故事版特技（特技范围仅原始画面）
024 Post Package Id STRING 设置滤镜资源包id（特技范围是整个timeline画幅）
025 Post Description File STRING 故事版特技的描述文件路径（特技范围是整个timeline画幅）
026 Post Description String STRING 故事版特技的描述内容（特技范围是整个timeline画幅）
027 Is Post Storyboard 3D BOOL FALSE 是否是三维故事版特技（特技范围是整个timeline画幅）
028 Package2 Id STRING 设置第二个滤镜资源包id（特技范围仅原始画面）
029 Package2 Description File 第二个故事版特技的描述文件路径（特技范围仅原始画面）
030 Package2 Description String STRING 第二个故事版特技的描述内容（特技范围仅原始画面）
031 Package2 Is Storyboard 3D BOOL FALSE 第二个故事版特技是否是三维故事版特技（特技范围仅原始画面）
032 Post Package2 Id STRING 设置第二个滤镜资源包id（特技范围是整个timeline画幅）
033 Post Package2 Description File STRING 第二个故事版特技的描述文件路径（特技范围是整个timeline画幅）
034 Post Package2 Description String STRING 第二个故事版特技的描述内容（特技范围是整个timeline画幅）
035 Package2 Is Post Storyboard 3D BOOL FALSE 第二个故事版特技是否是三维故事版特技（特技范围是整个timeline画幅）
036 Resource Dir STRING 空字符串 资源文件路径
037 Package Effect In FLOAT INT32_MAX 0.0 0.0 滤镜特技的特技开始时间
038 Package Effect Out FLOAT INT32_MAX 0.0 0.0 滤镜特技的特技结束时间
039 Package2 Effect In FLOAT INT32_MAX 0.0 0.0 第二个滤镜特技的特技开始时间
040 Package2 Effect Out FLOAT INT32_MAX 0.0 0.0 第二个滤镜特技的特技结束时间
041 Mask Region Info ARBDATA null 蒙版的形状信息，参见(NvsMaskRegionInfo)。
042 Mask Feather Width FLOAT 1000.0 0.0 0.0 蒙版羽化宽度
043 Mask Inverse Region BOOL FALSE 蒙版区域反转
044 Mask Coordinate System STRING ndc “ndc”：归一化坐标系 “timeline”：timeline坐标系 蒙版坐标类型
  • Particle System

说明：粒子。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Tail Fading Duration FLOAT 2.0 0.0 0.0 粒子尾巴褪色持续时间
002 Resource Dir STRING 资源文件路径
003 Description String STRING 描述内容
004 Description File STRING 描述文件
  • Neat

说明：磨皮。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Intensity FLOAT 1.0 0.0 0.8 强度
002 Details Intensity FLOAT 1.0 0.0 0.5 细节强度
003 Blur Thresh FLOAT 1.0 0.0 0.2 模糊阈值
004 Blur Radius FLOAT 1.0 0.0 0.5 模糊半径
  • Segmentation

说明：人体及天空分割。仅带有人体检测功能的SDK支持，程序初始化阶段需要加载相应分割模型。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Segment Type STRING Background 分割类型，目前支持”Background”，”Half Body”，”Sky”
002 Inverse Segment BOOL FALSE 反相
003 Output Mask BOOL FALSE 输出蒙版或被蒙版处理后的图像
  • Segmentation Edge

说明：生成分割边缘。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Width FLOAT 1000.0 0.0 5.0 边缘宽度
002 Color COLOR 1.0:1.0:1.0:1.0 边缘颜色
  • Line Painting

说明：标记箭头、线条的绘制。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Tex File Path STRING 纹理文件路径
002 Desc File Path STRING 描述文件路径，优先级高于描述字符
003 Desc String STRING 描述字符串
004 Wrap Mode STRING 纹理环绕方式：Clamp To Edge，Mirrored Repeat，Repeat
  • Matte

说明：哑光。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Intensity FLOAT 1.0 0.0 0.0 强度
002 Fill Radius FLOAT 30.0 3.0 15.0 填充半径
  • Mesh Warp

说明：网格变形特效。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Warp Info ARBDATA 变形信息，参见(NvsMeshWarpInfo)。
002 Antialiasing BOOL FALSE 开启抗锯齿
  • Midtones

说明：中间调。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Color Tolerance FLOAT 1.0 0.0 0.0 色容差
002 Gray Min FLOAT 1.0 0.0 0.0 最低灰度
003 Gray Max FLOAT 1.0 0.0 0.0 最高灰度
004 Inverse BOOL FALSE 反相
  • Video Echo

说明：彩虹幻影。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Echo Frame Count INT 22 2 15 幻影帧数量
002 Echo Frame Interval INT 5 1 1 帧间隔
003 Opacity Array ARBDATA 透明度数组
004 Color Array ARBDATA 透明度数组
  • Master keyer

说明：色键的抠像。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Key Color COLOR 1.0, 1.0, 1.0, 1.0 0.0, 0.0, 0.0, 0.0 0.0, 0.0, 0.0, 0.0 抠像基础颜色
002 Softeness Amendment FLOAT 1.0 -1.0 0.0 软边宽度
003 Spill Removal BOOL FALSE 溢色去除开关
004 Spill Removal Intensity FLOAT 1.0 0.0 0.25 溢色去除强度
005 Shrink Intensity FLOAT 1.0 0.0 0.0 缩边强度
006 Disable Premultiply BOOL FALSE 关闭预乘
007 Aperture FLOAT 360.0 0.0 90.0 抠像颜色孔径
  • Liquefaction

说明：液化失真。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Point X FLOAT 1.0 0.0 0.5 中心点X坐标（纹理坐标系）
002 Point Y FLOAT 1.0 0.0 0.5 中心点Y坐标（纹理坐标系）
003 Radius FLOAT 1.0 0.0 0.25 半径（纹理坐标系）
004 Type STRING Out 液化方式，支持In，Out
  • Horror

说明：恐惧。

  • Grid

说明：网格特技。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Amplitude FLOAT 3.0 0.0 1.0 振幅
002 Mode STRING Grid 模式 Grid，Point，Line
  • Noise Wave

说明：噪声波形扭曲。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Wave Length FLOAT 0.5 0.0 0.05 波长
002 Wave Amplify FLOAT 0.1 0.0 0.01 振幅
003 Noise Magnitude FLOAT 0.5 0.0 0.01 噪声强度
004 Wave Frequency FLOAT 50.0 0.0 1.0 运动快慢
  • Multi Shots

说明：分屏。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Horizontal Shot Count INT 3 1 1 水平分屏数量
002 Vertical Shot Count INT 3 1 1 垂直分屏数量
  • Noise

说明：噪声。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Intensity FLOAT 1.0 0.0 0.5 噪声强度
002 Density FLOAT 1.0 0.0 0.5 噪声密度
003 Grayscale BOOL FALSE 灰度噪声
004 Tex File Path STRING 纹理图片路径
005 Tex Intensity FLOAT 1.0 0.0 1.0 纹理强度
006 Tex Scale FLOAT 1000.0 0.0 1.0 纹理缩放倍数
  • Blend With Mask

说明：使用蒙版混合两个纹理，要求三个输入，依次为背景，前景，蒙版。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Ignore Background BOOL FALSE 忽略背景，将背景置为透明图像
002 Inverse Mask BOOL FALSE 蒙版反相
  • Hue Saturation

说明：色相/饱和度。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Settings ARBDATA 参数设置，参见(NvsHueSaturationSettingInfo)。

1.3、条件编译内建视频特效(Conditional Compiled Builtin Video Fx)

  • Painting Effect

说明：画笔（参数设置见：(NvsPaintingEffectContext) ）。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
  • Broken

说明：破碎效果。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Cge File STRING Cge 文件
002 Trans Normalized X FLOAT 1.0 -1.0 0.0 平移X归一化
003 Trans Normalized Y FLOAT 1.0 -1.0 0.0 平移Y归一化
  • Stroke Effect

说明：撞击效果。需三方技术支持。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Source File Path STRING 原文件路径
  • Fluid

说明：流动。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Edge File STRING 边缘文件
  • Face Effect

说明：人脸美化效果。支持的功能有道具，美颜，美型和美妆。程序初始化阶段需要加载相应检测模型。人体检测与渲染方案来自三方合作伙伴。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Face Type STRING NULL 脸型
002 Face Shape Level FLOAT 1.0 0.0 0.5 基础脸型程度
003 Cheek Thinning FLOAT 1.0 0.0 1.0 脸颊变薄
004 Eye Enlarging FLOAT 1.0 0.0 0.5 大眼
005 Beautification Package STRING 美型包
006 Face Ornament STRING 道具包
007 FlipX BOOL FALSE X方向翻转
008 FlipY BOOL FALSE Y方向翻转
  • Face Effect2

说明：人脸美化效果。支持的功能有美颜，美型和美妆。程序初始化阶段需要加载相应检测模型。人体检测与渲染方案来自三方合作伙伴。

序号 参 数 类 型 最 大 值 最 小 值 默 认 值 说 明
001 Reddening FLOAT 1.0 0.0 0.0 红润
002 Whitening FLOAT 1.0 0.0 0.0 美白
003 Strength FLOAT 1.0 0.0 0.0 磨皮
004 Strength Mode FLOAT 1.0 0.0 1.0 磨皮模式
005 Eye Enlarging FLOAT 1.0 0.0 0.0 大眼
006 Shrink Face FLOAT 1.0 0.0 0.0 瘦脸
007 Shrink JAW FLOAT 1.0 0.0 0.0 小脸
008 Contrast FLOAT 1.0 0.0 0.0 对比度
009 Saturation FLOAT 1.0 0.0 0.0 饱和度
010 Sticker Mode STRING 贴纸模式
011 Sticker Music Disabled BOOL FALSE 音乐贴纸不可用
012 Eye Enlarge Ratio FLOAT 1.0 -1.0 0.0 眼睛放大率
013 Eye Corner Stretch Ratio FLOAT 1.0 -1.0 0.0 眼角拉伸比
014 Shrink Face Ratio FLOAT 1.0 -1.0 0.0 缩脸比率
015 Face Width Warp Ratio FLOAT 1.0 -1.0 0.0 脸宽扭曲率
016 Face Length Warp Ratio FLOAT 1.0 -1.0 0.0 脸长扭曲率
017 Forehead Warp Ratio FLOAT 1.0 -1.0 0.0 前额扭曲率
018 Hairline Warp Ratio FLOAT 1.0 -1.0 0.0 发线扭曲率
019 Malar Warp Ratio FLOAT 1.0 -1.0 0.0 颧骨扭曲率
020 Jaw Warp Ratio FLOAT 1.0 -1.0 0.0 颚骨扭曲率
021 Chin Warp Ratio FLOAT 1.0 -1.0 0.0 下巴扭曲率
022 Eyebrow Warp Ratio FLOAT 1.0 -1.0 0.0 眉毛扭曲率
023 Eye Distance Warp Ratio FLOAT 1.0 -1.0 0.0 眼间距扭曲率
024 Nose Length Warp Ratio FLOAT 1.0 -1.0 0.0 鼻子长度扭曲率
025 Nose Width Warp Ratio FLOAT 1.0 -1.0 0.0 鼻子宽度扭曲率
026 Mouth Size Warp Ratio FLOAT 1.0 -1.0 0.0 嘴巴大小扭曲率
027 Mouth Width Warp Ratio FLOAT 1.0 -1.0 0.0 嘴巴宽度扭曲率
028 Mouth Corner Lift Ratio FLOAT 1.0 -1.0 0.0 嘴角提升率
029 Narrow Nose Param FLOAT 1.0 0.0 0.0 瘦鼻
030 Nose Length Param FLOAT 1.0 -1.0 0.0 长鼻参数
031 Chin Length Param FLOAT 1.0 -1.0 0.0 下巴
032 Mouth Size Param FLOAT 1.0 -1.0 0.0 嘴型
033 Philtrum Length Param FLOAT 1.0 -1.0 0.0 人中
034 Hairline Height Param FLOAT 1.0 -1.0 0.0 发际线
035 Thin Face Shape Param FLOAT 1.0 0.0 0.0 瘦脸型
036 Eye Distance Param FLOAT 1.0 -1.0 0.0 眼间距
037 Eye Angle Param FLOAT 1.0 -1.0 0.0 眼睛角度
038 Open Canthus Param FLOAT 1.0 0.0 0.0 开眼角
039 Profile Rhinoplasty Param FLOAT 1.0 0.0 0.0 侧脸隆鼻参数
040 Bright Eye Param FLOAT 1.0 0.0 0.0 亮眼
041 Remove Dark Circles Param FLOAT 1.0 0.0 0.0 去黑眼圈
042 Remove Nasolabial Folds Param FLOAT 1.0 0.0 0.0 去法令纹
043 White Teeth Param FLOAT 1.0 0.0 0.0 牙齿美白参数
044 Apple Musle Param FLOAT 1.0 0.0 0.0 苹果肌
045 Open External Canthus Param FLOAT 1.0 0.0 0.0 打开外眦参数
046 Shrink Cheekbone Param FLOAT 1.0 0.0 0.0 收缩颧骨参数
047 Custom Input Event INT 2147483647 0 0 自定制输入事件
048 Makeup Eye Resource STRING 美妆眼睛资源
049 Makeup Eye Strength FLOAT 1.0 0.0 1.0 美妆眼睛强度
050 Makeup Face Resource STRING 美妆脸部资源
051 Makeup Face Strength FLOAT 1.0 0.0 1.0 美妆脸部强度
052 Makeup Lip Resource STRING 美妆嘴唇资源
053 Makeup Lip Strength FLOAT 1.0 0.0 1.0 美妆嘴唇强度
054 Makeup Nose Resource STRING 美妆鼻子资源
055 Makeup Nose Strength FLOAT 1.0 0.0 1.0 美妆眉毛强度
056 Makeup Brow Resource STRING 美妆眉毛资源
057 Makeup Brow Strength FLOAT 1.0 0.0 1.0 美妆眉毛强度
058 Makeup Eyeliner Resource STRING 美妆眼线资源
059 Makeup Eyeliner Strength FLOAT 1.0 0.0 1.0 美妆眼线强度
060 Makeup Eyelash Resource STRING 美妆睫毛资源
061 Makeup Eyelash Strength FLOAT 1.0 0.0 1.0 美妆睫毛强度
062 Makeup Eyeball Resource STRING 美妆眼球资源
063 Makeup Eyeball Strength FLOAT 1.0 0.0 1.0 美妆眼球强度
064 Enable Landmark Callback BOOL FALSE 允许点位回调

2、内建视频转场(Builtin Video Transition)

  • Fade（淡入淡出）
  • Turning（翻转）
  • Swap（层叠）
  • Stretch In（伸展进入）
  • Page Curl（卷页）
  • Lens Flare（镜头炫光）
  • Star（星形）
  • Dip To Black（闪黑）
  • Dip To White（闪白）
  • Push To Right（右推拉）
  • Push To Top（上推拉）
  • Upper Left Into（斜推）
制作者   doxygen 1.8.18