Heightfield Crop

From Terragen Documentation from Planetside Software
Revision as of 00:49, 6 January 2021 by Redmaw (talk | contribs) (Updated descriptions and replaced most example images using Heightfield at Position lower left. Moved Heightfield Position documentation to after Heightfield Crop descriptions & examples.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Heightfield Crop
Heightfield Crop


Overview

The Heightfield Crop node is used to crop a portion of the heightfield it is applied to. Think of drawing a box by entering coordinates into the “Bottom left” and “Top right” settings. These coordinates correspond to the number of data samples in a TER file, or the number of pixels in an image file, such as an EXR. The coordinates start at the bottom left corner (0,0) of the heightfield, and the top right coordinates should be greater values than the bottom left. In this way you can isolate any section of the heightfield.


Settings:

    In the example images below this image was used as the heightfield to easily demonstrate where the heightfield is cropped and how it is positioned. The image resolution is 1000 x 1000 pixels, and the values used to crop the heightfield are based on pixels.
    Image used as heightfield for examples.
    Image used as heightfield for examples.

    Here the image has been applied as a heightfield.

    Image used as heightfield, no cropping.
    Image used as heightfield, no cropping.


    • Name: This setting allows you to apply a descriptive name to the node, which can be helpful when using multiple Heightfield crop nodes in a project.


    • Crop: When checked, or enabled, the heightfield is cropped by the settings below. Note that it is sometimes necessary to disable then re-enable this checkbox after changing the other settings in order to recalculate the crop region correctly.


    • Bottom left: This setting is the bottom left corner of the cropped section. Coordinates are measured from the bottom left corner (0,0) of the heightfield.
    • Top right: This setting is the top right corner of the cropped section. Coordinates are measured from the bottom left corner (0,0) of the heightfield, therefore they should be larger than the “Bottom left” values.
      Bottom left coordinates = 0,500, Top right coordinates = 500,1000
      Bottom left coordinates = 0,500, Top right coordinates = 500,1000
      Bottom left coordinates = 500,500, Top right coordinates = 1000,1000
      Bottom left coordinates = 500,500, Top right coordinates = 1000,1000
      Bottom left coordinates = 0,0, Top right coordinates = 500,500
      Bottom left coordinates = 0,0, Top right coordinates = 500,500
      Bottom left coordinates = 500,0, Top right coordinates = 1000,500
      Bottom left coordinates = 500,0, Top right coordinates = 1000,500


    • Include top right:


    • Pad outside original: When unchecked, or disabled, values entered in the “Bottom left” and “Top right” settings that exceed the actual number of data samples in the heightfield are ignored. When checked, or enabled, the cropped region is increased or "padded" by the amount that the data samples represent.
      Pad outside original disabled.
      Pad outside original disabled.
      Pad outside original enabled.
      Pad outside original enabled.


Heightfield shader "Position" setting

Cropped regions are positioned based on the Heightfield’s “Position” settings. This radio button can be found under the Heightfield shader’s Location tab.


Heightfield shader Location tab
Heightfield shader Location tab


Position centre enabled.
Position centre enabled.
Postion lower left enabled.
Postion lower left enabled.
Position upper left enabled.
Position upper left enabled.