Класс DebugGraphics

java.lang.Object
- java.awt.Graphics
- - javax.swing.DebugGraphics

public class DebugGraphics
extends Graphics

Подкласс Graphics, поддерживающий отладку графики. Переопределяет большинство методов из Graphics. Объекты DebugGraphics редко создаются вручную. Чаще всего они создаются автоматически, когда параметры отладки JComponent изменяются с помощью метода setDebugGraphicsOptions().

ПРИМЕЧАНИЕ: Для использования DebugGraphics необходимо отключить двойную буферизацию: RepaintManager repaintManager = RepaintManager.currentManager(component); repaintManager.setDoubleBufferingEnabled(false);

См. также:: JComponent.setDebugGraphicsOptions(int), RepaintManager.currentManager(java.awt.Component), RepaintManager.setDoubleBufferingEnabled(boolean)

Поля

Модификатор и тип	Поле и описание
`static int`	`BUFFERED_OPTION` Показывать буферизованные операции в отдельном `Frame`.
`static int`	`FLASH_OPTION` Мигать графическими операциями.
`static int`	`LOG_OPTION` Вести журнал графических операций.
`static int`	`NONE_OPTION` Не отлаживать графические операции.

Конструкторы

Конструктор и описание
`DebugGraphics()` Создаёт новый контекст отладки графики, который поддерживает замедленное рисование.
`DebugGraphics(Graphics graphics)` Создаёт контекст отладки графики из существующего контекста графики, который поддерживает замедленное рисование.
`DebugGraphics(Graphics graphics, JComponent component)` Создаёт контекст отладки графики из существующего контекста графики, который замедляет рисование для указанного компонента.

Методы

