MATLAB Function Reference

orient

Set paper orientation for printed output

Syntax

• orient
  orient landscape
  orient portrait
  orient tall
  orient(fig_handle), orient(simulink_model)
  orient(fig_handle,orientation), orient(simulink_model,orientation)
  

Description

orient returns a string with the current paper orientation, either portrait, landscape, or tall.

orient landscape sets the paper orientation of the current figure to full-page landscape, orienting the longest page dimension horizontally. The figure is centered on the page and scaled to fit the page with a 0.25 inch border.

orient portrait sets the paper orientation of the current figure to portrait, orienting the longest page dimension vertically. The portrait option returns the page orientation to the MATLAB default. (Note that the result of using the portrait option is affected by changes you make to figure properties. See the "Algorithm" section for more specific information.)

orient tall maps the current figure to the entire page in portrait orientation, leaving a 0.25 inch border.

orient(fig_handle), orient(simulink_model) returns the current orientation of the specified figure or Simulink model.

• orient(fig_handle,orientation), orient(simulink_model,orientation)
  

sets the orientation for the specified figure or Simulink model to the specified orientation (landscape, portrait, or tall).

Algorithm

orient sets the PaperOrientation, PaperPosition, and PaperUnits properties of the current figure. Subsequent print operations use these properties. The result of using the portrait option can be affected by default property values as follows:

• If the current figure PaperType is the same as the default figure PaperType and the default figure PaperOrientation has been set to landscape, then the orient portrait command uses the current values of PaperOrientation and PaperPosition to place the figure on the page.
• If the current figure PaperType is the same as the default figure PaperType and the default figure PaperOrientation has been set to landscape, then the orient portrait command uses the default figure PaperPosition with the x, y and width, height values reversed (i.e., [y,x,height,width]) to position the figure on the page.
• If the current figure PaperType is different from the default figure PaperType, then the orient portrait command uses the current figure PaperPosition with the x, y and width, height values reversed (i.e., [y,x,height,width]) to position the figure on the page.

See Also

print, set

PaperOrientation, PaperPosition, PaperSize, PaperType, and PaperUnits properties of figure graphics objects.

Printing for related functions

orderfields

orth