diff options
author | Jörg Frings-Fürst <debian@jff-webhosting.net> | 2014-09-01 13:56:46 +0200 |
---|---|---|
committer | Jörg Frings-Fürst <debian@jff-webhosting.net> | 2014-09-01 13:56:46 +0200 |
commit | 22f703cab05b7cd368f4de9e03991b7664dc5022 (patch) | |
tree | 6f4d50beaa42328e24b1c6b56b6ec059e4ef21a5 /doc/viewgam.html |
Initial import of argyll version 1.5.1-8debian/1.5.1-8
Diffstat (limited to 'doc/viewgam.html')
-rw-r--r-- | doc/viewgam.html | 125 |
1 files changed, 125 insertions, 0 deletions
diff --git a/doc/viewgam.html b/doc/viewgam.html new file mode 100644 index 0000000..0bf5c04 --- /dev/null +++ b/doc/viewgam.html @@ -0,0 +1,125 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> + <title>viewgam</title> + <meta http-equiv="content-type" + content="text/html; charset=ISO-8859-1"> + <meta name="author" content="Graeme Gill"> +</head> +<body> +<h2><b>gamut/viewgam</b></h2> +<h3>Summary</h3> +Convert one or more gamuts into a <a href="File_Formats.html#VRML">VRML</a> +3D visualization +file. This allows visual comparison of several gamut surfaces.<br> +Also allows creating the intersection (overlap) between two gamuts. +This is useful in measuring and visualizing the coverage of one gamut +of another.<br> +<h3>Usage<br> +</h3> +<small><span style="font-family: monospace;">viewgam { [-c color] [-t +trans] [-w|s] </span><span + style="font-style: italic; font-family: monospace;">infile.gam</span><span + style="font-family: monospace;"> } ... </span><span + style="font-style: italic; font-family: monospace;">outfile.wrl</span><br + style="font-family: monospace;"> +<span style="font-family: monospace;"> +For each input gamut file:</span><br style="font-family: monospace;"> +<span style="font-family: monospace;"> -c </span><i + style="font-family: monospace;">color</i><span + style="font-family: monospace;"> +Color +to +make gamut, +r = red, g = green, b = blue</span><br style="font-family: monospace;"> +<span style="font-family: monospace;"> + +c = cyan, m = magenta, y = yellow, w = white</span><br + style="font-family: monospace;"> +<span style="font-family: monospace;"> +n = natural color</span><br style="font-family: monospace;"> +<span style="font-family: monospace;"> -t </span><i + style="font-family: monospace;">trans</i><span + style="font-family: monospace;"> +Set +transparency +from 0.0 (opaque) to 1.0 (invisible)</span><br + style="font-family: monospace;"> +<span style="font-family: monospace;"> -w +Show as a wireframe</span><br style="font-family: monospace;"> +<span style="font-family: monospace;"> -s +Show as a solid surface</span><br style="font-family: monospace;"> +<i style="font-family: monospace;"> infile.gam</i><span + style="font-family: monospace;"> Name +of </span><i style="font-family: monospace;">infile</i><a + style="font-family: monospace;" href="File_Formats.html#.gam">.gam</a><span + style="font-family: monospace;"> file</span><br + style="font-family: monospace;"> +<br style="font-family: monospace;"> +<span style="font-family: monospace;"> -n +Don't add Lab axes<br> + -i Compute +and print intersecting volume of first 2 gamuts<br> + -I isect.gam Same as -i, but save intersection gamut +to isect.gam<br style="font-family: monospace;"> +</span><span style="font-family: monospace;"> </span><i + style="font-family: monospace;">outfile.wrl</i><span + style="font-family: monospace;"> Name of output +</span><i style="font-family: monospace;">outfile.wrl</i><span + style="font-family: monospace;"> file</span></small> +<br> +<h3>Usage Details and Discussion</h3> +<b>viewgam</b> creates a VRML file that allows the viewing and +comparing +of multiple gamut files by representing them as solid surfaces, +wireframes, +etc. It takes as input a list of gamut files, each file preceded by any +options that are to apply to the display of that particular +gamut. +<br> +<br> +The options that can be specified for each input gamut are:<br> +<br> +<b>-c</b> <i>color</i> allows the color of the surface or wireframe to +be +specified. Any of a number of predefined colors (red, green, blue, +cyan, +magenta, yellow, white) can be used, as well as allowing the color to +reflect +the natural color of that point in the colorspace.<br> +<br> +<b>-t</b> <i>trans</i> allows the transparency of the surface to +be +specified. A value of 0.2 might be a good place to start. Using +transparency +generally leads to a slower display than the default opaque surface +treatment, but can make it possible to see within a solid gamut surface.<br> +<br> +<b>-w</b> forces the gamut surface to be rendered as a wireframe.<br> +<br> +<b>-s</b> forces the gamut surface to be rendered as a solid surface.<br> +<br> +By default, the first gamut is treated as a solid with natural +coloring, +with the second and subsequent gamuts being wireframes with colors of +white, +red, cyan, yellow, green and blue, with decreasing visibility.<br> +<br> +The <b>-n</b> flag turns off display of the default L*a*b* axes in the +output.<br> +<br> +The <span style="font-weight: bold;">-i</span> flag computes the +intersecting volume of the first two gamuts (in cubic color units, +usually L*a*b*), as well as the volumes of the two gamuts and the +percentage the intersection is of the two gamuts. This is a useful +measure of the coverage one gamut has of another. If <span + style="font-weight: bold;">-I</span> is used, then as well as printing +the volume, the intersecting gamut will be saved to the <span + style="font-style: italic;">isect.gam</span> file.<br> +<br> +The final argument is the name of the VRML file to save the resulting +composite +3D visualization file to.<br> +<br> +</body> +</html> |