PNG  IHDRQgAMA a cHRMz&u0`:pQ<bKGDgmIDATxwUﹻ& ^CX(J I@ "% (** BX +*i"]j(IH{~R)[~>h{}gy)I$Ij .I$I$ʊy@}x.: $I$Ii}VZPC)I$IF ^0ʐJ$I$Q^}{"r=OzI$gRZeC.IOvH eKX $IMpxsk.쒷/&r[޳<v| .I~)@$updYRa$I |M.e JaֶpSYR6j>h%IRز if&uJ)M$I vLi=H;7UJ,],X$I1AҒJ$ XY XzI@GNҥRT)E@;]K*Mw;#5_wOn~\ DC&$(A5 RRFkvIR}l!RytRl;~^ǷJj اy뷦BZJr&ӥ8Pjw~vnv X^(I;4R=P[3]J,]ȏ~:3?[ a&e)`e*P[4]T=Cq6R[ ~ޤrXR Հg(t_HZ-Hg M$ãmL5R uk*`%C-E6/%[t X.{8P9Z.vkXŐKjgKZHg(aK9ڦmKjѺm_ \#$5,)-  61eJ,5m| r'= &ڡd%-]J on Xm|{ RҞe $eڧY XYrԮ-a7RK6h>n$5AVڴi*ֆK)mѦtmr1p| q:흺,)Oi*ֺK)ܬ֦K-5r3>0ԔHjJئEZj,%re~/z%jVMڸmrt)3]J,T K֦OvԒgii*bKiNO~%PW0=dii2tJ9Jݕ{7"I P9JKTbu,%r"6RKU}Ij2HKZXJ,妝 XYrP ެ24c%i^IK|.H,%rb:XRl1X4Pe/`x&P8Pj28Mzsx2r\zRPz4J}yP[g=L) .Q[6RjWgp FIH*-`IMRaK9TXcq*I y[jE>cw%gLRԕiFCj-ďa`#e~I j,%r,)?[gp FI˨mnWX#>mʔ XA DZf9,nKҲzIZXJ,L#kiPz4JZF,I,`61%2s $,VOϚ2/UFJfy7K> X+6 STXIeJILzMfKm LRaK9%|4p9LwJI!`NsiazĔ)%- XMq>pk$-$Q2x#N ؎-QR}ᶦHZډ)J,l#i@yn3LN`;nڔ XuX5pF)m|^0(>BHF9(cզEerJI rg7 4I@z0\JIi䵙RR0s;$s6eJ,`n 䂦0a)S)A 1eJ,堌#635RIgpNHuTH_SԕqVe ` &S)>p;S$魁eKIuX`I4춒o}`m$1":PI<[v9^\pTJjriRŭ P{#{R2,`)e-`mgj~1ϣLKam7&U\j/3mJ,`F;M'䱀 .KR#)yhTq;pcK9(q!w?uRR,n.yw*UXj#\]ɱ(qv2=RqfB#iJmmL<]Y͙#$5 uTU7ӦXR+q,`I}qL'`6Kͷ6r,]0S$- [RKR3oiRE|nӦXR.(i:LDLTJjY%o:)6rxzҒqTJjh㞦I.$YR.ʼnGZ\ֿf:%55 I˼!6dKxm4E"mG_ s? .e*?LRfK9%q#uh$)i3ULRfK9yxm܌bj84$i1U^@Wbm4uJ,ҪA>_Ij?1v32[gLRD96oTaR׿N7%L2 NT,`)7&ƝL*꽙yp_$M2#AS,`)7$rkTA29_Iye"|/0t)$n XT2`YJ;6Jx".e<`$) PI$5V4]29SRI>~=@j]lp2`K9Jaai^" Ԋ29ORI%:XV5]JmN9]H;1UC39NI%Xe78t)a;Oi Ҙ>Xt"~G>_mn:%|~ޅ_+]$o)@ǀ{hgN;IK6G&rp)T2i୦KJuv*T=TOSV>(~D>dm,I*Ɛ:R#ۙNI%D>G.n$o;+#RR!.eU˽TRI28t)1LWϚ>IJa3oFbu&:tJ*(F7y0ZR ^p'Ii L24x| XRI%ۄ>S1]Jy[zL$adB7.eh4%%누>WETf+3IR:I3Xה)3אOۦSRO'ٺ)S}"qOr[B7ϙ.edG)^ETR"RtRݜh0}LFVӦDB^k_JDj\=LS(Iv─aTeZ%eUAM-0;~˃@i|l @S4y72>sX-vA}ϛBI!ݎߨWl*)3{'Y|iSlEڻ(5KtSI$Uv02,~ԩ~x;P4ցCrO%tyn425:KMlD ^4JRxSهF_}شJTS6uj+ﷸk$eZO%G*^V2u3EMj3k%)okI]dT)URKDS 7~m@TJR~荪fT"֛L \sM -0T KfJz+nإKr L&j()[E&I ߴ>e FW_kJR|!O:5/2跌3T-'|zX ryp0JS ~^F>-2< `*%ZFP)bSn"L :)+pʷf(pO3TMW$~>@~ū:TAIsV1}S2<%ޟM?@iT ,Eūoz%i~g|`wS(]oȤ8)$ ntu`өe`6yPl IzMI{ʣzʨ )IZ2= ld:5+請M$-ї;U>_gsY$ÁN5WzWfIZ)-yuXIfp~S*IZdt;t>KūKR|$#LcԀ+2\;kJ`]YǔM1B)UbG"IRߊ<xܾӔJ0Z='Y嵤 Leveg)$znV-º^3Ւof#0Tfk^Zs[*I꯳3{)ˬW4Ւ4 OdpbZRS|*I 55#"&-IvT&/윚Ye:i$ 9{LkuRe[I~_\ؠ%>GL$iY8 9ܕ"S`kS.IlC;Ҏ4x&>u_0JLr<J2(^$5L s=MgV ~,Iju> 7r2)^=G$1:3G< `J3~&IR% 6Tx/rIj3O< ʔ&#f_yXJiގNSz; Tx(i8%#4 ~AS+IjerIUrIj362v885+IjAhK__5X%nV%Iͳ-y|7XV2v4fzo_68"S/I-qbf; LkF)KSM$ Ms>K WNV}^`-큧32ŒVؙGdu,^^m%6~Nn&͓3ŒVZMsRpfEW%IwdǀLm[7W&bIRL@Q|)* i ImsIMmKmyV`i$G+R 0tV'!V)֏28vU7͒vHꦼtxꗞT ;S}7Mf+fIRHNZUkUx5SAJㄌ9MqμAIRi|j5)o*^'<$TwI1hEU^c_j?Е$%d`z cyf,XO IJnTgA UXRD }{H}^S,P5V2\Xx`pZ|Yk:$e ~ @nWL.j+ϝYb퇪bZ BVu)u/IJ_ 1[p.p60bC >|X91P:N\!5qUB}5a5ja `ubcVxYt1N0Zzl4]7­gKj]?4ϻ *[bg$)+À*x쳀ogO$~,5 زUS9 lq3+5mgw@np1sso Ӻ=|N6 /g(Wv7U;zωM=wk,0uTg_`_P`uz?2yI!b`kĸSo+Qx%!\οe|އԁKS-s6pu_(ֿ$i++T8=eY; צP+phxWQv*|p1. ά. XRkIQYP,drZ | B%wP|S5`~́@i޾ E;Չaw{o'Q?%iL{u D?N1BD!owPHReFZ* k_-~{E9b-~P`fE{AܶBJAFO wx6Rox5 K5=WwehS8 (JClJ~ p+Fi;ŗo+:bD#g(C"wA^ r.F8L;dzdIHUX݆ϞXg )IFqem%I4dj&ppT{'{HOx( Rk6^C٫O.)3:s(۳(Z?~ٻ89zmT"PLtw䥈5&b<8GZ-Y&K?e8,`I6e(֍xb83 `rzXj)F=l($Ij 2*(F?h(/9ik:I`m#p3MgLaKjc/U#n5S# m(^)=y=đx8ŬI[U]~SцA4p$-F i(R,7Cx;X=cI>{Km\ o(Tv2vx2qiiDJN,Ҏ!1f 5quBj1!8 rDFd(!WQl,gSkL1Bxg''՞^ǘ;pQ P(c_ IRujg(Wz bs#P­rz> k c&nB=q+ؔXn#r5)co*Ũ+G?7< |PQӣ'G`uOd>%Mctz# Ԫڞ&7CaQ~N'-P.W`Oedp03C!IZcIAMPUۀ5J<\u~+{9(FbbyAeBhOSܳ1 bÈT#ŠyDžs,`5}DC-`̞%r&ڙa87QWWp6e7 Rϫ/oY ꇅ Nܶըtc!LA T7V4Jsū I-0Pxz7QNF_iZgúWkG83 0eWr9 X]㾮݁#Jˢ C}0=3ݱtBi]_ &{{[/o[~ \q鯜00٩|cD3=4B_b RYb$óBRsf&lLX#M*C_L܄:gx)WΘsGSbuL rF$9';\4Ɍq'n[%p.Q`u hNb`eCQyQ|l_C>Lb꟟3hSb #xNxSs^ 88|Mz)}:](vbۢamŖ࿥ 0)Q7@0=?^k(*J}3ibkFn HjB׻NO z x}7p 0tfDX.lwgȔhԾŲ }6g E |LkLZteu+=q\Iv0쮑)QٵpH8/2?Σo>Jvppho~f>%bMM}\//":PTc(v9v!gոQ )UfVG+! 35{=x\2+ki,y$~A1iC6#)vC5^>+gǵ@1Hy٪7u;p psϰu/S <aʸGu'tD1ԝI<pg|6j'p:tպhX{o(7v],*}6a_ wXRk,O]Lܳ~Vo45rp"N5k;m{rZbΦ${#)`(Ŵg,;j%6j.pyYT?}-kBDc3qA`NWQū20/^AZW%NQ MI.X#P#,^Ebc&?XR tAV|Y.1!؅⨉ccww>ivl(JT~ u`ٵDm q)+Ri x/x8cyFO!/*!/&,7<.N,YDŽ&ܑQF1Bz)FPʛ?5d 6`kQձ λc؎%582Y&nD_$Je4>a?! ͨ|ȎWZSsv8 j(I&yj Jb5m?HWp=g}G3#|I,5v珿] H~R3@B[☉9Ox~oMy=J;xUVoj bUsl_35t-(ՃɼRB7U!qc+x4H_Qo֮$[GO<4`&č\GOc[.[*Af%mG/ ňM/r W/Nw~B1U3J?P&Y )`ѓZ1p]^l“W#)lWZilUQu`-m|xĐ,_ƪ|9i:_{*(3Gѧ}UoD+>m_?VPۅ15&}2|/pIOʵ> GZ9cmíتmnz)yߐbD >e}:) r|@R5qVSA10C%E_'^8cR7O;6[eKePGϦX7jb}OTGO^jn*媓7nGMC t,k31Rb (vyܴʭ!iTh8~ZYZp(qsRL ?b}cŨʊGO^!rPJO15MJ[c&~Z`"ѓޔH1C&^|Ш|rʼ,AwĴ?b5)tLU)F| &g٣O]oqSUjy(x<Ϳ3 .FSkoYg2 \_#wj{u'rQ>o;%n|F*O_L"e9umDds?.fuuQbIWz |4\0 sb;OvxOSs; G%T4gFRurj(֍ڑb uԖKDu1MK{1^ q; C=6\8FR艇!%\YÔU| 88m)֓NcLve C6z;o&X x59:q61Z(T7>C?gcļxѐ Z oo-08jہ x,`' ҔOcRlf~`jj".Nv+sM_]Zk g( UOPyεx%pUh2(@il0ݽQXxppx-NS( WO+轾 nFߢ3M<;z)FBZjciu/QoF 7R¥ ZFLF~#ȣߨ^<쩡ݛкvџ))ME>ώx4m#!-m!L;vv#~Y[đKmx9.[,UFS CVkZ +ߟrY٧IZd/ioi$%͝ب_ֶX3ܫhNU ZZgk=]=bbJS[wjU()*I =ώ:}-蹞lUj:1}MWm=̛ _ ¾,8{__m{_PVK^n3esw5ӫh#$-q=A̟> ,^I}P^J$qY~Q[ Xq9{#&T.^GVj__RKpn,b=`żY@^՝;z{paVKkQXj/)y TIc&F;FBG7wg ZZDG!x r_tƢ!}i/V=M/#nB8 XxЫ ^@CR<{䤭YCN)eKOSƟa $&g[i3.C6xrOc8TI;o hH6P&L{@q6[ Gzp^71j(l`J}]e6X☉#͕ ׈$AB1Vjh㭦IRsqFBjwQ_7Xk>y"N=MB0 ,C #o6MRc0|$)ف"1!ixY<B9mx `,tA>)5ػQ?jQ?cn>YZe Tisvh# GMމȇp:ԴVuږ8ɼH]C.5C!UV;F`mbBk LTMvPʍϤj?ԯ/Qr1NB`9s"s TYsz &9S%U԰> {<ؿSMxB|H\3@!U| k']$U+> |HHMLޢ?V9iD!-@x TIî%6Z*9X@HMW#?nN ,oe6?tQwڱ.]-y':mW0#!J82qFjH -`ѓ&M0u Uγmxϵ^-_\])@0Rt.8/?ٰCY]x}=sD3ojަЫNuS%U}ԤwHH>ڗjܷ_3gN q7[q2la*ArǓԖ+p8/RGM ]jacd(JhWko6ڎbj]i5Bj3+3!\j1UZLsLTv8HHmup<>gKMJj0@H%,W΃7R) ">c, xixј^ aܖ>H[i.UIHc U1=yW\=S*GR~)AF=`&2h`DzT󑓶J+?W+}C%P:|0H܆}-<;OC[~o.$~i}~HQ TvXΈr=b}$vizL4:ȰT|4~*!oXQR6Lk+#t/g lԁߖ[Jڶ_N$k*". xsxX7jRVbAAʯKҎU3)zSNN _'s?f)6X!%ssAkʱ>qƷb hg %n ~p1REGMHH=BJiy[<5 ǁJҖgKR*倳e~HUy)Ag,K)`Vw6bRR:qL#\rclK/$sh*$ 6덤 KԖc 3Z9=Ɣ=o>X Ώ"1 )a`SJJ6k(<c e{%kϊP+SL'TcMJWRm ŏ"w)qc ef꒵i?b7b('"2r%~HUS1\<(`1Wx9=8HY9m:X18bgD1u ~|H;K-Uep,, C1 RV.MR5άh,tWO8WC$ XRVsQS]3GJ|12 [vM :k#~tH30Rf-HYݺ-`I9%lIDTm\ S{]9gOڒMNCV\G*2JRŨ;Rҏ^ڽ̱mq1Eu?To3I)y^#jJw^Ńj^vvlB_⋌P4x>0$c>K†Aļ9s_VjTt0l#m>E-,,x,-W)سo&96RE XR.6bXw+)GAEvL)͞K4$p=Ũi_ѱOjb HY/+@θH9޼]Nԥ%n{ &zjT? Ty) s^ULlb,PiTf^<À] 62R^V7)S!nllS6~͝V}-=%* ʻ>G DnK<y&>LPy7'r=Hj 9V`[c"*^8HpcO8bnU`4JȪAƋ#1_\ XϘHPRgik(~G~0DAA_2p|J묭a2\NCr]M_0 ^T%e#vD^%xy-n}-E\3aS%yN!r_{ )sAw ڼp1pEAk~v<:`'ӭ^5 ArXOI驻T (dk)_\ PuA*BY]yB"l\ey hH*tbK)3 IKZ򹞋XjN n *n>k]X_d!ryBH ]*R 0(#'7 %es9??ښFC,ՁQPjARJ\Ρw K#jahgw;2$l*) %Xq5!U᢯6Re] |0[__64ch&_}iL8KEgҎ7 M/\`|.p,~`a=BR?xܐrQ8K XR2M8f ?`sgWS%" Ԉ 7R%$ N}?QL1|-эټwIZ%pvL3Hk>,ImgW7{E xPHx73RA @RS CC !\ȟ5IXR^ZxHл$Q[ŝ40 (>+ _C >BRt<,TrT {O/H+˟Pl6 I B)/VC<6a2~(XwV4gnXR ϱ5ǀHٻ?tw똤Eyxp{#WK qG%5],(0ӈH HZ])ג=K1j&G(FbM@)%I` XRg ʔ KZG(vP,<`[ Kn^ SJRsAʠ5xՅF`0&RbV tx:EaUE/{fi2;.IAwW8/tTxAGOoN?G}l L(n`Zv?pB8K_gI+ܗ #i?ޙ.) p$utc ~DžfՈEo3l/)I-U?aԅ^jxArA ΧX}DmZ@QLےbTXGd.^|xKHR{|ΕW_h] IJ`[G9{).y) 0X YA1]qp?p_k+J*Y@HI>^?gt.06Rn ,` ?);p pSF9ZXLBJPWjgQ|&)7! HjQt<| ؅W5 x W HIzYoVMGP Hjn`+\(dNW)F+IrS[|/a`K|ͻ0Hj{R,Q=\ (F}\WR)AgSG`IsnAR=|8$}G(vC$)s FBJ?]_u XRvύ6z ŨG[36-T9HzpW̞ú Xg큽=7CufzI$)ki^qk-) 0H*N` QZkk]/tnnsI^Gu't=7$ Z;{8^jB% IItRQS7[ϭ3 $_OQJ`7!]W"W,)Iy W AJA;KWG`IY{8k$I$^%9.^(`N|LJ%@$I}ֽp=FB*xN=gI?Q{٥4B)mw $Igc~dZ@G9K X?7)aK%݅K$IZ-`IpC U6$I\0>!9k} Xa IIS0H$I H ?1R.Чj:4~Rw@p$IrA*u}WjWFPJ$I➓/6#! LӾ+ X36x8J |+L;v$Io4301R20M I$-E}@,pS^ޟR[/s¹'0H$IKyfŸfVOπFT*a$I>He~VY/3R/)>d$I>28`Cjw,n@FU*9ttf$I~<;=/4RD~@ X-ѕzἱI$: ԍR a@b X{+Qxuq$IЛzo /~3\8ڒ4BN7$IҀj V]n18H$IYFBj3̵̚ja pp $Is/3R Ӻ-Yj+L;.0ŔI$Av? #!5"aʄj}UKmɽH$IjCYs?h$IDl843.v}m7UiI=&=0Lg0$I4: embe` eQbm0u? $IT!Sƍ'-sv)s#C0:XB2a w I$zbww{."pPzO =Ɔ\[ o($Iaw]`E).Kvi:L*#gР7[$IyGPI=@R 4yR~̮´cg I$I/<tPͽ hDgo 94Z^k盇΄8I56^W$I^0̜N?4*H`237}g+hxoq)SJ@p|` $I%>-hO0eO>\ԣNߌZD6R=K ~n($I$y3D>o4b#px2$yڪtzW~a $I~?x'BwwpH$IZݑnC㧄Pc_9sO gwJ=l1:mKB>Ab<4Lp$Ib o1ZQ@85b̍ S'F,Fe,^I$IjEdù{l4 8Ys_s Z8.x m"+{~?q,Z D!I$ϻ'|XhB)=…']M>5 rgotԎ 獽PH$IjIPhh)n#cÔqA'ug5qwU&rF|1E%I$%]!'3AFD/;Ck_`9 v!ٴtPV;x`'*bQa w I$Ix5 FC3D_~A_#O݆DvV?<qw+I$I{=Z8".#RIYyjǪ=fDl9%M,a8$I$Ywi[7ݍFe$s1ՋBVA?`]#!oz4zjLJo8$I$%@3jAa4(o ;p,,dya=F9ً[LSPH$IJYЉ+3> 5"39aZ<ñh!{TpBGkj}Sp $IlvF.F$I z< '\K*qq.f<2Y!S"-\I$IYwčjF$ w9 \ߪB.1v!Ʊ?+r:^!I$BϹB H"B;L'G[ 4U#5>੐)|#o0aڱ$I>}k&1`U#V?YsV x>{t1[I~D&(I$I/{H0fw"q"y%4 IXyE~M3 8XψL}qE$I[> nD?~sf ]o΁ cT6"?'_Ἣ $I>~.f|'!N?⟩0G KkXZE]ޡ;/&?k OۘH$IRۀwXӨ<7@PnS04aӶp.:@\IWQJ6sS%I$e5ڑv`3:x';wq_vpgHyXZ 3gЂ7{{EuԹn±}$I$8t;b|591nءQ"P6O5i }iR̈́%Q̄p!I䮢]O{H$IRϻ9s֧ a=`- aB\X0"+5"C1Hb?߮3x3&gşggl_hZ^,`5?ߎvĸ%̀M!OZC2#0x LJ0 Gw$I$I}<{Eb+y;iI,`ܚF:5ܛA8-O-|8K7s|#Z8a&><a&/VtbtLʌI$I$I$I$I$I$IRjDD%tEXtdate:create2022-05-31T04:40:26+00:00!Î%tEXtdate:modify2022-05-31T04:40:26+00:00|{2IENDB`Mini Shell

HOME


Mini Shell 1.0
DIR:/usr/share/doc/libtiff-devel-4.0.3/html/man/
Upload File :
Current File : //usr/share/doc/libtiff-devel-4.0.3/html/man/libtiff.3tiff.html
<!-- Creator     : groff version 1.18.1 -->
<!-- CreationDate: Sat Feb 24 18:37:20 2007 -->
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta name="Content-Style" content="text/css">
<title>INTRO</title>
</head>
<body>

<h1 align=center>INTRO</h1>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#DATA TYPES">DATA TYPES</a><br>
<a href="#LIST OF ROUTINES">LIST OF ROUTINES</a><br>
<a href="#TAG USAGE">TAG USAGE</a><br>
<a href="#PSEUDO TAGS">PSEUDO TAGS</a><br>
<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<a href="#BUGS">BUGS</a><br>

<hr>
<a name="NAME"></a>
<h2>NAME</h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p><big>libtiff &minus; introduction to <i>libtiff</i>, a
library for reading and writing</big> TIFF
<big>files</big></p>
</td>
</table>
<a name="SYNOPSIS"></a>
<h2>SYNOPSIS</h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p><big><b>#include &lt;tiffio.h&gt;</b></big></p>
<!-- INDENTATION -->
<p><big>cc file.c <b>-ltiff</b></big></p>
</td>
</table>
<a name="DESCRIPTION"></a>
<h2>DESCRIPTION</h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p><big><i>libtiff</i> is a library for reading and writing
data files encoded with the <i>Tag Image File</i> format,
Revision 6.0 (or revision 5.0 or revision 4.0). This file
format is suitable for archiving multi-color and
monochromatic image data.</big></p>
<!-- INDENTATION -->
<p><big>The library supports several compression algorithms,
as indicated by the <i>Compression</i> field, including: no
compression (1),</big> CCITT <big>1D Huffman compression
(2),</big> CCITT <big>Group 3 Facsimile compression
(3),</big> CCITT <big>Group 4 Facsimile compression (4),
Lempel-Ziv &amp; Welch compression (5), baseline JPEG
compression (7), word-aligned 1D Huffman compression
(32771), and PackBits compression (32773). In addition,
several nonstandard compression algorithms are supported:
the 4-bit compression algorithm used by the
<i>ThunderScan</i> program (32809) (decompression only),
NeXT&rsquo;s 2-bit compression algorithm (32766)
(decompression only), an experimental LZ-style algorithm
known as Deflate (32946), and an experimental CIE LogLuv
compression scheme designed for images with high dynamic
range (32845 for LogL and 32845 for LogLuv). Directory
information may be in either little- or big-endian byte
order&minus;byte swapping is automatically done by the
library. Data bit ordering may be either Most Significant
Bit (</big> MSB <big>) to Least Significant Bit (</big> LSB
<big>) or</big> LSB <big>to</big> MSB. <big>Finally, the
library does not support files in which the
<i>BitsPerSample</i>, <i>Compression</i>,
<i>MinSampleValue</i>, or <i>MaxSampleValue</i> fields are
defined differently on a per-sample basis (in Rev. 6.0 the
<i>Compression</i> tag is not defined on a per-sample basis,
so this is immaterial).</big></p>
</td>
</table>
<a name="DATA TYPES"></a>
<h2>DATA TYPES</h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p><big>The library makes extensive use of C typedefs to
promote portability. Two sets of typedefs are used, one for
communication with clients of the library and one for
internal data structures and parsing of the</big> TIFF
<big>format. The following typedefs are exposed to users
either through function definitions or through parameters
passed through the varargs interfaces.</big></p></td>
</table>
<!-- TABS -->
<table width="100%" border=0 rules="none" frame="void"
       cols="3" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="15%"></td>
<td width="46%">

<p><big>typedef unsigned short uint16;</big></p>
</td>
<td width="38%">

<p><big>16-bit unsigned integer</big></p>
</td>
<tr valign="top" align="left">
<td width="15%"></td>
<td width="46%">

<p><big>typedef unsigned &lt;<i>thing</i>&gt;
uint32;</big></p>
</td>
<td width="38%">

<p><big>32-bit unsigned integer</big></p>
</td>
<tr valign="top" align="left">
<td width="15%"></td>
<td width="46%">

<p><big>typedef unsigned int ttag_t;</big></p>
</td>
<td width="38%">

<p><big>directory tag</big></p>
</td>
<tr valign="top" align="left">
<td width="15%"></td>
<td width="46%">

<p><big>typedef uint16 tdir_t;</big></p>
</td>
<td width="38%">

<p><big>directory index</big></p>
</td>
<tr valign="top" align="left">
<td width="15%"></td>
<td width="46%">

<p><big>typedef uint16 tsample_t;</big></p>
</td>
<td width="38%">

<p><big>sample number</big></p>
</td>
<tr valign="top" align="left">
<td width="15%"></td>
<td width="46%">

<p><big>typedef uint32 tstrip_t;</big></p>
</td>
<td width="38%">

<p><big>strip number</big></p>
</td>
<tr valign="top" align="left">
<td width="15%"></td>
<td width="46%">

<p><big>typedef uint32 ttile_t;</big></p>
</td>
<td width="38%">

<p><big>tile number</big></p>
</td>
<tr valign="top" align="left">
<td width="15%"></td>
<td width="46%">

<p><big>typedef int32 tsize_t;</big></p>
</td>
<td width="38%">

<p><big>i/o size in bytes</big></p>
</td>
<tr valign="top" align="left">
<td width="15%"></td>
<td width="46%">

<p><big>typedef void* tdata_t;</big></p>
</td>
<td width="38%">

<p><big>image data ref</big></p>
</td>
<tr valign="top" align="left">
<td width="15%"></td>
<td width="46%">

<p><big>typedef void* thandle_t;</big></p>
</td>
<td width="38%">

<p><big>client data handle</big></p>
</td>
<tr valign="top" align="left">
<td width="15%"></td>
<td width="46%">

<p><big>typedef int32 toff_t;</big></p>
</td>
<td width="38%">

<p><big>file offset</big></p>
</td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p><big>Note that <i>tstrip_t</i>, <i>ttile_t</i>, and
<i>tsize_t</i> are constrained to be no more than 32-bit
quantities by 32-bit fields they are stored in in the</big>
TIFF <big>image. Likewise <i>tsample_t</i> is limited by the
16-bit field used to store the <i>SamplesPerPixel</i> tag.
<i>tdir_t</i> constrains the maximum number of</big> IFDs
<big>that may appear in an image and may be an arbitrary
size (w/o penalty). <i>ttag_t</i> must be either int,
unsigned int, pointer, or double because the library uses a
varargs interface and</big> ANSI C <big>restricts the type
of the parameter before an ellipsis to be a promoted type.
<i>toff_t</i> is defined as int32 because TIFF file offsets
are (unsigned) 32-bit quantities. A signed value is used
because some interfaces return &minus;1 on error. Finally,
note that user-specified data references are passed as
opaque handles and only cast at the lowest layers where
their type is presumed.</big></p>
</td>
</table>
<a name="LIST OF ROUTINES"></a>
<h2>LIST OF ROUTINES</h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p><big>The following routines are part of the library.
Consult specific manual pages for details on their
operation; on most systems doing &lsquo;&lsquo;man
function-name&rsquo;&rsquo; will work.</big></p></td>
</table>
<!-- TABS -->

<p><big><i>Name Description</i></big></p>
<!-- TABS -->
<table width="100%" border=0 rules="none" frame="void"
       cols="3" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFCheckpointDirectory</big></p>
</td>
<td width="67%">

<p><big>writes the current state of the directory</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFCheckTile</big></p>
</td>
<td width="67%">

<p><big>very x,y,z,sample is within image</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFCIELabToRGBInit</big></p>
</td>
<td width="67%">

<p><big>initialize CIE L*a*b* 1976 to RGB conversion
state</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFCIELabToXYZ</big></p>
</td>
<td width="67%">

<p><big>perform CIE L*a*b* 1976 to CIE XYZ
conversion</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFClientOpen</big></p>
</td>
<td width="67%">

<p><big>open a file for reading or writing</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFClose</big></p>
</td>
<td width="67%">

<p><big>close an open file</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFComputeStrip</big></p>
</td>
<td width="67%">

<p><big>return strip containing y,sample</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFComputeTile</big></p>
</td>
<td width="67%">

<p><big>return tile containing x,y,z,sample</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFCurrentDirectory</big></p>
</td>
<td width="67%">

<p><big>return index of current directory</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFCurrentRow</big></p>
</td>
<td width="67%">

<p><big>return index of current scanline</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFCurrentStrip</big></p>
</td>
<td width="67%">

<p><big>return index of current strip</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFCurrentTile</big></p>
</td>
<td width="67%">

<p><big>return index of current tile</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFDataWidth</big></p>
</td>
<td width="67%">

<p><big>return the size of TIFF data types</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFError</big></p>
</td>
<td width="67%">

<p><big>library error handler</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFFdOpen</big></p>
</td>
<td width="67%">

<p><big>open a file for reading or writing</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFFileName</big></p>
</td>
<td width="67%">

<p><big>return name of open file</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFFileno</big></p>
</td>
<td width="67%">

<p><big>return open file descriptor</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFFindCODEC</big></p>
</td>
<td width="67%">

<p><big>find standard codec for the specific
scheme</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFFlush</big></p>
</td>
<td width="67%">

<p><big>flush all pending writes</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFFlushData</big></p>
</td>
<td width="67%">

<p><big>flush pending data writes</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFGetBitRevTable</big></p>
</td>
<td width="67%">

<p><big>return bit reversal table</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFGetField</big></p>
</td>
<td width="67%">

<p><big>return tag value in current directory</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFGetFieldDefaulted</big></p>
</td>
<td width="67%">

<p><big>return tag value in current directory</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFGetMode</big></p>
</td>
<td width="67%">

<p><big>return open file mode</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFGetVersion</big></p>
</td>
<td width="67%">

<p><big>return library version string</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFIsCODECConfigured</big></p>
</td>
<td width="67%">

<p><big>check, whether we have working codec</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFIsMSB2LSB</big></p>
</td>
<td width="67%">

<p><big>return true if image data is being
returned</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%"></td>
<td width="67%">

<p><big>with bit 0 as the most significant bit</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFIsTiled</big></p>
</td>
<td width="67%">

<p><big>return true if image data is tiled</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFIsByteSwapped</big></p>
</td>
<td width="67%">

<p><big>return true if image data is byte-swapped</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFNumberOfStrips</big></p>
</td>
<td width="67%">

<p><big>return number of strips in an image</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFNumberOfTiles</big></p>
</td>
<td width="67%">

<p><big>return number of tiles in an image</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFOpen</big></p>
</td>
<td width="67%">

<p><big>open a file for reading or writing</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFPrintDirectory</big></p>
</td>
<td width="67%">

<p><big>print description of the current
directory</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFReadBufferSetup</big></p>
</td>
<td width="67%">

<p><big>specify i/o buffer for reading</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFReadDirectory</big></p>
</td>
<td width="67%">

<p><big>read the next directory</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFReadEncodedStrip</big></p>
</td>
<td width="67%">

<p><big>read and decode a strip of data</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFReadEncodedTile</big></p>
</td>
<td width="67%">

<p><big>read and decode a tile of data</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFReadRawStrip</big></p>
</td>
<td width="67%">

<p><big>read a raw strip of data</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFReadRawTile</big></p>
</td>
<td width="67%">

<p><big>read a raw tile of data</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFReadRGBAImage</big></p>
</td>
<td width="67%">

<p><big>read an image into a fixed format raster</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFReadScanline</big></p>
</td>
<td width="67%">

<p><big>read and decode a row of data</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFReadTile</big></p>
</td>
<td width="67%">

<p><big>read and decode a tile of data</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFRegisterCODEC</big></p>
</td>
<td width="67%">

<p><big>override standard codec for the specific
scheme</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFReverseBits</big></p>
</td>
<td width="67%">

<p><big>reverse bits in an array of bytes</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFRGBAImageBegin</big></p>
</td>
<td width="67%">

<p><big>setup decoder state for TIFFRGBAImageGet</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFRGBAImageEnd</big></p>
</td>
<td width="67%">

<p><big>release TIFFRGBAImage decoder state</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFRGBAImageGet</big></p>
</td>
<td width="67%">

<p><big>read and decode an image</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFRGBAImageOK</big></p>
</td>
<td width="67%">

<p><big>is image readable by TIFFRGBAImageGet</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFScanlineSize</big></p>
</td>
<td width="67%">

<p><big>return size of a scanline</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFSetDirectory</big></p>
</td>
<td width="67%">

<p><big>set the current directory</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFSetSubDirectory</big></p>
</td>
<td width="67%">

<p><big>set the current directory</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFSetErrorHandler</big></p>
</td>
<td width="67%">

<p><big>set error handler function</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFSetField</big></p>
</td>
<td width="67%">

<p><big>set a tag&rsquo;s value in the current
directory</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFSetWarningHandler</big></p>
</td>
<td width="67%">

<p><big>set warning handler function</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFStripSize</big></p>
</td>
<td width="67%">

<p><big>returns size of a strip</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFRawStripSize</big></p>
</td>
<td width="67%">

<p><big>returns the number of bytes in a raw
strip</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFSwabShort</big></p>
</td>
<td width="67%">

<p><big>swap bytes of short</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFSwabLong</big></p>
</td>
<td width="67%">

<p><big>swap bytes of long</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFSwabArrayOfShort</big></p>
</td>
<td width="67%">

<p><big>swap bytes of an array of shorts</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFSwabArrayOfLong</big></p>
</td>
<td width="67%">

<p><big>swap bytes of an array of longs</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFTileRowSize</big></p>
</td>
<td width="67%">

<p><big>return size of a row in a tile</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFTileSize</big></p>
</td>
<td width="67%">

<p><big>return size of a tile</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFUnRegisterCODEC</big></p>
</td>
<td width="67%">

<p><big>unregisters the codec</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFVGetField</big></p>
</td>
<td width="67%">

<p><big>return tag value in current directory</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFVGetFieldDefaulted</big></p>
</td>
<td width="67%">

<p><big>return tag value in current directory</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFVSetField</big></p>
</td>
<td width="67%">

<p><big>set a tag&rsquo;s value in the current
directory</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFVStripSize</big></p>
</td>
<td width="67%">

<p><big>returns the number of bytes in a strip</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFWarning</big></p>
</td>
<td width="67%">

<p><big>library warning handler</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFWriteDirectory</big></p>
</td>
<td width="67%">

<p><big>write the current directory</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFWriteEncodedStrip</big></p>
</td>
<td width="67%">

<p><big>compress and write a strip of data</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFWriteEncodedTile</big></p>
</td>
<td width="67%">

<p><big>compress and write a tile of data</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFWriteRawStrip</big></p>
</td>
<td width="67%">

<p><big>write a raw strip of data</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFWriteRawTile</big></p>
</td>
<td width="67%">

<p><big>write a raw tile of data</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFWriteScanline</big></p>
</td>
<td width="67%">

<p><big>write a scanline of data</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFWriteTile</big></p>
</td>
<td width="67%">

<p><big>compress and write a tile of data</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFXYZToRGB</big></p>
</td>
<td width="67%">

<p><big>perform CIE XYZ to RGB conversion</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFYCbCrToRGBInit</big></p>
</td>
<td width="67%">

<p><big>initialize YCbCr to RGB conversion state</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>TIFFYCbCrtoRGB</big></p>
</td>
<td width="67%">

<p><big>perform YCbCr to RGB conversion</big></p>
</td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p><big>Auxiliary functions:</big></p></td>
</table>
<!-- TABS -->
<table width="100%" border=0 rules="none" frame="void"
       cols="3" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>_TIFFfree</big></p>
</td>
<td width="67%">

<p><big>free memory buffer</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>_TIFFmalloc</big></p>
</td>
<td width="67%">

<p><big>dynamically allocate memory buffer</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>_TIFFmemcmp</big></p>
</td>
<td width="67%">

<p><big>compare contents of the memory buffers</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>_TIFFmemcpy</big></p>
</td>
<td width="67%">

<p><big>copy contents of the one buffer to
another</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>_TIFFmemset</big></p>
</td>
<td width="67%">

<p><big>fill memory buffer with a constant byte</big></p>
</td>
<tr valign="top" align="left">
<td width="8%"></td>
<td width="23%">

<p><big>_TIFFrealloc</big></p>
</td>
<td width="67%">

<p><big>dynamically reallocate memory buffer</big></p>
</td>
</table>
<a name="TAG USAGE"></a>
<h2>TAG USAGE</h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p><big>The table below lists the</big> TIFF <big>tags that
are recognized and handled by the library. If no use is
indicated in the table, then the library reads and writes
the tag, but does not use it internally. Note that some tags
are meaningful only when a particul