gpac - 云端在线

程序：

您的姓名

GPAC - MPEG-4 系统框架和软件开发套件

商品描述

GPAC 代表（是吗？）GPAC 高级内容项目。 它是一个实现
以 ANSI C 编写的 MPEG-4 系统标准。GPAC 提供媒体播放工具，
矢量图形和 3D 渲染、MPEG-4 创作和分发。 这个手册页是
关于GPAC框架版本0.5.0的配置。

引言

GPAC框架中的一些应用程序使用在模块之间共享的配置文件
可在运行时重新加载。 该文件位于用户主目录中，名为
“.gpacrc”。

配置文件基于 win32 .ini 文件模型，按部分排序并
键。

一个部分被声明为 [部分名称] ，一个键被声明为 键名=值 ， 钥匙
值不被解释并且始终作为 ASCII 文本处理。 插件可以使用
配置文件也是如此（以避免多个文件）。

备注 on 插入 绍菜、黄芽菜、结球白菜、包心白菜 配置文件中给出的插件名称是导出的名称
由每个接口而不是物理库文件的名称（.dll/.so ...）。 物理方面
但是文件名可以用来识别插件，它将被接口替换
插件加载成功时的名称。

部分 常规

“常规”部分包含通用、操作系统和播放器特定选项。 本节不是
由 GPAC 框架使用。

模块目录 （价值： 路径）
模块（插件）位置的路径。 没有模块就无法加载客户端。
所有平台上的所有 GPAC 客户端都使用此选项

缓存目录 （价值： 路径）
指定临时文件的位置。 这必须是目录的绝对路径
具有写权限。 虽然没有被应用程序使用，但它被多个应用程序使用
插件。

以下选项是为 Osmo4/wxWidgets 播放器定义的。

循环 （价值： 是的， 不要）
指定演示文稿播放完毕后是否必须重新启动。

控制台关闭 （价值： 是的， 不要）
指定应用程序消息（脚本、缓冲、下载进度）是否
是否显示在控制台中。

浏览器 （价值： 字符串）
指定 WWW 锚点和场景图查看的首选浏览器 - 仅由使用
Osmo4/wxWidgets。

寻找字幕 （价值： 是的， 不要）
指定 Osmo4 在打开演示文稿时是否查找字幕文件。

PL入口 （价值： 无符号 整数)
指示播放器上次关闭时的活动播放列表条目。 播放列表备份是
“.gpac_pl.m3u”，存储在用户主目录中。

启动文件 值： 文档名称）
指定 osmo4/MP4Client 启动时加载的文件。 如果没有指定，则没有文件
已加载。

NoMIMETypeFetch （价值： 是的， 不要）
指定播放器在跟随超链接时是否必须检查 MIME 类型，或者
只关注已知扩展的链接。

日志文件 （价值： 文档名称）
指定 GPAC 日志的输出位置。 默认情况下，日志写入 stdout。
请注意，GPAC 可能在没有日志支持的情况下进行编译。 MP4Client 不使用它。

日志级别 （价值： 没有任何， 错误， 警告， 信息， 调试）
指定日志的级别。 缺省情况下，不进行日志记录。

日志工具 （价值： a ':'-分隔 名单 of 这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 以下 值）
指定应记录 GPAC 中的哪组工具。 可用的工具有：
核心：libgpac 核心事件。
编码：比特流格式（音频、视频、场景）。
容器：容器格式（ISO 文件、MPEG-2 TS、AVI...）。
网络：除 RTP 流量外的网络数据。
rtp：rtp、rtcp 和 rtsp 流量。
作者：创作工具（提示、导入、导出）。
同步：终端同步层。
编解码器：终端编解码器消息。
解析器：场景解析器（svg、xmt、bt）等。
media：终端媒体对象管理。
scene：场景图和场景管理器。
script：编写引擎消息的脚本。
compose：组合引擎（事件等）。
渲染：渲染引擎​​（2D、3D 等）。
服务：网络服务管理。
mmio：音频/视频硬件 I/O 管理。

部分 最近的文件

配置文件的“RecentFiles”部分保存最后访问的文件（硬编码为无
超过 20) 在最后的访问顺序中。 键是文件名，不使用任何值。
此部分仅由 GUI 客户端使用。

部分 系统

“系统”部分包含 MPEG-4 系统引擎的所有配置选项。 这
定义了以下选项：

语言 （价值： 3 个字符 码 ， ISO 639-2）
指定用户首选语言。 这用于在以下情况下选择流
音频对象中的替代内容。

