ansys.mapdl.core.Mapdl.dist#

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

Specifies the viewing distance for magnifications and perspective.

Mechanical APDL Command: /DIST

Command default:

Distance is automatically calculated to produce full window magnification.

Parameters:

wnstr

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

dvalstr

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).

kfactint or str

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.).

Notes

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 $e q u a t i o n n o t a v a i l a b l e$ /2 (+10%) producesa full window magnification, where $e q u a t i o n n o t a v a i l a b l e$ isthe largest in-plane vertical or horizontal dimension. See also auto and NumPy user guide commands.

This command is valid in any processor.