FM / man

/usr/share/doc/libtiff-devel/html/man

Name	Size	Mode	Actions
CMakeLists.txt	3435	0644	edit dl rm
fax2ps.1.html	6463	0644	edit dl rm
fax2tiff.1.html	15703	0644	edit dl rm
HtmlDoc.cmake	2147	0644	edit dl rm
index.html	3826	0644	edit dl rm
libtiff.3tiff.html	55646	0644	edit dl rm
pal2rgb.1.html	4522	0644	edit dl rm
ppm2tiff.1.html	3836	0644	edit dl rm
raw2tiff.1.html	11353	0644	edit dl rm
tiff2bw.1.html	3835	0644	edit dl rm
tiff2pdf.1.html	11566	0644	edit dl rm
tiff2ps.1.html	13490	0644	edit dl rm
tiff2rgba.1.html	4620	0644	edit dl rm
TIFFbuffer.3tiff.html	3668	0644	edit dl rm
TIFFClose.3tiff.html	2200	0644	edit dl rm
tiffcmp.1.html	3763	0644	edit dl rm
TIFFcodec.3tiff.html	3470	0644	edit dl rm
TIFFcolor.3tiff.html	18970	0644	edit dl rm
tiffcp.1.html	14246	0644	edit dl rm
tiffcrop.1.html	30269	0644	edit dl rm
TIFFDataWidth.3tiff.html	2268	0644	edit dl rm
TIFFDeferStrileArrayWriting.3tiff.html	4022	0644	edit dl rm
tiffdither.1.html	5324	0644	edit dl rm
tiffdump.1.html	3554	0644	edit dl rm
TIFFError.3tiff.html	3176	0644	edit dl rm
TIFFFieldDataType.3tiff.html	2184	0644	edit dl rm
TIFFFieldName.3tiff.html	2129	0644	edit dl rm
TIFFFieldPassCount.3tiff.html	2618	0644	edit dl rm
TIFFFieldReadCount.3tiff.html	2826	0644	edit dl rm
TIFFFieldTag.3tiff.html	2253	0644	edit dl rm
TIFFFieldWriteCount.3tiff.html	3150	0644	edit dl rm
TIFFFlush.3tiff.html	2901	0644	edit dl rm
TIFFGetField.3tiff.html	33650	0644	edit dl rm
tiffinfo.1.html	4186	0644	edit dl rm
tiffmedian.1.html	4669	0644	edit dl rm
TIFFmemory.3tiff.html	3306	0644	edit dl rm
TIFFOpen.3tiff.html	14772	0644	edit dl rm
TIFFOpenOptions.3tiff.html	7052	0644	edit dl rm
TIFFPrintDirectory.3tiff.html	4258	0644	edit dl rm
TIFFquery.3tiff.html	5098	0644	edit dl rm
TIFFReadDirectory.3tiff.html	7557	0644	edit dl rm
TIFFReadEncodedStrip.3tiff.html	3576	0644	edit dl rm
TIFFReadEncodedTile.3tiff.html	3516	0644	edit dl rm
TIFFReadRawStrip.3tiff.html	2862	0644	edit dl rm
TIFFReadRawTile.3tiff.html	2951	0644	edit dl rm
TIFFReadRGBAImage.3tiff.html	8618	0644	edit dl rm
TIFFReadRGBAStrip.3tiff.html	7258	0644	edit dl rm
TIFFReadRGBATile.3tiff.html	8048	0644	edit dl rm
TIFFReadScanline.3tiff.html	4500	0644	edit dl rm
TIFFReadTile.3tiff.html	3646	0644	edit dl rm
TIFFRGBAImage.3tiff.html	11629	0644	edit dl rm
tiffset.1.html	3630	0644	edit dl rm
TIFFSetDirectory.3tiff.html	3429	0644	edit dl rm
TIFFSetField.3tiff.html	31189	0644	edit dl rm
TIFFsize.3tiff.html	2469	0644	edit dl rm
tiffsplit.1.html	3125	0644	edit dl rm
TIFFStrileQuery.3tiff.html	4958	0644	edit dl rm
TIFFstrip.3tiff.html	4180	0644	edit dl rm
TIFFswab.3tiff.html	3239	0644	edit dl rm
TIFFtile.3tiff.html	4867	0644	edit dl rm
TIFFWarning.3tiff.html	3136	0644	edit dl rm
TIFFWriteDirectory.3tiff.html	6273	0644	edit dl rm
TIFFWriteEncodedStrip.3tiff.html	4424	0644	edit dl rm
TIFFWriteEncodedTile.3tiff.html	4215	0644	edit dl rm
TIFFWriteRawStrip.3tiff.html	3999	0644	edit dl rm
TIFFWriteRawTile.3tiff.html	3630	0644	edit dl rm
TIFFWriteScanline.3tiff.html	6819	0644	edit dl rm
TIFFWriteTile.3tiff.html	3170	0644	edit dl rm

Edit: /usr/share/doc/libtiff-devel/html/man/TIFFcolor.3tiff.html (18970B)

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
 p { margin-top: 0; margin-bottom: 0; vertical-align: top }
 pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
 table { margin-top: 0; margin-bottom: 0; vertical-align: top }
 h1 { text-align: center }
</style>
<title>COLOR</title>

</head>
<body>

<h1 align="center">COLOR</h1>

<a href="#NAME">NAME</a> 
<a href="#SYNOPSIS">SYNOPSIS</a> 
<a href="#DESCRIPTION">DESCRIPTION</a> 
<a href="#SEE ALSO">SEE ALSO</a>

<hr>

