NAME

cursor_setstorage - Use the storage defined by one video object as an accelerated mouse cursor.

SYNOPSIS

nil
cursor_setstorage( vid, txcos )

DESCRIPTION

This function works like image_sharestorage but with the target destination being the accelerated overlay cursor render path. The optional txcos argument should (if present) be an integer indexed table with exactly 8 elements where each element (n) is 0 <= n <= 1 specifying [ul_x, ul_y, ur_x, ur_y, lr_x, lr_y, ll_x, ll_y]. This can be used as a cheaper way of animating cursors or packing many cursors in the same vid.

NOTES

1

using cursor_setstorage( WORLDID ) will disable the accelerated cursor path.

EXAMPLE

function cursor_setstorage0()


      curs = fill_surface(8, 8, 255, 0, 0);


      cursor_setstorage(curs);


      resize_cursor(16, 16);


      move_cursor(VRESW * 0.5, VRESH * 0.5);
end

SEE ALSO:

cursor_position(3) nudge_cursor(3) resize_cursor(3) move_cursor(3)