class-description NEWS COMMUNITY STORE TUTORIALS SIGN UP LOGIN LOGOUT ROKOJORI NEWSLETTER SIGN UP LOGIN LOGOUT NEWS COMMUNITY STORE TUTORIALS TOGGLE FULLSCREEN VOLLBILD AN/AUS Rect2i
A 2D axis-aligned bounding box using integer coordinates.
The Rect2i built-in Variant type represents an axis-aligned rectangle in a 2D space, using integer coordinates. It is defined by its position and size, which are Vector2i. Because it does not rotate, it is frequently used for fast overlap tests (see intersects).
For floating-point coordinates, see Rect2.
Note: Negative values for size are not supported. With negative size, most Rect2i methods do not work correctly. Use abs to get an equivalent Rect2i with a non-negative size.
Note: In a boolean context, a Rect2i evaluates to false if both position and size are zero (equal to [constant Vector2i.ZERO]). Otherwise, it always evaluates to true.
set get Vector2i end<>():Vector2i set get
The ending point. This is usually the bottom-right corner of the rectangle, and is equivalent to position + size. Setting this point affects the size.

set get Vector2i position<>():Vector2i set get
The origin point. This is usually the top-left corner of the rectangle.

set get Vector2i size<>():Vector2i set get
The rectangle's width and height, starting from position. Setting this value also affects the end point.

Note: It's recommended setting the width and height to non-negative values, as most methods in Godot assume that the position is the top-left corner, and the end is the bottom-right corner. To get an equivalent rectangle with non-negative size, use abs.
Rect2i abs<>():Rect2i
Returns a Rect2i equivalent to this rectangle, with its width and height modified to be non-negative values, and with its position being the top-left corner of the rectangle.

var rect = Rect2i(25, 25, -100, -50) var absolute = rect.abs() # absolute is Rect2i(-75, -25, 100, 50)
var rect = new Rect2I(25, 25, -100, -50); var absolute = rect.Abs(); // absolute is Rect2I(-75, -25, 100, 50)

Note: It's recommended to use this method when size is negative, as most other methods in Godot assume that the position is the top-left corner, and the end is the bottom-right corner.
bool encloses<>( Rect2i b=, b:Rect2i=, ):bool
Returns true if this Rect2i completely encloses another one.

Rect2i expand<>( Vector2i to=, to:Vector2i=, ):Rect2i
Returns a copy of this rectangle expanded to align the edges with the given to point, if necessary.

var rect = Rect2i(0, 0, 5, 2) rect = rect.expand(Vector2i(10, 0)) # rect is Rect2i(0, 0, 10, 2) rect = rect.expand(Vector2i(-5, 5)) # rect is Rect2i(-5, 0, 15, 5)
var rect = new Rect2I(0, 0, 5, 2); rect = rect.Expand(new Vector2I(10, 0)); // rect is Rect2I(0, 0, 10, 2) rect = rect.Expand(new Vector2I(-5, 5)); // rect is Rect2I(-5, 0, 15, 5)

int get_area<>():int
Returns the rectangle's area. This is equivalent to size.x * size.y. See also has_area.

Vector2i get_center<>():Vector2i
Returns the center point of the rectangle. This is the same as position + (size / 2).

Note: If the size is odd, the result will be rounded towards position.
Rect2i grow<>( int amount=, amount:int=, ):Rect2i
Returns a copy of this rectangle extended on all sides by the given amount. A negative amount shrinks the rectangle instead. See also grow_individual and grow_side.

var a = Rect2i(4, 4, 8, 8).grow(4) # a is Rect2i(0, 0, 16, 16) var b = Rect2i(0, 0, 8, 4).grow(2) # b is Rect2i(-2, -2, 12, 8)
var a = new Rect2I(4, 4, 8, 8).Grow(4); // a is Rect2I(0, 0, 16, 16) var b = new Rect2I(0, 0, 8, 4).Grow(2); // b is Rect2I(-2, -2, 12, 8)

Rect2i grow_individual<>( int left=, left:int=, int top=, top:int=, int right=, right:int=, int bottom=, bottom:int=, ):Rect2i
Returns a copy of this rectangle with its left, top, right, and bottom sides extended by the given amounts. Negative values shrink the sides, instead. See also grow and grow_side.

Rect2i grow_side<>( int side=, side:int=, int amount=, amount:int=, ):Rect2i
Returns a copy of this rectangle with its side extended by the given amount (see Side constants). A negative amount shrinks the rectangle, instead. See also grow and grow_individual.

bool has_area<>():bool
Returns true if this rectangle has positive width and height. See also get_area.

bool has_point<>( Vector2i point=, point:Vector2i=, ):bool
Returns true if the rectangle contains the given point. By convention, points on the right and bottom edges are not included.

Note: This method is not reliable for Rect2i with a negative size. Use abs first to get a valid rectangle.
Rect2i intersection<>( Rect2i b=, b:Rect2i=, ):Rect2i
Returns the intersection between this rectangle and b. If the rectangles do not intersect, returns an empty Rect2i.

var a = Rect2i(0, 0, 5, 10) var b = Rect2i(2, 0, 8, 4) var c = a.intersection(b) # c is Rect2i(2, 0, 3, 4)
var a = new Rect2I(0, 0, 5, 10); var b = new Rect2I(2, 0, 8, 4); var c = rect1.Intersection(rect2); // c is Rect2I(2, 0, 3, 4)

Note: If you only need to know whether two rectangles are overlapping, use intersects, instead.
bool intersects<>( Rect2i b=, b:Rect2i=, ):bool
Returns true if this rectangle overlaps with the b rectangle. The edges of both rectangles are excluded.

Rect2i merge<>( Rect2i b=, b:Rect2i=, ):Rect2i
Returns a Rect2i that encloses both this rectangle and b around the edges. See also encloses.




All social media brands are registrated trademarks and belong to their respective owners.





CONTACT IMPRINT TERMS OF USE PRIVACY © ROKOROJI ® 2021 rokojori.com
CONTACT IMPRINT TERMS OF USE PRIVACY © ROKOROJI ® 2021 rokojori.com
We are using cookies on this site. Read more... Wir benutzen Cookies auf dieser Seite. Mehr lesen...