始终绘制BIFS （价值： 是的， 不要）
如果设置，后期 BIFS 帧仍将被绘制。 如果没有设置，场景不会被重绘
直到 BIFS 流恢复同步。 默认情况下此功能处于关闭状态，以保持更好的同步，
但在测试大量内容或缓慢渲染器时可能会发生变化。

强制单时钟 （价值： 是的， 不要）
MP4 文件的一大问题是“持续时间”的概念一直不明确
很长一段时间以来，大多数可用内容（音频视频文件）都指定了错误
BIFS 持续时间。 在这种情况下，无法控制/搜索电影。
ISMA 流的另一个问题是 BIFS/OD 不使用与
音频/视频，因此寻找主时间线不寻找AV媒体。
设置 ForceSingleClock 将通过使用单个时间线来处理这两种情况
所有媒体流并将持续时间设置为最长的流之一。

线程策略 （价值： 免费， 单， 多）
指定媒体解码器的线程化方式。
自由：让解码器决定他们的线程。
Single：意味着所有解码器都在单个线程中管理执行
调度和优先级处理。
Multi：意味着每个解码器在自己的线程中运行。

优先 （价值： 低， 正常 高， 即时的）
指定解码器的优先级（优先级应用于解码器线程）
无论线程模式如何）。

硬编码的原型 （价值： 名单 of 字符串 分离 by 空间）
保存 EXTERNPROTO URL 的列表（NO OD_ID !!!），在硬编码中实现
渲染器 - 仅用于开发。

无视觉线索 （价值： 是的， 不要）
指定视觉渲染是在主编解码器管理器中还是在编解码器管理器中完成
专用线程。

DefAudioDec, 定义视频解码器 （价值： 字符串）
指定默认使用哪个插件进行音频/视频解码。 例子，
“DefVideoDec=名称”。 给出的名称是要使用的插件的名称（相同
与其他插件的注意事项，参见上文）。

编解码器_XX_XX （价值： 字符串）
允许为每个流类型和对象指定默认媒体插件（音频/视频）
类型。 如果您对给定类型有多个解码器，这会很有用。 这
语法是 codec_AA_BB=插件名称 其中 AA 是十六进制 MPEG-4 流类型
编解码器的值（0x04=视觉，0x05=音频），BB 是十六进制的 MPEG-4
媒体的对象类型指示（0x20 = MPEG-4 视频，0x40=MPEG-4 音频，...）。
给出的名称是要使用的插件的名称（与其他插件的注意事项相同）
插件，参见上文）。

部分 渲染

“渲染”部分包含逻辑渲染引擎的所有配置选项，
无论是 2D 还是 3D。 定义了以下选项：

渲染器名称 （价值： 字符串）
指定应使用哪个渲染器。 目前有 2 个渲染器可用
在 GPAC 中，“GPAC 2D 渲染器”和“GPAC 3D 渲染器”。 渲染器无法重新加载
运行时，必须重新启动整个系统。

光栅2D （价值： 字符串）
指定用于矢量绘图的 2D 光栅器。 由 2D 渲染器使用（用于
一切）和 3D 渲染器（用于纹理文本和渐变）。

帧率 （价值： 漂浮）
指定演示的模拟帧速率 - 该值也被使用
由 MPEG-4 系统引擎来确定 BIFS 帧何时适合解码。

抗锯齿 （价值： 没有， 所有， 文本）
指定抗锯齿设置 - 是否应用该设置取决于
图形插件/图形卡。
无：无抗锯齿
文本：仅对文本进行抗锯齿
全部：完全抗锯齿

快速渲染 （价值： 是的， 不要）
指定渲染是否应以速度或质量为目标 - 设置是否为
应用与否取决于图形插件/显卡。

力场景大小 （价值： 是的， 不要）
如果没有给出尺寸信息，则强制场景调整为可用的最大位图
在 BIFS 配置中。

压力模式 （价值： 是的， 不要）
指定渲染器在最坏的情况下运行，重新计算所有向量
路径、网格、轮廓和重新加载纹理（将它们发送到显卡）
每一帧。

边界体积 （价值： 没有， 框， AABB）
指定是否绘制对象的包围体。 注意
2D 渲染器仅使用矩形作为包围体。 使用“AABB”值
仅由 3D 渲染器指定，并指定应绘制的对象边界框树。

部分 渲染2D

“Render2D”部分包含 2D 图块渲染引擎的所有配置选项。
定义了以下选项：

