back to main JSFX reference page

JSFX Programming Reference - Graphics
  • Graphics

    top  Graphics

    Effects can specify a @gfx code section, from which the effect can draw its own custom UI and/or analysis display.

    These functions and variables must only be used from the @gfx section.
    • gfx_lineto(x,y,aa) -- the aa parameter is optional in REAPER 4.59+
      Draws a line from gfx_x,gfx_y to x,y. if aa is 0.5 or greater, then antialiasing is used. Updates gfx_x and gfx_y to x,y.

    • gfx_line(x,y,x2,y2[,aa]) -- REAPER 4.59+
      Draws a line from x,y to x2,y2, and if aa is not specified or 0.5 or greater, it will be antialiased.

    • gfx_rectto(x,y)
      Fills a rectangle from gfx_x,gfx_y to x,y. Updates gfx_x,gfx_y to x,y.

    • gfx_rect(x,y,w,h) -- REAPER 4.59+
      Fills a rectngle at x,y, w,h pixels in dimension.

    • gfx_setpixel(r,g,b)
      Writes a pixel of r,g,b to gfx_x,gfx_y.

    • gfx_getpixel(r,g,b)
      Gets the value of the pixel at gfx_x,gfx_y into r,g,b.

    • gfx_drawnumber(n,ndigits)
      Draws the number "n" with "ndigits" of precision to gfx_x, gfx_y, and updates gfx_x to the right side of the drawing. The text height is gfx_texth

    • gfx_drawchar($'c')
      Draws the character 'c' (can be a numeric ASCII code as well), to gfx_x, gfx_y, and moves gfx_x over by the size of the character.

    • gfx_drawstr(str) -- REAPER 4.59+
      Draws a string at gfx_x, gfx_y, and updates gfx_x/gfx_y so that subsequent draws will occur in a similar place:
       gfx_drawstr("a"); gfx_drawstr("b");
      will look about the same as:

    • gfx_measurestr(str,w,h) -- REAPER 4.59+
      Measures the drawing dimensions of a string with the current font (as set by gfx_setfont).

    • gfx_setfont(idx[,fontface, sz, flags]) -- REAPER 4.59+
      Can select a font and optionally configure it. idx=0 for default bitmapped font, no configuration is possible for this font. idx=1..16 for a configurable font, specify fontface such as "Arial", sz of 8-100, and optionally specify flags, which is a multibyte character, which can include 'i' for italics, 'u' for underline, or 'b' for bold. These flags may or may not be supported depending on the font and OS. After calling gfx_setfont, gfx_texth may be updated to reflect the new average line height.

    • gfx_getfont() -- REAPER 4.59+
      Returns current font index.

    • gfx_printf(str, ...) -- REAPER 4.59+
      Formats and draws a string at gfx_x, gfx_y, and updates gfx_x/gfx_y accordingly (the latter only if the formatted string contains newline).

    • gfx_blurto(x,y) -- REAPER 2.018+
      Blurs the region of the screen between gfx_x,gfx_y and x,y, and updates gfx_x,gfx_y to x,y.

    • gfx_blit(source, scale, rotation) -- REAPER 2.018+
      If three parameters are specified, copies the entirity of the source bitmap to gfx_x,gfx_y using current opacity and copy mode (set with gfx_a, gfx_mode). You can specify scale (1.0 is unscaled) and rotation (0.0 is not rotated, angles are in radians).

      For the "source" parameter specify -1 to use the main framebuffer as source, or 0..127 to use the image specified (or PNG file in a filename: line).

      gfx_blit(source, scale, rotation[, srcx, srcy, srcw, srch, destx, desty, destw, desth, rotxoffs, rotyoffs]) -- REAPER 4.59+
      Srcx/srcy/srcw/srch specify the source rectangle (if omitted srcw/srch default to image size), destx/desty/destw/desth specify dest rectangle (if not specified, these will default to reasonable defaults -- destw/desth default to srcw/srch * scale).

    • gfx_blitext(source, coordinatelist, rotation) -- REAPER 2.018+
      This is a version of gfx_blit which takes many of its parameters via a buffer rather than direct parameters.

      For the "source" parameter specify -1 to use the main framebuffer as source, or 0..127 to use the image specified (or PNG file in a filename: line).

      coordinatelist should be an index to memory where a list of 10 parameters are stored, such as:
        coordinatelist=1000; // use memory slots 1000-1009
        coordinatelist[8]=rotation_x_offset; // only used if rotation is set, represents offset from center of image
        coordinatelist[9]=rotation_y_offset; // only used if rotation is set, represents offset from center of image

    • gfx_getimgdim(image, w, h) -- REAPER 2.018+
      Retreives the dimensions of image (representing a filename: index number) into w and h. Sets these values to 0 if an image failed loading (or if the filename index is invalid).

    • gfx_setimgdim(image, w,h) -- REAPER 4.59+
      Resize image referenced by index 0..127, width and height must be 0-2048. The contents of the image will be undefined after the resize.

    • gfx_loadimg(image, filename) -- REAPER 4.59+
      Load image from filename (see strings) into slot 0..127 specified by image. Returns the image index if success, otherwise -1 if failure. The image will be resized to the dimensions of the image file.

    • gfx_gradrect(x,y,w,h, r,g,b,a[, drdx, dgdx, dbdx, dadx, drdy, dgdy, dbdy, dady]) -- REAPER 4.59+
      Fills a gradient rectangle with the color and alpha specified. drdx-dadx reflect the adjustment (per-pixel) applied for each pixel moved to the right, drdy-dady are the adjustment applied for each pixel moved toward the bottom. Normally drdx=adjustamount/w, drdy=adjustamount/h, etc.

    • gfx_muladdrect(x,y,w,h, mul_r, mul_g, mul_b[, mul_a, add_r, add_g, add_b, add_a]) -- REAPER 4.59+
      Multiplies each pixel by mul_* and adds add_*, and updates in-place. Useful for changing brightness/contrast, or other effects.

    • gfx_deltablit(srcimg,srcx,srcy,srcw,srch, destx, desty, destw, desth, dsdx, dtdx, dsdy, dtdy, dsdxdy, dtdxdy ) -- REAPER 4.59+
      Blits from srcimg(srcx,srcy,srcw,srch) to destination (destx,desty,destw,desth). Source texture coordinates are s/t, dsdx represents the change in s coordinate for each x pixel, dtdy represents the change in t coordinate for each y pixel, etc. dsdxdy represents the change in dsdx for each line.

    • gfx_transformblit(srcimg, destx, desty, destw, desth, div_w, div_h, table) -- REAPER 4.59+
      Blits to destination at (destx,desty), size (destw,desth). div_w and div_h should be 2..64, and table should point to a table of 2*div_w*div_h values (this table must not cross a 65536 item boundary). Each pair in the table represents a S,T coordinate in the source image, and the table is treated as a left-right, top-bottom list of texture coordinates, which will then be rendered to the destination.

    • gfx_circle(x,y,r[,fill,antialias]) -- REAPER 4.60+
      Draws a circle, optionally filling/antialiasing.

    • gfx_roundrect(x,y,w,h,radius[,antialias]) -- REAPER 4.60+
      Draws a rectangle with rounded corners.

    • gfx_arc(x,y,r, ang1, ang2[,antialias]) -- REAPER 4.60+
      Draws an arc of the circle centered at x,y, with ang1/ang2 being specified in radians.

    • gfx_triangle(x1,y1,x2,y2,x3,y3[,x4,y4,...]) -- REAPER 5.0+
      Fills a triangle (or a convex polygon if more than 3 pairs of coordinates are specified).

    • gfx_getchar([char]) -- REAPER 4.60+
      If no parameter or zero is passed, returns a character from the plug-in window's keyboard queue. The return value will be less than 1 if no value is available.

      If char is passed and nonzero, returns whether that key is currently down.

      Common values are standard ASCII, such as 'a', 'A', '=' and '1', but for many keys multi-byte values are used, including 'home', 'up', 'down', 'left', 'rght', 'f1'.. 'f12', 'pgup', 'pgdn', 'ins', and 'del'.

      If the user has the "send all keyboard input to plug-in" option set, then many modified and special keys will be returned, including:
      • Ctrl/Cmd+A..Ctrl+Z as 1..26
      • Ctrl/Cmd+Alt+A..Z as 257..282,
      • Alt+A..Z as 'A'+256..'Z'+256
      • 27 for ESC
      • 13 for Enter
      • ' ' for space

      The plug-in can specify a line (before code sections):
      which will change the "send all keyboard input to plug-in" option to be on by default for new instances of the plug-in. -- REAPER 4.6+

    • gfx_r, gfx_g, gfx_b, gfx_a
      These represent the current red, green, blue, and alpha components used by drawing operations (0.0..1.0).

    • gfx_w, gfx_h
      These are set to the current width and height of the UI framebuffer.

    • gfx_x, gfx_y
      These set the "current" graphics position in x,y. You can set these yourselves, and many of the drawing functions update them as well.

    • gfx_mode
      Set to 0 for default options. Add 1.0 for additive blend mode (if you wish to do subtractive, set gfx_a to negative and use gfx_mode as additive). Add 2.0 to disable source alpha for gfx_blit(). Add 4.0 to disable filtering for gfx_blit().

    • gfx_clear
      If set to a value greater than -1.0, this will result in the framebuffer being cleared to that color. the color for this one is packed RGB (0..255), i.e. red+green*256+blue*65536. The default is 0 (black).

    • gfx_dest -- REAPER 4.59+
      Defaults to -1, set to 0..127 to have drawing operations go to an offscreen buffer (or loaded image).

    • gfx_texth
      Set to the height of a line of text in the current font. Do not modify this variable.

    • mouse_x, mouse_y
      mouse_x and mouse_y are set to the coordinates of the mouse within the graphics area of the window.

    • mouse_cap
      mouse_cap is a bitfield of mouse and keyboard modifier state.
      • 1: left mouse button
      • 2: right mouse button
      • 4: Control key (Windows), Command key (OSX)
      • 8: Shift key
      • 16: Alt key (Windows), Option key (OSX)
      • 32: Windows key (Windows), Control key (OSX) -- REAPER 4.60+
      • 64: middle mouse button -- REAPER 4.60+

    • mouse_wheel, mouse_hwheel -- REAPER 4.60+
      mouse wheel (and horizontal wheel) positions. These will change typically by 120 or a multiple thereof, the caller should clear the state to 0 after reading it.

  •   Home
        Old Versions
        Language Packs
        Theme Development
        Custom Cursors
        JSFX Programming
        Extensions SDK
        Extensions to VST SDK
        Language Pack Template
        User Guide