glitchup

注意： 此项目仍在开发中。您可以通过以下方式安装当前的可执行文件：

• cargo安装 glitchup
• 从这里下载程序

...然而它是不完整的，您可能会遇到错误。

如果您有任何问题，例如 "什么是databending?" 或 "你为什么制作这个?"，请查看问答

如果您想先了解一下databending，请查看databending教程！

选项

示例选项文件可以在Options.toml中找到。我将解释一些重要部分

输入 + 输出

需要设置inputfile选项来指定要databend的文件

inputfile = "somefile.jpeg"

您也可以指定不在当前目录中的文件。测试了文件在子目录中（dir/file.jpeg），然而没有测试文件在当前目录之外（../file.jpeg）。这可能可行，但是目前还需要进一步测试。

默认情况下，输出文件将与输入文件同名（并附加一个字符串）。如果您想用不同的名称/目录保存文件，可以指定outputfile选项。

inputfile = "somefile.jpeg"
outputfile = "otherfile.jpeg"

注意： 输出文件的名称将不会与您指定的名称完全相同。目前，输出文件名称的格式为name<mutations>.extension。这是为了显示文件所经历的突变，同时也避免覆盖现有文件。

全局选项

目前有4个全局选项

• times：指定程序运行次数。
• iterations：指定在保存之前突变应执行的次数。
• chunksize：每次突变时要突变的数据块的大小。
• mutations：要使用的突变。

所以，根据以下选项

times = 2
iterations = [5,10]
chunksize = 1000
mutations = [ ["Reverse"], ["Swap"] ]

程序将运行两次，每次运行都会有一个输出

• 对1KB数据块进行Reverse突变5到10次
• 通过应用Swap操作5到10次来对1KB块进行突变

...总共产生2 * 2个输出文件。(次数 * 突变次数)

范围

如您所见，iterations是一个包含2个整数的数组。几乎所有的突变特定选项都可以通过范围设置，即一个包含2个数字的数组

• iterations = x：x次迭代
• iterations = [x,y]：在x和y次迭代之间。

对于每次迭代，将在x和y之间随机生成一个数字。因此，如果您想在两个边界之间随机生成一个设置，请使用[x,y]。否则，如果您的设置需要更具体，只需使用一个文字数字即可。

突变

mutations选项已被从BEND++重写！现在它使用一个数组数组

mutations = [
  ["Reverse", "Swap"],
  ["Shuffle"],
  ...
]

mutations的每个元素都是一个数组，代表一个单独的输出。这个数组可以包含多个连在一起的突变！

在上面的选项中，这意味着第一个文件将首先通过Reverse进行突变，然后通过Swap，然后保存。然后创建原始文件的一个新副本，通过Shuffle进行突变，然后保存。依此类推...

特定选项

一些突变可能有自己的选项需要设置。例如，目前有一个需要设置loops选项的Loops突变。每个突变都有自己的配置，如[<Mutation>Config]，因此要配置Loops

[LoopsConfig]
loops = 10

这将设置loops为10用于Loop突变。如果您忘记指定此选项，程序将指定它需要哪些选项以及选项的名称。

TODO: Add example of error.

注意：在上面的情况下，只有当您在mutations选项中包含"Loops"时，才需要指定loops选项！如果排除"loops"，则上面的部分也可以省略。

[LoopsConfig]
loops = 10
chunksize = [10,1000]