Region3

Supported Datatype

Describes a rectangular volume in 3D space.

Description

The Region3 data type describes a volume in 3D space similar to an axis-aligned rectangular prism. It is commonly used with Terrain functions and functions that detect parts within a volume, such as WorldRoot.FindPartsInRegion3().

The prism's center is accessible using the Region3.CFrame property and the prism's size is accessible through the Region3.Size property. Note that the components of this property may be negative.

The Region3.ExpandToGrid() method returns a new Region3 whose bounds comply with a provided resolution value. The resulting volume may be equal to or greater than the original volume, but never smaller.

See also:

• Region3int16

Constructors

new Supported Returns a new Region3 using the provided vectors as boundaries.

Region3.new(min: Vector3, max: Vector3)

Returns a new Region3 using the provided vectors as boundaries.

Returns a new Region3 given the Vector3 bounds of the rectangular prism volume.

Note that the order of the provided bounds matters: by switching them, the polarity of the size components will switch. It is possible to create a Region3 with a negative volume.

Properties

CFrame Supported The center location and rotation of the Region3.

Region3.CFrame()

The center location and rotation of the Region3.

The CFrame representing the center position and orientation of the Region3. The position component is the midpoint of the min and max vectors passed to Region3.new(), computed as (min + max) / 2. Because a Region3 is always axis-aligned, the rotation component of the returned CFrame is always the identity (no rotation). This property is read-only.

Size Supported The 3D size of the Region3.

Region3.Size()

The 3D size of the Region3.

The size of the Region3 as a Vector3, equal to max - min from the constructor arguments. Individual components may be negative if the corresponding component of min is greater than max in the call to Region3.new(). This property is read-only.

Methods

ExpandToGrid Supported Expands the Region3 to fit a grid based on the provided resolution.

Region3:ExpandToGrid(resolution: number)

Expands the Region3 to fit a grid based on the provided resolution.

Expands the Region3 based on the provided resolution and returns the expanded Region3 aligned to the Terrain voxel grid.

Nova binding inventory

Library	Members
new	CFrame, ExpandToGrid, Size

Roblox reference: Region3