Function Entry: TABLET

← Prev | ↑ Chapter | Next → | Index | Symbols

Function Entry: TABLET

Name

tablet

Class

Function

Syntax

(tablet code [row1 row2 row3 direction])

Arguments and Values

  • code: integer.
    • 0: retrieve the current digitiser calibration; the trailing arguments are omitted.
    • 1: set the calibration; the trailing arguments are required.
  • row1, row2, row3: lists of three reals forming the rows of a 33 transformation matrix. The Z component of row3 is normalised to 1.
  • direction: list of three reals; the normal vector to the tablet surface in WCS. Automatically normalised.

Description

Retrieves or sets digitiser (tablet) calibrations. Calibration data lets AutoCAD transform raw digitiser coordinates into drawing-space coordinates.

Return Values

An integer on success. On failure, returns nil and sets the AutoCAD ERRNO system variable; typical failure cause is that the input device is not a tablet.

Side Effects

Updates the AutoCAD digitiser calibration state.

Examples

  • Identity calibration: (tablet 1 '(1 0 0) '(0 1 0) '(0 0 1) '(0 0 1)).

Availability

  • AutoCAD 2026: documented (Windows only).
  • BricsCAD V26: presumed compatible (Windows-only digitiser feature).
  • Status: AutoCAD-Windows documented; BricsCAD parity TBD.