Difference between revisions of "Main Page"

From Terragen Documentation from Planetside Software
Jump to: navigation, search
(Corrected animation guide link after recent edit)
m (Added Terragen RPC: Time of Day Example Script to the Guides section.)
 
(46 intermediate revisions by 5 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].
  
If you are a licensed user of Terragen and you need direct support, you can contact us via [http://planetside.co.uk/contact-us/ our contact page].
+
== Video Tutorials and Other Learning Resources ==
  
== Terragen 4 Official Documentation ==
+
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.
  
===Guides===
+
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.
  
[[Creating Your First Scene]]<br />
+
== 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.
 +
 
 +
[[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.
 +
 
 +
[[Heightfield and Procedural Terrain]]<br />
 +
Terragen allows the use of both heightfield and procedural terrain. Learn about the advantages and disadvantages of each.
 +
 
 +
== Getting Started ==
 +
 
 +
[[Tutorial 1: Creating Your First Scene]]<br />
 
A step-by-step tutorial on how to create a basic Terragen 4 scene.
 
A step-by-step tutorial on how to create a basic Terragen 4 scene.
  
[http://planetside.co.uk/docs/tg2/tg2-guide-part1.pdf User Guide Part 1: Fundamental Concepts and User Interface Overview] <br />
+
[[Tutorial 2: Adding a Lake]]<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.'''
+
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.
  
[[Terragen 4 User Guide Part 2: Fundamental Rendering and Shader Concepts|User Guide Part 2: Fundamental Rendering and Shader Concepts]]<br />
+
== Guides ==
This part of the User Guide explains some of the fundamental concepts used for rendering and shaders.  
+
 
 +
[[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 />
 +
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]]<br/>
 +
An introduction to Groups, Clip Files and Notes, and other tips for sharing things between projects and keeping them organized.
  
 
[[Terrain and Water]]<br />
 
[[Terrain and Water]]<br />
Line 27: 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 66: Line 133:
  
 
[[Terragen Input Settings Reference|Input Settings Reference]]<br />
 
[[Terragen Input Settings Reference|Input Settings Reference]]<br />
Lists all the input settings, such as mouse clicks and hot keys, that can be used in various views. You can find the input settings for TG4 [[Terragen Input Settings Reference|here]].
+
Lists all the input settings, such as mouse clicks and hot keys, that can be used in various views.
  
 
[[Terragen Menu Reference|Menu Reference]]<br />
 
[[Terragen Menu Reference|Menu Reference]]<br />
Describes the menus in the Terragen 4's menubar. You can read about Terragen 4's menus [[Terragen 2 Menu Reference|here]].
+
Describes the menus in the Terragen 4 menu bar.
  
 
[[Terragen Window Reference|Window Reference]]<br />
 
[[Terragen Window Reference|Window Reference]]<br />
Line 80: Line 147:
 
[[Terragen Import-Export Reference|Import-Export Reference]]<br />
 
[[Terragen Import-Export Reference|Import-Export Reference]]<br />
  
This reference describes TG4s import and export capabilities.
+
This reference describes Terragen 4's import and export capabilities.
  
 
[[Terragen Gathering Projects Reference|Gathering Projects Reference]]<br />
 
[[Terragen Gathering Projects Reference|Gathering Projects Reference]]<br />
Line 86: Line 153:
 
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.
  
[[Terragen 2 Global Illumination|Global Illumination]]<br />
+
[[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 />
  
 
Explains what Global Illumination is and how to use it in Terragen 4.
 
Explains what Global Illumination is and how to use it in Terragen 4.
Line 93: 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 />
  
Describes Terragen 4's preferences, which let you customise how the application behaves. You can find out about Terragen 4's preferences [[Terragen 42 Preferences|here]].
+
Describes Terragen 4's preferences, which let you customise how the application behaves.
  
 
[[Command Line Reference]]<br />
 
[[Command Line Reference]]<br />
  
How to run Terragen 4 from the command line on Windows, Mac and Linux, and descriptions of all the command line options.
+
How to run Terragen from the command line on Windows, Mac and Linux, and descriptions of all the command line options.
  
 
== Terragen Resources ==
 
== Terragen Resources ==
Line 110: Line 191:
 
== Terragen Community-Generated Content ==
 
== Terragen Community-Generated Content ==
  
[[Using Terragen 2]]<br />
+
[[Terragen Tips and Tricks]]<br />
A quick overview of using TG2.
+
Some quick tips and tricks for using Terragen, generated and maintained by our user community.
 
 
[[Terragen 2/3 Tips and Tricks]]<br />
 
Some quick tips and tricks for using TG2.
 
 
 
[[Terragen 2/3 Tutorials]]<br />
 
A list of tutorials, from beginning to advanced, to take you through how to do certain things with TG2.
 
 
 
[[Tutorial planning Area]]<br />
 
A list of planned or desired tutorials
 
  
[[Objects and Object Collections]]<br />
+
[[Terragen Tutorials]]<br />
A list of objects created for Terragen by the community and a list of stores and collections available for free or at a cost.
+
A list of tutorials, from beginning to advanced, to take you through how to do certain things with Terragen.

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.