stilview - 云端在线

程序：

您的姓名

stilview - 帮助您检索存储在 STIL 中的条目的命令行程序。

概要

斯蒂尔维尤 [-b] [-d] [-e 条目] [-f 字段] [-i] [-l HVSC 基目录] [-m]
[-o] [-s] [-t 调号]

斯蒂尔维尤 {[-h] | [-v]}

商品描述

静态视图 是一个命令行驱动的程序，可帮助您检索存储在 STIL 中的条目
快速准确。 STILView 大量使用 STIL C++ 类来做到这一点，事实上，
这个命令行程序的主要目的是测试那个类（顺便说一句，用于
许多基于 GUI 的 SID 播放器，最著名的是 Windows 的 SIDPlay 和 Unix 的 XSIDPLAY
系统）。 但是，它对用户非常友好，非程序员也可以使用。

按字母顺序排列的一些术语和 STIL 相关术语：

BUG 进入
HVSC 中存在一个特殊文件（/文档/BUGlist.txt) 列出所有已知的错误
在 HVSC 中的 SID 调谐。 有关其中内容的详细信息，请参阅该文件的顶部
确切地。 一个 BUG 条目就像一个 STIL 条目，但它包含在这个 BUGlist.txt 中
文件中。

领域
STIL 条目中最小的信息。 当前有效的字段名称是
姓名、标题、艺术家和评论。

文件-全局 评论
多调谐 SID 文件的 STIL 条目中的特殊 COMMENT 字段，它引用了
整个 SID，而不仅仅是其中的一首曲子。 这些通常包含有关的一般信息
SID 文件本身。

计费示例：

/Hubbard_Rob/Gerry_the_Germ.sid
评论：在 Rob 自己的音乐演示中，曲调以关卡命名
在原版游戏中。
（＃1）
标题：肺
（＃2）
名称：肾脏
（＃7）
标题：结束

高压蒸汽发生器
高压 SID 集合。 如果你不知道这是什么，你下载错了
程序。 :)

HVSC-相对 路径名
可以在 HVSC 中找到的 SID 文件的路径名加文件名，相对于
HVSC 的基本目录。 它总是采用 UNIX 风格的格式，例如：
/Hubbard_Rob/Commando.sid 指的是 Rob Hubbard 在 HVSC 中的 Commando.sid 文件（其中
实际上可能会在您的 Windows PC 上以 C:\Music\HVSC\Hubbard_Rob\Commando.sid 的形式找到）。

多调 进入
一个 STIL 条目，它指的是一个包含许多曲调的 SID 文件。 每首曲子
可能有自己的 STIL 块，它们在
"(#x)" 的形式，其中 x = 调号。 请参阅 HVS 中的 STIL.FAQ 以获取
详细说明。

计费示例：

/Hubbard_Rob/Gerry_the_Germ.sid
评论：在 Rob 自己的音乐演示中，曲调以关卡命名
在原版游戏中。
（＃1）
标题：肺
（＃2）
名称：肾脏
（＃7）
标题：结束

部分
属于一个作曲家的 STIL 的一部分（即每个 STIL 条目都引用了 SID
HVSC 的一个子目录中的文件）。 STIL 中的部分总是由
一行格式为：“### Composer's name ########”。

部分-全球 评论
一个特殊的 STIL 条目，它不是指单个 SID 文件，而是指整个
子目录。 这些通常包含有关作曲家本人或所有
他/她曾经编写过的 SID 文件，并且总是以“/Subdir/”的形式索引（注意
尾部斜杠！）。

计费示例：

/哈伯德_罗伯/
评论：所有这些曲调都被哈伯德确认是他的。 人们
经常偷走哈伯德的套路，导致一些曲调是错误的
归功于他。
哈伯德自己的评论用 (RH) 表示。

