From Inspired-Lua Wiki
Jump to: navigation, search

clipRect is a function that is part of gc.

Sets the clipping rectangle for subsequent graphics operations.

This has been introduced in TI-Nspire OS 3.0 (Changes).


gc:clipRect(op, x, y, width, height)

Parameter Type Description
string Can either be "set", "intersect", "reset", or "null"
number x coordinate
number y coordinate
number the width of the rectangle
number the height of the rectangle

Details about the "op" parameter : Parameter op takes one of the strings “set”, “reset”, “intersect”, or “null”.

  • reset sets the clipping rectangle to include the entire window. The remaining parameters is ignored and can be left out.
  • set sets the clipping rectangle to the x, y coordinates with the specified width and height. The remaining parameters default to the system window location and size.
  • intersect sets the clipping rectangle to the intersection of the current clipping rectangle with the rectangle specified in the routine parameters. It has been removed in platform.apilevel = 2.0 (OS 3.2)
  • null sets the clipping rectangle to empty. All subsequent graphics commands will be ignored.

Typically the “set” operation is called before drawing, say, a text string. It is important to call the “reset” operation after drawing the last clipped graphic so that you don’t leave a lingering clipping rectangle as a side effect.


gc:clipRect("set", 20, 20, 50, 10)