973
edits
Changes
no edit summary
{{Reference
|name=definecolor
}}
== [[Help:Reference|Syntax]] (autogenerated) ==
<syntax>definecolor</syntax>
== [[Help:Reference|Syntax]] ==
<table cellspacing="4" cellpadding="2" class="cmd">
</tr>
<tr valign="top" class="second">
<td class="cmd">[[Reference/enCommand/keyword:r|r]]</td> <td>[[Reference/enCommand/value:textnumber|textnumber]] red channel (RGB)</td>
</tr>
<tr valign="top" class="second">
<td class="cmd">[[Reference/enCommand/keyword:g|g]]</td> <td>[[Reference/enCommand/value:textnumber|textnumber]] green channel (RGB)</td>
</tr>
<tr valign="top" class="second">
<td class="cmd">[[Reference/enCommand/keyword:b|b]]</td> <td>[[Reference/enCommand/value:textnumber|textnumber]] blue channel (RGB)</td>
</tr>
<tr valign="top" class="second">
<td class="cmd">[[Reference/enCommand/keyword:c|c]]</td> <td>[[Reference/enCommand/value:textnumber|textnumber]] cyan channel (CMYK)</td>
</tr>
<tr valign="top" class="second">
<td class="cmd">[[Reference/enCommand/keyword:m|m]]</td> <td>[[Reference/enCommand/value:textnumber|textnumber]] magenta channel (CMYK)</td>
</tr>
<tr valign="top" class="second">
<td class="cmd">[[Reference/enCommand/keyword:y|y]]</td> <td>[[Reference/enCommand/value:textnumber|textnumber]] yellow channel (CMYK)</td>
</tr>
<tr valign="top" class="second">
<td class="cmd">[[Reference/enCommand/keyword:k|k]]</td> <td>[[Reference/enCommand/value:textnumber|textnumber]] black channel (CMYK)</td>
</tr>
<tr valign="top" class="second">
<td class="cmd">[[Reference/enCommand/keyword:s|s]]</td> <td>[[Reference/enCommand/value:textnumber|textnumber]] gray value (Grayscale), if v isn't set</td>
</tr>
<tr valign="top" class="second">
<td class="cmd">[[Reference/enCommand/keyword:h|h]]</td> <td>[[Reference/enCommand/value:textnumber|textnumber]] hue (HSB)</td>
</tr>
<tr valign="top" class="second">
<td class="cmd">[[Reference/enCommand/keyword:ts|ts]]</td> <td>[[Reference/enCommand/value:textnumber|textnumber]] saturation (HSB)</td>
</tr>
<tr valign="top" class="second">
<td class="cmd">[[Reference/enCommand/keyword:av|av]]</td> <td>[[Reference/enCommand/value:textnumber|textnumber]] brightness/value (HSB)</td>
</tr>
<tr valign="top" class="second">
<td class="cmd">[[Reference/enCommand/keyword:pt|pt]]</td> <td>[[Reference/enCommand/value:textnumber|textnumber]] transparency factor</td>
</tr>
<tr valign="top" class="second">
<td class="cmd">[[ReferenceCommand/enkeyword:a|a]]</td> <td>[[Command/value:number|number]] alternative (transparency method)</td> </tr> <tr valign="top" class="second"> <td class="cmd">[[Command/keyword:p|p]]</td> <td>[[Command/value:number|number]] spotcolor percentage</td> </tr> <tr valign="top" class="second"> <td class="cmd">[[Command/keyword:e|e]]</td> <td>[[ReferenceCommand/value:text|text]] spotcolor name</td> </tr> <tr valign="top" class="second"> <td class="cmd">[[Command/enkeyword:x|x]]</td> <td>[[Command/value:text|text]] Hexadecimal RGB value (like in HTML), only with hex module</td>
</tr>
</table>
== Description ==
<precode>\definecolor associated </code> associates a name with a color, for later use with the<code>\color command. </precode>command.
To use hexadecimal colors in mkii you need to load the proper module first:
<pretexcode>
\setupcolor[hex]
</pretexcode>
Then the colors can be specified with
<pretexcode>
\definecolor[hex-red][h=FF0000]
</pretexcode>
Regarding the key {{code|a}}, which means transparency alternative method, there are a certain number of values (actually at least 13, from 0 to 12) whose meanings can be seen from below:
<texcode>
\definetransparency [none] [0]
\definetransparency [normal] [1]
\definetransparency [multiply] [2]
\definetransparency [screen] [3]
\definetransparency [overlay] [4]
\definetransparency [softlight] [5]
\definetransparency [hardlight] [6]
\definetransparency [colordodge] [7]
\definetransparency [colorburn] [8]
\definetransparency [darken] [9]
\definetransparency [lighten] [10]
\definetransparency [difference] [11]
\definetransparency [exclusion] [12]
</texcode>
=== Defining derivative colors ===
Colors defined in terms of other colors are processed at the Lua end, unless they are direct clones. In that case, the new name is never told to Lua. That means that this does not work:
<texcode>
% direct clone, processed by TeX
\definecolor[ColorA][red]
% fails, ColorA not known to Lua
\definecolor[ColorB][.5(ColorA)]
</texcode>
Writing it as a fake fraction works.
<texcode>
% definition involves a fraction, processed by Lua.
\definecolor[ColorA][1.0(red)]
% succeeds
\definecolor[ColorB][.5(ColorA)]
</texcode>
== Example ==
<context source=yes mode=mkiv>% mode=mkiv % rgb\definecolor[bluu][r=.25, g = .1, b=1]Hey, \color[bluu]{look at that!-- Please fill } % hex%\setupcolor[hex] % needed in an example if you can --mkii only\definecolor[salmon][h=AB5757]Hey, \color[salmon]{look at that!}</context>
== See also ==
[[Category:ReferenceCommand/enColors|definecolor]]