com.sk89q.worldedit.regions

Class Polygonal2DRegionSelector

java.lang.Object

com.sk89q.worldedit.regions.Polygonal2DRegionSelector

All Implemented Interfaces:

CUIRegion, RegionSelector

public class Polygonal2DRegionSelector
extends Object
implements RegionSelector, CUIRegion

Selector for polygonal regions.

Author:

sk89q

Constructor Summary

Constructors

Constructor and Description
Polygonal2DRegionSelector(LocalWorld world) Deprecated.
Polygonal2DRegionSelector(LocalWorld world, int maxPoints)
Polygonal2DRegionSelector(LocalWorld world, List<BlockVector2D> points, int minY, int maxY)
Polygonal2DRegionSelector(RegionSelector oldSelector) Deprecated.
Polygonal2DRegionSelector(RegionSelector oldSelector, int maxPoints)

Method Summary

Methods

Modifier and Type	Method and Description
void	clear() Clear the selection.
void	describeCUI(LocalSession session, LocalPlayer 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, LocalPlayer player) Sends CUI events describing the region for versions of CUI smaller than the value supplied by getProtocolVersion().
void	explainPrimarySelection(LocalPlayer player, LocalSession session, Vector pos) Tell the player information about his/her primary selection.
void	explainRegionAdjust(LocalPlayer player, LocalSession session) The the player information about the region's changes.
void	explainSecondarySelection(LocalPlayer player, LocalSession session, Vector pos) Tell the player information about his/her secondary selection.
int	getArea() Get the number of blocks inside the region.
Polygonal2DRegion	getIncompleteRegion() Get the region even if it's not fully defined.
List<String>	getInformationLines() Get lines of information about the selection.
String	getLegacyTypeID() Returns the type ID to send to CUI in the selection event if the CUI is in legacy mode.
int	getPointCount()
BlockVector	getPrimaryPosition() Get the primary position.
int	getProtocolVersion() Returns the CUI version that is required to send up-to-date data.
Polygonal2DRegion	getRegion() Get the selection.
String	getTypeID() Returns the type ID to send to CUI in the selection event.
String	getTypeName() Get a lowercase name of this region selector type.
boolean	isDefined() Returns whether the region has been fully defined.
void	learnChanges() Update the selector with changes to the region.
boolean	selectPrimary(Vector pos) Called when the first point is selected.
boolean	selectSecondary(Vector pos) Called when the second point is selected.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Polygonal2DRegionSelector

@Deprecated
public Polygonal2DRegionSelector(LocalWorld world)

Deprecated.

Polygonal2DRegionSelector

public Polygonal2DRegionSelector(LocalWorld world,
                         int maxPoints)

Polygonal2DRegionSelector

@Deprecated
public Polygonal2DRegionSelector(RegionSelector oldSelector)

Deprecated.

Polygonal2DRegionSelector

public Polygonal2DRegionSelector(RegionSelector oldSelector,
                         int maxPoints)

Polygonal2DRegionSelector

public Polygonal2DRegionSelector(LocalWorld world,
                         List<BlockVector2D> points,
                         int minY,
                         int maxY)

Method Detail

selectPrimary

public boolean selectPrimary(Vector pos)

Description copied from interface: RegionSelector

Called when the first point is selected.

Specified by:

selectPrimary in interface RegionSelector

Returns:

true if something changed

selectSecondary

public boolean selectSecondary(Vector pos)

Description copied from interface: RegionSelector

Called when the second point is selected.

Specified by:

selectSecondary in interface RegionSelector

Returns:

true if something changed

explainPrimarySelection

public void explainPrimarySelection(LocalPlayer player,
                           LocalSession session,
                           Vector pos)

Description copied from interface: RegionSelector

Tell the player information about his/her primary selection.

Specified by:

explainPrimarySelection in interface RegionSelector

explainSecondarySelection

public void explainSecondarySelection(LocalPlayer player,
                             LocalSession session,
                             Vector pos)

Description copied from interface: RegionSelector

Tell the player information about his/her secondary selection.

Specified by:

explainSecondarySelection in interface RegionSelector

explainRegionAdjust

public void explainRegionAdjust(LocalPlayer player,
                       LocalSession session)

Description copied from interface: RegionSelector

The the player information about the region's changes. This may resend all the defining region information if needed.

Specified by:

explainRegionAdjust in interface RegionSelector

getPrimaryPosition

public BlockVector getPrimaryPosition()
                               throws IncompleteRegionException

Description copied from interface: RegionSelector

Get the primary position.

Specified by:

getPrimaryPosition in interface RegionSelector

Returns:

Throws:

IncompleteRegionException

getRegion

public Polygonal2DRegion getRegion()
                            throws IncompleteRegionException

Description copied from interface: RegionSelector

Get the selection.

Specified by:

getRegion in interface RegionSelector

Returns:

Throws:

IncompleteRegionException

getIncompleteRegion

public Polygonal2DRegion getIncompleteRegion()

Description copied from interface: RegionSelector

Get the region even if it's not fully defined.

Specified by:

getIncompleteRegion in interface RegionSelector

Returns:

isDefined

public boolean isDefined()

Description copied from interface: RegionSelector

Returns whether the region has been fully defined.

Specified by:

isDefined in interface RegionSelector

Returns:

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 String getTypeName()

Description copied from interface: RegionSelector

Get a lowercase name of this region selector type.

Specified by:

getTypeName in interface RegionSelector

Returns:

getInformationLines

public List<String> getInformationLines()

Description copied from interface: RegionSelector

Get lines of information about the selection.

Specified by:

getInformationLines in interface RegionSelector

Returns:

getArea

public int getArea()

Description copied from interface: RegionSelector

Get the number of blocks inside the region.

Specified by:

getArea in interface RegionSelector

Returns:

number of blocks or -1 if undefined

getPointCount

public int getPointCount()

describeCUI

public void describeCUI(LocalSession session,
               LocalPlayer 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,
                     LocalPlayer 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

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:

getTypeID

public 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:

getLegacyTypeID

public 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: