> For the complete documentation index, see [llms.txt](https://ezedits.gitbook.io/ezedits/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ezedits.gitbook.io/ezedits/commands/placement/placement-parameters.md).

# Placement Parameters

Whenever a structure is placed, it goes through the following pipeline (in that order):

* [Applying Dimensions](#dimensions-s) (`-s`)
* [Random Scaling](#random-scaling-o) (`-t`)
* [Orientation](#orientation-c-k) (`-c` and `-k`)
* [Random Flips](#random-flips-f) (`-f`)
* [Random 90° Rotations](#random-rotations-r) (`-r`)
* [**Alignment**](/ezedits/commands/placement/primary+secondary-alignment.md) (`<primary>` and `<secondary>`)

ezEdits lets you fully customize this pipeline. In brackets are the flags and arguments that apply changes to each step respectively.

***

### Controlling Dimensions: <mark style="color:orange;">`-s <dimensions>`</mark> <a href="#dimensions-s" id="dimensions-s"></a>

The dimensions define the size of a structure placement, by setting its bounding box size.

The flag `-s <dimensions>` sets the desired absolute base dimensions of the placement (overriding the default values).

By default, expression-based structures have dimensions `20,20,20`, while Schematic/Clipboard structures are placed with their inherent original dimensions.

{% hint style="info" %}
The structure might appear **stretched** or **compressed** depending on your choice of values.
{% endhint %}

<details>

<summary><mark style="color:blue;">Example</mark></summary>

For example, if your clipboard is inherently of size 5x7x5, then setting the dimensions as `-s 5,14,5` will stretch out the structure placement along its y-axis:

First image: `//ezsc Clipboard -s 5,7,5` (original clipboard size)

Second image: `//ezsc Clipboard -s 5,14,5`

![](/files/WrDLEXyCwpoix8zuwdR1) ![](/files/3RQk6tN5hLztaCym4azx)

</details>

***

### Random Scaling: <mark style="color:orange;">`-o <sizeMultiplierRange>`</mark> <a href="#random-scaling-o" id="random-scaling-o"></a>

Most of the structure commands place multiple structure placements at once. To give a bit of variety you can apply some random scaling for each placement.

The `-o <sizeMultiplierRange>` applies random scaling for each placement. You specify a range of values. A random number from this range is chosen as the scaling factor for each placement.

By default, the range is `1,1`, meaning the scaling factor is always 1, and thus, does nothing.

<details>

<summary><mark style="color:blue;">Example</mark></summary>

By setting the range as `-o 0.5,2.0` we get placements of e.g. our clipboard at random sizes between half the desired size and double the desired size,

`//ezsc Clipboard -o 0.5,2.0`

<img src="/files/yFQiPdHgty5AO32xGwzk" alt="" data-size="original">

(Same tree clipboard at various different sizes)

</details>

***

### Random Flips: <mark style="color:orange;">`-f <randomFlipsAxes>`</mark> <a href="#random-flips-f" id="random-flips-f"></a>

The `-f <randomFlipsAxes>` flag enables random flipping of the structure across any of the axes for each placement.

Available values are:

* None (default)
* X
* Y
* Z
* XY
* XZ
* YZ
* XYZ

Flips are applied after orientation but before alignment.

<details>

<summary><mark style="color:blue;">Example</mark></summary>

First Image: `//ezsc Clipboard` (no random flips)

Second Image: `//ezsc Clipboard -f XZ` (random mirrors along x- and z-axis, but not y)

![](/files/iiq04NghaXXYWZUzeCAK) ![](/files/nRlQIsLUoDxA3BQ7enX9)

</details>

***

### Random 90°-Rotations: <mark style="color:orange;">`-r <randomRotationAxis>`</mark> <a href="#random-rotations-r" id="random-rotations-r"></a>

The `-r <randomRotationAxis>` flag enables random 90° rotation of the structure across either of the axes for each placement.

Available values are:

* X
* Y
* Z

By default, this parameter is not set to anything, i.e. random rotations are disabled.

90°-rotations are applied after orientation but before alignment.

<details>

<summary><mark style="color:blue;">Example</mark></summary>

First Image: `//ezsc Clipboard` (no random rotations)

Second Image: `//ezsc Clipboard -r Y` (random 90°-rotations around the y-axis)

![](/files/PkHNBqkmFtpSS6Wt8fn2) ![](/files/sREMrsIE75ZRuV0SZjAH)

</details>

***

### Orientation (advanced): <mark style="color:orange;">`-k <orientationAxis>`</mark> and <mark style="color:orange;">`-c <orientationAngle>`</mark> <a href="#orientation-c-k" id="orientation-c-k"></a>

Setting an orientation means defining which internal coordinate system the structure has. That coordinate system is then used in the random flips/rotations and during alignment. *Defining an orientation is "defining which way is up and which way is forward"*

Orientation is set by a rotation axis (`-k <direction>`) and a rotation angle (`-c <angle>`). *The rotation works identically to `//ezd rotate`*

By default, the rotation axis `-k` is `y` or `up` and the rotation angle `-c` is `0`, which means no rotation.

For example, if you set the rotation axis to `-k x` and the rotation angle to `-c 90` then your structure is rotated to the side. Its eastern side will now be the "up-direction" and so on.

***

### Place Air: <mark style="color:orange;">`-a`</mark> <a href="#place-air-a" id="place-air-a"></a>

By default, if this flag *is not* set, air blocks are skipped when placing a structure. When this flag *is* set, air blocks within the structure are able to override existing blocks.

{% hint style="info" %}
This behaviour is opposite to `//paste`'s `-a` flag. It may be confusing, but we think it's more convenient for our commands.
{% endhint %}