camOrbit

Animates the camera rotating around a camera target. Allows orbits in multiple subplots of a figure. Saves as a movie or gif.

Description:
Not to be confused with the already built-in camorbit function (https://www.mathworks.com/help/matlab/ref/camorbit.html). camOrbit creates an animation of the camera rotating around a camera target. Allows orbits to occur in multiple subplots of a figure. Animations can be saved as a movie or gif.

Syntax:
• camOrbit
• camOrbit(FigureHandle, ...)
• camOrbit(FigureHandle, AxisHandles, ...)
• camOrbit('fps', FramesPerSecond, 'time', AnimationDuration, 'width', Width, 'height', Height, 'fullscreen', True/False)
• camOrbit('theta', HorizontalRotationAngles, 'phi', VerticalRotationAngles, 'axis', AxisOfRotation, 'cordsys', CoordinateSystems)

Defaults:
• FigureHandle - if none specified just uses the current figure
• AxisHandles - an array of subplot handles to be animated, if none specified just uses the current axis of target figure
• 'fps' - FPS of final animation, defaults to 30 frames per second
• 'time' - duration of final animation in seconds, defaults to 15 seconds
• 'width' - width of final animation, defaults to current figure size
• 'height' - height of final animation, defaults to current figure size
• 'fullscreen' - defaults to off (false)
• 'theta' - an array of maximum horizontal rotation angles in degrees for each AxisHandle, defaults to 360 degrees per active subplot
• 'phi' - an array of maximum vertical rotation angles in degrees for each AxisHandle, defaults to 360 degrees per active subplot
• 'axis' - an array of axis of rotation for each AxisHandle, defaults to [0 0 1] (z-axis) per active subplot
• 'cordsys' - a cell array of coordinate systems for each AxisHandle, defaults to 'data' (the coordinate system relative to the data) per active plot; use 'camera' to use the coordinate system relative to the camera

Saving:
• Final animations can be saved as an .avi (Uncompressed AVI), .gif (GIF), .mp4 (MPEG-4), or .mj2 (Archival)

Uses:
• For any 3D plots or subplots you wish to automatically orbit the camera around and save as a movie or gif.
• Can orbit a single plot, an individual subplot, multiple subplots, or all subplots at the same time.

Limitations:
• Can't be used in conjunction with plots that are already being animated (moving waves, etc.). Use MatLab's built in camorbit function for that instead.
• Unsure how it performs for MatLab versions before R2017a or OSs besides Windows, though it should work fine. If problems arise let me know.