Difference between revisions of "Populator v3"

From Terragen Documentation from Planetside Software
Jump to: navigation, search
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category:IMPORT]]
+
[[Image:drex_module_194_image_0.png|center|Populator v3]]
='''Populator v3.01'''=
 
  
[[Image:drex_module_194_image_0.png|485pxpx|Populator v3.01]]
+
'''Node Description & Purpose: '''<br />
 +
The Populator is used for creating and distributing many instances of the same object across a customizable rectangle area on the xz-plane. By using the Populator, the user can have the application accurately place instances of objects (instantiated objects) on the terrain surface automatically, so that the object's y coordinate matches the y coordinate of the terrain. The ability to specify a density shader allows users to mask the placement and distribution of objects. If no distribution shader is specified, the Populator places objects randomly across the defined rectangle area. To mimic more variety, the Populator can rotate instantiated objects randomly around the y-axis, and vary the object scale within a Population by user defined parameters.
  
==Additional tabs for Populator v3.01==
+
The Populator v3 has been superceded by the [[Populator v4]] node in TG3. The Populator v4 has a number of advantages. You cannot create Populator v3 nodes in TG3, however the node is still available if you're loading projects made in TG2. This means your projects will still load and render as expected.  
  
* [[Populator v3.01 - Terrain Tab]]
+
If you would like to convert a population from v3 to v4, simply select it in the Node List on the left, then use the utility button with a Gear Icon below the node list to select "Upgrade Selected Population to v4". Note that you must have the population you want to convert selected in the Node List; node selections in the Node Network will not be detected.
  
* [[Populator v3.01 - Object Scale Tab]]
+
For additional information and example projects for using Populator nodes, please see the [[Populator Guide]].
  
* [[Populator v3.01 - Object Rotation Tab]]
 
  
* [[Populator v3.01 - Seed Tab]]
+
'''Node Type: '''Population (of any object type)
  
