Difference between revisions of "Main Page"

From Terragen Documentation from Planetside Software
Jump to: navigation, search
(Link directly to Terragen 4 Global Illumination instead of Terragen 2)
m (Added Terragen RPC: Time of Day Example Script to the Guides section.)
 
(33 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
== Welcome to the Planetside Software Wiki ==
 
== Welcome to the Planetside Software Wiki ==
  
'''This is the primary source of documentation on Planetside Software's Terragen environment modeling and rendering products, including [[Terragen 4]] and [[Terragen Classic]] (deprecated).'''
+
This is the primary documentation repository for Planetside Software's Terragen environment modeling and rendering product. This documentation refers primarily to the latest version of Terragen (currently Terragen 4). Whenever the general term "Terragen" is used, it is referring to this most recent version, unless otherwise specified, e.g. "Terragen Classic".
  
<u>Please note: this documentation refers primarily to the latest version of Terragen (currently Terragen 4). Whenever the general term "Terragen" is used, it is referring to this most recent version, unless otherwise specified, e.g. "Terragen Classic".</u>
+
This wiki contains official information as well as community-written content. Official documentation is clearly delineated from user contributed information by section below. We hope you find this to be a valuable resource and we encourage you to contact us if you'd like to contribute in the community-generated areas.
  
This wiki contains official information as well as community-written content. Official documentation is clearly delineated from user contributed information by section below. We hope you find this to be a valuable resource and we encourage you to contribute any information you can in the community-generated areas. For help on how to use and contribute to a Wiki system, check the [[Help:Contents|Help]] section.
+
If you are a licensed user of Terragen and you need direct support, you can contact us via [https://planetside.co.uk/contact-us/ our contact page].
 +
 
 +
== Video Tutorials and Other Learning Resources ==
 +
 
 +
While the documentation below is the most comprehensive source of specific information about Terragen, many people find it easier to learn through video tutorials. There are links to several high quality, free tutorial channels on the [https://planetside.co.uk/terragen-tutorials/ Terragen Tutorials page] of our website. We recommend the [https://planetside.co.uk/terragen-terratuts-tutorials/ TerraTuts tutorials] for quickly learning Terragen basics.
 +
 
 +
You can also find some helpful techniques and in-depth discussions of specific technical issues on the [https://planetside.co.uk/category/tips-tricks/ Tips and Tricks] page. Check back regularly for new articles.
 +
 
 +
== Fundamental Terragen Concepts ==
 +
 
 +
Articles in this section cover concepts fundamental to understanding and using Terragen.
 +
 
 +
[[What is Terragen?]]<br />
 +
An explanation of Terragen's design and purpose.
  
If you are a licensed user of Terragen and you need direct support, you can contact us via [https://planetside.co.uk/contact-us/ our contact page].
+
[[Terragen Conventions]]<br />
 +
Some conventions of Terragen and how it differs from other 3D graphics programs.
 +
 
 +
[[Nodes]]<br />
 +
Nodes are the fundamental building blocks of a Terragen scene. Learn more about how they work and are represented in the UI.
 +
 
 +
[[Shaders]]<br />
 +
Shaders provide color and texture for the terrain in a scene.
  
== Terragen 4 Official Documentation ==
+
[[Heightfield and Procedural Terrain]]<br />
 +
Terragen allows the use of both heightfield and procedural terrain. Learn about the advantages and disadvantages of each.
  
===Guides===
+
== Getting Started ==
  
 
[[Tutorial 1: Creating Your First Scene]]<br />
 
[[Tutorial 1: Creating Your First Scene]]<br />
Line 18: Line 39:
 
[[Tutorial 2: Adding a Lake]]<br />
 
[[Tutorial 2: Adding a Lake]]<br />
 
A guide to adding a lake to a Terragen scene.
 
A guide to adding a lake to a Terragen scene.
 +
 +
== User Interface ==
 +
 +
Terragen's user interface is tailored to creating and rendering procedural landscapes and skies. This section will give you an overview of the Terragen user interface.
 +
 +
[[Terragen Menu Reference]]<br/>
 +
This article describes the top menus in Terragen.
 +
 +
[[Main Window User Interface Elements]]<br/>
 +
This article provides an overview of the main elements of the Terragen UI. You may refer to the following sections for details on specific elements of the UI:
 +
 +
* [[Top Toolbar]]
 +
 +
* [[Node List]]
 +
 +
* [[Shader Preview]]
 +
 +
* [[Node Properties]]
 +
 +
* [[The 3D Preview]]
 +
 +
* [[The Node Network]]
 +
 +
* [[Bottom Toolbar]]
 +
 +
[[Render Window]]<br/>
 +
This article describes the render window.
 +
 +
[[Terragen Window Reference|Window Reference]]<br />
 +
This reference describes the different windows used in Terragen 4.
 +
 +
== Guides ==
 +
 +
[[Terragen Network View Guide|Network View Guide]]<br />
 +
This is a guide to using the Node Network (Network View) in Terragen 4.
  
 
[[The Default Scene Explained]]<br />
 
[[The Default Scene Explained]]<br />
Line 24: Line 80:
 
[[Organizing Your Terragen Project]]<br/>
 
[[Organizing Your Terragen Project]]<br/>
 
An introduction to Groups, Clip Files and Notes, and other tips for sharing things between projects and keeping them organized.
 
An introduction to Groups, Clip Files and Notes, and other tips for sharing things between projects and keeping them organized.
 
[http://planetside.co.uk/docs/tg2/tg2-guide-part1.pdf User Guide Part 1: Fundamental Concepts and User Interface Overview] <br />
 
The User Guide is a series of documents that give an overview of all the major work areas of Terragen 4 and how to construct a basic scene. It is designed to be read through completely over time. '''Please note: this document is currently being updated for the latest version of Terragen. We apologize for the inconvenience.'''
 
 
[[Terragen 4 User Guide Part 2: Fundamental Rendering and Shader Concepts|User Guide Part 2: Fundamental Rendering and Shader Concepts]]<br />
 
This part of the User Guide explains some of the fundamental concepts used for rendering and shaders.
 
  
 
[[Terrain and Water]]<br />
 
[[Terrain and Water]]<br />
Line 36: Line 86:
 
[[Surface Mapping and Shading]]<br />
 
[[Surface Mapping and Shading]]<br />
 
Detailed information on applying surface maps, i.e. texturing, in Terragen 4. This section is oriented toward surface maps as applied to terrain, but much of the information also applies to object texturing.
 
Detailed information on applying surface maps, i.e. texturing, in Terragen 4. This section is oriented toward surface maps as applied to terrain, but much of the information also applies to object texturing.
 
[[Terragen 4 Animation Guide|Animation Guide]]<br />
 
This is a guide to using the Animation functions in Terragen. It has information and tutorials about creating animations using TG4.
 
  
 
[[The Library]]<br />
 
[[The Library]]<br />
 
This is a guide to using the Library and Library window in TG4.
 
This is a guide to using the Library and Library window in TG4.
  
[[Terragen Network View Guide|Network View Guide]]<br />
+
[[Working with Objects]]<br />
This is a guide to using the Network View in TG4.
+
This is a guide to working with objects in TG4. It covers topics such as importing objects, creating objects, manipulating them in the 3D Preview and much more.
 +
 
 +
[[Populator Guide]]<br />
 +
This is a guide to using Populator nodes. Populator nodes help you to quickly and efficiently add many objects, such as trees, to a scene.
  
 
[[Painted Shader Guide]]<br />
 
[[Painted Shader Guide]]<br />
 
This guide explains how to use and get the most out of the Painted Shader.
 
This guide explains how to use and get the most out of the Painted Shader.
 
[[Populator Guide]]<br />
 
This is a guide to using Populator nodes. Populator nodes help you to quickly and efficiently add many objects, such as trees, to a scene.
 
  
 
[[Working with Clip Files]]<br />
 
[[Working with Clip Files]]<br />
 
This page introduces Clip files, how to create them and how to use them. Clip files let you save nodes or collections of nodes so you can use them again or send them to others.
 
This page introduces Clip files, how to create them and how to use them. Clip files let you save nodes or collections of nodes so you can use them again or send them to others.
  
[[Working with Objects]]<br />
+
[[Terragen 4 Animation Guide|Animation Guide]]<br />
This is a guide to working with objects in TG4. It covers topics such as importing objects, creating objects, manipulating them in the 3D Preview and much more.
+
This is a guide to using the Animation functions in Terragen. It has information and tutorials about creating animations using TG4.
 +
 
 +
[[Animated Easy Clouds]]<br />
 +
A tutorial on the simple-to-use animation features built into Easy Clouds. The tutorial includes example videos and a project file that you can download.
 +
 
 +
[[Clouds Following Terrain Tutorial]]<br />
 +
Get an in-depth understanding of some powerful cloud control functions in Terragen with this tutorial by Martin Huisman
 +
 
 +
[[Subsurface Scattering]]<br />
 +
A guide to rendering subsurface scattering effects with the Glass Shader.
 +
 
 +
[[Creating 360 Degree Renders with the Spherical Camera]]<br />
 +
A guide to creating 360 degree HDR spherical images in Terragen for use as lighting and reflections in other 3D applications.
 +
 
 +
[[Terragen RPC: Time of Day Example Script]] <br />
 +
An exploration of Terragen's Remote Procedure Call feature.  Learn how to manipulate the parameter values of items in Terragen using a standalone program written in the Python programming language.
  
[[Ray Trace Objects and Defer Atmosphere/Cloud|A Guide to Rendering with Ray Trace Objects and Defer Atmo/Cloud]]<br />
+
[[Troubleshooting Licenses]]
How and when to use the rendering options "Ray trace objects", "Defer atmo/cloud" and "Ray trace everything".
 
  
 
[[FAQs and Troubleshooting]]
 
[[FAQs and Troubleshooting]]
  
[[Clouds Following Terrain Tutorial]]<br />
+
== References ==
Get an in-depth understanding of the new cloud control functions in Terragen with this tutorial by Martin Huisman
 
 
 
===Reference===
 
  
 
[[Terragen Node Reference]]<br />
 
[[Terragen Node Reference]]<br />
Line 94: Line 152:
  
 
Describes the project gathering process, which allows you to gather a project and related assets into a single folder.
 
Describes the project gathering process, which allows you to gather a project and related assets into a single folder.
 +
 +
[[Rendering Methods]]<br />
 +
 +
Discusses the two rendering methods that Terragen uses: micropolygon rasterization and raytracing.
 +
 +
[[Path Tracing]]<br />
 +
Beginning with Terragen 4.3, path tracing can be used to render more realistic images.
 +
 +
[[Ray Trace Objects and Defer Shading]]<br />
 +
How and when to use the rendering options "Ray trace objects", "Defer atmo/cloud" and "Defer all shading".
  
 
[[Terragen 4 Global Illumination|Global Illumination]]<br />
 
[[Terragen 4 Global Illumination|Global Illumination]]<br />
Line 102: Line 170:
  
 
Explains the Render Layers system in Terragen 4 Professional, including Render Elements.
 
Explains the Render Layers system in Terragen 4 Professional, including Render Elements.
 +
 +
[[OpenColorIO|OpenColorIO (OCIO)]]
 +
 +
Instructions for setting up OpenColorIO (OCIO) in Terragen Professional (v4.5+). It aims to allow you to work with colour spaces consistently with other applications in your pipeline.
  
 
[[Terragen Preferences|Preferences]]<br />
 
[[Terragen Preferences|Preferences]]<br />

Latest revision as of 02:32, 16 December 2022

Welcome to the Planetside Software Wiki[edit]

This is the primary documentation repository for Planetside Software's Terragen environment modeling and rendering product. This documentation refers primarily to the latest version of Terragen (currently Terragen 4). Whenever the general term "Terragen" is used, it is referring to this most recent version, unless otherwise specified, e.g. "Terragen Classic".

This wiki contains official information as well as community-written content. Official documentation is clearly delineated from user contributed information by section below. We hope you find this to be a valuable resource and we encourage you to contact us if you'd like to contribute in the community-generated areas.

If you are a licensed user of Terragen and you need direct support, you can contact us via our contact page.

Video Tutorials and Other Learning Resources[edit]

While the documentation below is the most comprehensive source of specific information about Terragen, many people find it easier to learn through video tutorials. There are links to several high quality, free tutorial channels on the Terragen Tutorials page of our website. We recommend the TerraTuts tutorials for quickly learning Terragen basics.

You can also find some helpful techniques and in-depth discussions of specific technical issues on the Tips and Tricks page. Check back regularly for new articles.

Fundamental Terragen Concepts[edit]

Articles in this section cover concepts fundamental to understanding and using Terragen.

What is Terragen?
An explanation of Terragen's design and purpose.

Terragen Conventions
Some conventions of Terragen and how it differs from other 3D graphics programs.

Nodes
Nodes are the fundamental building blocks of a Terragen scene. Learn more about how they work and are represented in the UI.

Shaders
Shaders provide color and texture for the terrain in a scene.

Heightfield and Procedural Terrain
Terragen allows the use of both heightfield and procedural terrain. Learn about the advantages and disadvantages of each.

Getting Started[edit]

Tutorial 1: Creating Your First Scene
A step-by-step tutorial on how to create a basic Terragen 4 scene.

Tutorial 2: Adding a Lake
A guide to adding a lake to a Terragen scene.

User Interface[edit]

Terragen's user interface is tailored to creating and rendering procedural landscapes and skies. This section will give you an overview of the Terragen user interface.

Terragen Menu Reference
This article describes the top menus in Terragen.

Main Window User Interface Elements
This article provides an overview of the main elements of the Terragen UI. You may refer to the following sections for details on specific elements of the UI:

Render Window
This article describes the render window.

Window Reference
This reference describes the different windows used in Terragen 4.

Guides[edit]

Network View Guide
This is a guide to using the Node Network (Network View) in Terragen 4.

The Default Scene Explained
When you open Terragen the first thing you see is a "default" scene, with basic terrain, planet, and atmosphere. This page explains how the default scene is set up.

Organizing Your Terragen Project
An introduction to Groups, Clip Files and Notes, and other tips for sharing things between projects and keeping them organized.

Terrain and Water
Detailed information on creating and controlling terrain and water features.

Surface Mapping and Shading
Detailed information on applying surface maps, i.e. texturing, in Terragen 4. This section is oriented toward surface maps as applied to terrain, but much of the information also applies to object texturing.

The Library
This is a guide to using the Library and Library window in TG4.

Working with Objects
This is a guide to working with objects in TG4. It covers topics such as importing objects, creating objects, manipulating them in the 3D Preview and much more.

Populator Guide
This is a guide to using Populator nodes. Populator nodes help you to quickly and efficiently add many objects, such as trees, to a scene.

Painted Shader Guide
This guide explains how to use and get the most out of the Painted Shader.

Working with Clip Files
This page introduces Clip files, how to create them and how to use them. Clip files let you save nodes or collections of nodes so you can use them again or send them to others.

Animation Guide
This is a guide to using the Animation functions in Terragen. It has information and tutorials about creating animations using TG4.

Animated Easy Clouds
A tutorial on the simple-to-use animation features built into Easy Clouds. The tutorial includes example videos and a project file that you can download.

Clouds Following Terrain Tutorial
Get an in-depth understanding of some powerful cloud control functions in Terragen with this tutorial by Martin Huisman

Subsurface Scattering
A guide to rendering subsurface scattering effects with the Glass Shader.

Creating 360 Degree Renders with the Spherical Camera
A guide to creating 360 degree HDR spherical images in Terragen for use as lighting and reflections in other 3D applications.

Terragen RPC: Time of Day Example Script
An exploration of Terragen's Remote Procedure Call feature. Learn how to manipulate the parameter values of items in Terragen using a standalone program written in the Python programming language.

Troubleshooting Licenses

FAQs and Troubleshooting

References[edit]

Terragen Node Reference
Describes all the Terragen 4 nodes.

Glossary
The Glossary explains terms relevant to Terragen.

Input Settings Reference
Lists all the input settings, such as mouse clicks and hot keys, that can be used in various views.

Menu Reference
Describes the menus in the Terragen 4 menu bar.

Window Reference
Describes the different windows used in Terragen 4.

Animation Module Reference

Gives an overview of the Animation Module as well as a reference for animation related windows and views.

Import-Export Reference

This reference describes Terragen 4's import and export capabilities.

Gathering Projects Reference

Describes the project gathering process, which allows you to gather a project and related assets into a single folder.

Rendering Methods

Discusses the two rendering methods that Terragen uses: micropolygon rasterization and raytracing.

Path Tracing
Beginning with Terragen 4.3, path tracing can be used to render more realistic images.

Ray Trace Objects and Defer Shading
How and when to use the rendering options "Ray trace objects", "Defer atmo/cloud" and "Defer all shading".

Global Illumination

Explains what Global Illumination is and how to use it in Terragen 4.

Render Layers and Render Elements (Terragen 4 Professional)

Explains the Render Layers system in Terragen 4 Professional, including Render Elements.

OpenColorIO (OCIO)

Instructions for setting up OpenColorIO (OCIO) in Terragen Professional (v4.5+). It aims to allow you to work with colour spaces consistently with other applications in your pipeline.

Preferences

Describes Terragen 4's preferences, which let you customise how the application behaves.

Command Line Reference

How to run Terragen from the command line on Windows, Mac and Linux, and descriptions of all the command line options.

Terragen Resources[edit]

Terragen Resource List

Find Terragen-compatible software, 3D models, content, and other resources.

Terragen Community-Generated Content[edit]

Terragen Tips and Tricks
Some quick tips and tricks for using Terragen, generated and maintained by our user community.

Terragen Tutorials
A list of tutorials, from beginning to advanced, to take you through how to do certain things with Terragen.

A heightmap or heightfield is an array of height values, usually in a grid which describe the height at specific points in a defined area. Heightfields are used to represent real-world and virtual terrain in a specific, easily converted format. Most heightfields can be represented as simple image data in grayscale, with black being minimum height and white being maximum height.

A parameter is an individual setting in a node parameter view which controls some aspect of the node.