Trainz/AM&C/PEVtools

PEVtools 和修复资产

Trainz 的长期用户，退休的电气工程师 PEV (Peter Villaume) 编写了一些用于修复内容的工具，适用于多个 Trainz 世代，对维护和修改运行于 TS2009—TS2012 到 TRS19 的资产很有用。这些工具安装在制造商 'PEVSoft' 下，非常安全——因为作为个人，PEV 不会支付年度认证费用，只需忽略 Windows 或其他安全软件的警告。

由于它们操作 Trainz 数据基本元素（网格和纹理文件），实际上在 Trainz 版本中并没有无法应用的工具，只需要了解一些有关如何调整 Windows 以使用它们的知识。有些工具，比如 TrainCar Viewer2.exe，如果资产早于 TS2009（实际上 TBV 小于 2.9），将会出现问题；TRS2006 和 TANE 都已知会在其各自的 ..\editing 文件夹中清除和删除本地批处理文件，如果存在软件更新或数据库重建（通过命令请求）。为稍微不同的文件夹启动点重写批处理实用程序（或只是将其作为存档，从中重新复制已删除的实用程序到您想要的位置）是保持工具箱可用的全部内容！

在 PEV 的 Trainz 工具上有一个 N3V Wiki 页面，提供了一些关于如何使用这些工具的基本信息，以及下载链接和更多信息，以及 ShaneTurner 的资源网站，该网站还提供 Trainz 用户感兴趣的教程和其他实用程序。
四个 PEVtools 对修复和更新旧资产至关重要

Images2TGA,
PM2IM,
QuickShadows，尤其是
Mesh Viewer2。

第一个和最后一个是更新或修复新获得的内容软件中遇到的 99.9% 的资产问题所需的唯一工具。TS09—T12 集成了一个 'Open With' 外部应用程序启动器，通过它通常可以打开任何要使用 Images2TGA.bat 修复的资产。如果错误消息抱怨过时的 PM 网格，可以使用 PM2IM.bat 或组合批处理实用程序 pm2IM+IMGS2TGA.bat 来同时执行这两个操作。
如果经常遇到一组具有相同故障的资产——通常由同一个作者创建——最好使用 CTRL+E 打开该组，然后对整个编辑文件夹运行批处理实用程序。PEVtools 具有一个遍历功能，可以处理整个目录及其所有子文件夹。

获取和安装 PEVs 工具

PEV 的工具将由社区在一个或另一个网站上维护，因为它们非常宝贵。Peter V. 是一位真正的程序员，他位于澳大利亚与 N3V/Auran 的小镇位置（位于布里斯班附近的黄金海岸）相对的另一边（或悉尼），但在 2013 年中期停止在他的网站上托管他的工具，当时 Trainz 粉丝 Shane Turner 在他的帮助站点上接手了这项工作。

在 Shane 的网站上查找 PEVs 工具及其随附的手册。
下载工具（zip 文件），并退出您可能正在运行的任何 Trainz 版本。
在您安装了您打算运行的所有 Trainz 版本之前，请勿安装 PEVtools。（PEVtools 安装程序需要知道这些 Trainz 子目录的位置，并且这些目录必须首先存在。）
1. 与往常一样，退出 Trainz 时，按 [CTRL][SHFT][ESC] 打开文件管理器，观察直到 TADdaemon 模块退出再进行其他操作。（这在 TS12-SP1+hf3 之后快得多，但在早期安装中，如 TS2009 和 TS2010，是一个持续存在的问题。）
2. TADdaemon 关闭后，就可以安全地重新启动或以其他方式修改 Trainz 目录（备份文件夹、复制本地文件夹，或其他维护，如添加 PEVtools）。
3. 设置一个系统还原点，将其标记为 Pre-PEVtools 安装，然后重新启动。（这确保了 Trainz 全部关闭，并且缓存是空闲的。）
依次打开您的下载文件夹，在 VISTA 和更新的 Windows 版本中。我们许多人维护一个 Trainz 工具目录，在这种情况下，将安装程序拖到该文件夹中。然后...
1. 右键单击并按住 (RMBHd) 以启动，（以管理员身份运行下拉菜单）依次运行 PEVs 的每个工具。

