View source for Trainz/Content Manager

You do not have permission to edit this page, for the following reason:

Your IP address is in a range that has been blocked on all Wikimedia Foundation wikis.

The block was made by ‪EPIC‬. The reason given is Open proxy/Webhost: See the help page if you are affected.

Start of block: 08:48, 2 July 2024
Expiry of block: 08:48, 2 July 2025

Your current IP address is 206.189.44.186. The blocked range is 206.189.32.0/20.

Please include all above details in any queries you make. If you believe you were blocked by mistake, you can find additional information and instructions in the No open proxies global policy.

Otherwise, to discuss the block please post a request for review on Meta-Wiki. You could also send an email to the stewards VRT queue at stewards@wikimedia.org including all above details.

You can view and copy the source of this page.

<!-- #REDIRECT [[Trainz/Content Manager 2.0--CM3.7]] 2021-03-25th
Not So Joe! Clone page just moved pending revision to the new beast
-->{{FUN-top|both=1|ref2=1|1=content man0|CO1=blue
|xalttitle2=Introductory Trainz — page by page instruction Fundamentals for Trainz Trainees
|p={{TL|Trainz modules}}|alttitle2=Introductory Trainz — written for those new to Trainz
|Xalttitle1=Fundamentals for Trainz Trainees<br/>Introductory Trainz — historic back ground for those new to Trainz
|rh={{TL|Trainz modules}}|h={{TL}}
|n={{here|CM Basics}}<!--TRS-X|Content Manager|sp=CM Basics}}
--->
<!--|alttitle2=Introductory Trainz — historic back ground for those new to Trainz-->}}

