/*
* Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Sun designates this
* particular file as subject to the "Classpath" exception as provided
* by Sun in the LICENSE file that accompanied this code.
*
* This code 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 General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
* CA 95054 USA or visit www.sun.com if you need additional information or
* have any questions.
*/
package javax.swing.plaf.synth;
import sun.swing.SwingUtilities2;
import java.awt.*;
import javax.swing.*;
import javax.swing.plaf.basic.BasicHTML;
import javax.swing.text.*;
import sun.swing.plaf.synth.*;
/**
* Wrapper for primitive graphics calls.
*
* @since 1.5
* @author Scott Violet
*/
public class SynthGraphicsUtils {
// These are used in the text painting code to avoid allocating a bunch of
// garbage.
private Rectangle paintIconR = new Rectangle();
private Rectangle paintTextR = new Rectangle();
private Rectangle paintViewR = new Rectangle();
private Insets paintInsets = new Insets(0, 0, 0, 0);
// These Rectangles/Insets are used in the text size calculation to avoid a
// a bunch of garbage.
private Rectangle iconR = new Rectangle();
private Rectangle textR = new Rectangle();
private Rectangle viewR = new Rectangle();
private Insets viewSizingInsets = new Insets(0, 0, 0, 0);
/**
* Creates a <code>SynthGraphicsUtils</code>.
*/
public SynthGraphicsUtils() {
}
/**
* Draws a line between the two end points.
*
* @param context Identifies hosting region.
* @param paintKey Identifies the portion of the component being asked
* to paint, may be null.
* @param g Graphics object to paint to
* @param x1 x origin
* @param y1 y origin
* @param x2 x destination
* @param y2 y destination
*/
public void drawLine(SynthContext context, Object paintKey,
Graphics g, int x1, int y1, int x2, int y2) {
g.drawLine(x1, y1, x2, y2);
}
/**
* Draws a line between the two end points.
* <p>This implementation supports only one line style key,
* <code>"dashed"</code>. The <code>"dashed"</code> line style is applied
* only to vertical and horizontal lines.
* <p>Specifying <code>null</code> or any key different from
* <code>"dashed"</code> will draw solid lines.
*
* @param context identifies hosting region
* @param paintKey identifies the portion of the component being asked
* to paint, may be null
* @param g Graphics object to paint to
* @param x1 x origin
* @param y1 y origin
* @param x2 x destination
* @param y2 y destination
* @param styleKey identifies the requested style of the line (e.g. "dashed")
* @since 1.6
*/
public void drawLine(SynthContext context, Object paintKey,
Graphics g, int x1, int y1, int x2, int y2,
Object styleKey) {
if ("dashed".equals(styleKey)) {
// draw vertical line
if (x1 == x2) {
y1 += (y1 % 2);
for (int y = y1; y <= y2; y+=2) {
g.drawLine(x1, y, x2, y);
}
// draw horizontal line
} else if (y1 == y2) {
x1 += (x1 % 2);
for (int x = x1; x <= x2; x+=2) {
g.drawLine(x, y1, x, y2);
}
// oblique lines are not supported
}
} else {
drawLine(context, paintKey, g, x1, y1, x2, y2);
}
}
/**
* Lays out text and an icon returning, by reference, the location to
* place the icon and text.
*
* @param ss SynthContext
* @param fm FontMetrics for the Font to use, this may be ignored
* @param text Text to layout
* @param icon Icon to layout
* @param hAlign horizontal alignment
* @param vAlign vertical alignment
* @param hTextPosition horizontal text position
* @param vTextPosition vertical text position
* @param viewR Rectangle to layout text and icon in.
* @param iconR Rectangle to place icon bounds in
* @param textR Rectangle to place text in
* @param iconTextGap gap between icon and text
*/
public String layoutText(SynthContext ss, FontMetrics fm,
String text, Icon icon, int hAlign,
int vAlign, int hTextPosition,
int vTextPosition, Rectangle viewR,
Rectangle iconR, Rectangle textR, int iconTextGap) {
if (icon instanceof SynthIcon) {
SynthIconWrapper wrapper = SynthIconWrapper.get((SynthIcon)icon,
ss);
String formattedText = SwingUtilities.layoutCompoundLabel(
ss.getComponent(), fm, text, wrapper, vAlign, hAlign,
vTextPosition, hTextPosition, viewR, iconR, textR,
iconTextGap);
SynthIconWrapper.release(wrapper);
return formattedText;
}
return SwingUtilities.layoutCompoundLabel(
ss.getComponent(), fm, text, icon, vAlign, hAlign,
vTextPosition, hTextPosition, viewR, iconR, textR,
iconTextGap);
}
/**
* Returns the size of the passed in string.
*
* @param ss SynthContext
* @param font Font to use
* @param metrics FontMetrics, may be ignored
* @param text Text to get size of.
*/
public int computeStringWidth(SynthContext ss, Font font,
FontMetrics metrics, String text) {
return SwingUtilities2.stringWidth(ss.getComponent(), metrics,
text);
}
/**
* Returns the minimum size needed to properly render an icon and text.
*
* @param ss SynthContext
* @param font Font to use
* @param text Text to layout
* @param icon Icon to layout
* @param hAlign horizontal alignment
* @param vAlign vertical alignment
* @param hTextPosition horizontal text position
* @param vTextPosition vertical text position
* @param iconTextGap gap between icon and text
* @param mnemonicIndex Index into text to render the mnemonic at, -1
* indicates no mnemonic.
*/
public Dimension getMinimumSize(SynthContext ss, Font font, String text,
Icon icon, int hAlign, int vAlign, int hTextPosition,
int vTextPosition, int iconTextGap, int mnemonicIndex) {
JComponent c = ss.getComponent();
Dimension size = getPreferredSize(ss, font, text, icon, hAlign,
vAlign, hTextPosition, vTextPosition,
iconTextGap, mnemonicIndex);
View v = (View) c.getClientProperty(BasicHTML.propertyKey);
if (v != null) {
size.width -= v.getPreferredSpan(View.X_AXIS) -
v.getMinimumSpan(View.X_AXIS);
}
return size;
}
/**
* Returns the maximum size needed to properly render an icon and text.
*
* @param ss SynthContext
* @param font Font to use
* @param text Text to layout
* @param icon Icon to layout
* @param hAlign horizontal alignment
* @param vAlign vertical alignment
* @param hTextPosition horizontal text position
* @param vTextPosition vertical text position
* @param iconTextGap gap between icon and text
* @param mnemonicIndex Index into text to render the mnemonic at, -1
* indicates no mnemonic.
*/
public Dimension getMaximumSize(SynthContext ss, Font font, String text,
Icon icon, int hAlign, int vAlign, int hTextPosition,
int vTextPosition, int iconTextGap, int mnemonicIndex) {
JComponent c = ss.getComponent();
Dimension size = getPreferredSize(ss, font, text, icon, hAlign,
vAlign, hTextPosition, vTextPosition,
iconTextGap, mnemonicIndex);
View v = (View) c.getClientProperty(BasicHTML.propertyKey);
if (v != null) {
size.width += v.getMaximumSpan(View.X_AXIS) -
v.getPreferredSpan(View.X_AXIS);
}
return size;
}
/**
* Returns the maximum height of the the Font from the passed in
* SynthContext.
*
* @param context SynthContext used to determine font.
* @return maximum height of the characters for the font from the passed
* in context.
*/
public int getMaximumCharHeight(SynthContext context) {
FontMetrics fm = context.getComponent().getFontMetrics(
context.getStyle().getFont(context));
return (fm.getAscent() + fm.getDescent());
}
/**
* Returns the preferred size needed to properly render an icon and text.
*
* @param ss SynthContext
* @param font Font to use
* @param text Text to layout
* @param icon Icon to layout
* @param hAlign horizontal alignment
* @param vAlign vertical alignment
* @param hTextPosition horizontal text position
* @param vTextPosition vertical text position
* @param iconTextGap gap between icon and text
* @param mnemonicIndex Index into text to render the mnemonic at, -1
* indicates no mnemonic.
*/
public Dimension getPreferredSize(SynthContext ss, Font font, String text,
Icon icon, int hAlign, int vAlign, int hTextPosition,
int vTextPosition, int iconTextGap, int mnemonicIndex) {
JComponent c = ss.getComponent();
Insets insets = c.getInsets(viewSizingInsets);
int dx = insets.left + insets.right;
int dy = insets.top + insets.bottom;
if (icon == null && (text == null || font == null)) {
return new Dimension(dx, dy);
}
else if ((text == null) || ((icon != null) && (font == null))) {
return new Dimension(SynthIcon.getIconWidth(icon, ss) + dx,
SynthIcon.getIconHeight(icon, ss) + dy);
}
else {
FontMetrics fm = c.getFontMetrics(font);
iconR.x = iconR.y = iconR.width = iconR.height = 0;
textR.x = textR.y = textR.width = textR.height = 0;
viewR.x = dx;
viewR.y = dy;
viewR.width = viewR.height = Short.MAX_VALUE;
layoutText(ss, fm, text, icon, hAlign, vAlign,
hTextPosition, vTextPosition, viewR, iconR, textR,
iconTextGap);
int x1 = Math.min(iconR.x, textR.x);
int x2 = Math.max(iconR.x + iconR.width, textR.x + textR.width);
int y1 = Math.min(iconR.y, textR.y);
int y2 = Math.max(iconR.y + iconR.height, textR.y + textR.height);
Dimension rv = new Dimension(x2 - x1, y2 - y1);
rv.width += dx;
rv.height += dy;
return rv;
}
}
/**
* Paints text at the specified location. This will not attempt to
* render the text as html nor will it offset by the insets of the
* component.
*
* @param ss SynthContext
* @param g Graphics used to render string in.
* @param text Text to render
* @param bounds Bounds of the text to be drawn.
* @param mnemonicIndex Index to draw string at.
*/
public void paintText(SynthContext ss, Graphics g, String text,
Rectangle bounds, int mnemonicIndex) {
paintText(ss, g, text, bounds.x, bounds.y, mnemonicIndex);
}
/**
* Paints text at the specified location. This will not attempt to
* render the text as html nor will it offset by the insets of the
* component.
*
* @param ss SynthContext
* @param g Graphics used to render string in.
* @param text Text to render
* @param x X location to draw text at.
* @param y Upper left corner to draw text at.
* @param mnemonicIndex Index to draw string at.
*/
public void paintText(SynthContext ss, Graphics g, String text,
int x, int y, int mnemonicIndex) {
if (text != null) {
JComponent c = ss.getComponent();
FontMetrics fm = SwingUtilities2.getFontMetrics(c, g);
y += fm.getAscent();
SwingUtilities2.drawStringUnderlineCharAt(c, g, text,
mnemonicIndex, x, y);
}
}
/**
* Paints an icon and text. This will render the text as html, if
* necessary, and offset the location by the insets of the component.
*
* @param ss SynthContext
* @param g Graphics to render string and icon into
* @param text Text to layout
* @param icon Icon to layout
* @param hAlign horizontal alignment
* @param vAlign vertical alignment
* @param hTextPosition horizontal text position
* @param vTextPosition vertical text position
* @param iconTextGap gap between icon and text
* @param mnemonicIndex Index into text to render the mnemonic at, -1
* indicates no mnemonic.
* @param textOffset Amount to offset the text when painting
*/
public void paintText(SynthContext ss, Graphics g, String text,
Icon icon, int hAlign, int vAlign, int hTextPosition,
int vTextPosition, int iconTextGap, int mnemonicIndex,
int textOffset) {
if ((icon == null) && (text == null)) {
return;
}
JComponent c = ss.getComponent();
FontMetrics fm = SwingUtilities2.getFontMetrics(c, g);
Insets insets = SynthLookAndFeel.getPaintingInsets(ss, paintInsets);
paintViewR.x = insets.left;
paintViewR.y = insets.top;
paintViewR.width = c.getWidth() - (insets.left + insets.right);
paintViewR.height = c.getHeight() - (insets.top + insets.bottom);
paintIconR.x = paintIconR.y = paintIconR.width = paintIconR.height = 0;
paintTextR.x = paintTextR.y = paintTextR.width = paintTextR.height = 0;
String clippedText =
layoutText(ss, fm, text, icon, hAlign, vAlign,
hTextPosition, vTextPosition, paintViewR, paintIconR,
paintTextR, iconTextGap);
if (icon != null) {
Color color = g.getColor();
if (ss.getStyle().getBoolean(ss, "TableHeader.alignSorterArrow", false) &&
"TableHeader.renderer".equals(c.getName())) {
paintIconR.x = paintViewR.width - paintIconR.width;
} else {
paintIconR.x += textOffset;
}
paintIconR.y += textOffset;
SynthIcon.paintIcon(icon, ss, g, paintIconR.x, paintIconR.y,
paintIconR.width, paintIconR.height);
g.setColor(color);
}
if (text != null) {
View v = (View) c.getClientProperty(BasicHTML.propertyKey);
if (v != null) {
v.paint(g, paintTextR);
} else {
paintTextR.x += textOffset;
paintTextR.y += textOffset;
paintText(ss, g, clippedText, paintTextR, mnemonicIndex);
}
}
}
/**
* Wraps a SynthIcon around the Icon interface, forwarding calls to
* the SynthIcon with a given SynthContext.
*/
private static class SynthIconWrapper implements Icon {
private static final java.util.List CACHE = new java.util.ArrayList(1);
private SynthIcon synthIcon;
private SynthContext context;
static SynthIconWrapper get(SynthIcon icon, SynthContext context) {
synchronized(CACHE) {
int size = CACHE.size();
if (size > 0) {
SynthIconWrapper wrapper = (SynthIconWrapper)CACHE.remove(
size - 1);
wrapper.reset(icon, context);
return wrapper;
}
}
return new SynthIconWrapper(icon, context);
}
static void release(SynthIconWrapper wrapper) {
wrapper.reset(null, null);
synchronized(CACHE) {
CACHE.add(wrapper);
}
}
SynthIconWrapper(SynthIcon icon, SynthContext context) {
reset(icon, context);
}
void reset(SynthIcon icon, SynthContext context) {
synthIcon = icon;
this.context = context;
}
public void paintIcon(Component c, Graphics g, int x, int y) {
// This is a noop as this should only be for sizing calls.
}
public int getIconWidth() {
return synthIcon.getIconWidth(context);
}
public int getIconHeight() {
return synthIcon.getIconHeight(context);
}
}
}