类 Selection

The Selection represents a volume in space, which may potentially be made up of one or more block locations. These block locations do not need to be contiguous, and a Selection represent an irregular shape. It's important to note that a Selection is only a representation of the volume shape space - and does NOT represent the actual contents of the space.

属性

isEmpty visible

方法

clear getBlockLocationIterator getBoundingBox getFillColor getOutlineColor getVolumeOrigin moveBy moveTo peekLastVolume popVolume pushVolume set setFillColor setOutlineColor

属性

只读isEmpty

isEmpty: boolean

备注

Returns a boolean representing whether or not there are any volumes pushed to the selection stack

抛出

This property can throw when used.

世界修改visible

visible: boolean

备注

Set whether or not the selection volume is visible to the client user. NOTE: Use this option carefully - Selection volumes are generally server-only, but marking a volume as visible causes the volume (and all volume operations) to be synchronized with the client game which can potentially generate excessive network traffic.

方法

clear

getBlockLocationIterator

  • getBlockLocationIterator(): BlockLocationIterator
    世界修改

    返回 BlockLocationIterator

    备注

    Fetch a block iterator which can be used to step across the Selection shape. Each call to the iterator will return the next block location within the Selection bounds which is actually selected. Block iteration is not guaranteed to be contiguous - it is possible to create irregular selection shapes by adding volumes to a selection which may or may not be contiguous or adjacent to other volumes within the selection. The Block iterator will return only selected volume locations

getBoundingBox

  • getBoundingBox(): BoundingBox
    世界修改

    返回 BoundingBox

    备注

    Return a bounding rectangle that contains all of the volumes within the selection (the bounding rectangle does NOT represent the shape of the selection, only the largest rectangle that will fit all of the volumes)

    抛出

    This function can throw errors.

getFillColor

getOutlineColor

getVolumeOrigin

moveBy

  • moveBy(delta: Vector3): Vector3
    世界修改

    参数

    • delta: Vector3

      The amount by which to move

    返回 Vector3

    Return the newly moved position

    备注

    Translate a selection by a given amount (this causes all of the volumes within the selection to be moved by the specified offset)

    抛出

    This function can throw errors.

moveTo

  • moveTo(location: Vector3): Vector3
    世界修改

    参数

    • location: Vector3

      The world location to which to relocate the selection

    返回 Vector3

    Return the newly moved position

    备注

    Move the selection to an absolute world location (causing all of the volumes within the selection to be moved to a location relative to the world location)

    抛出

    This function can throw errors.

peekLastVolume

popVolume

  • popVolume(): void
    世界修改

    返回 void

    备注

    Remove the volume information that was last pushed to the volume stack. This will reduce the stack item length by 1

    抛出

    This function can throw errors.

pushVolume

set

  • set(other: CompoundBlockVolume | Selection): void
    世界修改

    参数

    返回 void

    备注

    Replace the contents of the current selection with a new specified selection. This operation will delete the current contents and copy the contents of the new selection to the target selection - it does this by content, not by reference.

    抛出

    This function can throw errors.

setFillColor

  • setFillColor(color: RGBA): void
    世界修改

    参数

    返回 void

    备注

    Set the color of the hull of the selection object if it is visible.

    抛出

    This function can throw errors.

setOutlineColor

  • setOutlineColor(color: RGBA): void
    世界修改

    参数

    返回 void

    备注

    Set the color of the outline around the selection object if it is visible

    抛出

    This function can throw errors.

显示设置

成员可见性

目录

属性
方法