在您的工具在您安装的每个 TRAINZ 版本中初始化后，您将在 '版本路径根文件夹' '..\bin' 子目录下看到路径规范 ..\bin\CMPData\tools\OpenWith，其中将包含在每个已初始化的 Trainz 版本中安装的 PEVtools 批处理文件。
1. 这意味着如果您运行多个版本的 Trainz 版本（包含多个 SP 和 hotix 组合，就像我们中的一些人一样），要在每个版本中安装 PEV 工具，您必须将批处理文件复制到非版本中，并手动编辑该安装的路径规范。
2. 有时，可以通过将这些启动器复制到本地 '..\UserData\editing' 文件夹中，在 Trainz CM 之外 更全面、更方便地使用相同的批处理文件——同样需要进行一些手动编辑。在此位置，可以打开要编辑的资产，'然后将资产文件夹拖放到' PEVsoft 工具批处理文件图标上。
3. 更好的是，聪明的 Trainzer 可以编辑这些批处理文件，并创建一个复合文件，使单个拖放操作可以运行所有工具。此 '全部按顺序' 批处理文件也可以放置在 \bin 目录中的 ...\tools 文件夹中。

PEV 工具教程

John King 的 Trainz 资源新闻通讯发布了一系列关于 PEV 的 Trainz 工具的教程。这些教程涵盖了

Images2TGA 用于操作 Trainz 中使用的所有图像类型

PM2IM 用于将渐进网格转换为索引网格

QuickShadows 用于在需要时创建简单的阴影

AttachmentMaker 在几分钟内向资产添加附件

这些教程的转载可在 Shane 的下载页面上找到。

附件制作器

一个通过创建具有这些点的不可见网格来向现有资产添加附件点的程序。使用起来非常简单快捷；在几分钟内添加附件。

Images2TGA

该程序用于解压缩 N3V 的filename.texture 文件，这些文件在由内容管理器处理提交资产时，以内部打包的形式存储。这将公开各种原始图像文件，并使它们以及它们的 'texture.txt 文件可供操作和调整。Images2TGA 可用于解包和查看 Trainz 通过 TS2012 使用的所有图像类型。

TANE and TRS19 have expanded the list of allowable texture source files, and the utility probably won't work with .PGA files. The TGA on the title is merely a reflection of those being the original preferred image format for texture files.

该程序还可以将任何图像转换为另一种格式，以及添加和操作 alpha 图像。您可以将您喜欢的图像编辑器附加到该程序，以允许从 Images2TGA 中打开图像进行编辑。该程序处理最新的dxt 压缩纹理，并允许将这些图像转换为其他格式。拖网功能可用于将纹理转换为 TGA。

该程序取代了旧的两代 PEVtools Texture Viewer 2.exe 和 Texture2TGA.exe。该工具的最后一个版本发布于 2010 年，可以在这里下载，以及 PDF 格式的教程文件。
在更新和修复超过 2800 种不同的（存档副本）故障资产时，作者发现需要解决两个纹理相关问题，Texture2TGA 完成了 Images2TGA.exe 未处理的任务。

PM2IM

这是一个将非常过时的 Auran 渐进式网格 (PM) 转换为索引网格 (IM) 的工具程序。提供了一个选项来更改镜面反射值，这些值会导致物体表面出现不必要的反光。

该程序还可用于从 IM 网格中删除不支持的（纹理剥离）纹理类型（在直接模式下运行时），因此请在编辑文件夹中安装一个启动器快捷方式，或者将 im 文件类型与该工具关联，如以下提示和技巧中所示。

注意：许多纹理故障可以通过使用 PEV 的 PM2IM 程序重新提取 .im 文件来修复，您可以从 Windows 内部独立使用它（打开并将其指向资产文件夹），或者可以将其放在 ..\editing 中的批处理文件中，或者从CM 的RMBHd 下拉菜单中启动（首先）。

Trainz 网格查看器 2

该程序能够显示完整的火车车厢和纹理网格，允许查看部分或全部资产。

