CCG/Kind Examples

From TrainzOnline
< CCG(Difference between revisions)
Jump to: navigation, search
 
(10 intermediate revisions by one user not shown)
Line 4: Line 4:
  
  
Examples:
+
===Examples===
 
+
 
The test examples are taken from the models built into TC, primarily those developed by Auran, not supplied by Third Party Creators. As such, many are older models, and the config.txt files have been updated by Content Creator Plus. The example files are available for download, and they include the config.txt files and the textures, but not the 3dsmax or gmax meshes, as these were not available in many instances.
 
The test examples are taken from the models built into TC, primarily those developed by Auran, not supplied by Third Party Creators. As such, many are older models, and the config.txt files have been updated by Content Creator Plus. The example files are available for download, and they include the config.txt files and the textures, but not the 3dsmax or gmax meshes, as these were not available in many instances.
  
 
Some of the models are relatively simple, and do not show or use all of the container and tag options available for that particular Kind. The config.txt file is displayed in this chapter to show the typical containers used and the type of data that is entered for the tags.
 
Some of the models are relatively simple, and do not show or use all of the container and tag options available for that particular Kind. The config.txt file is displayed in this chapter to show the typical containers used and the type of data that is entered for the tags.
  
Please Note: The actual working config,txt file requires and includes brackets to separate containers and tags. These are not shown in the config.txt in this chapter for clarity and brevity. Please refer to the actual example config.txt file for full working files.
+
'''Please Note:''' Contrary to the original Content Creator's Guide for TC, the listings for config.txt files contain all necessay braces (curly brackets "{" and "}"). It's important to understand the relationship of containers and their tags.
  
  
  
Additional Examples:
+
===Additional Examples===
 
+
 
Additional examples are available for download, please refer to the earlier Content Creation Guide for TRS2004, for the download links. Many of these files include the mesh files. Examples are included on the Content Creation Art Source CD's available for purchase from the Auran website. All these earlier assets were developed for Trainz versions prior to the use of Content Creation Plus.
 
Additional examples are available for download, please refer to the earlier Content Creation Guide for TRS2004, for the download links. Many of these files include the mesh files. Examples are included on the Content Creation Art Source CD's available for purchase from the Auran website. All these earlier assets were developed for Trainz versions prior to the use of Content Creation Plus.
  
  
  
Models in TC:
+
===Models in TC===
 +
Most model asset files may be opened in Content Creator Plus using the option "Open in Content Creator Plus", or an asset may be cloned to make a new model. Some files provided by Third Party Creators are not available for modification or viewing, the privileges tag options have been used to prevent access, to protect the creators' assets. This option was only available for supplied assets built in to TC. It is not available for new creations uploaded to the Download Station. 
  
Most model asset files may be opened in Content Creator Plus using the option "Open in Explorer", or an asset may be cloned to make a new model. Some files provided by Third Party Creators are not available for modification or viewing, the privileges tag options have been used to prevent access, to protect the creators' assets. This option was only available for supplied assets built in to TC. It is not available for new creations uploaded to the Download Station.
+
'''Please Note:''' that assets opened in Content Creator Plus will be updated to the host version of Trainz.
  
 
For those accessible assets, the config.txt and texture files are then available. The texture files however are compiled with the texture.txt file and are not directly available for modification. For example, a file may be called black.texture without a.txt extension and is know as a Trainz file. It is not a plain text file.
 
For those accessible assets, the config.txt and texture files are then available. The texture files however are compiled with the texture.txt file and are not directly available for modification. For example, a file may be called black.texture without a.txt extension and is know as a Trainz file. It is not a plain text file.
  
