Mapdl.dist(wn='', dval='', kfact='', **kwargs)[source]#

Specifies the viewing distance for magnifications and perspective.

APDL Command: /DIST


Window number (or ALL) to which command applies (defaults to 1).


Distance along the view line from the observer to the focus point (defaults to value producing full-window display). Distances “too close” to the object will produce excessive magnifications. If DVAL = AUTO, zero, or blank, the program will calculate the distance automatically. If DVAL = USER, the distance of last display will be used (useful when last display automatically calculated distance).


DVAL interpretation key:

0 - Interpret numerical DVAL values as described above.

1 - Interpret DVAL as a multiplier on the current distance (DVAL of 2 gives twice

the current distance; 0.5 gives half the current distance, etc.).


The scale factor is relative to the window shape. For example, for objects centered in a square window and with parallel projection (no perspective), a distance of : /2 (+10%) produces a full window magnification, where : is the largest in-plane vertical or horizontal dimension. See also /AUTO and /USER commands.

This command is valid in any processor.