当前版本为 2.25，于 2013 年 11 月 18 日发布。
它允许您拍摄可用的组装截图，检查连接点，获取网格的多边形数量，以多种模式查看这些网格，包括线框模式以及有无以米或英尺和英寸为单位的轴缩放。
这些模式都允许旋转、缩放和倾斜，因此您可以通过一些练习详细检查资产的某个方面。
CTRL+箭头键 允许偏移资产的原点，以便您可以放大感兴趣的特定区域。SHFT+箭头键 允许您改变居中位置，以便在资产很大并且初始参考坐标轴偏离中心时，缩放能够对准目标并具有相关性。（这两种操作类型的改进空间都很大，但只要您有足够的耐心和足够的按键次数，它们就能告诉您需要了解的信息，以便进行修补或决定还需要做些什么。）
可以查看凹凸贴图网格。
可以单独查看附件，还可以查看火车车厢部件，例如转向架、喇叭和其他具有独立网格的组件。所有这些都可以进行定向，然后成像以创建 Trainz 资产修复所需的缩略图。
完整的火车车厢将显示在一定长度的轨道上，以及一个简单的纹理地面。可以自定义背景颜色，以便于检查或截取屏幕截图。这种改变对于某些屏幕截图需求特别有用。

注意：某些火车车厢在使用单一转向架类型时，可能无法在转向架容器的一种合法配置下正确显示，但另一种配置（简单版本）下可以正常显示。当您看到一个单轮位于一个双轮转向架的中心时，您会亲眼看到这一点。

如果只是暂时将trainz-build 代码值更改为 v2.5 或更高版本，然后保存（并使用该工具查看和窥探... 然后再恢复更改，或者不恢复！），则该工具可以与旧的资产（v1.3-v2.4）一起使用。
纹理视图功能允许您消除由包含额外的纹理文件引起的故障，这在旧的资产中比较常见，其中一个未使用的 texture.txt（有或没有匹配的 .tga 文件）位于资产文件夹中，但网格文件根本没有使用它。

编辑说明： 如果您要修补 V1.3 到 V1.5 的资产，使其能够在 TS09 及更高版本中通过验证和提交，则通常需要添加网格表容器、缩略图容器，以及对于火车车厢，添加转向架容器。除了缩略图，这就是 V2.0 资产的食谱，缩略图在 V2.5、TRS2006-SP0 中添加，因此不妨升级 trainz-build！该资产肯定不再适用于 Trainz 1.3！

最棒的是，纹理视图功能允许您确定丢失纹理（按名称或文件名）的映射位置和方式，以便您可以从其他资产中生成或找到替换纹理。

快速阴影

PEV 还编写了一个用于创建资产阴影网格的工具，并包含嵌入式纹理修复（旧资产的更新），称为 QuickShadows，用于火车车厢、桥梁以及从 TRS2004 开始需要这种功能的少数其他资产类型，当时该功能通过 TS12 开始适用于这些资产。Quickshadows 将获取任何 Trainz 网格，并根据其获得的输入创建阴影网格。TANE 为所有内容创建动态阴影，据称^{[脚注 1]} 因此，在撰写本文时，我们推断将这种功能添加到资产中将更多地是为了实现与旧版本的兼容性，而不是实际的必要性。

编辑说明： 明智的赌注是，即使对于 TANE，程序员也会在火车车厢缺少阴影网格时仍然生成错误消息。

Quickshadows 有几种模式可以创建火车车厢阴影网格，您应该尝试这些模式，找到适合该资产的最小多边形阴影。只有对于复杂的火车车厢（例如机车）才应单击“低多边形阴影”选项。对于大多数机车车辆和建筑物来说，简单的阴影单击框设置就足够了。

PEV 安装的软件会在批处理文件中添加“-close”开关到命令行，除非在 quickshadows 初始化时找到 Mesh Viewer2 或其他 Mesh Viewer，因此应该先初始化 quickshadows。
但是，ini 文件是一个可编辑的文本文件，允许在不卸载和重新安装实用程序的情况下重新访问这些选项。可以将一个二进制值设置为零，“CloseOnDone=0'”，这将允许从运行对话框、exe 文件夹或合适的批处理文件启动 quickshadows，允许在程序坚持关闭自身时重新访问设置菜单。
与 PEV 的大多数实用程序一样，Peter 在 quickshadows 文件夹中包含了一个 Windows 帮助文件（'quickshadows.chm'），其中包含术语搜索功能，详细介绍了如何使用该程序。
在引入阴影网格的历史 UTC 数据模型结构中，阴影网格通常放置在一个子文件夹中，该子文件夹的名称是通过将asset-filename 标签值与 '_shadow' 组合得到的。PEV 的工具将在它搜索网格文件的同一文件夹中创建阴影网格，该文件夹由批处理文件在未直接调用时确定。

添加关联选项

