Tools

Vertex Groups Generate/Update

_images/tools_intro.png

Mirage generates vertex groups to store information about the terrain. These weight groups are also automatically converted into color vertex groups to use in Cycles. You can use the buttons included in the tools panel to update the groups after you have made changes to the terrain.

They can also be used to add vertex groups to other meshes, or purely sculpted terrains.

Export Vertex Group to Image

_images/vgroups_exported.jpg

Exports a specific mirage vertex group to a greyscale image. Values will range from 0 (black) to 1 (white).

The image will contain as many pixels as vertices in the terrain, so the image size will be the square root of the vertex count. For example, a terrain of 65,536 vertices (medium detail) will create vertex group images of 256x256 pixels.

Export Heightmap

_images/export_heightmap.jpg

Export the terrain as a greyscale image. Each value in this image will represent the height of a specific vertex in the terrain, with 0 (black) being the lowest point of the terrain and 1 (white) the highest.

Heightmaps can be edited in any 2D editor (like GIMP and Krita), and they can be imported into meshes by many 3D editors and applications.

The images are saved as image datablocks in Blender. You can find them by going into the UV/Image Editor and finding the image called “Heightmap”.

You can also choose to split the heightmap into several smaller images. The options range from a 2x2 grid (4 images) up to 32x32 (64 images). When exported these images will be named like “[NAME]_x0_y0” where x0 and y0 are numbers representing the position of the image in the grid.

Note

Mirage doesn’t support generating heightmaps larger than terrains at the moment.

Warning

Note that the image has a fake user but it is not automatically saved! If you don’t pack it or save it to an external file before closing, Blender will lose the contents of the image.

Export terrain as data

Export the terrain as a list of heights.

The exported data is saved as a Text datablock. You can find it by going into the Text Editor and selecting “Terrain_data.py”.

Option

Description

List

A flattened list of heights

2D List

A list of rows containing a list of columns which contain the heights

Encoding

Description

Python List

Saves the list as a simple python list (can also be used for JSON)

CSV

Save the list as comma-separated values

Export distribution layers

Export distribution layer as data or an image (splat map).

Format

Description

Python List

A simple python list of coordinates (can also be used for JSON)

CSV

Save the list as comma-separated values

Splat map

An image where every white pixel represents an object in the terrain

Option

Description

Layer

Number of the distribution layer to export

Export all Layers

Export all distribution layers in sequence

Use World Coordinates

Use world or object coordinates

Discard Z Axis

Remove Z axis (height) from coordinates

Note

The last two options have no effect on splat maps