lcd

anything refers to the backwards-compatible capitalized messages.

• arguments [list]
  

The word ascii , followed by a number between 0 and 255, writes the character corresponding to that ASCII value at the current pen position, then moves the pen position to the right of that character. Numbers that exceed the 0-255 range are restricted to that range with a modulus operation.

• ascii value [int]
  

The word backsprite , followed by a symbol, sets the named sprite's drawing order so that it is drawn first (and displayed last). This command can be used to alter the order in which sprites are drawn. (Normally, sprites are drawn in the order they are recorded.)

• any symbol [list]
  

Set the background color

• red [int]
  
• green [int]
  
• blue [int]
  

Erase the contents of the lcd display

• arguments [list]
  

The word clearpicts , followed by a symbol, deletes all of an lcd object's named pictures from memory so that they can no longer be drawn. To remove the images from the lcd object's display, the command should be followed by a clear message.

Deletes all of an lcd object's named sprites.

The word closesprite , followed by a symbol argument that names the sprite, turns off sprite command collection and associates the defined region with the symbol. After the closesprite message, drawing commands function normally again.

• any symbol [list]
  

Max color palette selections are specified by a number in the range 0 - 255. Values exceeding 255 are range-restricted using a modulus operation.

• color-id [int]
  

The word deletepict , followed by a symbol, deletes the named the picture from memory so that it can no longer be drawn. To remove the image from the lcd object's display, the command should be followed by a clear message.

• any symbol [list]
  

The word deletesprite , followed by a symbol, deletes the named sprite.

• any symbol [list]
  

The word drawpict , followed by a symbol, draws the named picture. Optionally there may follow four numbers specifying a destination rectangle in which the picture is scaled and drawn, and source rectangle that specifies the area of the picture to use in the operation. These rectangles are specified as left, top, width, and height values in pixels. The destination rectangle is relative to the top left corner of the lcd display area. The source rectangle is relative to the top, left corner of the picture. If not present, these rectangles are both set to be the same size as the picture.

• arguments [list]
  

The word drawsprite , followed by a symbol, draws the named sprite. Optionally this may be followed by a pair of numbers that specify a horizontal and vertical offset for drawing the sprite.

• any symbol [list]
  

The font message specifies a font ID using the font number mapping that Max 6 uses generally and a font size to select a font used when drawing text in response to a write or ascii message.

• font-id [list]
  
• font-size () [list]
  

Same as paintarc except that only the unfilled outline of the arc is drawn.

• left () [int]
  
• top () [int]
  
• right () [int]
  
• bottom () [int]
  
• start-angle [degrees]
  
• degrees-arc [degrees]
  
• red [int]
  
• green [int]
  
• blue [int]
  

Same as paintoval except that only the unfilled outline of the oval is drawn.

• left () [int]
  
• top () [int]
  
• right () [int]
  
• bottom () [int]
  
• red [int]
  
• green [int]
  
• blue [int]
  

Same as paintpoly except that only the unfilled outline of the polygon is drawn.

• x/y int pairs [list]
  

Same as paintrect except that only the unfilled outline of the rectangle is drawn.

• left () [int]
  
• top () [int]
  
• right () [int]
  
• bottom () [int]
  
• red [int]
  
• green [int]
  
• blue [int]
  

Same as paintroundrect except that only the unfilled outline of the rounded rectangle is drawn.

• left () [int]
  
• top () [int]
  
• right () [int]
  
• bottom () [int]
  
• horizontal-roundness () [int]
  
• vertical-roundness () [int]
  
• red [int]
  
• green [int]
  
• blue [int]
  

Set the foreground (pen) color

• red () [int]
  
• green () [int]
  
• blue () [int]
  

The word frontsprite , followed by a symbol, sets the named sprite's drawing order so that it is drawn last (and displayed first). This command can be used to alter the order in which sprites are drawn. (Normally, sprites are drawn in the order they are recorded.)

• any symbol [list]
  

The word getpenloc outputs a message consisting of the word penloc followed by two numbers, out the lcd object's right outlet. The numbers represent local coordinates relative to the top-left corner of the lcd display area. The first number is the number of pixels to the right of that corner, and the second number is the number of pixels down from that corner.

