# Deformation

Deformation commands deform the contents of the given region into new shapes and forms.

All sub-commands are under `//ezdeform` (`//ezd`)\
e.g `//ezdeform hexagonalize`

***

## List of subcommands

***

#### ![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-f94534ef45825812589208b925839c97595ccb3c%2Fezdeform_hexagonalize_xrot.gif?alt=media)

### ` //ezdeform`` `` `<mark style="color:orange;">`hexagonalize`</mark>

<details>

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

**`//ezdeform hexagonalize [`**<mark style="color:orange;">**`size`**</mark>**`] [`**<mark style="color:orange;">**`air_gap`**</mark>**`] [`**<mark style="color:orange;">**`x_rotation`**</mark>**`] [`**<mark style="color:orange;">**`z_rotation`**</mark>**`] [`**<mark style="color:orange;">**`offset_angle`**</mark>**`] [`**<mark style="color:orange;">**`-w <profile>`**</mark>**`]`**

Deforms the region into hexagonal columns.

* <mark style="color:orange;">**Size**</mark> (Default: 12): Sets the size of hexagons.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-3c09a245c9b8d1b4b1e874565d7bd72bb9bd351b%2Fezdeform_hexagonalize_size.gif?alt=media)

* <mark style="color:orange;">**Air Gap**</mark> (Default: 0.0): Defines the width of the air gap between columns.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-734668222a990e4d52c78b53214c61f7ce6e5a62%2Fezdeform_hexagonalize_airgap.gif?alt=media)

* <mark style="color:orange;">**X Rotation**</mark> (Default: 0.0): Sets the column rotation angle along the X-axis, in degrees.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-f94534ef45825812589208b925839c97595ccb3c%2Fezdeform_hexagonalize_xrot.gif?alt=media)

* <mark style="color:orange;">**Z Rotation**</mark> (Default: 0.0): Sets the column rotation angle along the Z-axis, in degrees.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-826af981fb0bedcab48d1cdd8e0b6b835dd4cba5%2Fezdeform_hexagonalize_zrot.gif?alt=media)

* <mark style="color:orange;">**Offset Angle**</mark> (Default: 60.0): Adjusts the offset angle, controlling the shape (range: 0-90 degrees).

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-c3d67f2ab63ae9c7d3e3a21a5da68103031a40f2%2Fezdeform_hexagonalize_shape.gif?alt=media)

* <mark style="color:orange;">**-w**</mark>: See [Smoothblocks](https://ezedits.gitbook.io/ezedits/smoothblocks/smoothblocks).

</details>

***

#### ![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-45d6110e1f34110f21c6d4353803a801e3d5b6ae%2Fezdeform_noise.gif?alt=media)

### ` //ezdeform`` `` `<mark style="color:orange;">`noise`</mark>

<details>

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

**`//ezdeform noise <`**<mark style="color:orange;">**`noise`**</mark>**`> [`**<mark style="color:orange;">**`strength`**</mark>**`] [`**<mark style="color:orange;">**`-z <zoom>`**</mark>**`] [`**<mark style="color:orange;">**`-s <seed>`**</mark>**`] [`**<mark style="color:orange;">**`-w <profile>`**</mark>**`]`**

Deforms region according the given noise field.

* <mark style="color:orange;">**Noise**</mark>: Specifies the type of noise to use for deformation.
* <mark style="color:orange;">**Strength**</mark> (Default: 2.0): Sets the strength of the noise effect.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-c632673a2b2efb0a303e702bb3835e133293b5d8%2Fezdeform_noise_strength.gif?alt=media)

* <mark style="color:orange;">**Zoom**</mark> (Default: 1): Determines the scale of the noise.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-f0774e98da3a6ff6e29b7218054c60c9a6e3feb6%2Fezdeform_noise_frequency.gif?alt=media)

* <mark style="color:orange;">**-s \<seed>**</mark> (Default: -1): Optional seed for the noise pattern.
* <mark style="color:orange;">**-h**</mark>: When used, only deforms the region horizontally.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-27a98227f34e2c133db73dfe29afb57e60192e1e%2Fezdeform_noise_hflag.gif?alt=media)

* <mark style="color:orange;">**-v**</mark>: When used, only deforms the region vertically.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-a0be3e99c7ce10b61a23b0637b25ca9c9c5a0630%2Fezdeform_noise_vflag.gif?alt=media)