单调 进入
一个 STIL 条目，其中没有“(#x)”形式的曲调名称，其中 x 是
数字。 （请注意，单调条目可能仍指具有许多
曲调在里面，即。 当单调条目中只有一个 COMMENT 字段时！）

计费示例：

/Hubbard_Rob/Chain_Reaction.sid
标题：Zoolook（混音）[来自 Zoolook]
艺术家：让·米歇尔·雅尔

另一个例子（这里所指的 SID 有很多曲调！）：

/Barrett_Steve/Magic_Land_Dizzy.sid
评论：也用于游戏“Wacky Darts”(c) 1990 Codemasters。

斯蒂尔
SID 调谐信息列表，本质上是一个文本文件数据库，可以在您的
/DOCUMENTS/ 子目录中的 HVSC。

斯蒂尔 进入
STIL 中的所有信息都与 HVSC 的一个 SID 文件相关。 他们
总是由 HVSC 相对路径名索引。

TUNE
SID 中的组成之一。 大多数 SID 文件只有一首曲子，但许多
有多个（例如，一个是游戏的标题分数，一个是高分
音乐）。

配置

-b Do 而不去 打印 BUG 条目 默认值：未指定（即打印 BUG 条目）

示例：“stilview -e=/Hubbard_Rob/Commando.sid -b”

指定此选项后，将不会为给定的 SID 调谐打印 BUG 条目。
至少，必须指定 -e 选项才能使该选项起作用。

-d 默认值：未指定（即调试模式关闭）

示例：“stilview -e=/Hubbard_Rob/Commando.sid -d”

在 STILView 中打开调试模式。 这将导致广泛的输出，
调试消息到 STDERR。 如果您遇到任何问题或奇怪的行为
使用 STILView，运行 STILView 时的选项与您在
遇到了这个问题，添加了这个 -d 选项。 捕获完整
此运行的输出，并将其连同问题的详细说明一起发送给我（请参阅
此文件顶部的电子邮件地址）。

-e=条目
默认值：NONE（您必须为此选项提供与 HVSC 相关的路径名）

示例 #1：“stilview -e=/Hubbard_Rob/Commando.sid”

示例#2：“stilview -e=/Hubbard_Rob/”

这是您指定要查找的 STIL 条目的地方，以 HVSC-
相对路径名。 如果给定文件名不存在 STIL 条目，则 STILView 将
什么都不打印。 否则，您将获得 STIL 条目（或其中的一部分，您可能
已由其他选项指定）。 HVSC 相对路径名不区分大小写，因此
/HUBBARD_ROB/Commando.sid 与 /Hubbard_Rob/Commando.sid 相同。

Example #1 是检索 STIL 条目的最常用方法，它将返回所有
Commando.sid 的 STIL 条目，以及部分全局注释
/哈伯德_罗伯/。 示例 #2 是另一个有效的做法：这将只返回
/Hubbard_Rob/ 的部分全局注释。

-h 默认值：NONE 示例：stilview -h

打印列出可用选项的简短帮助屏幕。 所有其他选项
命令行上指定的也被忽略。

-f=部分
默认值：全部

有效值是：所有，姓名，作者，标题，艺术家，评论

示例 #1：“stilview -l -e=/Hubbard_Rob/Delta.sid -f=comment”

示例#2：“stilview -l -e=/Hubbard_Rob/Delta.sid -t=1 -f=title”

示例 #3：“stilview -l -e=/Hubbard_Rob/Delta.sid -t=12 -f=all -s -b”

要求 STIL 条目中的一个特定字段。 结合 -t 选项，这两个
options 可以检索 STIL 条目的任何部分，包括
特定子调的条目。 以下是对不同之处的完整和完整的解释
-t 和 -f 选项的可能组合检索：

"-t=0 -f=all" ：打印所有 STIL 条目。

"-t=0 -f=comment" ：打印文件全局注释。 对于单调条目，
在其中只有一个 COMMENT 字段，这将打印该 COMMENT。 对于单调
包含其他字段的条目，这不会打印任何内容。 （这是因为单
仅包含 COMMENT 字段的调整条目被假定为文件全局注释。）

"-t=0 -f= " : 什么都不打印。这些的组合
选项无效。

“-t= -f=all" :（其中 x 不是 0。）来自 STIL 部分的所有字段
给定调号的条目被打印。 对于单调条目，要求
-t=1 -f=all 相当于说 -t=0 -f=all，因为根据定义，整个条目
只指一首曲子。 （但是，将 -t 指定为 1 以外的任何其他数字将
什么都不打印！）请注意，如果 STIL 条目中有一个文件全局注释（它
也意味着如果一个单调条目只有一个 COMMENT 字段），那就是
而不去 印有这些选项的组合。

“-t= -f= " :（其中 x 不是 0。）
来自给定调谐编号的 STIL 条目部分的特定字段是
打印。 对于只包含 COMMENT 的单调条目，这将返回
什么都没有。

当然，如果使用这些选项询问的 STIL 条目或其任何部分没有
存在，STILView 将不打印任何内容。 此外，除非另外指定 -o, -s
和 -b 选项，部分全局注释和给定 SID 文件的 BUG 条目
也将被打印（如果它们存在）。

在示例#1 中，打印了 /Hubbard_Rob/Delta.sid 的文件全局注释，因为 -t
未指定并假定为 0。还打印了部分全局注释
以及同一个 SID 文件的 BUG 条目（如果存在）。 在示例#2 中，TITLE
/Hubbard_Rob/Delta.sid 的 tune #1 的 STIL 条目的字段与
同一 SID 文件的部分全局注释和 BUG 条目（如果存在）。 在
示例 #3，打印了 /Hubbard_Rob/Delta.sid 的 tune #12 的所有 STIL 条目，
但没有别的。

-i 默认值：无

示例：“stilview -i”

以交互模式启动 STILView，忽略指定的所有其他选项
命令行，除了 -l、-d 和 -m。 在交互模式下，您可以查找 STIL 条目
通过输入它们。您将收到所需的 STIL 条目的提示（必须是
使用 HVSC 相对路径名指定），用于请求的调谐编号（应该
是任何非负数，但这不是强制的），最后是特定的
要检索的 STIL 字段。

-l=高压蒸汽发生器 基地 DIR
默认值：HVSC_BASE 环境变量的值

示例 #1：“stilview -l=C:\Music\HVSC\ -e=/Hubbard_Rob/Commando.sid”

示例#2：“stilview -l=../HVSC/ =-e=/Hubbard_Rob/Commando.sid”

示例 #3：“stilview -l -e=/Hubbard_Rob/Commando.sid”

这是您告诉 STILView 在何处可以找到 HVSC 基目录（到
必须以操作系统所需的形式指定目录，例如。
Windows 下为 C:\Music\HVSC，UNIX 下为 /home/lala/HVSC）。 STILView 然后将尝试
在该目录的 /DOCUMENTS/ 子目录中找到 STIL.txt 文件。 如果这
未指定选项（或者如果在没有基目录的情况下指定了 -l），STILView
将尝试从 HVSC_BASE 环境中提取 HVSC 基目录的路径
多变的。 如果该环境变量不存在或指向某个位置
如果 DOCUMENTS 目录中没有 STIL.txt 文件，则 STILView 会失败。 如果
HVSC_BASE 环境变量存在且有效，指定该选项后，
使用此选项指定的目录用作 HVSC 基目录而不是
环境变量。

在示例 #1 中，HVSC 基目录位于硬盘驱动器上的 C:\Music\HVSC\
的 Windows PC，在示例 #2 中它位于当前的 HVSC 目录中
目录的 UNIX 系统的父目录。 在示例 #3 中，HVSC 基目录
选项中未指定，因此假设 HVSC_BASE 环境
变量包含它的路径。 实际上，在示例 #3 中指定 -l 选项
是多余的，可以省略。

-m 演示模式

默认值：无

示例 #1：“stilview -m”

示例#2：“stilview -e=/Hubbard_Rob/Commando.sid -m -i”

当指定时，它会打印出一大堆东西 a) 测试大部分
STILView 的功能，以及 b) 展示 STILView 能够从中检索的内容
斯蒂尔。 在示例#1 中，演示中打印了来自默认 STIL 的 STIL 信息
条目，然后 STILView 退出。 在示例#2 中，使用 STIL 信息打印演示
从 /Hubbard_Rob/Commando.sid 的指定 STIL 条目（而不是默认 SID
文件），然后进入交互模式。