• local-coordinates [list]
  

The word getpixel , followed by two integers specifying an offset from the top left corner of the lcd object's display, sends a message consisting of the word pixel followed by three numbers that specify the color of the pixel in RGB format and two additional numbers that specify the pixel offset.

• x-offset () [int]
  
• y-offset () [int]
  

Ouputs a message from the right outlet consisting of the word size and two numbers which report the width and height in pixels of the lcd display area.

Disable the drawing of a named sprite

• any symbol [list]
  

The word line , followed by two int arguments for horizontal and vertical offset, in pixels, relative to the current pen position, draws a line from the current pen position to a point determined by the specified offset, and that point becomes the new pen position. Positive arguments draw the line to the right or down; negative arguments draw up or to the left.

• x position [int]
  
• y position [int]
  

The word linesegment , followed by four int arguments that specify the endpoints of a line segment, draw a line. The numbers represent the horizontal and vertical offset of the beginning endpoint, and the horizontal and vertical offset of the finishing endpoint, in pixels, relative to the top left corner of the lcd display area. A color may optionally be specified using a single number that selects a color from Max's color palette (similar to the color message), or by using three additional numbers that describe an RGB value (similar to the frgb message).

• x start () [int]
  
• y start () [int]
  
• x end () [int]
  
• y end () [int]
  

The word lineto , followed by two int arguments for horizontal and vertical ending point, draws a line from the current pen position to the position specified by the arguments.

• x endpoint [int]
  
• y endpoint [int]
  

You can draw freehand in lcd with the mouse (provided this feature has not been turned off with a local 0 message). The mouse will draw with the current pen and color characteristics, and the mouse location will be sent out the outlet.

Moves the pen position a certain number of pixels down from, and to the right of, its current position. The word move must be followed by two int arguments for horizontal and vertical offset, in pixels, relative to the current pen position. Negative arguments may be used to move the pen position up or to the left.

• x position [int]
  
• y position [int]
  

Sets the pen position at which the next graphic instruction will be drawn. The moveto message must include two int arguments for horizontal and vertical offset, in pixels, relative to the upper left corner of the lcd display area.

• x position [int]
  
• y position [int]
  

The word oprgb , followed by three numbers between 0 and 255, specify an RGB value used as the opcolor for penmodes that support it.
If the penmode is set to 32, the alpha channel value is derived by averaging the three RGB values and mapping the average to the range 0. - 1.0 (e.g., an oprgb value of 128 128 128 would have an alpha value of .5 when the penmode is set to 32).

• red [int]
  
• green [int]
  
• blue [int]
  

The word paintarc , followed by six int arguments that specify the left, top, right, and bottom extremities of an oval across which the arc will be drawn, the start angle (0 is the top) and degrees of arc, paints an arc.

• left () [int]
  
• top () [int]
  
• right () [int]
  
• bottom () [int]
  
• start-angle [degrees]
  
• degrees-arc [degrees]
  
• red [int]
  
• green [int]
  
• blue [int]
  

The word paintoval , followed by four int arguments specifying the left, top, right, and bottom extremities of an oval, paints an oval. These extremities are specified in pixels, relative to the top left corner of the lcd display area. A color may optionally be specified using a single number that selects a color from Max's color palette (similar to the color message), or by using three additional numbers that describe an RGB value (similar to the frgb message).

• left () [int]
  
• top () [int]
  
• right () [int]
  
• bottom () [int]
  
• red [int]
  
• green [int]
  
• blue [int]
  

The word paintpoly may be followed by as many as 254 int arguments that would specify a series of x/y pairs that define a polygon to be painted in lcd. These x/y pairs are specified in pixels, relative to the top left corner of the lcd display area.

• x/y int pairs [list]
  

Left, top, right and bottom positions for the rectangle are specified in pixels, relative to the top left corner of the lcd display area when painting a filled rectangle. A color may optionally be specified using a single number that selects a color from Max's color palette (similar to the color message), or by using three additional numbers that describe an RGB value (similar to the frgb message).

