raw2tiff.1.html 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510
  1. <!-- Creator : groff version 1.18.1 -->
  2. <!-- CreationDate: Sat Feb 24 18:37:19 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>RAW2TIFF</title>
  8. </head>
  9. <body>
  10. <h1 align=center>RAW2TIFF</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="#OPTIONS">OPTIONS</a><br>
  15. <a href="#GUESSING THE IMAGE GEOMETRY">GUESSING THE IMAGE GEOMETRY</a><br>
  16. <a href="#SEE ALSO">SEE ALSO</a><br>
  17. <hr>
  18. <a name="NAME"></a>
  19. <h2>NAME</h2>
  20. <!-- INDENTATION -->
  21. <table width="100%" border=0 rules="none" frame="void"
  22. cols="2" cellspacing="0" cellpadding="0">
  23. <tr valign="top" align="left">
  24. <td width="8%"></td>
  25. <td width="91%">
  26. <p>raw2tiff &minus; create a <small>TIFF</small> file from a
  27. raw data</p>
  28. </td>
  29. </table>
  30. <a name="SYNOPSIS"></a>
  31. <h2>SYNOPSIS</h2>
  32. <!-- INDENTATION -->
  33. <table width="100%" border=0 rules="none" frame="void"
  34. cols="2" cellspacing="0" cellpadding="0">
  35. <tr valign="top" align="left">
  36. <td width="8%"></td>
  37. <td width="91%">
  38. <p><b>raw2tiff</b> [ <i>options</i> ] <i>input.raw
  39. output.tif</i></p>
  40. </td>
  41. </table>
  42. <a name="DESCRIPTION"></a>
  43. <h2>DESCRIPTION</h2>
  44. <!-- INDENTATION -->
  45. <table width="100%" border=0 rules="none" frame="void"
  46. cols="2" cellspacing="0" cellpadding="0">
  47. <tr valign="top" align="left">
  48. <td width="8%"></td>
  49. <td width="91%">
  50. <p><i>raw2tiff</i> converts a raw byte sequence into
  51. <small>TIFF.</small> By default, the <small>TIFF</small>
  52. image is created with data samples packed
  53. (<i>PlanarConfiguration</i>=1), compressed with the PackBits
  54. algorithm (<i>Compression</i>=32773), and with each strip no
  55. more than 8 kilobytes. These characteristics can overridden,
  56. or explicitly specified with the options described
  57. below.</p>
  58. </td>
  59. </table>
  60. <a name="OPTIONS"></a>
  61. <h2>OPTIONS</h2>
  62. <!-- INDENTATION -->
  63. <table width="100%" border=0 rules="none" frame="void"
  64. cols="2" cellspacing="0" cellpadding="0">
  65. <tr valign="top" align="left">
  66. <td width="8%"></td>
  67. <td width="91%">
  68. <p><b>&minus;H</b> <i>number</i></p></td>
  69. </table>
  70. <!-- INDENTATION -->
  71. <table width="100%" border=0 rules="none" frame="void"
  72. cols="2" cellspacing="0" cellpadding="0">
  73. <tr valign="top" align="left">
  74. <td width="19%"></td>
  75. <td width="80%">
  76. <p>size of input image file header in bytes (0 by default).
  77. This amount of data just will be skipped from the start of
  78. file while reading.</p>
  79. </td>
  80. </table>
  81. <!-- INDENTATION -->
  82. <table width="100%" border=0 rules="none" frame="void"
  83. cols="2" cellspacing="0" cellpadding="0">
  84. <tr valign="top" align="left">
  85. <td width="8%"></td>
  86. <td width="91%">
  87. <p><b>&minus;w</b> <i>number</i></p></td>
  88. </table>
  89. <!-- INDENTATION -->
  90. <table width="100%" border=0 rules="none" frame="void"
  91. cols="2" cellspacing="0" cellpadding="0">
  92. <tr valign="top" align="left">
  93. <td width="19%"></td>
  94. <td width="80%">
  95. <p>width of input image in pixels (can be guessed, see
  96. <b><small>GUESSING THE IMAGE GEOMETRY</small></b>
  97. below).</p>
  98. </td>
  99. </table>
  100. <!-- INDENTATION -->
  101. <table width="100%" border=0 rules="none" frame="void"
  102. cols="2" cellspacing="0" cellpadding="0">
  103. <tr valign="top" align="left">
  104. <td width="8%"></td>
  105. <td width="91%">
  106. <p><b>&minus;l</b> <i>number</i></p></td>
  107. </table>
  108. <!-- INDENTATION -->
  109. <table width="100%" border=0 rules="none" frame="void"
  110. cols="2" cellspacing="0" cellpadding="0">
  111. <tr valign="top" align="left">
  112. <td width="19%"></td>
  113. <td width="80%">
  114. <p>length of input image in lines (can be guessed, see
  115. <b><small>GUESSING THE IMAGE GEOMETRY</small></b>
  116. below).</p>
  117. </td>
  118. </table>
  119. <!-- INDENTATION -->
  120. <table width="100%" border=0 rules="none" frame="void"
  121. cols="2" cellspacing="0" cellpadding="0">
  122. <tr valign="top" align="left">
  123. <td width="8%"></td>
  124. <td width="91%">
  125. <p><b>&minus;b</b> <i>number</i></p></td>
  126. </table>
  127. <!-- INDENTATION -->
  128. <table width="100%" border=0 rules="none" frame="void"
  129. cols="2" cellspacing="0" cellpadding="0">
  130. <tr valign="top" align="left">
  131. <td width="19%"></td>
  132. <td width="80%">
  133. <p>number of bands in input image (1 by default).</p>
  134. </td>
  135. </table>
  136. <!-- INDENTATION -->
  137. <table width="100%" border=0 rules="none" frame="void"
  138. cols="2" cellspacing="0" cellpadding="0">
  139. <tr valign="top" align="left">
  140. <td width="8%"></td>
  141. <td width="91%">
  142. <p><b>&minus;d</b> <i>data_type</i></p></td>
  143. </table>
  144. <!-- INDENTATION -->
  145. <table width="100%" border=0 rules="none" frame="void"
  146. cols="2" cellspacing="0" cellpadding="0">
  147. <tr valign="top" align="left">
  148. <td width="19%"></td>
  149. <td width="80%">
  150. <p>type of samples in input image, where <i>data_type</i>
  151. may be:</p></td>
  152. </table>
  153. <!-- TABS -->
  154. <table width="100%" border=0 rules="none" frame="void"
  155. cols="3" cellspacing="0" cellpadding="0">
  156. <tr valign="top" align="left">
  157. <td width="19%"></td>
  158. <td width="10%">
  159. <p><b>byte</b></p>
  160. </td>
  161. <td width="70%">
  162. <p>8-bit unsigned integer (default),</p>
  163. </td>
  164. <tr valign="top" align="left">
  165. <td width="19%"></td>
  166. <td width="10%">
  167. <p><b>short</b></p>
  168. </td>
  169. <td width="70%">
  170. <p>16-bit unsigned integer,</p>
  171. </td>
  172. <tr valign="top" align="left">
  173. <td width="19%"></td>
  174. <td width="10%">
  175. <p><b>long</b></p>
  176. </td>
  177. <td width="70%">
  178. <p>32-bit unsigned integer,</p>
  179. </td>
  180. <tr valign="top" align="left">
  181. <td width="19%"></td>
  182. <td width="10%">
  183. <p><b>sbyte</b></p>
  184. </td>
  185. <td width="70%">
  186. <p>8-bit signed integer,</p>
  187. </td>
  188. <tr valign="top" align="left">
  189. <td width="19%"></td>
  190. <td width="10%">
  191. <p><b>sshort</b></p>
  192. </td>
  193. <td width="70%">
  194. <p>16-bit signed integer,</p>
  195. </td>
  196. <tr valign="top" align="left">
  197. <td width="19%"></td>
  198. <td width="10%">
  199. <p><b>slong</b></p>
  200. </td>
  201. <td width="70%">
  202. <p>32-bit signed integer,</p>
  203. </td>
  204. <tr valign="top" align="left">
  205. <td width="19%"></td>
  206. <td width="10%">
  207. <p><b>float</b></p>
  208. </td>
  209. <td width="70%">
  210. <p>32-bit IEEE floating point,</p>
  211. </td>
  212. <tr valign="top" align="left">
  213. <td width="19%"></td>
  214. <td width="10%">
  215. <p><b>double</b></p>
  216. </td>
  217. <td width="70%">
  218. <p>64-bit IEEE floating point.</p>
  219. </td>
  220. </table>
  221. <!-- INDENTATION -->
  222. <table width="100%" border=0 rules="none" frame="void"
  223. cols="2" cellspacing="0" cellpadding="0">
  224. <tr valign="top" align="left">
  225. <td width="8%"></td>
  226. <td width="91%">
  227. <p><b>&minus;i</b> <i>config</i></p></td>
  228. </table>
  229. <!-- INDENTATION -->
  230. <table width="100%" border=0 rules="none" frame="void"
  231. cols="2" cellspacing="0" cellpadding="0">
  232. <tr valign="top" align="left">
  233. <td width="19%"></td>
  234. <td width="80%">
  235. <p>type of samples interleaving in input image, where
  236. <i>config</i> may be:</p></td>
  237. </table>
  238. <!-- TABS -->
  239. <table width="100%" border=0 rules="none" frame="void"
  240. cols="3" cellspacing="0" cellpadding="0">
  241. <tr valign="top" align="left">
  242. <td width="19%"></td>
  243. <td width="8%">
  244. <p><b>pixel</b></p>
  245. </td>
  246. <td width="71%">
  247. <p>pixel interleaved data (default),</p>
  248. </td>
  249. <tr valign="top" align="left">
  250. <td width="19%"></td>
  251. <td width="8%">
  252. <p><b>band</b></p>
  253. </td>
  254. <td width="71%">
  255. <p>band interleaved data.</p>
  256. </td>
  257. </table>
  258. <!-- INDENTATION -->
  259. <table width="100%" border=0 rules="none" frame="void"
  260. cols="2" cellspacing="0" cellpadding="0">
  261. <tr valign="top" align="left">
  262. <td width="8%"></td>
  263. <td width="91%">
  264. <p><b>&minus;p</b> <i>photo</i></p></td>
  265. </table>
  266. <!-- INDENTATION -->
  267. <table width="100%" border=0 rules="none" frame="void"
  268. cols="2" cellspacing="0" cellpadding="0">
  269. <tr valign="top" align="left">
  270. <td width="19%"></td>
  271. <td width="80%">
  272. <p>photometric interpretation (color space) of the input
  273. image, where <i>photo</i> may be:</p></td>
  274. </table>
  275. <!-- TABS -->
  276. <table width="100%" border=0 rules="none" frame="void"
  277. cols="3" cellspacing="0" cellpadding="0">
  278. <tr valign="top" align="left">
  279. <td width="19%"></td>
  280. <td width="15%">
  281. <p><b>miniswhite</b></p>
  282. </td>
  283. <td width="65%">
  284. <p>white color represented with 0 value,</p>
  285. </td>
  286. <tr valign="top" align="left">
  287. <td width="19%"></td>
  288. <td width="15%">
  289. <p><b>minisblack</b></p>
  290. </td>
  291. <td width="65%">
  292. <p>black color represented with 0 value (default),</p>
  293. </td>
  294. <tr valign="top" align="left">
  295. <td width="19%"></td>
  296. <td width="15%">
  297. <p><b>rgb</b></p>
  298. </td>
  299. <td width="65%">
  300. <p>image has RGB color model,</p>
  301. </td>
  302. <tr valign="top" align="left">
  303. <td width="19%"></td>
  304. <td width="15%">
  305. <p><b>cmyk</b></p>
  306. </td>
  307. <td width="65%">
  308. <p>image has CMYK (separated) color model,</p>
  309. </td>
  310. <tr valign="top" align="left">
  311. <td width="19%"></td>
  312. <td width="15%">
  313. <p><b>ycbcr</b></p>
  314. </td>
  315. <td width="65%">
  316. <p>image has YCbCr color model,</p>
  317. </td>
  318. <tr valign="top" align="left">
  319. <td width="19%"></td>
  320. <td width="15%">
  321. <p><b>cielab</b></p>
  322. </td>
  323. <td width="65%">
  324. <p>image has CIE L*a*b color model,</p>
  325. </td>
  326. <tr valign="top" align="left">
  327. <td width="19%"></td>
  328. <td width="15%">
  329. <p><b>icclab</b></p>
  330. </td>
  331. <td width="65%">
  332. <p>image has ICC L*a*b color model,</p>
  333. </td>
  334. <tr valign="top" align="left">
  335. <td width="19%"></td>
  336. <td width="15%">
  337. <p><b>itulab</b></p>
  338. </td>
  339. <td width="65%">
  340. <p>image has ITU L*a*b color model.</p>
  341. </td>
  342. </table>
  343. <!-- TABS -->
  344. <table width="100%" border=0 rules="none" frame="void"
  345. cols="5" cellspacing="0" cellpadding="0">
  346. <tr valign="top" align="left">
  347. <td width="10%"></td>
  348. <td width="3%">
  349. <p><b>&minus;s</b></p>
  350. </td>
  351. <td width="5%"></td>
  352. <td width="80%">
  353. <p>swap bytes fetched from the input file.</p>
  354. </td>
  355. <td width="0%">
  356. </td>
  357. <tr valign="top" align="left">
  358. <td width="10%"></td>
  359. <td width="3%">
  360. <p><b>&minus;L</b></p>
  361. </td>
  362. <td width="5%"></td>
  363. <td width="80%">
  364. <p>input data has LSB2MSB bit order (default).</p>
  365. </td>
  366. <td width="0%">
  367. </td>
  368. <tr valign="top" align="left">
  369. <td width="10%"></td>
  370. <td width="3%">
  371. <p><b>&minus;M</b></p>
  372. </td>
  373. <td width="5%"></td>
  374. <td width="80%">
  375. <p>input data has MSB2LSB bit order.</p>
  376. </td>
  377. <td width="0%">
  378. </td>
  379. <tr valign="top" align="left">
  380. <td width="10%"></td>
  381. <td width="3%">
  382. <p><b>&minus;c</b></p>
  383. </td>
  384. <td width="5%"></td>
  385. <td width="80%">
  386. <p>Specify a compression scheme to use when writing image
  387. data: <b>&minus;c none</b> for no compression, <b>&minus;c
  388. packbits</b> for the PackBits compression algorithm (the
  389. default), <b>&minus;c jpeg</b> for the baseline JPEG
  390. compression algorithm, <b>&minus;c zip</b> for the Deflate
  391. compression algorithm, and <b>&minus;c lzw</b> for
  392. Lempel-Ziv &amp; Welch.</p>
  393. </td>
  394. <td width="0%">
  395. </td>
  396. </table>
  397. <!-- INDENTATION -->
  398. <table width="100%" border=0 rules="none" frame="void"
  399. cols="2" cellspacing="0" cellpadding="0">
  400. <tr valign="top" align="left">
  401. <td width="8%"></td>
  402. <td width="91%">
  403. <p><b>&minus;r</b> <i>number</i></p></td>
  404. </table>
  405. <!-- INDENTATION -->
  406. <table width="100%" border=0 rules="none" frame="void"
  407. cols="2" cellspacing="0" cellpadding="0">
  408. <tr valign="top" align="left">
  409. <td width="19%"></td>
  410. <td width="80%">
  411. <p>Write data with a specified number of rows per strip; by
  412. default the number of rows/strip is selected so that each
  413. strip is approximately 8 kilobytes.</p>
  414. </td>
  415. </table>
  416. <a name="GUESSING THE IMAGE GEOMETRY"></a>
  417. <h2>GUESSING THE IMAGE GEOMETRY</h2>
  418. <!-- INDENTATION -->
  419. <table width="100%" border=0 rules="none" frame="void"
  420. cols="2" cellspacing="0" cellpadding="0">
  421. <tr valign="top" align="left">
  422. <td width="8%"></td>
  423. <td width="91%">
  424. <p><i>raw2tiff</i> can guess image width and height in case
  425. one or both of these parameters are not specified. If you
  426. omit one of those parameters, the complementary one will be
  427. calculated based on the file size (taking into account
  428. header size, number of bands and data type). If you omit
  429. both parameters, the statistical approach will be used.
  430. Utility will compute correlation coefficient between two
  431. lines at the image center using several appropriate line
  432. sizes and the highest absolute value of the coefficient will
  433. indicate the right line size. That is why you should be
  434. cautious with the very large images, because guessing
  435. process may take a while (depending on your system
  436. performance). Of course, the utility can&rsquo;t guess the
  437. header size, number of bands and data type, so it should be
  438. specified manually. If you don&rsquo;t know anything about
  439. your image, just try with the several combinations of those
  440. options.</p>
  441. <!-- INDENTATION -->
  442. <p>There is no magic, it is just a mathematical statistics,
  443. so it can be wrong in some cases. But for most ordinary
  444. images guessing method will work fine.</p>
  445. </td>
  446. </table>
  447. <a name="SEE ALSO"></a>
  448. <h2>SEE ALSO</h2>
  449. <!-- INDENTATION -->
  450. <table width="100%" border=0 rules="none" frame="void"
  451. cols="2" cellspacing="0" cellpadding="0">
  452. <tr valign="top" align="left">
  453. <td width="8%"></td>
  454. <td width="91%">
  455. <p><b>pal2rgb</b>(1), <b>tiffcp</b>(1),
  456. <b>tiffmedian</b>(1), <b>libtiff</b>(3)</p>
  457. <!-- INDENTATION -->
  458. <p>Libtiff library home page:
  459. <b>http://www.simplesystems.org/libtiff/</b></p>
  460. </td>
  461. </table>
  462. <hr>
  463. </body>
  464. </html>