直接渲染 （价值： 是的， 不要）
指定是否应使用直接渲染。 在直接渲染模式下，
屏幕在每一帧都完全重绘。 在间接渲染对象中
从帧到帧跟踪定位并收集脏矩形信息
为了重绘最小量的屏幕缓冲区。是否设置为
应用与否取决于图形插件（目前所有插件都处理
模式）。

可缩放 （价值： 是的， 不要）
指定是否应使用可缩放缩放。 当可缩放变焦为
启用后，调整输出窗口的大小也将重新计算所有矢量对象。
否则仅拉伸最终缓冲区。

部分 渲染3D

“Render3D”部分包含 3D openGL 渲染引擎的所有配置选项。
定义了以下选项：

光栅轮廓 （价值： 是的， 不要）
指定轮廓应通过 openGL 笔宽度而不是
矢量轮廓。

多边形AA （价值： 是的， 不要）
指定是否应在完全抗锯齿模式下使用多边形抗锯齿。 如果
未设置，仅使用线和点抗锯齿。

原型的进一步迭代 （价值： 有线无， 仅有线， 实心线）
指定线框绘图选项：
WireNone：对象被绘制为实体
WireOnly：对象仅绘制为线框
WireOnSolid：将对象绘制为实体，然后绘制线框

禁用矩形扩展 （价值： 是的， 不要）
指定是否openGL矩形纹理扩展（GL_EXT_texture_rectangle或
应使用或不使用 GL_NV_texture_rectangle)。
如果“是”，则尺寸不是 XNUMX 的幂的纹理将重新缩放，除非
硬件支持非二次幂纹理 (GL_ARB_texture_non_power_of_two)
本地
如果“否”并且扩展可用，则使用纹理而不重新缩放。 注意
在这种情况下，纹理转换被禁用。

模拟POW2 （价值： 是的， 不要）
启用 2 次方仿真。 如果 openGL 矩形纹理扩展是则忽略
启用。
如果设置，视频纹理不会调整大小，而是使用填充进行模拟。 这通常会加快速度
增加形状上的视频映射，但禁用纹理转换。
如果未设置，则在映射到形状时，视频大小将调整为 2 纹理的幂。

位图复制像素 （价值： 是的， 不要）
指定是否应使用常规 openGL 纹理绘制位图节点
（“否”）或通过像素复制例程（“是”）。 这极大地影响了视频渲染
根据显卡通过位图。 有些卡会有更快的像素
复制纹理传输例程，有些不会。

部分 音频

“音频”部分包含音频渲染引擎的所有配置选项和
硬件。 请注意，大多数选项取决于所使用的驱动程序，并且可能会被忽略
司机。 定义了以下选项：

强制配置 （价值： 是的， 不要）
强制使用给定的声卡配置。 如果不设置声卡将
设置为使用 2 个音频缓冲区，每个缓冲区有 1024 个样本。 这可能无法正常工作
某些声卡由于硬件延迟，因此强制配置可能会非常困难
有用的。

缓冲区数 （价值： 整数， 0 禁止）
当强制配置时，指定要分配的音频缓冲区的数量（音频
如果可能的话，缓冲区以环形方式播放，否则将使用单个音频缓冲区
分配）。

总持续时间 （价值： 整数， 0 禁止）
当强制配置时，指定总音频缓冲区大小（以毫秒为单位）。 是
注意音频缓冲区越长，音频延迟就越长
暂停音频对象时。 快进音频播放的质量也会
使用大型音频缓冲区时会降级。
请注意： SDL 音频插件不使用 TotalDuration 和 num 缓冲区
同样，它只是使用此设置计算所需的音频缓冲区大小，并且
选择音频缓冲区大小的下一个 2 的幂。 它不使用环形缓冲区
的。

不重新同步 （价值： 是的， 不要）
禁用音频重新同步：永远不会调整音频时钟，并且可能会出现 A/V 同步
被打破

禁用多通道 （价值： 是的， 不要）
禁用音频多通道输出并始终缩混为立体声。 这可能是
如果多通道输出行为异常，则很有用。

禁用通知 （价值： 是的， 不要）
在支持时禁用音频缓冲区通知的使用（当前仅
DirectSound 支持）。 如果 DirectSound 音频听起来很奇怪，请尝试不使用
通知。 在 Win32/DX 以外的其他平台上被忽略。

驱动程序名称 （价值： 字符串）
指定用于音频渲染的驱动程序。

音量 （价值： 整数， 范围 0-100）
指定启动 GPAC 时使用的默认音量。

