2017-10-09 18:07:42 +00:00
SkIRect Reference
===
2018-10-16 14:30:28 +00:00
2018-10-08 18:57:48 +00:00
< a name = 'SkIRect' > < / a >
2018-10-16 14:30:28 +00:00
---
2018-10-08 18:57:48 +00:00
< pre style = "padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0 " >
struct < a href = '#SkIRect' > SkIRect< / a > {
int32_t < a href = '#SkIRect_fLeft' > fLeft< / a > ;
int32_t < a href = '#SkIRect_fTop' > fTop< / a > ;
int32_t < a href = '#SkIRect_fRight' > fRight< / a > ;
int32_t < a href = '#SkIRect_fBottom' > fBottom< / a > ;
static constexpr < a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_MakeEmpty' > MakeEmpty< / a > ();
static constexpr < a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_MakeWH' > MakeWH< / a > (int32_t w, int32_t h);
static constexpr < a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_MakeSize' > MakeSize< / a > (const < a href = 'undocumented#SkISize' > SkISize< / a > & size);
static constexpr < a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_MakeLTRB' > MakeLTRB< / a > (int32_t l, int32_t t,
int32_t r, int32_t b);
static constexpr < a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_MakeXYWH' > MakeXYWH< / a > (int32_t x, int32_t y,
int32_t w, int32_t h);
int32_t < a href = '#SkIRect_left' > left< / a > () const;
int32_t < a href = '#SkIRect_top' > top< / a > () const;
int32_t < a href = '#SkIRect_right' > right< / a > () const;
int32_t < a href = '#SkIRect_bottom' > bottom< / a > () const;
int32_t < a href = '#SkIRect_x' > x< / a > () const;
int32_t < a href = '#SkIRect_y' > y< / a > () const;
int32_t < a href = '#SkIRect_width' > width< / a > () const;
int32_t < a href = '#SkIRect_height' > height< / a > () const;
< a href = 'undocumented#SkISize' > SkISize< / a > < a href = '#SkIRect_size' > size< / a > () const;
int64_t < a href = '#SkIRect_width64' > width64< / a > () const;
int64_t < a href = '#SkIRect_height64' > height64< / a > () const;
bool < a href = '#SkIRect_isEmpty64' > isEmpty64< / a > () const;
bool < a href = '#SkIRect_isEmpty' > isEmpty< / a > () const;
friend bool < a href = '#SkIRect_equal_operator' > operator==(const SkIRect& a, const SkIRect& b)< / a > ;
friend bool < a href = '#SkIRect_notequal_operator' > operator!=(const SkIRect& a, const SkIRect& b)< / a > ;
void < a href = '#SkIRect_setEmpty' > setEmpty< / a > ();
void < a href = '#SkIRect_set' > set< / a > (int32_t left, int32_t top, int32_t right, int32_t bottom);
void < a href = '#SkIRect_setLTRB' > setLTRB< / a > (int32_t left, int32_t top, int32_t right, int32_t bottom);
void < a href = '#SkIRect_setXYWH' > setXYWH< / a > (int32_t x, int32_t y, int32_t width, int32_t height);
< a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_makeOffset' > makeOffset< / a > (int32_t dx, int32_t dy) const;
< a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_makeInset' > makeInset< / a > (int32_t dx, int32_t dy) const;
< a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_makeOutset' > makeOutset< / a > (int32_t dx, int32_t dy) const;
void < a href = '#SkIRect_offset' > offset< / a > (int32_t dx, int32_t dy);
void < a href = '#SkIRect_offset_2' > offset< / a > (const < a href = 'SkIPoint_Reference#SkIPoint' > SkIPoint< / a > & delta);
void < a href = '#SkIRect_offsetTo' > offsetTo< / a > (int32_t newX, int32_t newY);
void < a href = '#SkIRect_inset' > inset< / a > (int32_t dx, int32_t dy);
void < a href = '#SkIRect_outset' > outset< / a > (int32_t dx, int32_t dy);
void < a href = '#SkIRect_adjust' > adjust< / a > (int32_t dL, int32_t dT, int32_t dR, int32_t dB);
bool < a href = '#SkIRect_contains' > contains< / a > (int32_t x, int32_t y) const;
bool < a href = '#SkIRect_contains_2' > contains< / a > (int32_t left, int32_t top, int32_t right, int32_t bottom) const;
bool < a href = '#SkIRect_contains_3' > contains< / a > (const < a href = '#SkIRect' > SkIRect< / a > & r) const;
bool < a href = '#SkIRect_contains_4' > contains< / a > (const < a href = 'SkRect_Reference#SkRect' > SkRect< / a > & r) const;
bool < a href = '#SkIRect_containsNoEmptyCheck' > containsNoEmptyCheck< / a > (int32_t left, int32_t top,
int32_t right, int32_t bottom) const;
bool < a href = '#SkIRect_containsNoEmptyCheck_2' > containsNoEmptyCheck< / a > (const < a href = '#SkIRect' > SkIRect< / a > & r) const;
bool < a href = '#SkIRect_intersect' > intersect< / a > (const < a href = '#SkIRect' > SkIRect< / a > & r);
bool < a href = '#SkIRect_intersectNoEmptyCheck' > intersectNoEmptyCheck< / a > (const < a href = '#SkIRect' > SkIRect< / a > & a, const < a href = '#SkIRect' > SkIRect< / a > & b);
bool < a href = '#SkIRect_intersect_2' > intersect< / a > (const < a href = '#SkIRect' > SkIRect< / a > & a, const < a href = '#SkIRect' > SkIRect< / a > & b);
bool < a href = '#SkIRect_intersect_3' > intersect< / a > (int32_t left, int32_t top, int32_t right, int32_t bottom);
static bool < a href = '#SkIRect_Intersects' > Intersects< / a > (const < a href = '#SkIRect' > SkIRect< / a > & a, const < a href = '#SkIRect' > SkIRect< / a > & b);
static bool < a href = '#SkIRect_IntersectsNoEmptyCheck' > IntersectsNoEmptyCheck< / a > (const < a href = '#SkIRect' > SkIRect< / a > & a, const < a href = '#SkIRect' > SkIRect< / a > & b);
void < a href = '#SkIRect_join' > join< / a > (int32_t left, int32_t top, int32_t right, int32_t bottom);
void < a href = '#SkIRect_join_2' > join< / a > (const < a href = '#SkIRect' > SkIRect< / a > & r);
void < a href = '#SkIRect_sort' > sort< / a > ();
< a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_makeSorted' > makeSorted< / a > () const;
static const < a href = '#SkIRect' > SkIRect< / a > & < a href = '#SkIRect_EmptyIRect' > EmptyIRect< / a > ();
};
< / pre >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect' > SkIRect< / a > holds four 32-bit integer coordinates describing the upper and
lower bounds of a rectangle. < a href = '#SkIRect' > SkIRect< / a > may be created from outer bounds or
from position, width, and height. < a href = '#SkIRect' > SkIRect< / a > describes an area; if its right
is less than or equal to its left, or if its bottom is less than or equal to
2018-10-16 14:30:28 +00:00
its top, it is considered empty.< table style = 'border-collapse: collapse; width: 62.5em' >
2018-05-16 11:07:07 +00:00
< tr >< th style = 'text-align: left; border: 2px solid #dddddd ; padding: 8px; ' > Type</ th >
2018-10-08 18:57:48 +00:00
< th style = 'text-align: left; border: 2px solid #dddddd ; padding: 8px; ' > Member</ th >
2018-05-16 11:07:07 +00:00
< th style = 'text-align: left; border: 2px solid #dddddd ; padding: 8px; ' > Description</ th ></ tr >
< tr style = 'background-color: #f0f0f0 ; ' >
< td style = 'text-align: left; border: 2px solid #dddddd ; padding: 8px; ' > int32_t</ td >
< td style = 'text-align: left; border: 2px solid #dddddd ; padding: 8px; ' >< a name = 'SkIRect_fLeft' >< code > fLeft</ code ></ a ></ td >
< td style = 'text-align: left; border: 2px solid #dddddd ; padding: 8px; ' >
May contain any value. The smaller of the horizontal values when sorted.
When equal to or greater than < a href = '#SkIRect_fRight' > fRight< / a > , < a href = '#IRect' > IRect< / a > is empty.
< / td >
< / tr >
< tr >
< td style = 'text-align: left; border: 2px solid #dddddd ; padding: 8px; ' > int32_t</ td >
< td style = 'text-align: left; border: 2px solid #dddddd ; padding: 8px; ' >< a name = 'SkIRect_fTop' >< code > fTop</ code ></ a ></ td >
< td style = 'text-align: left; border: 2px solid #dddddd ; padding: 8px; ' >
May contain any value. The smaller of the horizontal values when sorted.
When equal to or greater than < a href = '#SkIRect_fBottom' > fBottom< / a > , < a href = '#IRect' > IRect< / a > is empty.
< / td >
< / tr >
< tr style = 'background-color: #f0f0f0 ; ' >
< td style = 'text-align: left; border: 2px solid #dddddd ; padding: 8px; ' > int32_t</ td >
< td style = 'text-align: left; border: 2px solid #dddddd ; padding: 8px; ' >< a name = 'SkIRect_fRight' >< code > fRight</ code ></ a ></ td >
< td style = 'text-align: left; border: 2px solid #dddddd ; padding: 8px; ' >
May contain any value. The larger of the vertical values when sorted.
When equal to or less than < a href = '#SkIRect_fLeft' > fLeft< / a > , < a href = '#IRect' > IRect< / a > is empty.
< / td >
< / tr >
< tr >
< td style = 'text-align: left; border: 2px solid #dddddd ; padding: 8px; ' > int32_t</ td >
< td style = 'text-align: left; border: 2px solid #dddddd ; padding: 8px; ' >< a name = 'SkIRect_fBottom' >< code > fBottom</ code ></ a ></ td >
< td style = 'text-align: left; border: 2px solid #dddddd ; padding: 8px; ' >
2017-10-09 18:07:42 +00:00
May contain any value. The larger of the vertical values when sorted.
2018-05-16 11:07:07 +00:00
When equal to or less than < a href = '#SkIRect_fTop' > fTop< / a > , < a href = '#IRect' > IRect< / a > is empty.
< / td >
< / tr >
2018-10-16 14:30:28 +00:00
< / table >
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_MakeEmpty' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
2018-10-08 18:57:48 +00:00
static constexpr < a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_MakeEmpty' > MakeEmpty< / a > ()
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > set to (0, 0, 0, 0).
2018-01-26 17:56:22 +00:00
Many other rectangles are empty; if left is equal to or greater than right,
or if top is equal to or greater than bottom. Setting all members to zero
2017-10-09 18:07:42 +00:00
is a convenience, but does not designate a special empty rectangle.
### Return Value
bounds (0, 0, 0, 0)
### Example
< div > < fiddle-embed name = "0ade3971c1d2616564992e286966ec8a" >
#### Example Output
~~~~
MakeEmpty isEmpty: true
offset rect isEmpty: true
inset rect isEmpty: true
outset rect isEmpty: false
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_EmptyIRect' > EmptyIRect< / a > < a href = '#SkIRect_isEmpty' > isEmpty< / a > < a href = '#SkIRect_setEmpty' > setEmpty< / a > < a href = 'SkRect_Reference#SkRect_MakeEmpty' > SkRect::MakeEmpty< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_MakeWH' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
2018-10-08 18:57:48 +00:00
static constexpr < a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_MakeWH' > MakeWH< / a > (int32_t w, int32_t h)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > set to (0, 0, < a href = '#SkIRect_MakeWH_w' > w< / a > , < a href = '#SkIRect_MakeWH_h' > h< / a > ). Does not validate input; < a href = '#SkIRect_MakeWH_w' > w< / a > or < a href = '#SkIRect_MakeWH_h' > h< / a >
2017-10-09 18:07:42 +00:00
may be negative.
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_MakeWH_w' > < code > < strong > w< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > width of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_MakeWH_h' > < code > < strong > h< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > height of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-05-16 11:07:07 +00:00
bounds (0, 0, < a href = '#SkIRect_MakeWH_w' > w< / a > , < a href = '#SkIRect_MakeWH_h' > h< / a > )
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "e36827a1a6ae2b1c26e7a8a08f325a07" >
#### Example Output
~~~~
all equal
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_MakeSize' > MakeSize< / a > < a href = '#SkIRect_MakeXYWH' > MakeXYWH< / a > < a href = 'SkRect_Reference#SkRect_MakeWH' > SkRect::MakeWH< / a > < a href = 'SkRect_Reference#SkRect_MakeIWH' > SkRect::MakeIWH< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_MakeSize' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
2018-10-08 18:57:48 +00:00
static constexpr < a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_MakeSize' > MakeSize< / a > (const < a href = 'undocumented#SkISize' > SkISize< / a > & size)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > set to (0, 0, < a href = '#SkIRect_MakeSize_size' > size< / a > .< a href = '#SkISize_width' > width()< / a > , < a href = '#SkIRect_MakeSize_size' > size< / a > .< a href = '#SkISize_height' > height()< / a > ).
Does not validate input; < a href = '#SkIRect_MakeSize_size' > size< / a > .< a href = '#SkISize_width' > width()< / a > or < a href = '#SkIRect_MakeSize_size' > size< / a > .< a href = '#SkISize_height' > height()< / a > may be negative.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_MakeSize_size' > < code > < strong > size< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > values for < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > width and height< / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-10-31 16:14:03 +00:00
bounds (0, 0, < a href = '#SkIRect_MakeSize_size' > size< / a > .< a href = '#SkISize_width' > width()< / a > , < a href = '#SkIRect_MakeSize_size' > size< / a > .< a href = '#SkISize_height' > height()< / a > )
2017-10-09 18:07:42 +00:00
### Example
2018-07-08 05:32:09 +00:00
< div > < fiddle-embed name = "c6586ff8d24869c780169b0d19c75df6" >
2017-10-09 18:07:42 +00:00
#### Example Output
~~~~
round width: 26 height: 36
floor width: 25 height: 35
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_MakeWH' > MakeWH< / a > < a href = '#SkIRect_MakeXYWH' > MakeXYWH< / a > < a href = 'SkRect_Reference#SkRect_Make' > SkRect::Make< / a > < sup > < a href = 'SkRect_Reference#SkRect_Make_2' > [2]< / a > < / sup > < a href = 'SkRect_Reference#SkRect_MakeIWH' > SkRect::MakeIWH< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_MakeLTRB' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
2018-10-08 18:57:48 +00:00
static constexpr < a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_MakeLTRB' > MakeLTRB< / a > (int32_t l, int32_t t, int32_t r, int32_t b)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > set to (< a href = '#SkIRect_MakeLTRB_l' > l< / a > , < a href = '#SkIRect_MakeLTRB_t' > t< / a > , < a href = '#SkIRect_MakeLTRB_r' > r< / a > , < a href = '#SkIRect_MakeLTRB_b' > b< / a > ). Does not sort input; < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > may
2018-05-16 11:07:07 +00:00
result in < a href = '#SkIRect_fLeft' > fLeft< / a > greater than < a href = '#SkIRect_fRight' > fRight< / a > , or < a href = '#SkIRect_fTop' > fTop< / a > greater than < a href = '#SkIRect_fBottom' > fBottom< / a > .
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_MakeLTRB_l' > < code > < strong > l< / strong > < / code > < / a > < / td >
< td > integer stored in < a href = '#SkIRect_fLeft' > fLeft< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_MakeLTRB_t' > < code > < strong > t< / strong > < / code > < / a > < / td >
< td > integer stored in < a href = '#SkIRect_fTop' > fTop< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_MakeLTRB_r' > < code > < strong > r< / strong > < / code > < / a > < / td >
< td > integer stored in < a href = '#SkIRect_fRight' > fRight< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_MakeLTRB_b' > < code > < strong > b< / strong > < / code > < / a > < / td >
< td > integer stored in < a href = '#SkIRect_fBottom' > fBottom< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-05-16 11:07:07 +00:00
bounds (< a href = '#SkIRect_MakeLTRB_l' > l< / a > , < a href = '#SkIRect_MakeLTRB_t' > t< / a > , < a href = '#SkIRect_MakeLTRB_r' > r< / a > , < a href = '#SkIRect_MakeLTRB_b' > b< / a > )
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "ec1473b700c594f2df9749a12a06b89b" >
#### Example Output
~~~~
rect: 5, 35, 15, 25 isEmpty: true
rect: 5, 25, 15, 35 isEmpty: false
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_MakeXYWH' > MakeXYWH< / a > < a href = 'SkRect_Reference#SkRect_MakeLTRB' > SkRect::MakeLTRB< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_MakeXYWH' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
2018-10-08 18:57:48 +00:00
static constexpr < a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_MakeXYWH' > MakeXYWH< / a > (int32_t x, int32_t y, int32_t w, int32_t h)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > set to: (< a href = '#SkIRect_MakeXYWH_x' > x< / a > , < a href = '#SkIRect_MakeXYWH_y' > y< / a > , < a href = '#SkIRect_MakeXYWH_x' > x< / a > + < a href = '#SkIRect_MakeXYWH_w' > w< / a > , < a href = '#SkIRect_MakeXYWH_y' > y< / a > + < a href = '#SkIRect_MakeXYWH_h' > h< / a > ).
Condense embedded formulas.
Bookmaker delimits formulas and equations to allow
representing variables and symbols without tripping
up reference lookup, spell checking, and comment
generation.
Before, formulas were represented with:
some text
#Formula
(x + y, 0)
##
, and more text
This made it difficult to know when spacing should
be preserved before and after the formula. Now,
formulas are represented with:
some text #Formula # (x + y, 0) ##, and more text
The presence or absence of a space between ## and ,
is now significant (before it was not).
Also, formulas are bracketed by <code> in markdown
generation, so that variables stand out better.
See:
https://skia.org/user/api/SkBlendMode_Reference?cl=152781#Dst_Out
for an example.
Also fixed 100 column offenders and added a code
check to identify them. For the moment, 100 column
offenders are outed with SkDebugf but their presence
does not cause bookmaker to fail.
TBR=caryclark@google.com
Docs-Preview: https://skia.org/?cl=152781
Bug: skia:6898
Change-Id: If92a65a234f5d616bf4485984a8d219a6f04821a
Reviewed-on: https://skia-review.googlesource.com/152781
Commit-Queue: Cary Clark <caryclark@skia.org>
Auto-Submit: Cary Clark <caryclark@skia.org>
Reviewed-by: Cary Clark <caryclark@skia.org>
2018-09-13 16:04:30 +00:00
Does not validate input; < a href = '#SkIRect_MakeXYWH_w' > w< / a > or < a href = '#SkIRect_MakeXYWH_h' > h< / a > may be negative.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_MakeXYWH_x' > < code > < strong > x< / strong > < / code > < / a > < / td >
< td > stored in < a href = '#SkIRect_fLeft' > fLeft< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_MakeXYWH_y' > < code > < strong > y< / strong > < / code > < / a > < / td >
< td > stored in < a href = '#SkIRect_fTop' > fTop< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_MakeXYWH_w' > < code > < strong > w< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > added to < a href = '#SkIRect_MakeXYWH_x' > x< / a > and stored in < a href = '#SkIRect_fRight' > fRight< / a > < / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_MakeXYWH_h' > < code > < strong > h< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > added to < a href = '#SkIRect_MakeXYWH_y' > y< / a > and stored in < a href = '#SkIRect_fBottom' > fBottom< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-10-31 16:14:03 +00:00
bounds at (< a href = '#SkIRect_MakeXYWH_x' > x< / a > , < a href = '#SkIRect_MakeXYWH_y' > y< / a > ) with width < a href = '#SkIRect_MakeXYWH_w' > w< / a > and height < a href = '#SkIRect_MakeXYWH_h' > h< / a >
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "598ee14350bd1d961cae6b36fa3df17e" >
#### Example Output
~~~~
rect: 5, 35, -10, 60 isEmpty: true
rect: -10, 35, 5, 60 isEmpty: false
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_MakeLTRB' > MakeLTRB< / a > < a href = 'SkRect_Reference#SkRect_MakeXYWH' > SkRect::MakeXYWH< / a >
2017-10-09 18:07:42 +00:00
2018-10-16 14:30:28 +00:00
< a name = 'Property' > < / a >
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_left' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
int32_t < a href = '#SkIRect_left' > left< / a > () const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns left edge of < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > , if sorted.
Call < a href = '#SkIRect_sort' > sort()< / a > to reverse < a href = '#SkIRect_fLeft' > fLeft< / a > and < a href = '#SkIRect_fRight' > fRight< / a > if needed.
2017-10-09 18:07:42 +00:00
### Return Value
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_fLeft' > fLeft< / a >
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "caf38ea4431bc246ba198f6a8c2b0f01" >
#### Example Output
~~~~
unsorted.fLeft: 15 unsorted.left(): 15
sorted.fLeft: 10 sorted.left(): 10
~~~~
< / fiddle-embed > < / div >
### See Also
2018-10-08 18:57:48 +00:00
< a href = '#SkIRect_fLeft' > fLeft< / a > < a href = '#SkIRect_x' > x< / a > () < a href = 'SkRect_Reference#SkRect_left' > SkRect::left< / a > ()
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_top' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
int32_t < a href = '#SkIRect_top' > top< / a > () const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns top edge of < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > , if sorted. Call < a href = '#SkIRect_isEmpty' > isEmpty< / a > () to see if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > may be invalid,
and < a href = '#SkIRect_sort' > sort()< / a > to reverse < a href = '#SkIRect_fTop' > fTop< / a > and < a href = '#SkIRect_fBottom' > fBottom< / a > if needed.
2017-10-09 18:07:42 +00:00
### Return Value
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_fTop' > fTop< / a >
2017-10-09 18:07:42 +00:00
### Example
2018-07-07 05:34:31 +00:00
< div > < fiddle-embed name = "cbec1ae6530e95943775450b1d11f19e" >
2017-10-09 18:07:42 +00:00
#### Example Output
~~~~
unsorted.fTop: 25 unsorted.top(): 25
sorted.fTop: 5 sorted.top(): 5
~~~~
< / fiddle-embed > < / div >
### See Also
2018-10-08 18:57:48 +00:00
< a href = '#SkIRect_fTop' > fTop< / a > < a href = '#SkIRect_y' > y< / a > () < a href = 'SkRect_Reference#SkRect_top' > SkRect::top< / a > ()
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_right' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
int32_t < a href = '#SkIRect_right' > right< / a > () const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns right edge of < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > , if sorted.
Call < a href = '#SkIRect_sort' > sort()< / a > to reverse < a href = '#SkIRect_fLeft' > fLeft< / a > and < a href = '#SkIRect_fRight' > fRight< / a > if needed.
2017-10-09 18:07:42 +00:00
### Return Value
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_fRight' > fRight< / a >
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "97e210976f1ee0387b30c70635cf114f" >
#### Example Output
~~~~
unsorted.fRight: 10 unsorted.right(): 10
sorted.fRight: 15 sorted.right(): 15
~~~~
< / fiddle-embed > < / div >
### See Also
2018-10-08 18:57:48 +00:00
< a href = '#SkIRect_fRight' > fRight< / a > < a href = 'SkRect_Reference#SkRect_right' > SkRect::right< / a > ()
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_bottom' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
int32_t < a href = '#SkIRect_bottom' > bottom< / a > () const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns bottom edge of < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > , if sorted. Call < a href = '#SkIRect_isEmpty' > isEmpty< / a > () to see if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > may be invalid,
and < a href = '#SkIRect_sort' > sort()< / a > to reverse < a href = '#SkIRect_fTop' > fTop< / a > and < a href = '#SkIRect_fBottom' > fBottom< / a > if needed.
2017-10-09 18:07:42 +00:00
### Return Value
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_fBottom' > fBottom< / a >
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "c32afebc296054a181621648a184b8e3" >
#### Example Output
~~~~
unsorted.fBottom: 5 unsorted.bottom(): 5
sorted.fBottom: 25 sorted.bottom(): 25
~~~~
< / fiddle-embed > < / div >
### See Also
2018-10-08 18:57:48 +00:00
< a href = '#SkIRect_fBottom' > fBottom< / a > < a href = 'SkRect_Reference#SkRect_bottom' > SkRect::bottom< / a > ()
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_x' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
int32_t < a href = '#SkIRect_x' > x< / a > () const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns left edge of < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > , if sorted. Call < a href = '#SkIRect_isEmpty' > isEmpty< / a > () to see if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > may be invalid,
and < a href = '#SkIRect_sort' > sort()< / a > to reverse < a href = '#SkIRect_fLeft' > fLeft< / a > and < a href = '#SkIRect_fRight' > fRight< / a > if needed.
2017-10-09 18:07:42 +00:00
### Return Value
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_fLeft' > fLeft< / a >
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "2a59cbfd1330a0db520d6ebb2b7c68c7" >
#### Example Output
~~~~
unsorted.fLeft: 15 unsorted.x(): 15
sorted.fLeft: 10 sorted.x(): 10
~~~~
< / fiddle-embed > < / div >
### See Also
2018-10-08 18:57:48 +00:00
< a href = '#SkIRect_fLeft' > fLeft< / a > < a href = '#SkIRect_left' > left< / a > () < a href = '#SkIRect_y' > y< / a > () < a href = 'SkRect_Reference#SkRect_x' > SkRect::x< / a > ()
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_y' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
int32_t < a href = '#SkIRect_y' > y< / a > () const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns top edge of < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > , if sorted. Call < a href = '#SkIRect_isEmpty' > isEmpty< / a > () to see if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > may be invalid,
and < a href = '#SkIRect_sort' > sort()< / a > to reverse < a href = '#SkIRect_fTop' > fTop< / a > and < a href = '#SkIRect_fBottom' > fBottom< / a > if needed.
2017-10-09 18:07:42 +00:00
### Return Value
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_fTop' > fTop< / a >
2017-10-09 18:07:42 +00:00
### Example
2018-07-05 05:35:27 +00:00
< div > < fiddle-embed name = "6ea461e71f7fc80605818fbf493caa63" >
2017-10-09 18:07:42 +00:00
#### Example Output
~~~~
unsorted.fTop: 25 unsorted.y(): 25
sorted.fTop: 5 sorted.y(): 5
~~~~
< / fiddle-embed > < / div >
### See Also
2018-10-08 18:57:48 +00:00
< a href = '#SkIRect_fTop' > fTop< / a > < a href = '#SkIRect_top' > top< / a > () < a href = '#SkIRect_x' > x< / a > () < a href = 'SkRect_Reference#SkRect_y' > SkRect::y< / a > ()
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_width' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
int32_t < a href = '#SkIRect_width' > width< / a > () const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns span on the x-axis. This does not check if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is sorted, or if
2017-10-09 18:07:42 +00:00
result fits in 32-bit signed integer; result may be negative.
### Return Value
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_fRight' > fRight< / a > minus < a href = '#SkIRect_fLeft' > fLeft< / a >
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "4acfbe051805940210c8916a94794142" >
#### Example Output
~~~~
unsorted width: -5
large width: -5
~~~~
< / fiddle-embed > < / div >
### See Also
2018-10-08 18:57:48 +00:00
< a href = '#SkIRect_height' > height< / a > () < a href = '#SkIRect_width64' > width64< / a > () < a href = '#SkIRect_height64' > height64< / a > () < a href = 'SkRect_Reference#SkRect_width' > SkRect::width< / a > ()
2018-01-11 15:35:44 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_width64' > < / a >
2018-10-16 14:30:28 +00:00
---
2018-01-11 15:35:44 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
int64_t < a href = '#SkIRect_width64' > width64< / a > () const
2018-01-11 15:35:44 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns span on the x-axis. This does not check if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is sorted, so the
result may be negative. This is safer than calling < a href = '#SkIRect_width' > width()< / a > since < a href = '#SkIRect_width' > width()< / a > might
2018-01-11 15:35:44 +00:00
overflow in its calculation.
### Return Value
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_fRight' > fRight< / a > minus < a href = '#SkIRect_fLeft' > fLeft< / a > cast to int64_t
2018-01-11 15:35:44 +00:00
2018-04-03 12:43:27 +00:00
### Example
2018-07-16 12:12:01 +00:00
< div > < fiddle-embed name = "63977f97999bbd6eecfdcc7575d75492" >
2018-01-11 15:35:44 +00:00
#### Example Output
~~~~
width: -5 width64: 4294967291
~~~~
2018-04-03 12:43:27 +00:00
< / fiddle-embed > < / div >
2018-01-11 15:35:44 +00:00
### See Also
2018-10-08 18:57:48 +00:00
< a href = '#SkIRect_width' > width< / a > () < a href = '#SkIRect_height' > height< / a > () < a href = '#SkIRect_height64' > height64< / a > () < a href = 'SkRect_Reference#SkRect_width' > SkRect::width< / a > ()
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_height' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
int32_t < a href = '#SkIRect_height' > height< / a > () const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns span on the y-axis. This does not check if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is sorted, or if
2017-10-09 18:07:42 +00:00
result fits in 32-bit signed integer; result may be negative.
### Return Value
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_fBottom' > fBottom< / a > minus < a href = '#SkIRect_fTop' > fTop< / a >
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "0175bae87fafcd9433ae661574695586" >
#### Example Output
~~~~
unsorted height: -5
large height: -5
~~~~
< / fiddle-embed > < / div >
### See Also
2018-10-08 18:57:48 +00:00
< a href = '#SkIRect_width' > width< / a > () < a href = 'SkRect_Reference#SkRect_height' > SkRect::height< / a > ()
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_height64' > < / a >
2018-10-16 14:30:28 +00:00
---
2018-01-11 15:35:44 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
int64_t < a href = '#SkIRect_height64' > height64< / a > () const
2018-01-11 15:35:44 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns span on the y-axis. This does not check if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is sorted, so the
result may be negative. This is safer than calling < a href = '#SkIRect_height' > height()< / a > since < a href = '#SkIRect_height' > height()< / a > might
2018-01-11 15:35:44 +00:00
overflow in its calculation.
### Return Value
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_fBottom' > fBottom< / a > minus < a href = '#SkIRect_fTop' > fTop< / a > cast to int64_t
2018-01-11 15:35:44 +00:00
2018-04-03 12:43:27 +00:00
### Example
< div > < fiddle-embed name = "02dd98716e54bbd8c2f0ff23b7ef98cf" >
2018-01-11 15:35:44 +00:00
#### Example Output
~~~~
height: -5 height64: 4294967291
~~~~
2018-04-03 12:43:27 +00:00
< / fiddle-embed > < / div >
2018-01-11 15:35:44 +00:00
### See Also
2018-10-08 18:57:48 +00:00
< a href = '#SkIRect_width' > width< / a > () < a href = '#SkIRect_height' > height< / a > () < a href = '#SkIRect_width64' > width64< / a > () < a href = 'SkRect_Reference#SkRect_height' > SkRect::height< / a > ()
2018-01-11 15:35:44 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_size' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
< a href = 'undocumented#SkISize' > SkISize< / a > < a href = '#SkIRect_size' > size< / a > () const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns spans on the x-axis and y-axis. This does not check if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is sorted,
2017-10-09 18:07:42 +00:00
or if result fits in 32-bit signed integer; result may be negative.
### Return Value
2018-10-31 16:14:03 +00:00
< a href = 'undocumented#SkISize' > SkISize< / a > (width, height)
2017-10-09 18:07:42 +00:00
### Example
2018-07-07 05:34:31 +00:00
< div > < fiddle-embed name = "8b3224641cb3053a7b8a5798b6cd1cf6" >
2017-10-09 18:07:42 +00:00
#### Example Output
~~~~
original rect: 20, 30, 40, 50 size: 20, 20
offset rect: 40, 50, 60, 70 size: 20, 20
outset rect: 20, 30, 80, 90 size: 60, 60
~~~~
< / fiddle-embed > < / div >
### See Also
2018-10-08 18:57:48 +00:00
< a href = '#SkIRect_height' > height< / a > () < a href = '#SkIRect_width' > width< / a > () < a href = '#SkIRect_MakeSize' > MakeSize< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_isEmpty' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
bool < a href = '#SkIRect_isEmpty' > isEmpty< / a > () const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns true if < a href = '#SkIRect_width' > width()< / a > or < a href = '#SkIRect_height' > height()< / a > are zero or negative.
2017-10-09 18:07:42 +00:00
### Return Value
2018-10-31 16:14:03 +00:00
true if < a href = '#SkIRect_width' > width()< / a > or < a href = '#SkIRect_height' > height()< / a > are zero or negative
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "edaad064b6de249b7a7c768dfa000adc" >
#### Example Output
~~~~
rect: {20, 40, 10, 50} is empty
sorted: {10, 40, 20, 50} is not empty
rect: {20, 40, 20, 50} is empty
sorted: {20, 40, 20, 50} is empty
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_EmptyIRect' > EmptyIRect< / a > < a href = '#SkIRect_MakeEmpty' > MakeEmpty< / a > < a href = '#SkIRect_sort' > sort< / a > < a href = 'SkRect_Reference#SkRect_isEmpty' > SkRect::isEmpty< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_isEmpty64' > < / a >
2018-10-16 14:30:28 +00:00
---
2018-01-11 15:35:44 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
bool < a href = '#SkIRect_isEmpty64' > isEmpty64< / a > () const
2018-01-11 15:35:44 +00:00
< / pre >
2018-05-16 11:07:07 +00:00
Returns true if < a href = '#SkIRect_fLeft' > fLeft< / a > is equal to or greater than < a href = '#SkIRect_fRight' > fRight< / a > , or if < a href = '#SkIRect_fTop' > fTop< / a > is equal
2018-10-31 16:14:03 +00:00
to or greater than < a href = '#SkIRect_fBottom' > fBottom< / a > . Call < a href = '#SkIRect_sort' > sort()< / a > to reverse rectangles with negative
2018-10-08 18:57:48 +00:00
< a href = '#SkIRect_width64' > width64< / a > () or < a href = '#SkIRect_height64' > height64< / a > ().
2018-01-11 15:35:44 +00:00
### Return Value
2018-10-31 16:14:03 +00:00
true if < a href = '#SkIRect_width64' > width64< / a > () or < a href = '#SkIRect_height64' > height64< / a > () are zero or negative
2018-01-11 15:35:44 +00:00
2018-04-03 12:43:27 +00:00
### Example
< div > < fiddle-embed name = "eb905faa1084ccab3ad0605df4c27ea4" >
2018-01-11 15:35:44 +00:00
#### Example Output
~~~~
rect: {20, 40, 10, 50} is empty
sorted: {10, 40, 20, 50} is not empty
rect: {20, 40, 20, 50} is empty
sorted: {20, 40, 20, 50} is empty
~~~~
2018-04-03 12:43:27 +00:00
< / fiddle-embed > < / div >
2018-01-11 15:35:44 +00:00
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_EmptyIRect' > EmptyIRect< / a > < a href = '#SkIRect_MakeEmpty' > MakeEmpty< / a > < a href = '#SkIRect_sort' > sort< / a > < a href = 'SkRect_Reference#SkRect_isEmpty' > SkRect::isEmpty< / a >
2018-01-11 15:35:44 +00:00
2018-10-16 14:30:28 +00:00
< a name = 'Operators' > < / a >
2018-01-26 17:56:22 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_equal_operator' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
bool < a href = '#SkIRect_equal_operator' > operator==(const SkIRect& a, const SkIRect& b)< / a >
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns true if all members in < a href = '#SkIRect_operator==(const SkIRect& a, const SkIRect& b)_a' > a< / a > : < a href = '#SkIRect_fLeft' > fLeft< / a > , < a href = '#SkIRect_fTop' > fTop< / a > , < a href = '#SkIRect_fRight' > fRight< / a > , and < a href = '#SkIRect_fBottom' > fBottom< / a > ; are
identical to corresponding members in < a href = '#SkIRect_operator==(const SkIRect& a, const SkIRect& b)_b' > b< / a > .
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_equal_operator_a' > < code > < strong > a< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to compare< / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_equal_operator_b' > < code > < strong > b< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to compare< / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
true if members are equal
### Example
2018-07-19 14:50:44 +00:00
< div > < fiddle-embed name = "bd8f028d9051062816c9116fea4237b2" >
2017-10-09 18:07:42 +00:00
#### Example Output
~~~~
test == sorted
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_notequal_operator' > operator!=(const SkIRect& a, const SkIRect& b)< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_notequal_operator' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
bool < a href = '#SkIRect_notequal_operator' > operator!=(const SkIRect& a, const SkIRect& b)< / a >
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns true if any member in < a href = '#SkIRect_operator!=(const SkIRect& a, const SkIRect& b)_a' > a< / a > : < a href = '#SkIRect_fLeft' > fLeft< / a > , < a href = '#SkIRect_fTop' > fTop< / a > , < a href = '#SkIRect_fRight' > fRight< / a > , and < a href = '#SkIRect_fBottom' > fBottom< / a > ; is not
identical to the corresponding member in < a href = '#SkIRect_operator!=(const SkIRect& a, const SkIRect& b)_b' > b< / a > .
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_notequal_operator_a' > < code > < strong > a< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to compare< / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_notequal_operator_b' > < code > < strong > b< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to compare< / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
true if members are not equal
### Example
< div > < fiddle-embed name = "6c4acd8aa203f632b7d85cae672abf4d" >
#### Example Output
~~~~
test != sorted
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_equal_operator' > operator==(const SkIRect& a, const SkIRect& b)< / a >
2017-10-09 18:07:42 +00:00
2018-10-16 14:30:28 +00:00
< a name = 'Set' > < / a >
2018-02-07 12:27:09 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_setEmpty' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
void < a href = '#SkIRect_setEmpty' > setEmpty< / a > ()
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Sets < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to (0, 0, 0, 0).
2017-10-09 18:07:42 +00:00
2018-01-26 17:56:22 +00:00
Many other rectangles are empty; if left is equal to or greater than right,
or if top is equal to or greater than bottom. Setting all members to zero
2017-10-09 18:07:42 +00:00
is a convenience, but does not designate a special empty rectangle.
### Example
< div > < fiddle-embed name = "94039c3cc9e911c8ab2993d56fd06210" >
#### Example Output
~~~~
rect: {3, 4, 1, 2} is empty
rect: {0, 0, 0, 0} is empty
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_MakeEmpty' > MakeEmpty< / a > < a href = 'SkRect_Reference#SkRect_setEmpty' > SkRect::setEmpty< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_set' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
void < a href = '#SkIRect_set' > set< / a > (int32_t left, int32_t top, int32_t right, int32_t bottom)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Sets < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to (< a href = '#SkIRect_set()_left' > left< / a > , < a href = '#SkIRect_set()_top' > top< / a > , < a href = '#SkIRect_set()_right' > right< / a > , < a href = '#SkIRect_set()_bottom' > bottom< / a > ).
< a href = '#SkIRect_set()_left' > left< / a > and < a href = '#SkIRect_set()_right' > right< / a > are not sorted; < a href = '#SkIRect_set()_left' > left< / a > is not necessarily less than < a href = '#SkIRect_set()_right' > right< / a > .
< a href = '#SkIRect_set()_top' > top< / a > and < a href = '#SkIRect_set()_bottom' > bottom< / a > are not sorted; < a href = '#SkIRect_set()_top' > top< / a > is not necessarily less than < a href = '#SkIRect_set()_bottom' > bottom< / a > .
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_set_left' > < code > < strong > left< / strong > < / code > < / a > < / td >
< td > assigned to < a href = '#SkIRect_fLeft' > fLeft< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_set_top' > < code > < strong > top< / strong > < / code > < / a > < / td >
< td > assigned to < a href = '#SkIRect_fTop' > fTop< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_set_right' > < code > < strong > right< / strong > < / code > < / a > < / td >
< td > assigned to < a href = '#SkIRect_fRight' > fRight< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_set_bottom' > < code > < strong > bottom< / strong > < / code > < / a > < / td >
< td > assigned to < a href = '#SkIRect_fBottom' > fBottom< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Example
2018-07-16 05:29:00 +00:00
< div > < fiddle-embed name = "1912c37076b7f3bf6aebfa167e971bec" >
2017-10-09 18:07:42 +00:00
#### Example Output
~~~~
rect1: {3, 4, 1, 2}
rect2: {3, 4, 1, 2}
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_setLTRB' > setLTRB< / a > < a href = '#SkIRect_setXYWH' > setXYWH< / a > < a href = 'SkRect_Reference#SkRect_set' > SkRect::set< / a > < sup > < a href = 'SkRect_Reference#SkRect_set_2' > [2]< / a > < / sup > < sup > < a href = 'SkRect_Reference#SkRect_set_3' > [3]< / a > < / sup > < sup > < a href = 'SkRect_Reference#SkRect_set_4' > [4]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_setLTRB' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
void < a href = '#SkIRect_setLTRB' > setLTRB< / a > (int32_t left, int32_t top, int32_t right, int32_t bottom)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Sets < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to (< a href = '#SkIRect_setLTRB_left' > left< / a > , < a href = '#SkIRect_setLTRB_top' > top< / a > , < a href = '#SkIRect_setLTRB_right' > right< / a > , < a href = '#SkIRect_setLTRB_bottom' > bottom< / a > ).
< a href = '#SkIRect_setLTRB_left' > left< / a > and < a href = '#SkIRect_setLTRB_right' > right< / a > are not sorted; < a href = '#SkIRect_setLTRB_left' > left< / a > is not necessarily less than < a href = '#SkIRect_setLTRB_right' > right< / a > .
< a href = '#SkIRect_setLTRB_top' > top< / a > and < a href = '#SkIRect_setLTRB_bottom' > bottom< / a > are not sorted; < a href = '#SkIRect_setLTRB_top' > top< / a > is not necessarily less than < a href = '#SkIRect_setLTRB_bottom' > bottom< / a > .
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_setLTRB_left' > < code > < strong > left< / strong > < / code > < / a > < / td >
< td > stored in < a href = '#SkIRect_fLeft' > fLeft< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_setLTRB_top' > < code > < strong > top< / strong > < / code > < / a > < / td >
< td > stored in < a href = '#SkIRect_fTop' > fTop< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_setLTRB_right' > < code > < strong > right< / strong > < / code > < / a > < / td >
< td > stored in < a href = '#SkIRect_fRight' > fRight< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_setLTRB_bottom' > < code > < strong > bottom< / strong > < / code > < / a > < / td >
< td > stored in < a href = '#SkIRect_fBottom' > fBottom< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Example
2018-07-08 05:32:09 +00:00
< div > < fiddle-embed name = "ead6bdcf2ae77ec19a1c5a96f5b31af8" >
2017-10-09 18:07:42 +00:00
#### Example Output
~~~~
rect1: {3, 4, 1, 2}
rect2: {3, 4, 1, 2}
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_set' > set< / a > < a href = '#SkIRect_setXYWH' > setXYWH< / a > < a href = 'SkRect_Reference#SkRect_setLTRB' > SkRect::setLTRB< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_setXYWH' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
void < a href = '#SkIRect_setXYWH' > setXYWH< / a > (int32_t x, int32_t y, int32_t width, int32_t height)
2017-10-09 18:07:42 +00:00
< / pre >
Condense embedded formulas.
Bookmaker delimits formulas and equations to allow
representing variables and symbols without tripping
up reference lookup, spell checking, and comment
generation.
Before, formulas were represented with:
some text
#Formula
(x + y, 0)
##
, and more text
This made it difficult to know when spacing should
be preserved before and after the formula. Now,
formulas are represented with:
some text #Formula # (x + y, 0) ##, and more text
The presence or absence of a space between ## and ,
is now significant (before it was not).
Also, formulas are bracketed by <code> in markdown
generation, so that variables stand out better.
See:
https://skia.org/user/api/SkBlendMode_Reference?cl=152781#Dst_Out
for an example.
Also fixed 100 column offenders and added a code
check to identify them. For the moment, 100 column
offenders are outed with SkDebugf but their presence
does not cause bookmaker to fail.
TBR=caryclark@google.com
Docs-Preview: https://skia.org/?cl=152781
Bug: skia:6898
Change-Id: If92a65a234f5d616bf4485984a8d219a6f04821a
Reviewed-on: https://skia-review.googlesource.com/152781
Commit-Queue: Cary Clark <caryclark@skia.org>
Auto-Submit: Cary Clark <caryclark@skia.org>
Reviewed-by: Cary Clark <caryclark@skia.org>
2018-09-13 16:04:30 +00:00
Sets < a href = '#IRect' > IRect</ a > to: < code > \(x, y, x \+ width, y \+ height\)</ code > .
Does not validate input; width or height may be negative.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_setXYWH_x' > < code > < strong > x< / strong > < / code > < / a > < / td >
< td > stored in < a href = '#SkIRect_fLeft' > fLeft< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_setXYWH_y' > < code > < strong > y< / strong > < / code > < / a > < / td >
< td > stored in < a href = '#SkIRect_fTop' > fTop< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_setXYWH_width' > < code > < strong > width< / strong > < / code > < / a > < / td >
< td > added to x and stored in < a href = '#SkIRect_fRight' > fRight< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_setXYWH_height' > < code > < strong > height< / strong > < / code > < / a > < / td >
< td > added to y and stored in < a href = '#SkIRect_fBottom' > fBottom< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Example
2018-07-07 05:34:31 +00:00
< div > < fiddle-embed name = "0e1db8c86678c004e504f47641b44b17" >
2017-10-09 18:07:42 +00:00
#### Example Output
~~~~
rect: 5, 35, -10, 60 isEmpty: true
rect: -10, 35, 5, 60 isEmpty: false
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_MakeXYWH' > MakeXYWH< / a > < a href = '#SkIRect_setLTRB' > setLTRB< / a > < a href = '#SkIRect_set' > set< / a > < a href = 'SkRect_Reference#SkRect_setXYWH' > SkRect::setXYWH< / a >
2017-10-09 18:07:42 +00:00
2018-10-16 14:30:28 +00:00
< a name = 'Inset_Outset_Offset' > < / a >
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_makeOffset' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
< a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_makeOffset' > makeOffset< / a > (int32_t dx, int32_t dy) const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > offset by (< a href = '#SkIRect_makeOffset_dx' > dx< / a > , < a href = '#SkIRect_makeOffset_dy' > dy< / a > ).
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
If < a href = '#SkIRect_makeOffset_dx' > dx< / a > is negative, < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned is moved to the left.
If < a href = '#SkIRect_makeOffset_dx' > dx< / a > is positive, < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned is moved to the right.
If < a href = '#SkIRect_makeOffset_dy' > dy< / a > is negative, < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned is moved upward.
If < a href = '#SkIRect_makeOffset_dy' > dy< / a > is positive, < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned is moved downward.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_makeOffset_dx' > < code > < strong > dx< / strong > < / code > < / a > < / td >
< td > offset added to < a href = '#SkIRect_fLeft' > fLeft< / a > and < a href = '#SkIRect_fRight' > fRight< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_makeOffset_dy' > < code > < strong > dy< / strong > < / code > < / a > < / td >
< td > offset added to < a href = '#SkIRect_fTop' > fTop< / a > and < a href = '#SkIRect_fBottom' > fBottom< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-10-31 16:14:03 +00:00
< a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > offset by < a href = '#SkIRect_makeOffset_dx' > dx< / a > and < a href = '#SkIRect_makeOffset_dy' > dy< / a > , with original width and height
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "737c747df07ddf392c05970440de0927" >
#### Example Output
~~~~
rect: 10, 50, 20, 60 isEmpty: false
rect: 25, 82, 35, 92 isEmpty: false
~~~~
< / fiddle-embed > < / div >
### See Also
2018-10-08 18:57:48 +00:00
< a href = '#SkIRect_offset' > offset< / a > < sup > < a href = '#SkIRect_offset_2' > [2]< / a > < / sup > () < a href = '#SkIRect_makeInset' > makeInset< / a > < a href = '#SkIRect_makeOutset' > makeOutset< / a > < a href = 'SkRect_Reference#SkRect_makeOffset' > SkRect::makeOffset< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_makeInset' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
< a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_makeInset' > makeInset< / a > (int32_t dx, int32_t dy) const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > , inset by (< a href = '#SkIRect_makeInset_dx' > dx< / a > , < a href = '#SkIRect_makeInset_dy' > dy< / a > ).
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
If < a href = '#SkIRect_makeInset_dx' > dx< / a > is negative, < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned is wider.
If < a href = '#SkIRect_makeInset_dx' > dx< / a > is positive, < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned is narrower.
If < a href = '#SkIRect_makeInset_dy' > dy< / a > is negative, < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned is taller.
If < a href = '#SkIRect_makeInset_dy' > dy< / a > is positive, < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned is shorter.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_makeInset_dx' > < code > < strong > dx< / strong > < / code > < / a > < / td >
< td > offset added to < a href = '#SkIRect_fLeft' > fLeft< / a > and subtracted from < a href = '#SkIRect_fRight' > fRight< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_makeInset_dy' > < code > < strong > dy< / strong > < / code > < / a > < / td >
< td > offset added to < a href = '#SkIRect_fTop' > fTop< / a > and subtracted from < a href = '#SkIRect_fBottom' > fBottom< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-10-31 16:14:03 +00:00
< a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > inset symmetrically left and right, top and bottom
2017-10-09 18:07:42 +00:00
### Example
2018-07-04 05:33:26 +00:00
< div > < fiddle-embed name = "1db94b2c76e0a7a71856532335fa56b6" >
2017-10-09 18:07:42 +00:00
#### Example Output
~~~~
rect: 10, 50, 20, 60 isEmpty: false
rect: 25, 82, 5, 28 isEmpty: true
~~~~
< / fiddle-embed > < / div >
### See Also
2018-10-08 18:57:48 +00:00
< a href = '#SkIRect_inset' > inset< / a > () < a href = '#SkIRect_makeOffset' > makeOffset< / a > < a href = '#SkIRect_makeOutset' > makeOutset< / a > < a href = 'SkRect_Reference#SkRect_makeInset' > SkRect::makeInset< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_makeOutset' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
< a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_makeOutset' > makeOutset< / a > (int32_t dx, int32_t dy) const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > , outset by (< a href = '#SkIRect_makeOutset_dx' > dx< / a > , < a href = '#SkIRect_makeOutset_dy' > dy< / a > ).
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
If < a href = '#SkIRect_makeOutset_dx' > dx< / a > is negative, < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned is narrower.
If < a href = '#SkIRect_makeOutset_dx' > dx< / a > is positive, < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned is wider.
If < a href = '#SkIRect_makeOutset_dy' > dy< / a > is negative, < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned is shorter.
If < a href = '#SkIRect_makeOutset_dy' > dy< / a > is positive, < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned is taller.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_makeOutset_dx' > < code > < strong > dx< / strong > < / code > < / a > < / td >
< td > offset subtracted to < a href = '#SkIRect_fLeft' > fLeft< / a > and added from < a href = '#SkIRect_fRight' > fRight< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_makeOutset_dy' > < code > < strong > dy< / strong > < / code > < / a > < / td >
< td > offset subtracted to < a href = '#SkIRect_fTop' > fTop< / a > and added from < a href = '#SkIRect_fBottom' > fBottom< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-10-31 16:14:03 +00:00
< a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > outset symmetrically left and right, top and bottom
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "240e2953e3455c08f6d89255feff8416" >
#### Example Output
~~~~
rect: 10, 50, 20, 60 isEmpty: false
rect: -5, 18, 35, 92 isEmpty: false
~~~~
< / fiddle-embed > < / div >
### See Also
2018-10-08 18:57:48 +00:00
< a href = '#SkIRect_outset' > outset< / a > () < a href = '#SkIRect_makeOffset' > makeOffset< / a > < a href = '#SkIRect_makeInset' > makeInset< / a > < a href = 'SkRect_Reference#SkRect_makeOutset' > SkRect::makeOutset< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_offset' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
void < a href = '#SkIRect_offset' > offset< / a > (int32_t dx, int32_t dy)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Offsets < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > by adding < a href = '#SkIRect_offset()_dx' > dx< / a > to < a href = '#SkIRect_fLeft' > fLeft< / a > , < a href = '#SkIRect_fRight' > fRight< / a > ; and by adding < a href = '#SkIRect_offset()_dy' > dy< / a > to < a href = '#SkIRect_fTop' > fTop< / a > , < a href = '#SkIRect_fBottom' > fBottom< / a > .
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
If < a href = '#SkIRect_offset()_dx' > dx< / a > is negative, moves < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned to the left.
If < a href = '#SkIRect_offset()_dx' > dx< / a > is positive, moves < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned to the right.
If < a href = '#SkIRect_offset()_dy' > dy< / a > is negative, moves < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned upward.
If < a href = '#SkIRect_offset()_dy' > dy< / a > is positive, moves < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned downward.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_offset_dx' > < code > < strong > dx< / strong > < / code > < / a > < / td >
< td > offset added to < a href = '#SkIRect_fLeft' > fLeft< / a > and < a href = '#SkIRect_fRight' > fRight< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_offset_dy' > < code > < strong > dy< / strong > < / code > < / a > < / td >
< td > offset added to < a href = '#SkIRect_fTop' > fTop< / a > and < a href = '#SkIRect_fBottom' > fBottom< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Example
< div > < fiddle-embed name = "77e633b2174ffae923c038b303418b50" >
#### Example Output
~~~~
rect: 15, 27, 55, 86
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_offsetTo' > offsetTo< / a > < a href = '#SkIRect_makeOffset' > makeOffset< / a > < a href = 'SkRect_Reference#SkRect_offset' > SkRect::offset< / a > < sup > < a href = 'SkRect_Reference#SkRect_offset_2' > [2]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_offset_2' > < / a >
2018-01-26 17:56:22 +00:00
2018-10-16 14:30:28 +00:00
---
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
void < a href = '#SkIRect_offset' > offset< / a > (const < a href = 'SkIPoint_Reference#SkIPoint' > SkIPoint< / a > & delta)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Offsets < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > by adding < a href = '#SkIRect_offset_2_delta' > delta< / a > .< a href = '#SkIPoint_fX' > fX< / a > to < a href = '#SkIRect_fLeft' > fLeft< / a > , < a href = '#SkIRect_fRight' > fRight< / a > ; and by adding < a href = '#SkIRect_offset_2_delta' > delta< / a > .< a href = '#SkIPoint_fY' > fY< / a > to
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_fTop' > fTop< / a > , < a href = '#SkIRect_fBottom' > fBottom< / a > .
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
If < a href = '#SkIRect_offset_2_delta' > delta< / a > .< a href = '#SkIPoint_fX' > fX< / a > is negative, moves < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned to the left.
If < a href = '#SkIRect_offset_2_delta' > delta< / a > .< a href = '#SkIPoint_fX' > fX< / a > is positive, moves < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned to the right.
If < a href = '#SkIRect_offset_2_delta' > delta< / a > .< a href = '#SkIPoint_fY' > fY< / a > is negative, moves < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned upward.
If < a href = '#SkIRect_offset_2_delta' > delta< / a > .< a href = '#SkIPoint_fY' > fY< / a > is positive, moves < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > returned downward.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_offset_2_delta' > < code > < strong > delta< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > offset added to < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Example
< div > < fiddle-embed name = "31a4c575499e76def651eb65994876f0" >
#### Example Output
~~~~
rect: 15, 27, 55, 86
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_offsetTo' > offsetTo< / a > < a href = '#SkIRect_makeOffset' > makeOffset< / a > < a href = 'SkRect_Reference#SkRect_offset' > SkRect::offset< / a > < sup > < a href = 'SkRect_Reference#SkRect_offset_2' > [2]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_offsetTo' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
void < a href = '#SkIRect_offsetTo' > offsetTo< / a > (int32_t newX, int32_t newY)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Offsets < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > so that < a href = '#SkIRect_fLeft' > fLeft< / a > equals < a href = '#SkIRect_offsetTo_newX' > newX< / a > , and < a href = '#SkIRect_fTop' > fTop< / a > equals < a href = '#SkIRect_offsetTo_newY' > newY< / a > . width and height
2017-10-09 18:07:42 +00:00
are unchanged.
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_offsetTo_newX' > < code > < strong > newX< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > stored in < a href = '#SkIRect_fLeft' > fLeft< / a > , preserving < a href = '#SkIRect_width' > width()< / a > < / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_offsetTo_newY' > < code > < strong > newY< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > stored in < a href = '#SkIRect_fTop' > fTop< / a > , preserving < a href = '#SkIRect_height' > height()< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Example
< div > < fiddle-embed name = "a2734ff23b35653956a3002e5c29ff91" >
#### Example Output
~~~~
rect: 15, 27, 55, 86
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_offset' > offset< / a > < sup > < a href = '#SkIRect_offset_2' > [2]< / a > < / sup > < a href = '#SkIRect_makeOffset' > makeOffset< / a > < a href = '#SkIRect_setXYWH' > setXYWH< / a > < a href = 'SkRect_Reference#SkRect_offsetTo' > SkRect::offsetTo< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_inset' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
void < a href = '#SkIRect_inset' > inset< / a > (int32_t dx, int32_t dy)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Insets < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > by (< a href = '#SkIRect_inset()_dx' > dx< / a > ,< a href = '#SkIRect_inset()_dy' > dy< / a > ).
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
If < a href = '#SkIRect_inset()_dx' > dx< / a > is positive, makes < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > narrower.
If < a href = '#SkIRect_inset()_dx' > dx< / a > is negative, makes < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > wider.
If < a href = '#SkIRect_inset()_dy' > dy< / a > is positive, makes < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > shorter.
If < a href = '#SkIRect_inset()_dy' > dy< / a > is negative, makes < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > taller.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_inset_dx' > < code > < strong > dx< / strong > < / code > < / a > < / td >
< td > offset added to < a href = '#SkIRect_fLeft' > fLeft< / a > and subtracted from < a href = '#SkIRect_fRight' > fRight< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_inset_dy' > < code > < strong > dy< / strong > < / code > < / a > < / td >
< td > offset added to < a href = '#SkIRect_fTop' > fTop< / a > and subtracted from < a href = '#SkIRect_fBottom' > fBottom< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Example
< div > < fiddle-embed name = "9debaded1aa8bdf5077a4de0b3015b8f" >
#### Example Output
~~~~
rect: 15, 27, 45, 60
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_outset' > outset< / a > < a href = '#SkIRect_makeInset' > makeInset< / a > < a href = 'SkRect_Reference#SkRect_inset' > SkRect::inset< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_outset' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
void < a href = '#SkIRect_outset' > outset< / a > (int32_t dx, int32_t dy)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Outsets < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > by (< a href = '#SkIRect_outset()_dx' > dx< / a > , < a href = '#SkIRect_outset()_dy' > dy< / a > ).
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
If < a href = '#SkIRect_outset()_dx' > dx< / a > is positive, makes < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > wider.
If < a href = '#SkIRect_outset()_dx' > dx< / a > is negative, makes < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > narrower.
If < a href = '#SkIRect_outset()_dy' > dy< / a > is positive, makes < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > taller.
If < a href = '#SkIRect_outset()_dy' > dy< / a > is negative, makes < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > shorter.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_outset_dx' > < code > < strong > dx< / strong > < / code > < / a > < / td >
< td > subtracted to < a href = '#SkIRect_fLeft' > fLeft< / a > and added from < a href = '#SkIRect_fRight' > fRight< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_outset_dy' > < code > < strong > dy< / strong > < / code > < / a > < / td >
< td > subtracted to < a href = '#SkIRect_fTop' > fTop< / a > and added from < a href = '#SkIRect_fBottom' > fBottom< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Example
< div > < fiddle-embed name = "3fc62ca29428195f33a3a02b3eb74e4f" >
#### Example Output
~~~~
rect: 5, 1, 55, 86
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_inset' > inset< / a > < a href = '#SkIRect_makeOutset' > makeOutset< / a > < a href = 'SkRect_Reference#SkRect_outset' > SkRect::outset< / a >
2017-10-09 18:07:42 +00:00
2018-10-16 14:30:28 +00:00
< a name = 'Intersection' > < / a >
2018-01-26 17:56:22 +00:00
2018-05-16 11:07:07 +00:00
< a href = '#IRect' > IRects< / a > intersect when they enclose a common area. To intersect, each of the pair
must describe area; < a href = '#SkIRect_fLeft' > fLeft< / a > is less than < a href = '#SkIRect_fRight' > fRight< / a > , and < a href = '#SkIRect_fTop' > fTop< / a > is less than < a href = '#SkIRect_fBottom' > fBottom< / a > ;
empty() returns false. The intersection of < a href = '#IRect' > IRect< / a > pair can be described by:
Condense embedded formulas.
Bookmaker delimits formulas and equations to allow
representing variables and symbols without tripping
up reference lookup, spell checking, and comment
generation.
Before, formulas were represented with:
some text
#Formula
(x + y, 0)
##
, and more text
This made it difficult to know when spacing should
be preserved before and after the formula. Now,
formulas are represented with:
some text #Formula # (x + y, 0) ##, and more text
The presence or absence of a space between ## and ,
is now significant (before it was not).
Also, formulas are bracketed by <code> in markdown
generation, so that variables stand out better.
See:
https://skia.org/user/api/SkBlendMode_Reference?cl=152781#Dst_Out
for an example.
Also fixed 100 column offenders and added a code
check to identify them. For the moment, 100 column
offenders are outed with SkDebugf but their presence
does not cause bookmaker to fail.
TBR=caryclark@google.com
Docs-Preview: https://skia.org/?cl=152781
Bug: skia:6898
Change-Id: If92a65a234f5d616bf4485984a8d219a6f04821a
Reviewed-on: https://skia-review.googlesource.com/152781
Commit-Queue: Cary Clark <caryclark@skia.org>
Auto-Submit: Cary Clark <caryclark@skia.org>
Reviewed-by: Cary Clark <caryclark@skia.org>
2018-09-13 16:04:30 +00:00
< code > \(max\(a\.< a href = '#SkIRect_fLeft' > fLeft</ a > , b\.< a href = '#SkIRect_fLeft' > fLeft</ a > \), max\(a\.< a href = '#SkIRect_fTop' > fTop</ a > , b\.< a href = '#SkIRect_fTop' > fTop</ a > \),
min\(a\.< a href = '#SkIRect_fRight' > fRight</ a > , b\.< a href = '#SkIRect_fRight' > fRight</ a > \), min\(a\.< a href = '#SkIRect_fBottom' > fBottom</ a > , b\.< a href = '#SkIRect_fBottom' > fBottom</ a > \)\)</ code > .
2018-01-26 17:56:22 +00:00
2018-05-16 11:07:07 +00:00
The intersection is only meaningful if the resulting < a href = '#IRect' > IRect< / a > is not empty and
describes an area: < a href = '#SkIRect_fLeft' > fLeft< / a > is less than < a href = '#SkIRect_fRight' > fRight< / a > , and < a href = '#SkIRect_fTop' > fTop< / a > is less than < a href = '#SkIRect_fBottom' > fBottom< / a > .
2018-05-18 15:57:17 +00:00
< a name = 'SkIRect_adjust' > < / a >
2018-10-16 14:30:28 +00:00
---
2018-05-18 15:57:17 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
void < a href = '#SkIRect_adjust' > adjust< / a > (int32_t dL, int32_t dT, int32_t dR, int32_t dB)
< / pre >
2018-10-31 16:14:03 +00:00
Adjusts < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > by adding < a href = '#SkIRect_adjust()_dL' > dL< / a > to < a href = '#SkIRect_fLeft' > fLeft< / a > , < a href = '#SkIRect_adjust()_dT' > dT< / a > to < a href = '#SkIRect_fTop' > fTop< / a > , < a href = '#SkIRect_adjust()_dR' > dR< / a > to < a href = '#SkIRect_fRight' > fRight< / a > , and < a href = '#SkIRect_adjust()_dB' > dB< / a > to < a href = '#SkIRect_fBottom' > fBottom< / a > .
2018-05-18 15:57:17 +00:00
2018-10-31 16:14:03 +00:00
If < a href = '#SkIRect_adjust()_dL' > dL< / a > is positive, narrows < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > on the left. If negative, widens it on the left.
If < a href = '#SkIRect_adjust()_dT' > dT< / a > is positive, shrinks < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > on the top. If negative, lengthens it on the top.
If < a href = '#SkIRect_adjust()_dR' > dR< / a > is positive, narrows < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > on the right. If negative, widens it on the right.
If < a href = '#SkIRect_adjust()_dB' > dB< / a > is positive, shrinks < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > on the bottom. If negative, lengthens it on the bottom.
2018-05-18 15:57:17 +00:00
2018-10-31 16:14:03 +00:00
The resulting < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is not checked for validity. Thus, if the resulting < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > left is
greater than right, the < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > will be considered empty. Call < a href = '#SkIRect_sort' > sort()< / a > after this call
2018-05-18 15:57:17 +00:00
if that is not the desired behavior.
### Parameters
< table > < tr > < td > < a name = 'SkIRect_adjust_dL' > < code > < strong > dL< / strong > < / code > < / a > < / td >
< td > offset added to < a href = '#SkIRect_fLeft' > fLeft< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_adjust_dT' > < code > < strong > dT< / strong > < / code > < / a > < / td >
< td > offset added to < a href = '#SkIRect_fTop' > fTop< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_adjust_dR' > < code > < strong > dR< / strong > < / code > < / a > < / td >
< td > offset added to < a href = '#SkIRect_fRight' > fRight< / a > < / td >
< / tr >
< tr > < td > < a name = 'SkIRect_adjust_dB' > < code > < strong > dB< / strong > < / code > < / a > < / td >
< td > offset added to < a href = '#SkIRect_fBottom' > fBottom< / a > < / td >
< / tr >
< / table >
### Example
< div > < fiddle-embed name = "8dc91284493dd012cca3d0ce4c66bda4" >
#### Example Output
~~~~
rect: 10, 10, 20, 20
~~~~
< / fiddle-embed > < / div >
### See Also
< a href = '#SkIRect_inset' > inset< / a > < a href = '#SkIRect_outset' > outset< / a >
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_contains' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
bool < a href = '#SkIRect_contains' > contains< / a > (int32_t x, int32_t y) const
2017-10-09 18:07:42 +00:00
< / pre >
Condense embedded formulas.
Bookmaker delimits formulas and equations to allow
representing variables and symbols without tripping
up reference lookup, spell checking, and comment
generation.
Before, formulas were represented with:
some text
#Formula
(x + y, 0)
##
, and more text
This made it difficult to know when spacing should
be preserved before and after the formula. Now,
formulas are represented with:
some text #Formula # (x + y, 0) ##, and more text
The presence or absence of a space between ## and ,
is now significant (before it was not).
Also, formulas are bracketed by <code> in markdown
generation, so that variables stand out better.
See:
https://skia.org/user/api/SkBlendMode_Reference?cl=152781#Dst_Out
for an example.
Also fixed 100 column offenders and added a code
check to identify them. For the moment, 100 column
offenders are outed with SkDebugf but their presence
does not cause bookmaker to fail.
TBR=caryclark@google.com
Docs-Preview: https://skia.org/?cl=152781
Bug: skia:6898
Change-Id: If92a65a234f5d616bf4485984a8d219a6f04821a
Reviewed-on: https://skia-review.googlesource.com/152781
Commit-Queue: Cary Clark <caryclark@skia.org>
Auto-Submit: Cary Clark <caryclark@skia.org>
Reviewed-by: Cary Clark <caryclark@skia.org>
2018-09-13 16:04:30 +00:00
Returns true if: < code > < a href = '#SkIRect_fLeft' > fLeft< / a > < = x < < a href = '#SkIRect_fRight' > fRight< / a > && < a href = '#SkIRect_fTop' > fTop< / a > < = y < < a href = '#SkIRect_fBottom' > fBottom< / a > < / code > .
2018-05-16 11:07:07 +00:00
Returns false if < a href = '#IRect' > IRect< / a > is empty.
2017-10-09 18:07:42 +00:00
Condense embedded formulas.
Bookmaker delimits formulas and equations to allow
representing variables and symbols without tripping
up reference lookup, spell checking, and comment
generation.
Before, formulas were represented with:
some text
#Formula
(x + y, 0)
##
, and more text
This made it difficult to know when spacing should
be preserved before and after the formula. Now,
formulas are represented with:
some text #Formula # (x + y, 0) ##, and more text
The presence or absence of a space between ## and ,
is now significant (before it was not).
Also, formulas are bracketed by <code> in markdown
generation, so that variables stand out better.
See:
https://skia.org/user/api/SkBlendMode_Reference?cl=152781#Dst_Out
for an example.
Also fixed 100 column offenders and added a code
check to identify them. For the moment, 100 column
offenders are outed with SkDebugf but their presence
does not cause bookmaker to fail.
TBR=caryclark@google.com
Docs-Preview: https://skia.org/?cl=152781
Bug: skia:6898
Change-Id: If92a65a234f5d616bf4485984a8d219a6f04821a
Reviewed-on: https://skia-review.googlesource.com/152781
Commit-Queue: Cary Clark <caryclark@skia.org>
Auto-Submit: Cary Clark <caryclark@skia.org>
Reviewed-by: Cary Clark <caryclark@skia.org>
2018-09-13 16:04:30 +00:00
Considers input to describe constructed < a href = '#IRect' > IRect</ a > : < code > \(x, y, x \+ 1, y \+ 1\)</ code > and
2018-05-16 11:07:07 +00:00
returns true if constructed area is completely enclosed by < a href = '#IRect' > IRect< / a > area.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_contains_x' > < code > < strong > x< / strong > < / code > < / a > < / td >
< td > test < a href = 'SkIPoint_Reference#IPoint' > IPoint< / a > x-coordinate< / td >
< / tr >
< tr > < td > < a name = 'SkIRect_contains_y' > < code > < strong > y< / strong > < / code > < / a > < / td >
< td > test < a href = 'SkIPoint_Reference#IPoint' > IPoint< / a > y-coordinate< / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-05-16 11:07:07 +00:00
true if (x, y) is inside < a href = '#IRect' > IRect< / a >
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "a7958a4e0668f5cf805a8e78eb57f51d" >
#### Example Output
~~~~
rect: (30, 50, 40, 60) contains (30, 50)
rect: (30, 50, 40, 60) does not contain (40, 50)
rect: (30, 50, 40, 60) does not contain (30, 60)
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_containsNoEmptyCheck' > containsNoEmptyCheck< / a > < sup > < a href = '#SkIRect_containsNoEmptyCheck_2' > [2]< / a > < / sup > < a href = 'SkRect_Reference#SkRect_contains' > SkRect::contains< / a > < sup > < a href = 'SkRect_Reference#SkRect_contains_2' > [2]< / a > < / sup > < sup > < a href = 'SkRect_Reference#SkRect_contains_3' > [3]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_contains_2' > < / a >
2018-01-26 17:56:22 +00:00
2018-10-16 14:30:28 +00:00
---
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
bool < a href = '#SkIRect_contains' > contains< / a > (int32_t left, int32_t top, int32_t right, int32_t bottom) const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Constructs < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to intersect from (< a href = '#SkIRect_contains_2_left' > left< / a > , < a href = '#SkIRect_contains_2_top' > top< / a > , < a href = '#SkIRect_contains_2_right' > right< / a > , < a href = '#SkIRect_contains_2_bottom' > bottom< / a > ). Does not sort
2017-10-09 18:07:42 +00:00
construction.
2018-10-31 16:14:03 +00:00
Returns true if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > contains construction.
Returns false if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is empty or construction is empty.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_contains_2_left' > < code > < strong > left< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > x-axis minimum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_contains_2_top' > < code > < strong > top< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > y-axis minimum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_contains_2_right' > < code > < strong > right< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > x-axis maximum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_contains_2_bottom' > < code > < strong > bottom< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > y-axis maximum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-10-31 16:14:03 +00:00
true if all sides of < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > are outside construction
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "eae55f284818d9965ec5834747d14a48" >
#### Example Output
~~~~
rect: (30, 50, 40, 60) contains (30, 50, 31, 51)
rect: (30, 50, 40, 60) does not contain (39, 49, 40, 50)
rect: (30, 50, 40, 60) does not contain (29, 59, 30, 60)
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_containsNoEmptyCheck' > containsNoEmptyCheck< / a > < sup > < a href = '#SkIRect_containsNoEmptyCheck_2' > [2]< / a > < / sup > < a href = 'SkRect_Reference#SkRect_contains' > SkRect::contains< / a > < sup > < a href = 'SkRect_Reference#SkRect_contains_2' > [2]< / a > < / sup > < sup > < a href = 'SkRect_Reference#SkRect_contains_3' > [3]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_contains_3' > < / a >
2018-01-26 17:56:22 +00:00
2018-10-16 14:30:28 +00:00
---
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
bool < a href = '#SkIRect_contains' > contains< / a > (const < a href = '#SkIRect' > SkIRect< / a > & r) const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns true if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > contains < a href = '#SkIRect_contains_3_r' > r< / a > .
Returns false if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is empty or < a href = '#SkIRect_contains_3_r' > r< / a > is empty.
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
< a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > contains < a href = '#SkIRect_contains_3_r' > r< / a > when < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > area completely includes < a href = '#SkIRect_contains_3_r' > r< / a > area.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_contains_3_r' > < code > < strong > r< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > contained< / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-10-31 16:14:03 +00:00
true if all sides of < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > are outside < a href = '#SkIRect_contains_3_r' > r< / a >
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "ee0185db622602b4eb19583c2f42c734" >
#### Example Output
~~~~
rect: (30, 50, 40, 60) contains (30, 50, 31, 51)
rect: (30, 50, 40, 60) does not contain (39, 49, 40, 50)
rect: (30, 50, 40, 60) does not contain (29, 59, 30, 60)
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_containsNoEmptyCheck' > containsNoEmptyCheck< / a > < sup > < a href = '#SkIRect_containsNoEmptyCheck_2' > [2]< / a > < / sup > < a href = 'SkRect_Reference#SkRect_contains' > SkRect::contains< / a > < sup > < a href = 'SkRect_Reference#SkRect_contains_2' > [2]< / a > < / sup > < sup > < a href = 'SkRect_Reference#SkRect_contains_3' > [3]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_contains_4' > < / a >
2018-01-26 17:56:22 +00:00
2018-10-16 14:30:28 +00:00
---
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
bool < a href = '#SkIRect_contains' > contains< / a > (const < a href = 'SkRect_Reference#SkRect' > SkRect< / a > & r) const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns true if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > contains < a href = '#SkIRect_contains_4_r' > r< / a > .
Returns false if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is empty or < a href = '#SkIRect_contains_4_r' > r< / a > is empty.
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
< a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > contains < a href = '#SkIRect_contains_4_r' > r< / a > when < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > area completely includes < a href = '#SkIRect_contains_4_r' > r< / a > area.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_contains_4_r' > < code > < strong > r< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > < a href = 'SkRect_Reference#SkRect' > SkRect< / a > contained< / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-10-31 16:14:03 +00:00
true if all sides of < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > are outside < a href = '#SkIRect_contains_4_r' > r< / a >
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "acbd79ffb304f332e4b38ef18e19663e" >
#### Example Output
~~~~
rect: (30, 50, 40, 60) contains (30, 50, 31, 51)
rect: (30, 50, 40, 60) does not contain (39, 49, 40, 50)
rect: (30, 50, 40, 60) does not contain (29, 59, 30, 60)
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_containsNoEmptyCheck' > containsNoEmptyCheck< / a > < sup > < a href = '#SkIRect_containsNoEmptyCheck_2' > [2]< / a > < / sup > < a href = 'SkRect_Reference#SkRect_contains' > SkRect::contains< / a > < sup > < a href = 'SkRect_Reference#SkRect_contains_2' > [2]< / a > < / sup > < sup > < a href = 'SkRect_Reference#SkRect_contains_3' > [3]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_containsNoEmptyCheck' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
bool < a href = '#SkIRect_containsNoEmptyCheck' > containsNoEmptyCheck< / a > (int32_t left, int32_t top, int32_t right, int32_t bottom) const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Constructs < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > from (< a href = '#SkIRect_containsNoEmptyCheck_left' > left< / a > , < a href = '#SkIRect_containsNoEmptyCheck_top' > top< / a > , < a href = '#SkIRect_containsNoEmptyCheck_right' > right< / a > , < a href = '#SkIRect_containsNoEmptyCheck_bottom' > bottom< / a > ). Does not sort
2017-10-09 18:07:42 +00:00
construction.
2018-10-31 16:14:03 +00:00
Returns true if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > contains construction.
Asserts if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is empty or construction is empty, and if SK_DEBUG is defined.
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
Return is undefined if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is empty or construction is empty.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_containsNoEmptyCheck_left' > < code > < strong > left< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > x-axis minimum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_containsNoEmptyCheck_top' > < code > < strong > top< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > y-axis minimum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_containsNoEmptyCheck_right' > < code > < strong > right< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > x-axis maximum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_containsNoEmptyCheck_bottom' > < code > < strong > bottom< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > y-axis maximum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-10-31 16:14:03 +00:00
true if all sides of < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > are outside construction
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "fef2a36bee224e92500199fa9d3cbb8b" >
#### Example Output
~~~~
rect: (30, 50, 40, 60) contains (30, 50, 31, 51)
rect: (30, 50, 40, 60) does not contain (39, 49, 40, 50)
rect: (30, 50, 40, 60) does not contain (29, 59, 30, 60)
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_contains' > contains< / a > < sup > < a href = '#SkIRect_contains_2' > [2]< / a > < / sup > < sup > < a href = '#SkIRect_contains_3' > [3]< / a > < / sup > < sup > < a href = '#SkIRect_contains_4' > [4]< / a > < / sup > < a href = 'SkRect_Reference#SkRect_contains' > SkRect::contains< / a > < sup > < a href = 'SkRect_Reference#SkRect_contains_2' > [2]< / a > < / sup > < sup > < a href = 'SkRect_Reference#SkRect_contains_3' > [3]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_containsNoEmptyCheck_2' > < / a >
2018-01-26 17:56:22 +00:00
2018-10-16 14:30:28 +00:00
---
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
bool < a href = '#SkIRect_containsNoEmptyCheck' > containsNoEmptyCheck< / a > (const < a href = '#SkIRect' > SkIRect< / a > & r) const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns true if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > contains construction.
Asserts if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is empty or construction is empty, and if SK_DEBUG is defined.
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
Return is undefined if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is empty or construction is empty.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_containsNoEmptyCheck_2_r' > < code > < strong > r< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > contained< / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-10-31 16:14:03 +00:00
true if all sides of < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > are outside < a href = '#SkIRect_containsNoEmptyCheck_2_r' > r< / a >
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "8f91f58001d9c10420eb146fbc169af4" >
#### Example Output
~~~~
rect: (30, 50, 40, 60) contains (30, 50, 31, 51)
rect: (30, 50, 40, 60) does not contain (39, 49, 40, 50)
rect: (30, 50, 40, 60) does not contain (29, 59, 30, 60)
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_contains' > contains< / a > < sup > < a href = '#SkIRect_contains_2' > [2]< / a > < / sup > < sup > < a href = '#SkIRect_contains_3' > [3]< / a > < / sup > < sup > < a href = '#SkIRect_contains_4' > [4]< / a > < / sup > < a href = 'SkRect_Reference#SkRect_contains' > SkRect::contains< / a > < sup > < a href = 'SkRect_Reference#SkRect_contains_2' > [2]< / a > < / sup > < sup > < a href = 'SkRect_Reference#SkRect_contains_3' > [3]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_intersect' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
bool < a href = '#SkIRect_intersect' > intersect< / a > (const < a href = '#SkIRect' > SkIRect< / a > & r)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns true if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > intersects < a href = '#SkIRect_intersect()_r' > r< / a > , and sets < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to intersection.
Returns false if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > does not intersect < a href = '#SkIRect_intersect()_r' > r< / a > , and leaves < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > unchanged.
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
Returns false if either < a href = '#SkIRect_intersect()_r' > r< / a > or < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is empty, leaving < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > unchanged.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_intersect_r' > < code > < strong > r< / strong > < / code > < / a > < / td >
< td > limit of result< / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-10-31 16:14:03 +00:00
true if < a href = '#SkIRect_intersect()_r' > r< / a > and < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > have area in common
2017-10-09 18:07:42 +00:00
### Example
2018-05-16 11:07:07 +00:00
< div > < fiddle-embed name = "ea233f5d5d1ae0e76fc6f2eb371c927a" > < div > Two < a href = 'undocumented#SkDebugf' > SkDebugf< / a > calls are required. If the calls are combined, their arguments
2018-01-26 17:56:22 +00:00
may not be evaluated in left to right order: the printed intersection may
2018-03-05 18:26:16 +00:00
be before or after the call to intersect.
< / div >
2017-10-09 18:07:42 +00:00
#### Example Output
~~~~
intersection: 30, 60, 50, 80
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_Intersects' > Intersects< / a > < a href = '#SkIRect_intersectNoEmptyCheck' > intersectNoEmptyCheck< / a > < a href = '#SkIRect_join' > join< / a > < sup > < a href = '#SkIRect_join_2' > [2]< / a > < / sup > < a href = 'SkRect_Reference#SkRect_intersect' > SkRect::intersect< / a > < sup > < a href = 'SkRect_Reference#SkRect_intersect_2' > [2]< / a > < / sup > < sup > < a href = 'SkRect_Reference#SkRect_intersect_3' > [3]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_intersect_2' > < / a >
2018-01-26 17:56:22 +00:00
2018-10-16 14:30:28 +00:00
---
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
2018-10-08 18:57:48 +00:00
bool < a href = '#SkIRect_intersect' > intersect< / a > (const < a href = '#SkIRect' > SkIRect< / a > & a, const < a href = '#SkIRect' > SkIRect< / a > & b)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns true if < a href = '#SkIRect_intersect_2_a' > a< / a > intersects < a href = '#SkIRect_intersect_2_b' > b< / a > , and sets < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to intersection.
Returns false if < a href = '#SkIRect_intersect_2_a' > a< / a > does not intersect < a href = '#SkIRect_intersect_2_b' > b< / a > , and leaves < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > unchanged.
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
Returns false if either < a href = '#SkIRect_intersect_2_a' > a< / a > or < a href = '#SkIRect_intersect_2_b' > b< / a > is empty, leaving < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > unchanged.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_intersect_2_a' > < code > < strong > a< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to intersect< / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_intersect_2_b' > < code > < strong > b< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to intersect< / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-05-16 11:07:07 +00:00
true if < a href = '#SkIRect_intersect_2_a' > a< / a > and < a href = '#SkIRect_intersect_2_b' > b< / a > have area in common
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "b2db0573aacf99ca52776c5522459d02" >
#### Example Output
~~~~
intersection: 30, 60, 50, 80
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_Intersects' > Intersects< / a > < a href = '#SkIRect_intersectNoEmptyCheck' > intersectNoEmptyCheck< / a > < a href = '#SkIRect_join' > join< / a > < sup > < a href = '#SkIRect_join_2' > [2]< / a > < / sup > < a href = 'SkRect_Reference#SkRect_intersect' > SkRect::intersect< / a > < sup > < a href = 'SkRect_Reference#SkRect_intersect_2' > [2]< / a > < / sup > < sup > < a href = 'SkRect_Reference#SkRect_intersect_3' > [3]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_intersectNoEmptyCheck' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
2018-10-08 18:57:48 +00:00
bool < a href = '#SkIRect_intersectNoEmptyCheck' > intersectNoEmptyCheck< / a > (const < a href = '#SkIRect' > SkIRect< / a > & a, const < a href = '#SkIRect' > SkIRect< / a > & b)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns true if < a href = '#SkIRect_intersectNoEmptyCheck_a' > a< / a > intersects < a href = '#SkIRect_intersectNoEmptyCheck_b' > b< / a > , and sets < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to intersection.
Returns false if < a href = '#SkIRect_intersectNoEmptyCheck_a' > a< / a > does not intersect < a href = '#SkIRect_intersectNoEmptyCheck_b' > b< / a > , and leaves < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > unchanged.
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
Asserts if either < a href = '#SkIRect_intersectNoEmptyCheck_a' > a< / a > or < a href = '#SkIRect_intersectNoEmptyCheck_b' > b< / a > is empty, and if SK_DEBUG is defined.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_intersectNoEmptyCheck_a' > < code > < strong > a< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to intersect< / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_intersectNoEmptyCheck_b' > < code > < strong > b< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to intersect< / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-05-16 11:07:07 +00:00
true if < a href = '#SkIRect_intersectNoEmptyCheck_a' > a< / a > and < a href = '#SkIRect_intersectNoEmptyCheck_b' > b< / a > have area in common
2017-10-09 18:07:42 +00:00
### Example
2018-07-04 05:33:26 +00:00
< div > < fiddle-embed name = "d35fbc9fdea71df8b8a12fd3da50d11c" >
2017-10-09 18:07:42 +00:00
#### Example Output
~~~~
intersection: 30, 60, 50, 80
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_Intersects' > Intersects< / a > < a href = '#SkIRect_intersect' > intersect< / a > < sup > < a href = '#SkIRect_intersect_2' > [2]< / a > < / sup > < sup > < a href = '#SkIRect_intersect_3' > [3]< / a > < / sup > < a href = '#SkIRect_join' > join< / a > < sup > < a href = '#SkIRect_join_2' > [2]< / a > < / sup > < a href = 'SkRect_Reference#SkRect_intersect' > SkRect::intersect< / a > < sup > < a href = 'SkRect_Reference#SkRect_intersect_2' > [2]< / a > < / sup > < sup > < a href = 'SkRect_Reference#SkRect_intersect_3' > [3]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_intersect_3' > < / a >
2018-01-26 17:56:22 +00:00
2018-10-16 14:30:28 +00:00
---
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
bool < a href = '#SkIRect_intersect' > intersect< / a > (int32_t left, int32_t top, int32_t right, int32_t bottom)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Constructs < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to intersect from (< a href = '#SkIRect_intersect_3_left' > left< / a > , < a href = '#SkIRect_intersect_3_top' > top< / a > , < a href = '#SkIRect_intersect_3_right' > right< / a > , < a href = '#SkIRect_intersect_3_bottom' > bottom< / a > ). Does not sort
2017-10-09 18:07:42 +00:00
construction.
2018-10-31 16:14:03 +00:00
Returns true if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > intersects construction, and sets < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to intersection.
Returns false if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > does not intersect construction, and leaves < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > unchanged.
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
Returns false if either construction or < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is empty, leaving < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > unchanged.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_intersect_3_left' > < code > < strong > left< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > x-axis minimum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_intersect_3_top' > < code > < strong > top< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > y-axis minimum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_intersect_3_right' > < code > < strong > right< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > x-axis maximum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_intersect_3_bottom' > < code > < strong > bottom< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > y-axis maximum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-10-31 16:14:03 +00:00
true if construction and < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > have area in common
2017-10-09 18:07:42 +00:00
### Example
2018-05-16 11:07:07 +00:00
< div > < fiddle-embed name = "200422990eded2f754ab9893118f2645" > < div > Two < a href = 'undocumented#SkDebugf' > SkDebugf< / a > calls are required. If the calls are combined, their arguments
2018-01-26 17:56:22 +00:00
may not be evaluated in left to right order: the printed intersection may
2018-03-05 18:26:16 +00:00
be before or after the call to intersect.
< / div >
2017-10-09 18:07:42 +00:00
#### Example Output
~~~~
intersection: 30, 60, 50, 80
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_intersectNoEmptyCheck' > intersectNoEmptyCheck< / a > < a href = '#SkIRect_Intersects' > Intersects< / a > < a href = '#SkIRect_join' > join< / a > < sup > < a href = '#SkIRect_join_2' > [2]< / a > < / sup > < a href = 'SkRect_Reference#SkRect_intersect' > SkRect::intersect< / a > < sup > < a href = 'SkRect_Reference#SkRect_intersect_2' > [2]< / a > < / sup > < sup > < a href = 'SkRect_Reference#SkRect_intersect_3' > [3]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_Intersects' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
static bool < a href = '#SkIRect_Intersects' > Intersects< / a > (const < a href = '#SkIRect' > SkIRect< / a > & a, const < a href = '#SkIRect' > SkIRect< / a > & b)
2017-10-09 18:07:42 +00:00
< / pre >
2018-05-16 11:07:07 +00:00
Returns true if < a href = '#SkIRect_Intersects_a' > a< / a > intersects < a href = '#SkIRect_Intersects_b' > b< / a > .
Returns false if either < a href = '#SkIRect_Intersects_a' > a< / a > or < a href = '#SkIRect_Intersects_b' > b< / a > is empty, or do not intersect.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_Intersects_a' > < code > < strong > a< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to intersect< / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_Intersects_b' > < code > < strong > b< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to intersect< / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-05-16 11:07:07 +00:00
true if < a href = '#SkIRect_Intersects_a' > a< / a > and < a href = '#SkIRect_Intersects_b' > b< / a > have area in common
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "0c67cf8981389efc7108369fb9b7976b" >
#### Example Output
~~~~
intersection
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_IntersectsNoEmptyCheck' > IntersectsNoEmptyCheck< / a > < a href = '#SkIRect_intersect' > intersect< / a > < sup > < a href = '#SkIRect_intersect_2' > [2]< / a > < / sup > < sup > < a href = '#SkIRect_intersect_3' > [3]< / a > < / sup > < a href = 'SkRect_Reference#SkRect_intersect' > SkRect::intersect< / a > < sup > < a href = 'SkRect_Reference#SkRect_intersect_2' > [2]< / a > < / sup > < sup > < a href = 'SkRect_Reference#SkRect_intersect_3' > [3]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_IntersectsNoEmptyCheck' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
static bool < a href = '#SkIRect_IntersectsNoEmptyCheck' > IntersectsNoEmptyCheck< / a > (const < a href = '#SkIRect' > SkIRect< / a > & a, const < a href = '#SkIRect' > SkIRect< / a > & b)
2017-10-09 18:07:42 +00:00
< / pre >
2018-05-16 11:07:07 +00:00
Returns true if < a href = '#SkIRect_IntersectsNoEmptyCheck_a' > a< / a > intersects < a href = '#SkIRect_IntersectsNoEmptyCheck_b' > b< / a > .
Asserts if either < a href = '#SkIRect_IntersectsNoEmptyCheck_a' > a< / a > or < a href = '#SkIRect_IntersectsNoEmptyCheck_b' > b< / a > is empty, and if SK_DEBUG is defined.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_IntersectsNoEmptyCheck_a' > < code > < strong > a< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to intersect< / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_IntersectsNoEmptyCheck_b' > < code > < strong > b< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to intersect< / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Return Value
2018-05-16 11:07:07 +00:00
true if < a href = '#SkIRect_IntersectsNoEmptyCheck_a' > a< / a > and < a href = '#SkIRect_IntersectsNoEmptyCheck_b' > b< / a > have area in common
2017-10-09 18:07:42 +00:00
### Example
2018-07-18 20:21:51 +00:00
< div > < fiddle-embed name = "dba234d15162fb5b26e1a96529ca6a2a" >
2017-10-09 18:07:42 +00:00
#### Example Output
~~~~
intersection
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_Intersects' > Intersects< / a > < a href = '#SkIRect_intersect' > intersect< / a > < sup > < a href = '#SkIRect_intersect_2' > [2]< / a > < / sup > < sup > < a href = '#SkIRect_intersect_3' > [3]< / a > < / sup > < a href = 'SkRect_Reference#SkRect_intersect' > SkRect::intersect< / a > < sup > < a href = 'SkRect_Reference#SkRect_intersect_2' > [2]< / a > < / sup > < sup > < a href = 'SkRect_Reference#SkRect_intersect_3' > [3]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-10-16 14:30:28 +00:00
< a name = 'Join' > < / a >
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_join' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
void < a href = '#SkIRect_join' > join< / a > (int32_t left, int32_t top, int32_t right, int32_t bottom)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Constructs < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to intersect from (< a href = '#SkIRect_join()_left' > left< / a > , < a href = '#SkIRect_join()_top' > top< / a > , < a href = '#SkIRect_join()_right' > right< / a > , < a href = '#SkIRect_join()_bottom' > bottom< / a > ). Does not sort
2017-10-09 18:07:42 +00:00
construction.
2018-10-31 16:14:03 +00:00
Sets < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to the union of itself and the construction.
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
Has no effect if construction is empty. Otherwise, if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is empty, sets
< a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to construction.
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_join_left' > < code > < strong > left< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > x-axis minimum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_join_top' > < code > < strong > top< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > y-axis minimum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_join_right' > < code > < strong > right< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > x-axis maximum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2018-05-16 11:07:07 +00:00
< / tr >
< tr > < td > < a name = 'SkIRect_join_bottom' > < code > < strong > bottom< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > y-axis maximum of constructed < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Example
< div > < fiddle-embed name = "c00ef06289d21db70340e465690e0e08" >
#### Example Output
~~~~
join: 10, 20, 55, 65
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_set' > set< / a > < a href = 'SkRect_Reference#SkRect_join' > SkRect::join< / a > < sup > < a href = 'SkRect_Reference#SkRect_join_2' > [2]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_join_2' > < / a >
2018-01-26 17:56:22 +00:00
2018-10-16 14:30:28 +00:00
---
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
void < a href = '#SkIRect_join' > join< / a > (const < a href = '#SkIRect' > SkIRect< / a > & r)
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Sets < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to the union of itself and < a href = '#SkIRect_join_2_r' > r< / a > .
2017-10-09 18:07:42 +00:00
2018-10-31 16:14:03 +00:00
Has no effect if < a href = '#SkIRect_join_2_r' > r< / a > is empty. Otherwise, if < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > is empty, sets < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > to < a href = '#SkIRect_join_2_r' > r< / a > .
2017-10-09 18:07:42 +00:00
### Parameters
2018-05-16 11:07:07 +00:00
< table > < tr > < td > < a name = 'SkIRect_join_2_r' > < code > < strong > r< / strong > < / code > < / a > < / td >
2018-10-31 16:14:03 +00:00
< td > expansion < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > < / td >
2017-10-09 18:07:42 +00:00
< / tr >
< / table >
### Example
< div > < fiddle-embed name = "75fd81c1d3512e63890d085593018876" >
#### Example Output
~~~~
join: 10, 20, 55, 65
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_set' > set< / a > < a href = 'SkRect_Reference#SkRect_join' > SkRect::join< / a > < sup > < a href = 'SkRect_Reference#SkRect_join_2' > [2]< / a > < / sup >
2017-10-09 18:07:42 +00:00
2018-10-16 14:30:28 +00:00
< a name = 'Sorting' > < / a >
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_sort' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
void < a href = '#SkIRect_sort' > sort< / a > ()
2017-10-09 18:07:42 +00:00
< / pre >
2018-05-16 11:07:07 +00:00
Swaps < a href = '#SkIRect_fLeft' > fLeft< / a > and < a href = '#SkIRect_fRight' > fRight< / a > if < a href = '#SkIRect_fLeft' > fLeft< / a > is greater than < a href = '#SkIRect_fRight' > fRight< / a > ; and swaps
< a href = '#SkIRect_fTop' > fTop< / a > and < a href = '#SkIRect_fBottom' > fBottom< / a > if < a href = '#SkIRect_fTop' > fTop< / a > is greater than < a href = '#SkIRect_fBottom' > fBottom< / a > . Result may be empty,
2018-10-31 16:14:03 +00:00
and < a href = '#SkIRect_width' > width()< / a > and < a href = '#SkIRect_height' > height()< / a > will be zero or positive.
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "fa12547fcfd4c1aef3db1a1f6aae0fe4" >
#### Example Output
~~~~
rect: 30, 50, 20, 10
sorted: 20, 10, 30, 50
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_makeSorted' > makeSorted< / a > < a href = 'SkRect_Reference#SkRect_sort' > SkRect::sort< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_makeSorted' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
< a href = '#SkIRect' > SkIRect< / a > < a href = '#SkIRect_makeSorted' > makeSorted< / a > () const
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > with < a href = '#SkIRect_fLeft' > fLeft< / a > and < a href = '#SkIRect_fRight' > fRight< / a > swapped if < a href = '#SkIRect_fLeft' > fLeft< / a > is greater than < a href = '#SkIRect_fRight' > fRight< / a > ; and
2018-05-16 11:07:07 +00:00
with < a href = '#SkIRect_fTop' > fTop< / a > and < a href = '#SkIRect_fBottom' > fBottom< / a > swapped if < a href = '#SkIRect_fTop' > fTop< / a > is greater than < a href = '#SkIRect_fBottom' > fBottom< / a > . Result may be empty;
2018-10-31 16:14:03 +00:00
and < a href = '#SkIRect_width' > width()< / a > and < a href = '#SkIRect_height' > height()< / a > will be zero or positive.
2017-10-09 18:07:42 +00:00
### Return Value
2018-10-31 16:14:03 +00:00
sorted < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a >
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "de89926c374aa16427916900b89a3441" >
#### Example Output
~~~~
rect: 30, 50, 20, 10
sorted: 20, 10, 30, 50
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_sort' > sort< / a > < a href = 'SkRect_Reference#SkRect_makeSorted' > SkRect::makeSorted< / a >
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< a name = 'SkIRect_EmptyIRect' > < / a >
2018-10-16 14:30:28 +00:00
---
2017-10-09 18:07:42 +00:00
2018-05-16 11:07:07 +00:00
< pre style = "padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0 " >
2018-10-08 18:57:48 +00:00
static const < a href = '#SkIRect' > SkIRect< / a > & < a href = '#SkIRect_EmptyIRect' > EmptyIRect< / a > ()
2017-10-09 18:07:42 +00:00
< / pre >
2018-10-31 16:14:03 +00:00
Returns a reference to immutable empty < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > , set to (0, 0, 0, 0).
2017-10-09 18:07:42 +00:00
### Return Value
2018-10-31 16:14:03 +00:00
global < a href = 'SkIRect_Reference#SkIRect' > SkIRect< / a > set to all zeroes
2017-10-09 18:07:42 +00:00
### Example
< div > < fiddle-embed name = "65e0b9b52e907902630577941fb3ed6d" >
#### Example Output
~~~~
rect: 0, 0, 0, 0
~~~~
< / fiddle-embed > < / div >
### See Also
2018-05-16 11:07:07 +00:00
< a href = '#SkIRect_MakeEmpty' > MakeEmpty< / a >
2017-10-09 18:07:42 +00:00
