Pev: kind industry fixed in sample

2012-11-10T06:32:21Z

kind industry fixed in sample

← Older revision		Revision as of 06:32, 10 November 2012
Line 15:		Line 15:

	A TYPICAL ASSET OF THIS KIND MAY HAVE THE FOLLOWING TAGS:		A TYPICAL ASSET OF THIS KIND MAY HAVE THE FOLLOWING TAGS:
	<font color="red">industry</font>
			<font color="red">kind ''"industry"''</font>
	kuid ''kuid''		kuid ''kuid''
	trainz-build ''data''		trainz-build ''data''

Pev: New page: ==KIND: INDUSTRY== ===Description=== A scenery asset with product processing functionality.Industry assets interact with compatible rolling stock assets through their script file and ass...

2011-06-07T01:11:41Z

New page: ==KIND: INDUSTRY== ===Description=== A scenery asset with product processing functionality.Industry assets interact with compatible rolling stock assets through their script file and ass...

New page

==KIND: INDUSTRY==

===Description===

A scenery asset with product processing functionality.Industry assets interact with compatible rolling stock assets through their script file and asset triggers. An Industry asset supports product queues and attached track.

===Container Structure===

A well formed industry kind has the following container structure:

[[Image:CCG_industry_dir.jpg]]

See Chapter 7 for an example asset of this kind.

A TYPICAL ASSET OF THIS KIND MAY HAVE THE FOLLOWING TAGS:
industry

kuid ''kuid''
trainz-build ''data''
category-class ''data''
category-region ''data''
category-era ''data''
username ''data''
kind ''data''
script ''file''
preview-mesh-kuid ''kuid''
icon0 ''kuid''
kuid-table
coal ''kuid''
mesh-table
default
mesh ''file''
auto-create ''data''
attached-track
out_track0
track ''kuid''
vertices
0 ''data''
attached-trigger
trig0
att ''data''
radius ''data''
queues
20ft_cont_q
size ''data''
initial-count ''data''
product-kuid ''kuid''
allowed-products
0 ''kuid''
processes
multi_consumer_producer
start-enabled ''data''
duration ''data''
inputs
0
amount ''data''
queue ''data''
outputs
0
amount ''data''
queue ''data''
string-table
multi_pickupdropoff ''data''
thumbnails
0
image ''file''
width ''data''
height ''data''
1
image ''file''
width ''data''
height ''data''

===TAGS AND CONTAINERS===
The following tags are further defined in Chapter 5:

;kuid
:Generated automatically br [[Content Manager]].

;trainz-build
:Automatically set to 2.9 for 2009 assets.

;category-class
:Should be one of the following:
: "BIN" - Industry asset with product processing functionality,
: "BPF" - Passenger Station with passenger processing functionality,
: "BPN" - Passenger Station (non-functional),
: "BB" - Buildable (Kind Buildable)
:See the "Buildings & Structures" section [[Category Class]].

;category-region
:See [[Category Region]] for a list of valid category-region values.

;category-era
:See [[Category Era]] for a list of valid category-era values.

;username
:Asset username. This will be the name that appears in the surveyor menu.

;kind
:Must be "industry".

;class
:The name of the scenario class within the script file.

;script
:The script file (gs or gse file).

;icon0
:Kuid of the preview icon. Should be a 32x32 tga.

;preview-mesh-kuid
:The mesh to be used in the surveyor preview area. This is useful when an asset has a large bounding box. i.e. the "Airport" with it's jet animation.

;mesh-table
:Default - Contains the default mesh. Auto-create should be set to true in order to make the mesh visible.

;string-table
:The string table stores a list of text strings to be used by the industry script.

;kuid-table
:The kuid of the track\road used in the asset should be present here, as should those of any other referenced assets.

===Additional Containers===
As well as containing all of the common tags and containers detailed in Chapter 5 , the industry kind also contains additional containers and tags that are specialised to the requirements of the kind.

====Attached Track Container====
Auto-generated spline track. Generated through attachment points located within the default mesh. Attached-tracks update automatically to the spline track connected to it. You may over-ride this auto-update feature by adding useadjoiningtracktype 0

Note. Correct track end attachment orientation is essential. The '''Y''' axis must point 'out' at the correct angle. The Z axis must point 'up' see Page 75.

The '''Attached Track''' Container has the following tags and containers:

;track
:Kuid of the track to be used.

;useadjoiningtracktype
:Indicates whether the track type should change to match that of the first track joined to the object.

;vertex
:Attachment points at which to place track.

====Attached Trigger Container====

A Trigger is a point along an attached track with a specified radius. When a compatible rollingstock item enters this radius it triggers a set of commands, controlled through its script. A trigger is setup in an industries config.txt.

