Trainz/Content Manager

From Wikibooks, open books for an open world
Jump to: navigation, search
Introductory Trainz — page by page instruction
Trainz | Introductory Trainz | Trainz AM&C | Creation | Appendixes |  References • Containers • Kinds • Tags • Index
 Mouse use
Content Manager in it's early 'CMP' incarnation.

Introduction To CM/CMP[edit]

Predecessors to CM or CMP meaning Content Manager.exe was a stand alone utility from Trainz 1.0 through TRS2004-SP4 with which users could install new modeling assets. In essence the early simple contentmanager.exe programs did some simple file management and unpacked cdp files and tucked their contents away.

Prior to TRS2004, the cloud services we know as the DLS was more list presenting access to a disorganized collection of zip and cdp files than an organized database with a built in search engine, FTP manager and central repository that was established about the time TRS2004 (v2.0) came about. The local Trainz database was more organized as groups of open files as well, and data corruption was thus more likely. With a database manager on the servers to handshake with on the DLS end, more sophisticated user-end software became feasible and with trainz-build v2.5 of TRS2006 Content Manager—then retitled as Content Manager Plus (CMP)— took on a whole host of additional capabilities formerly performed by separate *.exe utility programs and incorporated a ton of new powerful search and asset management features such as the ability to directly communicate with the download station (DLS), could import content from installation to installation by direct file importing/parsing or via cdp importation, export a route or asset to share on the DLS, manage asset editing, manage and use archives and archiving, and generally became the centerpoint for asset operations not involving actually building a route. Today's CM (often still referred to as CMP on the forums) has the same functions, much the same look and feel, and varies little save for searching enhancements from the TRS2006 era CMPs.

P train grey.png
The content manager in the forthcoming Trainz: A New Era (TANE) will be a very different user interface than the one described here.

CM/CMP (Content Manager Plus) is accessible via the Trainz launcher screen or by directly launching the exe file from the Trainz installation's root directory \bin sub-folder. Many users with multiple Trainz installations will bundle shortcuts to launch the CM or Trainz launcher programs from a common Trainz folder. CM's purpose is to manage the assets on your hard drive (located in your Trainz\UserData folder) and the subfolders therein (such as the \local, \screenshots, \editing folders).

Mainly Trainzer's use it to communicate and manage downloading from the DLS, and to select and filter assets for surveyor. TS2009 introduced enhanced filtering (selectability) so power users will often define a search criteria, called a search filter, save that and then use that to trim down the list of assets one must look through to find a desired asset when route building.

CM/CMP has a sophisticated search facility and automatically downloads dependencies associated with each asset. CM/CMP is closely integrated to CCP and is also used to open assets for editing and committing them for use in Trainz. In TRS2006 and above, new assets and asset clones (copies with new kuids) are created via CM/CMP.

P train grey.png

The original 'Content Manager Plus' precursor page to this page was overhauled in March 2014, and the 'Blog' section within it is so charmingly written and mostly still applicable, (from an experiential point of view, it gives the flavor of using the CMs your first few time really well--provided sounds are enabled!) It was worth retaining for new users, so take time to read it. After wrestling with CM a month or so, re-read it and laugh at what you missed the first time.

Getting around in CM[edit]

CMP through CM-3.7 looks much like a spreadsheet with relocatable columns (from CM-2.0 of TS2009) meaning columns selected for viewing in the 'main view' (the right hand part of the screen) using ALT+V can later be slide left or right and rearranged to suit the user preferences, or the type of task you might be about. For example, one day you might want to locate all the assets that were installed with the download of XYZ route and sessions, so want to see install date... an otherwise uninformative data column. Some days you want modification date, and on others perhaps, the regions, era or the trainz-build values are your primary sorting and searching interests. The check box in the ALT+V menu allow hiding columns or turning their display on, whilst dragging them allows you to rearrange them left to right.

title bar notations

The notations CM-X.Y appears in the CM/CMP title bar after TC3 and after TS2009-SP3 the X.Y (initially just CM-2.0) was incremented with each code build and so displayed as a suffix to give a visual reminder of the trainz-build tag or 'version' of the Trainz software. It now signifies the trainz-build code an asset created or updated using Content Creator Plus (CCP) editing will be given.

Editing modes

CM supports asset editing in two forms: CCP, which is a table-like fill in the blanks rigid form for getting the proper parts assigned to a new asset, or by free form editing using Windows utilities. For asset repairs, virtually everyone avoids CCP and uses a Windows Explorer editing folder with direct access to the files making up the asset. This folder and files can be opened in several ways:

  1. Hotkeys SHFT+CTRL+E directly opens a Windows Explorer folder with no processing, and it pops up immediately on top of other screen windows.
  2. RMBH+drag+Open With accesses one of the PEVtools or other batch utility that has been installed in the \bin\...\Tools sub-folder. Thusly, for example, if a repair requires accessing textures (say in the error message you see an alphamask and it's base texture don't match in size, so one needs re-sized) one can open the asset with PEV's images2TGA utility and be ready to fix the problem immediately. In this case the window will often be behind or other another Windows application window depending upon your video set up and the biases built-in to Windows. If running a dual or three monitor system, often these can be biased to open in the other screen(s) from CM, so will open where it can be seen immediately.

Left hand panes[edit]

In truth, the left hand panes are an overcrowded mess cramped for space since TRS2006 was written long enough ago (2004-2005) that dual and triple head systems were very rare, and the arrangement made sense for single monitor systems. The alpha-test software for TANE will have an entirely different look, see, and feel with floating and resizable windows. Each left hand pane has a little click icon to open it or close it, and in normal operations, one will be the DLH (Download Helper) pane, another the Asset Details pane, and as needed, the search pane. Other panes are for uploading, archiving, and so forth. Play a bit and read the manual, whether printed or in pdf format, then re-read it. Wait a month and read it again. Each time will give you the power of additional knowledge and insights as to the capabilities shedding further light on what we present herein.

Download Helper[edit]

Buttons are straight forward, Start, Clear, Stop. With nothing in the pane, it's already cleared. To pick something for download, one sets up a search criteria (below) then clicks on one or more assets to select them (Highlighted, colors of CM and highlighting are as you set them in your Windows theme) then drag them into the DLH pane. As you add more you'll likely note some activity going on, part of which is CM and the DLS are filling in dependencies—sub-assets the asset you selected depend upon as parts, for example the bogeys, wheels, or couplings of that railcar type, or textures, etc. which are parts of the assets you selected. As you add more by drag and drop, the list will grow a scroll bar and grow longer as dependencies are identified and added.

P train grey.png
You should always give the DLH some time to settle before hitting Start, but once it's cranked the top of your list for a couple of minutes, these days hitting start seems risk free, unlike some of the instabilities CMP used to exhibit as are alluded to in the CMP article. CM-2.0 may suffer some of he same issues, but CM-3.3 and after offload much of the data management to TADdaemon.exe which gates data to and from the DLS whilst TrainzUtil.exe manages adds, extractions, and so forth to the database proper; both being invisible in the background save to power users.
←   Prev: [  Content Manager ]  — ↑Trainz   ]  —   Next: [   External Links  ]   →
  Previous page: Trainz Next page:    
←    [ Content Manager  ] ⇐ Previous  Glossary    Next   ⇒   [ External Links ]  →