- From: Tab Atkins Jr.. via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 15 Aug 2011 22:38:44 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-images
In directory hutz:/tmp/cvs-serv24673
Modified Files:
Overview.html Overview.src.html
Log Message:
Fixed the radial-gradient "degenerate shape" section to match the limit as the size approaches degeneracy.
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-images/Overview.html,v
retrieving revision 1.147
retrieving revision 1.148
diff -u -d -r1.147 -r1.148
--- Overview.html 13 Aug 2011 01:20:17 -0000 1.147
+++ Overview.html 15 Aug 2011 22:38:42 -0000 1.148
@@ -20,10 +20,10 @@
<h1>CSS Image Values and Replaced Content Module Level 3</h1>
- <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 13 August 2011</h2>
+ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 15 August 2011</h2>
<dl><!--<dt>This version:</dt>
- <dd><a href="http://www.w3.org/TR/2011/ED-css3-images-20110813/">http://www.w3.org/TR/2011/ED-css3-images-20110813/</a>-->
+ <dd><a href="http://www.w3.org/TR/2011/ED-css3-images-20110815/">http://www.w3.org/TR/2011/ED-css3-images-20110815/</a>-->
<dt>Latest version:
@@ -954,9 +954,10 @@
<dd>
<p>Alternately, the ending-shape's size and shape can be defined
explicitly, by providing two lengths or percentages. These measure the
- length of the horizontal and vertical axes of the ellipse, respectively.
- (The axis length is the length from the center of the ellipse to the
- edge, similar to the radius of a circle, not the diameter.)</p>
+ length of the horizontal and vertical axises of the ellipse,
+ respectively. (The axis length is the length from the center of the
+ ellipse to the edge, similar to the radius of a circle, not the
+ diameter.)</p>
<p>Percentages used in the first value are relative to the width of the
box, while percentages used in the second value are relative to the
@@ -967,16 +968,35 @@
<p>Some combinations of position, size, and shape will produce a <dfn
id=degenerate-shape>degenerate shape</dfn> - a circle or ellipse with a
- radius of 0. This will occur if the position is on a box edge and the
- second argument is ‘<code class=css>circle
- closest-side</code>’, ‘<code class=css>ellipse
- closest-side</code>’, or ‘<code class=css>ellipse
- closest-corner</code>’, or if the position is on a box corner and
- the shape is ‘<a href="#radial-closest-corner"><code
+ radius of 0. This will occur if the center is on a box edge and the second
+ argument is ‘<code class=css>circle closest-side</code>’,
+ ‘<code class=css>ellipse closest-side</code>’, or ‘<code
+ class=css>ellipse closest-corner</code>’, or if the center is on a
+ box corner and the shape is ‘<a href="#radial-closest-corner"><code
class=css>closest-corner</code></a>’, or if the size and shape are
given explicitly and either of the radiuses are ‘<code
- class=css>0</code>’. In these instances, the the gradient represents
- a solid-color image equal to the color of the last color-stop.
+ class=css>0</code>’. In these instances, the gradient must be be
+ rendered as follows:
+
+ <dl>
+ <dt>If the ending-shape has zero width (regardless of the height):
+
+ <dd>Render as if the ending-shape was an ellipse whose height was an
+ arbitrary very large number and whose width was an arbitrary very small
+ number greater than zero. <span class=note>This will make the gradient
+ look similar to a horizontal linear gradient that is mirrored across the
+ center of the ellipse. It also means that all color-stop positions
+ specified with a percentage resolve to ‘<code
+ class=css>0px</code>’.</span>
+
+ <dt>Otherwise, if the ending-shape has zero height:
+
+ <dd>Render as if the ending-shape was an ellipse whose width was an
+ arbitrary very large number and whose height was an arbitrary very small
+ number greater than zero. <span class=note>This will make the gradient
+ look like a solid-color image equal to the color of the last color-stop,
+ or equal to the average color of the gradient if it's repeating.</span>
+ </dl>
<p>If this argument is omitted, it defaults to ‘<code
class=css>ellipse cover</code>’.
@@ -1133,6 +1153,14 @@
color-stops equally spaced between them. Then it must render the gradient
as a solid-color image equal to that average color.
+ <p>If the height of a repeating radial gradient is zero, or is close enough
+ to zero that the implementation knows that the physical resolution of the
+ output device is insufficient to faithfully render the gradient, the
+ implementation must <a href="#find-the-average-color-of-a-gradient"><i
+ title=gradient-average-color>find the average color of the
+ gradient</i></a> and render the gradient as a solid-color image equal to
+ the average color.
+
<p>To <dfn id=find-the-average-color-of-a-gradient
title=gradient-average-color>find the average color of a gradient</dfn>,
run these steps:
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-images/Overview.src.html,v
retrieving revision 1.154
retrieving revision 1.155
diff -u -d -r1.154 -r1.155
--- Overview.src.html 13 Aug 2011 01:20:17 -0000 1.154
+++ Overview.src.html 15 Aug 2011 22:38:42 -0000 1.155
@@ -619,7 +619,7 @@
<dd>
<p>Alternately, the ending-shape's size and shape can be defined
explicitly, by providing two lengths or percentages. These measure
- the length of the horizontal and vertical axes of the ellipse,
+ the length of the horizontal and vertical axises of the ellipse,
respectively. (The axis length is the length from the center of the
ellipse to the edge, similar to the radius of a circle, not the
diameter.)</p>
@@ -632,7 +632,15 @@
</dd>
</dl>
- <p>Some combinations of position, size, and shape will produce a <dfn>degenerate shape</dfn> - a circle or ellipse with a radius of 0. This will occur if the position is on a box edge and the second argument is ''circle closest-side'', ''ellipse closest-side'', or ''ellipse closest-corner'', or if the position is on a box corner and the shape is ''closest-corner'', or if the size and shape are given explicitly and either of the radiuses are ''0''. In these instances, the the gradient represents a solid-color image equal to the color of the last color-stop.</p>
+ <p>Some combinations of position, size, and shape will produce a <dfn>degenerate shape</dfn> - a circle or ellipse with a radius of 0. This will occur if the center is on a box edge and the second argument is ''circle closest-side'', ''ellipse closest-side'', or ''ellipse closest-corner'', or if the center is on a box corner and the shape is ''closest-corner'', or if the size and shape are given explicitly and either of the radiuses are ''0''. In these instances, the gradient must be be rendered as follows:</p>
+
+ <dl>
+ <dt>If the ending-shape has zero width (regardless of the height):</dt>
+ <dd>Render as if the ending-shape was an ellipse whose height was an arbitrary very large number and whose width was an arbitrary very small number greater than zero. <span class='note'>This will make the gradient look similar to a horizontal linear gradient that is mirrored across the center of the ellipse. It also means that all color-stop positions specified with a percentage resolve to ''0px''.</span></dd>
+
+ <dt>Otherwise, if the ending-shape has zero height:</dt>
+ <dd>Render as if the ending-shape was an ellipse whose width was an arbitrary very large number and whose height was an arbitrary very small number greater than zero. <span class='note'>This will make the gradient look like a solid-color image equal to the color of the last color-stop, or equal to the average color of the gradient if it's repeating.</span></dd>
+ </dl>
<p>If this argument is omitted, it defaults to ''ellipse cover''.</p>
@@ -754,6 +762,8 @@
<p>If the distance between the first and last color-stops is zero (or rounds to zero due to implementation limitations), the implementation must <i title="gradient-average-color">find the average color</i> of a gradient with the same number and color of color-stops, but with the first and last color-stop an arbitrary non-zero distance apart, and the remaining color-stops equally spaced between them. Then it must render the gradient as a solid-color image equal to that average color.</p>
+ <p>If the height of a repeating radial gradient is zero, or is close enough to zero that the implementation knows that the physical resolution of the output device is insufficient to faithfully render the gradient, the implementation must <i title="gradient-average-color">find the average color of the gradient</i> and render the gradient as a solid-color image equal to the average color.</p>
+
<p>To <dfn title="gradient-average-color">find the average color of a gradient</dfn>, run these steps:</p>
<ol>
Received on Monday, 15 August 2011 22:38:46 UTC