* <mark style="color:orange;">**-w**</mark>: See [Smoothblocks](https://ezedits.gitbook.io/ezedits/smoothblocks/smoothblocks).

</details>

***

#### ![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-d539301e6aa6e451f6b71e4bccffcdf85d9d88f6%2Fezdeform_rotate_angle.gif?alt=media)

### ` //ezdeform`` `` `<mark style="color:orange;">`rotate`</mark>

<details>

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

**`//ezdeform rotate <`**<mark style="color:orange;">**`angle`**</mark>**`> [`**<mark style="color:orange;">**`-o`**</mark>**`] [`**<mark style="color:orange;">**`-w <profile>`**</mark>**`]`**

Rotates region clockwise with the the center of rotation being the center of the selection (or the player's head position using -o) and with the player aim defining the axis of rotation.

* <mark style="color:orange;">**Angle**</mark>: Sets the angle of rotation, in degrees.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-d539301e6aa6e451f6b71e4bccffcdf85d9d88f6%2Fezdeform_rotate_angle.gif?alt=media)

* <mark style="color:orange;">**-o**</mark>: When used, uses the player's position as the center of rotation instead of the selection's center.
* <mark style="color:orange;">**-w**</mark>: See [Smoothblocks](https://ezedits.gitbook.io/ezedits/smoothblocks/smoothblocks).

</details>

***

#### ![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-755b5702850f2aba20ee40185b5ad12118c595ba%2Fezdeform_voronoialize_airgap.gif?alt=media)

### ` //ezdeform`` `` `<mark style="color:orange;">`voronoialize`</mark>

<details>

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

**`//ezdeform voronoialize [`**<mark style="color:orange;">**`size`**</mark>**`] [`**<mark style="color:orange;">**`air_gap`**</mark>**`] [`**<mark style="color:orange;">**`-s <seed>`**</mark>**`] [`**<mark style="color:orange;">**`-w <profile>`**</mark>**`]`**

Deforms region to randomly distributed voronoi cells.

* <mark style="color:orange;">**Size**</mark> (Default: 12): Determines the size of the voronoi cells.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-0a84845b23c611dd0ffd56c5bb59abd87b9179bf%2Fezdeform_voronoialize_size.gif?alt=media)

* <mark style="color:orange;">**Air Gap**</mark> (Default: 0.0): Specifies the width of the air gap between cells.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-755b5702850f2aba20ee40185b5ad12118c595ba%2Fezdeform_voronoialize_airgap.gif?alt=media)

* <mark style="color:orange;">**-s \<seed>**</mark> (Default: -1): Optional seed for generating the pattern.
* <mark style="color:orange;">**-w \<profile>**</mark>: See [Smoothblocks](https://ezedits.gitbook.io/ezedits/smoothblocks/smoothblocks).

</details>

***

#### ![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-3647d7618006dc738932ddae1e8491f04692c51e%2Fezdeform_voronoialize2_airgap.gif?alt=media)

### ` //ezdeform`` `` `<mark style="color:orange;">`voronoialize2`</mark>

<details>

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

**`//ezdeform voronoialize2 <`**<mark style="color:orange;">**`amount`**</mark>**`> [`**<mark style="color:orange;">**`air_gap`**</mark>**`] [`**<mark style="color:orange;">**`-s <seed>`**</mark>**`] [`**<mark style="color:orange;">**`-r <uniformity>`**</mark>**`] [`**<mark style="color:orange;">**`-n <normalOffset>`**</mark>**`] [`**<mark style="color:orange;">**`-w <profile>`**</mark>**`]`**

Deforms the region to Voronoi cells distributed along the surface shape. Could more accurately preserve the original shape compared to the first voronoialize.

* <mark style="color:orange;">**Amount**</mark>: Specifies the cell amount in the voronoi pattern. A small amount naturally leads to larger cells and vice versa.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-75f3897b30f6620a2f6fca6d7947ba5c6e038d93%2Fezdeform_voronoialize2_amount.gif?alt=media)

* <mark style="color:orange;">**Air Gap**</mark> (Default: 0.0): Determines the width of the air gap between cells.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-3647d7618006dc738932ddae1e8491f04692c51e%2Fezdeform_voronoialize2_airgap.gif?alt=media)

