3,897
edits
Changes
Jump to navigation
Jump to search
m
< [[Visuals]] | [[Graphics]] >{{Color navbox}}
= Enabling colors =
In current versions ConTeXt supports two color models: [http://en.wikipedia.org/wiki/RGB_color_model RGB] (earlier than 11typically used for screen display) and [http://en.05wikipedia.2009org/wiki/CMYK_color_model CMYK] (typically used for printing) of ConTeXt mkiv, . There is also support for [http://en.wikipedia.org/wiki/Spot_color spot colors are enabled by default] (typically used for offset printing) and transparencies.
In older versions, colors must be enabled using <cmd>setupcolors</cmd><tt>[state=Before you start]</tt>... =
Using 2. Colors are not enabled by default in MkII. To enabled colors with ConTeXt is easy:in MkII, use<texcode>\setupcolors[state=start]</texcode>
== Choosing 3. To disable colors in a color model =document, use<texcode>\setupcolors[state=stop]</texcode>
* RGB and CMYK are enabled by default. If you want only RGB or only CMYK color, use <tt>cmyk=no</tt> or <tt>rgbBasic Usage =no</tt>. Multitone colors see below. * For spot colors, say spot=yes. To eliminate everything except spot colours, leaving a clean file for professional printing, accompany this with rgb=no,cmyk=no. See spot colours below for more details.* Normally all colors are defined in RGB ''and'' CMYK and get converted if needed.
== Using predefined colors: <cmd>setupcolor</cmd> ==
You find lists of predefined colors in the files <tt>colo-xxx.tex</tt>To color text, load them with <cmd>setupcolor</cmd><tt>[xxx]</tt>:* rgb: some simple colors, loaded by default (with translations for the different interface languages!)* xwi: X-Windows-colors* pra: PRAGMA ADE company colors* ema: Emacs colorsuse
* Try the magic <cmd>showcolor</cmd><tttexcode>\color[xxxdefined-color]{ ... text ... }</tttexcode>!
{| ! width="25%"| ! width="10%"| ! width="65%"| |- | <texcode>\showcolor[rgb]</texcode>|| <context>\setupcolors[state=start]\showcolor[rgb]</context>|} == Defining colors: <cmd>definecolor</cmd> ==or
\definecolor[blablue][r=.25, g=.1, b=1, c=1, m=.1, y=0, k=0, s=.2] Here's some Three \color[blabluered]{blue textcool} inbetween!cats
=== Colors with Hexadecimal Numbers ===or
You can also use hexadecimal numers to specify colors. You need to load the '''hex''' color module first:
===Transparent Colors===It is also possible to use RGB or CMYK or hex values to color text. The syntax for these is You can define '''transparent''' colors through setting t, e<texcode>\colored[settings]{... text ..g. }</texcode>where <ttcode>t=0.5settings</ttcode>are the same settings as used by {{cmd|definecolor}}. Beware, some PDF viewers and printshops can't handle PDF transparences!For example:
Hans Hagen posted the following sample code for transparent colors on the mailing list on 2005-07-13; the yellow blocks have been added to demonstrate the order in which the blocks are drawn on the page; the first yellow block is behind the transparent red and blue blocks, while the second is in front of them.
== Defining color schemes: <cmd>definecolorgroup</cmd> and <cmd>definepalet</cmd>==
<cmd>definecolorgroup</cmd><tt>[name][system][values]</tt>
Very interesting feature* To color the section titles red, to be described later... (see manual)use<texcode>\setuphead[color=red]</texcode>
=Choosing a * To color the footnotes red, use<texcode>\setupfootnotes[color scheme=red]</texcode>
There are three basic strategies to select color combinations for a particular designetc.
# Create a color scheme by picking several colors found within the objects to be used (photographs, pictures, etc)
# Create colors derived from those found in the objects to be used
# Create a color scheme based on the message to convey / the psychological effects of color
See for additional help & reference:* [http://colorschemedesigner.com/ colorschemedesigner.com] = Pre- Useful site to help choose a color scheme in rgb color spacedefined colors =* Tina Sutton, Bride M Whelan: The Complete Color Harmony. Rockport Publishers (2004). ISBN 978-1592530311 (recommanded in the mailing list)
=Using Colors=The following colors are pre-defined in ConTeXt (see {{src|colo-imp-rgb.mkiv}}).
* Use the color name like <tt>[color=blablue]</tt> in some <tt>\setup...</tt> command.
* Typeset single text elements with <cmd>color</cmd><tt>[blablue]{nice blue text}</tt> or longer sections with <cmd>startcolor</cmd><tt>[blablue] ...</tt> <cmd>stopcolor</cmd>.
{| ! width="45%"| ! width="10%"| ! width="45%"| |- | <texcode>\setupbackgrounds[page][background=color,backgroundcolor=blue]}
\starttexttext\stoptext</texcode>||<context>\setupcolors[state=start]= X11 Colors ==
\setupbackgroundsIn addition to the above basic color, ConTeXt also includes a definition of the [pagehttp://www.w3.org/TR/2002/WD-css3-color-20020219/#x11-color X11 colors][background=color. To load this list ({{src|colo-imp-xwi.mkiv}}),backgroundcolor=blue]use
== Background of cells in tables ==This loads the following additional colors:
See [[Table{| 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="#Background Colors]]EFF7FF"| |antiquewhite||bgcolor="#F9EAD6"| |aquamarine||bgcolor="#7FFFD3"| |azure||bgcolor="#EFFFFF"| |-|beige||bgcolor="#F4F4DB"| |bisque||bgcolor="#FFE2C4"| |black||bgcolor="#000000"| |blanchedalmond||bgcolor="#FFEACC"| |-|blue||bgcolor="#0000FF"| |blueviolet||bgcolor="#892BE2"| |brown||bgcolor="#A52828"| |burlywood||bgcolor="#DDB787"| |-|cadetblue||bgcolor="#5E9EA0"| |chartreuse||bgcolor="#7FFF00"| |chocolate||bgcolor="#D1681E"| |coral||bgcolor="#FF7F4F"| |-|cornflowerblue||bgcolor="#6393ED"| |cornsilk||bgcolor="#FFF7DB"| |cyan||bgcolor="#00FFFF"| |darkgoldenrod||bgcolor="#B7870A"| |-|darkgreen||bgcolor="#006300"| |darkkhaki||bgcolor="#BCB76B"| |darkolivegreen||bgcolor="#546B2D"| |darkorange||bgcolor="#FF8C00"| |-|darkorchid||bgcolor="#9933CC"| |darksalmon||bgcolor="#E8967A"| |darkseagreen||bgcolor="#8EBC8E"| |darkslateblue||bgcolor="#473D8C"| |-|darkturquoise||bgcolor="#00CED1"| |darkviolet||bgcolor="#9300D3"| |deeppink||bgcolor="#FF1493"| |deepskyblue||bgcolor="#00BFFF"| |-|dodgerblue||bgcolor="#1E8EFF"| |firebrick||bgcolor="#B22121"| |floralwhite||bgcolor="#FFF9EF"| |forestgreen||bgcolor="#218C21"| |-|gainsboro||bgcolor="#DBDBDB"| |ghostwhite||bgcolor="#F7F7FF"| |gold||bgcolor="#FFD600"| |goldenrod||bgcolor="#D8A521"| |-|green||bgcolor="#00FF00"| |greenyellow||bgcolor="#ADFF2D"| |honeydew||bgcolor="#EFFFEF"| |hotpink||bgcolor="#FF68B5"| |-|indianred||bgcolor="#CC5B5B"| |ivory||bgcolor="#FFFFEF"| |khaki||bgcolor="#EFE58C"| |lavender||bgcolor="#E5E5F9"| |-|lavenderblush||bgcolor="#FFEFF4"| |lawngreen||bgcolor="#7CFC00"| |lemonchiffon||bgcolor="#FFF9CC"| |lightblue||bgcolor="#ADD8E5"| |-|lightcoral||bgcolor="#EF7F7F"| |lightcyan||bgcolor="#E0FFFF"| |lightgoldenrod||bgcolor="#EDDD82"| |lightgoldenrodyellow||bgcolor="#F9F9D1"| |-|lightpink||bgcolor="#FFB5C1"| |lightsalmon||bgcolor="#FFA07A"| |lightseagreen||bgcolor="#21B2AA"| |lightskyblue||bgcolor="#87CEF9"| |-|lightslateblue||bgcolor="#8470FF"| |lightsteelblue||bgcolor="#AFC4DD"| |lightyellow||bgcolor="#FFFFE0"| |limegreen||bgcolor="#33CC33"| |-|linen||bgcolor="#F9EFE5"| |magenta||bgcolor="#FF00FF"| |maroon||bgcolor="#AF3060"| |mediumaquamarine||bgcolor="#66CCAA"| |-|mediumblue||bgcolor="#0000CC"| |mediumorchid||bgcolor="#BA54D3"| |mediumpurple||bgcolor="#9370DB"| |mediumseagreen||bgcolor="#3DB270"| |-|mediumslateblue||bgcolor="#7A68ED"| |mediumspringgreen||bgcolor="#00F999"| |mediumturquoise||bgcolor="#47D1CC"| |mediumvioletred||bgcolor="#C61484"| |-|midnightblue||bgcolor="#191970"| |mintcream||bgcolor="#F4FFF9"| |mistyrose||bgcolor="#FFE2E0"| |moccasin||bgcolor="#FFE2B5"| |-|navajowhite||bgcolor="#FFDDAD"| |navy||bgcolor="#00007F"| |navyblue||bgcolor="#00007F"| |oldlace||bgcolor="#FCF4E5"| |-|olivedrab||bgcolor="#6B8E23"| |orange||bgcolor="#FFA500"| |orangered||bgcolor="#FF4400"| |orchid||bgcolor="#D870D6"| |-|palegoldenrod||bgcolor="#EDE8AA"| |palegreen||bgcolor="#99F999"| |paleturquoise||bgcolor="#AFEDED"| |palevioletred||bgcolor="#DB7093"| |-|papayawhip||bgcolor="#FFEFD6"| |peachpuff||bgcolor="#FFD8BA"| |peru||bgcolor="#CC843F"| |pink||bgcolor="#FFBFCC"| |-|plum||bgcolor="#DDA0DD"| |powderblue||bgcolor="#AFE0E5"| |purple||bgcolor="#A021EF"| |red ||bgcolor="#FF0000"| |-|rosybrown||bgcolor="#BC8E8E"| |royalblue||bgcolor="#3F68E0"| |saddlebrown||bgcolor="#8C4411"| |salmon||bgcolor="#F97F72"| |-|sandybrown||bgcolor="#F4A360"| |seagreen||bgcolor="#2D8C56"| |seashell||bgcolor="#FFF4ED"| |sienna||bgcolor="#A0512D"| |-|skyblue||bgcolor="#87CEEA"| |slateblue||bgcolor="#6B59CC"| |snow||bgcolor="#FFF9F9"| |springgreen||bgcolor="#00FF7F"| |-|steelblue||bgcolor="#4482B5"| |tan ||bgcolor="#D1B58C"| |thistle||bgcolor="#D8BFD8"| |tomato||bgcolor="#FF6347"| |-|turquoise||bgcolor="#3FE0D1"| |violet||bgcolor="#ED82ED"| |violetred||bgcolor="#D1218E"| |wheat||bgcolor="#F4DDB2"| |-|white||bgcolor="#FFFFFF"| |whitesmoke||bgcolor="#F4F4F4"| |yellow||bgcolor="#FFFF00"| |yellowgreen||bgcolor="#99CC33"| |}
To produce a file ready for a clean PDF separation process at your print houseIn addition to the above, start with:there are two other sets of pre-defined colors.
which will set things up for spot colors with CMYK allowed. The last setting ensures that black overprinting your spot colour tints will not knock out the colour - this is important for some types of commercial printing.= Defining New Colors =
Then define your basic spot colour. Note that New colors may be defined in the name cannot contain spaces or numbers (but we come to that later):following ways
Now you can define the tints of this ink that you '''Note''': The key-values are actually going to use in your documentoverloaded. Let'For example, <code>h</code> is used for both HSV model and Hex model; <code>s say you'll have a 100% </code> is used for headings:both HSV model and grayscale model. The distinction is made based on the presence or absence of the <code>v</code> key.
<cmd>definespotcolor</cmd><tt>[MyBlue][PantoneTwoNineFour][p=1]</tt>= Cloning existing colors ==
And then a 20% tint for nice display boxes:You can ''clone'' an existing color using<texcode>\definecolor[new-color][old-color]</texcode>
And now you can happily use these named colours:This is a \important{important}word.
<texcode>\starttextdefinecolor[highlight][lavenderblush] This is a \color[MyBlue]important{Interestingimportant}\stoptextword.
If you are including graphics made by an external program, you might want to match the colour name used in the graphic with the colour name in your '''ConTeXt''' set-up so that only one colour space This is used in the final filea \important{important}word. Unfortunately Pantone names and others tend to have spaces and numbers in them, so you need to do a low-level mapping trick from your base name to the name you want embedded in the file:
<cmd>doregisterspotcolorname</cmd><tt>\definecolor[highlight][lavenderblush]This is a \important{PantoneTwoNineFour}{PANTONE 294 CVimportant}word.</ttcontext>|}
Now your output file should work beautifully with graphics embedded!== Adapting existing colors ==
==Using the 'e' key to \definecolor to specify a spot colour name with spaces=={{todo | add details about this}}
As an update to the above description on defining spot colours, you can now use the 'e' key when defining your spot colours in order to specify the precise colour names to be used by your ConTeXt set-up in the output file. For example:= Advanced Usage =
<texcode>% Define spot colours using 'e=....' to specify colour names to use in output file\definecolor [PantoneThreeZeroEight] [c=1,m=.05,yChanging color of entire document =0,k=.47,e=PANTONE 308 CV] To change the main text color of the document use
% Define tints of spot colours to be used in document for colouring text\definespotcolor [DarkBlue] [PantoneThreeZeroEight] [p=1]For example,
\definespotcolor{| ! width="45%"| ! width="10%"| [LightBlue] ! width="45%"| [PantoneTwoNineEight]|- |<texcode>\setupcolors[ptextcolor=1blue]\starttexttext\stoptext
(Tested only on minimal Linux distribution dated 31 Aug 2005 - can others confirm thisto be true across the board now?)== Changing background color of page ==
Any text between a The background color of the page can be changed using<cmdtexcode>startcolor\setupbackgrounds[page][DarkBluebackground=color,backgroundcolor=defined-color]</cmd> and <cmd>stopcolor</cmdtexcode> should now be assigned to the correct spot colour channel - Pantone 308 CV - on output. More importantly if you include an external figure containing areas of this colour then your text and those parts of the graphic which have the same colour should now appear together in the 'Pantone 308 CV' colour channel on colour separation.
For example, if your original graphic is an EPS file containing the following lines:
and you convert this to a PDF using \starttexttext\stoptext<tt/texcode>ps2pdf||</ttcontext> for inclusion in your '''ConTeXt''' document your PDF graphic will then contain something like:\setuppapersize[A10]\setupcolors[state=start]
<code> 8 0 obj \setupbackgrounds[/Separation /PANTONE#20308#20CV /DeviceCMYK 9 0 Rpage]endobj 10 0 obj [/Separation /PANTONE#20298#20CV /DeviceCMYK 11 0 Rbackground=color,backgroundcolor=blue]endobj </code>
Note how the space characters in the colour name are now encoded as '#20', but the colour names are essentially identical between the original EPS graphic, the new PDF graphic and your \starttexttext.\stoptext</context>|}
A good way of testing colour separation if you don't have access to expensive pre-flight PDF validation tools is to use the following GhostScript command:
gs \
-dBATCH \
-dNOPAUSE \
-sDEVICE=tiffsep \
-dDOINTERPOLATE \
-dTextAlphaBits=4 \
-dGraphicsAlphaBits=4 \
-sOutputFile=output.tif \
-r120 \
-MaxSeparations=8 \
input.pdf
This renders a PDF file <tt>input.pdf</tt> as a set of TIFF files:
output.tif - Composite including CMYK approximations to spot colours output.tif.Black.tif - K channel output.tif.Cyan.tif - C channel output.tif.Magenta.tif - M channel output.tif.Yellow.tif - Y channel output.tif.s0.tif - Pantone 308 CV output.tif.s1.tif - Pantone 298 CV== Using colors in MetaPost ==
=Multitones=A color defined in TeX is available in MetaPost using `\MPcolor{...}`. For example:
Hans wrote on the mailinglist on 2004{||-12-27 about handling of multitone colors:|<texcode>\definecolor[highlight][r=0.8,g=0.8,b=0]\starttext\color[highlight]{Highlighted text in TeX}
Currently it's done by pdftools\startMPcodelabel("Highlighted text in MetaPost", origin) withcolor \MPcolor{highlight};\stopMPcode</texcode>|<context mode=mkiv>\definecolor[highlight][r=0.rb8,g=0.8,b=0]\starttext\color[highlight]{Highlighted text in TeX}
Once pdfxTeX becomes pdfeTeX out of a sudden your beta can do it as well.\startMPcodelabel("Highlighted text in MetaPost", origin) withcolor \MPcolor{highlight};\stopMPcode</context>|}
I still need Note that `\MPcolor{...}` behaves similar to figure out a way to automatically reverse `color` primitive in MetaPost. For example, the graphicfollowing is valid MetaPost code.<texcode>color myColor; myColor = 0.5[\MPcolor{highlight}, but one of these days you can start using it.white];</texcode>
Actually, multitones for text already work out of the box:
<texcode>
\setupcolors[state=start]
\definecolor [blue] [c=1,m=.38,yUsing colors in TikZ =0,k=.64]\definecolor [yellow] [c=0,m=.28,y=1,k=.06]
\definespotcolor [blue-100] [blue] [p=1]\definespotcolor [yellowViewing pre-100] [yellow] [pdefined color =1]
\definemultitonecolor [combicolor] [blue=.12,yellow=.28] [cView all defined colors =.1,m=.1,y=.3,k=.1]
\starttextTo 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 ...)
\startcolor[yellow]\blackrule[width=3cmIf you use {{cmd|showcolor}} without any argument,height=3cm]\stopcolorall currently defined colors are shown.
\startcolor[combicolor]\blackrule[width=3cm,height=3cm]\stopcolorView specific defined colors ==
\stoptext</texcode>(The CMYK color spec is To view the fall back components of a defined color used on screen; one , you can preview separations in full Acrobat 7.)use:
Another sample by Hans (mailing list 2005* {{cmd|colorcomponents}}* {{cmd|transparencycomponents}}* {{cmd|processcolorcomponents}}<texcode>\colorcompoents{defined-11color}\tranparencycomponents{defined-16) demonstrates a lot of different possibilities:color}\processcolorcomponents{defined-color}</texcode>
\startbuffer\definecolor [blue] [c=1, mTesting if color is defined =.38, y=0, k=.64]\definecolor [yellow] [c=0, m=.28, y=1, k=.06]
\definespotcolor [blue-100] [blue] [p=1]\definespotcolor [yellow-100] [yellow] [p=1]To test if a color is defined, use
\definemultitonecolor [combicolor] [blue=.12, yellow=.28] [c=.1, m=.1, y=.3, k=.1]* {{cmd|doifcolor}}* {{cmd|doifcolorelse}}
\definemultitonecolor [combicolor-b] [blue=1] [c=1, m=.38, y=0, k=.64] % force multitone\definemultitonecolor [combicolor-y] [yellow=1] [c=0, m=.28, y=1, k=.06] % force multitoneUsage:
\startbaselinecorrection\startcombination[4*1] {\externalfigure[demo-a]} {no color} {\externalfigure[demo-a][color=combicolor]} {indexed duotone} {\externalfigure[demo-a][colorSpecialized topics =combicolor-b]} {spot color} {\externalfigure[demo-a][color=combicolor-y]} {spot color}\stopcombination\stopbaselinecorrection
\startbaselinecorrection\startcombination[4*1] {\externalfigure[demo-b]} {no color} {\externalfigure[demo-bColor/Palet|Color Palettes][color=combicolor]} {indexed duotone} {\externalfigure* [demo-b[Color/Transparency|Transparency][color=combicolor-b]} {spot color} {\externalfigure* [demo-b[Color/Spot_Colors|Spot Colors][color=combicolor-y]} {spot color}\stopcombination\stopbaselinecorrection
\startbaselinecorrection\startcombination[4*1] {\externalfigure[demo-a]} {no color} {\externalfigure[demo-a][color=combicolor]} {indexed duotone} {\externalfigure[demo-a][colorReferences =blue-100]} {spot color} {\externalfigure[demo-a][color=yellow-100]} {spot color}\stopcombination\stopbaselinecorrection
\startbaselinecorrection\startcombination[4*1] {\externalfigure[demo-bhttp://paletton.com Paletton]} {no color} {\externalfigure[demo-b][Website to choose color=combicolor]} {indexed duotone}palettes {\externalfigure* [demo-bhttp://colorbrewer2.org/ ColorBrewer][color=blue-100]} {spot color} {\externalfigure[demo-b][color=yellow-100]} {spot color}\stopcombination\stopbaselinecorrection\stopbufferwebsite to choose colors for maps and graphics.
\getbuffer \typebuffer* Tina Sutton, Bride M Whelan: The Complete Color Harmony. Rockport Publishers (2004). ISBN 978-1592530311 (recommanded in the mailing list)
\stoptext
</texcode>
= References =
See "Color and Background" in the manual{{Getting started navbox}}
→Defining New Colors: bit of visual cleanup
1. It is usually a bad style to use explicit color switches in the text. It is 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=Defining Colors=red]</texcode>and then use <code>\important{important text}</code> in the text.
<cmd>definecolor</cmd><tttexcode>\startcolor[blabluedefined-color][r= ...1, g=text .1, b=1, c=1, m=.1, y=0, k=0, s=.2]\stopcolor</tttexcode> (definition for RGB, CMYK and Grey!)
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:
{|
|-
| <texcode>
</texcode>
|
| <contextmode=mkiv>\setupcolors[state=start]starttext\definecolor[blablue][r=.1, g=.1, b=1, c=1, m=.1, y=0, k=0, s=.2] Here's some Three \color[blabluered]{blue textcool} inbetween!cats\stoptext
</context>
|}
{|
! width="45%"|
|-
| <texcode>
\setupcolorstarttext\startcolor[hexred]\definecolor[salmon][h=AB5757]input tufte\stopcolorHey, \color[salmon]{look at that!}stoptext
</texcode>
|
|<contextmode=mkiv>\setupcolorssetuppapersize[state=startA5]\setupcolorstarttext\startcolor[hexred]\definecolor[salmon][h=AB5757]input tufte\stopcolorHey, \color[salmon]{look at that!}stoptext
</context>
|}
{|
|-
| <texcode>
Three \definecolor [transparentred] colored[r=1,t=.5,a=1]\definecolor [transparentblue] [b=1,t=0.5,a=1]\definecolor [solidyellow] [y=1,t=1,a=1] \starttext \startTEXpageThis is some sample text that goes behind the rectangles\hskip-8cm\blackrule[width=2cm,height=1cm,depth=1cm,colorg=solidyellow]\hskip-0.67cm\blackrule[width=2cm8,height=2cm,color=transparentred]\hskip-0.67cm\blackrule[width=2cm,height=1cm,depth=1cm,colorb=transparentblue]\hskip-0.67cm\blackrule[width=2cm,height=2cm,color=solidyellow8]\hskip2cm.\stopTEXpage \stoptext{colorful} cats
</texcode>
|
|<contextmode=mkiv>\setupcolors[state=start]\definecolor [transparentred] [r=1,t=.5,a=1]\definecolor [transparentblue] [b=1,t=.5,a=1]\definecolor [solidyellow] [y=1,t=1,a=1]
\starttext
Three \startTEXpageThis is some sample text that goes behind the rectangles\hskip-8cm\blackrulecolored[widthr=2cm,height=1cm,depth=1cm,color=solidyellow]\hskip-0.67cm\blackrule[width=2cm1,heightg=2cm,color=transparentred]\hskip-0.67cm\blackrule[width=2cm8,heightb=1cm,depth=1cm,color=transparentblue]\hskip-0.67cm\blackrule[width=2cm,height=2cm,color=solidyellow8]\hskip2cm.\stopTEXpage{colorful} cats
\stoptext
</context>
|}
'''Note'''. There is no need to use the color commands directly. Almost all ConTeXt commands accept a <cmdcode>definepaletcolor</cmdcode>key, and you can use <ttcode>[palettename][colorname1=groupcolor:1, colorname2color=groupcolor:2, ...]defined-color</ttcode>. For example,
== Default pre-defined colors ==
{| style="text-align: right; padding-right: 20px;"!| Name !! Color !style= Background of the page "width: 80px;"| Name !! Color !style="width: 100px;"| Name !! Color !style="width: 100px;"| Name !! Color|-|black||bgcolor="#000"| |white||bgcolor="#FFF"| |-|gray||bgcolor="#E6E6E6"| |lightgray||bgcolor="#D6D6D6"| |middlegray||bgcolor="#B9B9B9"| |darkgray||bgcolor="#999999"| |- |red||bgcolor="#FF0000"| |lightred||bgcolor="#FF0000"| |middlered||bgcolor="#CC0000"| |darkred||bgcolor="#990000"| |-|green||bgcolor="#00FF00"| |lightgreen||bgcolor="#00FF00"| |middlegreen||bgcolor="#00CC00"| |darkgreen||bgcolor="#009900"| |-|blue||bgcolor="#0000FF"| |lightblue||bgcolor="#0000FF"| |middleblue||bgcolor="#0000CC"| |darkblue||bgcolor="#000099"| |-|cyan||bgcolor="#00FFFF" | | ||bgcolor=| |middlecyan||bgcolor="#00CCCC" | |darkcyan||bgcolor="#006666" | |-|magenta||bgcolor="#FF00FF" | | ||bgcolor=| |middlemagenta||bgcolor="CC00CC" | |darkmagenta||bgcolor="660066" | |-|yellow||bgcolor="#FFFF00" | | ||bgcolor=| |middleyellow||bgcolor="CCCC00" | |darkyellow||bgcolor="666600" |
<texcode>\starttexttext\stoptextusecolors[xwi]</contexttexcode>|}
=Spot colours= Additional 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]<cmd/code>setupcolors| {{src|colo-imp-ema.mkiv}} || 549 Emacs colors|-| RAL || <code>\usecolors[ral]</cmdcode>| {{src|colo-imp-ral.mkiv}} || 213 RAL color system (Deutsches Institut für Gütesicherung und Kennzeichnung)|-| Solarized || <ttcode>\usecolors[rgb=no,cmyk=yes,spot=yes,state=start,overprint=yessolarized]</ttcode>| {{src|colo-imp-solarized.mkiv}} || 16 solarized colors |}
{| class="wikitable"! Name !! Syntax (and Example) !! Explanation|-| style="width:20%;" | RGB color model| style="width:40%;" | <texcode>\definecolor[...][r=..., g=..., b=...]<cmd/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</cmdcode>and <ttcode>1</code>. |-| CMYK color model| <texcode>\definecolor[PantoneTwoNineFour...][c=1..,m=.56.,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 color model|<texcode>\definecolor[...18][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> is between <code>0</code> and <code>360</code>; the values for <code>s</code>, <code>v</code> are floating point numbers between <code>0</code> and <code>1</code>. |-| Hex| <texcode>\definecolor[...][h=...]</texcode> For example,<texcode>\definecolor[lime][h=BFFF00] This is \color[lime]{a new color}that we defined</texcode>| The value for <code>x</ttcode>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][g=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).|}
For example{|| width="45%"| <cmd>definespotcolor</cmd><tttexcode>\usecolors[xwi]\definecolor[highlight][MyBlueTintyellow]\defineframed [PantoneTwoNineFourimportant] [plocation=low, frame=.2off, background=color, backgroundcolor=highlight]</tt>
</texcode>
| width="10%"|
| width="45%"| <context mode=mkiv>\usecolors[xwi]
\definecolor[highlight][yellow]
\defineframed[important][location=low, frame=off,
background=color, backgroundcolor=highlight]
<texcode>\definecolor setupcolors[PantoneTwoNineEight] [c=.69,m=.07,y=0,k=0,etextcolor=PANTONE 298 CVdefined-color]</texcode>
</texcode>
|
|<context mode=mkiv>
\setupcolors[textcolor=blue]
\starttext
text
\stoptext
</context>
|}
For example,{| ! width="45%"| ! width="10%DocumentCustomColors: (PANTONE 298 CV)"| ! width="45%%+ (PANTONE 308 CV)"| %%CMYKCustomColor: 0.69 0.07 0 0 (PANTONE 298 CV)|- %%+ 1 0.05 0 0.47 (PANTONE 308 CV)| <texcode>\setuppapersize[A10]\setupbackgrounds[page][background=color,backgroundcolor=blue]
{| |-|<texcode>\startcolorshowcolor[bluex11]</texcode>|<context mode=mkiv>\blackrulestartTEXpage[width=3cm,height=3cm5cm]\showcolor[x11]\stopcolorstopTEXpage</context>|}
* {{cmd|showcolorcomponents}}
<texcode>\showcolorcomponents[color-1, color-2]</texcode>
For example,
{| |-|<texcode>\showcolorcomponents[red,middlered,darkred]</texcode>|<context mode=Colorizing Grayscale Pictures=mkiv>\showcolorcomponents[red,middlered,darkred]</context>|}
For example,{||-|<texcode>\setuplayout[headerstartlines\colorcomponents{red}\transparencycomponents{red}\processcolorcomponents{red}\stoplines</texcode>|<context mode=0pt,footer=0pt,width=middle,height=middle,backspace=1cm,topspace=1cm]mkiv>\startlines\colorcomponents{red}\transparencycomponents{red}\processcolorcomponents{red}\setupcolors[state=start]stoplines</context>|}
<texcode>\useexternalfigure[demodoifcolor{color-a][millname}{... if branch ..png] [object=no, width=.2\textwidth]}\useexternalfigure[demodoifcolorelse{color-b][hacker-bwname}{... if branch ...}{... else branch ..jpg][object=no, width=.2\textwidth]}</texcode>
