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,
快速阴影，尤其是
网格查看器 2。

第一个和最后一个是更新或修复新获得的内容软件中遇到的 99.9% 资产问题所需的唯一工具，当内容管理器抱怨时。TS09—T12 集成了一个“打开方式”外部应用程序启动器，通过该启动器通常打开任何要使用 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's 工具教程

John King's Trainz Resources NewsLetter 发布了一系列关于 PEV's Trainz 工具的教程。它们涵盖了

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

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

快速阴影 用于在需要的地方创建简单的阴影

附件制作器 在几分钟内为资产添加附件

这些教程的转载可以在 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 资产修复所需的缩略图。
完整的火车车厢显示在一段轨道上，以及一个简单的纹理地面。可以自定义背景颜色以进行检查或截图。这种更改对于某些截图需求特别有用。

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

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

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

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

QuickShadows

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

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

Quickshadows 有几种模式可以用来制作火车车厢阴影网格，应该尝试使用它们来找到适合该资产的最小多边形阴影。仅当火车车厢很复杂（例如机车）时，才应点击低多边形阴影选项。对于大多数滚动库存和建筑物来说，简单的阴影点击框设置就足够了。

PEV 的安装软件将在批处理文件中将 '-close' 开关添加到命令行中，除非在 quickshadows 初始化期间找到网格查看器 2 或其他网格查看器，因此应该先初始化它。
但是，ini 文件是可以编辑的文本文件，允许您重新访问这些选择，而无需卸载和重新安装实用程序。有一个二进制值可以设置为 0，'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 内部运行批处理时。（我有一个本地副本（位于 ..\bin 下），与 PEV 的其他工具一起，就像它的 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 的编码技能一流，调用网格查看器时，即使资产不是火车车厢，也不会产生任何问题。据我所知，这也会在从 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]