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 資料夾中安裝的本地批處理檔案。只需重新編寫批處理實用程式以使用略微不同的資料夾啟動點 (或將其作為存檔，從中重新複製已刪除的檔案到您想要的位置)，即可讓工具箱繼續使用！

N3V 維基有一個頁面，位於 PEV 的 Trainz 工具，提供了有關如何使用這些工具以及下載連結的簡要說明，以及更多有關 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. 設定一個系統還原點，將其標記為“安裝 PEVtools 之前的版本”，然後重新啟動。(這確保所有 Trainz 都已關閉，並且快取已清空。)
依次開啟下載資料夾，在 VISTA 和更新版本的 Windows 中。我們許多人維護著一個 Trainz 工具目錄，在這種情況下，將安裝程式拖放到該資料夾中。然後...
1. 右鍵單擊並按住 (RMBHd) 啟動，(以管理員身份執行下拉選單) 依次啟動每個 PEV 的工具。

在您在安裝的每個 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 用於將漸進網格轉換為索引網格

快速陰影 用於在需要的地方建立簡單的陰影

附件製作器 幾分鐘內將附件新增到資源

這些教程的轉載版可以在 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），在將 PM2IM 轉換後，如果您只是暫時將 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 檔案是一個可編輯的文字檔案，允許您在不解除安裝和重新安裝實用程式的情況下重新訪問這些選項。有一個二進位制值可以設定為零，“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 下有一個本地副本，就像它的 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]