colour.models.exponent_function_basic¶
- colour.models.exponent_function_basic(x: FloatingOrArrayLike, exponent: FloatingOrArrayLike = 1, style: Union[Literal['basicFwd', 'basicRev', 'basicMirrorFwd', 'basicMirrorRev', 'basicPassThruFwd', 'basicPassThruRev'], str] = 'basicFwd') FloatingOrNDArray [source]¶
Define the basic exponent transfer function.
- Parameters
x (FloatingOrArrayLike) – Data to undergo the basic exponent conversion.
exponent (FloatingOrArrayLike) – Exponent value used for the conversion.
style (Union[Literal['basicFwd', 'basicRev', 'basicMirrorFwd', 'basicMirrorRev', 'basicPassThruFwd', 'basicPassThruRev'], str]) –
Defines the behaviour for the transfer function to operate:
basicFwd: Basic Forward exponential behaviour where the definition applies a basic power law using the exponent. Values less than zero are clamped.
basicRev: Basic Reverse exponential behaviour where the definition applies a basic power law using the exponent. Values less than zero are clamped.
basicMirrorFwd: Basic Mirror Forward exponential behaviour where the definition applies a basic power law using the exponent for values greater than or equal to zero and mirrors the function for values less than zero (i.e. rotationally symmetric around the origin).
basicMirrorRev: Basic Mirror Reverse exponential behaviour where the definition applies a basic power law using the exponent for values greater than or equal to zero and mirrors the function for values less than zero (i.e. rotationally symmetric around the origin).
basicPassThruFwd: Basic Pass Forward exponential behaviour where the definition applies a basic power law using the exponent for values greater than or equal to zero and passes values less than zero unchanged.
basicPassThruRev: Basic Pass Reverse exponential behaviour where the definition applies a basic power law using the exponent for values greater than or equal to zero and passes values less than zero unchanged.
- Returns
Exponentially converted data.
- Return type
Examples
>>> exponent_function_basic(0.18, 2.2) 0.0229932... >>> exponent_function_basic(-0.18, 2.2) 0.0 >>> exponent_function_basic(0.18, 2.2, 'basicRev') 0.4586564... >>> exponent_function_basic(-0.18, 2.2, 'basicRev') 0.0 >>> exponent_function_basic( ... 0.18, 2.2, 'basicMirrorFwd') 0.0229932... >>> exponent_function_basic( ... -0.18, 2.2, 'basicMirrorFwd') -0.0229932... >>> exponent_function_basic( ... 0.18, 2.2, 'basicMirrorRev') 0.4586564... >>> exponent_function_basic( ... -0.18, 2.2, 'basicMirrorRev') -0.4586564... >>> exponent_function_basic( ... 0.18, 2.2, 'basicPassThruFwd') 0.0229932... >>> exponent_function_basic( ... -0.18, 2.2, 'basicPassThruFwd') -0.1799999... >>> exponent_function_basic( ... 0.18, 2.2, 'basicPassThruRev') 0.4586564... >>> exponent_function_basic( ... -0.18, 2.2, 'basicPassThruRev') -0.1799999...