-o Do 而不去 打印 STIL 条目

默认值：未指定（即打印 STIL 条目）

示例 #1：“stilview -e=/Hubbard_Rob/Delta.sid -o”

示例 2：“stilview -e=/Hubbard_Rob/Delta.sid -o -s”

指定此选项时，将不会为给定的 SID 调谐打印 STIL 条目
（但将打印部分全局条目和 BUG 条目，前提是它们存在并且
其他选项没有关闭它们的输出）。 至少，-e 选项必须是
指定此选项工作。 Example #1 将打印出 section-global
注释和 /Hubbard_Rob/Delta.sid 的 BUG 条目，示例 #2 将仅打印出
相同 SID 的部分全局注释。

-s Do 而不去 打印部分-全局注释

默认值：未指定（即打印部分全局条目）

示例：“stilview -e=/Hubbard_Rob/Delta.sid -s”

指定此选项时，将不会打印部分全局条目
给定 SID 调。 至少，必须为此选项指定 -e 选项以
工作。

-t=调 数
默认值：0

示例 #1：“stilview -e=/Hubbard_Rob/Commando.sid -t=0”

示例#2：“stilview -e=/Hubbard_Rob/Delta.sid -t=1 -f=title -s -b”

示例 #3：“stilview -e=/Hubbard_Rob/Delta.sid -t=12”

