(swplot-mouse)=

# swplot.mouse

## Syntax
  
`swplot.mouse`
  
`swplot.mouse(hFigure, perspective)`
 
## Description
  
`swplot.mouse` adds rotation and zoom functionality to the active swplot
figure. The following mouse actions are supported:
* `mouse-drag`        Rotation of objects.
* `ctrl+mouse-drag`   Shift of objects (pan).
* `mouse-wheel`       Zoom of objects.
* `ctrl+mouse-wheel`  Change perspective and switch to perspective
                      projection.
  
## Input Arguments
  
`hFigure`
: Handle of the swplot figure. Default is the active figure.
  
`perspective`
: String determines whether camera projection mode is changed
  automatically between orthographic (zooming withouth ctrl 
  key pressed) and perspective (zooming with ctrl key
  pressed):
  * `'auto'`      Automatic switching (default).
  * `'fix'`       No switching.
  
## See Also
  
[camproj](https://www.mathworks.com/help/matlab/ref/camproj.html)