• left () [int]
  
• top () [int]
  
• right () [int]
  
• bottom () [int]
  
• red [int]
  
• green [int]
  
• blue [int]
  

The word paintroundrect , followed by six int arguments specifying the left, top, right, and bottom positions of a rectangle and the amount of horizontal and vertical roundness in pixels, paints a rounded rectangle. The edge positions are specified in pixels, relative to the top left corner of the lcd display area. A color may optionally be specified using a single number that selects a color from Max's color palette (similar to the color message), or by using three additional numbers that describe an RGB value (similar to the frgb message).

• left () [int]
  
• top () [int]
  
• right () [int]
  
• bottom () [int]
  
• horizontal-roundness () [int]
  
• vertical-roundness () [int]
  
• red [int]
  
• green [int]
  
• blue [int]
  

The word penmode , followed by a number in the range 0-7, sets the transfer mode for subsequent drawing operations. The following are transfer mode constants;

Copy 0
Or 1
Xor 2
Bic 3
NotCopy 4
NotOr 5
NotXor 6
NotBic 7

• transfer-mode [list]
  

The word pensize , followed by two equal int arguments specifying horizontal and vertical thickness in pixels (e.g., 4 4), sets the current pensize. The horizontal and vertical thicknesses must be equal.

• horizontal-thickness () [int]
  
• vertical-thickness () [int]
  

The word readpict followed by a symbol which specifies a filename, looks for a graphic file (a .pct file openable on Windows using the QuickTime Picture Viewer for Windows) with that name in Max's file search path, and reads the picture file from disk into RAM. This named picture can then be drawn in lcd with the drawpict and tilepict messages. In response to the readpict message, the object sends a message out the right outlet of the lcd object consisting of the word pict followed by a symbol which specifies the name of the picture file and two numbers which specify the file's width and height. If the read is unsuccessful, the error message pict <pictname> error will be sent out the right outlet.

• filename [list]
  

Initiates the recording of drawing commands which will be stored in a named sprite. While recording, drawing commands will have no effect on the contents of the lcd object's window.

The erase message erases the current display and resets the colors, pen, and pen position to their default states. It is equivalent to the message

clear, pensize 1, penmode 0, frgb 0 0 0, brgb 255 255 255, moveto 0 0

• arguments [list]
  

The word scrollrect , followed by six int arguments that specify the left, top, right, and bottom positions of a rectangle to be scrolled and the number of pixels to scroll in the x and y direction, scrolls a rectangle within the lcd object's display area.

• left () [int]
  
• top () [int]
  
• right () [int]
  
• bottom () [int]
  
• x-offset () [int]
  
• y-offset () [int]
  

The word setpixel , followed by two numbers which specify a location in local coordinates relative to the top-left corner of the lcd display area and a list of three integers in the range 0-255 which specify a color in RGB format, will set the pixel at the designated location to the selected color.

• x coordinate [int]
  
• y coordinate [int]
  
• red [int]
  
• green [int]
  
• blue [int]
  

The word size , followed by two integers, changes the lcd object window size. The Maximum size is 8192 x 8192.

• horizontal-size () [int]
  
• vertical-size () [int]
  

The word textface , followed by one or more names specifying text style(s), sets the font style(s) to be used when rendering text. Text style names are normal , bold , and italic .

• text-styles [list]
  

The word tilepict , followed by a picture name argument, fills a rectangle by tiling a picture. Optionally there may follow, four numbers that specify a destination rectangle in which the picture is tiled and four numbers that specify a source rectangle that specifies the area of the picture to use in the operation. These rectangles are specified as left, top, width, and height values in pixels. The destination rectangle is relative to the top left corner of the lcd display area. The source rectangle is relative to the top, left corner of the picture. If not present, the destination rectangle is set to the same size of lcd, and the source rectangle is set to be the same size as the picture.

• arguments [list]
  

The word write , followed by any symbol, writes that symbol beginning at the current pen position, and moves the pen position to the end of the text.

• any symbol [list]
  

The word writepict , followed by an optional filename argument, writes the current contents of the lcd display area to a PNG file.

• filename [symbol]