Модификатор и тип	Метод и описание
`void`	`clearRect(int x, int y, int width, int height)` Переопределяет `Graphics.clearRect`.
`void`	`clipRect(int x, int y, int width, int height)` Переопределяет `Graphics.clipRect`.
`void`	`copyArea(int x, int y, int width, int height, int destX, int destY)` Переопределяет `Graphics.copyArea`.
`Graphics`	`create()` Переопределяет `Graphics.create` для возврата объекта DebugGraphics.
`Graphics`	`create(int x, int y, int width, int height)` Переопределяет `Graphics.create` для возврата объекта DebugGraphics.
`void`	`dispose()` Переопределяет `Graphics.dispose`.
`void`	`draw3DRect(int x, int y, int width, int height, boolean raised)` Переопределяет `Graphics.draw3DRect`.
`void`	`drawArc(int x, int y, int width, int height, int startAngle, int arcAngle)` Переопределяет `Graphics.drawArc`.
`void`	`drawBytes(byte[] data, int offset, int length, int x, int y)` Переопределяет `Graphics.drawBytes`.
`void`	`drawChars(char[] data, int offset, int length, int x, int y)` Переопределяет `Graphics.drawChars`.
`boolean`	`drawImage(Image img, int x, int y, Color bgcolor, ImageObserver observer)` Переопределяет `Graphics.drawImage`.
`boolean`	`drawImage(Image img, int x, int y, ImageObserver observer)` Переопределяет `Graphics.drawImage`.
`boolean`	`drawImage(Image img, int x, int y, int width, int height, Color bgcolor, ImageObserver observer)` Переопределяет `Graphics.drawImage`.
`boolean`	`drawImage(Image img, int x, int y, int width, int height, ImageObserver observer)` Переопределяет `Graphics.drawImage`.
`boolean`	`drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, Color bgcolor, ImageObserver observer)` Переопределяет `Graphics.drawImage`.
`boolean`	`drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, ImageObserver observer)` Переопределяет `Graphics.drawImage`.
`void`	`drawLine(int x1, int y1, int x2, int y2)` Переопределяет `Graphics.drawLine`.
`void`	`drawOval(int x, int y, int width, int height)` Переопределяет `Graphics.drawOval`.
`void`	`drawPolygon(int[] xPoints, int[] yPoints, int nPoints)` Переопределяет `Graphics.drawPolygon`.
`void`	`drawPolyline(int[] xPoints, int[] yPoints, int nPoints)` Переопределяет `Graphics.drawPolyline`.
`void`	`drawRect(int x, int y, int width, int height)` Переопределяет `Graphics.drawRect`.
`void`	`drawRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)` Переопределяет `Graphics.drawRoundRect`.
`void`	`drawString(AttributedCharacterIterator iterator, int x, int y)` Переопределяет `Graphics.drawString`.
`void`	`drawString(String aString, int x, int y)` Переопределяет `Graphics.drawString`.
`void`	`fill3DRect(int x, int y, int width, int height, boolean raised)` Переопределяет `Graphics.fill3DRect`.
`void`	`fillArc(int x, int y, int width, int height, int startAngle, int arcAngle)` Переопределяет `Graphics.fillArc`.
`void`	`fillOval(int x, int y, int width, int height)` Переопределяет `Graphics.fillOval`.
`void`	`fillPolygon(int[] xPoints, int[] yPoints, int nPoints)` Переопределяет `Graphics.fillPolygon`.
`void`	`fillRect(int x, int y, int width, int height)` Переопределяет `Graphics.fillRect`.
`void`	`fillRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)` Переопределяет `Graphics.fillRoundRect`.
`static Color`	`flashColor()` Возвращает цвет, используемый для мигания графических операций.
`static int`	`flashCount()` Возвращает количество раз, которое графические операции будут мигать.
`static int`	`flashTime()` Возвращает задержку времени мигания графической операции.
`Shape`	`getClip()` Переопределяет `Graphics.getClip`.
`Rectangle`	`getClipBounds()` Переопределяет `Graphics.getClipBounds`.
`Color`	`getColor()` Возвращает цвет, используемый для рисования текста.
`int`	`getDebugOptions()` Возвращает текущие параметры отладки для этого DebugGraphics.
`Font`	`getFont()` Возвращает шрифт, используемый для рисования текста.
`FontMetrics`	`getFontMetrics()` Переопределяет `Graphics.getFontMetrics`.
`FontMetrics`	`getFontMetrics(Font f)` Переопределяет `Graphics.getFontMetrics`.
`boolean`	`isDrawingBuffer()` Возвращает значение drawingBuffer.
`static PrintStream`	`logStream()` Возвращает поток, в который DebugGraphics записывает логирование графических операций.
`void`	`setClip(int x, int y, int width, int height)` Переопределяет `Graphics.setClip`.
`void`	`setClip(Shape clip)` Переопределяет `Graphics.setClip`.
`void`	`setColor(Color aColor)` Устанавливает цвет, используемый для рисования и заполнения линий и фигур.
`void`	`setDebugOptions(int options)` Включает/выключает диагностическую информацию о каждой графической операции.
`static void`	`setFlashColor(Color flashColor)` Устанавливает цвет, используемый для мигания графических операций.
`static void`	`setFlashCount(int flashCount)` Устанавливает количество раз, которое графические операции будут мигать.
`static void`	`setFlashTime(int flashTime)` Устанавливает задержку времени мигания графической операции.
`void`	`setFont(Font aFont)` Устанавливает шрифт, используемый для рисования текста.
`static void`	`setLogStream(PrintStream stream)` Устанавливает поток, в который DebugGraphics записывает логирование графических операций.
`void`	`setPaintMode()` Переопределяет `Graphics.setPaintMode`.
`void`	`setXORMode(Color aColor)` Переопределяет `Graphics.setXORMode`.
`void`	`translate(int x, int y)` Переопределяет `Graphics.translate`.

Методы, унаследованные от класса java.awt.Graphics

drawPolygon, fillPolygon, finalize, getClipBounds, getClipRect, hitClip, toString

Методы, унаследованные от класса java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Поля

LOG_OPTION

public static final int LOG_OPTION

Регистрация графических операций.

См. также:: Значения константных полей

FLASH_OPTION

public static final int FLASH_OPTION

Мигание графических операций.

См. также:: Значения константных полей

BUFFERED_OPTION

public static final int BUFFERED_OPTION

Отображение буферизованных операций в отдельном Frame.

См. также:: Значения константных полей

