# change-frame-depth(2)

[Home] [Commands] [Variables] [Macro-Dev] [Glossary]

## NAME

change-frame-depth - Change the number of lines on the current frame
change-frame-width - Change the number of columns on the current frame

## SYNOPSIS

n change-frame-depth [ "depth" ]
n change-frame-width [ "width" ]

## DESCRIPTION

change-frame-depth changes the depth of the current frame, if the numeric argument n is given then the frame depth is changed by n lines. If n is not specified the user is prompted for the new depth and the frame depth will be changed to this value. It is assumed that the screen can draw the requested n lines and MicroEmacs draws the lines at the users peril.

A change in depth causes all of the internal windows currently displayed in the frame to be re-sized, the vertical position of the windows are modified to match the new screen dimension, the horizontal position of the windows remains unaltered. If the window is down-sized and the currently displayed windows are not able to fit into the new screen space then all windows are deleted with the exception of the current window.

change-frame-width changes the width of the current frame, if the numeric argument n is given then the frame width is changed by n characters. If n is not specified the user is prompted for the new width and the frame width will be changed to this value. It is assumed that the screen can draw the requested n columns and MicroEmacs draws them at the users peril. The windows are reorganized as change-frame-depth working horizontally rather than vertically.

## NOTES

Within windowing environments such as X-Windows and Microsoft Windows these commands cause the canvas window to be re-sized to accommodate the change in screen size.

In MS-DOS and UNIX Termcap environments the physical size of the screen is determined by the characteristics of the display adapter. change-frame-depth may be used to correct anomalies (usually on portables) in the displayable screen area and the graphics mode. e.g. In DOS the graphics mode utilizes 50 lines, and only 47 lines are viewable. In this case change the screen depth to 47 and MicroEmacs will not utilize the remaining lines which are not viewable.

## SEE ALSO

$frame-depth(5), $frame-width(5).

(c) Copyright JASSPA 2009
Last Modified: 2009/08/29
Generated On: 2009/10/12

</HMTL>