
SAMPLING 2 / SAMPLE MARKER
--------------------------

Modular waveform marker, to be used in conjunction (but not necessarily only) with the Sample Display/Edit module.
A typical usage is overlaying one or more Markers on top of a waveform display, each one set with suitable Label, color and label positioning. Offset, Visible and Total shall all be linked together with the main Waveform Display, for marker positioning to be consistent across zooming or scrolling of the waveform display.

A Marker can be grasped by its Label by clicking and keeping the left mouse button pressed, and then dragged to a new position.
An extra invisible handle of 10 pixels is provided at the opposite side of the label, to allow grasping markers whose labels have slided off-screen.
Markers with empty label can't be grasped.

A compact version is also included which occupies less space in the structure view, by having all cosmetic pins not exposed.

The Reset Marker module can be conveniently used to automatically reset markers at preset positions in function of the sample length.


NOTE (detailed sample positioning):
-----------------------------------
Markers are now always placed in the middle of every sample frame (this becomes visible only at magnification levels where individual samples frames are larger than one pixel). This prevents visual inconsistency between start and end markers (previously, they were placed at the start or at the end of sample frames, respectively). A better solution does not exist.


PIN DESCRIPTION
---------------

Offset, Visible, Total (input) -  These standardised values represent the sample Length (Total), the amount of visible samples depending on the current zoom factor (Visible) and position from start of the visible window (Offset). Link these integer pins to the corresponding ones of a Waveform Display module and (if needed) of a Scroll Bar module or more Marker modules.

Pos (input/output) - integer marker position from start. A negative value can be specified aswell, to indicate an offset from the end (where -1 stands for the last sample).

Label (input) - string for the marker label

Style (input) - text style for the marker label (style color is replaced by the specified ARGB color)

Label Left (input) - whether to place the label on the left of the marker or on its right (default)

Mouse Down (output) - TRUE while clicking on the marker label

Marker and Label ARGB - standard hexadecimal 32-bits ARGB strings specifying the colors of the marker and of its text label