滤镜：gpsgraphic

插件信息

title: GPS 图形
media types: Video
description: 将 GPS 相关图形叠加到视频上
version: 4
creator: Daniel F
copyright: Meltytech, LLC
license: LGPLv2.1

参数

resource

title: GPS 文件/URL
description: 包含位置（GPS）数据的文件的完整路径。支持的扩展名：.gpx、.tcx。
type: string
readonly: no
required: yes
widget: fileopen

time_offset

title: 时间偏移
description: 需要加到视频文件上的偏移量（以秒为单位），用于使其与 GPS 轨迹对齐。大多数情况下，该值至少需要设置为两个文件之间的时区差，另外如果视频录制设备的时间没有精确校准，还需再加上若干秒。GPS 时间始终是精确的且为 UTC。如果 GPS 领先于视频则使用正值，否则使用负值。
type: integer
readonly: no
required: no
default: 0
widget: text

smoothing_value

title: 平滑程度
description: 为消除 GPS 误差而进行平滑处理的 GPS 点数量。值为 1 时不平滑位置，只计算额外字段（速度、距离等），同时会对缺失的心率和海拔值进行插值。
type: integer
readonly: no
required: no
minimum: 1
default: 5
widget: text

speed_multiplier

title: 速度倍率
description: 如果视频文件是延时摄影（或慢动作），用此值设置加速/减速比例。示例取值：30 表示 30 倍延时，0.25 表示 4 倍慢动作素材。
type: float
readonly: no
required: no
default: 1
widget: text

graph_data_source

title: 图形数据源
description:

使用 GPS 文件中的哪些数据来绘制：
0 = GPS 位置/轨迹
1 = 海拔（如果可用）
2 = 心率（如果可用）
3 = 速度（始终可用，由位置计算得出）

type: integer
readonly: no
required: no
minimum: 0
maximum: 3
default: 0
widget: combo

graph_type

title: 图形类型
description:

如何绘制所选数据：
0 = 基本的二维地图折线（针对位置）或按时间的一维图表（其他数据）
1 = 放大地图/图表并围绕当前位置居中
2 = 绘制速度表盘（所有数据源均可用，但仅推荐用于速度；
对于地图类型，它表示从裁剪的起点到终点之间的"完成百分比"）
注意：对于类型 1（跟随居中的圆点）：
* 裁剪值仅按百分比有效，且只取下侧（相应地取左侧）的值作为两侧的值
（即：bot/top 两个值必须相等才能保持圆点居中）
* 如果数据源不是 GPS 位置，则只对水平轴（时间）做居中处理，
垂直轴的裁剪行为与类型 0 相同（静态保持相同的 min/max 界限，
允许 now_dot 上下移动）。

type: integer
readonly: no
required: no
minimum: 0
maximum: 2
default: 0
widget: combo

trim_start_p

title: 起始裁剪
description: 从 GPS 文件开头裁剪掉数据（占总量的百分比）。注意：trim_start_p 和 trim_end_p 都是相对整个文件计算的，因此起始裁剪 50% 并结尾裁剪 50% 会导致整个文件被裁掉。
type: float
readonly: no
required: no
minimum: 0
maximum: 100
default: 0
widget: spinner

trim_end_p

title: 结尾裁剪
description: 从 GPS 文件结尾裁剪掉数据（以占总量的反向百分比表示，即：100 表示不裁剪，50 表示裁掉文件一半，5 表示裁剪掉 95% 的文件）。注意：trim_start_p 和 trim_end_p 都是相对整个文件计算的，因此起始裁剪 50% 并结尾裁剪 50% 会导致整个文件被裁掉。
type: float
readonly: no
required: no
minimum: 0
maximum: 100
default: 100
widget: spinner

crop_mode_h

title: 水平裁剪模式
description:

决定如何解释 crop_left_p 和 crop_right_p 的值：
0 = min..max 范围内的百分比
1 = 绝对值（例如可以在 22.2 到 22.3 度经度之间进行裁剪）
注意：对于水平类型，绝对值指经度（针对位置数据源类型），
其余数据源类型则为时间（自 epoch 起的毫秒数）

type: integer
readonly: no
required: no
minimum: 0
maximum: 1
default: 0
widget: combo

crop_left_p

