Package com.sk89q.worldedit.extent
Class AbstractBufferingExtent
java.lang.Object
com.sk89q.worldedit.extent.AbstractDelegateExtent
com.sk89q.worldedit.extent.AbstractBufferingExtent
- All Implemented Interfaces:
Extent
,InputExtent
,OutputExtent
- Direct Known Subclasses:
ChunkBatchingExtent
,ExtentBuffer
,MultiStageReorder
Base extent class for buffering changes between
setBlock(BlockVector3, BlockStateHolder)
and the delegate extent. This class ensures that getBlock(BlockVector3)
is properly
handled, by returning buffered blocks.-
Field Summary
Fields inherited from class com.sk89q.worldedit.extent.AbstractDelegateExtent
extent
-
Constructor Summary
ModifierConstructorDescriptionprotected
AbstractBufferingExtent
(Extent extent) Create a new instance. -
Method Summary
Modifier and TypeMethodDescriptiongetBlock
(BlockVector3 position) Get a snapshot of the block at the given location.getBufferedBlock
(BlockVector3 position) Deprecated.protected BaseBlock
getBufferedFullBlock
(BlockVector3 position) Gets a block from the buffer, or null if not buffered.getFullBlock
(BlockVector3 position) Get an immutable snapshot of the block at the given location.abstract <T extends BlockStateHolder<T>>
booleansetBlock
(BlockVector3 location, T block) Change the block at the given location to the given block.protected final <T extends BlockStateHolder<T>>
booleansetDelegateBlock
(BlockVector3 location, T block) Methods inherited from class com.sk89q.worldedit.extent.AbstractDelegateExtent
addPostProcessor, addProcessor, apply, cancel, commit, commitBefore, countBlocks, countBlocks, createEntity, createEntity, disableHistory, disableQueue, enableQueue, fullySupports3DBiomes, getBiome, getBiomeType, getBlock, getBlockDistribution, getBlockDistributionWithData, getBrightness, getEmittedLight, getEntities, getEntities, getExtent, getFullBlock, getMaximumPoint, getMaxY, getMinimumPoint, getMinY, getSkyLight, isQueueEnabled, isWorld, relight, relightBlock, relightSky, removeEntity, replaceBlocks, replaceBlocks, replaceBlocks, setBiome, setBiome, setBlock, setBlockLight, setBlocks, setBlocks, setBlocks, setChangeSet, setSkyLight, tile, toString
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface com.sk89q.worldedit.extent.Extent
addCaves, addOre, addOres, addSchems, apply, center, contains, contains, enableHistory, generate, getHighestTerrainBlock, getHighestTerrainBlock, getNearestSurfaceLayer, getNearestSurfaceTerrainBlock, getNearestSurfaceTerrainBlock, getNearestSurfaceTerrainBlock, getNearestSurfaceTerrainBlock, getNearestSurfaceTerrainBlock, lazyCopy, regenerateChunk, spawnResource
Methods inherited from interface com.sk89q.worldedit.extent.InputExtent
getBiome, getBrightness, getEmittedLight, getHeightMap, getOpacity, getOpacity, getSkyLight
Methods inherited from interface com.sk89q.worldedit.extent.OutputExtent
setBiome, setBlockLight, setHeightMap, setSkyLight, setTile
-
Constructor Details
-
AbstractBufferingExtent
Create a new instance.- Parameters:
extent
- the extent
-
-
Method Details
-
setBlock
public abstract <T extends BlockStateHolder<T>> boolean setBlock(BlockVector3 location, T block) throws WorldEditException Description copied from interface:OutputExtent
Change the block at the given location to the given block. The operation may not tie the givenBlockStateHolder
to the world, so future changes to theBlockStateHolder
do not affect the world until this method is called again.The return value of this method indicates whether the change was probably successful. It may not be successful if, for example, the location is out of the bounds of the extent. It may be unsuccessful if the block passed is the same as the one in the world. However, the return value is only an estimation and it may be incorrect, but it could be used to count, for example, the approximate number of changes.
- Specified by:
setBlock
in interfaceOutputExtent
- Overrides:
setBlock
in classAbstractDelegateExtent
- Parameters:
location
- position of the blockblock
- block to set- Returns:
- true if the block was successfully set (return value may not be accurate)
- Throws:
WorldEditException
- thrown on an error
-
setDelegateBlock
protected final <T extends BlockStateHolder<T>> boolean setDelegateBlock(BlockVector3 location, T block) throws WorldEditException - Throws:
WorldEditException
-
getBlock
Description copied from interface:InputExtent
Get a snapshot of the block at the given location.If the given position is out of the bounds of the extent, then the behavior is undefined (an air block could be returned). However,
null
should not be returned.The returned block is immutable and is a snapshot of the block at the time of call. It has no position attached to it, so it could be reused in
Pattern
s and so on.- Specified by:
getBlock
in interfaceInputExtent
- Overrides:
getBlock
in classAbstractDelegateExtent
- Parameters:
position
- position of the block- Returns:
- the block
-
getFullBlock
Description copied from interface:InputExtent
Get an immutable snapshot of the block at the given location.- Specified by:
getFullBlock
in interfaceInputExtent
- Overrides:
getFullBlock
in classAbstractDelegateExtent
- Parameters:
position
- position of the block- Returns:
- the block
-
getBufferedBlock
Deprecated.New subclasses should overridegetBufferedFullBlock(BlockVector3)
insteadGets a block from the buffer. -
getBufferedFullBlock
@NonAbstractForCompatibility(delegateName="getBufferedBlock", delegateParams=BlockVector3.class) @Nullable protected BaseBlock getBufferedFullBlock(BlockVector3 position) Gets a block from the buffer, or null if not buffered.- Parameters:
position
- The position- Returns:
- The buffered block, or null
-
getBufferedFullBlock(BlockVector3)
instead