* <mark style="color:orange;">**-s \<seed>**</mark> (Default: -1): Optional seed for generating the pattern. `-1` will randomly generate a seed.
* <mark style="color:orange;">**-r \<uniformity>**</mark> (Default: 15): Sets the voronoi seed point repulsion iteration count. 0 means fully random. 15 iterations lead to a more uniform/even appearance.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-3b6a47ba05ef61676b13eaea1cfb44210af79bc0%2Fezdeform_voronoialize2_repulsion.gif?alt=media)

* <mark style="color:orange;">**-n \<normalOffset>**</mark> (Default: 5): Technical parameter. Adjusts how deep the cell seed is positioned into the shape. Larger/Thicker shapes could benefit from a larger value. Thinner shapes should use a smaller value if the generation breaks down.
* <mark style="color:orange;">**-w \<profile>**</mark>: See [Smoothblocks](https://ezedits.gitbook.io/ezedits/smoothblocks/smoothblocks).

</details>

***

#### ![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-112f4cda4e6ed00d8d6c1409f07af53bfe577e63%2Fezdeform_voxelize_scales.gif?alt=media)

### ` //ezdeform`` `` `<mark style="color:orange;">`voxelize`</mark>

<details>

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

**`//ezdeform voxelize <`**<mark style="color:orange;">**`scales`**</mark>**`> <`**<mark style="color:orange;">**`gap`**</mark>**`> <`**<mark style="color:orange;">**`distortion`**</mark>**`> [`**<mark style="color:orange;">**`-i <primary>`**</mark>**`] [`**<mark style="color:orange;">**`-j <secondary>`**</mark>**`] [`**<mark style="color:orange;">**`-s <seed>`**</mark>**`] [`**<mark style="color:orange;">**`-hv`**</mark>**`] [`**<mark style="color:orange;">**`-w <profile>`**</mark>**`]`**

Deforms region into larger cuboid shapes.

* <mark style="color:orange;">**Scales**</mark> (Default: 3): Sets the scale of the cuboids.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-112f4cda4e6ed00d8d6c1409f07af53bfe577e63%2Fezdeform_voxelize_scales.gif?alt=media)

You may put three comma-separated values to define the dimension for each axis.\
![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-5898d2be357d2147b75a7e8f528cd2d2576590dd%2Fezdeform_voxelize_scales3.gif?alt=media)

* <mark style="color:orange;">**Gap**</mark> (Default: 0.0): Defines the width of the air gap between voxels.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-caf15180a420aa2a3b168f90eeb47290bb023d1e%2Fezdeform_voxelize_airgap.gif?alt=media)

* <mark style="color:orange;">**Distortion**</mark> (Default: 0.0): Adjusts the strength of random grid distortion (range: 0-1).
* <mark style="color:orange;">**-s \<seed>**</mark> (Default: -1): Optional seed for the distortion.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-e6b9588be99bf9819eb0429c732673f13ae78c4c%2Fezdeform_voxelize_distortion.gif?alt=media)

* <mark style="color:orange;">**-i \<primary>**</mark> (Default: y): Specifies the y-axis direction for grid.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-6d5b4eba477f90b4780fffbe34c9f1b6dc980041%2Fezdeform_voxelize_primary.gif?alt=media)

* <mark style="color:orange;">**-j \<secondary>**</mark> (Default: -x): Specifies the x-axis direction of the grid.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-516f03bec29a26ad9ddd903b40f2991314495f1d%2Fezdeform_voxelize_secondary.gif?alt=media)

* <mark style="color:orange;">**-h**</mark>: When used, only voxelizes horizontally.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-8a0efabffdcb446c3db5a0a2d76bb8ec01c19373%2Fezdeform_voxelize_hflag1.gif?alt=media) ![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-bbb82e79e5fe02712b2859d4335afb50c330a883%2Fezdeform_voxelize_hflag2.gif?alt=media)

* <mark style="color:orange;">**-v**</mark>: When used, only voxelizes vertically.

![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-35265b442696ee77fe61691f37f4a7a75c78af3c%2Fezdeform_voxelize_vflag1.gif?alt=media) ![](https://62542430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmwyNbIIrWCkyIco2qJ9j%2Fuploads%2Fgit-blob-519e4c9565d733196489f51efc85f204de55454f%2Fezdeform_voxelize_vflag2.gif?alt=media)

* <mark style="color:orange;">**-w**</mark>: See [Smoothblocks](https://ezedits.gitbook.io/ezedits/smoothblocks/smoothblocks).

</details>

***