Class ClipboardItem

A ClipboardItem is a handle to an object which represents a set of blocks in a contained bounding area (most likely copied from the world)

Index

Constructors

Properties

id isEmpty normalizedOrigin originalWorldLocation size

Methods

clear getPredictedWriteVolume readFromStructure readFromWorld writeToWorld

Constructors

`Private`constructor

new ClipboardItem(): ClipboardItem
Returns ClipboardItem

Properties

`Readonly`id

id: string

`Readonly`isEmpty

isEmpty: boolean

Remarks

Return whether there is any block content in the item

World Ready

This property can't be read in early-execution mode.

`Readonly`normalizedOrigin

normalizedOrigin: Vector3

`Readonly`originalWorldLocation

originalWorldLocation: Vector3

`Readonly`size

Methods

clear

clear(): void
Returns void
Remarks
Clear the contents of the item

Write Privilege
This function can't be called in read-only mode.

Throws
This function can throw errors.

World Ready
This function can't be called in early-execution mode.

getPredictedWriteVolume

getPredictedWriteVolume(
location: Vector3,
options?: ClipboardWriteOptions,
): RelativeVolumeListBlockVolume
Parameters
- location: Vector3
- Optionaloptions: ClipboardWriteOptions
Returns RelativeVolumeListBlockVolume
Remarks
Write Privilege
This function can't be called in read-only mode.

Throws
This function can throw errors.

World Ready
This function can't be called in early-execution mode.

readFromStructure

readFromStructure(structure: EditorStructure): void
Parameters
- structure: EditorStructure
Returns void
Remarks
Write Privilege
This function can't be called in read-only mode.

Throws
This function can throw errors.

World Ready
This function can't be called in early-execution mode.

readFromWorld

readFromWorld(source: BlockVolumeBase | RelativeVolumeListBlockVolume): void
Parameters
- source: BlockVolumeBase | RelativeVolumeListBlockVolume
Returns void
Remarks
Copy the contents of a rectangular volume into the Clipboard Item

Write Privilege
This function can't be called in read-only mode.

Throws
This function can throw errors.

World Ready
This function can't be called in early-execution mode.

writeToWorld

writeToWorld(location: Vector3, options?: ClipboardWriteOptions): boolean
Parameters
- location: Vector3
  The root point of the world location to which the ClipboardItem is written (this is modified by the various anchor, offset and rotation parameters of the ClipboardWriteOptions
- Optionaloptions: ClipboardWriteOptions
  An optional set of write parameters which modify the properties of the ClipboardItem as it is applied to the world
Returns boolean
Success or Failure

Remarks
Apply the contents of a ClipboardItem to the world at a given location using a set of write options

Write Privilege
This function can't be called in read-only mode.

Throws
This function can throw errors.

World Ready
This function can't be called in early-execution mode.