Heightfield Crop - Revision history

Redmaw: Updated descriptions and replaced most example images using Heightfield at Position lower left. Moved Heightfield Position documentation to after Heightfield Crop descriptions & examples.

2021-01-06T00:49:06Z

Updated descriptions and replaced most example images using Heightfield at Position lower left. Moved Heightfield Position documentation to after Heightfield Crop descriptions & examples.

← Older revision		Revision as of 00:49, 6 January 2021
Line 3:		Line 3:

	== Overview ==		== Overview ==
	The Heightfield Crop node is used to crop a portion of the heightfield it is applied to.		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.

	It is important to understand that the values entered into the “Bottom left” and “Top right” settings correspond to the number of sample points in a TER file, or the number of pixels in an image file, such as an EXR. The values do not represent metres unless there is one sample point or pixel per metre in the source heightfield.

	For example, a heightfield covering 1,000 square meters could be generated using 100 sample points on each X and Y axis. Therefore each sample point is 10 metres apart. To crop half of the heightfield you would enter a value of 50 in the “Bottom left” setting’s X and Y fields for half of the sample points, not 500 for half of the distance in metres.

	~~Cropping begins at the bottom left corner of the heightfield and extends along the X and Y axis for the values entered in the “Bottom left” setting.~~

	If values have been entered in the “Top right” setting, a second crop occurs from the top right corner of the previously cropped section, extending along the -X and -Y axis direction. Note, that if no values have been entered in the “Bottom left” setting, then the crop will begin at the bottom left corner of the heightfield using the “Top right” values.

	~~The final size of the cropped region is the absolute value of the “Bottom left” X and Y axis components minus the “Top right” components.~~

	~~You can create offsets for the cropped region by entering values greater than the number of sample points in the heightfield and enabling the “Pad outside original” setting.~~

	~~The cropped region is positioned based on the Heightfield’s “Position” settings. This radio button can be found under the Heightfield shader’s Location tab.~~

	~~[[File:HFShader_GUI_PositionRadioButton.png\|none\|470px\|Heightfield shader Location tab]]~~

	~~In this way you can isolate any section of the heightfield.~~


Line 36:		Line 20:
	Here the image has been applied as a heightfield.		Here the image has been applied as a heightfield.

	[[File:~~HFCrop_00_NoCrop~~.jpg\|none\|400px\|Image used as heightfield, no cropping.]]		[[File:HFCrop_00-2_NoCrop.jpg\|none\|400px\|Image used as heightfield, no cropping.]]

	<br />		<br />
