The originally intended use is to give the user of a gui the opportunity to create his own function/dataset which can be fetched from the X/YData of the line object after it has been changed.
The function adds a few callbackfunctions to the figure that contains the line object. These implement the following functionalities:
-adding points to the line
-removing points from the line
-moving existing points under different restrictions
You basically just have to call 'LineManipulator(lineHandle,controlMode)'
with lineHandle being a valid handle to a line object and controlMode being one of the following strings:
everything is allowed
blocks the moving data point when it would pass the neigbouring points on the x/y-axis
pushes all other data points with the moving data point if it would pass them on the x/y-axis
deactivates the functionality