Revision as of 09:29, 4 December 2017 (view source) N3vpolsen (Talk | contribs) ← Older edit		Revision as of 12:58, 4 December 2017 (view source) N3vpolsen (Talk | contribs) Newer edit →
Line 3:		Line 3:
	=Configuration=		=Configuration=
		+
		+	== Effect Layer Window ==
		+
		+	The Effect Layers window allows you to edit your effect properties. The UI in this window will change based on what effect you choose (clutter, turf, something else).
		+
	[[file:turfeffectlayerwindow.jpg]]		[[file:turfeffectlayerwindow.jpg]]
		+
		+
		+	=== Select ===
		+
		+	This allows you to select any existing effect layers to view and edit their parameters.
		+
		+	[[File:turfeffectlayerselection.jpg]]
		+
		+
		+
		+	=== Delete ===
		+
		+	This button will delete the currently selected effect layer.
		+
		+	[[File:effectlayerwindow1b.jpg]]
		+
		+
		+
		+	=== Add ===
		+
		+	This button will allow you to create a new effect layer.
		+
		+	[[File:effectlayerwindow1c.jpg]]
		+
		+
		+
		+	=== Name ===
		+
		+	Enter a name for your effect layer.
		+
		+	[[File:turfeffectlayername.jpg]]
		+
		+
		+
		+	=== Turffx-Asset ===
		+
		+	This is where you select one asset to be generated for your turffx layer. Select an asset you want used in your turffx layer from the dropdown list.
		+
		+	[[File:turfeffectlayerasset.jpg]]
		+
		+
		+
		+	=== Turffx-Density Data Binding ===
		+
		+	The "turffx-density" options and associated "constant" value control the [[Effect Layer Data Binding]] (read this link for details) which controls the density of this turffx layer across the route. Density ranges from 0.0 (no turf present) to 1.0 (maximum density).
		+
		+	[[File:turfeffectlayerdensity.jpg]]
		+
		+	[[File:turfeffectlayerdensitydefaultvalue.jpg]]
		+
		+
		+
		+	=== Turffx-Height-Scale Data Binding ===
		+
		+	The "turffx-height-scale" options and associated "constant" value control the [[Effect Layer Data Binding]] (read this link for details) which controls the height of this turffx layer across the route. Height ranges from 0.0 (no turf present) to 1.0 (maximum height).
		+
		+	[[File:turfeffectlayerheightscale.jpg]]
		+
		+	[[File:turfeffectlayerheightscaledefaultvalue.jpg]]
		+
		+
		+
		+	=== Geometry-Scale ===
		+
		+	TBD
		+
		+	[[File:turfeffectlayergeometryscale.jpg]]
		+
		+
		+
		+	=== Blade-Width ===
		+
		+	TBD
		+
		+	[[File:turfeffectlayerbladewidth.jpg]]
		+
		+
		+
		+	=== Blade-Width-Noise ===
		+
		+	TBD
		+
		+	[[File:turfeffectlayerbladewidthnoise.jpg]]
		+
		+
		+
		+	=== Blade-Height-Noise ===
		+
		+	TBD
		+
		+	[[File:turfeffectlayerbladeheight.jpg]]
		+
		+
		+
		+	=== Width-Scale-Near ===
		+
		+	TBD
		+
		+	[[File:turfeffectlayerwidthscalenear.jpg]]
		+
		+
		+
		+	=== Width-Scale-Far ===
		+
		+	TBD
		+
		+	[[File:turfeffectlayerwidthscalefar.jpg]]
		+
		+
		+
		+	=== Bending-Scale ===
		+
		+	TBD
		+
		+	[[File:turfeffectlayerbendingscale.jpg]]
		+
		+
		+
		+	=== Dispersal ===
		+
		+	TBD
		+
		+	[[File:turfeffectlayerdispersal.jpg]]
		+
		+
		+
		+	=== Bunching ===
		+
		+	TBD
		+
		+	[[File:turfeffectlayerbunching.jpg]]
		+
		+
		+
		+
		+	== Painting Clutter ==
		+
		+
		+	[[File:paintingeffectlayers1.jpg]]
		+

---

Revision as of 12:58, 4 December 2017