Line 43:		Line 27:
	* ''' 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.		* ''' 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.
	<br />		<br />
	* '''Bottom left: ''' This is the ~~number~~ of ~~data samples to include along~~ the ~~X and Y axis starting~~ from the bottom left corner of the heightfield. ~~Values greater than~~ the ~~actual number~~ of ~~data samples~~ are ~~ignored if~~ the ~~“Pad outside original” setting is disabled~~, ~~but are taken into account when~~ the ~~setting is enabled. See~~ the ~~“Pad outside original” setting for more information~~.		* '''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.
	<ul>		<ul>
	[[File:HFCrop_09_BottomLeft_0001.jpg\|none\|800px\|Bottom left exampless.]]		<!-- [[File:HFCrop_09_BottomLeft_0001.jpg\|none\|800px\|Bottom left exampless.]]-->
			{\|
			\|-
			\| [[File:HFCrop_12_BotL0x500_TopR500x1000.jpg\|none\|400px\|Bottom left coordinates = 0,500, Top right coordinates = 500,1000 ]] \|\| [[File:HFCrop_13_BotL500x500_TopR1000x1000.jpg\|none\|400px\|Bottom left coordinates = 500,500, Top right coordinates = 1000,1000]]
			\|-
			\| [[File:HFCrop_14_BotL0x0_TopR500x500.jpg\|none\|400px\|Bottom left coordinates = 0,0, Top right coordinates = 500,500]] \|\| [[File:HFCrop_15_BotL500x0_TopR1000x500.jpg\|none\|400px\|Bottom left coordinates = 500,0, Top right coordinates = 1000,500]]
			\|}
	</ul>		</ul>


	* '''Top right: ''' When the “Bottom left” X and Y axis values are 0.0, the "Top right" values indicate the number of data samples to include along the X and Y axis starting from the bottom left corner of the heightfield. Otherwise, they are the number of data samples to include along the -X and -Y axis starting from the top right corner of the region cropped by the “Bottom left” setting. Values greater than the actual number of data samples are ignored if the “Pad outside original” setting is disabled, but are taken into account when the setting is enabled. See the “Pad outside original” setting for more information.
	~~<ul>~~
	~~[[File:HFCrop_10_TopRight.jpg\|none\|800px\|Top right examples.]]~~
	~~</ul>~~


Line 58:		Line 44:


	* '''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 ~~in size and offset~~ by the ~~exceeded~~ amount that the data samples represent.		* '''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.
	<ul>		<ul>
	[[File:~~HFCrop_11_PadOutsideOriginal~~.jpg\|none\|~~800px~~\|Pad outside original ~~examples~~.]]		{\|
			\|-
			\| [[File:HFCrop_16_PadOutsideOff.jpg\|none\|400px\|Pad outside original disabled.]] \|\| [[File:HFCrop_17_PadOutsideOn.jpg\|none\|400px\|Pad outside original enabled.]]
			\|}
	</ul>		</ul>
	</ul>		</ul>
	<br />		<br />

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


			[[File:HFShader_GUI_PositionRadioButton.png\|none\|470px\|Heightfield shader Location tab]]



			{\|
			\|-
			\| [[File:HFCrop_18-2_HFPositionCentre.jpg\|none\|266px\|Position centre enabled.]] \|\| [[File:HFCrop_19_HFPositionLowL.jpg\|none\|266px\|Postion lower left enabled.]] \|\| [[File:HFCrop_20_HFPositionUpR.jpg\|none\|266px\|Position upper left enabled.]]
			\|}
			<br />
	[[Category: Heightfield Operators]]		[[Category: Heightfield Operators]]

Redmaw: Added descriptions and example images for Heightfield Crop.

2021-01-03T08:24:59Z

Added descriptions and example images for Heightfield Crop.

@@ Line 1: / Line 1: @@
-[[Image:drex_module_182_image_0.png|485pxpx|Heightfield Crop]]
+[[File:HFCrop_GUI.png|none|470px|Heightfield Crop]]
 [[Category: Heightfield Operators]]
-'''Node Type:''' Heightfield Operator<br />
+Here the image has been applied as a heightfield.
-'''Settings:'''<br />
+<br />
 <ul>
-<li>
+[[File:HFCrop_10_TopRight.jpg|none|800px|Top right examples.]]
 </ul>
 [[Category: Heightfield Operators]]

JavaJones at 21:38, 17 April 2012

2012-04-17T21:38:02Z

← Older revision		Revision as of 21:38, 17 April 2012
Line 2:		Line 2:

	<!-- imported from file: module_182.html-->		<!-- imported from file: module_182.html-->

			[[Category: Heightfield Operators]]

			'''Node Description and Purpose:'''<br />
			The Heightfield Crop node can be used to crop the area of the heighfield it's attached to.


			'''Node Type:''' Heightfield Operator<br />


			'''Settings:'''<br />
			<ul>
			<li>
			'''Crop check box:''' If this is checked then the crop function will be applied; uncheck it to disable the effect. The settings below and to the right control how the heightfield will be cropped.
			</li><li>
			'''Bottom left:''' TBC
			</li><li>
			'''Top right:''' TBC
			</li><li>
			'''Include top right check box:''' TBC
			</li><li>
			'''Pad outside original check box:''' TBC
			</li>
			</ul>


	[[Category: Heightfield Operators]]		[[Category: Heightfield Operators]]

JavaJones at 18:43, 1 June 2011

2011-06-01T18:43:40Z

← Older revision		Revision as of 18:43, 1 June 2011
Line 3:		Line 3:
	<!-- imported from file: module_182.html-->		<!-- imported from file: module_182.html-->

	[[Category: Heightfield Operators\| ]]		[[Category: Heightfield Operators]]

JavaJones at 02:29, 18 May 2011

2011-05-18T02:29:22Z

← Older revision		Revision as of 02:29, 18 May 2011
Line 1:		Line 1:
	[[~~Category~~:~~IMPORT~~]]		[[Image:drex_module_182_image_0.png\|485pxpx\|Heightfield Crop]]
	~~='''Heightfield Crop'''=~~

	~~[[Image:drex_module_182_image_0.png\|485pxpx\|Heightfield Crop]]~~
	~~__NOTOC__~~
	<!-- imported from file: module_182.html-->		<!-- imported from file: module_182.html-->

			[[Category: Heightfield Operators\| ]]

127.0.0.1: jrfconvert import

2010-07-11T02:55:19Z

jrfconvert import

New page

[[Category:IMPORT]]
='''Heightfield Crop'''=

[[Image:drex_module_182_image_0.png|485pxpx|Heightfield Crop]]
__NOTOC__