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]