例如，如何将多个绘画、照片处理、显示或图形创建程序中的一个或多个与 BMP、JPG、PNG 和 TGA 文件相关联，以便在需要操作这些文件时尽可能快地使用最佳应用程序——Windows 通常将前三个与它的照片和传真查看器默认关联，而照片和传真查看器无法显示 TARGA 格式的文件。

像 Windows 下的任何可执行文件一样，可以将文件类型与一个或多个文件相关联，然后这些文件可以可选地打开该类型的文件扩展名。当您想要右键单击数据文件类型以提供选择时，此操作对于单个应用程序来说很简单，但对于多个应用程序（如上面提到的图形/绘画程序）来说则是重复性的。

@echo on
REM File: ..\UserData\editing\$$_All-but-viewer.bat
"F:\PEVSoft\Images2TGA\Images2TGA.exe" -trawl -close -fixcolour %1% 
"F:\PEVSoft\pm2im\PM2IM.exe" -trawl -close %1% 
"F:\PEVSoft\quickshadows\QuickShadows.exe" -trawl -close %1% 
"F:\Progs\fnr.exe" --cl --dir %1% --fileMask "*.txt"  --excludeFileMask "*.dll, *.exe"  --includeSubDirectories --find ".pm" --replace ".im"

关于 $$_All-but-viewer.bat
对于 PM2IM 后处理，我在修复数百个资产时遇到的唯一问题是，当它没有找到要更改的 .PM 扩展名时，它会生成一个错误代码（就像好的软件一样）。这也表现在从 CM 内部运行批处理时。（我在 PEV 的其他工具的本地副本（在 ..\bin 下）中有一个，就像它的 Traincar 伙伴一样。它比依次运行每个工具要好。）

$$_All-In-Sequence.bat

@echo off
REM File: ..\UserData\editing\$$_All-In-Sequence.bat
"F:\Progs\PEVSoft\Images2TGA\Images2TGA.exe" -trawl -close -fixcolour %1% 
"F:\Progs\PEVSoft\pm2im\PM2IM.exe" -trawl -close %1% 
"F:\Progs\PEVSoft\quickshadows\QuickShadows.exe" -trawl -close %1% 
"F:\Progs\fnr.exe" --cl --dir %1% --fileMask "*.txt"  --excludeFileMask "*.dll, *.exe"  --includeSubDirectories --find ".pm" --replace ".im" 
REM pause Press any key to view mesh and finish
"C:\Progs\PEVSoft\Mesh Viewer2\Mesh_Viewer.exe" -trawl -close %1%

关于 $$_All-In-Sequence.bat
对于 PM2IM 后处理，我在修复数百个资产时遇到的唯一问题是，当它没有找到 Traincar 资产时，它会生成一个错误代码（就像好的软件一样）。PEV 的编码技能一流，对 Mesh Viewer 的调用在资产不是火车车厢时不会产生任何问题。据我记忆，这也表现在从 CM 内部运行批处理时向 CM 返回一个错误代码。此工具和上面的工具将在 CM 中通过标准的任务完成 API 窗口报告，仅注释返回了错误代码。（我在本地有一个副本（在 ..\bin 下），与 PEV 的其他工具一起，就像它的 Traincar 伙伴一样。它比逐个拖放运行每个工具要好。）

本地 PM2IM.bat 替代方案

如果你想在现代计算机快速执行的情况下看到发生了什么，你可以使用一些状态消息和“等待按键”延迟来欺骗一个批处理文件，例如此文件包含的。

@echo off
REM File: F:\TS12\UserData\editing\$$_PM2IM.bat
"F:\PEVSoft\pm2im\PM2IM.exe" -trawl -close %1%
echo PM2IM done, ready to patch file extensions (*.pm to *.im)
pause 
echo patching file extensions (*.pm to *.im)
"F:\Progs\fnr.exe" --cl --dir %1% --fileMask "*.txt"  --excludeFileMask "*.dll, *.exe"  --includeSubDirectories --find ".pm" --replace ".im"

请注意上面存在 FNR.exe，以及 PEVtools 在“那台”计算机安装上的不同根目录。

将其与 PEV 安装的文件进行比较：（添加了完整的路径说明 REM 行作为 ID 标头。）

@echo off
REM File: F:\TS12\bin\CMPData\tools\OpenWith\PM2IM.bat
"F:\PEVSoft\pm2im\PM2IM.exe" -trawl -close %1%

[脚注 1]