EllipsoidRegionSelector (worldedit-core 7.2.0 API)

java.lang.Object
- com.sk89q.worldedit.regions.selector.EllipsoidRegionSelector

All Implemented Interfaces:

CUIRegion, RegionSelector

Direct Known Subclasses:

SphereRegionSelector
```
public class EllipsoidRegionSelector
extends java.lang.Object
implements RegionSelector, CUIRegion
```
Creates a EllipsoidRegionSelector from a user's selections.

Field Summary

Fields
Modifier and Type Field and Description

protected EllipsoidRegion region

protected boolean started

Fields
Modifier and Type	Field and Description
`protected EllipsoidRegion`	`region`
`protected boolean`	`started`

Constructor Summary

Constructors
Constructor and Description
`EllipsoidRegionSelector()` Create a new selector with a `null` world.
`EllipsoidRegionSelector(RegionSelector oldSelector)` Create a new selector from the given selector.
`EllipsoidRegionSelector(World world)` Create a new selector.
`EllipsoidRegionSelector(World world, BlockVector3 center, Vector3 radius)` Create a new selector.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`clear()` Clear the selection.
`void`	`describeCUI(LocalSession session, Actor player)` Sends CUI events describing the region for versions of CUI equal to or greater than the value supplied by getProtocolVersion().
`void`	`describeLegacyCUI(LocalSession session, Actor player)` Sends CUI events describing the region for versions of CUI smaller than the value supplied by getProtocolVersion().
`void`	`explainPrimarySelection(Actor player, LocalSession session, BlockVector3 pos)` Tell the player information about his/her primary selection.
`void`	`explainRegionAdjust(Actor player, LocalSession session)` Tell the player information about the region's changes.
`void`	`explainSecondarySelection(Actor player, LocalSession session, BlockVector3 pos)` Tell the player information about his/her secondary selection.
`EllipsoidRegion`	`getIncompleteRegion()` Get the region even if it's not fully defined.
`java.lang.String`	`getLegacyTypeID()` Returns the type ID to send to CUI in the selection event if the CUI is in legacy mode.
`BlockVector3`	`getPrimaryPosition()` Get the primary position.
`int`	`getProtocolVersion()` Returns the CUI version that is required to send up-to-date data.
`EllipsoidRegion`	`getRegion()` Get the selection.
`java.util.List<com.sk89q.worldedit.util.formatting.text.Component>`	`getSelectionInfoLines()` Get lines of information about the selection.
`java.lang.String`	`getTypeID()` Returns the type ID to send to CUI in the selection event.
`java.lang.String`	`getTypeName()` Get a lowercase name of this region selector type.
`long`	`getVolume()` Get the number of blocks inside the region.
`World`	`getWorld()` Get the world for the region selector.
`boolean`	`isDefined()` Returns whether the region has been fully defined.
`void`	`learnChanges()` Update the selector with changes to the region.
`boolean`	`selectPrimary(BlockVector3 position, SelectorLimits limits)` Called when the first point is selected.
`boolean`	`selectSecondary(BlockVector3 position, SelectorLimits limits)` Called when the second point is selected.
`void`	`setWorld(World world)` Set the world for the region selector.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.sk89q.worldedit.regions.RegionSelector
getArea, getInformationLines

- Field Detail
  - region
```
protected transient EllipsoidRegion region
```
  - started
```
protected transient boolean started
```
- Constructor Detail
  - EllipsoidRegionSelector
```
public EllipsoidRegionSelector()
```
    Create a new selector with a null world.
  - EllipsoidRegionSelector
```
public EllipsoidRegionSelector(@Nullable
                               World world)
```
    Create a new selector.
    
    Parameters:
    
    world - the world, which may be null
  - EllipsoidRegionSelector
```
public EllipsoidRegionSelector(RegionSelector oldSelector)
```
    Create a new selector from the given selector.
    
    Parameters:
    
    oldSelector - the old selector
  - EllipsoidRegionSelector
```
public EllipsoidRegionSelector(@Nullable
                               World world,
                               BlockVector3 center,
                               Vector3 radius)
```
    Create a new selector.
    
    Parameters:
    
    world - the world
    
    center - the center
    
    radius - the radius
- Method Detail
  - getWorld
```
@Nullable
public World getWorld()
```
    Description copied from interface: RegionSelector
    
    Get the world for the region selector.
    
    Specified by:
    
    getWorld in interface RegionSelector
    
    Returns:
    
    a world, which may be null
  - setWorld
```
public void setWorld(@Nullable
                     World world)
```
    Description copied from interface: RegionSelector
    
    Set the world for the region selector.
    
    Specified by:
    
    setWorld in interface RegionSelector
    
    Parameters:
    
    world - the world, which may be null
  - selectPrimary
```
public boolean selectPrimary(BlockVector3 position,
                             SelectorLimits limits)
```
    Description copied from interface: RegionSelector
    
    Called when the first point is selected.
    
    Specified by:
    
    selectPrimary in interface RegionSelector
    
    Parameters:
    
    position - the position
    
    Returns:
    
    true if something changed
  - selectSecondary
```
public boolean selectSecondary(BlockVector3 position,
                               SelectorLimits limits)
```
    Description copied from interface: RegionSelector
    
    Called when the second point is selected.
    
    Specified by:
    
    selectSecondary in interface RegionSelector
    
    Parameters:
    
    position - the position
    
    Returns:
    
    true if something changed
  - explainPrimarySelection
```
public void explainPrimarySelection(Actor player,
                                    LocalSession session,
                                    BlockVector3 pos)
```
    Description copied from interface: RegionSelector
    
    Tell the player information about his/her primary selection.
    
    Specified by:
    
    explainPrimarySelection in interface RegionSelector
    
    Parameters:
    
    player - the actor
    
    session - the session
    
    pos - position
  - explainSecondarySelection
