Class Canvas

Contains drawing operations.

Methods

• clear [color <color c = Color.black>]
• draw bitmap <bitmap bmp> to <position bitmapPos> [alpha <int a = 255>]
• draw bitmap <bitmap bmp> to <rectangle targetRect> [offset <position bitmapOffset = 0, 0>] [alpha <int a = 255>]
• draw bitmap <bitmap bmp> to <position bitmapPos> source <rectangle sourceRectangle>[alpha <int a = 255>]
• draw string <string str> to <position textPosition> [color <color textColor = color.white>] [font <font f = system.get default font>]
• draw string <string str> range <range strRange> to <position textPosition> [color <color textColor = color.white>] [font <font f = system.get default font>]
• draw rectangle <rectangle rect> [color <color rectangleColor = Color.white>]
• draw line from <position fromPos> to <position toPos> [color <color lineColor = Color.white>]

clear [color <color c = Color.black>]

Clears the canvas object with a color.

Parameters

• c - The clear color. Default is black.

main
  system.run application new MyApplication
                
class MyApplication extends Application
  draw to <canvas g>
    // Clear object to white
    g.clear color Color.white
                

draw bitmap <bitmap bmp> to <position bitmapPos> [alpha <int a = 255>]

Draws a bitmap. The optional alpha value specifies the opaqueness of the drawn bitmap.

Parameters

• bmp - The bitmap to draw.
• bitmapPos - The position where the bmp is drawn.
• a - Alpha value

main
  system.run application new MyApplication
                
class MyApplication extends Application
  draw to <canvas g>
    Bitmap bmp = new Bitmap from file "example.png"
    // Draw bitmap to upper left corner
    g.draw bitmap bmp to 0,0
                

draw bitmap <bitmap bmp> to <rectangle targetRect> [offset <position bitmapOffset = 0, 0>] [alpha <int a = 255>]

Fills a rectangle with bitmap. The bitmap is tiled if it does not cover the whole targetRect area.

Parameters

• bmp - The bitmap to draw.
• targetRect - The rectangle that will be filled using the bitmap bmp
• bitmapOffset - This specifies the tiling offset for the bitmap.
• a - Alpha value

main
  system.run application new MyApplication
                
class MyApplication extends Application
  draw to <canvas g>
    Bitmap bmp = new Bitmap from file "example.png"
    // Draw bitmap to rectangle starting at upper left corner with size 100x100.
    g.draw bitmap bmp to 0, 0 size 100, 100
                

draw bitmap <bitmap bmp> to <position bitmapPos> source <rectangle sourceRectangle>[alpha <int a = 255>]

Draws a part of bitmap. The sourceRect specifies the area to draw. This area will be clipped to the bmp's boundaries.

Parameters

• bmp - The bitmap to draw.
• bitmapPos - The position where the bmp is drawn.
• sourceRectangle - Defines the area of the bmp that is drawn.
• a - Alpha value

main
  system.run application new MyApplication
                
class MyApplication extends Application
  draw to <canvas g>
    Bitmap bmp = new Bitmap from file "example.png"
    // Draw 50x50 area of bitmap to upper left corner.
    g.draw bitmap bmp to 0, 0 source 0, 0 size 50, 50
                

draw string <string str> to <position textPosition> [color <color textColor = color.white>] [font <font f = system.get default font>]

Draws a string.

Parameters

• str - The string to draw.
• textPosition - The position where the string is drawn to.
• textColor - Text color. The default color is white.
• f - The font that is used on drawing. The default value is the default system font.

main
  system.run application new MyApplication
                
class MyApplication extends Application
  draw to <canvas g>
    // Draw string "Test data" with default font to upper left corner
    g.draw string "Test data" to 0,0
                

draw string <string str> range <range strRange> to <position textPosition> [color <color textColor = color.white>] [font <font f = system.get default font>]

Draws a string.

Parameters

• str - The string to draw.
• strRange - Defines the sub-range of the string that is draw. The default value is the whole string.
• textPosition - The position where the string is drawn to.
• textColor - Text color. The default color is white.
• f - The font that is used on drawing. The default value is the first system font.

main
  system.run application new MyApplication
                
class MyApplication extends Application
  draw to <canvas g>
    Font f = system.load bitmap font from file "bitmapFont.png"
    // Draw string "Test" to upper left corner with blue color and loaded font.
    g.draw string "Test data" range 0 size 4 to 0,0 color Color.blue font f
                

draw rectangle <rectangle rect> [color <color rectangleColor = Color.white>]

Draws a filled rectangle.

Parameters

• rect - The rectangle to draw.
• rectangleColor - The color for the rectangle. The default color is white.

main
  system.run application new MyApplication
                
class MyApplication extends Application
  draw to <canvas g>
    // Draw green rectangle of size 50x50 to position 100,100
    g.draw rectangle 100,100 size 50,50 color Color.green
                

draw line from <position fromPos> to <position toPos> [color <color lineColor = Color.white>]

Draws a line from fromPos to toPos.

Parameters

• fromPos - The first point of the line.
• toPos - The last point of the line.
• lineColor - Color for the line. The default color is white.

main
  system.run application new MyApplication
                
class MyApplication extends Application
  draw to <canvas g>
    Size screenSize = screen.get size
    // Draw orange line from top left corner to bottom right corner.
    g.draw line from 0,0 to screenSize.get width, screenSize.get height color Color.Orange