title: 向左裁剪
description: 从图形左侧裁剪数据（实际上相当于放大）。该值根据 crop_mode_h 被解释为占总量的百分比或绝对值。在百分比模式下，取值不限于 0-100，以支持"缩小"行为（例如：左侧裁剪 -50 会额外增加相当于总水平距离一半的范围）。（在百分比模式下）取值超过 100 将实际上不显示任何内容。如果 graph_type 为速度表盘，则所有左右裁剪值都被忽略。
type: float
readonly: no
required: no
default: 0
widget: spinner

crop_right_p

title: 向左裁剪
description: 与 crop_left_p 相同，但作用于右侧，且百分比类型按反向百分比解释（即：100 = 不裁剪）。取值小于 0 将实际上不显示任何内容。
type: float
readonly: no
required: no
default: 100
widget: spinner

crop_mode_v

title: 垂直裁剪模式
description:

决定如何解释 crop_bot_p 和 crop_top_p 的值：
0 = min..max 范围内的百分比
1 = 绝对值（例如可缩放到海拔 100 到 150m 之间，
以便更好地显示这两个值之间的微小高度变化）
注意：对于垂直类型，绝对值指纬度度数（针对位置数据源类型），
其余数据源则为海拔、心率、速度，按 legend_unit 类型解释（如适用）
（即：海拔值 10 默认按米理解，但若把 legend_unit 改为 feet，
则表示 10 英尺）。

type: integer
readonly: no
required: no
minimum: 0
maximum: 1
default: 0
widget: combo

crop_bot_p

title: 向左裁剪
description: 从图形下侧裁剪数据（实际上相当于放大）。该值根据 crop_mode_v 被解释为占总量的百分比或绝对值。在百分比模式下，取值不限于 0-100，以支持"缩小"行为（例如：下侧裁剪 -50 会在底部额外增加相当于总垂直距离一半的范围）。（在百分比模式下）取值超过 100 将实际上不显示任何内容。如果 graph_type 为速度表盘，则该项设置指针的最小位置，所有更低的值都会被截断。
type: float
readonly: no
required: no
default: 0
widget: spinner

crop_top_p

title: 向左裁剪
description: 与 crop_bot_p 相同，但作用于上侧，且百分比类型按反向百分比解释（即：100 = 不裁剪）。取值小于 0 将实际上不显示任何内容。
type: float
readonly: no
required: no
default: 100
widget: spinner

color_style

title: 图形配色样式
description:

选择以下样式之一来绘制图形折线：
0 = 单色 -> 整条图形使用相同颜色和粗细
1 = 双色 -> 同 2 和 3，但整条线粗细一致
2 = 实线过去、细线未来 -> 从图形起点到当前位置（即"过去"）
使用第 1 种颜色和所选粗细绘制，而图形的"未来"部分使用第 2 种颜色，
粗细为 2px（若主粗细小于 3 则为 1px）
3 = 实线未来、细线过去
4 = 垂直渐变 -> 相对整个矩形区域，线条按垂直渐变着色
5 = 水平渐变
6 = 按时间着色 -> 所选颜色作为渐变，按时间顺序使用
（除位置数据源外，对一维图表而言实际上就是从左到右的渐变）
7 = 按海拔着色 -> 所选颜色作为渐变，从文件中的最小海拔值
渐变到最大值，不受裁剪或 trim 影响
8 = 按心率着色
9 = 按速度着色 -> 同上，但渐变受平滑影响
10 = 按速度着色（上限 100km/h）-> 可接受的最大速度为 100km/h - 用于规避严重 GPS 误差
11 = 按坡度着色（上限 90 度）-> 渐变跟随坡度值，但以最大 90 度为基准
（若最大坡度小于 90，则以该值为基准）；受平滑影响
12 = 按坡度着色（上限 20 度）-> 同上，但最大颜色以 20 度为基准；这样做
对大多数 GPS 轨迹能给出符合预期的颜色，否则一小段较陡的区域会让轨迹其余部分
与平地无法区分

type: integer
readonly: no
required: no
minimum: 0
maximum: 9
default: 1
widget: combo

color.*

title: 颜色
description:

设置图形折线的颜色。
可以使用递增后缀指定多个颜色，使折线按特定方式绘制
（即：渐变或过去/未来）。
默认情况下，该滤镜有 5 种颜色（蓝、绿、黄、橙、红）：
color.1 = #ff00aaff
color.2 = #ff00e000
color.3 = #ffffff00
color.4 = #ffff8c00
color.5 = #ffff0000
颜色值是 RGB 加 alpha 通道的十六进制表示，形式为 0xrrggbbaa。
颜色也可以是这些单词：white、black、red、green 或 blue。
还可以使用 HTML 风格的颜色值 #rrggbb 或 #aarrggbb。

