2 * Jexer - Java Text User Interface
4 * The MIT License (MIT)
6 * Copyright (C) 2017 Kevin Lamonte
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the "Software"),
10 * to deal in the Software without restriction, including without limitation
11 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12 * and/or sell copies of the Software, and to permit persons to whom the
13 * Software is furnished to do so, subject to the following conditions:
15 * The above copyright notice and this permission notice shall be included in
16 * all copies or substantial portions of the Software.
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
23 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
24 * DEALINGS IN THE SOFTWARE.
26 * @author Kevin Lamonte [kevin.lamonte@gmail.com]
31 import java
.awt
.Color
;
32 import java
.awt
.Cursor
;
34 import java
.awt
.FontMetrics
;
35 import java
.awt
.Graphics
;
36 import java
.awt
.Graphics2D
;
37 import java
.awt
.Insets
;
38 import java
.awt
.Point
;
39 import java
.awt
.Rectangle
;
40 import java
.awt
.Toolkit
;
41 import java
.awt
.geom
.Rectangle2D
;
42 import java
.awt
.image
.BufferedImage
;
43 import java
.awt
.image
.BufferStrategy
;
44 import java
.io
.InputStream
;
45 import java
.util
.Date
;
46 import java
.util
.HashMap
;
47 import javax
.swing
.JFrame
;
48 import javax
.swing
.SwingUtilities
;
50 import jexer
.bits
.Cell
;
51 import jexer
.bits
.CellAttributes
;
52 import jexer
.session
.SwingSessionInfo
;
55 * This Screen implementation draws to a Java Swing JFrame.
57 public final class SwingScreen
extends Screen
{
60 * If true, use triple buffering thread.
62 private static boolean tripleBuffer
= true;
65 * Cursor style to draw.
67 public enum CursorStyle
{
69 * Use an underscore for the cursor.
74 * Use a solid block for the cursor.
79 * Use an outlined block for the cursor.
84 private static Color MYBLACK
;
85 private static Color MYRED
;
86 private static Color MYGREEN
;
87 private static Color MYYELLOW
;
88 private static Color MYBLUE
;
89 private static Color MYMAGENTA
;
90 private static Color MYCYAN
;
91 private static Color MYWHITE
;
93 private static Color MYBOLD_BLACK
;
94 private static Color MYBOLD_RED
;
95 private static Color MYBOLD_GREEN
;
96 private static Color MYBOLD_YELLOW
;
97 private static Color MYBOLD_BLUE
;
98 private static Color MYBOLD_MAGENTA
;
99 private static Color MYBOLD_CYAN
;
100 private static Color MYBOLD_WHITE
;
102 private static boolean dosColors
= false;
105 * Setup Swing colors to match DOS color palette.
107 private static void setDOSColors() {
111 MYBLACK
= new Color(0x00, 0x00, 0x00);
112 MYRED
= new Color(0xa8, 0x00, 0x00);
113 MYGREEN
= new Color(0x00, 0xa8, 0x00);
114 MYYELLOW
= new Color(0xa8, 0x54, 0x00);
115 MYBLUE
= new Color(0x00, 0x00, 0xa8);
116 MYMAGENTA
= new Color(0xa8, 0x00, 0xa8);
117 MYCYAN
= new Color(0x00, 0xa8, 0xa8);
118 MYWHITE
= new Color(0xa8, 0xa8, 0xa8);
119 MYBOLD_BLACK
= new Color(0x54, 0x54, 0x54);
120 MYBOLD_RED
= new Color(0xfc, 0x54, 0x54);
121 MYBOLD_GREEN
= new Color(0x54, 0xfc, 0x54);
122 MYBOLD_YELLOW
= new Color(0xfc, 0xfc, 0x54);
123 MYBOLD_BLUE
= new Color(0x54, 0x54, 0xfc);
124 MYBOLD_MAGENTA
= new Color(0xfc, 0x54, 0xfc);
125 MYBOLD_CYAN
= new Color(0x54, 0xfc, 0xfc);
126 MYBOLD_WHITE
= new Color(0xfc, 0xfc, 0xfc);
132 * SwingFrame is our top-level hook into the Swing system.
134 class SwingFrame
extends JFrame
{
137 * Serializable version.
139 private static final long serialVersionUID
= 1;
142 * The terminus font resource filename.
144 private static final String FONTFILE
= "terminus-ttf-4.39/TerminusTTF-Bold-4.39.ttf";
147 * The BufferStrategy object needed for triple-buffering.
149 private BufferStrategy bufferStrategy
;
152 * A cache of previously-rendered glyphs for blinking text, when it
155 private HashMap
<Cell
, BufferedImage
> glyphCacheBlink
;
158 * A cache of previously-rendered glyphs for non-blinking, or
159 * blinking-and-visible, text.
161 private HashMap
<Cell
, BufferedImage
> glyphCache
;
164 * The TUI Screen data.
169 * If true, we were successful getting Terminus.
171 private boolean gotTerminus
= false;
174 * Width of a character cell.
176 private int textWidth
= 1;
179 * Height of a character cell.
181 private int textHeight
= 1;
184 * Descent of a character cell.
186 private int maxDescent
= 0;
189 * System-dependent Y adjustment for text in the character cell.
191 private int textAdjustY
= 0;
194 * System-dependent X adjustment for text in the character cell.
196 private int textAdjustX
= 0;
199 * Top pixel absolute location.
201 private int top
= 30;
204 * Left pixel absolute location.
206 private int left
= 30;
209 * The cursor style to draw.
211 private CursorStyle cursorStyle
= CursorStyle
.UNDERLINE
;
214 * The number of millis to wait before switching the blink from
215 * visible to invisible.
217 private long blinkMillis
= 500;
220 * If true, the cursor should be visible right now based on the blink
223 private boolean cursorBlinkVisible
= true;
226 * The time that the blink last flipped from visible to invisible or
227 * from invisible to visible.
229 private long lastBlinkTime
= 0;
232 * Convert a CellAttributes foreground color to an Swing Color.
234 * @param attr the text attributes
235 * @return the Swing Color
237 private Color
attrToForegroundColor(final CellAttributes attr
) {
239 if (attr
.getForeColor().equals(jexer
.bits
.Color
.BLACK
)) {
241 } else if (attr
.getForeColor().equals(jexer
.bits
.Color
.RED
)) {
243 } else if (attr
.getForeColor().equals(jexer
.bits
.Color
.BLUE
)) {
245 } else if (attr
.getForeColor().equals(jexer
.bits
.Color
.GREEN
)) {
247 } else if (attr
.getForeColor().equals(jexer
.bits
.Color
.YELLOW
)) {
248 return MYBOLD_YELLOW
;
249 } else if (attr
.getForeColor().equals(jexer
.bits
.Color
.CYAN
)) {
251 } else if (attr
.getForeColor().equals(jexer
.bits
.Color
.MAGENTA
)) {
252 return MYBOLD_MAGENTA
;
253 } else if (attr
.getForeColor().equals(jexer
.bits
.Color
.WHITE
)) {
257 if (attr
.getForeColor().equals(jexer
.bits
.Color
.BLACK
)) {
259 } else if (attr
.getForeColor().equals(jexer
.bits
.Color
.RED
)) {
261 } else if (attr
.getForeColor().equals(jexer
.bits
.Color
.BLUE
)) {
263 } else if (attr
.getForeColor().equals(jexer
.bits
.Color
.GREEN
)) {
265 } else if (attr
.getForeColor().equals(jexer
.bits
.Color
.YELLOW
)) {
267 } else if (attr
.getForeColor().equals(jexer
.bits
.Color
.CYAN
)) {
269 } else if (attr
.getForeColor().equals(jexer
.bits
.Color
.MAGENTA
)) {
271 } else if (attr
.getForeColor().equals(jexer
.bits
.Color
.WHITE
)) {
275 throw new IllegalArgumentException("Invalid color: " +
276 attr
.getForeColor().getValue());
280 * Convert a CellAttributes background color to an Swing Color.
282 * @param attr the text attributes
283 * @return the Swing Color
285 private Color
attrToBackgroundColor(final CellAttributes attr
) {
286 if (attr
.getBackColor().equals(jexer
.bits
.Color
.BLACK
)) {
288 } else if (attr
.getBackColor().equals(jexer
.bits
.Color
.RED
)) {
290 } else if (attr
.getBackColor().equals(jexer
.bits
.Color
.BLUE
)) {
292 } else if (attr
.getBackColor().equals(jexer
.bits
.Color
.GREEN
)) {
294 } else if (attr
.getBackColor().equals(jexer
.bits
.Color
.YELLOW
)) {
296 } else if (attr
.getBackColor().equals(jexer
.bits
.Color
.CYAN
)) {
298 } else if (attr
.getBackColor().equals(jexer
.bits
.Color
.MAGENTA
)) {
300 } else if (attr
.getBackColor().equals(jexer
.bits
.Color
.WHITE
)) {
303 throw new IllegalArgumentException("Invalid color: " +
304 attr
.getBackColor().getValue());
308 * Public constructor.
310 * @param screen the Screen that Backend talks to
312 public SwingFrame(final SwingScreen screen
) {
313 this.screen
= screen
;
316 // Figure out my cursor style
317 String cursorStyleString
= System
.getProperty(
318 "jexer.Swing.cursorStyle", "underline").toLowerCase();
320 if (cursorStyleString
.equals("underline")) {
321 cursorStyle
= CursorStyle
.UNDERLINE
;
322 } else if (cursorStyleString
.equals("outline")) {
323 cursorStyle
= CursorStyle
.OUTLINE
;
324 } else if (cursorStyleString
.equals("block")) {
325 cursorStyle
= CursorStyle
.BLOCK
;
328 if (System
.getProperty("jexer.Swing.tripleBuffer") != null) {
329 if (System
.getProperty("jexer.Swing.tripleBuffer").
332 SwingScreen
.tripleBuffer
= false;
336 setTitle("Jexer Application");
337 setBackground(Color
.black
);
340 // Always try to use Terminus, the one decent font.
341 ClassLoader loader
= Thread
.currentThread().
342 getContextClassLoader();
343 InputStream in
= loader
.getResourceAsStream(FONTFILE
);
344 Font terminusRoot
= Font
.createFont(Font
.TRUETYPE_FONT
, in
);
345 Font terminus
= terminusRoot
.deriveFont(Font
.PLAIN
, 20);
348 } catch (Exception e
) {
350 // setFont(new Font("Liberation Mono", Font.PLAIN, 24));
351 setFont(new Font(Font
.MONOSPACED
, Font
.PLAIN
, 24));
355 // Kill the X11 cursor
356 // Transparent 16 x 16 pixel cursor image.
357 BufferedImage cursorImg
= new BufferedImage(16, 16,
358 BufferedImage
.TYPE_INT_ARGB
);
359 // Create a new blank cursor.
360 Cursor blankCursor
= Toolkit
.getDefaultToolkit().createCustomCursor(
361 cursorImg
, new Point(0, 0), "blank cursor");
362 setCursor(blankCursor
);
364 // Be capable of seeing Tab / Shift-Tab
365 setFocusTraversalKeysEnabled(false);
367 // Save the text cell width/height
370 // Cache glyphs as they are rendered
371 glyphCacheBlink
= new HashMap
<Cell
, BufferedImage
>();
372 glyphCache
= new HashMap
<Cell
, BufferedImage
>();
374 // Setup triple-buffering
375 if (SwingScreen
.tripleBuffer
) {
376 setIgnoreRepaint(true);
377 createBufferStrategy(3);
378 bufferStrategy
= getBufferStrategy();
383 * Figure out my font dimensions.
385 private void getFontDimensions() {
386 Graphics gr
= getGraphics();
387 FontMetrics fm
= gr
.getFontMetrics();
388 maxDescent
= fm
.getMaxDescent();
389 Rectangle2D bounds
= fm
.getMaxCharBounds(gr
);
390 int leading
= fm
.getLeading();
391 textWidth
= (int)Math
.round(bounds
.getWidth());
392 // textHeight = (int)Math.round(bounds.getHeight()) - maxDescent;
394 // This produces the same number, but works better for ugly
396 textHeight
= fm
.getMaxAscent() + maxDescent
- leading
;
398 if (gotTerminus
== true) {
402 if (System
.getProperty("os.name").startsWith("Windows")) {
406 if (System
.getProperty("os.name").startsWith("Mac")) {
413 * Resize to font dimensions.
415 public void resizeToScreen() {
416 // Figure out the thickness of borders and use that to set the
418 Insets insets
= getInsets();
422 setSize(textWidth
* screen
.width
+ insets
.left
+ insets
.right
,
423 textHeight
* screen
.height
+ insets
.top
+ insets
.bottom
);
427 * Update redraws the whole screen.
429 * @param gr the Swing Graphics context
432 public void update(final Graphics gr
) {
433 // The default update clears the area. Don't do that, instead
434 // just paint it directly.
439 * Draw one glyph to the screen.
441 * @param gr the Swing Graphics context
442 * @param cell the Cell to draw
443 * @param xPixel the x-coordinate to render to. 0 means the
444 * left-most pixel column.
445 * @param yPixel the y-coordinate to render to. 0 means the top-most
448 private void drawGlyph(final Graphics gr
, final Cell cell
,
449 final int xPixel
, final int yPixel
) {
451 BufferedImage image
= null;
452 if (cell
.isBlink() && !cursorBlinkVisible
) {
453 image
= glyphCacheBlink
.get(cell
);
455 image
= glyphCache
.get(cell
);
458 gr
.drawImage(image
, xPixel
, yPixel
, this);
462 // Generate glyph and draw it.
463 Graphics2D gr2
= null;
467 image
= new BufferedImage(textWidth
, textHeight
,
468 BufferedImage
.TYPE_INT_ARGB
);
469 gr2
= image
.createGraphics();
470 gr2
.setFont(getFont());
474 gr2
= (Graphics2D
) gr
;
477 Cell cellColor
= new Cell();
478 cellColor
.setTo(cell
);
481 if (cell
.isReverse()) {
482 cellColor
.setForeColor(cell
.getBackColor());
483 cellColor
.setBackColor(cell
.getForeColor());
486 // Draw the background rectangle, then the foreground character.
487 gr2
.setColor(attrToBackgroundColor(cellColor
));
488 gr2
.fillRect(gr2x
, gr2y
, textWidth
, textHeight
);
490 // Handle blink and underline
492 || (cell
.isBlink() && cursorBlinkVisible
)
494 gr2
.setColor(attrToForegroundColor(cellColor
));
495 char [] chars
= new char[1];
496 chars
[0] = cell
.getChar();
497 gr2
.drawChars(chars
, 0, 1, gr2x
+ textAdjustX
,
498 gr2y
+ textHeight
- maxDescent
+ textAdjustY
);
500 if (cell
.isUnderline()) {
501 gr2
.fillRect(gr2x
, gr2y
+ textHeight
- 2, textWidth
, 2);
508 // We need a new key that will not be mutated by
510 Cell key
= new Cell();
512 if (cell
.isBlink() && !cursorBlinkVisible
) {
513 glyphCacheBlink
.put(key
, image
);
515 glyphCache
.put(key
, image
);
518 gr
.drawImage(image
, xPixel
, yPixel
, this);
524 * Check if the cursor is visible, and if so draw it.
526 * @param gr the Swing Graphics context
528 private void drawCursor(final Graphics gr
) {
531 && (cursorY
<= screen
.height
- 1)
532 && (cursorX
<= screen
.width
- 1)
533 && cursorBlinkVisible
535 int xPixel
= cursorX
* textWidth
+ left
;
536 int yPixel
= cursorY
* textHeight
+ top
;
537 Cell lCell
= screen
.logical
[cursorX
][cursorY
];
538 gr
.setColor(attrToForegroundColor(lCell
));
539 switch (cursorStyle
) {
543 gr
.fillRect(xPixel
, yPixel
+ textHeight
- 2, textWidth
, 2);
546 gr
.fillRect(xPixel
, yPixel
, textWidth
, textHeight
);
549 gr
.drawRect(xPixel
, yPixel
, textWidth
- 1, textHeight
- 1);
556 * Paint redraws the whole screen.
558 * @param gr the Swing Graphics context
561 public void paint(final Graphics gr
) {
562 // Do nothing until the screen reference has been set.
563 if (screen
== null) {
566 if (screen
.frame
== null) {
570 // See if it is time to flip the blink time.
571 long nowTime
= (new Date()).getTime();
572 if (nowTime
> blinkMillis
+ lastBlinkTime
) {
573 lastBlinkTime
= nowTime
;
574 cursorBlinkVisible
= !cursorBlinkVisible
;
578 int xCellMax
= screen
.width
;
580 int yCellMax
= screen
.height
;
582 Rectangle bounds
= gr
.getClipBounds();
583 if (bounds
!= null) {
584 // Only update what is in the bounds
585 xCellMin
= screen
.textColumn(bounds
.x
);
586 xCellMax
= screen
.textColumn(bounds
.x
+ bounds
.width
);
587 if (xCellMax
> screen
.width
) {
588 xCellMax
= screen
.width
;
590 if (xCellMin
>= xCellMax
) {
591 xCellMin
= xCellMax
- 2;
596 yCellMin
= screen
.textRow(bounds
.y
);
597 yCellMax
= screen
.textRow(bounds
.y
+ bounds
.height
);
598 if (yCellMax
> screen
.height
) {
599 yCellMax
= screen
.height
;
601 if (yCellMin
>= yCellMax
) {
602 yCellMin
= yCellMax
- 2;
608 // We need a total repaint
609 reallyCleared
= true;
612 // Prevent updates to the screen's data from the TApplication
614 synchronized (screen
) {
616 System.err.printf("bounds %s X %d %d Y %d %d\n",
617 bounds, xCellMin, xCellMax, yCellMin, yCellMax);
620 for (int y
= yCellMin
; y
< yCellMax
; y
++) {
621 for (int x
= xCellMin
; x
< xCellMax
; x
++) {
623 int xPixel
= x
* textWidth
+ left
;
624 int yPixel
= y
* textHeight
+ top
;
626 Cell lCell
= screen
.logical
[x
][y
];
627 Cell pCell
= screen
.physical
[x
][y
];
629 if (!lCell
.equals(pCell
)
633 drawGlyph(gr
, lCell
, xPixel
, yPixel
);
635 // Physical is always updated
636 physical
[x
][y
].setTo(lCell
);
643 reallyCleared
= false;
644 } // synchronized (screen)
647 } // class SwingFrame
650 * The raw Swing JFrame. Note package private access.
655 * Restore terminal to normal state.
657 public void shutdown() {
662 * Public constructor.
664 public SwingScreen() {
666 SwingUtilities
.invokeAndWait(new Runnable() {
668 SwingScreen
.this.frame
= new SwingFrame(SwingScreen
.this);
669 SwingScreen
.this.sessionInfo
=
670 new SwingSessionInfo(SwingScreen
.this.frame
,
674 SwingScreen
.this.setDimensions(sessionInfo
.getWindowWidth(),
675 sessionInfo
.getWindowHeight());
677 SwingScreen
.this.frame
.resizeToScreen();
678 SwingScreen
.this.frame
.setVisible(true);
681 } catch (Exception e
) {
689 private SwingSessionInfo sessionInfo
;
692 * Create the SwingSessionInfo. Note package private access.
694 * @return the sessionInfo
696 SwingSessionInfo
getSessionInfo() {
701 * Push the logical screen to the physical device.
704 public void flushPhysical() {
707 System.err.printf("flushPhysical(): reallyCleared %s dirty %s\n",
708 reallyCleared, dirty);
711 // If reallyCleared is set, we have to draw everything.
712 if ((frame
.bufferStrategy
!= null) && (reallyCleared
== true)) {
713 // Triple-buffering: we have to redraw everything on this thread.
714 Graphics gr
= frame
.bufferStrategy
.getDrawGraphics();
717 frame
.bufferStrategy
.show();
718 // sync() doesn't seem to help the tearing for me.
719 // Toolkit.getDefaultToolkit().sync();
721 } else if ((frame
.bufferStrategy
== null) && (reallyCleared
== true)) {
722 // Repaint everything on the Swing thread.
727 // Do nothing if nothing happened.
732 if (frame
.bufferStrategy
!= null) {
733 // See if it is time to flip the blink time.
734 long nowTime
= (new Date()).getTime();
735 if (nowTime
> frame
.blinkMillis
+ frame
.lastBlinkTime
) {
736 frame
.lastBlinkTime
= nowTime
;
737 frame
.cursorBlinkVisible
= !frame
.cursorBlinkVisible
;
740 Graphics gr
= frame
.bufferStrategy
.getDrawGraphics();
742 synchronized (this) {
743 for (int y
= 0; y
< height
; y
++) {
744 for (int x
= 0; x
< width
; x
++) {
745 Cell lCell
= logical
[x
][y
];
746 Cell pCell
= physical
[x
][y
];
748 int xPixel
= x
* frame
.textWidth
+ frame
.left
;
749 int yPixel
= y
* frame
.textHeight
+ frame
.top
;
751 if (!lCell
.equals(pCell
)
757 frame
.drawGlyph(gr
, lCell
, xPixel
, yPixel
);
758 physical
[x
][y
].setTo(lCell
);
762 frame
.drawCursor(gr
);
763 } // synchronized (this)
766 frame
.bufferStrategy
.show();
767 // sync() doesn't seem to help the tearing for me.
768 // Toolkit.getDefaultToolkit().sync();
772 // Swing thread version: request a repaint, but limit it to the area
775 // Find the minimum-size damaged region.
776 int xMin
= frame
.getWidth();
778 int yMin
= frame
.getHeight();
781 synchronized (this) {
782 for (int y
= 0; y
< height
; y
++) {
783 for (int x
= 0; x
< width
; x
++) {
784 Cell lCell
= logical
[x
][y
];
785 Cell pCell
= physical
[x
][y
];
787 int xPixel
= x
* frame
.textWidth
+ frame
.left
;
788 int yPixel
= y
* frame
.textHeight
+ frame
.top
;
790 if (!lCell
.equals(pCell
)
799 if (xPixel
+ frame
.textWidth
> xMax
) {
800 xMax
= xPixel
+ frame
.textWidth
;
805 if (yPixel
+ frame
.textHeight
> yMax
) {
806 yMax
= yPixel
+ frame
.textHeight
;
812 if (xMin
+ frame
.textWidth
>= xMax
) {
813 xMax
+= frame
.textWidth
;
815 if (yMin
+ frame
.textHeight
>= yMax
) {
816 yMax
+= frame
.textHeight
;
819 // Repaint the desired area
821 System.err.printf("REPAINT X %d %d Y %d %d\n", xMin, xMax,
824 if (frame
.bufferStrategy
!= null) {
825 // This path should never be taken, but is left here for
827 Graphics gr
= frame
.bufferStrategy
.getDrawGraphics();
828 Rectangle bounds
= new Rectangle(xMin
, yMin
, xMax
- xMin
,
833 frame
.bufferStrategy
.show();
834 // sync() doesn't seem to help the tearing for me.
835 // Toolkit.getDefaultToolkit().sync();
837 // Repaint on the Swing thread.
838 frame
.repaint(xMin
, yMin
, xMax
- xMin
, yMax
- yMin
);
843 * Put the cursor at (x,y).
845 * @param visible if true, the cursor should be visible
846 * @param x column coordinate to put the cursor on
847 * @param y row coordinate to put the cursor on
850 public void putCursor(final boolean visible
, final int x
, final int y
) {
852 if ((visible
== cursorVisible
) && ((x
== cursorX
) && (y
== cursorY
))) {
853 // See if it is time to flip the blink time.
854 long nowTime
= (new Date()).getTime();
855 if (nowTime
< frame
.blinkMillis
+ frame
.lastBlinkTime
) {
856 // Nothing has changed, so don't do anything.
862 && (cursorY
<= height
- 1)
863 && (cursorX
<= width
- 1)
865 // Make the current cursor position dirty
866 if (physical
[cursorX
][cursorY
].getChar() == 'Q') {
867 physical
[cursorX
][cursorY
].setChar('X');
869 physical
[cursorX
][cursorY
].setChar('Q');
873 super.putCursor(visible
, x
, y
);
877 * Convert pixel column position to text cell column position.
879 * @param x pixel column position
880 * @return text cell column position
882 public int textColumn(final int x
) {
883 return ((x
- frame
.left
) / frame
.textWidth
);
887 * Convert pixel row position to text cell row position.
889 * @param y pixel row position
890 * @return text cell row position
892 public int textRow(final int y
) {
893 return ((y
- frame
.top
) / frame
.textHeight
);
897 * Set the window title.
899 * @param title the new title
901 public void setTitle(final String title
) {
902 frame
.setTitle(title
);