[css-color-5] RCS has number or percent everywhere, see w3c#7114

Author: svgeesus

css-color-5/Overview.bs

@@ -1011,7 +1011,7 @@ so it has meaningful values for the channels.
 	without changing any other aspect of the color.
 
 	Note as well that the [=origin color=] is a color keyword
-	(effectively RGB),
+	(and thus, sRGB),
 	but it's automatically interpreted as an LCH color
 	due to being used in the ''lch()'' function.
 </div>
@@ -1048,15 +1048,16 @@ so it has meaningful values for the channels.
 	for the obsolete NTSC color space,
 	not sRGB.)
 
-	(Note, though, that an easier and more accurate way to grayscale a color
-	is to use the ''lch()'' function,
+	(Note, too, that this is just to illustrate the syntax;
+	an easier and more accurate way to grayscale a color
+	is to use the ''oklch()'' function,
 	as that color space is more accurate to human perception:
-	''lch(from var(--color) l 0 h)'' preserves the lightness,
+	''oklch(from var(--color) l 0 h)'' preserves the lightness,
 	but zeroes out the chroma,
 	which determines how "colorful" the color is.)
 </div>
 
-<h3 id="relative-RGB">Relative RGB colors</h3>
+<h3 id="relative-RGB">Relative sRGB colors</h3>
 
 The grammar of the ''rgb()'' function is extended as follows:
 
@@ -1072,9 +1073,10 @@ Within a [=relative color=] syntax ''rgb()'' function,
 the allowed [=channel keywords=] are:
 
 * <dfn value for="rgb()">r</dfn>, <dfn value for="rgb()">g</dfn>, and <dfn value for="rgb()">b</dfn>
-	are all <<percentage>>s
+	are all <<percentage>>s or <<number>>s
 	that correspond to the [=origin color's=] red, green, and blue channels
-	after its conversion to sRGB
+	after its conversion to sRGB. For <<number>>s, 255 (or 255.0)
+	is equivalent to 100%.
 * <dfn value for="rgb()">alpha</dfn> is a <<percentage>> that corresponds to the [=origin color's=] alpha transparency
 
 <div class="example">
@@ -1117,7 +1119,9 @@ The grammar of the ''hsl()'' function is extended as follows:
 
 <pre class='prod'>
 <dfn>hsl()</dfn> = hsl(([from <<color>>]?
-			  [<<hue>> | none] [<<percentage>> | none] [<<percentage>> | none]
+			  [<<hue>> | none]
+			  [<<percentage>> | <<number>> | none]
+			  [<<percentage>> | <<number>> | none]
 			  [ / [<<alpha-value>> | none] ]? )
 </pre>
 
@@ -1130,7 +1134,7 @@ the allowed [=channel keywords=] are:
 	after its conversion to sRGB,
 	normalized to a [0deg, 360deg) range
 * <dfn value for="hsl()">s</dfn> and <dfn value for="hsl()">l</dfn>
-	are <<percentage>>s that correspond to the [=origin color's=] HSL saturation and lightness
+	are <<percentage>>s or <<number>>s that correspond to the [=origin color's=] HSL saturation and lightness
 	after its conversion to sRGB
 * <dfn value for="hsl()">alpha</dfn> is a <<percentage>> that corresponds to the [=origin color's=] alpha transparency
 
@@ -1151,7 +1155,9 @@ The grammar of the ''hwb()'' function is extended as follows:
 
 <pre class='prod'>
 	<dfn>hwb()</dfn> = hwb([from <<color>>]?
-				  [<<hue>> | none] [<<percentage>> | none] [<<percentage>> | none]
+				  [<<hue>> | none]
+				  [<<percentage>> | <<number>> | none]
+				  [<<percentage>> | <<number>> | none]
 				  [ / [<<alpha-value>> | none] ]? )
 </pre>
 
@@ -1164,7 +1170,7 @@ the allowed [=channel keywords=] are:
 	after its conversion to sRGB,
 	normalized to a [0deg, 360deg) range
 * <dfn value for="hwb()">w</dfn> and <dfn value for="hwb()">b</dfn>
-	are <<percentage>>s that correspond to the [=origin color's=] HWB whiteness and blackness
+	are <<percentage>>s or <<number>>s that correspond to the [=origin color's=] HWB whiteness and blackness
 	after its conversion to sRGB
 * <dfn value for="hwb()">alpha</dfn> is a <<percentage>> that corresponds to the [=origin color's=] alpha transparency
 
@@ -1174,18 +1180,20 @@ The grammar of the ''lab()'' function is extended as follows:
 
 <pre class='prod'>
 <dfn>lab()</dfn> = lab([from <<color>>]?
-			  [<<percentage>> | none] [<<number>> | none] [<<number>> | none]
+			  [<<percentage>> | <<number>> | none]
+			  [<<percentage>> | <<number>> | none]
+			  [<<percentage>> | <<number>> | none]
 			  [ / [<<alpha-value>> | none] ]? )
 </pre>
 
 
 Within a [=relative color=] syntax ''lab()'' function,
 the allowed [=channel keywords=] are:
 
-* <dfn value for="lab()">l</dfn> is a <<percentage>>
+* <dfn value for="lab()">l</dfn> is a <<percentage>> or <<number>>
 	that corresponds to the [=origin color's=] CIE Lightness
-* <dfn value for="lab()">a</dfn> and <dfn value for="lab()">b</dfn> are <<number>>s
-	that correspond to the [=origin color's=] CIELab a and b axises
+* <dfn value for="lab()">a</dfn> and <dfn value for="lab()">b</dfn> are <<percentage>>s or <<number>>s
+	that correspond to the [=origin color's=] CIELab a and b axes
 * <dfn value for="lab()">alpha</dfn> is a <<percentage>> that corresponds to the [=origin color's=] alpha transparency
 
 <div class="example">
@@ -1216,17 +1224,19 @@ The grammar of the ''oklab()'' function is extended as follows:
 
 <pre class='prod'>
 <dfn>oklab()</dfn> = oklab([from <<color>>]?
-				  [<<percentage>> | none] [<<number>> | none] [<<number>> | none]
+				  [<<percentage>> | <<number>> | none]
+				  [<<percentage>> | <<number>> | none]
+				  [<<percentage>> | <<number>> | none]
 				  [ / [<<alpha-value>> | none] ]? )
 </pre>
 
 
 Within a [=relative color=] syntax ''oklab()'' function,
 the allowed [=channel keywords=] are:
 
-* <dfn value for="oklab()">l</dfn> is a <<percentage>>
+* <dfn value for="oklab()">l</dfn> is a <<percentage>> or <<number>>
 	that corresponds to the [=origin color's=] OKLab Lightness
-* <dfn value for="oklab()">a</dfn> and <dfn value for="oklab()">b</dfn> are <<number>>s
+* <dfn value for="oklab()">a</dfn> and <dfn value for="oklab()">b</dfn> are <<percentage>>s or <<number>>s
 	that correspond to the [=origin color's=] OKLab a and b axes
 * <dfn value for="oklab()">alpha</dfn> is a <<percentage>> that corresponds to the [=origin color's=] alpha transparency
 
@@ -1236,17 +1246,19 @@ The grammar of the ''lch()'' function is extended as follows:
 
 <pre class='prod'>
 <dfn>lch()</dfn> = lch([from <<color>>]?
-				[<<percentage>> | none] [<<number>> | none] [<<hue>> | none]
+				[<<percentage>> | <<number>> | none]
+				[<<percentage>> | <<number>> | none]
+				[<<hue>> | none]
 				[ / [<<alpha-value>> | none] ]? )
 </pre>
 
 
 Within a [=relative color=] syntax ''lch()'' function,
 the allowed [=channel keywords=] are:
 
-* <dfn value for="lch()">l</dfn> is a <<percentage>>
+* <dfn value for="lch()">l</dfn> is a <<percentage>> or <<number>>
 	that corresponds to the [=origin color's=] CIE Lightness
-* <dfn value for="lch()">c</dfn> is a <<number>>
+* <dfn value for="lch()">c</dfn> is a <<percentage>> or <<number>>
 	that corresponds to the [=origin color's=] LCH chroma
 * <dfn value for="lch()">h</dfn> is an <<angle>>
 	that corresponds to the [=origin color's=] LCH hue,
@@ -1361,17 +1373,19 @@ The grammar of the ''oklch()'' function is extended as follows:
 
 <pre class='prod'>
 <dfn>oklch()</dfn> = oklch([from <<color>>]?
-					[<<percentage>> | none] [<<number>> | none] [<<hue>> | none]
+					[<<percentage>> | <<number>> | none]
+					[<<percentage>> | <<number>> | none]
+					[<<hue>> | none]
 					[ / [<<alpha-value>> | none] ]? )
 </pre>
 
 
 Within a [=relative color=] syntax ''oklch()'' function,
 the allowed [=channel keywords=] are:
 
-* <dfn value for="oklch()">l</dfn> is a <<percentage>>
+* <dfn value for="oklch()">l</dfn> is a <<percentage>> or <<number>>
 	that corresponds to the [=origin color's=] OKLab Lightness
-* <dfn value for="oklch()">c</dfn> is a <<number>>
+* <dfn value for="oklch()">c</dfn> is a <<percentage>> or <<number>>
 	that corresponds to the [=origin color's=] OKLCH chroma
 * <dfn value for="oklch()">h</dfn> is an <<angle>>
 	that corresponds to the [=origin color's=] OKLCH hue,
@@ -1426,14 +1440,14 @@ The OKLCH chroma has dropped from 0.251 to 0.117.
 		<dfn>custom-params</dfn> = <<dashed-ident>> [ <<number>> | <<percentage>> | none ]#
 		<dfn>predefined-rgb-params</dfn> = <<predefined-rgb>> [ <<number>> | <<percentage>> | none ]{3}
 		<dfn>predefined-rgb</dfn> = srgb | srgb-linear | display-p3 | a98-rgb | prophoto-rgb | rec2020
-		<dfn>xyz-params</dfn> = <<xyz>> [ <<number>> | none ]{3}
+		<dfn>xyz-params</dfn> = <<xyz>> [ <<number>> | <<percentage>> | none ]{3}
 		<dfn>xyz</dfn> = xyz | xyz-d50 | xyz-d65
 	</pre>
 
 	<!-- check this test, remove any fallback testing -->
-	<!-- <wpt>
+	<wpt>
 		color-function-parsing.html
-	</wpt> -->
+	</wpt>
 
 	The color function takes parameters specifying a color, in an explicitly listed color space.
 
@@ -1468,21 +1482,21 @@ the number and name of the allowed [=channel keywords=] are:
 
 * defined by the '@color-profile/components' descriptor on the corresponding ''@color-profile'',
 	if present;
-	otherwise, no relative color manipulation is valid. They are <<percentage>>s that correspond to the [=origin color's=] channels
-	after its conversion to the color space of the color profile.
+	otherwise, no relative color manipulation is valid. They are <<number>>s or <<percentage>>s that correspond to the [=origin color's=] channels
+	after its conversion to the color space of the color profile. For <<number>>s, 1.0 corresponds to 100%.
 
 Within a [=relative color=] syntax ''color()'' function using <<predefined-rgb-params>>,
 the allowed [=channel keywords=] are:
 
 * <dfn value for="color()">r</dfn>, <dfn value for="color()">g</dfn>, and <dfn value for="color()">b</dfn>
-	are all <<percentage>>s
+	are all <<percentage>>s or <<number>>s
 	that correspond to the [=origin color's=] red, green, and blue channels
 	after its conversion to the predefined RGB color space.
 
 Within a [=relative color=] syntax ''color()'' function using <<xyz-params>>,
 the allowed [=channel keywords=] are:
 
-* <dfn value for="color()">x</dfn>, <dfn value for="color()">y</dfn>, <dfn value for="color()">z</dfn> are all <<number>>s
+* <dfn value for="color()">x</dfn>, <dfn value for="color()">y</dfn>, <dfn value for="color()">z</dfn> are all <<percentage>>s or <<number>>s
 	that correspond to the [=origin color's=] X, Y and Z channels
 	after its conversion to relative CIE XYZ color space
 	adapted to the relevant white point.
@@ -2066,7 +2080,7 @@ or any other color or monochrome output device which has been characterized.
 			}
 		</pre>
 
-		This example does not use illustrative swatches, because most of the colors are outside of sRGB.
+		Note: This example does not use illustrative swatches, because most of the colors are outside of sRGB.
 
 		This CMYK color corresponds to lab(56.596645% -58.995875 28.072154)
 		or lch(56.596645% 65.33421077211648 154.5533771086801).