Plexus/Plex-FAWE
1
0
Fork 0
mirror of https://github.com/plexusorg/Plex-FAWE.git synced 2024-12-23 09:47:38 +00:00
Code Issues Packages Projects Releases Wiki Activity

Clean up and removal of some old exceptions.

Browse Source
This commit is contained in:
sk89q 2014-07-29 07:57:45 -07:00
parent 41584eee4a
commit 8834af7538
44 changed files with 1047 additions and 948 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
src/legacy/java/com/sk89q/worldedit/blocks/MobSpawnerBlock.java
View File

@ -25,7 +25,7 @@ import com.sk89q.jnbt.NBTUtils;
import com.sk89q.jnbt.ShortTag; import com.sk89q.jnbt.ShortTag;
import com.sk89q.jnbt.StringTag; import com.sk89q.jnbt.StringTag;
import com.sk89q.jnbt.Tag; import com.sk89q.jnbt.Tag;
import com.sk89q.worldedit.MobType; import com.sk89q.worldedit.blocks.metadata.MobType;
import com.sk89q.worldedit.world.storage.InvalidFormatException; import com.sk89q.worldedit.world.storage.InvalidFormatException;
import java.util.HashMap; import java.util.HashMap;

1
src/main/java/com/sk89q/minecraft/util/commands/CommandContext.java
View File

