umdgen.exe（螢火蟲框架[親測有效]）

螢火蟲框架[親測有效]-

螢火蟲框架[親測有效]螢火蟲框架(Firefly)地獄門神(F.R.C.)本類庫集成了游戲修改中常常需要用到的一些工具和工具類。

螢火蟲框架(Firefly)

地獄門神(F.R.C.)

githubhttps://github.com/IanusInferus/firefly

下載 https://github.com/IanusInferus/firefly/releases

1 概論

本框架的原本目標是為漢化的整個生命周期中的每一件沒有已有工具或已有工具不完善的重復勞動提供工具或框架支持，但目前已不限于此。
這里列出漢化的流程結構，即本框架已經支持的部分(以限定名的形式表達)。也列出部分流程的其他工具。
程序加[]，命名空間或庫不加[]。

文件包|分散文件
↓↑
包格式分析：[UltraEdit]
解包、替換包中文件、壓縮解壓：Firefly.Packaging，Firefly.Compressing，Firefly.GUI.PackageManager、Zlib.Net、[WQSG_UMD]、[UMDGen]
↓↑
字符映射表|字庫|文本|圖片

字符映射表
↓↑
字符映射表分析：[UltraEdit]
字符映射表格式轉換：Firefly.TextEncoding
↓↑
.tbl字符表文件
↓↑←通用格式文本
字符映射表生成：[Firefly.MappingGen]

字庫
↓↑
字庫分析：[UltraEdit]、[CrystalTile]、[CrystalTile2]
字庫生成、字模提?。篬Firefly.FontGen]、Firefly.Glyphing、Firefly.Imaging
↓↑
.fd字庫描述文件+字庫圖片
↓←文本導出
.loc圖形文本

文本
↓↑
文本分析：[UltraEdit]、[CrystalTile]、[CrystalTile2]
文本導出、文本導入：Firefly.Texting、Firefly.TextEncoding、[WQSG導出(導入)]
↓↑
通用編碼通用格式文本(UTF-16、GB18030)x(Txt、Agemo、WQSG、Plain)
↓↑
直接修改：[Notepad]

圖片
↓↑
圖片分析：[UltraEdit]、[CrystalTile]、[CrystalTile2]
圖片轉換：Firefly.Imaging、DevIL.Net
↓↑
通用格式圖片(bmp、png、dds)
↓↑
直接修改：[Photoshop]

通用編碼通用格式文本
↓↑→ .tbl
↓↑←字符表文件
文本轉碼：[Firefly.TransEncoding]
生成字符表：[Firefly.CharAdder]
漢字字形轉換：[Firefly.TransVariant]

.loc圖形文本
↓↑
文本顯示、修改：[Firefly.Eddy]
↓↑
通用編碼通用格式文本

2 各庫功能介紹

2.1 核心庫(Firefly.Core.dll)
本庫集成了漢化中常常需要用到的一些工具類。
主要有如下方面：
├─Compressing 壓縮：LZ77、RLE算法輔助類
├─Core 核心：在文件流中讀寫各種類型的整數、把文件流的一部分看作文件流、提取文件名的一部分、
│ 從整數中提取位、從多個文件位置計算多個文件長度、遍歷多個區間中的整數索引等
├─Glyphing 字形：字形表示、字庫生成。
├─Imaging 圖像：在Bitmap類與顏色數組之間傳送數據、Bmp文件類、Gif文件類、顏色空間轉換
├─Packaging 文件包：輕松構造文件包解包打包器
├─Setting 設置：INI文件支持
├─TextEncoding 編碼：從文本按頻率提取需編碼字符、文本碼表格式讀寫
└─Texting 文件：Agemo文本讀寫、WQSG文本讀寫、LOC圖形文本讀寫、基于字節的文本正則表達式搜索、簡繁日字形轉換
詳細用法請參見Firefly.chm文檔。

2.2 界面庫(Firefly.GUI.dll)
放置主要與界面有關的內容。
│ FileDialog 將打開、保存文件合并的文件對話框，同時也可用于打開文件夾。用于替代(OpenFileDialog、
│ SaveFileDialog、FolderBrowserDialog)三個System.Windows.Forms控件。
│ FileSelectBox 文件選取框，一個文本框和一個按鈕的組合，用于選取文件或文件夾路徑。
│ PackageManager 包管理器，用于配合Firefly.Packing中的類，實現快速包管理器的編寫。
│ ProgressDialog 進度框，用于顯示進度。
│ ScrollablePictureBox 可滾動圖片框。

2.3 漩渦文本本地化工具(Firefly.Eddy)
用于顯示和保存各種本地化文本，GUI工具。
該工具已分離為單獨的漩渦(Eddy)項目。

2.4 正則表達式文件重命名工具(RegexRename.exe)
用于批量重命名文件，命令行工具。
詳細用法請參見運行命令時的幫助信息，以/?選項獲得。

2.5 字符入庫器(CharAdder.exe)
用于提取生成字庫所需的字符，命令行工具。
詳細用法請參見運行命令時的幫助信息，以/?選項獲得。