NONE_OPTION

public static final int NONE_OPTION

Отключить отладку графических операций.

См. также:: Значения константных полей

Конструкторы

DebugGraphics

public DebugGraphics()

Создаёт новый контекст отладочной графики, поддерживающий замедленное рисование.

DebugGraphics

public DebugGraphics(Graphics graphics,
                     JComponent component)

Создаёт контекст отладочной графики из существующего графического контекста, замедляющего рисование для указанного компонента.

Параметры:: graphics - контекст Graphics для замедления; component - компонент JComponent для замедленного рисования

DebugGraphics

public DebugGraphics(Graphics graphics)

Создаёт контекст отладочной графики из существующего графического контекста, поддерживающего замедленное рисование.

Параметры:: graphics - контекст Graphics для замедления

Методы

create

public Graphics create()

Переопределяет Graphics.create для возвращения объекта DebugGraphics.

Указано в:: create в классе Graphics
Возвращает:: новый графический контекст, являющийся копией этого графического контекста.

create

public Graphics create(int x,
                       int y,
                       int width,
                       int height)

Переопределяет Graphics.create для возвращения объекта DebugGraphics.

Переопределяет:: create в классе Graphics
Параметры:: x - координата x.; y - координата y.; width - ширина области обрезки.; height - высота области обрезки.
Возвращает:: новый графический контекст.
См. также:: Graphics.translate(int, int), Graphics.clipRect(int, int, int, int)

setFlashColor

public static void setFlashColor(Color flashColor)

Устанавливает цвет, используемый для мигания операций рисования.

flashColor

public static Color flashColor()

Возвращает цвет, используемый для мигания операций рисования.

См. также:: setFlashColor(java.awt.Color)

setFlashTime

public static void setFlashTime(int flashTime)

Устанавливает время задержки мигания операций рисования.

flashTime

public static int flashTime()

Возвращает время задержки мигания операций рисования.

См. также:: setFlashTime(int)

setFlashCount

public static void setFlashCount(int flashCount)

Устанавливает количество раз, которое операции рисования будут мигать.

flashCount

public static int flashCount()

Возвращает количество раз, которое операции рисования будут мигать.

См. также:: setFlashCount(int)

setLogStream

public static void setLogStream(PrintStream stream)

Устанавливает поток, в который DebugGraphics регистрирует операции рисования.

logStream

public static PrintStream logStream()

Возвращает поток, в который DebugGraphics регистрирует операции рисования.

См. также:: setLogStream(java.io.PrintStream)

setFont

public void setFont(Font aFont)

Устанавливает шрифт, используемый для операций рисования текста.

Указано в:: setFont в классе Graphics
Параметры:: aFont - шрифт.
См. также:: Graphics.getFont(), Graphics.drawString(java.lang.String, int, int), Graphics.drawBytes(byte[], int, int, int, int), Graphics.drawChars(char[], int, int, int, int)

getFont

public Font getFont()

Возвращает шрифт, используемый для операций рисования текста.

Указано в:: getFont в классе Graphics
Возвращает:: текущий шрифт этого графического контекста.
См. также:: setFont(java.awt.Font)

setColor

public void setColor(Color aColor)

Устанавливает цвет, который будет использоваться для рисования и заливки линий и фигур.

Указано в:: setColor в классе Graphics
Параметры:: aColor - новый цвет отображения.
См. также:: Color, Graphics.getColor()

getColor

public Color getColor()

Возвращает цвет, используемый для рисования текста.

Указано в:: getColor в классе Graphics
Возвращает:: текущий цвет этого графического контекста.
См. также:: setColor(java.awt.Color)

getFontMetrics

public FontMetrics getFontMetrics()

Переопределяет Graphics.getFontMetrics.

Переопределяет:: getFontMetrics в классе Graphics
Возвращает:: метрики шрифта текущего шрифта этого графического контекста.
См. также:: Graphics.getFont(), FontMetrics, Graphics.getFontMetrics(Font)

getFontMetrics

public FontMetrics getFontMetrics(Font f)

Переопределяет Graphics.getFontMetrics.

