176 lines
7.0 KiB
HTML
Executable File
176 lines
7.0 KiB
HTML
Executable File
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<title>viewgam</title>
|
|
<meta http-equiv="content-type" content="text/html;
|
|
charset=windows-1252">
|
|
<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#X3DOM">X3DOM</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>
|
|
<br>
|
|
See <a href="3dformat.html">3D Viewing Format</a> for switching to
|
|
VRML or X3D output format.<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.x3d.html</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>
|
|
-o
|
|
|
|
Print & plot points on first gamut that are outside second
|
|
gamut<br style="font-family: monospace;">
|
|
</span><span style="font-family: monospace;"> </span><i
|
|
style="font-family: monospace;">outfile </i><span
|
|
style="font-family: monospace;"><i> </i>Base
|
|
|
|
|
|
|
|
name of output </span><i style="font-family: monospace;">outfile.x3d.html</i><span
|
|
style="font-family: monospace;"> file</span></small> <br>
|
|
<h3>Usage Details and Discussion</h3>
|
|
<b>viewgam</b> creates a X3DOM 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 <span style="font-weight: bold;">-o</span> flag checks points
|
|
on the surface of the first gamut, and prints them out if they are
|
|
outside the second gamut. The delta E outside the second gamut is
|
|
printed first in square brackets. It also creates a visualization
|
|
file outfile_oog.x3d.html of the portion of the first gamut that is
|
|
outside the second.<br>
|
|
<br>
|
|
The final argument is the base name of the X3DOM file to save the
|
|
resulting composite 3D visualization file to. If the name given
|
|
doesn't have an extension, one will be automatically added.<br>
|
|
<br>
|
|
</body>
|
|
</html>
|