锅 （价值： 整数， 范围 0-100）
指定启动 GPAC - 0 时使用的默认音频立体声平衡
左，100 为全右，50 为平衡。

部分 视频

“视频”部分包含视频渲染器和硬件的所有配置选项。
定义了以下选项：

禁用YUV （价值： 是的， 不要） - 用过的 by 2D 渲染器 仅由
禁用 YUV 硬件支持（YUV 硬件支持可能不适用于
当前插件）。

开关分辨率 （价值： 是的， 不要）
如果启用，则选择大于场景大小的最小视频分辨率，否则使用
当前视频分辨率。

驱动程序名称 （价值： 字符串）
指定用于视频内存访问的驱动程序。

部分 网络

“网络”部分包含插件和使用的网络的所有配置选项
系统引擎。 定义了以下选项：

自动重新配置UDP （价值： 是的， 不要）
指定如果 UDP 流量被阻止，网络管理器是否应重新连接场景。

数据超时 （价值： 无符号 整数)
指定初始缓冲中止之前的超时（以毫秒为单位）。 默认终端
值为 20000（20 秒）。

UDP不可用 （价值： 是的， 不要）
指定UDP流量不可用（通常由GPAC设置）

UDP超时 （价值： 无符号 整数)
指定初始 UDP 检测的超时（以毫秒为单位）。 一旦 UDP 数据包被
收到的超时被忽略。

缓冲区长度 （价值： 无符号 整数)
指定解码缓冲区的默认长度（以毫秒为单位）。 客户端
在开始解码之前将等待缓冲区被填满。 插件可能决定
根据协议和网络抖动使用不同的值。

重新缓冲长度 （价值： 无符号 整数)
指定解码缓冲区的重新缓冲长度（以毫秒为单位）。 每当
解码缓冲区充满度小于该值，对象时钟暂停并且
流重新缓冲直到 BufferLength。 因此，值为 0 表示没有
重新缓冲。 插件可能会根据协议决定使用不同的值
网络抖动。

部分 字体引擎

“FontEngine”部分包含字体处理的所有配置选项。 全球政治行动委员会
渲染模块通过矢量轮廓处理文本，允许图形插件
开发时无需集成文本渲染，这始终是一项繁重的工作。 这
定义了以下选项：

驱动程序名称 （价值： 字符串）
指定用于字体处理的驱动程序。

字体目录 （价值： 路径）
指定字体所在目录-目前只能有一个目录
被指定（但是没有什么可以阻止字体插件使用私有目录）。
如果目录无效或不包含字体，则文本可能不可用
GPAC。

纹理文本模式 （价值： 绝不， 3D， 总是）
指定文本是否应绘制到纹理然后渲染或直接渲染
呈现。 使用纹理文本可以改善 3D 渲染器中的文本外观，并且
改进视频上的文字等内容。

衬线字体 （价值： 字符串）
指定默认 SERIF 字体。

字体Sans （价值： 字符串）
指定默认 SANS 字体。

字体固定 （价值： 字符串）
指定默认的 FIXED 字体。

请注意： freetype 插件使用此部分来维护字体名称之间的关联
和 truetype 字体文件名。 这极大地加快了运行时的字体选择速度。

部分 下载

“下载器”部分包含文件下载和缓存的所有配置选项。

清理缓存 （价值： 是的， 不要）
指定下载的文件一旦使用是否应删除。

重启文件 （价值： 是的， 不要）
指定之前是否应删除不完整下载的文件
重新下载。

最大速率 （价值： 积极 整数）
指定文件下载的最大数据速率（以千位每秒为单位）。 这
用于模拟目的。 值为 0 表示没有速率限制。

用户代理 （价值： 字符串）
指定备用用户代理（默认为“GPAC $VERSION”）。

部分 代理服务器

配置文件的“HTTPProxy”部分保存 HTTP 代理的配置选项
寻址。 目前只能启用一个代理，并且不进行 URI 选择

启用 （价值： 是的， 不要）
指定下载文件时是否应使用代理。

姓名 （价值： 字符串）
指定不带协议标识符的代理名称（IP 地址或解析名称）
（例如，没有“http://”）。 如果不存在，则代理被禁用。

港口 （价值： 积极 整数）
指定与代理一起使用的端口。 如果未指定端口，则默认 HTTP
使用端口 (80)。

部分 流

“Streaming”部分包含使用 IETF 进行实时流传输的所有配置选项
SDP/RTSP/RTP/RTCP 协议。