```
public void explainSecondarySelection(Actor player,
                                      LocalSession session,
                                      BlockVector3 pos)
```
    Description copied from interface: RegionSelector
    
    Tell the player information about his/her secondary selection.
    
    Specified by:
    
    explainSecondarySelection in interface RegionSelector
    
    Parameters:
    
    player - the actor
    
    session - the session
    
    pos - position
  - explainRegionAdjust
```
public void explainRegionAdjust(Actor player,
                                LocalSession session)
```
    Description copied from interface: RegionSelector
    
    Tell the player information about the region's changes. This may resend all the defining region information if needed.
    
    Specified by:
    
    explainRegionAdjust in interface RegionSelector
    
    Parameters:
    
    player - the actor
    
    session - the session
  - isDefined
```
public boolean isDefined()
```
    Description copied from interface: RegionSelector
    
    Returns whether the region has been fully defined.
    
    Specified by:
    
    isDefined in interface RegionSelector
    
    Returns:
    
    true if a selection is available
  - getRegion
```
public EllipsoidRegion getRegion()
                          throws IncompleteRegionException
```
    Description copied from interface: RegionSelector
    
    Get the selection.
    
    Specified by:
    
    getRegion in interface RegionSelector
    
    Returns:
    
    the created region
    
    Throws:
    
    IncompleteRegionException - thrown if a region has not been fully defined
  - getIncompleteRegion
```
public EllipsoidRegion getIncompleteRegion()
```
    Description copied from interface: RegionSelector
    
    Get the region even if it's not fully defined.
    
    Specified by:
    
    getIncompleteRegion in interface RegionSelector
    
    Returns:
    
    an incomplete region object that is incomplete
  - learnChanges
```
public void learnChanges()
```
    Description copied from interface: RegionSelector
    
    Update the selector with changes to the region.
    
    Specified by:
    
    learnChanges in interface RegionSelector
  - clear
```
public void clear()
```
    Description copied from interface: RegionSelector
    
    Clear the selection.
    
    Specified by:
    
    clear in interface RegionSelector
  - getTypeName
```
public java.lang.String getTypeName()
```
    Description copied from interface: RegionSelector
    
    Get a lowercase name of this region selector type.
    
    Specified by:
    
    getTypeName in interface RegionSelector
    
    Returns:
    
    a lower case name of the type
  - getSelectionInfoLines
```
public java.util.List<com.sk89q.worldedit.util.formatting.text.Component> getSelectionInfoLines()
```
    Description copied from interface: RegionSelector
    
    Get lines of information about the selection.
    
    Specified by:
    
    getSelectionInfoLines in interface RegionSelector
    
    Returns:
    
    a list of lines describing the region.
  - getVolume
```
public long getVolume()
```
    Description copied from interface: RegionSelector
    
    Get the number of blocks inside the region.
    
    Specified by:
    
    getVolume in interface RegionSelector
    
    Returns:
    
    number of blocks, or -1 if undefined
  - describeCUI
```
public void describeCUI(LocalSession session,
                        Actor player)
```
    Description copied from interface: CUIRegion
    
    Sends CUI events describing the region for versions of CUI equal to or greater than the value supplied by getProtocolVersion().
    
    Specified by:
    
    describeCUI in interface CUIRegion
  - describeLegacyCUI
```
public void describeLegacyCUI(LocalSession session,
                              Actor player)
```
    Description copied from interface: CUIRegion
    
    Sends CUI events describing the region for versions of CUI smaller than the value supplied by getProtocolVersion().
    
    Specified by:
    
    describeLegacyCUI in interface CUIRegion
  - getLegacyTypeID
```
public java.lang.String getLegacyTypeID()
```
    Description copied from interface: CUIRegion
    
    Returns the type ID to send to CUI in the selection event if the CUI is in legacy mode.
    
    Specified by:
    
    getLegacyTypeID in interface CUIRegion
    
    Returns:
    
    the legacy type ID
  - getProtocolVersion
```
public int getProtocolVersion()
```
    Description copied from interface: CUIRegion
    
    Returns the CUI version that is required to send up-to-date data. If the CUI version is smaller than this value, the legacy methods will be called.
    
    Specified by:
    
    getProtocolVersion in interface CUIRegion
    
    Returns:
    
    the protocol version
  - getTypeID
```
public java.lang.String getTypeID()
```
    Description copied from interface: CUIRegion
    
    Returns the type ID to send to CUI in the selection event.
    
    Specified by:
    
    getTypeID in interface CUIRegion
    
    Returns:
    
    the type ID
  - getPrimaryPosition
```
public BlockVector3 getPrimaryPosition()
                                throws IncompleteRegionException
```
    Description copied from interface: RegionSelector
    
    Get the primary position.
    
    Specified by:
    
    getPrimaryPosition in interface RegionSelector
    
    Returns:
    
    the primary position
    
    Throws:
    
    IncompleteRegionException - thrown if a region has not been fully defined

Class EllipsoidRegionSelector

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface com.sk89q.worldedit.regions.RegionSelector

Field Detail

region

started

Constructor Detail

EllipsoidRegionSelector

EllipsoidRegionSelector

EllipsoidRegionSelector

EllipsoidRegionSelector

Method Detail

getWorld

setWorld

selectPrimary

selectSecondary

explainPrimarySelection

explainSecondarySelection

explainRegionAdjust

isDefined

getRegion

getIncompleteRegion

learnChanges

clear

getTypeName

getSelectionInfoLines

getVolume

describeCUI

describeLegacyCUI

getLegacyTypeID

getProtocolVersion

getTypeID

getPrimaryPosition