> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magickml.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integer

# CLAMP

The CLAMP node constrains an input integer value to a specified range defined by a minimum and maximum value. If the input value falls within the range, it is passed through unchanged. If the input value is less than the minimum or greater than the maximum, it is "clamped" to the nearest boundary value.

## Inputs

1. `value` (integer): The input value to be clamped. Default is 0.
2. `min` (integer): The minimum allowed value. Default is 0.
3. `max` (integer): The maximum allowed value. Default is 0.

## Outputs

1. `result` (integer): The clamped output value.

## Configuration

This node has no configuration options.

## Usage

1. Connect an integer value to the `value` input. This is the value you want to constrain to the specified range.
2. Set the `min` input to the minimum allowed value for the output.
3. Set the `max` input to the maximum allowed value for the output.
4. The `result` output will emit the input value if it's within the \[min, max] range. If the input is less than `min`, `result` will be `min`. If the input is greater than `max`, `result` will be `max`.

## Example

Let's say you have a spell that generates a random integer between -100 and 100, but you need to ensure the value is always between 0 and 50 before using it. You can use the CLAMP node like this:

1. Connect the random integer generator to the `value` input of CLAMP.
2. Set the CLAMP `min` input to 0.
3. Set the CLAMP `max` input to 50.
4. Connect the `result` output to the rest of your spell.

Now, any values less than 0 will be raised to 0, and any values greater than 50 will be reduced to 50. Values already in the \[0, 50] range will pass through unchanged.

## Tips

* CLAMP is useful any time you need to constrain a value to a known range. This is common when working with parameters that have legal bounds, like percentages (0-100), RGB color values (0-255), etc.
* Remember that CLAMP is inclusive of the `min` and `max` values. If you need an exclusive range, adjust your bounds accordingly.
* If `min` is greater than `max`, CLAMP will swap their values internally so that `min` is always less than or equal to `max`.

## Cautions

* Both the input value and the `min`/`max` bounds must be integers. For floating-point clamping, use the CLAMP (Float) node instead.
* Be aware that clamping discards out-of-bounds values rather than scaling or normalizing them. If you need to fit a range of values proportionally into a different range, consider using a map or lerp node instead.