com.threerings.media.image

Class NinePatch

java.lang.Object

com.threerings.media.image.NinePatch

public class NinePatch
extends Object

The NinePatch class permits drawing a bitmap in nine sections. The four corners are unscaled; the four edges are scaled in one axis, and the middle is scaled in both axes. Normally, the middle is transparent so that the patch can provide a selection about a rectangle. Essentially, it allows the creation of custom graphics that will scale the way that you define, when content added within the image exceeds the normal bounds of the graphic. This is an AWT clone of the NinePatch functionality that exists in Google's Android graphic system. See http://developer.android.com/guide/topics/graphics/2d-graphics.html#nine-patch

Constructor Summary

Constructors

Constructor and Description
NinePatch(BufferedImage img) Builds a NinePatch based on the given image.
NinePatch(BufferedImage img, Rectangle center, Rectangle content) Builds a NinePatch based on the given image.

Method Summary

Modifier and Type	Method and Description
Rectangle	getBoundsSurrounding(Rectangle content) Returns a rectangle describing the bounds of this NinePatch when drawn such that it frames the given content rectangle.
void	paint(Graphics2D gfx, Rectangle location)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NinePatch

public NinePatch(BufferedImage img)

Builds a NinePatch based on the given image. Figures out the NinePatch bounds by parsing the image: Opaque pixels in the top row and left column show the stretchable center. Opaque pixels in the bottom row and right column show the content area.

NinePatch

public NinePatch(BufferedImage img,
                 Rectangle center,
                 Rectangle content)

Builds a NinePatch based on the given image.

Parameters:

center - specifies the stretchable center of the image.

content - if non-null, specifies the usable content area of the image

Method Detail

paint

public void paint(Graphics2D gfx,
                  Rectangle location)

getBoundsSurrounding

public Rectangle getBoundsSurrounding(Rectangle content)

Returns a rectangle describing the bounds of this NinePatch when drawn such that it frames the given content rectangle.