Curves.tbl - Revision history

Lafiel: Inline Curves

2025-10-02T00:38:18Z

Inline Curves

@@ Line 69: / Line 69: @@
 (0.5, 1): EaseInQuad
 (1, 0): Constant
 #End

Asteroth at 18:15, 12 November 2023

2023-11-12T18:15:10Z

← Older revision		Revision as of 18:15, 12 November 2023
Line 1:		Line 1:
	{{SCP_table}}		{{SCP_table}}
	{{Tables}}		{{Tables}}
	The '''curves.tbl''' allows for defining arbitrary mathematical functions, a mapping from an arbitrary X value to an arbitrary Y value. These can be used in a variety of different ways, and what X and Y are are specific to the particular situation which calls for a curve.		The '''curves.tbl''' allows for defining arbitrary mathematical functions, a mapping from an arbitrary X value to an arbitrary Y value. These can be used in a variety of different ways, and what X and Y are are specific to the particular situation which calls for a curve. When a curve is used, an X value is supplied, the mapping is applied and the Y value is returned.

	This table is one of the [[Modular Tables]] and can be extended with xxx-crv.tbm		This table is one of the [[Modular Tables]] and can be extended with xxx-crv.tbm

Asteroth at 09:12, 28 April 2023

2023-04-28T09:12:56Z

