This object represents a box (a rectangular shape).
The definition of the attributes is: p1 is the lower left point, p2 the
upper right one. If a box is constructed from two points (or four coordinates), the
coordinates are sorted accordingly.
A box can be empty. An empty box represents no area
(not even a point). Empty boxes behave neutral with respect to most operations.
Empty boxes return true on empty?.
A box can be a point or a single
line. In this case, the area is zero but the box still
can overlap other boxes for example and it is not empty.
[const] | bool | != | (const DBox box) | Returns true if this box is not equal to the other box |
[const] | DBox | & | (const DBox box) | Returns the intersection of this box with another box |
[const] | DBox | * | (const DBox box) | Returns the convolution product from this box with another box |
[const] | DBox | * | (double scale_factor) | Returns the scaled box |
[const] | DBox | + | (const DPoint point) | Joins box with a point |
[const] | DBox | + | (const DBox box) | Joins two boxes |
[const] | bool | < | (const DBox box) | Returns true if this box is 'less' than another box |
[const] | bool | == | (const DBox box) | Returns true if this box is equal to the other box |
| void | _create | | Ensures the C++ object is created |
| void | _destroy | | Explicitly destroys the object |
[const] | bool | _destroyed? | | Returns a value indicating whether the object was already destroyed |
[const] | bool | _is_const_object? | | Returns a value indicating whether the reference is a const reference |
| void | _manage | | Marks the object as managed by the script side. |
| void | _unmanage | | Marks the object as no longer owned by the script side. |
[const] | double | area | | Computes the box area |
| void | assign | (const DBox other) | Assigns another object to self |
[const] | double | bottom | | Gets the bottom coordinate of the box |
| void | bottom= | (double c) | Sets the bottom coordinate of the box |
[const] | DPoint | center | | Gets the center of the box |
[const] | bool | contains? | (double x, double y) | Returns true if the box contains the given point |
[const] | bool | contains? | (const DPoint point) | Returns true if the box contains the given point |
[const] | new DBox ptr | dup | | Creates a copy of self |
[const] | bool | empty? | | Returns a value indicating whether the box is empty |
| DBox | enlarge | (double dx, double dy) | Enlarges the box by a certain amount. |
| DBox | enlarge | (const DVector enlargement) | Enlarges the box by a certain amount. |
[const] | DBox | enlarged | (double dx, double dy) | Enlarges the box by a certain amount. |
[const] | DBox | enlarged | (const DVector enlargement) | Returns the enlarged box. |
[const] | unsigned long | hash | | Computes a hash value |
[const] | double | height | | Gets the height of the box |
[const] | bool | inside? | (const DBox box) | Tests if this box is inside the argument box |
[const] | bool | is_point? | | Returns true, if the box is a single point |
[const] | double | left | | Gets the left coordinate of the box |
| void | left= | (double c) | Sets the left coordinate of the box |
| DBox | move | (double dx, double dy) | Moves the box by a certain distance |
| DBox | move | (const DVector distance) | Moves the box by a certain distance |
[const] | DBox | moved | (double dx, double dy) | Moves the box by a certain distance |
[const] | DBox | moved | (const DVector distance) | Returns the box moved by a certain distance |
[const] | bool | overlaps? | (const DBox box) | Tests if this box overlaps the argument box |
[const] | DPoint | p1 | | Gets the lower left point of the box |
| void | p1= | (const DPoint p) | Sets the lower left point of the box |
[const] | DPoint | p2 | | Gets the upper right point of the box |
| void | p2= | (const DPoint p) | Sets the upper right point of the box |
[const] | double | perimeter | | Returns the perimeter of the box |
[const] | double | right | | Gets the right coordinate of the box |
| void | right= | (double c) | Sets the right coordinate of the box |
[const] | Box | to_itype | (double dbu = 1) | Converts the box to an integer coordinate box |
[const] | string | to_s | | Returns a string representing this box |
[const] | double | top | | Gets the top coordinate of the box |
| void | top= | (double c) | Sets the top coordinate of the box |
[const] | bool | touches? | (const DBox box) | Tests if this box touches the argument box |
[const] | Box | transformed | (const VCplxTrans t) | Transforms the box with the given complex transformation |
[const] | DBox | transformed | (const DTrans t) | Returns the box transformed with the given simple transformation |
[const] | DBox | transformed | (const DCplxTrans t) | Returns the box transformed with the given complex transformation |
[const] | double | width | | Gets the width of the box |
!= | Signature: [const] bool != (const DBox box) Description: Returns true if this box is not equal to the other box Returns true, if this box and the given box are not equal |
& | Signature: [const] DBox & (const DBox box) Description: Returns the intersection of this box with another box box: | The box to take the intersection with | Returns: | The intersection box |
The intersection of two boxes is the largest
box common to both boxes. The intersection may be
empty if both boxes to not touch. If the boxes do
not overlap but touch the result may be a single
line or point with an area of zero. Overwrites this box
with the result. |
* | Signature: [const] DBox * (const DBox box) Description: Returns the convolution product from this box with another box box: | The box to convolve with this box. | Returns: | The convolved box |
The * operator convolves the firstbox with the one given as
the second argument. The box resulting from "convolution" is the
outer boundary of the union set formed by placing
the second box at every point of the first. In other words,
the returned box of (p1,p2)*(q1,q2) is (p1+q1,p2+q2). |
Signature: [const] DBox * (double scale_factor) Description: Returns the scaled box scale_factor: | The scaling factor | Returns: | The scaled box |
The * operator scales the box with the given factor and returns the result. This method has been introduced in version 0.22. |
+ | Signature: [const] DBox + (const DPoint point) Description: Joins box with a point point: | The point to join with this box. | Returns: | The box joined with the point |
The + operator joins a point with the box. The resulting box will enclose both the original box and the point. |
Signature: [const] DBox + (const DBox box) Description: Joins two boxes box: | The box to join with this box. | Returns: | The joined box |
The + operator joins the first box with the one given as
the second argument. Joining constructs a box that encloses
both boxes given. Empty boxes are neutral: they do not
change another box when joining. Overwrites this box
with the result. |
< | Signature: [const] bool < (const DBox box) Description: Returns true if this box is 'less' than another box Returns true, if this box is 'less' with respect to first and second point (in this order) |
== | Signature: [const] bool == (const DBox box) Description: Returns true if this box is equal to the other box Returns true, if this box and the given box are equal |
_create | Signature: void _create Description: Ensures the C++ object is created
Use this method to ensure the C++ object is created, for example to ensure that resources are allocated. Usually C++ objects are created on demand and not necessarily when the script object is created. |
_destroy | Signature: void _destroy Description: Explicitly destroys the object
Explicitly destroys the object on C++ side if it was owned by the script interpreter. Subsequent access to this object will throw an exception.
If the object is not owned by the script, this method will do nothing. |
_destroyed? | Signature: [const] bool _destroyed? Description: Returns a value indicating whether the object was already destroyed
This method returns true, if the object was destroyed, either explicitly or by the C++ side.
The latter may happen, if the object is owned by a C++ object which got destroyed itself. |
_is_const_object? | Signature: [const] bool _is_const_object? Description: Returns a value indicating whether the reference is a const reference
This method returns true, if self is a const reference.
In that case, only const methods may be called on self. |
_manage | Signature: void _manage Description: Marks the object as managed by the script side.
After calling this method on an object, the script side will be responsible for the management of the object. This method may be called if an object is returned from a C++ function and the object is known not to be owned by any C++ instance. If necessary, the script side may delete the object if the script's reference is no longer required. Usually it's not required to call this method. It has been introduced in version 0.24. |
_unmanage | Signature: void _unmanage Description: Marks the object as no longer owned by the script side.
Calling this method will make this object no longer owned by the script's memory management. Instead, the object must be managed in some other way. Usually this method may be called if it is known that some C++ object holds and manages this object. Technically speaking, this method will turn the script's reference into a weak reference. After the script engine decides to delete the reference, the object itself will still exist. If the object is not managed otherwise, memory leaks will occur. Usually it's not required to call this method. It has been introduced in version 0.24. |
area | Signature: [const] double area Description: Computes the box area Returns the box area or 0 if the box is empty |
assign | Signature: void assign (const DBox other) Description: Assigns another object to self |
bottom | Signature: [const] double bottom Description: Gets the bottom coordinate of the box Python specific notes: The object exposes a readable attribute 'bottom'. This is the getter.
|
bottom= | Signature: void bottom= (double c) Description: Sets the bottom coordinate of the box Python specific notes: The object exposes a writable attribute 'bottom'. This is the setter.
|
center | Signature: [const] DPoint center Description: Gets the center of the box |
contains? | Signature: [const] bool contains? (double x,double y) Description: Returns true if the box contains the given point Returns: | true if the point is inside the box. |
Tests whether a point (x, y) is inside the box.
It also returns true if the point is exactly on the box contour. |
Signature: [const] bool contains? (const DPoint point) Description: Returns true if the box contains the given point p: | The point to test against. | Returns: | true if the point is inside the box. |
Tests whether a point is inside the box.
It also returns true if the point is exactly on the box contour. |
create | Signature: void create Description: Ensures the C++ object is created Use of this method is deprecated. Use _create instead |
destroy | Signature: void destroy Description: Explicitly destroys the object Use of this method is deprecated. Use _destroy instead |
destroyed? | Signature: [const] bool destroyed? Description: Returns a value indicating whether the object was already destroyed Use of this method is deprecated. Use _destroyed? instead |
dup | Signature: [const] new DBox ptr dup Description: Creates a copy of self |
empty? | Signature: [const] bool empty? Description: Returns a value indicating whether the box is empty An empty box may be created with the default constructor for example. Such a box is neutral when combining it with other boxes and renders empty boxes if used in box intersections and false in geometrical relationship tests. |
enlarge | Signature: DBox enlarge (double dx,double dy) Description: Enlarges the box by a certain amount. Returns: | A reference to this box. |
This is a convenience method which takes two values instead of a Point object.
This method has been introduced in version 0.23. |
Signature: DBox enlarge (const DVector enlargement) Description: Enlarges the box by a certain amount. enlargement: | The grow or shrink amount in x and y direction | Returns: | A reference to this box. |
Enlarges the box by x and y value specified in the vector
passed. Positive values with grow the box, negative ones
will shrink the box. The result may be an empty box if the
box disappears. The amount specifies the grow or shrink
per edge. The width and height will change by twice the
amount.
Does not check for coordinate
overflows. |
enlarged | Signature: [const] DBox enlarged (double dx,double dy) Description: Enlarges the box by a certain amount. Returns: | The enlarged box. |
This is a convenience method which takes two values instead of a Point object.
This method has been introduced in version 0.23. |
Signature: [const] DBox enlarged (const DVector enlargement) Description: Returns the enlarged box. enlargement: | The grow or shrink amount in x and y direction | Returns: | The enlarged box. |
Enlarges the box by x and y value specified in the vector
passed. Positive values with grow the box, negative ones
will shrink the box. The result may be an empty box if the
box disappears. The amount specifies the grow or shrink
per edge. The width and height will change by twice the
amount.
Does not modify this box. Does not check for coordinate
overflows. |
from_ibox | Signature: [static] new DBox ptr from_ibox (const Box box) Description: Creates a floating-point coordinate box from an integer coordinate box Use of this method is deprecated. Use new instead Python specific notes: This method is the default initializer of the object
|
from_s | Signature: [static] new DBox ptr from_s (string s) Description: Creates a box object from a string Creates the object from a string representation (as returned by to_s) This method has been added in version 0.23.
|
hash | Signature: [const] unsigned long hash Description: Computes a hash value
Returns a hash value for the given box. This method enables boxes as hash keys. This method has been introduced in version 0.25.
Python specific notes: This method is also available as 'hash(object)'
|
height | Signature: [const] double height Description: Gets the height of the box |
inside? | Signature: [const] bool inside? (const DBox box) Description: Tests if this box is inside the argument box Returns true, if this box is inside the given box, i.e. the box intersection renders this box |
is_const_object? | Signature: [const] bool is_const_object? Description: Returns a value indicating whether the reference is a const reference Use of this method is deprecated. Use _is_const_object? instead |
is_point? | Signature: [const] bool is_point? Description: Returns true, if the box is a single point |
left | Signature: [const] double left Description: Gets the left coordinate of the box Python specific notes: The object exposes a readable attribute 'left'. This is the getter.
|
left= | Signature: void left= (double c) Description: Sets the left coordinate of the box Python specific notes: The object exposes a writable attribute 'left'. This is the setter.
|
move | Signature: DBox move (double dx,double dy) Description: Moves the box by a certain distance Returns: | A reference to this box. |
This is a convenience method which takes two values instead of a Point object.
This method has been introduced in version 0.23. |
Signature: DBox move (const DVector distance) Description: Moves the box by a certain distance distance: | The offset to move the box. | Returns: | A reference to this box. |
Moves the box by a given offset and returns the moved
box. Does not check for coordinate overflows. |
moved | Signature: [const] DBox moved (double dx,double dy) Description: Moves the box by a certain distance Returns: | The enlarged box. |
This is a convenience method which takes two values instead of a Point object.
This method has been introduced in version 0.23. |
Signature: [const] DBox moved (const DVector distance) Description: Returns the box moved by a certain distance distance: | The offset to move the box. | Returns: | The moved box. |
Moves the box by a given offset and returns the moved
box. Does not modify this box. Does not check for coordinate
overflows. |
new | Signature: [static] new DBox ptr new (const Box box) Description: Creates a floating-point coordinate box from an integer coordinate box This constructor has been introduced in version 0.25 and replaces the previous static method 'from_ibox'. Python specific notes: This method is the default initializer of the object
|
Signature: [static] new DBox ptr new Description: Creates an empty (invalid) box Empty boxes don't modify a box when joined with it. The intersection between an empty and any other box is also an empty box. The width, height, p1 and p2 attributes of an empty box are undefined. Use empty? to get a value indicating whether the box is empty.
Python specific notes: This method is the default initializer of the object
|
Signature: [static] new DBox ptr new (double left,double bottom,double right,double top) Description: Creates a box with four coordinates Four coordinates are given to create a new box. If the coordinates are not provided in the correct order (i.e. right < left), these are swapped. Python specific notes: This method is the default initializer of the object
|
Signature: [static] new DBox ptr new (const DPoint lower_left,const DPoint upper_right) Description: Creates a box from two points Two points are given to create a new box. If the coordinates are not provided in the correct order (i.e. right < left), these are swapped. Python specific notes: This method is the default initializer of the object
|
overlaps? | Signature: [const] bool overlaps? (const DBox box) Description: Tests if this box overlaps the argument box Returns true, if the intersection box of this box with the argument box exists and has a non-vanishing area |
p1 | Signature: [const] DPoint p1 Description: Gets the lower left point of the box Python specific notes: The object exposes a readable attribute 'p1'. This is the getter.
|
p1= | Signature: void p1= (const DPoint p) Description: Sets the lower left point of the box Python specific notes: The object exposes a writable attribute 'p1'. This is the setter.
|
p2 | Signature: [const] DPoint p2 Description: Gets the upper right point of the box Python specific notes: The object exposes a readable attribute 'p2'. This is the getter.
|
p2= | Signature: void p2= (const DPoint p) Description: Sets the upper right point of the box Python specific notes: The object exposes a writable attribute 'p2'. This is the setter.
|
perimeter | Signature: [const] double perimeter Description: Returns the perimeter of the box This method is equivalent to 2*(width+height). For empty boxes, this method returns 0. This method has been introduced in version 0.23. |
right | Signature: [const] double right Description: Gets the right coordinate of the box Python specific notes: The object exposes a readable attribute 'right'. This is the getter.
|
right= | Signature: void right= (double c) Description: Sets the right coordinate of the box Python specific notes: The object exposes a writable attribute 'right'. This is the setter.
|
to_itype | Signature: [const] Box to_itype (double dbu = 1) Description: Converts the box to an integer coordinate box The database unit can be specified to translate the floating-point coordinate box in micron units to an integer-coordinate box in database units. The boxes coordinates will be divided by the database unit. This method has been introduced in version 0.25. |
to_s | Signature: [const] string to_s Description: Returns a string representing this box This string can be turned into a box again by using from_s Python specific notes: This method is also available as 'str(object)' and 'repr(object)'
|
top | Signature: [const] double top Description: Gets the top coordinate of the box Python specific notes: The object exposes a readable attribute 'top'. This is the getter.
|
top= | Signature: void top= (double c) Description: Sets the top coordinate of the box Python specific notes: The object exposes a writable attribute 'top'. This is the setter.
|
touches? | Signature: [const] bool touches? (const DBox box) Description: Tests if this box touches the argument box Two boxes touch if they overlap or their boundaries share at least one common point. Touching is equivalent to a non-empty intersection ('!(b1 & b2).empty?'). |
transformed | Signature: [const] Box transformed (const VCplxTrans t) Description: Transforms the box with the given complex transformation t: | The magnifying transformation to apply | Returns: | The transformed box (in this case an integer coordinate box) |
This method has been introduced in version 0.25.
|
Signature: [const] DBox transformed (const DTrans t) Description: Returns the box transformed with the given simple transformation t: | The transformation to apply | Returns: | The transformed box |
|
Signature: [const] DBox transformed (const DCplxTrans t) Description: Returns the box transformed with the given complex transformation t: | The magnifying transformation to apply | Returns: | The transformed box (a DBox now) |
|
width | Signature: [const] double width Description: Gets the width of the box |