默认端口 （价值： 无符号 短）
指定连接到服务器时使用的默认端口（如果端口被忽略，则忽略
网址中指定）。 如果端口是 80 或 8080 (HTTP)，客户端将连接到
RTSP 服务器通过 HTTP 隧道，传输将在 RTSP 上进行
连接。

重新订购尺寸 （价值： 整数）
RTP 重新排序缓冲区的大小 - 0 表示不重新排序。 运输时忽略
发生在 RTSP 连接上

RTSP 上的 RTP （价值： 是的， 不要）
指定是否应在 RTSP 连接上承载 RTP 数据包（TCP 或 UDP）
如果可能，或者通过 UDP 进行。 如果连接端口是HTTP端口，则此
值被假定为 true

RTSP超时 （价值： 无符号 整数)
指定与服务器的连接超时：RTSP 请求被视为
超时后失败。

首次丢包 （价值： 无符号 整数)
指定要丢弃的第一个 SL 数据包 - 0 表示没有数据包丢弃。 用于
丢包模拟测试。

丢包频率 （价值： 无符号 整数)
指定 SL 数据包被丢弃的频率。 如果值为20，则一包
每收到 20 个数据包就会被丢弃。 用于丢包模拟测试。

部分 Mime类型

此部分用于保留 GPAC 插件的 MIME 类型和文件关联。 格式
关键是： mimeType="fileExt1 文件xExt2 .. 文件xExtN" 哑剧类型 描述 插件名称
该描述用于 GUI 目的（打开文件对话框）。 您可以修改该文件
扩展列表以支持您自己的扩展。 MIME 类型始终在以下情况下进行检查：
处理远程资源（例如http文件）以加载适当的插件。
如果 MIME 类型不可用，则首先检查提供的扩展名，然后检查所有输入
插件被查询。

部分 Mime类型

配置文件的“StreamingCache”部分保存了所有配置选项
流缓存。 流缓存允许记录实时源，例如 RTP/RTSP
会议和网络广播。 目前这只是 GPAC 中的一个实验性功能。
记录目录 （价值： 路径） 指定录制文件的路径。 缓存数据已写入
直接写入磁盘（无需重新交错或类似过程）。 如果没有指定，则默认
使用缓存目录。

基本文件名 （价值： 字符串）
指定录制文件的基本名称。 如果配置文件中不存在，
使用服务名称 (URL)。

保留现有文件 （价值： 含 不要）
指定是否应保留同名的缓存文件。 如果不是，则为整数
编号将添加到缓存的文件名中，最新文件的最大编号。

部分 SAX加载器
“SAXLoader”部分包含 SVG 的 XML SAX 解析的所有配置选项，
XMT 和 X3D 文件。

进步 （价值： 字符串）
指定加载器使用的 XML 解析模式。 支持的模式有：
yes：SAX 解析用于渐进式加载文档。
no：使用SAX解析，文档将首先被完整下载。
DOM：使用DOM解析，文档将首先被完整下载。 仅有的
由 libXML2 插件支持，否则按“否”处理。

最长持续时间 （值 积极 整数）
指定 SAX 解析器加载一部分所花费的最长时间
该文件的。 仅在 SAX 渐进模式下使用。

部分 XviD格式

“XviD”部分包含 XviD 编解码器的所有配置选项。

后处理 （价值： 字符串）
指定解码视频时要应用的过滤器。 该字符串是过滤器列表
用空格字符分隔。 支持的过滤器有：
电影效果：xvid 1.0.0 电影效果。
Deblock_Y：Y 平面去块滤波器。
Deblock_UV：UV 平面去块滤镜。

螺纹的 （值 是的， 不要）
指定解码器是否应在其自己的线程中运行。

部分 FFMPEG

“FFMPEG”部分包含 FFMPEG 解复用器和编解码器的所有配置选项。

数据缓冲器MS （价值： 无符号 整数)
指定之前要缓冲的视频/音频数据量（以毫秒为单位）
开始解码。 仅供开发人员使用。

部分 ISO阅读器

“ISOReader”部分包含 ISO 媒体文件解复用器的所有配置选项。

忽略品牌的 MPEG-4 （价值： 全 4CC or 4CC 模式 （ABC* ab*))
忽略显示列出品牌的文件的所有 MPEG-4 系统轨道和 IOD
他们的兼容品牌列表。

创作 “ 配置 文件

如果未找到，启动 MP4Client 或 Osmo4 时会创建默认配置文件。
在此过程中，必须根据提示输入字体目录和缓存目录。 这
文件位于用户主目录中，名为“.gpacrc”

使用 onworks.net 服务在线使用 gpac