← Older revision		Revision as of 09:12, 28 April 2023
Line 24:		Line 24:
	==Interpolation functions==		==Interpolation functions==
	{{Table232\|		{{Table232\|
	Interpolation functions define how the curve should change in between keyframes. There are several basic interpolation functions, but note that any previously defined curve can itself be used as an interpolation function. The engine provides quite a few [[non-basic curves]] as well.		Interpolation functions define how the curve should change in between keyframes. There are several basic interpolation functions, but note that any previously defined curve can itself be used as an interpolation function. The engine provides quite a few [[Curves.tbl#Built-in Curves\|non-basic curves]] as well.


	===Constant===		===Constant===
Line 39:		Line 38:
	Parameters:		Parameters:
	*''Float'', Degree. A degree 2 polynomial is quadratic, degree 3 is cubic, etc. High degree makes the 'gentle' end even gentler and the 'harsh' end even harsher.		*''Float'', Degree. A degree 2 polynomial is quadratic, degree 3 is cubic, etc. High degree makes the 'gentle' end even gentler and the 'harsh' end even harsher.
	*''Boolean'', "Ease in". Whether to "ease in" or "ease out". Easing in means the slow, gentle end is first and then the function harshly goes to the next Y value. Easing out does the opposite, it harshly goes to the next Y value, and spends most of the time gradually arriving.		*''Boolean'', "Ease in". Defaults to true. Whether to "ease in" or "ease out". Easing in means the slow, gentle end is first and then the function harshly goes to the next Y value. Easing out does the opposite, it harshly goes to the next Y value, and spends most of the time gradually arriving.

	===Circular===		===Circular===
	A smooth interpolation ~~gentle at one end, harsh on~~ the ~~other. The output Y value is~~ a ~~polynomial curve of the given degree from the keyframe's Y value and the next keyframe's Y value~~.		A smooth interpolation function which takes the form of a (possibly stretched) circular segment.
	Parameters:		Parameters:
	*''~~Float~~'', ~~Degree~~. ~~A degree 2 polynomial~~ is ~~quadratic~~, ~~degree 3 is cubic~~, ~~etc~~. ~~High degree makes~~ the '~~gentle~~' ~~end even gentler~~ and the '~~harsh~~' end ~~even harsher~~.		*''Boolean'', "Ease in". Defaults to true. Whether to "ease in" or "ease out". Easing in means the slow, gentle end is first and then the function harshly goes to the next Y value. Easing out does the opposite, it harshly goes to the next Y value, and spends most of the time gradually arriving.

			===Any other previously defined curve===
			Provided the curve has already been defined, another curve may next into new ones. This keyframe's X and Y values will be used as 0, 0 in the original curve, and the next keyframe's X and Y values will be uesd as 1, 1 in the original curve.
			*No parameters.
			}}

			==Built-in Curves==
			{{Table232\|
			Many functions from [https://easings.net/ Easing functions] are provided built-in. All of the 'Quad', 'Cubic', 'Quart', 'Quint', 'Circ' curves are avilable under the names used on the website. Additionally, all built-in curves also have 'reversed' versions which decrease from 1 to 0 instead of ascending from 0 to 1, which end in 'Rev' (such as 'easeInOutQuadRev').
	}}		}}

	==Sample Entry==		==Sample Entry==
	<pre>		<pre>
	#~~DEFAULT PROFILE~~		#Curves

	$~~Tonemapper~~: ~~Uncharted 2~~		$Name: test1
	$~~Exposure~~: 4.0		$KeyFrames:
			(0, 1): Polynomial, 2, true
			(1, 0): Constant

	$~~Missile Light Radius~~:		$Name: test2
	~~+default~~: 20		$KeyFrames:
			(0, 0): Circular
			(0.5, 1): EaseInQuad
			(1, 0): Constant

	~~$Laser Light Radius:~~		#End
	~~+default: 100~~

	~~$Beam Light Radius:~~
	~~+default: 37.5~~

	~~$Point Light Radius:~~
	~~+Multiplier: 1.25~~

	~~$Cone Light Radius:~~
	~~+Multiplier: 1.25~~

	#~~END DEFAULT PROFILE~~
	</pre>		</pre>

	~~== References ==~~
	~~# [http://filmicworlds.com/blog/filmic-tonemapping-with-piecewise-power-curves/ Filmic Tonemapping with Piecewise Power Curves], John Hable~~
	~~# [https://64.github.io/tonemapping/ Tone Mapping], 64~~
	~~# [http://filmicworlds.com/blog/filmic-tonemapping-operators/ Filmic Tonemapping Operators], John Hable~~


	[[Category:Tables]]		[[Category:Tables]]

Asteroth: Created page with "{{SCP_table}} {{Tables}} The '''curves.tbl''' allows for defining arbitrary mathematical functions, a mapping from an arbitrary X value to an arbitrary Y value. These can be u..."

2023-04-28T08:56:34Z

Created page with "{{SCP_table}} {{Tables}} The '''curves.tbl''' allows for defining arbitrary mathematical functions, a mapping from an arbitrary X value to an arbitrary Y value. These can be u..."

New page

{{SCP_table}}
{{Tables}}
The '''curves.tbl''' allows for defining arbitrary mathematical functions, a mapping from an arbitrary X value to an arbitrary Y value. These can be used in a variety of different ways, and what X and Y are are specific to the particular situation which calls for a curve.

This table is one of the [[Modular Tables]] and can be extended with xxx-crv.tbm

==#Curves==
{{Table232|
This section defines the individual curve functions.

===$Name:===
The unique name to identify this particular curve.

====$Keyframes:====
*Required once for a curve, to begin listing its keyframes with the following syntax:
<pre>(X, Y): Interpolation function, any paramters...</pre>
*Entries like the above can be repeated as many times as necessary
*The X values ''must'' come in ascending order
*The last X value must be at least 1
Example:
<pre>(0, 1): Polynomial, 2, true</pre>
}}

==Interpolation functions==
{{Table232|
Interpolation functions define how the curve should change in between keyframes. There are several basic interpolation functions, but note that any previously defined curve can itself be used as an interpolation function. The engine provides quite a few [[non-basic curves]] as well.

===Constant===
The simplest interpolation, the output Y value is equal to the keyframe's Y value for its entire domain.
*No parameters.

===Linear===
A slightly less simple interpolation, the output Y value is a straight line between the keyframe's Y value and the next keyframe's Y value.
*No parameters.

===Polynomial===
A smooth interpolation gentle at one end, harsh on the other. The output Y value is a polynomial curve of the given degree from the keyframe's Y value and the next keyframe's Y value.
Parameters:
*''Float'', Degree. A degree 2 polynomial is quadratic, degree 3 is cubic, etc. High degree makes the 'gentle' end even gentler and the 'harsh' end even harsher.
*''Boolean'', "Ease in". Whether to "ease in" or "ease out". Easing in means the slow, gentle end is first and then the function harshly goes to the next Y value. Easing out does the opposite, it harshly goes to the next Y value, and spends most of the time gradually arriving.

===Circular===
A smooth interpolation gentle at one end, harsh on the other. The output Y value is a polynomial curve of the given degree from the keyframe's Y value and the next keyframe's Y value.
Parameters:
*''Float'', Degree. A degree 2 polynomial is quadratic, degree 3 is cubic, etc. High degree makes the 'gentle' end even gentler and the 'harsh' end even harsher.
}}

==Sample Entry==
<pre>
#DEFAULT PROFILE

$Tonemapper: Uncharted 2
$Exposure: 4.0

$Missile Light Radius:
+default: 20

$Laser Light Radius:
+default: 100

$Beam Light Radius:
+default: 37.5

$Point Light Radius:
+Multiplier: 1.25

$Cone Light Radius:
+Multiplier: 1.25

#END DEFAULT PROFILE
</pre>

== References ==
# [http://filmicworlds.com/blog/filmic-tonemapping-with-piecewise-power-curves/ Filmic Tonemapping with Piecewise Power Curves], John Hable
# [https://64.github.io/tonemapping/ Tone Mapping], 64
# [http://filmicworlds.com/blog/filmic-tonemapping-operators/ Filmic Tonemapping Operators], John Hable

[[Category:Tables]]