World Editor: Terrain Creation Tool – Arma Reforger
Lou Montana (talk | contribs) m (Text replacement - " " to " ") |
Lou Montana (talk | contribs) m (Some wiki formatting) |
||
(4 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{TOC|side}} | {{TOC|side}} | ||
{{Feature|important|Before anything: '''save frequently'''. After height map importation, normal maps, terrain texture and layer maps import/generation as they are '''not''' saved to file after the operation.}} | |||
{{ | |||
= | == Manage == | ||
== Common | === Height Map === | ||
The height map is terrain altitude's information. World Editor can work with both {{hl|.asc}} and 16-bit {{hl|.png}} height map files. | |||
The section offers options to import, export, and rebuild the height map. | |||
==== Import Height Map ==== | |||
This option allows to import a height map from an external source or a World Editor export. | |||
It allows to '''invert in X and Z axis''', importing the terrain "from right to left" (a hill being West of the terrain would be East) or "from bottom to top" (South would be North). | |||
Ticking both corresponds to a 180° terrain rotation. | |||
The '''resampling heights''' option allows to override the terrain's altitude range by linear interpolation. It is required for png import as the png format only holds ''relative'' | |||
{| class="wikitable align-center" | |||
|+ Example | |||
|- | |||
! Original (-10 to +10m range) | |||
| -10 | |||
| -5 | |||
| 0 | |||
| 1 | |||
| 5 | |||
| 10 | |||
|- | |||
! Imported (0 to +100m range) | |||
| 0 | |||
| 25 | |||
| 50 | |||
| 55 | |||
| 75 | |||
| 100 | |||
|} | |||
==== Export Height Map ==== | |||
The '''Base'''/'''Modified''' option targets the terrain's height map - either the base terrain one, or the one modified by e.g road generators and other entities that edit terrain through script. | |||
==== Rebuild Height Map ==== | |||
This button allows to rebuild the height map manually in the event it is not synchronised properly with the actual data (road, building placements). | |||
==== Bake Selection ==== | |||
This "bakes" the selected entities' terrain modification into the base height map. | |||
For example: if a building is placed on a slope, it flattens the terrain by default; this flattening follows the building and is destroyed with the building. | |||
With this button the building's flattening is stored into the height map and will remain even if that building is moved or deleted. | |||
==== Generate Normal Map ==== | |||
Allows to (re)generate the terrain's normal map. Normal map interpolation settings (minimum and maximum angle for vertex interpolation) are only available when the Interpolation Mode option is set to {{hl|Auto}}. | |||
=== Satellite Map === | |||
==== Import satellite map ==== | |||
This imports a satellite map for the terrain, used for long-distance terrain texture. | |||
=== Surface Map === | |||
==== Fix block border ==== | |||
This is to be used if hard edges between textures of neighbouring terrain blocks appear. | |||
==== Change surface map size ==== | |||
==== Rebuild terrain materials ==== | |||
'''Rebuild terrain materials''' must be run if a layer map reimport goes wrong - in the event of wrong or missing clutter or when terrain material tracing does not work properly. | |||
=== Options === | |||
<!-- '''Terrain tool step edit only''' checkbox --> | |||
=== Tile Map === | |||
The Tile Map is an overhead map of the terrain tiles. | |||
==== Minimap Controls ==== | |||
Hold {{Controls|RMB}} to drag the map around. | |||
===== Scale To Fit ===== | |||
Fit the minimap to the view widget. | |||
===== Center on Camera ===== | |||
Move the minimap so the camera position is centered. | |||
===== Claim Tiles ===== | |||
Lock tiles so only your account can work on them. | |||
===== Release Tiles ===== | |||
Release tiles so everyone can work on them. | |||
===== Cogwheel ===== | |||
; Set Background Image | |||
Set the minimap's texture. | |||
{{Feature|informative|See also [[Arma Reforger:2D Map Creation|2D Map Creation]].}} | |||
; Clear Background Image | |||
Remove the minimap's texture. | |||
== Sculpt == | |||
=== Common Values === | |||
'''Strength''': strength of the effect - range 0..500 | '''Strength''': strength of the effect - range 0..500 | ||
Line 18: | Line 114: | ||
'''Angle''': the effect angle - range 0..360 | '''Angle''': the effect angle - range 0..360 | ||
== Common Controls == | === Common Controls === | ||
{| class="wikitable" | {| class="wikitable valign-top" | ||
! Controls | ! Controls | ||
! Effect | ! Effect | ||
Line 40: | Line 136: | ||
|} | |} | ||
<gallery mode="packed" heights="200px"> | |||
File:armareforger-world_editor_terrain_tool_brush_linear.png|Linear | |||
File:armareforger-world_editor_terrain_tool_brush_smooth.png|Smooth | |||
File:armareforger-world_editor_terrain_tool_brush_sphere.png|Sphere | |||
File:armareforger-world_editor_terrain_tool_brush_inverted_sphere.png|Inv-Sphere | |||
</gallery> | |||
== Sculpt == | |||
<gallery mode="packed" heights="200px"> | |||
File:armareforger-world_editor_terrain_tool_brush_round.png|Round | |||
File:armareforger-world_editor_terrain_tool_brush_rect.png|Rect | |||
File:armareforger-world_editor_terrain_tool_brush_rect.png|User<ul style="text-align: left"><li>shown shape is identical to '''Rect'''<li>Falloff does not impact the result<li>Looks into the Data\Brushes directory</ul> | |||
</gallery> | |||
<gallery mode="packed" heights="200px"> | |||
File:armareforger-world_editor_terrain_tool_brush_falloff_small.png|Falloff (small) | |||
File:armareforger-world_editor_terrain_tool_brush_falloff_medium.png|Falloff (medium) | |||
File:armareforger-world_editor_terrain_tool_brush_falloff_large.png|Falloff (large) | |||
</gallery> | |||
=== Sculpt === | |||
{{Controls|LMB}} raises terrain according to Strength. | {{Controls|LMB}} raises terrain according to Strength. | ||
Line 47: | Line 163: | ||
{{Controls|Alt|LMB}} lowers the terrain. | {{Controls|Alt|LMB}} lowers the terrain. | ||
=== Flatten === | |||
== Flatten == | |||
Sets the terrain to a defined Height. '''Space''' picks the height of the current terrain position under the cursor. | Sets the terrain to a defined Height. '''Space''' picks the height of the current terrain position under the cursor. | ||
=== Smooth === | |||
== Smooth == | |||
Softens edges. | Softens edges. | ||
=== Noise === | |||
Generates Perlin-based terrain noise. | |||
== Paint == | |||
= Paint = | |||
A specific terrain tool used for painting surface materials on terrain ground. | A specific terrain tool used for painting surface materials on terrain ground. | ||
Line 108: | Line 187: | ||
--> | --> | ||
{| class="wikitable" | {| class="wikitable valign-top" | ||
! Feature | ! Feature | ||
! Screenshot | ! Screenshot | ||
Line 114: | Line 193: | ||
|- | |- | ||
| | | | ||
== Basic Brush Settings == | === Basic Brush Settings === | ||
| [[File:armareforger-world_editor_terrain_tool_paint_basic_brush_settings.png]] | | [[File:armareforger-world_editor_terrain_tool_paint_basic_brush_settings.png]] | ||
| '''Show diagnostics for block under cursor''' – this option enables a simple surface layer list per block tab in World Editor viewport when using Paint tool and hovering over terrain. Information about block under cursor will be shown. Useful as an overview to manage surfaces in multiple blocks efficiently while painting. | | '''Show diagnostics for block under cursor''' – this option enables a simple surface layer list per block tab in World Editor viewport when using Paint tool and hovering over terrain. | ||
{{Feature|informative|See the {{ | Information about block under cursor will be shown. Useful as an overview to manage surfaces in multiple blocks efficiently while painting. | ||
{{Feature|informative|See the {{Link|#Sculpt}} section above for more information.}} | |||
==== Strength ==== | |||
range: 0..40 | range: 0..40 | ||
Strength of the brush. {{Controls|Shift|MouseUp}}/{{Controls|Shift|MouseDown}} to adjust. | Strength of the brush. {{Controls|Shift|MouseUp}}/{{Controls|Shift|MouseDown}} to adjust. | ||
=== Radius === | ==== Radius ==== | ||
range: 0..200 | range: 0..200 | ||
Radius of the brush. {{Controls|Ctrl|MouseUp}}/{{Controls|Ctrl|MouseDown}} to adjust. | Radius of the brush. {{Controls|Ctrl|MouseUp}}/{{Controls|Ctrl|MouseDown}} to adjust. | ||
=== Falloff === | ==== Falloff ==== | ||
range: 0..100 | range: 0..100 | ||
Fadeout of the brush. {{Controls|Ctrl|Shift|MouseUp}}/{{Controls|Ctrl|Shift|MouseDown}} to adjust. | Fadeout of the brush. {{Controls|Ctrl|Shift|MouseUp}}/{{Controls|Ctrl|Shift|MouseDown}} to adjust. | ||
=== Angle === | ==== Angle ==== | ||
range: 0..360 | range: 0..360 | ||
Line 144: | Line 220: | ||
|- | |- | ||
| | | | ||
== Brush Shape and Type == | === Brush Shape and Type === | ||
| [[File:armareforger-world_editor_terrain_tool_paint_brush_shape_and_type.png]] | | [[File:armareforger-world_editor_terrain_tool_paint_brush_shape_and_type.png]] | ||
| | | | ||
Line 151: | Line 227: | ||
|- | |- | ||
| | | | ||
== Surface Layer List == | === Surface Layer List === | ||
| [[File:armareforger-world_editor_terrain_tool_paint_surface_layer_list.png]] | | [[File:armareforger-world_editor_terrain_tool_paint_surface_layer_list.png]] | ||
| | | | ||
* Surface layer list – A simple drag & drop list of surface materials. These can be dropped from either Workbench or World Editor's Resource Browser. | * Surface layer list – A simple drag & drop list of surface materials. These can be dropped from either Workbench or World Editor's Resource Browser. | ||
* The very first surface layer is always used as default and while it can not be removed or imported, it can be changed to a different one. In this scenario, Grass_03 is used as a default surface. When masks are stored in game files, they are all merged together. Any information that is remaining from the resulting merged mask is used as default layer. | * The very first surface layer is always used as default and while it can not be removed or imported, it can be changed to a different one. | ||
In this scenario, Grass_03 is used as a default surface. When masks are stored in game files, they are all merged together. Any information that is remaining from the resulting merged mask is used as default layer. | |||
|- | |- | ||
| | | | ||
== Basic Painting == | === Basic Painting === | ||
| {{Wiki|TODO}} | | {{Wiki|TODO}} | ||
| | | | ||
|- | |- | ||
| | | | ||
== Extra Surface Layer Operations == | === Extra Surface Layer Operations === | ||
| [[File:armareforger-world_editor_terrain_tool_paint_extra_surface_layer_operations.png]]<br> | | [[File:armareforger-world_editor_terrain_tool_paint_extra_surface_layer_operations.png]]<br> | ||
[[File:armareforger-world_editor_terrain_tool_paint_extra_surface_layer_operations_path.png]] | [[File:armareforger-world_editor_terrain_tool_paint_extra_surface_layer_operations_path.png]] | ||
Line 178: | Line 255: | ||
* A simple batch import and export feature for surface masks is also available – these options work with masks from all surfaces at once. | * A simple batch import and export feature for surface masks is also available – these options work with masks from all surfaces at once. | ||
''All surface masks are in a .png format and for the best results a predetermined sizing should be followed – this information can be found in the {{ | ''All surface masks are in a .png format and for the best results a predetermined sizing should be followed – this information can be found in the {{Link|#Info & Diags}} tab (section below).'' | ||
|} | |} | ||
= Info & Diags = | == Holes == | ||
Holes are a way to '''hide''' the terrain. One can create a hole or disable a block for that. | |||
{{Feature|informative|The invisible terrain is '''still''' walkable.}} | |||
=== Options === | |||
==== Show terrain in holes and disabled blocks ==== | |||
If ticked, the terrain in holes and disabled blocks will appear. | |||
==== Show holes diag ==== | |||
Highlight the holes. | |||
==== Show disabled blocks diag ==== | |||
Highlight the disabled blocks. | |||
== Info & Diags == | |||
This tab contains useful info about blocks and their surface layers. These diagnostics also allow either manual merging or replacing of surface layers in specific blocks. | This tab contains useful info about blocks and their surface layers. These diagnostics also allow either manual merging or replacing of surface layers in specific blocks. | ||
{| class="wikitable" | {| class="wikitable valign-top" | ||
! Step | ! Step | ||
! Screenshot | ! Screenshot | ||
Line 192: | Line 286: | ||
|- | |- | ||
| | | | ||
=== Block and Pixel Under Cursor Diagnostics === | |||
| [[File:armareforger-world_editor_terrain_tool_info_n_diags_block_and_pixel_under_cursor_diagnostics.png]] | | [[File:armareforger-world_editor_terrain_tool_info_n_diags_block_and_pixel_under_cursor_diagnostics.png]] | ||
| | | | ||
Line 198: | Line 292: | ||
* While in '''Info & Diags''' tab, you can press Ctrl+X in World Editor's viewport to visualize surface layers painted on the terrain ground. Diagnostic colors are set in each surface layer. | * While in '''Info & Diags''' tab, you can press Ctrl+X in World Editor's viewport to visualize surface layers painted on the terrain ground. Diagnostic colors are set in each surface layer. | ||
==== Block ==== | |||
== Block == | |||
** '''Live (under cursor)''' – diagnostics will describe the block actually under cursor in World Editor's viewport. If the tile is clicked then this checkbox becomes unticked. | ** '''Live (under cursor)''' – diagnostics will describe the block actually under cursor in World Editor's viewport. If the tile is clicked then this checkbox becomes unticked. | ||
** '''Camera auto-align''' – when a block is selected, camera will automatically align to it. | ** '''Camera auto-align''' – when a block is selected, camera will automatically align to it. | ||
Line 206: | Line 298: | ||
** Percentage list determines the mask coverage of a surface layer in a selected block. These percentages work with surface layer mask blending as well, meaning that the total value can be up to 500%. | ** Percentage list determines the mask coverage of a surface layer in a selected block. These percentages work with surface layer mask blending as well, meaning that the total value can be up to 500%. | ||
==== Pixel Under Cursor ==== | |||
== Pixel Under Cursor == | |||
** '''Coordinates''' – same as above. | ** '''Coordinates''' – same as above. | ||
** The Pixel Surface statistics list shows surface layers per pixel. The range is set from 0 to 255 (black - white) and always add up to '''255'''. It is possible to determine exactly which pixel contains what surface layers through this data. | ** The Pixel Surface statistics list shows surface layers per pixel. The range is set from 0 to 255 (black - white) and always add up to '''255'''. It is possible to determine exactly which pixel contains what surface layers through this data. | ||
|- | |- | ||
| | | | ||
=== Basic Surface Diagnostics === | |||
| [[File:armareforger-world_editor_terrain_tool_info_n_diags_basic_surface_diagnostics.png]] | | [[File:armareforger-world_editor_terrain_tool_info_n_diags_basic_surface_diagnostics.png]] | ||
| | | | ||
Line 224: | Line 314: | ||
|- | |- | ||
| | | | ||
=== Surface Layer Merge or Replace Operations === | |||
| {{Wiki|TODO|Add graphic element?}} | | {{Wiki|TODO|Add graphic element?}} | ||
| | | | ||
Line 233: | Line 323: | ||
# If there is a red square in the 3x3 grid, the 5 surface layer limit is reached in that block and it needs to be processed by further merging surface layers there to empty the slot. | # If there is a red square in the 3x3 grid, the 5 surface layer limit is reached in that block and it needs to be processed by further merging surface layers there to empty the slot. | ||
|} | |} | ||
{{GameCategory|armaR|Modding|Official Tools|World Editor Tools}} | {{GameCategory|armaR|Modding|Official Tools|World Editor Tools}} |
Latest revision as of 20:42, 5 September 2023
Manage
Height Map
The height map is terrain altitude's information. World Editor can work with both .asc and 16-bit .png height map files. The section offers options to import, export, and rebuild the height map.
Import Height Map
This option allows to import a height map from an external source or a World Editor export.
It allows to invert in X and Z axis, importing the terrain "from right to left" (a hill being West of the terrain would be East) or "from bottom to top" (South would be North). Ticking both corresponds to a 180° terrain rotation.
The resampling heights option allows to override the terrain's altitude range by linear interpolation. It is required for png import as the png format only holds relative
Original (-10 to +10m range) | -10 | -5 | 0 | 1 | 5 | 10 |
---|---|---|---|---|---|---|
Imported (0 to +100m range) | 0 | 25 | 50 | 55 | 75 | 100 |
Export Height Map
The Base/Modified option targets the terrain's height map - either the base terrain one, or the one modified by e.g road generators and other entities that edit terrain through script.
Rebuild Height Map
This button allows to rebuild the height map manually in the event it is not synchronised properly with the actual data (road, building placements).
Bake Selection
This "bakes" the selected entities' terrain modification into the base height map.
For example: if a building is placed on a slope, it flattens the terrain by default; this flattening follows the building and is destroyed with the building. With this button the building's flattening is stored into the height map and will remain even if that building is moved or deleted.
Generate Normal Map
Allows to (re)generate the terrain's normal map. Normal map interpolation settings (minimum and maximum angle for vertex interpolation) are only available when the Interpolation Mode option is set to Auto.
Satellite Map
Import satellite map
This imports a satellite map for the terrain, used for long-distance terrain texture.
Surface Map
Fix block border
This is to be used if hard edges between textures of neighbouring terrain blocks appear.
Change surface map size
Rebuild terrain materials
Rebuild terrain materials must be run if a layer map reimport goes wrong - in the event of wrong or missing clutter or when terrain material tracing does not work properly.
Options
Tile Map
The Tile Map is an overhead map of the terrain tiles.
Minimap Controls
Hold to drag the map around.
Scale To Fit
Fit the minimap to the view widget.
Center on Camera
Move the minimap so the camera position is centered.
Claim Tiles
Lock tiles so only your account can work on them.
Release Tiles
Release tiles so everyone can work on them.
Cogwheel
- Set Background Image
Set the minimap's texture.
- Clear Background Image
Remove the minimap's texture.
Sculpt
Common Values
Strength: strength of the effect - range 0..500
Height (in Flatten mode): wanted terrain's absolute height
Radius: radius (in metres) range 0..200
Falloff: the "cone/cylinder" slope ratio (see below) - range 0..100
Angle: the effect angle - range 0..360
Common Controls
Controls | Effect |
---|---|
⇧ Shift + Mouse up ⇧ Shift + Mouse down |
Set strength/height |
Ctrl + Mouse up Ctrl + Mouse down |
Set radius |
Ctrl + ⇧ Shift + Mouse up Ctrl + ⇧ Shift + Mouse down |
Set falloff |
Ctrl + ⇧ Shift + Mousewheel | Set angle |
Sculpt
raises terrain according to Strength.
Alt + lowers the terrain.
Flatten
Sets the terrain to a defined Height. Space picks the height of the current terrain position under the cursor.
Smooth
Softens edges.
Noise
Generates Perlin-based terrain noise.
Paint
A specific terrain tool used for painting surface materials on terrain ground.
- Paint tool is used for painting surface materials on a terrain ground with an adjustable brush. All paint brush properties can be set in the same tab.
- Information where each surface material is painted is stored as a mask inside game files upon saving a project. However, it is possible to both import and export each surface's mask in a .png file.
- As of Arma Reforger v0.9.5 there is a limit of 5 surfaces per block for a terrain.
Feature | Screenshot | Description |
---|---|---|
Basic Brush Settings |
Show diagnostics for block under cursor – this option enables a simple surface layer list per block tab in World Editor viewport when using Paint tool and hovering over terrain.
Information about block under cursor will be shown. Useful as an overview to manage surfaces in multiple blocks efficiently while painting. Strengthrange: 0..40 Strength of the brush. ⇧ Shift + MouseUp/⇧ Shift + MouseDown to adjust. Radiusrange: 0..200 Radius of the brush. Ctrl + MouseUp/Ctrl + MouseDown to adjust. Falloffrange: 0..100 Fadeout of the brush. Ctrl + ⇧ Shift + MouseUp/Ctrl + ⇧ Shift + MouseDown to adjust. Anglerange: 0..360 Rotation of the brush – useful for rectangular or user brushes. | |
Brush Shape and Type |
| |
Surface Layer List |
In this scenario, Grass_03 is used as a default surface. When masks are stored in game files, they are all merged together. Any information that is remaining from the resulting merged mask is used as default layer. | |
Basic Painting |
||
Extra Surface Layer Operations |
All surface masks are in a .png format and for the best results a predetermined sizing should be followed – this information can be found in the Info & Diags tab (section below). |
Holes
Holes are a way to hide the terrain. One can create a hole or disable a block for that.
Options
Show terrain in holes and disabled blocks
If ticked, the terrain in holes and disabled blocks will appear.
Show holes diag
Highlight the holes.
Show disabled blocks diag
Highlight the disabled blocks.
Info & Diags
This tab contains useful info about blocks and their surface layers. These diagnostics also allow either manual merging or replacing of surface layers in specific blocks.