From Terragen Documentation from Planetside Software
Jump to: navigation, search


The Rock object creates a single, simple rock shape in your scene. It can also be used in populations.


  • Name: This setting allows you to apply a descriptive name to the node, which can be helpful when using multiple Rock nodes in a project.
  • Enable: When checked, the node is active and the rock object will appear in the scene with the settings below applied to its surface and shape. When unchecked, the node is ignored.
  • Population mode: This popup has two options:
    Population mode options

    Individual Object: This is the default for rock objects created individually, not part of a population. If you choose this option for rock objects that are part of a population the population instances will still render but the rock object itself will also show up at its original position.
    Member of a Population: This is the default for rock objects created as part of creating a population. It means the rock objects only render as part of a population. If you choose this option for an individual rock object it won't render. If you create a rock object as part of a population and then decide to use it on its own you may need to change the popup to Individual Object to get it to render.

  • Preview mode: This popup has five options to let you choose how the object should be displayed in the 3D Preview, and sets the most detailed mode that the object can be displayed in. The Object Display Mode button in the 3D Preview controls the mode for the preview as a whole. For example, if you set the Preview mode of the object to Wireframe but the 3D Preview object display mode is set to Show as bounding boxes then the object will only be drawn as a bounding box.
    Preview mode options
  • Preview colour: Enabling this parameter causes the rock object to be drawn in the 3D preview using the preview colour when the rock object display mode is set to Show as bounding box or Show as wireframe. When set to Show as smooth shaded or Show as textured the preview colour tints the rock object’s textured surface. This is useful for making a particular rock object stand out in the 3D preview. Clicking on the colour swatch to the right of the parameter label opens the Colour Picker pane.

Rock Tab[edit]

Rock Tab
  • Number of faces: This setting increases or decreases the amount of polygons, or faces, that make up the rock object. Low values result in larger polygons and a blockier looking rock. Higher values result in smaller polygons and a smoother looking rock, capable of being deformed by shader or function nodes assigned to settings found under the Mesh Modifiers tab.
    Increasing the Number of faces setting increases the number of polygons used to define the rock.

  • Diameter: This setting controls the diameter of the rock object. Increasing the value makes the rock object larger. Note, that this scaling takes place around the pivot point, or center, of the rock object and it may be necessary to reposition the rock so that it sits properly on the terrain after changing its diameter.
    Increasing the diameter makes the rock object larger.

  • Variation count:: This setting controls the number of unique variations of the rock object when used in a population. A value of 0 forces all the rock objects to be the same. When the number of instanced rock objects exceeds the number of unique variations the variations are reused in the population.
    The Variation Count setting creates unique variations of the rock object’s geometry in a population.

  • Seed:This value is used by the rock object to generate random aspects of its geometry. A new seed value is generated for each new rock object, which helps to ensure that each rock object and rock populations don't coincide with one another. For example, two rock populators with identical settings and seed values will generate instances in exactly the same place. There may be situations in which you want this to happen, and in that case it’s important that both populations use the same seed value.
    Random seed values

  • Random Seed: Click this button to generate a new random seed value for the rock object.

Shattering Tab[edit]

Shattering Tab
  • Coming soon

Mesh Modifiers Tab[edit]

Mesh Modifiers Tab
  • Coming soon

Surface Shaders Tab[edit]

Surface Shaders Tab

This tab lets you assign a surface shader to texture the rock object.

  • Surface shader: Use this setting to assign a surface shader to the rock object.
  • Displacement tolerance: If you find that rough or spikey surfaces are showing problems at bucket edges, for example spikes having cut off tops, or gaps in ray traced shadows then increasing this value may help. However this can greatly increase render times. Relatively flat surfaces may render more quickly with smaller values. The default value is 1. However this is an advanced setting and you should not change it unless you have specific problem you need to address. If you are having problems try starting with 2 and then increase it by small increments until they're resolved. A value of 4 would be considered a high value.
  • Smooth polygons at terminator: This fixes self-shadow artifacts at the lighting terminator of polygonal objects where the smooth normals are inconsistent with the geometric normal. This parameter is enabled by default.
  • Darken bumps at terminator: This setting approximates self-shadow of bump maps at the lighting terminator to reduce the chance of seeing a sharp line where the surface falls into shadow. This setting is enabled by default.
    Smooth polygons at terminator comparison Darken bumps at terminator comparison

Rendering Tab[edit]