'''Node Description & Purpose: '''The Populator is used for creating and distributing many instances of the same object across a customizable rectangle area on the xz-plane. By using the Populator, the user can have the application accurately place instances of objects (instantiated objects) on the terrain surface automatically, so that the object's y coordinate matches the y coordinate of the terrain. The ability to specify a density shader allows users to mask the placement and distribution of objects. If no distribution shader is specified, the Populator places objects randomly across the define rectangle area. To mimic more variety, the Populator can rotate instantiated objects randomly around the y-axis, and vary the object scale within a Population by user defined parameters.<br /><br />'''Node Type: '''Population (of any object type)<br /><br />'''Nodes in Default Scene: ''' n/a<br /><br />'''Settings - Main: '''Settings on main settings window (outside tabs)<br />
+
 
 +
'''Settings: '''<br />
  
 
* '''Name: '''The name of the populator node
 
* '''Name: '''The name of the populator node
 
* '''Enable (Checkbox): '''Enables or disables the Populator.
 
* '''Enable (Checkbox): '''Enables or disables the Populator.
 
* '''Show b-box in preview: '''Enables or disables a 2D rectangle in the preview window, which marks the boundaries of the population on the xz axis.
 
* '''Show b-box in preview: '''Enables or disables a 2D rectangle in the preview window, which marks the boundaries of the population on the xz axis.
* '''Object maker: '''Allows to enter or select an object maker that defines the object being populated.
+
* '''Preview mode:''' Lets you choose how the object should be displayed in the 3D Preview. This popup 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.
* '''Unique Variations: '''Not yet functional.
+
* '''Preview colour:''' If you check this param the population will draw in the 3D Preview using the specified colour. The preview colour can be seen in bounding box, wireframe and smooth shaded preview modes. Use the colour button to choose a new colour.
* '''Render Quality: '''Allows for specifying the render quality of populated objects. To reduce render times, level-of-detail reduction is applied to parts of objects that appear very small in the rendered image, with respect to the image resolution and detail settings in the render node. Therefore more detail reduction is applied to objects in the distance or to objects with very small polygons. The Render Quality setting controls how much reduction takes place, but also affects render times.
+
* '''Object maker: '''Allows the user to enter or select an object maker that defines the object being populated.
* '''"Populate Now" Button: '''Calculates a population of instanced object based on the current settings. If you do not press this button, the population will be calculated automatically the next time you render an image, but if you have enabled "Preview instances" then you can use this button to preview the positions of the objects in the 3D Preview without rendering an image.
+
* '''Render Quality: '''Allows for specifying the render quality of populated objects. To reduce render times, level-of-detail reduction is applied to parts of objects that appear very small in the rendered image, with respect to the image resolution and detail settings in the render node. Therefore more detail reduction is applied to objects in the distance or to objects with very small polygons. The Render Quality setting controls how much reduction takes place, but also affects render times. '''Note: this setting does not have an effect when Raytrace Objects is enabled, which is the default in newer versions of Terragen.'''
* '''Repopulate every frame: '''Forces the populator to recalculate the positions and sizes of the instantiated objects every time a new frame is rendered. This is necessary if you animate your distribution functions, terrain, or object maker. If you don't check this box, the population will still be calculated automatically at the start of a render if any of the Populator's parameters have changed.
 
* '''Preview Instances: '''Enables or disables object preview in the preview window. Objects can currently not be rendered in the preview, but Terragen 2 draws a 3D box around each instantiated object. This can slow down navigation in the preview window drastically with very large numbers of instances, hence the checkbox allows users to temporarily switch of drawing those 3D boxes in the preview.
 
  
<br />'''Settings - Tabs: '''<br /><br />'''Distribution Tab: '''<br />
+
<u>Distribution tab</u><br />
  
* '''Area Centre: '''Enter the 3D coordinates of the rectangle distribution area on the XZ plane and the Y value for height. Leave the Y field empty if you rather want to specify a terrain onto which the objects should be placed.
+
* '''Area Centre: '''Enter the 3D coordinates of the rectangle distribution area on the XZ plane; the Y value is used for height. Leave the Y field empty if you want to specify a terrain onto which the objects should be placed.
* '''Area Length a: '''Length of one side of the population boundaries (along x).
+
* '''Area Length a: '''Length of one side of the population boundary (along x).
* '''Area Length b: '''Length of one side of the population boundaries (along z).
+
* '''Area Length b: '''Length of one side of the population boundary (along z).
* '''Object Spacing: '''Specify the average distance from one object instance to the other.
+
* '''Object Spacing in a,b: '''Specify the average distance from one object instance to the other.
* '''Use density Shader: '''If left empty, the Populator will randomly, but completely cover the specified area with instantiated objects. You may create or select an existing shader to serve as a mask for the populator instead (such as a power fractal shader, or an image map projection.
+
* '''Spacing variation in a, b:''' This controls the randomness of the the position of the object instance. If you used a value of 0 there would be no random aspect to the placement of the object instances and they would all be lined up on a grid defined by the '''Object spacing in a,b'''. At the default value of 1 the placement of the object is the most random and the population as a whole looks the least regular.
 +
* '''Use density Shader: '''If left empty, the Populator will completely cover the specified area with instantiated objects. You can use a density shader to give you more control over where objects are placed. The density shader is read as a mask where white areas mean objects are placed the most densely and black areas mean no objects will show up. Intermediate grayscale values will have varying levels of population density according to how light the grayscale value is.
 
* '''Invert Density Shader: '''Inverts the mask specified in the density shader.
 
* '''Invert Density Shader: '''Inverts the mask specified in the density shader.
  
<br />'''Terrain Tab: '''<br />
 
  
* '''Sit on terrain: '''Mark the checkbox AND specify a shader to serve as a terrain onto which the instantiated objects will be placed.
+
* '''Repopulate every frame: '''Forces the populator to recalculate the positions and sizes of the instantiated objects every time a new frame is rendered. This is necessary if you animate your distribution functions, terrain, or object maker. If you don't check this box, the population will still be calculated automatically at the start of a render if any of the Populator's parameters have changed.
 +
* '''"Populate Now" Button: '''Calculates a population of instanced objects based on the current settings. If you do not press this button, the population will be calculated automatically the next time you render an image, but if you have enabled "Preview instances" then you can use this button to preview the positions of the objects in the 3D Preview without rendering an image.
 +
 
 +
 
 +
==Additional tabs for Populator v3==
 +
 
 +
* [[Populator v3 - Terrain Tab]]
  
<br />'''Object Scale Tab: '''<br />
+
* [[Populator v3 - Object Scale Tab]]
  
* '''Minimum & Maximum Scale: '''Defines the minimum and maximum multiplier affecting the size of an instantiated object. The default size of an object in the population is defined in the corresponding object maker. The "minimum & maximum scale" setting allows to redefine the range of scales within the population, relative to the default size in the object maker.
+
* [[Populator v3 - Object Rotation Tab]]
  
<br />'''Object Rotation Tab: '''<br />
+
* [[Populator v3 - Seed Tab]]
  
* '''Minimum & Maximum Y Rotation: '''Defines the minimum and maximum angle in degrees by which the populator may rotate the instances alround the y-axis.
 
  
__NOTOC__
+
[[Category:Population Nodes]]
<!-- imported from file: module_194.html-->
 

Latest revision as of 01:30, 14 February 2014

Populator v3

Node Description & Purpose:
The Populator is used for creating and distributing many instances of the same object across a customizable rectangle area on the xz-plane. By using the Populator, the user can have the application accurately place instances of objects (instantiated objects) on the terrain surface automatically, so that the object's y coordinate matches the y coordinate of the terrain. The ability to specify a density shader allows users to mask the placement and distribution of objects. If no distribution shader is specified, the Populator places objects randomly across the defined rectangle area. To mimic more variety, the Populator can rotate instantiated objects randomly around the y-axis, and vary the object scale within a Population by user defined parameters.

The Populator v3 has been superceded by the Populator v4 node in TG3. The Populator v4 has a number of advantages. You cannot create Populator v3 nodes in TG3, however the node is still available if you're loading projects made in TG2. This means your projects will still load and render as expected.

If you would like to convert a population from v3 to v4, simply select it in the Node List on the left, then use the utility button with a Gear Icon below the node list to select "Upgrade Selected Population to v4". Note that you must have the population you want to convert selected in the Node List; node selections in the Node Network will not be detected.

For additional information and example projects for using Populator nodes, please see the Populator Guide.


Node Type: Population (of any object type)


Settings:

  • Name: The name of the populator node
  • Enable (Checkbox): Enables or disables the Populator.
  • Show b-box in preview: Enables or disables a 2D rectangle in the preview window, which marks the boundaries of the population on the xz axis.
  • Preview mode: Lets you choose how the object should be displayed in the 3D Preview. This popup 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 colour: If you check this param the population will draw in the 3D Preview using the specified colour. The preview colour can be seen in bounding box, wireframe and smooth shaded preview modes. Use the colour button to choose a new colour.
  • Object maker: Allows the user to enter or select an object maker that defines the object being populated.
  • Render Quality: Allows for specifying the render quality of populated objects. To reduce render times, level-of-detail reduction is applied to parts of objects that appear very small in the rendered image, with respect to the image resolution and detail settings in the render node. Therefore more detail reduction is applied to objects in the distance or to objects with very small polygons. The Render Quality setting controls how much reduction takes place, but also affects render times. Note: this setting does not have an effect when Raytrace Objects is enabled, which is the default in newer versions of Terragen.

Distribution tab

  • Area Centre: Enter the 3D coordinates of the rectangle distribution area on the XZ plane; the Y value is used for height. Leave the Y field empty if you want to specify a terrain onto which the objects should be placed.
  • Area Length a: Length of one side of the population boundary (along x).
  • Area Length b: Length of one side of the population boundary (along z).
  • Object Spacing in a,b: Specify the average distance from one object instance to the other.
  • Spacing variation in a, b: This controls the randomness of the the position of the object instance. If you used a value of 0 there would be no random aspect to the placement of the object instances and they would all be lined up on a grid defined by the Object spacing in a,b. At the default value of 1 the placement of the object is the most random and the population as a whole looks the least regular.
  • Use density Shader: If left empty, the Populator will completely cover the specified area with instantiated objects. You can use a density shader to give you more control over where objects are placed. The density shader is read as a mask where white areas mean objects are placed the most densely and black areas mean no objects will show up. Intermediate grayscale values will have varying levels of population density according to how light the grayscale value is.
  • Invert Density Shader: Inverts the mask specified in the density shader.


  • Repopulate every frame: Forces the populator to recalculate the positions and sizes of the instantiated objects every time a new frame is rendered. This is necessary if you animate your distribution functions, terrain, or object maker. If you don't check this box, the population will still be calculated automatically at the start of a render if any of the Populator's parameters have changed.
  • "Populate Now" Button: Calculates a population of instanced objects based on the current settings. If you do not press this button, the population will be calculated automatically the next time you render an image, but if you have enabled "Preview instances" then you can use this button to preview the positions of the objects in the 3D Preview without rendering an image.


Additional tabs for Populator v3[edit]

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.

The Node List is a part of the Terragen interface that shows a list of nodes along the left side of the application window. The Node List generally shows only those nodes that are relevant to the current Layout (e.g. Terrain, Atmosphere). It sometimes includes buttons or other controls that are specific to a particular Layout as well. The Node List is hierarchical and each level is collapsible.

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".