# Primitive

## Overview <a href="#overview" id="overview"></a>

Primitive Layers provide the ability to quickly add simple geometric shapes to the base of your terrain.

## Video Guide

{% embed url="<https://vimeo.com/1029705546>" %}
World Creator Guide
{% endembed %}

### Available Primitive Layers <a href="#different-shape-types" id="different-shape-types"></a>

At the moment these Primitive Shapes are available inside of World Creator. Future updates might include new types, if you require specific shapes let us know on the discord server.

### Circle

{% tabs %}
{% tab title="Result" %}

<div><figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FHPJwZoymWRJMkiuEUTun%2Freference_shapelayers_primitives_circle_01.webp?alt=media&#x26;token=a9421183-4362-4b0a-a795-ec03936e0fc0" alt=""><figcaption></figcaption></figure> <figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2Fbhq5id81NOX3wh4lltnN%2Freference_shapelayers_primitives_circle_02.webp?alt=media&#x26;token=78ac1d48-b65c-44a8-974a-bd30806272f3" alt=""><figcaption></figcaption></figure> <figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FVwUm0T3e8fsttBd77kpl%2Freference_shapelayers_primitives_circle_03.webp?alt=media&#x26;token=f93831fa-29bc-4ad1-b8d9-f4109b1f99d3" alt=""><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Parameters" %}

<table><thead><tr><th width="200.4832763671875">Property</th><th>Description</th></tr></thead><tbody><tr><td><strong>Curve</strong></td><td>Controls the curvature of the falloff.</td></tr><tr><td><strong>Falloff</strong></td><td>Controls the width of the falloff.</td></tr><tr><td><strong>Opening</strong></td><td>Allows you to cut out a section of the circle.</td></tr><tr><td><strong>Base Offset</strong></td><td>Shifts the base terrain that is not the shape to make operations like <strong>Min/Max</strong> more useful. </td></tr></tbody></table>
{% endtab %}
{% endtabs %}

### Donut

{% tabs %}
{% tab title="Result" %}

<div><figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FXSWgXNKAsRSe6HyLT01i%2Freference_shapelayers_primitives_donut_01.webp?alt=media&#x26;token=d8f5c5c0-e64c-41fa-821b-6d77536d8845" alt=""><figcaption></figcaption></figure> <figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FBgtdFxZybk2xVohVRCSJ%2Freference_shapelayers_primitives_donut_02.webp?alt=media&#x26;token=5c1225c4-f537-4c4b-b573-ee6309cf0f2b" alt=""><figcaption></figcaption></figure> <figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FTuq49xtWsbi3ZDxRU6PD%2Freference_shapelayers_primitives_donut_03.webp?alt=media&#x26;token=e478804c-659e-49b8-a1c7-288dcb716677" alt=""><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Parameters" %}

<table><thead><tr><th width="200.4832763671875">Property</th><th>Description</th></tr></thead><tbody><tr><td><strong>Curve</strong></td><td>Controls the curvature of the falloff.</td></tr><tr><td><strong>Falloff</strong></td><td>Controls the width of the falloff.</td></tr><tr><td><strong>Opening</strong></td><td>Allows you to cut out a section of the donut.</td></tr><tr><td><strong>Hole</strong></td><td>Controls the size of the hole.</td></tr><tr><td><strong>Base Offset</strong></td><td>Shifts the base terrain that is not the shape to make operations like <strong>Min/Max</strong> more useful. </td></tr></tbody></table>
{% endtab %}
{% endtabs %}

### Gradient

{% tabs %}
{% tab title="Result" %}

<div><figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FhVHODxMnVlD71p1s8AjI%2Freference_shapelayers_primitives_gradient_01.webp?alt=media&#x26;token=cb3a727f-b3cf-4f33-ad6c-0ac301df8ff5" alt=""><figcaption></figcaption></figure> <figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FDz1Tf12F4v23xdHHeUZv%2Freference_shapelayers_primitives_gradient_02.webp?alt=media&#x26;token=fcc0a345-1f8e-4421-9a25-3b7e319d8040" alt=""><figcaption></figcaption></figure> <figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FaWJztqmofD2HhK3te6ga%2Freference_shapelayers_primitives_gradient_03.webp?alt=media&#x26;token=e19400b4-97c2-412c-bc4a-b089e50d69d0" alt=""><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Parameters" %}

<table><thead><tr><th width="200.4832763671875">Property</th><th>Description</th></tr></thead><tbody><tr><td><strong>Curve</strong></td><td>Controls the curvature of the gradient.</td></tr><tr><td><strong>Center</strong></td><td>Allows you to position the top end of the gradient.</td></tr><tr><td><strong>Tiling</strong></td><td>Tiles the gradient.</td></tr><tr><td><strong>Tiling Offset</strong></td><td>Shifts the tiled gradient.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

### Helix

{% tabs %}
{% tab title="Result" %}

<div><figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2F09e1CE85YK6DmBa8P4zn%2Freference_shapelayers_primitives_helix_01.webp?alt=media&#x26;token=d09921e6-45d6-4fc2-b26a-5e0299766e82" alt=""><figcaption></figcaption></figure> <figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FpGeVHZLRL6CjkiU3rNPq%2Freference_shapelayers_primitives_helix_02.webp?alt=media&#x26;token=c941ac2f-0b34-44af-8886-3567e0d8873f" alt=""><figcaption></figcaption></figure> <figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FqoQNnIVpnh73lMNmWlRL%2Freference_shapelayers_primitives_helix_03.webp?alt=media&#x26;token=7a441761-b000-4451-a770-5621a31ca716" alt=""><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Parameters" %}