Rendering Tab
  • Render: An object's render state can be set to Visible, Invisible or Holdout. When set to Holdout, an object is visible in the rendered image as a black shape with an alpha value of zero. When using render layers the object's render state is combined with the group visibility parameter to determine its least visible setting. Invisible is less visible than Holdout, which is less visible than Visible.
    Render options
  • Visible to other rays: When enabled, the rock object will be taken into account by all the rays determined by the renderer including those from the camera, direct and indirect lighting, etc. In the example below, a 100% reflective 3D object has been placed behind three coloured spheres in order to mirror the effect of the calculated rays.
    Visible to other rays comparison
  • Cast shadow: When checked, the rock object will cast shadows.
    Cast Shadows comparison
  • Double-sided surface: When checked, the rock object surfaces are double sided. A single sided surface is only visible from the "front", which is the direction the surface normal is pointing. If you look at it from the other direction the surface isn't visible. Double sided surfaces are visible from all directions.
  • Use smooth normals: When checked, the rock object normals are interpolated to make the surface appear smooth. When unchecked, its surface will look faceted
  • Render method: This popup has three options.
    Render method options

    Default: Ray Tracing is the default rendering method for an object. Typically it results in higher quality and faster rendering. When displacement is applied to a 3D object the render method should be changed to Force Displacement. When the object's render method is set to Default, the object is rendered according to the Ray trace objects setting in the render node.
    Force Displacement: When enabled for the rock object, its surfaces will be subdivided into micropolygons at render time, which allows the 3D geometry to be displaced correctly but at the expense of slightly longer render times. It is useful when you have some objects you want to render with displacement but you don't want to change how all the rest of your objects are rendered, i.e. Ray traced.
    Force Ray Trace: When enabled for the rock object, its surfaces will be ray traced at render time, even if Ray trace objects is disabled in the Renderer settings. This can be useful when Ray trace objects is disabled in the Renderer in order for other 3D objects to use displacement, but you want this object to use ray tracing for the highest quality rendering and it has not been displaced.

  • Sorting bias (metres): This setting gives you control over the order in which objects are rendered when using the micropolygon renderer. This does not apply to objects being rendered with the ray tracer. A large positive value, e.g. 10,000,000 (or 1e7) will usually force the object to render first. A large negative value, e.g. -10,000,000 (or -1e7) will usually force the object to render last, or after the terrain. This can be useful when rendering large objects with displacement, such as a lake object that lies mostly below the displaced terrain. By setting the lake object’s Sorting bias (metres) value to something like -10,000,000 forces it to render after the terrain.

Transform Tab[edit]

Transform Tab
  • Translate: This sets the position of the rock object.
  • Rotate: This rotates the rock object about its origin. The order of the values is heading, pitch then bank.
  • Scale: This sets the scale of the rock object in the X, Y and Z directions.

Angular Position Tab[edit]

Angular Position Tab

This tab has settings which use angles and distance to set the position of the rock relative to the scene origin. These settings are an alternative to using the Translate setting in the Transform tab. The diagram below shows how all the parameters relate to each other and the origin.

  • Heading: This angle sets the rotation of the rock object around the scene origin, in the XY plane, increasing as you turn clockwise.
  • Elevation: This angle sets the vertical part of the position. You could think of it as the angle above or below the horizon. 90 is straight up, -90 is straight down.
  • Distance: This sets the distance of the rock object from the origin, in metres.
Angular positions

Import Tab[edit]

Import Tab

These settings apply to .chan/.mov and FBX import.

  • Import offset: This setting allows you to offset the positions imported from the file. As an example, you might want the positions imported from the file to be moved 10 metres in the X direction. To do that enter 10 for the X coordinate and import the file.
  • Import scale: You can use this setting to scale values imported from the file.
  • Import chan file: This setting specifies the file to be imported. When you choose a new file you will be prompted to import the file. If you choose not to import it immediately you can click the Import chan File button to perform the import.

A single object or device in the node network which generates or modifies data and may accept input data or create output data or both, depending on its function. Nodes usually have their own settings which control the data they create or how they modify data passing through them. Nodes are connected together in a network to perform work in a network-based user interface. In Terragen 2 nodes are connected together to describe a scene.

The bounding box is a box which surrounds (or bounds) an object or shader. This box shows the maximum extents of the item inside it. Sometimes abbreviated as "b-box".

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

A shader is a program or set of instructions used in 3D computer graphics to determine the final surface properties of an object or image. This can include arbitrarily complex descriptions of light absorption and diffusion, texture mapping, reflection and refraction, shadowing, surface displacement and post-processing effects. In Terragen 2 shaders are used to construct and modify almost every element of a scene.

When Terragen renders, it divides the image up into buckets or tiles. Each bucket is rendered separately, allowing multiple buckets to be rendered at once. It also allows memory to be used more efficiently.

Literally, to change the position of something. In graphics terminology to displace a surface is to modify its geometric (3D) structure using reference data of some kind. For example, a grayscale image might be taken as input, with black areas indicating no displacement of the surface, and white indicating maximum displacement. In Terragen 2 displacement is used to create all terrain by taking heightfield or procedural data as input and using it to displace the normally flat sphere of the planet.