SphericalRegion

SphericalRegion

is an option for three-dimensional graphics functions that specifies whether the final image should be scaled so that a sphere drawn around the threedimensional bounding box would fit in the display area specified.

Details

  • SphericalRegionFalse scales three-dimensional images to be as large as possible, given the display area specified.
  • SphericalRegionTrue scales three-dimensional images so that a sphere drawn around the threedimensional bounding box always fits in the display area specified.
  • SphericalRegionAutomatic is equivalent to SphericalRegionFalse for top-level graphics. However, if the graphic is contained within another typesetting or graphical construct such as an Inset, Row or Grid, Automatic will be treated as equivalent to True.
  • The center of the sphere is taken to be at the center of the bounding box. The radius of the sphere is chosen so that the bounding box just fits within the sphere.
  • With SphericalRegion->True, the image of a particular object remains consistent in size, regardless of the orientation of the object.
  • SphericalRegionSphere[center,radius] specifies a bounding sphere in the graphic's coordinate system. radius specifies the radius in the direction. The and directions will be scaled automatically in the camera space to have a spherical view scope. A valid Sphere specification will cause the ViewAngle and ViewVector options to be ignored.
  • If center is specified as Automatic, the center will be taken to be the ViewCenter. Otherwise, the ViewCenter option will be overridden by center.

Examples

open allclose all

Basic Examples  (1)

Size a 3D plot to be within the bounding box at any orientation:

Scope  (3)

Make a sequence of images be consistently sized, independent of orientation:

Without SphericalRegion, each image is made as big as possible:

Specify SphericalRegion using a bounding Sphere:

Use ViewCenter to specify the center of bounding sphere:

Properties & Relations  (2)

By default, 3D graphics are sized just to fit in the 2D bounding box:

With SphericalRegion, the graphics can lie inside the bounding box:

A circumscribing circle just touches a corner of the bounding box:

SphericalRegion->True for a Cuboid viewed at various view points:

The same view points with an explicit sphere specification:

Without SphericalRegion:

Possible Issues  (2)

ViewCenter will be ignored if an explicit center of the bounding sphere is specified:

ViewAngle will be ignored if a valid bounding sphere is specified:

Introduced in 1991
 (2.0)
 |
Updated in 2019
 (12.0)
2020
 (12.1)