@ -31,6 +31,7 @@ public class CommandContext {
protected final String command; protected final String command;
protected final List<String> parsedArgs; protected final List<String> parsedArgs;
protected final List<Integer> originalArgIndices; protected final List<Integer> originalArgIndices;
protected final String[] originalArgs; protected final String[] originalArgs;
protected final Set<Character> booleanFlags = new HashSet<Character>(); protected final Set<Character> booleanFlags = new HashSet<Character>();

52
src/main/java/com/sk89q/worldedit/BlockVector.java
View File

@ -20,11 +20,11 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
/** /**
* Extension of Vector that supports being compared as ints (for accuracy). * Extension of {@code Vector} that that compares with other instances
* * using integer components.
* @author sk89q
*/ */
public class BlockVector extends Vector { public class BlockVector extends Vector {
public static final BlockVector ZERO = new BlockVector(0, 0, 0); public static final BlockVector ZERO = new BlockVector(0, 0, 0);
public static final BlockVector UNIT_X = new BlockVector(1, 0, 0); public static final BlockVector UNIT_X = new BlockVector(1, 0, 0);
public static final BlockVector UNIT_Y = new BlockVector(0, 1, 0); public static final BlockVector UNIT_Y = new BlockVector(0, 1, 0);
@ -32,55 +32,47 @@ public class BlockVector extends Vector {
public static final BlockVector ONE = new BlockVector(1, 1, 1); public static final BlockVector ONE = new BlockVector(1, 1, 1);
/** /**
* Construct the Vector object. * Construct an instance as a copy of another instance.
* *
* @param pt * @param position the other position
*/ */
public BlockVector(Vector pt) { public BlockVector(Vector position) {
super(pt); super(position);
} }
/** /**
* Construct the Vector object. * Construct a new instance.
* *
* @param x * @param x the X coordinate
* @param y * @param y the Y coordinate
* @param z * @param z the Z coordinate
*/ */
public BlockVector(int x, int y, int z) { public BlockVector(int x, int y, int z) {
super(x, y, z); super(x, y, z);
} }
/** /**
* Construct the Vector object. * Construct a new instance.
* *
* * @param x the X coordinate
* @param x * @param y the Y coordinate
* @param y * @param z the Z coordinate
* @param z
*/ */
public BlockVector(float x, float y, float z) { public BlockVector(float x, float y, float z) {
super(x, y, z); super(x, y, z);
} }
/** /**
* Construct the Vector object. * Construct a new instance.
* *
* * @param x the X coordinate
* @param x * @param y the Y coordinate
* @param y * @param z the Z coordinate
* @param z
*/ */
public BlockVector(double x, double y, double z) { public BlockVector(double x, double y, double z) {
super(x, y, z); super(x, y, z);
} }
/**
* Checks if another object is equivalent.
*
* @param obj
* @return whether the other object is equivalent
*/
@Override @Override
public boolean equals(Object obj) { public boolean equals(Object obj) {
if (!(obj instanceof Vector)) { if (!(obj instanceof Vector)) {
@ -92,11 +84,6 @@ public class BlockVector extends Vector {
} }
/**
* Gets the hash code.
*
* @return hash code
*/
@Override @Override
public int hashCode() { public int hashCode() {
return ((int) x << 19) ^ return ((int) x << 19) ^
@ -108,4 +95,5 @@ public class BlockVector extends Vector {
public BlockVector toBlockVector() { public BlockVector toBlockVector() {
return this; return this;
} }
} }

45
src/main/java/com/sk89q/worldedit/BlockVector2D.java
View File

@ -20,76 +20,66 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
/** /**
* Extension of Vector2D that supports being compared as ints (for accuracy). * Extension of {@code Vector2D} that that compares with other instances
* * using integer components.
* @author sk89q
*/ */
public class BlockVector2D extends Vector2D { public class BlockVector2D extends Vector2D {
public static final BlockVector2D ZERO = new BlockVector2D(0, 0); public static final BlockVector2D ZERO = new BlockVector2D(0, 0);
public static final BlockVector2D UNIT_X = new BlockVector2D(1, 0); public static final BlockVector2D UNIT_X = new BlockVector2D(1, 0);
public static final BlockVector2D UNIT_Z = new BlockVector2D(0, 1); public static final BlockVector2D UNIT_Z = new BlockVector2D(0, 1);
public static final BlockVector2D ONE = new BlockVector2D(1, 1); public static final BlockVector2D ONE = new BlockVector2D(1, 1);
/** /**
* Construct the Vector object. * Construct an instance from another instance.
* *
* @param pt * @param position the position to copy
*/ */
public BlockVector2D(Vector2D pt) { public BlockVector2D(Vector2D position) {
super(pt); super(position);
} }
/** /**
* Construct the Vector object. * Construct a new instance.
* *
* @param x * @param x the X coordinate
* @param z * @param z the Z coordinate
*/ */
public BlockVector2D(int x, int z) { public BlockVector2D(int x, int z) {
super(x, z); super(x, z);
} }
/** /**
* Construct the Vector object. * Construct a new instance.
* *
* @param x * @param x the X coordinate
* @param z * @param z the Z coordinate
*/ */
public BlockVector2D(float x, float z) { public BlockVector2D(float x, float z) {
super(x, z); super(x, z);
} }
/** /**
* Construct the Vector object. * Construct a new instance.
* *
* @param x * @param x the X coordinate
* @param z * @param z the Z coordinate
*/ */
public BlockVector2D(double x, double z) { public BlockVector2D(double x, double z) {
super(x, z); super(x, z);
} }
/**
* Checks if another object is equivalent.
*
* @param obj
* @return whether the other object is equivalent
*/
@Override @Override
public boolean equals(Object obj) { public boolean equals(Object obj) {
if (!(obj instanceof Vector2D)) { if (!(obj instanceof Vector2D)) {
return false; return false;
} }
Vector2D other = (Vector2D) obj; Vector2D other = (Vector2D) obj;
return (int) other.x == (int) this.x && (int) other.z == (int) this.z; return (int) other.x == (int) this.x && (int) other.z == (int) this.z;
} }
/**
* Gets the hash code.
*
* @return hash code
*/
@Override @Override
public int hashCode() { public int hashCode() {
return (Integer.valueOf((int) x).hashCode() >> 13) ^ return (Integer.valueOf((int) x).hashCode() >> 13) ^
@ -100,4 +90,5 @@ public class BlockVector2D extends Vector2D {
public BlockVector2D toBlockVector2D() { public BlockVector2D toBlockVector2D() {
return this; return this;
} }
} }

83
src/main/java/com/sk89q/worldedit/BlockWorldVector.java
View File

@ -20,94 +20,89 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
/** /**
* Extension of Vector that supports being compared as ints (for accuracy). * @deprecated Replace all uses of {@link WorldVector}s with {@link Location}s
*
* @author sk89q
*/ */
@SuppressWarnings("deprecation")
@Deprecated
public class BlockWorldVector extends WorldVector { public class BlockWorldVector extends WorldVector {
/** /**
* Construct the Vector object. * Construct an instance from another instance.
* *
* @param pt * @param position the position to copy
*/ */
public BlockWorldVector(WorldVector pt) { public BlockWorldVector(WorldVector position) {
super(pt.getWorld(), pt); super(position.getWorld(), position);
} }
/** /**
* Construct the Vector object. * Construct an instance from another instance.
* @param world
* *
* @param pt * @param world the world
* @param position the position to copy
*/ */
public BlockWorldVector(LocalWorld world, Vector pt) { public BlockWorldVector(LocalWorld world, Vector position) {
super(world, pt); super(world, position);
} }
/** /**
* Construct the Vector object. * Construct a new instance.
* *
* @param world * @param world another instance
* @param x * @param x the X coordinate
* @param y * @param y the Y coordinate
* @param z * @param z the Z coordinate
*/ */
public BlockWorldVector(WorldVector world, int x, int y, int z) { public BlockWorldVector(WorldVector world, int x, int y, int z) {
super(world.getWorld(), x, y, z); super(world.getWorld(), x, y, z);
} }
/** /**
* Construct the Vector object. * Construct a new instance.
* *
* @param world * @param world another instance
* @param v * @param v the other vector
*/ */
public BlockWorldVector(WorldVector world, Vector v) { public BlockWorldVector(WorldVector world, Vector v) {
super(world.getWorld(), v.getX(), v.getY(), v.getZ()); super(world.getWorld(), v.getX(), v.getY(), v.getZ());
} }
/** /**
* Construct the Vector object. * Construct a new instance.
* *
* @param world * @param world a world
* @param x * @param x the X coordinate
* @param y * @param y the Y coordinate
* @param z * @param z the Z coordinate
*/ */
public BlockWorldVector(LocalWorld world, int x, int y, int z) { public BlockWorldVector(LocalWorld world, int x, int y, int z) {
super(world, x, y, z); super(world, x, y, z);
} }
/** /**
* Construct the Vector object. * Construct a new instance.
* *
* @param world * @param world a world
* @param x * @param x the X coordinate
* @param y * @param y the Y coordinate
* @param z * @param z the Z coordinate
*/ */
public BlockWorldVector(LocalWorld world, float x, float y, float z) { public BlockWorldVector(LocalWorld world, float x, float y, float z) {
super(world, x, y, z); super(world, x, y, z);
} }
/** /**
* Construct the Vector object. * Construct a new instance.
* *
* @param world * @param world a world
* @param x * @param x the X coordinate
* @param y * @param y the Y coordinate
* @param z * @param z the Z coordinate
*/ */
public BlockWorldVector(LocalWorld world, double x, double y, double z) { public BlockWorldVector(LocalWorld world, double x, double y, double z) {
super(world, x, y, z); super(world, x, y, z);
} }
/**
* Checks if another object is equivalent.
*
* @param obj
* @return whether the other object is equivalent
*/
@Override @Override
public boolean equals(Object obj) { public boolean equals(Object obj) {
if (!(obj instanceof Vector)) { if (!(obj instanceof Vector)) {
@ -119,15 +114,11 @@ public class BlockWorldVector extends WorldVector {
} }
/**
* Gets the hash code.
*
* @return hash code
*/
@Override @Override
public int hashCode() { public int hashCode() {
return (Integer.valueOf((int) x).hashCode() << 19) ^ return (Integer.valueOf((int) x).hashCode() << 19) ^
(Integer.valueOf((int) y).hashCode() << 12) ^ (Integer.valueOf((int) y).hashCode() << 12) ^
Integer.valueOf((int) z).hashCode(); Integer.valueOf((int) z).hashCode();
} }
} }

47
src/main/java/com/sk89q/worldedit/BlockWorldVector2D.java
View File

@ -19,34 +19,65 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
/**
* @deprecated Replace all uses of {@link WorldVector}s with {@link Location}s
*/
@SuppressWarnings("deprecation")
@Deprecated
public class BlockWorldVector2D extends WorldVector2D { public class BlockWorldVector2D extends WorldVector2D {
/**
* Construct a new instance.
*
* @param world the world
* @param x the X coordinate
* @param z the Z coordinate
*/
public BlockWorldVector2D(LocalWorld world, double x, double z) { public BlockWorldVector2D(LocalWorld world, double x, double z) {
super(world, x, z); super(world, x, z);
} }
/**
* Construct a new instance.
*
* @param world the world
* @param x the X coordinate
* @param z the Z coordinate
*/
public BlockWorldVector2D(LocalWorld world, float x, float z) { public BlockWorldVector2D(LocalWorld world, float x, float z) {
super(world, x, z); super(world, x, z);
} }
/**
* Construct a new instance.
*
* @param world the world
* @param x the X coordinate
* @param z the Z coordinate
*/
public BlockWorldVector2D(LocalWorld world, int x, int z) { public BlockWorldVector2D(LocalWorld world, int x, int z) {
super(world, x, z); super(world, x, z);
} }
public BlockWorldVector2D(LocalWorld world, Vector2D pt) { /**
super(world, pt); * Construct a new instance.
*
* @param world the world
* @param position a position
*/
public BlockWorldVector2D(LocalWorld world, Vector2D position) {
super(world, position);
} }
/**
* Construct a new instance with X and Z set to (0, 0).
*
* @param world the world
*/
public BlockWorldVector2D(LocalWorld world) { public BlockWorldVector2D(LocalWorld world) {
super(world); super(world);
} }
/**
* Checks if another object is equivalent.
*
* @param obj
* @return whether the other object is equivalent
*/
@Override @Override
public boolean equals(Object obj) { public boolean equals(Object obj) {
if (!(obj instanceof WorldVector2D)) { if (!(obj instanceof WorldVector2D)) {

237
src/main/java/com/sk89q/worldedit/CuboidClipboard.java
View File

@ -19,6 +19,18 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
import com.sk89q.worldedit.blocks.BaseBlock;
import com.sk89q.worldedit.blocks.BlockID;
import com.sk89q.worldedit.command.ClipboardCommands;
import com.sk89q.worldedit.command.SchematicCommands;
import com.sk89q.worldedit.extent.Extent;
import com.sk89q.worldedit.extent.clipboard.Clipboard;
import com.sk89q.worldedit.function.operation.ForwardExtentCopy;
import com.sk89q.worldedit.regions.CuboidRegion;
import com.sk89q.worldedit.regions.Region;
import com.sk89q.worldedit.schematic.SchematicFormat;
import com.sk89q.worldedit.util.Countable;
import com.sk89q.worldedit.world.DataException;
import java.io.File; import java.io.File;
import java.io.IOException; import java.io.IOException;
@ -28,21 +40,29 @@ import java.util.HashMap;
import java.util.List; import java.util.List;
import java.util.Map; import java.util.Map;
import com.sk89q.worldedit.blocks.BaseBlock; import static com.google.common.base.Preconditions.checkNotNull;
import com.sk89q.worldedit.blocks.BlockID;
import com.sk89q.worldedit.world.DataException;
import com.sk89q.worldedit.regions.Region;
import com.sk89q.worldedit.schematic.SchematicFormat;
import com.sk89q.worldedit.util.Countable;
/** /**
* The clipboard remembers the state of a cuboid region. * The clipboard remembers the state of a cuboid region.
* *
* @author sk89q * @deprecated This is slowly being replaced with {@link Clipboard}, which is
* far more versatile. Transforms are supported using affine
* transformations and full entity support is provided because
* the clipboard properly implements {@link Extent}. However,
* the new clipboard class is only available in WorldEdit 6.x and
* beyond. We intend on keeping this deprecated class in WorldEdit
* for an extended amount of time so there is no rush to
* switch (but new features will not be supported). To copy between
* a clipboard and a world (or between any two {@code Extent}s),
* one can use {@link ForwardExtentCopy}. See
* {@link ClipboardCommands} and {@link SchematicCommands} for
* more information.
*/ */
@Deprecated
public class CuboidClipboard { public class CuboidClipboard {
/** /**
* Flip direction. * An enum of possible flip directions.
*/ */
public enum FlipDirection { public enum FlipDirection {
NORTH_SOUTH, NORTH_SOUTH,
@ -59,9 +79,11 @@ public class CuboidClipboard {
/** /**
* Constructs the clipboard. * Constructs the clipboard.
* *
* @param size * @param size the dimensions of the clipboard (should be at least 1 on every dimension)
*/ */
public CuboidClipboard(Vector size) { public CuboidClipboard(Vector size) {
checkNotNull(size);
this.size = size; this.size = size;
data = new BaseBlock[size.getBlockX()][size.getBlockY()][size.getBlockZ()]; data = new BaseBlock[size.getBlockX()][size.getBlockY()][size.getBlockZ()];
origin = new Vector(); origin = new Vector();
@ -71,10 +93,14 @@ public class CuboidClipboard {
/** /**
* Constructs the clipboard. * Constructs the clipboard.
* *
* @param size * @param size the dimensions of the clipboard (should be at least 1 on every dimension)
* @param origin * @param origin the origin point where the copy was made, which must be the
* {@link CuboidRegion#getMinimumPoint()} relative to the copy
*/ */
public CuboidClipboard(Vector size, Vector origin) { public CuboidClipboard(Vector size, Vector origin) {
checkNotNull(size);
checkNotNull(origin);
this.size = size; this.size = size;
data = new BaseBlock[size.getBlockX()][size.getBlockY()][size.getBlockZ()]; data = new BaseBlock[size.getBlockX()][size.getBlockY()][size.getBlockZ()];
this.origin = origin; this.origin = origin;
@ -84,11 +110,16 @@ public class CuboidClipboard {
/** /**
* Constructs the clipboard. * Constructs the clipboard.
* *
* @param size * @param size the dimensions of the clipboard (should be at least 1 on every dimension)
* @param origin * @param origin the origin point where the copy was made, which must be the
* @param offset * {@link CuboidRegion#getMinimumPoint()} relative to the copy
* @param offset the offset from the minimum point of the copy where the user was
*/ */
public CuboidClipboard(Vector size, Vector origin, Vector offset) { public CuboidClipboard(Vector size, Vector origin, Vector offset) {
checkNotNull(size);
checkNotNull(origin);
checkNotNull(offset);
this.size = size; this.size = size;
data = new BaseBlock[size.getBlockX()][size.getBlockY()][size.getBlockZ()]; data = new BaseBlock[size.getBlockX()][size.getBlockY()][size.getBlockZ()];
this.origin = origin; this.origin = origin;
@ -127,6 +158,7 @@ public class CuboidClipboard {
* *
* @param angle in degrees * @param angle in degrees
*/ */
@SuppressWarnings("deprecation")
public void rotate2D(int angle) { public void rotate2D(int angle) {
angle = angle % 360; angle = angle % 360;
if (angle % 90 != 0) { // Can only rotate 90 degrees at the moment if (angle % 90 != 0) { // Can only rotate 90 degrees at the moment
@ -196,7 +228,10 @@ public class CuboidClipboard {
* @param dir direction to flip * @param dir direction to flip
* @param aroundPlayer flip the offset around the player * @param aroundPlayer flip the offset around the player
*/ */
@SuppressWarnings("deprecation")
public void flip(FlipDirection dir, boolean aroundPlayer) { public void flip(FlipDirection dir, boolean aroundPlayer) {
checkNotNull(dir);
final int width = getWidth(); final int width = getWidth();
final int length = getLength(); final int length = getLength();
final int height = getHeight(); final int height = getHeight();
@ -303,7 +338,7 @@ public class CuboidClipboard {
/** /**
* Copies blocks to the clipboard. * Copies blocks to the clipboard.
* *
* @param editSession The EditSession from which to take the blocks * @param editSession the EditSession from which to take the blocks
*/ */
public void copy(EditSession editSession) { public void copy(EditSession editSession) {
for (int x = 0; x < size.getBlockX(); ++x) { for (int x = 0; x < size.getBlockX(); ++x) {
@ -337,21 +372,38 @@ public class CuboidClipboard {
} }
} }
public void paste(EditSession editSession, Vector newOrigin, boolean noAir) /**
throws MaxChangedBlocksException { * Paste the clipboard at the given location using the given {@code EditSession}.
*
* <p>This method blocks the server/game until the entire clipboard is
* pasted. In the future, {@link ForwardExtentCopy} will be recommended,
* which, if combined with the proposed operation scheduler framework,
* will not freeze the game/server.</p>
*
* @param editSession the EditSession to which blocks are to be copied to
* @param newOrigin the new origin point (must correspond to the minimum point of the cuboid)
* @param noAir true to not copy air blocks in the source
* @throws MaxChangedBlocksException thrown if too many blocks were changed
*/
public void paste(EditSession editSession, Vector newOrigin, boolean noAir) throws MaxChangedBlocksException {
paste(editSession, newOrigin, noAir, false); paste(editSession, newOrigin, noAir, false);
} }
/** /**
* Paste from the clipboard. * Paste the clipboard at the given location using the given {@code EditSession}.
* *
* @param editSession * <p>This method blocks the server/game until the entire clipboard is
* @param newOrigin Position to paste it from * pasted. In the future, {@link ForwardExtentCopy} will be recommended,
* @param noAir True to not paste air * which, if combined with the proposed operation scheduler framework,
* @throws MaxChangedBlocksException * will not freeze the game/server.</p>
*
* @param editSession the EditSession to which blocks are to be copied to
* @param newOrigin the new origin point (must correspond to the minimum point of the cuboid)
* @param noAir true to not copy air blocks in the source
* @param entities true to copy entities
* @throws MaxChangedBlocksException thrown if too many blocks were changed
*/ */
public void paste(EditSession editSession, Vector newOrigin, boolean noAir, boolean entities) public void paste(EditSession editSession, Vector newOrigin, boolean noAir, boolean entities) throws MaxChangedBlocksException {
throws MaxChangedBlocksException {
place(editSession, newOrigin.add(offset), noAir); place(editSession, newOrigin.add(offset), noAir);
if (entities) { if (entities) {
pasteEntities(newOrigin.add(offset)); pasteEntities(newOrigin.add(offset));
@ -359,14 +411,19 @@ public class CuboidClipboard {
} }
/** /**
* Places the blocks in a position from the minimum corner. * Paste the clipboard at the given location using the given {@code EditSession}.
* *
* @param editSession * <p>This method blocks the server/game until the entire clipboard is
* @param pos * pasted. In the future, {@link ForwardExtentCopy} will be recommended,
* @param noAir * which, if combined with the proposed operation scheduler framework,
* @throws MaxChangedBlocksException * will not freeze the game/server.</p>
*
* @param editSession the EditSession to which blocks are to be copied to
* @param newOrigin the new origin point (must correspond to the minimum point of the cuboid)
* @param noAir true to not copy air blocks in the source
* @throws MaxChangedBlocksException thrown if too many blocks were changed
*/ */
public void place(EditSession editSession, Vector pos, boolean noAir) throws MaxChangedBlocksException { public void place(EditSession editSession, Vector newOrigin, boolean noAir) throws MaxChangedBlocksException {
for (int x = 0; x < size.getBlockX(); ++x) { for (int x = 0; x < size.getBlockX(); ++x) {
for (int y = 0; y < size.getBlockY(); ++y) { for (int y = 0; y < size.getBlockY(); ++y) {
for (int z = 0; z < size.getBlockZ(); ++z) { for (int z = 0; z < size.getBlockZ(); ++z) {
@ -379,37 +436,50 @@ public class CuboidClipboard {
continue; continue;
} }
editSession.setBlock(new Vector(x, y, z).add(pos), block); editSession.setBlock(new Vector(x, y, z).add(newOrigin), block);
} }
} }
} }
} }
public LocalEntity[] pasteEntities(Vector pos) { /**
* Paste the stored entities to the given position.
*
* @param newOrigin the new origin
* @return a list of entities that were pasted
*/
public LocalEntity[] pasteEntities(Vector newOrigin) {
LocalEntity[] entities = new LocalEntity[this.entities.size()]; LocalEntity[] entities = new LocalEntity[this.entities.size()];
for (int i = 0; i < this.entities.size(); ++i) { for (int i = 0; i < this.entities.size(); ++i) {
CopiedEntity copied = this.entities.get(i); CopiedEntity copied = this.entities.get(i);
if (copied.entity.spawn(copied.entity.getPosition().setPosition(copied.relativePosition.add(pos)))) { if (copied.entity.spawn(copied.entity.getPosition().setPosition(copied.relativePosition.add(newOrigin)))) {
entities[i] = copied.entity; entities[i] = copied.entity;
} }
} }
return entities; return entities;
} }
/**
* Store an entity.
*
* @param entity the entity
*/
public void storeEntity(LocalEntity entity) { public void storeEntity(LocalEntity entity) {
this.entities.add(new CopiedEntity(entity)); this.entities.add(new CopiedEntity(entity));
} }
/** /**
* Get one point in the copy. * Get the block at the given position.
* *
* @param The point, relative to the origin of the copy (0, 0, 0) and not to the actual copy origin. * <p>If the position is out of bounds, air will be returned.</p>
*
* @param position the point, relative to the origin of the copy (0, 0, 0) and not to the actual copy origin
* @return air, if this block was outside the (non-cuboid) selection while copying * @return air, if this block was outside the (non-cuboid) selection while copying
* @throws ArrayIndexOutOfBoundsException if the position is outside the bounds of the CuboidClipboard * @throws ArrayIndexOutOfBoundsException if the position is outside the bounds of the CuboidClipboard
* @deprecated Use {@link #getBlock(Vector)} instead * @deprecated Use {@link #getBlock(Vector)} instead
*/ */
public BaseBlock getPoint(Vector pos) throws ArrayIndexOutOfBoundsException { public BaseBlock getPoint(Vector position) throws ArrayIndexOutOfBoundsException {
final BaseBlock block = getBlock(pos); final BaseBlock block = getBlock(position);
if (block == null) { if (block == null) {
return new BaseBlock(BlockID.AIR); return new BaseBlock(BlockID.AIR);
} }
@ -418,30 +488,32 @@ public class CuboidClipboard {
} }
/** /**
* Get one point in the copy. * Get the block at the given position.
* *
* @param The point, relative to the origin of the copy (0, 0, 0) and not to the actual copy origin. * <p>If the position is out of bounds, air will be returned.</p>
*
* @param position the point, relative to the origin of the copy (0, 0, 0) and not to the actual copy origin
* @return null, if this block was outside the (non-cuboid) selection while copying * @return null, if this block was outside the (non-cuboid) selection while copying
* @throws ArrayIndexOutOfBoundsException if the position is outside the bounds of the CuboidClipboard * @throws ArrayIndexOutOfBoundsException if the position is outside the bounds of the CuboidClipboard
*/ */
public BaseBlock getBlock(Vector pos) throws ArrayIndexOutOfBoundsException { public BaseBlock getBlock(Vector position) throws ArrayIndexOutOfBoundsException {
return data[pos.getBlockX()][pos.getBlockY()][pos.getBlockZ()]; return data[position.getBlockX()][position.getBlockY()][position.getBlockZ()];
} }
/** /**
* Set one point in the copy. Pass null to remove the block. * Set the block at a position in the clipboard.
* *
* @param The point, relative to the origin of the copy (0, 0, 0) and not to the actual copy origin. * @param position the point, relative to the origin of the copy (0, 0, 0) and not to the actual copy origin.
* @throws ArrayIndexOutOfBoundsException if the position is outside the bounds of the CuboidClipboard * @throws ArrayIndexOutOfBoundsException if the position is outside the bounds of the CuboidClipboard
*/ */
public void setBlock(Vector pt, BaseBlock block) { public void setBlock(Vector position, BaseBlock block) {
data[pt.getBlockX()][pt.getBlockY()][pt.getBlockZ()] = block; data[position.getBlockX()][position.getBlockY()][position.getBlockZ()] = block;
} }
/** /**
* Get the size of the copy. * Get the dimensions of the clipboard.
* *
* @return * @return the dimensions, where (1, 1, 1) is 1 wide, 1 across, 1 deep
*/ */
public Vector getSize() { public Vector getSize() {
return size; return size;
@ -450,30 +522,37 @@ public class CuboidClipboard {
/** /**
* Saves the clipboard data to a .schematic-format file. * Saves the clipboard data to a .schematic-format file.
* *
* @param path * @param path the path to the file to save
* @throws IOException * @throws IOException thrown on I/O error
* @throws DataException * @throws DataException thrown on error writing the data for other reasons
* @deprecated use {@link SchematicFormat#MCEDIT}
*/ */
@Deprecated @Deprecated
public void saveSchematic(File path) throws IOException, DataException { public void saveSchematic(File path) throws IOException, DataException {
checkNotNull(path);
SchematicFormat.MCEDIT.save(this, path); SchematicFormat.MCEDIT.save(this, path);
} }
/** /**
* Load a .schematic file into a clipboard. * Load a .schematic file into a clipboard.
* *
* @param path * @param path the path to the file to load
* @return clipboard * @return a clipboard
* @throws DataException * @throws IOException thrown on I/O error
* @throws IOException * @throws DataException thrown on error writing the data for other reasons
* @deprecated use {@link SchematicFormat#MCEDIT}
*/ */
@Deprecated @Deprecated
public static CuboidClipboard loadSchematic(File path) public static CuboidClipboard loadSchematic(File path) throws DataException, IOException {
throws DataException, IOException { checkNotNull(path);
return SchematicFormat.MCEDIT.load(path); return SchematicFormat.MCEDIT.load(path);
} }
/** /**
* Get the origin point, which corresponds to where the copy was
* originally copied from. The origin is the lowest possible X, Y, and
* Z components of the cuboid region that was copied.
*
* @return the origin * @return the origin
*/ */
public Vector getOrigin() { public Vector getOrigin() {
@ -481,39 +560,45 @@ public class CuboidClipboard {
} }
/** /**
* Set the origin point, which corresponds to where the copy was
* originally copied from. The origin is the lowest possible X, Y, and
* Z components of the cuboid region that was copied.
*
* @param origin the origin to set * @param origin the origin to set
*/ */
public void setOrigin(Vector origin) { public void setOrigin(Vector origin) {
checkNotNull(origin);
this.origin = origin; this.origin = origin;
} }
/** /**
* @return the offset * Get the offset of the player to the clipboard's minimum point
* (minimum X, Y, Z coordinates).
*
* <p>The offset is inverse (multiplied by -1).</p>
*
* @return the offset the offset
*/ */
public Vector getOffset() { public Vector getOffset() {
return offset; return offset;
} }
/** /**
* @param offset * Set the offset of the player to the clipboard's minimum point
* (minimum X, Y, Z coordinates).
*
* <p>The offset is inverse (multiplied by -1).</p>
*
* @param offset the new offset
*/ */
public void setOffset(Vector offset) { public void setOffset(Vector offset) {
this.offset = offset; this.offset = offset;
} }
private class CopiedEntity {
private final LocalEntity entity;
private final Vector relativePosition;
public CopiedEntity(LocalEntity entity) {
this.entity = entity;
this.relativePosition = entity.getPosition().getPosition().subtract(getOrigin());
}
}
/** /**
* Get the block distribution inside a clipboard. * Get the block distribution inside a clipboard.
* *
* @return * @return a block distribution
*/ */
public List<Countable<Integer>> getBlockDistribution() { public List<Countable<Integer>> getBlockDistribution() {
List<Countable<Integer>> distribution = new ArrayList<Countable<Integer>>(); List<Countable<Integer>> distribution = new ArrayList<Countable<Integer>>();
@ -553,7 +638,7 @@ public class CuboidClipboard {
/** /**
* Get the block distribution inside a clipboard with data values. * Get the block distribution inside a clipboard with data values.
* *
* @return * @return a block distribution
*/ */
// TODO reduce code duplication // TODO reduce code duplication
public List<Countable<BaseBlock>> getBlockDistributionWithData() { public List<Countable<BaseBlock>> getBlockDistributionWithData() {
@ -591,4 +676,18 @@ public class CuboidClipboard {
return distribution; return distribution;
} }
/**
* Stores a copied entity.
*/
private class CopiedEntity {
private final LocalEntity entity;
private final Vector relativePosition;
private CopiedEntity(LocalEntity entity) {
this.entity = entity;
this.relativePosition = entity.getPosition().getPosition().subtract(getOrigin());
}
}
} }

5
src/main/java/com/sk89q/worldedit/DisallowedItemException.java
View File

@ -20,11 +20,9 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
/** /**
* * Thrown when a disallowed item is used.
* @author sk89q
*/ */
public class DisallowedItemException extends WorldEditException { public class DisallowedItemException extends WorldEditException {
private static final long serialVersionUID = -8080026411461549979L;
private String type; private String type;
@ -40,4 +38,5 @@ public class DisallowedItemException extends WorldEditException {
public String getID() { public String getID() {
return type; return type;
} }
} }

6
src/main/java/com/sk89q/worldedit/EditSession.java
View File

@ -88,10 +88,10 @@ import static com.sk89q.worldedit.regions.Regions.*;
/** /**
* An {@link Extent} that handles history, {@link BlockBag}s, change limits, * An {@link Extent} that handles history, {@link BlockBag}s, change limits,
* block re-ordering, and much more. Most operations in WorldEdit use this class. * block re-ordering, and much more. Most operations in WorldEdit use this class.
* </p> *
* Most of the actual functionality is implemented with a number of other * <p>Most of the actual functionality is implemented with a number of other
* {@link Extent}s that are chained together. For example, history is logged * {@link Extent}s that are chained together. For example, history is logged
* using the {@link ChangeSetExtent}. * using the {@link ChangeSetExtent}.</p>
*/ */
@SuppressWarnings("FieldCanBeLocal") @SuppressWarnings("FieldCanBeLocal")
public class EditSession implements Extent { public class EditSession implements Extent {

6
src/main/java/com/sk89q/worldedit/EditSessionFactory.java
View File

@ -30,10 +30,10 @@ import static com.google.common.base.Preconditions.checkNotNull;
/** /**
* Creates new {@link EditSession}s. To get an instance of this factory, * Creates new {@link EditSession}s. To get an instance of this factory,
* use {@link WorldEdit#getEditSessionFactory()}. * use {@link WorldEdit#getEditSessionFactory()}.
* </p> *
* It is no longer possible to replace the instance of this in WorldEdit * <p>It is no longer possible to replace the instance of this in WorldEdit
* with a custom one. Use {@link EditSessionEvent} to override * with a custom one. Use {@link EditSessionEvent} to override
* the creation of {@link EditSession}s. * the creation of {@link EditSession}s.</p>
*/ */
public class EditSessionFactory { public class EditSessionFactory {

4
src/main/java/com/sk89q/worldedit/EmptyClipboardException.java
View File

@ -20,10 +20,8 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
/** /**
* * Thrown when there is no clipboard set.
* @author Albert
*/ */
public class EmptyClipboardException extends WorldEditException { public class EmptyClipboardException extends WorldEditException {
private static final long serialVersionUID = -3197424556127109425L;
} }

3
src/main/java/com/sk89q/worldedit/IncompleteRegionException.java
View File

@ -21,10 +21,7 @@ package com.sk89q.worldedit;
/** /**
* Raised when a region is not fully defined. * Raised when a region is not fully defined.
*
* @author sk89q
*/ */
public class IncompleteRegionException extends WorldEditException { public class IncompleteRegionException extends WorldEditException {
private static final long serialVersionUID = 458988897980179094L;
} }

5
src/main/java/com/sk89q/worldedit/InvalidItemException.java
View File

@ -20,13 +20,12 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
/** /**
* * Thrown when an invalid item is specified.
* @author sk89q
*/ */
public class InvalidItemException extends DisallowedItemException { public class InvalidItemException extends DisallowedItemException {
private static final long serialVersionUID = -2739618871154124586L;
public InvalidItemException(String type, String message) { public InvalidItemException(String type, String message) {
super(type, message); super(type, message);
} }
} }

8
src/main/java/com/sk89q/worldedit/LocalConfiguration.java
View File

@ -29,10 +29,9 @@ import java.util.Set;
/** /**
* Represents WorldEdit's configuration. * Represents WorldEdit's configuration.
*
* @author sk89q
*/ */
public abstract class LocalConfiguration { public abstract class LocalConfiguration {
protected static final int[] defaultDisallowedBlocks = new int[] { protected static final int[] defaultDisallowedBlocks = new int[] {
// dangerous stuff (physics/drops items) // dangerous stuff (physics/drops items)
BlockID.SAPLING, BlockID.SAPLING,
@ -114,16 +113,17 @@ public abstract class LocalConfiguration {
public boolean allowSymlinks = false; public boolean allowSymlinks = false;
/** /**
* Loads the configuration. * Load the configuration.
*/ */
public abstract void load(); public abstract void load();
/** /**
* Get the working directory to work from. * Get the working directory to work from.
* *
* @return * @return a working directory
*/ */
public File getWorkingDirectory() { public File getWorkingDirectory() {
return new File("."); return new File(".");
} }
} }

10
src/main/java/com/sk89q/worldedit/LocalEntity.java
View File

@ -19,10 +19,17 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
import com.sk89q.worldedit.entity.BaseEntity;
import com.sk89q.worldedit.entity.Entity;
/** /**
* @author zml2008 * Holds an entity.
*
* @deprecated replaced with the new entity API using {@link Entity} and {@link BaseEntity}
*/ */
@Deprecated
public abstract class LocalEntity { public abstract class LocalEntity {
private final Location position; private final Location position;
protected LocalEntity(Location position) { protected LocalEntity(Location position) {
@ -38,4 +45,5 @@ public abstract class LocalEntity {
} }
public abstract boolean spawn(Location loc); public abstract boolean spawn(Location loc);
} }

2
src/main/java/com/sk89q/worldedit/LocalPlayer.java
View File

@ -26,7 +26,7 @@ import com.sk89q.worldedit.extension.platform.Actor;
/** /**
* Represents a player that uses WorldEdit. * Represents a player that uses WorldEdit.
* *
* @deprecated Use {@link Actor} (or {@link Player}, etc.) instead (and {@link AbstractPlayerActor} to extend) * @deprecated use {@link Actor} (or {@link Player}, etc.) instead (and {@link AbstractPlayerActor} to extend)
*/ */
@Deprecated @Deprecated
public abstract class LocalPlayer extends AbstractPlayerActor { public abstract class LocalPlayer extends AbstractPlayerActor {

3
src/main/java/com/sk89q/worldedit/LocalSession.java
View File

@ -25,6 +25,7 @@ import com.sk89q.jchronic.utils.Span;
import com.sk89q.jchronic.utils.Time; import com.sk89q.jchronic.utils.Time;
import com.sk89q.worldedit.command.tool.BlockTool; import com.sk89q.worldedit.command.tool.BlockTool;
import com.sk89q.worldedit.command.tool.BrushTool; import com.sk89q.worldedit.command.tool.BrushTool;
import com.sk89q.worldedit.command.tool.InvalidToolBindException;
import com.sk89q.worldedit.command.tool.SinglePickaxe; import com.sk89q.worldedit.command.tool.SinglePickaxe;
import com.sk89q.worldedit.command.tool.Tool; import com.sk89q.worldedit.command.tool.Tool;
import com.sk89q.worldedit.entity.Player; import com.sk89q.worldedit.entity.Player;
@ -315,8 +316,6 @@ public class LocalSession {
return selector; return selector;
} }
/** /**
* @deprecated use {@link #getRegionSelector(World)} * @deprecated use {@link #getRegionSelector(World)}
*/ */

4
src/main/java/com/sk89q/worldedit/MaxBrushRadiusException.java
View File

@ -20,10 +20,8 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
/** /**
*
* Thrown when a maximum radius for a brush is reached. * Thrown when a maximum radius for a brush is reached.
*
*/ */
public class MaxBrushRadiusException extends MaxRadiusException { public class MaxBrushRadiusException extends MaxRadiusException {
private static final long serialVersionUID = 1L;
} }

16
src/main/java/com/sk89q/worldedit/MaxChangedBlocksException.java
View File

@ -20,19 +20,29 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
/** /**
* * Thrown when too many blocks are changed (which may be limited
* @author sk89q * due to the configuration).
*/ */
public class MaxChangedBlocksException extends WorldEditException { public class MaxChangedBlocksException extends WorldEditException {
private static final long serialVersionUID = -2621044030640945259L;
int maxBlocks; int maxBlocks;
/**
* Create a new instance.
*
* @param maxBlocks the maximum number of blocks that can be changed
*/
public MaxChangedBlocksException(int maxBlocks) { public MaxChangedBlocksException(int maxBlocks) {
this.maxBlocks = maxBlocks; this.maxBlocks = maxBlocks;
} }
/**
* Get the limit.
*
* @return the maximum number of blocks that can be changed
*/
public int getBlockLimit() { public int getBlockLimit() {
return maxBlocks; return maxBlocks;
} }
} }

7
src/main/java/com/sk89q/worldedit/MaxRadiusException.java
View File

@ -20,10 +20,9 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
/** /**
* Thrown when a maximum radius is reached. * Thrown when a maximum radius is reached, such as, for example,
* * in the case of a sphere command.
* @author sk89q
*/ */
public class MaxRadiusException extends WorldEditException { public class MaxRadiusException extends WorldEditException {
private static final long serialVersionUID = -8405382841529528119L;
} }

26
src/main/java/com/sk89q/worldedit/NotABlockException.java
View File

@ -19,16 +19,34 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
/**
* Raised when an item is used when a block was expected.
*/
public class NotABlockException extends WorldEditException { public class NotABlockException extends WorldEditException {
/**
* Create a new instance.
*/
public NotABlockException() { public NotABlockException() {
super("This item is not a block."); super("This item is not a block.");
} }
public NotABlockException(String type) { /**
super("The item '"+type+"' is not a block."); * Create a new instance.
*
* @param input the input that was used
*/
public NotABlockException(String input) {
super("The item '" + input + "' is not a block.");
} }
public NotABlockException(int typeId) { /**
super("The item with the ID "+typeId+" is not a block."); * Create a new instance.
*
* @param input the input that was used
*/
public NotABlockException(int input) {
super("The item with the ID " + input + " is not a block.");
} }
} }

8
src/main/java/com/sk89q/worldedit/PlayerDirection.java
View File

@ -19,10 +19,15 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
import com.sk89q.worldedit.util.Direction;
/** /**
* Direction. * The player's direction.
*
* <p>In the future, this class will be replaced with {@link Direction}.</p>
*/ */
public enum PlayerDirection { public enum PlayerDirection {
NORTH(new Vector(0, 0, -1), new Vector(-1, 0, 0), true), NORTH(new Vector(0, 0, -1), new Vector(-1, 0, 0), true),
NORTH_EAST((new Vector(1, 0, -1)).normalize(), (new Vector(-1, 0, -1)).normalize(), false), NORTH_EAST((new Vector(1, 0, -1)).normalize(), (new Vector(-1, 0, -1)).normalize(), false),
EAST(new Vector(1, 0, 0), new Vector(0, 0, -1), true), EAST(new Vector(1, 0, 0), new Vector(0, 0, -1), true),
@ -56,4 +61,5 @@ public enum PlayerDirection {
public boolean isOrthogonal() { public boolean isOrthogonal() {
return isOrthogonal; return isOrthogonal;
} }
} }

32
src/main/java/com/sk89q/worldedit/PlayerNeededException.java
View File

@ -1,32 +0,0 @@
/*
* WorldEdit, a Minecraft world manipulation toolkit
* Copyright (C) sk89q <http://www.sk89q.com>
* Copyright (C) WorldEdit team and contributors
*
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by the
* Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
* for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
package com.sk89q.worldedit;
/**
* Thrown when an operation is run that needs an actual player, not a console.
*
*/
public class PlayerNeededException extends RuntimeException {
private static final long serialVersionUID = 1L;
public PlayerNeededException() {
super("This command cannot be run on the console.");
}
}

36
src/main/java/com/sk89q/worldedit/UnknownBiomeTypeException.java
View File

@ -1,36 +0,0 @@
/*
* WorldEdit, a Minecraft world manipulation toolkit
* Copyright (C) sk89q <http://www.sk89q.com>
* Copyright (C) WorldEdit team and contributors
*
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by the
* Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
* for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
package com.sk89q.worldedit;
public class UnknownBiomeTypeException extends WorldEditException {
private static final long serialVersionUID = -6239229394330814896L;
private String typeName;
public UnknownBiomeTypeException(String typeName) {
super("Unknown " + typeName + " biome type.");
this.typeName = typeName;
}
public String getTypeName() {
return typeName;
}
}

15
src/main/java/com/sk89q/worldedit/UnknownDirectionException.java
View File

@ -20,19 +20,28 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
/** /**
* * Thrown when an unknown direction is specified or detected.
* @author sk89q
*/ */
public class UnknownDirectionException extends WorldEditException { public class UnknownDirectionException extends WorldEditException {
private static final long serialVersionUID = 5705931351293248358L;
private String dir; private String dir;
/**
* Create a new instance.
*
* @param dir the input that was tried
*/
public UnknownDirectionException(String dir) { public UnknownDirectionException(String dir) {
this.dir = dir; this.dir = dir;
} }
/**
* Get the direction string that was input.
*
* @return input
*/
public String getDirection() { public String getDirection() {
return dir; return dir;
} }
} }

14
src/main/java/com/sk89q/worldedit/UnknownItemException.java
View File

@ -21,19 +21,27 @@ package com.sk89q.worldedit;
/** /**
* Thrown when no item exist by the ID. * Thrown when no item exist by the ID.
*
* @author sk89q
*/ */
public class UnknownItemException extends WorldEditException { public class UnknownItemException extends WorldEditException {
private static final long serialVersionUID = 2661079183700565880L;
private String type; private String type;
/**
* Create a new instance.
*
* @param type the input that was provided
*/
public UnknownItemException(String type) { public UnknownItemException(String type) {
this.type = type; this.type = type;
} }
/**
* Get the input.
*
* @return the input
*/
public String getID() { public String getID() {
return type; return type;
} }
} }

465
src/main/java/com/sk89q/worldedit/Vector.java
View File

@ -19,11 +19,15 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
import com.sk89q.worldedit.math.transform.AffineTransform;
import javax.annotation.Nullable;
/** /**
* * An immutable 3-dimensional vector.
* @author sk89q
*/ */
public class Vector implements Comparable<Vector> { public class Vector implements Comparable<Vector> {
public static final Vector ZERO = new Vector(0, 0, 0); public static final Vector ZERO = new Vector(0, 0, 0);
public static final Vector UNIT_X = new Vector(1, 0, 0); public static final Vector UNIT_X = new Vector(1, 0, 0);
public static final Vector UNIT_Y = new Vector(0, 1, 0); public static final Vector UNIT_Y = new Vector(0, 1, 0);
@ -33,11 +37,11 @@ public class Vector implements Comparable<Vector> {
protected final double x, y, z; protected final double x, y, z;
/** /**
* Construct the Vector object. * Construct an instance.
* *
* @param x * @param x the X coordinate
* @param y * @param y the Y coordinate
* @param z * @param z the Z coordinate
*/ */
public Vector(double x, double y, double z) { public Vector(double x, double y, double z) {
this.x = x; this.x = x;
@ -46,11 +50,11 @@ public class Vector implements Comparable<Vector> {
} }
/** /**
* Construct the Vector object. * Construct an instance.
* *
* @param x * @param x the X coordinate
* @param y * @param y the Y coordinate
* @param z * @param z the Z coordinate
*/ */
public Vector(int x, int y, int z) { public Vector(int x, int y, int z) {
this.x = (double) x; this.x = (double) x;
@ -59,11 +63,11 @@ public class Vector implements Comparable<Vector> {
} }
/** /**
* Construct the Vector object. * Construct an instance.
* *
* @param x * @param x the X coordinate
* @param y * @param y the Y coordinate
* @param z * @param z the Z coordinate
*/ */
public Vector(float x, float y, float z) { public Vector(float x, float y, float z) {
this.x = (double) x; this.x = (double) x;
@ -72,18 +76,20 @@ public class Vector implements Comparable<Vector> {
} }
/** /**
* Construct the Vector object. * Copy another vector.
* *
* @param pt * @param other another vector to make a copy of
*/ */
public Vector(Vector pt) { public Vector(Vector other) {
this.x = pt.x; this.x = other.x;
this.y = pt.y; this.y = other.y;
this.z = pt.z; this.z = other.z;
} }
/** /**
* Construct the Vector object. * Construct a new instance with X, Y, and Z coordinates set to 0.
*
* <p>One can also refer to a static {@link #ZERO}.</p>
*/ */
public Vector() { public Vector() {
this.x = 0; this.x = 0;
@ -92,33 +98,37 @@ public class Vector implements Comparable<Vector> {
} }
/** /**
* @return the x * Get the X coordinate.
*
* @return the x coordinate
*/ */
public double getX() { public double getX() {
return x; return x;
} }
/** /**
* @return the x * Get the X coordinate rounded.
*
* @return the x coordinate
*/ */
public int getBlockX() { public int getBlockX() {
return (int) Math.round(x); return (int) Math.round(x);
} }
/** /**
* Set X. * Set the X coordinate.
* *
* @param x * @param x the new X
* @return new vector * @return a new vector
*/ */
public Vector setX(double x) { public Vector setX(double x) {
return new Vector(x, y, z); return new Vector(x, y, z);
} }
/** /**
* Set X. * Set the X coordinate.
* *
* @param x * @param x the X coordinate
* @return new vector * @return new vector
*/ */
public Vector setX(int x) { public Vector setX(int x) {
@ -126,315 +136,331 @@ public class Vector implements Comparable<Vector> {
} }
/** /**
* @return the y * Get the Y coordinate.
*
* @return the y coordinate
*/ */
public double getY() { public double getY() {
return y; return y;
} }
/** /**
* @return the y * Get the Y coordinate rounded.
*
* @return the y coordinate
*/ */
public int getBlockY() { public int getBlockY() {
return (int) Math.round(y); return (int) Math.round(y);
} }
/** /**
* Set Y. * Set the Y coordinate.
* *
* @param y * @param y the new Y
* @return new vector * @return a new vector
*/ */
public Vector setY(double y) { public Vector setY(double y) {
return new Vector(x, y, z); return new Vector(x, y, z);
} }
/** /**
* Set Y. * Set the Y coordinate.
* *
* @param y * @param y the new Y
* @return new vector * @return a new vector
*/ */
public Vector setY(int y) { public Vector setY(int y) {
return new Vector(x, y, z); return new Vector(x, y, z);
} }
/** /**
* @return the z * Get the Z coordinate.
*
* @return the z coordinate
*/ */
public double getZ() { public double getZ() {
return z; return z;
} }
/** /**
* @return the z * Get the Z coordinate rounded.
*
* @return the z coordinate
*/ */
public int getBlockZ() { public int getBlockZ() {
return (int) Math.round(z); return (int) Math.round(z);
} }
/** /**
* Set Z. * Set the Z coordinate.
* *
* @param z * @param z the new Z
* @return new vector * @return a new vector
*/ */
public Vector setZ(double z) { public Vector setZ(double z) {
return new Vector(x, y, z); return new Vector(x, y, z);
} }
/** /**
* Set Z. * Set the Z coordinate.
* *
* @param z * @param z the new Z
* @return new vector * @return a new vector
*/ */
public Vector setZ(int z) { public Vector setZ(int z) {
return new Vector(x, y, z); return new Vector(x, y, z);
} }
/** /**
* Adds two points. * Add another vector to this vector and return the result as a new vector.
* *
* @param other * @param other the other vector
* @return New point * @return a new vector
*/ */
public Vector add(Vector other) { public Vector add(Vector other) {
return new Vector(x + other.x, y + other.y, z + other.z); return new Vector(x + other.x, y + other.y, z + other.z);
} }
/** /**
* Adds two points. * Add another vector to this vector and return the result as a new vector.
* *
* @param x * @param x the value to add
* @param y * @param y the value to add
* @param z * @param z the value to add
* @return New point * @return a new vector
*/ */
public Vector add(double x, double y, double z) { public Vector add(double x, double y, double z) {
return new Vector(this.x + x, this.y + y, this.z + z); return new Vector(this.x + x, this.y + y, this.z + z);
} }
/** /**
* Adds two points. * Add another vector to this vector and return the result as a new vector.
* *
* @param x * @param x the value to add
* @param y * @param y the value to add
* @param z * @param z the value to add
* @return New point * @return a new vector
*/ */
public Vector add(int x, int y, int z) { public Vector add(int x, int y, int z) {
return new Vector(this.x + x, this.y + y, this.z + z); return new Vector(this.x + x, this.y + y, this.z + z);
} }
/** /**
* Adds points. * Add a list of vectors to this vector and return the
* result as a new vector.
* *
* @param others * @param others an array of vectors
* @return New point * @return a new vector
*/ */
public Vector add(Vector... others) { public Vector add(Vector... others) {
double newX = x, newY = y, newZ = z; double newX = x, newY = y, newZ = z;
for (int i = 0; i < others.length; ++i) { for (Vector other : others) {
newX += others[i].x; newX += other.x;
newY += others[i].y; newY += other.y;
newZ += others[i].z; newZ += other.z;
} }
return new Vector(newX, newY, newZ); return new Vector(newX, newY, newZ);
} }
/** /**
* Subtracts two points. * Subtract another vector from this vector and return the result
* as a new vector.
* *
* @param other * @param other the other vector
* @return New point * @return a new vector
*/ */
public Vector subtract(Vector other) { public Vector subtract(Vector other) {
return new Vector(x - other.x, y - other.y, z - other.z); return new Vector(x - other.x, y - other.y, z - other.z);
} }
/** /**
* Subtract two points. * Subtract another vector from this vector and return the result
* as a new vector.
* *
* @param x * @param x the value to subtract
* @param y * @param y the value to subtract
* @param z * @param z the value to subtract
* @return New point * @return a new vector
*/ */
public Vector subtract(double x, double y, double z) { public Vector subtract(double x, double y, double z) {
return new Vector(this.x - x, this.y - y, this.z - z); return new Vector(this.x - x, this.y - y, this.z - z);
} }
/** /**
* Subtract two points. * Subtract another vector from this vector and return the result
* as a new vector.
* *
* @param x * @param x the value to subtract
* @param y * @param y the value to subtract
* @param z * @param z the value to subtract
* @return New point * @return a new vector
*/ */
public Vector subtract(int x, int y, int z) { public Vector subtract(int x, int y, int z) {
return new Vector(this.x - x, this.y - y, this.z - z); return new Vector(this.x - x, this.y - y, this.z - z);
} }
/** /**
* Subtract points. * Subtract a list of vectors from this vector and return the result
* as a new vector.
* *
* @param others * @param others an array of vectors
* @return New point * @return a new vector
*/ */
public Vector subtract(Vector... others) { public Vector subtract(Vector... others) {
double newX = x, newY = y, newZ = z; double newX = x, newY = y, newZ = z;
for (int i = 0; i < others.length; ++i) { for (Vector other : others) {
newX -= others[i].x; newX -= other.x;
newY -= others[i].y; newY -= other.y;
newZ -= others[i].z; newZ -= other.z;
} }
return new Vector(newX, newY, newZ); return new Vector(newX, newY, newZ);
} }
/** /**
* Component-wise multiplication * Multiply this vector by another vector on each component.
* *
* @param other * @param other the other vector
* @return New point * @return a new vector
*/ */
public Vector multiply(Vector other) { public Vector multiply(Vector other) {
return new Vector(x * other.x, y * other.y, z * other.z); return new Vector(x * other.x, y * other.y, z * other.z);
} }
/** /**
* Component-wise multiplication * Multiply this vector by another vector on each component.
* *
* @param x * @param x the value to multiply
* @param y * @param y the value to multiply
* @param z * @param z the value to multiply
* @return New point * @return a new vector
*/ */
public Vector multiply(double x, double y, double z) { public Vector multiply(double x, double y, double z) {
return new Vector(this.x * x, this.y * y, this.z * z); return new Vector(this.x * x, this.y * y, this.z * z);
} }
/** /**
* Component-wise multiplication * Multiply this vector by another vector on each component.
* *
* @param x * @param x the value to multiply
* @param y * @param y the value to multiply
* @param z * @param z the value to multiply
* @return New point * @return a new vector
*/ */
public Vector multiply(int x, int y, int z) { public Vector multiply(int x, int y, int z) {
return new Vector(this.x * x, this.y * y, this.z * z); return new Vector(this.x * x, this.y * y, this.z * z);
} }
/** /**
* Component-wise multiplication * Multiply this vector by zero or more vectors on each component.
* *
* @param others * @param others an array of vectors
* @return New point * @return a new vector
*/ */
public Vector multiply(Vector... others) { public Vector multiply(Vector... others) {
double newX = x, newY = y, newZ = z; double newX = x, newY = y, newZ = z;
for (int i = 0; i < others.length; ++i) { for (Vector other : others) {
newX *= others[i].x; newX *= other.x;
newY *= others[i].y; newY *= other.y;
newZ *= others[i].z; newZ *= other.z;
} }
return new Vector(newX, newY, newZ); return new Vector(newX, newY, newZ);
} }
/** /**
* Scalar multiplication. * Perform scalar multiplication and return a new vector.
* *
* @param n * @param n the value to multiply
* @return New point * @return a new vector
*/ */
public Vector multiply(double n) { public Vector multiply(double n) {
return new Vector(this.x * n, this.y * n, this.z * n); return new Vector(this.x * n, this.y * n, this.z * n);
} }
/** /**
* Scalar multiplication. * Perform scalar multiplication and return a new vector.
* *
* @param n * @param n the value to multiply
* @return New point * @return a new vector
*/ */
public Vector multiply(float n) { public Vector multiply(float n) {
return new Vector(this.x * n, this.y * n, this.z * n); return new Vector(this.x * n, this.y * n, this.z * n);
} }
/** /**
* Scalar multiplication. * Perform scalar multiplication and return a new vector.
* *
* @param n * @param n the value to multiply
* @return New point * @return a new vector
*/ */
public Vector multiply(int n) { public Vector multiply(int n) {
return new Vector(this.x * n, this.y * n, this.z * n); return new Vector(this.x * n, this.y * n, this.z * n);
} }
/** /**
* Component-wise division * Divide this vector by another vector on each component.
* *
* @param other * @param other the other vector
* @return New point * @return a new vector
*/ */
public Vector divide(Vector other) { public Vector divide(Vector other) {
return new Vector(x / other.x, y / other.y, z / other.z); return new Vector(x / other.x, y / other.y, z / other.z);
} }
/** /**
* Component-wise division * Divide this vector by another vector on each component.
* *
* @param x * @param x the value to divide by
* @param y * @param y the value to divide by
* @param z * @param z the value to divide by
* @return New point * @return a new vector
*/ */
public Vector divide(double x, double y, double z) { public Vector divide(double x, double y, double z) {
return new Vector(this.x / x, this.y / y, this.z / z); return new Vector(this.x / x, this.y / y, this.z / z);
} }
/** /**
* Component-wise division * Divide this vector by another vector on each component.
* *
* @param x * @param x the value to divide by
* @param y * @param y the value to divide by
* @param z * @param z the value to divide by
* @return New point * @return a new vector
*/ */
public Vector divide(int x, int y, int z) { public Vector divide(int x, int y, int z) {
return new Vector(this.x / x, this.y / y, this.z / z); return new Vector(this.x / x, this.y / y, this.z / z);
} }
/** /**
* Scalar division. * Perform scalar division and return a new vector.
* *
* @param n * @param n the value to divide by
* @return new point * @return a new vector
*/ */
public Vector divide(int n) { public Vector divide(int n) {
return new Vector(x / n, y / n, z / n); return new Vector(x / n, y / n, z / n);
} }
/** /**
* Scalar division. * Perform scalar division and return a new vector.
* *
* @param n * @param n the value to divide by
* @return new point * @return a new vector
*/ */
public Vector divide(double n) { public Vector divide(double n) {
return new Vector(x / n, y / n, z / n); return new Vector(x / n, y / n, z / n);
} }
/** /**
* Scalar division. * Perform scalar division and return a new vector.
* *
* @param n * @param n the value to divide by
* @return new point * @return a new vector
*/ */
public Vector divide(float n) { public Vector divide(float n) {
return new Vector(x / n, y / n, z / n); return new Vector(x / n, y / n, z / n);
@ -450,42 +476,43 @@ public class Vector implements Comparable<Vector> {
} }
/** /**
* Get the length^2 of the vector. * Get the length, squared, of the vector.
* *
* @return length^2 * @return length, squared
*/ */
public double lengthSq() { public double lengthSq() {
return x * x + y * y + z * z; return x * x + y * y + z * z;
} }
/** /**
* Get the distance away from a point. * Get the distance between this vector and another vector.
* *
* @param pt * @param other the other vector
* @return distance * @return distance
*/ */
public double distance(Vector pt) { public double distance(Vector other) {
return Math.sqrt(Math.pow(pt.x - x, 2) + return Math.sqrt(Math.pow(other.x - x, 2) +
Math.pow(pt.y - y, 2) + Math.pow(other.y - y, 2) +
Math.pow(pt.z - z, 2)); Math.pow(other.z - z, 2));
} }
/** /**
* Get the distance away from a point, squared. * Get the distance between this vector and another vector, squared.
* *
* @param pt * @param other the other vector
* @return distance * @return distance
*/ */
public double distanceSq(Vector pt) { public double distanceSq(Vector other) {
return Math.pow(pt.x - x, 2) + return Math.pow(other.x - x, 2) +
Math.pow(pt.y - y, 2) + Math.pow(other.y - y, 2) +
Math.pow(pt.z - z, 2); Math.pow(other.z - z, 2);
} }
/** /**
* Get the normalized vector. * Get the normalized vector, which is the vector divided by its
* length, as a new vector.
* *
* @return vector * @return a new vector
*/ */
public Vector normalize() { public Vector normalize() {
return divide(length()); return divide(length());
@ -494,7 +521,7 @@ public class Vector implements Comparable<Vector> {
/** /**
* Gets the dot product of this and another vector. * Gets the dot product of this and another vector.
* *
* @param other * @param other the other vector
* @return the dot product of this and the other vector * @return the dot product of this and the other vector
*/ */
public double dot(Vector other) { public double dot(Vector other) {
@ -504,7 +531,7 @@ public class Vector implements Comparable<Vector> {
/** /**
* Gets the cross product of this and another vector. * Gets the cross product of this and another vector.
* *
* @param other * @param other the other vector
* @return the cross product of this and the other vector * @return the cross product of this and the other vector
*/ */
public Vector cross(Vector other) { public Vector cross(Vector other) {
@ -518,22 +545,21 @@ public class Vector implements Comparable<Vector> {
/** /**
* Checks to see if a vector is contained with another. * Checks to see if a vector is contained with another.
* *
* @param min * @param min the minimum point (X, Y, and Z are the lowest)
* @param max * @param max the maximum point (X, Y, and Z are the lowest)
* @return * @return true if the vector is contained
*/ */
public boolean containedWithin(Vector min, Vector max) { public boolean containedWithin(Vector min, Vector max) {
return x >= min.x && x <= max.x return x >= min.x && x <= max.x && y >= min.y && y <= max.y && z >= min.z && z <= max.z;
&& y >= min.y && y <= max.y
&& z >= min.z && z <= max.z;
} }
/** /**
* Checks to see if a vector is contained with another. * Checks to see if a vector is contained with another, comparing
* using discrete comparisons, inclusively.
* *
* @param min * @param min the minimum point (X, Y, and Z are the lowest)
* @param max * @param max the maximum point (X, Y, and Z are the lowest)
* @return * @return true if the vector is contained
*/ */
public boolean containedWithinBlock(Vector min, Vector max) { public boolean containedWithinBlock(Vector min, Vector max) {
return getBlockX() >= min.getBlockX() && getBlockX() <= max.getBlockX() return getBlockX() >= min.getBlockX() && getBlockX() <= max.getBlockX()
@ -544,18 +570,18 @@ public class Vector implements Comparable<Vector> {
/** /**
* Clamp the Y component. * Clamp the Y component.
* *
* @param min * @param min the minimum value
* @param max * @param max the maximum value
* @return * @return a new vector
*/ */
public Vector clampY(int min, int max) { public Vector clampY(int min, int max) {
return new Vector(x, Math.max(min, Math.min(max, y)), z); return new Vector(x, Math.max(min, Math.min(max, y)), z);
} }
/** /**
* Rounds all components down. * Floors the values of all components.
* *
* @return * @return a new vector
*/ */
public Vector floor() { public Vector floor() {
return new Vector(Math.floor(x), Math.floor(y), Math.floor(z)); return new Vector(Math.floor(x), Math.floor(y), Math.floor(z));
@ -564,41 +590,43 @@ public class Vector implements Comparable<Vector> {
/** /**
* Rounds all components up. * Rounds all components up.
* *
* @return * @return a new vector
*/ */
public Vector ceil() { public Vector ceil() {
return new Vector(Math.ceil(x), Math.ceil(y), Math.ceil(z)); return new Vector(Math.ceil(x), Math.ceil(y), Math.ceil(z));
} }
/** /**
* Rounds all components to the closest integer.<br> * Rounds all components to the closest integer.
*<br>
* Components < 0.5 are rounded down, otherwise up
* *
* @return * <p>Components < 0.5 are rounded down, otherwise up.</p>
*
* @return a new vector
*/ */
public Vector round() { public Vector round() {
return new Vector(Math.floor(x + 0.5), Math.floor(y + 0.5), Math.floor(z + 0.5)); return new Vector(Math.floor(x + 0.5), Math.floor(y + 0.5), Math.floor(z + 0.5));
} }
/** /**
* Returns a vector with the absolute values of the components of this vector. * Returns a vector with the absolute values of the components of
* this vector.
* *
* @return * @return a new vector
*/ */
public Vector positive() { public Vector positive() {
return new Vector(Math.abs(x), Math.abs(y), Math.abs(z)); return new Vector(Math.abs(x), Math.abs(y), Math.abs(z));
} }
/** /**
* 2D transformation. * Perform a 2D transformation on this vector and return a new one.
* *
* @param angle in degrees * @param angle in degrees
* @param aboutX about which x coordinate to rotate * @param aboutX about which x coordinate to rotate
* @param aboutZ about which z coordinate to rotate * @param aboutZ about which z coordinate to rotate
* @param translateX what to add after rotation * @param translateX what to add after rotation
* @param translateZ what to add after rotation * @param translateZ what to add after rotation
* @return * @return a new vector
* @see AffineTransform another method to transform vectors
*/ */
public Vector transform2D(double angle, double aboutX, double aboutZ, double translateX, double translateZ) { public Vector transform2D(double angle, double aboutX, double aboutZ, double translateX, double translateZ) {
angle = Math.toRadians(angle); angle = Math.toRadians(angle);
@ -614,6 +642,12 @@ public class Vector implements Comparable<Vector> {
); );
} }
/**
* Returns whether this vector is collinear with another vector.
*
* @param other the other vector
* @return true if collinear
*/
public boolean isCollinearWith(Vector other) { public boolean isCollinearWith(Vector other) {
if (x == 0 && y == 0 && z == 0) { if (x == 0 && y == 0 && z == 0) {
// this is a zero vector // this is a zero vector
@ -686,12 +720,12 @@ public class Vector implements Comparable<Vector> {
} }
/** /**
* Get a block point from a point. * Create a new {@code BlockVector} using the given components.
* *
* @param x * @param x the X coordinate
* @param y * @param y the Y coordinate
* @param z * @param z the Z coordinate
* @return point * @return a new {@code BlockVector}
*/ */
public static BlockVector toBlockPoint(double x, double y, double z) { public static BlockVector toBlockPoint(double x, double y, double z) {
return new BlockVector( return new BlockVector(
@ -702,9 +736,9 @@ public class Vector implements Comparable<Vector> {
} }
/** /**
* Get a block point from a point. * Create a new {@code BlockVector} from this vector.
* *
* @return point * @return a new {@code BlockVector}
*/ */
public BlockVector toBlockPoint() { public BlockVector toBlockPoint() {
return new BlockVector( return new BlockVector(
@ -715,11 +749,23 @@ public class Vector implements Comparable<Vector> {
} }
/** /**
* Checks if another object is equivalent. * Create a new {@code BlockVector} from this vector.
* *
* @param obj * @return a new {@code BlockVector}
* @return whether the other object is equivalent
*/ */
public BlockVector toBlockVector() {
return new BlockVector(this);
}
/**
* Creates a 2D vector by dropping the Y component from this vector.
*
* @return a new {@code Vector2D}
*/
public Vector2D toVector2D() {
return new Vector2D(x, z);
}
@Override @Override
public boolean equals(Object obj) { public boolean equals(Object obj) {
if (!(obj instanceof Vector)) { if (!(obj instanceof Vector)) {
@ -731,18 +777,16 @@ public class Vector implements Comparable<Vector> {
} }
@Override @Override
public int compareTo(Vector other) { public int compareTo(@Nullable Vector other) {
if (other == null) {
throw new IllegalArgumentException("null not supported");
}
if (y != other.y) return Double.compare(y, other.y); if (y != other.y) return Double.compare(y, other.y);
if (z != other.z) return Double.compare(z, other.z); if (z != other.z) return Double.compare(z, other.z);
if (x != other.x) return Double.compare(x, other.x); if (x != other.x) return Double.compare(x, other.x);
return 0; return 0;
} }
/**
* Gets the hash code.
*
* @return hash code
*/
@Override @Override
public int hashCode() { public int hashCode() {
int hash = 7; int hash = 7;
@ -753,39 +797,16 @@ public class Vector implements Comparable<Vector> {
return hash; return hash;
} }
/**
* Returns string representation "(x, y, z)".
*
* @return string
*/
@Override @Override
public String toString() { public String toString() {
return "(" + x + ", " + y + ", " + z + ")"; return "(" + x + ", " + y + ", " + z + ")";
} }
/**
* Gets a BlockVector version.
*
* @return BlockVector
*/
public BlockVector toBlockVector() {
return new BlockVector(this);
}
/**
* Creates a 2D vector by dropping the Y component from this vector.
*
* @return Vector2D
*/
public Vector2D toVector2D() {
return new Vector2D(x, z);
}
/** /**
* Gets the minimum components of two vectors. * Gets the minimum components of two vectors.
* *
* @param v1 * @param v1 the first vector
* @param v2 * @param v2 the second vector
* @return minimum * @return minimum
*/ */
public static Vector getMinimum(Vector v1, Vector v2) { public static Vector getMinimum(Vector v1, Vector v2) {
@ -799,8 +820,8 @@ public class Vector implements Comparable<Vector> {
/** /**
* Gets the maximum components of two vectors. * Gets the maximum components of two vectors.
* *
* @param v1 * @param v1 the first vector
* @param v2 * @param v2 the second vector
* @return maximum * @return maximum
*/ */
public static Vector getMaximum(Vector v1, Vector v2) { public static Vector getMaximum(Vector v1, Vector v2) {
@ -814,8 +835,8 @@ public class Vector implements Comparable<Vector> {
/** /**
* Gets the midpoint of two vectors. * Gets the midpoint of two vectors.
* *
* @param v1 * @param v1 the first vector
* @param v2 * @param v2 the second vector
* @return maximum * @return maximum
*/ */
public static Vector getMidpoint(Vector v1, Vector v2) { public static Vector getMidpoint(Vector v1, Vector v2) {

376
src/main/java/com/sk89q/worldedit/Vector2D.java
View File

@ -19,9 +19,10 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
import com.sk89q.worldedit.math.transform.AffineTransform;
/** /**
* * An immutable 2-dimensional vector.
* @author sk89q
*/ */
public class Vector2D { public class Vector2D {
public static final Vector2D ZERO = new Vector2D(0, 0); public static final Vector2D ZERO = new Vector2D(0, 0);
@ -32,10 +33,10 @@ public class Vector2D {
protected final double x, z; protected final double x, z;
/** /**
* Construct the Vector2D object. * Construct an instance.
* *
* @param x * @param x the X coordinate
* @param z * @param z the Z coordinate
*/ */
public Vector2D(double x, double z) { public Vector2D(double x, double z) {
this.x = x; this.x = x;
@ -43,10 +44,10 @@ public class Vector2D {
} }
/** /**
* Construct the Vector2D object. * Construct an instance.
* *
* @param x * @param x the X coordinate
* @param z * @param z the Z coordinate
*/ */
public Vector2D(int x, int z) { public Vector2D(int x, int z) {
this.x = (double) x; this.x = (double) x;
@ -54,10 +55,10 @@ public class Vector2D {
} }
/** /**
* Construct the Vector2D object. * Construct an instance.
* *
* @param x * @param x the X coordinate
* @param z * @param z the Z coordinate
*/ */
public Vector2D(float x, float z) { public Vector2D(float x, float z) {
this.x = (double) x; this.x = (double) x;
@ -65,17 +66,19 @@ public class Vector2D {
} }
/** /**
* Construct the Vector2D object. * Copy another vector.
* *
* @param pt * @param other the other vector
*/ */
public Vector2D(Vector2D pt) { public Vector2D(Vector2D other) {
this.x = pt.x; this.x = other.x;
this.z = pt.z; this.z = other.z;
} }
/** /**
* Construct the Vector2D object. * Construct a new instance with X and Z coordinates set to 0.
*
* <p>One can also refer to a static {@link #ZERO}.</p>
*/ */
public Vector2D() { public Vector2D() {
this.x = 0; this.x = 0;
@ -83,304 +86,320 @@ public class Vector2D {
} }
/** /**
* @return the x * Get the X coordinate.
*
* @return the x coordinate
*/ */
public double getX() { public double getX() {
return x; return x;
} }
/** /**
* @return the x * Get the X coordinate rounded.
*
* @return the x coordinate
*/ */
public int getBlockX() { public int getBlockX() {
return (int) Math.round(x); return (int) Math.round(x);
} }
/** /**
* Set X. * Set the X coordinate.
* *
* @param x * @param x the new X
* @return new vector * @return a new vector
*/ */
public Vector2D setX(double x) { public Vector2D setX(double x) {
return new Vector2D(x, z); return new Vector2D(x, z);
} }
/** /**
* Set X. * Set the X coordinate.
* *
* @param x * @param x the new X
* @return new vector * @return a new vector
*/ */
public Vector2D setX(int x) { public Vector2D setX(int x) {
return new Vector2D(x, z); return new Vector2D(x, z);
} }
/** /**
* @return the z * Get the Z coordinate.
*
* @return the z coordinate
*/ */
public double getZ() { public double getZ() {
return z; return z;
} }
/** /**
* @return the z * Get the Z coordinate rounded.
*
* @return the z coordinate
*/ */
public int getBlockZ() { public int getBlockZ() {
return (int) Math.round(z); return (int) Math.round(z);
} }
/** /**
* Set Z. * Set the Z coordinate.
* *
* @param z * @param z the new Z
* @return new vector * @return a new vector
*/ */
public Vector2D setZ(double z) { public Vector2D setZ(double z) {
return new Vector2D(x, z); return new Vector2D(x, z);
} }
/** /**
* Set Z. * Set the Z coordinate.
* *
* @param z * @param z the new Z
* @return new vector * @return a new vector
*/ */
public Vector2D setZ(int z) { public Vector2D setZ(int z) {
return new Vector2D(x, z); return new Vector2D(x, z);
} }
/** /**
* Adds two points. * Add another vector to this vector and return the result as a new vector.
* *
* @param other * @param other the other vector
* @return New point * @return a new vector
*/ */
public Vector2D add(Vector2D other) { public Vector2D add(Vector2D other) {
return new Vector2D(x + other.x, z + other.z); return new Vector2D(x + other.x, z + other.z);
} }
/** /**
* Adds two points. * Add another vector to this vector and return the result as a new vector.
* *
* @param x * @param x the value to add
* @param z * @param z the value to add
* @return New point * @return a new vector
*/ */
public Vector2D add(double x, double z) { public Vector2D add(double x, double z) {
return new Vector2D(this.x + x, this.z + z); return new Vector2D(this.x + x, this.z + z);
} }
/** /**
* Adds two points. * Add another vector to this vector and return the result as a new vector.
* *
* @param x * @param x the value to add
* @param z * @param z the value to add
* @return New point * @return a new vector
*/ */
public Vector2D add(int x, int z) { public Vector2D add(int x, int z) {
return new Vector2D(this.x + x, this.z + z); return new Vector2D(this.x + x, this.z + z);
} }
/** /**
* Adds points. * Add a list of vectors to this vector and return the
* result as a new vector.
* *
* @param others * @param others an array of vectors
* @return New point * @return a new vector
*/ */
public Vector2D add(Vector2D... others) { public Vector2D add(Vector2D... others) {
double newX = x, newZ = z; double newX = x, newZ = z;
for (int i = 0; i < others.length; ++i) { for (Vector2D other : others) {
newX += others[i].x; newX += other.x;
newZ += others[i].z; newZ += other.z;
} }
return new Vector2D(newX, newZ); return new Vector2D(newX, newZ);
} }
/** /**
* Subtracts two points. * Subtract another vector from this vector and return the result
* as a new vector.
* *
* @param other * @param other the other vector
* @return New point * @return a new vector
*/ */
public Vector2D subtract(Vector2D other) { public Vector2D subtract(Vector2D other) {
return new Vector2D(x - other.x, z - other.z); return new Vector2D(x - other.x, z - other.z);
} }
/** /**
* Subtract two points. * Subtract another vector from this vector and return the result
* as a new vector.
* *
* @param x * @param x the value to subtract
* @param z * @param z the value to subtract
* @return New point * @return a new vector
*/ */
public Vector2D subtract(double x, double z) { public Vector2D subtract(double x, double z) {
return new Vector2D(this.x - x, this.z - z); return new Vector2D(this.x - x, this.z - z);
} }
/** /**
* Subtract two points. * Subtract another vector from this vector and return the result
* as a new vector.
* *
* @param x * @param x the value to subtract
* @param z * @param z the value to subtract
* @return New point * @return a new vector
*/ */
public Vector2D subtract(int x, int z) { public Vector2D subtract(int x, int z) {
return new Vector2D(this.x - x, this.z - z); return new Vector2D(this.x - x, this.z - z);
} }
/** /**
* Subtract points. * Subtract a list of vectors from this vector and return the result
* as a new vector.
* *
* @param others * @param others an array of vectors
* @return New point * @return a new vector
*/ */
public Vector2D subtract(Vector2D... others) { public Vector2D subtract(Vector2D... others) {
double newX = x, newZ = z; double newX = x, newZ = z;
for (int i = 0; i < others.length; ++i) { for (Vector2D other : others) {
newX -= others[i].x; newX -= other.x;
newZ -= others[i].z; newZ -= other.z;
} }
return new Vector2D(newX, newZ); return new Vector2D(newX, newZ);
} }
/** /**
* Component-wise multiplication * Multiply this vector by another vector on each component.
* *
* @param other * @param other the other vector
* @return New point * @return a new vector
*/ */
public Vector2D multiply(Vector2D other) { public Vector2D multiply(Vector2D other) {
return new Vector2D(x * other.x, z * other.z); return new Vector2D(x * other.x, z * other.z);
} }
/** /**
* Component-wise multiplication * Multiply this vector by another vector on each component.
* *
* @param x * @param x the value to multiply
* @param z * @param z the value to multiply
* @return New point * @return a new vector
*/ */
public Vector2D multiply(double x, double z) { public Vector2D multiply(double x, double z) {
return new Vector2D(this.x * x, this.z * z); return new Vector2D(this.x * x, this.z * z);
} }
/** /**
* Component-wise multiplication * Multiply this vector by another vector on each component.
* *
* @param x * @param x the value to multiply
* @param z * @param z the value to multiply
* @return New point * @return a new vector
*/ */
public Vector2D multiply(int x, int z) { public Vector2D multiply(int x, int z) {
return new Vector2D(this.x * x, this.z * z); return new Vector2D(this.x * x, this.z * z);
} }
/** /**
* Component-wise multiplication * Multiply this vector by zero or more vectors on each component.
* *
* @param others * @param others an array of vectors
* @return New point * @return a new vector
*/ */
public Vector2D multiply(Vector2D... others) { public Vector2D multiply(Vector2D... others) {
double newX = x, newZ = z; double newX = x, newZ = z;
for (int i = 0; i < others.length; ++i) { for (Vector2D other : others) {
newX *= others[i].x; newX *= other.x;
newZ *= others[i].z; newZ *= other.z;
} }
return new Vector2D(newX, newZ); return new Vector2D(newX, newZ);
} }
/** /**
* Scalar multiplication. * Perform scalar multiplication and return a new vector.
* *
* @param n * @param n the value to multiply
* @return New point * @return a new vector
*/ */
public Vector2D multiply(double n) { public Vector2D multiply(double n) {
return new Vector2D(this.x * n, this.z * n); return new Vector2D(this.x * n, this.z * n);
} }
/** /**
* Scalar multiplication. * Perform scalar multiplication and return a new vector.
* *
* @param n * @param n the value to multiply
* @return New point * @return a new vector
*/ */
public Vector2D multiply(float n) { public Vector2D multiply(float n) {
return new Vector2D(this.x * n, this.z * n); return new Vector2D(this.x * n, this.z * n);
} }
/** /**
* Scalar multiplication. * Perform scalar multiplication and return a new vector.
* *
* @param n * @param n the value to multiply
* @return New point * @return a new vector
*/ */
public Vector2D multiply(int n) { public Vector2D multiply(int n) {
return new Vector2D(this.x * n, this.z * n); return new Vector2D(this.x * n, this.z * n);
} }
/** /**
* Component-wise division * Divide this vector by another vector on each component.
* *
* @param other * @param other the other vector
* @return New point * @return a new vector
*/ */
public Vector2D divide(Vector2D other) { public Vector2D divide(Vector2D other) {
return new Vector2D(x / other.x, z / other.z); return new Vector2D(x / other.x, z / other.z);
} }
/** /**
* Component-wise division * Divide this vector by another vector on each component.
* *
* @param x * @param x the value to divide by
* @param z * @param z the value to divide by
* @return New point * @return a new vector
*/ */
public Vector2D divide(double x, double z) { public Vector2D divide(double x, double z) {
return new Vector2D(this.x / x, this.z / z); return new Vector2D(this.x / x, this.z / z);
} }
/** /**
* Component-wise division * Divide this vector by another vector on each component.
* *
* @param x * @param x the value to divide by
* @param z * @param z the value to divide by
* @return New point * @return a new vector
*/ */
public Vector2D divide(int x, int z) { public Vector2D divide(int x, int z) {
return new Vector2D(this.x / x, this.z / z); return new Vector2D(this.x / x, this.z / z);
} }
/** /**
* Scalar division. * Perform scalar division and return a new vector.
* *
* @param n * @param n the value to divide by
* @return new point * @return a new vector
*/ */
public Vector2D divide(int n) { public Vector2D divide(int n) {
return new Vector2D(x / n, z / n); return new Vector2D(x / n, z / n);
} }
/** /**
* Scalar division. * Perform scalar division and return a new vector.
* *
* @param n * @param n the value to divide by
* @return new point * @return a new vector
*/ */
public Vector2D divide(double n) { public Vector2D divide(double n) {
return new Vector2D(x / n, z / n); return new Vector2D(x / n, z / n);
} }
/** /**
* Scalar division. * Perform scalar division and return a new vector.
* *
* @param n * @param n the value to divide by
* @return new point * @return a new vector
*/ */
public Vector2D divide(float n) { public Vector2D divide(float n) {
return new Vector2D(x / n, z / n); return new Vector2D(x / n, z / n);
@ -396,40 +415,40 @@ public class Vector2D {
} }
/** /**
* Get the length^2 of the vector. * Get the length, squared, of the vector.
* *
* @return length^2 * @return length, squared
*/ */
public double lengthSq() { public double lengthSq() {
return x * x + z * z; return x * x + z * z;
} }
/** /**
* Get the distance away from a point. * Get the distance between this vector and another vector.
* *
* @param pt * @param other the other vector
* @return distance * @return distance
*/ */
public double distance(Vector2D pt) { public double distance(Vector2D other) {
return Math.sqrt(Math.pow(pt.x - x, 2) + return Math.sqrt(Math.pow(other.x - x, 2) + Math.pow(other.z - z, 2));
Math.pow(pt.z - z, 2));
} }
/** /**
* Get the distance away from a point, squared. * Get the distance between this vector and another vector, squared.
* *
* @param pt * @param other the other vector
* @return distance * @return distance
*/ */
public double distanceSq(Vector2D pt) { public double distanceSq(Vector2D other) {
return Math.pow(pt.x - x, 2) + return Math.pow(other.x - x, 2) +
Math.pow(pt.z - z, 2); Math.pow(other.z - z, 2);
} }
/** /**
* Get the normalized vector. * Get the normalized vector, which is the vector divided by its
* length, as a new vector.
* *
* @return vector * @return a new vector
*/ */
public Vector2D normalize() { public Vector2D normalize() {
return divide(length()); return divide(length());
@ -438,7 +457,7 @@ public class Vector2D {
/** /**
* Gets the dot product of this and another vector. * Gets the dot product of this and another vector.
* *
* @param other * @param other the other vector
* @return the dot product of this and the other vector * @return the dot product of this and the other vector
*/ */
public double dot(Vector2D other) { public double dot(Vector2D other) {
@ -448,9 +467,9 @@ public class Vector2D {
/** /**
* Checks to see if a vector is contained with another. * Checks to see if a vector is contained with another.
* *
* @param min * @param min the minimum point (X, Y, and Z are the lowest)
* @param max * @param max the maximum point (X, Y, and Z are the lowest)
* @return * @return true if the vector is contained
*/ */
public boolean containedWithin(Vector2D min, Vector2D max) { public boolean containedWithin(Vector2D min, Vector2D max) {
return x >= min.x && x <= max.x return x >= min.x && x <= max.x
@ -460,9 +479,9 @@ public class Vector2D {
/** /**
* Checks to see if a vector is contained with another. * Checks to see if a vector is contained with another.
* *
* @param min * @param min the minimum point (X, Y, and Z are the lowest)
* @param max * @param max the maximum point (X, Y, and Z are the lowest)
* @return * @return true if the vector is contained
*/ */
public boolean containedWithinBlock(Vector2D min, Vector2D max) { public boolean containedWithinBlock(Vector2D min, Vector2D max) {
return getBlockX() >= min.getBlockX() && getBlockX() <= max.getBlockX() return getBlockX() >= min.getBlockX() && getBlockX() <= max.getBlockX()
@ -470,9 +489,9 @@ public class Vector2D {
} }
/** /**
* Rounds all components down. * Floors the values of all components.
* *
* @return * @return a new vector
*/ */
public Vector2D floor() { public Vector2D floor() {
return new Vector2D(Math.floor(x), Math.floor(z)); return new Vector2D(Math.floor(x), Math.floor(z));
@ -481,41 +500,43 @@ public class Vector2D {
/** /**
* Rounds all components up. * Rounds all components up.
* *
* @return * @return a new vector
*/ */
public Vector2D ceil() { public Vector2D ceil() {
return new Vector2D(Math.ceil(x), Math.ceil(z)); return new Vector2D(Math.ceil(x), Math.ceil(z));
} }
/** /**
* Rounds all components to the closest integer.<br> * Rounds all components to the closest integer.
*<br>
* Components < 0.5 are rounded down, otherwise up
* *
* @return * <p>Components < 0.5 are rounded down, otherwise up.</p>
*
* @return a new vector
*/ */
public Vector2D round() { public Vector2D round() {
return new Vector2D(Math.floor(x + 0.5), Math.floor(z + 0.5)); return new Vector2D(Math.floor(x + 0.5), Math.floor(z + 0.5));
} }
/** /**
* Returns a vector with the absolute values of the components of this vector. * Returns a vector with the absolute values of the components of
* this vector.
* *
* @return * @return a new vector
*/ */
public Vector2D positive() { public Vector2D positive() {
return new Vector2D(Math.abs(x), Math.abs(z)); return new Vector2D(Math.abs(x), Math.abs(z));
} }
/** /**
* 2D transformation. * Perform a 2D transformation on this vector and return a new one.
* *
* @param angle in degrees * @param angle in degrees
* @param aboutX about which x coordinate to rotate * @param aboutX about which x coordinate to rotate
* @param aboutZ about which z coordinate to rotate * @param aboutZ about which z coordinate to rotate
* @param translateX what to add after rotation * @param translateX what to add after rotation
* @param translateZ what to add after rotation * @param translateZ what to add after rotation
* @return * @return a new vector
* @see AffineTransform another method to transform vectors
*/ */
public Vector2D transform2D(double angle, double aboutX, double aboutZ, double translateX, double translateZ) { public Vector2D transform2D(double angle, double aboutX, double aboutZ, double translateX, double translateZ) {
angle = Math.toRadians(angle); angle = Math.toRadians(angle);
@ -529,6 +550,12 @@ public class Vector2D {
); );
} }
/**
* Returns whether this vector is collinear with another vector.
*
* @param other the other vector
* @return true if collinear
*/
public boolean isCollinearWith(Vector2D other) { public boolean isCollinearWith(Vector2D other) {
if (x == 0 && z == 0) { if (x == 0 && z == 0) {
// this is a zero vector // this is a zero vector
@ -560,20 +587,32 @@ public class Vector2D {
} }
/** /**
* Gets a BlockVector version. * Create a new {@code BlockVector2D} from this vector.
* *
* @return BlockVector * @return a new {@code BlockVector2D}
*/ */
public BlockVector2D toBlockVector2D() { public BlockVector2D toBlockVector2D() {
return new BlockVector2D(this); return new BlockVector2D(this);
} }
/** /**
* Checks if another object is equivalent. * Creates a 3D vector by adding a zero Y component to this vector.
* *
* @param obj * @return a new vector
* @return whether the other object is equivalent
*/ */
public Vector toVector() {
return new Vector(x, 0, z);
}
/**
* Creates a 3D vector by adding the specified Y component to this vector.
*
* @return a new vector
*/
public Vector toVector(double y) {
return new Vector(x, y, z);
}
@Override @Override
public boolean equals(Object obj) { public boolean equals(Object obj) {
if (!(obj instanceof Vector2D)) { if (!(obj instanceof Vector2D)) {
@ -585,50 +624,22 @@ public class Vector2D {
} }
/**
* Gets the hash code.
*
* @return hash code
*/
@Override @Override
public int hashCode() { public int hashCode() {
return ((new Double(x)).hashCode() >> 13) ^ return ((new Double(x)).hashCode() >> 13) ^
(new Double(z)).hashCode(); (new Double(z)).hashCode();
} }
/**
* Returns string representation "(x, y, z)".
*
* @return string
*/
@Override @Override
public String toString() { public String toString() {
return "(" + x + ", " + z + ")"; return "(" + x + ", " + z + ")";
} }
/**
* Creates a 3D vector by adding a zero Y component to this vector.
*
* @return Vector
*/
public Vector toVector() {
return new Vector(x, 0, z);
}
/**
* Creates a 3D vector by adding the specified Y component to this vector.
*
* @return Vector
*/
public Vector toVector(double y) {
return new Vector(x, y, z);
}
/** /**
* Gets the minimum components of two vectors. * Gets the minimum components of two vectors.
* *
* @param v1 * @param v1 the first vector
* @param v2 * @param v2 the second vector
* @return minimum * @return minimum
*/ */
public static Vector2D getMinimum(Vector2D v1, Vector2D v2) { public static Vector2D getMinimum(Vector2D v1, Vector2D v2) {
@ -641,8 +652,8 @@ public class Vector2D {
/** /**
* Gets the maximum components of two vectors. * Gets the maximum components of two vectors.
* *
* @param v1 * @param v1 the first vector
* @param v2 * @param v2 the second vector
* @return maximum * @return maximum
*/ */
public static Vector2D getMaximum(Vector2D v1, Vector2D v2) { public static Vector2D getMaximum(Vector2D v1, Vector2D v2) {
@ -651,4 +662,5 @@ public class Vector2D {
Math.max(v1.z, v2.z) Math.max(v1.z, v2.z)
); );
} }
} }

5
src/main/java/com/sk89q/worldedit/VectorFace.java
View File

@ -19,12 +19,15 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
import com.sk89q.worldedit.util.Direction;
/** /**
* Represents the adjacency of one vector to another. Works similarly to * Represents the adjacency of one vector to another. Works similarly to
* Bukkit's BlockFace class. * Bukkit's BlockFace class.
* *
* @author wizjany * @deprecated to be replaced with {@link Direction}
*/ */
@Deprecated
public enum VectorFace { public enum VectorFace {
NORTH(-1, 0, 0), NORTH(-1, 0, 0),
EAST(0, 0, -1), EAST(0, 0, -1),

26
src/main/java/com/sk89q/worldedit/WorldEdit.java
View File

@ -45,6 +45,10 @@ import com.sk89q.worldedit.scripting.RhinoCraftScriptEngine;
import com.sk89q.worldedit.session.SessionManager; import com.sk89q.worldedit.session.SessionManager;
import com.sk89q.worldedit.session.request.Request; import com.sk89q.worldedit.session.request.Request;
import com.sk89q.worldedit.util.eventbus.EventBus; import com.sk89q.worldedit.util.eventbus.EventBus;
import com.sk89q.worldedit.util.io.file.FileSelectionAbortedException;
import com.sk89q.worldedit.util.io.file.FilenameException;
import com.sk89q.worldedit.util.io.file.FilenameResolutionException;
import com.sk89q.worldedit.util.io.file.InvalidFilenameException;
import com.sk89q.worldedit.util.logging.WorldEditPrefixHandler; import com.sk89q.worldedit.util.logging.WorldEditPrefixHandler;
import com.sk89q.worldedit.world.registry.BundledBlockData; import com.sk89q.worldedit.world.registry.BundledBlockData;
@ -66,16 +70,16 @@ import static com.sk89q.worldedit.event.platform.Interaction.OPEN;
/** /**
* The entry point and container for a working implementation of WorldEdit. * The entry point and container for a working implementation of WorldEdit.
* </p> *
* An instance handles event handling; block, mask, pattern, etc. registration; * <p>An instance handles event handling; block, mask, pattern, etc. registration;
* the management of sessions; the creation of {@link EditSession}s; and more. * the management of sessions; the creation of {@link EditSession}s; and more.
* In order to use WorldEdit, at least one {@link Platform} must be registered * In order to use WorldEdit, at least one {@link Platform} must be registered
* with WorldEdit using {@link PlatformManager#register(Platform)} on the * with WorldEdit using {@link PlatformManager#register(Platform)} on the
* manager retrieved using {@link WorldEdit#getPlatformManager()}. * manager retrieved using {@link WorldEdit#getPlatformManager()}.</p>
* </p> *
* An instance of WorldEdit can be retrieved using the static * <p>An instance of WorldEdit can be retrieved using the static
* method {@link WorldEdit#getInstance()}, which is shared among all * method {@link WorldEdit#getInstance()}, which is shared among all
* platforms within the same classloader hierarchy. * platforms within the same classloader hierarchy.</p>
*/ */
public class WorldEdit { public class WorldEdit {
@ -104,10 +108,10 @@ public class WorldEdit {
/** /**
* Gets the current instance of this class. * Gets the current instance of this class.
* </p> *
* An instance will always be available, but no platform may yet be * <p>An instance will always be available, but no platform may yet be
* registered with WorldEdit, meaning that a number of operations * registered with WorldEdit, meaning that a number of operations
* may fail. However, event handlers can be registered. * may fail. However, event handlers can be registered.</p>
* *
* @return an instance of WorldEdit. * @return an instance of WorldEdit.
*/ */
@ -128,8 +132,8 @@ public class WorldEdit {
/** /**
* Get the event bus for WorldEdit. * Get the event bus for WorldEdit.
* </p> *
* Event handlers can be registered on the event bus. * <p>Event handlers can be registered on the event bus.</p>
* *
* @return the event bus * @return the event bus
*/ */

30
src/main/java/com/sk89q/worldedit/WorldEditNotInstalled.java
View File

@ -1,30 +0,0 @@
/*
* WorldEdit, a Minecraft world manipulation toolkit
* Copyright (C) sk89q <http://www.sk89q.com>
* Copyright (C) WorldEdit team and contributors
*
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by the
* Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
* for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
package com.sk89q.worldedit;
/**
* Raised when WorldEdit is not installed.
*
* @author sk89q
*/
public class WorldEditNotInstalled extends WorldEditException {
private static final long serialVersionUID = -4698408698930848121L;
}

9
src/main/java/com/sk89q/worldedit/WorldEditOperation.java
View File

@ -22,9 +22,12 @@ package com.sk89q.worldedit;
/** /**
* Represents a WorldEdit operation. * Represents a WorldEdit operation.
* *
* @author sk89q * @deprecated This will be removed with no direct replacement. Please use the
* WorldEdit API.
*/ */
@Deprecated
public abstract class WorldEditOperation { public abstract class WorldEditOperation {
public abstract void run(LocalSession session,
LocalPlayer player, EditSession editSession) throws Throwable; public abstract void run(LocalSession session, LocalPlayer player, EditSession editSession) throws Throwable;
} }

7
src/main/java/com/sk89q/worldedit/WorldVector2D.java
View File

@ -19,11 +19,12 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
/**
* @deprecated Use {@link com.sk89q.worldedit.util.Location} wherever possible
*/
@Deprecated
public class WorldVector2D extends Vector2D { public class WorldVector2D extends Vector2D {
/**
* Represents the world.
*/
protected LocalWorld world; protected LocalWorld world;
public WorldVector2D(LocalWorld world) { public WorldVector2D(LocalWorld world) {

7
src/main/java/com/sk89q/worldedit/WorldVectorFace.java
View File

@ -20,12 +20,11 @@
package com.sk89q.worldedit; package com.sk89q.worldedit;
/** /**
* A WorldVector that emphasizes one side of the block * @deprecated Use {@link com.sk89q.worldedit.util.Location} wherever possible
*/ */
@Deprecated
public class WorldVectorFace extends WorldVector { public class WorldVectorFace extends WorldVector {
/**
* Represents the side.
*/
private VectorFace face; private VectorFace face;
/** /**

2
src/main/java/com/sk89q/worldedit/MobType.java → src/main/java/com/sk89q/worldedit/blocks/metadata/MobType.java
View File

@ -17,7 +17,7 @@
* along with this program. If not, see <http://www.gnu.org/licenses/>. * along with this program. If not, see <http://www.gnu.org/licenses/>.
*/ */
package com.sk89q.worldedit; package com.sk89q.worldedit.blocks.metadata;
/** /**
* Represents the possible types of mobs. * Represents the possible types of mobs.

4
src/main/java/com/sk89q/worldedit/command/SchematicCommands.java
View File

@ -24,8 +24,8 @@ import com.sk89q.minecraft.util.commands.CommandContext;
import com.sk89q.minecraft.util.commands.CommandException; import com.sk89q.minecraft.util.commands.CommandException;
import com.sk89q.minecraft.util.commands.CommandPermissions; import com.sk89q.minecraft.util.commands.CommandPermissions;
import com.sk89q.worldedit.EditSession; import com.sk89q.worldedit.EditSession;
import com.sk89q.worldedit.FilenameException; import com.sk89q.worldedit.util.io.file.FilenameException;
import com.sk89q.worldedit.FilenameResolutionException; import com.sk89q.worldedit.util.io.file.FilenameResolutionException;
import com.sk89q.worldedit.LocalConfiguration; import com.sk89q.worldedit.LocalConfiguration;
import com.sk89q.worldedit.LocalSession; import com.sk89q.worldedit.LocalSession;
import com.sk89q.worldedit.WorldEdit; import com.sk89q.worldedit.WorldEdit;

4
src/main/java/com/sk89q/worldedit/InvalidToolBindException.java → src/main/java/com/sk89q/worldedit/command/tool/InvalidToolBindException.java
View File

@ -17,7 +17,9 @@
* along with this program. If not, see <http://www.gnu.org/licenses/>. * along with this program. If not, see <http://www.gnu.org/licenses/>.
*/ */
package com.sk89q.worldedit; package com.sk89q.worldedit.command.tool;
import com.sk89q.worldedit.WorldEditException;
public class InvalidToolBindException extends WorldEditException { public class InvalidToolBindException extends WorldEditException {
private static final long serialVersionUID = -1865311004052447699L; private static final long serialVersionUID = -1865311004052447699L;

1
src/main/java/com/sk89q/worldedit/extension/factory/DefaultBlockParser.java
View File

@ -21,6 +21,7 @@ package com.sk89q.worldedit.extension.factory;
import com.sk89q.worldedit.*; import com.sk89q.worldedit.*;
import com.sk89q.worldedit.blocks.*; import com.sk89q.worldedit.blocks.*;
import com.sk89q.worldedit.blocks.metadata.MobType;
import com.sk89q.worldedit.entity.Player; import com.sk89q.worldedit.entity.Player;
import com.sk89q.worldedit.extension.input.DisallowedUsageException; import com.sk89q.worldedit.extension.input.DisallowedUsageException;
import com.sk89q.worldedit.extension.input.InputParseException; import com.sk89q.worldedit.extension.input.InputParseException;

9
src/main/java/com/sk89q/worldedit/internal/command/WorldEditExceptionConverter.java
View File

@ -23,10 +23,14 @@ import com.sk89q.minecraft.util.commands.CommandException;
import com.sk89q.worldedit.*; import com.sk89q.worldedit.*;
import com.sk89q.worldedit.blocks.ItemType; import com.sk89q.worldedit.blocks.ItemType;
import com.sk89q.worldedit.command.InsufficientArgumentsException; import com.sk89q.worldedit.command.InsufficientArgumentsException;
import com.sk89q.worldedit.command.tool.InvalidToolBindException;
import com.sk89q.worldedit.internal.expression.ExpressionException; import com.sk89q.worldedit.internal.expression.ExpressionException;
import com.sk89q.worldedit.regions.RegionOperationException; import com.sk89q.worldedit.regions.RegionOperationException;
import com.sk89q.worldedit.util.command.parametric.ExceptionConverterHelper; import com.sk89q.worldedit.util.command.parametric.ExceptionConverterHelper;
import com.sk89q.worldedit.util.command.parametric.ExceptionMatch; import com.sk89q.worldedit.util.command.parametric.ExceptionMatch;
import com.sk89q.worldedit.util.io.file.FileSelectionAbortedException;
import com.sk89q.worldedit.util.io.file.FilenameResolutionException;
import com.sk89q.worldedit.util.io.file.InvalidFilenameException;
import java.util.regex.Matcher; import java.util.regex.Matcher;
import java.util.regex.Pattern; import java.util.regex.Pattern;
@ -46,11 +50,6 @@ public class WorldEditExceptionConverter extends ExceptionConverterHelper {
this.worldEdit = worldEdit; this.worldEdit = worldEdit;
} }
@ExceptionMatch
public void convert(PlayerNeededException e) throws CommandException {
throw new CommandException(e.getMessage());
}
@ExceptionMatch @ExceptionMatch
public void convert(NumberFormatException e) throws CommandException { public void convert(NumberFormatException e) throws CommandException {
final Matcher matcher = numberFormat.matcher(e.getMessage()); final Matcher matcher = numberFormat.matcher(e.getMessage());

1
src/main/java/com/sk89q/worldedit/scripting/CraftScriptContext.java
View File

@ -25,6 +25,7 @@ import com.sk89q.worldedit.command.InsufficientArgumentsException;
import com.sk89q.worldedit.entity.Player; import com.sk89q.worldedit.entity.Player;
import com.sk89q.worldedit.extension.platform.Platform; import com.sk89q.worldedit.extension.platform.Platform;
import com.sk89q.worldedit.patterns.Pattern; import com.sk89q.worldedit.patterns.Pattern;
import com.sk89q.worldedit.util.io.file.FilenameException;
import java.io.File; import java.io.File;
import java.util.ArrayList; import java.util.ArrayList;

2
src/main/java/com/sk89q/worldedit/FileSelectionAbortedException.java → src/main/java/com/sk89q/worldedit/util/io/file/FileSelectionAbortedException.java
View File

@ -17,7 +17,7 @@
* along with this program. If not, see <http://www.gnu.org/licenses/>. * along with this program. If not, see <http://www.gnu.org/licenses/>.
*/ */
package com.sk89q.worldedit; package com.sk89q.worldedit.util.io.file;
public class FileSelectionAbortedException extends FilenameException { public class FileSelectionAbortedException extends FilenameException {
private static final long serialVersionUID = 7377072269988014886L; private static final long serialVersionUID = 7377072269988014886L;

4
src/main/java/com/sk89q/worldedit/FilenameException.java → src/main/java/com/sk89q/worldedit/util/io/file/FilenameException.java
View File

@ -17,7 +17,9 @@
* along with this program. If not, see <http://www.gnu.org/licenses/>. * along with this program. If not, see <http://www.gnu.org/licenses/>.
*/ */
package com.sk89q.worldedit; package com.sk89q.worldedit.util.io.file;
import com.sk89q.worldedit.WorldEditException;
public class FilenameException extends WorldEditException { public class FilenameException extends WorldEditException {
private static final long serialVersionUID = 6072601657326106265L; private static final long serialVersionUID = 6072601657326106265L;

2
src/main/java/com/sk89q/worldedit/FilenameResolutionException.java → src/main/java/com/sk89q/worldedit/util/io/file/FilenameResolutionException.java
View File

@ -17,7 +17,7 @@
* along with this program. If not, see <http://www.gnu.org/licenses/>. * along with this program. If not, see <http://www.gnu.org/licenses/>.
*/ */
package com.sk89q.worldedit; package com.sk89q.worldedit.util.io.file;
public class FilenameResolutionException extends FilenameException { public class FilenameResolutionException extends FilenameException {
private static final long serialVersionUID = 4673670296313383121L; private static final long serialVersionUID = 4673670296313383121L;

2
src/main/java/com/sk89q/worldedit/InvalidFilenameException.java → src/main/java/com/sk89q/worldedit/util/io/file/InvalidFilenameException.java
View File

@ -17,7 +17,7 @@
* along with this program. If not, see <http://www.gnu.org/licenses/>. * along with this program. If not, see <http://www.gnu.org/licenses/>.
*/ */
package com.sk89q.worldedit; package com.sk89q.worldedit.util.io.file;
public class InvalidFilenameException extends FilenameException { public class InvalidFilenameException extends FilenameException {
private static final long serialVersionUID = 7377072269988014886L; private static final long serialVersionUID = 7377072269988014886L;