diff options
author | Cary Clark <caryclark@skia.org> | 2018-01-08 16:20:59 -0500 |
---|---|---|
committer | Skia Commit-Bot <skia-commit-bot@chromium.org> | 2018-01-08 22:00:01 +0000 |
commit | 0c95aab176558ab1a050e69d361fde2b54226360 (patch) | |
tree | 655f5caf1739574a6d7ce4bccd3e2aaada55e392 /site/user | |
parent | 2c33e3e3f40ebcde0bfa6d22cc34b6b97526fb36 (diff) |
fix example and suppress MakeLargest
add rule to skip MakeLargest until
general rule suppressing contents
of #if SK_SUPPORT_LEGACY_... can be
added.
Docs-Preview: https://skia.org/?cl=92221
Bug: skia:6898
Change-Id: Ic2783bf110098626f5e846c3765e72aefbb4398d
Reviewed-on: https://skia-review.googlesource.com/92221
Commit-Queue: Cary Clark <caryclark@skia.org>
Reviewed-by: Mike Reed <reed@google.com>
Reviewed-by: Cary Clark <caryclark@skia.org>
Diffstat (limited to 'site/user')
-rw-r--r-- | site/user/api/SkIRect_Reference.md | 132 | ||||
-rw-r--r-- | site/user/api/SkRect_Reference.md | 211 | ||||
-rw-r--r-- | site/user/api/catalog.htm | 78 |
3 files changed, 38 insertions, 383 deletions
diff --git a/site/user/api/SkIRect_Reference.md b/site/user/api/SkIRect_Reference.md index fcbe17e39b..51e96f002d 100644 --- a/site/user/api/SkIRect_Reference.md +++ b/site/user/api/SkIRect_Reference.md @@ -33,7 +33,6 @@ its <a href="#SkIRect_top">top</a>, it is considered empty. | <a href="#SkIRect_IntersectsNoEmptyCheck">IntersectsNoEmptyCheck</a> | Returns true if areas overlap. Skips empty check. | | <a href="#SkIRect_MakeEmpty">MakeEmpty</a> | Returns bounds of (0, 0, 0, 0). | | <a href="#SkIRect_MakeLTRB">MakeLTRB</a> | Constructs from int <a href="#SkIRect_left">left</a>, <a href="#SkIRect_top">top</a>, <a href="#SkIRect_right">right</a>, <a href="#SkIRect_bottom">bottom</a>. | -| <a href="#SkIRect_MakeLargest">MakeLargest</a> | Constructs from (<a href="undocumented#SK_MinS32">SK MinS32</a>, <a href="undocumented#SK_MinS32">SK MinS32</a>, <a href="undocumented#SK_MaxS32">SK MaxS32</a>, <a href="undocumented#SK_MaxS32">SK MaxS32</a>). | | <a href="#SkIRect_MakeSize">MakeSize</a> | Constructs from <a href="undocumented#ISize">ISize</a> returning (0, 0, <a href="#SkIRect_width">width</a>, <a href="#SkIRect_height">height</a>). | | <a href="#SkIRect_MakeWH">MakeWH</a> | Constructs from int input returning (0, 0, <a href="#SkIRect_width">width</a>, <a href="#SkIRect_height">height</a>). | | <a href="#SkIRect_MakeXYWH">MakeXYWH</a> | Constructs from int input returning (<a href="#SkIRect_x">x</a>, <a href="#SkIRect_y">y</a>, <a href="#SkIRect_width">width</a>, <a href="#SkIRect_height">height</a>). | @@ -48,7 +47,6 @@ its <a href="#SkIRect_top">top</a>, it is considered empty. | <a href="#SkIRect_intersectNoEmptyCheck">intersectNoEmptyCheck</a> | Sets to shared area; returns true if not empty. Skips empty check. | | <a href="#SkIRect_is16Bit">is16Bit</a> | Returns true if members fit in 16-bit word. | | <a href="#SkIRect_isEmpty">isEmpty</a> | Returns true if <a href="#SkIRect_width">width</a> or <a href="#SkIRect_height">height</a> are zero or negative. | -| <a href="#SkIRect_isLargest">isLargest</a> | Returns true if equal to (<a href="undocumented#SK_MinS32">SK MinS32</a>, <a href="undocumented#SK_MinS32">SK MinS32</a>, <a href="undocumented#SK_MaxS32">SK MaxS32</a>, <a href="undocumented#SK_MaxS32">SK MaxS32</a>). | | <a href="#SkIRect_join">join</a> | Sets to union of bounds. | | <a href="#SkIRect_left">left</a> | Returns smaller bounds in <a href="#SkIRect_x">x</a>, if sorted. | | <a href="#SkIRect_makeInset">makeInset</a> | Constructs from sides moved symmetrically about the center. | @@ -63,8 +61,6 @@ its <a href="#SkIRect_top">top</a>, it is considered empty. | <a href="#SkIRect_set">set</a> | Sets to (<a href="#SkIRect_left">left</a>, <a href="#SkIRect_top">top</a>, <a href="#SkIRect_right">right</a>, <a href="#SkIRect_bottom">bottom</a>). | | <a href="#SkIRect_setEmpty">setEmpty</a> | Sets to (0, 0, 0, 0). | | <a href="#SkIRect_setLTRB">setLTRB</a> | Sets to <a href="undocumented#SkScalar">SkScalar</a> input (<a href="#SkIRect_left">left</a>, <a href="#SkIRect_top">top</a>, <a href="#SkIRect_right">right</a>, <a href="#SkIRect_bottom">bottom</a>). | -| <a href="#SkIRect_setLargest">setLargest</a> | Sets to (<a href="undocumented#SK_MinS32">SK MinS32</a>, <a href="undocumented#SK_MinS32">SK MinS32</a>, <a href="undocumented#SK_MaxS32">SK MaxS32</a>, <a href="undocumented#SK_MaxS32">SK MaxS32</a>). | -| <a href="#SkIRect_setLargestInverted">setLargestInverted</a> | Sets to (<a href="undocumented#SK_MaxS32">SK MaxS32</a>, <a href="undocumented#SK_MaxS32">SK MaxS32</a>, <a href="undocumented#SK_MinS32">SK MinS32</a>, <a href="undocumented#SK_MinS32">SK MinS32</a>). | | <a href="#SkIRect_setXYWH">setXYWH</a> | Sets to (<a href="#SkIRect_x">x</a>, <a href="#SkIRect_y">y</a>, <a href="#SkIRect_width">width</a>, <a href="#SkIRect_height">height</a>). | | <a href="#SkIRect_size">size</a> | Returns <a href="undocumented#ISize">ISize</a> (<a href="#SkIRect_width">width</a>, <a href="#SkIRect_height">height</a>). | | <a href="#SkIRect_sort">sort</a> | Orders sides from smaller to larger. | @@ -126,42 +122,7 @@ outset rect isEmpty: false ### See Also -<a href="#SkIRect_EmptyIRect">EmptyIRect</a> <a href="#SkIRect_isEmpty">isEmpty</a> <a href="#SkIRect_setEmpty">setEmpty</a> <a href="#SkIRect_setLargestInverted">setLargestInverted</a> <a href="#SkRect_MakeEmpty">SkRect::MakeEmpty</a> - ---- - -<a name="SkIRect_MakeLargest"></a> -## MakeLargest - -<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> -static SkIRect SK_WARN_UNUSED_RESULT MakeLargest() -</pre> - -Returns constructed <a href="#IRect">IRect</a> setting <a href="#SkIRect_left">left</a> and <a href="#SkIRect_top">top</a> to most negative value, and -setting <a href="#SkIRect_right">right</a> and <a href="#SkIRect_bottom">bottom</a> to most positive value. - -### Return Value - -bounds (<a href="undocumented#SK_MinS32">SK MinS32</a>, <a href="undocumented#SK_MinS32">SK MinS32</a>, <a href="undocumented#SK_MaxS32">SK MaxS32</a>, <a href="undocumented#SK_MaxS32">SK MaxS32</a>) - -### Example - -<div><fiddle-embed name="2b32ed04a64cd3d5fb525d404cbb9a09"> - -#### Example Output - -~~~~ -MakeLargest isLargest: true -MakeLargest isEmpty: false -outset isLargest: false -outset isEmpty: true -~~~~ - -</fiddle-embed></div> - -### See Also - -<a href="#SkIRect_isLargest">isLargest</a> <a href="#SkIRect_setLargest">setLargest</a> <a href="#SkRect_MakeLargest">SkRect::MakeLargest</a> +<a href="#SkIRect_EmptyIRect">EmptyIRect</a> <a href="#SkIRect_isEmpty">isEmpty</a> <a href="#SkIRect_setEmpty">setEmpty</a> <a href="#SkRect_MakeEmpty">SkRect::MakeEmpty</a> --- @@ -744,40 +705,6 @@ sorted: {20, 40, 20, 50} is empty --- -<a name="SkIRect_isLargest"></a> -## isLargest - -<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> -bool isLargest() const -</pre> - -Returns true if <a href="#IRect">IRect</a> encloses largest possible area. - -### Return Value - -true if equal to (<a href="undocumented#SK_MinS32">SK MinS32</a>, <a href="undocumented#SK_MinS32">SK MinS32</a>, <a href="undocumented#SK_MaxS32">SK MaxS32</a>, <a href="undocumented#SK_MaxS32">SK MaxS32</a>) - -### Example - -<div><fiddle-embed name="477e0a7f0aa8aec1d94e1e117041a335"><div>Note that the <a href="#SkIRect_width">width</a> is not negative, yet it cannot be represented as a 32-bit -signed integer.</div> - -#### Example Output - -~~~~ -large is largest: true -large width -2 -large is empty: false -~~~~ - -</fiddle-embed></div> - -### See Also - -<a href="#SkIRect_MakeLargest">MakeLargest</a> <a href="#SkRect_isLargest">SkRect::isLargest</a> - ---- - <a name="SkIRect_equal_operator"></a> ## operator== @@ -1055,54 +982,6 @@ rect: -10, 35, 5, 60 isEmpty: false --- -<a name="SkIRect_setLargest"></a> -## setLargest - -<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> -void setLargest() -</pre> - -Sets rectangle <a href="#SkIRect_left">left</a> and <a href="#SkIRect_top">top</a> to most negative value, and sets -<a href="#SkIRect_right">right</a> and <a href="#SkIRect_bottom">bottom</a> to most positive value. - -### Example - -<div><fiddle-embed name="d5d67c6f09a14d06f1ee988cb56525b5"> - -#### Example Output - -~~~~ -MakeLargest isLargest: true -MakeLargest isEmpty: false -outset isLargest: false -outset isEmpty: true -~~~~ - -</fiddle-embed></div> - -### See Also - -<a href="#SkIRect_MakeLargest">MakeLargest</a> <a href="#SkIRect_isLargest">isLargest</a> <a href="#SkIRect_setLargestInverted">setLargestInverted</a> <a href="undocumented#SK_MinS32">SK MinS32</a> <a href="undocumented#SK_MaxS32">SK MaxS32</a> - ---- - -<a name="SkIRect_setLargestInverted"></a> -## setLargestInverted - -<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> -void setLargestInverted() -</pre> - -Sets rectangle <a href="#SkIRect_left">left</a> and <a href="#SkIRect_top">top</a> to most positive value, and sets -<a href="#SkIRect_right">right</a> and <a href="#SkIRect_bottom">bottom</a> to most negative value. This is used internally to -flag that a condition is met, but otherwise has no special purpose. - -### See Also - -<a href="#SkIRect_setEmpty">setEmpty</a> <a href="#SkIRect_setLargest">setLargest</a> - ---- - <a name="SkIRect_makeOffset"></a> ## makeOffset @@ -2195,3 +2074,12 @@ rect: 0, 0, 0, 0 --- +<a name="SkIRect_MakeLargest"></a> +## MakeLargest + +<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> +static SkIRect SK_WARN_UNUSED_RESULT MakeLargest() +</pre> + +--- + diff --git a/site/user/api/SkRect_Reference.md b/site/user/api/SkRect_Reference.md index 9f97cbea27..678f28f8af 100644 --- a/site/user/api/SkRect_Reference.md +++ b/site/user/api/SkRect_Reference.md @@ -37,8 +37,6 @@ integer input cannot convert to <a href="undocumented#SkScalar">SkScalar</a> wit | <a href="#SkRect_MakeFromIRect">MakeFromIRect</a> | Deprecated. | | <a href="#SkRect_MakeIWH">MakeIWH</a> | Constructs from int input returning (0, 0, <a href="#SkRect_width">width</a>, <a href="#SkRect_height">height</a>). | | <a href="#SkRect_MakeLTRB">MakeLTRB</a> | Constructs from <a href="undocumented#SkScalar">SkScalar</a> <a href="#SkRect_left">left</a>, <a href="#SkRect_top">top</a>, <a href="#SkRect_right">right</a>, <a href="#SkRect_bottom">bottom</a>. | -| <a href="#SkRect_MakeLargest">MakeLargest</a> | Constructs (<a href="undocumented#SK_ScalarMin">SK ScalarMin</a>, <a href="undocumented#SK_ScalarMin">SK ScalarMin</a>, <a href="undocumented#SK_ScalarMax">SK ScalarMax</a>, <a href="undocumented#SK_ScalarMax">SK ScalarMax</a>). | -| <a href="#SkRect_MakeLargestS32">MakeLargestS32</a> | Constructs largest signed integers that fit in 32-bit float. | | <a href="#SkRect_MakeSize">MakeSize</a> | Constructs from <a href="undocumented#Size">Size</a> returning (0, 0, <a href="#SkRect_width">width</a>, <a href="#SkRect_height">height</a>). | | <a href="#SkRect_MakeWH">MakeWH</a> | Constructs from <a href="undocumented#SkScalar">SkScalar</a> input returning (0, 0, <a href="#SkRect_width">width</a>, <a href="#SkRect_height">height</a>). | | <a href="#SkRect_MakeXYWH">MakeXYWH</a> | Constructs from <a href="undocumented#SkScalar">SkScalar</a> input returning (<a href="#SkRect_x">x</a>, <a href="#SkRect_y">y</a>, <a href="#SkRect_width">width</a>, <a href="#SkRect_height">height</a>). | @@ -56,7 +54,6 @@ integer input cannot convert to <a href="undocumented#SkScalar">SkScalar</a> wit | <a href="#SkRect_intersects">intersects</a> | Returns true if areas overlap. | | <a href="#SkRect_isEmpty">isEmpty</a> | Returns true if <a href="#SkRect_width">width</a> or <a href="#SkRect_height">height</a> are zero or negative. | | <a href="#SkRect_isFinite">isFinite</a> | Returns true if no member is infinite or NaN. | -| <a href="#SkRect_isLargest">isLargest</a> | Returns equal to (<a href="undocumented#SK_ScalarMin">SK ScalarMin</a>, <a href="undocumented#SK_ScalarMin">SK ScalarMin</a>, <a href="undocumented#SK_ScalarMax">SK ScalarMax</a>, <a href="undocumented#SK_ScalarMax">SK ScalarMax</a>). | | <a href="#SkRect_isSorted">isSorted</a> | Returns true if <a href="#SkRect_width">width</a> or <a href="#SkRect_height">height</a> are zero or positive. | | <a href="#SkRect_iset">iset</a> | Sets to int input (<a href="#SkRect_left">left</a>, <a href="#SkRect_top">top</a>, <a href="#SkRect_right">right</a>, <a href="#SkRect_bottom">bottom</a>). | | <a href="#SkRect_isetWH">isetWH</a> | Sets to int input (0, 0, <a href="#SkRect_width">width</a>, <a href="#SkRect_height">height</a>). | @@ -80,8 +77,6 @@ integer input cannot convert to <a href="undocumented#SkScalar">SkScalar</a> wit | <a href="#SkRect_setBoundsCheck">setBoundsCheck</a> | Sets to upper and lower limits of <a href="SkPoint_Reference#Point">Point</a> array. | | <a href="#SkRect_setEmpty">setEmpty</a> | Sets to (0, 0, 0, 0). | | <a href="#SkRect_setLTRB">setLTRB</a> | Sets to <a href="undocumented#SkScalar">SkScalar</a> input (<a href="#SkRect_left">left</a>, <a href="#SkRect_top">top</a>, <a href="#SkRect_right">right</a>, <a href="#SkRect_bottom">bottom</a>). | -| <a href="#SkRect_setLargest">setLargest</a> | Sets to (<a href="undocumented#SK_ScalarMin">SK ScalarMin</a>, <a href="undocumented#SK_ScalarMin">SK ScalarMin</a>, <a href="undocumented#SK_ScalarMax">SK ScalarMax</a>, <a href="undocumented#SK_ScalarMax">SK ScalarMax</a>). | -| <a href="#SkRect_setLargestInverted">setLargestInverted</a> | Sets to (<a href="undocumented#SK_ScalarMax">SK ScalarMax</a>, <a href="undocumented#SK_ScalarMax">SK ScalarMax</a>, <a href="undocumented#SK_ScalarMin">SK ScalarMin</a>, <a href="undocumented#SK_ScalarMin">SK ScalarMin</a>). | | <a href="#SkRect_setWH">setWH</a> | Sets to <a href="undocumented#SkScalar">SkScalar</a> input (0, 0, <a href="#SkRect_width">width</a>, <a href="#SkRect_height">height</a>). | | <a href="#SkRect_setXYWH">setXYWH</a> | Sets to <a href="undocumented#SkScalar">SkScalar</a> input (<a href="#SkRect_x">x</a>, <a href="#SkRect_y">y</a>, <a href="#SkRect_width">width</a>, <a href="#SkRect_height">height</a>). | | <a href="#SkRect_sort">sort</a> | Orders sides from smaller to larger. | @@ -144,81 +139,7 @@ outset rect isEmpty: false ### See Also -<a href="#SkRect_isEmpty">isEmpty</a> <a href="#SkRect_setEmpty">setEmpty</a> <a href="#SkRect_setLargestInverted">setLargestInverted</a> <a href="#SkIRect_MakeEmpty">SkIRect::MakeEmpty</a> - ---- - -<a name="SkRect_MakeLargest"></a> -## MakeLargest - -<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> -static SkRect SK_WARN_UNUSED_RESULT MakeLargest() -</pre> - -Returns constructed <a href="#Rect">Rect</a> setting <a href="#SkRect_left">left</a> and <a href="#SkRect_top">top</a> to most negative finite value, and -setting <a href="#SkRect_right">right</a> and <a href="#SkRect_bottom">bottom</a> to most positive finite value. - -### Return Value - -bounds (<a href="undocumented#SK_ScalarMin">SK ScalarMin</a>, <a href="undocumented#SK_ScalarMin">SK ScalarMin</a>, <a href="undocumented#SK_ScalarMax">SK ScalarMax</a>, <a href="undocumented#SK_ScalarMax">SK ScalarMax</a>) - -### Example - -<div><fiddle-embed name="42774381948ce88ec19b5c0d16a84bd7"> - -#### Example Output - -~~~~ -MakeLargest isLargest: true -MakeLargest isFinite: true -outset a little isLargest: true -outset a little isFinite: true -outset a little more isLargest: false -outset a little more isFinite: false -~~~~ - -</fiddle-embed></div> - -### See Also - -<a href="#SkRect_MakeLargestS32">MakeLargestS32</a> <a href="#SkRect_isLargest">isLargest</a> <a href="#SkRect_setLargest">setLargest</a> <a href="#SkIRect_MakeLargest">SkIRect::MakeLargest</a> - ---- - -<a name="SkRect_MakeLargestS32"></a> -## MakeLargestS32 - -<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> -static SkRect SK_WARN_UNUSED_RESULT MakeLargestS32() -</pre> - -Returns constructed <a href="#Rect">Rect</a> that can be represented exactly with <a href="SkIRect_Reference#IRect">IRect</a>. The <a href="#SkRect_left">left</a> -and <a href="#SkRect_top">top</a> are <a href="#SkRect_set">set</a> to the most negative integer value that fits in a 32-bit float, -and the <a href="#SkRect_right">right</a> and <a href="#SkRect_bottom">bottom</a> are <a href="#SkRect_set">set</a> to the most positive finite value that fits in -a 32-bit float. - -These are the largest values for which <a href="#SkRect_round_2">round</a> is well defined. - -### Return Value - -bounds (<a href="undocumented#SK_MinS32FitsInFloat">SK MinS32FitsInFloat</a>, <a href="undocumented#SK_MinS32FitsInFloat">SK MinS32FitsInFloat</a>, -<a href="undocumented#SK_MaxS32FitsInFloat">SK MaxS32FitsInFloat</a>, <a href="undocumented#SK_MaxS32FitsInFloat">SK MaxS32FitsInFloat</a>) - -### Example - -<div><fiddle-embed name="9dde55347ba15b60166b5a0583c55587"> - -#### Example Output - -~~~~ -f_rect == r_rect -~~~~ - -</fiddle-embed></div> - -### See Also - -<a href="#SkRect_MakeLargest">MakeLargest</a> <a href="#SkRect_isLargest">isLargest</a> <a href="#SkRect_setLargest">setLargest</a> <a href="#SkIRect_MakeLargest">SkIRect::MakeLargest</a> +<a href="#SkRect_isEmpty">isEmpty</a> <a href="#SkRect_setEmpty">setEmpty</a> <a href="#SkIRect_MakeEmpty">SkIRect::MakeEmpty</a> --- @@ -610,41 +531,6 @@ sorted: {20, 40, 20, 50} is sorted --- -<a name="SkRect_isLargest"></a> -## isLargest - -<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> -bool isLargest() const -</pre> - -Returns true if <a href="#Rect">Rect</a> encloses largest possible area. - -### Return Value - -true if equal to (<a href="undocumented#SK_ScalarMin">SK ScalarMin</a>, <a href="undocumented#SK_ScalarMin">SK ScalarMin</a>, <a href="undocumented#SK_ScalarMax">SK ScalarMax</a>, <a href="undocumented#SK_ScalarMax">SK ScalarMax</a>) - -### Example - -<div><fiddle-embed name="30ef8865ff1ba8789ee1d3be92734ad8"><div>Note that the <a href="#SkRect_width">width</a> cannot be represented as a 32-bit finite value.</div> - -#### Example Output - -~~~~ -large is largest: true -large width inf -large is empty: false -large is sorted: true -large is finite: true -~~~~ - -</fiddle-embed></div> - -### See Also - -<a href="#SkRect_MakeLargest">MakeLargest</a> <a href="#SkIRect_isLargest">SkIRect::isLargest</a> - ---- - <a name="SkRect_isFinite"></a> ## isFinite @@ -661,7 +547,7 @@ true if no member is infinite or NaN ### Example -<div><fiddle-embed name="7365c6553b830e6535cea0ce0d07be19"> +<div><fiddle-embed name="443fe5f8296d4cdb19cc9862a9cf77a4"> #### Example Output @@ -1612,70 +1498,6 @@ rect: -15, 0, 0, 25 isEmpty: false --- -<a name="SkRect_setLargest"></a> -## setLargest - -<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> -void setLargest() -</pre> - -Sets rectangle <a href="#SkRect_left">left</a> and <a href="#SkRect_top">top</a> to most negative finite value, and sets -<a href="#SkRect_right">right</a> and <a href="#SkRect_bottom">bottom</a> to most positive finite value. - -### Example - -<div><fiddle-embed name="7a07b1914ade5c38cce6be417bc8aa4b"> - -#### Example Output - -~~~~ -MakeLargest isLargest: true -MakeLargest isFinite: true -outset a little isLargest: true -outset a little isFinite: true -outset a little more isLargest: false -outset a little more isFinite: false -~~~~ - -</fiddle-embed></div> - -### See Also - -<a href="#SkRect_MakeLargest">MakeLargest</a> <a href="#SkRect_isLargest">isLargest</a> <a href="#SkRect_setLargestInverted">setLargestInverted</a> <a href="undocumented#SK_ScalarMin">SK ScalarMin</a> <a href="undocumented#SK_ScalarMax">SK ScalarMax</a> - ---- - -<a name="SkRect_setLargestInverted"></a> -## setLargestInverted - -<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> -void setLargestInverted() -</pre> - -Sets rectangle <a href="#SkRect_left">left</a> and <a href="#SkRect_top">top</a> to most positive finite value, and sets -<a href="#SkRect_right">right</a> and <a href="#SkRect_bottom">bottom</a> to most negative finite value. - -Use to initial <a href="#Rect">Rect</a> before one or more calls to <a href="#SkRect_growToInclude">growToInclude</a>. - -### Example - -<div><fiddle-embed name="394442eedd4f01e42c5a4905e832dd0c"> - -#### Example Output - -~~~~ -original rect: 3.40282e+38, 3.40282e+38, -3.40282e+38, -3.40282e+38 isEmpty: true -grown rect: 42, 24, 42, 24 isEmpty: true -~~~~ - -</fiddle-embed></div> - -### See Also - -<a href="#SkRect_growToInclude">growToInclude</a> <a href="#SkRect_setEmpty">setEmpty</a> <a href="#SkRect_setLargest">setLargest</a> - ---- - <a name="SkRect_makeOffset"></a> ## makeOffset @@ -2447,8 +2269,8 @@ Grows <a href="#Rect">Rect</a> to include (<a href="#SkRect_growToInclude_pt">pt <a href="#SkRect_fLeft">fLeft</a> <= <a href="#SkRect_growToInclude_pt">pt</a>.fX <= <a href="#SkRect_fRight">fRight</a> && <a href="#SkRect_fTop">fTop</a> <= <a href="#SkRect_growToInclude_pt">pt</a>.fY <= <a href="#SkRect_fBottom">fBottom</a>. -If <a href="#Rect">Rect</a> is initialized with <a href="#SkRect_setLargestInverted">setLargestInverted</a>, then <a href="#Rect">Rect</a> will contain bounds of -<a href="#Point">Points</a> after one or more calls. In this case, <a href="#Rect">Rect</a> is empty after first call. +If <a href="#Rect">Rect</a> is inverted, then <a href="#Rect">Rect</a> will preserve the <a href="#SkRect_top">top</a> <a href="#SkRect_left">left</a>, and the result +will not be inverted. ### Parameters @@ -2459,19 +2281,19 @@ If <a href="#Rect">Rect</a> is initialized with <a href="#SkRect_setLargestInver ### Example -<div><fiddle-embed name="c2855b1bc92b4e332f6edd968065e4f0"> +<div><fiddle-embed name="9a2bb963b7bdde80710cac5d148c6ccd"> #### Example Output ~~~~ -rect: 42, 24, 42, 24 isEmpty: true +rect: 1, 1, 42, 24 isEmpty: false ~~~~ </fiddle-embed></div> ### See Also -<a href="#SkRect_setLargestInverted">setLargestInverted</a> <a href="#SkRect_join">join</a> +<a href="#SkRect_join">join</a> --- @@ -2483,7 +2305,7 @@ For each of <a href="#SkRect_growToInclude_2_count">count</a> <a href="SkPoint_R it so that: <a href="#SkRect_fLeft">fLeft</a> <= pt.fX <= <a href="#SkRect_fRight">fRight</a> && <a href="#SkRect_fTop">fTop</a> <= pt.fY <= <a href="#SkRect_fBottom">fBottom</a>. -If <a href="#Rect">Rect</a> is initialized with <a href="#SkRect_setLargestInverted">setLargestInverted</a>, then <a href="#Rect">Rect</a> will contain bounds of +If <a href="#Rect">Rect</a> is inverted, then <a href="#Rect">Rect</a> will contain bounds of <a href="#Point">Points</a> after one or more calls. In this case, <a href="#Rect">Rect</a> is empty after first call. ### Parameters @@ -2509,7 +2331,7 @@ rect: 30, 50, 40, 60 ### See Also -<a href="#SkRect_setLargestInverted">setLargestInverted</a> <a href="#SkRect_join">join</a> +<a href="#SkRect_join">join</a> --- @@ -2525,7 +2347,7 @@ it so that: of bytes in element; the interval to skip to advance from one <a href="SkPoint_Reference#Point">Point</a> to the next. -If <a href="#Rect">Rect</a> is initialized with <a href="#SkRect_setLargestInverted">setLargestInverted</a>, then <a href="#Rect">Rect</a> will contain bounds of +If <a href="#Rect">Rect</a> is inverted, then <a href="#Rect">Rect</a> will contain bounds of <a href="#Point">Points</a> after one or more calls. In this case, <a href="#Rect">Rect</a> is empty after first call. ### Parameters @@ -2541,7 +2363,7 @@ number of elements in array</td> ### Example -<div><fiddle-embed name="6dbf21017c60b76cae3379fd9101342a"> +<div><fiddle-embed name="1275f2f35d5ca9412bd2ae0e81e9f2e0"> #### Example Output @@ -2554,7 +2376,7 @@ rect: 30, 50, 40, 60 ### See Also -<a href="#SkRect_setLargestInverted">setLargestInverted</a> <a href="#SkRect_join">join</a> +<a href="#SkRect_join">join</a> --- @@ -3037,3 +2859,12 @@ rect is equal to copy --- +<a name="SkRect_MakeLargest"></a> +## MakeLargest + +<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> +static SkRect SK_WARN_UNUSED_RESULT MakeLargest() +</pre> + +--- + diff --git a/site/user/api/catalog.htm b/site/user/api/catalog.htm index 2ebe88c6e6..d782ee8b1b 100644 --- a/site/user/api/catalog.htm +++ b/site/user/api/catalog.htm @@ -700,13 +700,6 @@ "name": "SkIRect::MakeLTRB", "stdout": "rect: 5, 35, 15, 25 isEmpty: true\\nrect: 5, 25, 15, 35 isEmpty: false\\n" }, - "SkIRect_MakeLargest": { - "code": "void draw(SkCanvas* canvas) {\n SkIRect rect = SkIRect::MakeLargest();\n SkDebugf(\"MakeLargest isLargest: %s\\n\", rect.isLargest() ? \"true\" : \"false\");\n SkDebugf(\"MakeLargest isEmpty: %s\\n\", rect.isEmpty() ? \"true\" : \"false\");\n rect.outset(1, 1);\n SkDebugf(\"outset isLargest: %s\\n\", rect.isLargest() ? \"true\" : \"false\");\n SkDebugf(\"outset isEmpty: %s\\n\", rect.isEmpty() ? \"true\" : \"false\");\n}", - "hash": "2b32ed04a64cd3d5fb525d404cbb9a09", - "file": "SkIRect_Reference", - "name": "SkIRect::MakeLargest", - "stdout": "MakeLargest isLargest: true\\nMakeLargest isEmpty: false\\noutset isLargest: false\\noutset isEmpty: true\\n" - }, "SkIRect_MakeSize": { "code": "void draw(SkCanvas* canvas) {\n SkSize size = {25.5f, 35.5f};\n SkIRect rect = SkIRect::MakeSize(size.toRound());\n SkDebugf(\"round width: %d height: %d\\n\", rect.width(), rect.height());\n rect = SkIRect::MakeSize(size.toFloor());\n SkDebugf(\"floor width: %d height: %d\\n\", rect.width(), rect.height());\n}", "hash": "c6586ff8d24869c780169b0d19c75df6", @@ -854,13 +847,6 @@ "name": "SkIRect::isEmpty", "stdout": "rect: {20, 40, 10, 50} is empty\\nsorted: {10, 40, 20, 50} is not empty\\nrect: {20, 40, 20, 50} is empty\\nsorted: {20, 40, 20, 50} is empty\\n" }, - "SkIRect_isLargest": { - "code": "void draw(SkCanvas* canvas) {\n SkIRect large = SkIRect::MakeLargest();\n SkDebugf(\"large is largest: %s\\n\" ,large.isLargest() ? \"true\" : \"false\");\n SkDebugf(\"large width %d\\n\", large.width());\n SkDebugf(\"large is empty: %s\\n\", large.isEmpty() ? \"true\" : \"false\");\n}", - "hash": "477e0a7f0aa8aec1d94e1e117041a335", - "file": "SkIRect_Reference", - "name": "SkIRect::isLargest", - "stdout": "large is largest: true\\nlarge width -2\\nlarge is empty: false\\n" - }, "SkIRect_join": { "code": "void draw(SkCanvas* canvas) {\n SkIRect rect = { 10, 20, 15, 25};\n rect.join(50, 60, 55, 65);\n SkDebugf(\"join: %d, %d, %d, %d\\n\", rect.fLeft, rect.fTop, rect.fRight, rect.fBottom);\n}", "hash": "c00ef06289d21db70340e465690e0e08", @@ -980,13 +966,6 @@ "name": "SkIRect::setLTRB", "stdout": "rect1: {3, 4, 1, 2}\\nrect2: {3, 4, 1, 2}\\n" }, - "SkIRect_setLargest": { - "code": "void draw(SkCanvas* canvas) {\n SkIRect rect;\n rect.setLargest();\n SkDebugf(\"MakeLargest isLargest: %s\\n\", rect.isLargest() ? \"true\" : \"false\");\n SkDebugf(\"MakeLargest isEmpty: %s\\n\", rect.isEmpty() ? \"true\" : \"false\");\n rect.outset(1, 1);\n SkDebugf(\"outset isLargest: %s\\n\", rect.isLargest() ? \"true\" : \"false\");\n SkDebugf(\"outset isEmpty: %s\\n\", rect.isEmpty() ? \"true\" : \"false\");\n}", - "hash": "d5d67c6f09a14d06f1ee988cb56525b5", - "file": "SkIRect_Reference", - "name": "SkIRect::setLargest", - "stdout": "MakeLargest isLargest: true\\nMakeLargest isEmpty: false\\noutset isLargest: false\\noutset isEmpty: true\\n" - }, "SkIRect_setXYWH": { "code": "void draw(SkCanvas* canvas) {\n SkIRect rect;\n rect.setXYWH(5, 35, -15, 25);\n SkDebugf(\"rect: %d, %d, %d, %d isEmpty: %s\\n\", rect.left(), rect.top(), rect.right(),\n rect.bottom(), rect.isEmpty() ? \"true\" : \"false\");\n rect.sort();\n SkDebugf(\"rect: %d, %d, %d, %d isEmpty: %s\\n\", rect.left(), rect.top(), rect.right(),\n rect.bottom(), rect.isEmpty() ? \"true\" : \"false\");\n}", "hash": "0e1db8c86678c004e504f47641b44b17", @@ -2688,20 +2667,6 @@ "name": "SkRect::MakeLTRB", "stdout": "rect: 5, 35, 15, 25 isEmpty: true\\nrect: 5, 25, 15, 35 isEmpty: false\\n" }, - "SkRect_MakeLargest": { - "code": "void draw(SkCanvas* canvas) {\n SkRect rect = SkRect::MakeLargest();\n SkDebugf(\"MakeLargest isLargest: %s\\n\", rect.isLargest() ? \"true\" : \"false\");\n SkDebugf(\"MakeLargest isFinite: %s\\n\", rect.isFinite() ? \"true\" : \"false\");\n rect.outset(1e31, 1e31);\n SkDebugf(\"outset a little isLargest: %s\\n\", rect.isLargest() ? \"true\" : \"false\");\n SkDebugf(\"outset a little isFinite: %s\\n\", rect.isFinite() ? \"true\" : \"false\");\n rect.outset(1e32, 1e32);\n SkDebugf(\"outset a little more isLargest: %s\\n\", rect.isLargest() ? \"true\" : \"false\");\n SkDebugf(\"outset a little more isFinite: %s\\n\", rect.isFinite() ? \"true\" : \"false\");\n}", - "hash": "42774381948ce88ec19b5c0d16a84bd7", - "file": "SkRect_Reference", - "name": "SkRect::MakeLargest", - "stdout": "MakeLargest isLargest: true\\nMakeLargest isFinite: true\\noutset a little isLargest: true\\noutset a little isFinite: true\\noutset a little more isLargest: false\\noutset a little more isFinite: false\\n" - }, - "SkRect_MakeLargestS32": { - "code": "void draw(SkCanvas* canvas) {\n SkRect f_rect = SkRect::MakeLargestS32();\n SkIRect i_rect = f_rect.round();\n SkRect r_rect = SkRect::Make(i_rect);\n SkDebugf(\"f_rect %c= r_rect\\n\", f_rect == r_rect ? '=' : '!');\n}", - "hash": "9dde55347ba15b60166b5a0583c55587", - "file": "SkRect_Reference", - "name": "SkRect::MakeLargestS32", - "stdout": "f_rect == r_rect\\n" - }, "SkRect_MakeSize": { "code": "void draw(SkCanvas* canvas) {\n SkSize size = {25.5f, 35.5f};\n SkRect rect = SkRect::MakeSize(size);\n SkDebugf(\"rect width: %g height: %g\\n\", rect.width(), rect.height());\n SkISize floor = size.toFloor();\n rect = SkRect::MakeSize(SkSize::Make(floor));\n SkDebugf(\"floor width: %g height: %g\\n\", rect.width(), rect.height());\n}", "hash": "ab2c1a55016c8de9172b77fdf69e00a2", @@ -2801,11 +2766,11 @@ "stdout": "tests are equal\\n{0, 0, 2, 2} == {-0, -0, 2, 2} and are numerically equal\\n{0, 0, 2, 2} == {-0, -0, 2, 2} and are numerically equal\\n{0, 0, 2, 2} == {-0, -0, 2, 2} and are numerically equal\\n" }, "SkRect_growToInclude": { - "code": "void draw(SkCanvas* canvas) {\n SkRect rect;\n rect.setLargestInverted();\n rect.growToInclude( { 42, 24 } );\n SkDebugf(\"rect: %g, %g, %g, %g \", rect.left(), rect.top(), rect.right(), rect.bottom());\n SkDebugf(\"isEmpty: %s\\n\", rect.isEmpty() ? \"true\" : \"false\");\n}", - "hash": "c2855b1bc92b4e332f6edd968065e4f0", + "code": "void draw(SkCanvas* canvas) {\n SkRect rect = { 1, 1, 0, 0 };\n rect.growToInclude( { 42, 24 } );\n SkDebugf(\"rect: %g, %g, %g, %g \", rect.left(), rect.top(), rect.right(), rect.bottom());\n SkDebugf(\"isEmpty: %s\\n\", rect.isEmpty() ? \"true\" : \"false\");\n}", + "hash": "9a2bb963b7bdde80710cac5d148c6ccd", "file": "SkRect_Reference", "name": "SkRect::growToInclude", - "stdout": "rect: 42, 24, 42, 24 isEmpty: true\\n" + "stdout": "rect: 1, 1, 42, 24 isEmpty: false\\n" }, "SkRect_growToInclude_2": { "code": "void draw(SkCanvas* canvas) {\n SkPoint pts[] = { { 30, 50 }, { 40, 50 }, { 30, 60 } };\n SkRect rect = { pts[0].fX, pts[0].fY, pts[0].fX, pts[0].fY };\n rect.growToInclude( pts[1] );\n rect.growToInclude( pts[2] );\n SkDebugf(\"rect: %g, %g, %g, %g \", rect.left(), rect.top(), rect.right(), rect.bottom());\n}", @@ -2815,8 +2780,8 @@ "stdout": "rect: 30, 50, 40, 60" }, "SkRect_growToInclude_3": { - "code": "void draw(SkCanvas* canvas) {\n SkPoint3 pts[] = { { 30, 50, -1 }, { 40, 50, -1 }, { 30, 60, -1 } };\n SkRect rect;\n rect.setLargestInverted();\n rect.growToInclude((SkPoint* ) &pts[0].fX, sizeof(SkPoint3), SK_ARRAY_COUNT(pts));\n SkDebugf(\"rect: %g, %g, %g, %g \", rect.left(), rect.top(), rect.right(), rect.bottom());\n}", - "hash": "6dbf21017c60b76cae3379fd9101342a", + "code": "void draw(SkCanvas* canvas) {\n SkPoint3 pts[] = { { 30, 50, -1 }, { 40, 50, -1 }, { 30, 60, -1 } };\n SkRect rect = { 1, 1, 0, 0 };\n rect.growToInclude((SkPoint* ) &pts[0].fX, sizeof(SkPoint3), SK_ARRAY_COUNT(pts));\n SkDebugf(\"rect: %g, %g, %g, %g \", rect.left(), rect.top(), rect.right(), rect.bottom());\n}", + "hash": "1275f2f35d5ca9412bd2ae0e81e9f2e0", "file": "SkRect_Reference", "name": "SkRect::growToInclude_3", "stdout": "rect: 30, 50, 40, 60 \\n" @@ -2878,19 +2843,12 @@ "stdout": "rect: {20, 40, 10, 50} is empty\\nsorted: {10, 40, 20, 50} is not empty\\nrect: {20, 40, 20, 50} is empty\\nsorted: {20, 40, 20, 50} is empty\\n" }, "SkRect_isFinite": { - "code": "void draw(SkCanvas* canvas) {\n SkRect largest = SkRect::MakeLargest();\n SkDebugf(\"largest is finite: %s\\n\", largest.isFinite() ? \"true\" : \"false\");\n SkDebugf(\"large width %g\\n\", largest.width());\n SkRect widest = SkRect::MakeWH(largest.width(), largest.height());\n SkDebugf(\"widest is finite: %s\\n\", widest.isFinite() ? \"true\" : \"false\");\n}", - "hash": "7365c6553b830e6535cea0ce0d07be19", + "code": "void draw(SkCanvas* canvas) {\n SkRect largest = { SK_ScalarMin, SK_ScalarMin, SK_ScalarMax, SK_ScalarMax };\n SkDebugf(\"largest is finite: %s\\n\", largest.isFinite() ? \"true\" : \"false\");\n SkDebugf(\"large width %g\\n\", largest.width());\n SkRect widest = SkRect::MakeWH(largest.width(), largest.height());\n SkDebugf(\"widest is finite: %s\\n\", widest.isFinite() ? \"true\" : \"false\");\n}", + "hash": "443fe5f8296d4cdb19cc9862a9cf77a4", "file": "SkRect_Reference", "name": "SkRect::isFinite", "stdout": "largest is finite: true\\nlarge width inf\\nwidest is finite: false\\n" }, - "SkRect_isLargest": { - "code": "void draw(SkCanvas* canvas) {\n SkRect large = SkRect::MakeLargest();\n SkDebugf(\"large is largest: %s\\n\" ,large.isLargest() ? \"true\" : \"false\");\n SkDebugf(\"large width %g\\n\", large.width());\n SkDebugf(\"large is empty: %s\\n\", large.isEmpty() ? \"true\" : \"false\");\n SkDebugf(\"large is sorted: %s\\n\", large.isSorted() ? \"true\" : \"false\");\n SkDebugf(\"large is finite: %s\\n\", large.isFinite() ? \"true\" : \"false\");\n}", - "hash": "30ef8865ff1ba8789ee1d3be92734ad8", - "file": "SkRect_Reference", - "name": "SkRect::isLargest", - "stdout": "large is largest: true\\nlarge width inf\\nlarge is empty: false\\nlarge is sorted: true\\nlarge is finite: true\\n" - }, "SkRect_isSorted": { "code": "void draw(SkCanvas* canvas) {\n SkRect tests[] = {{20, 40, 10, 50}, {20, 40, 20, 50}};\n for (auto rect : tests) {\n SkDebugf(\"rect: {%g, %g, %g, %g} is\" \"%s sorted\\n\", rect.left(), rect.top(), rect.right(),\n rect.bottom(), rect.isSorted() ? \"\" : \" not\");\n rect.sort();\n SkDebugf(\"sorted: {%g, %g, %g, %g} is\" \"%s sorted\\n\", rect.left(), rect.top(), rect.right(),\n rect.bottom(), rect.isSorted() ? \"\" : \" not\");\n }\n}", "hash": "c7065a83b220a96f903dbbb65906fe7b", @@ -3094,20 +3052,6 @@ "name": "SkRect::setLTRB", "stdout": "rect1: {3, 4, 1, 2}\\nrect2: {3, 4, 1, 2}\\n" }, - "SkRect_setLargest": { - "code": "void draw(SkCanvas* canvas) {\n SkRect rect;\n rect.setLargest();\n SkDebugf(\"MakeLargest isLargest: %s\\n\", rect.isLargest() ? \"true\" : \"false\");\n SkDebugf(\"MakeLargest isFinite: %s\\n\", rect.isFinite() ? \"true\" : \"false\");\n rect.outset(1e31, 1e31);\n SkDebugf(\"outset a little isLargest: %s\\n\", rect.isLargest() ? \"true\" : \"false\");\n SkDebugf(\"outset a little isFinite: %s\\n\", rect.isFinite() ? \"true\" : \"false\");\n rect.outset(1e32, 1e32);\n SkDebugf(\"outset a little more isLargest: %s\\n\", rect.isLargest() ? \"true\" : \"false\");\n SkDebugf(\"outset a little more isFinite: %s\\n\", rect.isFinite() ? \"true\" : \"false\");\n}", - "hash": "7a07b1914ade5c38cce6be417bc8aa4b", - "file": "SkRect_Reference", - "name": "SkRect::setLargest", - "stdout": "MakeLargest isLargest: true\\nMakeLargest isFinite: true\\noutset a little isLargest: true\\noutset a little isFinite: true\\noutset a little more isLargest: false\\noutset a little more isFinite: false\\n" - }, - "SkRect_setLargestInverted": { - "code": "void draw(SkCanvas* canvas) {\n auto debugster = [](const char* prefix, const SkRect& rect) -> void {\n SkDebugf(\"%s \", prefix);\n SkDebugf(\"rect: %g, %g, %g, %g \", rect.left(), rect.top(), rect.right(), rect.bottom());\n SkDebugf(\"isEmpty: %s\\n\", rect.isEmpty() ? \"true\" : \"false\");\n };\n SkRect ptBounds;\n ptBounds.setLargestInverted();\n debugster(\"original\", ptBounds);\n ptBounds.growToInclude( { 42, 24 } );\n debugster(\"grown\", ptBounds);\n}", - "hash": "394442eedd4f01e42c5a4905e832dd0c", - "file": "SkRect_Reference", - "name": "SkRect::setLargestInverted", - "stdout": "original rect: 3.40282e+38, 3.40282e+38, -3.40282e+38, -3.40282e+38 isEmpty: true\\ngrown rect: 42, 24, 42, 24 isEmpty: true\\n" - }, "SkRect_setWH": { "code": "void draw(SkCanvas* canvas) {\n SkRect rect;\n rect.setWH(-15, 25);\n SkDebugf(\"rect: %g, %g, %g, %g isEmpty: %s\\n\", rect.left(), rect.top(), rect.right(),\n rect.bottom(), rect.isEmpty() ? \"true\" : \"false\");\n rect.sort();\n SkDebugf(\"rect: %g, %g, %g, %g isEmpty: %s\\n\", rect.left(), rect.top(), rect.right(),\n rect.bottom(), rect.isEmpty() ? \"true\" : \"false\");\n}", "hash": "9cb5fee17802fa49341f3707bdf5d235", @@ -5216,14 +5160,6 @@ "file": "SkMatrix_Reference", "name": "SkMatrix::mapPoints" }, - "SkMatrix_mapPointsWithStride": { - "code": "void draw(SkCanvas* canvas) {\n SkMatrix matrix;\n matrix.reset();\n struct PointZ {\n SkPoint fPt;\n SkPoint fStationary;\n } pts[] = {{{40, 70}, {40, 70}}, {{180, 70}, {180, 70}}, {{180, 220}, {180, 220}},\n {{40, 220}, {40, 220}}};\n constexpr int count = SK_ARRAY_COUNT(pts);\n SkPaint paint;\n paint.setARGB(77, 23, 99, 154);\n for (int i = 0; i < 5; ++i) {\n matrix.preRotate(10, 128, 128);\n matrix.mapPointsWithStride(&pts[0].fPt, sizeof(PointZ), count);\n canvas->drawPoints(SkCanvas::kPolygon_PointMode, count * 2, &pts[0].fPt, paint);\n }\n}", - "width": 256, - "height": 256, - "hash": "02c50c7bb5d5dd1fe7e54b0d3bf64c2a", - "file": "SkMatrix_Reference", - "name": "SkMatrix::mapPointsWithStride" -}, "SkMatrix_mapPoints_2": { "code": "void draw(SkCanvas* canvas) {\n SkMatrix matrix;\n matrix.setRotate(35, 128, 128);\n const int count = 4;\n SkPoint pts[count];\n matrix.mapRectToQuad(pts, {40, 70, 180, 220} );\n SkPaint paint;\n paint.setARGB(77, 23, 99, 154);\n for (int i = 0; i < 5; ++i) {\n canvas->drawPoints(SkCanvas::kPolygon_PointMode, count, pts, paint);\n matrix.mapPoints(pts, count);\n }\n}", "width": 256, |