<table><thead><tr><th width="200.4832763671875">Property</th><th>Description</th></tr></thead><tbody><tr><td><strong>Curve</strong></td><td>Controls the curvature of the falloff.</td></tr><tr><td><strong>Falloff</strong></td><td>Controls the width of the falloff.</td></tr><tr><td><strong>Helix</strong></td><td>Adds a height difference between the start and end point of the circle to create a gradient.</td></tr><tr><td><strong>Base Offset</strong></td><td>Shifts the base terrain that is not the shape to make operations like <strong>Min/Max</strong> more useful. </td></tr></tbody></table>
{% endtab %}
{% endtabs %}

### Polygon

{% tabs %}
{% tab title="Result" %}

<div><figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FVuwfVX5HWhb0MTG23xno%2Freference_shapelayers_primitives_polygon_01.webp?alt=media&#x26;token=28fc259e-e08c-4943-9ddb-74a62479a696" alt=""><figcaption></figcaption></figure> <figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2Fqp8Jcq08Jiz74Tm4HvkU%2Freference_shapelayers_primitives_polygon_02.webp?alt=media&#x26;token=16f3819b-1c27-4b01-9fea-e9597dbd8658" alt=""><figcaption></figcaption></figure> <figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FdqdngaOVF425JXB0qfWa%2Freference_shapelayers_primitives_polygon_03.webp?alt=media&#x26;token=52824d5f-dc1a-4cd5-ab2b-e6d9c091d704" alt=""><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Parameters" %}

<table><thead><tr><th width="200.4832763671875">Property</th><th>Description</th></tr></thead><tbody><tr><td><strong>Corners</strong></td><td>Controls the corners of the polygon.</td></tr><tr><td><strong>Falloff</strong></td><td>Controls the width of the falloff.</td></tr><tr><td><strong>Curve</strong></td><td>Controls the curvature of the falloff.</td></tr><tr><td><strong>Base Offset</strong></td><td>Shifts the base terrain that is not the shape to make operations like <strong>Min/Max</strong> more useful. </td></tr></tbody></table>
{% endtab %}
{% endtabs %}

### Square

{% tabs %}
{% tab title="Result" %}

<div><figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FBWrLhIFbwQWbEuvAuus0%2Freference_shapelayers_primitives_square_01.webp?alt=media&#x26;token=81e49691-3bee-4bf3-a754-4313084ef28c" alt=""><figcaption></figcaption></figure> <figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FQdhKgRw0upkAKl6ytv0f%2Freference_shapelayers_primitives_square_02.webp?alt=media&#x26;token=4f32b8ae-061a-4a10-958f-fa16cabd7313" alt=""><figcaption></figcaption></figure> <figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FRlcMNk70NgbhxEy9J74M%2Freference_shapelayers_primitives_square_03.webp?alt=media&#x26;token=7bef114e-d30d-43f2-9430-95d4bfdb1c78" alt=""><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Parameters" %}

<table><thead><tr><th width="200.4832763671875">Property</th><th>Description</th></tr></thead><tbody><tr><td><strong>Round Corners</strong></td><td>Rounds the corners of the square.</td></tr><tr><td><strong>Falloff</strong></td><td>Controls the width of the falloff.</td></tr><tr><td><strong>Curve</strong></td><td>Controls the curvature of the falloff.</td></tr><tr><td><strong>Base Offset</strong></td><td>Shifts the base terrain that is not the shape to make operations like <strong>Min/Max</strong> more useful. </td></tr></tbody></table>
{% endtab %}
{% endtabs %}

### Star

{% tabs %}
{% tab title="Result" %}

<div><figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2F75eWQLVuEE2GxqnrLUYm%2Freference_shapelayers_primitives_star_01.webp?alt=media&#x26;token=f0ca820a-4a73-49b3-b9c3-f25f3e7a0279" alt=""><figcaption></figcaption></figure> <figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2F64Ze9keCShoj5eCgXdWC%2Freference_shapelayers_primitives_star_02.webp?alt=media&#x26;token=c8a126b6-bb4a-4c1f-aea3-c4b8da0c8007" alt=""><figcaption></figcaption></figure> <figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2Fo3PzVjj1tX5X1RDrHlQr%2Freference_shapelayers_primitives_star_03.webp?alt=media&#x26;token=e6e24800-61b8-41dd-9913-7b6743d267b8" alt=""><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Parameters" %}

<table><thead><tr><th width="200.4832763671875">Property</th><th>Description</th></tr></thead><tbody><tr><td><strong>Corners</strong></td><td>Controls the amount of corners of the star.</td></tr><tr><td><strong>Intrusion</strong></td><td>Controls how far in the star inner corners go.</td></tr><tr><td><strong>Falloff</strong></td><td>Controls the width of the falloff.</td></tr><tr><td><strong>Curve</strong></td><td>Controls the curvature of the falloff.</td></tr><tr><td><strong>Base Offset</strong></td><td>Shifts the base terrain that is not the shape to make operations like <strong>Min/Max</strong> more useful. </td></tr></tbody></table>
{% endtab %}
{% endtabs %}