首选项文件包含打开 wfview 时读取的数据,其内容在点击设置(Settings)下的“保存设置(Save Settings)”按钮时保存。
这些数据包括程序外观、电台连接、窗口位置等设置。不建议编辑该文件;如确需编辑,风险自负。
每发布一个 wfview 版本,我们都会废弃并新增一些设置,因此你可能会看到来自旧版本的一些属性,它们会被忽略。
别忘了,在设置窗口中点击“恢复默认(Revert to Default)”即可轻松重置首选项。
如果无法打开 wfview 而希望重置设置,可以向 wfview 传入以下命令行标志:--clearconfig CONFIRM
访问方式:
首选项文件可按以下方式访问:
- macOS:使用 defaults 命令,指定 org 为 org.wfview.org
- Linux:读取 ~/.config/wfview/wfview.conf 这个纯文本文件
- Windows:配置存储在 Windows 注册表的 “HKEY_CURRENT_USER\SOFTWARE\wfview\wfview” 下。编辑 Windows 注册表时务必小心,regedit.exe 工具使用不当会严重损坏 Windows 安装。除非你清楚自己在做什么,否则不要改动上述注册表项之外的任何内容!
注意:可以使用 --settings 命令行参数指定其他设置文件。参数列表见此处。
首选项文件的节与属性:
各节如下(注意,qt 库不允许 wfview 决定这些节在文件中的确切顺序,因此用户可为了清晰而重新排序):
[Controls]
这些选项来自设置(Settings)标签页下的选项:
- EnablePTT:设为 'true' 或 'false',以启用或禁用 wfview 的 PTT 控制。不会改变电台自身的 PTT 锁定控制。
- NiceTS:设为 'true' 或 'false',以启用或禁用调谐频率或在频谱中双击时可能发生的频率取整。
[Interface]
这些选项大多来自设置(Settings)标签页下的复选框:
- ConfirmPowerOff:布尔值,用于禁用“确定要关机吗(Are you sure you want to power off)”对话框。
- ConfirmExit:布尔值,用于禁用“确定要退出吗?(Are you sure you want to quit?)”对话框
- StylesheetPath:设为自定义样式表的路径,相对于 /usr/share/wfview/stylesheets
- UseFullScreen:设为 'true' 或 'false',以在启动时启用全屏。
- UseSystemTheme:设为 'true' 或 'false',以启用或禁用系统主题(相对于样式表——内置或用户添加的)
- splitter:可从频谱图到瀑布图之间拖动的垂直分隔条的位置。最好不要手工编辑它。
- windowState:窗口状态(位置与最大化状态)
- windowGeometry:窗口的位置与大小。如果看不到 wfview 窗口,可删除此变量与上一个变量,这会恢复默认值。
- WFAntiAlias:瀑布图抗锯齿的布尔值
- WFInterpolate:是否在瀑布图数据点与屏幕像素之间进行插值的布尔值
- WFLength:瀑布图显示长度。取值应为 160 到 1023。
- Meter2Type:副仪表所选用的仪表类型。整数按源代码中的枚举类型表示仪表编号。
- plotCeiling:“顶部(top)”滑块的值
- plotFloor:“底部(bot)”滑块的值
- WFTheme:瀑布图所选用的配色主题
- underlayMode:频谱图底衬的所选模式:
- 0:无
- 1:峰值保持(Peak Hold)
- 2:缓冲峰值(Buffered Peaks)
- 3:平均(Average)
- underlayBufferSize:缓冲区大小。有效数值为 2 到 128。
[Radio]
这些选项与串口访问相关:
- RigCIVuInt:用该参数以无符号整数格式手动设置电台的 CI-V 地址。若设置了该值,wfview 不会广播请求所有电台自报身份,而是只向指定的 CI-V 地址发送电台 ID 请求。如果你的电台不响应 CI-V 总线上的广播查询,或者同一物理 CI-V 总线上有不止一台电台(在后 USB 转接器年代极为罕见),这项设置都很有用。若未设置或设为 0,wfview 会自动查找任何已连接的电台(无论该电台是否为已知型号)并尝试控制它。默认值为 0,建议大多数用户采用。
- CIVisRadioModel:布尔值。设为“true”时,wfview 会假定电台型号与上面手动设置的 CI-V 相同。对于不响应 Rig ID 查询的老式电台,在上面填入默认 CI-V 地址,然后把该参数设为 true。
- SerialPortBaud:用该属性指定自定义波特率,老式电台往往需要。默认值为 115200,这也是通过串口提供频谱数据的新型电台所要求的。
- SerialPortRadio:用该属性指定串口的自定义路径。例如,若使用 socat 从远程主机转发串口流量,可用它指定伪终端。若未设置或设为“auto”,wfview 会在 Linux 平台上自动查找直接连接且受支持的 Icom 电台。在其他平台上,它会尝试使用第一个可用的串口。
- localAFgain:无符号字符(0-255),用于存储用户的本地音频增益(AF gain,即音量)。不会改变电台端的音量,只影响在计算机上听到的响度。
- VirtualSerialPort:为其他程序当串口使用而创建的虚拟伪终端的字符串路径。
[Server]
这些选项用于内置的 OEM 兼容服务器,适合把非以太网电台接入网络。
- ServerEnabled:true/false,是否启用 wfview 的内部服务器,该服务器模拟一台 Icom 电台并允许多个客户端连接。目前仍相当实验性
- ServerControlPort:客户端进行初始连接的 UDP 端口。
- ServerCivPort:服务器向客户端通告的 UDP 端口,默认 50002。
- ServerAudioPort:服务器向客户端通告的 UDP 端口,默认 50003。
- ServerNumUsers:当前已配置的用户数。
- ServerUsername_x、ServerPassword_x、serverUserType_x:包含用户信息。
[LAN]
这些选项用于配置对以下电台的网络访问:内置网络的电台、连接到运行 Icom 软件的 PC 的电台,或连接到已启用上述 [Server] 的 wfview 主机的电台。
- EnableLAN:true 或 false,启用对电台的 LAN 连接(而非 USB)
- AudioInput:音频输入设备名称。最好通过设置(Settings)标签页设置,因为名称必须完全一致
- AudioOutput:音频输出设备名称。最好通过设置(Settings)标签页设置,因为名称必须完全一致
- AudioRXCodec:这是发送给电台的接收编解码器(Codec),0x01 = 单声道 uLaw,0x02 = 单声道 8bit PCM,0x04 = 单声道 16bit PCM,0x08 为双声道 8bit PCM,0x10 为双声道 16bit PCM,0x20 为双声道 uLaw。预计将来会为 wfview 与 wfview 之间的通信增加其他模式,可能包括压缩。
- AudioTXCodec:这是发送给电台的接收编解码器,0x01 = 单声道 uLaw,0x02 = 单声道 8bit PCM,0x04 = 单声道 16bit PCM。预计将来会为 wfview 与 wfview 之间的通信增加其他模式,可能包括压缩。
- AudioRXLatency:用此项指定接收(RX)允许的延迟毫秒数。
- AudioTXLatency:用此项指定发射(TX)允许的延迟毫秒数。
- AudioRXSampleRate:这是告知电台用于接收音频的采样率。默认值为 48000,也可使用 8000、16000 和 24000。其他速率很可能被电台拒绝。较小的采样率会降低所需的网络带宽,但可能降低音质。
- AudioTXSampleRate:这是告知电台用于发射音频的采样率。默认值为 48000,也可使用 8000、16000 和 24000。其他速率很可能被电台拒绝。较小的采样率会降低所需的网络带宽,但可能降低音质。
- ClientName:这通常是你的计算机的“名称”,但可以换成任何其他名称。该值无法在 wfview 内更改,只能通过手工编辑文件/注册表项来更改。
- ControlLANPort:这是 wfview 用来与电台通信的“控制”端口,默认 50001。其他所需端口由电台配置。
- EnableRigCtlD:true 或 false,启用 wfview 内的 rigctld 模拟。这非常实验性,目前仅支持一小部分 rigctld 命令。默认禁用,且无法在 wfview 图形界面内启用。
- RigCtlPort:内部 rigctld 模拟应监听的端口。默认 4533,以免与机器上运行的其他 rigctld 冲突。
- IPAddress:电台的 IP 地址
- Username:在电台 Network 菜单中配置的用户名
- Password:在电台中为上述用户配置的密码。
- ResampleQuality:这是 0-10 的数值,决定 wfview 内部音频重采样器的质量,0 为最低质量。仅在采样率不是 48000 时使用;默认值 4 是在质量与速度之间取折中。
- WaterfallFormat:所要提供的瀑布图数据格式。
- 0:不处理
- 1:串口风格(多段)
- 2:LAN 风格(单段)
- tcpServerPort:用于通过 TCP/IP 进行原始 CI-V 访问的端口,N1MM+ 即使用该方式。值为零时禁用此功能。
[Memory]
本节包含 wfview 管理的 99 个存储信道。不必为该格式编写解析器,我们会在未来版本改用 CSV。
[Color Presets]
(进行中)
这些行定义用户输入的颜色预设。数据以字符串读入,预期格式为 #AARRGGBB,其中 AA 是 alpha 通道(0xff = 不透明,0x00 = 透明),RRGGBB 是标准的红绿蓝 HTML 颜色。完全透明的颜色(AA = 00)基本上会隐藏界面的某个元素。PresetName 用于预设下拉框,必须不超过 10 个字符。Unicode 字符应当可用,不过尚未测试。presetNum 属性由系统自动分配,不应更改。
任何未能正确读入的颜色都会回退为 wfview 的默认颜色。
关于这些颜色的更多内容,见手册的这一节。
第一个颜色预设的示例:
ColorPreset\1\axisColor=#ffffffff ColorPreset\1\gridColor=#ff000000 ColorPreset\1\meterAverage=#ff3fb7cd ColorPreset\1\meterLevel=#ff0000ff ColorPreset\1\meterLowText=#ffeff0f1 ColorPreset\1\meterLowerLine=#ffeff0f1 ColorPreset\1\meterPeakLevel=#ffaaffff ColorPreset\1\meterPeakScale=#ffff0000 ColorPreset\1\passband=#80006fa7 ColorPreset\1\plotBackground=#ff000000 ColorPreset\1\presetName=Dark ColorPreset\1\presetNum=0 ColorPreset\1\spectrumFill=#00000000 ColorPreset\1\spectrumLine=#ffffff00 ColorPreset\1\textColor=#ffffffff ColorPreset\1\tuningLine=#ff55ffff ColorPreset\1\underlayFill=#96465e96 ColorPreset\1\underlayLine=#9633ff55 ColorPreset\1\wfAxis=#ffffffff ColorPreset\1\wfBackground=#ff000000 ColorPreset\1\wfGrid=#00000000 ColorPreset\1\wfText=#ffffffff