# Palette Gradient Brushes
The following commands feature brushes for creating gradients.
***
### `//ezbr` `gradient`
Gradient Brush
**` //ezbr gradient`` `` `****` [radius] [interpolation] [bleed] [-avw] [-n ] [-z ] [-d ]`**
The `gradient` brush allows you to first define a plane by selecting 2 points, you can then paint with your gradient with blocks chosen based on distance along this plane.
**Left Click**** to start a plane at your target block**\ **Sneak + Left Click**** to start a plane at the player position**\ **Right Click**** to set the end of the plane at your target block OR paint palette blocks if the plane is set**\ **Sneak + Right Click**** to set the end of the plane at the player position OR paint palette blocks if the plane is set**\ **Swap Hands**** (Default F key) to toggle between GLOBAL and PER\_ITEM active gradients**
* **Palette**: Specifies the palette to use for the gradient.
* **Radius** (Default: 8): Sets the radius of the brush.
* **Interpolation** (Default: NONE): Determines the type of interpolation used in the gradient transition.
* **Bleed** (Default: 0.5): Adjusts the strength of interpolation, with a normal range from 0 to 1.
* **`-a`**: When activated, the gradient is allowed to replace air blocks.
* **`-v`**: Deactivates WorldEditCUI integration.
* `-w`: Try to texture shaping blocks (slabs, stairs, etc.) with the closest existing material.
* **`-n `** (Default: `White()`): Adds an underlying noise field to the gradient effect.
* **`-z `** (Default: 1): Modifies the scale of the noise.
* **`-d `** (Default: NONE): Sets the distance mode changing the brush to work based on distance from the initial block with the given distance function.
***
### `//ezbr` `gradientstroke`
Gradient Stroke Brush
**` //ezbr gradientstroke`` `` `****` [radius] [interpolation] [bleed] [-advwx] [-n ] [-z ]`**
The `gradientstroke` brush allows for gradient application along a path (stroke) defined by selecting points.
**Left Click**** to add points**\ **Sneak + Left Click**** to remove the last point**\ **Right Click**** to confirm & place the gradient stroke**\ **Sneak + Right Click**** to clear all points**\ **Swap Hands**** (Default F key) to toggle between GLOBAL and PER\_ITEM active gradients**
* **Palette**: Specifies the block pattern for the gradient.
* **Radius** (Default: 8): Sets the radius of the brush.
* **Interpolation** (Default: LINEAR): Determines the type of interpolation used in the gradient transition.
* **Bleed** (Default: 0.5): Adjusts the strength of interpolation, with a normal range from 0 to 1.
* **`-a`**: When activated, allows the gradient to replace air blocks.
* **`-d`**: Activates the 'distance to center' mode which applies the gradient based on distance to the middle of the stroke line instead of distance along the stroke.
* **`-v`**: Deactivates WorldEditCUI integration.
* `-w`: Try to texture shaping blocks (slabs, stairs, etc.) with the closest existing material.
* **`-x`**: Clears the brush's path after every placed stroke.
* **`-n `** (Default: `White()`): Adds an underlying noise field to the gradient effect.
* **`-z `** (Default: 1): Modifies the scale of the noise.
***
## Gradient Parameters
There are a few parameters to creating a gradient worth explaining.
### Bleed
First off, the **`bleed`** parameter.
The bleed parameter determines how much the colors bleed into each other.
### Noise
The pattern of how this bleeding takes place can be determined by **`noise`**. The GIF above was using White noise (`-n White`), while the following GIFs use Perlin noise (`-n Perlin(Freq:0.25)`)
#### You can also put in any noise. Here are a few more examples:
**`-n Perlin(Freq:0.25)`**
**`-n Cellular(Freq:0.15)`**
**`-n @@ridged(Freq:0.15)`**
**`-n Shard(Freq:0.15)`**
### Interpolation Mode
In the following, we compare the five different **`interpolation modes`** of applying the noise to the gradient. The GIFs go through increasing and decreasing bleed values between 0 and 1.
*The blue square's top and bottom show where the gradient starts and ends*
#### NONE
No interpolation is applied.
#### LINEAR
The noise is applied with a constant factor throughout the entire gradient. Because of that, the gradient is "clipping" outside our two selected positions.
#### TAPERED
Applies the noise strongest in the middle of the gradient and tapers off towards the start and end to avoid "clipping" outside of the given positions.
#### BEZIER
Uses Bezier interpolation to apply the noise more softly and smoothly. Breaks for a bleed value of >1.
#### SIN