The '''Attached Trigger''' Container has the following tags:

;att
:The attachment point (located in the mesh file) to place the trigger.

;radius
:Radius (in metres) of the trigger.

;track
:The track name which the train must be on to trigger.

====Consists Container====
The consists tag stores information on consists that can be generated by the industry.

The '''Consists Container''' has the following Tags:

;show-in-consist-menu
Boolean flag that dictates whether this train appears in the consist menu (0 - false, 1 - true). The consist menu was along the bottom of the screen in the original Trainz and UTC but is no longer present. It effectively stopped a user from getting access to an AI train. Redundant for most uses except for legacy/scenario usage.

;coupling-mask
:Coupling mask that applies to the consist. 0 will block off all coupling activity while "1" will mean you can couple with a vehicle.

;decoupling-mask
:Decoupling mask that applies to the consist. 0 will mean you can't decouple vehicles in the train while 1 means you can decouple vehicles.

=====Consist Element(Consist subcontainer)=====

;vehicle
:The kuid of the vehicle to be used.

;facing
:Indicates the direction of the vehicle.

;running-number
:Running number of the vehicle.

====Processes Container====
Processes - The input and output settings of the industry. You can specify the amount of input and output for each queue referenced product as well as the duration (or rate) in seconds for that process to take place.

All queues and processes are linked through the industry asset's script file.

The '''Processes Container''' has the following tags and containers:

;start-enabled
:Specifies whether the process starts enabled.

;duration
:Length of time (in seconds) that the process runs for.

=====Inputs Container (Processes subcontainer)=====

;amount
:Amount required as input.

;queue
:queue from which to take input.

=====Outputs Container(Processes subcontainer)=====

;amount
:Amount to output.

;queue
:queue in which to place output.

====Queue Container====

;size
:Size of queue.

;animated-mesh
:Animated mesh which changes as the queue becomes full.

;initial-count
:The initial number of items in the queue.

;product-kuid
:The product type used to fill `initial-count'

;allowed products
:The allowed products in this queue.

;conflicts-with-queues
:This queue and the conflicting queue(s) cannot be used simultaneously.

;attachment-points
:List of attachment points for this queue on which products are visualised. (Use this, OR animated-mesh)

;allowed-categories
:The allowed product categories in this queue.

;Notes

Perhaps the simplest examples of industry functionality are the TRS released Coalmine and the Powerstation assets.

When the coal hopper enters the trigger radius of the coalmine loading bay, it's script interacts with the hoppers own script. Particle effects (pfx) from the coalmine visually display the coal entering the hopper and the hopper animated load rises to show it's full state. The coalmine's own animated load pile reduces as does its commodity level.

Similarly, when the full hopper enters the Powerstation trigger radius, the hopper's animated load lowers, the side doors open and the pfx on the hopper itself initiate. The animated load on the Powerstation increases and it's commodity level increases.

The hopper pfx, and the animated doors are both controlled by the hopper.gs script file.

Sounds events and generic events can be linked to animation key-frame to give great control over sound and script timing for industry and scenery assets.

The increasing use of scripts in TRS adds flexibility and control to assets and their functionality.

===THIS KIND SUPPORTS THE FOLLOWING:===

;CONTAINERS
:queues Container, Smoke Container, SoundScript Container, Mesh Table, Attached Track Container, Attached Trigger Container, String Table, Chinese String Table, Czech String Table, Dutch String Table, French String Table, German String Table, Italian String Table, Polish String Table, Russian String Table, Spanish String Table, KUID Table, Obsolete Table, Thumbnails, Privileges, Extensions, Processes Container, Consists Container.

;TAGS
:kuid, trainz-build, category-class, category-region, category-era, username, kind, alias, author, autoname, category-keyword, class, contact-email, contact-website, description, description-cn, description-cz, description-de, description-es, description-fr, description-it, descriptionpl, description-nl, description-ru, dighole, floating, height-range, icon-texture, icon0, icon1, icon2, icon3, license, light, nightmode, organisation, passenger-height, preview-mesh-kuid, preview-scale, rgb, rollstep, rotate, rotate-yz-range, rotstep, script, snapgrid, snapmod surveyor-name-label, surveyor-only, username-cn, username-cz, username-de, username-es, username-fr, username-it, username-nl, username-pl, username-ru.

==Return to CCG Index==
[[Content Creator's Guide]]

CCG/Industry - Revision history

Pev: kind industry fixed in sample

Pev: New page: ==KIND: INDUSTRY== ===Description=== A scenery asset with product processing functionality.Industry assets interact with compatible rolling stock assets through their script file and ass...