Minimal CutoffResult Javadocs

This commit is contained in:
Brady 2018-10-08 23:34:12 -05:00
parent 875f01c358
commit 2e69bbe371
No known key found for this signature in database
GPG Key ID: 73A788379A197567

View File

@ -18,13 +18,21 @@
package baritone.api.pathing.path; package baritone.api.pathing.path;
/** /**
* The result of a path cut-off operation.
*
* @author Brady * @author Brady
* @since 10/8/2018 * @since 10/8/2018
*/ */
public final class CutoffResult { public final class CutoffResult {
/**
* The resulting path
*/
private final IPath path; private final IPath path;
/**
* The amount of movements that were removed
*/
private final int removed; private final int removed;
private CutoffResult(IPath path, int removed) { private CutoffResult(IPath path, int removed) {
@ -32,22 +40,44 @@ public final class CutoffResult {
this.removed = removed; this.removed = removed;
} }
/**
* @return Whether or not the path was cut
*/
public final boolean wasCut() { public final boolean wasCut() {
return this.removed > 0; return this.removed > 0;
} }
/**
* @return The amount of movements that were removed
*/
public final int getRemoved() { public final int getRemoved() {
return this.removed; return this.removed;
} }
/**
* @return The resulting path
*/
public final IPath getPath() { public final IPath getPath() {
return this.path; return this.path;
} }
/**
* Creates a new result from a successful cut-off operation.
*
* @param path The input path
* @param index The index to cut the path at
* @return The result of the operation
*/
public static CutoffResult cutoffPath(IPath path, int index) { public static CutoffResult cutoffPath(IPath path, int index) {
return new CutoffResult(new CutoffPath(path, index), path.positions().size() - index - 1); return new CutoffResult(new CutoffPath(path, index), path.positions().size() - index - 1);
} }
/**
* Creates a new result in which no cut-off occurred.
*
* @param path The input path
* @return The result of the operation
*/
public static CutoffResult preservePath(IPath path) { public static CutoffResult preservePath(IPath path) {
return new CutoffResult(path, 0); return new CutoffResult(path, 0);
} }