brush.java

tiled地图编辑器是2d的,很不错的国外软件,使用起来很方便的

/*
 *  Tiled Map Editor, (c) 2004-2006
 *
 *  This program 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 2 of the License, or
 *  (at your option) any later version.
 *
 *  Adam Turk <[e-mail]>
 *  Bjorn Lindeijer <[e-mail]>
 */

package tiled.mapeditor.brush;

import java.awt.Graphics2D;
import java.awt.Rectangle;

import tiled.core.MultilayerPlane;
import tiled.view.MapView;


public interface Brush
{
    /**
     * Returns the number of layers affected by this brush.
     *
     * @return int
     */
    public int getAffectedLayers();

    /**
     * Returns the bounds of this brush. This is used for determining the area
     * to redraw when the brush moves.
     */
    public Rectangle getBounds();

    /**
     * Called before painting operation starts. This is when the mouse is
     * initially pressed.
     *
     * @param mp      the MultilayerPlane to be affected.
     * @param x       the tile x-coordinate where the user initiated the paint.
     * @param y       the tile y-coordinate where the user initiated the paint.
     * @param button  the mouse button that was used.
     * @param layer   the selected layer.
     *
     * @see MultilayerPlane
     */
    public void startPaint(
            MultilayerPlane mp, int x, int y, int button, int layer);

    /**
     * This is the main processing method for a brush. This method should only
     * be called between calls to startPaint and endPaint.
     *
     * @param x       the tile x-coordinate of the mouse.
     * @param y       the tile y-coordinate of the mouse.
     *
     * @return the rectangular region affected by the painting, used to
     *         determine which area to redraw.
     * @throws Exception
     */
    public Rectangle doPaint(int x, int y) throws Exception;

    /**
     * Called when painting operation finishes. This is when the mouse is
     * released.
     */
    public void endPaint();

    /**
     * Draws a preview of the editing operation when applicable. This version
     * will draw the preview at the specified location.
     *
     * @param g2d The graphics context to draw to.
     * @param x The x-coord to draw the preview at
     * @param y The y-coord to draw the preview at
     * @param mv
     */
    public void drawPreview(Graphics2D g2d, int x, int y, MapView mv);

    /**
     * Draws a preview of the editing operation when applicable.
     *
     * @param g2d The graphics context to draw to.
     * @param mv
     */
    public void drawPreview(Graphics2D g2d, MapView mv);

    /**
     * Returns wether this brush equals another brush.
     *
     * @param brush
     * @return boolean
     */
    public boolean equals(Brush brush);
}