> modifiers

Filter

modifiers/filter·v1.5.1

IN:1 OUT:1

SUMMARY

The Filter smooths instances over time by keeping a short history per instance and replacing the current value with a filtered one, so jittery or stepped motion upstream comes out smooth. It works on position, rotation, scale and one extra float attribute, each with its own toggle, and is built on TouchDesigner's Time Filter POP.

Filter Type offers Gaussian, Triangle and Box averages over the Filter Width, or One Euro, an adaptive filter that smooths when still and follows quickly when moving. The Lag page adds an optional lag with overshoot and slope or acceleration clamps, while Effect and Do Falloff blend between the raw and filtered result per instance.

PARAMETERS

PAGEGeneral

Group	Group	If there are input groups, specifying a group name in this field will cause this POP to act only upon the group specified.
Do Falloff	Dofalloff	Weight the effect on each point by the Falloff Attribute.
Falloff Attribute	Falloffattr	The point attribute, 0 to 1, that weights the effect.
Position	Position	Enable filtering the position.
Rotation	Rotation	Enable filtering the rotation.
Scale	Scale	Enable filtering the scale.
Other	Other	Enable filtering a float attribute as well (Attribute).
Attribute (Float)	Attr	Float attribute to filter when Other is on.

PAGEFilter

Active Filter	Activefilter	Apply the Time Filter. When off, the data passes through and the filter history restarts when turned back on.
[+]Filter Type	Filtertype	Determines the filter. Gaussian, Triangle and Box are weighted averages. One Euro is adaptive and smooth when still.
[+]Filter Width Unit	Widthunit	Choose between Seconds or Frames as the unit of Filter Width.
Filter Width	Width	Sets the length of the history the filter averages. Higher values are smoother but lag more.
[+]Increment Unit	Incrementunit	Choose between Seconds or Frames as the unit of Increment.
Increment	Increment	Sets the time between the kept samples, 1 frame by default. Larger values are cheaper but coarser.
Cutoff Frequency (Hz)	Cutoff	Sets the One Euro filter cutoff frequency, in Hz, when the value is still. Lower values are smoother.
Speed Coefficient	Speedcoeff	For One Euro, how much the cutoff opens with speed. Higher values give less lag on fast motion.
Slope Cutoff Frequency (Hz)	Slopecutoff	For One Euro, the cutoff frequency in Hz of the speed estimate. Lower values are steadier.
Effect	Effect	Determines the amount of smoothing applied, blending from the raw result at 0 to the smoothed result at 1.
Fill Missed Frames	Fillmissedframes	When on, the history is filled with the dropped frames' samples instead of leaving a gap.
Reset Filter	Filterreset	While on, the filter history is cleared every frame so the output follows the input.
Reset Filter Pulse	Resetpulse	Clears the filter history and restarts from the current input.

PAGELag

Active Lag	Activelag	Enable the lag stage. When off, the data passes straight through.
[+]Lag Type	Lagtype	Determines the lag easing: By Value uses the Lag times, By Amplitude scales them by the distance to the target.
[+]Lag Unit	Lagunit	Choose between Seconds or Frames as the unit of Lag.
Lag	Lag	Sets the catch-up time when rising (first value) and falling (second value), in Lag Unit.
[+]Overshoot Unit	Overshootunit	Sets the unit of Overshoot, in seconds or frames.
Overshoot	Overshoot	How far past the target the lag swings, while rising and while falling, in Overshoot Unit. 0 disables it.
Clamp Slope	Clampslope	Limit the rate of change of the value to the Max Slope.
Max Slope	Slope	The first value limits the slope when it is rising, and the second value limits the slope when it is decreasing.
Clamp Acceleration	Clampaccel	Enable limiting the change of the rate to Max Acceleration.
Max Acceleration	Accel	The first value limits the acceleration when it is rising, and the second value limits the acceleration when it is decreasing.
Snap	Snap	When on, the output snaps onto the target once it is within Snap Threshold.
Snap Threshold	Snapthreshold	Sets the distance to the target at which the lagged value snaps onto it.
Reset Lag	Lagreset	While on, the lag is held at the target.
Reset Lag Pulse	Lagresetpulse	Jumps the lag onto the target.
Freeze	Freeze	Holds the lagged value. 1 freezes it, 0 leaves it free, values in between slow it down.
Reset Freeze	Freezereset	When on, the frozen value is reset to the target every frame.
Reset Freeze Pulse	Freezeresetpulse	Reset the frozen value to the target.

PAGEFalloff

Preview Falloff	Previewfalloff	Enable coloring the points by the Other attribute.
[+]Falloff Ramp	Fallofframp	Selects the color ramp of the preview.
Open Custom Ramp Editor	Opencustomrampeditor	Open the editor of the custom preview ramp.
Reset Custom Ramp	Resetcustomramp	Resets the custom preview ramp.

PAGECommon

Bypass	Bypass	Pass through the first input to the output unchanged.
Free Extra GPU Memory	Freeextragpumem	Free memory that has accumulated when output memory has grown and shrunk.
Render Primitives	Renderprimitives	Whether to render the full POPX geometry. When off, only point instances are drawn.
Convert to Point Primitives	Converttoptprim	Enable converting points to point primitives when Render Primitives is off.
SRT / RST	Srtrst	Sets the transform order, SRT or RST, used when the points are rendered as TouchDesigner instances.

ATTRIBUTES

IORead

Pivot	point vec3	Per-instance pivot used to build the transform.
popxFalloff	point float	Falloff attribute controlling where and how strongly the filtering is applied (default popxFalloff; set by Falloff Attribute).

IOModified

P	point vec3	Instance position, temporally smoothed over the sample history.
Orient	point vec4	Instance orientation, smoothed over the sample history (shortest-path quaternion).
Scale	point vec3	Instance scale, smoothed over the sample history.
Other	point float	The custom float channel chosen by Attribute (Float), smoothed over the sample history.
PointScale	point float	Uniform per-instance scale, folded into the transform.
Transform	point mat3	Per-instance 3x3 transform rebuilt from the filtered pose.

IOCreated

FullTransform

point mat4

Per-instance 4x4 transform including pivot-corrected translation.

INPUTS

Input 0 POP - POPX/POP Geometry

OUTPUTS

Output 0 POP - POPX/POP Geometry