Changes

Jump to navigation Jump to search
17,311 bytes added ,  18:34, 24 May 2020
m
Removed redirect to Colors
{{Color navbox}} ConTeXt supports several color models: [https://en.wikipedia.org/wiki/RGB_color_model RGB] (typically used for screen display),[https://en.wikipedia.org/wiki/CMYK_color_model CMYK] (typically used for printing) as well as [https://en.wikipedia.org/wiki/HSL_and_HSV HSV/HSL] and [https://en.wikipedia.org/wiki/HWB_color_model HWB]. There is also support for [https://en.wikipedia.org/wiki/Spot_color spot colors] (typically used for offset printing) and transparencies.  = Before you start ... =  1. It’s usually bad style to use explicit color switches in the text. It’s better to define a semantic command that takes care of the color switching. For example, instead of using <code>\color[red]{important text}</code>, define<texcode>\definehighlight[important][color=red]</texcode>and then use <code>\important{important text}</code> in the text. 2. Colors are not enabled by default in MkII. To enable colors in MkII, use<texcode>\setupcolors[state=start]</texcode> 3. To disable colors in a document, use<texcode>\setupcolors[state=stop]</texcode> = Basic Usage =  To color text, use <texcode>\color[defined-color]{ ... text ... }</texcode> or  <texcode>\startcolor[defined-color] ... text ... \stopcolor</texcode> where <code>defined-color</code> is a color defined using {{cmd|definecolor}}. For example, <code>red</code> is one of the predefined colors. So, we can use: {| ! width="45%"| ! width="10%"| ! width="45%"| |- | <texcode>Three \color[red]{cool} cats</texcode>||<context mode=mkiv>\starttextThree \color[red]{cool} cats\stoptext</context>|} or {| ! width="45%"| ! width="10%"| ! width="45%"| |- | <texcode>\starttext\startcolor[red]\input tufte\stopcolor\stoptext</texcode>||<context mode=mkiv>\setuppapersize[A5]\starttext\startcolor[red]\input tufte\stopcolor\stoptext</context>|} It is also possible to use RGB or CMYK or hex values to color text. The syntax for these is<texcode>\colored[settings]{... text ...}</texcode>where <code>settings</code> are the same settings as used by {{cmd|definecolor}}. For example:  {| ! width="45%"| ! width="10%"| ! width="45%"| |- | <texcode>Three \colored[r=0.1, g=0.8, b=0.8]{colorful} cats</texcode>||<context mode=mkiv>\starttextThree \colored[r=0.1, g=0.8, b=0.8]{colorful} cats\stoptext</context>|}  '''Note'''. There is no need to use the color commands directly. Almost all ConTeXt commands accept a <code>color</code> key, and you can use <code>color=defined-color</code>. For example,  * To color the section titles red, use<texcode>\setuphead[color=red]</texcode> * To color the footnotes red, use<texcode>\setupfootnotes[color=red]</texcode> etc.  = Pre-defined colors =  == Default pre-defined colors == The following colors are pre-defined in ConTeXt (see {{src|colo-imp-rgb.mkiv}}).  {| style="text-align: right; padding-right: 20px;"!| Name !! Color !style="width: 80px;"| Name !! Color !style="width: 100px;"| Name !! Color !style="width: 100px;"| Name !! Color|-|black||bgcolor="#000"| &nbsp;|white||bgcolor="#FFF"| &nbsp; |-|gray||bgcolor="#E6E6E6"| &nbsp;|lightgray||bgcolor="#D6D6D6"| &nbsp; |middlegray||bgcolor="#B9B9B9"| &nbsp; |darkgray||bgcolor="#999999"| &nbsp; |- |red||bgcolor="#FF0000"| &nbsp;|lightred||bgcolor="#FF0000"| &nbsp; |middlered||bgcolor="#CC0000"| &nbsp; |darkred||bgcolor="#990000"| &nbsp; |-|green||bgcolor="#00FF00"| &nbsp;|lightgreen||bgcolor="#00FF00"| &nbsp; |middlegreen||bgcolor="#00CC00"| &nbsp; |darkgreen||bgcolor="#009900"| &nbsp; |-|blue||bgcolor="#0000FF"| &nbsp;|lightblue||bgcolor="#0000FF"| &nbsp; |middleblue||bgcolor="#0000CC"| &nbsp; |darkblue||bgcolor="#000099"| &nbsp; |-|cyan||bgcolor="#00FFFF" | &nbsp;| &nbsp; ||bgcolor=| &nbsp; |middlecyan||bgcolor="#00CCCC" | &nbsp;|darkcyan||bgcolor="#006666" | &nbsp;|-|magenta||bgcolor="#FF00FF" | &nbsp;| &nbsp; ||bgcolor=| &nbsp; |middlemagenta||bgcolor="CC00CC" | &nbsp;|darkmagenta||bgcolor="660066" | &nbsp;|-|yellow||bgcolor="#FFFF00" | &nbsp;| &nbsp; ||bgcolor=| &nbsp; |middleyellow||bgcolor="CCCC00" | &nbsp;|darkyellow||bgcolor="666600" | &nbsp; |} == X11 Colors == In addition to the above basic color, ConTeXt also includes a definition of the [http://www.w3.org/TR/2002/WD-css3-color-20020219/#x11-color X11 colors]. To load this list ({{src|colo-imp-xwi.mkiv}}), use <texcode>\usecolors[xwi]</texcode> This loads the following additional colors: {| style="text-align: right; padding-right: 20px;"!| Name !! Color !style="width: 80px;"| Name !! Color !style="width: 100px;"| Name !! Color !style="width: 100px;"| Name !! Color|-|-|aliceblue||bgcolor="#EFF7FF"|&nbsp;|antiquewhite||bgcolor="#F9EAD6"|&nbsp;|aquamarine||bgcolor="#7FFFD3"|&nbsp;|azure||bgcolor="#EFFFFF"|&nbsp;|-|beige||bgcolor="#F4F4DB"|&nbsp;|bisque||bgcolor="#FFE2C4"|&nbsp;|black||bgcolor="#000000"|&nbsp;|blanchedalmond||bgcolor="#FFEACC"|&nbsp;|-|blue||bgcolor="#0000FF"|&nbsp;|blueviolet||bgcolor="#892BE2"|&nbsp;|brown||bgcolor="#A52828"|&nbsp;|burlywood||bgcolor="#DDB787"|&nbsp;|-|cadetblue||bgcolor="#5E9EA0"|&nbsp;|chartreuse||bgcolor="#7FFF00"|&nbsp;|chocolate||bgcolor="#D1681E"|&nbsp;|coral||bgcolor="#FF7F4F"|&nbsp;|-|cornflowerblue||bgcolor="#6393ED"|&nbsp;|cornsilk||bgcolor="#FFF7DB"|&nbsp;|cyan||bgcolor="#00FFFF"|&nbsp;|darkgoldenrod||bgcolor="#B7870A"|&nbsp;|-|darkgreen||bgcolor="#006300"|&nbsp;|darkkhaki||bgcolor="#BCB76B"|&nbsp;|darkolivegreen||bgcolor="#546B2D"|&nbsp;|darkorange||bgcolor="#FF8C00"|&nbsp;|-|darkorchid||bgcolor="#9933CC"|&nbsp;|darksalmon||bgcolor="#E8967A"|&nbsp;|darkseagreen||bgcolor="#8EBC8E"|&nbsp;|darkslateblue||bgcolor="#473D8C"|&nbsp;|-|darkturquoise||bgcolor="#00CED1"|&nbsp;|darkviolet||bgcolor="#9300D3"|&nbsp;|deeppink||bgcolor="#FF1493"|&nbsp;|deepskyblue||bgcolor="#00BFFF"|&nbsp;|-|dodgerblue||bgcolor="#1E8EFF"|&nbsp;|firebrick||bgcolor="#B22121"|&nbsp;|floralwhite||bgcolor="#FFF9EF"|&nbsp;|forestgreen||bgcolor="#218C21"|&nbsp;|-|gainsboro||bgcolor="#DBDBDB"|&nbsp;|ghostwhite||bgcolor="#F7F7FF"|&nbsp;|gold||bgcolor="#FFD600"|&nbsp;|goldenrod||bgcolor="#D8A521"|&nbsp;|-|green||bgcolor="#00FF00"|&nbsp;|greenyellow||bgcolor="#ADFF2D"|&nbsp;|honeydew||bgcolor="#EFFFEF"|&nbsp;|hotpink||bgcolor="#FF68B5"|&nbsp;|-|indianred||bgcolor="#CC5B5B"|&nbsp;|ivory||bgcolor="#FFFFEF"|&nbsp;|khaki||bgcolor="#EFE58C"|&nbsp;|lavender||bgcolor="#E5E5F9"|&nbsp;|-|lavenderblush||bgcolor="#FFEFF4"|&nbsp;|lawngreen||bgcolor="#7CFC00"|&nbsp;|lemonchiffon||bgcolor="#FFF9CC"|&nbsp;|lightblue||bgcolor="#ADD8E5"|&nbsp;|-|lightcoral||bgcolor="#EF7F7F"|&nbsp;|lightcyan||bgcolor="#E0FFFF"|&nbsp;|lightgoldenrod||bgcolor="#EDDD82"|&nbsp;|lightgoldenrodyellow||bgcolor="#F9F9D1"|&nbsp;|-|lightpink||bgcolor="#FFB5C1"|&nbsp;|lightsalmon||bgcolor="#FFA07A"|&nbsp;|lightseagreen||bgcolor="#21B2AA"|&nbsp;|lightskyblue||bgcolor="#87CEF9"|&nbsp;|-|lightslateblue||bgcolor="#8470FF"|&nbsp;|lightsteelblue||bgcolor="#AFC4DD"|&nbsp;|lightyellow||bgcolor="#FFFFE0"|&nbsp;|limegreen||bgcolor="#33CC33"|&nbsp;|-|linen||bgcolor="#F9EFE5"|&nbsp;|magenta||bgcolor="#FF00FF"|&nbsp;|maroon||bgcolor="#AF3060"|&nbsp;|mediumaquamarine||bgcolor="#66CCAA"|&nbsp;|-|mediumblue||bgcolor="#0000CC"|&nbsp;|mediumorchid||bgcolor="#BA54D3"|&nbsp;|mediumpurple||bgcolor="#9370DB"|&nbsp;|mediumseagreen||bgcolor="#3DB270"|&nbsp;|-|mediumslateblue||bgcolor="#7A68ED"|&nbsp;|mediumspringgreen||bgcolor="#00F999"|&nbsp;|mediumturquoise||bgcolor="#47D1CC"|&nbsp;|mediumvioletred||bgcolor="#C61484"|&nbsp;|-|midnightblue||bgcolor="#191970"|&nbsp;|mintcream||bgcolor="#F4FFF9"|&nbsp;|mistyrose||bgcolor="#FFE2E0"|&nbsp;|moccasin||bgcolor="#FFE2B5"|&nbsp;|-|navajowhite||bgcolor="#FFDDAD"|&nbsp;|navy||bgcolor="#00007F"|&nbsp;|navyblue||bgcolor="#00007F"|&nbsp;|oldlace||bgcolor="#FCF4E5"|&nbsp;|-|olivedrab||bgcolor="#6B8E23"|&nbsp;|orange||bgcolor="#FFA500"|&nbsp;|orangered||bgcolor="#FF4400"|&nbsp;|orchid||bgcolor="#D870D6"|&nbsp;|-|palegoldenrod||bgcolor="#EDE8AA"|&nbsp;|palegreen||bgcolor="#99F999"|&nbsp;|paleturquoise||bgcolor="#AFEDED"|&nbsp;|palevioletred||bgcolor="#DB7093"|&nbsp;|-|papayawhip||bgcolor="#FFEFD6"|&nbsp;|peachpuff||bgcolor="#FFD8BA"|&nbsp;|peru||bgcolor="#CC843F"|&nbsp;|pink||bgcolor="#FFBFCC"|&nbsp;|-|plum||bgcolor="#DDA0DD"|&nbsp;|powderblue||bgcolor="#AFE0E5"|&nbsp;|purple||bgcolor="#A021EF"|&nbsp;|red ||bgcolor="#FF0000"|&nbsp;|-|rosybrown||bgcolor="#BC8E8E"|&nbsp;|royalblue||bgcolor="#3F68E0"|&nbsp;|saddlebrown||bgcolor="#8C4411"|&nbsp;|salmon||bgcolor="#F97F72"|&nbsp;|-|sandybrown||bgcolor="#F4A360"|&nbsp;|seagreen||bgcolor="#2D8C56"|&nbsp;|seashell||bgcolor="#FFF4ED"|&nbsp;|sienna||bgcolor="#A0512D"|&nbsp;|-|skyblue||bgcolor="#87CEEA"|&nbsp;|slateblue||bgcolor="#6B59CC"|&nbsp;|snow||bgcolor="#FFF9F9"|&nbsp;|springgreen||bgcolor="#00FF7F"|&nbsp;|-|steelblue||bgcolor="#4482B5"|&nbsp;|tan ||bgcolor="#D1B58C"|&nbsp;|thistle||bgcolor="#D8BFD8"|&nbsp;|tomato||bgcolor="#FF6347"|&nbsp;|-|turquoise||bgcolor="#3FE0D1"|&nbsp;|violet||bgcolor="#REDIRECT ED82ED"|&nbsp;|violetred||bgcolor="#D1218E"|&nbsp;|wheat||bgcolor="#F4DDB2"|&nbsp;|-|white||bgcolor="#FFFFFF"|&nbsp;|whitesmoke||bgcolor="#F4F4F4"|&nbsp;|yellow||bgcolor="#FFFF00"|&nbsp;|yellowgreen||bgcolor="#99CC33"|&nbsp;|} == Additional pre-defined colors == In addition to the above, there are two other sets of pre-defined colors.  {| class="wikitable"| x11 || <code>\usecolors[x11]</code>| {{src|colo-imp-x11.mkiv}}| 658 extended Xorg color keywords (WWW), defined in hex RGB|-| crayola || <code>\usecolors[crayola] </code> | {{src|colo-imp-crayola.mkiv}} || 235 Crayola (Binney & Smith) colors|-| ema || <code>\usecolors[ema]</code>| {{src|colo-imp-ema.mkiv}} || 549 Emacs colors|-| RAL || <code>\usecolors[ral]</code>| {{src|colo-imp-ral.mkiv}} || 213 RAL color system (Deutsches Institut für Gütesicherung und Kennzeichnung)|-| Solarized || <code>\usecolors[solarized]</code>| {{src|colo-imp-solarized.mkiv}} || 16 solarized colors |} = Defining New Colors= New colors may be defined in the following ways {| class="wikitable"! Name !! Syntax (and Example) !! Explanation|-| style="width:20%;" | RGB color model| style="width:40%;" | <texcode>\definecolor[...][r=..., g=..., b=...]</texcode> For example,<texcode>\definecolor[lime][r=0.75, g=1, b=0] This is \color[lime]{a new color}that we defined</texcode>| The values for <code>r</code>, <code>g</code>, and <code>b</code> are floating point number between <code>0</code> and <code>1</code>. |-| CMYK color model| <texcode>\definecolor[...][c=.., m=.., y=.., k=..]</texcode> For example,<texcode>\definecolor[lime][c=0.25, m=0, y=1, k=0] This is \color[lime]{a new color}that we defined</texcode>| The values for <code>c</code>, <code>m</code>, <code>y</code> and <code>k</code> are floating point number between <code>0</code> and <code>1</code>. |-| HSV/HSL color model|<texcode>\definecolor[...][h=.., s=.., v=..]</texcode> For example,<texcode>\definecolor[lime][h=75, s=1, v=1] This is \color[lime]{a new color}that we defined</texcode>| The value for <code>h</code> (hue) is between <code>0</code> and <code>360</code>; the values for <code>s</code> (saturation), <code>v</code> (value/brightness) are floating point numbers between <code>0</code> and <code>1</code>. |-| HWB color model|<texcode>\definecolor[...][h=.., w=.., b=..]</texcode> For example,<texcode>\definecolor[something][h=75, w=0.5, b=.1] This is \color[something]{a new color}that we defined</texcode>| The value for <code>h</code> (hue) is between <code>0</code> and <code>360</code>; the values for <code>w</code> (whiteness), <code>b</code> (blackness) are floating point numbers between <code>0</code> and <code>1</code>. This mostly unknown color model is also used in CSS3/SVG.|-| Hex| <texcode>\definecolor[...][x=...]</texcode> For example,<texcode>\definecolor[lime][x=BFFF00] This is \color[lime]{a new color}that we defined</texcode>| The value for <code>x</code> is a three-byte hexadecimal number where the bytes represent the red, green, and blue values. This follows the HTML and CSS style of defining colors.|-|Gray scale|<texcode>\definecolor[...][s=...]</texcode> For example,<texcode>\definecolor[screen][s=0.5] This is \color[screen]{a new color}that we defined</texcode>| The value for <code>s</code> is a floating point number between <code>0</code> and <code>1</code>, representing the grayness value (1 represents white, 0 represents black).|} == Cloning existing colors == You can ''clone'' an existing color using<texcode>\definecolor[new-color][old-color]</texcode> For example{|| width="45%"| <texcode>\usecolors[xwi]\definecolor[highlight][yellow]\defineframed [important] [location=low, frame=off, background=color, backgroundcolor=highlight] This is a \important{important}word. \definecolor[highlight][lavenderblush]This is a \important{important}word.</texcode>| width="10%"|| width="45%"| <context mode=mkiv>\usecolors[xwi]\definecolor[highlight][yellow]\defineframed[important][location=low, frame=off, background=color, backgroundcolor=highlight] This is a \important{important}word. \definecolor[highlight][lavenderblush]This is a \important{important}word.</context>|} == Adapting existing colors == {{todo | add details about this}} = Advanced Usage = == Changing color of entire document == To change the main text color of the document use <texcode>\setupcolors[textcolor=defined-color]</texcode> For example, {| ! width="45%"| ! width="10%"| ! width="45%"||-|<texcode>\setupcolors[textcolor=blue]\starttexttext\stoptext</texcode>||<context mode=mkiv>\setupcolors[textcolor=blue]\starttexttext\stoptext</context>|} == Changing background color of page == The background color of the page can be changed using<texcode>\setupbackgrounds[page][background=color,backgroundcolor=defined-color]</texcode>  For example,{| ! width="45%"| ! width="10%"| ! width="45%"| |- | <texcode>\setuppapersize[A10]\setupbackgrounds[page][background=color,backgroundcolor=blue] \starttexttext\stoptext</texcode>||<context>\setuppapersize[A10]\setupcolors[state=start] \setupbackgrounds[page][background=color,backgroundcolor=blue] \starttexttext\stoptext</context>|}    == Using colors in MetaPost == A color defined in TeX is available in MetaPost using `\MPcolor{...}`. For example: {||-|<texcode>\definecolor[highlight][r=0.8,g=0.8,b=0]\starttext\color[highlight]{Highlighted text in TeX} \startMPcodelabel("Highlighted text in MetaPost", origin) withcolor \MPcolor{highlight};\stopMPcode</texcode>|<context mode=mkiv>\definecolor[highlight][r=0.8,g=0.8,b=0]\starttext\color[highlight]{Highlighted text in TeX} \startMPcodelabel("Highlighted text in MetaPost", origin) withcolor \MPcolor{highlight};\stopMPcode</context>|} Note that `\MPcolor{...}` behaves similar to a `color` primitive in MetaPost. For example, the following is valid MetaPost code.<texcode>color myColor; myColor = 0.5[\MPcolor{highlight}, white];</texcode>  == Using colors in TikZ == = Viewing pre-defined color = == View all defined colors == To view pre-defined colors, you can use {{cmd|showcolor}}. For example, to see all the colors defined in {{src|colo-imp-x11.mkiv}}, use (output truncated for display here ...) {| |-|<texcode>\showcolor[x11]</texcode>|<context mode=mkiv>\startTEXpage[height=5cm]\showcolor[x11]\stopTEXpage</context>|} If you use {{cmd|showcolor}} without any argument, all currently defined colors are shown. == View specific defined colors == To view the components of a defined color, you can use: * {{cmd|showcolorcomponents}}<texcode>\showcolorcomponents[color-1, color-2]</texcode> For example, {| |-|<texcode>\showcolorcomponents[red,middlered,darkred]</texcode>|<context mode=mkiv>\showcolorcomponents[red,middlered,darkred]</context>|} * {{cmd|colorcomponents}}* {{cmd|transparencycomponents}}* {{cmd|processcolorcomponents}}<texcode>\colorcompoents{defined-color}\tranparencycomponents{defined-color}\processcolorcomponents{defined-color}</texcode> For example,{||-|<texcode>\startlines\colorcomponents{red}\transparencycomponents{red}\processcolorcomponents{red}\stoplines</texcode>|<context mode=mkiv>\startlines\colorcomponents{red}\transparencycomponents{red}\processcolorcomponents{red}\stoplines</context>|} = Testing if color is defined = To test if a color is defined, use * {{cmd|doifcolor}}* {{cmd|doifcolorelse}} Usage: <texcode>\doifcolor{color-name}{... if branch ... }\doifcolorelse{color-name}{... if branch ...}{... else branch ...}</texcode> = Specialized topics = * [[Color/Palet|Color Palettes]]* [[Color/Transparency|Transparency]] * [[Color/Spot_Colors|Spot Colors]] = References = * [http://paletton.com Paletton] - Website to choose color palettes* [http://colorbrewer2.org/ ColorBrewer]- website to choose colors for maps and graphics. * Tina Sutton, Bride M Whelan: The Complete Color Harmony. Rockport Publishers (2004). ISBN 978-1592530311 (recommanded in the mailing list)   {{Getting started navbox}}

Navigation menu