Docs Project

ResetPLS

Reset stateful operators (feedback, cache, timers, counts) across the project, with a pattern-based exception list. Bound to ctrl+0.

⚡ Project Toolbar button

Where it appears

Read off the registry hosts in the component, so this is where the tool puts itself in a default install; every one of these can be reordered or hidden from Hub.

Shortcuts

Global: they fire anywhere in TouchDesigner. Shortcuts scoped to a single panel are a local control scheme and stay off this list.

  • Cmd+0 / Ctrl+0

Global ResetPLS

YouTube breakdown

This component takes care of all your reset needs, pulsing all resetpulse or similar parameters of operators included in search. You can enable or disable certain operator types (hope I didn't forget any). No more dragging a Keyboard In CHOP all across your networks! You can also specify exceptions and whether those exceptions block further resets down the line (only relevant for COMPs).

It is bound to Ctrl+0 hotkey (which I have bound to one of my mouse buttons as well).

Conf

  • Root: where opfindDAT should start the search
  • Limit Depth: enable limit how far opfind should search
  • Depth: maximum depth of limit
  • Except: list of opeartor exceptions the search should ignore.
  • Exceptions Limit: only relevant for baseCOMP that are listed as Exception. If enabled all further operators under are also excluded.
  • Enable/Disable All OPtypes: sets the state of all operator type toggles
  • Reset On Startup: pulses Reset automatically when the project starts
  • Reset: pulses reset parameter for all included operators

TOP, CHOP, SOP, COMP

  • Individual toggles enabling/disabling certain operator types (only ones relevant for resetting listed)
  • For COMP operators and Script TOP/CHOP/SOP/DAT: the component assumes a pulse parameter named Reset or Resetpulse. The list of assumed parameters can be edited under the Misc parameter tab, clicking the pulse Edit Custom Reset Pars

Misc

  • Reset Timeline: if enabled resets root timeline to the frame specified in Reset Frame
  • Reset Frame: which frame to reset to if Reset Timeline is enabled
  • Callback: toggles executing a custom callback on reset
  • Create Callbacks: create a text DAT next to this component where you can define an onReset script
  • Callbacks: location of the callback script (points to the default script by default)
  • Static Exceptions: you should list all pattern match strings here you want to exclude.
    • A use-case for this is some common custom components such as the already present colour_lovers_picker. You must prepend your string with a ^.
    • After adding more rows to this list you should re-save the component either as external tox or into your palette.
  • Edit Custom Reset Pars: list of parameter names assumed to be present in Base, Container, Script TOP/CHOP/SOP/DATs for the purpose of resetting. You can add more rows.

Parameters

Its Registry page comes from FNS_ConfigRegistry and FNS_ToolbarRegistry.

Conf

ControlType / defaultWhat it does
RootRoot operator.. Where the search for resettable operators starts. Everything under this component is considered, subject to Depth and the exception lists.
Limit DepthLimitdepth on / offon Stop the search at a fixed number of levels below Root instead of walking the whole tree. Worth it in a big project where a full walk is slow.
DepthDepth number1 How many levels below Root to search, when Limit Depth is on.
ExceptExcept textempty Operators to leave alone, one pattern per entry. Everything else under Root is reset.
Exceptions LimitExceptionslimit on / offoff For an excepted COMP, also skip everything inside it. Off resets its children even though the COMP itself is excepted.
Enable All OPtypesActiveall button Switch on every operator-type toggle across the pages, so the reset covers everything this tool knows how to reset.
Disable All OPtypesDisableall button Switch off every operator-type toggle, so the reset covers nothing until you pick types back.
Reset On StartupResetonstartup on / offoff Fire the reset once, automatically, when the project opens.
ResetReset button Reset now: pulse the reset parameter of every included operator under Root. This is what the hotkey and the toolbar button do.
Reset ShortcutShortcut textcmd.0 ctrl.0 Hotkey that pulses Global ResetPLS. Both the Windows and macOS combos are listed.

TOP

ControlType / defaultWhat it does
FeedbackFeedbacktop on / offoff Include Feedback TOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
CacheCachetop on / offoff Include Cache TOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
Texture 3DTexture3d on / offoff Include Texture 3D TOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
Movie File InMoviefilein on / offoff Include Movie File In TOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
FlowFlow on / offoff Include Flow TOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
Blob TrackBlobtrack on / offoff Include Blob Track TOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
ScriptScripttop on / offoff Include Script TOPs in the reset sweep, so their reset parameter is pulsed along with everything else. Reset here means pulsing a custom parameter named Reset or Resetpulse. The list of names it looks for is editable under Misc, Edit Custom Reset Pars.

CHOP

ControlType / defaultWhat it does
LFOLfo on / offoff Include LFO CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
SpeedSpeed on / offoff Include Speed CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
CountCount on / offoff Include Count CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
TimerTimer on / offoff Include Timer CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
FilterFilter on / offoff Include Filter CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
LagLag on / offoff Include Lag CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
Audio File InAudiofilein on / offoff Include Audio File In CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
Audio OscillatorAudiooscillator on / offoff Include Audio Oscillator CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
FeedbackFeedbackchop on / offoff Include Feedback CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
GestureGesture on / offoff Include Gesture CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
BeatBeat on / offoff Include Beat CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
TrailTrailchop on / offoff Include Trail CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
EventEvent on / offoff Include Event CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
RecordRecord on / offoff Include Record CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
SequencerSequencer on / offoff Include Sequencer CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
NoiseNoise on / offoff Include Noise CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
ScriptScriptchop on / offoff Include Script CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else. Reset here means pulsing a custom parameter named Reset or Resetpulse. The list of names it looks for is editable under Misc, Edit Custom Reset Pars.
SpringSpringchop on / offoff Include Spring CHOPs in the reset sweep, so their reset parameter is pulsed along with everything else.

SOP

ControlType / defaultWhat it does
TrailTrailsop on / offoff Include Trail SOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
CacheCachesop on / offoff Include Cache SOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
ParticleParticle on / offoff Include Particle SOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
CreepCreep on / offoff Include Creep SOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
SpringSpringsop on / offoff Include Spring SOPs in the reset sweep, so their reset parameter is pulsed along with everything else.
ScriptScriptsop on / offoff Include Script SOPs in the reset sweep, so their reset parameter is pulsed along with everything else. Reset here means pulsing a custom parameter named Reset or Resetpulse. The list of names it looks for is editable under Misc, Edit Custom Reset Pars.

POP

ControlType / defaultWhat it does
CacheCachepop on / offoff Include Cache POPs in the reset sweep, so their reset parameter is pulsed along with everything else.
TrailTrailpop on / offoff Include Trail POPs in the reset sweep, so their reset parameter is pulsed along with everything else.
FeedbackFeedbackpop on / offoff Include Feedback POPs in the reset sweep, so their reset parameter is pulsed along with everything else.
ParticleParticlepop on / offoff Include Particle POPs in the reset sweep, so their reset parameter is pulsed along with everything else.
Import SelectImportselectpop on / offoff Include Import Select POPs in the reset sweep, so their reset parameter is pulsed along with everything else.

DAT

ControlType / defaultWhat it does
MIDI InMidiin on / offoff Include MIDI In DATs in the reset sweep, so their reset parameter is pulsed along with everything else.
MIDI EventMidievent on / offoff Include MIDI Event DATs in the reset sweep, so their reset parameter is pulsed along with everything else.
FifoFifo on / offoff Include Fifo DATs in the reset sweep, so their reset parameter is pulsed along with everything else.
SerialSerial on / offoff Include Serial DATs in the reset sweep, so their reset parameter is pulsed along with everything else.
OSC InOscin on / offoff Include OSC In DATs in the reset sweep, so their reset parameter is pulsed along with everything else.
OSC OutOscout on / offoff Include OSC Out DATs in the reset sweep, so their reset parameter is pulsed along with everything else.
ScriptScriptdat on / offoff Include Script DATs in the reset sweep, so their reset parameter is pulsed along with everything else. Reset here means pulsing a custom parameter named Reset or Resetpulse. The list of names it looks for is editable under Misc, Edit Custom Reset Pars.

COMP

ControlType / defaultWhat it does
ReplicatorReplicator on / offoff Include Replicator COMPs in the reset sweep, so their reset parameter is pulsed along with everything else. Reset here means pulsing a custom parameter named Reset or Resetpulse. The list of names it looks for is editable under Misc, Edit Custom Reset Pars.
Flex SolverFlexsolver on / offoff Include Flex Solver COMPs in the reset sweep, so their reset parameter is pulsed along with everything else. Reset here means pulsing a custom parameter named Reset or Resetpulse. The list of names it looks for is editable under Misc, Edit Custom Reset Pars.
ActorActor on / offoff Include Actor COMPs in the reset sweep, so their reset parameter is pulsed along with everything else. Reset here means pulsing a custom parameter named Reset or Resetpulse. The list of names it looks for is editable under Misc, Edit Custom Reset Pars.
Bullet SolverBulletsolver on / offoff Include Bullet Solver COMPs in the reset sweep, so their reset parameter is pulsed along with everything else. Reset here means pulsing a custom parameter named Reset or Resetpulse. The list of names it looks for is editable under Misc, Edit Custom Reset Pars.
BaseBase on / offoff Include Base COMPs in the reset sweep, so their reset parameter is pulsed along with everything else. Reset here means pulsing a custom parameter named Reset or Resetpulse. The list of names it looks for is editable under Misc, Edit Custom Reset Pars.
ContainerContainer on / offoff Include Container COMPs in the reset sweep, so their reset parameter is pulsed along with everything else. Reset here means pulsing a custom parameter named Reset or Resetpulse. The list of names it looks for is editable under Misc, Edit Custom Reset Pars.
GeometryGeometry on / offoff Include Geometry COMPs in the reset sweep, so their reset parameter is pulsed along with everything else. Reset here means pulsing a custom parameter named Reset or Resetpulse. The list of names it looks for is editable under Misc, Edit Custom Reset Pars.

Misc

ControlType / defaultWhat it does
Reset TimelineTimeline on / offoff Also send the root timeline back to Reset Frame when a reset runs.
Reset FrameFrame number0 The frame the root timeline jumps to, when Reset Timeline is on.
CallbackCustomscript on / offoff Also run your own callback on each reset, so a tool with no reset parameter can still be handled.
Create CallbacksCreatecallbacks button Create a callbacks DAT beside this component with an onReset stub to fill in, and point the parameter below at it.
CallbacksCallbacksread-only operatorempty The DAT holding the onReset callback. It points at the shipped default until you make your own.
Static ExceptionsOpen2 button Edit the static exception list: name patterns that are never reset, whatever else is set. Prefix each with '^'. Re-save the component after adding rows, or they are lost with the session.
Edit Custom Reset ParsOpen3 button Edit the parameter names this tool treats as a reset on COMPs and Script operators. Defaults are Reset and Resetpulse; add your own component's name here to make it resettable.
Externalize TablesExternalizetables on / offoff Keep this component's tables in files on disk rather than inside the project, so the same exceptions and reset-parameter names follow you between projects.

About

ControlType / defaultWhat it does
ReadMeOpen button Open this tool's README.

Edit this page on GitHub →