Clarified language around using hex color notation, re: processing#391

Scott Murray · Scott Murray · commit ac26bf76f9b0 · 2014-04-27T19:08:33.000-07:00
diff --git a/content/api_en/color.xml b/content/api_en/color.xml
@@ -58,6 +58,8 @@ Creates colors for storing in variables of the <b>color</b> datatype. The parame
 <br/>
 Note that if only one value is provided to <b>color()</b>, it will be interpreted as a grayscale value. Add a second value, and it will be used for alpha transparency. When three values are specified, they are interpreted as either RGB or HSB values. Adding a fourth value applies alpha transparency.<br/>
 <br/>
+Note that the <b>color()</b> function is not necessary when using hexadecimal notation, as in: <b>color c = #006699</b><br/>
+<br/>
 More about how colors are stored can be found in the reference for the <a href="color_datatype.html">color</a> datatype.
 ]]></description>
 
diff --git a/content/api_en/include/color_datatype.xml b/content/api_en/include/color_datatype.xml
@@ -27,11 +27,11 @@ Datatype for storing color values. Colors may be assigned with <b>get()</b> and
 <br/> <br/>
 Using <b>print()</b> or <b>println()</b> on a color will produce strange results (usually negative numbers) because of the way colors are stored in memory. A better technique is to use the <b>hex()</b> function to format the color data, or use the <b>red()</b>, <b>green()</b>, and <b>blue()</b> functions to get individual values and print those. The <b>hue()</b>, <b>saturation()</b>, and <b>brightness()</b> functions work in a similar fashion. To extract red, green, and blue values more quickly (for instance when analyzing an image or a frame of video), use <a href="rightshift.html">bit shifting</a>.
 <br/> <br/>
-Values can also be created using web color notation. For example, "color c = #006699".
+Values can also be created using web color notation. For example: <b>color c = #006699</b>
 <br/> <br/>
-Web color notation only works for opaque colors. To define a color with an alpha value, you can either use the <b>color()</b> function, or use hexadecimal notation. For hex notation, prefix the values with "0x", for instance "color c = 0xCC006699". In that example, CC (the hex value of 204) is the alpha value, and the remainder is identical to a web color. Note the alpha value is first in the hexadecimal notation (but last when used with the <b>color()</b> function, or functions like <b>fill()</b> and <b>stroke()</b>).
+Web color notation only works for opaque colors. To define a color with an alpha value, you can either use the <b>color()</b> function, or use hexadecimal notation. For hex notation, prefix the values with <b>0x</b>, for instance <b>color c = 0xCC006699</b>. In that example, <b>CC</b> (the hex value of 204) is the alpha value, and the remainder is identical to a web color. Note that in hexadecimal notation, the alpha value appears in the first position. (It appears last when used with functions like <b>color()</b>, <b>fill()</b>, and <b>stroke()</b>.) The following is an equivalent way of writing the preceding example, but using the <b>color()</b> function, and specifying the alpha value as its second parameter: <b>color c = color(#006699, 191)</b>
 <br/> <br/>
-From a technical standpoint, colors are 32 bits of information ordered as AAAAAAAARRRRRRRRGGGGGGGGBBBBBBBB where the A's contain the alpha value, the R's are the red value, G's are green, and B's are blue. Each component is 8 bits (a number between 0 and 255). These values can be manipulated with <a href="rightshift.html">bit shifting</a>.
+From a technical standpoint, colors are 32 bits of information ordered as <b>AAAAAAAARRRRRRRRGGGGGGGGBBBBBBBB</b> where the A's contain the alpha value, the R's are the red value, G's are green, and B's are blue. Each component is 8 bits (a number between 0 and 255). These values can be manipulated with <a href="rightshift.html">bit shifting</a>.
 ]]></description>
 
 </root>
