X-Git-Url: http://git.nikiroo.be/?p=jvcard.git;a=blobdiff_plain;f=src%2Fcom%2Fgooglecode%2Flanterna%2FTerminalPosition.java;fp=src%2Fcom%2Fgooglecode%2Flanterna%2FTerminalPosition.java;h=0000000000000000000000000000000000000000;hp=3dd5813f96888262cd3e1e79db4ed14d4eb20205;hb=f06c81000632cfb5f525ca458f719338f55f9f66;hpb=a73a906356c971b080c36368e71a15d87e8b8d31 diff --git a/src/com/googlecode/lanterna/TerminalPosition.java b/src/com/googlecode/lanterna/TerminalPosition.java deleted file mode 100644 index 3dd5813..0000000 --- a/src/com/googlecode/lanterna/TerminalPosition.java +++ /dev/null @@ -1,177 +0,0 @@ -/* - * This file is part of lanterna (http://code.google.com/p/lanterna/). - * - * lanterna 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 . - * - * Copyright (C) 2010-2015 Martin - */ -package com.googlecode.lanterna; - -/** - * A 2-d position in 'terminal space'. Please note that the coordinates are 0-indexed, meaning 0x0 is the top left - * corner of the terminal. This object is immutable so you cannot change it after it has been created. Instead, you - * can easily create modified 'clones' by using the 'with' methods. - * - * @author Martin - */ -public class TerminalPosition { - - /** - * Constant for the top-left corner (0x0) - */ - public static final TerminalPosition TOP_LEFT_CORNER = new TerminalPosition(0, 0); - /** - * Constant for the 1x1 position (one offset in both directions from top-left) - */ - public static final TerminalPosition OFFSET_1x1 = new TerminalPosition(1, 1); - - private final int row; - private final int column; - - /** - * Creates a new TerminalPosition object, which represents a location on the screen. There is no check to verify - * that the position you specified is within the size of the current terminal and you can specify negative positions - * as well. - * - * @param column Column of the location, or the "x" coordinate, zero indexed (the first column is 0) - * @param row Row of the location, or the "y" coordinate, zero indexed (the first row is 0) - */ - public TerminalPosition(int column, int row) { - this.row = row; - this.column = column; - } - - /** - * Returns the index of the column this position is representing, zero indexed (the first column has index 0). - * @return Index of the column this position has - */ - public int getColumn() { - return column; - } - - /** - * Returns the index of the row this position is representing, zero indexed (the first row has index 0) - * @return Index of the row this position has - */ - public int getRow() { - return row; - } - - /** - * Creates a new TerminalPosition object representing a position with the same column index as this but with a - * supplied row index. - * @param row Index of the row for the new position - * @return A TerminalPosition object with the same column as this but with a specified row index - */ - public TerminalPosition withRow(int row) { - if(row == 0 && this.column == 0) { - return TOP_LEFT_CORNER; - } - return new TerminalPosition(this.column, row); - } - - /** - * Creates a new TerminalPosition object representing a position with the same row index as this but with a - * supplied column index. - * @param column Index of the column for the new position - * @return A TerminalPosition object with the same row as this but with a specified column index - */ - public TerminalPosition withColumn(int column) { - if(column == 0 && this.row == 0) { - return TOP_LEFT_CORNER; - } - return new TerminalPosition(column, this.row); - } - - /** - * Creates a new TerminalPosition object representing a position on the same row, but with a column offset by a - * supplied value. Calling this method with delta 0 will return this, calling it with a positive delta will return - * a terminal position delta number of columns to the right and for negative numbers the same to the left. - * @param delta Column offset - * @return New terminal position based off this one but with an applied offset - */ - public TerminalPosition withRelativeColumn(int delta) { - if(delta == 0) { - return this; - } - return withColumn(column + delta); - } - - /** - * Creates a new TerminalPosition object representing a position on the same column, but with a row offset by a - * supplied value. Calling this method with delta 0 will return this, calling it with a positive delta will return - * a terminal position delta number of rows to the down and for negative numbers the same up. - * @param delta Row offset - * @return New terminal position based off this one but with an applied offset - */ - public TerminalPosition withRelativeRow(int delta) { - if(delta == 0) { - return this; - } - return withRow(row + delta); - } - - /** - * Creates a new TerminalPosition object that is 'translated' by an amount of rows and columns specified by another - * TerminalPosition. Same as calling - * withRelativeRow(translate.getRow()).withRelativeColumn(translate.getColumn()) - * @param translate How many columns and rows to translate - * @return New TerminalPosition that is the result of the original with added translation - */ - public TerminalPosition withRelative(TerminalPosition translate) { - return withRelative(translate.getColumn(), translate.getRow()); - } - - /** - * Creates a new TerminalPosition object that is 'translated' by an amount of rows and columns specified by the two - * parameters. Same as calling - * withRelativeRow(deltaRow).withRelativeColumn(deltaColumn) - * @param deltaColumn How many columns to move from the current position in the new TerminalPosition - * @param deltaRow How many rows to move from the current position in the new TerminalPosition - * @return New TerminalPosition that is the result of the original position with added translation - */ - public TerminalPosition withRelative(int deltaColumn, int deltaRow) { - return withRelativeRow(deltaRow).withRelativeColumn(deltaColumn); - } - - @Override - public String toString() { - return "[" + column + ":" + row + "]"; - } - - @Override - public int hashCode() { - int hash = 3; - hash = 23 * hash + this.row; - hash = 23 * hash + this.column; - return hash; - } - - public boolean equals(int columnIndex, int rowIndex) { - return this.column == columnIndex && - this.row == rowIndex; - } - - @Override - public boolean equals(Object obj) { - if (obj == null) { - return false; - } - if (getClass() != obj.getClass()) { - return false; - } - final TerminalPosition other = (TerminalPosition) obj; - return this.row == other.row && this.column == other.column; - } -}