Content Manager - Revision history

S301: Redirected page to Help:Content Manager

2018-08-01T03:14:38Z

← Older revision		Revision as of 03:14, 1 August 2018
Line 1:		Line 1:
	~~{{FUN-beg}}{{FUN-BOT}}{{ORP-top}}~~		#REDIRECT [[Help:Content_Manager]]
	~~==Content Manager==~~
	~~'''Content Manager''' (abbreviated as '''CM''') is the included content management {{wp\|Graphical user interface\|GUI}} utility for managing assets, uploading and downloading content from the~~ [[Download Station]], and for exporting and importing [[cdp file]]s for archiving or sharing. It has been part of Trainz releases since the debut of [[TRS2006]] (then called Content Manager Plus and '''CMP''') in the fall of 2005, and was the major improvement made to the four service packs that evolved [[TRS2004]]'s advances replacing several separate .exe file modules with a single common user interface to manipulate and manage assets and content. CM includes the ability to archive assets, disable them so they would not appear in Surveyor asset selection APIs and a filter definition and selection system which allowed the Trainz user to fine tune the selections presented in the menuing of the Surveyor module tools APIs.

	~~==Functionality==~~

	~~Content Manager is intended to address the following functions~~:
	* Install and remove custom content.
	* Archive custom content.
	* Search both local and DLS content.
	* Download DLS content.
	* Create and edit custom content.
	* Provide a platform for executing [[Content Manager Tools]].


	~~==Ideology==~~

	Content Manager is designed to allow content creators to produce new content, and to allow end-users to download with a minimal of hassle. It is tightly integrated with the Download Station (DLS) to allow content to be uploaded and downloaded in a reliable fashion.

	~~Content Manager is specifically not intended for users to perform regular editing of content created by others; this behavior is considered fairly counter-productive for the following reasons:~~
	* It is expected that DLS content will be available in a working format, and that Content Manager will transfer the content to the local machine in a working format.
	** This is historically inaccurate, please see the [[Download Station Cleanup]] page. It was found that many legacy content items, had typos, misspellings, and formatting errors of one sort or another that were further linked to Trainz run-time crashes.
	* Trainz software was revised to trap and expose these errors.
	* It is required that local content maintains parity with the original DLS content, such that dependencies and updates continue to work appropriately.
	** By editing DLS content locally, the user is establishing that they will take responsibility for maintaining not only the edited asset, but potentially all assets which share some kind of dependency on the edited asset.
	* When a user downloads or purchases a new item of content, they have a reasonable expectation that it will work "out of the box".
	** This expectation is in direct conflict with the user performing significant edits to other content.
	~~There are some obvious cases where edits are harmless, and CMP attempts to allow for the most useful of these- such as renaming or hiding an asset.~~

	~~==Ramifications-asset validation==~~
	It is expected that the Trainz environment will be optimised and extended with each new version release. To allow existing custom content to work with newer versions of Trainz, N3V has adopted an "installation" process for custom content, in favor of the original "drop it in a folder" process. During this process, the Trainz environment performs the following steps:
	* Validates that the content will work with the current Trainz installation.
	* Precaches various metrics from the content that Trainz requires at runtime such that the entire item of content does not need to be loaded at game startup (as was the case in the earliest Trainz versions.)
	* Upgrades files within the content to the latest file formats, such that the upgrade process does need to not occur during loading.
	* Converts some files from human-readable form to a machine-optimized format.
	* Moves the raw content files to storage within the Trainz Asset Database.
	* Notifies running Trainz executables of any changes.

	~~==Changes since TRS2004==~~
	~~Users are no longer provided with direct access to installed custom content, for the following reasons, but such assets may be cloned under a user kuid code:~~
	* Installed content may be stored in a custom internal format, rather than in the public distribution format.
	* Edits made to files which have supposedly been pre-processed will result in runtime errors where the cached data no longer matches the actual content on disk.

	Since direct access is not possible, Content Manager provides a mechanism for users to 'check out' items for editing, and to check them in again after the edits are complete. (Open for Edit, asset validation, and Committing the asset) The normal installation steps are performed during the check-in process allowing Trainz to use the updated content safely. Trainz will issue a query and warning when installed content has been modified, or as has sometimes happened, imported from an older version of Trainz, then the separate asset (now part of the new release) might be in the situation of overwriting an updated validated version.
	~~{{ORP-bot}}~~