<!--https://en.wikibooks.org/w/index.php?limit=500&tagfilter=&title=Special%3AContributions&contribs=user&target=Fabartus&namespace=6&tagfilter=&newOnly=1&year=2015&month=-1
-->
{| style="float:right; clear:both;"
|-
| <!--
--->[[File:Typical-TRS2004eraErrors-00-00antd-Total-List,Ready to begin fixing New Impoorted Content frm bottom toTop.jpg|thumb|[[Trainz/Content Manager|Content Manager]] in it's early 'CMP' incarnation.]]
|-
| [[File:Category-era and Category-region in Trainz's CM are separate dropdown entries for sorting and selecting appropriate mixes of criteria when narrowing down content numbers.png|thumb|File:Category-era and Category-region in Trainz's CM are separate dropdown entries for sorting and selecting appropriate mixes of criteria when narrowing down content numbers.]]
|-
| <!--
-->[[File:A Category in Trainz's CM are an aid to sorting and selecting appropriate content varieties which are classified into groups by N3V loosely based on category-class and Kinds.png|thumb|A Category in Trainz's CM are an aid to sorting and selecting appropriate content varieties which are classified into groups by N3V loosely based on category-class and Kinds. ]]
|-
|}
<!-- original location
[[File:Typical-TRS2004eraErrors-00-00antd-Total-List,Ready to begin fixing New Impoorted Content frm bottom toTop.jpg|thumb|[[Trainz/Content Manager|Content Manager]] in it's early 'CMP' incarnation.]]
<code><pre>p={{TRS-X|Trainz modules}}|h={{TRS-X|Trainz modules}}|n={{TRS-X|Content Manager|sp=CM Basics}}
</pre></code> -->
:*''Releases earlier than Trainz: A New Era (TANE) are covered in the main page: ''' [[Trainz/Content Manager 2.0--CM3.7]]''' ''
:*''Early versions coverage: [[Trainz/Content Manager Plus|Content Manager Plus]], &nbsp; [[Trainz/AM&C/Content Manager|AM&C/Content Manager]] ''
&nbsp;
{{Trainz-stub|sort=content Man0|fix=This Page is currently a clone of previously covered versions (See above links)... It will be r
rewritten as an introductory tour, focused on the new style TANE and TRS19 release format -- probably with some worked-in How-To examples to immediately empower newer users.}}

== Introduction To CM/CMP==
;Background to the Content Manager and the DLS 
Predecessors to '''CM''' or '''CMP''' were a stand alone utilities from Trainz 1.0 through TRS2004-SP4 ''(also named '''ContentManager.exe''',. hence the 'Plus' of TRS2006's CMP)'' with which users could install new modeling assets. There weren't many options but installing assets. Other utilities performed some of the tasks (e.g. uploading) but Data Management was mainly manual by moving folders about.
&nbsp;
In essence the early simple ContentManager.exe programs did some simple file management and unpacked {{TG|CDP|cdp}} files and tucked their contents away in a scheme using open folders, {{TG|E|enumerated}} folder locations, and a data system that had no real data base to it. They could also create cdp files, allowing the early growing Trainz community to feast on shared creations. Eventually, the early {{TL|Download Station}} was hosted by Auran and users could browse without much search capability much as one can on today's less sophisticated 3rd party Trainz fan-sites. Most of these are operated by an individual or a small group of {{TL|Content Creator}}s.
&nbsp;
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. It was a central repository but a chaotic one, and the chaos was converted into today's order when DLS was established during {{TL|UTC}}'s hey days (v1.5), a little before the time TRS2004 (v2.0) came about. 
&nbsp;
===The need for CMP===
The early local Trainz {{TG|I|install}}'s database was more organized as groups of open files as well, and data corruption was thus more likely until TRS2004 evolved a better file structure and compressed data formats, which was best exploited with the advent of TRS2006 and its ''Content Manager Plus'' became a data base manager and search and access tool. With a database manager on the servers to handshake with on the DLS end, the more sophisticated user-end software became feasible and it arrived with trainz-build v2.5 ({{TL|TRS2006}} Content Manager&mdash;then retitled as '''{{TL|Content Manager/Content Manager Plus|Content Manager Plus}} (or {{TL|CMP}})'''. 
&nbsp;

===The powers of CMP===
CMP had capabilities unknown in the earlier Trainz 'Content Manager' which relied on a primitive {{TBS|region}} and {{TBS|type}} tags classification system for it's limited capabilities of asset grouping and searching. The earlier module was mostly a listing/cataloging utility allowing a user to examine her own inventory of assets, with no information from the DLS.
* CMP took on a whole host of additional capabilities formerly performed by several separate *.exe utility programs, including those of 3rd party providers, and incorporated a ton of new powerful search, classification, and asset management features such as:
# the ability to directly communicate with the {{TL|Download Station}} (DLS) during searching
# could import content from installation to installation by direct file importing/parsing
# or via cdp importation,
# export a route or asset or
# upload it to share with others on the DLS
# manage asset editing
# manage and use archives and archiving
# search by combining criteria and classification
 
and generally became the center-point for asset operations not involving actually building a route. {{TrainzTip|BG=white|'''TS09's CM-2.0-TS12 CM-3.7's''' (All often still referred to as CMP on the forums) have the same functions (with some extensions), and ''much the same look and feel'', as well as their operations&mdash;have varied little save for important expanded searching enhancements from the TRS2006 era CMPs, and for the addition of a column identifying the {{TBS|trainz-build}} (aka 'version') value of an asset.
* The content manager in '''Trainz: A New Era (TANE)''' is (''finally'') a different 'Windowed' user interface with ''multiple 'main view report views' ''than the historic CM's described and depicted here with their'' 'fixed left panes' ''and TANE's has an ability to locate it's windows on any monitor (untied to the control panes), and each of which may then spawn an alternative sub-search and display another 'main view'.
{{TRS-EdNt|The TANE CM, as of the May 15th 2015 launch of the TANE 'Release Version', is still a work in progress in September&mdash;with N3V and the developer's user group refining it's user interface throughout the summer. It's firm or final interface and hotkeys, et. al. is expected to arrive with Trainz:A New Era's first Service Pack<ref><u>TANE CM/SP1-Situation normal</u>: Announced in the planning by Tony Hilliam in early August, without any expected publication date/deadline.</ref>}}
}}

&nbsp;

===Launching CM/CMP===
CM/CMP ('''Content Manager Plus''') is accessible via the {{TL|Launcher|Trainz Launcher}} screens or by directly launching the ContentManager.exe file from the Trainz installation's root directory \bin sub-folder {{BL|(recommended, or by shortcut thereto)}}. Many users with multiple Trainz installations will bundle shortcuts to launch the CM or Trainz launcher programs from a common Trainz folder. CM's primary purpose is to manage the data flow to and from the DLS and manage the local assets on your hard drive (located in your '''[[Trainz\The UserData folder|..\UserData folder]]''') and the sub-folders therein (such as the '''..\local, ..\settings, ..\screenshots, ..\editing''' folders) as well as the Trainz release's special data base of built-in items. (See '''{{TG|JA files}} and {{TG|l|Libraries}}'''.)

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 (selectable savable criteria were part of the T'06 CMP, but the way they could be combined was limited. In T'09, {{BL|the new power was in the addition of new search-refining Boolean logic operators: '''OR''', '''AND NOT''', and '''''AND'''''}} [the latter of which is somewhat redundant in most uses{{efn|AND Boolean Operator: Is rarely needed ''in simple filters'', for two ''filter entry windows entered'' {{nowrap|(stacked) ''one-after-another''}} automatically combine in a Boolean AND. Hence, It's usefulness comes mostly in filter formations using the AND NOT operator first with a conditional linked to a second or third criteria separated by an OR operator.}}]) so power users will often define a search criteria, called a {{TL|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 identifies and downloads {{TG|dependencies}} associated with each asset. CM/CMP is closely integrated to {{TG|C|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, though a {{TL|route}} or {{TL|session}} may be cloned using a Save As option in {{TL|Surveyor}}. 
 
{{TrainzTip|BG=white|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. Despite the improvements, the operations are so very similar it's worth taking the'' 'grin-making' ''time after you've acquired some CM operations experience.
}}

==Getting around in CM==
[[File:Trainz CM Tricks-01 in TS10 (w-small icons) Using an ORed KUID list to view fixed asset and then to see certain dependencies not in first KUID group.png|thumb|alt=[[commons:File:Trainz CM Tricks-01 in TS10 (w-small icons) Using an ORed KUID list to view fixed asset and then to see certain dependencies not in first KUID group.png]]|'''Using an ORed KUID list to view fixed asset''' - Some faults won't show as fixed, until the asset is recommitted. See the description on this image when blown up.]]
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 {{kp|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 {{kp|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 {{TL|TC3}} and after TS2009-SP3 the X.Y (initially just CM-2.0) was incremented with each {{TG|C|code build}} and so displayed as a suffix to give a visual reminder of the {{TR|T|trainz-build}} or 'version' of the Trainz software. It now signifies the trainz-build code an asset created or updated using {{TL|Content Creator Plus}} ({{TL|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:
# Hotkeys {{kp|SHFT|CTRL|E}} directly opens a Windows Explorer folder with no processing, and it pops up immediately on top of other screen windows.
# {{kp|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==
{{TrainzTip|BG=white|1=
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 Windows software interface in TANE has an entirely different look, see, and feel with floating and resizable windows but can get a bit messy in a different way; while still following the spirit of the original TRS2006 Content Manager Plus and those CM versions since. 
}}
&nbsp;

For the moment, notice the default tabs along CM's top of the {{TL|main view}} ''each load a search criteria in the Search pane when pressed;'' and also that by using {{kp|Tab}} (Toggles) one can hide or open the left panes. The {{TLH|How-To Search efficiently in CM}} tutorial & reference will allow us to cover ''tips and tricks'' in depth outside this survey topic. ''(You didn't want to read that here, now anyway, did you?)''{{-}}
[[file:Image of TS12's left hand control windows or panes.png|thumb|left|400px|Image of '''{{TL|TS12}}'s''' left hand ''tools windows'' or ''control panes'' (most closed, with little change in appearance since '''TR'6'''). <br
/>1. The '''Down Load Helper ({{TL|DLH pane}})''' opens as the top Pane, here showing one item needing updated. (Note the icon)<br
/>2. the {{TL|Search pane}} window opens next down (partially obscured off-pane), and <br
/>3. the third down, {{TL|Details pane}} shows a thumbnail of the asset and part of it's description tag's data field information. Other information is obscured off-pane.<br
/>4. Whereas, each when minimized looks like the other three 'collapsed' pane bars on the bottom, saving for their labels.]]

As can be seen in the image below and left, 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''', or other combinations ({{TL|uploads pane|uploads}}, {{TL|archive pane|archive}}, and {{TL|pick list}}) based on what you are doing that give you the desired flexibility. Each can be closed when set up and still have effect, or the whole set of panes can be toggled open or closed with commensurate widening or narrowing by alternate presses of the {{kp|TAB}} key. Other panes shown are for uploading, archiving, and so forth, but like the DLH pane, these are used primarily by dragging and dropping from the '''Main View''' into the pane, so must be open to be in actual use. ''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 here.
&nbsp;
[[File:TRAINZ RMBH+drag dropdown menu showing asset with Dependencies and Dependent Assets.jpg|thumb|400px|alt=|As can be seen in the images above, Trainz has various RMBH drop down menus, as with the one shown here from right clicking on an asset in ''the 'Main View'.'' This particular image doesn't show you the currently selected line which like the currently selected asset would be highlighted in blue as I dragged down the menu. If you fixing a batch of new faulty assets, as in this view, the most common use is the line saying 'open with' which allows you to use external tools, such as {{TL|PEVtools}} to begin preparing an asset for examination and tweaking&mdash;normally all that is needed to make an asset workable.
Another commonly used RMBH+drag command is '''show asset versions''', which allows you to compare older and newer assets, and those which may have been obsoleted by an entirely different kuid series, perhaps by a different author entirely! Similarly, '''Show dependencies''' and '''show Config.txt''' files are both workhorse selections.]]

===Download Helper (DLH)===
{{TextBox|BG=white|clr=none|You should always give the DLH some 'few minutes' of time to settle before hitting {{mb|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 {{TL|CMP|CMP article}}. True,  CM-2.0 may suffer some of the same issues, but CM-3.3 and after offload much of the data management to a better implementation of 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. The TS12 TADdaemon is much improved over that of TS09 & TS10s shared technology.
}}
To pick something for download, one sets up a search criteria (see image left) 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&mdash;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.

==={{TL|Search pane}}===
Buttons are straight forward, {{mb|Start}}, {{mb|Clear}}, {{mb|Stop}}, and {{mb|+}}/{{mb|-}} to ''add/delete'' a new'' 'filter-line' (API data window)''. With nothing in the pane, it's already cleared. 
&nbsp;
{| style="float:right; clear:right; margin-left:1em; padding:5px; " border="2px"
! Example of DLS 'Unexpected Consequences'
|-
| One problem with DLS Route downloads:<br
/>Grabbing a Route or Session can bring<br
/>in 'bunches of tonnes' of dependencies!<br
/>(And their faults, if they use an old kuid!){{efn
  |On Download unexpected consequences:<br
/>In my experience, Surveyor and CM don't update a Session or Route kuid-table (dependencies) when saving an asset, if a newer Kuid2 or Obsolete-table entry replaces it. That action seems to happen only at load time. Hence, even an updated 'face-lifted' route may call for older KUIDs... and if your system doesn't have the latest update, the old one's come down as well. <br
/>This necessitates a version check of each missing dependency and a subsequent download. A {{TLH|How-To get asset dependencies efficiently|'How-To' process}} we'll cover elsewhere in depth.
}}
|-
|
{{:Trainz/Content_Manager/Six-begat-36-Table}}
|-
|}
===Perils of Downloading===
New Trainzer's need be aware of the perils of downloading too much too soon. There is a smart way to proceed, and ones less effective. The Table at right illustrates this point. Six assets were listed as downloads in the DLH pane. When the {{TG|dependencies}} were added by CM, the download was 36! A sixfold increase, and this is a mild example. Downloading a session will bring in a route, the route (and since Layers were introduced in TS10) and sessions might both have ''several thousand or several hundred'' asset dependencies respectively.
&nbsp;
 
===Search Pane===
Perhaps even more than the DLH the Search Pane will likely receive your most frequent attentions. 
{{-}}
<!-- ***** This comment, if it shows, is the top of the substed template:BP-TRS-refs ***** --->
&nbsp;
==Notes, Footnotes & References==
{{#if:||
Config.txt files are endemic and ever present in Trainz assets, for no asset can be defined without this type of {{TRC|p=Computer Science container}}. The keyword-value_of_key pairing must always be kept in mind in editing or creating Trainz content. The {{TBS|5=TrainzBaseSpec}} contains values and containers which are most common in asset defining config.txt files.
&nbsp;}} 

{{#if:||
===Notes===

{{notelist}}
&nbsp;}} 

{{#if:||
===Footnotes===

{{reflist}}
&nbsp;}} 

{{#if:||
===References===

* Trainz printed or {{wp|pdf file}} Manuals, applicable version - usually in the {{BL|..\extras or  ..\extras\manuals folder}}
* {{N3V|Config.txt_file|TrainzOnline Wiki Config.txt file page}} and various other pages
* {{N3V|CCG|TrainzOnline Wiki: '''Content Creator's Guide pages'''}} (various)
* Various {{TL|CCG}} and Auran websites
{{#if:|||

&nbsp;}}}} 
 
