lookAtVolume Method

Change the volume that this view displays, keeping its current rotation.

lookAtVolume(volume: LowAndHighXYZ | LowAndHighXY, aspect?: number, margin?: MarginPercent): void

note for 2d views, only the X and Y values of volume are used.

Parameter Type Description
volume LowAndHighXYZ | LowAndHighXY The new volume, in world-coordinates, for the view. The resulting view will show all of worldVolume, by fitting a
view-axis-aligned bounding box around it. For views that are not aligned with the world coordinate system, this will sometimes
result in a much larger volume than worldVolume.
aspect number The X/Y aspect ratio of the view into which the result will be displayed. If the aspect ratio of the volume does not
match aspect, the shorter axis is lengthened and the volume is centered. If aspect is undefined, no adjustment is made.
margin MarginPercent The amount of "white space" to leave around the view volume (which essentially increases the volume
of space shown in the view.) If undefined, no additional white space is added.

Defined in

Last Updated: 05 June, 2020