From c2748c5d30926fe6837cec570621a983fa8bd61f Mon Sep 17 00:00:00 2001 From: Masataka Yakura Date: Fri, 16 Jun 2023 18:03:13 +0900 Subject: [PATCH] [css-color-5] move `color()` parameters description out of `` bullet point ``, ``, ``, ``, and `` should not be tied to `` but are in the current draft. --- css-color-5/Overview.bs | 152 ++++++++++++++++++++-------------------- 1 file changed, 76 insertions(+), 76 deletions(-) diff --git a/css-color-5/Overview.bs b/css-color-5/Overview.bs index 32a5711c8d8..11dc8cd7097 100644 --- a/css-color-5/Overview.bs +++ b/css-color-5/Overview.bs @@ -1533,87 +1533,87 @@ the allowed [=channel keywords=] are: after conversion, if required to relative CIE XYZ color space adapted to the relevant white point. - The parameters have the following form: - - * An <> or <> denoting the color space. - If this is an <> it denotes one of the - predefined color spaces - [[css-color-4#predefined]] - (such as ''display-p3''); - if it is a <> it denotes a custom - color space, defined by a ''@color-profile'' rule. - Individual predefined color spaces - may further restrict whether <>s or <>s - or both, may be used. - - If the <> names a non-existent color space - (a name that does not match one of the - predefined color spaces), - or a predefined but unsupported color space, - this argument represents an invalid color. - - If the <> names a non-existent color space - ( a name that does not match an color profile's name, - or which matches but the corresponding profile has not loaded, - or does not represent a valid profile), - this argument represents an invalid color. - - - * One or more <>s or <>s providing the parameter values that the color space takes. - - For custom color spaces, - specified component values - less than 0 or 0%, or greater than 1 or 100% - are not invalid; - they are clamped to the valid range at computed value time. - This is because ICC profiles typically do not accept - out of range input values. - - For custom color spaces, if more <>s or <>s are provided than parameters that the color space takes, - the excess <>s at the end are ignored. - The color is still a [=valid color=]. - - For custom color spaces, if more <>s or <>s are provided than components listed in the optional components descriptor, - the additional values at the end are still valid, - but cannot be used in Relative Color Syntax. - The color is still a [=valid color=]. - - For custom color spaces, if fewer <>s or <>s are provided than parameters that the color space takes, - the missing parameters default to ''0''. - (This is particularly convenient for multichannel printers - where the additional inks are spot colors or varnishes - that most colors on the page won't use.) - The color is still a [=valid color=]. - - For predefined color spaces, - specified component values - less than 0 or 0%, or greater than 1 or 100% - are not invalid; - these out of gamut colors - are gamut mapped to the valid range at computed value time, - with a relative colorimetric intent. +The parameters have the following form: + +* An <> or <> denoting the color space. + If this is an <> it denotes one of the + predefined color spaces + [[css-color-4#predefined]] + (such as ''display-p3''); + if it is a <> it denotes a custom + color space, defined by a ''@color-profile'' rule. + Individual predefined color spaces + may further restrict whether <>s or <>s + or both, may be used. + + If the <> names a non-existent color space + (a name that does not match one of the + predefined color spaces), + or a predefined but unsupported color space, + this argument represents an invalid color. + + If the <> names a non-existent color space + ( a name that does not match an color profile's name, + or which matches but the corresponding profile has not loaded, + or does not represent a valid profile), + this argument represents an invalid color. + +* One or more <>s or <>s providing the parameter values that the color space takes. + + For custom color spaces, + specified component values + less than 0 or 0%, or greater than 1 or 100% + are not invalid; + they are clamped to the valid range at computed value time. + This is because ICC profiles typically do not accept + out of range input values. + + For custom color spaces, if more <>s or <>s are provided than parameters that the color space takes, + the excess <>s at the end are ignored. + The color is still a [=valid color=]. + + For custom color spaces, if more <>s or <>s are provided than components listed in the optional components descriptor, + the additional values at the end are still valid, + but cannot be used in Relative Color Syntax. + The color is still a [=valid color=]. + + For custom color spaces, if fewer <>s or <>s are provided than parameters that the color space takes, + the missing parameters default to ''0''. + (This is particularly convenient for multichannel printers + where the additional inks are spot colors or varnishes + that most colors on the page won't use.) + The color is still a [=valid color=]. + + For predefined color spaces, + specified component values + less than 0 or 0%, or greater than 1 or 100% + are not invalid; + these out of gamut colors + are gamut mapped to the valid range at computed value time, + with a relative colorimetric intent. + +* An optional slash-separated <>. + This is interpreted the same way as the <> in ''rgb()'', + and if omitted it defaults to ''100%''. - * An optional slash-separated <>. - This is interpreted the same way as the <> in ''rgb()'', - and if omitted it defaults to ''100%''. + + parsing/color-computed-relative-color.html + - - parsing/color-computed-relative-color.html - +
+ For example, Relative Color Syntax in the CIE XYZ D65 colorspace + is used to generate a color which has exactly half the luminance + of the base color: -
- For example, Relative Color Syntax in the CIE XYZ D65 colorspace - is used to generate a color which has exactly half the luminance - of the base color: + 
+		--base:  color(display-p3 0.7 0.5 0.1);
+		--dark:  color(from var(--base) xyz-d65 calc(x/2) calc(y/2) calc(z/2));
+
- 
-			--base:  color(display-p3 0.7 0.5 0.1);
-			--dark:  color(from var(--base) xyz-d65 calc(x/2) calc(y/2) calc(z/2));
-
+ The origin color is color(xyz-d65 0.281 0.253 0.044) + and so the relative color is color(xyz-d65 0.14 0.126 0.022). +
- The origin color is color(xyz-d65 0.281 0.253 0.044) - and so the relative color is color(xyz-d65 0.14 0.126 0.022). -

Custom Color Spaces