/* * Jexer - Java Text User Interface * * The MIT License (MIT) * * Copyright (C) 2017 Kevin Lamonte * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), * to deal in the Software without restriction, including without limitation * the rights to use, copy, modify, merge, publish, distribute, sublicense, * and/or sell copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * DEALINGS IN THE SOFTWARE. * * @author Kevin Lamonte [kevin.lamonte@gmail.com] * @version 1 */ package jexer.teditor; import java.util.ArrayList; import java.util.List; import jexer.bits.Cell; import jexer.bits.CellAttributes; /** * A Line represents a single line of text on the screen. Each character is * a Cell, so it can have color attributes in addition to the basic char. */ public class Line implements Fragment { /** * The cells of the line. */ private List cells; /** * The line number. */ private int lineNumber; /** * The previous Fragment in the list. */ private Fragment prevFrag; /** * The next Fragment in the list. */ private Fragment nextFrag; /** * Construct a new Line from an existing text string. */ public Line() { this(""); } /** * Construct a new Line from an existing text string. * * @param text the code points of the line */ public Line(final String text) { cells = new ArrayList(text.length()); for (int i = 0; i < text.length(); i++) { cells.add(new Cell(text.charAt(i))); } } /** * Reset all colors of this Line to white-on-black. */ public void resetColors() { setColors(new CellAttributes()); } /** * Set all colors of this Line to one color. * * @param color the new color to use */ public void setColors(final CellAttributes color) { for (Cell cell: cells) { cell.setTo(color); } } /** * Set the color of one cell. * * @param index a cell number, between 0 and getCellCount() * @param color the new color to use * @throws IndexOutOfBoundsException if index is negative or not less * than getCellCount() */ public void setColor(final int index, final CellAttributes color) { cells.get(index).setTo(color); } /** * Get the raw text that will be rendered. * * @return the text */ public String getText() { char [] text = new char[cells.size()]; for (int i = 0; i < cells.size(); i++) { text[i] = cells.get(i).getChar(); } return new String(text); } /** * Get the attributes for a cell. * * @param index a cell number, between 0 and getCellCount() * @return the attributes * @throws IndexOutOfBoundsException if index is negative or not less * than getCellCount() */ public CellAttributes getColor(final int index) { return cells.get(index); } /** * Get the number of graphical cells represented by this text. Note that * a Unicode grapheme cluster can take any number of pixels, but this * editor is intended to be used with a fixed-width font. So this count * returns the number of fixed-width cells, NOT the number of grapheme * clusters. * * @return the number of fixed-width cells this fragment's text will * render to */ public int getCellCount() { return cells.size(); } /** * Get the text to render for a specific fixed-width cell. * * @param index a cell number, between 0 and getCellCount() * @return the codepoints to render for this fixed-width cell * @throws IndexOutOfBoundsException if index is negative or not less * than getCellCount() */ public Cell getCell(final int index) { return cells.get(index); } /** * Get the text to render for several fixed-width cells. * * @param start a cell number, between 0 and getCellCount() * @param length the number of cells to return * @return the codepoints to render for this fixed-width cell * @throws IndexOutOfBoundsException if start or (start + length) is * negative or not less than getCellCount() */ public String getCells(final int start, final int length) { char [] text = new char[length]; for (int i = 0; i < length; i++) { text[i] = cells.get(i + start).getChar(); } return new String(text); } /** * Sets (replaces) the text to render for a specific fixed-width cell. * * @param index a cell number, between 0 and getCellCount() * @param ch the character for this fixed-width cell * @throws IndexOutOfBoundsException if index is negative or not less * than getCellCount() */ public void setCell(final int index, final char ch) { cells.set(index, new Cell(ch)); } /** * Sets (replaces) the text to render for a specific fixed-width cell. * * @param index a cell number, between 0 and getCellCount() * @param cell the new value for this fixed-width cell * @throws IndexOutOfBoundsException if index is negative or not less * than getCellCount() */ public void setCell(final int index, final Cell cell) { cells.set(index, cell); } /** * Inserts a char to render for a specific fixed-width cell. * * @param index a cell number, between 0 and getCellCount() - 1 * @param ch the character for this fixed-width cell * @throws IndexOutOfBoundsException if index is negative or not less * than getCellCount() */ public void insertCell(final int index, final char ch) { cells.add(index, new Cell(ch)); } /** * Inserts a Cell to render for a specific fixed-width cell. * * @param index a cell number, between 0 and getCellCount() - 1 * @param cell the new value for this fixed-width cell * @throws IndexOutOfBoundsException if index is negative or not less * than getCellCount() */ public void insertCell(final int index, final Cell cell) { cells.add(index, cell); } /** * Delete a specific fixed-width cell. * * @param index a cell number, between 0 and getCellCount() - 1 * @throws IndexOutOfBoundsException if index is negative or not less * than getCellCount() */ public void deleteCell(final int index) { cells.remove(index); } /** * Delete several fixed-width cells. * * @param start a cell number, between 0 and getCellCount() - 1 * @param length the number of cells to delete * @throws IndexOutOfBoundsException if index is negative or not less * than getCellCount() */ public void deleteCells(final int start, final int length) { for (int i = 0; i < length; i++) { cells.remove(start); } } /** * Appends a char to render for a specific fixed-width cell. * * @param ch the character for this fixed-width cell */ public void appendCell(final char ch) { cells.add(new Cell(ch)); } /** * Inserts a Cell to render for a specific fixed-width cell. * * @param cell the new value for this fixed-width cell */ public void appendCell(final Cell cell) { cells.add(cell); } /** * Get the next Fragment in the list, or null if this Fragment is the * last node. * * @return the next Fragment, or null */ public Fragment next() { return nextFrag; } /** * Get the previous Fragment in the list, or null if this Fragment is the * first node. * * @return the previous Fragment, or null */ public Fragment prev() { return prevFrag; } /** * See if this Fragment can be joined with the next Fragment in list. * * @return true if the join was possible, false otherwise */ public boolean isNextJoinable() { if ((nextFrag != null) && (nextFrag instanceof Line)) { return true; } return false; } /** * Join this Fragment with the next Fragment in list. * * @return true if the join was successful, false otherwise */ public boolean joinNext() { if ((nextFrag == null) || !(nextFrag instanceof Line)) { return false; } Line q = (Line) nextFrag; ArrayList newCells = new ArrayList(this.cells.size() + q.cells.size()); newCells.addAll(this.cells); newCells.addAll(q.cells); this.cells = newCells; ((Line) q.nextFrag).prevFrag = this; nextFrag = q.nextFrag; return true; } /** * See if this Fragment can be joined with the previous Fragment in list. * * @return true if the join was possible, false otherwise */ public boolean isPrevJoinable() { if ((prevFrag != null) && (prevFrag instanceof Line)) { return true; } return false; } /** * Join this Fragment with the previous Fragment in list. * * @return true if the join was successful, false otherwise */ public boolean joinPrev() { if ((prevFrag == null) || !(prevFrag instanceof Line)) { return false; } Line p = (Line) prevFrag; ArrayList newCells = new ArrayList(this.cells.size() + p.cells.size()); newCells.addAll(p.cells); newCells.addAll(this.cells); this.cells = newCells; ((Line) p.prevFrag).nextFrag = this; prevFrag = p.prevFrag; return true; } /** * Set the next Fragment in the list. Note that this performs no sanity * checking or modifications on fragment; this function can break * connectivity in the list. * * @param fragment the next Fragment, or null */ public void setNext(Fragment fragment) { nextFrag = fragment; } /** * Set the previous Fragment in the list. Note that this performs no * sanity checking or modifications on fragment; this function can break * connectivity in the list. * * @param fragment the previous Fragment, or null */ public void setPrev(Fragment fragment) { prevFrag = fragment; } /** * Split this Fragment into two. 'this' Fragment will contain length * cells, 'this.next()' will contain (getCellCount() - length) cells. * * @param length the number of cells to leave in this Fragment * @throws IndexOutOfBoundsException if length is negative, or 0, greater * than (getCellCount() - 1) */ public void split(final int length) { // Create the next node Line q = new Line(); q.nextFrag = nextFrag; q.prevFrag = this; ((Line) nextFrag).prevFrag = q; nextFrag = q; // Split cells q.cells = new ArrayList(cells.size() - length); q.cells.addAll(cells.subList(length, cells.size())); cells = cells.subList(0, length); } /** * Insert a new Fragment at a position, splitting the contents of this * Fragment into two around it. 'this' Fragment will contain the cells * between 0 and index, 'this.next()' will be the inserted fragment, and * 'this.next().next()' will contain the cells between 'index' and * getCellCount() - 1. * * @param index the number of cells to leave in this Fragment * @param fragment the Fragment to insert * @throws IndexOutOfBoundsException if length is negative, or 0, greater * than (getCellCount() - 1) */ public void split(final int index, Fragment fragment) { // Create the next node and insert into the list. Line q = new Line(); q.nextFrag = nextFrag; q.nextFrag.setPrev(q); q.prevFrag = fragment; fragment.setNext(q); fragment.setPrev(this); nextFrag = fragment; // Split cells q.cells = new ArrayList(cells.size() - index); q.cells.addAll(cells.subList(index, cells.size())); cells = cells.subList(0, index); } /** * Insert a new Fragment before this one. * * @param fragment the Fragment to insert */ public void insert(Fragment fragment) { fragment.setNext(this); fragment.setPrev(prevFrag); prevFrag.setNext(fragment); prevFrag = fragment; } /** * Append a new Fragment at the end of this one. * * @param fragment the Fragment to append */ public void append(Fragment fragment) { fragment.setNext(nextFrag); fragment.setPrev(this); nextFrag.setPrev(fragment); nextFrag = fragment; } /** * Delete this Fragment from the list, and return its next(). * * @return this Fragment's next(), or null if it was at the end of the * list */ public Fragment deleteGetNext() { Fragment result = nextFrag; nextFrag.setPrev(prevFrag); prevFrag.setNext(nextFrag); prevFrag = null; nextFrag = null; return result; } /** * Delete this Fragment from the list, and return its prev(). * * @return this Fragment's next(), or null if it was at the beginning of * the list */ public Fragment deleteGetPrev() { Fragment result = prevFrag; nextFrag.setPrev(prevFrag); prevFrag.setNext(nextFrag); prevFrag = null; nextFrag = null; return result; } /** * Get the anchor position. * * @return the anchor number */ public int getAnchor() { return lineNumber; } /** * Set the anchor position. * * @param x the new anchor number */ public void setAnchor(final int x) { lineNumber = x; } }