<!-- ***** This comment, if it shows, is the bottom of the substed template:BP-TRS-refs ***** --->
{{-}}
{{FUN-bot|IT=yes|cat1={{PAGENAME:{{BOOKCATEGORY}}}}|CC=1|sort=content man0}}
{{Trainz-page|{{TL|Trainz modules}}|{{TL|External Links}}}}

<noinclude>

{{Trainz-stub|sort=content Man0|fix=Page needs written as introductory tour, with worked-in How-To immediately empowering users.}}
</noinclude>

Templates used on this page:

Trainz/Content Manager/Six-begat-36-Table (edit)
Template:- (view source) (protected)
Template:Ambox (view source) (protected)
Template:Ambox/core (view source) (protected)
Template:BL (edit)
Template:BOOKCATEGORY (view source) (protected)
Template:BOOKNAME (view source) (protected)
Template:BOOKNAME/core (view source) (protected)
Template:BOOKNAME/inbook (view source) (protected)
Template:Beginner links (edit)
Template:Blue (edit)
Template:Bmbox (view source) (protected)
Template:Bmbox/core (view source) (protected)
Template:Box-shadow (edit)
Template:Bull (view source) (protected)
Template:BullR (edit)
Template:Center/end (edit)
Template:Center/top (edit)
Template:Col (edit)
Template:Efn (edit)
Template:Evalx (view source) (protected)
Template:FUN-bot (edit)
Template:FUN-top (edit)
Template:Here (edit)
Template:Info (view source) (semi-protected)
Template:Key press/core (edit)
Template:Kp (edit)
Template:Linear-gradient (edit)
Template:Main other (view source) (protected)
Template:Mb (edit)
Template:Mbox (view source) (semi-protected)
Template:N3V (edit)
Template:Notelist (edit)
Template:Nowrap (view source) (semi-protected)
Template:Reflist (edit)
Template:Reflist/styles.css (edit)
Template:TBS (edit)
Template:TG (edit)
Template:TL (edit)
Template:TLH (edit)
Template:TR (edit)
Template:TRC (edit)
Template:TRS-Book search (edit)
Template:TRS-EdNt (edit)
Template:TRS-hdrbox (edit)
Template:TRSpagestyle (edit)
Template:TextBox (view source) (protected)
Template:Trainz-page (edit)
Template:Trainz-stub (edit)
Template:TrainzTip (edit)
Template:Wp (edit)
Template:• (view source) (protected)
Module:Arguments (edit)
Module:Check for unknown parameters (edit)
Module:Message box (view source) (protected)
Module:Message box/ambox.css (edit)
Module:Message box/configuration (view source) (protected)
Module:TScope (view source) (protected)
Module:Wikilisp (view source) (protected)
Module:Yesno (edit)

Return to Trainz/Content Manager.

Retrieved from "https://en.wikibooks.org/wiki/Trainz/Content_Manager"