$DD_DIRECTION (vanilla) / dd_direction (sublime: function arg)

[NEW] switch between 0 = horizontal list vs 1 = vertical list

$DD_MOUSE_X; $DD_MOUSE_Y (vanilla) / dd_mouse_x; dd_mouse_y (sublime function arg)

[NEW] sets custom drag movement speed.
leave 0 for default / automatic setting
Max speed is 1000; Lowest speed is 1 (almost no movement)

$DD_MOUSE_X: horizontally

$DD_MOUSE_Y: vertically

Note:

• setting a custom value for both directions will create a completely free omnidirectional cursor movement while still having the sorting function feature, just try it yourself.
• If only same direction values are set, the movement speed can only be slowed down (since the default setting, is already max speed), resulting in a unidirectional movement (default behavior)
• If only opposite direction values are set, the movement speed can only be increased (since the default setting is already lowest speed), resulting in the above mentioned bidirectional cursor movements (since the same direction’s default setting is max already)

Cases:

$DD_DIRECTION = 0: $DD_MOUSE_X = same movement
$DD_DIRECTION = 0: $DD_MOUSE_Y = opposite movement speed

$DD_DIRECTION = 1: $DD_MOUSE_X = opposite movement
$DD_DIRECTION = 1: $DD_MOUSE_Y = same movement

Examples:

1. Horizontal Drag & Drop: One Direction, Cursor movement default but slowed down

$DD_DIRECTION = 0, $DD_MOUSE_X = 100
$DD_DIRECTION = 0: $DD_MOUSE_Y = 0

2.Horizontal Drag & Drop: Omnidirectional, Cursor movement max

$DD_DIRECTION = 0, $DD_MOUSE_X = 1000
$DD_DIRECTION = 0: $DD_MOUSE_Y = 1000

3. Vertical Drag & Drop: One Direction, Cursor movement default but slowed down

$DD_DIRECTION = 1: $DD_MOUSE_X = 1
$DD_DIRECTION = 1: $DD_MOUSE_Y = 100

4. Vertical Drag & Drop: Omnidirectional, same direction max <=> opposite direction slow

$DD_DIRECTION = 1: $DD_MOUSE_X = 100
$DD_DIRECTION = 1: $DD_MOUSE_Y = 0

$DD_NUM_CURSOR (vanilla) / (sublime: no need to set this value)

defines the number of cursors (max 16)

$DD_AREA_WIDTH (vanilla) / dd_width (sublime: function arg)

sets the total width of the drag & drop area in pixels

$DD_AREA_HEIGHT (vanilla) / dd_height (sublime: function arg)

defines the total height of the drag & drop area in pixels

$DD_AREA_JUSTIFY (vanilla) / dd_justify (sublime: function arg)

defines the horizontal alignment of the the whole drag & drop area within your UI.
0 = Left
1 = centered

$DD_AREA_POS_X (vanilla) / dd_posx (sublime: function arg)

positions the drag&drop area accross the x-axis in pixels depending on the $DD_AREA_ALIGN settings. Negative values are allowed but only have effect at centered alignment.
If $DD_AREA_ALIGN the origin is the very left.
if $DD_AREA_ALIGN = 1 the origin is the center of your UI

$DD_AREA_POS_Y (vanilla) / dd_posy (sublime function arg)

positions the drag&drop area across the y-axis in pixels. Negative values have no effect.

1.  put this in the top of the on init (before calling any functions):

   declare !cursor_img[] := ("cursor_list_0","cursor_list_1","cursor_list_2","cursor_list_3","cursor_list_4","cursor_list_5","cursor_list_6","cursor_list_7")
   declare const DD_CURSOR_COUNT := cursor_img.SIZE

2. in the KSP folder open “ksp_draggables_v2-0_xy (sublime).ksp” and copy all the required functions somewhere into your script. Preferably under the “on init”:
   REQUIRED FUNCTIONS: yb_init_ddarea, yb_dragndrop_colision, yb_justify_content
   OPTIONAL FUNCTIONS: yb_set_ui
3. Call the yb_init_ddarea function without the “call” expression anywhere inside the on init and pass all arguments. Read the little SETUP box below
4. Add an on ui_control for ?dd_area and call the yb_dd_oncontrol like so:

   on ui_control (?dd_area)
     yb_dd_oncontrol
   end on

5. please copy the credits & copyright notice (from inside the script) somewhere clearly visible e.g. into another open script tab or into an about section of your instrument.
   If you would like to completely remove the copyright notice, shorten it or place it somewhere else, please get in touch @ https://yummybeats.com/contact

SETUP

declare !cursor_img[] := ("cursor_list_0","cursor_list_1","cursor_list_2",...)

• add custom cursor images. Simply replace all values with your filenames without file extension (.png)
• The images should be formatted like a button with 6 states, learn more (don’t forget to add the txt file)
• To use more than 8 cursors simply extend the array. Up to 16 cursors allowed. A max cursor count would looks like this:
  declare !cursor_img[] := (“cursor_0”, “cursor_1”, “cursor_2”, “cursor_3”, “cursor_4”, “cursor_5”, “cursor_6”, “cursor_7”, “cursor_8”, “cursor_9”, “cursor_10”, “cursor_11”, “cursor_12”, “cursor_13”, “cursor_14”, “cursor_15”)

Passing the Arguments & defining the DD area

yb_init_ddarea(ui_width,ui_height,dd_width,dd_height,dd_justify,dd_posx,dd_posy,dd_direction,dd_mouse_x,dd_mouse_y,dd_array_cursorimg)

{}

• ui_width pass the total width of your UI in pixels e.g. 800
• ui_height pass the height of your UI in pixels e.g. 400
• dd_width pass the width of the drag n drop area
• dd_height pass the height of the drag n drop area
• dd_justify justify the dd_area along the x-axis … 0=left/start, 1=center, 2= right/end
• dd_align align the dd_area along the y-axis … 0=top; 1=center;  2=bottom
• dd_posx move the dd_area across the x-axis depending on the justification (negatives values = left; positive values = right)
• dd_posy move the dd_area across the y-axis depending on the alignment (negatives values = up; positive values = down)
• dd_direction 0=horizontal cursor movement; 1=vertical cursor movement
• dd_mouse_x drag speed across the x-axis 0=default; 1000=max (note: both values above 0 means free cursor movement in 2D space) (read vanilla for detailed explanation)
• dd_mouse_y drag speed across the y-axis 0=default; 1000=max (note: both values above 0 means free cursor movement in 2D space) (read vanilla for detailed explanation)
• dd_array_cursorimg used to pass the cursor image array, so always keep it set to “cursor_img” unless you are using a custom array for the images