2.6 編碼轉換器(TransEncoding.exe)
用于批量轉換文件編碼，命令行工具。
詳細用法請參見運行命令時的幫助信息，以/?選項獲得。

2.7 Agemo文本驗證器(AgemoValidator.exe)
用于批量驗證Agemo文本格式，GUI工具。
詳細用法請參見運行時的提示信息。

2.8 簡繁日漢字異體字轉換器(TransVariant.exe)
用于批量轉換簡繁日漢字字形，命令行工具。
詳細用法請參見運行命令時的幫助信息，以/?選項獲得。

2.9 字符映射表生成器(MappingGen.exe)
用于進行最接近字符映射表生成，命令行工具。
詳細用法請參見運行命令時的幫助信息，以/?選項獲得。

2.10 WQSG文本驗證器(WQSGValidator.exe)
用于批量驗證WQSG文本格式，GUI工具。
詳細用法請參見運行時的提示信息。

2.11 字庫圖片生成器(FontGen.exe)
用于生成fd字庫描述文件和字庫圖片，命令行和圖形界面工具。
詳細用法請參見運行命令時的幫助信息，以/?選項獲得。

2.12 暴力文本導出器(BruteForceExporter.exe)
用于使用正則表達式或自定義標記按指定編碼從字節文件中暴力提取WQSG文本。
詳細用法請參見運行命令時的幫助信息，以/?選項獲得。

2.13 WQSG文本導入器(WQSGImporter.exe)
用于導入WQSG格式的文本，特別是暴力提取的文本。
詳細用法請參見運行命令時的幫助信息，以/?選項獲得。

2.14 正則表達式字符串替換工具(RegexReplace.exe)
用于命令行替換文件中的字符串，命令行工具。
詳細用法請參見運行命令時的幫助信息，以/?選項獲得。

2.15 元類型結構處理工具(MetaSchemaManipulator.exe)
用于從元類型結構生成代碼，命令行工具。
詳細用法請參見運行命令時的幫助信息，以/?選項獲得。

2.16 VB文本驗證器(VBValidator.exe)
用于批量驗證VB文本格式，命令行工具。
詳細用法請參見運行命令時的幫助信息，以/?選項獲得。

3 環境要求

本框架使用 Visual Basic 10.0 編寫，開發時需要 Visual Studio 2017 或 BuildTool 支持。
本框架運行時需要 Microsoft .Net Framework 4 或 Microsoft .Net Framework 4 Client Profile 運行庫支持。
Microsoft .Net Framework 4 (x86/x64，48.1MB)
http://download.microsoft.com/download/9/5/A/95A9616B-7A37-4AF6-BC36-D6EA96C8DAAE/dotNetFx40_Full_x86_x64.exe

Microsoft .NET Framework 4 Client Profile (x86，28.8MB)
http://download.microsoft.com/download/3/1/8/318161B8-9874-48E4-BB38-9EB82C5D6358/dotNetFx40_Client_x86.exe

4 用戶使用協議

以下協議不針對示例(Examples文件夾)：
本框架是免費自由軟件，所有源代碼和可執行程序按照BSD許可證授權，詳見License.zh.txt。
本框架的所有文檔不按照BSD許可證授權，你可以不經修改的復制、傳播這些文檔，你還可以引用、翻譯這些文檔，其他一切權利保留。

以下協議針對示例(Examples文件夾)：
本框架的示例進入公有領域，可以隨意修改使用。

5 備注

若你使用C++編程，需要使用C++/CLI才能調用本框架的內容。

如果發現了BUG，或者有什么意見或建議，請通過說明文件Readme.zh.txt中的郵件地址或者直接在本網頁下留言與我聯系。

——————-

螢火蟲漢化框架示例說明

地獄門神(F.R.C.)

示例說明如下，其中部分示例需要運行Build.cmd編譯，因此請確保有編譯環境：

Compressing
演示LZ77壓縮通用庫的調用方法。

Encoding
演示使用MappingGen來進行偽Shift-JIS碼表的創建。
使用偽Shift-JIS碼表，可以在不修改日文游戲的編碼處理部分的情況下，通過修改字體文件和文本來完成漢化。
使用MappingGen創建的偽碼表會盡量保證對應原字或原字的異體字。

Imaging\MIG
演示MIG/GIM文件的導出和導入。
編譯后在Imaging\MIG\Bin中使用MigTran導入導出。
導出時將MIG/GIM文件拖到MigTran上。
導入時將導出的文件拖到MigTran上。

Imaging\ImageSplitter
演示通道分離。
可以將.Net類庫支持的幾種圖像文件(如png)的按ARGB通道分離成A通道、RGB通道兩個文件。

Packaging
演示文件包讀寫框架的使用。
演示跨語言調用本庫。
分別有F#、VB、C#、C++/CLI四個版本。

本框架的示例進入公有領域，可以隨意修改使用。

本框架使用 Visual Basic 10.0 編寫，開發時需要 Visual Studio 2017 或 BuildTool 支持。