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]