# TABLET Command [GstarCAD 2015](../../Index.md) → [Commands](../%28Commands%29.md) → [T](%28T%29.md) ## Function Description: > Calibrate, configure, and turn on and off an attached digitizing tablet **Menu:** > Tools\>Tablet **Command Entry:** > TABLET **Command Prompt:** > Tablet: ON/OFF/CALibrate/ConFiGure/\<On\>: > > **ON** > > Turns on Tablet mode. > > **OFF** > > Turns off Tablet mode. > > **CALibrate** > > > Calibrate the digitizer with a paper drawing or photograph, creating the tablet transformation, which is the mapping of points from the tablet to the coordinate drawing system. > > > > Calibration is digitizing points on the drawing and mapping them to their real coordinates. > > > > Calibration can be performed in model space or paper space. The Cal option turns on Tablet mode in the space in which the tablet is calibrated. When the space is changed, the Cal option turns off Tablet mode. > > > > The paper should be flat (with no bumps or wrinkles) and securely fastened to the digitizing tablet. The paper can be oriented at any angle. > > > > Digitize point #1: *Digitize a point on the paper drawing* > > > > Enter coordinates for point #1: *Specify an X,Y coordinate at the digitized point* > > > > Digitize point #2: *Digitize a point on the paper drawing* > > > > Enter coordinates for point #2: *Specify an X,Y coordinate at the digitized point* > > > > Digitize point #3 (or ENTER to end): *Digitize a point on the tablet or press*ENTER > > > > Enter coordinates for point #3: *Specify an X,Y coordinate in the drawing* > > > > The points you enter cannot be duplicates. The points need not be the origin on either axis, and you can enter as many points as you like. The more points you enter, the more accurate the drawing will be. > > > > If you enter only two points, the program automatically computes an orthogonal transformation. If it is successful, the Command ends. > > > > If you enter three or more points, the program computes the transformation in each of the three transformation types (Orthogonal, Affine, and Projective) to determine which best fits the calibration points. If you enter more than four points, computing the best-fitting projective transformation can take a long time. You can cancel the process by pressing ESC. > > > > When the computations are complete, the program displays a table with the number of calibration points and a column for each transformation type. > > > > If there have been no failures of projection transformation, the program prompts you to choose a transformation type. > > > > Enter transformation type \[Orthogonal/Affine/Projective/Repeat table\] \<Repeat\>: *Enter an option or press*ENTER > > > > Only transformation types for which the outcome was Success, Exact, or Canceled are included in this prompt. A projective transformation can be specified even if it was canceled. The program uses the result computed at the time you canceled. > > > > **Transformation Table** > > > > Report the number of calibration points and provides information about each transformation type. > > > > **Outcome of Fit** > > > > Report the outcome of fit for each of the transformation types. If the outcome of fit is not Success or Exact for any of the transformation types, the program reports failure of the entire calibration process and ends the Command. The remaining entries in each column are blank unless Outcome of Fit is Success. > > > > **Exact** > > > > Indicate the correct number of points for a valid transformation. > > > > **Success** > > > > Indicate more than enough points. The program succeeded in fitting a transformation to the data. > > > > **Impossible** > > > > Indicate not enough points. > > > > **Failure** > > > > Indicate enough points, but the program was unable to fit a transformation to the points, usually because some points were colinear or coincident. > > > > **Canceled** > > > > Indicate that the fit process was canceled. This outcome occurs only with the projective transformation. > > > > **RMS Error** > > > > Report the RMS (root mean square) error, which measures how close the program has come to finding a perfect fit. The goal is the smallest RMS error > > > > **Standard Deviation** > > > > Report the standard deviation of the residuals. If it is near zero, the residual at each calibration point is about the same. > > > > **Largest Residual/At Point** > > > > Report the point at which the mapping is least accurate. The residual is the distance between where the point was mapped during transformation and where it would be mapped if the fit were perfect. The distance is given in the current linear units. > > > > **Second-Largest Residual/At Point** > > > > Report the point at which the mapping is second-least accurate. The residual is the distance between where the point was mapped during transformation and where it would be mapped if the fit were perfect. The distance is given in the current linear units. > > > > Affine > > > > Specify arbitrary linear transformation in two dimensions consisting of translation, independent > > *X*\- and *Y*-scaling, rotation, and skewing with three calibration points. > > > > Use Affine when horizontal dimensions in a paper drawing are stretched with respect to vertical dimensions, and lines that are supposed to be parallel actually are parallel. > > > > The RMS (root mean square) error reported after calibration measures how close the program has come to making a perfect fit. Affine should be used if the RMS is small. > > > > Projective > > > > Specify a transformation equivalent to a perspective projection of one plane in space onto another plane with four calibration points. A projective transformation provides a limited form of what cartographers call > > *rubber sheeting*, in which different portions of the tablet surface are stretched by varying amounts. Straight lines map into straight lines. Parallel lines do not necessarily stay parallel. > > > > Projective transformation corrects parallel lines that appear to converge. > > > > **Repeat Table** > > > > Redisplay the computed table, which rates the transformation types. > > **ConFiGure** > > > Designate or realign the tablet menu areas or designates a small portion of a large tablet as a screen pointing area. > > > > Enter number of tablet menus desired (0-4) \<*current*\>: *Enter a value or press*ENTER > > > > If tablet menus are in use and the same number of menus is selected, the following prompts are displayed: > > > > Do you want to realign tablet menus? \[Yes/No\] \<N\>: > > *Enter y or n or press* ENTER > > > > Digitize upper-left corner of menu area *n*: *Digitize a point* > > > > Digitize lower-left corner of menu area *n*: *Digitize a point* > > > > Digitize lower-right corner of menu area *n*: *Digitize a point* > > > > In the prompt, *n* is the menu number (1-4). > > > > The printed menu form must be affixed to the tablet surface, and the requested points must be digitized. The set of three points must form a 90-degree angle. Tablet menu areas can be skewed at any angle. > > > > Enter the number of columns for menu area *n*: *Enter a positive value* > > > > Enter the number of rows for menu area *n*: *Enter a positive value* > > > > After all interaction concerning tablet menus is complete, the following prompt is displayed: > > > > Do you want to respecify the screen pointing area? \[Yes/No\] \<N\>: > > *Enter y or n or press* ENTER > > > > If you enter *y*, the following prompts are displayed: > > > > Digitize lower-left corner of the pointing area: *Digitize a point* > > > > Digitize upper-right corner of the pointing area: *Digitize a point* > > > > A small portion of the tablet's surface is designated as the fixed screen pointing area. The following prompt is displayed: > > > > Do you want to specify the Floating Screen Pointing area? \[Yes/No\] \<N\>: > > *Enter y or n or press* ENTER > > > > If you responded *y* to the previous prompt, respond to the following prompt: > > > > Do you want the Floating Screen Area to be the same size as the Fixed Screen Pointing Area? \[Yes/No\] \<Y\>: *Enter y or n or press*ENTER > > > > If you responded *n* to the previous prompt, respond to the following prompts: > > > > Digitize lower-left corner of the Floating Screen pointing area: *Digitize a point* > > > > Digitize upper-right corner of the Floating Screen pointing area: > > *Digitize a point* > > > > Respond to the following prompt: > > > > Would you also like to specify a button to toggle the Floating Screen Area? \[Yes/No\] \<N\>: > > *Enter y or n or press* ENTER > > > > If you responded *y* to the previous prompt, respond to the following prompt: > > > > Press any non-pick button on the digitizer puck that you wish to designate as the toggle for the Floating Screen Area ## Other versions with matching text [GstarCAD 8 (2013–2014)](../../../2013/Commands/T/TABLET%20Command.md)