draws an embossed rectangle, optionally with a background-color

returns false in case of an error

draws a round-rectangle with a custom thickness.

You shouldn't redraw with it too often, as it eats many ressources

returns false in case of an error

blits a framebuffer at position 0,0. If the gfx-window is smaller than the contents of the framebuffer, it will resize it before blitting to window size, retaining the correct aspect-ratio.

Mostly intended for debugging-purposes, when you want to track, if a certain framebuffer contains, what you expect it to contain.

returns false in case of an error

Blits a centered image at the position given by parameter x and y. That means, the center of the image will be at x and y.

All the rest basically works like the regular gfx.blit-function.

returns false in case of an error

Returns a font_layout-value that can be used for the parameter flags for the function gfx.drawstr.

Note: as per limitation of Reaper, you can only have up to 4 font_layout-parameters at the same time.

Some combinations do not work together, so you need to experiment.

Resizes an image, keeping its aspect-ratio. You can set a background-color for non rectangular-images.

Resizing upwards will probably cause artifacts!

Note: this uses image 1023 as temporary buffer so don't use image 1023, when using this function!

Sets the font of the gfx-window.

As Mac and Windows have different visible font-sizes for the same font-size, this function adapts the font-size correctly(unlike Reaper's own native gfx.setfont-function).

returns false in case of an error

gets all characters from the keyboard-queue of gfx.getchar as a handy table.

the returned table character_queue is of the following format:

    character_queue[index]["Code"] - the character-code
    character_queue[index]["Ansi"] - the character-code converted into Ansi
    character_queue[index]["UTF8"] - the character-code converted into UTF8
  
When readable_characters=true, the entries of the character_queue for Ansi and UTF8 will hold readable strings for non-printable characters, like:
  "ins ", "del ", "home", "F1  "-"F12 ", "tab ", "esc ", "pgup", "pgdn", "up  ", "down", "left", "rght", "bspc", "ente"
  
You can optionally let this function manage clipboard. So hitting Ctrl+V will get put the content of the clipboard into the character_queue of Ansi/UTF8 in the specific position of the character-queue,
while hitting Ctrl+C will put the contents of the parameter to_clipboard into the clipboard in this case.

Retval first_typed_character behaves basically like the returned character of Reaper's native function gfx.getchar()

returns -2 in case of an error

Checks clickstates and mouseclick/wheel-behavior, since last time calling this function and returns their states.
Allows you to get click, doubleclick, dragging, including the appropriate coordinates and mousewheel-states.

Much more convenient, than fiddling around with gfx.mouse_cap

Note: After doubleclicked, this will not return mouse-clicked-states, until the mouse-button is released. So any mouse-clicks during that can be only gotten from the retval mouse_cap.
      This is to prevent automatic mouse-dragging after double-clicks.

This draws text to x and y and adapts the line-lengths to fit into width and height.

returns the files drag'n'dropped into a gfx-window, including the mouseposition within the gfx-window, where the files have been dropped.

if changed==true, then the filelist is updated, otherwise this function returns the last dropped files again.
Note: when the same files will be dropped, changed==true will also be dropped with only the mouse-position updated.
That way, dropping the same files in differen places is recognised by this function.

Call repeatedly in every defer-cycle to get the latest files and coordinates.

Important: Don't use Reaper's own gfx.dropfile while using this, as this could intefere with this function.

Returns the HWND of the currently opened gfx-window. You need to use ultraschall.GFX_Init(), otherwise
it will contain the message "Please, use ultraschall.GFX_Init() for window-creation, not gfx.init(!), to retrieve the HWND of the gfx-window."

Opens a new graphics window and returns its HWND-windowhandler object.