type: color
readonly: no
required: no
animation: yes
widget: color

show_now_dot

title: 显示当前圆点
description: 启用后，在图形折线上当前位置/时间处绘制一个圆片。如果图形类型为速度表盘，则影响指针。
type: boolean
readonly: no
required: no
default: 0
widget: checkbox

now_dot_color

title: 当前圆点颜色
description: 选择 now_dot 圆片外圈的颜色。该圆圈的大小与线条粗细相同。圆片内部始终为白色。如果颜色的 alpha 值为 0（默认），则使用与附近（或过去）线段相同的颜色（渐变类型同样如此），因此实际上会让它随时间改变颜色。颜色值是 RGB 加 alpha 通道的十六进制表示，形式为 0xrrggbbaa。颜色也可以是这些单词：white、black、red、green 或 blue。还可以使用 HTML 风格的颜色值 #rrggbb 或 #aarrggbb。
type: color
readonly: no
required: no
animation: yes
widget: color

show_now_text

title: 显示当前数值文本
description: 启用后，在矩形区域右下方以大号白色粗体字绘制当前值。legend_unit 的值会追加在末尾并作为当前单位使用（如果在 legend_unit 字符串中找到有效单位，例如其中任意位置出现 "km" 即视为公里）。
type: boolean
readonly: no
required: no
default: 0
widget: checkbox

angle

title: 旋转
description: 旋转整个图形矩形。对于速度表盘类型，文字保持水平。
type: float
readonly: no
required: no
default: 0

thickness

title: 线条粗细
description: 以 px 设置折线的粗细。
type: integer
readonly: no
required: no
minimum: 1
default: 5

show_grid

title: 绘制图例
description: 启用后，将绘制 5 条水平线（地图类型还绘制垂直线）并标注小数值，分别对应当前显示图形的当前数据源值的 0%、25%、50%、75% 和 100% 处；如适用则受 legend_unit 类型影响，并把该字符串追加到数值之后。对于速度表盘类型，这显示刻度值（但不追加单位）。
type: boolean
readonly: no
required: no
default: 0
widget: checkbox

legend_unit

draw_individual_dots

title: 仅显示点
description: 启用后，图形将用独立的点而非线来绘制。这实际上会显示受平滑影响的各个数据点（例如：对于位置数据，若平滑值为 1，则显示每个 GPS 定位点），既可以在放大到足够程度时用作炫酷效果，也可以用于调试意外的线条跳跃。
type: boolean
readonly: no
required: no
default: 0
widget: checkbox

rect

title: 矩形
description: 定义绘制图形所在的矩形。格式为："X Y W H"。X、Y、W、H 默认按像素单位解释，除非带有后缀 '%'。
type: rect
readonly: no
required: no
default: 0 0 100% 100%

bg_img_path

title: 背景图像
description: 如果选择了有效的图像文件，将作为矩形区域的背景使用。以 "!" 字符开头的路径会被忽略。提示：使用地图图像可以为 GPS 轨迹增加上下文。
type: string
readonly: no
required: no
widget: fileopen

bg_scale_w

title: 背景缩放
description: 缩放背景图像（相对中心），使其与上面的 GPS 轨迹匹配。小于 1 的值放大图像，大于 1 的值缩小图像。0 表示隐藏。
type: float
readonly: no
required: no
minimum: 0
maximum: 2
default: 1

bg_opacity

title: 背景不透明度
description: 设置背景图像的不透明度。
type: float
readonly: no
required: no
minimum: 0
maximum: 1
default: 1

gps_start_text

title: GPS 起始时间
description: 第一个有效 GPS 点的日期和时间。
type:
readonly: yes
required: no

video_start_text

title: 视频起始时间
description: 视频文件的日期和时间。
type:
readonly: yes
required: no

auto_gps_offset_start

title: 自动起始偏移
description: 提供一个辅助偏移量，以保证视频文件开头与 gps 文件开头同步。如果视频文件和 gps 记录是同时开始的，该值能正确设置偏移。
type:
readonly: yes
required: no

auto_gps_offset_now

title: 自动当前偏移
description: 提供一个辅助偏移量，把第一个 gps 点同步到当前视频时间（每秒更新一次）。如果你在 gps 启动的瞬间开始录制视频，该值能正确设置偏移。
type:
readonly: yes
required: no

map_coords_hint

title: 地图提示
description: 返回 gps 文件的中心经纬度坐标。
type:
readonly: yes
required: no

Filter: glsl.manager 滤镜：gpstext