libtiff.3tiff.html 24 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150
  1. <!-- Creator : groff version 1.18.1 -->
  2. <!-- CreationDate: Sat Feb 24 18:37:20 2007 -->
  3. <html>
  4. <head>
  5. <meta name="generator" content="groff -Thtml, see www.gnu.org">
  6. <meta name="Content-Style" content="text/css">
  7. <title>INTRO</title>
  8. </head>
  9. <body>
  10. <h1 align=center>INTRO</h1>
  11. <a href="#NAME">NAME</a><br>
  12. <a href="#SYNOPSIS">SYNOPSIS</a><br>
  13. <a href="#DESCRIPTION">DESCRIPTION</a><br>
  14. <a href="#DATA TYPES">DATA TYPES</a><br>
  15. <a href="#LIST OF ROUTINES">LIST OF ROUTINES</a><br>
  16. <a href="#TAG USAGE">TAG USAGE</a><br>
  17. <a href="#PSEUDO TAGS">PSEUDO TAGS</a><br>
  18. <a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
  19. <a href="#SEE ALSO">SEE ALSO</a><br>
  20. <a href="#BUGS">BUGS</a><br>
  21. <hr>
  22. <a name="NAME"></a>
  23. <h2>NAME</h2>
  24. <!-- INDENTATION -->
  25. <table width="100%" border=0 rules="none" frame="void"
  26. cols="2" cellspacing="0" cellpadding="0">
  27. <tr valign="top" align="left">
  28. <td width="8%"></td>
  29. <td width="91%">
  30. <p><big>libtiff &minus; introduction to <i>libtiff</i>, a
  31. library for reading and writing</big> TIFF
  32. <big>files</big></p>
  33. </td>
  34. </table>
  35. <a name="SYNOPSIS"></a>
  36. <h2>SYNOPSIS</h2>
  37. <!-- INDENTATION -->
  38. <table width="100%" border=0 rules="none" frame="void"
  39. cols="2" cellspacing="0" cellpadding="0">
  40. <tr valign="top" align="left">
  41. <td width="8%"></td>
  42. <td width="91%">
  43. <p><big><b>#include &lt;tiffio.h&gt;</b></big></p>
  44. <!-- INDENTATION -->
  45. <p><big>cc file.c <b>-ltiff</b></big></p>
  46. </td>
  47. </table>
  48. <a name="DESCRIPTION"></a>
  49. <h2>DESCRIPTION</h2>
  50. <!-- INDENTATION -->
  51. <table width="100%" border=0 rules="none" frame="void"
  52. cols="2" cellspacing="0" cellpadding="0">
  53. <tr valign="top" align="left">
  54. <td width="8%"></td>
  55. <td width="91%">
  56. <p><big><i>libtiff</i> is a library for reading and writing
  57. data files encoded with the <i>Tag Image File</i> format,
  58. Revision 6.0 (or revision 5.0 or revision 4.0). This file
  59. format is suitable for archiving multi-color and
  60. monochromatic image data.</big></p>
  61. <!-- INDENTATION -->
  62. <p><big>The library supports several compression algorithms,
  63. as indicated by the <i>Compression</i> field, including: no
  64. compression (1),</big> CCITT <big>1D Huffman compression
  65. (2),</big> CCITT <big>Group 3 Facsimile compression
  66. (3),</big> CCITT <big>Group 4 Facsimile compression (4),
  67. Lempel-Ziv &amp; Welch compression (5), baseline JPEG
  68. compression (7), word-aligned 1D Huffman compression
  69. (32771), and PackBits compression (32773). In addition,
  70. several nonstandard compression algorithms are supported:
  71. the 4-bit compression algorithm used by the
  72. <i>ThunderScan</i> program (32809) (decompression only),
  73. NeXT&rsquo;s 2-bit compression algorithm (32766)
  74. (decompression only), an experimental LZ-style algorithm
  75. known as Deflate (32946), and an experimental CIE LogLuv
  76. compression scheme designed for images with high dynamic
  77. range (32845 for LogL and 32845 for LogLuv). Directory
  78. information may be in either little- or big-endian byte
  79. order&minus;byte swapping is automatically done by the
  80. library. Data bit ordering may be either Most Significant
  81. Bit (</big> MSB <big>) to Least Significant Bit (</big> LSB
  82. <big>) or</big> LSB <big>to</big> MSB. <big>Finally, the
  83. library does not support files in which the
  84. <i>BitsPerSample</i>, <i>Compression</i>,
  85. <i>MinSampleValue</i>, or <i>MaxSampleValue</i> fields are
  86. defined differently on a per-sample basis (in Rev. 6.0 the
  87. <i>Compression</i> tag is not defined on a per-sample basis,
  88. so this is immaterial).</big></p>
  89. </td>
  90. </table>
  91. <a name="DATA TYPES"></a>
  92. <h2>DATA TYPES</h2>
  93. <!-- INDENTATION -->
  94. <table width="100%" border=0 rules="none" frame="void"
  95. cols="2" cellspacing="0" cellpadding="0">
  96. <tr valign="top" align="left">
  97. <td width="8%"></td>
  98. <td width="91%">
  99. <p><big>The library makes extensive use of C typedefs to
  100. promote portability. Two sets of typedefs are used, one for
  101. communication with clients of the library and one for
  102. internal data structures and parsing of the</big> TIFF
  103. <big>format. The following typedefs are exposed to users
  104. either through function definitions or through parameters
  105. passed through the varargs interfaces.</big></p></td>
  106. </table>
  107. <!-- TABS -->
  108. <table width="100%" border=0 rules="none" frame="void"
  109. cols="3" cellspacing="0" cellpadding="0">
  110. <tr valign="top" align="left">
  111. <td width="15%"></td>
  112. <td width="46%">
  113. <p><big>typedef unsigned short uint16_t;</big></p>
  114. </td>
  115. <td width="38%">
  116. <p><big>16-bit unsigned integer</big></p>
  117. </td>
  118. <tr valign="top" align="left">
  119. <td width="15%"></td>
  120. <td width="46%">
  121. <p><big>typedef unsigned &lt;<i>thing</i>&gt;
  122. uint32_t;</big></p>
  123. </td>
  124. <td width="38%">
  125. <p><big>32-bit unsigned integer</big></p>
  126. </td>
  127. <tr valign="top" align="left">
  128. <td width="15%"></td>
  129. <td width="46%">
  130. <p><big>typedef unsigned int ttag_t;</big></p>
  131. </td>
  132. <td width="38%">
  133. <p><big>directory tag</big></p>
  134. </td>
  135. <tr valign="top" align="left">
  136. <td width="15%"></td>
  137. <td width="46%">
  138. <p><big>typedef uint16_t tdir_t;</big></p>
  139. </td>
  140. <td width="38%">
  141. <p><big>directory index</big></p>
  142. </td>
  143. <tr valign="top" align="left">
  144. <td width="15%"></td>
  145. <td width="46%">
  146. <p><big>typedef uint16_t tsample_t;</big></p>
  147. </td>
  148. <td width="38%">
  149. <p><big>sample number</big></p>
  150. </td>
  151. <tr valign="top" align="left">
  152. <td width="15%"></td>
  153. <td width="46%">
  154. <p><big>typedef uint32_t tstrip_t;</big></p>
  155. </td>
  156. <td width="38%">
  157. <p><big>strip number</big></p>
  158. </td>
  159. <tr valign="top" align="left">
  160. <td width="15%"></td>
  161. <td width="46%">
  162. <p><big>typedef uint32_t ttile_t;</big></p>
  163. </td>
  164. <td width="38%">
  165. <p><big>tile number</big></p>
  166. </td>
  167. <tr valign="top" align="left">
  168. <td width="15%"></td>
  169. <td width="46%">
  170. <p><big>typedef int32_t tsize_t;</big></p>
  171. </td>
  172. <td width="38%">
  173. <p><big>i/o size in bytes</big></p>
  174. </td>
  175. <tr valign="top" align="left">
  176. <td width="15%"></td>
  177. <td width="46%">
  178. <p><big>typedef void* tdata_t;</big></p>
  179. </td>
  180. <td width="38%">
  181. <p><big>image data ref</big></p>
  182. </td>
  183. <tr valign="top" align="left">
  184. <td width="15%"></td>
  185. <td width="46%">
  186. <p><big>typedef void* thandle_t;</big></p>
  187. </td>
  188. <td width="38%">
  189. <p><big>client data handle</big></p>
  190. </td>
  191. <tr valign="top" align="left">
  192. <td width="15%"></td>
  193. <td width="46%">
  194. <p><big>typedef int32_t toff_t;</big></p>
  195. </td>
  196. <td width="38%">
  197. <p><big>file offset</big></p>
  198. </td>
  199. </table>
  200. <!-- INDENTATION -->
  201. <table width="100%" border=0 rules="none" frame="void"
  202. cols="2" cellspacing="0" cellpadding="0">
  203. <tr valign="top" align="left">
  204. <td width="8%"></td>
  205. <td width="91%">
  206. <p><big>Note that <i>tstrip_t</i>, <i>ttile_t</i>, and
  207. <i>tsize_t</i> are constrained to be no more than 32-bit
  208. quantities by 32-bit fields they are stored in in the</big>
  209. TIFF <big>image. Likewise <i>tsample_t</i> is limited by the
  210. 16-bit field used to store the <i>SamplesPerPixel</i> tag.
  211. <i>tdir_t</i> constrains the maximum number of</big> IFDs
  212. <big>that may appear in an image and may be an arbitrary
  213. size (w/o penalty). <i>ttag_t</i> must be either int,
  214. unsigned int, pointer, or double because the library uses a
  215. varargs interface and</big> ANSI C <big>restricts the type
  216. of the parameter before an ellipsis to be a promoted type.
  217. <i>toff_t</i> is defined as int32_t because TIFF file offsets
  218. are (unsigned) 32-bit quantities. A signed value is used
  219. because some interfaces return &minus;1 on error. Finally,
  220. note that user-specified data references are passed as
  221. opaque handles and only cast at the lowest layers where
  222. their type is presumed.</big></p>
  223. </td>
  224. </table>
  225. <a name="LIST OF ROUTINES"></a>
  226. <h2>LIST OF ROUTINES</h2>
  227. <!-- INDENTATION -->
  228. <table width="100%" border=0 rules="none" frame="void"
  229. cols="2" cellspacing="0" cellpadding="0">
  230. <tr valign="top" align="left">
  231. <td width="8%"></td>
  232. <td width="91%">
  233. <p><big>The following routines are part of the library.
  234. Consult specific manual pages for details on their
  235. operation; on most systems doing &lsquo;&lsquo;man
  236. function-name&rsquo;&rsquo; will work.</big></p></td>
  237. </table>
  238. <!-- TABS -->
  239. <p><big><i>Name Description</i></big></p>
  240. <!-- TABS -->
  241. <table width="100%" border=0 rules="none" frame="void"
  242. cols="3" cellspacing="0" cellpadding="0">
  243. <tr valign="top" align="left">
  244. <td width="8%"></td>
  245. <td width="23%">
  246. <p><big>TIFFCheckpointDirectory</big></p>
  247. </td>
  248. <td width="67%">
  249. <p><big>writes the current state of the directory</big></p>
  250. </td>
  251. <tr valign="top" align="left">
  252. <td width="8%"></td>
  253. <td width="23%">
  254. <p><big>TIFFCheckTile</big></p>
  255. </td>
  256. <td width="67%">
  257. <p><big>very x,y,z,sample is within image</big></p>
  258. </td>
  259. <tr valign="top" align="left">
  260. <td width="8%"></td>
  261. <td width="23%">
  262. <p><big>TIFFCIELabToRGBInit</big></p>
  263. </td>
  264. <td width="67%">
  265. <p><big>initialize CIE L*a*b* 1976 to RGB conversion
  266. state</big></p>
  267. </td>
  268. <tr valign="top" align="left">
  269. <td width="8%"></td>
  270. <td width="23%">
  271. <p><big>TIFFCIELabToXYZ</big></p>
  272. </td>
  273. <td width="67%">
  274. <p><big>perform CIE L*a*b* 1976 to CIE XYZ
  275. conversion</big></p>
  276. </td>
  277. <tr valign="top" align="left">
  278. <td width="8%"></td>
  279. <td width="23%">
  280. <p><big>TIFFClientOpen</big></p>
  281. </td>
  282. <td width="67%">
  283. <p><big>open a file for reading or writing</big></p>
  284. </td>
  285. <tr valign="top" align="left">
  286. <td width="8%"></td>
  287. <td width="23%">
  288. <p><big>TIFFClose</big></p>
  289. </td>
  290. <td width="67%">
  291. <p><big>close an open file</big></p>
  292. </td>
  293. <tr valign="top" align="left">
  294. <td width="8%"></td>
  295. <td width="23%">
  296. <p><big>TIFFComputeStrip</big></p>
  297. </td>
  298. <td width="67%">
  299. <p><big>return strip containing y,sample</big></p>
  300. </td>
  301. <tr valign="top" align="left">
  302. <td width="8%"></td>
  303. <td width="23%">
  304. <p><big>TIFFComputeTile</big></p>
  305. </td>
  306. <td width="67%">
  307. <p><big>return tile containing x,y,z,sample</big></p>
  308. </td>
  309. <tr valign="top" align="left">
  310. <td width="8%"></td>
  311. <td width="23%">
  312. <p><big>TIFFCurrentDirectory</big></p>
  313. </td>
  314. <td width="67%">
  315. <p><big>return index of current directory</big></p>
  316. </td>
  317. <tr valign="top" align="left">
  318. <td width="8%"></td>
  319. <td width="23%">
  320. <p><big>TIFFCurrentRow</big></p>
  321. </td>
  322. <td width="67%">
  323. <p><big>return index of current scanline</big></p>
  324. </td>
  325. <tr valign="top" align="left">
  326. <td width="8%"></td>
  327. <td width="23%">
  328. <p><big>TIFFCurrentStrip</big></p>
  329. </td>
  330. <td width="67%">
  331. <p><big>return index of current strip</big></p>
  332. </td>
  333. <tr valign="top" align="left">
  334. <td width="8%"></td>
  335. <td width="23%">
  336. <p><big>TIFFCurrentTile</big></p>
  337. </td>
  338. <td width="67%">
  339. <p><big>return index of current tile</big></p>
  340. </td>
  341. <tr valign="top" align="left">
  342. <td width="8%"></td>
  343. <td width="23%">
  344. <p><big>TIFFDataWidth</big></p>
  345. </td>
  346. <td width="67%">
  347. <p><big>return the size of TIFF data types</big></p>
  348. </td>
  349. <tr valign="top" align="left">
  350. <td width="8%"></td>
  351. <td width="23%">
  352. <p><big>TIFFError</big></p>
  353. </td>
  354. <td width="67%">
  355. <p><big>library error handler</big></p>
  356. </td>
  357. <tr valign="top" align="left">
  358. <td width="8%"></td>
  359. <td width="23%">
  360. <p><big>TIFFFdOpen</big></p>
  361. </td>
  362. <td width="67%">
  363. <p><big>open a file for reading or writing</big></p>
  364. </td>
  365. <tr valign="top" align="left">
  366. <td width="8%"></td>
  367. <td width="23%">
  368. <p><big>TIFFFileName</big></p>
  369. </td>
  370. <td width="67%">
  371. <p><big>return name of open file</big></p>
  372. </td>
  373. <tr valign="top" align="left">
  374. <td width="8%"></td>
  375. <td width="23%">
  376. <p><big>TIFFFileno</big></p>
  377. </td>
  378. <td width="67%">
  379. <p><big>return open file descriptor</big></p>
  380. </td>
  381. <tr valign="top" align="left">
  382. <td width="8%"></td>
  383. <td width="23%">
  384. <p><big>TIFFFindCODEC</big></p>
  385. </td>
  386. <td width="67%">
  387. <p><big>find standard codec for the specific
  388. scheme</big></p>
  389. </td>
  390. <tr valign="top" align="left">
  391. <td width="8%"></td>
  392. <td width="23%">
  393. <p><big>TIFFFlush</big></p>
  394. </td>
  395. <td width="67%">
  396. <p><big>flush all pending writes</big></p>
  397. </td>
  398. <tr valign="top" align="left">
  399. <td width="8%"></td>
  400. <td width="23%">
  401. <p><big>TIFFFlushData</big></p>
  402. </td>
  403. <td width="67%">
  404. <p><big>flush pending data writes</big></p>
  405. </td>
  406. <tr valign="top" align="left">
  407. <td width="8%"></td>
  408. <td width="23%">
  409. <p><big>TIFFGetBitRevTable</big></p>
  410. </td>
  411. <td width="67%">
  412. <p><big>return bit reversal table</big></p>
  413. </td>
  414. <tr valign="top" align="left">
  415. <td width="8%"></td>
  416. <td width="23%">
  417. <p><big>TIFFGetField</big></p>
  418. </td>
  419. <td width="67%">
  420. <p><big>return tag value in current directory</big></p>
  421. </td>
  422. <tr valign="top" align="left">
  423. <td width="8%"></td>
  424. <td width="23%">
  425. <p><big>TIFFGetFieldDefaulted</big></p>
  426. </td>
  427. <td width="67%">
  428. <p><big>return tag value in current directory</big></p>
  429. </td>
  430. <tr valign="top" align="left">
  431. <td width="8%"></td>
  432. <td width="23%">
  433. <p><big>TIFFGetMode</big></p>
  434. </td>
  435. <td width="67%">
  436. <p><big>return open file mode</big></p>
  437. </td>
  438. <tr valign="top" align="left">
  439. <td width="8%"></td>
  440. <td width="23%">
  441. <p><big>TIFFGetVersion</big></p>
  442. </td>
  443. <td width="67%">
  444. <p><big>return library version string</big></p>
  445. </td>
  446. <tr valign="top" align="left">
  447. <td width="8%"></td>
  448. <td width="23%">
  449. <p><big>TIFFIsCODECConfigured</big></p>
  450. </td>
  451. <td width="67%">
  452. <p><big>check, whether we have working codec</big></p>
  453. </td>
  454. <tr valign="top" align="left">
  455. <td width="8%"></td>
  456. <td width="23%">
  457. <p><big>TIFFIsMSB2LSB</big></p>
  458. </td>
  459. <td width="67%">
  460. <p><big>return true if image data is being
  461. returned</big></p>
  462. </td>
  463. <tr valign="top" align="left">
  464. <td width="8%"></td>
  465. <td width="23%"></td>
  466. <td width="67%">
  467. <p><big>with bit 0 as the most significant bit</big></p>
  468. </td>
  469. <tr valign="top" align="left">
  470. <td width="8%"></td>
  471. <td width="23%">
  472. <p><big>TIFFIsTiled</big></p>
  473. </td>
  474. <td width="67%">
  475. <p><big>return true if image data is tiled</big></p>
  476. </td>
  477. <tr valign="top" align="left">
  478. <td width="8%"></td>
  479. <td width="23%">
  480. <p><big>TIFFIsByteSwapped</big></p>
  481. </td>
  482. <td width="67%">
  483. <p><big>return true if image data is byte-swapped</big></p>
  484. </td>
  485. <tr valign="top" align="left">
  486. <td width="8%"></td>
  487. <td width="23%">
  488. <p><big>TIFFNumberOfStrips</big></p>
  489. </td>
  490. <td width="67%">
  491. <p><big>return number of strips in an image</big></p>
  492. </td>
  493. <tr valign="top" align="left">
  494. <td width="8%"></td>
  495. <td width="23%">
  496. <p><big>TIFFNumberOfTiles</big></p>
  497. </td>
  498. <td width="67%">
  499. <p><big>return number of tiles in an image</big></p>
  500. </td>
  501. <tr valign="top" align="left">
  502. <td width="8%"></td>
  503. <td width="23%">
  504. <p><big>TIFFOpen</big></p>
  505. </td>
  506. <td width="67%">
  507. <p><big>open a file for reading or writing</big></p>
  508. </td>
  509. <tr valign="top" align="left">
  510. <td width="8%"></td>
  511. <td width="23%">
  512. <p><big>TIFFPrintDirectory</big></p>
  513. </td>
  514. <td width="67%">
  515. <p><big>print description of the current
  516. directory</big></p>
  517. </td>
  518. <tr valign="top" align="left">
  519. <td width="8%"></td>
  520. <td width="23%">
  521. <p><big>TIFFReadBufferSetup</big></p>
  522. </td>
  523. <td width="67%">
  524. <p><big>specify i/o buffer for reading</big></p>
  525. </td>
  526. <tr valign="top" align="left">
  527. <td width="8%"></td>
  528. <td width="23%">
  529. <p><big>TIFFReadDirectory</big></p>
  530. </td>
  531. <td width="67%">
  532. <p><big>read the next directory</big></p>
  533. </td>
  534. <tr valign="top" align="left">
  535. <td width="8%"></td>
  536. <td width="23%">
  537. <p><big>TIFFReadEncodedStrip</big></p>
  538. </td>
  539. <td width="67%">
  540. <p><big>read and decode a strip of data</big></p>
  541. </td>
  542. <tr valign="top" align="left">
  543. <td width="8%"></td>
  544. <td width="23%">
  545. <p><big>TIFFReadEncodedTile</big></p>
  546. </td>
  547. <td width="67%">
  548. <p><big>read and decode a tile of data</big></p>
  549. </td>
  550. <tr valign="top" align="left">
  551. <td width="8%"></td>
  552. <td width="23%">
  553. <p><big>TIFFReadRawStrip</big></p>
  554. </td>
  555. <td width="67%">
  556. <p><big>read a raw strip of data</big></p>
  557. </td>
  558. <tr valign="top" align="left">
  559. <td width="8%"></td>
  560. <td width="23%">
  561. <p><big>TIFFReadRawTile</big></p>
  562. </td>
  563. <td width="67%">
  564. <p><big>read a raw tile of data</big></p>
  565. </td>
  566. <tr valign="top" align="left">
  567. <td width="8%"></td>
  568. <td width="23%">
  569. <p><big>TIFFReadRGBAImage</big></p>
  570. </td>
  571. <td width="67%">
  572. <p><big>read an image into a fixed format raster</big></p>
  573. </td>
  574. <tr valign="top" align="left">
  575. <td width="8%"></td>
  576. <td width="23%">
  577. <p><big>TIFFReadScanline</big></p>
  578. </td>
  579. <td width="67%">
  580. <p><big>read and decode a row of data</big></p>
  581. </td>
  582. <tr valign="top" align="left">
  583. <td width="8%"></td>
  584. <td width="23%">
  585. <p><big>TIFFReadTile</big></p>
  586. </td>
  587. <td width="67%">
  588. <p><big>read and decode a tile of data</big></p>
  589. </td>
  590. <tr valign="top" align="left">
  591. <td width="8%"></td>
  592. <td width="23%">
  593. <p><big>TIFFRegisterCODEC</big></p>
  594. </td>
  595. <td width="67%">
  596. <p><big>override standard codec for the specific
  597. scheme</big></p>
  598. </td>
  599. <tr valign="top" align="left">
  600. <td width="8%"></td>
  601. <td width="23%">
  602. <p><big>TIFFReverseBits</big></p>
  603. </td>
  604. <td width="67%">
  605. <p><big>reverse bits in an array of bytes</big></p>
  606. </td>
  607. <tr valign="top" align="left">
  608. <td width="8%"></td>
  609. <td width="23%">
  610. <p><big>TIFFRGBAImageBegin</big></p>
  611. </td>
  612. <td width="67%">
  613. <p><big>setup decoder state for TIFFRGBAImageGet</big></p>
  614. </td>
  615. <tr valign="top" align="left">
  616. <td width="8%"></td>
  617. <td width="23%">
  618. <p><big>TIFFRGBAImageEnd</big></p>
  619. </td>
  620. <td width="67%">
  621. <p><big>release TIFFRGBAImage decoder state</big></p>
  622. </td>
  623. <tr valign="top" align="left">
  624. <td width="8%"></td>
  625. <td width="23%">
  626. <p><big>TIFFRGBAImageGet</big></p>
  627. </td>
  628. <td width="67%">
  629. <p><big>read and decode an image</big></p>
  630. </td>
  631. <tr valign="top" align="left">
  632. <td width="8%"></td>
  633. <td width="23%">
  634. <p><big>TIFFRGBAImageOK</big></p>
  635. </td>
  636. <td width="67%">
  637. <p><big>is image readable by TIFFRGBAImageGet</big></p>
  638. </td>
  639. <tr valign="top" align="left">
  640. <td width="8%"></td>
  641. <td width="23%">
  642. <p><big>TIFFScanlineSize</big></p>
  643. </td>
  644. <td width="67%">
  645. <p><big>return size of a scanline</big></p>
  646. </td>
  647. <tr valign="top" align="left">
  648. <td width="8%"></td>
  649. <td width="23%">
  650. <p><big>TIFFSetDirectory</big></p>
  651. </td>
  652. <td width="67%">
  653. <p><big>set the current directory</big></p>
  654. </td>
  655. <tr valign="top" align="left">
  656. <td width="8%"></td>
  657. <td width="23%">
  658. <p><big>TIFFSetSubDirectory</big></p>
  659. </td>
  660. <td width="67%">
  661. <p><big>set the current directory</big></p>
  662. </td>
  663. <tr valign="top" align="left">
  664. <td width="8%"></td>
  665. <td width="23%">
  666. <p><big>TIFFSetErrorHandler</big></p>
  667. </td>
  668. <td width="67%">
  669. <p><big>set error handler function</big></p>
  670. </td>
  671. <tr valign="top" align="left">
  672. <td width="8%"></td>
  673. <td width="23%">
  674. <p><big>TIFFSetField</big></p>
  675. </td>
  676. <td width="67%">
  677. <p><big>set a tag&rsquo;s value in the current
  678. directory</big></p>
  679. </td>
  680. <tr valign="top" align="left">
  681. <td width="8%"></td>
  682. <td width="23%">
  683. <p><big>TIFFSetWarningHandler</big></p>
  684. </td>
  685. <td width="67%">
  686. <p><big>set warning handler function</big></p>
  687. </td>
  688. <tr valign="top" align="left">
  689. <td width="8%"></td>
  690. <td width="23%">
  691. <p><big>TIFFStripSize</big></p>
  692. </td>
  693. <td width="67%">
  694. <p><big>returns size of a strip</big></p>
  695. </td>
  696. <tr valign="top" align="left">
  697. <td width="8%"></td>
  698. <td width="23%">
  699. <p><big>TIFFRawStripSize</big></p>
  700. </td>
  701. <td width="67%">
  702. <p><big>returns the number of bytes in a raw
  703. strip</big></p>
  704. </td>
  705. <tr valign="top" align="left">
  706. <td width="8%"></td>
  707. <td width="23%">
  708. <p><big>TIFFSwabShort</big></p>
  709. </td>
  710. <td width="67%">
  711. <p><big>swap bytes of short</big></p>
  712. </td>
  713. <tr valign="top" align="left">
  714. <td width="8%"></td>
  715. <td width="23%">
  716. <p><big>TIFFSwabLong</big></p>
  717. </td>
  718. <td width="67%">
  719. <p><big>swap bytes of long</big></p>
  720. </td>
  721. <tr valign="top" align="left">
  722. <td width="8%"></td>
  723. <td width="23%">
  724. <p><big>TIFFSwabArrayOfShort</big></p>
  725. </td>
  726. <td width="67%">
  727. <p><big>swap bytes of an array of shorts</big></p>
  728. </td>
  729. <tr valign="top" align="left">
  730. <td width="8%"></td>
  731. <td width="23%">
  732. <p><big>TIFFSwabArrayOfLong</big></p>
  733. </td>
  734. <td width="67%">
  735. <p><big>swap bytes of an array of longs</big></p>
  736. </td>
  737. <tr valign="top" align="left">
  738. <td width="8%"></td>
  739. <td width="23%">
  740. <p><big>TIFFTileRowSize</big></p>
  741. </td>
  742. <td width="67%">
  743. <p><big>return size of a row in a tile</big></p>
  744. </td>
  745. <tr valign="top" align="left">
  746. <td width="8%"></td>
  747. <td width="23%">
  748. <p><big>TIFFTileSize</big></p>
  749. </td>
  750. <td width="67%">
  751. <p><big>return size of a tile</big></p>
  752. </td>
  753. <tr valign="top" align="left">
  754. <td width="8%"></td>
  755. <td width="23%">
  756. <p><big>TIFFUnRegisterCODEC</big></p>
  757. </td>
  758. <td width="67%">
  759. <p><big>unregisters the codec</big></p>
  760. </td>
  761. <tr valign="top" align="left">
  762. <td width="8%"></td>
  763. <td width="23%">
  764. <p><big>TIFFVGetField</big></p>
  765. </td>
  766. <td width="67%">
  767. <p><big>return tag value in current directory</big></p>
  768. </td>
  769. <tr valign="top" align="left">
  770. <td width="8%"></td>
  771. <td width="23%">
  772. <p><big>TIFFVGetFieldDefaulted</big></p>
  773. </td>
  774. <td width="67%">
  775. <p><big>return tag value in current directory</big></p>
  776. </td>
  777. <tr valign="top" align="left">
  778. <td width="8%"></td>
  779. <td width="23%">
  780. <p><big>TIFFVSetField</big></p>
  781. </td>
  782. <td width="67%">
  783. <p><big>set a tag&rsquo;s value in the current
  784. directory</big></p>
  785. </td>
  786. <tr valign="top" align="left">
  787. <td width="8%"></td>
  788. <td width="23%">
  789. <p><big>TIFFVStripSize</big></p>
  790. </td>
  791. <td width="67%">
  792. <p><big>returns the number of bytes in a strip</big></p>
  793. </td>
  794. <tr valign="top" align="left">
  795. <td width="8%"></td>
  796. <td width="23%">
  797. <p><big>TIFFWarning</big></p>
  798. </td>
  799. <td width="67%">
  800. <p><big>library warning handler</big></p>
  801. </td>
  802. <tr valign="top" align="left">
  803. <td width="8%"></td>
  804. <td width="23%">
  805. <p><big>TIFFWriteDirectory</big></p>
  806. </td>
  807. <td width="67%">
  808. <p><big>write the current directory</big></p>
  809. </td>
  810. <tr valign="top" align="left">
  811. <td width="8%"></td>
  812. <td width="23%">
  813. <p><big>TIFFWriteEncodedStrip</big></p>
  814. </td>
  815. <td width="67%">
  816. <p><big>compress and write a strip of data</big></p>
  817. </td>
  818. <tr valign="top" align="left">
  819. <td width="8%"></td>
  820. <td width="23%">
  821. <p><big>TIFFWriteEncodedTile</big></p>
  822. </td>
  823. <td width="67%">
  824. <p><big>compress and write a tile of data</big></p>
  825. </td>
  826. <tr valign="top" align="left">
  827. <td width="8%"></td>
  828. <td width="23%">
  829. <p><big>TIFFWriteRawStrip</big></p>
  830. </td>
  831. <td width="67%">
  832. <p><big>write a raw strip of data</big></p>
  833. </td>
  834. <tr valign="top" align="left">
  835. <td width="8%"></td>
  836. <td width="23%">
  837. <p><big>TIFFWriteRawTile</big></p>
  838. </td>
  839. <td width="67%">
  840. <p><big>write a raw tile of data</big></p>
  841. </td>
  842. <tr valign="top" align="left">
  843. <td width="8%"></td>
  844. <td width="23%">
  845. <p><big>TIFFWriteScanline</big></p>
  846. </td>
  847. <td width="67%">
  848. <p><big>write a scanline of data</big></p>
  849. </td>
  850. <tr valign="top" align="left">
  851. <td width="8%"></td>
  852. <td width="23%">
  853. <p><big>TIFFWriteTile</big></p>
  854. </td>
  855. <td width="67%">
  856. <p><big>compress and write a tile of data</big></p>
  857. </td>
  858. <tr valign="top" align="left">
  859. <td width="8%"></td>
  860. <td width="23%">
  861. <p><big>TIFFXYZToRGB</big></p>
  862. </td>
  863. <td width="67%">
  864. <p><big>perform CIE XYZ to RGB conversion</big></p>
  865. </td>
  866. <tr valign="top" align="left">
  867. <td width="8%"></td>
  868. <td width="23%">
  869. <p><big>TIFFYCbCrToRGBInit</big></p>
  870. </td>
  871. <td width="67%">
  872. <p><big>initialize YCbCr to RGB conversion state</big></p>
  873. </td>
  874. <tr valign="top" align="left">
  875. <td width="8%"></td>
  876. <td width="23%">
  877. <p><big>TIFFYCbCrtoRGB</big></p>
  878. </td>
  879. <td width="67%">
  880. <p><big>perform YCbCr to RGB conversion</big></p>
  881. </td>
  882. </table>
  883. <!-- INDENTATION -->
  884. <table width="100%" border=0 rules="none" frame="void"
  885. cols="2" cellspacing="0" cellpadding="0">
  886. <tr valign="top" align="left">
  887. <td width="8%"></td>
  888. <td width="91%">
  889. <p><big>Auxiliary functions:</big></p></td>
  890. </table>
  891. <!-- TABS -->
  892. <table width="100%" border=0 rules="none" frame="void"
  893. cols="3" cellspacing="0" cellpadding="0">
  894. <tr valign="top" align="left">
  895. <td width="8%"></td>
  896. <td width="23%">
  897. <p><big>_TIFFfree</big></p>
  898. </td>
  899. <td width="67%">
  900. <p><big>free memory buffer</big></p>
  901. </td>
  902. <tr valign="top" align="left">
  903. <td width="8%"></td>
  904. <td width="23%">
  905. <p><big>_TIFFmalloc</big></p>
  906. </td>
  907. <td width="67%">
  908. <p><big>dynamically allocate memory buffer</big></p>
  909. </td>
  910. <tr valign="top" align="left">
  911. <td width="8%"></td>
  912. <td width="23%">
  913. <p><big>_TIFFmemcmp</big></p>
  914. </td>
  915. <td width="67%">
  916. <p><big>compare contents of the memory buffers</big></p>
  917. </td>
  918. <tr valign="top" align="left">
  919. <td width="8%"></td>
  920. <td width="23%">
  921. <p><big>_TIFFmemcpy</big></p>
  922. </td>
  923. <td width="67%">
  924. <p><big>copy contents of the one buffer to
  925. another</big></p>
  926. </td>
  927. <tr valign="top" align="left">
  928. <td width="8%"></td>
  929. <td width="23%">
  930. <p><big>_TIFFmemset</big></p>
  931. </td>
  932. <td width="67%">
  933. <p><big>fill memory buffer with a constant byte</big></p>
  934. </td>
  935. <tr valign="top" align="left">
  936. <td width="8%"></td>
  937. <td width="23%">
  938. <p><big>_TIFFrealloc</big></p>
  939. </td>
  940. <td width="67%">
  941. <p><big>dynamically reallocate memory buffer</big></p>
  942. </td>
  943. </table>
  944. <a name="TAG USAGE"></a>
  945. <h2>TAG USAGE</h2>
  946. <!-- INDENTATION -->
  947. <table width="100%" border=0 rules="none" frame="void"
  948. cols="2" cellspacing="0" cellpadding="0">
  949. <tr valign="top" align="left">
  950. <td width="8%"></td>
  951. <td width="91%">
  952. <p><big>The table below lists the</big> TIFF <big>tags that
  953. are recognized and handled by the library. If no use is
  954. indicated in the table, then the library reads and writes
  955. the tag, but does not use it internally. Note that some tags
  956. are meaningful only when a particul