The TurfFX Effect Layer is an Effect Layer type which is used to render grass (and similar foliage). As with all effect layers, turf is painted onto the terrain and automatically generates appropriate geometry for the area surrounding the camera. As compared to the Clutter Effect Layer, TurfFX offers less flexibility but substantial improvements to performance which in turn allows for greater density at greater draw distances and effective wind-synchronised animation.

Contents 1 Configuration 1.1 Effect Layer Window 1.1.1 Select 1.1.2 Delete 1.1.3 Add 1.1.4 Name 1.1.5 Turffx-Asset 1.1.6 Turffx-Density Data Binding 1.1.7 Turffx-Height-Scale Data Binding 1.1.8 Geometry-Scale 1.1.9 Blade-Width 1.1.10 Blade-Width-Noise 1.1.11 Blade-Height-Noise 1.1.12 Width-Scale-Near 1.1.13 Width-Scale-Far 1.1.14 Bending-Scale 1.1.15 Dispersal 1.1.16 Bunching 1.2 Painting Clutter 2 Example Usage 3 Asset Creation 3.1 Asset Parameters 3.1.1 SHAPE 3.1.2 CURVE 3.1.3 OFFSET 3.1.4 TESSELLATION 3.1.5 DISPERSAL 3.1.6 BUNCHING 3.1.7 DENSITY 3.1.8 COLOUR TINTING 3.1.9 FINAL TWEAKING 4 Hardware Limitations

Configuration

Effect Layer Window

The Effect Layers window allows you to edit your effect properties. The UI in this window will change based on what effect you choose (clutter, turf, something else).

Select

This allows you to select any existing effect layers to view and edit their parameters.

Delete

This button will delete the currently selected effect layer.

Add

This button will allow you to create a new effect layer.

Name

Enter a name for your effect layer.

Turffx-Asset

This is where you select one asset to be generated for your turffx layer. Select an asset you want used in your turffx layer from the dropdown list.

Turffx-Density Data Binding

The "turffx-density" options and associated "constant" value control the Effect Layer Data Binding (read this link for details) which controls the density of this turffx layer across the route. Density ranges from 0.0 (no turf present) to 1.0 (maximum density).

Turffx-Height-Scale Data Binding

The "turffx-height-scale" options and associated "constant" value control the Effect Layer Data Binding (read this link for details) which controls the height of this turffx layer across the route. Height ranges from 0.0 (no turf present) to 1.0 (maximum height).

Geometry-Scale

TBD

Blade-Width

TBD

Blade-Width-Noise

TBD

Blade-Height-Noise

TBD

Width-Scale-Near

TBD

Width-Scale-Far

TBD

Bending-Scale

TBD

Dispersal

TBD

Bunching

TBD

Painting Clutter

Example Usage

Asset Creation

Asset Parameters

TurfFx is made up of individual polygon blades with many options to configure each blade in your Turf Effect Layer and within the asset itself.

SHAPE

Determine the shape of your blade:

CURVE

Adjust the curve of your blades based on 2 or 3 control points:

OFFSET

Set whether your blade needs edge offsets:

TESSELLATION

Determine the tessellation of your blades:

DISPERSAL

Adjust the dispersal of your blades:

BUNCHING

Adjust how blades bunch together:

DENSITY

Set the number of seeds to plant which controls the overall density:

COLOUR TINTING

Determine which parts of the blade to colour blend to match the ground texture:

FINAL TWEAKING

In addition to the adjustments above, you can also tweak the height, width, bending-scale for wind animation and many more parameters to create all different sorts of grass and grass-like ground cover.

Hardware Limitations

As an NVIDIA-provided visual effect, there are some hardware requirements and limitations which apply to TurfFX.

1. TurfFX is currently supported only for Windows.

2. TurfFX requires a GPU with substantial amounts of VRAM. Whereas Trainz will typically run (albeit slowly, or at reduced settings) on below-spec computers, TurfFX may need to be disabled entirely if the GPU is insufficient.

Trainz offers a fallback mode which effectively replaces the TurfFX layer with an equivalent Clutter layer. This results in a weaker but still acceptable overall visual result. Alternatively, the user may opt to disable TurfFX entirely, in which case the TurfFX Effect Layers become invisible.