Region
open class Region : Parcelable
| kotlin.Any | |
| ↳ | android.graphics.Region |
Summary
| Nested classes | |
|---|---|
| Inherited constants | |
|---|---|
| Public constructors | |
|---|---|
Region()Create an empty region |
|
|
Return a region set to the specified rectangle |
|
|
Return a copy of the specified region |
|
|
Return a region set to the specified rectangle |
|
| Public methods | |
|---|---|
| open Boolean |
Return true if the region contains the specified point |
| open Int | |
| open Boolean | |
| open Path |
Return the boundary of the region as a new Path. |
| open Boolean |
getBoundaryPath(path: Path)Set the path to the boundary of the region. |
| open Rect |
Return a new Rect set to the bounds of the region. |
| open Boolean |
Set the Rect to the bounds of the region. |
| open Boolean |
Return true if the region contains more than one rectangle |
| open Boolean |
isEmpty()Return true if this region is empty |
| open Boolean |
isRect()Return true if the region contains a single rectangle |
| open Boolean |
Set this region to the result of performing the Op on the specified rect and region. |
| open Boolean |
Perform the specified Op on this region and the specified rect. |
| open Boolean |
Set this region to the result of performing the Op on the specified regions. |
| open Boolean |
Perform the specified Op on this region and the specified region. |
| open Boolean |
Perform the specified Op on this region and the specified rect. |
| open Boolean |
quickContains(r: Rect)Return true if the region is a single rectangle (not complex) and it contains the specified rectangle. |
| open Boolean |
quickContains(left: Int, top: Int, right: Int, bottom: Int)Return true if the region is a single rectangle (not complex) and it contains the specified rectangle. |
| open Boolean |
quickReject(r: Rect)Return true if the region is empty, or if the specified rectangle does not intersect the region. |
| open Boolean |
quickReject(rgn: Region!)Return true if the region is empty, or if the specified region does not intersect the region. |
| open Boolean |
quickReject(left: Int, top: Int, right: Int, bottom: Int)Return true if the region is empty, or if the specified rectangle does not intersect the region. |
| open Boolean |
Set the region to the specified rectangle |
| open Boolean |
Set the region to the specified region. |
| open Boolean |
Set the region to the specified rectangle |
| open Unit |
setEmpty()Set the region to the empty region |
| open Boolean |
Set the region to the area described by the path and clip. |
| open String |
toString() |
| open Unit |
Translate the region by [dx, dy]. |
| open Unit |
Set the dst region to the result of translating this region by [dx, dy]. |
| Boolean | |
| open Unit |
writeToParcel(p: Parcel, flags: Int)Write the region and its pixels to the parcel. |
| Protected methods | |
|---|---|
| open Unit |
finalize() |
| Properties | |
|---|---|
| static Parcelable.Creator<Region!> | |
Public constructors
Region
Region(r: Rect)
Return a region set to the specified rectangle
| Parameters | |
|---|---|
r |
Rect: This value cannot be null. |
Region
Region(region: Region)
Return a copy of the specified region
| Parameters | |
|---|---|
region |
Region: This value cannot be null. |
Region
Region(
left: Int,
top: Int,
right: Int,
bottom: Int)
Return a region set to the specified rectangle
Public methods
contains
open fun contains(
x: Int,
y: Int
): Boolean
Return true if the region contains the specified point
describeContents
open fun describeContents(): Int
| Return | |
|---|---|
Int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or android.os.Parcelable#CONTENTS_FILE_DESCRIPTOR |
equals
open fun equals(other: Any?): Boolean
| Parameters | |
|---|---|
obj |
the reference object with which to compare. |
| Return | |
|---|---|
Boolean |
true if this object is the same as the obj argument; false otherwise. |
getBoundaryPath
open fun getBoundaryPath(): Path
Return the boundary of the region as a new Path. If the region is empty, the path will also be empty.
| Return | |
|---|---|
Path |
This value cannot be null. |
getBoundaryPath
open fun getBoundaryPath(path: Path): Boolean
Set the path to the boundary of the region. If the region is empty, the path will also be empty.
| Parameters | |
|---|---|
path |
Path: This value cannot be null. |
getBounds
open fun getBounds(): Rect
Return a new Rect set to the bounds of the region. If the region is empty, the Rect will be set to [0, 0, 0, 0]
| Return | |
|---|---|
Rect |
This value cannot be null. |
getBounds
open fun getBounds(r: Rect): Boolean
Set the Rect to the bounds of the region. If the region is empty, the Rect will be set to [0, 0, 0, 0]
| Parameters | |
|---|---|
r |
Rect: This value cannot be null. |
isComplex
open fun isComplex(): Boolean
Return true if the region contains more than one rectangle
isRect
open fun isRect(): Boolean
Return true if the region contains a single rectangle
op
open fun op(
rect: Rect,
region: Region,
op: Region.Op
): Boolean
Set this region to the result of performing the Op on the specified rect and region. Return true if the result is not empty.
| Parameters | |
|---|---|
rect |
Rect: This value cannot be null. |
region |
Region: This value cannot be null. |
op |
Region.Op: This value cannot be null. |
op
open fun op(
r: Rect,
op: Region.Op
): Boolean
Perform the specified Op on this region and the specified rect. Return true if the result of the op is not empty.
| Parameters | |
|---|---|
r |
Rect: This value cannot be null. |
op |
Region.Op: This value cannot be null. |
op
open fun op(
region1: Region,
region2: Region,
op: Region.Op
): Boolean
Set this region to the result of performing the Op on the specified regions. Return true if the result is not empty.
| Parameters | |
|---|---|
region1 |
Region: This value cannot be null. |
region2 |
Region: This value cannot be null. |
op |
Region.Op: This value cannot be null. |
op
open fun op(
region: Region,
op: Region.Op
): Boolean
Perform the specified Op on this region and the specified region. Return true if the result of the op is not empty.
| Parameters | |
|---|---|
region |
Region: This value cannot be null. |
op |
Region.Op: This value cannot be null. |
op
open fun op(
left: Int,
top: Int,
right: Int,
bottom: Int,
op: Region.Op
): Boolean
Perform the specified Op on this region and the specified rect. Return true if the result of the op is not empty.
| Parameters | |
|---|---|
op |
Region.Op: This value cannot be null. |
quickContains
open fun quickContains(r: Rect): Boolean
Return true if the region is a single rectangle (not complex) and it contains the specified rectangle. Returning false is not a guarantee that the rectangle is not contained by this region, but return true is a guarantee that the rectangle is contained by this region.
| Parameters | |
|---|---|
r |
Rect: This value cannot be null. |
quickContains
open fun quickContains(
left: Int,
top: Int,
right: Int,
bottom: Int
): Boolean
Return true if the region is a single rectangle (not complex) and it contains the specified rectangle. Returning false is not a guarantee that the rectangle is not contained by this region, but return true is a guarantee that the rectangle is contained by this region.
quickReject
open fun quickReject(r: Rect): Boolean
Return true if the region is empty, or if the specified rectangle does not intersect the region. Returning false is not a guarantee that they intersect, but returning true is a guarantee that they do not.
| Parameters | |
|---|---|
r |
Rect: This value cannot be null. |
quickReject
open fun quickReject(rgn: Region!): Boolean
Return true if the region is empty, or if the specified region does not intersect the region. Returning false is not a guarantee that they intersect, but returning true is a guarantee that they do not.
quickReject
open fun quickReject(
left: Int,
top: Int,
right: Int,
bottom: Int
): Boolean
Return true if the region is empty, or if the specified rectangle does not intersect the region. Returning false is not a guarantee that they intersect, but returning true is a guarantee that they do not.
set
open fun set(r: Rect): Boolean
Set the region to the specified rectangle
| Parameters | |
|---|---|
r |
Rect: This value cannot be null. |
set
open fun set(region: Region): Boolean
Set the region to the specified region.
| Parameters | |
|---|---|
region |
Region: This value cannot be null. |
set
open fun set(
left: Int,
top: Int,
right: Int,
bottom: Int
): Boolean
Set the region to the specified rectangle
setPath
open fun setPath(
path: Path,
clip: Region
): Boolean
Set the region to the area described by the path and clip. Return true if the resulting region is non-empty. This produces a region that is identical to the pixels that would be drawn by the path (with no antialiasing).
| Parameters | |
|---|---|
path |
Path: This value cannot be null. |
clip |
Region: This value cannot be null. |
toString
open fun toString(): String
| Return | |
|---|---|
String |
a string representation of the object. |
translate
open fun translate(
dx: Int,
dy: Int
): Unit
Translate the region by [dx, dy]. If the region is empty, do nothing.
translate
open fun translate(
dx: Int,
dy: Int,
dst: Region!
): Unit
Set the dst region to the result of translating this region by [dx, dy]. If this region is empty, then dst will be set to empty.
union
fun union(r: Rect): Boolean
| Parameters | |
|---|---|
r |
Rect: This value cannot be null. |
writeToParcel
open fun writeToParcel(
p: Parcel,
flags: Int
): Unit
Write the region and its pixels to the parcel. The region can be rebuilt from the parcel by calling CREATOR.createFromParcel().
| Parameters | |
|---|---|
dest |
The Parcel in which the object should be written. This value cannot be null. |
flags |
Int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE. Value is either 0 or a combination of android.os.Parcelable#PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES |
p |
Parcel: Parcel object to write the region data into |
Protected methods
finalize
protected open fun finalize(): Unit
| Exceptions | |
|---|---|
java.lang.Throwable |
the Exception raised by this method |