Указано в:: getFontMetrics в классе Graphics
Параметры:: f - указанный шрифт
Возвращает:: метрики шрифта для указанного шрифта.
См. также:: Graphics.getFont(), FontMetrics, Graphics.getFontMetrics()

translate

public void translate(int x,
                      int y)

Переопределяет Graphics.translate.

Указано в:: translate в классе Graphics
Параметры:: x - координата x.; y - координата y.

setPaintMode

public void setPaintMode()

Переопределяет Graphics.setPaintMode.

Указано в:: setPaintMode в классе Graphics

setXORMode

public void setXORMode(Color aColor)

Переопределяет Graphics.setXORMode.

Указано в:: setXORMode в классе Graphics
Параметры:: aColor - цвет XOR-переключения

getClipBounds

public Rectangle getClipBounds()

Переопределяет Graphics.getClipBounds.

Указано в:: getClipBounds в классе Graphics
Возвращает:: прямоугольник границ текущей области обрезки, или null если область обрезки не установлена.
См. также:: Graphics.getClip(), Graphics.clipRect(int, int, int, int), Graphics.setClip(int, int, int, int), Graphics.setClip(Shape)

clipRect

public void clipRect(int x,
                     int y,
                     int width,
                     int height)

Переопределяет Graphics.clipRect.

Указано в:: clipRect в классе Graphics
Параметры:: x - координата x прямоугольника для пересечения с областью обрезки; y - координата y прямоугольника для пересечения с областью обрезки; width - ширина прямоугольника для пересечения с областью обрезки; height - высота прямоугольника для пересечения с областью обрезки
См. также:: Graphics.setClip(int, int, int, int), Graphics.setClip(Shape)

setClip

public void setClip(int x,
                    int y,
                    int width,
                    int height)

Переопределяет Graphics.setClip.

Указано в:: setClip в классе Graphics
Параметры:: x - координата x нового прямоугольника обрезки.; y - координата y нового прямоугольника обрезки.; width - ширина нового прямоугольника обрезки.; height - высота нового прямоугольника обрезки.
См. также:: Graphics.clipRect(int, int, int, int), Graphics.setClip(Shape), Graphics.getClip()

getClip

public Shape getClip()

Переопределяет Graphics.getClip.

Указано:: getClip в классе Graphics
Возвращает:: объект Shape , представляющий текущую область обрезки, или null , если обрезка не задана.
См. также:: Graphics.getClipBounds(), Graphics.clipRect(int, int, int, int), Graphics.setClip(int, int, int, int), Graphics.setClip(Shape)

setClip

public void setClip(Shape clip)

Переопределяет Graphics.setClip.

Указано:: setClip в классе Graphics
Параметры:: clip - Shape для установки обрезки
См. также:: Graphics.getClip(), Graphics.clipRect(int, int, int, int), Graphics.setClip(int, int, int, int)

drawRect

public void drawRect(int x,
                     int y,
                     int width,
                     int height)

Переопределяет Graphics.drawRect.

Переопределяет:: drawRect в классе Graphics
Параметры:: x - координата x прямоугольника для отрисовки.; y - координата y прямоугольника для отрисовки.; width - ширина прямоугольника для отрисовки.; height - высота прямоугольника для отрисовки.
См. также:: Graphics.fillRect(int, int, int, int), Graphics.clearRect(int, int, int, int)

fillRect

public void fillRect(int x,
                     int y,
                     int width,
                     int height)

Переопределяет Graphics.fillRect.

Указано:: fillRect в классе Graphics
Параметры:: x - координата x прямоугольника для заполнения.; y - координата y прямоугольника для заполнения.; width - ширина прямоугольника для заполнения.; height - высота прямоугольника для заполнения.
См. также:: Graphics.clearRect(int, int, int, int), Graphics.drawRect(int, int, int, int)

clearRect

public void clearRect(int x,
                      int y,
                      int width,
                      int height)

Переопределяет Graphics.clearRect.

