Class PDRectangle
- java.lang.Object
-
- com.tom_roush.pdfbox.pdmodel.common.PDRectangle
-
- All Implemented Interfaces:
COSObjectable
public class PDRectangle extends Object implements COSObjectable
A rectangle in a PDF document.
-
-
Field Summary
Fields Modifier and Type Field Description static PDRectangleA0A rectangle the size of A0 Paper.static PDRectangleA1A rectangle the size of A1 Paper.static PDRectangleA2A rectangle the size of A2 Paper.static PDRectangleA3A rectangle the size of A3 Paper.static PDRectangleA4A rectangle the size of A4 Paper.static PDRectangleA5A rectangle the size of A5 Paper.static PDRectangleA6A rectangle the size of A6 Paper.static PDRectangleLEGALA rectangle the size of U.S.static PDRectangleLETTERA rectangle the size of U.S.
-
Constructor Summary
Constructors Constructor Description PDRectangle()Constructor.PDRectangle(float width, float height)Constructor.PDRectangle(float x, float y, float width, float height)Constructor.PDRectangle(BoundingBox box)Constructor.PDRectangle(COSArray array)Constructor.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description booleancontains(float x, float y)Method to determine if the x/y point is inside this rectangle.PDRectanglecreateRetranslatedRectangle()This will create a translated rectangle based off of this rectangle, such that the new rectangle retains the same dimensions(height/width), but the lower left x,y values are zero.COSArraygetCOSArray()This will get the underlying array for this rectangle.COSBasegetCOSObject()Convert this standard java object to a COS object.floatgetHeight()This will get the height of this rectangle as calculated by upperRightY - lowerLeftY.floatgetLowerLeftX()This will get the lower left x coordinate.floatgetLowerLeftY()This will get the lower left y coordinate.floatgetUpperRightX()This will get the upper right x coordinate.floatgetUpperRightY()This will get the upper right y coordinate.floatgetWidth()This will get the width of this rectangle as calculated by upperRightX - lowerLeftX.voidmove(float horizontalAmount, float verticalAmount)This will move the rectangle the given relative amount.voidsetLowerLeftX(float value)This will set the lower left x coordinate.voidsetLowerLeftY(float value)This will set the lower left y coordinate.voidsetUpperRightX(float value)This will set the upper right x coordinate.voidsetUpperRightY(float value)This will set the upper right y coordinate.android.graphics.PathtoGeneralPath()Returns a general path equivalent to this rectangle.StringtoString()This will return a string representation of this rectangle.android.graphics.Pathtransform(Matrix matrix)Returns a copy of this rectangle which has been transformed using the given matrix.
-
-
-
Field Detail
-
LETTER
public static final PDRectangle LETTER
A rectangle the size of U.S. Letter, 8.5" x 11".
-
LEGAL
public static final PDRectangle LEGAL
A rectangle the size of U.S. Legal, 8.5" x 14".
-
A0
public static final PDRectangle A0
A rectangle the size of A0 Paper.
-
A1
public static final PDRectangle A1
A rectangle the size of A1 Paper.
-
A2
public static final PDRectangle A2
A rectangle the size of A2 Paper.
-
A3
public static final PDRectangle A3
A rectangle the size of A3 Paper.
-
A4
public static final PDRectangle A4
A rectangle the size of A4 Paper.
-
A5
public static final PDRectangle A5
A rectangle the size of A5 Paper.
-
A6
public static final PDRectangle A6
A rectangle the size of A6 Paper.
-
-
Constructor Detail
-
PDRectangle
public PDRectangle()
Constructor. Initializes to 0,0,0,0
-
PDRectangle
public PDRectangle(float width, float height)Constructor.- Parameters:
width- The width of the rectangle.height- The height of the rectangle.
-
PDRectangle
public PDRectangle(float x, float y, float width, float height)Constructor.- Parameters:
x- the x coordinate of the rectangley- the y coordinate of the rectanglewidth- The width of the rectangle.height- The height of the rectangle.
-
PDRectangle
public PDRectangle(BoundingBox box)
Constructor.- Parameters:
box- the bounding box to be used for the rectangle
-
PDRectangle
public PDRectangle(COSArray array)
Constructor.- Parameters:
array- An array of numbers as specified in the PDF Reference for a rectangle type.
-
-
Method Detail
-
contains
public boolean contains(float x, float y)Method to determine if the x/y point is inside this rectangle.- Parameters:
x- The x-coordinate to test.y- The y-coordinate to test.- Returns:
- True if the point is inside this rectangle.
-
createRetranslatedRectangle
public PDRectangle createRetranslatedRectangle()
This will create a translated rectangle based off of this rectangle, such that the new rectangle retains the same dimensions(height/width), but the lower left x,y values are zero.
100, 100, 400, 400 (llx, lly, urx, ury )
will be translated to 0,0,300,300- Returns:
- A new rectangle that has been translated back to the origin.
-
getCOSArray
public COSArray getCOSArray()
This will get the underlying array for this rectangle.- Returns:
- The cos array.
-
getLowerLeftX
public float getLowerLeftX()
This will get the lower left x coordinate.- Returns:
- The lower left x.
-
setLowerLeftX
public void setLowerLeftX(float value)
This will set the lower left x coordinate.- Parameters:
value- The lower left x.
-
getLowerLeftY
public float getLowerLeftY()
This will get the lower left y coordinate.- Returns:
- The lower left y.
-
setLowerLeftY
public void setLowerLeftY(float value)
This will set the lower left y coordinate.- Parameters:
value- The lower left y.
-
getUpperRightX
public float getUpperRightX()
This will get the upper right x coordinate.- Returns:
- The upper right x .
-
setUpperRightX
public void setUpperRightX(float value)
This will set the upper right x coordinate.- Parameters:
value- The upper right x .
-
getUpperRightY
public float getUpperRightY()
This will get the upper right y coordinate.- Returns:
- The upper right y.
-
setUpperRightY
public void setUpperRightY(float value)
This will set the upper right y coordinate.- Parameters:
value- The upper right y.
-
getWidth
public float getWidth()
This will get the width of this rectangle as calculated by upperRightX - lowerLeftX.- Returns:
- The width of this rectangle.
-
getHeight
public float getHeight()
This will get the height of this rectangle as calculated by upperRightY - lowerLeftY.- Returns:
- The height of this rectangle.
-
move
public void move(float horizontalAmount, float verticalAmount)This will move the rectangle the given relative amount.- Parameters:
horizontalAmount- positive values will move rectangle to the right, negative's to the left.verticalAmount- positive values will move the rectangle up, negative's down.
-
transform
public android.graphics.Path transform(Matrix matrix)
Returns a copy of this rectangle which has been transformed using the given matrix.
-
getCOSObject
public COSBase getCOSObject()
Convert this standard java object to a COS object.- Specified by:
getCOSObjectin interfaceCOSObjectable- Returns:
- The cos object that matches this Java object.
-
toGeneralPath
public android.graphics.Path toGeneralPath()
Returns a general path equivalent to this rectangle. This method avoids the problems caused by Rectangle2D not working well with -ve rectangles.
-
-