TIFFYCbCrToRGBInit,
TIFFYCbCrtoRGB, TIFFCIELabToRGBInit, TIFFCIELabToXYZ,
TIFFXYZToRGB &minus; color conversion routines.

<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>

#include
&lt;tiffio.h&gt;

int
TIFFYCbCrToRGBInit(TIFFYCbCrToRGB *ycbcr,
float *luma, float
*refBlackWhite&quot;);&quot; 
void TIFFYCbCrtoRGB(TIFFYCbCrToRGB *ycbcr,
uint32_t Y, int32_t Cb,
int32_t Cr, uint32_t *R,
uint32_t *G, uint32_t *B
);

int
TIFFCIELabToRGBInit(TIFFCIELabToRGB *cielab,
const TIFFDisplay *display, float
*refWhite); 
void TIFFCIELabToXYZ(TIFFCIELabToRGB *cielab,
uint32_t L, int32_t a,
int32_t b, float *X, float
*Y, float *Z); 
void TIFFXYZToRGB(TIFFCIELabToRGB *cielab,
float X, float Y, float
Z&quot;,uint32_t*&quot;R,
uint32_t *G, uint32_t
*B);

<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>

TIFF supports
several color spaces for images stored in that format. There
is usually a problem of application to handle the data
properly and convert between different colorspaces for
displaying and printing purposes. To simplify this task
libtiff implements several color conversion routines itself.
In particular, these routines used in
TIFFRGBAImage(3TIFF) interface.

TIFFYCbCrToRGBInit()
used to initialize YCbCr to RGB conversion
state. Allocating and freeing of the ycbcr structure
belongs to programmer. TIFFYCbCrToRGB defined in
tiffio.h as

typedef struct
{ /* YCbCr-&gt;RGB support */ 
TIFFRGBValue* clamptab; /* range clamping table */

int*<td width="34%"></td>
<td width="-26%"></td>
<td width="15%"></td>
<td width="8%"></td>
<td width="7%"></td>
<td width="62%">

Cr_r_tab; 
int*</td></tr>
<tr valign="top" align="left">
<td width="34%"></td>
<td width="-26%"></td>
<td width="15%"></td>
<td width="8%"></td>
<td width="7%"></td>
<td width="62%">

Cb_b_tab; 
int32_t*</td></tr>
<tr valign="top" align="left">
<td width="34%"></td>
<td width="-26%"></td>
<td width="15%"></td>
<td width="8%"></td>
<td width="7%"></td>
<td width="62%">

Cr_g_tab; 
int32_t*</td></tr>
<tr valign="top" align="left">
<td width="34%"></td>
<td width="-26%"></td>
<td width="15%"></td>
<td width="8%"></td>
<td width="7%"></td>
<td width="62%">

Cb_g_tab;</td></tr>
</table>

int32_t* Y_tab; 
} TIFFYCbCrToRGB;

luma is
a float array of three values representing proportions of
the red, green and blue in luminance, Y (see section 21 of
the TIFF 6.0 specification, where the YCbCr images
discussed). TIFFTAG_YCBCRCOEFFICIENTS holds that
values in TIFF file. refBlackWhite is a float array
of 6 values which specifies a pair of headroom and footroom
image data values (codes) for each image component (see
section 20 of the TIFF 6.0 specification where the
colorinmetry fields discussed).
TIFFTAG_REFERENCEBLACKWHITE is responsible for
storing these values in TIFF file. Following code snippet
should helps to understand the the technique:

float *luma,
*refBlackWhite; 
uint16_t hs, vs;

/* Initialize
structures */ 
ycbcr = (TIFFYCbCrToRGB*)

_TIFFmalloc(TIFFroundup(sizeof(TIFFYCbCrToRGB),
sizeof(long)) </td></tr>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="92%">

+ 4*256*sizeof(TIFFRGBValue)</td></tr>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="92%">

+ 2*256*sizeof(int)</td></tr>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="92%">

+ 3*256*sizeof(int32_t));</td></tr>
</table>

if (ycbcr == NULL) { 
TIFFError(&quot;YCbCr-&gt;RGB&quot;,

&quot;No space for YCbCr-&gt;RGB conversion
state&quot;); </td></tr>
</table>

exit(0); 
}

TIFFGetFieldDefaulted(tif,
TIFFTAG_YCBCRCOEFFICIENTS, &amp;luma); 
TIFFGetFieldDefaulted(tif, TIFFTAG_REFERENCEBLACKWHITE,
&amp;refBlackWhite); 
if (TIFFYCbCrToRGBInit(ycbcr, luma, refBlackWhite) &lt;
0)

exit(0);</td></tr>
</table>

/* Start
conversion */ 
uint32_t r, g, b; 
uint32_t Y; 
int32_t Cb, Cr;

for each pixel
in image

TIFFYCbCrtoRGB(img-&gt;ycbcr, Y, Cb, Cr, &amp;r, &amp;g,
&amp;b); </td></tr>
</table>

/* Free state
structure */ 
_TIFFfree(ycbcr);

TIFFCIELabToRGBInit()
initializes the CIE L*a*b* 1976 to RGB
conversion state. TIFFCIELabToRGB defined as

#define
CIELABTORGB_TABLE_RANGE 1500

typedef struct {</td>
<td width="8%"></td>
<td width="7%"></td>
<td width="8%"></td>
<td width="8%">
</td>
<td width="46%">

/* CIE Lab 1976-&gt;RGB support */</td></tr>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
</td>
<td width="8%">

int</td>
<td width="7%">

range;</td>
<td width="8%"></td>
<td width="8%">
</td>
<td width="46%">

/* Size of conversion table */</td></tr>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="-14%"></td>
<td width="7%"></td>
<td width="8%">
</td>
<td width="8%">