Указано:: clearRect в классе Graphics
Параметры:: x - координата x прямоугольника для очистки.; y - координата y прямоугольника для очистки.; width - ширина прямоугольника для очистки.; height - высота прямоугольника для очистки.
См. также:: Graphics.fillRect(int, int, int, int), Graphics.drawRect(int, int, int, int), Graphics.setColor(java.awt.Color), Graphics.setPaintMode(), Graphics.setXORMode(java.awt.Color)

drawRoundRect

public void drawRoundRect(int x,
                          int y,
                          int width,
                          int height,
                          int arcWidth,
                          int arcHeight)

Переопределяет Graphics.drawRoundRect.

Указано:: drawRoundRect в классе Graphics
Параметры:: x - координата x прямоугольника для отрисовки.; y - координата y прямоугольника для отрисовки.; width - ширина прямоугольника для отрисовки.; height - высота прямоугольника для отрисовки.; arcWidth - горизонтальный диаметр дуги в четырёх углах.; arcHeight - вертикальный диаметр дуги в четырёх углах.
См. также:: Graphics.fillRoundRect(int, int, int, int, int, int)

fillRoundRect

public void fillRoundRect(int x,
                          int y,
                          int width,
                          int height,
                          int arcWidth,
                          int arcHeight)

Переопределяет Graphics.fillRoundRect.

Указано:: fillRoundRect в классе Graphics
Параметры:: x - координата x прямоугольника для заполнения.; y - координата y прямоугольника для заполнения.; width - ширина прямоугольника для заполнения.; height - высота прямоугольника для заполнения.; arcWidth - горизонтальный диаметр дуги в четырёх углах.; arcHeight - вертикальный диаметр дуги в четырёх углах.
См. также:: Graphics.drawRoundRect(int, int, int, int, int, int)

drawLine

public void drawLine(int x1,
                     int y1,
                     int x2,
                     int y2)

Переопределяет Graphics.drawLine.

Указано:: drawLine в классе Graphics
Параметры:: x1 - координата x первой точки.; y1 - координата y первой точки.; x2 - координата x второй точки.; y2 - координата y второй точки.

draw3DRect

public void draw3DRect(int x,
                       int y,
                       int width,
                       int height,
                       boolean raised)

Переопределяет Graphics.draw3DRect.

Переопределяет:: draw3DRect в классе Graphics
Параметры:: x - координата x прямоугольника для отрисовки.; y - координата y прямоугольника для отрисовки.; width - ширина прямоугольника для отрисовки.; height - высота прямоугольника для отрисовки.; raised - логическое значение, определяющее, является ли прямоугольник поднятым над поверхностью или вдавленным в неё.
См. также:: Graphics.fill3DRect(int, int, int, int, boolean)

fill3DRect

public void fill3DRect(int x,
                       int y,
                       int width,
                       int height,
                       boolean raised)

Переопределяет Graphics.fill3DRect.

Переопределяет:: fill3DRect в классе Graphics
Параметры:: x - координата x прямоугольника для заполнения.; y - координата y прямоугольника для заполнения.; width - ширина прямоугольника для заполнения.; height - высота прямоугольника для заполнения.; raised - логическое значение, определяющее, является ли прямоугольник поднятым над поверхностью или выгравированным в ней.
См. также:: Graphics.draw3DRect(int, int, int, int, boolean)

drawOval

public void drawOval(int x,
                     int y,
                     int width,
                     int height)

Переопределяет Graphics.drawOval.

Указано:: drawOval в классе Graphics
Параметры:: x - координата x верхнего левого угла эллипса для отрисовки.; y - координата y верхнего левого угла эллипса для отрисовки.; width - ширина эллипса для отрисовки.; height - высота эллипса для отрисовки.
См. также:: Graphics.fillOval(int, int, int, int)

fillOval

public void fillOval(int x,
                     int y,
                     int width,
                     int height)

Переопределяет Graphics.fillOval.

Указано:: fillOval в классе Graphics
Параметры:: x - координата x верхнего левого угла эллипса для заполнения.; y - координата y верхнего левого угла эллипса для заполнения.; width - ширина эллипса для заполнения.; height - высота эллипса для заполнения.
См. также:: Graphics.drawOval(int, int, int, int)

drawArc

