

JOG SHUTTLE IMAGE
-----------------

Provides an animated image capable of endless rotation, suitable for usage as a jog/shuttle, for fine-tuning purposes or wherever the accurate precision of a knob with many turns can be useful.

This module behaves identically to the Vec Jog Shuttle, with the only difference that in this case an appositely designed image of rotary type shall be supplied, covering a *full 360 degrees rotation* (one is included as an example).

Any image or animation of non-rotary type will be rejected.

*The Jog Shuttle can be connected directly to a Patch Memory Float by its _Value pin_ specifying a matching range at the Value Min and Value Max pins.*

The Delta Out pin outputs a zero immediately followed by a delta-move (rotational) signal everytime the wheel is rotated.
The Delta Out pin can be used to increment/decrement a Patch Memory (int or float) thru the Patch Memory Increment module, or to increment/decrement any other external value (eg. a shape node position) by suitable connections and modules (eg. the Patch Memory Increment or Float Increment).

Usually you will be able to perform no more than 'Turns per Range' rotations to cover the full declared value range. Whenever the Jog Shuttle must be used to control a value of unlimited range instead, either directly or thru the Delta Out pin, the Unlimited bool pin (unexposed) shall be set.

The Delta Out value will always be proportional to the declared range in any case (for example, setting a range of 0-5 and 10 turns per range, a rotation of 5 degrees to the right produces a delta move of +(5-0)/(10*360/5) = +0.00694444; with a range of 0-10 and 1 turns per range, a rotation of 2 degrees to the left produces a delta move of -(10-0)/(1*360/2), and so on).

When dealing with non-centered images, as in the case of images with a shadow, the rotation movement with the mouse may result compromised, since by default the module assumes that the center of rotation is placed at the very center of the rectangle (width/2, height/2).
To cope with such cases, some convenient Center options have now been provided (unexposed).
The option Show Center can be temporarily enabled to display a cross, useful for adjusting the center offset with the Center Off X and Center Off Y values. For example, if the image used casts a shadow to the lower right, its rotational center will result shifted upwards and to the left: a negative value shall be specified for both offsets with the help of the momentary cross. Please disable the Show Center option when no longer needed.

The integer Alpha Min pin (unexposed, range 0-255) allows to specify a transparency threshold for grasping the image. Normally you don't want to be able to pick an image by its shadow or by another transparent or semi-transparent area; therefore an Alpha Min value of 255 (or even 250 or less if the image is never 100% opaque) is adequate.