询问 STIL 条目中与某一特定曲调有关的部分。 如果调号
0 给出，它检索所有条目。 结合 -f 选项，这两个
options 可以检索 STIL 条目的任何部分，包括
特定子调的条目。

有关此选项的更多详细信息，请参阅 -f 选项的说明。

Example #1 检索 /Hubbard_Rob/Commando.sid 的所有 STIL 条目，包括
部分全局注释和 BUG 条目（如果有），但由于默认值
此选项为 0，在此示例中也可以省略。 Example #2 检索
只有 /Hubbard_Rob/Delta.sid 的第一个子调条目的 TITLE 字段（而不是
部分-全局注释或 BUG 条目），而示例 #3 检索所有
同一 SID 文件的第 12 条调子的 STIL 条目（包括部分全局注释和
BUG条目，如果有的话）。

-v 打印版本号

默认值：未指定（即不*不*打印版本号）

示例 #1：“stilview -v”

示例#2：“stilview -e=/Hubbard_Rob/Commando.sid -v”

指定此选项时，STILView 程序的版本号和
打印出它使用的 STIL.txt 文件的版本号。 在示例#1 中，这是
唯一打印在屏幕上的信息，在示例#2 中是版本
数字被打印出来，那么 /Hubbard_Rob/Commando.sid 的 STIL 条目也是
打印出来。

环境

HVSC_BASE
指定 HVSC 基目录的位置。

示例

以下所有示例均假设 HVSC_BASE 环境设置为有效的 HVSC
基本目录（其中 $HVSC_BASE/文档/STIL.txt 和
$HVSC_BASE/DOCUMENTS/BUGlist.txt 文件存在），并且示例还假定存在
这些文件中的以下条目：

--- 在 STIL.txt 中 ---

/哈伯德_罗伯/
评论：所有这些曲调都被哈伯德确认是他的。 人们
经常偷走哈伯德的套路，导致一些曲调是错误的
归功于他。

/Hubbard_Rob/Action_Biker.sid
评论：“Action B 是一款非常早期的游戏，并且在方法上非常保守
- 我的想法是给他们我认为他们想要的东西，一个简单的
可爱的曲子……”（RH）

/Hubbard_Rob/Commando.sid
评论：曲调 #1 和 #3 已从街机版转换而来。

/Hubbard_Rob/Delta.sid
评论：根据 Hubbard 的说法，Kentilla 和 Delta 是最复杂的
作曲，他们花了最长的时间去做，他们都开车送他
疯。
（＃1）
标题：在奔跑中[来自月球的黑暗面]
艺术家：平克·弗洛伊德
评论：与其说是对它的混音，不如说是受到它的启发。
（＃12）
标题：Koyaanisqatsi [来自电影]
艺术家：菲利普·格拉斯
评论：“灵感来自菲利普·格拉斯和平克·弗洛伊德。” (右)

/Hubbard_Rob/International_Karate.sid
标题：圣诞快乐，劳伦斯先生 [来自电影] (0:42-1:16)
艺术家：坂本龙一
评论：“[...] 我开始探索降 B 小调五声音阶的东西
不同的低音音符，降 B、降 D、降 G 和降 A。 中间
部分以双倍的速度进入 F（我认为）以使事情活跃起来。 一世
对曲子很满意......”（RH）