public void drawArc(int x,
                    int y,
                    int width,
                    int height,
                    int startAngle,
                    int arcAngle)

Переопределяет Graphics.drawArc.

Указано:: drawArc в классе Graphics
Параметры:: x - координата x верхнего левого угла дуги для отрисовки.; y - координата y верхнего левого угла дуги для отрисовки.; width - ширина дуги для отрисовки.; height - высота дуги для отрисовки.; startAngle - начальный угол.; arcAngle - угловой охват дуги относительно начального угла.
См. также:: Graphics.fillArc(int, int, int, int, int, int)

fillArc

public void fillArc(int x,
                    int y,
                    int width,
                    int height,
                    int startAngle,
                    int arcAngle)

Переопределяет Graphics.fillArc.

Указано:: fillArc в классе Graphics
Параметры:: x - координата x верхнего левого угла дуги для заполнения.; y - координата y верхнего левого угла дуги для заполнения.; width - ширина дуги для заполнения.; height - высота дуги для заполнения.; startAngle - начальный угол.; arcAngle - угловой охват дуги относительно начального угла.
См. также:: Graphics.drawArc(int, int, int, int, int, int)

drawPolyline

public void drawPolyline(int[] xPoints,
                         int[] yPoints,
                         int nPoints)

Переопределяет Graphics.drawPolyline.

Указано в:: drawPolyline в классе Graphics
Параметры:: xPoints - массив точек x; yPoints - массив точек y; nPoints - общее количество точек
См. также:: Graphics.drawPolygon(int[], int[], int)

drawPolygon

public void drawPolygon(int[] xPoints,
                        int[] yPoints,
                        int nPoints)

Переопределяет Graphics.drawPolygon.

Указано в:: drawPolygon в классе Graphics
Параметры:: xPoints - массив координат x.; yPoints - массив координат y.; nPoints - общее количество точек.
См. также:: Graphics.fillPolygon(int[], int[], int), Graphics.drawPolyline(int[], int[], int)

fillPolygon

public void fillPolygon(int[] xPoints,
                        int[] yPoints,
                        int nPoints)

Переопределяет Graphics.fillPolygon.

Указано в:: fillPolygon в классе Graphics
Параметры:: xPoints - массив координат x.; yPoints - массив координат y.; nPoints - общее количество точек.
См. также:: Graphics.drawPolygon(int[], int[], int)

drawString

public void drawString(String aString,
                       int x,
                       int y)

Переопределяет Graphics.drawString.

Указано в:: drawString в классе Graphics
Параметры:: aString - строка для отрисовки.; x - координата x.; y - координата y.
См. также:: Graphics.drawBytes(byte[], int, int, int, int), Graphics.drawChars(char[], int, int, int, int)

drawString

public void drawString(AttributedCharacterIterator iterator,
                       int x,
                       int y)

Переопределяет Graphics.drawString.

Указано в:: drawString в классе Graphics
Параметры:: iterator - итератор с текстом для отрисовки; x - координата x.; y - координата y.
См. также:: Graphics.drawBytes(byte[], int, int, int, int), Graphics.drawChars(char[], int, int, int, int)

drawBytes

public void drawBytes(byte[] data,
                      int offset,
                      int length,
                      int x,
                      int y)

Переопределяет Graphics.drawBytes.

Переопределяет:: drawBytes в классе Graphics
Параметры:: data - данные для отрисовки; offset - начальный смещение в данных; length - количество байтов для отрисовки; x - координата x базовой линии текста; y - координата y базовой линии текста
См. также:: Graphics.drawChars(char[], int, int, int, int), Graphics.drawString(java.lang.String, int, int)

drawChars

public void drawChars(char[] data,
                      int offset,
                      int length,
                      int x,
                      int y)

Переопределяет Graphics.drawChars.

Переопределяет:: drawChars в классе Graphics
Параметры:: data - массив символов для отрисовки; offset - начальный смещение в данных; length - количество символов для отрисовки; x - координата x базовой линии текста; y - координата y базовой линии текста
См. также:: Graphics.drawBytes(byte[], int, int, int, int), Graphics.drawString(java.lang.String, int, int)