A cloned asset will use the compiled texture files correctly, as specified in the original exported asset mesh files, however if you wish to modify the texture, the original graphics file needs to be recovered. The file may be extracted using the program TGATool2 available for download from: file:///C:/CCG%20Project/Downloads/mwgfx.htm
+
A cloned asset will use the compiled texture files correctly, as specified in the original exported asset mesh files, however if you wish to modify the texture, the original graphics file needs to be recovered. The file may be extracted using the program Images2TGA available for download from [http://www.members.optusnet.com.au/~villaump/pevsoft.htm here]. It will open all texture and image files used in the latest versions of Trainz.
:Please Note that TGATool no longer works for textures in TS2009 onwards. Images2TGA from here will open all texture and image files used in the latest versions of Trainz.
+
 
+
Modifying Texture Files:
+
  
 +
===Modifying Texture Files===
 
After installing the program, configure it to refer to an external graphic editor, such as Paint Shop Pro or Photoshop, using the Preferences .... Select Editing Program option.
 
After installing the program, configure it to refer to an external graphic editor, such as Paint Shop Pro or Photoshop, using the Preferences .... Select Editing Program option.
  
Line 72: Line 69:
 
Mote: Do not change the name of the texture file from the original, for example make black.texture become blacknew.texture.txt. The exported .im files have the material name "black" encapsulated in the file, and will look for a matching black.texture or black.texture.txt file in the asset. You can however change the actual graphic file names and refer to them correctly in the text of the .texture.txt file.
 
Mote: Do not change the name of the texture file from the original, for example make black.texture become blacknew.texture.txt. The exported .im files have the material name "black" encapsulated in the file, and will look for a matching black.texture or black.texture.txt file in the asset. You can however change the actual graphic file names and refer to them correctly in the text of the .texture.txt file.
  
Requirements:
 
  
 +
===Requirements===
 
There are some conditions of use of modified or cloned in-built assets.
 
There are some conditions of use of modified or cloned in-built assets.
  
Line 82: Line 79:
 
Additionally, for assets using or based on in-built assets provided by a Third Party Creator, you must have permission from the creator of the original asset, before sharing or uploading any files.
 
Additionally, for assets using or based on in-built assets provided by a Third Party Creator, you must have permission from the creator of the original asset, before sharing or uploading any files.
  
Examples for the following Kinds are included in this chapter:
+
 
 +
==Examples for the following Kinds are included in this chapter==
 +
 
 +
<table width="100%" border="2" cellspacing="0" cellpadding="10">
 +
<tr>
 +
<td width="30%" valign="top">
  
 
●      [[CCG/Example: Activity|Activity]]
 
●      [[CCG/Example: Activity|Activity]]
Line 110: Line 112:
 
●      [[CCG/Example: Engine (Electric)|Engine (Electric)]]
 
●      [[CCG/Example: Engine (Electric)|Engine (Electric)]]
  
●      [[CCG/Example: Engine (Diesel\Electric)|Engine (Diesel\Electric)]]
+
●      [[CCG/Example: EngineSound (Diesel\Electric)|EngineSound (Diesel\Electric)]]
  
●      [[CCG/Example: Engine (Steam)|Engine (Steam)]]
+
●      [[CCG/Example: EngineSound (Steam)|EngineSound (Steam)]]
 
+
●      [[CCG/Example: EngineSound|EngineSound]]
+
  
 
●      [[CCG/Example: Environment|Environment]]
 
●      [[CCG/Example: Environment|Environment]]
Line 122: Line 122:
 
●      [[CCG/Example: Fixed Track (Junction)|Fixed Track (Junction)]]
 
●      [[CCG/Example: Fixed Track (Junction)|Fixed Track (Junction)]]
  
●      [[CCG/Example: GroundTexture (Normal)|GroundTexture (Normal)]]
+
●      [[CCG/Example: GroundTexture|GroundTexture]]
  
 
●      [[CCG/Example: GroundTexture (Clutter Mesh)|GroundTexture (Clutter Mesh)]]
 
●      [[CCG/Example: GroundTexture (Clutter Mesh)|GroundTexture (Clutter Mesh)]]
Line 131: Line 131:
  
 
●      [[CCG/Example: HornSound (3 Part)|HornSound (3 Part)]]
 
●      [[CCG/Example: HornSound (3 Part)|HornSound (3 Part)]]
 +
 +
</td>
 +
<td width="30%" valign="top">
  
 
●      [[CCG/Example: Html-Asset|Html-Asset]]
 
●      [[CCG/Example: Html-Asset|Html-Asset]]
Line 177: Line 180:
  
 
●      [[CCG/Example: Product (Passenger Product)|Product (Passenger Product)]]
 
●      [[CCG/Example: Product (Passenger Product)|Product (Passenger Product)]]
 +
 +
</td>
 +
<td width="30%" valign="top">
  
 
●      [[CCG/Example: Product-Category|Product-Category]]
 
●      [[CCG/Example: Product-Category|Product-Category]]
Line 215: Line 221:
  
 
●      [[CCG/Example: Water2|Water2]]
 
●      [[CCG/Example: Water2|Water2]]
 +
 +
●      [[CCG/Example: Displacements|Displacements]]
 +
 +
</td></tr></table>
 +
 +
 +
 +
==Return to CCG Index==
 +
[[Content Creator's Guide]]

Latest revision as of 17:48, 13 June 2011

Contents

[edit] Kind Examples

The purpose of this chapter is to provide real example Assets to show the use of the various Containers and Tag in all the Kinds that are included in Trainz. Please refer to Chapter 6 for a complete description of the Containers and Tags used, and new functions in Appendix D.


[edit] Examples

The test examples are taken from the models built into TC, primarily those developed by Auran, not supplied by Third Party Creators. As such, many are older models, and the config.txt files have been updated by Content Creator Plus. The example files are available for download, and they include the config.txt files and the textures, but not the 3dsmax or gmax meshes, as these were not available in many instances.

Some of the models are relatively simple, and do not show or use all of the container and tag options available for that particular Kind. The config.txt file is displayed in this chapter to show the typical containers used and the type of data that is entered for the tags.

Please Note: Contrary to the original Content Creator's Guide for TC, the listings for config.txt files contain all necessay braces (curly brackets "{" and "}"). It's important to understand the relationship of containers and their tags.


[edit] Additional Examples

Additional examples are available for download, please refer to the earlier Content Creation Guide for TRS2004, for the download links. Many of these files include the mesh files. Examples are included on the Content Creation Art Source CD's available for purchase from the Auran website. All these earlier assets were developed for Trainz versions prior to the use of Content Creation Plus.


[edit] Models in TC

Most model asset files may be opened in Content Creator Plus using the option "Open in Content Creator Plus", or an asset may be cloned to make a new model. Some files provided by Third Party Creators are not available for modification or viewing, the privileges tag options have been used to prevent access, to protect the creators' assets. This option was only available for supplied assets built in to TC. It is not available for new creations uploaded to the Download Station.

Please Note: that assets opened in Content Creator Plus will be updated to the host version of Trainz.

For those accessible assets, the config.txt and texture files are then available. The texture files however are compiled with the texture.txt file and are not directly available for modification. For example, a file may be called black.texture without a.txt extension and is know as a Trainz file. It is not a plain text file.

A cloned asset will use the compiled texture files correctly, as specified in the original exported asset mesh files, however if you wish to modify the texture, the original graphics file needs to be recovered. The file may be extracted using the program Images2TGA available for download from here. It will open all texture and image files used in the latest versions of Trainz.

[edit] Modifying Texture Files

After installing the program, configure it to refer to an external graphic editor, such as Paint Shop Pro or Photoshop, using the Preferences .... Select Editing Program option.

Open the asset in Explorer in Content Creator Plus so the texture files may be accessed. In TgaTools2, Load the appropriate map.texture file, as a "Trainz" file. It will display the original graphic file, and also any Alpha channel or opacity map in a panel to the right of the editor. The original text included in the file is unrecoverable.

Save the file as black.tga for example, and the saved file will include any Alpha channel for transparency or opacity, as used in the original asset.

If you wish to make the Alpha channel a separate .bmp file, use the program option Image .... Send Alpha Channel to Editor (PSP or Photoshop you configured earlier). This allows you to save the Alpha channel as a separate .bmp file, from your editor.

Modify the graphic texture files (.tga or .bmp) as required. Note that any separate opacity .bmp file must be the same pixel sizes as the main texture .tga file.

In your cloned or modified asset, type a new black.texture.txt file to refer to the extracted image or images. Make sure you delete the original .texture file when you have made a new .texture.txt file.

Consider the original .texture filename, the name indicates if the texture was a simple .tga file, a .tga file with an Alpha channel, or a .tga file the also uses a separate Alpha or opacity .bmp file, for example:

1. black.texture - this is a texture using only a black.tga file for the asset. Create a new text file with the following entries, and save it with the name black.texture.txt

 Primary=black.tga
 Tile=none

2. black-black.texture - this is a texture using a black.tga file and either includes an alpha channel in the same file, or refers to a separate black.bmp file for the Alpha channel or opacity map. Because the names are the same, it is impossible to determine which option was used by the original creator. Either of the following options will work in the cloned asset:

If you have saved the original file as a .tga file with the included alpha channel in that file, create a new text file with the following entries, and save it with the name black-black.texture.txt

 Primary=black.tga
 Alpha=black.tga
 Tile=none

If you have saved the original file as a .tga file with the alpha channel as a separate .bmp file, from your graphic editor, create a new text file with the following entries, and save it with the name black-black.texture.txt

 Primary=black.tga
 Alpha=black.bmp
 Tile=none

3. black-black_op.texture - this is a texture using a black.tga file and refers to a separate black_op.bmp file for the Alpha channel or opacity map. Create a new text file with the following entries, and save it with the name black-black_op.texture.txt

 Primary=black.tga
 Alpha=black_op.bmp
 Tile=none

Mote: Do not change the name of the texture file from the original, for example make black.texture become blacknew.texture.txt. The exported .im files have the material name "black" encapsulated in the file, and will look for a matching black.texture or black.texture.txt file in the asset. You can however change the actual graphic file names and refer to them correctly in the text of the .texture.txt file.


[edit] Requirements

There are some conditions of use of modified or cloned in-built assets.

You may freely use the files from TC to make new models, or modify textures for your own purposes, for personal use, on your own computer.

If you wish to share the new or modified models with others, the following conditions apply - for all assets, they are to be uploaded to, and made available from, the Auran Download Station, as a condition of use. This was a condition of use for the original Content Creation Art Source files.

Additionally, for assets using or based on in-built assets provided by a Third Party Creator, you must have permission from the creator of the original asset, before sharing or uploading any files.


[edit] Examples for the following Kinds are included in this chapter

Activity

Behavior

Bogey

Bogey (Animated Bogey)

Bogey (Steam Bogey)

Bridge

Buildable

Chunky-Track

Double-Track

DriverCharacter

DriverCommand

Engine (Diesel)

Engine (Electric)

EngineSound (Diesel\Electric)

EngineSound (Steam)

Environment

Fixed Track (Simple)

Fixed Track (Junction)

GroundTexture

GroundTexture (Clutter Mesh)

HornSound (1 Part)

HornSound (2 Part)

HornSound (3 Part)

Html-Asset

Industry (Multiple Industry)

Industry (Coal Mine)

Interior (Diesel)

Interior Electric)

Interior (Steam)

Library

Map

Mesh

Mesh-Reducing-Track

MOCrossing

MOJunction

MOSignal

MOSpeedBoard

Pantograph

Paintshed-Template

Paintshed-Template

Product (Coal Product)

Product (General Goods Product)

Product (Diesel Fuel Product)

Product (40Ft Container Product)

Product (Lumber Product)

Product (Passenger Product)

Product-Category

Profile

Scenery

Scenery-Trackside

Steam-Engine

Texture

Texture-Group

Track

TrackSound

TrainCar (Coal Hopper)

TrainCar (Diesel Engine)

TrainCar (Electric Engine)

TrainCar (Rollingstock)

TrainCar (Passenger Car)

TrainCar (Steam Engine)

Tunnel

TurnTable (Animated)

TurnTable (Not Animated)

Water2

Displacements


[edit] Return to CCG Index

Content Creator's Guide

Personal tools