/Hubbard_Rob/Rasputin.sid
（＃1）
标题: Katjusha (0:07-0:36)
艺术家: Matvei Blanter, M. Isakovski
标题: Katjusha (2:20)
艺术家: Matvei Blanter, M. Isakovski
标题：卡尔金卡 (2:41-2:51)
艺术家：传统
评语：俄罗斯民歌。
标题：卡尔金卡 (3:12-3:22)
艺术家：传统
评语：俄罗斯民歌。
（＃2）
评语：俄罗斯民歌。

--- 在 BUGlist.txt 中---

/Hubbard_Rob/Commando.sid
BUG：这只是为了演示。

/Hubbard_Rob/Delta.sid
（＃12）
BUG：演示入口。

鉴于这些条目，以下是您可以从 STILView 获得的打印输出。 ($> 表示
您的操作系统给出的命令行提示。）

打印与 SID 文件相关的所有内容：

$> stilview -e=/Hubbard_Rob/Commando.sid
---- 全球评论 ----
评论：所有这些曲调都被哈伯德确认是他的。 人们
经常偷走哈伯德的套路，导致一些曲调是错误的
归功于他。
------ STIL 条目 ------
评论：曲调 #1 和 #3 已从街机版转换而来。
- - - - - 漏洞 - - - - -
BUG：这只是为了演示。
$>

只要求部分全球评论：

$> stilview -e=/Hubbard_Rob/
/哈伯德_罗伯/
评论：所有这些曲调都被哈伯德确认是他的。 人们
经常偷走哈伯德的套路，导致一些曲调是错误的
归功于他。
$>

请注意，这也可以通过以下方式检索：

$> stilview -e=/Hubbard_Rob/Commando.sid -o -b
评论：所有这些曲调都被哈伯德确认是他的。 人们
经常偷走哈伯德的套路，导致一些曲调是错误的
归功于他。
$>

这不会打印任何内容，因为单调条目没有文件全局注释：

$> stilview -e=/Hubbard_Rob/International_Karate.sid -t=0 -f=comment -s -b
$>

...除非其中唯一的字段是 COMMENT（在这种情况下，该评论被假定为
是文件全局注释）：

$> stilview -e=/Hubbard_Rob/Action_Biker.sid -t=0 -f=comment -s -b
评论：“Action B 是一款非常早期的游戏，并且在方法上非常保守
- 我的想法是给他们我认为他们想要的东西，一个简单的
可爱的曲子……”（RH）
$>

还要注意单调条目只有一个调，所以要求 STIL 条目
曲调 #3 毫无意义：

$> stilview -e=/Hubbard_Rob/International_Karate.sid -t=3 -s -b
$>

打印给定 SID 文件的文件全局注释：

$> stilview -e=/Hubbard_Rob/Delta.sid -t=0 -f=comment -s -b
评论：根据 Hubbard 的说法，Kentilla 和 Delta 是最复杂的
作曲，他们花了最长的时间去做，他们都开车送他
疯。
$>

打印出给定 SID 文件的第 12 调的 ARTIST 字段，并打印出所有内容
与 SID 文件相关的其他内容：

$> stilview -e=/Hubbard_Rob/Delta.sid -t=12 -f=artist
---- 全球评论 ----
评论：所有这些曲调都被哈伯德确认是他的。 人们
经常偷走哈伯德的套路，导致一些曲调是错误的
归功于他。
------ STIL 条目 ------
艺术家：菲利普·格拉斯
- - - - - 漏洞 - - - - -
BUG：演示入口。
$>

请注意，当前版本的 STILView 只能检索指定的第一个
涵盖多首歌曲的曲调领域！ 见下文：

$> stilview -e=/Hubbard_Rob/Rasputin.sid -t=1 -f=title -s
标题: Katjusha (0:07-0:36)
$>

即使给定 SID 文件的 STIL 条目没有打印出部分全局注释
不存在：

$> stilview -e=/Hubbard_Rob/This_doesnt_exist.sid
评论：所有这些曲调都被哈伯德确认是他的。 人们
经常偷走哈伯德的套路，导致一些曲调是错误的
归功于他。
$>

以下 4 个步骤描述了如何让 STILView 打印出与给定相关的所有内容
SID 文件的给定调号一一：

1) 这仅打印出部分全局注释：

