target/targen
Summary
Generate a profiling test target values .ti1 file. targen is used to generate
the device channel test point values for grayscale, RGB, CMY, CMYK or N-color
output or display devices.
[ Note though that colprof will only create RGB, CMY or CMYK profiles. ]
Usage Summary
targen [options] outfile
-v [level] Verbose mode [optional verbose level, 1..n]
-d col_comb choose colorant combination from the following:
0: Print grey
1: Video grey
2: Print RGB
3: Video RGB
4: CMYK
5: CMY
6: CMYK + Light CM
7: CMYK + Light CMK
8: CMYK + Red + Blue
9: CMYK + Orange + Green
10: CMYK + Light CMK + Light Light K
11: CMYK + Orange + Green + Light CM
12: CMYK + Light CM + Medium CM
-D colorant Add or delete colorant from combination:
0: Additive
1: Cyan
2: Magenta
3: Yellow
4: Black
5: Orange
6: Red
7: Green
8: Blue
9: White
10: Light Cyan
11: Light Magenta
12: Light Yellow
13: Light Black
14: Medium Cyan
15: Medium Magenta
16: Medium Yellow
17: Medium Black
18: Light Light Black
-G Generate good optimzed points rather than Fast
-e patches White color test patches (default 4)
-B patches Black test patches (default 4 Grey/RGB, else 0)
-s steps Single channel steps (default 0)
-g steps Gray axis RGB or CMY steps (default 0)
-m steps Multidimensional device space cube steps (default 0)
-b steps Multidimensional body centered cubic steps (default 0)
-f patches Add iterative & adaptive full spread patches to total
(default 836)
Default is Optimised Farthest Point Sampling (OFPS)
-t Use incremental far point for full spread
-r Use device space random for full spread
-R Use perceptual space random for full spread
-q Use device space-filling quasi-random for full spread
-Q Use perceptual space-filling quasi-random for full spread
-i Use device space body centered cubic grid for full spread
-I Use perceptual space body centered cubic grid for full
spread
-a angle Simplex grid angle 0.0 - 0.5 for B.C.C. grid, default
0.333300
-A adaptation Degree of adaptation of OFPS 0.0 - 1.0 (default 0.1, 1.0
if -c profile provided)
-t Use incremental far point for full spread (default iterative)
-l ilimit Total ink limit in %(default = none, or estimated from profile)
-p power Optional power-like value applied to all device values.
-c profile Optional device ICC or MPP pre-conditioning profile filename
-N nemphasis Degree of neutral axis patch concentration 0-1. (default 0.50)
-V demphasis dark region patch concentration 1.0-4.0 (default 1.0 = none)
-F L,a,b,rad Filter out samples outside Lab sphere.
-O Don't re-order display RGB patches for minimum delay
-U Don't filter out duplicate patches
-w Dump diagnostic outfile.x3d.html file (Lab locations)
-W Dump diagnostic outfile.x3d.html file (Device locations)
outfile Base name for output(.ti1)
Usage Details and Discussion
The number of target patches needs to be chosen, depending on the media size,
the type of device, and the quality of profile required. For an inkjet device,
something like 3000 test points or more is desirable for high quality profiles,
while 500-1000 will probably suffice for a medium quality profile. A few
hundred may be sufficient for a preliminary profile. Well behaved printing
devices (such as a chemical proof, or a high quality printing press) may
produce good profiles with 1000 to 2000 test points. Well behaved RGB devices
such as CRT monitors may need only a few hundred points, if a shaper/matrix
type profile is to be produced, while pseudo RGB printers, or other RGB devices
that a CLUT type profile may be used with, should probably choose somewhere
between 500 and 3000 patches. For 'N' color profile creation, 3000 or more test
points should probably be used.
The -v flag turns on extra verbosity when generating patch values. Extra
diagnostics and verbosity may be available if a parameter is provided with a
value greater than 1.
The -d parameter sets the colorspace the test values will be generated in.
Video gray space is assumed to be an additive space, where a zero device value
will be black, and a maximum device value will be white. A print gray space is
assumed to be a subtractive space, in which a zero device value will be white,
and a maximum device value will be black. If no colorspace is specified,
subtractive CMYK is assumed as a default.
The -D parameter modifies the colorspace set by -d by allowing individual
colorants to be added or subtracted from the colorspace.
how this working with other commands?and the function is?
The -G flag changes the Incremental Far Point Distribution algorithm from fast
to good mode. Fast mode uses a limited number of iterations to optimize the
patch locations, while good mode strives for a more even patch distribution by
using more iterations.
The composition of the test patches is controlled by the following flags and
parameters:
The -e parameter sets the number of white colored test patches, defaulting to 4
if the -e flag isn't used. The white patches are usually very important in
establishing white point that the ICC data is made relative to, so it improves
robustness to use more than a single point.
what do -e do while i am using ?
The -B parameter sets the number of black colored test patches, defaulting to 4
if the -B flag isn't used and the colorspace is grey or RGB. The black point
can be very important for characterizing additive color spaces, so measuring
more than one black patch improves robustness over measuring just a single
point.
didnot quiet get what it do when using
The -s parameter sets the number of patches in a set of per colorant wedges.
The steps are evenly spaced in device space by default, and the total number of
test patches will be the number of colorants times the value specified with the
-s flag. If the -p parameter is provided, then, then the steps will be
distributed according to the power value. e.g. the option -s 5 will generate
steps at 0.0 0.25 0.5 0.75 and 1.0, while the option -s 5 -p 2.0 will generate
steps at 0.0 0.0625 0.25 0.5625 and 1.0. By default, no per colorant test wedge
values are generated. When creating a test chart for a device that will be used
as a source colorspace, it is often useful to generated some per colorant wedge
values.
The -g parameter sets the number of patches in a set of combined (nominally
gray) wedges. This will typically be equal RGB or CMY values, and by default
will be equally spaced steps in device space. If the -p parameter is provided,
then, then the steps will be distributed according to the power value. e.g. the
option -g 5 will generate steps at 0.0 0.25 0.5 0.75 and 1.0, while the option
-g 5 -p 2.0 will generate steps at 0.0 0.0625 0.25 0.5625 and 1.0. By default,
no gray combination values are generated. When creating a test chart for a
device that will be used as a source colorspace, it is often useful to
generated some per colorant wedge values.
The -m parameter sets the edge size of the multidimensional grid of test
values. The total number of patches of this type will be the -m parameter value
to the power of the number of colorants. The grid steps are evenly spaced in
device space by default, but if the -p parameter is provided, then, then the
steps will be distributed according to the power value. e.g. the option -m 5
will generate steps at 0.0 0.25 0.5 0.75 and 1.0, while the option -m 5 -p 2.0
will generate steps at 0.0 0.0625 0.25 0.5625 and 1.0. By default, all the
device primary color combinations that fall within the ink limit are generated..
The -b parameter sets the outer edge size of the multidimensional body centered
grid of test values. The total number of patches of this type will be the -b
parameter value to the power of the number of colorants plus the (number-1) to
the power of the number of colorants. The grid steps are evenly spaced in
device space by default, but if the -p parameter is provided, then, then the
steps will be distributed according to the power value. A body centered grid is
a regular grid (see -m) with another smaller regular grid within it, at the
centers of the outer grid. This grid arrangement is more space efficient than a
regular grid (ie. for a given number of test points, it fills the space better.)
what do -s -g -m -b do? and what's the difference between those parameters?
The behavior of the -e, -s, -g -m and -b flags, is not to duplicate test values
already created by a previous type.
The -f parameter sets the number of full spread test patches. Full spread
patches are distributed according to the default or chosen algorithm. The
default algorithm will optimize the point locations to minimize the distance
from any point in device space, to the nearest sample point. This is called
Optimized Farthest Point Sampling (OFPS) . This can be overridden by specifying
the -t. -r, -R, -q, -i or -I flags. If the default OFPS algorithm is used, then
adaptive test point distribution can be fully enabled by supplying a previous
or typical profile with the -c option. The total number patches specified will
include any patches generated using the -e, -s, -g -m and -b flags (i.e. full
spread patches will be added to bring the total number of patches including
those generated using the -e, -s, -g-m and -b flags up to the specified
number). When there are more than four device channels, the full spread
distribution algorithm can't deal with so many dimensions, and targen falls
back on an incremental far point distribution algorithm by default, that
doesn't generate such evenly spread points. This behaviour can be forced using
the -t flag. A table of useful total patch counts for different paper sizes is
shown below. Note that it's occasionally the case that the OFPS algorithm will
fail to complete, or make very slow progress if the -c profile is poor,
non-smooth, or has unusual behaviour. In these cases a different algorithm
should be chosen (ie. -Q or -I), or perhaps a smoother or lower resolution
("quality") previous profile may overcome the problem.
The -t flag overrides the default full spread test patch algorithm, and makes
use of the Incremental Far Point Distribution algorithm, which incrementally
searches for test points that are as far away as possible from any existing
points. This is used as the default for dimensions higher than 4.
The -r flag overrides the default full spread test patch algorithm, and chooses
test points with an even random distribution in device space.
The -R flag overrides the default full spread test patch algorithm, and chooses
test points with an even random distribution in perceptual space.
The -q flag overrides the default full spread test patch algorithm, and chooses
test points with a quasi-random, space filling distribution in device space.
The -Q flag overrides the default full spread test patch algorithm, and chooses
test points with a quasi-random, space filling distribution in perceptual space.
The -i flag overrides the default full spread test patch algorithm, and chooses
test points with body centered cubic distribution in device space.
The -I flag overrides the default full spread test patch algorithm, and chooses
test points with body centered cubic distribution in perceptual space.
The -a angle parameter sets the overall angle that the body centered grid
distribution has.
what is the parameters function and what will they do to the OFPS algorithm?
BTW:i am a chinese user with poor english unstanding so please help me with
patience thx a lot ! :)