Jamesmoody: Reverted edits by Fabartus (talk) to last revision by Windwalkr

2013-12-10T07:37:35Z

Reverted edits by Fabartus (talk) to last revision by Windwalkr

← Older revision		Revision as of 07:37, 10 December 2013
Line 1:		Line 1:
	{{FUN-beg}}{{FUN-BOT}}{{ORP-top}}		{{FUN-beg}}{{FUN-BOT}}{{ORP-top}}
	~~:'''''Trainz Beginners''' seeking How-To guidance and instruction on running ContentManager should refer to '''[[Help:Content Manager]]'''.''~~
	==Content Manager==		==Content Manager==
	'''Content Manager''' (abbreviated as '''CM''') is the included content management {{wp\|Graphical user interface\|GUI}} utility for managing assets, uploading and downloading content from the [[Download Station]], and for exporting and importing [[cdp file]]s for archiving or sharing. It has been part of Trainz releases since the debut of [[TRS2006]] (then called Content Manager Plus and '''CMP''') in the fall of 2005, and was the major improvement made to the four service packs that evolved [[TRS2004]]'s advances replacing several separate .exe file modules with a single common user interface to manipulate and manage assets and content. CM includes the ability to archive assets, disable them so they would not appear in Surveyor asset selection APIs and a filter definition and selection system which allowed the Trainz user to fine tune the selections presented in the menuing of the Surveyor module tools APIs.		'''Content Manager''' (abbreviated as '''CM''') is the included content management {{wp\|Graphical user interface\|GUI}} utility for managing assets, uploading and downloading content from the [[Download Station]], and for exporting and importing [[cdp file]]s for archiving or sharing. It has been part of Trainz releases since the debut of [[TRS2006]] (then called Content Manager Plus and '''CMP''') in the fall of 2005, and was the major improvement made to the four service packs that evolved [[TRS2004]]'s advances replacing several separate .exe file modules with a single common user interface to manipulate and manage assets and content. CM includes the ability to archive assets, disable them so they would not appear in Surveyor asset selection APIs and a filter definition and selection system which allowed the Trainz user to fine tune the selections presented in the menuing of the Surveyor module tools APIs.

Fabartus: /* Content Manager */ link

2013-12-10T06:00:30Z

Content Manager: link

← Older revision		Revision as of 06:00, 10 December 2013
Line 1:		Line 1:
	{{FUN-beg}}{{FUN-BOT}}{{ORP-top}}		{{FUN-beg}}{{FUN-BOT}}{{ORP-top}}
			:'''''Trainz Beginners''' seeking How-To guidance and instruction on running ContentManager should refer to '''[[Help:Content Manager]]'''.''
	==Content Manager==		==Content Manager==
	'''Content Manager''' (abbreviated as '''CM''') is the included content management {{wp\|Graphical user interface\|GUI}} utility for managing assets, uploading and downloading content from the [[Download Station]], and for exporting and importing [[cdp file]]s for archiving or sharing. It has been part of Trainz releases since the debut of [[TRS2006]] (then called Content Manager Plus and '''CMP''') in the fall of 2005, and was the major improvement made to the four service packs that evolved [[TRS2004]]'s advances replacing several separate .exe file modules with a single common user interface to manipulate and manage assets and content. CM includes the ability to archive assets, disable them so they would not appear in Surveyor asset selection APIs and a filter definition and selection system which allowed the Trainz user to fine tune the selections presented in the menuing of the Surveyor module tools APIs.		'''Content Manager''' (abbreviated as '''CM''') is the included content management {{wp\|Graphical user interface\|GUI}} utility for managing assets, uploading and downloading content from the [[Download Station]], and for exporting and importing [[cdp file]]s for archiving or sharing. It has been part of Trainz releases since the debut of [[TRS2006]] (then called Content Manager Plus and '''CMP''') in the fall of 2005, and was the major improvement made to the four service packs that evolved [[TRS2004]]'s advances replacing several separate .exe file modules with a single common user interface to manipulate and manage assets and content. CM includes the ability to archive assets, disable them so they would not appear in Surveyor asset selection APIs and a filter definition and selection system which allowed the Trainz user to fine tune the selections presented in the menuing of the Surveyor module tools APIs.

Windwalkr: remove some trolling and improve some wording

2013-08-20T00:43:35Z

remove some trolling and improve some wording

← Older revision		Revision as of 00:43, 20 August 2013
Line 1:		Line 1:
	{{FUN-beg}}{{FUN-BOT}}{{ORP-top}}		{{FUN-beg}}{{FUN-BOT}}{{ORP-top}}
	==Content Manager==		==Content Manager==
	'''Content Manager''' ~~or more often~~ '''CM''' is ~~N3V Game's normally~~ included content management {{wp\|Graphical user interface\|GUI}} utility for managing assets, uploading and downloading content ~~via a secure {{wp\|File Transfer Protocol\|FTP server}} link to~~ the [[Download Station]], and for exporting and importing [[cdp file]]s for archiving or sharing. It has been part of Trainz releases since the debut of [[TRS2006]] (then called Content Manager Plus and '''CMP''') in the fall of 2005, and was the major improvement made to the four service packs that evolved [[TRS2004]]'s advances replacing several separate .exe file modules with a single common user interface to manipulate and manage assets and content. ~~CMP/~~CM ~~included~~ the ability to archive assets, disable them so they would not appear in Surveyor asset selection APIs and a filter definition and selection system which allowed the Trainz user to fine tune the selections presented in the menuing of the Surveyor module tools APIs.		'''Content Manager''' (abbreviated as '''CM''') is the included content management {{wp\|Graphical user interface\|GUI}} utility for managing assets, uploading and downloading content from the [[Download Station]], and for exporting and importing [[cdp file]]s for archiving or sharing. It has been part of Trainz releases since the debut of [[TRS2006]] (then called Content Manager Plus and '''CMP''') in the fall of 2005, and was the major improvement made to the four service packs that evolved [[TRS2004]]'s advances replacing several separate .exe file modules with a single common user interface to manipulate and manage assets and content. CM includes the ability to archive assets, disable them so they would not appear in Surveyor asset selection APIs and a filter definition and selection system which allowed the Trainz user to fine tune the selections presented in the menuing of the Surveyor module tools APIs.

	==Functionality==		==Functionality==
Line 21:		Line 21:
	* It is expected that DLS content will be available in a working format, and that Content Manager will transfer the content to the local machine in a working format.		* It is expected that DLS content will be available in a working format, and that Content Manager will transfer the content to the local machine in a working format.
	** This is historically inaccurate, please see the [[Download Station Cleanup]] page. It was found that many legacy content items, had typos, misspellings, and formatting errors of one sort or another that were further linked to Trainz run-time crashes.		** This is historically inaccurate, please see the [[Download Station Cleanup]] page. It was found that many legacy content items, had typos, misspellings, and formatting errors of one sort or another that were further linked to Trainz run-time crashes.
	* Trainz software was revised to trap and expose these errors, but the N3V programmers did not think of the remedy of auto-fixing many of those which in many cases would be more efficacious and have saved the individual users from fixing such content locally as error screening was tightened.		* Trainz software was revised to trap and expose these errors.
	* It is required that local content maintains parity with the original DLS content, such that dependencies and updates continue to work appropriately.		* It is required that local content maintains parity with the original DLS content, such that dependencies and updates continue to work appropriately.
	** By editing DLS content locally, the user is establishing that they will take responsibility for maintaining not only the edited asset, but potentially all assets which share some kind of dependency on the edited asset.		** By editing DLS content locally, the user is establishing that they will take responsibility for maintaining not only the edited asset, but potentially all assets which share some kind of dependency on the edited asset.

Fabartus: tweak

2013-07-26T21:46:40Z

tweak

← Older revision		Revision as of 21:46, 26 July 2013
Line 1:		Line 1:
	{{FUN-beg}}{{FUN-BOT}}{{ORP-top}}		{{FUN-beg}}{{FUN-BOT}}{{ORP-top}}
	==Content Manager==		==Content Manager==
	'''Content Manager''' or more often '''CM''' is N3V Game's normally included content management {{wp\|Graphical user interface\|GUI}} utility for managing assets, uploading and downloading content via a secure {{wp\|FTP server}} link to the [[Download Station]], and for exporting and importing [[cdp file]]s for archiving or sharing. It has been part of Trainz releases since the debut of [[TRS2006]] (then called Content Manager Plus and '''CMP''') in the fall of 2005, and was the major improvement made to the four service packs that evolved [[TRS2004]]'s advances replacing several separate .exe file modules with a single common user interface to manipulate and manage assets and content. CMP/CM included the ability to archive assets, disable them so they would not appear in Surveyor asset selection APIs and a filter definition and selection system which allowed the Trainz user to fine tune the selections presented in the menuing of the Surveyor module tools APIs.		'''Content Manager''' or more often '''CM''' is N3V Game's normally included content management {{wp\|Graphical user interface\|GUI}} utility for managing assets, uploading and downloading content via a secure {{wp\|File Transfer Protocol\|FTP server}} link to the [[Download Station]], and for exporting and importing [[cdp file]]s for archiving or sharing. It has been part of Trainz releases since the debut of [[TRS2006]] (then called Content Manager Plus and '''CMP''') in the fall of 2005, and was the major improvement made to the four service packs that evolved [[TRS2004]]'s advances replacing several separate .exe file modules with a single common user interface to manipulate and manage assets and content. CMP/CM included the ability to archive assets, disable them so they would not appear in Surveyor asset selection APIs and a filter definition and selection system which allowed the Trainz user to fine tune the selections presented in the menuing of the Surveyor module tools APIs.

	==Functionality==		==Functionality==

Fabartus: fmt, new user notes

2013-07-26T21:45:05Z

fmt, new user notes

← Older revision		Revision as of 21:45, 26 July 2013
Line 1:		Line 1:
	Content Manager is N3V's included content management GUI.		{{FUN-beg}}{{FUN-BOT}}{{ORP-top}}
			==Content Manager==
			'''Content Manager''' or more often '''CM''' is N3V Game's normally included content management {{wp\|Graphical user interface\|GUI}} utility for managing assets, uploading and downloading content via a secure {{wp\|FTP server}} link to the [[Download Station]], and for exporting and importing [[cdp file]]s for archiving or sharing. It has been part of Trainz releases since the debut of [[TRS2006]] (then called Content Manager Plus and '''CMP''') in the fall of 2005, and was the major improvement made to the four service packs that evolved [[TRS2004]]'s advances replacing several separate .exe file modules with a single common user interface to manipulate and manage assets and content. CMP/CM included the ability to archive assets, disable them so they would not appear in Surveyor asset selection APIs and a filter definition and selection system which allowed the Trainz user to fine tune the selections presented in the menuing of the Surveyor module tools APIs.

	~~'''~~Functionality~~'''~~		==Functionality==

	Content Manager is intended to address the following functions:		Content Manager is intended to address the following functions:
Line 12:		Line 14:


	~~'''~~Ideology~~'''~~		==Ideology==

	Content Manager is designed to allow content creators to produce new content, and to allow end-users to download with a minimal of hassle. It is tightly integrated with the Download Station (DLS) to allow content to be uploaded and downloaded in a reliable fashion.		Content Manager is designed to allow content creators to produce new content, and to allow end-users to download with a minimal of hassle. It is tightly integrated with the Download Station (DLS) to allow content to be uploaded and downloaded in a reliable fashion.

	Content Manager is specifically not intended for users to perform regular editing of content created by others; this behavior is considered fairly counter-productive for the following reasons:		Content Manager is specifically not intended for users to perform regular editing of content created by others; this behavior is considered fairly counter-productive for the following reasons:
	* It is expected that DLS content will be available in a working format, and that Content Manager will transfer the content to the local machine in a working format. (This is historically inaccurate, please see the [[Download Station Cleanup]] page.)		* It is expected that DLS content will be available in a working format, and that Content Manager will transfer the content to the local machine in a working format.
	* It is required that local content maintains parity with the original DLS content, such that dependencies and updates continue to work appropriately. By editing DLS content locally, the user is establishing that they will take responsibility for maintaining not only the edited asset, but potentially all assets which share some kind of dependency on the edited asset.		** This is historically inaccurate, please see the [[Download Station Cleanup]] page. It was found that many legacy content items, had typos, misspellings, and formatting errors of one sort or another that were further linked to Trainz run-time crashes.
	* When a user downloads or purchases a new item of content, they have a reasonable expectation that it will work "out of the box". This expectation is in direct conflict with the user performing significant edits to other content.		* Trainz software was revised to trap and expose these errors, but the N3V programmers did not think of the remedy of auto-fixing many of those which in many cases would be more efficacious and have saved the individual users from fixing such content locally as error screening was tightened.
			* It is required that local content maintains parity with the original DLS content, such that dependencies and updates continue to work appropriately.
			** By editing DLS content locally, the user is establishing that they will take responsibility for maintaining not only the edited asset, but potentially all assets which share some kind of dependency on the edited asset.
			* When a user downloads or purchases a new item of content, they have a reasonable expectation that it will work "out of the box".
			** This expectation is in direct conflict with the user performing significant edits to other content.
	There are some obvious cases where edits are harmless, and CMP attempts to allow for the most useful of these- such as renaming or hiding an asset.		There are some obvious cases where edits are harmless, and CMP attempts to allow for the most useful of these- such as renaming or hiding an asset.

			==Ramifications-asset validation==
	It is expected that the Trainz environment will be optimised and extended with each new version release. To allow existing custom content to work with newer versions of Trainz, N3V has adopted an "installation" process for custom content, in favor of the original "drop it in a folder" process. During this process, the Trainz environment performs the following steps:		It is expected that the Trainz environment will be optimised and extended with each new version release. To allow existing custom content to work with newer versions of Trainz, N3V has adopted an "installation" process for custom content, in favor of the original "drop it in a folder" process. During this process, the Trainz environment performs the following steps:
	* Validates that the content will work with the current Trainz installation.		* Validates that the content will work with the current Trainz installation.
Line 30:		Line 37:
	* Notifies running Trainz executables of any changes.		* Notifies running Trainz executables of any changes.

	Users are no longer provided with direct access to installed custom content, for the following reasons:		==Changes since TRS2004==
			Users are no longer provided with direct access to installed custom content, for the following reasons, but such assets may be cloned under a user kuid code:
	* Installed content may be stored in a custom internal format, rather than in the public distribution format.		* Installed content may be stored in a custom internal format, rather than in the public distribution format.
	* Edits made to files which have supposedly been pre-processed will result in runtime errors where the cached data no longer matches the actual content on disk.		* Edits made to files which have supposedly been pre-processed will result in runtime errors where the cached data no longer matches the actual content on disk.

	Since direct access is not possible, Content Manager provides a mechanism for users to 'check out' items for editing, and to check them in again after the edits are complete. The normal installation steps are performed during the check-in process allowing Trainz to use the updated content safely.		Since direct access is not possible, Content Manager provides a mechanism for users to 'check out' items for editing, and to check them in again after the edits are complete. (Open for Edit, asset validation, and Committing the asset) The normal installation steps are performed during the check-in process allowing Trainz to use the updated content safely. Trainz will issue a query and warning when installed content has been modified, or as has sometimes happened, imported from an older version of Trainz, then the separate asset (now part of the new release) might be in the situation of overwriting an updated validated version.
			{{ORP-bot}}

Windwalkr at 09:48, 18 October 2010

2010-10-18T09:48:30Z

← Older revision		Revision as of 09:48, 18 October 2010
Line 1:		Line 1:
	Content Manager is ~~Auran~~'s included content management GUI.		Content Manager is N3V's included content management GUI.

	'''Functionality'''		'''Functionality'''
Line 22:		Line 22:
	There are some obvious cases where edits are harmless, and CMP attempts to allow for the most useful of these- such as renaming or hiding an asset.		There are some obvious cases where edits are harmless, and CMP attempts to allow for the most useful of these- such as renaming or hiding an asset.

	It is expected that the Trainz environment will be optimised and extended with each new version release. To allow existing custom content to work with newer versions of Trainz, ~~Auran~~ has adopted an "installation" process for custom content, in favor of the original "drop it in a folder" process. During this process, the Trainz environment performs the following steps:		It is expected that the Trainz environment will be optimised and extended with each new version release. To allow existing custom content to work with newer versions of Trainz, N3V has adopted an "installation" process for custom content, in favor of the original "drop it in a folder" process. During this process, the Trainz environment performs the following steps:
	* Validates that the content will work with the current Trainz installation.		* Validates that the content will work with the current Trainz installation.
	* Precaches various metrics from the content that Trainz requires at runtime such that the entire item of content does not need to be loaded at game startup (as was the case in the earliest Trainz versions.)		* Precaches various metrics from the content that Trainz requires at runtime such that the entire item of content does not need to be loaded at game startup (as was the case in the earliest Trainz versions.)

Windwalkr: 1 revision

2010-02-03T13:58:50Z

1 revision

← Older revision	Revision as of 13:58, 3 February 2010
(No difference)

imported>Dalaid: Ideology, 2nd para first word. Fixed typo "Conent" to "Content".

2009-02-04T16:26:06Z

Ideology, 2nd para first word. Fixed typo "Conent" to "Content".

New page

Content Manager is Auran's included content management GUI.

'''Functionality'''

Content Manager is intended to address the following functions:
* Install and remove custom content.
* Archive custom content.
* Search both local and DLS content.
* Download DLS content.
* Create and edit custom content.
* Provide a platform for executing [[Content Manager Tools]].

'''Ideology'''

Content Manager is designed to allow content creators to produce new content, and to allow end-users to download with a minimal of hassle. It is tightly integrated with the Download Station (DLS) to allow content to be uploaded and downloaded in a reliable fashion.

Content Manager is specifically not intended for users to perform regular editing of content created by others; this behavior is considered fairly counter-productive for the following reasons:
* It is expected that DLS content will be available in a working format, and that Content Manager will transfer the content to the local machine in a working format. (This is historically inaccurate, please see the [[Download Station Cleanup]] page.)
* It is required that local content maintains parity with the original DLS content, such that dependencies and updates continue to work appropriately. By editing DLS content locally, the user is establishing that they will take responsibility for maintaining not only the edited asset, but potentially all assets which share some kind of dependency on the edited asset.
* When a user downloads or purchases a new item of content, they have a reasonable expectation that it will work "out of the box". This expectation is in direct conflict with the user performing significant edits to other content.
There are some obvious cases where edits are harmless, and CMP attempts to allow for the most useful of these- such as renaming or hiding an asset.

It is expected that the Trainz environment will be optimised and extended with each new version release. To allow existing custom content to work with newer versions of Trainz, Auran has adopted an "installation" process for custom content, in favor of the original "drop it in a folder" process. During this process, the Trainz environment performs the following steps:
* Validates that the content will work with the current Trainz installation.
* Precaches various metrics from the content that Trainz requires at runtime such that the entire item of content does not need to be loaded at game startup (as was the case in the earliest Trainz versions.)
* Upgrades files within the content to the latest file formats, such that the upgrade process does need to not occur during loading.
* Converts some files from human-readable form to a machine-optimized format.
* Moves the raw content files to storage within the Trainz Asset Database.
* Notifies running Trainz executables of any changes.

Users are no longer provided with direct access to installed custom content, for the following reasons:
* Installed content may be stored in a custom internal format, rather than in the public distribution format.
* Edits made to files which have supposedly been pre-processed will result in runtime errors where the cached data no longer matches the actual content on disk.

Since direct access is not possible, Content Manager provides a mechanism for users to 'check out' items for editing, and to check them in again after the edits are complete. The normal installation steps are performed during the check-in process allowing Trainz to use the updated content safely.