$> stilview -e=/Hubbard_Rob/Delta.sid -o -b
评论：所有这些曲调都被哈伯德确认是他的。 人们
经常偷走哈伯德的套路，导致一些曲调是错误的
归功于他。
$>

2) 这仅打印出文件全局注释：

$> stilview -e=/Hubbard_Rob/Delta.sid -t=0 -f=comment -s -b
评论：根据 Hubbard 的说法，Kentilla 和 Delta 是最复杂的
作曲，他们花了最长的时间去做，他们都开车送他
疯。
$>

3) 这将打印出给定调号的所有 STIL 条目：

$> stilview -e=/Hubbard_Rob/Delta.sid -t=12 -f=all -s -b
标题：Koyaanisqatsi [来自电影]
艺术家：菲利普·格拉斯
评论：“灵感来自菲利普·格拉斯和平克·弗洛伊德。” (右)
$>

4) 这仅打印出相同调号的 BUG 条目：

$> stilview -e=/Hubbard_Rob/Delta.sid -t=12 -s -o
BUG：演示入口。
$>

以下 3 个步骤描述了如何让 STILView 打印出与给定相关的所有内容
SID文件：

1) 这仅打印出部分全局注释：

$> stilview -e=/Hubbard_Rob/Delta.sid -o -b
评论：所有这些曲调都被哈伯德确认是他的。 人们
经常偷走哈伯德的套路，导致一些曲调是错误的
归功于他。
$>

2) 这将打印出所有 STIL 条目：

$> stilview -e=/Hubbard_Rob/Delta.sid -s -b
评论：“[...] Delta 音乐加载器和游戏内音乐是 Gary Liddon 的想法。
[...] 他当时是 Thalamus 的制作人。 他告诉罗伯·哈伯德
使游戏内的音乐类似于月之暗面的第二首曲目
平克·弗洛伊德 (Pink Floyd) 的作品。”（来自 Matt Furniss 的信息。）
“小叮当都是来自Sanxion和Romeo/Juliet的小片段
音乐。 他们都应该是短的毒刺，如结束
等级、额外生命等……”
“Delta 的灵感来自于这种极简主义的构图技术
玻璃和一点平克·弗洛伊德。 这也很难做到并且需要
驱动程序的一些自定义代码来完成它。 音乐很乏味
调试。 Delta 的其他东西更传统 - 我非常喜欢
其他曲调。 Delta 分布在 2 周内......”（RH）
根据哈伯德的说法，Kentilla 和 Delta 是最复杂的一个
作曲，他们花了最长的时间去做，他们都开车送他
疯。
（＃1）
标题：在奔跑中[来自月球的黑暗面]
艺术家：平克·弗洛伊德
评论：与其说是对它的混音，不如说是受到它的启发。
（＃12）
标题：Koyaanisqatsi [来自电影]
艺术家：菲利普·格拉斯
评论：“灵感来自菲利普·格拉斯和平克·弗洛伊德。” (右)
$>

3) 这会打印出所有的 BUG 条目：

$> stilview -e=/Hubbard_Rob/Delta.sid -s -o
（＃12）
BUG：演示入口。
$>

作者

啦啦啦 <[电子邮件保护]>
原作者。

莱昂德罗 妮妮 <[电子邮件保护]>
当前维护者。

资源

SourceForge 项目：http://sourceforge.net/projects/sidplay-residfp/>
高压 Sid 收集 (HVSC)：http://hvsc.c64.org/>

复印

版权所有 (C) 1998, 2002 LaLa
版权所有 (C) 2012-2014 Leandro Nini

该程序是免费软件； 您可以根据以下条款重新分发和/或修改它
由自由软件基金会发布的 GNU 通用公共许可证； 任何一个
许可的第2版，或（由您选择）任何更高版本。

分发此程序是希望它有用，但不作任何保证；
甚至没有对适销性或针对特定目的的适用性的暗示保证。
有关更多详细信息，请参阅 GNU 通用公共许可证。

您应该已经收到一份 GNU 通用公共许可证以及该程序；
如果没有，请写信给 Free Software Foundation, Inc.，51 Franklin Street, Fifth Floor，
美国马萨诸塞州波士顿 02110-1301。

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