All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.alee.extended.painter.BorderPainter Maven / Gradle / Ivy

There is a newer version: 1.2.14
Show newest version
/*
 * This file is part of WebLookAndFeel library.
 *
 * WebLookAndFeel library is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * WebLookAndFeel library 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 for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with WebLookAndFeel library.  If not, see .
 */

package com.alee.extended.painter;

import com.alee.utils.GraphicsUtils;

import javax.swing.*;
import java.awt.*;
import java.awt.geom.Rectangle2D;
import java.awt.geom.RectangularShape;
import java.awt.geom.RoundRectangle2D;

/**
 * Simple border painter.
 * This painter might be used instead of LineBorder in any component that supports painters.
 *
 * @param  component type
 * @author Mikle Garin
 * @see AbstractPainter
 * @see Painter
 */

public class BorderPainter extends AbstractPainter
{
    /**
     * Border width.
     */
    protected int width = BorderPainterStyle.width;

    /**
     * Border round.
     */
    protected int round = BorderPainterStyle.round;

    /**
     * Border color.
     */
    protected Color color = BorderPainterStyle.color;

    /**
     * Border stroke.
     */
    protected Stroke stroke = null;

    /**
     * Constructs default border painter.
     */
    public BorderPainter ()
    {
        super ();
        updateStroke ();
    }

    /**
     * Constructs border painter with a specified width.
     *
     * @param width border width
     */
    public BorderPainter ( final int width )
    {
        super ();
        this.width = width;
    }

    /**
     * Constructs border painter with a specified color.
     *
     * @param color border color
     */
    public BorderPainter ( final Color color )
    {
        super ();
        this.color = color;
        updateStroke ();
    }

    /**
     * Constructs border painter with a specified width and color.
     *
     * @param width border width
     * @param color border color
     */
    public BorderPainter ( final int width, final Color color )
    {
        super ();
        this.width = width;
        this.color = color;
    }

    /**
     * Returns border width.
     *
     * @return border width
     */
    public int getWidth ()
    {
        return width;
    }

    /**
     * Sets border width.
     * This will also force stroke to update and overwrite old stroke value.
     *
     * @param width new border width
     */
    public void setWidth ( final int width )
    {
        this.width = width;
        updateStroke ();
        updateAll ();
    }

    /**
     * Returns border round.
     *
     * @return border round
     */
    public int getRound ()
    {
        return round;
    }

    /**
     * Sets border round.
     * This will also force stroke to update and overwrite old stroke value.
     *
     * @param round new border round
     */
    public void setRound ( final int round )
    {
        this.round = round;
        updateStroke ();
        repaint ();
    }

    /**
     * Returns border color.
     *
     * @return border color
     */
    public Color getColor ()
    {
        return color;
    }

    /**
     * Sets border color.
     *
     * @param color new border color
     */
    public void setColor ( final Color color )
    {
        this.color = color;
        repaint ();
    }

    /**
     * Returns border stroke.
     *
     * @return border stroke
     */
    public Stroke getStroke ()
    {
        return stroke;
    }

    /**
     * Sets border stroke.
     * Be aware that this value might be overwritten when you modify other painter settings.
     *
     * @param stroke new border stroke
     * @see #setWidth(int)
     * @see #setRound(int)
     */
    public void setStroke ( final Stroke stroke )
    {
        this.stroke = stroke;
        repaint ();
    }

    /**
     * Updates border stroke depending on painter settings.
     */
    protected void updateStroke ()
    {
        stroke = new BasicStroke ( getWidth (), BasicStroke.CAP_ROUND, BasicStroke.JOIN_ROUND );
    }

    /**
     * Returns preferred size required for proper painting of visual data provided by this painter.
     * This should not take into account any sizes not related to this painter settings (for example text size on button).
     *
     * @param c component to process
     * @return preferred size required for proper painting of visual data provided by this painter
     */
    @Override
    public Dimension getPreferredSize ( final E c )
    {
        return new Dimension ( Math.max ( width * 2, round * 2 ), Math.max ( width * 2, round * 2 ) );
    }

    /**
     * Returns margin required for visual data provided by this painter.
     * This margin is usually added to component's margin when the final component border is calculated.
     *
     * @param c component to process
     * @return margin required for visual data provided by this painter
     */
    @Override
    public Insets getMargin ( final E c )
    {
        final Insets m = super.getMargin ( c );
        return new Insets ( m.top + width, m.left + width, m.bottom + width, m.right + width );
    }

    /**
     * Paints visual data onto the component graphics.
     * Provided graphics and component are taken directly from component UI paint method.
     * Provided bounds are usually fake (zero location, component size) but in some cases it might be specified by componentUI.
     *
     * @param g2d    component graphics
     * @param bounds bounds for painter visual data
     * @param c      component to process
     */
    @Override
    public void paint ( final Graphics2D g2d, final Rectangle bounds, final E c )
    {
        if ( width > 0 && stroke != null && color != null )
        {
            final Object aa = GraphicsUtils.setupAntialias ( g2d );
            final Stroke os = GraphicsUtils.setupStroke ( g2d, stroke, stroke != null );

            g2d.setPaint ( color );
            g2d.draw ( getBorderShape ( bounds ) );

            GraphicsUtils.restoreStroke ( g2d, os, stroke != null );
            GraphicsUtils.restoreAntialias ( g2d, aa );
        }
    }

    /**
     * Returns border shape for the specified limiting bounds.
     *
     * @param bounds limiting bounds
     * @return border shape for the specified limiting bounds
     */
    protected RectangularShape getBorderShape ( final Rectangle bounds )
    {
        final double shear = width == 1 ? 0 : ( double ) width / 2;
        if ( round > 0 )
        {
            return new RoundRectangle2D.Double ( bounds.x + shear, bounds.y + shear, bounds.width - shear * 2 - 1,
                    bounds.height - shear * 2 - 1, round * 2, round * 2 );
        }
        else
        {
            return new Rectangle2D.Double ( bounds.x + shear, bounds.y + shear, bounds.width - shear * 2 - 1,
                    bounds.height - shear * 2 - 1 );
        }
    }
}




© 2015 - 2025 Weber Informatics LLC | Privacy Policy