Hex Artifact Content
Not logged in

Artifact 52251b621db28cd27f9a51cc6061f512e37013ce:

Wiki page [sql_reference_list] by sandro 2020-10-02 10:06:47.
0000: 44 20 32 30 32 30 2d 31 30 2d 30 32 54 31 30 3a  D 2020-10-02T10:
0010: 30 36 3a 34 37 2e 31 36 34 0a 4c 20 73 71 6c 5f  06:47.164.L sql_
0020: 72 65 66 65 72 65 6e 63 65 5f 6c 69 73 74 0a 50  reference_list.P
0030: 20 39 37 33 37 31 37 32 38 35 32 35 30 38 65 38   9737172852508e8
0040: 66 30 62 33 66 37 32 61 37 65 39 37 30 30 35 62  f0b3f72a7e97005b
0050: 61 63 30 65 64 36 63 65 30 0a 55 20 73 61 6e 64  ac0ed6ce0.U sand
0060: 72 6f 0a 57 20 31 35 36 38 37 37 0a 42 61 63 6b  ro.W 156877.Back
0070: 20 74 6f 20 3c 61 20 68 72 65 66 3d 22 68 74 74   to <a href="htt
0080: 70 73 3a 2f 2f 77 77 77 2e 67 61 69 61 2d 67 69  ps://www.gaia-gi
0090: 73 2e 69 74 2f 66 6f 73 73 69 6c 2f 6c 69 62 72  s.it/fossil/libr
00a0: 61 73 74 65 72 6c 69 74 65 32 2f 77 69 6b 69 3f  asterlite2/wiki?
00b0: 6e 61 6d 65 3d 72 61 73 74 65 72 6c 69 74 65 32  name=rasterlite2
00c0: 2d 64 6f 63 22 3e 52 61 73 74 65 72 4c 69 74 65  -doc">RasterLite
00d0: 32 20 64 6f 63 20 69 6e 64 65 78 3c 2f 61 3e 3c  2 doc index</a><
00e0: 68 72 3e 3c 62 72 3e 0d 0a 0d 0a 3c 68 31 3e 57  hr><br>....<h1>W
00f0: 6f 72 6b 20 69 6e 20 70 72 6f 67 72 65 73 73 3c  ork in progress<
0100: 2f 68 31 3e 0d 0a 0d 0a 3c 68 31 3e 52 61 73 74  /h1>....<h1>Rast
0110: 65 72 4c 69 74 65 32 20 53 51 4c 20 66 75 6e 63  erLite2 SQL func
0120: 74 69 6f 6e 73 20 2d 20 72 65 66 65 72 65 6e 63  tions - referenc
0130: 65 20 6c 69 73 74 3c 2f 68 31 3e 0d 0a 3c 68 72  e list</h1>..<hr
0140: 3e 0d 0a 3c 68 32 3e 53 51 4c 20 66 75 6e 63 74  >..<h2>SQL funct
0150: 69 6f 6e 73 20 73 75 70 70 6f 72 74 69 6e 67 20  ions supporting 
0160: 56 65 72 73 69 6f 6e 20 61 6e 64 20 41 72 63 68  Version and Arch
0170: 69 74 65 63 74 75 72 65 3c 2f 68 32 3e 20 0d 0a  itecture</h2> ..
0180: 3c 74 61 62 6c 65 20 77 69 64 74 68 3d 22 31 30  <table width="10
0190: 30 25 22 20 62 6f 72 64 65 72 3d 22 31 22 20 62  0%" border="1" b
01a0: 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 30 22  gcolor="#ffffe0"
01b0: 20 63 65 6c 6c 65 73 70 61 63 69 6e 67 3d 22 34   cellespacing="4
01c0: 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 36  " cellpadding="6
01d0: 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 67 63 6f  ">..<tr><th bgco
01e0: 6c 6f 72 3d 22 23 65 30 65 30 65 30 22 20 77 69  lor="#e0e0e0" wi
01f0: 64 74 68 3d 22 35 30 25 22 3e 53 79 6e 74 61 78  dth="50%">Syntax
0200: 3c 2f 74 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72  </th><th bgcolor
0210: 3d 22 23 65 30 65 30 65 30 22 20 77 69 64 74 68  ="#e0e0e0" width
0220: 3d 22 35 30 25 22 3e 53 75 6d 6d 61 72 79 3c 2f  ="50%">Summary</
0230: 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a  th></tr>..<tr>..
0240: 3c 74 64 3e 3c 62 3e 52 4c 32 5f 56 65 72 73 69  <td><b>RL2_Versi
0250: 6f 6e 3c 2f 62 3e 20 28 29 20 3a 20 3c 69 3e 53  on</b> () : <i>S
0260: 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a  tring</i></td>..
0270: 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20  <td>Will return 
0280: 74 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 52  the version of R
0290: 61 73 74 65 72 4c 69 74 65 32 20 63 75 72 72 65  asterLite2 curre
02a0: 6e 74 6c 79 20 69 6e 20 75 73 65 2e 3c 2f 74 64  ntly in use.</td
02b0: 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a  >..</tr>..<tr>..
02c0: 3c 74 64 3e 3c 62 3e 52 4c 32 5f 54 61 72 67 65  <td><b>RL2_Targe
02d0: 74 5f 43 50 55 3c 2f 62 3e 20 28 29 20 3a 20 3c  t_CPU</b> () : <
02e0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64  i>String</i></td
02f0: 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75  >..<td>Will retu
0300: 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  rn the name of t
0310: 68 65 20 43 50 55 20 61 72 63 68 69 74 65 63 74  he CPU architect
0320: 75 72 65 20 63 75 72 72 65 6e 74 6c 79 20 69 6e  ure currently in
0330: 20 75 73 65 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72   use.</td>..</tr
0340: 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e  >..<tr>..<td><b>
0350: 52 4c 32 5f 43 61 69 72 6f 5f 56 65 72 73 69 6f  RL2_Cairo_Versio
0360: 6e 3c 2f 62 3e 20 28 29 20 3a 20 3c 69 3e 53 74  n</b> () : <i>St
0370: 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c  ring</i></td>..<
0380: 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 74  td>Will return t
0390: 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 6c 69  he version of li
03a0: 62 63 61 69 72 6f 20 63 75 72 72 65 6e 74 6c 79  bcairo currently
03b0: 20 69 6e 20 75 73 65 2e 3c 2f 74 64 3e 0d 0a 3c   in use.</td>..<
03c0: 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e  /tr>..<tr>..<td>
03d0: 3c 62 3e 52 4c 32 5f 43 75 72 6c 5f 56 65 72 73  <b>RL2_Curl_Vers
03e0: 69 6f 6e 3c 2f 62 3e 20 28 29 20 3a 20 3c 69 3e  ion</b> () : <i>
03f0: 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d  String</i></td>.
0400: 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e  .<td>Will return
0410: 20 74 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20   the version of 
0420: 6c 69 62 63 75 72 6c 20 63 75 72 72 65 6e 74 6c  libcurl currentl
0430: 79 20 69 6e 20 75 73 65 2e 3c 2f 74 64 3e 0d 0a  y in use.</td>..
0440: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64  </tr>..<tr>..<td
0450: 3e 3c 62 3e 52 4c 32 5f 5a 6c 69 62 5f 56 65 72  ><b>RL2_Zlib_Ver
0460: 73 69 6f 6e 3c 2f 62 3e 20 28 29 20 3a 20 3c 69  sion</b> () : <i
0470: 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e  >String</i></td>
0480: 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72  ..<td>Will retur
0490: 6e 20 74 68 65 20 76 65 72 73 69 6f 6e 20 6f 66  n the version of
04a0: 20 7a 6c 69 62 20 28 3c 69 3e 44 45 46 4c 41 54   zlib (<i>DEFLAT
04b0: 45 3c 2f 69 3e 29 20 63 75 72 72 65 6e 74 6c 79  E</i>) currently
04c0: 20 69 6e 20 75 73 65 2e 3c 2f 74 64 3e 0d 0a 3c   in use.</td>..<
04d0: 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e  /tr>..<tr>..<td>
04e0: 3c 62 3e 52 4c 32 5f 4c 5a 4d 41 5f 56 65 72 73  <b>RL2_LZMA_Vers
04f0: 69 6f 6e 3c 2f 62 3e 20 28 29 20 3a 20 3c 69 3e  ion</b> () : <i>
0500: 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d  String</i></td>.
0510: 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e  .<td>Will return
0520: 20 74 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20   the version of 
0530: 6c 69 62 6c 7a 6d 61 20 63 75 72 72 65 6e 74 6c  liblzma currentl
0540: 79 20 69 6e 20 75 73 65 2e 3c 2f 74 64 3e 0d 0a  y in use.</td>..
0550: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64  </tr>..<tr>..<td
0560: 3e 3c 62 3e 52 4c 32 5f 4c 5a 34 5f 56 65 72 73  ><b>RL2_LZ4_Vers
0570: 69 6f 6e 3c 2f 62 3e 20 28 29 20 3a 20 3c 69 3e  ion</b> () : <i>
0580: 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d  String</i></td>.
0590: 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e  .<td>Will return
05a0: 20 74 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20   the version of 
05b0: 6c 69 62 6c 7a 34 20 63 75 72 72 65 6e 74 6c 79  liblz4 currently
05c0: 20 69 6e 20 75 73 65 2e 3c 2f 74 64 3e 0d 0a 3c   in use.</td>..<
05d0: 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e  /tr>..<tr>..<td>
05e0: 3c 62 3e 52 4c 32 5f 5a 53 54 44 5f 56 65 72 73  <b>RL2_ZSTD_Vers
05f0: 69 6f 6e 3c 2f 62 3e 20 28 29 20 3a 20 3c 69 3e  ion</b> () : <i>
0600: 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d  String</i></td>.
0610: 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e  .<td>Will return
0620: 20 74 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20   the version of 
0630: 6c 69 62 7a 73 74 64 20 63 75 72 72 65 6e 74 6c  libzstd currentl
0640: 79 20 69 6e 20 75 73 65 2e 3c 2f 74 64 3e 0d 0a  y in use.</td>..
0650: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64  </tr>..<tr>..<td
0660: 3e 3c 62 3e 52 4c 32 5f 50 4e 47 5f 56 65 72 73  ><b>RL2_PNG_Vers
0670: 69 6f 6e 3c 2f 62 3e 20 28 29 20 3a 20 3c 69 3e  ion</b> () : <i>
0680: 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d  String</i></td>.
0690: 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e  .<td>Will return
06a0: 20 74 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20   the version of 
06b0: 6c 69 62 70 6e 67 20 63 75 72 72 65 6e 74 6c 79  libpng currently
06c0: 20 69 6e 20 75 73 65 2e 3c 2f 74 64 3e 0d 0a 3c   in use.</td>..<
06d0: 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e  /tr>..<tr>..<td>
06e0: 3c 62 3e 52 4c 32 5f 4a 50 45 47 5f 56 65 72 73  <b>RL2_JPEG_Vers
06f0: 69 6f 6e 3c 2f 62 3e 20 28 29 20 3a 20 3c 69 3e  ion</b> () : <i>
0700: 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d  String</i></td>.
0710: 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e  .<td>Will return
0720: 20 74 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20   the version of 
0730: 6c 69 62 6a 70 65 67 20 28 6f 72 20 6c 69 62 6a  libjpeg (or libj
0740: 70 65 67 2d 74 75 72 62 6f 29 20 63 75 72 72 65  peg-turbo) curre
0750: 6e 74 6c 79 20 69 6e 20 75 73 65 2e 3c 2f 74 64  ntly in use.</td
0760: 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a  >..</tr>..<tr>..
0770: 3c 74 64 3e 3c 62 3e 52 4c 32 5f 54 49 46 46 5f  <td><b>RL2_TIFF_
0780: 56 65 72 73 69 6f 6e 3c 2f 62 3e 20 28 29 20 3a  Version</b> () :
0790: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f   <i>String</i></
07a0: 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 65  td>..<td>Will re
07b0: 74 75 72 6e 20 74 68 65 20 76 65 72 73 69 6f 6e  turn the version
07c0: 20 6f 66 20 6c 69 62 74 69 66 66 20 63 75 72 72   of libtiff curr
07d0: 65 6e 74 6c 79 20 69 6e 20 75 73 65 2e 3c 2f 74  ently in use.</t
07e0: 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d  d>..</tr>..<tr>.
07f0: 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 47 65 6f 54  .<td><b>RL2_GeoT
0800: 49 46 46 5f 56 65 72 73 69 6f 6e 3c 2f 62 3e 20  IFF_Version</b> 
0810: 28 29 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  () : <i>String</
0820: 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c  i></td>..<td>Wil
0830: 6c 20 72 65 74 75 72 6e 20 74 68 65 20 76 65 72  l return the ver
0840: 73 69 6f 6e 20 6f 66 20 6c 69 62 67 65 6f 74 69  sion of libgeoti
0850: 66 66 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20  ff currently in 
0860: 75 73 65 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e  use.</td>..</tr>
0870: 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52  ..<tr>..<td><b>R
0880: 4c 32 5f 57 45 42 50 5f 56 65 72 73 69 6f 6e 3c  L2_WEBP_Version<
0890: 2f 62 3e 20 28 29 20 3a 20 3c 69 3e 53 74 72 69  /b> () : <i>Stri
08a0: 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  ng</i></td>..<td
08b0: 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65  >Will return the
08c0: 20 76 65 72 73 69 6f 6e 20 6f 66 20 6c 69 62 77   version of libw
08d0: 65 62 70 20 63 75 72 72 65 6e 74 6c 79 20 69 6e  ebp currently in
08e0: 20 75 73 65 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72   use.</td>..</tr
08f0: 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e  >..<tr>..<td><b>
0900: 52 4c 32 5f 4f 70 65 6e 4a 50 45 47 5f 56 65 72  RL2_OpenJPEG_Ver
0910: 73 69 6f 6e 3c 2f 62 3e 20 28 29 20 3a 20 3c 69  sion</b> () : <i
0920: 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e  >String</i></td>
0930: 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72  ..<td>Will retur
0940: 6e 20 74 68 65 20 76 65 72 73 69 6f 6e 20 6f 66  n the version of
0950: 20 6c 69 62 6f 70 65 6e 6a 70 32 20 28 3c 69 3e   libopenjp2 (<i>
0960: 4a 70 65 67 32 30 30 30 3c 2f 69 3e 29 20 63 75  Jpeg2000</i>) cu
0970: 72 72 65 6e 74 6c 79 20 69 6e 20 75 73 65 2e 3c  rrently in use.<
0980: 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 2f 74  /td>..</tr>..</t
0990: 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 0d  able><br>..<hr>.
09a0: 0a 3c 68 32 3e 53 51 4c 20 66 75 6e 63 74 69 6f  .<h2>SQL functio
09b0: 6e 73 20 74 65 73 74 69 6e 67 20 77 68 69 63 68  ns testing which
09c0: 20 63 6f 64 65 63 73 20 61 72 65 20 61 63 74 75   codecs are actu
09d0: 61 6c 6c 79 20 73 75 70 70 6f 72 74 65 64 20 62  ally supported b
09e0: 79 20 74 68 65 20 6c 69 62 72 61 72 79 3c 2f 68  y the library</h
09f0: 32 3e 20 0d 0a 3c 74 61 62 6c 65 20 77 69 64 74  2> ..<table widt
0a00: 68 3d 22 31 30 30 25 22 20 62 6f 72 64 65 72 3d  h="100%" border=
0a10: 22 31 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66  "1" bgcolor="#ff
0a20: 66 66 65 30 22 20 63 65 6c 6c 65 73 70 61 63 69  ffe0" cellespaci
0a30: 6e 67 3d 22 34 22 20 63 65 6c 6c 70 61 64 64 69  ng="4" cellpaddi
0a40: 6e 67 3d 22 36 22 3e 0d 0a 3c 74 72 3e 3c 74 68  ng="6">..<tr><th
0a50: 20 62 67 63 6f 6c 6f 72 3d 22 23 65 30 65 30 65   bgcolor="#e0e0e
0a60: 30 22 20 77 69 64 74 68 3d 22 35 30 25 22 3e 53  0" width="50%">S
0a70: 79 6e 74 61 78 3c 2f 74 68 3e 3c 74 68 20 62 67  yntax</th><th bg
0a80: 63 6f 6c 6f 72 3d 22 23 65 30 65 30 65 30 22 20  color="#e0e0e0" 
0a90: 77 69 64 74 68 3d 22 35 30 25 22 3e 53 75 6d 6d  width="50%">Summ
0aa0: 61 72 79 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c  ary</th></tr>..<
0ab0: 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f  tr>..<td><b>RL2_
0ac0: 68 61 73 5f 63 6f 64 65 63 5f 6e 6f 6e 65 3c 2f  has_codec_none</
0ad0: 62 3e 20 28 29 20 3a 20 3c 69 3e 42 6f 6f 6c 65  b> () : <i>Boole
0ae0: 61 6e 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  an</i></td>..<td
0af0: 3e 54 65 73 74 73 20 69 66 20 74 68 65 20 4e 4f  >Tests if the NO
0b00: 4e 45 20 63 6f 64 65 63 20 69 73 20 63 75 72 72  NE codec is curr
0b10: 65 6e 74 6c 79 20 73 75 70 70 6f 72 74 65 64 2e  ently supported.
0b20: 0d 0a 3c 62 72 3e 57 69 6c 6c 20 63 6f 73 74 61  ..<br>Will costa
0b30: 6e 74 6c 79 20 72 65 74 75 72 6e 20 31 20 28 54  ntly return 1 (T
0b40: 52 55 45 29 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72  RUE).</td>..</tr
0b50: 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e  >..<tr>..<td><b>
0b60: 52 4c 32 5f 68 61 73 5f 63 6f 64 65 63 5f 64 65  RL2_has_codec_de
0b70: 66 6c 61 74 65 3c 2f 62 3e 20 28 29 20 3a 20 3c  flate</b> () : <
0b80: 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c 2f 74  i>Boolean</i></t
0b90: 64 3e 0d 0a 3c 74 64 3e 54 65 73 74 73 20 69 66  d>..<td>Tests if
0ba0: 20 74 68 65 20 44 45 46 4c 41 54 45 20 28 7a 69   the DEFLATE (zi
0bb0: 70 3a 20 77 69 74 68 20 44 65 6c 74 61 20 46 69  p: with Delta Fi
0bc0: 6c 74 65 72 29 20 63 6f 64 65 63 20 69 73 20 63  lter) codec is c
0bd0: 75 72 72 65 6e 74 6c 79 20 73 75 70 70 6f 72 74  urrently support
0be0: 65 64 2e 0d 0a 3c 62 72 3e 57 69 6c 6c 20 63 6f  ed...<br>Will co
0bf0: 73 74 61 6e 74 6c 79 20 72 65 74 75 72 6e 20 31  stantly return 1
0c00: 20 28 54 52 55 45 29 2e 3c 2f 74 64 3e 0d 0a 3c   (TRUE).</td>..<
0c10: 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e  /tr>..<tr>..<td>
0c20: 3c 62 3e 52 4c 32 5f 68 61 73 5f 63 6f 64 65 63  <b>RL2_has_codec
0c30: 5f 64 65 66 6c 61 74 65 5f 6e 6f 3c 2f 62 3e 20  _deflate_no</b> 
0c40: 28 29 20 3a 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c  () : <i>Boolean<
0c50: 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 54 65  /i></td>..<td>Te
0c60: 73 74 73 20 69 66 20 74 68 65 20 44 45 46 4c 41  sts if the DEFLA
0c70: 54 45 5f 4e 4f 20 28 7a 69 70 3a 20 77 69 74 68  TE_NO (zip: with
0c80: 6f 75 74 20 44 65 6c 74 61 20 46 69 6c 74 65 72  out Delta Filter
0c90: 29 20 63 6f 64 65 63 20 69 73 20 63 75 72 72 65  ) codec is curre
0ca0: 6e 74 6c 79 20 73 75 70 70 6f 72 74 65 64 2e 0d  ntly supported..
0cb0: 0a 3c 62 72 3e 57 69 6c 6c 20 63 6f 73 74 61 6e  .<br>Will costan
0cc0: 74 6c 79 20 72 65 74 75 72 6e 20 31 20 28 54 52  tly return 1 (TR
0cd0: 55 45 29 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e  UE).</td>..</tr>
0ce0: 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52  ..<tr>..<td><b>R
0cf0: 4c 32 5f 68 61 73 5f 63 6f 64 65 63 5f 6c 7a 6d  L2_has_codec_lzm
0d00: 61 3c 2f 62 3e 20 28 29 20 3a 20 3c 69 3e 42 6f  a</b> () : <i>Bo
0d10: 6f 6c 65 61 6e 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a  olean</i></td>..
0d20: 3c 74 64 3e 54 65 73 74 73 20 69 66 20 74 68 65  <td>Tests if the
0d30: 20 4c 5a 4d 41 20 28 37 2d 7a 69 70 3a 20 77 69   LZMA (7-zip: wi
0d40: 74 68 20 44 65 6c 74 61 20 46 69 6c 74 65 72 29  th Delta Filter)
0d50: 20 63 6f 64 65 63 20 69 73 20 63 75 72 72 65 6e   codec is curren
0d60: 74 6c 79 20 73 75 70 70 6f 72 74 65 64 2e 0d 0a  tly supported...
0d70: 3c 62 72 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20  <br>Will return 
0d80: 31 20 28 54 52 55 45 29 20 6f 72 20 30 20 28 46  1 (TRUE) or 0 (F
0d90: 41 4c 53 45 29 20 61 63 63 6f 72 64 69 6e 67 6c  ALSE) accordingl
0da0: 79 20 74 6f 20 61 63 74 75 61 6c 20 63 6f 6e 66  y to actual conf
0db0: 69 67 75 72 61 74 69 6f 6e 2e 3c 2f 74 64 3e 0d  iguration.</td>.
0dc0: 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74  .</tr>..<tr>..<t
0dd0: 64 3e 3c 62 3e 52 4c 32 5f 68 61 73 5f 63 6f 64  d><b>RL2_has_cod
0de0: 65 63 5f 6c 7a 6d 61 5f 6e 6f 3c 2f 62 3e 20 28  ec_lzma_no</b> (
0df0: 29 20 3a 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f  ) : <i>Boolean</
0e00: 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 54 65 73  i></td>..<td>Tes
0e10: 74 73 20 69 66 20 74 68 65 20 4c 5a 4d 41 5f 4e  ts if the LZMA_N
0e20: 4f 20 28 37 2d 7a 69 70 3a 20 77 69 74 68 6f 75  O (7-zip: withou
0e30: 74 20 44 65 6c 74 61 20 46 69 6c 74 65 72 29 20  t Delta Filter) 
0e40: 63 6f 64 65 63 20 69 73 20 63 75 72 72 65 6e 74  codec is current
0e50: 6c 79 20 73 75 70 70 6f 72 74 65 64 2e 0d 0a 3c  ly supported...<
0e60: 62 72 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 31  br>Will return 1
0e70: 20 28 54 52 55 45 29 20 6f 72 20 30 20 28 46 41   (TRUE) or 0 (FA
0e80: 4c 53 45 29 20 61 63 63 6f 72 64 69 6e 67 6c 79  LSE) accordingly
0e90: 20 74 6f 20 61 63 74 75 61 6c 20 63 6f 6e 66 69   to actual confi
0ea0: 67 75 72 61 74 69 6f 6e 2e 3c 2f 74 64 3e 0d 0a  guration.</td>..
0eb0: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64  </tr>..<tr>..<td
0ec0: 3e 3c 62 3e 52 4c 32 5f 68 61 73 5f 63 6f 64 65  ><b>RL2_has_code
0ed0: 63 5f 6c 7a 34 3c 2f 62 3e 20 28 29 20 3a 20 3c  c_lz4</b> () : <
0ee0: 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c 2f 74  i>Boolean</i></t
0ef0: 64 3e 0d 0a 3c 74 64 3e 54 65 73 74 73 20 69 66  d>..<td>Tests if
0f00: 20 74 68 65 20 4c 5a 34 20 28 66 61 73 74 20 6c   the LZ4 (fast l
0f10: 6f 73 73 6c 65 73 73 3a 20 77 69 74 68 20 44 65  ossless: with De
0f20: 6c 74 61 20 46 69 6c 74 65 72 29 20 63 6f 64 65  lta Filter) code
0f30: 63 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 73  c is currently s
0f40: 75 70 70 6f 72 74 65 64 2e 0d 0a 3c 62 72 3e 57  upported...<br>W
0f50: 69 6c 6c 20 72 65 74 75 72 6e 20 31 20 28 54 52  ill return 1 (TR
0f60: 55 45 29 20 6f 72 20 30 20 28 46 41 4c 53 45 29  UE) or 0 (FALSE)
0f70: 20 61 63 63 6f 72 64 69 6e 67 6c 79 20 74 6f 20   accordingly to 
0f80: 61 63 74 75 61 6c 20 63 6f 6e 66 69 67 75 72 61  actual configura
0f90: 74 69 6f 6e 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72  tion.</td>..</tr
0fa0: 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e  >..<tr>..<td><b>
0fb0: 52 4c 32 5f 68 61 73 5f 63 6f 64 65 63 5f 6c 7a  RL2_has_codec_lz
0fc0: 34 5f 6e 6f 3c 2f 62 3e 20 28 29 20 3a 20 3c 69  4_no</b> () : <i
0fd0: 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c 2f 74 64  >Boolean</i></td
0fe0: 3e 0d 0a 3c 74 64 3e 54 65 73 74 73 20 69 66 20  >..<td>Tests if 
0ff0: 74 68 65 20 4c 5a 34 5f 4e 4f 20 28 66 61 73 74  the LZ4_NO (fast
1000: 20 6c 6f 73 65 6c 65 73 73 3a 20 77 69 74 68 6f   loseless: witho
1010: 75 74 20 44 65 6c 74 61 20 46 69 6c 74 65 72 29  ut Delta Filter)
1020: 20 63 6f 64 65 63 20 69 73 20 63 75 72 72 65 6e   codec is curren
1030: 74 6c 79 20 73 75 70 70 6f 72 74 65 64 2e 0d 0a  tly supported...
1040: 3c 62 72 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20  <br>Will return 
1050: 31 20 28 54 52 55 45 29 20 6f 72 20 30 20 28 46  1 (TRUE) or 0 (F
1060: 41 4c 53 45 29 20 61 63 63 6f 72 64 69 6e 67 6c  ALSE) accordingl
1070: 79 20 74 6f 20 61 63 74 75 61 6c 20 63 6f 6e 66  y to actual conf
1080: 69 67 75 72 61 74 69 6f 6e 2e 3c 2f 74 64 3e 0d  iguration.</td>.
1090: 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74  .</tr>..<tr>..<t
10a0: 64 3e 3c 62 3e 52 4c 32 5f 68 61 73 5f 63 6f 64  d><b>RL2_has_cod
10b0: 65 63 5f 7a 73 74 64 3c 2f 62 3e 20 28 29 20 3a  ec_zstd</b> () :
10c0: 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c   <i>Boolean</i><
10d0: 2f 74 64 3e 0d 0a 3c 74 64 3e 54 65 73 74 73 20  /td>..<td>Tests 
10e0: 69 66 20 74 68 65 20 5a 53 54 44 20 28 5a 73 74  if the ZSTD (Zst
10f0: 61 6e 64 61 72 64 3a 20 77 69 74 68 20 44 65 6c  andard: with Del
1100: 74 61 20 46 69 6c 74 65 72 29 20 63 6f 64 65 63  ta Filter) codec
1110: 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 73 75   is currently su
1120: 70 70 6f 72 74 65 64 2e 0d 0a 3c 62 72 3e 57 69  pported...<br>Wi
1130: 6c 6c 20 72 65 74 75 72 6e 20 31 20 28 54 52 55  ll return 1 (TRU
1140: 45 29 20 6f 72 20 30 20 28 46 41 4c 53 45 29 20  E) or 0 (FALSE) 
1150: 61 63 63 6f 72 64 69 6e 67 6c 79 20 74 6f 20 61  accordingly to a
1160: 63 74 75 61 6c 20 63 6f 6e 66 69 67 75 72 61 74  ctual configurat
1170: 69 6f 6e 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e  ion.</td>..</tr>
1180: 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52  ..<tr>..<td><b>R
1190: 4c 32 5f 68 61 73 5f 63 6f 64 65 63 5f 7a 73 74  L2_has_codec_zst
11a0: 64 5f 6e 6f 3c 2f 62 3e 20 28 29 20 3a 20 3c 69  d_no</b> () : <i
11b0: 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c 2f 74 64  >Boolean</i></td
11c0: 3e 0d 0a 3c 74 64 3e 54 65 73 74 73 20 69 66 20  >..<td>Tests if 
11d0: 74 68 65 20 5a 53 54 44 5f 4e 4f 20 28 5a 73 74  the ZSTD_NO (Zst
11e0: 61 6e 64 61 72 64 3a 20 77 69 74 68 6f 75 74 20  andard: without 
11f0: 44 65 6c 74 61 20 46 69 6c 74 65 72 29 20 63 6f  Delta Filter) co
1200: 64 65 63 20 69 73 20 63 75 72 72 65 6e 74 6c 79  dec is currently
1210: 20 73 75 70 70 6f 72 74 65 64 2e 0d 0a 3c 62 72   supported...<br
1220: 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 31 20 28  >Will return 1 (
1230: 54 52 55 45 29 20 6f 72 20 30 20 28 46 41 4c 53  TRUE) or 0 (FALS
1240: 45 29 20 61 63 63 6f 72 64 69 6e 67 6c 79 20 74  E) accordingly t
1250: 6f 20 61 63 74 75 61 6c 20 63 6f 6e 66 69 67 75  o actual configu
1260: 72 61 74 69 6f 6e 2e 3c 2f 74 64 3e 0d 0a 3c 2f  ration.</td>..</
1270: 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c  tr>..<tr>..<td><
1280: 62 3e 52 4c 32 5f 68 61 73 5f 63 6f 64 65 63 5f  b>RL2_has_codec_
1290: 70 6e 67 3c 2f 62 3e 20 28 29 20 3a 20 3c 69 3e  png</b> () : <i>
12a0: 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c 2f 74 64 3e  Boolean</i></td>
12b0: 0d 0a 3c 74 64 3e 54 65 73 74 73 20 69 66 20 74  ..<td>Tests if t
12c0: 68 65 20 50 4e 47 20 63 6f 64 65 63 20 69 73 20  he PNG codec is 
12d0: 63 75 72 72 65 6e 74 6c 79 20 73 75 70 70 6f 72  currently suppor
12e0: 74 65 64 2e 0d 0a 3c 62 72 3e 57 69 6c 6c 20 63  ted...<br>Will c
12f0: 6f 73 74 61 6e 74 6c 79 20 72 65 74 75 72 6e 20  ostantly return 
1300: 31 20 28 54 52 55 45 29 2e 3c 2f 74 64 3e 0d 0a  1 (TRUE).</td>..
1310: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64  </tr>..<tr>..<td
1320: 3e 3c 62 3e 52 4c 32 5f 68 61 73 5f 63 6f 64 65  ><b>RL2_has_code
1330: 63 5f 6a 70 65 67 3c 2f 62 3e 20 28 29 20 3a 20  c_jpeg</b> () : 
1340: 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c 2f  <i>Boolean</i></
1350: 74 64 3e 0d 0a 3c 74 64 3e 54 65 73 74 73 20 69  td>..<td>Tests i
1360: 66 20 74 68 65 20 4a 50 45 47 20 63 6f 64 65 63  f the JPEG codec
1370: 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 73 75   is currently su
1380: 70 70 6f 72 74 65 64 2e 0d 0a 3c 62 72 3e 57 69  pported...<br>Wi
1390: 6c 6c 20 63 6f 73 74 61 6e 74 6c 79 20 72 65 74  ll costantly ret
13a0: 75 72 6e 20 31 20 28 54 52 55 45 29 2e 3c 2f 74  urn 1 (TRUE).</t
13b0: 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d  d>..</tr>..<tr>.
13c0: 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 68 61 73 5f  .<td><b>RL2_has_
13d0: 63 6f 64 65 63 5f 66 61 78 34 3c 2f 62 3e 20 28  codec_fax4</b> (
13e0: 29 20 3a 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f  ) : <i>Boolean</
13f0: 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 54 65 73  i></td>..<td>Tes
1400: 74 73 20 69 66 20 74 68 65 20 46 41 58 34 20 63  ts if the FAX4 c
1410: 6f 64 65 63 20 69 73 20 63 75 72 72 65 6e 74 6c  odec is currentl
1420: 79 20 73 75 70 70 6f 72 74 65 64 2e 0d 0a 3c 62  y supported...<b
1430: 72 3e 57 69 6c 6c 20 63 6f 73 74 61 6e 74 6c 79  r>Will costantly
1440: 20 72 65 74 75 72 6e 20 31 20 28 54 52 55 45 29   return 1 (TRUE)
1450: 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c  .</td>..</tr>..<
1460: 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f  tr>..<td><b>RL2_
1470: 68 61 73 5f 63 6f 64 65 63 5f 77 65 62 70 3c 2f  has_codec_webp</
1480: 62 3e 20 28 29 20 3a 20 3c 69 3e 42 6f 6f 6c 65  b> () : <i>Boole
1490: 61 6e 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  an</i></td>..<td
14a0: 3e 54 65 73 74 73 20 69 66 20 74 68 65 20 57 65  >Tests if the We
14b0: 62 50 20 28 6c 6f 73 73 79 29 20 63 6f 64 65 63  bP (lossy) codec
14c0: 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 73 75   is currently su
14d0: 70 70 6f 72 74 65 64 2e 0d 0a 3c 62 72 3e 57 69  pported...<br>Wi
14e0: 6c 6c 20 72 65 74 75 72 6e 20 31 20 28 54 52 55  ll return 1 (TRU
14f0: 45 29 20 6f 72 20 30 20 28 46 41 4c 53 45 29 20  E) or 0 (FALSE) 
1500: 61 63 63 6f 72 64 69 6e 67 6c 79 20 74 6f 20 61  accordingly to a
1510: 63 74 75 61 6c 20 63 6f 6e 66 69 67 75 72 61 74  ctual configurat
1520: 69 6f 6e 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e  ion.</td>..</tr>
1530: 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52  ..<tr>..<td><b>R
1540: 4c 32 5f 68 61 73 5f 63 6f 64 65 63 5f 6c 6c 5f  L2_has_codec_ll_
1550: 77 65 62 70 3c 2f 62 3e 20 28 29 20 3a 20 3c 69  webp</b> () : <i
1560: 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c 2f 74 64  >Boolean</i></td
1570: 3e 0d 0a 3c 74 64 3e 54 65 73 74 73 20 69 66 20  >..<td>Tests if 
1580: 74 68 65 20 57 65 62 50 20 28 6c 6f 73 73 6c 65  the WebP (lossle
1590: 73 73 29 20 63 6f 64 65 63 20 69 73 20 63 75 72  ss) codec is cur
15a0: 72 65 6e 74 6c 79 20 73 75 70 70 6f 72 74 65 64  rently supported
15b0: 2e 0d 0a 3c 62 72 3e 57 69 6c 6c 20 72 65 74 75  ...<br>Will retu
15c0: 72 6e 20 31 20 28 54 52 55 45 29 20 6f 72 20 30  rn 1 (TRUE) or 0
15d0: 20 28 46 41 4c 53 45 29 20 61 63 63 6f 72 64 69   (FALSE) accordi
15e0: 6e 67 6c 79 20 74 6f 20 61 63 74 75 61 6c 20 63  ngly to actual c
15f0: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 3c 2f 74  onfiguration.</t
1600: 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d  d>..</tr>..<tr>.
1610: 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 68 61 73 5f  .<td><b>RL2_has_
1620: 63 6f 64 65 63 5f 6f 70 65 6e 6a 70 65 67 3c 2f  codec_openjpeg</
1630: 62 3e 20 28 29 20 3a 20 3c 69 3e 42 6f 6f 6c 65  b> () : <i>Boole
1640: 61 6e 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  an</i></td>..<td
1650: 3e 54 65 73 74 73 20 69 66 20 74 68 65 20 4f 70  >Tests if the Op
1660: 65 6e 4a 70 65 67 20 28 4a 70 65 67 32 30 30 30  enJpeg (Jpeg2000
1670: 20 6c 6f 73 73 79 29 20 63 6f 64 65 63 20 69 73   lossy) codec is
1680: 20 63 75 72 72 65 6e 74 6c 79 20 73 75 70 70 6f   currently suppo
1690: 72 74 65 64 2e 0d 0a 3c 62 72 3e 57 69 6c 6c 20  rted...<br>Will 
16a0: 72 65 74 75 72 6e 20 31 20 28 54 52 55 45 29 20  return 1 (TRUE) 
16b0: 6f 72 20 30 20 28 46 41 4c 53 45 29 20 61 63 63  or 0 (FALSE) acc
16c0: 6f 72 64 69 6e 67 6c 79 20 74 6f 20 61 63 74 75  ordingly to actu
16d0: 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e  al configuration
16e0: 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c  .</td>..</tr>..<
16f0: 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f  tr>..<td><b>RL2_
1700: 68 61 73 5f 63 6f 64 65 63 5f 6c 6c 5f 6f 70 65  has_codec_ll_ope
1710: 6a 70 65 67 3c 2f 62 3e 20 28 29 20 3a 20 3c 69  jpeg</b> () : <i
1720: 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c 2f 74 64  >Boolean</i></td
1730: 3e 0d 0a 3c 74 64 3e 54 65 73 74 73 20 69 66 20  >..<td>Tests if 
1740: 74 68 65 20 4f 70 65 6e 4a 70 65 67 20 28 4a 70  the OpenJpeg (Jp
1750: 65 67 32 30 30 30 20 6c 6f 73 73 6c 65 73 73 29  eg2000 lossless)
1760: 20 63 6f 64 65 63 20 69 73 20 63 75 72 72 65 6e   codec is curren
1770: 74 6c 79 20 73 75 70 70 6f 72 74 65 64 2e 0d 0a  tly supported...
1780: 3c 62 72 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20  <br>Will return 
1790: 31 20 28 54 52 55 45 29 20 6f 72 20 30 20 28 46  1 (TRUE) or 0 (F
17a0: 41 4c 53 45 29 20 61 63 63 6f 72 64 69 6e 67 6c  ALSE) accordingl
17b0: 79 20 74 6f 20 61 63 74 75 61 6c 20 63 6f 6e 66  y to actual conf
17c0: 69 67 75 72 61 74 69 6f 6e 2e 3c 2f 74 64 3e 0d  iguration.</td>.
17d0: 0a 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e  .</tr>..</table>
17e0: 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a 3c 68 32 3e  <br>..<hr>..<h2>
17f0: 53 51 4c 20 66 75 6e 63 74 69 6f 6e 73 20 63 6f  SQL functions co
1800: 6e 74 72 6f 6c 6c 69 6e 67 20 70 61 72 61 6c 6c  ntrolling parall
1810: 65 6c 20 65 78 65 63 75 74 69 6f 6e 3c 2f 68 32  el execution</h2
1820: 3e 20 0d 0a 3c 74 61 62 6c 65 20 77 69 64 74 68  > ..<table width
1830: 3d 22 31 30 30 25 22 20 62 6f 72 64 65 72 3d 22  ="100%" border="
1840: 31 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66  1" bgcolor="#fff
1850: 66 65 30 22 20 63 65 6c 6c 65 73 70 61 63 69 6e  fe0" cellespacin
1860: 67 3d 22 34 22 20 63 65 6c 6c 70 61 64 64 69 6e  g="4" cellpaddin
1870: 67 3d 22 36 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20  g="6">..<tr><th 
1880: 62 67 63 6f 6c 6f 72 3d 22 23 65 30 65 30 65 30  bgcolor="#e0e0e0
1890: 22 20 77 69 64 74 68 3d 22 35 30 25 22 3e 53 79  " width="50%">Sy
18a0: 6e 74 61 78 3c 2f 74 68 3e 3c 74 68 20 62 67 63  ntax</th><th bgc
18b0: 6f 6c 6f 72 3d 22 23 65 30 65 30 65 30 22 20 77  olor="#e0e0e0" w
18c0: 69 64 74 68 3d 22 35 30 25 22 3e 53 75 6d 6d 61  idth="50%">Summa
18d0: 72 79 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74  ry</th></tr>..<t
18e0: 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 47  r>..<td><b>RL2_G
18f0: 65 74 4d 61 78 54 68 72 65 61 64 73 3c 2f 62 3e  etMaxThreads</b>
1900: 20 28 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72   () : <i>Integer
1910: 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57  </i></td>..<td>W
1920: 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65 20 63  ill return the c
1930: 75 72 72 65 6e 74 6c 79 20 73 65 74 20 4d 41 58  urrently set MAX
1940: 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6e 63 75   number of concu
1950: 72 72 65 6e 74 20 74 68 72 65 61 64 73 20 61 6c  rrent threads al
1960: 6c 6f 77 65 64 20 66 6f 72 20 70 61 72 61 6c 6c  lowed for parall
1970: 65 6c 20 65 78 65 63 75 74 69 6f 6e 2e 3c 2f 74  el execution.</t
1980: 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d  d>..</tr>..<tr>.
1990: 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 53 65 74 4d  .<td><b>RL2_SetM
19a0: 61 78 54 68 72 65 61 64 73 3c 2f 62 3e 20 28 20  axThreads</b> ( 
19b0: 3c 62 3e 6d 61 78 3c 2f 62 3e 20 3c 69 3e 49 6e  <b>max</b> <i>In
19c0: 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69  teger</i> ) : <i
19d0: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64  >Integer</i></td
19e0: 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 73 65 74 20  >..<td>Will set 
19f0: 74 68 65 20 4d 41 58 20 6e 75 6d 62 65 72 20 6f  the MAX number o
1a00: 66 20 63 6f 6e 63 75 72 72 65 6e 74 20 74 68 72  f concurrent thr
1a10: 65 61 64 73 20 61 6c 6c 6f 77 65 64 20 66 6f 72  eads allowed for
1a20: 20 70 61 72 61 6c 6c 65 6c 20 65 78 65 63 75 74   parallel execut
1a30: 69 6f 6e 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72  ion.<br>..Will r
1a40: 65 74 75 72 6e 20 74 68 65 20 4d 41 58 20 6e 75  eturn the MAX nu
1a50: 6d 62 65 72 20 6f 66 20 63 6f 6e 63 75 72 72 65  mber of concurre
1a60: 6e 74 20 74 68 72 65 61 64 73 20 61 66 74 65 72  nt threads after
1a70: 20 74 68 69 73 20 63 61 6c 6c 2e 3c 2f 74 64 3e   this call.</td>
1a80: 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64  ..</tr>..<tr><td
1a90: 20 62 67 63 6f 6c 6f 72 3d 22 64 30 66 66 64 30   bgcolor="d0ffd0
1aa0: 22 20 63 6f 6c 73 70 61 6e 3d 22 32 22 3e 0d 0a  " colspan="2">..
1ab0: 3c 68 32 3e 4e 6f 74 65 3c 2f 68 32 3e 0d 0a 54  <h2>Note</h2>..T
1ac0: 68 65 20 4d 41 58 20 6e 75 6d 62 65 72 20 6f 66  he MAX number of
1ad0: 20 63 6f 6e 63 75 72 72 65 6e 74 20 74 68 72 65   concurrent thre
1ae0: 61 64 73 20 69 73 20 61 20 3c 62 3e 67 6c 6f 62  ads is a <b>glob
1af0: 61 6c 20 6f 70 74 69 6f 6e 3c 2f 62 3e 20 73 65  al option</b> se
1b00: 74 20 61 74 20 74 68 65 20 3c 62 3e 44 42 20 63  t at the <b>DB c
1b10: 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 62 3e 20 6c 65  onnection</b> le
1b20: 76 65 6c 2e 3c 62 72 3e 0d 0a 4f 6e 63 65 20 73  vel.<br>..Once s
1b30: 65 74 2c 20 69 74 20 77 69 6c 6c 20 69 6e 66 6c  et, it will infl
1b40: 75 65 6e 63 65 20 61 6e 79 20 73 75 62 73 65 71  uence any subseq
1b50: 75 65 6e 74 20 63 61 6c 6c 20 74 6f 20 61 6e 79  uent call to any
1b60: 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 73 75   SQL function su
1b70: 70 70 6f 72 74 69 6e 67 20 70 61 72 61 6c 6c 65  pporting paralle
1b80: 6c 20 65 78 65 63 75 74 69 6f 6e 2e 3c 62 72 3e  l execution.<br>
1b90: 0d 0a 54 68 65 20 69 6e 69 74 69 61 6c 20 76 61  ..The initial va
1ba0: 6c 75 65 20 66 6f 72 20 61 6e 79 20 6e 65 77 20  lue for any new 
1bb0: 3c 62 3e 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 62  <b>connection</b
1bc0: 3e 20 69 73 20 61 6c 77 61 79 73 20 3c 62 3e 30  > is always <b>0
1bd0: 3c 2f 62 3e 2c 20 74 68 61 74 20 69 73 20 6e 6f  </b>, that is no
1be0: 20 70 61 72 61 6c 6c 65 6c 20 65 78 65 63 75 74   parallel execut
1bf0: 69 6f 6e 20 61 74 20 61 6c 6c 2e 0d 0a 3c 2f 74  ion at all...</t
1c00: 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65  d></tr>..</table
1c10: 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a 3c 68 32  ><br>..<hr>..<h2
1c20: 3e 53 51 4c 20 66 75 6e 63 74 69 6f 6e 73 20 63  >SQL functions c
1c30: 6f 6e 74 72 6f 6c 6c 69 6e 67 20 54 65 78 74 20  ontrolling Text 
1c40: 53 79 6d 62 6f 6c 69 7a 65 72 73 20 28 4d 61 70  Symbolizers (Map
1c50: 20 4c 61 62 65 6c 73 29 3c 2f 68 32 3e 20 0d 0a   Labels)</h2> ..
1c60: 3c 74 61 62 6c 65 20 77 69 64 74 68 3d 22 31 30  <table width="10
1c70: 30 25 22 20 62 6f 72 64 65 72 3d 22 31 22 20 62  0%" border="1" b
1c80: 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 30 22  gcolor="#ffffe0"
1c90: 20 63 65 6c 6c 65 73 70 61 63 69 6e 67 3d 22 34   cellespacing="4
1ca0: 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 36  " cellpadding="6
1cb0: 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 67 63 6f  ">..<tr><th bgco
1cc0: 6c 6f 72 3d 22 23 65 30 65 30 65 30 22 20 77 69  lor="#e0e0e0" wi
1cd0: 64 74 68 3d 22 35 30 25 22 3e 53 79 6e 74 61 78  dth="50%">Syntax
1ce0: 3c 2f 74 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72  </th><th bgcolor
1cf0: 3d 22 23 65 30 65 30 65 30 22 20 77 69 64 74 68  ="#e0e0e0" width
1d00: 3d 22 35 30 25 22 3e 53 75 6d 6d 61 72 79 3c 2f  ="50%">Summary</
1d10: 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a  th></tr>..<tr>..
1d20: 3c 74 64 3e 3c 62 3e 52 4c 32 5f 49 73 41 6e 74  <td><b>RL2_IsAnt
1d30: 69 4c 61 62 65 6c 43 6f 6c 6c 69 73 69 6f 6e 45  iLabelCollisionE
1d40: 6e 61 62 6c 65 64 3c 2f 62 3e 20 28 29 20 3a 20  nabled</b> () : 
1d50: 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c 2f  <i>Boolean</i></
1d60: 74 64 3e 0d 0a 3c 74 64 3e 54 65 73 74 73 20 69  td>..<td>Tests i
1d70: 66 20 74 68 65 20 41 6e 74 69 4c 61 62 65 6c 43  f the AntiLabelC
1d80: 6f 6c 6c 69 73 69 6f 6e 20 67 6c 6f 62 61 6c 20  ollision global 
1d90: 6f 70 74 69 6f 6e 20 69 73 20 63 75 72 72 65 6e  option is curren
1da0: 74 6c 79 20 61 63 74 69 76 61 74 65 64 20 6f 72  tly activated or
1db0: 20 6e 6f 74 2e 0d 0a 3c 62 72 3e 57 69 6c 6c 20   not...<br>Will 
1dc0: 72 65 74 75 72 6e 20 31 20 28 54 52 55 45 29 20  return 1 (TRUE) 
1dd0: 6f 72 20 30 20 28 46 41 4c 53 45 29 20 61 63 63  or 0 (FALSE) acc
1de0: 6f 72 64 69 6e 67 6c 79 20 74 6f 20 61 63 74 75  ordingly to actu
1df0: 61 6c 20 73 65 74 74 69 6e 67 2e 3c 2f 74 64 3e  al setting.</td>
1e00: 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74  </td>..</tr>..<t
1e10: 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 45  r>..<td><b>RL2_E
1e20: 6e 61 62 6c 65 41 6e 74 69 4c 61 62 65 6c 43 6f  nableAntiLabelCo
1e30: 6c 6c 69 73 69 6f 6e 3c 2f 62 3e 20 28 29 20 3a  llision</b> () :
1e40: 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c   <i>Boolean</i><
1e50: 2f 74 64 3e 0d 0a 3c 74 64 3e 41 63 74 69 76 61  /td>..<td>Activa
1e60: 74 65 73 20 74 68 65 20 41 6e 74 69 4c 61 62 65  tes the AntiLabe
1e70: 6c 43 6f 6c 6c 69 73 69 6f 6e 20 67 6c 6f 62 61  lCollision globa
1e80: 6c 20 6f 70 74 69 6f 6e 2e 0d 0a 3c 62 72 3e 53  l option...<br>S
1e90: 61 6d 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65  ame return value
1ea0: 20 61 73 20 69 6e 20 52 4c 32 5f 49 73 41 6e 74   as in RL2_IsAnt
1eb0: 69 4c 61 62 65 6c 43 6f 6c 6c 69 73 69 6f 6e 45  iLabelCollisionE
1ec0: 6e 61 62 6c 65 64 28 29 3c 2f 74 64 3e 3c 2f 74  nabled()</td></t
1ed0: 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d  d>..</tr>..<tr>.
1ee0: 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 44 69 73 61  .<td><b>RL2_Disa
1ef0: 62 6c 65 41 6e 74 69 4c 61 62 65 6c 43 6f 6c 6c  bleAntiLabelColl
1f00: 69 73 69 6f 6e 3c 2f 62 3e 20 28 29 20 3a 20 3c  ision</b> () : <
1f10: 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c 2f 74  i>Boolean</i></t
1f20: 64 3e 0d 0a 3c 74 64 3e 44 65 61 63 74 69 76 61  d>..<td>Deactiva
1f30: 74 65 73 20 74 68 65 20 41 6e 74 69 4c 61 62 65  tes the AntiLabe
1f40: 6c 43 6f 6c 6c 69 73 69 6f 6e 20 67 6c 6f 62 61  lCollision globa
1f50: 6c 20 6f 70 74 69 6f 6e 2e 0d 0a 3c 62 72 3e 53  l option...<br>S
1f60: 61 6d 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65  ame return value
1f70: 20 61 73 20 69 6e 20 52 4c 32 5f 49 73 41 6e 74   as in RL2_IsAnt
1f80: 69 4c 61 62 65 6c 43 6f 6c 6c 69 73 69 6f 6e 45  iLabelCollisionE
1f90: 6e 61 62 6c 65 64 28 29 3c 2f 74 64 3e 3c 2f 74  nabled()</td></t
1fa0: 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d  d>..</tr>..<tr>.
1fb0: 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 49 73 4c 61  .<td><b>RL2_IsLa
1fc0: 62 65 6c 57 72 61 70 54 65 78 74 45 6e 61 62 6c  belWrapTextEnabl
1fd0: 65 64 3c 2f 62 3e 20 28 29 20 3a 20 3c 69 3e 42  ed</b> () : <i>B
1fe0: 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c 2f 74 64 3e 0d  oolean</i></td>.
1ff0: 0a 3c 74 64 3e 54 65 73 74 73 20 69 66 20 74 68  .<td>Tests if th
2000: 65 20 4c 61 62 65 6c 57 72 61 70 54 65 78 74 20  e LabelWrapText 
2010: 67 6c 6f 62 61 6c 20 6f 70 74 69 6f 6e 20 69 73  global option is
2020: 20 63 75 72 72 65 6e 74 6c 79 20 61 63 74 69 76   currently activ
2030: 61 74 65 64 20 6f 72 20 6e 6f 74 2e 0d 0a 3c 62  ated or not...<b
2040: 72 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 31 20  r>Will return 1 
2050: 28 54 52 55 45 29 20 6f 72 20 30 20 28 46 41 4c  (TRUE) or 0 (FAL
2060: 53 45 29 20 61 63 63 6f 72 64 69 6e 67 6c 79 20  SE) accordingly 
2070: 74 6f 20 61 63 74 75 61 6c 20 73 65 74 74 69 6e  to actual settin
2080: 67 2e 3c 2f 74 64 3e 3c 2f 74 64 3e 0d 0a 3c 2f  g.</td></td>..</
2090: 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c  tr>..<tr>..<td><
20a0: 62 3e 52 4c 32 5f 45 6e 61 62 6c 65 4c 61 62 65  b>RL2_EnableLabe
20b0: 6c 57 72 61 70 54 65 78 74 3c 2f 62 3e 20 28 29  lWrapText</b> ()
20c0: 20 3a 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69   : <i>Boolean</i
20d0: 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 41 63 74 69  ></td>..<td>Acti
20e0: 76 61 74 65 73 20 74 68 65 20 4c 61 62 65 6c 57  vates the LabelW
20f0: 72 61 70 54 65 78 74 20 67 6c 6f 62 61 6c 20 6f  rapText global o
2100: 70 74 69 6f 6e 2e 0d 0a 3c 62 72 3e 53 61 6d 65  ption...<br>Same
2110: 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 61 73   return value as
2120: 20 69 6e 20 52 4c 32 5f 49 73 4c 61 62 65 6c 57   in RL2_IsLabelW
2130: 72 61 70 54 65 78 74 45 6e 61 62 6c 65 64 28 29  rapTextEnabled()
2140: 3c 2f 74 64 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72  </td></td>..</tr
2150: 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e  >..<tr>..<td><b>
2160: 52 4c 32 5f 44 69 73 61 62 6c 65 4c 61 62 65 6c  RL2_DisableLabel
2170: 57 72 61 70 54 65 78 74 3c 2f 62 3e 20 28 29 20  WrapText</b> () 
2180: 3a 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e  : <i>Boolean</i>
2190: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 44 65 61 63 74  </td>..<td>Deact
21a0: 69 76 61 74 65 73 20 74 68 65 20 4c 61 62 65 6c  ivates the Label
21b0: 57 72 61 70 54 65 78 74 20 67 6c 6f 62 61 6c 20  WrapText global 
21c0: 6f 70 74 69 6f 6e 2e 0d 0a 3c 62 72 3e 53 61 6d  option...<br>Sam
21d0: 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 61  e return value a
21e0: 73 20 69 6e 20 52 4c 32 5f 49 73 4c 61 62 65 6c  s in RL2_IsLabel
21f0: 57 72 61 70 54 65 78 74 45 6e 61 62 6c 65 64 28  WrapTextEnabled(
2200: 29 3c 2f 74 64 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74  )</td></td>..</t
2210: 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62  r>..<tr>..<td><b
2220: 3e 52 4c 32 5f 49 73 4c 61 62 65 6c 41 75 74 6f  >RL2_IsLabelAuto
2230: 72 6f 74 61 74 65 45 6e 61 62 6c 65 64 3c 2f 62  rotateEnabled</b
2240: 3e 20 28 29 20 3a 20 3c 69 3e 42 6f 6f 6c 65 61  > () : <i>Boolea
2250: 6e 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e  n</i></td>..<td>
2260: 54 65 73 74 73 20 69 66 20 74 68 65 20 4c 61 62  Tests if the Lab
2270: 65 6c 41 75 74 6f 72 6f 74 61 74 65 20 67 6c 6f  elAutorotate glo
2280: 62 61 6c 20 6f 70 74 69 6f 6e 20 69 73 20 63 75  bal option is cu
2290: 72 72 65 6e 74 6c 79 20 61 63 74 69 76 61 74 65  rrently activate
22a0: 64 20 6f 72 20 6e 6f 74 2e 0d 0a 3c 62 72 3e 57  d or not...<br>W
22b0: 69 6c 6c 20 72 65 74 75 72 6e 20 31 20 28 54 52  ill return 1 (TR
22c0: 55 45 29 20 6f 72 20 30 20 28 46 41 4c 53 45 29  UE) or 0 (FALSE)
22d0: 20 61 63 63 6f 72 64 69 6e 67 6c 79 20 74 6f 20   accordingly to 
22e0: 61 63 74 75 61 6c 20 73 65 74 74 69 6e 67 2e 3c  actual setting.<
22f0: 2f 74 64 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e  /td></td>..</tr>
2300: 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52  ..<tr>..<td><b>R
2310: 4c 32 5f 45 6e 61 62 6c 65 4c 61 62 65 6c 41 75  L2_EnableLabelAu
2320: 74 6f 72 6f 74 61 74 65 3c 2f 62 3e 20 28 29 20  torotate</b> () 
2330: 3a 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e  : <i>Boolean</i>
2340: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 41 63 74 69 76  </td>..<td>Activ
2350: 61 74 65 73 20 74 68 65 20 4c 61 62 65 6c 41 75  ates the LabelAu
2360: 74 6f 72 6f 74 61 74 65 20 67 6c 6f 62 61 6c 20  torotate global 
2370: 6f 70 74 69 6f 6e 2e 0d 0a 3c 62 72 3e 53 61 6d  option...<br>Sam
2380: 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 61  e return value a
2390: 73 20 69 6e 20 52 4c 32 5f 49 73 4c 61 62 65 6c  s in RL2_IsLabel
23a0: 41 75 74 6f 72 6f 74 61 74 65 45 6e 61 62 6c 65  AutorotateEnable
23b0: 64 28 29 3c 2f 74 64 3e 3c 2f 74 64 3e 0d 0a 3c  d()</td></td>..<
23c0: 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e  /tr>..<tr>..<td>
23d0: 3c 62 3e 52 4c 32 5f 44 69 73 61 62 6c 65 4c 61  <b>RL2_DisableLa
23e0: 62 65 6c 41 75 74 6f 72 6f 74 61 74 65 3c 2f 62  belAutorotate</b
23f0: 3e 20 28 29 20 3a 20 3c 69 3e 42 6f 6f 6c 65 61  > () : <i>Boolea
2400: 6e 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e  n</i></td>..<td>
2410: 44 65 61 63 74 69 76 61 74 65 73 20 74 68 65 20  Deactivates the 
2420: 4c 61 62 65 6c 41 75 74 6f 72 6f 74 61 74 65 20  LabelAutorotate 
2430: 67 6c 6f 62 61 6c 20 6f 70 74 69 6f 6e 2e 0d 0a  global option...
2440: 3c 62 72 3e 53 61 6d 65 20 72 65 74 75 72 6e 20  <br>Same return 
2450: 76 61 6c 75 65 20 61 73 20 69 6e 20 52 4c 32 5f  value as in RL2_
2460: 49 73 4c 61 62 65 6c 41 75 74 6f 72 6f 74 61 74  IsLabelAutorotat
2470: 65 45 6e 61 62 6c 65 64 28 29 3c 2f 74 64 3e 3c  eEnabled()</td><
2480: 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72  /td>..</tr>..<tr
2490: 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 49 73  >..<td><b>RL2_Is
24a0: 4c 61 62 65 6c 53 68 69 66 50 6f 73 69 74 69 6f  LabelShifPositio
24b0: 6e 45 6e 61 62 6c 65 64 3c 2f 62 3e 20 28 29 20  nEnabled</b> () 
24c0: 3a 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e  : <i>Boolean</i>
24d0: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 54 65 73 74 73  </td>..<td>Tests
24e0: 20 69 66 20 74 68 65 20 4c 61 62 65 6c 53 68 69   if the LabelShi
24f0: 66 50 6f 73 69 74 69 6f 6e 20 67 6c 6f 62 61 6c  fPosition global
2500: 20 6f 70 74 69 6f 6e 20 69 73 20 63 75 72 72 65   option is curre
2510: 6e 74 6c 79 20 61 63 74 69 76 61 74 65 64 20 6f  ntly activated o
2520: 72 20 6e 6f 74 2e 0d 0a 3c 62 72 3e 57 69 6c 6c  r not...<br>Will
2530: 20 72 65 74 75 72 6e 20 31 20 28 54 52 55 45 29   return 1 (TRUE)
2540: 20 6f 72 20 30 20 28 46 41 4c 53 45 29 20 61 63   or 0 (FALSE) ac
2550: 63 6f 72 64 69 6e 67 6c 79 20 74 6f 20 61 63 74  cordingly to act
2560: 75 61 6c 20 73 65 74 74 69 6e 67 2e 3c 2f 74 64  ual setting.</td
2570: 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c  ></td>..</tr>..<
2580: 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f  tr>..<td><b>RL2_
2590: 45 6e 61 62 6c 65 4c 61 62 65 6c 53 68 69 66 50  EnableLabelShifP
25a0: 6f 73 69 74 69 6f 6e 3c 2f 62 3e 20 28 29 20 3a  osition</b> () :
25b0: 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c   <i>Boolean</i><
25c0: 2f 74 64 3e 0d 0a 3c 74 64 3e 41 63 74 69 76 61  /td>..<td>Activa
25d0: 74 65 73 20 74 68 65 20 4c 61 62 65 6c 53 68 69  tes the LabelShi
25e0: 66 50 6f 73 69 74 69 6f 6e 20 67 6c 6f 62 61 6c  fPosition global
25f0: 20 6f 70 74 69 6f 6e 2e 0d 0a 3c 62 72 3e 53 61   option...<br>Sa
2600: 6d 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20  me return value 
2610: 61 73 20 69 6e 20 52 4c 32 5f 49 73 4c 61 62 65  as in RL2_IsLabe
2620: 6c 53 68 69 66 50 6f 73 69 74 69 6f 6e 45 6e 61  lShifPositionEna
2630: 62 6c 65 64 28 29 3c 2f 74 64 3e 3c 2f 74 64 3e  bled()</td></td>
2640: 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c  ..</tr>..<tr>..<
2650: 74 64 3e 3c 62 3e 52 4c 32 5f 44 69 73 61 62 6c  td><b>RL2_Disabl
2660: 65 4c 61 62 65 6c 53 68 69 66 50 6f 73 69 74 69  eLabelShifPositi
2670: 6f 6e 3c 2f 62 3e 20 28 29 20 3a 20 3c 69 3e 42  on</b> () : <i>B
2680: 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c 2f 74 64 3e 0d  oolean</i></td>.
2690: 0a 3c 74 64 3e 44 65 61 63 74 69 76 61 74 65 73  .<td>Deactivates
26a0: 20 74 68 65 20 4c 61 62 65 6c 53 68 69 66 50 6f   the LabelShifPo
26b0: 73 69 74 69 6f 6e 20 67 6c 6f 62 61 6c 20 6f 70  sition global op
26c0: 74 69 6f 6e 2e 0d 0a 3c 62 72 3e 53 61 6d 65 20  tion...<br>Same 
26d0: 72 65 74 75 72 6e 20 76 61 6c 75 65 20 61 73 20  return value as 
26e0: 69 6e 20 52 4c 32 5f 49 73 4c 61 62 65 6c 53 68  in RL2_IsLabelSh
26f0: 69 66 50 6f 73 69 74 69 6f 6e 45 6e 61 62 6c 65  ifPositionEnable
2700: 64 28 29 3c 2f 74 64 3e 3c 2f 74 64 3e 0d 0a 3c  d()</td></td>..<
2710: 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 20 62 67  /tr>..<tr><td bg
2720: 63 6f 6c 6f 72 3d 22 64 30 66 66 64 30 22 20 63  color="d0ffd0" c
2730: 6f 6c 73 70 61 6e 3d 22 32 22 3e 0d 0a 3c 68 32  olspan="2">..<h2
2740: 3e 4e 6f 74 65 3c 2f 68 32 3e 0d 0a 41 6c 6c 20  >Note</h2>..All 
2750: 74 68 65 20 61 62 6f 76 65 20 3c 62 3e 67 6c 6f  the above <b>glo
2760: 62 61 6c 20 6f 70 74 69 6f 6e 73 3c 2f 62 3e 20  bal options</b> 
2770: 61 72 65 20 73 65 74 20 61 74 20 74 68 65 20 3c  are set at the <
2780: 62 3e 44 42 20 63 6f 6e 6e 65 63 74 69 6f 6e 3c  b>DB connection<
2790: 2f 62 3e 20 6c 65 76 65 6c 2e 3c 62 72 3e 0d 0a  /b> level.<br>..
27a0: 4f 6e 63 65 20 73 65 74 2c 20 65 61 63 68 20 6f  Once set, each o
27b0: 6e 65 20 6f 66 20 74 68 65 6d 20 77 69 6c 6c 20  ne of them will 
27c0: 69 6e 66 6c 75 65 6e 63 65 20 61 6e 79 20 73 75  influence any su
27d0: 62 73 65 71 75 65 6e 74 20 63 61 6c 6c 20 74 6f  bsequent call to
27e0: 20 61 6e 79 20 53 51 4c 20 66 75 6e 63 74 69 6f   any SQL functio
27f0: 6e 20 73 75 70 70 6f 72 74 69 6e 67 20 54 65 78  n supporting Tex
2800: 74 20 53 79 6d 62 6f 6c 69 7a 65 72 73 2e 3c 62  t Symbolizers.<b
2810: 72 3e 0d 0a 54 68 65 20 69 6e 69 74 69 61 6c 20  r>..The initial 
2820: 76 61 6c 75 65 20 66 6f 72 20 61 6e 79 20 6e 65  value for any ne
2830: 77 20 3c 62 3e 63 6f 6e 6e 65 63 74 69 6f 6e 3c  w <b>connection<
2840: 2f 62 3e 20 69 73 20 61 6c 77 61 79 73 20 3c 62  /b> is always <b
2850: 3e 30 3c 2f 62 3e 20 66 6f 72 20 61 6c 6c 20 74  >0</b> for all t
2860: 68 65 6d 2c 20 74 68 61 74 20 69 73 20 6e 6f 20  hem, that is no 
2870: 73 70 65 63 69 61 6c 20 54 65 78 74 2f 4c 61 62  special Text/Lab
2880: 65 6c 20 6f 70 74 69 6f 6e 73 20 61 74 20 61 6c  el options at al
2890: 6c 2e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a  l...</td></tr>..
28a0: 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68  </table><br>..<h
28b0: 72 3e 0d 0a 3c 68 32 3e 53 51 4c 20 66 75 6e 63  r>..<h2>SQL func
28c0: 74 69 6f 6e 73 20 73 75 70 70 6f 72 74 69 6e 67  tions supporting
28d0: 20 42 4c 4f 42 20 73 65 72 69 61 6c 69 7a 65 64   BLOB serialized
28e0: 20 50 69 78 65 6c 20 6f 62 6a 65 63 74 73 3c 2f   Pixel objects</
28f0: 68 32 3e 20 0d 0a 3c 74 61 62 6c 65 20 77 69 64  h2> ..<table wid
2900: 74 68 3d 22 31 30 30 25 22 20 62 6f 72 64 65 72  th="100%" border
2910: 3d 22 31 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66  ="1" bgcolor="#f
2920: 66 66 66 65 30 22 20 63 65 6c 6c 65 73 70 61 63  fffe0" cellespac
2930: 69 6e 67 3d 22 34 22 20 63 65 6c 6c 70 61 64 64  ing="4" cellpadd
2940: 69 6e 67 3d 22 36 22 3e 0d 0a 3c 74 72 3e 3c 74  ing="6">..<tr><t
2950: 68 20 62 67 63 6f 6c 6f 72 3d 22 23 65 30 65 30  h bgcolor="#e0e0
2960: 65 30 22 20 77 69 64 74 68 3d 22 35 30 25 22 3e  e0" width="50%">
2970: 53 79 6e 74 61 78 3c 2f 74 68 3e 3c 74 68 20 62  Syntax</th><th b
2980: 67 63 6f 6c 6f 72 3d 22 23 65 30 65 30 65 30 22  gcolor="#e0e0e0"
2990: 20 77 69 64 74 68 3d 22 35 30 25 22 3e 53 75 6d   width="50%">Sum
29a0: 6d 61 72 79 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a  mary</th></tr>..
29b0: 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32  <tr>..<td><b>RL2
29c0: 5f 49 73 56 61 6c 69 64 50 69 78 65 6c 3c 2f 62  _IsValidPixel</b
29d0: 3e 20 28 20 3c 62 3e 70 69 78 65 6c 3c 2f 62 3e  > ( <b>pixel</b>
29e0: 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 20 2c 20 3c   <i>BLOB</i> , <
29f0: 62 3e 73 61 6d 70 6c 65 54 79 70 65 3c 2f 62 3e  b>sampleType</b>
2a00: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
2a10: 20 3c 62 3e 6e 75 6d 42 61 6e 64 73 3c 2f 62 3e   <b>numBands</b>
2a20: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
2a30: 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  ) : <i>Integer</
2a40: 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c  i></td>..<td>Wil
2a50: 6c 20 74 65 73 74 20 61 20 42 4c 4f 42 20 73 65  l test a BLOB se
2a60: 72 69 61 6c 69 7a 65 64 20 3c 62 3e 3c 69 3e 70  rialized <b><i>p
2a70: 69 78 65 6c 3c 2f 69 3e 3c 2f 62 3e 20 6f 62 6a  ixel</i></b> obj
2a80: 65 63 74 20 66 6f 72 20 76 61 6c 69 64 69 74 79  ect for validity
2a90: 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72 65 74 75  .<br>..Will retu
2aa0: 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28 54 52 55  rn <b>1</b> (TRU
2ab0: 45 29 20 6f 72 20 3c 62 3e 30 3c 2f 62 3e 20 28  E) or <b>0</b> (
2ac0: 46 41 4c 53 45 29 3a 20 6f 72 20 3c 62 3e 2d 31  FALSE): or <b>-1
2ad0: 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69 64 20  </b> on invalid 
2ae0: 61 72 67 75 6d 65 6e 74 73 20 6f 72 20 69 66 20  arguments or if 
2af0: 61 6e 79 20 65 72 72 6f 72 20 6f 63 63 75 72 72  any error occurr
2b00: 65 64 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d  ed.</td>..</tr>.
2b10: 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c  .<tr>..<td><b>RL
2b20: 32 5f 43 72 65 61 74 65 50 69 78 65 6c 3c 2f 62  2_CreatePixel</b
2b30: 3e 20 28 20 3c 62 3e 73 61 6d 70 6c 65 54 79 70  > ( <b>sampleTyp
2b40: 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  e</b> <i>String<
2b50: 2f 69 3e 20 2c 20 3c 62 3e 70 69 78 65 6c 54 79  /i> , <b>pixelTy
2b60: 70 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  pe</b> <i>String
2b70: 3c 2f 69 3e 20 2c 20 3c 62 3e 6e 75 6d 42 61 6e  </i> , <b>numBan
2b80: 64 73 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ds</b> <i>Intege
2b90: 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 42 4c 4f  r</i> ) : <i>BLO
2ba0: 42 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e  B</i></td>..<td>
2bb0: 57 69 6c 6c 20 72 65 74 75 72 6e 20 61 20 42 4c  Will return a BL
2bc0: 4f 42 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67  OB corresponding
2bd0: 20 74 6f 20 61 20 50 69 78 65 6c 20 73 65 72 69   to a Pixel seri
2be0: 61 6c 69 7a 65 64 20 6f 62 6a 65 63 74 3a 20 3c  alized object: <
2bf0: 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20  b>NULL</b> will 
2c00: 62 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 69  be returned on i
2c10: 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73  nvalid arguments
2c20: 20 6f 72 20 69 66 20 61 6e 79 20 65 72 72 6f 72   or if any error
2c30: 20 6f 63 63 75 72 72 65 64 2e 3c 62 72 3e 0d 0a   occurred.<br>..
2c40: 41 6c 6c 20 50 69 78 65 6c 20 63 6f 6d 70 6f 6e  All Pixel compon
2c50: 65 6e 74 73 20 77 69 6c 6c 20 62 65 20 69 6e 69  ents will be ini
2c60: 74 69 61 6c 6c 79 20 73 65 74 20 74 6f 20 3c 62  tially set to <b
2c70: 3e 5a 45 52 4f 3c 2f 62 3e 2e 3c 2f 74 64 3e 0d  >ZERO</b>.</td>.
2c80: 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74  .</tr>..<tr>..<t
2c90: 64 3e 3c 62 3e 52 4c 32 5f 47 65 74 50 69 78 65  d><b>RL2_GetPixe
2ca0: 6c 54 79 70 65 3c 2f 62 3e 20 28 20 3c 62 3e 70  lType</b> ( <b>p
2cb0: 69 78 65 6c 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42  ixel</b> <i>BLOB
2cc0: 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 74 72 69  </i> ) : <i>Stri
2cd0: 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  ng</i></td>..<td
2ce0: 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65  >Will return the
2cf0: 20 6d 6e 65 6d 6f 6e 69 63 20 50 69 78 65 6c 54   mnemonic PixelT
2d00: 79 70 65 20 66 72 6f 6d 20 61 20 50 69 78 65 6c  ype from a Pixel
2d10: 20 73 65 72 69 61 6c 69 7a 65 64 20 6f 62 6a 65   serialized obje
2d20: 63 74 3a 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20  ct: <b>NULL</b> 
2d30: 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64  will be returned
2d40: 20 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75   on invalid argu
2d50: 6d 65 6e 74 73 20 6f 72 20 69 66 20 61 6e 79 20  ments or if any 
2d60: 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 2e 3c  error occurred.<
2d70: 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72  /td>..</tr>..<tr
2d80: 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 47 65  >..<td><b>RL2_Ge
2d90: 74 50 69 78 65 6c 53 61 6d 70 6c 65 54 79 70 65  tPixelSampleType
2da0: 3c 2f 62 3e 20 28 20 3c 62 3e 70 69 78 65 6c 3c  </b> ( <b>pixel<
2db0: 2f 62 3e 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 20  /b> <i>BLOB</i> 
2dc0: 29 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  ) : <i>String</i
2dd0: 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c  ></td>..<td>Will
2de0: 20 72 65 74 75 72 6e 20 74 68 65 20 6d 6e 65 6d   return the mnem
2df0: 6f 6e 69 63 20 53 61 6d 70 6c 65 54 79 70 65 20  onic SampleType 
2e00: 66 72 6f 6d 20 61 20 50 69 78 65 6c 20 73 65 72  from a Pixel ser
2e10: 69 61 6c 69 7a 65 64 20 6f 62 6a 65 63 74 3a 20  ialized object: 
2e20: 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c  <b>NULL</b> will
2e30: 20 62 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20   be returned on 
2e40: 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74  invalid argument
2e50: 73 20 6f 72 20 69 66 20 61 6e 79 20 65 72 72 6f  s or if any erro
2e60: 72 20 6f 63 63 75 72 72 65 64 2e 3c 2f 74 64 3e  r occurred.</td>
2e70: 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c  ..</tr>..<tr>..<
2e80: 74 64 3e 3c 62 3e 52 4c 32 5f 47 65 74 50 69 78  td><b>RL2_GetPix
2e90: 65 6c 4e 75 6d 42 61 6e 64 73 3c 2f 62 3e 20 28  elNumBands</b> (
2ea0: 20 3c 62 3e 70 69 78 65 6c 3c 2f 62 3e 20 3c 69   <b>pixel</b> <i
2eb0: 3e 42 4c 4f 42 3c 2f 69 3e 20 29 20 3a 20 3c 69  >BLOB</i> ) : <i
2ec0: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64  >Integer</i></td
2ed0: 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75  >..<td>Will retu
2ee0: 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  rn the number of
2ef0: 20 42 61 6e 64 73 20 66 72 6f 6d 20 61 20 50 69   Bands from a Pi
2f00: 78 65 6c 20 73 65 72 69 61 6c 69 7a 65 64 20 6f  xel serialized o
2f10: 62 6a 65 63 74 3a 20 3c 62 3e 4e 55 4c 4c 3c 2f  bject: <b>NULL</
2f20: 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72  b> will be retur
2f30: 6e 65 64 20 6f 6e 20 69 6e 76 61 6c 69 64 20 61  ned on invalid a
2f40: 72 67 75 6d 65 6e 74 73 20 6f 72 20 69 66 20 61  rguments or if a
2f50: 6e 79 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65  ny error occurre
2f60: 64 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a  d.</td>..</tr>..
2f70: 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32  <tr>..<td><b>RL2
2f80: 5f 47 65 74 50 69 78 65 6c 56 61 6c 75 65 3c 2f  _GetPixelValue</
2f90: 62 3e 20 28 20 3c 62 3e 70 69 78 65 6c 3c 2f 62  b> ( <b>pixel</b
2fa0: 3e 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 20 2c 20  > <i>BLOB</i> , 
2fb0: 3c 62 3e 62 61 6e 64 49 6e 64 65 78 3c 2f 62 3e  <b>bandIndex</b>
2fc0: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
2fd0: 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  ) : <i>Integer</
2fe0: 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52  i><br><br>..<b>R
2ff0: 4c 32 5f 47 65 74 50 69 78 65 6c 56 61 6c 75 65  L2_GetPixelValue
3000: 3c 2f 62 3e 20 28 20 3c 62 3e 70 69 78 65 6c 3c  </b> ( <b>pixel<
3010: 2f 62 3e 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 20  /b> <i>BLOB</i> 
3020: 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 3c 2f  , <b>bandIndex</
3030: 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
3040: 3e 20 29 20 3a 20 3c 69 3e 44 6f 75 62 6c 65 3c  > ) : <i>Double<
3050: 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69  /i></td>..<td>Wi
3060: 6c 6c 20 72 65 74 75 72 6e 20 74 68 65 20 63 75  ll return the cu
3070: 72 72 65 6e 74 20 73 61 6d 70 6c 65 56 61 6c 75  rrent sampleValu
3080: 65 20 28 64 61 74 61 2d 74 79 70 65 20 77 69 6c  e (data-type wil
3090: 6c 20 6d 61 74 63 68 20 74 68 65 20 50 69 78 65  l match the Pixe
30a0: 6c 27 73 20 73 61 6d 70 6c 65 54 79 70 65 29 20  l's sampleType) 
30b0: 66 72 6f 6d 20 61 20 50 69 78 65 6c 20 73 65 72  from a Pixel ser
30c0: 69 61 6c 69 7a 65 64 20 6f 62 6a 65 63 74 3a 20  ialized object: 
30d0: 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c  <b>NULL</b> will
30e0: 20 62 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20   be returned on 
30f0: 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74  invalid argument
3100: 73 20 6f 72 20 69 66 20 61 6e 79 20 65 72 72 6f  s or if any erro
3110: 72 20 6f 63 63 75 72 72 65 64 2e 3c 62 72 3e 3c  r occurred.<br><
3120: 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75  u>Please note</u
3130: 3e 3a 20 74 68 65 20 66 69 72 73 74 20 42 61 6e  >: the first Ban
3140: 64 20 61 6c 77 61 79 73 20 63 6f 72 72 65 73 70  d always corresp
3150: 6f 6e 64 73 20 74 6f 20 69 6e 64 65 78 20 3c 62  onds to index <b
3160: 3e 5a 45 52 4f 3c 2f 62 3e 2e 3c 2f 74 64 3e 0d  >ZERO</b>.</td>.
3170: 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74  .</tr>..<tr>..<t
3180: 64 3e 3c 62 3e 52 4c 32 5f 53 65 74 50 69 78 65  d><b>RL2_SetPixe
3190: 6c 56 61 6c 75 65 3c 2f 62 3e 20 28 20 3c 62 3e  lValue</b> ( <b>
31a0: 70 69 78 65 6c 3c 2f 62 3e 20 3c 69 3e 42 4c 4f  pixel</b> <i>BLO
31b0: 42 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49  B</i> , <b>bandI
31c0: 6e 64 65 78 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  ndex</b> <i>Inte
31d0: 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 73 61 6d  ger</i> , <b>sam
31e0: 70 6c 65 56 61 6c 75 65 3c 2f 62 3e 20 3c 69 3e  pleValue</b> <i>
31f0: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20  Integer</i> ) : 
3200: 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 62 72 3e 3c  <i>BLOB</i><br><
3210: 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 53 65 74 50  br>..<b>RL2_SetP
3220: 69 78 65 6c 56 61 6c 75 65 3c 2f 62 3e 20 28 20  ixelValue</b> ( 
3230: 3c 62 3e 70 69 78 65 6c 3c 2f 62 3e 20 3c 69 3e  <b>pixel</b> <i>
3240: 42 4c 4f 42 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61  BLOB</i> , <b>ba
3250: 6e 64 49 6e 64 65 78 3c 2f 62 3e 20 3c 69 3e 49  ndIndex</b> <i>I
3260: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
3270: 73 61 6d 70 6c 65 56 61 6c 75 65 3c 2f 62 3e 20  sampleValue</b> 
3280: 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 29 20  <i>Double</i> ) 
3290: 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 2f 74  : <i>BLOB</i></t
32a0: 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74  d>..<td>Will ret
32b0: 75 72 6e 20 61 20 6e 65 77 20 42 4c 4f 42 20 63  urn a new BLOB c
32c0: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20  orresponding to 
32d0: 61 20 50 69 78 65 6c 20 73 65 72 69 61 6c 69 7a  a Pixel serializ
32e0: 65 64 20 6f 62 6a 65 63 74 20 73 75 70 70 6f 72  ed object suppor
32f0: 74 69 6e 67 20 74 68 65 20 72 65 71 75 65 73 74  ting the request
3300: 65 64 20 73 61 6d 70 6c 65 56 61 6c 75 65 20 28  ed sampleValue (
3310: 77 68 69 63 68 20 69 73 20 65 78 70 65 63 74 65  which is expecte
3320: 64 20 74 6f 20 72 65 73 70 65 63 74 20 74 68 65  d to respect the
3330: 20 70 72 65 63 69 73 69 6f 6e 20 64 65 63 6c 61   precision decla
3340: 72 65 64 20 62 79 20 74 68 65 20 73 61 6d 70 6c  red by the sampl
3350: 65 54 79 70 65 29 3a 20 3c 62 3e 4e 55 4c 4c 3c  eType): <b>NULL<
3360: 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75  /b> will be retu
3370: 72 6e 65 64 20 6f 6e 20 69 6e 76 61 6c 69 64 20  rned on invalid 
3380: 61 72 67 75 6d 65 6e 74 73 20 6f 72 20 69 66 20  arguments or if 
3390: 61 6e 79 20 65 72 72 6f 72 20 6f 63 63 75 72 72  any error occurr
33a0: 65 64 2e 3c 62 72 3e 3c 75 3e 50 6c 65 61 73 65  ed.<br><u>Please
33b0: 20 6e 6f 74 65 3c 2f 75 3e 3a 20 74 68 65 20 66   note</u>: the f
33c0: 69 72 73 74 20 42 61 6e 64 20 61 6c 77 61 79 73  irst Band always
33d0: 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20   corresponds to 
33e0: 69 6e 64 65 78 20 3c 62 3e 5a 45 52 4f 3c 2f 62  index <b>ZERO</b
33f0: 3e 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a  >.</td>..</tr>..
3400: 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32  <tr>..<td><b>RL2
3410: 5f 49 73 54 72 61 6e 73 70 61 72 65 6e 74 50 69  _IsTransparentPi
3420: 78 65 6c 3c 2f 62 3e 20 28 20 3c 62 3e 70 69 78  xel</b> ( <b>pix
3430: 65 6c 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 3c 2f  el</b> <i>BLOB</
3440: 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65  i> ) : <i>Intege
3450: 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e  r</i></td>..<td>
3460: 57 69 6c 6c 20 74 65 73 74 20 61 20 42 4c 4f 42  Will test a BLOB
3470: 20 73 65 72 69 61 6c 69 7a 65 64 20 3c 62 3e 3c   serialized <b><
3480: 69 3e 70 69 78 65 6c 3c 2f 69 3e 3c 2f 62 3e 20  i>pixel</i></b> 
3490: 6f 62 6a 65 63 74 20 66 6f 72 20 74 72 61 6e 73  object for trans
34a0: 70 61 72 65 6e 63 79 2e 3c 62 72 3e 0d 0a 57 69  parency.<br>..Wi
34b0: 6c 6c 20 72 65 74 75 72 6e 20 3c 62 3e 31 3c 2f  ll return <b>1</
34c0: 62 3e 20 28 54 52 55 45 29 20 6f 72 20 3c 62 3e  b> (TRUE) or <b>
34d0: 30 3c 2f 62 3e 20 28 46 41 4c 53 45 29 3a 20 6f  0</b> (FALSE): o
34e0: 72 20 3c 62 3e 2d 31 3c 2f 62 3e 20 6f 6e 20 69  r <b>-1</b> on i
34f0: 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73  nvalid arguments
3500: 20 6f 72 20 69 66 20 61 6e 79 20 65 72 72 6f 72   or if any error
3510: 20 6f 63 63 75 72 72 65 64 2e 3c 2f 74 64 3e 0d   occurred.</td>.
3520: 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74  .</tr>..<tr>..<t
3530: 64 3e 3c 62 3e 52 4c 32 5f 49 73 4f 70 61 71 75  d><b>RL2_IsOpaqu
3540: 65 50 69 78 65 6c 3c 2f 62 3e 20 28 20 3c 62 3e  ePixel</b> ( <b>
3550: 70 69 78 65 6c 3c 2f 62 3e 20 3c 69 3e 42 4c 4f  pixel</b> <i>BLO
3560: 42 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74  B</i> ) : <i>Int
3570: 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c  eger</i></td>..<
3580: 74 64 3e 57 69 6c 6c 20 74 65 73 74 20 61 20 42  td>Will test a B
3590: 4c 4f 42 20 73 65 72 69 61 6c 69 7a 65 64 20 3c  LOB serialized <
35a0: 62 3e 3c 69 3e 70 69 78 65 6c 3c 2f 69 3e 3c 2f  b><i>pixel</i></
35b0: 62 3e 20 6f 62 6a 65 63 74 20 66 6f 72 20 6f 70  b> object for op
35c0: 61 63 69 74 79 2e 3c 62 72 3e 0d 0a 57 69 6c 6c  acity.<br>..Will
35d0: 20 72 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e   return <b>1</b>
35e0: 20 28 54 52 55 45 29 20 6f 72 20 3c 62 3e 30 3c   (TRUE) or <b>0<
35f0: 2f 62 3e 20 28 46 41 4c 53 45 29 3a 20 6f 72 20  /b> (FALSE): or 
3600: 3c 62 3e 2d 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76  <b>-1</b> on inv
3610: 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73 20 6f  alid arguments o
3620: 72 20 69 66 20 61 6e 79 20 65 72 72 6f 72 20 6f  r if any error o
3630: 63 63 75 72 72 65 64 2e 3c 2f 74 64 3e 0d 0a 3c  ccurred.</td>..<
3640: 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e  /tr>..<tr>..<td>
3650: 3c 62 3e 52 4c 32 5f 53 65 74 54 72 61 6e 73 70  <b>RL2_SetTransp
3660: 61 72 65 6e 74 50 69 78 65 6c 3c 2f 62 3e 20 28  arentPixel</b> (
3670: 20 3c 62 3e 70 69 78 65 6c 3c 2f 62 3e 20 3c 69   <b>pixel</b> <i
3680: 3e 42 4c 4f 42 3c 2f 69 3e 20 29 20 3a 20 3c 69  >BLOB</i> ) : <i
3690: 3e 42 4c 4f 42 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a  >BLOB</i></td>..
36a0: 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20  <td>Will return 
36b0: 61 20 6e 65 77 20 42 4c 4f 42 20 63 6f 72 72 65  a new BLOB corre
36c0: 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 20 74 72  sponding to a tr
36d0: 61 6e 73 70 61 72 65 6e 74 20 50 69 78 65 6c 20  ansparent Pixel 
36e0: 73 65 72 69 61 6c 69 7a 65 64 20 6f 62 6a 65 63  serialized objec
36f0: 74 3a 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77  t: <b>NULL</b> w
3700: 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20  ill be returned 
3710: 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d  on invalid argum
3720: 65 6e 74 73 20 6f 72 20 69 66 20 61 6e 79 20 65  ents or if any e
3730: 72 72 6f 72 20 6f 63 63 75 72 72 65 64 2e 3c 2f  rror occurred.</
3740: 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e  td>..</tr>..<tr>
3750: 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 53 65 74  ..<td><b>RL2_Set
3760: 4f 70 61 71 75 65 50 69 78 65 6c 3c 2f 62 3e 20  OpaquePixel</b> 
3770: 28 20 3c 62 3e 70 69 78 65 6c 3c 2f 62 3e 20 3c  ( <b>pixel</b> <
3780: 69 3e 42 4c 4f 42 3c 2f 69 3e 20 29 20 3a 20 3c  i>BLOB</i> ) : <
3790: 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 2f 74 64 3e 0d  i>BLOB</i></td>.
37a0: 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e  .<td>Will return
37b0: 20 61 20 6e 65 77 20 42 4c 4f 42 20 63 6f 72 72   a new BLOB corr
37c0: 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 6e 20  esponding to an 
37d0: 6f 70 61 71 75 65 20 50 69 78 65 6c 20 73 65 72  opaque Pixel ser
37e0: 69 61 6c 69 7a 65 64 20 6f 62 6a 65 63 74 3a 20  ialized object: 
37f0: 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c  <b>NULL</b> will
3800: 20 62 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20   be returned on 
3810: 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74  invalid argument
3820: 73 20 6f 72 20 69 66 20 61 6e 79 20 65 72 72 6f  s or if any erro
3830: 72 20 6f 63 63 75 72 72 65 64 2e 3c 2f 74 64 3e  r occurred.</td>
3840: 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c  ..</tr>..<tr>..<
3850: 74 64 3e 3c 62 3e 52 4c 32 5f 50 69 78 65 6c 45  td><b>RL2_PixelE
3860: 71 75 61 6c 73 3c 2f 62 3e 20 28 20 3c 62 3e 70  quals</b> ( <b>p
3870: 69 78 65 6c 5f 31 3c 2f 62 3e 20 3c 69 3e 42 4c  ixel_1</b> <i>BL
3880: 4f 42 3c 2f 69 3e 20 2c 20 3c 62 3e 70 69 78 65  OB</i> , <b>pixe
3890: 6c 5f 32 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 3c  l_2</b> <i>BLOB<
38a0: 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67  /i> ) : <i>Integ
38b0: 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  er</i></td>..<td
38c0: 3e 57 69 6c 6c 20 63 6f 6d 70 61 72 65 20 74 77  >Will compare tw
38d0: 6f 20 42 4c 4f 42 20 73 65 72 69 61 6c 69 7a 65  o BLOB serialize
38e0: 64 20 3c 62 3e 3c 69 3e 70 69 78 65 6c 3c 2f 69  d <b><i>pixel</i
38f0: 3e 3c 2f 62 3e 20 6f 62 6a 65 63 74 73 20 66 6f  ></b> objects fo
3900: 72 20 69 64 65 6e 74 69 74 79 2e 3c 62 72 3e 0d  r identity.<br>.
3910: 0a 57 69 6c 6c 20 72 65 74 75 72 6e 20 3c 62 3e  .Will return <b>
3920: 31 3c 2f 62 3e 20 28 54 52 55 45 29 20 6f 72 20  1</b> (TRUE) or 
3930: 3c 62 3e 30 3c 2f 62 3e 20 28 46 41 4c 53 45 29  <b>0</b> (FALSE)
3940: 3a 20 6f 72 20 3c 62 3e 2d 31 3c 2f 62 3e 20 6f  : or <b>-1</b> o
3950: 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65  n invalid argume
3960: 6e 74 73 20 6f 72 20 69 66 20 61 6e 79 20 65 72  nts or if any er
3970: 72 6f 72 20 6f 63 63 75 72 72 65 64 2e 3c 2f 74  ror occurred.</t
3980: 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d  d>..</tr>..<tr>.
3990: 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 47 65 74 50  .<td><b>RL2_GetP
39a0: 69 78 65 6c 46 72 6f 6d 52 61 73 74 65 72 42 79  ixelFromRasterBy
39b0: 50 6f 69 6e 74 3c 2f 62 3e 20 28 20 3c 62 3e 64  Point</b> ( <b>d
39c0: 62 5f 70 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e  b_prefix</b> <i>
39d0: 54 65 78 74 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f  Text</i> , <b>co
39e0: 76 65 72 61 67 65 3c 2f 62 3e 20 3c 69 3e 54 65  verage</b> <i>Te
39f0: 78 74 3c 2f 69 3e 20 2c 20 3c 62 3e 70 6f 69 6e  xt</i> , <b>poin
3a00: 74 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65  t</b> <i>BLOB-Ge
3a10: 6f 6d 3c 2f 69 3e 20 2c 20 3c 62 3e 70 79 72 61  om</i> , <b>pyra
3a20: 6d 79 64 5f 6c 65 76 65 6c 3c 2f 62 3e 20 3c 69  myd_level</b> <i
3a30: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a  >Integer</i> ) :
3a40: 20 3c 69 3e 42 4c 4f 42 2d 50 69 78 65 6c 3c 2f   <i>BLOB-Pixel</
3a50: 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52  i><br><br>..<b>R
3a60: 4c 32 5f 47 65 74 50 69 78 65 6c 46 72 6f 6d 52  L2_GetPixelFromR
3a70: 61 73 74 65 72 42 79 50 6f 69 6e 74 3c 2f 62 3e  asterByPoint</b>
3a80: 20 28 20 3c 62 3e 64 62 5f 70 72 65 66 69 78 3c   ( <b>db_prefix<
3a90: 2f 62 3e 20 3c 69 3e 54 65 78 74 3c 2f 69 3e 20  /b> <i>Text</i> 
3aa0: 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 3c 2f 62  , <b>coverage</b
3ab0: 3e 20 3c 69 3e 54 65 78 74 3c 2f 69 3e 20 2c 20  > <i>Text</i> , 
3ac0: 3c 62 3e 70 6f 69 6e 74 3c 2f 62 3e 20 3c 69 3e  <b>point</b> <i>
3ad0: 42 4c 4f 42 2d 47 65 6f 6d 3c 2f 69 3e 20 2c 20  BLOB-Geom</i> , 
3ae0: 3c 62 3e 68 6f 72 7a 5f 72 65 73 3c 2f 62 3e 20  <b>horz_res</b> 
3af0: 3c 69 3e 44 6f 75 62 6c 65 2f 69 3e 20 2c 20 3c  <i>Double/i> , <
3b00: 62 3e 76 65 72 74 5f 72 65 73 3c 2f 62 3e 20 3c  b>vert_res</b> <
3b10: 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a  i>Double</i> ) :
3b20: 20 3c 69 3e 42 4c 4f 42 2d 50 69 78 65 6c 3c 2f   <i>BLOB-Pixel</
3b30: 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c  i></td>..<td>Wil
3b40: 6c 20 65 78 74 72 61 63 74 20 66 72 6f 6d 20 74  l extract from t
3b50: 68 65 20 52 61 73 74 65 72 20 43 6f 76 65 72 61  he Raster Covera
3b60: 67 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 79  ge identified by
3b70: 20 3c 62 3e 64 62 5f 70 72 65 66 69 78 3c 2f 62   <b>db_prefix</b
3b80: 3e 20 61 6e 64 20 3c 62 3e 63 6f 76 65 72 61 67  > and <b>coverag
3b90: 65 3c 2f 62 3e 20 74 68 65 20 70 69 78 65 6c 20  e</b> the pixel 
3ba0: 6d 61 74 63 68 69 6e 67 20 74 68 65 20 6d 61 70  matching the map
3bb0: 20 63 6f 6f 72 64 69 6e 61 74 65 73 20 73 70 65   coordinates spe
3bc0: 63 69 66 69 65 64 20 62 79 20 3c 62 3e 70 6f 69  cified by <b>poi
3bd0: 6e 74 3c 2f 62 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c  nt</b>:..<ul>..<
3be0: 6c 69 3e 61 20 3c 62 3e 4e 55 4c 4c 20 64 62 5f  li>a <b>NULL db_
3bf0: 70 72 65 66 69 78 3c 2f 62 3e 20 77 69 6c 6c 20  prefix</b> will 
3c00: 62 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79  be automatically
3c10: 20 69 6e 74 65 72 70 72 65 74 65 64 20 61 73 20   interpreted as 
3c20: 3c 62 3e 27 4d 41 49 4e 27 3c 2f 62 3e 2e 3c 2f  <b>'MAIN'</b>.</
3c30: 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e  li>..<li>the <b>
3c40: 70 6f 69 6e 74 3c 2f 62 3e 20 47 65 6f 6d 65 74  point</b> Geomet
3c50: 72 79 20 6d 75 73 74 20 69 64 65 6e 74 69 66 79  ry must identify
3c60: 20 61 20 73 69 6e 67 6c 65 20 50 4f 49 4e 54 2e   a single POINT.
3c70: 3c 62 72 3e 0d 0a 49 66 20 74 68 65 20 53 52 49  <br>..If the SRI
3c80: 44 20 64 65 63 6c 61 72 65 64 20 62 79 20 3c 62  D declared by <b
3c90: 3e 70 6f 69 6e 74 3c 2f 62 3e 20 69 73 6e 27 74  >point</b> isn't
3ca0: 20 74 68 65 20 73 61 6d 65 20 64 65 63 6c 61 72   the same declar
3cb0: 65 64 20 62 79 20 74 68 65 20 52 61 73 74 65 72  ed by the Raster
3cc0: 20 43 6f 76 65 72 61 67 65 20 74 68 65 6e 20 3c   Coverage then <
3cd0: 62 3e 70 6f 69 6e 74 3c 2f 62 3e 20 77 69 6c 6c  b>point</b> will
3ce0: 20 62 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c   be automaticall
3cf0: 79 20 72 65 70 72 6f 6a 65 63 74 65 64 20 69 6e  y reprojected in
3d00: 74 6f 20 74 68 65 20 52 61 73 74 65 72 20 43 6f  to the Raster Co
3d10: 76 65 72 61 67 65 20 6f 77 6e 20 53 52 49 44 2e  verage own SRID.
3d20: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e  </li>..</ul><br>
3d30: 0d 0a 57 69 6c 6c 20 72 65 74 75 72 6e 20 61 20  ..Will return a 
3d40: 42 4c 4f 42 20 73 65 72 69 61 6c 69 7a 65 64 20  BLOB serialized 
3d50: 3c 62 3e 3c 69 3e 70 69 78 65 6c 3c 2f 69 3e 3c  <b><i>pixel</i><
3d60: 2f 62 3e 20 6f 62 6a 65 63 74 20 6f 72 20 3c 62  /b> object or <b
3d70: 3e 4e 55 4c 4c 3c 2f 62 3e 20 6f 6e 20 69 6e 76  >NULL</b> on inv
3d80: 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73 20 6f  alid arguments o
3d90: 72 20 69 66 20 61 6e 79 20 65 72 72 6f 72 20 6f  r if any error o
3da0: 63 63 75 72 72 65 64 2e 3c 2f 74 64 3e 0d 0a 3c  ccurred.</td>..<
3db0: 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62  /tr>..</table><b
3dc0: 72 3e 0d 0a 3c 68 72 3e 0d 0a 3c 68 32 3e 53 51  r>..<hr>..<h2>SQ
3dd0: 4c 20 66 75 6e 63 74 69 6f 6e 73 20 73 75 70 70  L functions supp
3de0: 6f 72 74 69 6e 67 20 42 4c 4f 42 20 73 65 72 69  orting BLOB seri
3df0: 61 6c 69 7a 65 64 20 50 61 6c 65 74 74 65 20 6f  alized Palette o
3e00: 62 6a 65 63 74 73 3c 2f 68 32 3e 20 0d 0a 3c 74  bjects</h2> ..<t
3e10: 61 62 6c 65 20 77 69 64 74 68 3d 22 31 30 30 25  able width="100%
3e20: 22 20 62 6f 72 64 65 72 3d 22 31 22 20 62 67 63  " border="1" bgc
3e30: 6f 6c 6f 72 3d 22 23 66 66 66 66 65 30 22 20 63  olor="#ffffe0" c
3e40: 65 6c 6c 65 73 70 61 63 69 6e 67 3d 22 34 22 20  ellespacing="4" 
3e50: 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 36 22 3e  cellpadding="6">
3e60: 0d 0a 3c 74 72 3e 3c 74 68 20 62 67 63 6f 6c 6f  ..<tr><th bgcolo
3e70: 72 3d 22 23 65 30 65 30 65 30 22 20 77 69 64 74  r="#e0e0e0" widt
3e80: 68 3d 22 35 30 25 22 3e 53 79 6e 74 61 78 3c 2f  h="50%">Syntax</
3e90: 74 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22  th><th bgcolor="
3ea0: 23 65 30 65 30 65 30 22 20 77 69 64 74 68 3d 22  #e0e0e0" width="
3eb0: 35 30 25 22 3e 53 75 6d 6d 61 72 79 3c 2f 74 68  50%">Summary</th
3ec0: 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74  ></tr>..<tr>..<t
3ed0: 64 3e 3c 62 3e 52 4c 32 5f 49 73 56 61 6c 69 64  d><b>RL2_IsValid
3ee0: 52 61 73 74 65 72 50 61 6c 65 74 74 65 3c 2f 62  RasterPalette</b
3ef0: 3e 20 28 20 3c 62 3e 70 61 6c 65 74 74 65 3c 2f  > ( <b>palette</
3f00: 62 3e 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 20 2c  b> <i>BLOB</i> ,
3f10: 20 3c 62 3e 73 61 6d 70 6c 65 54 79 70 65 3c 2f   <b>sampleType</
3f20: 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
3f30: 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c   ) : <i>Integer<
3f40: 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69  /i></td>..<td>Wi
3f50: 6c 6c 20 74 65 73 74 20 61 20 42 4c 4f 42 20 73  ll test a BLOB s
3f60: 65 72 69 61 6c 69 7a 65 64 20 3c 62 3e 3c 69 3e  erialized <b><i>
3f70: 70 61 6c 65 74 74 65 3c 2f 69 3e 3c 2f 62 3e 20  palette</i></b> 
3f80: 6f 62 6a 65 63 74 20 66 6f 72 20 76 61 6c 69 64  object for valid
3f90: 69 74 79 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72  ity.<br>..Will r
3fa0: 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28  eturn <b>1</b> (
3fb0: 54 52 55 45 29 20 6f 72 20 3c 62 3e 30 3c 2f 62  TRUE) or <b>0</b
3fc0: 3e 20 28 46 41 4c 53 45 29 3a 20 6f 72 20 3c 62  > (FALSE): or <b
3fd0: 3e 2d 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c  >-1</b> on inval
3fe0: 69 64 20 61 72 67 75 6d 65 6e 74 73 20 6f 72 20  id arguments or 
3ff0: 69 66 20 61 6e 79 20 65 72 72 6f 72 20 6f 63 63  if any error occ
4000: 75 72 72 65 64 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74  urred.</td>..</t
4010: 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62  r>..<tr>..<td><b
4020: 3e 52 4c 32 5f 47 65 74 50 61 6c 65 74 74 65 4e  >RL2_GetPaletteN
4030: 75 6d 45 6e 74 72 69 65 73 3c 2f 62 3e 20 28 20  umEntries</b> ( 
4040: 3c 62 3e 70 61 6c 65 74 74 65 3c 2f 62 3e 20 3c  <b>palette</b> <
4050: 69 3e 42 4c 4f 42 3c 2f 69 3e 20 29 20 3a 20 3c  i>BLOB</i> ) : <
4060: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74  i>Integer</i></t
4070: 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74  d>..<td>Will ret
4080: 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  urn the number o
4090: 66 20 63 6f 6c 6f 72 20 65 6e 74 72 69 65 73 20  f color entries 
40a0: 66 72 6f 6d 20 61 20 50 61 6c 65 74 74 65 20 73  from a Palette s
40b0: 65 72 69 61 6c 69 7a 65 64 20 6f 62 6a 65 63 74  erialized object
40c0: 3a 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69  : <b>NULL</b> wi
40d0: 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 6f  ll be returned o
40e0: 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65  n invalid argume
40f0: 6e 74 73 20 6f 72 20 69 66 20 61 6e 79 20 65 72  nts or if any er
4100: 72 6f 72 20 6f 63 63 75 72 72 65 64 2e 3c 2f 74  ror occurred.</t
4110: 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d  d>..</tr>..<tr>.
4120: 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 47 65 74 50  .<td><b>RL2_GetP
4130: 61 6c 65 74 74 65 43 6f 6c 6f 72 45 6e 74 72 79  aletteColorEntry
4140: 3c 2f 62 3e 20 28 20 3c 62 3e 70 61 6c 65 74 74  </b> ( <b>palett
4150: 65 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 3c 2f 69  e</b> <i>BLOB</i
4160: 3e 20 2c 20 3c 62 3e 65 6e 74 72 79 49 6e 64 65  > , <b>entryInde
4170: 78 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  x</b> <i>Integer
4180: 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 74 72 69  </i> ) : <i>Stri
4190: 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  ng</i></td>..<td
41a0: 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65  >Will return the
41b0: 20 63 75 72 72 65 6e 74 20 63 6f 6c 6f 72 20 28   current color (
41c0: 48 45 58 2d 52 47 42 20 66 6f 72 6d 61 74 29 20  HEX-RGB format) 
41d0: 66 72 6f 6d 20 61 20 73 65 72 69 61 6c 69 7a 65  from a serialize
41e0: 64 20 50 61 6c 65 74 74 65 20 6f 62 6a 65 63 74  d Palette object
41f0: 20 45 6e 74 72 79 3a 20 3c 62 3e 4e 55 4c 4c 3c   Entry: <b>NULL<
4200: 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75  /b> will be retu
4210: 72 6e 65 64 20 6f 6e 20 69 6e 76 61 6c 69 64 20  rned on invalid 
4220: 61 72 67 75 6d 65 6e 74 73 20 6f 72 20 69 66 20  arguments or if 
4230: 61 6e 79 20 65 72 72 6f 72 20 6f 63 63 75 72 72  any error occurr
4240: 65 64 2e 3c 62 72 3e 3c 75 3e 50 6c 65 61 73 65  ed.<br><u>Please
4250: 20 6e 6f 74 65 3c 2f 75 3e 3a 20 74 68 65 20 66   note</u>: the f
4260: 69 72 73 74 20 50 61 6c 65 74 74 65 20 45 6e 74  irst Palette Ent
4270: 72 79 20 61 6c 77 61 79 73 20 63 6f 72 72 65 73  ry always corres
4280: 70 6f 6e 64 73 20 74 6f 20 69 6e 64 65 78 20 3c  ponds to index <
4290: 62 3e 5a 45 52 4f 3c 2f 62 3e 2e 3c 2f 74 64 3e  b>ZERO</b>.</td>
42a0: 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c  ..</tr>..<tr>..<
42b0: 74 64 3e 3c 62 3e 52 4c 32 5f 53 65 74 50 61 6c  td><b>RL2_SetPal
42c0: 65 74 74 65 43 6f 6c 6f 72 45 6e 74 72 79 3c 2f  etteColorEntry</
42d0: 62 3e 20 28 20 3c 62 3e 70 61 6c 65 74 74 65 3c  b> ( <b>palette<
42e0: 2f 62 3e 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 20  /b> <i>BLOB</i> 
42f0: 2c 20 3c 62 3e 65 6e 74 72 79 49 6e 64 65 78 3c  , <b>entryIndex<
4300: 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
4310: 69 3e 20 2c 20 3c 62 3e 68 65 78 52 67 62 43 6f  i> , <b>hexRgbCo
4320: 6c 6f 72 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  lor</b> <i>Strin
4330: 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 42 4c 4f  g</i> ) : <i>BLO
4340: 42 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e  B</i></td>..<td>
4350: 57 69 6c 6c 20 72 65 74 75 72 6e 20 61 20 6e 65  Will return a ne
4360: 77 20 42 4c 4f 42 20 63 6f 72 72 65 73 70 6f 6e  w BLOB correspon
4370: 64 69 6e 67 20 74 6f 20 61 20 50 61 6c 65 74 74  ding to a Palett
4380: 65 20 73 65 72 69 61 6c 69 7a 65 64 20 6f 62 6a  e serialized obj
4390: 65 63 74 20 73 75 70 70 6f 72 74 69 6e 67 20 74  ect supporting t
43a0: 68 65 20 63 68 61 6e 67 65 64 20 63 6f 6c 6f 72  he changed color
43b0: 20 45 6e 74 72 79 2e 0d 0a 54 68 65 20 63 6f 6c   Entry...The col
43c0: 6f 72 20 69 73 20 65 78 70 65 63 74 65 64 20 74  or is expected t
43d0: 6f 20 62 65 20 65 78 70 72 65 73 73 65 64 20 69  o be expressed i
43e0: 6e 20 74 68 65 20 63 61 6e 6f 6e 69 63 61 6c 20  n the canonical 
43f0: 57 45 42 20 48 45 58 2d 52 47 42 20 66 6f 72 6d  WEB HEX-RGB form
4400: 2c 20 61 73 20 69 6e 20 3c 62 3e 27 23 66 66 38  , as in <b>'#ff8
4410: 30 38 30 27 3c 2f 62 3e 2e 3c 62 72 3e 0d 0a 3c  080'</b>.<br>..<
4420: 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20  b>NULL</b> will 
4430: 62 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 69  be returned on i
4440: 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73  nvalid arguments
4450: 20 6f 72 20 69 66 20 61 6e 79 20 65 72 72 6f 72   or if any error
4460: 20 6f 63 63 75 72 72 65 64 2e 3c 62 72 3e 3c 75   occurred.<br><u
4470: 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e  >Please note</u>
4480: 3a 20 74 68 65 20 66 69 72 73 74 20 50 61 6c 65  : the first Pale
4490: 74 74 65 20 45 6e 74 72 79 20 61 6c 77 61 79 73  tte Entry always
44a0: 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20   corresponds to 
44b0: 69 6e 64 65 78 20 3c 62 3e 5a 45 52 4f 3c 2f 62  index <b>ZERO</b
44c0: 3e 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a  >.</td>..</tr>..
44d0: 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32  <tr>..<td><b>RL2
44e0: 5f 50 61 6c 65 74 74 65 45 71 75 61 6c 73 3c 2f  _PaletteEquals</
44f0: 62 3e 20 28 20 3c 62 3e 70 61 6c 65 74 74 65 5f  b> ( <b>palette_
4500: 31 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 3c 2f 69  1</b> <i>BLOB</i
4510: 3e 20 2c 20 3c 62 3e 70 61 6c 65 74 74 65 5f 32  > , <b>palette_2
4520: 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e  </b> <i>BLOB</i>
4530: 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c   ) : <i>Integer<
4540: 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69  /i></td>..<td>Wi
4550: 6c 6c 20 63 6f 6d 70 61 72 65 20 74 77 6f 20 42  ll compare two B
4560: 4c 4f 42 20 73 65 72 69 61 6c 69 7a 65 64 20 3c  LOB serialized <
4570: 62 3e 3c 69 3e 70 61 6c 65 74 74 65 3c 2f 69 3e  b><i>palette</i>
4580: 3c 2f 62 3e 20 6f 62 6a 65 63 74 73 20 66 6f 72  </b> objects for
4590: 20 69 64 65 6e 74 69 74 79 2e 3c 62 72 3e 0d 0a   identity.<br>..
45a0: 57 69 6c 6c 20 72 65 74 75 72 6e 20 3c 62 3e 31  Will return <b>1
45b0: 3c 2f 62 3e 20 28 54 52 55 45 29 20 6f 72 20 3c  </b> (TRUE) or <
45c0: 62 3e 30 3c 2f 62 3e 20 28 46 41 4c 53 45 29 3a  b>0</b> (FALSE):
45d0: 20 6f 72 20 3c 62 3e 2d 31 3c 2f 62 3e 20 6f 6e   or <b>-1</b> on
45e0: 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e   invalid argumen
45f0: 74 73 20 6f 72 20 69 66 20 61 6e 79 20 65 72 72  ts or if any err
4600: 6f 72 20 6f 63 63 75 72 72 65 64 2e 3c 2f 74 64  or occurred.</td
4610: 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c  >..</tr>..</tabl
4620: 65 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a 3c 68  e><br>..<hr>..<h
4630: 32 3e 53 51 4c 20 66 75 6e 63 74 69 6f 6e 73 20  2>SQL functions 
4640: 73 75 70 70 6f 72 74 69 6e 67 20 42 4c 4f 42 20  supporting BLOB 
4650: 73 65 72 69 61 6c 69 7a 65 64 20 52 61 73 74 65  serialized Raste
4660: 72 2f 42 61 6e 64 20 53 74 61 74 69 73 74 69 63  r/Band Statistic
4670: 73 20 6f 62 6a 65 63 74 73 3c 2f 68 32 3e 20 0d  s objects</h2> .
4680: 0a 3c 74 61 62 6c 65 20 77 69 64 74 68 3d 22 31  .<table width="1
4690: 30 30 25 22 20 62 6f 72 64 65 72 3d 22 31 22 20  00%" border="1" 
46a0: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 30  bgcolor="#ffffe0
46b0: 22 20 63 65 6c 6c 65 73 70 61 63 69 6e 67 3d 22  " cellespacing="
46c0: 34 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22  4" cellpadding="
46d0: 36 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 67 63  6">..<tr><th bgc
46e0: 6f 6c 6f 72 3d 22 23 65 30 65 30 65 30 22 20 77  olor="#e0e0e0" w
46f0: 69 64 74 68 3d 22 35 30 25 22 3e 53 79 6e 74 61  idth="50%">Synta
4700: 78 3c 2f 74 68 3e 3c 74 68 20 62 67 63 6f 6c 6f  x</th><th bgcolo
4710: 72 3d 22 23 65 30 65 30 65 30 22 20 77 69 64 74  r="#e0e0e0" widt
4720: 68 3d 22 35 30 25 22 3e 53 75 6d 6d 61 72 79 3c  h="50%">Summary<
4730: 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d  /th></tr>..<tr>.
4740: 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 49 73 56 61  .<td><b>RL2_IsVa
4750: 6c 69 64 52 61 73 74 65 72 53 74 61 74 69 73 74  lidRasterStatist
4760: 69 63 73 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50  ics</b> ( <b>dbP
4770: 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72  refix</b> <i>Str
4780: 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76  ing</i> , <b>cov
4790: 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69  erageName</b> <i
47a0: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
47b0: 3e 72 61 73 74 65 72 53 74 61 74 69 73 74 69 63  >rasterStatistic
47c0: 73 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 3c 2f 69  s</b> <i>BLOB</i
47d0: 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72  > ) : <i>Integer
47e0: 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62  </i><br><br>..<b
47f0: 3e 52 4c 32 5f 49 73 56 61 6c 69 64 52 61 73 74  >RL2_IsValidRast
4800: 65 72 53 74 61 74 69 73 74 69 63 73 3c 2f 62 3e  erStatistics</b>
4810: 20 28 20 3c 62 3e 72 61 73 74 65 72 53 74 61 74   ( <b>rasterStat
4820: 69 73 74 69 63 73 3c 2f 62 3e 20 3c 69 3e 42 4c  istics</b> <i>BL
4830: 4f 42 3c 2f 69 3e 20 2c 20 3c 62 3e 73 61 6d 70  OB</i> , <b>samp
4840: 6c 65 54 79 70 65 3c 2f 62 3e 20 3c 69 3e 53 74  leType</b> <i>St
4850: 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 6e 75  ring</i> , <b>nu
4860: 6d 42 61 6e 64 73 3c 2f 62 3e 20 3c 69 3e 49 6e  mBands</b> <i>In
4870: 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69  teger</i> ) : <i
4880: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64  >Integer</i></td
4890: 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 74 65 73 74  >..<td>Will test
48a0: 20 61 20 42 4c 4f 42 20 73 65 72 69 61 6c 69 7a   a BLOB serializ
48b0: 65 64 20 3c 62 3e 3c 69 3e 72 61 73 74 65 72 53  ed <b><i>rasterS
48c0: 74 61 74 69 73 74 69 63 73 3c 2f 69 3e 3c 2f 62  tatistics</i></b
48d0: 3e 20 6f 62 6a 65 63 74 20 66 6f 72 20 76 61 6c  > object for val
48e0: 69 64 69 74 79 2e 3c 62 72 3e 0d 0a 54 68 65 20  idity.<br>..The 
48f0: 3c 62 3e 3c 69 3e 64 62 50 72 65 66 69 78 3c 2f  <b><i>dbPrefix</
4900: 69 3e 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 20  i></b> argument 
4910: 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 73  is intended to s
4920: 70 65 63 69 66 79 20 74 68 65 20 41 54 54 41 43  pecify the ATTAC
4930: 48 45 44 2d 44 42 20 77 68 65 72 65 20 74 68 65  HED-DB where the
4940: 20 43 6f 76 65 72 61 67 65 20 69 73 20 65 78 70   Coverage is exp
4950: 65 63 74 65 64 20 74 6f 20 62 65 20 66 6f 75 6e  ected to be foun
4960: 64 3b 20 69 74 20 63 6f 75 6c 64 20 62 65 20 65  d; it could be e
4970: 76 65 6e 74 75 61 6c 6c 79 20 3c 62 3e 4e 55 4c  ventually <b>NUL
4980: 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69 6e 20 74 68  L</b>, and in th
4990: 69 73 20 63 61 73 65 20 74 68 65 20 3c 62 3e 4d  is case the <b>M
49a0: 41 49 4e 20 44 42 3c 2f 62 3e 20 77 69 6c 6c 20  AIN DB</b> will 
49b0: 69 6d 70 6c 69 63 69 74 6c 79 20 62 65 20 61 73  implicitly be as
49c0: 73 75 6d 65 64 2e 3c 62 72 3e 0d 0a 57 69 6c 6c  sumed.<br>..Will
49d0: 20 72 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e   return <b>1</b>
49e0: 20 28 54 52 55 45 29 20 6f 72 20 3c 62 3e 30 3c   (TRUE) or <b>0<
49f0: 2f 62 3e 20 28 46 41 4c 53 45 29 3a 20 6f 72 20  /b> (FALSE): or 
4a00: 3c 62 3e 2d 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76  <b>-1</b> on inv
4a10: 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73 20 6f  alid arguments o
4a20: 72 20 69 66 20 61 6e 79 20 65 72 72 6f 72 20 6f  r if any error o
4a30: 63 63 75 72 72 65 64 2e 3c 2f 74 64 3e 0d 0a 3c  ccurred.</td>..<
4a40: 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e  /tr>..<tr>..<td>
4a50: 3c 62 3e 52 4c 32 5f 47 65 74 52 61 73 74 65 72  <b>RL2_GetRaster
4a60: 53 74 61 74 69 73 74 69 63 73 5f 4e 6f 44 61 74  Statistics_NoDat
4a70: 61 50 69 78 65 6c 73 43 6f 75 6e 74 3c 2f 62 3e  aPixelsCount</b>
4a80: 20 28 20 3c 62 3e 72 61 73 74 65 72 53 74 61 74   ( <b>rasterStat
4a90: 69 73 74 69 63 73 3c 2f 62 3e 20 3c 69 3e 42 4c  istics</b> <i>BL
4aa0: 4f 42 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e  OB</i> ) : <i>In
4ab0: 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a  teger</i></td>..
4ac0: 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20  <td>Will return 
4ad0: 74 68 65 20 74 6f 74 61 6c 20 63 6f 75 6e 74 20  the total count 
4ae0: 6f 66 20 4e 6f 44 61 74 61 20 70 69 78 65 6c 73  of NoData pixels
4af0: 20 66 72 6f 6d 20 61 20 42 4c 4f 42 20 73 65 72   from a BLOB ser
4b00: 69 61 6c 69 7a 65 64 20 3c 62 3e 3c 69 3e 72 61  ialized <b><i>ra
4b10: 73 74 65 72 53 74 61 74 69 73 74 69 63 73 3c 2f  sterStatistics</
4b20: 69 3e 3c 2f 62 3e 20 6f 62 6a 65 63 74 3a 20 3c  i></b> object: <
4b30: 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 6f 6e 20 69 6e  b>NULL</b> on in
4b40: 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73 20  valid arguments 
4b50: 6f 72 20 69 66 20 61 6e 79 20 65 72 72 6f 72 20  or if any error 
4b60: 6f 63 63 75 72 72 65 64 2e 3c 2f 74 64 3e 0d 0a  occurred.</td>..
4b70: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64  </tr>..<tr>..<td
4b80: 3e 3c 62 3e 52 4c 32 5f 47 65 74 52 61 73 74 65  ><b>RL2_GetRaste
4b90: 72 53 74 61 74 69 73 74 69 63 73 5f 56 61 6c 69  rStatistics_Vali
4ba0: 64 50 69 78 65 6c 73 43 6f 75 6e 74 3c 2f 62 3e  dPixelsCount</b>
4bb0: 20 28 20 3c 62 3e 72 61 73 74 65 72 53 74 61 74   ( <b>rasterStat
4bc0: 69 73 74 69 63 73 3c 2f 62 3e 20 3c 69 3e 42 4c  istics</b> <i>BL
4bd0: 4f 42 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e  OB</i> ) : <i>In
4be0: 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a  teger</i></td>..
4bf0: 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20  <td>Will return 
4c00: 74 68 65 20 74 6f 74 61 6c 20 63 6f 75 6e 74 20  the total count 
4c10: 6f 66 20 76 61 6c 69 64 20 70 69 78 65 6c 73 20  of valid pixels 
4c20: 28 65 78 63 6c 75 64 69 6e 67 20 4e 6f 44 61 74  (excluding NoDat
4c30: 61 20 70 69 78 65 6c 73 29 20 66 72 6f 6d 20 61  a pixels) from a
4c40: 20 42 4c 4f 42 20 73 65 72 69 61 6c 69 7a 65 64   BLOB serialized
4c50: 20 3c 62 3e 3c 69 3e 72 61 73 74 65 72 53 74 61   <b><i>rasterSta
4c60: 74 69 73 74 69 63 73 3c 2f 69 3e 3c 2f 62 3e 20  tistics</i></b> 
4c70: 6f 62 6a 65 63 74 3a 20 3c 62 3e 4e 55 4c 4c 3c  object: <b>NULL<
4c80: 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69 64 20 61  /b> on invalid a
4c90: 72 67 75 6d 65 6e 74 73 20 6f 72 20 69 66 20 61  rguments or if a
4ca0: 6e 79 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65  ny error occurre
4cb0: 64 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a  d.</td>..</tr>..
4cc0: 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32  <tr>..<td><b>RL2
4cd0: 5f 47 65 74 52 61 73 74 65 72 53 74 61 74 69 73  _GetRasterStatis
4ce0: 74 69 63 73 5f 53 61 6d 70 6c 65 54 79 70 65 3c  tics_SampleType<
4cf0: 2f 62 3e 20 28 20 3c 62 3e 72 61 73 74 65 72 53  /b> ( <b>rasterS
4d00: 74 61 74 69 73 74 69 63 73 3c 2f 62 3e 20 3c 69  tatistics</b> <i
4d10: 3e 42 4c 4f 42 3c 2f 69 3e 20 29 20 3a 20 3c 69  >BLOB</i> ) : <i
4d20: 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e  >String</i></td>
4d30: 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72  ..<td>Will retur
4d40: 6e 20 74 68 65 20 6d 6e 65 6d 6f 6e 69 63 20 53  n the mnemonic S
4d50: 61 6d 70 6c 65 54 79 70 65 20 66 72 6f 6d 20 61  ampleType from a
4d60: 20 3c 62 3e 3c 69 3e 72 61 73 74 65 72 53 74 61   <b><i>rasterSta
4d70: 74 69 73 74 69 63 73 3c 2f 69 3e 3c 2f 62 3e 20  tistics</i></b> 
4d80: 73 65 72 69 61 6c 69 7a 65 64 20 6f 62 6a 65 63  serialized objec
4d90: 74 3a 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 6f  t: <b>NULL</b> o
4da0: 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65  n invalid argume
4db0: 6e 74 73 20 6f 72 20 69 66 20 61 6e 79 20 65 72  nts or if any er
4dc0: 72 6f 72 20 6f 63 63 75 72 72 65 64 2e 3c 2f 74  ror occurred.</t
4dd0: 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d  d>..</tr>..<tr>.
4de0: 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 47 65 74 52  .<td><b>RL2_GetR
4df0: 61 73 74 65 72 53 74 61 74 69 73 74 69 63 73 5f  asterStatistics_
4e00: 42 61 6e 64 73 43 6f 75 6e 74 3c 2f 62 3e 20 28  BandsCount</b> (
4e10: 20 3c 62 3e 72 61 73 74 65 72 53 74 61 74 69 73   <b>rasterStatis
4e20: 74 69 63 73 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42  tics</b> <i>BLOB
4e30: 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 74 72 69  </i> ) : <i>Stri
4e40: 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  ng</i></td>..<td
4e50: 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65  >Will return the
4e60: 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66   total number of
4e70: 20 73 75 70 70 6f 72 74 65 64 20 42 61 6e 64 73   supported Bands
4e80: 20 66 72 6f 6d 20 61 20 3c 62 3e 3c 69 3e 72 61   from a <b><i>ra
4e90: 73 74 65 72 53 74 61 74 69 73 74 69 63 73 3c 2f  sterStatistics</
4ea0: 69 3e 3c 2f 62 3e 20 73 65 72 69 61 6c 69 7a 65  i></b> serialize
4eb0: 64 20 6f 62 6a 65 63 74 3a 20 3c 62 3e 4e 55 4c  d object: <b>NUL
4ec0: 4c 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69 64  L</b> on invalid
4ed0: 20 61 72 67 75 6d 65 6e 74 73 20 6f 72 20 69 66   arguments or if
4ee0: 20 61 6e 79 20 65 72 72 6f 72 20 6f 63 63 75 72   any error occur
4ef0: 72 65 64 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e  red.</td>..</tr>
4f00: 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52  ..<tr>..<td><b>R
4f10: 4c 32 5f 47 65 74 42 61 6e 64 53 74 61 74 69 73  L2_GetBandStatis
4f20: 74 69 63 73 5f 4d 69 6e 3c 2f 62 3e 20 28 20 3c  tics_Min</b> ( <
4f30: 62 3e 72 61 73 74 65 72 53 74 61 74 69 73 74 69  b>rasterStatisti
4f40: 63 73 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 3c 2f  cs</b> <i>BLOB</
4f50: 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65  i> , <b>bandInde
4f60: 78 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  x</b> <i>Integer
4f70: 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 44 6f 75 62  </i> ) : <i>Doub
4f80: 6c 65 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  le</i></td>..<td
4f90: 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65  >Will return the
4fa0: 20 4d 69 6e 69 6d 75 6d 20 76 61 6c 75 65 20 66   Minimum value f
4fb0: 72 6f 6d 20 61 20 73 70 65 63 69 66 69 63 20 42  rom a specific B
4fc0: 61 6e 64 20 6f 66 20 61 20 3c 62 3e 3c 69 3e 72  and of a <b><i>r
4fd0: 61 73 74 65 72 53 74 61 74 69 73 74 69 63 73 3c  asterStatistics<
4fe0: 2f 69 3e 3c 2f 62 3e 20 73 65 72 69 61 6c 69 7a  /i></b> serializ
4ff0: 65 64 20 6f 62 6a 65 63 74 3a 20 3c 62 3e 4e 55  ed object: <b>NU
5000: 4c 4c 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69  LL</b> on invali
5010: 64 20 61 72 67 75 6d 65 6e 74 73 20 6f 72 20 69  d arguments or i
5020: 66 20 61 6e 79 20 65 72 72 6f 72 20 6f 63 63 75  f any error occu
5030: 72 72 65 64 2e 3c 62 72 3e 3c 75 3e 50 6c 65 61  rred.<br><u>Plea
5040: 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 74 68 65  se note</u>: the
5050: 20 66 69 72 73 74 20 42 61 6e 64 20 61 6c 77 61   first Band alwa
5060: 79 73 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74  ys corresponds t
5070: 6f 20 69 6e 64 65 78 20 3c 62 3e 5a 45 52 4f 3c  o index <b>ZERO<
5080: 2f 62 3e 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e  /b>.</td>..</tr>
5090: 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52  ..<tr>..<td><b>R
50a0: 4c 32 5f 47 65 74 42 61 6e 64 53 74 61 74 69 73  L2_GetBandStatis
50b0: 74 69 63 73 5f 4d 61 78 3c 2f 62 3e 20 28 20 3c  tics_Max</b> ( <
50c0: 62 3e 72 61 73 74 65 72 53 74 61 74 69 73 74 69  b>rasterStatisti
50d0: 63 73 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 3c 2f  cs</b> <i>BLOB</
50e0: 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65  i> , <b>bandInde
50f0: 78 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  x</b> <i>Integer
5100: 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 44 6f 75 62  </i> ) : <i>Doub
5110: 6c 65 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  le</i></td>..<td
5120: 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65  >Will return the
5130: 20 4d 61 78 69 6d 75 6d 20 76 61 6c 75 65 20 66   Maximum value f
5140: 72 6f 6d 20 61 20 73 70 65 63 69 66 69 63 20 42  rom a specific B
5150: 61 6e 64 20 6f 66 20 61 20 3c 62 3e 3c 69 3e 72  and of a <b><i>r
5160: 61 73 74 65 72 53 74 61 74 69 73 74 69 63 73 3c  asterStatistics<
5170: 2f 69 3e 3c 2f 62 3e 20 73 65 72 69 61 6c 69 7a  /i></b> serializ
5180: 65 64 20 6f 62 6a 65 63 74 3a 20 3c 62 3e 4e 55  ed object: <b>NU
5190: 4c 4c 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69  LL</b> on invali
51a0: 64 20 61 72 67 75 6d 65 6e 74 73 20 6f 72 20 69  d arguments or i
51b0: 66 20 61 6e 79 20 65 72 72 6f 72 20 6f 63 63 75  f any error occu
51c0: 72 72 65 64 2e 3c 62 72 3e 3c 75 3e 50 6c 65 61  rred.<br><u>Plea
51d0: 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 74 68 65  se note</u>: the
51e0: 20 66 69 72 73 74 20 42 61 6e 64 20 61 6c 77 61   first Band alwa
51f0: 79 73 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74  ys corresponds t
5200: 6f 20 69 6e 64 65 78 20 3c 62 3e 5a 45 52 4f 3c  o index <b>ZERO<
5210: 2f 62 3e 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e  /b>.</td>..</tr>
5220: 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52  ..<tr>..<td><b>R
5230: 4c 32 5f 47 65 74 42 61 6e 64 53 74 61 74 69 73  L2_GetBandStatis
5240: 74 69 63 73 5f 41 76 67 3c 2f 62 3e 20 28 20 3c  tics_Avg</b> ( <
5250: 62 3e 72 61 73 74 65 72 53 74 61 74 69 73 74 69  b>rasterStatisti
5260: 63 73 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 3c 2f  cs</b> <i>BLOB</
5270: 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65  i> , <b>bandInde
5280: 78 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  x</b> <i>Integer
5290: 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 44 6f 75 62  </i> ) : <i>Doub
52a0: 6c 65 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  le</i></td>..<td
52b0: 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65  >Will return the
52c0: 20 41 76 65 72 61 67 65 2f 4d 65 61 6e 20 76 61   Average/Mean va
52d0: 6c 75 65 20 66 72 6f 6d 20 61 20 73 70 65 63 69  lue from a speci
52e0: 66 69 63 20 42 61 6e 64 20 6f 66 20 61 20 3c 62  fic Band of a <b
52f0: 3e 3c 69 3e 72 61 73 74 65 72 53 74 61 74 69 73  ><i>rasterStatis
5300: 74 69 63 73 3c 2f 69 3e 3c 2f 62 3e 20 73 65 72  tics</i></b> ser
5310: 69 61 6c 69 7a 65 64 20 6f 62 6a 65 63 74 3a 20  ialized object: 
5320: 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 6f 6e 20 69  <b>NULL</b> on i
5330: 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73  nvalid arguments
5340: 20 6f 72 20 69 66 20 61 6e 79 20 65 72 72 6f 72   or if any error
5350: 20 6f 63 63 75 72 72 65 64 2e 3c 62 72 3e 3c 75   occurred.<br><u
5360: 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e  >Please note</u>
5370: 3a 20 74 68 65 20 66 69 72 73 74 20 42 61 6e 64  : the first Band
5380: 20 61 6c 77 61 79 73 20 63 6f 72 72 65 73 70 6f   always correspo
5390: 6e 64 73 20 74 6f 20 69 6e 64 65 78 20 3c 62 3e  nds to index <b>
53a0: 5a 45 52 4f 3c 2f 62 3e 2e 3c 2f 74 64 3e 0d 0a  ZERO</b>.</td>..
53b0: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64  </tr>..<tr>..<td
53c0: 3e 3c 62 3e 52 4c 32 5f 47 65 74 42 61 6e 64 53  ><b>RL2_GetBandS
53d0: 74 61 74 69 73 74 69 63 73 5f 56 61 72 3c 2f 62  tatistics_Var</b
53e0: 3e 20 28 20 3c 62 3e 72 61 73 74 65 72 53 74 61  > ( <b>rasterSta
53f0: 74 69 73 74 69 63 73 3c 2f 62 3e 20 3c 69 3e 42  tistics</b> <i>B
5400: 4c 4f 42 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e  LOB</i> , <b>ban
5410: 64 49 6e 64 65 78 3c 2f 62 3e 20 3c 69 3e 49 6e  dIndex</b> <i>In
5420: 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69  teger</i> ) : <i
5430: 3e 44 6f 75 62 6c 65 3c 2f 69 3e 3c 2f 74 64 3e  >Double</i></td>
5440: 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72  ..<td>Will retur
5450: 6e 20 74 68 65 20 65 73 74 69 6d 61 74 65 64 20  n the estimated 
5460: 56 61 72 69 61 6e 63 65 20 76 61 6c 75 65 20 66  Variance value f
5470: 72 6f 6d 20 61 20 73 70 65 63 69 66 69 63 20 42  rom a specific B
5480: 61 6e 64 20 6f 66 20 61 20 3c 62 3e 3c 69 3e 72  and of a <b><i>r
5490: 61 73 74 65 72 53 74 61 74 69 73 74 69 63 73 3c  asterStatistics<
54a0: 2f 69 3e 3c 2f 62 3e 20 73 65 72 69 61 6c 69 7a  /i></b> serializ
54b0: 65 64 20 6f 62 6a 65 63 74 3a 20 3c 62 3e 4e 55  ed object: <b>NU
54c0: 4c 4c 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69  LL</b> on invali
54d0: 64 20 61 72 67 75 6d 65 6e 74 73 20 6f 72 20 69  d arguments or i
54e0: 66 20 61 6e 79 20 65 72 72 6f 72 20 6f 63 63 75  f any error occu
54f0: 72 72 65 64 2e 3c 62 72 3e 3c 75 3e 50 6c 65 61  rred.<br><u>Plea
5500: 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 74 68 65  se note</u>: the
5510: 20 66 69 72 73 74 20 42 61 6e 64 20 61 6c 77 61   first Band alwa
5520: 79 73 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74  ys corresponds t
5530: 6f 20 69 6e 64 65 78 20 3c 62 3e 5a 45 52 4f 3c  o index <b>ZERO<
5540: 2f 62 3e 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e  /b>.</td>..</tr>
5550: 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52  ..<tr>..<td><b>R
5560: 4c 32 5f 47 65 74 42 61 6e 64 53 74 61 74 69 73  L2_GetBandStatis
5570: 74 69 63 73 5f 53 74 64 44 65 76 3c 2f 62 3e 20  tics_StdDev</b> 
5580: 28 20 3c 62 3e 72 61 73 74 65 72 53 74 61 74 69  ( <b>rasterStati
5590: 73 74 69 63 73 3c 2f 62 3e 20 3c 69 3e 42 4c 4f  stics</b> <i>BLO
55a0: 42 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49  B</i> , <b>bandI
55b0: 6e 64 65 78 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  ndex</b> <i>Inte
55c0: 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 44  ger</i> ) : <i>D
55d0: 6f 75 62 6c 65 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a  ouble</i></td>..
55e0: 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20  <td>Will return 
55f0: 74 68 65 20 65 73 74 69 6d 61 74 65 64 20 53 74  the estimated St
5600: 61 6e 64 61 72 64 20 44 65 76 69 61 74 69 6f 6e  andard Deviation
5610: 20 76 61 6c 75 65 20 66 72 6f 6d 20 61 20 73 70   value from a sp
5620: 65 63 69 66 69 63 20 42 61 6e 64 20 6f 66 20 61  ecific Band of a
5630: 20 3c 62 3e 3c 69 3e 72 61 73 74 65 72 53 74 61   <b><i>rasterSta
5640: 74 69 73 74 69 63 73 3c 2f 69 3e 3c 2f 62 3e 20  tistics</i></b> 
5650: 73 65 72 69 61 6c 69 7a 65 64 20 6f 62 6a 65 63  serialized objec
5660: 74 3a 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 6f  t: <b>NULL</b> o
5670: 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65  n invalid argume
5680: 6e 74 73 20 6f 72 20 69 66 20 61 6e 79 20 65 72  nts or if any er
5690: 72 6f 72 20 6f 63 63 75 72 72 65 64 2e 3c 62 72  ror occurred.<br
56a0: 3e 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c  ><u>Please note<
56b0: 2f 75 3e 3a 20 74 68 65 20 66 69 72 73 74 20 42  /u>: the first B
56c0: 61 6e 64 20 61 6c 77 61 79 73 20 63 6f 72 72 65  and always corre
56d0: 73 70 6f 6e 64 73 20 74 6f 20 69 6e 64 65 78 20  sponds to index 
56e0: 3c 62 3e 5a 45 52 4f 3c 2f 62 3e 2e 3c 2f 74 64  <b>ZERO</b>.</td
56f0: 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a  >..</tr>..<tr>..
5700: 3c 74 64 3e 3c 62 3e 52 4c 32 5f 47 65 74 42 61  <td><b>RL2_GetBa
5710: 6e 64 53 74 61 74 69 73 74 69 63 73 5f 48 69 73  ndStatistics_His
5720: 74 6f 67 72 61 6d 3c 2f 62 3e 20 28 20 3c 62 3e  togram</b> ( <b>
5730: 72 61 73 74 65 72 53 74 61 74 69 73 74 69 63 73  rasterStatistics
5740: 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e  </b> <i>BLOB</i>
5750: 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 3c   , <b>bandIndex<
5760: 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
5770: 69 3e 20 29 20 3a 20 3c 69 3e 42 4c 4f 42 3c 2f  i> ) : <i>BLOB</
5780: 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c  i></td>..<td>Wil
5790: 6c 20 72 65 74 75 72 6e 20 61 20 42 4c 4f 42 20  l return a BLOB 
57a0: 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f  corresponding to
57b0: 20 61 20 50 4e 47 20 69 6d 61 67 65 20 72 65 70   a PNG image rep
57c0: 72 65 73 65 6e 74 69 6e 67 20 74 68 65 20 65 73  resenting the es
57d0: 74 69 6d 61 74 65 64 20 64 69 73 74 72 69 62 75  timated distribu
57e0: 74 69 6f 6e 20 48 69 73 74 6f 67 72 61 6d 20 66  tion Histogram f
57f0: 72 6f 6d 20 61 20 73 70 65 63 69 66 69 63 20 42  rom a specific B
5800: 61 6e 64 20 6f 66 20 61 20 3c 62 3e 3c 69 3e 72  and of a <b><i>r
5810: 61 73 74 65 72 53 74 61 74 69 73 74 69 63 73 3c  asterStatistics<
5820: 2f 69 3e 3c 2f 62 3e 20 73 65 72 69 61 6c 69 7a  /i></b> serializ
5830: 65 64 20 6f 62 6a 65 63 74 3a 20 3c 62 3e 4e 55  ed object: <b>NU
5840: 4c 4c 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69  LL</b> on invali
5850: 64 20 61 72 67 75 6d 65 6e 74 73 20 6f 72 20 69  d arguments or i
5860: 66 20 61 6e 79 20 65 72 72 6f 72 20 6f 63 63 75  f any error occu
5870: 72 72 65 64 2e 3c 62 72 3e 3c 75 3e 50 6c 65 61  rred.<br><u>Plea
5880: 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 74 68 65  se note</u>: the
5890: 20 66 69 72 73 74 20 42 61 6e 64 20 61 6c 77 61   first Band alwa
58a0: 79 73 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74  ys corresponds t
58b0: 6f 20 69 6e 64 65 78 20 3c 62 3e 5a 45 52 4f 3c  o index <b>ZERO<
58c0: 2f 62 3e 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e  /b>.</td>..</tr>
58d0: 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a  ..</table><br>..
58e0: 3c 68 72 3e 0d 0a 3c 68 32 3e 53 51 4c 20 66 75  <hr>..<h2>SQL fu
58f0: 6e 63 74 69 6f 6e 73 20 73 75 70 70 6f 72 74 69  nctions supporti
5900: 6e 67 20 42 4c 4f 42 20 73 65 72 69 61 6c 69 7a  ng BLOB serializ
5910: 65 64 20 72 61 73 74 65 72 54 69 6c 65 20 6f 62  ed rasterTile ob
5920: 6a 65 63 74 73 3c 2f 68 32 3e 20 0d 0a 3c 74 61  jects</h2> ..<ta
5930: 62 6c 65 20 77 69 64 74 68 3d 22 31 30 30 25 22  ble width="100%"
5940: 20 62 6f 72 64 65 72 3d 22 31 22 20 62 67 63 6f   border="1" bgco
5950: 6c 6f 72 3d 22 23 66 66 66 66 65 30 22 20 63 65  lor="#ffffe0" ce
5960: 6c 6c 65 73 70 61 63 69 6e 67 3d 22 34 22 20 63  llespacing="4" c
5970: 65 6c 6c 70 61 64 64 69 6e 67 3d 22 36 22 3e 0d  ellpadding="6">.
5980: 0a 3c 74 72 3e 3c 74 68 20 62 67 63 6f 6c 6f 72  .<tr><th bgcolor
5990: 3d 22 23 65 30 65 30 65 30 22 20 77 69 64 74 68  ="#e0e0e0" width
59a0: 3d 22 35 30 25 22 3e 53 79 6e 74 61 78 3c 2f 74  ="50%">Syntax</t
59b0: 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23  h><th bgcolor="#
59c0: 65 30 65 30 65 30 22 20 77 69 64 74 68 3d 22 35  e0e0e0" width="5
59d0: 30 25 22 3e 53 75 6d 6d 61 72 79 3c 2f 74 68 3e  0%">Summary</th>
59e0: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64  </tr>..<tr>..<td
59f0: 3e 3c 62 3e 52 4c 32 5f 49 73 56 61 6c 69 64 52  ><b>RL2_IsValidR
5a00: 61 73 74 65 72 54 69 6c 65 3c 2f 62 3e 20 28 20  asterTile</b> ( 
5a10: 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20  <b>dbPrefix</b> 
5a20: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
5a30: 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
5a40: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
5a50: 69 3e 20 2c 20 3c 62 3e 70 79 72 61 6d 69 64 4c  i> , <b>pyramidL
5a60: 65 76 65 6c 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  evel</b> <i>Inte
5a70: 67 65 72 3c 2f 69 3e 2c 20 3c 62 3e 74 69 6c 65  ger</i>, <b>tile
5a80: 4f 64 64 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 3c  Odd</b> <i>BLOB<
5a90: 2f 69 3e 20 2c 20 3c 62 3e 74 69 6c 65 45 76 65  /i> , <b>tileEve
5aa0: 6e 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 3c 2f 69  n</b> <i>BLOB</i
5ab0: 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72  > ) : <i>Integer
5ac0: 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57  </i></td>..<td>W
5ad0: 69 6c 6c 20 74 65 73 74 20 61 20 42 4c 4f 42 20  ill test a BLOB 
5ae0: 73 65 72 69 61 6c 69 7a 65 64 20 3c 62 3e 3c 69  serialized <b><i
5af0: 3e 72 61 73 74 65 72 54 69 6c 65 3c 2f 69 3e 3c  >rasterTile</i><
5b00: 2f 62 3e 20 6f 62 6a 65 63 74 20 66 6f 72 20 76  /b> object for v
5b10: 61 6c 69 64 69 74 79 2e 3c 62 72 3e 0d 0a 54 68  alidity.<br>..Th
5b20: 65 20 3c 62 3e 3c 69 3e 64 62 50 72 65 66 69 78  e <b><i>dbPrefix
5b30: 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67 75 6d 65 6e  </i></b> argumen
5b40: 74 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f  t is intended to
5b50: 20 73 70 65 63 69 66 79 20 74 68 65 20 41 54 54   specify the ATT
5b60: 41 43 48 45 44 2d 44 42 20 77 68 65 72 65 20 74  ACHED-DB where t
5b70: 68 65 20 43 6f 76 65 72 61 67 65 20 69 73 20 65  he Coverage is e
5b80: 78 70 65 63 74 65 64 20 74 6f 20 62 65 20 66 6f  xpected to be fo
5b90: 75 6e 64 3b 20 69 74 20 63 6f 75 6c 64 20 62 65  und; it could be
5ba0: 20 65 76 65 6e 74 75 61 6c 6c 79 20 3c 62 3e 4e   eventually <b>N
5bb0: 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69 6e 20  ULL</b>, and in 
5bc0: 74 68 69 73 20 63 61 73 65 20 74 68 65 20 3c 62  this case the <b
5bd0: 3e 4d 41 49 4e 20 44 42 3c 2f 62 3e 20 77 69 6c  >MAIN DB</b> wil
5be0: 6c 20 69 6d 70 6c 69 63 69 74 6c 79 20 62 65 20  l implicitly be 
5bf0: 61 73 73 75 6d 65 64 2e 3c 62 72 3e 0d 0a 57 69  assumed.<br>..Wi
5c00: 6c 6c 20 72 65 74 75 72 6e 20 3c 62 3e 31 3c 2f  ll return <b>1</
5c10: 62 3e 20 28 54 52 55 45 29 20 6f 72 20 3c 62 3e  b> (TRUE) or <b>
5c20: 30 3c 2f 62 3e 20 28 46 41 4c 53 45 29 3a 20 6f  0</b> (FALSE): o
5c30: 72 20 3c 62 3e 2d 31 3c 2f 62 3e 20 6f 6e 20 69  r <b>-1</b> on i
5c40: 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73  nvalid arguments
5c50: 20 6f 72 20 69 66 20 61 6e 79 20 65 72 72 6f 72   or if any error
5c60: 20 6f 63 63 75 72 72 65 64 2e 3c 2f 74 64 3e 0d   occurred.</td>.
5c70: 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74  .</tr>..<tr>..<t
5c80: 64 3e 3c 62 3e 52 4c 32 5f 47 65 74 54 69 6c 65  d><b>RL2_GetTile
5c90: 49 6d 61 67 65 3c 2f 62 3e 20 28 20 3c 62 3e 64  Image</b> ( <b>d
5ca0: 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53  bPrefix</b> <i>S
5cb0: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63  tring</i> , <b>c
5cc0: 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20  overageName</b> 
5cd0: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
5ce0: 3c 62 3e 74 69 6c 65 49 44 3c 2f 62 3e 20 3c 69  <b>tileID</b> <i
5cf0: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a  >Integer</i> ) :
5d00: 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 2f 74 64   <i>BLOB</i></td
5d10: 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75  >..<td>Will retu
5d20: 72 6e 20 61 20 42 4c 4f 42 20 63 6f 72 72 65 73  rn a BLOB corres
5d30: 70 6f 6e 64 69 6e 67 20 74 6f 20 61 20 50 4e 47  ponding to a PNG
5d40: 20 69 6d 61 67 65 20 28 76 69 73 75 61 6c 20 70   image (visual p
5d50: 72 65 76 69 65 77 29 20 66 72 6f 6d 20 61 20 3c  review) from a <
5d60: 62 3e 3c 69 3e 72 61 73 74 65 72 54 69 6c 65 3c  b><i>rasterTile<
5d70: 2f 69 3e 3c 2f 62 3e 20 73 65 72 69 61 6c 69 7a  /i></b> serializ
5d80: 65 64 20 6f 62 6a 65 63 74 3a 20 3c 62 3e 4e 55  ed object: <b>NU
5d90: 4c 4c 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69  LL</b> on invali
5da0: 64 20 61 72 67 75 6d 65 6e 74 73 20 6f 72 20 69  d arguments or i
5db0: 66 20 61 6e 79 20 65 72 72 6f 72 20 6f 63 63 75  f any error occu
5dc0: 72 72 65 64 2e 3c 62 72 3e 0d 0a 54 68 65 20 6d  rred.<br>..The m
5dd0: 61 6e 64 61 74 6f 72 79 20 3c 62 3e 3c 69 3e 64  andatory <b><i>d
5de0: 62 50 72 65 66 69 78 3c 2f 69 3e 3c 2f 62 3e 20  bPrefix</i></b> 
5df0: 61 72 67 75 6d 65 6e 74 20 63 6f 75 6c 64 20 65  argument could e
5e00: 76 65 6e 74 75 61 6c 6c 79 20 62 65 20 3c 62 3e  ventually be <b>
5e10: 4e 55 4c 4c 3c 2f 62 3e 20 61 6e 64 20 69 6e 20  NULL</b> and in 
5e20: 74 68 69 73 20 63 61 73 65 20 74 68 65 20 3c 62  this case the <b
5e30: 3e 4d 41 49 4e 20 44 42 3c 2f 62 3e 20 77 69 6c  >MAIN DB</b> wil
5e40: 6c 20 69 6d 70 6c 69 63 69 74 6c 79 20 62 65 20  l implicitly be 
5e50: 61 73 73 75 6d 65 64 2e 3c 62 72 3e 0d 0a 3c 75  assumed.<br>..<u
5e60: 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e  >Please note</u>
5e70: 3a 20 66 6f 72 20 70 69 78 65 6c 54 79 70 65 73  : for pixelTypes
5e80: 20 6c 61 63 6b 69 6e 67 20 61 6e 79 20 69 6d 70   lacking any imp
5e90: 6c 69 63 69 74 20 70 68 6f 74 6f 6d 65 74 72 69  licit photometri
5ea0: 63 20 69 6e 74 65 72 70 72 65 74 61 74 69 6f 6e  c interpretation
5eb0: 20 28 69 2e 65 2e 20 44 41 54 41 47 52 49 44 29   (i.e. DATAGRID)
5ec0: 20 61 20 64 65 66 61 75 6c 74 20 47 72 61 79 73   a default Grays
5ed0: 63 61 6c 65 20 69 6e 74 65 72 70 72 65 74 61 74  cale interpretat
5ee0: 69 6f 6e 20 77 69 6c 6c 20 62 65 20 73 69 6c 65  ion will be sile
5ef0: 6e 74 6c 79 20 61 73 73 75 6d 65 64 2e 0d 0a 46  ntly assumed...F
5f00: 6f 72 20 52 61 73 74 65 72 20 54 69 6c 65 73 20  or Raster Tiles 
5f10: 6f 66 20 74 68 65 20 4d 55 4c 54 49 42 41 4e 44  of the MULTIBAND
5f20: 20 74 79 70 65 20 61 20 64 65 66 61 75 6c 74 20   type a default 
5f30: 47 72 61 79 73 63 61 6c 65 20 69 6e 74 65 72 70  Grayscale interp
5f40: 72 65 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  retation of the 
5f50: 3c 62 3e 66 69 72 73 74 20 62 61 6e 64 20 6f 6e  <b>first band on
5f60: 6c 79 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 73  ly</b> will be s
5f70: 69 6c 65 6e 74 6c 79 20 61 73 73 75 6d 65 64 2e  ilently assumed.
5f80: 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74  </td>..</tr>..<t
5f90: 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 47  r>..<td><b>RL2_G
5fa0: 65 74 54 72 69 70 6c 65 42 61 6e 64 54 69 6c 65  etTripleBandTile
5fb0: 49 6d 61 67 65 3c 2f 62 3e 20 28 20 3c 62 3e 64  Image</b> ( <b>d
5fc0: 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53  bPrefix</b> <i>S
5fd0: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63  tring</i> , <b>c
5fe0: 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20  overageName</b> 
5ff0: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
6000: 3c 62 3e 74 69 6c 65 49 44 3c 2f 62 3e 20 3c 69  <b>tileID</b> <i
6010: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
6020: 62 3e 62 61 6e 64 49 6e 64 65 78 52 65 64 3c 2f  b>bandIndexRed</
6030: 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
6040: 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78  > , <b>bandIndex
6050: 47 72 65 65 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74  Green</b> <i>Int
6060: 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61  eger</i> , <b>ba
6070: 6e 64 49 6e 64 65 78 42 6c 75 65 3c 2f 62 3e 20  ndIndexBlue</b> 
6080: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29  <i>Integer</i> )
6090: 20 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 62   : <i>BLOB</i><b
60a0: 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 47  r><br>..<b>RL2_G
60b0: 65 74 54 72 69 70 6c 65 42 61 6e 64 54 69 6c 65  etTripleBandTile
60c0: 49 6d 61 67 65 3c 2f 62 3e 20 28 20 3c 62 3e 64  Image</b> ( <b>d
60d0: 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53  bPrefix</b> <i>S
60e0: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63  tring</i> , <b>c
60f0: 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20  overageName</b> 
6100: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
6110: 3c 62 3e 74 69 6c 65 49 44 3c 2f 62 3e 20 3c 69  <b>tileID</b> <i
6120: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
6130: 62 3e 62 61 6e 64 49 6e 64 65 78 52 65 64 3c 2f  b>bandIndexRed</
6140: 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
6150: 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78  > , <b>bandIndex
6160: 47 72 65 65 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74  Green</b> <i>Int
6170: 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61  eger</i> , <b>ba
6180: 6e 64 49 6e 64 65 78 42 6c 75 65 3c 2f 62 3e 20  ndIndexBlue</b> 
6190: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
61a0: 20 3c 62 3e 62 67 43 6f 6c 6f 72 3c 2f 62 3e 20   <b>bgColor</b> 
61b0: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20  <i>String</i> ) 
61c0: 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 62 72  : <i>BLOB</i><br
61d0: 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 47 65  ><br>..<b>RL2_Ge
61e0: 74 54 72 69 70 6c 65 42 61 6e 64 54 69 6c 65 49  tTripleBandTileI
61f0: 6d 61 67 65 3c 2f 62 3e 20 28 20 3c 62 3e 64 62  mage</b> ( <b>db
6200: 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74  Prefix</b> <i>St
6210: 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f  ring</i> , <b>co
6220: 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c  verageName</b> <
6230: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
6240: 62 3e 74 69 6c 65 49 44 3c 2f 62 3e 20 3c 69 3e  b>tileID</b> <i>
6250: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
6260: 3e 62 61 6e 64 49 6e 64 65 78 52 65 64 3c 2f 62  >bandIndexRed</b
6270: 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
6280: 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 47   , <b>bandIndexG
6290: 72 65 65 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  reen</b> <i>Inte
62a0: 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e  ger</i> , <b>ban
62b0: 64 49 6e 64 65 78 42 6c 75 65 3c 2f 62 3e 20 3c  dIndexBlue</b> <
62c0: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
62d0: 3c 62 3e 62 67 43 6f 6c 6f 72 3c 2f 62 3e 20 3c  <b>bgColor</b> <
62e0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
62f0: 62 3e 74 72 61 6e 73 70 61 72 65 6e 74 3c 2f 62  b>transparent</b
6300: 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
6310: 20 29 20 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e   ) : <i>BLOB</i>
6320: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20  </td>..<td>Will 
6330: 72 65 74 75 72 6e 20 61 20 42 4c 4f 42 20 63 6f  return a BLOB co
6340: 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61  rresponding to a
6350: 20 50 4e 47 20 69 6d 61 67 65 20 28 76 69 73 75   PNG image (visu
6360: 61 6c 20 70 72 65 76 69 65 77 29 20 66 72 6f 6d  al preview) from
6370: 20 61 20 3c 62 3e 3c 69 3e 72 61 73 74 65 72 54   a <b><i>rasterT
6380: 69 6c 65 3c 2f 69 3e 3c 2f 62 3e 20 73 65 72 69  ile</i></b> seri
6390: 61 6c 69 7a 65 64 20 6f 62 6a 65 63 74 3a 20 3c  alized object: <
63a0: 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 6f 6e 20 69 6e  b>NULL</b> on in
63b0: 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73 20  valid arguments 
63c0: 6f 72 20 69 66 20 61 6e 79 20 65 72 72 6f 72 20  or if any error 
63d0: 6f 63 63 75 72 72 65 64 2e 3c 62 72 3e 0d 0a 54  occurred.<br>..T
63e0: 68 65 20 6d 61 6e 64 61 74 6f 72 79 20 3c 62 3e  he mandatory <b>
63f0: 3c 69 3e 64 62 50 72 65 66 69 78 3c 2f 69 3e 3c  <i>dbPrefix</i><
6400: 2f 62 3e 20 61 72 67 75 6d 65 6e 74 20 63 6f 75  /b> argument cou
6410: 6c 64 20 65 76 65 6e 74 75 61 6c 6c 79 20 62 65  ld eventually be
6420: 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 61 6e 64   <b>NULL</b> and
6430: 20 69 6e 20 74 68 69 73 20 63 61 73 65 20 74 68   in this case th
6440: 65 20 3c 62 3e 4d 41 49 4e 20 44 42 3c 2f 62 3e  e <b>MAIN DB</b>
6450: 20 77 69 6c 6c 20 69 6d 70 6c 69 63 69 74 6c 79   will implicitly
6460: 20 62 65 20 61 73 73 75 6d 65 64 2e 3c 62 72 3e   be assumed.<br>
6470: 0d 0a 54 68 65 20 3c 62 3e 3c 69 3e 62 61 6e 64  ..The <b><i>band
6480: 49 6e 64 65 78 52 65 64 3c 2f 62 3e 3c 2f 69 3e  IndexRed</b></i>
6490: 2c 20 3c 62 3e 3c 69 3e 62 61 6e 64 49 6e 64 65  , <b><i>bandInde
64a0: 78 47 72 65 65 6e 3c 2f 69 3e 3c 2f 62 3e 20 61  xGreen</i></b> a
64b0: 6e 64 20 3c 62 3e 3c 69 3e 62 61 6e 64 49 6e 64  nd <b><i>bandInd
64c0: 65 78 42 6c 75 65 3c 2f 69 3e 3c 2f 62 3e 20 61  exBlue</i></b> a
64d0: 72 67 75 6d 65 6e 74 73 20 61 72 65 20 69 6e 74  rguments are int
64e0: 65 6e 64 65 64 20 74 6f 20 61 72 62 69 74 72 61  ended to arbitra
64f0: 72 69 6c 79 20 63 6f 6d 70 6f 73 65 20 74 68 65  rily compose the
6500: 20 52 47 42 20 50 4e 47 20 73 74 61 72 74 69 6e   RGB PNG startin
6510: 67 20 66 72 6f 6d 20 74 68 65 20 42 61 6e 64 73  g from the Bands
6520: 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 68   supported by th
6530: 65 20 43 6f 76 65 72 61 67 65 2e 0d 0a 3c 62 72  e Coverage...<br
6540: 3e 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c  ><u>Please note<
6550: 2f 75 3e 3a 20 74 68 65 20 66 69 72 73 74 20 42  /u>: the first B
6560: 61 6e 64 20 61 6c 77 61 79 73 20 63 6f 72 72 65  and always corre
6570: 73 70 6f 6e 64 73 20 74 6f 20 69 6e 64 65 78 20  sponds to index 
6580: 3c 62 3e 5a 45 52 4f 3c 2f 62 3e 3c 62 72 3e 3c  <b>ZERO</b><br><
6590: 62 72 3e 0d 0a 54 68 65 20 6f 70 74 69 6f 6e 61  br>..The optiona
65a0: 6c 20 3c 62 3e 3c 69 3e 62 67 43 6f 6c 6f 72 3c  l <b><i>bgColor<
65b0: 2f 69 3e 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74  /i></b> argument
65c0: 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f 20   is expected to 
65d0: 62 65 20 65 78 70 72 65 73 73 65 64 20 69 6e 20  be expressed in 
65e0: 74 68 65 20 63 61 6e 6f 6e 69 63 61 6c 20 57 45  the canonical WE
65f0: 42 20 48 45 58 2d 52 47 42 20 66 6f 72 6d 2c 20  B HEX-RGB form, 
6600: 61 73 20 69 6e 20 3c 62 3e 27 23 66 66 38 30 38  as in <b>'#ff808
6610: 30 27 3c 2f 62 3e 20 28 64 65 66 61 75 6c 74 20  0'</b> (default 
6620: 69 73 20 27 23 66 66 66 66 66 66 27 20 69 2e 65  is '#ffffff' i.e
6630: 2e 20 66 75 6c 6c 20 77 68 69 74 65 29 2e 3c 62  . full white).<b
6640: 72 3e 0d 0a 54 68 65 20 73 65 63 6f 6e 64 20 6f  r>..The second o
6650: 70 74 69 6f 6e 61 6c 20 3c 62 3e 3c 69 3e 74 72  ptional <b><i>tr
6660: 61 6e 73 70 61 72 65 6e 74 3c 2f 69 3e 3c 2f 62  ansparent</i></b
6670: 3e 20 61 72 67 75 6d 65 6e 74 20 69 73 20 65 78  > argument is ex
6680: 70 65 63 74 65 64 20 74 6f 20 62 65 20 65 78 70  pected to be exp
6690: 72 65 73 73 65 64 20 61 73 20 61 20 42 6f 6f 6c  ressed as a Bool
66a0: 65 61 6e 20 76 61 6c 75 65 20 28 64 65 66 61 75  ean value (defau
66b0: 6c 74 20 69 73 20 3c 62 3e 30 3c 2f 62 3e 20 46  lt is <b>0</b> F
66c0: 41 4c 53 45 29 2e 3c 62 72 3e 0d 0a 3c 75 3e 50  ALSE).<br>..<u>P
66d0: 6c 65 61 73 65 20 6e 6f 74 65 20 76 65 72 79 20  lease note very 
66e0: 77 65 6c 6c 3c 2f 75 3e 3a 20 74 68 69 73 20 53  well</u>: this S
66f0: 51 4c 20 66 75 6e 63 74 69 6f 6e 20 77 69 6c 6c  QL function will
6700: 20 6f 6e 6c 79 20 61 63 63 65 70 74 20 52 61 73   only accept Ras
6710: 74 65 72 20 54 69 6c 65 73 20 6f 66 20 74 68 65  ter Tiles of the
6720: 20 4d 55 4c 54 49 42 41 4e 44 20 6f 72 20 52 47   MULTIBAND or RG
6730: 42 20 74 79 70 65 2e 3c 2f 74 64 3e 0d 0a 3c 2f  B type.</td>..</
6740: 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c  tr>..<tr>..<td><
6750: 62 3e 52 4c 32 5f 47 65 74 4d 6f 6e 6f 42 61 6e  b>RL2_GetMonoBan
6760: 64 54 69 6c 65 49 6d 61 67 65 3c 2f 62 3e 20 28  dTileImage</b> (
6770: 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e   <b>dbPrefix</b>
6780: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
6790: 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
67a0: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
67b0: 69 3e 20 2c 20 3c 62 3e 74 69 6c 65 49 44 3c 2f  i> , <b>tileID</
67c0: 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
67d0: 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78  > , <b>bandIndex
67e0: 47 72 61 79 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  Gray</b> <i>Inte
67f0: 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 42  ger</i> ) : <i>B
6800: 4c 4f 42 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d  LOB</i><br><br>.
6810: 0a 3c 62 3e 52 4c 32 5f 47 65 74 4d 6f 6e 6f 42  .<b>RL2_GetMonoB
6820: 61 6e 64 54 69 6c 65 49 6d 61 67 65 3c 2f 62 3e  andTileImage</b>
6830: 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f   ( <b>dbPrefix</
6840: 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
6850: 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61   , <b>coverageNa
6860: 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  me</b> <i>String
6870: 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 6c 65 49 44  </i> , <b>tileID
6880: 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
6890: 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64  /i> , <b>bandInd
68a0: 65 78 47 72 61 79 3c 2f 62 3e 20 3c 69 3e 49 6e  exGray</b> <i>In
68b0: 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
68c0: 67 43 6f 6c 6f 72 3c 2f 62 3e 20 3c 69 3e 53 74  gColor</b> <i>St
68d0: 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e  ring</i> ) : <i>
68e0: 42 4c 4f 42 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e  BLOB</i><br><br>
68f0: 0d 0a 3c 62 3e 52 4c 32 5f 47 65 74 4d 6f 6e 6f  ..<b>RL2_GetMono
6900: 42 61 6e 64 54 69 6c 65 49 6d 61 67 65 3c 2f 62  BandTileImage</b
6910: 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c  > ( <b>dbPrefix<
6920: 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
6930: 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e  > , <b>coverageN
6940: 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ame</b> <i>Strin
6950: 67 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 6c 65 49  g</i> , <b>tileI
6960: 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  D</b> <i>Integer
6970: 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e  </i> , <b>bandIn
6980: 64 65 78 47 72 61 79 3c 2f 62 3e 20 3c 69 3e 49  dexGray</b> <i>I
6990: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
69a0: 62 67 43 6f 6c 6f 72 3c 2f 62 3e 20 3c 69 3e 53  bgColor</b> <i>S
69b0: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 74  tring</i> , <b>t
69c0: 72 61 6e 73 70 61 72 65 6e 74 3c 2f 62 3e 20 3c  ransparent</b> <
69d0: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20  i>Integer</i> ) 
69e0: 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 2f 74  : <i>BLOB</i></t
69f0: 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74  d>..<td>Will ret
6a00: 75 72 6e 20 61 20 42 4c 4f 42 20 63 6f 72 72 65  urn a BLOB corre
6a10: 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 20 50 4e  sponding to a PN
6a20: 47 20 69 6d 61 67 65 20 28 76 69 73 75 61 6c 20  G image (visual 
6a30: 70 72 65 76 69 65 77 29 20 66 72 6f 6d 20 61 20  preview) from a 
6a40: 3c 62 3e 3c 69 3e 72 61 73 74 65 72 54 69 6c 65  <b><i>rasterTile
6a50: 3c 2f 69 3e 3c 2f 62 3e 20 73 65 72 69 61 6c 69  </i></b> seriali
6a60: 7a 65 64 20 6f 62 6a 65 63 74 3a 20 3c 62 3e 4e  zed object: <b>N
6a70: 55 4c 4c 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c  ULL</b> on inval
6a80: 69 64 20 61 72 67 75 6d 65 6e 74 73 20 6f 72 20  id arguments or 
6a90: 69 66 20 61 6e 79 20 65 72 72 6f 72 20 6f 63 63  if any error occ
6aa0: 75 72 72 65 64 2e 3c 62 72 3e 0d 0a 54 68 65 20  urred.<br>..The 
6ab0: 6d 61 6e 64 61 74 6f 72 79 20 3c 62 3e 3c 69 3e  mandatory <b><i>
6ac0: 64 62 50 72 65 66 69 78 3c 2f 69 3e 3c 2f 62 3e  dbPrefix</i></b>
6ad0: 20 61 72 67 75 6d 65 6e 74 20 63 6f 75 6c 64 20   argument could 
6ae0: 65 76 65 6e 74 75 61 6c 6c 79 20 62 65 20 3c 62  eventually be <b
6af0: 3e 4e 55 4c 4c 3c 2f 62 3e 20 61 6e 64 20 69 6e  >NULL</b> and in
6b00: 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 3c   this case the <
6b10: 62 3e 4d 41 49 4e 20 44 42 3c 2f 62 3e 20 77 69  b>MAIN DB</b> wi
6b20: 6c 6c 20 69 6d 70 6c 69 63 69 74 6c 79 20 62 65  ll implicitly be
6b30: 20 61 73 73 75 6d 65 64 2e 3c 62 72 3e 0d 0a 54   assumed.<br>..T
6b40: 68 65 20 3c 62 3e 3c 69 3e 62 61 6e 64 49 6e 64  he <b><i>bandInd
6b50: 65 78 47 72 61 79 3c 2f 69 3e 3c 2f 62 3e 20 61  exGray</i></b> a
6b60: 72 67 75 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e  rgument is inten
6b70: 64 65 64 20 74 6f 20 61 72 62 69 74 72 61 72 69  ded to arbitrari
6b80: 6c 79 20 63 6f 6d 70 6f 73 65 20 74 68 65 20 47  ly compose the G
6b90: 72 61 79 73 63 61 6c 65 20 50 4e 47 20 73 74 61  rayscale PNG sta
6ba0: 72 74 69 6e 67 20 66 72 6f 6d 20 74 68 65 20 42  rting from the B
6bb0: 61 6e 64 73 20 73 75 70 70 6f 72 74 65 64 20 62  ands supported b
6bc0: 79 20 74 68 65 20 43 6f 76 65 72 61 67 65 2e 0d  y the Coverage..
6bd0: 0a 3c 62 72 3e 3c 75 3e 50 6c 65 61 73 65 20 6e  .<br><u>Please n
6be0: 6f 74 65 3c 2f 75 3e 3a 20 74 68 65 20 66 69 72  ote</u>: the fir
6bf0: 73 74 20 42 61 6e 64 20 61 6c 77 61 79 73 20 63  st Band always c
6c00: 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 69 6e  orresponds to in
6c10: 64 65 78 20 3c 62 3e 5a 45 52 4f 3c 2f 62 3e 3c  dex <b>ZERO</b><
6c20: 62 72 3e 3c 62 72 3e 0d 0a 54 68 65 20 6f 70 74  br><br>..The opt
6c30: 69 6f 6e 61 6c 20 3c 62 3e 3c 69 3e 62 67 43 6f  ional <b><i>bgCo
6c40: 6c 6f 72 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67 75  lor</i></b> argu
6c50: 6d 65 6e 74 20 69 73 20 65 78 70 65 63 74 65 64  ment is expected
6c60: 20 74 6f 20 62 65 20 65 78 70 72 65 73 73 65 64   to be expressed
6c70: 20 69 6e 20 74 68 65 20 63 61 6e 6f 6e 69 63 61   in the canonica
6c80: 6c 20 57 45 42 20 48 45 58 2d 52 47 42 20 66 6f  l WEB HEX-RGB fo
6c90: 72 6d 2c 20 61 73 20 69 6e 20 3c 62 3e 27 23 66  rm, as in <b>'#f
6ca0: 66 38 30 38 30 27 3c 2f 62 3e 20 28 64 65 66 61  f8080'</b> (defa
6cb0: 75 6c 74 20 69 73 20 27 23 66 66 66 66 66 66 27  ult is '#ffffff'
6cc0: 20 69 2e 65 2e 20 66 75 6c 6c 20 77 68 69 74 65   i.e. full white
6cd0: 29 2e 3c 62 72 3e 0d 0a 54 68 65 20 73 65 63 6f  ).<br>..The seco
6ce0: 6e 64 20 6f 70 74 69 6f 6e 61 6c 20 3c 62 3e 3c  nd optional <b><
6cf0: 69 3e 74 72 61 6e 73 70 61 72 65 6e 74 3c 2f 69  i>transparent</i
6d00: 3e 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 20 69  ></b> argument i
6d10: 73 20 65 78 70 65 63 74 65 64 20 74 6f 20 62 65  s expected to be
6d20: 20 65 78 70 72 65 73 73 65 64 20 61 73 20 61 20   expressed as a 
6d30: 42 6f 6f 6c 65 61 6e 20 76 61 6c 75 65 20 28 64  Boolean value (d
6d40: 65 66 61 75 6c 74 20 69 73 20 3c 62 3e 30 3c 2f  efault is <b>0</
6d50: 62 3e 20 46 41 4c 53 45 29 2e 3c 62 72 3e 0d 0a  b> FALSE).<br>..
6d60: 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f  <u>Please note</
6d70: 75 3e 3a 20 66 6f 72 20 70 69 78 65 6c 54 79 70  u>: for pixelTyp
6d80: 65 73 20 6c 61 63 6b 69 6e 67 20 61 6e 79 20 69  es lacking any i
6d90: 6d 70 6c 69 63 69 74 20 70 68 6f 74 6f 6d 65 74  mplicit photomet
6da0: 72 69 63 20 69 6e 74 65 72 70 72 65 74 61 74 69  ric interpretati
6db0: 6f 6e 20 28 69 2e 65 2e 20 44 41 54 41 47 52 49  on (i.e. DATAGRI
6dc0: 44 29 20 61 20 64 65 66 61 75 6c 74 20 47 72 61  D) a default Gra
6dd0: 79 73 63 61 6c 65 20 69 6e 74 65 72 70 72 65 74  yscale interpret
6de0: 61 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20 73 69  ation will be si
6df0: 6c 65 6e 74 6c 79 20 61 73 73 75 6d 65 64 2e 3c  lently assumed.<
6e00: 62 72 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e  br>..<u>Please n
6e10: 6f 74 65 20 76 65 72 79 20 77 65 6c 6c 3c 2f 75  ote very well</u
6e20: 3e 3a 20 74 68 69 73 20 53 51 4c 20 66 75 6e 63  >: this SQL func
6e30: 74 69 6f 6e 20 77 69 6c 6c 20 6f 6e 6c 79 20 61  tion will only a
6e40: 63 63 65 70 74 20 52 61 73 74 65 72 20 54 69 6c  ccept Raster Til
6e50: 65 73 20 6f 66 20 74 68 65 20 4d 55 4c 54 49 42  es of the MULTIB
6e60: 41 4e 44 20 6f 72 20 52 47 42 20 74 79 70 65 2e  AND or RGB type.
6e70: 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 2f  </td>..</tr>..</
6e80: 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 72 3e  table><br>..<hr>
6e90: 0d 0a 3c 68 32 3e 53 51 4c 20 66 75 6e 63 74 69  ..<h2>SQL functi
6ea0: 6f 6e 73 20 73 75 70 70 6f 72 74 69 6e 67 20 43  ons supporting C
6eb0: 6f 76 65 72 61 67 65 20 61 6e 64 20 53 65 63 74  overage and Sect
6ec0: 69 6f 6e 20 6d 61 6e 61 67 65 6d 65 6e 74 3c 2f  ion management</
6ed0: 68 32 3e 20 0d 0a 3c 74 61 62 6c 65 20 77 69 64  h2> ..<table wid
6ee0: 74 68 3d 22 31 30 30 25 22 20 62 6f 72 64 65 72  th="100%" border
6ef0: 3d 22 31 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66  ="1" bgcolor="#f
6f00: 66 66 66 65 30 22 20 63 65 6c 6c 65 73 70 61 63  fffe0" cellespac
6f10: 69 6e 67 3d 22 34 22 20 63 65 6c 6c 70 61 64 64  ing="4" cellpadd
6f20: 69 6e 67 3d 22 36 22 3e 0d 0a 3c 74 72 3e 3c 74  ing="6">..<tr><t
6f30: 68 20 62 67 63 6f 6c 6f 72 3d 22 23 65 30 65 30  h bgcolor="#e0e0
6f40: 65 30 22 3e 53 79 6e 74 61 78 3c 2f 74 68 3e 3c  e0">Syntax</th><
6f50: 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 65 30 65  th bgcolor="#e0e
6f60: 30 65 30 22 20 77 69 64 74 68 3d 22 35 30 25 22  0e0" width="50%"
6f70: 3e 53 75 6d 6d 61 72 79 3c 2f 74 68 3e 3c 2f 74  >Summary</th></t
6f80: 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62  r>..<tr>..<td><b
6f90: 3e 52 4c 32 5f 43 72 65 61 74 65 52 61 73 74 65  >RL2_CreateRaste
6fa0: 72 43 6f 76 65 72 61 67 65 3c 2f 62 3e 20 28 20  rCoverage</b> ( 
6fb0: 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
6fc0: 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
6fd0: 3e 20 2c 20 3c 62 3e 73 61 6d 70 6c 65 54 79 70  > , <b>sampleTyp
6fe0: 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  e</b> <i>String<
6ff0: 2f 69 3e 20 2c 20 3c 62 3e 70 69 78 65 6c 54 79  /i> , <b>pixelTy
7000: 70 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  pe</b> <i>String
7010: 3c 2f 69 3e 20 2c 20 3c 62 3e 6e 75 6d 42 61 6e  </i> , <b>numBan
7020: 64 73 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ds</b> <i>Intege
7030: 72 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 6d 70 72  r</i> , <b>compr
7040: 65 73 73 69 6f 6e 54 79 70 65 3c 2f 62 3e 20 3c  essionType</b> <
7050: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 0d 0a  i>String</i> ,..
7060: 3c 62 3e 71 75 61 6c 69 74 79 3c 2f 62 3e 20 3c  <b>quality</b> <
7070: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
7080: 3c 62 3e 74 69 6c 65 57 69 64 74 68 3c 2f 62 3e  <b>tileWidth</b>
7090: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
70a0: 2c 0d 0a 3c 62 3e 74 69 6c 65 48 65 69 67 68 74  ,..<b>tileHeight
70b0: 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
70c0: 2f 69 3e 20 2c 20 3c 62 3e 53 52 49 44 3c 2f 62  /i> , <b>SRID</b
70d0: 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
70e0: 20 2c 20 0d 0a 3c 62 3e 70 69 78 65 6c 52 65 73   , ..<b>pixelRes
70f0: 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 2f 69 3e  olution</b> </i>
7100: 44 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c  Double</i> ) : <
7110: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72  i>Integer</i><br
7120: 3e 3c 62 72 3e 3c 62 3e 52 4c 32 5f 43 72 65 61  ><br><b>RL2_Crea
7130: 74 65 52 61 73 74 65 72 43 6f 76 65 72 61 67 65  teRasterCoverage
7140: 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f 76 65 72 61  </b> ( <b>covera
7150: 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74  geName</b> <i>St
7160: 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73 61  ring</i> , <b>sa
7170: 6d 70 6c 65 54 79 70 65 3c 2f 62 3e 20 3c 69 3e  mpleType</b> <i>
7180: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
7190: 70 69 78 65 6c 54 79 70 65 3c 2f 62 3e 20 3c 69  pixelType</b> <i
71a0: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
71b0: 3e 6e 75 6d 42 61 6e 64 73 3c 2f 62 3e 20 3c 69  >numBands</b> <i
71c0: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
71d0: 62 3e 63 6f 6d 70 72 65 73 73 69 6f 6e 54 79 70  b>compressionTyp
71e0: 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  e</b> <i>String<
71f0: 2f 69 3e 20 2c 0d 0a 3c 62 3e 71 75 61 6c 69 74  /i> ,..<b>qualit
7200: 79 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  y</b> <i>Integer
7210: 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 6c 65 57 69  </i> , <b>tileWi
7220: 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  dth</b> <i>Integ
7230: 65 72 3c 2f 69 3e 20 2c 0d 0a 3c 62 3e 74 69 6c  er</i> ,..<b>til
7240: 65 48 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49  eHeight</b> <i>I
7250: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
7260: 53 52 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  SRID</b> <i>Inte
7270: 67 65 72 3c 2f 69 3e 20 2c 20 0d 0a 3c 62 3e 68  ger</i> , ..<b>h
7280: 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69  orzPixelResoluti
7290: 6f 6e 3c 2f 62 3e 20 3c 2f 69 3e 44 6f 75 62 6c  on</b> </i>Doubl
72a0: 65 3c 2f 69 3e 20 2c 20 0d 0a 3c 62 3e 76 65 72  e</i> , ..<b>ver
72b0: 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  tPixelResolution
72c0: 3c 2f 62 3e 20 3c 2f 69 3e 44 6f 75 62 6c 65 3c  </b> </i>Double<
72d0: 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67  /i> ) : <i>Integ
72e0: 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 3c 62  er</i><br><br><b
72f0: 3e 52 4c 32 5f 43 72 65 61 74 65 52 61 73 74 65  >RL2_CreateRaste
7300: 72 43 6f 76 65 72 61 67 65 3c 2f 62 3e 20 28 20  rCoverage</b> ( 
7310: 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
7320: 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
7330: 3e 20 2c 20 3c 62 3e 73 61 6d 70 6c 65 54 79 70  > , <b>sampleTyp
7340: 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  e</b> <i>String<
7350: 2f 69 3e 20 2c 20 3c 62 3e 70 69 78 65 6c 54 79  /i> , <b>pixelTy
7360: 70 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  pe</b> <i>String
7370: 3c 2f 69 3e 20 2c 20 3c 62 3e 6e 75 6d 42 61 6e  </i> , <b>numBan
7380: 64 73 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ds</b> <i>Intege
7390: 72 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 6d 70 72  r</i> , <b>compr
73a0: 65 73 73 69 6f 6e 54 79 70 65 3c 2f 62 3e 20 3c  essionType</b> <
73b0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 0d 0a  i>String</i> ,..
73c0: 3c 62 3e 71 75 61 6c 69 74 79 3c 2f 62 3e 20 3c  <b>quality</b> <
73d0: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
73e0: 3c 62 3e 74 69 6c 65 57 69 64 74 68 3c 2f 62 3e  <b>tileWidth</b>
73f0: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
7400: 2c 0d 0a 3c 62 3e 74 69 6c 65 48 65 69 67 68 74  ,..<b>tileHeight
7410: 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
7420: 2f 69 3e 20 2c 20 3c 62 3e 53 52 49 44 3c 2f 62  /i> , <b>SRID</b
7430: 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
7440: 20 2c 20 0d 0a 3c 62 3e 68 6f 72 7a 50 69 78 65   , ..<b>horzPixe
7450: 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20  lResolution</b> 
7460: 3c 2f 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c  </i>Double</i> ,
7470: 20 0d 0a 3c 62 3e 76 65 72 74 50 69 78 65 6c 52   ..<b>vertPixelR
7480: 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 2f  esolution</b> </
7490: 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 0d 0a  i>Double</i> ,..
74a0: 3c 62 3e 6e 6f 44 61 74 61 50 69 78 65 6c 3c 2f  <b>noDataPixel</
74b0: 62 3e 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 20 29  b> <i>BLOB</i> )
74c0: 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69   : <i>Integer</i
74d0: 3e 3c 62 72 3e 3c 62 72 3e 3c 62 3e 52 4c 32 5f  ><br><br><b>RL2_
74e0: 43 72 65 61 74 65 52 61 73 74 65 72 43 6f 76 65  CreateRasterCove
74f0: 72 61 67 65 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f  rage</b> ( <b>co
7500: 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c  verageName</b> <
7510: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
7520: 62 3e 73 61 6d 70 6c 65 54 79 70 65 3c 2f 62 3e  b>sampleType</b>
7530: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
7540: 20 3c 62 3e 70 69 78 65 6c 54 79 70 65 3c 2f 62   <b>pixelType</b
7550: 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
7560: 2c 20 3c 62 3e 6e 75 6d 42 61 6e 64 73 3c 2f 62  , <b>numBands</b
7570: 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
7580: 20 2c 20 3c 62 3e 63 6f 6d 70 72 65 73 73 69 6f   , <b>compressio
7590: 6e 54 79 70 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  nType</b> <i>Str
75a0: 69 6e 67 3c 2f 69 3e 20 2c 0d 0a 3c 62 3e 71 75  ing</i> ,..<b>qu
75b0: 61 6c 69 74 79 3c 2f 62 3e 20 3c 69 3e 49 6e 74  ality</b> <i>Int
75c0: 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69  eger</i> , <b>ti
75d0: 6c 65 57 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49  leWidth</b> <i>I
75e0: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 0d 0a 3c 62  nteger</i> ,..<b
75f0: 3e 74 69 6c 65 48 65 69 67 68 74 3c 2f 62 3e 20  >tileHeight</b> 
7600: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
7610: 20 3c 62 3e 53 52 49 44 3c 2f 62 3e 20 3c 69 3e   <b>SRID</b> <i>
7620: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 0d 0a  Integer</i> , ..
7630: 3c 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f  <b>horzPixelReso
7640: 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 2f 69 3e 44  lution</b> </i>D
7650: 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 0d 0a 3c 62  ouble</i> , ..<b
7660: 3e 76 65 72 74 50 69 78 65 6c 52 65 73 6f 6c 75  >vertPixelResolu
7670: 74 69 6f 6e 3c 2f 62 3e 20 3c 2f 69 3e 44 6f 75  tion</b> </i>Dou
7680: 62 6c 65 3c 2f 69 3e 20 2c 0d 0a 3c 62 3e 6e 6f  ble</i> ,..<b>no
7690: 44 61 74 61 50 69 78 65 6c 3c 2f 62 3e 20 3c 69  DataPixel</b> <i
76a0: 3e 42 4c 4f 42 3c 2f 69 3e 20 2c 20 3c 62 3e 73  >BLOB</i> , <b>s
76b0: 74 72 69 63 74 52 65 73 6f 6c 75 74 69 6f 6e 3c  trictResolution<
76c0: 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
76d0: 69 3e 20 2c 20 3c 62 3e 6d 69 78 65 64 52 65 73  i> , <b>mixedRes
76e0: 6f 6c 75 74 69 6f 6e 73 3c 2f 62 3e 20 3c 69 3e  olutions</b> <i>
76f0: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
7700: 3e 73 65 63 74 69 6f 6e 50 61 74 68 73 3c 2f 62  >sectionPaths</b
7710: 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
7720: 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 4d 44 35   , <b>sectionMD5
7730: 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
7740: 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e  /i> , <b>section
7750: 53 75 6d 6d 61 72 79 3c 2f 62 3e 20 3c 69 3e 49  Summary</b> <i>I
7760: 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c  nteger</i> ) : <
7770: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72  i>Integer</i><br
7780: 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 43 72  ><br>..<b>RL2_Cr
7790: 65 61 74 65 52 61 73 74 65 72 43 6f 76 65 72 61  eateRasterCovera
77a0: 67 65 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f 76 65  ge</b> ( <b>cove
77b0: 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e  rageName</b> <i>
77c0: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
77d0: 73 61 6d 70 6c 65 54 79 70 65 3c 2f 62 3e 20 3c  sampleType</b> <
77e0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
77f0: 62 3e 70 69 78 65 6c 54 79 70 65 3c 2f 62 3e 20  b>pixelType</b> 
7800: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
7810: 3c 62 3e 6e 75 6d 42 61 6e 64 73 3c 2f 62 3e 20  <b>numBands</b> 
7820: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
7830: 20 3c 62 3e 63 6f 6d 70 72 65 73 73 69 6f 6e 54   <b>compressionT
7840: 79 70 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ype</b> <i>Strin
7850: 67 3c 2f 69 3e 20 2c 0d 0a 3c 62 3e 71 75 61 6c  g</i> ,..<b>qual
7860: 69 74 79 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  ity</b> <i>Integ
7870: 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 6c 65  er</i> , <b>tile
7880: 57 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74  Width</b> <i>Int
7890: 65 67 65 72 3c 2f 69 3e 20 2c 0d 0a 3c 62 3e 74  eger</i> ,..<b>t
78a0: 69 6c 65 48 65 69 67 68 74 3c 2f 62 3e 20 3c 69  ileHeight</b> <i
78b0: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
78c0: 62 3e 53 52 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e  b>SRID</b> <i>In
78d0: 74 65 67 65 72 3c 2f 69 3e 20 2c 20 0d 0a 3c 62  teger</i> , ..<b
78e0: 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75  >horzPixelResolu
78f0: 74 69 6f 6e 3c 2f 62 3e 20 3c 2f 69 3e 44 6f 75  tion</b> </i>Dou
7900: 62 6c 65 3c 2f 69 3e 20 2c 20 0d 0a 3c 62 3e 76  ble</i> , ..<b>v
7910: 65 72 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69  ertPixelResoluti
7920: 6f 6e 3c 2f 62 3e 20 3c 2f 69 3e 44 6f 75 62 6c  on</b> </i>Doubl
7930: 65 3c 2f 69 3e 20 2c 0d 0a 3c 62 3e 6e 6f 44 61  e</i> ,..<b>noDa
7940: 74 61 50 69 78 65 6c 3c 2f 62 3e 20 3c 69 3e 42  taPixel</b> <i>B
7950: 4c 4f 42 3c 2f 69 3e 20 2c 20 3c 62 3e 73 74 72  LOB</i> , <b>str
7960: 69 63 74 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62  ictResolution</b
7970: 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
7980: 20 2c 20 3c 62 3e 6d 69 78 65 64 52 65 73 6f 6c   , <b>mixedResol
7990: 75 74 69 6f 6e 73 3c 2f 62 3e 20 3c 69 3e 49 6e  utions</b> <i>In
79a0: 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 73  teger</i> , <b>s
79b0: 65 63 74 69 6f 6e 50 61 74 68 73 3c 2f 62 3e 20  ectionPaths</b> 
79c0: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
79d0: 20 3c 62 3e 73 65 63 74 69 6f 6e 4d 44 35 3c 2f   <b>sectionMD5</
79e0: 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
79f0: 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 53 75  > , <b>sectionSu
7a00: 6d 6d 61 72 79 3c 2f 62 3e 20 3c 69 3e 49 6e 74  mmary</b> <i>Int
7a10: 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 69 73  eger</i> , <b>is
7a20: 5f 71 75 65 72 79 61 62 6c 65 3c 2f 62 3e 20 3c  _queryable</b> <
7a30: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20  i>Integer</i> ) 
7a40: 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  : <i>Integer</i>
7a50: 0d 0a 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c  ..</td>..<td>Wil
7a60: 6c 20 61 74 74 65 6d 70 74 20 74 6f 20 63 72 65  l attempt to cre
7a70: 61 74 65 20 61 20 6e 65 77 20 52 61 73 74 65 72  ate a new Raster
7a80: 20 43 6f 76 65 72 61 67 65 20 77 69 74 68 69 6e   Coverage within
7a90: 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 63   the currently c
7aa0: 6f 6e 6e 65 63 74 65 64 20 44 42 2d 66 69 6c 65  onnected DB-file
7ab0: 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72 65 74 75  .<br>..Will retu
7ac0: 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28 54 52 55  rn <b>1</b> (TRU
7ad0: 45 2f 53 55 43 43 45 53 53 29 20 6f 72 20 3c 62  E/SUCCESS) or <b
7ae0: 3e 30 3c 2f 62 3e 20 28 46 41 4c 53 45 2f 46 41  >0</b> (FALSE/FA
7af0: 49 4c 55 52 45 29 3a 20 6f 72 20 3c 62 3e 2d 31  ILURE): or <b>-1
7b00: 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69 64 20  </b> on invalid 
7b10: 61 72 67 75 6d 65 6e 74 73 2e 3c 62 72 3e 0d 0a  arguments.<br>..
7b20: 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f  <u>Please note</
7b30: 75 3e 3a 20 79 6f 75 20 63 61 6e 20 75 73 65 20  u>: you can use 
7b40: 74 68 65 20 73 65 63 6f 6e 64 20 66 6f 72 6d 20  the second form 
7b50: 74 6f 20 63 72 65 61 74 65 20 61 20 52 61 73 74  to create a Rast
7b60: 65 72 20 43 6f 76 65 72 61 67 65 20 72 65 71 75  er Coverage requ
7b70: 69 72 69 6e 67 20 3c 62 3e 3c 69 3e 72 65 63 74  iring <b><i>rect
7b80: 61 6e 67 75 6c 61 72 3c 2f 69 3e 3c 2f 62 3e 20  angular</i></b> 
7b90: 70 69 78 65 6c 73 2e 3c 62 72 3e 3c 62 72 3e 0d  pixels.<br><br>.
7ba0: 0a 54 68 65 20 74 68 69 72 64 20 66 6f 72 6d 20  .The third form 
7bb0: 61 6c 6c 6f 77 73 20 74 6f 20 65 78 70 6c 69 63  allows to explic
7bc0: 69 74 6c 79 20 64 65 63 6c 61 72 65 20 61 20 4e  itly declare a N
7bd0: 6f 44 61 74 61 20 76 61 6c 75 65 3b 20 69 6e 20  oData value; in 
7be0: 74 68 69 73 20 63 61 73 65 20 74 68 65 20 6c 61  this case the la
7bf0: 73 74 20 61 72 67 75 6d 65 6e 74 20 69 73 20 65  st argument is e
7c00: 78 70 65 63 74 65 64 20 74 6f 20 63 6f 72 72 65  xpected to corre
7c10: 73 70 6f 6e 64 20 74 6f 20 61 20 50 69 78 65 6c  spond to a Pixel
7c20: 20 73 65 72 69 61 6c 69 7a 65 64 20 6f 62 6a 65   serialized obje
7c30: 63 74 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68  ct exactly match
7c40: 69 6e 67 20 74 68 65 20 43 6f 76 65 72 61 67 65  ing the Coverage
7c50: 27 73 20 70 69 78 65 6c 20 6d 6f 64 65 6c 2e 3c  's pixel model.<
7c60: 62 72 3e 3c 62 72 3e 0d 0a 54 68 65 20 66 6f 75  br><br>..The fou
7c70: 72 74 68 20 66 6f 72 6d 20 61 6c 6c 6f 77 73 20  rth form allows 
7c80: 74 6f 20 65 78 70 6c 69 63 69 74 6c 79 20 73 65  to explicitly se
7c90: 74 20 3c 62 3e 3c 69 3e 50 6f 6c 69 63 69 65 73  t <b><i>Policies
7ca0: 20 4f 70 74 69 6f 6e 73 3c 2f 69 3e 3c 2f 62 3e   Options</i></b>
7cb0: 20 28 61 6c 77 61 79 73 20 64 69 73 61 62 6c 65   (always disable
7cc0: 64 20 62 79 20 64 65 66 61 75 6c 74 29 2e 20 45  d by default). E
7cd0: 61 63 68 20 73 69 6e 67 6c 65 20 4f 70 74 69 6f  ach single Optio
7ce0: 6e 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f  n corresponds to
7cf0: 20 61 20 3c 69 3e 3c 62 3e 62 6f 6f 6c 65 61 6e   a <i><b>boolean
7d00: 3c 2f 62 3e 3c 2f 69 3e 20 76 61 6c 75 65 20 28  </b></i> value (
7d10: 46 41 4c 53 45 3d 64 69 73 61 62 6c 65 64 20 2f  FALSE=disabled /
7d20: 20 54 52 55 45 3d 65 6e 61 62 6c 65 64 29 2e 3c   TRUE=enabled).<
7d30: 62 72 3e 3c 62 72 3e 0d 0a 54 68 65 20 66 69 66  br><br>..The fif
7d40: 74 68 20 61 6e 64 20 66 69 6e 61 6c 20 66 6f 72  th and final for
7d50: 6d 20 61 6c 6c 6f 77 73 20 74 6f 20 65 78 70 6c  m allows to expl
7d60: 69 63 69 74 6c 79 20 73 74 61 74 65 20 69 66 20  icitly state if 
7d70: 74 68 65 20 43 6f 76 65 72 61 67 65 20 69 73 20  the Coverage is 
7d80: 3c 62 3e 71 75 65 72 79 61 62 6c 65 3c 2f 62 3e  <b>queryable</b>
7d90: 20 6f 72 20 6e 6f 74 20 28 61 6c 77 61 79 73 20   or not (always 
7da0: 73 65 74 20 74 6f 20 3c 62 3e 46 41 4c 53 45 3c  set to <b>FALSE<
7db0: 2f 62 3e 20 62 79 20 64 65 66 61 75 6c 74 29 2e  /b> by default).
7dc0: 0d 0a 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a  ..</td>..</tr>..
7dd0: 3c 74 72 3e 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32  <tr>..<td><b>RL2
7de0: 5f 53 65 74 43 6f 76 65 72 61 67 65 49 6e 66 6f  _SetCoverageInfo
7df0: 73 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f 76 65 72  s</b> ( <b>cover
7e00: 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  ageName</b> <i>S
7e10: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 74  tring</i> , <b>t
7e20: 69 74 6c 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  itle</b> <i>Stri
7e30: 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 61 62 73 74  ng</i> , <b>abst
7e40: 72 61 63 74 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  ract</b> <i>Stri
7e50: 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e  ng</i> ) : <i>In
7e60: 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72  teger</i><br><br
7e70: 3e 0d 0a 3c 62 3e 52 4c 32 5f 53 65 74 43 6f 76  >..<b>RL2_SetCov
7e80: 65 72 61 67 65 49 6e 66 6f 73 3c 2f 62 3e 20 28  erageInfos</b> (
7e90: 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
7ea0: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
7eb0: 69 3e 20 2c 20 3c 62 3e 74 69 74 6c 65 3c 2f 62  i> , <b>title</b
7ec0: 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
7ed0: 2c 20 3c 62 3e 61 62 73 74 72 61 63 74 3c 2f 62  , <b>abstract</b
7ee0: 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
7ef0: 2c 20 3c 62 3e 69 73 5f 71 75 65 72 79 61 62 6c  , <b>is_queryabl
7f00: 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  e</b> <i>Integer
7f10: 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65  </i> ) : <i>Inte
7f20: 67 65 72 3c 2f 69 3e 0d 0a 3c 2f 74 64 3e 0d 0a  ger</i>..</td>..
7f30: 3c 74 64 3e 49 6e 73 65 72 74 73 20 28 6f 72 20  <td>Inserts (or 
7f40: 75 70 64 61 74 65 73 29 20 74 68 65 20 64 65 73  updates) the des
7f50: 63 72 69 70 74 69 76 65 20 69 6e 66 6f 73 20 61  criptive infos a
7f60: 73 73 6f 63 69 61 74 65 64 20 74 6f 20 61 20 43  ssociated to a C
7f70: 6f 76 65 72 61 67 65 2e 0d 0a 3c 75 6c 3e 0d 0a  overage...<ul>..
7f80: 3c 6c 69 3e 3c 62 3e 63 6f 76 65 72 61 67 65 5f  <li><b>coverage_
7f90: 6e 61 6d 65 3c 2f 62 3e 20 6d 75 73 74 20 69 64  name</b> must id
7fa0: 65 6e 74 69 66 79 20 61 6e 20 65 78 69 73 74 69  entify an existi
7fb0: 6e 67 20 43 6f 76 65 72 61 67 65 2e 3c 2f 6c 69  ng Coverage.</li
7fc0: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 74 69 74 6c 65 3c  >..<li><b>title<
7fd0: 2f 62 3e 20 61 6e 64 20 3c 62 3e 61 62 73 74 72  /b> and <b>abstr
7fe0: 61 63 74 3c 2f 62 3e 20 72 65 70 72 65 73 65 6e  act</b> represen
7ff0: 74 20 74 68 65 20 64 65 73 63 72 69 70 74 69 76  t the descriptiv
8000: 65 20 69 6e 66 6f 73 20 74 6f 20 62 65 20 73 65  e infos to be se
8010: 74 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65  t.</li>..<li>the
8020: 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65   optional argume
8030: 6e 74 20 3c 62 3e 69 73 5f 71 75 65 72 79 61 62  nt <b>is_queryab
8040: 6c 65 3c 2f 62 3e 20 28 65 78 70 65 63 74 65 64  le</b> (expected
8050: 20 74 6f 20 62 65 20 6f 66 20 74 68 65 20 42 6f   to be of the Bo
8060: 6f 6c 65 61 6e 20 74 79 70 65 29 20 64 65 74 65  olean type) dete
8070: 72 6d 69 6e 65 73 20 69 66 20 74 68 65 20 43 6f  rmines if the Co
8080: 76 65 72 61 67 65 20 69 73 20 71 75 65 72 79 61  verage is querya
8090: 62 6c 65 20 6f 72 20 6e 6f 74 3b 20 69 66 20 6f  ble or not; if o
80a0: 6d 69 74 74 65 64 20 74 68 65 20 43 6f 76 65 72  mitted the Cover
80b0: 61 67 65 20 77 69 6c 6c 20 70 72 65 73 65 72 76  age will preserv
80c0: 65 20 74 68 65 20 61 6c 72 65 61 64 79 20 64 65  e the already de
80d0: 66 69 6e 65 64 20 76 61 6c 75 65 2e 3c 2f 6c 69  fined value.</li
80e0: 3e 0d 0a 3c 2f 75 6c 3e 3c 68 72 3e 0d 0a 74 68  >..</ul><hr>..th
80f0: 65 20 72 65 74 75 72 6e 20 74 79 70 65 20 69 73  e return type is
8100: 20 49 6e 74 65 67 65 72 2c 20 77 69 74 68 20 61   Integer, with a
8110: 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 6f 66   return value of
8120: 20 31 20 66 6f 72 20 54 52 55 45 20 28 73 75 63   1 for TRUE (suc
8130: 63 65 73 73 29 20 6f 72 20 30 20 66 6f 72 20 46  cess) or 0 for F
8140: 41 4c 53 45 20 28 66 61 69 6c 75 72 65 29 3a 20  ALSE (failure): 
8150: 2d 31 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72  -1 will be retur
8160: 6e 65 64 20 6f 6e 20 69 6e 76 61 6c 69 64 20 61  ned on invalid a
8170: 72 67 75 6d 65 6e 74 65 73 2e 3c 2f 74 64 3e 0d  rgumentes.</td>.
8180: 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74  .</tr>..<tr>..<t
8190: 64 3e 3c 62 3e 52 4c 32 5f 53 65 74 52 61 73 74  d><b>RL2_SetRast
81a0: 65 72 43 6f 76 65 72 61 67 65 43 6f 70 79 72 69  erCoverageCopyri
81b0: 67 68 74 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f 76  ght</b> ( <b>cov
81c0: 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69  erageName</b> <i
81d0: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
81e0: 3e 63 6f 70 79 72 69 67 68 74 3c 2f 62 3e 20 3c  >copyright</b> <
81f0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a  i>String</i> ) :
8200: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c   <i>Integer</i><
8210: 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f  br><br>..<b>RL2_
8220: 53 65 74 52 61 73 74 65 72 43 6f 76 65 72 61 67  SetRasterCoverag
8230: 65 43 6f 70 79 72 69 67 68 74 3c 2f 62 3e 20 28  eCopyright</b> (
8240: 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
8250: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
8260: 69 3e 20 2c 20 3c 62 3e 63 6f 70 79 72 69 67 68  i> , <b>copyrigh
8270: 74 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  t</b> <i>String<
8280: 2f 69 3e 20 2c 20 3c 62 3e 6c 69 63 65 6e 73 65  /i> , <b>license
8290: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
82a0: 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65  i> ) : <i>Intege
82b0: 72 3c 2f 69 3e 0d 0a 3c 2f 74 64 3e 0d 0a 3c 74  r</i>..</td>..<t
82c0: 64 3e 49 6e 73 65 72 74 73 20 28 6f 72 20 75 70  d>Inserts (or up
82d0: 64 61 74 65 73 29 20 43 6f 70 79 72 69 67 68 74  dates) Copyright
82e0: 20 61 6e 64 20 4c 69 63 65 6e 73 65 20 69 6e 66   and License inf
82f0: 6f 73 20 61 73 73 6f 63 69 61 74 65 64 20 74 6f  os associated to
8300: 20 61 20 43 6f 76 65 72 61 67 65 2e 0d 0a 3c 75   a Coverage...<u
8310: 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 63 6f 76 65 72  l>..<li><b>cover
8320: 61 67 65 5f 6e 61 6d 65 3c 2f 62 3e 20 6d 75 73  age_name</b> mus
8330: 74 20 69 64 65 6e 74 69 66 79 20 61 6e 20 65 78  t identify an ex
8340: 69 73 74 69 6e 67 20 43 6f 76 65 72 61 67 65 2e  isting Coverage.
8350: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 63 6f  </li>..<li><b>co
8360: 70 79 72 69 67 68 74 3c 2f 62 3e 20 69 64 65 6e  pyright</b> iden
8370: 74 69 66 69 65 73 20 74 68 65 20 43 6f 70 79 72  tifies the Copyr
8380: 69 67 68 74 20 68 6f 6c 64 65 72 3b 20 69 66 20  ight holder; if 
8390: 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 74 68 65 20  <b>NULL</b> the 
83a0: 63 75 72 72 65 6e 74 20 76 61 6c 75 65 20 77 69  current value wi
83b0: 6c 6c 20 62 65 20 70 72 65 73 65 72 76 65 64 2e  ll be preserved.
83c0: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f  </li>..<li>the o
83d0: 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74  ptional argument
83e0: 20 3c 62 3e 6c 69 63 65 6e 73 65 3c 2f 62 3e 20   <b>license</b> 
83f0: 6d 75 73 74 20 72 65 66 65 72 65 6e 63 65 20 6f  must reference o
8400: 6e 65 20 74 68 65 20 44 61 74 61 20 4c 69 63 65  ne the Data Lice
8410: 6e 73 65 73 20 72 65 67 69 73 74 65 72 65 64 20  nses registered 
8420: 69 6e 74 6f 20 74 68 65 20 3c 62 3e 64 61 74 61  into the <b>data
8430: 5f 6c 69 63 65 6e 73 65 73 3c 2f 62 3e 20 74 61  _licenses</b> ta
8440: 62 6c 65 2c 20 61 73 20 65 2e 67 2e 20 3c 69 3e  ble, as e.g. <i>
8450: 43 43 30 20 31 2e 30 3c 2f 69 3e 20 6f 72 20 3c  CC0 1.0</i> or <
8460: 69 3e 43 43 20 42 59 20 34 2e 30 3c 2f 69 3e 2e  i>CC BY 4.0</i>.
8470: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 68 72 3e  </li>..</ul><hr>
8480: 0d 0a 74 68 65 20 72 65 74 75 72 6e 20 74 79 70  ..the return typ
8490: 65 20 69 73 20 49 6e 74 65 67 65 72 2c 20 77 69  e is Integer, wi
84a0: 74 68 20 61 20 72 65 74 75 72 6e 20 76 61 6c 75  th a return valu
84b0: 65 20 6f 66 20 31 20 66 6f 72 20 54 52 55 45 20  e of 1 for TRUE 
84c0: 28 73 75 63 63 65 73 73 29 20 6f 72 20 30 20 66  (success) or 0 f
84d0: 6f 72 20 46 41 4c 53 45 20 28 66 61 69 6c 75 72  or FALSE (failur
84e0: 65 29 3a 20 2d 31 20 77 69 6c 6c 20 62 65 20 72  e): -1 will be r
84f0: 65 74 75 72 6e 65 64 20 6f 6e 20 69 6e 76 61 6c  eturned on inval
8500: 69 64 20 61 72 67 75 6d 65 6e 74 65 73 2e 3c 2f  id argumentes.</
8510: 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e  td>..</tr>..<tr>
8520: 0d 0a 3c 74 64 3e 3c 62 3e 52 4c 32 5f 44 72 6f  ..<td><b>RL2_Dro
8530: 70 43 6f 76 65 72 61 67 65 3c 2f 62 3e 20 28 20  pCoverage</b> ( 
8540: 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
8550: 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
8560: 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72  > ) : <i>Integer
8570: 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62  </i><br><br>..<b
8580: 3e 52 4c 32 5f 44 72 6f 70 43 6f 76 65 72 61 67  >RL2_DropCoverag
8590: 65 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f 76 65 72  e</b> ( <b>cover
85a0: 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  ageName</b> <i>S
85b0: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 74  tring</i> , <b>t
85c0: 72 61 6e 73 61 63 74 69 6f 6e 3c 2f 62 3e 20 3c  ransaction</b> <
85d0: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20  i>Integer</i> ) 
85e0: 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  : <i>Integer</i>
85f0: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20  </td>..<td>Will 
8600: 61 74 74 65 6d 70 74 20 64 6f 20 63 6f 6d 70 6c  attempt do compl
8610: 65 74 65 6c 79 20 72 65 6d 6f 76 65 20 61 20 52  etely remove a R
8620: 61 73 74 65 72 20 43 6f 76 65 72 61 67 65 20 28  aster Coverage (
8630: 69 6e 63 6c 75 64 69 6e 67 20 61 6c 6c 20 72 65  including all re
8640: 6c 61 74 65 64 20 53 65 63 74 69 6f 6e 73 2c 20  lated Sections, 
8650: 50 79 72 61 6d 69 64 73 20 61 6e 64 20 54 69 6c  Pyramids and Til
8660: 65 73 29 20 66 72 6f 6d 20 74 68 65 20 63 75 72  es) from the cur
8670: 72 65 6e 74 6c 79 20 63 6f 6e 6e 65 63 74 65 64  rently connected
8680: 20 44 42 2d 66 69 6c 65 2e 3c 62 72 3e 0d 0a 57   DB-file.<br>..W
8690: 69 6c 6c 20 72 65 74 75 72 6e 20 3c 62 3e 31 3c  ill return <b>1<
86a0: 2f 62 3e 20 28 54 52 55 45 2f 53 55 43 43 45 53  /b> (TRUE/SUCCES
86b0: 53 29 20 6f 72 20 3c 62 3e 30 3c 2f 62 3e 20 28  S) or <b>0</b> (
86c0: 46 41 4c 53 45 2f 46 41 49 4c 55 52 45 29 3a 20  FALSE/FAILURE): 
86d0: 6f 72 20 3c 62 3e 2d 31 3c 2f 62 3e 20 6f 6e 20  or <b>-1</b> on 
86e0: 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74  invalid argument
86f0: 73 2e 3c 62 72 3e 0d 0a 3c 75 3e 50 6c 65 61 73  s.<br>..<u>Pleas
8700: 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 69 66 20 74  e note</u>: if t
8710: 68 65 20 73 65 63 6f 6e 64 20 6f 70 74 69 6f 6e  he second option
8720: 61 6c 20 61 72 67 75 6d 65 6e 74 20 28 65 78 70  al argument (exp
8730: 65 63 74 65 64 20 74 6f 20 62 65 20 6f 66 20 74  ected to be of t
8740: 68 65 20 42 6f 6f 6c 65 61 6e 20 74 79 70 65 29  he Boolean type)
8750: 20 69 73 6e 27 74 20 64 65 63 6c 61 72 65 64 20   isn't declared 
8760: 61 6e 20 69 6e 74 65 72 6e 61 6c 20 53 51 4c 20  an internal SQL 
8770: 54 72 61 6e 73 61 63 74 69 6f 6e 20 77 69 6c 6c  Transaction will
8780: 20 62 65 20 69 6d 70 6c 69 63 69 74 6c 79 20 68   be implicitly h
8790: 61 6e 64 6c 65 64 2e 3c 2f 74 64 3e 0d 0a 3c 2f  andled.</td>..</
87a0: 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 0d  tr>..<tr>..<td>.
87b0: 0a 3c 62 3e 52 4c 32 5f 43 6f 70 79 52 61 73 74  .<b>RL2_CopyRast
87c0: 65 72 43 6f 76 65 72 61 67 65 3c 2f 62 3e 20 28  erCoverage</b> (
87d0: 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e   <b>dbPrefix</b>
87e0: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
87f0: 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
8800: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
8810: 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65  i> ) : <i>Intege
8820: 72 3c 2f 69 3e 0d 0a 3c 62 72 3e 3c 62 72 3e 0d  r</i>..<br><br>.
8830: 0a 3c 62 3e 52 4c 32 5f 43 6f 70 79 52 61 73 74  .<b>RL2_CopyRast
8840: 65 72 43 6f 76 65 72 61 67 65 3c 2f 62 3e 20 28  erCoverage</b> (
8850: 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e   <b>dbPrefix</b>
8860: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
8870: 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
8880: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
8890: 69 3e 20 2c 20 3c 62 3e 74 72 61 6e 73 61 63 74  i> , <b>transact
88a0: 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 62 6f 6f 6c 65  ion</b> <i>boole
88b0: 61 6e 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e  an</i> ) : <i>In
88c0: 74 65 67 65 72 3c 2f 69 3e 0d 0a 3c 2f 74 64 3e  teger</i>..</td>
88d0: 0d 0a 3c 74 64 3e 0d 0a 57 69 6c 6c 20 63 6f 70  ..<td>..Will cop
88e0: 79 20 61 20 63 6f 6d 70 6c 65 74 65 20 52 61 73  y a complete Ras
88f0: 74 65 72 20 43 6f 76 65 72 61 67 65 20 66 72 6f  ter Coverage fro
8900: 6d 20 61 6e 20 3c 62 3e 61 74 74 61 63 68 65 64  m an <b>attached
8910: 20 44 42 3c 2f 62 3e 20 74 6f 20 74 68 65 20 63   DB</b> to the c
8920: 75 72 72 65 6e 74 6c 79 20 63 6f 6e 6e 65 63 74  urrently connect
8930: 65 64 20 28 3c 62 3e 4d 41 49 4e 3c 2f 62 3e 29  ed (<b>MAIN</b>)
8940: 20 44 42 2e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e   DB...<ul>..<li>
8950: 61 20 76 61 6c 69 64 20 52 61 73 74 65 72 20 43  a valid Raster C
8960: 6f 76 65 72 61 67 65 20 6d 61 74 63 68 69 6e 67  overage matching
8970: 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
8980: 3c 2f 62 3e 20 6d 75 73 74 20 65 78 69 73 74 73  </b> must exists
8990: 20 77 69 74 68 69 6e 20 74 68 65 20 41 74 74 61   within the Atta
89a0: 63 68 65 64 20 44 42 20 69 64 65 6e 74 69 66 69  ched DB identifi
89b0: 65 64 20 62 79 20 3c 62 3e 64 62 50 72 65 66 69  ed by <b>dbPrefi
89c0: 78 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69  x</b>.</li>..<li
89d0: 3e 6e 6f 20 52 61 73 74 65 72 20 43 6f 76 65 72  >no Raster Cover
89e0: 61 67 65 20 6d 61 74 63 68 69 6e 67 20 3c 62 3e  age matching <b>
89f0: 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e  coverageName</b>
8a00: 20 6d 75 73 74 20 65 78 69 73 74 73 20 77 69 74   must exists wit
8a10: 68 69 6e 20 74 68 65 20 4d 41 49 4e 20 44 42 2e  hin the MAIN DB.
8a20: 3c 62 72 3e 0d 0a 49 74 20 77 69 6c 6c 20 62 65  <br>..It will be
8a30: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63   automatically c
8a40: 72 65 61 74 65 64 20 61 6e 64 20 70 6f 70 75 6c  reated and popul
8a50: 61 74 65 64 20 61 73 20 61 70 70 72 6f 70 72 69  ated as appropri
8a60: 61 74 65 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e  ate.</li>..</ul>
8a70: 0d 0a 57 69 6c 6c 20 72 65 74 75 72 6e 20 3c 62  ..Will return <b
8a80: 3e 31 3c 2f 62 3e 20 28 54 52 55 45 2f 53 55 43  >1</b> (TRUE/SUC
8a90: 43 45 53 53 29 20 6f 72 20 3c 62 3e 30 3c 2f 62  CESS) or <b>0</b
8aa0: 3e 20 28 46 41 4c 53 45 2f 46 41 49 4c 55 52 45  > (FALSE/FAILURE
8ab0: 29 3a 20 6f 72 20 3c 62 3e 2d 31 3c 2f 62 3e 20  ): or <b>-1</b> 
8ac0: 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d  on invalid argum
8ad0: 65 6e 74 73 2e 3c 62 72 3e 0d 0a 3c 75 3e 50 6c  ents.<br>..<u>Pl
8ae0: 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 69  ease note</u>: i
8af0: 66 20 74 68 65 20 74 68 69 72 64 20 6f 70 74 69  f the third opti
8b00: 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 28 65  onal argument (e
8b10: 78 70 65 63 74 65 64 20 74 6f 20 62 65 20 6f 66  xpected to be of
8b20: 20 74 68 65 20 42 6f 6f 6c 65 61 6e 20 74 79 70   the Boolean typ
8b30: 65 29 20 69 73 6e 27 74 20 64 65 63 6c 61 72 65  e) isn't declare
8b40: 64 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 53 51  d an internal SQ
8b50: 4c 20 54 72 61 6e 73 61 63 74 69 6f 6e 20 77 69  L Transaction wi
8b60: 6c 6c 20 62 65 20 69 6d 70 6c 69 63 69 74 6c 79  ll be implicitly
8b70: 20 68 61 6e 64 6c 65 64 2e 0d 0a 3c 2f 74 64 3e   handled...</td>
8b80: 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c  ..</tr>..<tr>..<
8b90: 74 64 3e 3c 62 3e 52 4c 32 5f 44 65 6c 65 74 65  td><b>RL2_Delete
8ba0: 53 65 63 74 69 6f 6e 3c 2f 62 3e 20 28 20 3c 62  Section</b> ( <b
8bb0: 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62  >coverageName</b
8bc0: 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
8bd0: 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 49 44 3c 2f  , <b>sectionID</
8be0: 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
8bf0: 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72  > ) : <i>Integer
8c00: 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62  </i><br><br>..<b
8c10: 3e 52 4c 32 5f 44 65 6c 65 74 65 53 65 63 74 69  >RL2_DeleteSecti
8c20: 6f 6e 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f 76 65  on</b> ( <b>cove
8c30: 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e  rageName</b> <i>
8c40: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
8c50: 73 65 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69  sectionID</b> <i
8c60: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
8c70: 62 3e 74 72 61 6e 73 61 63 74 69 6f 6e 3c 2f 62  b>transaction</b
8c80: 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
8c90: 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c   ) : <i>Integer<
8ca0: 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69  /i></td>..<td>Wi
8cb0: 6c 6c 20 61 74 74 65 6d 70 74 20 64 6f 20 63 6f  ll attempt do co
8cc0: 6d 70 6c 65 74 65 6c 79 20 72 65 6d 6f 76 65 20  mpletely remove 
8cd0: 61 20 52 61 73 74 65 72 20 53 65 63 74 69 6f 6e  a Raster Section
8ce0: 20 28 69 6e 63 6c 75 64 69 6e 67 20 61 20 64 69   (including a di
8cf0: 72 65 63 74 6c 79 20 72 65 6c 61 74 65 64 20 50  rectly related P
8d00: 79 72 61 6d 69 64 20 69 66 20 70 72 65 73 65 6e  yramid if presen
8d10: 74 20 61 6e 64 20 61 6c 6c 20 72 65 6c 61 74 65  t and all relate
8d20: 64 20 54 69 6c 65 73 29 20 66 72 6f 6d 20 74 68  d Tiles) from th
8d30: 65 20 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e 6e  e currently conn
8d40: 65 63 74 65 64 20 44 42 2d 66 69 6c 65 2e 3c 62  ected DB-file.<b
8d50: 72 3e 0d 0a 57 69 6c 6c 20 72 65 74 75 72 6e 20  r>..Will return 
8d60: 3c 62 3e 31 3c 2f 62 3e 20 28 54 52 55 45 2f 53  <b>1</b> (TRUE/S
8d70: 55 43 43 45 53 53 29 20 6f 72 20 3c 62 3e 30 3c  UCCESS) or <b>0<
8d80: 2f 62 3e 20 28 46 41 4c 53 45 2f 46 41 49 4c 55  /b> (FALSE/FAILU
8d90: 52 45 29 3a 20 6f 72 20 3c 62 3e 2d 31 3c 2f 62  RE): or <b>-1</b
8da0: 3e 20 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72 67  > on invalid arg
8db0: 75 6d 65 6e 74 73 2e 3c 62 72 3e 0d 0a 3c 75 3e  uments.<br>..<u>
8dc0: 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a  Please note</u>:
8dd0: 20 69 66 20 74 68 65 20 74 68 69 72 64 20 6f 70   if the third op
8de0: 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20  tional argument 
8df0: 28 65 78 70 65 63 74 65 64 20 74 6f 20 62 65 20  (expected to be 
8e00: 6f 66 20 74 68 65 20 42 6f 6f 6c 65 61 6e 20 74  of the Boolean t
8e10: 79 70 65 29 20 69 73 6e 27 74 20 64 65 63 6c 61  ype) isn't decla
8e20: 72 65 64 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20  red an internal 
8e30: 53 51 4c 20 54 72 61 6e 73 61 63 74 69 6f 6e 20  SQL Transaction 
8e40: 77 69 6c 6c 20 62 65 20 69 6d 70 6c 69 63 69 74  will be implicit
8e50: 6c 79 20 68 61 6e 64 6c 65 64 2e 3c 2f 74 64 3e  ly handled.</td>
8e60: 0d 0a 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65  ..</tr>..</table
8e70: 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a 3c 68 32  ><br>..<hr>..<h2
8e80: 3e 53 51 4c 20 66 75 6e 63 74 69 6f 6e 73 20 73  >SQL functions s
8e90: 75 70 70 6f 72 74 69 6e 67 20 50 79 72 61 6d 69  upporting Pyrami
8ea0: 64 20 6d 61 6e 61 67 65 6d 65 6e 74 3c 2f 68 32  d management</h2
8eb0: 3e 20 0d 0a 3c 74 61 62 6c 65 20 77 69 64 74 68  > ..<table width
8ec0: 3d 22 31 30 30 25 22 20 62 6f 72 64 65 72 3d 22  ="100%" border="
8ed0: 31 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66  1" bgcolor="#fff
8ee0: 66 65 30 22 20 63 65 6c 6c 65 73 70 61 63 69 6e  fe0" cellespacin
8ef0: 67 3d 22 34 22 20 63 65 6c 6c 70 61 64 64 69 6e  g="4" cellpaddin
8f00: 67 3d 22 36 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20  g="6">..<tr><th 
8f10: 62 67 63 6f 6c 6f 72 3d 22 23 65 30 65 30 65 30  bgcolor="#e0e0e0
8f20: 22 20 77 69 64 74 68 3d 22 35 30 25 22 3e 53 79  " width="50%">Sy
8f30: 6e 74 61 78 3c 2f 74 68 3e 3c 74 68 20 62 67 63  ntax</th><th bgc
8f40: 6f 6c 6f 72 3d 22 23 65 30 65 30 65 30 22 20 77  olor="#e0e0e0" w
8f50: 69 64 74 68 3d 22 35 30 25 22 3e 53 75 6d 6d 61  idth="50%">Summa
8f60: 72 79 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74  ry</th></tr>..<t
8f70: 72 3e 3c 74 64 3e 3c 62 3e 52 4c 32 5f 50 79 72  r><td><b>RL2_Pyr
8f80: 61 6d 69 64 69 7a 65 3c 2f 62 3e 20 28 20 3c 62  amidize</b> ( <b
8f90: 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62  >coverageName</b
8fa0: 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
8fb0: 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  ) : <i>Integer</
8fc0: 69 3e 3c 62 72 3e 3c 62 72 3e 3c 62 3e 52 4c 32  i><br><br><b>RL2
8fd0: 5f 50 79 72 61 6d 69 64 69 7a 65 3c 2f 62 3e 20  _Pyramidize</b> 
8fe0: 28 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d  ( <b>coverageNam
8ff0: 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  e</b> <i>String<
9000: 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e  /i> , <b>section
9010: 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ID</b> <i>Intege
9020: 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74  r</i> ) : <i>Int
9030: 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e  eger</i><br><br>
9040: 3c 62 3e 52 4c 32 5f 50 79 72 61 6d 69 64 69 7a  <b>RL2_Pyramidiz
9050: 65 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f 76 65 72  e</b> ( <b>cover
9060: 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  ageName</b> <i>S
9070: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73  tring</i> , <b>s
9080: 65 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e  ectionID</b> <i>
9090: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
90a0: 3e 66 6f 72 63 65 52 65 62 75 69 6c 64 3c 2f 62  >forceRebuild</b
90b0: 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
90c0: 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c   ) : <i>Integer<
90d0: 2f 69 3e 3c 62 72 3e 3c 62 72 3e 3c 62 3e 52 4c  /i><br><br><b>RL
90e0: 32 5f 50 79 72 61 6d 69 64 69 7a 65 3c 2f 62 3e  2_Pyramidize</b>
90f0: 20 28 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61   ( <b>coverageNa
9100: 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  me</b> <i>String
9110: 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f  </i> , <b>sectio
9120: 6e 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  nID</b> <i>Integ
9130: 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 66 6f 72 63  er</i> , <b>forc
9140: 65 52 65 62 75 69 6c 64 3c 2f 62 3e 20 3c 69 3e  eRebuild</b> <i>
9150: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
9160: 3e 74 72 61 6e 73 61 63 74 69 6f 6e 3c 2f 62 3e  >transaction</b>
9170: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
9180: 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  ) : <i>Integer</
9190: 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c  i></td>..<td>Wil
91a0: 6c 20 61 74 74 65 6d 70 74 20 64 6f 20 28 72 65  l attempt do (re
91b0: 29 62 75 69 6c 64 20 3c 62 3e 3c 69 3e 53 65 63  )build <b><i>Sec
91c0: 74 69 6f 6e 2d 62 61 73 65 64 3c 2f 69 3e 3c 2f  tion-based</i></
91d0: 62 3e 20 50 79 72 61 6d 69 64 20 6c 65 76 65 6c  b> Pyramid level
91e0: 73 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72 65 74  s.<br>..Will ret
91f0: 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28 54 52  urn <b>1</b> (TR
9200: 55 45 2f 53 55 43 43 45 53 53 29 20 6f 72 20 3c  UE/SUCCESS) or <
9210: 62 3e 30 3c 2f 62 3e 20 28 46 41 4c 53 45 2f 46  b>0</b> (FALSE/F
9220: 41 49 4c 55 52 45 29 3a 20 6f 72 20 3c 62 3e 2d  AILURE): or <b>-
9230: 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69 64  1</b> on invalid
9240: 20 61 72 67 75 6d 65 6e 74 73 2e 3c 62 72 3e 0d   arguments.<br>.
9250: 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c  .<u>Please note<
9260: 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69  /u>: ..<ul>..<li
9270: 3e 69 66 20 61 20 73 69 6e 67 6c 65 20 3c 62 3e  >if a single <b>
9280: 3c 69 3e 73 65 63 74 69 6f 6e 49 44 3c 2f 69 3e  <i>sectionID</i>
9290: 3c 2f 62 3e 20 69 73 20 73 70 65 63 69 66 69 65  </b> is specifie
92a0: 64 2c 20 74 68 65 6e 20 6f 6e 6c 79 20 74 68 65  d, then only the
92b0: 20 50 79 72 61 6d 69 64 20 6c 65 76 65 6c 73 20   Pyramid levels 
92c0: 64 69 72 65 63 74 6c 79 20 62 65 6c 6f 6e 67 69  directly belongi
92d0: 6e 67 20 74 6f 20 74 68 61 74 20 53 65 63 74 69  ng to that Secti
92e0: 6f 6e 20 77 69 6c 6c 20 62 65 20 63 6f 6e 73 69  on will be consi
92f0: 64 65 72 65 64 2e 3c 62 72 3e 0d 0a 41 20 3c 62  dered.<br>..A <b
9300: 3e 4e 55 4c 4c 3c 2f 62 3e 20 73 65 63 74 69 6f  >NULL</b> sectio
9310: 6e 49 44 20 61 6c 77 61 79 73 20 69 6d 70 6c 69  nID always impli
9320: 65 73 20 70 72 6f 63 65 73 73 69 6e 67 20 74 68  es processing th
9330: 65 20 77 68 6f 6c 65 20 43 6f 76 65 72 61 67 65  e whole Coverage
9340: 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69 66 20 74  .</li>..<li>if t
9350: 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75  he optional argu
9360: 6d 65 6e 74 20 3c 62 3e 3c 69 3e 66 6f 72 63 65  ment <b><i>force
9370: 52 65 62 75 69 6c 64 3c 2f 69 3e 3c 2f 62 3e 20  Rebuild</i></b> 
9380: 28 65 78 70 65 63 74 65 64 20 74 6f 20 62 65 20  (expected to be 
9390: 6f 66 20 74 68 65 20 42 6f 6f 6c 65 61 6e 20 74  of the Boolean t
93a0: 79 70 65 29 20 61 6e 79 20 61 6c 72 65 61 64 79  ype) any already
93b0: 20 65 78 69 73 74 69 6e 67 20 50 79 72 61 6d 69   existing Pyrami
93c0: 64 20 6c 65 76 65 6c 20 77 69 6c 6c 20 62 65 20  d level will be 
93d0: 69 6d 6d 65 64 69 61 74 65 6c 79 20 64 65 73 74  immediately dest
93e0: 72 6f 79 65 64 20 61 6e 64 20 74 68 65 6e 20 72  royed and then r
93f0: 65 62 75 69 6c 64 2e 0d 0a 49 66 20 6e 6f 74 2c  ebuild...If not,
9400: 20 61 6c 6c 20 65 78 69 73 74 69 6e 67 20 50 79   all existing Py
9410: 72 61 6d 69 64 20 6c 65 76 65 6c 73 20 77 69 6c  ramid levels wil
9420: 6c 20 62 65 20 6c 65 66 74 20 75 6e 74 6f 75 63  l be left untouc
9430: 68 65 64 20 61 6e 64 20 6f 6e 6c 79 20 65 76 65  hed and only eve
9440: 6e 74 75 61 6c 6c 79 20 6d 69 73 73 69 6e 67 20  ntually missing 
9450: 6c 65 76 65 6c 73 20 77 69 6c 6c 20 62 65 20 62  levels will be b
9460: 75 69 6c 74 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  uilt.</li>..<li>
9470: 69 66 20 74 68 65 20 6c 61 73 74 20 6f 70 74 69  if the last opti
9480: 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 28 65  onal argument (e
9490: 78 70 65 63 74 65 64 20 74 6f 20 62 65 20 6f 66  xpected to be of
94a0: 20 74 68 65 20 42 6f 6f 6c 65 61 6e 20 74 79 70   the Boolean typ
94b0: 65 29 20 69 73 6e 27 74 20 64 65 63 6c 61 72 65  e) isn't declare
94c0: 64 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 53 51  d an internal SQ
94d0: 4c 20 54 72 61 6e 73 61 63 74 69 6f 6e 20 77 69  L Transaction wi
94e0: 6c 6c 20 62 65 20 69 6d 70 6c 69 63 69 74 6c 79  ll be implicitly
94f0: 20 68 61 6e 64 6c 65 64 2e 3c 2f 6c 69 3e 0d 0a   handled.</li>..
9500: 3c 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72  </ul></td>..</tr
9510: 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 52 4c  >..<tr><td><b>RL
9520: 32 5f 50 79 72 61 6d 69 64 69 7a 65 4d 6f 6e 6f  2_PyramidizeMono
9530: 6c 69 74 68 69 63 3c 2f 62 3e 20 28 20 3c 62 3e  lithic</b> ( <b>
9540: 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e  coverageName</b>
9550: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29   <i>String</i> )
9560: 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69   : <i>Integer</i
9570: 3e 3c 62 72 3e 3c 62 72 3e 3c 62 3e 52 4c 32 5f  ><br><br><b>RL2_
9580: 50 79 72 61 6d 69 64 69 7a 65 4d 6f 6e 6f 6c 69  PyramidizeMonoli
9590: 74 68 69 63 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f  thic</b> ( <b>co
95a0: 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c  verageName</b> <
95b0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
95c0: 62 3e 76 69 72 74 75 61 6c 4c 65 76 65 6c 73 3c  b>virtualLevels<
95d0: 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
95e0: 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65  i> ) : <i>Intege
95f0: 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 3c 62 3e  r</i><br><br><b>
9600: 52 4c 32 5f 50 79 72 61 6d 69 64 69 7a 65 4d 6f  RL2_PyramidizeMo
9610: 6e 6f 6c 69 74 68 69 63 3c 2f 62 3e 20 28 20 3c  nolithic</b> ( <
9620: 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f  b>coverageName</
9630: 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
9640: 20 2c 20 3c 62 3e 76 69 72 74 75 61 6c 4c 65 76   , <b>virtualLev
9650: 65 6c 73 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  els</b> <i>Integ
9660: 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 74 72 61 6e  er</i> , <b>tran
9670: 73 61 63 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 49  saction</b> <i>I
9680: 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c  nteger</i> ) : <
9690: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74  i>Integer</i></t
96a0: 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 61 74 74  d>..<td>Will att
96b0: 65 6d 70 74 20 64 6f 20 28 72 65 29 62 75 69 6c  empt do (re)buil
96c0: 64 20 50 79 72 61 6d 69 64 20 6c 65 76 65 6c 73  d Pyramid levels
96d0: 20 6f 66 20 74 68 65 20 3c 62 3e 4d 6f 6e 6f 6c   of the <b>Monol
96e0: 69 74 68 69 63 3c 2f 62 3e 20 74 79 70 65 2e 3c  ithic</b> type.<
96f0: 62 72 3e 0d 0a 57 69 6c 6c 20 72 65 74 75 72 6e  br>..Will return
9700: 20 3c 62 3e 31 3c 2f 62 3e 20 28 54 52 55 45 2f   <b>1</b> (TRUE/
9710: 53 55 43 43 45 53 53 29 20 6f 72 20 3c 62 3e 30  SUCCESS) or <b>0
9720: 3c 2f 62 3e 20 28 46 41 4c 53 45 2f 46 41 49 4c  </b> (FALSE/FAIL
9730: 55 52 45 29 3a 20 6f 72 20 3c 62 3e 2d 31 3c 2f  URE): or <b>-1</
9740: 62 3e 20 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72  b> on invalid ar
9750: 67 75 6d 65 6e 74 73 2e 3c 62 72 3e 0d 0a 3c 75  guments.<br>..<u
9760: 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e  >Please note</u>
9770: 3a 20 0d 0a 3c 75 6c 3e 3c 6c 69 3e 74 68 65 20  : ..<ul><li>the 
9780: 77 68 6f 6c 65 20 43 6f 76 65 72 61 67 65 20 77  whole Coverage w
9790: 69 6c 6c 20 62 65 20 61 6c 77 61 79 73 20 70 72  ill be always pr
97a0: 6f 63 65 73 73 65 64 2c 20 61 6e 64 20 61 6e 79  ocessed, and any
97b0: 20 65 76 65 6e 74 75 61 6c 6c 79 20 70 72 65 65   eventually pree
97c0: 78 69 73 74 69 6e 67 20 3c 62 3e 3c 69 3e 53 65  xisting <b><i>Se
97d0: 63 74 69 6f 6e 2d 62 61 73 65 64 3c 2f 69 3e 3c  ction-based</i><
97e0: 2f 62 3e 20 6f 72 20 3c 62 3e 3c 69 3e 4d 6f 6e  /b> or <b><i>Mon
97f0: 6f 6c 69 74 68 69 63 3c 2f 69 3e 3c 2f 62 3e 20  olithic</i></b> 
9800: 50 79 72 61 6d 69 64 20 77 69 6c 6c 20 62 65 20  Pyramid will be 
9810: 64 65 73 74 72 6f 79 65 64 20 69 6e 20 6f 72 64  destroyed in ord
9820: 65 72 20 74 6f 20 72 65 62 75 69 6c 64 20 61 20  er to rebuild a 
9830: 6e 65 77 20 50 79 72 61 6d 69 64 20 66 72 6f 6d  new Pyramid from
9840: 20 73 63 72 61 74 63 68 2e 3c 2f 6c 69 3e 0d 0a   scratch.</li>..
9850: 3c 6c 69 3e 74 68 65 20 73 65 63 6f 6e 64 20 6f  <li>the second o
9860: 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74  ptional argument
9870: 20 3c 62 3e 3c 69 3e 76 69 72 74 75 61 6c 4c 65   <b><i>virtualLe
9880: 76 65 6c 73 3c 2f 69 3e 3c 2f 62 3e 20 61 6c 6c  vels</i></b> all
9890: 6f 77 73 20 74 6f 20 63 68 6f 6f 73 65 20 74 68  ows to choose th
98a0: 65 20 70 72 65 66 65 72 72 65 64 20 69 6e 74 65  e preferred inte
98b0: 72 6c 65 61 76 65 20 66 61 63 74 6f 72 20 62 65  rleave factor be
98c0: 74 77 65 65 6e 20 3c 69 3e 3c 75 3e 70 68 79 73  tween <i><u>phys
98d0: 69 63 61 6c 3c 2f 75 3e 3c 2f 69 3e 20 61 6e 64  ical</u></i> and
98e0: 20 3c 69 3e 3c 75 3e 76 69 72 74 75 61 6c 3c 2f   <i><u>virtual</
98f0: 75 3e 3c 2f 75 3e 20 4c 65 76 65 6c 73 2e 20 41  u></u> Levels. A
9900: 63 63 65 70 74 61 62 6c 65 20 76 61 6c 75 65 73  cceptable values
9910: 20 61 72 65 20 3c 62 3e 31 3c 2f 62 3e 2c 20 3c   are <b>1</b>, <
9920: 62 3e 32 3c 2f 62 3e 20 6f 72 20 3c 62 3e 33 3c  b>2</b> or <b>3<
9930: 2f 62 3e 2e 20 54 68 65 20 64 65 66 61 75 6c 74  /b>. The default
9940: 20 73 65 74 74 69 6e 67 20 69 73 20 3c 62 3e 33   setting is <b>3
9950: 3c 2f 62 3e 2c 20 77 69 74 68 20 74 68 65 20 6e  </b>, with the n
9960: 6f 74 61 62 6c 65 20 65 78 63 65 70 74 69 6f 6e  otable exception
9970: 20 6f 66 20 3c 62 3e 4d 4f 4e 4f 43 48 52 4f 4d   of <b>MONOCHROM
9980: 45 20 31 2d 42 49 54 3c 2f 62 3e 20 43 6f 76 65  E 1-BIT</b> Cove
9990: 72 61 67 65 73 2c 20 69 6e 20 77 68 69 63 68 20  rages, in which 
99a0: 63 61 73 65 20 77 69 6c 6c 20 62 65 20 3c 62 3e  case will be <b>
99b0: 31 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69  1</b>.</li>..<li
99c0: 3e 69 66 20 74 68 65 20 6c 61 73 74 20 6f 70 74  >if the last opt
99d0: 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 28  ional argument (
99e0: 65 78 70 65 63 74 65 64 20 74 6f 20 62 65 20 6f  expected to be o
99f0: 66 20 74 68 65 20 42 6f 6f 6c 65 61 6e 20 74 79  f the Boolean ty
9a00: 70 65 29 20 69 73 6e 27 74 20 64 65 63 6c 61 72  pe) isn't declar
9a10: 65 64 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 53  ed an internal S
9a20: 51 4c 20 54 72 61 6e 73 61 63 74 69 6f 6e 20 77  QL Transaction w
9a30: 69 6c 6c 20 62 65 20 69 6d 70 6c 69 63 69 74 6c  ill be implicitl
9a40: 79 20 68 61 6e 64 6c 65 64 2e 3c 2f 6c 69 3e 0d  y handled.</li>.
9a50: 0a 3c 2f 75 6c 3e 0d 0a 3c 75 3e 49 6d 70 6f 72  .</ul>..<u>Impor
9a60: 74 61 6e 74 20 4e 6f 74 69 63 65 3c 2f 75 3e 3a  tant Notice</u>:
9a70: 20 61 20 4d 6f 6e 6f 6c 69 74 68 69 63 20 50 79   a Monolithic Py
9a80: 72 61 6d 69 64 20 69 73 20 6e 6f 74 20 63 6f 6d  ramid is not com
9a90: 70 61 74 69 62 6c 65 20 77 69 74 68 20 61 6e 79  patible with any
9aa0: 20 43 6f 76 65 72 61 67 65 20 64 65 63 6c 61 72   Coverage declar
9ab0: 65 64 20 62 79 20 65 6e 61 62 6c 69 6e 67 20 74  ed by enabling t
9ac0: 68 65 20 3c 62 3e 6d 69 78 65 64 52 65 73 6f 6c  he <b>mixedResol
9ad0: 75 74 69 6f 6e 3c 2f 62 3e 20 50 6f 6c 69 63 79  ution</b> Policy
9ae0: 2e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c  .</td>..</tr>..<
9af0: 74 72 3e 3c 74 64 3e 3c 62 3e 52 4c 32 5f 44 65  tr><td><b>RL2_De
9b00: 50 79 72 61 6d 69 64 69 7a 65 3c 2f 62 3e 20 28  Pyramidize</b> (
9b10: 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
9b20: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
9b30: 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65  i> ) : <i>Intege
9b40: 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 3c 62 3e  r</i><br><br><b>
9b50: 52 4c 32 5f 44 65 50 79 72 61 6d 69 64 69 7a 65  RL2_DePyramidize
9b60: 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f 76 65 72 61  </b> ( <b>covera
9b70: 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74  geName</b> <i>St
9b80: 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65  ring</i> , <b>se
9b90: 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e 49  ctionID</b> <i>I
9ba0: 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c  nteger</i> ) : <
9bb0: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72  i>Integer</i><br
9bc0: 3e 3c 62 72 3e 3c 62 3e 52 4c 32 5f 44 65 50 79  ><br><b>RL2_DePy
9bd0: 72 61 6d 69 64 69 7a 65 3c 2f 62 3e 20 28 20 3c  ramidize</b> ( <
9be0: 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f  b>coverageName</
9bf0: 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
9c00: 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 49 44 3c   , <b>sectionID<
9c10: 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
9c20: 69 3e 20 2c 20 3c 62 3e 74 72 61 6e 73 61 63 74  i> , <b>transact
9c30: 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  ion</b> <i>Integ
9c40: 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e  er</i> ) : <i>In
9c50: 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a  teger</i></td>..
9c60: 3c 74 64 3e 57 69 6c 6c 20 61 74 74 65 6d 70 74  <td>Will attempt
9c70: 20 64 6f 20 64 65 73 74 72 6f 79 20 50 79 72 61   do destroy Pyra
9c80: 6d 69 64 20 6c 65 76 65 6c 73 2e 3c 62 72 3e 0d  mid levels.<br>.
9c90: 0a 57 69 6c 6c 20 72 65 74 75 72 6e 20 3c 62 3e  .Will return <b>
9ca0: 31 3c 2f 62 3e 20 28 54 52 55 45 2f 53 55 43 43  1</b> (TRUE/SUCC
9cb0: 45 53 53 29 20 6f 72 20 3c 62 3e 30 3c 2f 62 3e  ESS) or <b>0</b>
9cc0: 20 28 46 41 4c 53 45 2f 46 41 49 4c 55 52 45 29   (FALSE/FAILURE)
9cd0: 3a 20 6f 72 20 3c 62 3e 2d 31 3c 2f 62 3e 20 6f  : or <b>-1</b> o
9ce0: 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65  n invalid argume
9cf0: 6e 74 73 2e 3c 62 72 3e 0d 0a 3c 75 3e 50 6c 65  nts.<br>..<u>Ple
9d00: 61 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 0d 0a  ase note</u>: ..
9d10: 3c 75 6c 3e 0d 0a 3c 6c 69 3e 69 66 20 61 20 73  <ul>..<li>if a s
9d20: 69 6e 67 6c 65 20 3c 62 3e 3c 69 3e 73 65 63 74  ingle <b><i>sect
9d30: 69 6f 6e 49 44 3c 2f 69 3e 3c 2f 62 3e 20 69 73  ionID</i></b> is
9d40: 20 73 70 65 63 69 66 69 65 64 2c 20 74 68 65 6e   specified, then
9d50: 20 6f 6e 6c 79 20 74 68 65 20 50 79 72 61 6d 69   only the Pyrami
9d60: 64 20 6c 65 76 65 6c 73 20 64 69 72 65 63 74 6c  d levels directl
9d70: 79 20 62 65 6c 6f 6e 67 69 6e 67 20 74 6f 20 74  y belonging to t
9d80: 68 61 74 20 53 65 63 74 69 6f 6e 20 77 69 6c 6c  hat Section will
9d90: 20 62 65 20 63 6f 6e 73 69 64 65 72 65 64 20 28   be considered (
9da0: 3c 69 3e 6f 6e 6c 79 20 73 75 70 70 6f 72 74 65  <i>only supporte
9db0: 64 20 66 6f 72 20 3c 62 3e 53 65 63 74 69 6f 6e  d for <b>Section
9dc0: 2d 62 61 73 65 64 3c 2f 62 3e 20 50 79 72 61 6d  -based</b> Pyram
9dd0: 69 64 73 3c 2f 69 3e 29 2e 3c 62 72 3e 0d 0a 41  ids</i>).<br>..A
9de0: 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 73 65 63   <b>NULL</b> sec
9df0: 74 69 6f 6e 49 44 20 61 6c 77 61 79 73 20 69 6d  tionID always im
9e00: 70 6c 69 65 73 20 70 72 6f 63 65 73 73 69 6e 67  plies processing
9e10: 20 74 68 65 20 77 68 6f 6c 65 20 43 6f 76 65 72   the whole Cover
9e20: 61 67 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69  age.</li>..<li>i
9e30: 66 20 74 68 65 20 6c 61 73 74 20 6f 70 74 69 6f  f the last optio
9e40: 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 28 65 78  nal argument (ex
9e50: 70 65 63 74 65 64 20 74 6f 20 62 65 20 6f 66 20  pected to be of 
9e60: 74 68 65 20 42 6f 6f 6c 65 61 6e 20 74 79 70 65  the Boolean type
9e70: 29 20 69 73 6e 27 74 20 64 65 63 6c 61 72 65 64  ) isn't declared
9e80: 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 53 51 4c   an internal SQL
9e90: 20 54 72 61 6e 73 61 63 74 69 6f 6e 20 77 69 6c   Transaction wil
9ea0: 6c 20 62 65 20 69 6d 70 6c 69 63 69 74 6c 79 20  l be implicitly 
9eb0: 68 61 6e 64 6c 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c  handled.</li>..<
9ec0: 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e  /ul></td>..</tr>
9ed0: 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a  ..</table><br>..
9ee0: 3c 68 72 3e 0d 0a 3c 68 32 3e 53 51 4c 20 66 75  <hr>..<h2>SQL fu
9ef0: 6e 63 74 69 6f 6e 73 20 72 65 74 75 72 6e 69 6e  nctions returnin
9f00: 67 20 73 74 79 6c 65 64 20 4d 61 70 73 3c 2f 68  g styled Maps</h
9f10: 32 3e 20 0d 0a 3c 74 61 62 6c 65 20 77 69 64 74  2> ..<table widt
9f20: 68 3d 22 31 30 30 25 22 20 62 6f 72 64 65 72 3d  h="100%" border=
9f30: 22 31 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66  "1" bgcolor="#ff
9f40: 66 66 65 30 22 20 63 65 6c 6c 65 73 70 61 63 69  ffe0" cellespaci
9f50: 6e 67 3d 22 34 22 20 63 65 6c 6c 70 61 64 64 69  ng="4" cellpaddi
9f60: 6e 67 3d 22 36 22 3e 0d 0a 3c 74 72 3e 3c 74 68  ng="6">..<tr><th
9f70: 20 62 67 63 6f 6c 6f 72 3d 22 23 65 30 65 30 65   bgcolor="#e0e0e
9f80: 30 22 20 77 69 64 74 68 3d 22 35 30 25 22 3e 53  0" width="50%">S
9f90: 79 6e 74 61 78 3c 2f 74 68 3e 3c 74 68 20 62 67  yntax</th><th bg
9fa0: 63 6f 6c 6f 72 3d 22 23 65 30 65 30 65 30 22 20  color="#e0e0e0" 
9fb0: 77 69 64 74 68 3d 22 35 30 25 22 3e 53 75 6d 6d  width="50%">Summ
9fc0: 61 72 79 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c  ary</th></tr>..<
9fd0: 74 72 3e 3c 74 64 3e 3c 62 3e 52 4c 32 5f 47 65  tr><td><b>RL2_Ge
9fe0: 74 4d 61 70 49 6d 61 67 65 46 72 6f 6d 52 61 73  tMapImageFromRas
9ff0: 74 65 72 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50  ter</b> ( <b>dbP
a000: 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72  refix</b> <i>Str
a010: 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76  ing</i> , <b>cov
a020: 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69  erageName</b> <i
a030: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
a040: 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e  >boundingBox</b>
a050: 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72   <i>BLOB-Geometr
a060: 79 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68  y</i> , <b>width
a070: 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
a080: 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c  /i> , <b>height<
a090: 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
a0a0: 69 3e 20 29 20 3a 20 3c 69 3e 42 4c 4f 42 3c 2f  i> ) : <i>BLOB</
a0b0: 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52  i><br><br>..<b>R
a0c0: 4c 32 5f 47 65 74 4d 61 70 49 6d 61 67 65 46 72  L2_GetMapImageFr
a0d0: 6f 6d 52 61 73 74 65 72 3c 2f 62 3e 20 28 20 3c  omRaster</b> ( <
a0e0: 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c  b>dbPrefix</b> <
a0f0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
a100: 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f  b>coverageName</
a110: 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
a120: 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f   , <b>boundingBo
a130: 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65  x</b> <i>BLOB-Ge
a140: 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e  ometry</i> , <b>
a150: 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74  width</b> <i>Int
a160: 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65  eger</i> , <b>he
a170: 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  ight</b> <i>Inte
a180: 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 73 74 79  ger</i> , <b>sty
a190: 6c 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74  leName</b> <i>St
a1a0: 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e  ring</i> ) : <i>
a1b0: 42 4c 4f 42 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e  BLOB</i><br><br>
a1c0: 0d 0a 3c 62 3e 52 4c 32 5f 47 65 74 4d 61 70 49  ..<b>RL2_GetMapI
a1d0: 6d 61 67 65 46 72 6f 6d 52 61 73 74 65 72 3c 2f  mageFromRaster</
a1e0: 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78  b> ( <b>dbPrefix
a1f0: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
a200: 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65  i> , <b>coverage
a210: 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Name</b> <i>Stri
a220: 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e  ng</i> , <b>boun
a230: 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42  dingBox</b> <i>B
a240: 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e  LOB-Geometry</i>
a250: 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20   , <b>width</b> 
a260: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
a270: 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c   <b>height</b> <
a280: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
a290: 3c 62 3e 73 74 79 6c 65 4e 61 6d 65 3c 2f 62 3e  <b>styleName</b>
a2a0: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
a2b0: 20 3c 62 3e 6d 69 6d 65 54 79 70 65 3c 2f 62 3e   <b>mimeType</b>
a2c0: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29   <i>String</i> )
a2d0: 20 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 62   : <i>BLOB</i><b
a2e0: 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 47  r><br>..<b>RL2_G
a2f0: 65 74 4d 61 70 49 6d 61 67 65 46 72 6f 6d 52 61  etMapImageFromRa
a300: 73 74 65 72 3c 2f 62 3e 20 28 20 3c 62 3e 64 62  ster</b> ( <b>db
a310: 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74  Prefix</b> <i>St
a320: 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f  ring</i> , <b>co
a330: 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c  verageName</b> <
a340: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
a350: 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62  b>boundingBox</b
a360: 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74  > <i>BLOB-Geomet
a370: 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74  ry</i> , <b>widt
a380: 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  h</b> <i>Integer
a390: 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74  </i> , <b>height
a3a0: 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
a3b0: 2f 69 3e 20 2c 20 3c 62 3e 73 74 79 6c 65 4e 61  /i> , <b>styleNa
a3c0: 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  me</b> <i>String
a3d0: 3c 2f 69 3e 20 2c 20 3c 62 3e 6d 69 6d 65 54 79  </i> , <b>mimeTy
a3e0: 70 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  pe</b> <i>String
a3f0: 3c 2f 69 3e 20 2c 20 3c 62 3e 62 67 43 6f 6c 6f  </i> , <b>bgColo
a400: 72 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  r</b> <i>String<
a410: 2f 69 3e 20 29 20 3a 20 3c 69 3e 42 4c 4f 42 3c  /i> ) : <i>BLOB<
a420: 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e  /i><br><br>..<b>
a430: 52 4c 32 5f 47 65 74 4d 61 70 49 6d 61 67 65 46  RL2_GetMapImageF
a440: 72 6f 6d 52 61 73 74 65 72 3c 2f 62 3e 20 28 20  romRaster</b> ( 
a450: 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20  <b>dbPrefix</b> 
a460: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
a470: 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
a480: 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
a490: 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42  > , <b>boundingB
a4a0: 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47  ox</b> <i>BLOB-G
a4b0: 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62  eometry</i> , <b
a4c0: 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
a4d0: 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
a4e0: 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
a4f0: 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 73 74  eger</i> , <b>st
a500: 79 6c 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  yleName</b> <i>S
a510: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 6d  tring</i> , <b>m
a520: 69 6d 65 54 79 70 65 3c 2f 62 3e 20 3c 69 3e 53  imeType</b> <i>S
a530: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62  tring</i> , <b>b
a540: 67 43 6f 6c 6f 72 3c 2f 62 3e 20 3c 69 3e 53 74  gColor</b> <i>St
a550: 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 74 72  ring</i> , <b>tr
a560: 61 6e 73 70 61 72 65 6e 74 3c 2f 62 3e 20 3c 69  ansparent</b> <i
a570: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a  >Integer</i> ) :
a580: 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 62 72 3e   <i>BLOB</i><br>
a590: 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 47 65 74  <br>..<b>RL2_Get
a5a0: 4d 61 70 49 6d 61 67 65 46 72 6f 6d 52 61 73 74  MapImageFromRast
a5b0: 65 72 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72  er</b> ( <b>dbPr
a5c0: 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  efix</b> <i>Stri
a5d0: 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65  ng</i> , <b>cove
a5e0: 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e  rageName</b> <i>
a5f0: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
a600: 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20  boundingBox</b> 
a610: 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79  <i>BLOB-Geometry
a620: 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c  </i> , <b>width<
a630: 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
a640: 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f  i> , <b>height</
a650: 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
a660: 3e 20 2c 20 3c 62 3e 73 74 79 6c 65 4e 61 6d 65  > , <b>styleName
a670: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
a680: 69 3e 20 2c 20 3c 62 3e 6d 69 6d 65 54 79 70 65  i> , <b>mimeType
a690: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
a6a0: 69 3e 20 2c 20 3c 62 3e 62 67 43 6f 6c 6f 72 3c  i> , <b>bgColor<
a6b0: 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
a6c0: 3e 20 2c 20 3c 62 3e 74 72 61 6e 73 70 61 72 65  > , <b>transpare
a6d0: 6e 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  nt</b> <i>Intege
a6e0: 72 3c 2f 69 3e 20 2c 20 3c 62 3e 71 75 61 6c 69  r</i> , <b>quali
a6f0: 74 79 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ty</b> <i>Intege
a700: 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 42 4c 4f  r</i> ) : <i>BLO
a710: 42 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c  B</i><br><br>..<
a720: 62 3e 52 4c 32 5f 47 65 74 4d 61 70 49 6d 61 67  b>RL2_GetMapImag
a730: 65 46 72 6f 6d 52 61 73 74 65 72 3c 2f 62 3e 20  eFromRaster</b> 
a740: 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62  ( <b>dbPrefix</b
a750: 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
a760: 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d  , <b>coverageNam
a770: 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  e</b> <i>String<
a780: 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e  /i> , <b>boundin
a790: 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42  gBox</b> <i>BLOB
a7a0: 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20  -Geometry</i> , 
a7b0: 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e  <b>width</b> <i>
a7c0: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
a7d0: 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49  >height</b> <i>I
a7e0: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
a7f0: 73 74 79 6c 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69  styleName</b> <i
a800: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
a810: 3e 6d 69 6d 65 54 79 70 65 3c 2f 62 3e 20 3c 69  >mimeType</b> <i
a820: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
a830: 3e 62 67 43 6f 6c 6f 72 3c 2f 62 3e 20 3c 69 3e  >bgColor</b> <i>
a840: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
a850: 74 72 61 6e 73 70 61 72 65 6e 74 3c 2f 62 3e 20  transparent</b> 
a860: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
a870: 20 3c 62 3e 71 75 61 6c 69 74 79 3c 2f 62 3e 20   <b>quality</b> 
a880: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
a890: 20 3c 62 3e 72 65 61 73 70 65 63 74 3c 2f 62 3e   <b>reaspect</b>
a8a0: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
a8b0: 29 20 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c  ) : <i>BLOB</i><
a8c0: 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 61  /td>..<td>Will a
a8d0: 74 74 65 6d 70 74 20 74 6f 20 63 72 65 61 74 65  ttempt to create
a8e0: 20 61 20 64 69 67 69 74 61 6c 20 69 6d 61 67 65   a digital image
a8f0: 20 72 65 70 72 65 73 65 6e 74 69 6e 67 20 61 20   representing a 
a900: 53 74 79 6c 65 64 20 4d 61 70 20 66 72 6f 6d 20  Styled Map from 
a910: 61 20 43 6f 76 65 72 61 67 65 20 6f 66 20 74 68  a Coverage of th
a920: 65 20 52 61 73 74 65 72 20 74 79 70 65 2e 3c 62  e Raster type.<b
a930: 72 3e 0d 0a 57 69 6c 6c 20 72 65 74 75 72 6e 20  r>..Will return 
a940: 61 20 42 4c 4f 42 20 63 6f 6e 74 61 69 6e 69 6e  a BLOB containin
a950: 67 20 74 68 65 20 53 74 79 6c 65 64 20 4d 61 70  g the Styled Map
a960: 3a 20 6f 72 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e  : or <b>NULL</b>
a970: 20 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75   on invalid argu
a980: 6d 65 6e 74 73 20 6f 72 20 69 66 20 61 6e 79 20  ments or if any 
a990: 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 3c 62 72  error occurs.<br
a9a0: 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74  >..<u>Please not
a9b0: 65 3c 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c  e</u>: ..<ul>..<
a9c0: 6c 69 3e 54 68 65 20 3c 62 3e 3c 69 3e 64 62 50  li>The <b><i>dbP
a9d0: 72 65 66 69 78 3c 2f 69 3e 3c 2f 62 3e 20 61 72  refix</i></b> ar
a9e0: 67 75 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e 64  gument is intend
a9f0: 65 64 20 74 6f 20 73 70 65 63 69 66 79 20 74 68  ed to specify th
aa00: 65 20 41 54 54 41 43 48 45 44 2d 44 42 20 77 68  e ATTACHED-DB wh
aa10: 65 72 65 20 74 68 65 20 43 6f 76 65 72 61 67 65  ere the Coverage
aa20: 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f 20   is expected to 
aa30: 62 65 20 66 6f 75 6e 64 3b 20 69 74 20 63 6f 75  be found; it cou
aa40: 6c 64 20 62 65 20 65 76 65 6e 74 75 61 6c 6c 79  ld be eventually
aa50: 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e   <b>NULL</b>, an
aa60: 64 20 69 6e 20 74 68 69 73 20 63 61 73 65 20 74  d in this case t
aa70: 68 65 20 3c 62 3e 4d 41 49 4e 20 44 42 3c 2f 62  he <b>MAIN DB</b
aa80: 3e 20 77 69 6c 6c 20 69 6d 70 6c 69 63 69 74 6c  > will implicitl
aa90: 79 20 62 65 20 61 73 73 75 6d 65 64 2e 3c 2f 6c  y be assumed.</l
aaa0: 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c  i>..<li>the <b><
aab0: 69 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 69  i>boundingBox</i
aac0: 3e 3c 2f 62 3e 20 69 73 20 65 78 70 65 63 74 65  ></b> is expecte
aad0: 64 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20 74  d to represent t
aae0: 68 65 20 6f 76 65 72 61 6c 6c 20 65 78 74 65 6e  he overall exten
aaf0: 74 20 6f 66 20 74 68 65 20 53 74 79 6c 65 64 20  t of the Styled 
ab00: 4d 61 70 3b 20 79 6f 75 20 63 6f 75 6c 64 20 65  Map; you could e
ab10: 76 65 6e 74 75 61 6c 6c 79 20 70 61 73 73 20 61  ventually pass a
ab20: 6e 79 20 61 72 62 69 74 72 61 72 79 20 6b 69 6e  ny arbitrary kin
ab30: 64 20 6f 66 20 47 65 6f 6d 65 74 72 79 2c 20 61  d of Geometry, a
ab40: 6e 64 20 74 68 65 20 42 6f 75 6e 64 69 6e 67 20  nd the Bounding 
ab50: 42 6f 78 20 61 6b 61 20 4d 42 52 20 77 69 6c 6c  Box aka MBR will
ab60: 20 62 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c   be automaticall
ab70: 79 20 64 65 74 65 72 6d 69 6e 65 64 2e 3c 2f 6c  y determined.</l
ab80: 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c  i>..<li>the <b><
ab90: 69 3e 73 74 79 6c 65 4e 61 6d 65 3c 2f 69 3e 3c  i>styleName</i><
aba0: 2f 62 3e 20 63 6f 75 6c 64 20 62 65 20 65 76 65  /b> could be eve
abb0: 6e 74 75 61 6c 6c 79 20 3c 62 3e 27 64 65 66 61  ntually <b>'defa
abc0: 75 6c 74 27 3c 2f 62 3e 2c 20 74 68 69 73 20 63  ult'</b>, this c
abd0: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20  orresponding to 
abe0: 74 68 65 20 69 6d 70 6c 69 63 69 74 20 73 74 79  the implicit sty
abf0: 6c 65 20 73 75 70 70 6f 72 74 65 64 20 66 6f 72  le supported for
ac00: 20 61 6c 6c 20 50 69 78 65 6c 20 54 79 70 65 73   all Pixel Types
ac10: 20 65 78 63 65 70 74 20 4d 55 4c 54 49 42 41 4e   except MULTIBAN
ac20: 44 20 28 77 68 69 63 68 20 61 6c 77 61 79 73 20  D (which always 
ac30: 72 65 71 75 69 72 65 20 73 6f 6d 65 20 65 78 70  require some exp
ac40: 6c 69 63 69 74 20 73 74 79 6c 65 20 74 6f 20 62  licit style to b
ac50: 65 20 61 70 70 6c 69 65 64 29 2e 3c 2f 6c 69 3e  e applied).</li>
ac60: 0d 0a 3c 6c 69 3e 74 68 65 20 42 6f 75 6e 64 69  ..<li>the Boundi
ac70: 6e 67 42 6f 78 20 69 73 20 65 78 70 65 63 74 65  ngBox is expecte
ac80: 64 20 74 6f 20 65 78 61 63 74 6c 79 20 6d 61 74  d to exactly mat
ac90: 63 68 20 74 68 65 20 69 6d 61 67 65 27 73 20 3c  ch the image's <
aca0: 62 3e 3c 69 3e 77 69 64 74 68 3c 2f 69 3e 3c 2f  b><i>width</i></
acb0: 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e 68 65 69  b> and <b><i>hei
acc0: 67 68 74 3c 2f 69 3e 3c 2f 62 3e 20 64 69 6d 65  ght</i></b> dime
acd0: 6e 73 69 6f 6e 73 20 61 74 20 74 68 61 74 20 72  nsions at that r
ace0: 65 73 6f 6c 75 74 69 6f 6e 2e 3c 62 72 3e 0d 0a  esolution.<br>..
acf0: 45 78 63 65 70 74 20 77 68 65 6e 20 74 68 65 20  Except when the 
ad00: 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e  optional argumen
ad10: 74 20 3c 62 3e 3c 69 3e 72 65 61 73 70 65 63 74  t <b><i>reaspect
ad20: 3c 2f 69 3e 3c 2f 62 3e 20 69 73 20 73 65 74 20  </i></b> is set 
ad30: 74 6f 20 54 52 55 45 3b 20 69 6e 20 74 68 69 73  to TRUE; in this
ad40: 20 6c 61 74 65 72 20 63 61 73 65 20 65 61 63 68   later case each
ad50: 20 73 69 6e 67 6c 65 20 61 78 69 73 20 63 6f 75   single axis cou
ad60: 6c 64 20 62 65 20 69 6e 64 65 70 65 6e 64 65 6e  ld be independen
ad70: 74 6c 79 20 72 65 73 63 61 6c 65 64 2e 3c 2f 6c  tly rescaled.</l
ad80: 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69  i>..<li>the opti
ad90: 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62  onal argument <b
ada0: 3e 3c 69 3e 6d 69 6d 65 54 79 70 65 3c 2f 69 3e  ><i>mimeType</i>
adb0: 3c 2f 62 3e 20 63 6f 75 6c 64 20 62 65 20 6f 6e  </b> could be on
adc0: 65 20 6f 66 20 3c 62 3e 27 69 6d 61 67 65 2f 70  e of <b>'image/p
add0: 64 66 27 3c 2f 62 3e 2c 20 3c 62 3e 27 69 6d 61  df'</b>, <b>'ima
ade0: 67 65 2f 6a 70 65 67 27 3c 2f 62 3e 2c 20 3c 62  ge/jpeg'</b>, <b
adf0: 3e 27 69 6d 61 67 65 2f 74 69 66 66 27 3c 2f 62  >'image/tiff'</b
ae00: 3e 20 6f 72 20 3c 62 3e 27 61 70 70 6c 69 63 61  > or <b>'applica
ae10: 74 69 6f 6e 2f 78 2d 70 64 66 27 3c 2f 62 3e 3b  tion/x-pdf'</b>;
ae20: 20 64 65 66 61 75 6c 74 20 69 73 20 3c 62 3e 27   default is <b>'
ae30: 69 6d 61 67 65 2f 70 6e 67 27 3c 2f 62 3e 2e 3c  image/png'</b>.<
ae40: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70  /li>..<li>the op
ae50: 74 69 6f 6e 61 6c 20 3c 62 3e 3c 69 3e 62 67 43  tional <b><i>bgC
ae60: 6f 6c 6f 72 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67  olor</i></b> arg
ae70: 75 6d 65 6e 74 20 69 73 20 65 78 70 65 63 74 65  ument is expecte
ae80: 64 20 74 6f 20 62 65 20 65 78 70 72 65 73 73 65  d to be expresse
ae90: 64 20 69 6e 20 74 68 65 20 63 61 6e 6f 6e 69 63  d in the canonic
aea0: 61 6c 20 57 45 42 20 48 45 58 2d 52 47 42 20 66  al WEB HEX-RGB f
aeb0: 6f 72 6d 2c 20 61 73 20 69 6e 20 3c 62 3e 27 23  orm, as in <b>'#
aec0: 66 66 38 30 38 30 27 3c 2f 62 3e 20 28 64 65 66  ff8080'</b> (def
aed0: 61 75 6c 74 20 69 73 20 27 23 66 66 66 66 66 66  ault is '#ffffff
aee0: 27 20 69 2e 65 2e 20 66 75 6c 6c 20 77 68 69 74  ' i.e. full whit
aef0: 65 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68  e).</li>..<li>th
af00: 65 20 6f 70 74 69 6f 6e 61 6c 20 3c 62 3e 3c 69  e optional <b><i
af10: 3e 74 72 61 6e 73 70 61 72 65 6e 74 3c 2f 69 3e  >transparent</i>
af20: 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 20 69 73  </b> argument is
af30: 20 65 78 70 65 63 74 65 64 20 74 6f 20 62 65 20   expected to be 
af40: 65 78 70 72 65 73 73 65 64 20 61 73 20 61 20 42  expressed as a B
af50: 6f 6f 6c 65 61 6e 20 76 61 6c 75 65 20 28 64 65  oolean value (de
af60: 66 61 75 6c 74 20 69 73 20 3c 62 3e 30 3c 2f 62  fault is <b>0</b
af70: 3e 20 46 41 4c 53 45 29 2e 3c 62 72 3e 0d 0a 3c  > FALSE).<br>..<
af80: 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75  u>Please note</u
af90: 3e 3a 20 74 72 61 6e 73 70 61 72 65 6e 63 79 20  >: transparency 
afa0: 69 73 20 73 75 70 70 6f 72 74 65 64 20 75 6e 69  is supported uni
afb0: 71 75 65 6c 79 20 62 79 20 50 4e 47 20 69 6d 61  quely by PNG ima
afc0: 67 65 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74  ges.</li>..<li>t
afd0: 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75  he optional argu
afe0: 6d 65 6e 74 20 3c 62 3e 3c 69 3e 71 75 61 6c 69  ment <b><i>quali
aff0: 74 79 3c 2f 69 3e 3c 2f 62 3e 20 28 69 6e 20 74  ty</i></b> (in t
b000: 68 65 20 72 61 6e 67 65 20 3c 62 3e 30 3c 2f 62  he range <b>0</b
b010: 3e 20 2d 20 3c 62 3e 31 30 30 3c 2f 62 3e 3b 20  > - <b>100</b>; 
b020: 64 65 66 61 75 6c 74 20 3c 62 3e 38 30 3c 2f 62  default <b>80</b
b030: 3e 29 20 69 73 20 6d 65 61 6e 69 6e 67 66 75 6c  >) is meaningful
b040: 20 6f 6e 6c 79 20 69 6e 20 74 68 65 20 63 61 73   only in the cas
b050: 65 20 6f 66 20 4a 50 45 47 20 69 6d 61 67 65 73  e of JPEG images
b060: 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c  .</li>..</ul>..<
b070: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c  /td></tr>..<tr><
b080: 74 64 3e 3c 62 3e 52 4c 32 5f 47 65 74 53 74 79  td><b>RL2_GetSty
b090: 6c 65 64 4d 61 70 49 6d 61 67 65 46 72 6f 6d 52  ledMapImageFromR
b0a0: 61 73 74 65 72 3c 2f 62 3e 20 28 20 3c 62 3e 64  aster</b> ( <b>d
b0b0: 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53  bPrefix</b> <i>S
b0c0: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63  tring</i> , <b>c
b0d0: 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20  overageName</b> 
b0e0: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
b0f0: 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f  <b>boundingBox</
b100: 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65  b> <i>BLOB-Geome
b110: 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64  try</i> , <b>wid
b120: 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  th</b> <i>Intege
b130: 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68  r</i> , <b>heigh
b140: 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  t</b> <i>Integer
b150: 3c 2f 69 3e 20 2c 20 3c 62 3e 78 6d 6c 5f 73 74  </i> , <b>xml_st
b160: 79 6c 65 3c 2f 62 3e 20 3c 69 3e 54 65 78 74 3c  yle</b> <i>Text<
b170: 2f 69 3e 20 29 20 3a 20 3c 69 3e 42 4c 4f 42 3c  /i> ) : <i>BLOB<
b180: 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e  /i><br><br>..<b>
b190: 52 4c 32 5f 47 65 74 53 74 79 6c 65 64 4d 61 70  RL2_GetStyledMap
b1a0: 49 6d 61 67 65 46 72 6f 6d 52 61 73 74 65 72 3c  ImageFromRaster<
b1b0: 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69  /b> ( <b>dbPrefi
b1c0: 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  x</b> <i>String<
b1d0: 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67  /i> , <b>coverag
b1e0: 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  eName</b> <i>Str
b1f0: 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75  ing</i> , <b>bou
b200: 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e  ndingBox</b> <i>
b210: 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69  BLOB-Geometry</i
b220: 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e  > , <b>width</b>
b230: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
b240: 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20  , <b>height</b> 
b250: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
b260: 20 3c 62 3e 78 6d 6c 5f 73 74 79 6c 65 3c 2f 62   <b>xml_style</b
b270: 3e 20 3c 69 3e 54 65 78 74 3c 2f 69 3e 20 2c 20  > <i>Text</i> , 
b280: 3c 62 3e 6d 69 6d 65 54 79 70 65 3c 2f 62 3e 20  <b>mimeType</b> 
b290: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20  <i>String</i> ) 
b2a0: 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 62 72  : <i>BLOB</i><br
b2b0: 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 47 65  ><br>..<b>RL2_Ge
b2c0: 74 53 74 79 6c 65 64 4d 61 70 49 6d 61 67 65 46  tStyledMapImageF
b2d0: 72 6f 6d 52 61 73 74 65 72 3c 2f 62 3e 20 28 20  romRaster</b> ( 
b2e0: 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20  <b>dbPrefix</b> 
b2f0: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
b300: 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
b310: 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
b320: 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42  > , <b>boundingB
b330: 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47  ox</b> <i>BLOB-G
b340: 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62  eometry</i> , <b
b350: 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
b360: 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
b370: 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
b380: 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 78 6d  eger</i> , <b>xm
b390: 6c 5f 73 74 79 6c 65 3c 2f 62 3e 20 3c 69 3e 54  l_style</b> <i>T
b3a0: 65 78 74 3c 2f 69 3e 20 2c 20 3c 62 3e 6d 69 6d  ext</i> , <b>mim
b3b0: 65 54 79 70 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  eType</b> <i>Str
b3c0: 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62 67 43  ing</i> , <b>bgC
b3d0: 6f 6c 6f 72 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  olor</b> <i>Stri
b3e0: 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 42 4c  ng</i> ) : <i>BL
b3f0: 4f 42 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a  OB</i><br><br>..
b400: 3c 62 3e 52 4c 32 5f 47 65 74 53 74 79 6c 65 64  <b>RL2_GetStyled
b410: 4d 61 70 49 6d 61 67 65 46 72 6f 6d 52 61 73 74  MapImageFromRast
b420: 65 72 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72  er</b> ( <b>dbPr
b430: 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  efix</b> <i>Stri
b440: 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65  ng</i> , <b>cove
b450: 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e  rageName</b> <i>
b460: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
b470: 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20  boundingBox</b> 
b480: 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79  <i>BLOB-Geometry
b490: 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c  </i> , <b>width<
b4a0: 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
b4b0: 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f  i> , <b>height</
b4c0: 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
b4d0: 3e 20 2c 20 3c 62 3e 78 6d 6c 5f 73 74 79 6c 65  > , <b>xml_style
b4e0: 3c 2f 62 3e 20 3c 69 3e 54 65 78 74 3c 2f 69 3e  </b> <i>Text</i>
b4f0: 20 2c 20 3c 62 3e 6d 69 6d 65 54 79 70 65 3c 2f   , <b>mimeType</
b500: 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
b510: 20 2c 20 3c 62 3e 62 67 43 6f 6c 6f 72 3c 2f 62   , <b>bgColor</b
b520: 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
b530: 2c 20 3c 62 3e 74 72 61 6e 73 70 61 72 65 6e 74  , <b>transparent
b540: 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
b550: 2f 69 3e 20 29 20 3a 20 3c 69 3e 42 4c 4f 42 3c  /i> ) : <i>BLOB<
b560: 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e  /i><br><br>..<b>
b570: 52 4c 32 5f 47 65 74 53 74 79 6c 65 64 4d 61 70  RL2_GetStyledMap
b580: 49 6d 61 67 65 46 72 6f 6d 52 61 73 74 65 72 3c  ImageFromRaster<
b590: 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69  /b> ( <b>dbPrefi
b5a0: 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  x</b> <i>String<
b5b0: 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67  /i> , <b>coverag
b5c0: 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  eName</b> <i>Str
b5d0: 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75  ing</i> , <b>bou
b5e0: 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e  ndingBox</b> <i>
b5f0: 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69  BLOB-Geometry</i
b600: 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e  > , <b>width</b>
b610: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
b620: 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20  , <b>height</b> 
b630: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
b640: 20 3c 62 3e 78 6d 6c 5f 73 74 79 6c 65 3c 2f 62   <b>xml_style</b
b650: 3e 20 3c 69 3e 54 65 78 74 3c 2f 69 3e 20 2c 20  > <i>Text</i> , 
b660: 3c 62 3e 6d 69 6d 65 54 79 70 65 3c 2f 62 3e 20  <b>mimeType</b> 
b670: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
b680: 3c 62 3e 62 67 43 6f 6c 6f 72 3c 2f 62 3e 20 3c  <b>bgColor</b> <
b690: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
b6a0: 62 3e 74 72 61 6e 73 70 61 72 65 6e 74 3c 2f 62  b>transparent</b
b6b0: 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
b6c0: 20 2c 20 3c 62 3e 71 75 61 6c 69 74 79 3c 2f 62   , <b>quality</b
b6d0: 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
b6e0: 20 29 20 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e   ) : <i>BLOB</i>
b6f0: 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32  <br><br>..<b>RL2
b700: 5f 47 65 74 53 74 79 6c 65 64 4d 61 70 49 6d 61  _GetStyledMapIma
b710: 67 65 46 72 6f 6d 52 61 73 74 65 72 3c 2f 62 3e  geFromRaster</b>
b720: 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f   ( <b>dbPrefix</
b730: 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
b740: 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61   , <b>coverageNa
b750: 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  me</b> <i>String
b760: 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69  </i> , <b>boundi
b770: 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f  ngBox</b> <i>BLO
b780: 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c  B-Geometry</i> ,
b790: 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69   <b>width</b> <i
b7a0: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
b7b0: 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e  b>height</b> <i>
b7c0: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
b7d0: 3e 78 6d 6c 5f 73 74 79 6c 65 3c 2f 62 3e 20 3c  >xml_style</b> <
b7e0: 69 3e 54 65 78 74 3c 2f 69 3e 20 2c 20 3c 62 3e  i>Text</i> , <b>
b7f0: 6d 69 6d 65 54 79 70 65 3c 2f 62 3e 20 3c 69 3e  mimeType</b> <i>
b800: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
b810: 62 67 43 6f 6c 6f 72 3c 2f 62 3e 20 3c 69 3e 53  bgColor</b> <i>S
b820: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 74  tring</i> , <b>t
b830: 72 61 6e 73 70 61 72 65 6e 74 3c 2f 62 3e 20 3c  ransparent</b> <
b840: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
b850: 3c 62 3e 71 75 61 6c 69 74 79 3c 2f 62 3e 20 3c  <b>quality</b> <
b860: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
b870: 3c 62 3e 72 65 61 73 70 65 63 74 3c 2f 62 3e 20  <b>reaspect</b> 
b880: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29  <i>Integer</i> )
b890: 20 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 2f   : <i>BLOB</i></
b8a0: 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 61 74  td>..<td>Will at
b8b0: 74 65 6d 70 74 20 74 6f 20 63 72 65 61 74 65 20  tempt to create 
b8c0: 61 20 64 69 67 69 74 61 6c 20 69 6d 61 67 65 20  a digital image 
b8d0: 72 65 70 72 65 73 65 6e 74 69 6e 67 20 61 20 53  representing a S
b8e0: 74 79 6c 65 64 20 4d 61 70 20 66 72 6f 6d 20 61  tyled Map from a
b8f0: 20 43 6f 76 65 72 61 67 65 20 6f 66 20 74 68 65   Coverage of the
b900: 20 52 61 73 74 65 72 20 74 79 70 65 2e 3c 62 72   Raster type.<br
b910: 3e 0d 0a 57 69 6c 6c 20 72 65 74 75 72 6e 20 61  >..Will return a
b920: 20 42 4c 4f 42 20 63 6f 6e 74 61 69 6e 69 6e 67   BLOB containing
b930: 20 74 68 65 20 53 74 79 6c 65 64 20 4d 61 70 3a   the Styled Map:
b940: 20 6f 72 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20   or <b>NULL</b> 
b950: 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d  on invalid argum
b960: 65 6e 74 73 20 6f 72 20 69 66 20 61 6e 79 20 65  ents or if any e
b970: 72 72 6f 72 20 6f 63 63 75 72 73 2e 3c 62 72 3e  rror occurs.<br>
b980: 3c 62 72 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20  <br>..<u>Please 
b990: 6e 6f 74 65 3c 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e  note</u>: ..<ul>
b9a0: 0d 0a 3c 6c 69 3e 41 6c 6d 6f 73 74 20 61 6c 6c  ..<li>Almost all
b9b0: 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73 20 61   the arguments a
b9c0: 72 65 20 74 68 65 20 73 61 6d 65 20 61 73 20 69  re the same as i
b9d0: 6e 20 3c 62 3e 52 4c 32 5f 47 65 74 4d 61 70 49  n <b>RL2_GetMapI
b9e0: 6d 61 67 65 46 72 6f 6d 52 61 73 74 65 72 28 29  mageFromRaster()
b9f0: 3c 2f 62 3e 20 61 6e 64 20 68 61 76 65 20 69 64  </b> and have id
ba00: 65 6e 74 69 63 61 6c 20 69 6e 74 65 72 70 72 65  entical interpre
ba10: 74 61 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c  tation.</li>..<l
ba20: 69 3e 54 68 65 20 6f 6e 6c 79 20 65 78 63 65 70  i>The only excep
ba30: 74 69 6f 6e 20 62 65 69 6e 67 20 3c 62 3e 3c 69  tion being <b><i
ba40: 3e 78 6d 6c 5f 73 74 79 6c 65 3c 2f 69 3e 3c 2f  >xml_style</i></
ba50: 62 3e 20 74 68 61 74 20 69 73 20 65 78 70 65 63  b> that is expec
ba60: 74 65 64 20 74 6f 20 63 6f 6e 74 61 69 6e 20 61  ted to contain a
ba70: 20 76 61 6c 69 64 20 3c 62 3e 53 4c 44 2f 53 45   valid <b>SLD/SE
ba80: 20 58 4d 4c 20 52 61 73 74 65 72 20 53 79 6d 62   XML Raster Symb
ba90: 6f 6c 69 7a 65 72 3c 2f 62 3e 2e 3c 2f 6c 69 3e  olizer</b>.</li>
baa0: 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 74 61  ..</ul><br>..<ta
bab0: 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d  ble cellspacing=
bac0: 22 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d  "8" cellpadding=
bad0: 22 38 22 20 62 67 63 6f 6c 6f 72 3d 22 23 64 30  "8" bgcolor="#d0
bae0: 66 66 64 30 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a  ffd0"><tr><td>..
baf0: 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 3a 0d  In other words:.
bb00: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 42 6f 74 68 20  .<ul>..<li>Both 
bb10: 3c 62 3e 52 4c 32 5f 47 65 74 4d 61 70 49 6d 61  <b>RL2_GetMapIma
bb20: 67 65 46 72 6f 6d 52 61 73 74 65 72 28 29 3c 2f  geFromRaster()</
bb30: 62 3e 20 61 6e 64 20 3c 62 3e 52 4c 32 5f 47 65  b> and <b>RL2_Ge
bb40: 74 53 74 79 6c 65 64 4d 61 70 49 6d 61 67 65 46  tStyledMapImageF
bb50: 72 6f 6d 52 61 73 74 65 72 28 29 3c 2f 62 3e 20  romRaster()</b> 
bb60: 61 72 65 20 76 65 72 79 20 73 69 6d 69 6c 61 72  are very similar
bb70: 20 69 6e 20 74 68 65 69 72 20 67 65 6e 65 72 61   in their genera
bb80: 6c 20 62 65 68 61 76 69 6f 72 2e 20 54 68 65 20  l behavior. The 
bb90: 6d 61 69 6e 20 64 69 66 66 65 72 65 6e 63 65 20  main difference 
bba0: 62 65 74 77 65 65 6e 20 74 68 65 6d 20 69 73 3a  between them is:
bbb0: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 52  ..<ul>..<li><b>R
bbc0: 4c 32 5f 47 65 74 4d 61 70 49 6d 61 67 65 46 72  L2_GetMapImageFr
bbd0: 6f 6d 52 61 73 74 65 72 28 29 3c 2f 62 3e 20 61  omRaster()</b> a
bbe0: 63 63 65 70 74 73 20 74 68 65 20 3c 62 3e 6e 61  ccepts the <b>na
bbf0: 6d 65 3c 2f 62 3e 20 6f 66 20 61 20 72 65 67 69  me</b> of a regi
bc00: 73 74 65 72 65 64 20 53 74 79 6c 65 2e 3c 2f 6c  stered Style.</l
bc10: 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 52 4c 32 5f 47  i>..<li><b>RL2_G
bc20: 65 74 53 74 79 6c 65 64 4d 61 70 49 6d 61 67 65  etStyledMapImage
bc30: 46 72 6f 6d 52 61 73 74 65 72 28 29 3c 2f 62 3e  FromRaster()</b>
bc40: 20 64 69 72 65 63 74 6c 79 20 61 63 63 65 70 74   directly accept
bc50: 73 20 61 6e 20 3c 62 3e 58 4d 4c 20 53 74 79 6c  s an <b>XML Styl
bc60: 65 3c 2f 62 3e 20 64 65 66 69 6e 69 74 69 6f 6e  e</b> definition
bc70: 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c  .</li>..</ul></l
bc80: 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 3e  i>..</ul>..</td>
bc90: 3c 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e 0d 0a 3c  </tr></table>..<
bca0: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c  /td></tr>..<tr><
bcb0: 74 64 3e 3c 62 3e 52 4c 32 5f 47 65 74 4d 61 70  td><b>RL2_GetMap
bcc0: 49 6d 61 67 65 46 72 6f 6d 56 65 63 74 6f 72 3c  ImageFromVector<
bcd0: 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69  /b> ( <b>dbPrefi
bce0: 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  x</b> <i>String<
bcf0: 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67  /i> , <b>coverag
bd00: 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  eName</b> <i>Str
bd10: 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75  ing</i> , <b>bou
bd20: 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e  ndingBox</b> <i>
bd30: 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69  BLOB-Geometry</i
bd40: 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e  > , <b>width</b>
bd50: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
bd60: 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20  , <b>height</b> 
bd70: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29  <i>Integer</i> )
bd80: 20 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 62   : <i>BLOB</i><b
bd90: 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 47  r><br>..<b>RL2_G
bda0: 65 74 4d 61 70 49 6d 61 67 65 46 72 6f 6d 56 65  etMapImageFromVe
bdb0: 63 74 6f 72 3c 2f 62 3e 20 28 20 3c 62 3e 64 62  ctor</b> ( <b>db
bdc0: 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74  Prefix</b> <i>St
bdd0: 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f  ring</i> , <b>co
bde0: 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c  verageName</b> <
bdf0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
be00: 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62  b>boundingBox</b
be10: 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74  > <i>BLOB-Geomet
be20: 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74  ry</i> , <b>widt
be30: 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  h</b> <i>Integer
be40: 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74  </i> , <b>height
be50: 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
be60: 2f 69 3e 20 2c 20 3c 62 3e 73 74 79 6c 65 4e 61  /i> , <b>styleNa
be70: 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  me</b> <i>String
be80: 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 42 4c 4f 42  </i> ) : <i>BLOB
be90: 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62  </i><br><br>..<b
bea0: 3e 52 4c 32 5f 47 65 74 4d 61 70 49 6d 61 67 65  >RL2_GetMapImage
beb0: 46 72 6f 6d 56 65 63 74 6f 72 3c 2f 62 3e 20 28  FromVector</b> (
bec0: 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e   <b>dbPrefix</b>
bed0: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
bee0: 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
bef0: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
bf00: 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67  i> , <b>bounding
bf10: 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d  Box</b> <i>BLOB-
bf20: 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c  Geometry</i> , <
bf30: 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49  b>width</b> <i>I
bf40: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
bf50: 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e  height</b> <i>In
bf60: 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 73  teger</i> , <b>s
bf70: 74 79 6c 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e  tyleName</b> <i>
bf80: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
bf90: 6d 69 6d 65 54 79 70 65 3c 2f 62 3e 20 3c 69 3e  mimeType</b> <i>
bfa0: 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c  String</i> ) : <
bfb0: 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 62 72 3e 3c 62  i>BLOB</i><br><b
bfc0: 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 47 65 74 4d 61  r>..<b>RL2_GetMa
bfd0: 70 49 6d 61 67 65 46 72 6f 6d 56 65 63 74 6f 72  pImageFromVector
bfe0: 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66  </b> ( <b>dbPref
bff0: 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  ix</b> <i>String
c000: 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61  </i> , <b>covera
c010: 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74  geName</b> <i>St
c020: 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f  ring</i> , <b>bo
c030: 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69  undingBox</b> <i
c040: 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f  >BLOB-Geometry</
c050: 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62  i> , <b>width</b
c060: 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
c070: 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e   , <b>height</b>
c080: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
c090: 2c 20 3c 62 3e 73 74 79 6c 65 4e 61 6d 65 3c 2f  , <b>styleName</
c0a0: 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
c0b0: 20 2c 20 3c 62 3e 6d 69 6d 65 54 79 70 65 3c 2f   , <b>mimeType</
c0c0: 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
c0d0: 20 2c 20 3c 62 3e 62 67 43 6f 6c 6f 72 3c 2f 62   , <b>bgColor</b
c0e0: 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
c0f0: 29 20 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c  ) : <i>BLOB</i><
c100: 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f  br><br>..<b>RL2_
c110: 47 65 74 4d 61 70 49 6d 61 67 65 46 72 6f 6d 56  GetMapImageFromV
c120: 65 63 74 6f 72 3c 2f 62 3e 20 28 20 3c 62 3e 64  ector</b> ( <b>d
c130: 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53  bPrefix</b> <i>S
c140: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63  tring</i> , <b>c
c150: 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20  overageName</b> 
c160: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
c170: 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f  <b>boundingBox</
c180: 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65  b> <i>BLOB-Geome
c190: 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64  try</i> , <b>wid
c1a0: 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  th</b> <i>Intege
c1b0: 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68  r</i> , <b>heigh
c1c0: 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  t</b> <i>Integer
c1d0: 3c 2f 69 3e 20 2c 20 3c 62 3e 73 74 79 6c 65 4e  </i> , <b>styleN
c1e0: 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ame</b> <i>Strin
c1f0: 67 3c 2f 69 3e 20 2c 20 3c 62 3e 6d 69 6d 65 54  g</i> , <b>mimeT
c200: 79 70 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ype</b> <i>Strin
c210: 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62 67 43 6f 6c  g</i> , <b>bgCol
c220: 6f 72 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  or</b> <i>String
c230: 3c 2f 69 3e 20 2c 20 3c 62 3e 74 72 61 6e 73 70  </i> , <b>transp
c240: 61 72 65 6e 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  arent</b> <i>Int
c250: 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e  eger</i> ) : <i>
c260: 42 4c 4f 42 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e  BLOB</i><br><br>
c270: 0d 0a 3c 62 3e 52 4c 32 5f 47 65 74 4d 61 70 49  ..<b>RL2_GetMapI
c280: 6d 61 67 65 46 72 6f 6d 56 65 63 74 6f 72 3c 2f  mageFromVector</
c290: 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78  b> ( <b>dbPrefix
c2a0: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
c2b0: 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65  i> , <b>coverage
c2c0: 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Name</b> <i>Stri
c2d0: 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e  ng</i> , <b>boun
c2e0: 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42  dingBox</b> <i>B
c2f0: 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e  LOB-Geometry</i>
c300: 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20   , <b>width</b> 
c310: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
c320: 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c   <b>height</b> <
c330: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
c340: 3c 62 3e 73 74 79 6c 65 4e 61 6d 65 3c 2f 62 3e  <b>styleName</b>
c350: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
c360: 20 3c 62 3e 6d 69 6d 65 54 79 70 65 3c 2f 62 3e   <b>mimeType</b>
c370: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
c380: 20 3c 62 3e 62 67 43 6f 6c 6f 72 3c 2f 62 3e 20   <b>bgColor</b> 
c390: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
c3a0: 3c 62 3e 74 72 61 6e 73 70 61 72 65 6e 74 3c 2f  <b>transparent</
c3b0: 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
c3c0: 3e 20 2c 20 3c 62 3e 71 75 61 6c 69 74 79 3c 2f  > , <b>quality</
c3d0: 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
c3e0: 3e 20 29 20 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69  > ) : <i>BLOB</i
c3f0: 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c  ><br><br>..<b>RL
c400: 32 5f 47 65 74 4d 61 70 49 6d 61 67 65 46 72 6f  2_GetMapImageFro
c410: 6d 56 65 63 74 6f 72 3c 2f 62 3e 20 28 20 3c 62  mVector</b> ( <b
c420: 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69  >dbPrefix</b> <i
c430: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
c440: 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62  >coverageName</b
c450: 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
c460: 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78  , <b>boundingBox
c470: 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f  </b> <i>BLOB-Geo
c480: 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 77  metry</i> , <b>w
c490: 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  idth</b> <i>Inte
c4a0: 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69  ger</i> , <b>hei
c4b0: 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  ght</b> <i>Integ
c4c0: 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 73 74 79 6c  er</i> , <b>styl
c4d0: 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  eName</b> <i>Str
c4e0: 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 6d 69 6d  ing</i> , <b>mim
c4f0: 65 54 79 70 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  eType</b> <i>Str
c500: 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62 67 43  ing</i> , <b>bgC
c510: 6f 6c 6f 72 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  olor</b> <i>Stri
c520: 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 74 72 61 6e  ng</i> , <b>tran
c530: 73 70 61 72 65 6e 74 3c 2f 62 3e 20 3c 69 3e 49  sparent</b> <i>I
c540: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
c550: 71 75 61 6c 69 74 79 3c 2f 62 3e 20 3c 69 3e 49  quality</b> <i>I
c560: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
c570: 72 65 61 73 70 65 63 74 3c 2f 62 3e 20 3c 69 3e  reaspect</b> <i>
c580: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20  Integer</i> ) : 
c590: 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 2f 74 64 3e  <i>BLOB</i></td>
c5a0: 0d 0a 3c 74 64 3e 57 69 6c 6c 20 61 74 74 65 6d  ..<td>Will attem
c5b0: 70 74 20 74 6f 20 63 72 65 61 74 65 20 61 20 64  pt to create a d
c5c0: 69 67 69 74 61 6c 20 69 6d 61 67 65 20 72 65 70  igital image rep
c5d0: 72 65 73 65 6e 74 69 6e 67 20 61 20 53 74 79 6c  resenting a Styl
c5e0: 65 64 20 4d 61 70 20 66 72 6f 6d 20 61 20 43 6f  ed Map from a Co
c5f0: 76 65 72 61 67 65 20 6f 66 20 74 68 65 20 56 65  verage of the Ve
c600: 63 74 6f 72 20 74 79 70 65 2e 3c 62 72 3e 0d 0a  ctor type.<br>..
c610: 57 69 6c 6c 20 72 65 74 75 72 6e 20 61 20 42 4c  Will return a BL
c620: 4f 42 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68  OB containing th
c630: 65 20 53 74 79 6c 65 64 20 4d 61 70 3a 20 6f 72  e Styled Map: or
c640: 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 6f 6e 20   <b>NULL</b> on 
c650: 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74  invalid argument
c660: 73 20 6f 72 20 69 66 20 61 6e 79 20 65 72 72 6f  s or if any erro
c670: 72 20 6f 63 63 75 72 73 2e 3c 62 72 3e 0d 0a 3c  r occurs.<br>..<
c680: 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75  u>Please note</u
c690: 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54  >: ..<ul>..<li>T
c6a0: 68 65 20 3c 62 3e 3c 69 3e 64 62 50 72 65 66 69  he <b><i>dbPrefi
c6b0: 78 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67 75 6d 65  x</i></b> argume
c6c0: 6e 74 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74  nt is intended t
c6d0: 6f 20 73 70 65 63 69 66 79 20 74 68 65 20 41 54  o specify the AT
c6e0: 54 41 43 48 45 44 2d 44 42 20 77 68 65 72 65 20  TACHED-DB where 
c6f0: 74 68 65 20 43 6f 76 65 72 61 67 65 20 69 73 20  the Coverage is 
c700: 65 78 70 65 63 74 65 64 20 74 6f 20 62 65 20 66  expected to be f
c710: 6f 75 6e 64 3b 20 69 74 20 63 6f 75 6c 64 20 62  ound; it could b
c720: 65 20 65 76 65 6e 74 75 61 6c 6c 79 20 3c 62 3e  e eventually <b>
c730: 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69 6e  NULL</b>, and in
c740: 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 3c   this case the <
c750: 62 3e 4d 41 49 4e 20 44 42 3c 2f 62 3e 20 77 69  b>MAIN DB</b> wi
c760: 6c 6c 20 69 6d 70 6c 69 63 69 74 6c 79 20 62 65  ll implicitly be
c770: 20 61 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a   assumed.</li>..
c780: 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 62 6f  <li>the <b><i>bo
c790: 75 6e 64 69 6e 67 42 6f 78 3c 2f 69 3e 3c 2f 62  undingBox</i></b
c7a0: 3e 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f  > is expected to
c7b0: 20 72 65 70 72 65 73 65 6e 74 20 74 68 65 20 6f   represent the o
c7c0: 76 65 72 61 6c 6c 20 65 78 74 65 6e 74 20 6f 66  verall extent of
c7d0: 20 74 68 65 20 53 74 79 6c 65 64 20 4d 61 70 3b   the Styled Map;
c7e0: 20 79 6f 75 20 63 6f 75 6c 64 20 65 76 65 6e 74   you could event
c7f0: 75 61 6c 6c 79 20 70 61 73 73 20 61 6e 79 20 61  ually pass any a
c800: 72 62 69 74 72 61 72 79 20 6b 69 6e 64 20 6f 66  rbitrary kind of
c810: 20 47 65 6f 6d 65 74 72 79 2c 20 61 6e 64 20 74   Geometry, and t
c820: 68 65 20 42 6f 75 6e 64 69 6e 67 20 42 6f 78 20  he Bounding Box 
c830: 61 6b 61 20 4d 42 52 20 77 69 6c 6c 20 62 65 20  aka MBR will be 
c840: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65  automatically de
c850: 74 65 72 6d 69 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a  termined.</li>..
c860: 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 73 74  <li>the <b><i>st
c870: 79 6c 65 4e 61 6d 65 3c 2f 69 3e 3c 2f 62 3e 20  yleName</i></b> 
c880: 63 6f 75 6c 64 20 62 65 20 65 76 65 6e 74 75 61  could be eventua
c890: 6c 6c 79 20 3c 62 3e 27 64 65 66 61 75 6c 74 27  lly <b>'default'
c8a0: 3c 2f 62 3e 2c 20 74 68 69 73 20 63 6f 72 72 65  </b>, this corre
c8b0: 73 70 6f 6e 64 69 6e 67 20 74 6f 20 74 68 65 20  sponding to the 
c8c0: 69 6d 70 6c 69 63 69 74 20 73 74 79 6c 65 20 73  implicit style s
c8d0: 75 70 70 6f 72 74 65 64 20 66 6f 72 20 61 6c 6c  upported for all
c8e0: 20 50 69 78 65 6c 20 54 79 70 65 73 20 65 78 63   Pixel Types exc
c8f0: 65 70 74 20 4d 55 4c 54 49 42 41 4e 44 20 28 77  ept MULTIBAND (w
c900: 68 69 63 68 20 61 6c 77 61 79 73 20 72 65 71 75  hich always requ
c910: 69 72 65 20 73 6f 6d 65 20 65 78 70 6c 69 63 69  ire some explici
c920: 74 20 73 74 79 6c 65 20 74 6f 20 62 65 20 61 70  t style to be ap
c930: 70 6c 69 65 64 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c  plied).</li>..<l
c940: 69 3e 74 68 65 20 42 6f 75 6e 64 69 6e 67 42 6f  i>the BoundingBo
c950: 78 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f  x is expected to
c960: 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68 20 74   exactly match t
c970: 68 65 20 69 6d 61 67 65 27 73 20 3c 62 3e 3c 69  he image's <b><i
c980: 3e 77 69 64 74 68 3c 2f 69 3e 3c 2f 62 3e 20 61  >width</i></b> a
c990: 6e 64 20 3c 62 3e 3c 69 3e 68 65 69 67 68 74 3c  nd <b><i>height<
c9a0: 2f 69 3e 3c 2f 62 3e 20 64 69 6d 65 6e 73 69 6f  /i></b> dimensio
c9b0: 6e 73 20 61 74 20 74 68 61 74 20 72 65 73 6f 6c  ns at that resol
c9c0: 75 74 69 6f 6e 2e 3c 62 72 3e 0d 0a 45 78 63 65  ution.<br>..Exce
c9d0: 70 74 20 77 68 65 6e 20 74 68 65 20 6f 70 74 69  pt when the opti
c9e0: 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62  onal argument <b
c9f0: 3e 3c 69 3e 72 65 61 73 70 65 63 74 3c 2f 69 3e  ><i>reaspect</i>
ca00: 3c 2f 62 3e 20 69 73 20 73 65 74 20 74 6f 20 54  </b> is set to T
ca10: 52 55 45 3b 20 69 6e 20 74 68 69 73 20 6c 61 74  RUE; in this lat
ca20: 65 72 20 63 61 73 65 20 65 61 63 68 20 73 69 6e  er case each sin
ca30: 67 6c 65 20 61 78 69 73 20 63 6f 75 6c 64 20 62  gle axis could b
ca40: 65 20 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 20  e independently 
ca50: 72 65 73 63 61 6c 65 64 2e 3c 2f 6c 69 3e 0d 0a  rescaled.</li>..
ca60: 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c  <li>the optional
ca70: 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 3c 69 3e   argument <b><i>
ca80: 6d 69 6d 65 54 79 70 65 3c 2f 69 3e 3c 2f 62 3e  mimeType</i></b>
ca90: 20 63 6f 75 6c 64 20 62 65 20 6f 6e 65 20 6f 66   could be one of
caa0: 20 3c 62 3e 27 69 6d 61 67 65 2f 70 64 66 27 3c   <b>'image/pdf'<
cab0: 2f 62 3e 2c 20 3c 62 3e 27 69 6d 61 67 65 2f 6a  /b>, <b>'image/j
cac0: 70 65 67 27 3c 2f 62 3e 2c 20 3c 62 3e 27 69 6d  peg'</b>, <b>'im
cad0: 61 67 65 2f 74 69 66 66 27 3c 2f 62 3e 20 6f 72  age/tiff'</b> or
cae0: 20 3c 62 3e 27 61 70 70 6c 69 63 61 74 69 6f 6e   <b>'application
caf0: 2f 78 2d 70 64 66 27 3c 2f 62 3e 3b 20 64 65 66  /x-pdf'</b>; def
cb00: 61 75 6c 74 20 69 73 20 3c 62 3e 27 69 6d 61 67  ault is <b>'imag
cb10: 65 2f 70 6e 67 27 3c 2f 62 3e 2e 3c 2f 6c 69 3e  e/png'</b>.</li>
cb20: 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e  ..<li>the option
cb30: 61 6c 20 3c 62 3e 3c 69 3e 62 67 43 6f 6c 6f 72  al <b><i>bgColor
cb40: 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67 75 6d 65 6e  </i></b> argumen
cb50: 74 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f  t is expected to
cb60: 20 62 65 20 65 78 70 72 65 73 73 65 64 20 69 6e   be expressed in
cb70: 20 74 68 65 20 63 61 6e 6f 6e 69 63 61 6c 20 57   the canonical W
cb80: 45 42 20 48 45 58 2d 52 47 42 20 66 6f 72 6d 2c  EB HEX-RGB form,
cb90: 20 61 73 20 69 6e 20 3c 62 3e 27 23 66 66 38 30   as in <b>'#ff80
cba0: 38 30 27 3c 2f 62 3e 20 28 64 65 66 61 75 6c 74  80'</b> (default
cbb0: 20 69 73 20 27 23 66 66 66 66 66 66 27 20 69 2e   is '#ffffff' i.
cbc0: 65 2e 20 66 75 6c 6c 20 77 68 69 74 65 29 2e 3c  e. full white).<
cbd0: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70  /li>..<li>the op
cbe0: 74 69 6f 6e 61 6c 20 3c 62 3e 3c 69 3e 74 72 61  tional <b><i>tra
cbf0: 6e 73 70 61 72 65 6e 74 3c 2f 69 3e 3c 2f 62 3e  nsparent</i></b>
cc00: 20 61 72 67 75 6d 65 6e 74 20 69 73 20 65 78 70   argument is exp
cc10: 65 63 74 65 64 20 74 6f 20 62 65 20 65 78 70 72  ected to be expr
cc20: 65 73 73 65 64 20 61 73 20 61 20 42 6f 6f 6c 65  essed as a Boole
cc30: 61 6e 20 76 61 6c 75 65 20 28 64 65 66 61 75 6c  an value (defaul
cc40: 74 20 69 73 20 3c 62 3e 30 3c 2f 62 3e 20 46 41  t is <b>0</b> FA
cc50: 4c 53 45 29 2e 3c 62 72 3e 0d 0a 3c 75 3e 50 6c  LSE).<br>..<u>Pl
cc60: 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 74  ease note</u>: t
cc70: 72 61 6e 73 70 61 72 65 6e 63 79 20 69 73 20 73  ransparency is s
cc80: 75 70 70 6f 72 74 65 64 20 75 6e 69 71 75 65 6c  upported uniquel
cc90: 79 20 62 79 20 50 4e 47 20 69 6d 61 67 65 73 2e  y by PNG images.
cca0: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f  </li>..<li>the o
ccb0: 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74  ptional argument
ccc0: 20 3c 62 3e 3c 69 3e 71 75 61 6c 69 74 79 3c 2f   <b><i>quality</
ccd0: 69 3e 3c 2f 62 3e 20 28 69 6e 20 74 68 65 20 72  i></b> (in the r
cce0: 61 6e 67 65 20 3c 62 3e 30 3c 2f 62 3e 20 2d 20  ange <b>0</b> - 
ccf0: 3c 62 3e 31 30 30 3c 2f 62 3e 3b 20 64 65 66 61  <b>100</b>; defa
cd00: 75 6c 74 20 3c 62 3e 38 30 3c 2f 62 3e 29 20 69  ult <b>80</b>) i
cd10: 73 20 6d 65 61 6e 69 6e 67 66 75 6c 20 6f 6e 6c  s meaningful onl
cd20: 79 20 69 6e 20 74 68 65 20 63 61 73 65 20 6f 66  y in the case of
cd30: 20 4a 50 45 47 20 69 6d 61 67 65 73 2e 3c 2f 6c   JPEG images.</l
cd40: 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 3e  i>..</ul>..</td>
cd50: 3c 2f 74 72 3e 0d 0a 0d 0a 0d 0a 0d 0a 3c 74 72  </tr>........<tr
cd60: 3e 3c 74 64 3e 3c 62 3e 52 4c 32 5f 47 65 74 53  ><td><b>RL2_GetS
cd70: 74 79 6c 65 64 4d 61 70 49 6d 61 67 65 46 72 6f  tyledMapImageFro
cd80: 6d 56 65 63 74 6f 72 3c 2f 62 3e 20 28 20 3c 62  mVector</b> ( <b
cd90: 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69  >dbPrefix</b> <i
cda0: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
cdb0: 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62  >coverageName</b
cdc0: 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
cdd0: 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78  , <b>boundingBox
cde0: 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f  </b> <i>BLOB-Geo
cdf0: 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 77  metry</i> , <b>w
ce00: 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  idth</b> <i>Inte
ce10: 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69  ger</i> , <b>hei
ce20: 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  ght</b> <i>Integ
ce30: 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 42 4c  er</i> ) : <i>BL
ce40: 4f 42 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a  OB</i><br><br>..
ce50: 3c 62 3e 52 4c 32 5f 47 65 74 53 74 79 6c 65 64  <b>RL2_GetStyled
ce60: 4d 61 70 49 6d 61 67 65 46 72 6f 6d 56 65 63 74  MapImageFromVect
ce70: 6f 72 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72  or</b> ( <b>dbPr
ce80: 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  efix</b> <i>Stri
ce90: 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65  ng</i> , <b>cove
cea0: 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e  rageName</b> <i>
ceb0: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
cec0: 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20  boundingBox</b> 
ced0: 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79  <i>BLOB-Geometry
cee0: 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c  </i> , <b>width<
cef0: 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
cf00: 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f  i> , <b>height</
cf10: 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
cf20: 3e 20 2c 20 3c 62 3e 78 6d 6c 5f 73 74 79 6c 65  > , <b>xml_style
cf30: 3c 2f 62 3e 20 3c 69 3e 54 65 78 74 3c 2f 69 3e  </b> <i>Text</i>
cf40: 20 29 20 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e   ) : <i>BLOB</i>
cf50: 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32  <br><br>..<b>RL2
cf60: 5f 47 65 74 53 74 79 6c 65 64 4d 61 70 49 6d 61  _GetStyledMapIma
cf70: 67 65 46 72 6f 6d 56 65 63 74 6f 72 3c 2f 62 3e  geFromVector</b>
cf80: 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f   ( <b>dbPrefix</
cf90: 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
cfa0: 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61   , <b>coverageNa
cfb0: 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  me</b> <i>String
cfc0: 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69  </i> , <b>boundi
cfd0: 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f  ngBox</b> <i>BLO
cfe0: 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c  B-Geometry</i> ,
cff0: 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69   <b>width</b> <i
d000: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
d010: 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e  b>height</b> <i>
d020: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
d030: 3e 78 6d 6c 5f 73 74 79 6c 65 3c 2f 62 3e 20 3c  >xml_style</b> <
d040: 69 3e 54 65 78 74 3c 2f 69 3e 20 2c 20 3c 62 3e  i>Text</i> , <b>
d050: 6d 69 6d 65 54 79 70 65 3c 2f 62 3e 20 3c 69 3e  mimeType</b> <i>
d060: 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c  String</i> ) : <
d070: 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 62 72 3e 3c 62  i>BLOB</i><br><b
d080: 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 47 65 74 53 74  r>..<b>RL2_GetSt
d090: 79 6c 65 64 4d 61 70 49 6d 61 67 65 46 72 6f 6d  yledMapImageFrom
d0a0: 56 65 63 74 6f 72 3c 2f 62 3e 20 28 20 3c 62 3e  Vector</b> ( <b>
d0b0: 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e  dbPrefix</b> <i>
d0c0: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
d0d0: 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e  coverageName</b>
d0e0: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
d0f0: 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c   <b>boundingBox<
d100: 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d  /b> <i>BLOB-Geom
d110: 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69  etry</i> , <b>wi
d120: 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  dth</b> <i>Integ
d130: 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67  er</i> , <b>heig
d140: 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ht</b> <i>Intege
d150: 72 3c 2f 69 3e 20 2c 20 3c 62 3e 78 6d 6c 5f 73  r</i> , <b>xml_s
d160: 74 79 6c 65 3c 2f 62 3e 20 3c 69 3e 54 65 78 74  tyle</b> <i>Text
d170: 3c 2f 69 3e 20 2c 20 3c 62 3e 6d 69 6d 65 54 79  </i> , <b>mimeTy
d180: 70 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  pe</b> <i>String
d190: 3c 2f 69 3e 20 2c 20 3c 62 3e 62 67 43 6f 6c 6f  </i> , <b>bgColo
d1a0: 72 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  r</b> <i>String<
d1b0: 2f 69 3e 20 29 20 3a 20 3c 69 3e 42 4c 4f 42 3c  /i> ) : <i>BLOB<
d1c0: 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e  /i><br><br>..<b>
d1d0: 52 4c 32 5f 47 65 74 53 74 79 6c 65 64 4d 61 70  RL2_GetStyledMap
d1e0: 49 6d 61 67 65 46 72 6f 6d 56 65 63 74 6f 72 3c  ImageFromVector<
d1f0: 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69  /b> ( <b>dbPrefi
d200: 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  x</b> <i>String<
d210: 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67  /i> , <b>coverag
d220: 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  eName</b> <i>Str
d230: 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75  ing</i> , <b>bou
d240: 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e  ndingBox</b> <i>
d250: 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69  BLOB-Geometry</i
d260: 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e  > , <b>width</b>
d270: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
d280: 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20  , <b>height</b> 
d290: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
d2a0: 20 3c 62 3e 78 6d 6c 5f 73 74 79 6c 65 3c 2f 62   <b>xml_style</b
d2b0: 3e 20 3c 69 3e 54 65 78 74 3c 2f 69 3e 20 2c 20  > <i>Text</i> , 
d2c0: 3c 62 3e 6d 69 6d 65 54 79 70 65 3c 2f 62 3e 20  <b>mimeType</b> 
d2d0: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
d2e0: 3c 62 3e 62 67 43 6f 6c 6f 72 3c 2f 62 3e 20 3c  <b>bgColor</b> <
d2f0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
d300: 62 3e 74 72 61 6e 73 70 61 72 65 6e 74 3c 2f 62  b>transparent</b
d310: 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
d320: 20 29 20 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e   ) : <i>BLOB</i>
d330: 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32  <br><br>..<b>RL2
d340: 5f 47 65 74 53 74 79 6c 65 64 4d 61 70 49 6d 61  _GetStyledMapIma
d350: 67 65 46 72 6f 6d 56 65 63 74 6f 72 3c 2f 62 3e  geFromVector</b>
d360: 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f   ( <b>dbPrefix</
d370: 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
d380: 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61   , <b>coverageNa
d390: 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  me</b> <i>String
d3a0: 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69  </i> , <b>boundi
d3b0: 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f  ngBox</b> <i>BLO
d3c0: 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c  B-Geometry</i> ,
d3d0: 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69   <b>width</b> <i
d3e0: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
d3f0: 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e  b>height</b> <i>
d400: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
d410: 3e 78 6d 6c 5f 73 74 79 6c 65 3c 2f 62 3e 20 3c  >xml_style</b> <
d420: 69 3e 54 65 78 74 3c 2f 69 3e 20 2c 20 3c 62 3e  i>Text</i> , <b>
d430: 6d 69 6d 65 54 79 70 65 3c 2f 62 3e 20 3c 69 3e  mimeType</b> <i>
d440: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
d450: 62 67 43 6f 6c 6f 72 3c 2f 62 3e 20 3c 69 3e 53  bgColor</b> <i>S
d460: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 74  tring</i> , <b>t
d470: 72 61 6e 73 70 61 72 65 6e 74 3c 2f 62 3e 20 3c  ransparent</b> <
d480: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
d490: 3c 62 3e 71 75 61 6c 69 74 79 3c 2f 62 3e 20 3c  <b>quality</b> <
d4a0: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20  i>Integer</i> ) 
d4b0: 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 62 72  : <i>BLOB</i><br
d4c0: 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 47 65  ><br>..<b>RL2_Ge
d4d0: 74 53 74 79 6c 65 64 4d 61 70 49 6d 61 67 65 46  tStyledMapImageF
d4e0: 72 6f 6d 56 65 63 74 6f 72 3c 2f 62 3e 20 28 20  romVector</b> ( 
d4f0: 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20  <b>dbPrefix</b> 
d500: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
d510: 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
d520: 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
d530: 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42  > , <b>boundingB
d540: 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47  ox</b> <i>BLOB-G
d550: 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62  eometry</i> , <b
d560: 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
d570: 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
d580: 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
d590: 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 78 6d  eger</i> , <b>xm
d5a0: 6c 5f 73 74 79 6c 65 3c 2f 62 3e 20 3c 69 3e 54  l_style</b> <i>T
d5b0: 65 78 74 3c 2f 69 3e 20 2c 20 3c 62 3e 6d 69 6d  ext</i> , <b>mim
d5c0: 65 54 79 70 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  eType</b> <i>Str
d5d0: 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62 67 43  ing</i> , <b>bgC
d5e0: 6f 6c 6f 72 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  olor</b> <i>Stri
d5f0: 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 74 72 61 6e  ng</i> , <b>tran
d600: 73 70 61 72 65 6e 74 3c 2f 62 3e 20 3c 69 3e 49  sparent</b> <i>I
d610: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
d620: 71 75 61 6c 69 74 79 3c 2f 62 3e 20 3c 69 3e 49  quality</b> <i>I
d630: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
d640: 72 65 61 73 70 65 63 74 3c 2f 62 3e 20 3c 69 3e  reaspect</b> <i>
d650: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20  Integer</i> ) : 
d660: 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 2f 74 64 3e  <i>BLOB</i></td>
d670: 0d 0a 3c 74 64 3e 57 69 6c 6c 20 61 74 74 65 6d  ..<td>Will attem
d680: 70 74 20 74 6f 20 63 72 65 61 74 65 20 61 20 64  pt to create a d
d690: 69 67 69 74 61 6c 20 69 6d 61 67 65 20 72 65 70  igital image rep
d6a0: 72 65 73 65 6e 74 69 6e 67 20 61 20 53 74 79 6c  resenting a Styl
d6b0: 65 64 20 4d 61 70 20 66 72 6f 6d 20 61 20 43 6f  ed Map from a Co
d6c0: 76 65 72 61 67 65 20 6f 66 20 74 68 65 20 56 65  verage of the Ve
d6d0: 63 74 6f 72 20 74 79 70 65 2e 3c 62 72 3e 0d 0a  ctor type.<br>..
d6e0: 57 69 6c 6c 20 72 65 74 75 72 6e 20 61 20 42 4c  Will return a BL
d6f0: 4f 42 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68  OB containing th
d700: 65 20 53 74 79 6c 65 64 20 4d 61 70 3a 20 6f 72  e Styled Map: or
d710: 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 6f 6e 20   <b>NULL</b> on 
d720: 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74  invalid argument
d730: 73 20 6f 72 20 69 66 20 61 6e 79 20 65 72 72 6f  s or if any erro
d740: 72 20 6f 63 63 75 72 73 2e 3c 62 72 3e 3c 62 72  r occurs.<br><br
d750: 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74  >..<u>Please not
d760: 65 3c 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c  e</u>: ..<ul>..<
d770: 6c 69 3e 41 6c 6d 6f 73 74 20 61 6c 6c 20 74 68  li>Almost all th
d780: 65 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65 20  e arguments are 
d790: 74 68 65 20 73 61 6d 65 20 61 73 20 69 6e 20 3c  the same as in <
d7a0: 62 3e 52 4c 32 5f 47 65 74 4d 61 70 49 6d 61 67  b>RL2_GetMapImag
d7b0: 65 46 72 6f 6d 56 65 63 74 6f 72 28 29 3c 2f 62  eFromVector()</b
d7c0: 3e 20 61 6e 64 20 68 61 76 65 20 69 64 65 6e 74  > and have ident
d7d0: 69 63 61 6c 20 69 6e 74 65 72 70 72 65 74 61 74  ical interpretat
d7e0: 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 54  ion.</li>..<li>T
d7f0: 68 65 20 6f 6e 6c 79 20 65 78 63 65 70 74 69 6f  he only exceptio
d800: 6e 20 62 65 69 6e 67 20 3c 62 3e 3c 69 3e 78 6d  n being <b><i>xm
d810: 6c 5f 73 74 79 6c 65 3c 2f 69 3e 3c 2f 62 3e 20  l_style</i></b> 
d820: 74 68 61 74 20 69 73 20 65 78 70 65 63 74 65 64  that is expected
d830: 20 74 6f 20 63 6f 6e 74 61 69 6e 20 61 20 76 61   to contain a va
d840: 6c 69 64 20 3c 62 3e 53 4c 44 2f 53 45 20 58 4d  lid <b>SLD/SE XM
d850: 4c 20 56 65 63 74 6f 72 20 53 79 6d 62 6f 6c 69  L Vector Symboli
d860: 7a 65 72 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c  zer</b>.</li>..<
d870: 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65  /ul><br>..<table
d880: 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22   cellspacing="8"
d890: 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22   cellpadding="8"
d8a0: 20 62 67 63 6f 6c 6f 72 3d 22 23 64 30 66 66 64   bgcolor="#d0ffd
d8b0: 30 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 49 6e 20  0"><tr><td>..In 
d8c0: 6f 74 68 65 72 20 77 6f 72 64 73 3a 0d 0a 3c 75  other words:..<u
d8d0: 6c 3e 0d 0a 3c 6c 69 3e 42 6f 74 68 20 3c 62 3e  l>..<li>Both <b>
d8e0: 52 4c 32 5f 47 65 74 4d 61 70 49 6d 61 67 65 46  RL2_GetMapImageF
d8f0: 72 6f 6d 56 65 63 74 6f 72 28 29 3c 2f 62 3e 20  romVector()</b> 
d900: 61 6e 64 20 3c 62 3e 52 4c 32 5f 47 65 74 53 74  and <b>RL2_GetSt
d910: 79 6c 65 64 4d 61 70 49 6d 61 67 65 46 72 6f 6d  yledMapImageFrom
d920: 56 65 63 74 6f 72 28 29 3c 2f 62 3e 20 61 72 65  Vector()</b> are
d930: 20 76 65 72 79 20 73 69 6d 69 6c 61 72 20 69 6e   very similar in
d940: 20 74 68 65 69 72 20 67 65 6e 65 72 61 6c 20 62   their general b
d950: 65 68 61 76 69 6f 72 2e 20 54 68 65 20 6d 61 69  ehavior. The mai
d960: 6e 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 74  n difference bet
d970: 77 65 65 6e 20 74 68 65 6d 20 69 73 3a 0d 0a 3c  ween them is:..<
d980: 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 52 4c 32 5f  ul>..<li><b>RL2_
d990: 47 65 74 4d 61 70 49 6d 61 67 65 46 72 6f 6d 56  GetMapImageFromV
d9a0: 65 63 74 6f 72 28 29 3c 2f 62 3e 20 61 63 63 65  ector()</b> acce
d9b0: 70 74 73 20 74 68 65 20 3c 62 3e 6e 61 6d 65 3c  pts the <b>name<
d9c0: 2f 62 3e 20 6f 66 20 61 20 72 65 67 69 73 74 65  /b> of a registe
d9d0: 72 65 64 20 53 74 79 6c 65 2e 3c 2f 6c 69 3e 0d  red Style.</li>.
d9e0: 0a 3c 6c 69 3e 3c 62 3e 52 4c 32 5f 47 65 74 53  .<li><b>RL2_GetS
d9f0: 74 79 6c 65 64 4d 61 70 49 6d 61 67 65 46 72 6f  tyledMapImageFro
da00: 6d 56 65 63 74 6f 72 28 29 3c 2f 62 3e 20 64 69  mVector()</b> di
da10: 72 65 63 74 6c 79 20 61 63 63 65 70 74 73 20 61  rectly accepts a
da20: 6e 20 3c 62 3e 58 4d 4c 20 53 74 79 6c 65 3c 2f  n <b>XML Style</
da30: 62 3e 20 64 65 66 69 6e 69 74 69 6f 6e 2e 3c 2f  b> definition.</
da40: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d  li>..</ul></li>.
da50: 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74  .</ul>..</td></t
da60: 72 3e 3c 2f 74 61 62 6c 65 3e 0d 0a 3c 2f 74 64  r></table>..</td
da70: 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e  ></tr>..<tr><td>
da80: 3c 62 3e 52 4c 32 5f 47 65 74 4d 61 70 49 6d 61  <b>RL2_GetMapIma
da90: 67 65 46 72 6f 6d 57 4d 53 3c 2f 62 3e 20 28 20  geFromWMS</b> ( 
daa0: 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20  <b>dbPrefix</b> 
dab0: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
dac0: 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
dad0: 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
dae0: 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42  > , <b>boundingB
daf0: 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47  ox</b> <i>BLOB-G
db00: 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62  eometry</i> , <b
db10: 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
db20: 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
db30: 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
db40: 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e  eger</i> ) : <i>
db50: 42 4c 4f 42 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e  BLOB</i><br><br>
db60: 0d 0a 3c 62 3e 52 4c 32 5f 47 65 74 4d 61 70 49  ..<b>RL2_GetMapI
db70: 6d 61 67 65 46 72 6f 6d 57 4d 53 3c 2f 62 3e 20  mageFromWMS</b> 
db80: 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62  ( <b>dbPrefix</b
db90: 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
dba0: 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d  , <b>coverageNam
dbb0: 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  e</b> <i>String<
dbc0: 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e  /i> , <b>boundin
dbd0: 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42  gBox</b> <i>BLOB
dbe0: 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20  -Geometry</i> , 
dbf0: 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e  <b>width</b> <i>
dc00: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
dc10: 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49  >height</b> <i>I
dc20: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
dc30: 76 65 72 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53  version</b> <i>S
dc40: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73  tring</i> , <b>s
dc50: 74 79 6c 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e  tyleName</b> <i>
dc60: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
dc70: 6d 69 6d 65 54 79 70 65 3c 2f 62 3e 20 3c 69 3e  mimeType</b> <i>
dc80: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
dc90: 62 67 43 6f 6c 6f 72 3c 2f 62 3e 20 3c 69 3e 53  bgColor</b> <i>S
dca0: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 74  tring</i> , <b>t
dcb0: 72 61 6e 73 70 61 72 65 6e 74 3c 2f 62 3e 20 3c  ransparent</b> <
dcc0: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20  i>Integer</i> ) 
dcd0: 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 2f 74  : <i>BLOB</i></t
dce0: 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 61 74 74  d>..<td>Will att
dcf0: 65 6d 70 74 20 74 6f 20 63 72 65 61 74 65 20 61  empt to create a
dd00: 20 64 69 67 69 74 61 6c 20 69 6d 61 67 65 20 72   digital image r
dd10: 65 70 72 65 73 65 6e 74 69 6e 67 20 61 20 53 74  epresenting a St
dd20: 79 6c 65 64 20 4d 61 70 20 66 72 6f 6d 20 61 20  yled Map from a 
dd30: 43 6f 76 65 72 61 67 65 20 6f 66 20 74 68 65 20  Coverage of the 
dd40: 57 4d 53 20 74 79 70 65 2e 3c 62 72 3e 0d 0a 57  WMS type.<br>..W
dd50: 69 6c 6c 20 72 65 74 75 72 6e 20 61 20 42 4c 4f  ill return a BLO
dd60: 42 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65  B containing the
dd70: 20 53 74 79 6c 65 64 20 4d 61 70 3a 20 6f 72 20   Styled Map: or 
dd80: 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 6f 6e 20 69  <b>NULL</b> on i
dd90: 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73  nvalid arguments
dda0: 20 6f 72 20 69 66 20 61 6e 79 20 65 72 72 6f 72   or if any error
ddb0: 20 6f 63 63 75 72 73 2e 3c 62 72 3e 0d 0a 3c 75   occurs.<br>..<u
ddc0: 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e  >Please note</u>
ddd0: 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54 68  : ..<ul>..<li>Th
dde0: 65 20 3c 62 3e 3c 69 3e 64 62 50 72 65 66 69 78  e <b><i>dbPrefix
ddf0: 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67 75 6d 65 6e  </i></b> argumen
de00: 74 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f  t is intended to
de10: 20 73 70 65 63 69 66 79 20 74 68 65 20 41 54 54   specify the ATT
de20: 41 43 48 45 44 2d 44 42 20 77 68 65 72 65 20 74  ACHED-DB where t
de30: 68 65 20 43 6f 76 65 72 61 67 65 20 69 73 20 65  he Coverage is e
de40: 78 70 65 63 74 65 64 20 74 6f 20 62 65 20 66 6f  xpected to be fo
de50: 75 6e 64 3b 20 69 74 20 63 6f 75 6c 64 20 62 65  und; it could be
de60: 20 65 76 65 6e 74 75 61 6c 6c 79 20 3c 62 3e 4e   eventually <b>N
de70: 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69 6e 20  ULL</b>, and in 
de80: 74 68 69 73 20 63 61 73 65 20 74 68 65 20 3c 62  this case the <b
de90: 3e 4d 41 49 4e 20 44 42 3c 2f 62 3e 20 77 69 6c  >MAIN DB</b> wil
dea0: 6c 20 69 6d 70 6c 69 63 69 74 6c 79 20 62 65 20  l implicitly be 
deb0: 61 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c  assumed.</li>..<
dec0: 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 62 6f 75  li>the <b><i>bou
ded0: 6e 64 69 6e 67 42 6f 78 3c 2f 69 3e 3c 2f 62 3e  ndingBox</i></b>
dee0: 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f 20   is expected to 
def0: 72 65 70 72 65 73 65 6e 74 20 74 68 65 20 6f 76  represent the ov
df00: 65 72 61 6c 6c 20 65 78 74 65 6e 74 20 6f 66 20  erall extent of 
df10: 74 68 65 20 53 74 79 6c 65 64 20 4d 61 70 3b 20  the Styled Map; 
df20: 79 6f 75 20 63 6f 75 6c 64 20 65 76 65 6e 74 75  you could eventu
df30: 61 6c 6c 79 20 70 61 73 73 20 61 6e 79 20 61 72  ally pass any ar
df40: 62 69 74 72 61 72 79 20 6b 69 6e 64 20 6f 66 20  bitrary kind of 
df50: 47 65 6f 6d 65 74 72 79 2c 20 61 6e 64 20 74 68  Geometry, and th
df60: 65 20 42 6f 75 6e 64 69 6e 67 20 42 6f 78 20 61  e Bounding Box a
df70: 6b 61 20 4d 42 52 20 77 69 6c 6c 20 62 65 20 61  ka MBR will be a
df80: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 74  utomatically det
df90: 65 72 6d 69 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c  ermined.</li>..<
dfa0: 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 76 65 72  li>the <b><i>ver
dfb0: 73 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67  sion</i></b> arg
dfc0: 75 6d 65 6e 74 20 64 65 74 65 72 6d 69 6e 77 73  ument determinws
dfd0: 20 77 68 69 63 68 20 76 65 72 73 69 6f 6e 20 6f   which version o
dfe0: 66 20 74 68 65 20 57 4d 53 20 70 72 6f 74 6f 63  f the WMS protoc
dff0: 6f 6c 20 73 68 6f 75 6c 64 20 62 65 20 75 73 65  ol should be use
e000: 64 2e 3c 62 72 3e 0d 0a 56 61 6c 69 64 20 76 61  d.<br>..Valid va
e010: 6c 75 65 73 20 61 72 65 3a 20 3c 62 3e 31 2e 30  lues are: <b>1.0
e020: 2e 30 3c 2f 62 3e 2c 20 3c 62 3e 31 2e 31 2e 30  .0</b>, <b>1.1.0
e030: 3c 2f 62 3e 2c 20 3c 62 3e 31 2e 31 2e 31 3c 2f  </b>, <b>1.1.1</
e040: 62 3e 20 61 6e 64 20 3c 62 3e 31 2e 33 2e 30 3c  b> and <b>1.3.0<
e050: 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68  /b></li>..<li>th
e060: 65 20 3c 62 3e 3c 69 3e 73 74 79 6c 65 4e 61 6d  e <b><i>styleNam
e070: 65 3c 2f 69 3e 3c 2f 62 3e 20 63 6f 75 6c 64 20  e</i></b> could 
e080: 62 65 20 65 76 65 6e 74 75 61 6c 6c 79 20 3c 62  be eventually <b
e090: 3e 27 64 65 66 61 75 6c 74 27 3c 2f 62 3e 20 28  >'default'</b> (
e0a0: 69 74 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68  it depends on th
e0b0: 65 20 73 70 65 63 69 66 69 63 20 63 61 70 61 62  e specific capab
e0c0: 69 6c 69 74 65 73 20 64 65 63 6c 61 72 65 64 20  ilites declared 
e0d0: 66 72 6f 6d 20 74 68 65 20 72 65 6d 6f 74 65 20  from the remote 
e0e0: 73 65 72 76 65 72 29 2e 3c 2f 6c 69 3e 0d 0a 3c  server).</li>..<
e0f0: 6c 69 3e 74 68 65 20 42 6f 75 6e 64 69 6e 67 42  li>the BoundingB
e100: 6f 78 20 69 73 20 65 78 70 65 63 74 65 64 20 74  ox is expected t
e110: 6f 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68 20  o exactly match 
e120: 74 68 65 20 69 6d 61 67 65 27 73 20 3c 62 3e 3c  the image's <b><
e130: 69 3e 77 69 64 74 68 3c 2f 69 3e 3c 2f 62 3e 20  i>width</i></b> 
e140: 61 6e 64 20 3c 62 3e 3c 69 3e 68 65 69 67 68 74  and <b><i>height
e150: 3c 2f 69 3e 3c 2f 62 3e 20 64 69 6d 65 6e 73 69  </i></b> dimensi
e160: 6f 6e 73 20 61 74 20 74 68 61 74 20 72 65 73 6f  ons at that reso
e170: 6c 75 74 69 6f 6e 2e 2e 3c 2f 6c 69 3e 0d 0a 3c  lution..</li>..<
e180: 6c 69 3e 74 68 65 20 61 72 67 75 6d 65 6e 74 20  li>the argument 
e190: 3c 62 3e 3c 69 3e 6d 69 6d 65 54 79 70 65 3c 2f  <b><i>mimeType</
e1a0: 69 3e 3c 2f 62 3e 20 63 6f 75 6c 64 20 75 73 75  i></b> could usu
e1b0: 61 6c 6c 79 20 62 65 20 6f 6e 65 20 6f 66 20 3c  ally be one of <
e1c0: 62 3e 27 69 6d 61 67 65 2f 70 64 66 27 3c 2f 62  b>'image/pdf'</b
e1d0: 3e 2c 20 3c 62 3e 27 69 6d 61 67 65 2f 6a 70 65  >, <b>'image/jpe
e1e0: 67 27 3c 2f 62 3e 20 6f 72 20 3c 62 3e 27 69 6d  g'</b> or <b>'im
e1f0: 61 67 65 2f 74 69 66 66 27 3c 2f 62 3e 20 28 69  age/tiff'</b> (i
e200: 74 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 65  t depends on the
e210: 20 73 70 65 63 69 66 69 63 20 63 61 70 61 62 69   specific capabi
e220: 6c 69 74 65 73 20 64 65 63 6c 61 72 65 64 20 66  lites declared f
e230: 72 6f 6d 20 74 68 65 20 72 65 6d 6f 74 65 20 73  rom the remote s
e240: 65 72 76 65 72 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c  erver).</li>..<l
e250: 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 3c  i>the optional <
e260: 62 3e 3c 69 3e 62 67 43 6f 6c 6f 72 3c 2f 69 3e  b><i>bgColor</i>
e270: 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 20 69 73  </b> argument is
e280: 20 65 78 70 65 63 74 65 64 20 74 6f 20 62 65 20   expected to be 
e290: 65 78 70 72 65 73 73 65 64 20 69 6e 20 74 68 65  expressed in the
e2a0: 20 63 61 6e 6f 6e 69 63 61 6c 20 57 45 42 20 48   canonical WEB H
e2b0: 45 58 2d 52 47 42 20 66 6f 72 6d 2c 20 61 73 20  EX-RGB form, as 
e2c0: 69 6e 20 3c 62 3e 27 23 66 66 38 30 38 30 27 3c  in <b>'#ff8080'<
e2d0: 2f 62 3e 20 28 64 65 66 61 75 6c 74 20 69 73 20  /b> (default is 
e2e0: 27 23 66 66 66 66 66 66 27 20 69 2e 65 2e 20 66  '#ffffff' i.e. f
e2f0: 75 6c 6c 20 77 68 69 74 65 29 2e 3c 2f 6c 69 3e  ull white).</li>
e300: 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e  ..<li>the option
e310: 61 6c 20 3c 62 3e 3c 69 3e 74 72 61 6e 73 70 61  al <b><i>transpa
e320: 72 65 6e 74 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67  rent</i></b> arg
e330: 75 6d 65 6e 74 20 69 73 20 65 78 70 65 63 74 65  ument is expecte
e340: 64 20 74 6f 20 62 65 20 65 78 70 72 65 73 73 65  d to be expresse
e350: 64 20 61 73 20 61 20 42 6f 6f 6c 65 61 6e 20 76  d as a Boolean v
e360: 61 6c 75 65 20 28 64 65 66 61 75 6c 74 20 69 73  alue (default is
e370: 20 3c 62 3e 30 3c 2f 62 3e 20 46 41 4c 53 45 29   <b>0</b> FALSE)
e380: 2e 3c 62 72 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65  .<br>..<u>Please
e390: 20 6e 6f 74 65 3c 2f 75 3e 3a 20 74 72 61 6e 73   note</u>: trans
e3a0: 70 61 72 65 6e 63 79 20 69 73 20 73 75 70 70 6f  parency is suppo
e3b0: 72 74 65 64 20 75 6e 69 71 75 65 6c 79 20 62 79  rted uniquely by
e3c0: 20 50 4e 47 20 69 6d 61 67 65 73 2e 3c 2f 6c 69   PNG images.</li
e3d0: 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 3e 3c  >..</ul>..</td><
e3e0: 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62  /tr>..<tr><td><b
e3f0: 3e 52 4c 32 5f 47 65 74 49 6d 61 67 65 46 72 6f  >RL2_GetImageFro
e400: 6d 4d 61 70 43 6f 6e 66 69 67 75 72 61 74 69 6f  mMapConfiguratio
e410: 6e 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f 6e 66 69  n</b> ( <b>confi
e420: 67 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  gName</b> <i>Str
e430: 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75  ing</i> , <b>bou
e440: 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e  ndingBox</b> <i>
e450: 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69  BLOB-Geometry</i
e460: 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e  > , <b>width</b>
e470: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
e480: 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20  , <b>height</b> 
e490: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29  <i>Integer</i> )
e4a0: 20 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 62   : <i>BLOB</i><b
e4b0: 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 47  r><br>..<b>RL2_G
e4c0: 65 74 49 6d 61 67 65 46 72 6f 6d 4d 61 70 43 6f  etImageFromMapCo
e4d0: 6e 66 69 67 75 72 61 74 69 6f 6e 3c 2f 62 3e 20  nfiguration</b> 
e4e0: 28 20 3c 62 3e 63 6f 6e 66 69 67 4e 61 6d 65 3c  ( <b>configName<
e4f0: 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
e500: 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42  > , <b>boundingB
e510: 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47  ox</b> <i>BLOB-G
e520: 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62  eometry</i> , <b
e530: 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
e540: 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
e550: 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
e560: 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 6d 69  eger</i> , <b>mi
e570: 6d 65 54 79 70 65 3c 2f 62 3e 20 3c 69 3e 53 74  meType</b> <i>St
e580: 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e  ring</i> ) : <i>
e590: 42 4c 4f 42 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e  BLOB</i><br><br>
e5a0: 0d 0a 3c 62 3e 52 4c 32 5f 47 65 74 49 6d 61 67  ..<b>RL2_GetImag
e5b0: 65 46 72 6f 6d 4d 61 70 43 6f 6e 66 69 67 75 72  eFromMapConfigur
e5c0: 61 74 69 6f 6e 3c 2f 62 3e 20 28 20 3c 62 3e 63  ation</b> ( <b>c
e5d0: 6f 6e 66 69 67 4e 61 6d 65 3c 2f 62 3e 20 3c 69  onfigName</b> <i
e5e0: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
e5f0: 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e  >boundingBox</b>
e600: 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72   <i>BLOB-Geometr
e610: 79 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68  y</i> , <b>width
e620: 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
e630: 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c  /i> , <b>height<
e640: 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
e650: 69 3e 20 2c 20 3c 62 3e 6d 69 6d 65 54 79 70 65  i> , <b>mimeType
e660: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
e670: 69 3e 20 2c 20 3c 62 3e 71 75 61 6c 69 74 79 3c  i> , <b>quality<
e680: 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
e690: 69 3e 20 29 20 3a 20 3c 69 3e 42 4c 4f 42 3c 2f  i> ) : <i>BLOB</
e6a0: 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52  i><br><br>..<b>R
e6b0: 4c 32 5f 47 65 74 49 6d 61 67 65 46 72 6f 6d 4d  L2_GetImageFromM
e6c0: 61 70 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3c  apConfiguration<
e6d0: 2f 62 3e 20 28 20 3c 62 3e 63 6f 6e 66 69 67 4e  /b> ( <b>configN
e6e0: 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ame</b> <i>Strin
e6f0: 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64  g</i> , <b>bound
e700: 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c  ingBox</b> <i>BL
e710: 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20  OB-Geometry</i> 
e720: 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c  , <b>width</b> <
e730: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
e740: 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69  <b>height</b> <i
e750: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
e760: 62 3e 6d 69 6d 65 54 79 70 65 3c 2f 62 3e 20 3c  b>mimeType</b> <
e770: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
e780: 62 3e 71 75 61 6c 69 74 79 3c 2f 62 3e 20 3c 69  b>quality</b> <i
e790: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
e7a0: 62 3e 72 65 61 73 70 65 63 74 3c 2f 62 3e 20 3c  b>reaspect</b> <
e7b0: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20  i>Integer</i> ) 
e7c0: 3a 20 3c 69 3e 42 4c 4f 42 3c 2f 69 3e 3c 2f 74  : <i>BLOB</i></t
e7d0: 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 61 74 74  d>..<td>Will att
e7e0: 65 6d 70 74 20 74 6f 20 63 72 65 61 74 65 20 61  empt to create a
e7f0: 20 64 69 67 69 74 61 6c 20 69 6d 61 67 65 20 72   digital image r
e800: 65 70 72 65 73 65 6e 74 69 6e 67 20 61 20 63 6f  epresenting a co
e810: 6d 70 6c 65 78 2c 20 6d 75 6c 74 69 2d 6c 61 79  mplex, multi-lay
e820: 65 72 65 64 20 53 74 79 6c 65 64 20 4d 61 70 20  ered Styled Map 
e830: 66 72 6f 6d 20 61 20 72 65 67 69 73 74 65 72 65  from a registere
e840: 64 20 4d 61 70 43 6f 6e 66 69 67 75 72 61 74 69  d MapConfigurati
e850: 6f 6e 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72 65  on.<br>..Will re
e860: 74 75 72 6e 20 61 20 42 4c 4f 42 20 63 6f 6e 74  turn a BLOB cont
e870: 61 69 6e 69 6e 67 20 74 68 65 20 53 74 79 6c 65  aining the Style
e880: 64 20 4d 61 70 3a 20 6f 72 20 3c 62 3e 4e 55 4c  d Map: or <b>NUL
e890: 4c 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69 64  L</b> on invalid
e8a0: 20 61 72 67 75 6d 65 6e 74 73 20 6f 72 20 69 66   arguments or if
e8b0: 20 61 6e 79 20 65 72 72 6f 72 20 6f 63 63 75 72   any error occur
e8c0: 73 2e 3c 62 72 3e 0d 0a 3c 75 3e 50 6c 65 61 73  s.<br>..<u>Pleas
e8d0: 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 0d 0a 3c 75  e note</u>: ..<u
e8e0: 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 20 3c 62 3e 3c  l>..<li>The <b><
e8f0: 69 3e 63 6f 6e 66 69 67 4e 61 6d 65 3c 2f 69 3e  i>configName</i>
e900: 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 20 69 73  </b> argument is
e910: 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 73 70 65   intended to spe
e920: 63 69 66 79 20 77 68 69 63 68 20 6f 66 20 74 68  cify which of th
e930: 65 20 72 65 67 69 73 74 65 72 65 64 20 4d 61 70  e registered Map
e940: 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 73 20 73  Configurations s
e950: 68 6f 75 6c 64 20 62 65 20 75 73 65 64 2e 3c 62  hould be used.<b
e960: 72 3e 0d 0a 3c 62 3e 4e 6f 74 65 3c 2f 62 3e 3a  r>..<b>Note</b>:
e970: 20 74 68 65 20 72 65 71 75 69 72 65 64 20 4d 61   the required Ma
e980: 70 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d  pConfiguration m
e990: 75 73 74 20 62 65 20 72 65 67 69 73 74 65 72 65  ust be registere
e9a0: 64 20 69 6e 74 6f 20 74 68 65 20 3c 62 3e 4d 41  d into the <b>MA
e9b0: 49 4e 20 44 42 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a  IN DB</b></li>..
e9c0: 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 62 6f  <li>the <b><i>bo
e9d0: 75 6e 64 69 6e 67 42 6f 78 3c 2f 69 3e 3c 2f 62  undingBox</i></b
e9e0: 3e 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f  > is expected to
e9f0: 20 72 65 70 72 65 73 65 6e 74 20 74 68 65 20 6f   represent the o
ea00: 76 65 72 61 6c 6c 20 65 78 74 65 6e 74 20 6f 66  verall extent of
ea10: 20 74 68 65 20 53 74 79 6c 65 64 20 4d 61 70 3b   the Styled Map;
ea20: 20 79 6f 75 20 63 6f 75 6c 64 20 65 76 65 6e 74   you could event
ea30: 75 61 6c 6c 79 20 70 61 73 73 20 61 6e 79 20 61  ually pass any a
ea40: 72 62 69 74 72 61 72 79 20 6b 69 6e 64 20 6f 66  rbitrary kind of
ea50: 20 47 65 6f 6d 65 74 72 79 2c 20 61 6e 64 20 74   Geometry, and t
ea60: 68 65 20 42 6f 75 6e 64 69 6e 67 20 42 6f 78 20  he Bounding Box 
ea70: 61 6b 61 20 4d 42 52 20 77 69 6c 6c 20 62 65 20  aka MBR will be 
ea80: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65  automatically de
ea90: 74 65 72 6d 69 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a  termined.</li>..
eaa0: 3c 6c 69 3e 74 68 65 20 42 6f 75 6e 64 69 6e 67  <li>the Bounding
eab0: 42 6f 78 20 69 73 20 65 78 70 65 63 74 65 64 20  Box is expected 
eac0: 74 6f 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68  to exactly match
ead0: 20 74 68 65 20 69 6d 61 67 65 27 73 20 3c 62 3e   the image's <b>
eae0: 3c 69 3e 77 69 64 74 68 3c 2f 69 3e 3c 2f 62 3e  <i>width</i></b>
eaf0: 20 61 6e 64 20 3c 62 3e 3c 69 3e 68 65 69 67 68   and <b><i>heigh
eb00: 74 3c 2f 69 3e 3c 2f 62 3e 20 64 69 6d 65 6e 73  t</i></b> dimens
eb10: 69 6f 6e 73 20 61 74 20 74 68 61 74 20 72 65 73  ions at that res
eb20: 6f 6c 75 74 69 6f 6e 2e 3c 62 72 3e 0d 0a 45 78  olution.<br>..Ex
eb30: 63 65 70 74 20 77 68 65 6e 20 74 68 65 20 6f 70  cept when the op
eb40: 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20  tional argument 
eb50: 3c 62 3e 3c 69 3e 72 65 61 73 70 65 63 74 3c 2f  <b><i>reaspect</
eb60: 69 3e 3c 2f 62 3e 20 69 73 20 73 65 74 20 74 6f  i></b> is set to
eb70: 20 54 52 55 45 3b 20 69 6e 20 74 68 69 73 20 6c   TRUE; in this l
eb80: 61 74 65 72 20 63 61 73 65 20 65 61 63 68 20 73  ater case each s
eb90: 69 6e 67 6c 65 20 61 78 69 73 20 63 6f 75 6c 64  ingle axis could
eba0: 20 62 65 20 69 6e 64 65 70 65 6e 64 65 6e 74 6c   be independentl
ebb0: 79 20 72 65 73 63 61 6c 65 64 2e 3c 2f 6c 69 3e  y rescaled.</li>
ebc0: 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e  ..<li>the option
ebd0: 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 3c  al argument <b><
ebe0: 69 3e 6d 69 6d 65 54 79 70 65 3c 2f 69 3e 3c 2f  i>mimeType</i></
ebf0: 62 3e 20 63 6f 75 6c 64 20 62 65 20 6f 6e 65 20  b> could be one 
ec00: 6f 66 20 3c 62 3e 27 69 6d 61 67 65 2f 70 64 66  of <b>'image/pdf
ec10: 27 3c 2f 62 3e 2c 20 3c 62 3e 27 69 6d 61 67 65  '</b>, <b>'image
ec20: 2f 6a 70 65 67 27 3c 2f 62 3e 2c 20 3c 62 3e 27  /jpeg'</b>, <b>'
ec30: 69 6d 61 67 65 2f 74 69 66 66 27 3c 2f 62 3e 20  image/tiff'</b> 
ec40: 6f 72 20 3c 62 3e 27 61 70 70 6c 69 63 61 74 69  or <b>'applicati
ec50: 6f 6e 2f 78 2d 70 64 66 27 3c 2f 62 3e 3b 20 64  on/x-pdf'</b>; d
ec60: 65 66 61 75 6c 74 20 69 73 20 3c 62 3e 27 69 6d  efault is <b>'im
ec70: 61 67 65 2f 70 6e 67 27 3c 2f 62 3e 2e 3c 2f 6c  age/png'</b>.</l
ec80: 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69  i>..<li>the opti
ec90: 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62  onal argument <b
eca0: 3e 3c 69 3e 71 75 61 6c 69 74 79 3c 2f 69 3e 3c  ><i>quality</i><
ecb0: 2f 62 3e 20 28 69 6e 20 74 68 65 20 72 61 6e 67  /b> (in the rang
ecc0: 65 20 3c 62 3e 30 3c 2f 62 3e 20 2d 20 3c 62 3e  e <b>0</b> - <b>
ecd0: 31 30 30 3c 2f 62 3e 3b 20 64 65 66 61 75 6c 74  100</b>; default
ece0: 20 3c 62 3e 38 30 3c 2f 62 3e 29 20 69 73 20 6d   <b>80</b>) is m
ecf0: 65 61 6e 69 6e 67 66 75 6c 20 6f 6e 6c 79 20 69  eaningful only i
ed00: 6e 20 74 68 65 20 63 61 73 65 20 6f 66 20 4a 50  n the case of JP
ed10: 45 47 20 69 6d 61 67 65 73 2e 3c 2f 6c 69 3e 0d  EG images.</li>.
ed20: 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74  .</ul>..</td></t
ed30: 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e  r>..</table><br>
ed40: 0d 0a 3c 68 72 3e 0d 0a 3c 68 32 3e 53 51 4c 20  ..<hr>..<h2>SQL 
ed50: 66 75 6e 63 74 69 6f 6e 73 20 69 6d 70 6f 72 74  functions import
ed60: 69 6e 67 20 72 61 73 74 65 72 20 64 61 74 61 20  ing raster data 
ed70: 66 72 6f 6d 20 65 78 74 65 72 6e 61 6c 20 64 61  from external da
ed80: 74 61 73 6f 75 72 63 65 73 3c 2f 68 32 3e 20 0d  tasources</h2> .
ed90: 0a 3c 74 61 62 6c 65 20 77 69 64 74 68 3d 22 31  .<table width="1
eda0: 30 30 25 22 20 62 6f 72 64 65 72 3d 22 31 22 20  00%" border="1" 
edb0: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 30  bgcolor="#ffffe0
edc0: 22 20 63 65 6c 6c 65 73 70 61 63 69 6e 67 3d 22  " cellespacing="
edd0: 34 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22  4" cellpadding="
ede0: 36 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 67 63  6">..<tr><th bgc
edf0: 6f 6c 6f 72 3d 22 23 65 30 65 30 65 30 22 20 77  olor="#e0e0e0" w
ee00: 69 64 74 68 3d 22 35 30 25 22 3e 53 79 6e 74 61  idth="50%">Synta
ee10: 78 3c 2f 74 68 3e 3c 74 68 20 62 67 63 6f 6c 6f  x</th><th bgcolo
ee20: 72 3d 22 23 65 30 65 30 65 30 22 20 77 69 64 74  r="#e0e0e0" widt
ee30: 68 3d 22 35 30 25 22 3e 53 75 6d 6d 61 72 79 3c  h="50%">Summary<
ee40: 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c  /th></tr>..<tr><
ee50: 74 64 3e 3c 62 3e 52 4c 32 5f 4c 6f 61 64 52 61  td><b>RL2_LoadRa
ee60: 73 74 65 72 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f  ster</b> ( <b>co
ee70: 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c  verageName</b> <
ee80: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
ee90: 62 3e 73 6f 75 72 63 65 50 61 74 68 3c 2f 62 3e  b>sourcePath</b>
eea0: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29   <i>String</i> )
eeb0: 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69   : <i>Integer</i
eec0: 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c  ><br><br>..<b>RL
eed0: 32 5f 4c 6f 61 64 52 61 73 74 65 72 3c 2f 62 3e  2_LoadRaster</b>
eee0: 20 28 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61   ( <b>coverageNa
eef0: 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  me</b> <i>String
ef00: 3c 2f 69 3e 20 2c 20 3c 62 3e 73 6f 75 72 63 65  </i> , <b>source
ef10: 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Path</b> <i>Stri
ef20: 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 74 68  ng</i> , <b>with
ef30: 57 6f 72 6c 64 46 69 6c 65 3c 2f 62 3e 20 3c 69  WorldFile</b> <i
ef40: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a  >Integer</i> ) :
ef50: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c   <i>Integer</i><
ef60: 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f  br><br>..<b>RL2_
ef70: 4c 6f 61 64 52 61 73 74 65 72 3c 2f 62 3e 20 28  LoadRaster</b> (
ef80: 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
ef90: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
efa0: 69 3e 20 2c 20 3c 62 3e 73 6f 75 72 63 65 50 61  i> , <b>sourcePa
efb0: 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  th</b> <i>String
efc0: 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 74 68 57 6f  </i> , <b>withWo
efd0: 72 6c 64 46 69 6c 65 3c 2f 62 3e 20 3c 69 3e 49  rldFile</b> <i>I
efe0: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
eff0: 66 6f 72 63 65 53 52 49 44 3c 2f 62 3e 20 3c 69  forceSRID</b> <i
f000: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a  >Integer</i> ) :
f010: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c   <i>Integer</i><
f020: 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f  br><br>..<b>RL2_
f030: 4c 6f 61 64 52 61 73 74 65 72 3c 2f 62 3e 20 28  LoadRaster</b> (
f040: 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
f050: 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
f060: 69 3e 20 2c 20 3c 62 3e 73 6f 75 72 63 65 50 61  i> , <b>sourcePa
f070: 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  th</b> <i>String
f080: 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 74 68 57 6f  </i> , <b>withWo
f090: 72 6c 64 46 69 6c 65 3c 2f 62 3e 20 3c 69 3e 49  rldFile</b> <i>I
f0a0: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
f0b0: 66 6f 72 63 65 53 52 49 44 3c 2f 62 3e 20 3c 69  forceSRID</b> <i
f0c0: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
f0d0: 62 3e 70 79 72 61 6d 69 64 69 7a 65 3c 2f 62 3e  b>pyramidize</b>
f0e0: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
f0f0: 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  ) : <i>Integer</
f100: 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52  i><br><br>..<b>R
f110: 4c 32 5f 4c 6f 61 64 52 61 73 74 65 72 3c 2f 62  L2_LoadRaster</b
f120: 3e 20 28 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e  > ( <b>coverageN
f130: 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ame</b> <i>Strin
f140: 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73 6f 75 72 63  g</i> , <b>sourc
f150: 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72  ePath</b> <i>Str
f160: 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 74  ing</i> , <b>wit
f170: 68 57 6f 72 6c 64 46 69 6c 65 3c 2f 62 3e 20 3c  hWorldFile</b> <
f180: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
f190: 3c 62 3e 66 6f 72 63 65 53 52 49 44 3c 2f 62 3e  <b>forceSRID</b>
f1a0: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
f1b0: 2c 20 3c 62 3e 70 79 72 61 6d 69 64 69 7a 65 3c  , <b>pyramidize<
f1c0: 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
f1d0: 69 3e 2c 20 3c 62 3e 74 72 61 6e 73 61 63 74 69  i>, <b>transacti
f1e0: 6f 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  on</b> <i>Intege
f1f0: 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74  r</i> ) : <i>Int
f200: 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c  eger</i></td>..<
f210: 74 64 3e 57 69 6c 6c 20 61 74 74 65 6d 70 74 20  td>Will attempt 
f220: 74 6f 20 63 72 65 61 74 65 20 61 6e 64 20 70 6f  to create and po
f230: 70 75 6c 61 74 65 20 61 20 6e 65 77 20 53 65 63  pulate a new Sec
f240: 74 69 6f 6e 20 77 69 74 68 69 6e 20 61 20 43 6f  tion within a Co
f250: 76 65 72 61 67 65 20 62 79 20 69 6d 70 6f 72 74  verage by import
f260: 69 6e 67 20 61 6e 20 65 78 74 65 72 6e 61 6c 20  ing an external 
f270: 66 69 6c 65 2d 62 61 73 65 64 20 72 61 73 74 65  file-based raste
f280: 72 20 64 61 74 61 73 6f 75 72 63 65 20 28 6f 66  r datasource (of
f290: 20 74 68 65 20 4a 50 45 47 2c 20 54 49 46 46 2c   the JPEG, TIFF,
f2a0: 20 47 65 6f 54 69 66 66 20 6f 72 20 41 53 43 49   GeoTiff or ASCI
f2b0: 49 20 47 72 69 64 20 74 79 70 65 29 2e 3c 62 72  I Grid type).<br
f2c0: 3e 0d 0a 57 69 6c 6c 20 72 65 74 75 72 6e 20 3c  >..Will return <
f2d0: 62 3e 31 3c 2f 62 3e 20 28 54 52 55 45 2f 53 55  b>1</b> (TRUE/SU
f2e0: 43 43 45 53 53 29 20 6f 72 20 3c 62 3e 30 3c 2f  CCESS) or <b>0</
f2f0: 62 3e 20 28 46 41 4c 53 45 2f 46 41 49 4c 55 52  b> (FALSE/FAILUR
f300: 45 29 3a 20 6f 72 20 3c 62 3e 2d 31 3c 2f 62 3e  E): or <b>-1</b>
f310: 20 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75   on invalid argu
f320: 6d 65 6e 74 73 2e 3c 62 72 3e 0d 0a 3c 75 3e 50  ments.<br>..<u>P
f330: 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20  lease note</u>: 
f340: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 69 66 20 74  ..<ul>..<li>if t
f350: 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75  he optional argu
f360: 6d 65 6e 74 20 3c 62 3e 3c 69 3e 77 69 74 68 57  ment <b><i>withW
f370: 6f 72 6c 64 46 69 6c 65 3c 2f 69 3e 3c 2f 62 3e  orldFile</i></b>
f380: 20 28 65 78 70 65 63 74 65 64 20 74 6f 20 62 65   (expected to be
f390: 20 6f 66 20 74 68 65 20 42 6f 6f 6c 65 61 6e 20   of the Boolean 
f3a0: 74 79 70 65 29 20 69 73 20 73 65 74 20 74 6f 20  type) is set to 
f3b0: 54 52 55 45 2c 20 74 68 65 6e 20 61 20 63 6f 72  TRUE, then a cor
f3c0: 72 65 73 70 6f 6e 64 69 6e 67 20 57 6f 72 6c 64  responding World
f3d0: 46 69 6c 65 20 69 73 20 65 78 70 65 63 74 65 64  File is expected
f3e0: 20 74 6f 20 62 65 20 66 6f 75 6e 64 20 61 6e 64   to be found and
f3f0: 20 77 69 6c 6c 20 62 65 20 75 73 65 64 20 74 6f   will be used to
f400: 20 67 6f 65 72 65 66 65 6e 63 65 20 74 68 65 20   goerefence the 
f410: 72 61 73 74 65 72 2e 3c 2f 6c 69 3e 0d 0a 3c 6c  raster.</li>..<l
f420: 69 3e 69 66 20 74 68 65 20 6f 70 74 69 6f 6e 61  i>if the optiona
f430: 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 3c 69  l argument <b><i
f440: 3e 66 6f 72 63 65 53 52 49 44 3c 2f 69 3e 3c 2f  >forceSRID</i></
f450: 62 3e 20 69 73 20 65 78 70 6c 69 63 69 74 20 73  b> is explicit s
f460: 65 74 2c 20 74 68 61 6e 20 69 74 73 20 76 61 6c  et, than its val
f470: 75 65 20 77 69 6c 6c 20 62 65 20 61 73 73 75 6d  ue will be assum
f480: 65 64 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20  ed to represent 
f490: 74 68 65 20 53 52 49 44 20 64 65 63 6c 61 72 65  the SRID declare
f4a0: 64 20 62 79 20 74 68 65 20 65 78 74 65 72 6e 61  d by the externa
f4b0: 6c 20 64 61 74 61 73 6f 75 72 63 65 2e 3c 62 72  l datasource.<br
f4c0: 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74  >..<u>Please not
f4d0: 65 3c 2f 75 3e 3a 20 64 65 63 6c 61 72 69 6e 67  e</u>: declaring
f4e0: 20 73 6f 6d 65 20 66 6f 72 63 65 53 52 49 44 20   some forceSRID 
f4f0: 76 61 6c 75 65 20 69 73 20 61 62 73 6f 6c 75 74  value is absolut
f500: 65 6c 79 20 72 65 71 75 69 72 65 64 20 66 6f 72  ely required for
f510: 20 61 6e 79 20 4a 50 45 47 2c 20 54 49 46 46 20   any JPEG, TIFF 
f520: 61 6e 64 20 41 53 43 49 49 20 47 72 69 64 20 66  and ASCII Grid f
f530: 69 6c 65 2c 20 62 65 63 61 75 73 65 20 6f 6e 6c  ile, because onl
f540: 79 20 47 65 6f 54 49 46 46 20 63 6f 75 6c 64 20  y GeoTIFF could 
f550: 65 76 65 6e 74 75 61 6c 6c 79 20 64 65 63 6c 61  eventually decla
f560: 72 65 20 73 6f 6d 65 20 53 52 49 44 2e 3c 2f 6c  re some SRID.</l
f570: 69 3e 0d 0a 3c 6c 69 3e 69 66 20 74 68 65 20 6f  i>..<li>if the o
f580: 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74  ptional argument
f590: 20 3c 62 3e 3c 69 3e 70 79 72 61 6d 69 64 69 7a   <b><i>pyramidiz
f5a0: 65 3c 2f 69 3e 3c 2f 62 3e 20 28 65 78 70 65 63  e</i></b> (expec
f5b0: 74 65 64 20 74 6f 20 62 65 20 6f 66 20 74 68 65  ted to be of the
f5c0: 20 42 6f 6f 6c 65 61 6e 20 74 79 70 65 29 20 69   Boolean type) i
f5d0: 73 20 73 65 74 20 74 6f 20 54 52 55 45 2c 20 74  s set to TRUE, t
f5e0: 68 65 6e 20 61 6e 79 20 50 79 72 61 6d 69 64 20  hen any Pyramid 
f5f0: 6c 65 76 65 6c 20 64 69 72 65 63 74 6c 79 20 73  level directly s
f600: 75 70 70 6f 72 74 69 6e 67 20 74 68 65 20 63 75  upporting the cu
f610: 72 72 65 6e 74 20 53 65 63 74 69 6f 6e 20 77 69  rrent Section wi
f620: 6c 6c 20 62 65 20 69 6d 6d 65 64 69 61 74 65 6c  ll be immediatel
f630: 79 20 62 75 69 6c 74 3b 20 6f 74 68 65 72 77 69  y built; otherwi
f640: 73 65 20 50 79 72 61 6d 69 64 20 6c 65 76 65 6c  se Pyramid level
f650: 73 20 77 69 6c 6c 20 62 65 20 69 67 6e 6f 72 65  s will be ignore
f660: 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69 66 20  d.</li>..<li>if 
f670: 74 68 65 20 6c 61 73 74 20 6f 70 74 69 6f 6e 61  the last optiona
f680: 6c 20 61 72 67 75 6d 65 6e 74 20 28 65 78 70 65  l argument (expe
f690: 63 74 65 64 20 74 6f 20 62 65 20 6f 66 20 74 68  cted to be of th
f6a0: 65 20 42 6f 6f 6c 65 61 6e 20 74 79 70 65 29 20  e Boolean type) 
f6b0: 69 73 6e 27 74 20 64 65 63 6c 61 72 65 64 20 61  isn't declared a
f6c0: 6e 20 69 6e 74 65 72 6e 61 6c 20 53 51 4c 20 54  n internal SQL T
f6d0: 72 61 6e 73 61 63 74 69 6f 6e 20 77 69 6c 6c 20  ransaction will 
f6e0: 62 65 20 69 6d 70 6c 69 63 69 74 6c 79 20 68 61  be implicitly ha
f6f0: 6e 64 6c 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75  ndled.</li>..</u
f700: 6c 3e 0d 0a 3c 74 61 62 6c 65 20 77 69 64 74 68  l>..<table width
f710: 3d 22 31 30 30 25 22 20 62 67 63 6f 6c 6f 72 3d  ="100%" bgcolor=
f720: 22 23 66 66 64 30 38 30 22 20 63 65 6c 6c 70 61  "#ffd080" cellpa
f730: 64 64 69 6e 67 3d 22 36 22 3e 3c 74 72 3e 3c 74  dding="6"><tr><t
f740: 64 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f  d>..<u>Please no
f750: 74 65 20 76 65 72 79 20 77 65 6c 6c 3c 2f 75 3e  te very well</u>
f760: 3a 20 74 68 69 73 20 53 51 4c 20 66 75 6e 63 74  : this SQL funct
f770: 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 61 76 61 69  ion is only avai
f780: 6c 61 62 6c 65 20 77 68 65 6e 20 74 68 65 20 65  lable when the e
f790: 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61  nvironment varia
f7a0: 62 6c 65 20 3c 62 3e 53 50 41 54 49 41 4c 49 54  ble <b>SPATIALIT
f7b0: 45 5f 53 45 43 55 52 49 54 59 3d 72 65 6c 61 78  E_SECURITY=relax
f7c0: 65 64 3c 2f 62 3e 20 69 73 20 73 65 74 2e 3c 2f  ed</b> is set.</
f7d0: 74 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e  td></tr></table>
f7e0: 0d 0a 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a  ..</td>..</tr>..
f7f0: 3c 74 72 3e 3c 74 64 3e 3c 62 3e 52 4c 32 5f 4c  <tr><td><b>RL2_L
f800: 6f 61 64 52 61 73 74 65 72 73 46 72 6f 6d 44 69  oadRastersFromDi
f810: 72 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f 76 65 72  r</b> ( <b>cover
f820: 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  ageName</b> <i>S
f830: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 64  tring</i> , <b>d
f840: 69 72 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74  irPath</b> <i>St
f850: 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 65 78  ring</i> , <b>ex
f860: 74 65 6e 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53  tension</b> <i>S
f870: 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69  tring</i> ) : <i
f880: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e  >Integer</i><br>
f890: 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 4c 6f 61  <br>..<b>RL2_Loa
f8a0: 64 52 61 73 74 65 72 73 46 72 6f 6d 44 69 72 3c  dRastersFromDir<
f8b0: 2f 62 3e 20 28 20 3c 62 3e 63 6f 76 65 72 61 67  /b> ( <b>coverag
f8c0: 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  eName</b> <i>Str
f8d0: 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 64 69 72  ing</i> , <b>dir
f8e0: 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Path</b> <i>Stri
f8f0: 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 65 78 74 65  ng</i> , <b>exte
f900: 6e 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53 74 72  nsion</b> <i>Str
f910: 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 74  ing</i> , <b>wit
f920: 68 57 6f 72 6c 64 46 69 6c 65 3c 2f 62 3e 20 3c  hWorldFile</b> <
f930: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20  i>Integer</i> ) 
f940: 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  : <i>Integer</i>
f950: 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32  <br><br>..<b>RL2
f960: 5f 4c 6f 61 64 52 61 73 74 65 72 73 46 72 6f 6d  _LoadRastersFrom
f970: 44 69 72 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f 76  Dir</b> ( <b>cov
f980: 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69  erageName</b> <i
f990: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
f9a0: 3e 64 69 72 50 61 74 68 3c 2f 62 3e 20 3c 69 3e  >dirPath</b> <i>
f9b0: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
f9c0: 65 78 74 65 6e 73 69 6f 6e 3c 2f 62 3e 20 3c 69  extension</b> <i
f9d0: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
f9e0: 3e 77 69 74 68 57 6f 72 6c 64 46 69 6c 65 3c 2f  >withWorldFile</
f9f0: 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
fa00: 3e 20 2c 20 3c 62 3e 66 6f 72 63 65 53 52 49 44  > , <b>forceSRID
fa10: 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
fa20: 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67  /i> ) : <i>Integ
fa30: 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a  er</i><br><br>..
fa40: 3c 62 3e 52 4c 32 5f 4c 6f 61 64 52 61 73 74 65  <b>RL2_LoadRaste
fa50: 72 73 46 72 6f 6d 44 69 72 3c 2f 62 3e 20 28 20  rsFromDir</b> ( 
fa60: 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
fa70: 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
fa80: 3e 20 2c 20 3c 62 3e 64 69 72 50 61 74 68 3c 2f  > , <b>dirPath</
fa90: 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
faa0: 20 2c 20 3c 62 3e 65 78 74 65 6e 73 69 6f 6e 3c   , <b>extension<
fab0: 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
fac0: 3e 20 2c 20 3c 62 3e 77 69 74 68 57 6f 72 6c 64  > , <b>withWorld
fad0: 46 69 6c 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  File</b> <i>Inte
fae0: 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 66 6f 72  ger</i> , <b>for
faf0: 63 65 53 52 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e  ceSRID</b> <i>In
fb00: 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 70  teger</i> , <b>p
fb10: 79 72 61 6d 69 64 69 7a 65 3c 2f 62 3e 20 3c 69  yramidize</b> <i
fb20: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a  >Integer</i> ) :
fb30: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c   <i>Integer</i><
fb40: 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f  br><br>..<b>RL2_
fb50: 4c 6f 61 64 52 61 73 74 65 72 73 46 72 6f 6d 44  LoadRastersFromD
fb60: 69 72 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f 76 65  ir</b> ( <b>cove
fb70: 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e  rageName</b> <i>
fb80: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
fb90: 64 69 72 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53  dirPath</b> <i>S
fba0: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 65  tring</i> , <b>e
fbb0: 78 74 65 6e 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e  xtension</b> <i>
fbc0: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
fbd0: 77 69 74 68 57 6f 72 6c 64 46 69 6c 65 3c 2f 62  withWorldFile</b
fbe0: 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
fbf0: 20 2c 20 3c 62 3e 66 6f 72 63 65 53 52 49 44 3c   , <b>forceSRID<
fc00: 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
fc10: 69 3e 20 2c 20 3c 62 3e 70 79 72 61 6d 69 64 69  i> , <b>pyramidi
fc20: 7a 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ze</b> <i>Intege
fc30: 72 3c 2f 69 3e 2c 20 3c 62 3e 74 72 61 6e 73 61  r</i>, <b>transa
fc40: 63 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74  ction</b> <i>Int
fc50: 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e  eger</i> ) : <i>
fc60: 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e  Integer</i></td>
fc70: 0d 0a 3c 74 64 3e 57 69 6c 6c 20 61 74 74 65 6d  ..<td>Will attem
fc80: 70 74 20 74 6f 20 69 6d 70 6f 72 74 20 61 6c 6c  pt to import all
fc90: 20 65 78 74 65 72 6e 61 6c 20 66 69 6c 65 2d 62   external file-b
fca0: 61 73 65 64 20 72 61 73 74 65 72 20 64 61 74 61  ased raster data
fcb0: 73 6f 75 72 63 65 73 20 28 6f 66 20 74 68 65 20  sources (of the 
fcc0: 4a 50 45 47 2c 20 54 49 46 46 2c 20 47 65 6f 54  JPEG, TIFF, GeoT
fcd0: 69 66 66 20 6f 72 20 41 53 43 49 49 20 47 72 69  iff or ASCII Gri
fce0: 64 20 74 79 70 65 29 20 66 6f 75 6e 64 20 77 69  d type) found wi
fcf0: 74 68 69 6e 20 61 6e 20 65 78 74 65 72 6e 61 6c  thin an external
fd00: 20 64 69 72 65 63 74 6f 72 79 2e 3c 62 72 3e 0d   directory.<br>.
fd10: 0a 46 6f 72 20 65 61 63 68 20 64 61 74 61 73 6f  .For each dataso
fd20: 75 72 63 65 20 62 65 69 6e 67 20 69 6d 70 6f 72  urce being impor
fd30: 74 65 64 20 61 20 63 6f 72 72 65 73 70 6f 6e 64  ted a correspond
fd40: 69 6e 67 20 53 65 63 74 69 6f 6e 20 77 69 6c 6c  ing Section will
fd50: 20 62 65 20 63 72 65 61 74 65 64 20 61 6e 64 20   be created and 
fd60: 70 6f 70 75 6c 61 74 65 64 2e 3c 62 72 3e 0d 0a  populated.<br>..
fd70: 57 69 6c 6c 20 72 65 74 75 72 6e 20 3c 62 3e 31  Will return <b>1
fd80: 3c 2f 62 3e 20 28 54 52 55 45 2f 53 55 43 43 45  </b> (TRUE/SUCCE
fd90: 53 53 29 20 6f 72 20 3c 62 3e 30 3c 2f 62 3e 20  SS) or <b>0</b> 
fda0: 28 46 41 4c 53 45 2f 46 41 49 4c 55 52 45 29 3a  (FALSE/FAILURE):
fdb0: 20 6f 72 20 3c 62 3e 2d 31 3c 2f 62 3e 20 6f 6e   or <b>-1</b> on
fdc0: 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e   invalid argumen
fdd0: 74 73 2e 3c 62 72 3e 0d 0a 3c 75 3e 50 6c 65 61  ts.<br>..<u>Plea
fde0: 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 0d 0a 3c  se note</u>: ..<
fdf0: 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6d 61 6e  ul>..<li>the man
fe00: 64 61 74 6f 72 79 20 3c 62 3e 3c 69 3e 65 78 74  datory <b><i>ext
fe10: 65 6e 73 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 61  ension</i></b> a
fe20: 72 67 75 6d 65 6e 74 20 69 73 20 65 78 70 65 63  rgument is expec
fe30: 74 65 64 20 74 6f 20 73 70 65 63 69 66 79 20 74  ted to specify t
fe40: 68 65 20 3c 75 3e 3c 69 3e 66 69 6c 65 6e 61 6d  he <u><i>filenam
fe50: 65 20 65 78 74 65 6e 73 69 6f 6e 3c 2f 69 3e 3c  e extension</i><
fe60: 2f 75 3e 20 69 64 65 6e 74 69 66 79 69 6e 67 20  /u> identifying 
fe70: 74 68 65 20 66 69 6c 65 73 20 74 6f 20 62 65 20  the files to be 
fe80: 69 6d 70 6f 72 74 65 64 20 28 65 2e 67 2e 20 3c  imported (e.g. <
fe90: 62 3e 2e 74 69 66 3c 2f 62 3e 2c 20 3c 62 3e 2e  b>.tif</b>, <b>.
fea0: 6a 70 67 3c 2f 62 3e 20 6f 72 20 3c 62 3e 2e 61  jpg</b> or <b>.a
feb0: 73 63 3c 2f 62 3e 29 2e 3c 2f 6c 69 3e 0d 0a 3c  sc</b>).</li>..<
fec0: 6c 69 3e 69 66 20 74 68 65 20 6f 70 74 69 6f 6e  li>if the option
fed0: 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 3c  al argument <b><
fee0: 69 3e 77 69 74 68 57 6f 72 6c 64 46 69 6c 65 3c  i>withWorldFile<
fef0: 2f 69 3e 3c 2f 62 3e 20 28 65 78 70 65 63 74 65  /i></b> (expecte
ff00: 64 20 74 6f 20 62 65 20 6f 66 20 74 68 65 20 42  d to be of the B
ff10: 6f 6f 6c 65 61 6e 20 74 79 70 65 29 20 69 73 20  oolean type) is 
ff20: 73 65 74 20 74 6f 20 54 52 55 45 2c 20 74 68 65  set to TRUE, the
ff30: 6e 20 61 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e  n a correspondin
ff40: 67 20 57 6f 72 6c 64 46 69 6c 65 20 69 73 20 65  g WorldFile is e
ff50: 78 70 65 63 74 65 64 20 74 6f 20 62 65 20 66 6f  xpected to be fo
ff60: 75 6e 64 20 61 6e 64 20 77 69 6c 6c 20 62 65 20  und and will be 
ff70: 75 73 65 64 20 74 6f 20 67 6f 65 72 65 66 65 6e  used to goerefen
ff80: 63 65 20 74 68 65 20 72 61 73 74 65 72 2e 3c 2f  ce the raster.</
ff90: 6c 69 3e 0d 0a 3c 6c 69 3e 69 66 20 74 68 65 20  li>..<li>if the 
ffa0: 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e  optional argumen
ffb0: 74 20 3c 62 3e 3c 69 3e 66 6f 72 63 65 53 52 49  t <b><i>forceSRI
ffc0: 44 3c 2f 69 3e 3c 2f 62 3e 20 69 73 20 65 78 70  D</i></b> is exp
ffd0: 6c 69 63 69 74 20 73 65 74 2c 20 74 68 61 6e 20  licit set, than 
ffe0: 69 74 73 20 76 61 6c 75 65 20 77 69 6c 6c 20 62  its value will b
fff0: 65 20 61 73 73 75 6d 65 64 20 74 6f 20 72 65 70  e assumed to rep
10000 72 65 73 65 6e 74 20 74 68 65 20 53 52 49 44 20  resent the SRID 
10010 64 65 63 6c 61 72 65 64 20 62 79 20 74 68 65 20  declared by the 
10020 65 78 74 65 72 6e 61 6c 20 64 61 74 61 73 6f 75  external datasou
10030 72 63 65 2e 3c 62 72 3e 0d 0a 3c 75 3e 50 6c 65  rce.<br>..<u>Ple
10040 61 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 64 65  ase note</u>: de
10050 63 6c 61 72 69 6e 67 20 73 6f 6d 65 20 66 6f 72  claring some for
10060 63 65 53 52 49 44 20 76 61 6c 75 65 20 69 73 20  ceSRID value is 
10070 61 62 73 6f 6c 75 74 65 6c 79 20 72 65 71 75 69  absolutely requi
10080 72 65 64 20 66 6f 72 20 61 6e 79 20 4a 50 45 47  red for any JPEG
10090 2c 20 54 49 46 46 20 61 6e 64 20 41 53 43 49 49  , TIFF and ASCII
100a0 20 47 72 69 64 20 66 69 6c 65 2c 20 62 65 63 61   Grid file, beca
100b0 75 73 65 20 6f 6e 6c 79 20 47 65 6f 54 49 46 46  use only GeoTIFF
100c0 20 63 6f 75 6c 64 20 65 76 65 6e 74 75 61 6c 6c   could eventuall
100d0 79 20 64 65 63 6c 61 72 65 20 73 6f 6d 65 20 53  y declare some S
100e0 52 49 44 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69  RID.</li>..<li>i
100f0 66 20 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61  f the optional a
10100 72 67 75 6d 65 6e 74 20 3c 62 3e 3c 69 3e 70 79  rgument <b><i>py
10110 72 61 6d 69 64 69 7a 65 3c 2f 69 3e 3c 2f 62 3e  ramidize</i></b>
10120 20 28 65 78 70 65 63 74 65 64 20 74 6f 20 62 65   (expected to be
10130 20 6f 66 20 74 68 65 20 42 6f 6f 6c 65 61 6e 20   of the Boolean 
10140 74 79 70 65 29 20 69 73 20 73 65 74 20 74 6f 20  type) is set to 
10150 54 52 55 45 2c 20 74 68 65 6e 20 61 6e 79 20 50  TRUE, then any P
10160 79 72 61 6d 69 64 20 6c 65 76 65 6c 20 64 69 72  yramid level dir
10170 65 63 74 6c 79 20 73 75 70 70 6f 72 74 69 6e 67  ectly supporting
10180 20 74 68 65 20 63 75 72 72 65 6e 74 20 53 65 63   the current Sec
10190 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20 69 6d 6d  tion will be imm
101a0 65 64 69 61 74 65 6c 79 20 62 75 69 6c 74 3b 20  ediately built; 
101b0 6f 74 68 65 72 77 69 73 65 20 50 79 72 61 6d 69  otherwise Pyrami
101c0 64 20 6c 65 76 65 6c 73 20 77 69 6c 6c 20 62 65  d levels will be
101d0 20 69 67 6e 6f 72 65 64 2e 3c 2f 6c 69 3e 0d 0a   ignored.</li>..
101e0 3c 6c 69 3e 69 66 20 74 68 65 20 6c 61 73 74 20  <li>if the last 
101f0 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e  optional argumen
10200 74 20 28 65 78 70 65 63 74 65 64 20 74 6f 20 62  t (expected to b
10210 65 20 6f 66 20 74 68 65 20 42 6f 6f 6c 65 61 6e  e of the Boolean
10220 20 74 79 70 65 29 20 69 73 6e 27 74 20 64 65 63   type) isn't dec
10230 6c 61 72 65 64 20 61 6e 20 69 6e 74 65 72 6e 61  lared an interna
10240 6c 20 53 51 4c 20 54 72 61 6e 73 61 63 74 69 6f  l SQL Transactio
10250 6e 20 77 69 6c 6c 20 62 65 20 69 6d 70 6c 69 63  n will be implic
10260 69 74 6c 79 20 68 61 6e 64 6c 65 64 2e 3c 2f 6c  itly handled.</l
10270 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 74 61 62 6c  i>..</ul>..<tabl
10280 65 20 77 69 64 74 68 3d 22 31 30 30 25 22 20 62  e width="100%" b
10290 67 63 6f 6c 6f 72 3d 22 23 66 66 64 30 38 30 22  gcolor="#ffd080"
102a0 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 36 22   cellpadding="6"
102b0 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 75 3e 50 6c  ><tr><td>..<u>Pl
102c0 65 61 73 65 20 6e 6f 74 65 20 76 65 72 79 20 77  ease note very w
102d0 65 6c 6c 3c 2f 75 3e 3a 20 74 68 69 73 20 53 51  ell</u>: this SQ
102e0 4c 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e  L function is on
102f0 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 77 68 65  ly available whe
10300 6e 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e  n the environmen
10310 74 20 76 61 72 69 61 62 6c 65 20 3c 62 3e 53 50  t variable <b>SP
10320 41 54 49 41 4c 49 54 45 5f 53 45 43 55 52 49 54  ATIALITE_SECURIT
10330 59 3d 72 65 6c 61 78 65 64 3c 2f 62 3e 20 69 73  Y=relaxed</b> is
10340 20 73 65 74 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 3c   set.</td></tr><
10350 2f 74 61 62 6c 65 3e 0d 0a 3c 2f 74 64 3e 0d 0a  /table>..</td>..
10360 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c  </tr>..<tr><td><
10370 62 3e 52 4c 32 5f 4c 6f 61 64 52 61 73 74 65 72  b>RL2_LoadRaster
10380 46 72 6f 6d 57 4d 53 3c 2f 62 3e 20 28 20 3c 62  FromWMS</b> ( <b
10390 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62  >coverageName</b
103a0 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
103b0 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 4e 61 6d 65  , <b>sectionName
103c0 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
103d0 69 3e 20 2c 20 3c 62 3e 67 65 74 4d 61 70 55 72  i> , <b>getMapUr
103e0 6c 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  l</b> <i>String<
103f0 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e  /i> , <b>boundin
10400 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42  gBox</b> <i>BLOB
10410 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20  -Geometry</i> , 
10420 3c 62 3e 77 6d 73 56 65 72 73 69 6f 6e 3c 2f 62  <b>wmsVersion</b
10430 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
10440 2c 20 3c 62 3e 77 6d 73 4c 61 79 65 72 4e 61 6d  , <b>wmsLayerNam
10450 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  e</b> <i>String<
10460 2f 69 3e 20 2c 20 3c 62 3e 77 6d 73 4c 61 79 65  /i> , <b>wmsLaye
10470 72 53 74 79 6c 65 3c 2f 62 3e 20 3c 69 3e 53 74  rStyle</b> <i>St
10480 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 6d  ring</i> , <b>wm
10490 73 49 6d 61 67 65 46 6f 72 6d 61 74 3c 2f 62 3e  sImageFormat</b>
104a0 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
104b0 20 3c 62 3e 77 6d 73 50 69 78 65 6c 52 65 73 6f   <b>wmsPixelReso
104c0 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f  lution</b> <i>Do
104d0 75 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e  uble</i> ) : <i>
104e0 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c  Integer</i><br><
104f0 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 4c 6f 61 64  br>..<b>RL2_Load
10500 52 61 73 74 65 72 46 72 6f 6d 57 4d 53 3c 2f 62  RasterFromWMS</b
10510 3e 20 28 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e  > ( <b>coverageN
10520 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ame</b> <i>Strin
10530 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69  g</i> , <b>secti
10540 6f 6e 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74  onName</b> <i>St
10550 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 67 65  ring</i> , <b>ge
10560 74 4d 61 70 55 72 6c 3c 2f 62 3e 20 3c 69 3e 53  tMapUrl</b> <i>S
10570 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62  tring</i> , <b>b
10580 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c  oundingBox</b> <
10590 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c  i>BLOB-Geometry<
105a0 2f 69 3e 20 2c 20 3c 62 3e 77 6d 73 56 65 72 73  /i> , <b>wmsVers
105b0 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ion</b> <i>Strin
105c0 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 6d 73 4c 61  g</i> , <b>wmsLa
105d0 79 65 72 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  yerName</b> <i>S
105e0 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77  tring</i> , <b>w
105f0 6d 73 4c 61 79 65 72 53 74 79 6c 65 3c 2f 62 3e  msLayerStyle</b>
10600 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
10610 20 3c 62 3e 77 6d 73 49 6d 61 67 65 46 6f 72 6d   <b>wmsImageForm
10620 61 74 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  at</b> <i>String
10630 3c 2f 69 3e 20 2c 20 3c 62 3e 77 6d 73 48 6f 72  </i> , <b>wmsHor
10640 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  zPixelResolution
10650 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f  </b> <i>Double</
10660 69 3e 20 2c 20 3c 62 3e 77 6d 73 56 65 72 74 50  i> , <b>wmsVertP
10670 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
10680 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e  b> <i>Double</i>
10690 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c   ) : <i>Integer<
106a0 2f 69 3e 3c 62 72 3e 3c 62 72 3e 3c 62 3e 52 4c  /i><br><br><b>RL
106b0 32 5f 4c 6f 61 64 52 61 73 74 65 72 46 72 6f 6d  2_LoadRasterFrom
106c0 57 4d 53 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f 76  WMS</b> ( <b>cov
106d0 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69  erageName</b> <i
106e0 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
106f0 3e 73 65 63 74 69 6f 6e 4e 61 6d 65 3c 2f 62 3e  >sectionName</b>
10700 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
10710 20 3c 62 3e 67 65 74 4d 61 70 55 72 6c 3c 2f 62   <b>getMapUrl</b
10720 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
10730 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78  , <b>boundingBox
10740 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f  </b> <i>BLOB-Geo
10750 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 77  metry</i> , <b>w
10760 6d 73 56 65 72 73 69 6f 6e 3c 2f 62 3e 20 3c 69  msVersion</b> <i
10770 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
10780 3e 77 6d 73 4c 61 79 65 72 4e 61 6d 65 3c 2f 62  >wmsLayerName</b
10790 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
107a0 2c 20 3c 62 3e 77 6d 73 4c 61 79 65 72 53 74 79  , <b>wmsLayerSty
107b0 6c 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  le</b> <i>String
107c0 3c 2f 69 3e 20 2c 20 3c 62 3e 77 6d 73 49 6d 61  </i> , <b>wmsIma
107d0 67 65 46 6f 72 6d 61 74 3c 2f 62 3e 20 3c 69 3e  geFormat</b> <i>
107e0 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
107f0 77 6d 73 48 6f 72 7a 50 69 78 65 6c 52 65 73 6f  wmsHorzPixelReso
10800 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f  lution</b> <i>Do
10810 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 77 6d  uble</i> , <b>wm
10820 73 56 65 72 74 50 69 78 65 6c 52 65 73 6f 6c 75  sVertPixelResolu
10830 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62  tion</b> <i>Doub
10840 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 6f 70 61 71  le</i> , <b>opaq
10850 75 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ue</b> <i>Intege
10860 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74  r</i> ) : <i>Int
10870 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e  eger</i><br><br>
10880 0d 0a 3c 62 3e 52 4c 32 5f 4c 6f 61 64 52 61 73  ..<b>RL2_LoadRas
10890 74 65 72 46 72 6f 6d 57 4d 53 3c 2f 62 3e 20 28  terFromWMS</b> (
108a0 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
108b0 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
108c0 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 4e  i> , <b>sectionN
108d0 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ame</b> <i>Strin
108e0 67 3c 2f 69 3e 20 2c 20 3c 62 3e 67 65 74 4d 61  g</i> , <b>getMa
108f0 70 55 72 6c 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  pUrl</b> <i>Stri
10900 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e  ng</i> , <b>boun
10910 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42  dingBox</b> <i>B
10920 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e  LOB-Geometry</i>
10930 20 2c 20 3c 62 3e 77 6d 73 56 65 72 73 69 6f 6e   , <b>wmsVersion
10940 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
10950 69 3e 20 2c 20 3c 62 3e 77 6d 73 4c 61 79 65 72  i> , <b>wmsLayer
10960 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Name</b> <i>Stri
10970 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 6d 73 4c  ng</i> , <b>wmsL
10980 61 79 65 72 53 74 79 6c 65 3c 2f 62 3e 20 3c 69  ayerStyle</b> <i
10990 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
109a0 3e 77 6d 73 49 6d 61 67 65 46 6f 72 6d 61 74 3c  >wmsImageFormat<
109b0 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
109c0 3e 20 2c 20 3c 62 3e 77 6d 73 48 6f 72 7a 50 69  > , <b>wmsHorzPi
109d0 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62  xelResolution</b
109e0 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20  > <i>Double</i> 
109f0 2c 20 3c 62 3e 77 6d 73 56 65 72 74 50 69 78 65  , <b>wmsVertPixe
10a00 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20  lResolution</b> 
10a10 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20  <i>Double</i> , 
10a20 3c 62 3e 6f 70 61 71 75 65 3c 2f 62 3e 20 3c 69  <b>opaque</b> <i
10a30 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
10a40 62 3e 73 77 61 70 58 59 3c 2f 62 3e 20 3c 69 3e  b>swapXY</b> <i>
10a50 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20  Integer</i> ) : 
10a60 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62  <i>Integer</i><b
10a70 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 4c  r><br>..<b>RL2_L
10a80 6f 61 64 52 61 73 74 65 72 46 72 6f 6d 57 4d 53  oadRasterFromWMS
10a90 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f 76 65 72 61  </b> ( <b>covera
10aa0 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74  geName</b> <i>St
10ab0 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65  ring</i> , <b>se
10ac0 63 74 69 6f 6e 4e 61 6d 65 3c 2f 62 3e 20 3c 69  ctionName</b> <i
10ad0 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
10ae0 3e 67 65 74 4d 61 70 55 72 6c 3c 2f 62 3e 20 3c  >getMapUrl</b> <
10af0 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
10b00 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62  b>boundingBox</b
10b10 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74  > <i>BLOB-Geomet
10b20 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 77 6d 73 56  ry</i> , <b>wmsV
10b30 65 72 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53 74  ersion</b> <i>St
10b40 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 6d  ring</i> , <b>wm
10b50 73 4c 61 79 65 72 4e 61 6d 65 3c 2f 62 3e 20 3c  sLayerName</b> <
10b60 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
10b70 62 3e 77 6d 73 4c 61 79 65 72 53 74 79 6c 65 3c  b>wmsLayerStyle<
10b80 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
10b90 3e 20 2c 20 3c 62 3e 77 6d 73 49 6d 61 67 65 46  > , <b>wmsImageF
10ba0 6f 72 6d 61 74 3c 2f 62 3e 20 3c 69 3e 53 74 72  ormat</b> <i>Str
10bb0 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 6d 73  ing</i> , <b>wms
10bc0 48 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74  HorzPixelResolut
10bd0 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c  ion</b> <i>Doubl
10be0 65 3c 2f 69 3e 20 2c 20 3c 62 3e 77 6d 73 56 65  e</i> , <b>wmsVe
10bf0 72 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rtPixelResolutio
10c00 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c  n</b> <i>Double<
10c10 2f 69 3e 20 2c 20 3c 62 3e 6f 70 61 71 75 65 3c  /i> , <b>opaque<
10c20 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
10c30 69 3e 20 2c 20 3c 62 3e 73 77 61 70 58 59 3c 2f  i> , <b>swapXY</
10c40 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
10c50 3e 20 2c 20 3c 62 3e 70 72 6f 78 79 3c 2f 62 3e  > , <b>proxy</b>
10c60 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29   <i>String</i> )
10c70 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69   : <i>Integer</i
10c80 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c  ><br><br>..<b>RL
10c90 32 5f 4c 6f 61 64 52 61 73 74 65 72 46 72 6f 6d  2_LoadRasterFrom
10ca0 57 4d 53 3c 2f 62 3e 20 28 20 3c 62 3e 63 6f 76  WMS</b> ( <b>cov
10cb0 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69  erageName</b> <i
10cc0 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
10cd0 3e 73 65 63 74 69 6f 6e 4e 61 6d 65 3c 2f 62 3e  >sectionName</b>
10ce0 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
10cf0 20 3c 62 3e 67 65 74 4d 61 70 55 72 6c 3c 2f 62   <b>getMapUrl</b
10d00 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
10d10 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78  , <b>boundingBox
10d20 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f  </b> <i>BLOB-Geo
10d30 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 77  metry</i> , <b>w
10d40 6d 73 56 65 72 73 69 6f 6e 3c 2f 62 3e 20 3c 69  msVersion</b> <i
10d50 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
10d60 3e 77 6d 73 4c 61 79 65 72 4e 61 6d 65 3c 2f 62  >wmsLayerName</b
10d70 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
10d80 2c 20 3c 62 3e 77 6d 73 4c 61 79 65 72 53 74 79  , <b>wmsLayerSty
10d90 6c 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  le</b> <i>String
10da0 3c 2f 69 3e 20 2c 20 3c 62 3e 77 6d 73 49 6d 61  </i> , <b>wmsIma
10db0 67 65 46 6f 72 6d 61 74 3c 2f 62 3e 20 3c 69 3e  geFormat</b> <i>
10dc0 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
10dd0 77 6d 73 48 6f 72 7a 50 69 78 65 6c 52 65 73 6f  wmsHorzPixelReso
10de0 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f  lution</b> <i>Do
10df0 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 77 6d  uble</i> , <b>wm
10e00 73 56 65 72 74 50 69 78 65 6c 52 65 73 6f 6c 75  sVertPixelResolu
10e10 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62  tion</b> <i>Doub
10e20 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 6f 70 61 71  le</i> , <b>opaq
10e30 75 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ue</b> <i>Intege
10e40 72 3c 2f 69 3e 20 2c 20 3c 62 3e 73 77 61 70 58  r</i> , <b>swapX
10e50 59 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  Y</b> <i>Integer
10e60 3c 2f 69 3e 20 2c 20 3c 62 3e 70 72 6f 78 79 3c  </i> , <b>proxy<
10e70 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
10e80 3e 20 2c 20 3c 62 3e 74 72 61 6e 73 61 63 74 69  > , <b>transacti
10e90 6f 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  on</b> <i>Intege
10ea0 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74  r</i> ) : <i>Int
10eb0 65 67 65 72 3c 2f 69 3e 0d 0a 3c 2f 74 64 3e 0d  eger</i>..</td>.
10ec0 0a 3c 74 64 3e 57 69 6c 6c 20 61 74 74 65 6d 70  .<td>Will attemp
10ed0 74 20 74 6f 20 63 72 65 61 74 65 20 61 6e 64 20  t to create and 
10ee0 70 6f 70 75 6c 61 74 65 20 61 20 6e 65 77 20 53  populate a new S
10ef0 65 63 74 69 6f 6e 20 77 69 74 68 69 6e 20 61 20  ection within a 
10f00 43 6f 76 65 72 61 67 65 20 62 79 20 69 6d 70 6f  Coverage by impo
10f10 72 74 69 6e 67 20 72 61 73 74 65 72 20 64 61 74  rting raster dat
10f20 61 20 66 72 6f 6d 20 61 6e 20 65 78 74 65 72 6e  a from an extern
10f30 61 6c 20 57 4d 53 20 64 61 74 61 73 6f 75 72 63  al WMS datasourc
10f40 65 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72 65 74  e.<br>..Will ret
10f50 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28 54 52  urn <b>1</b> (TR
10f60 55 45 2f 53 55 43 43 45 53 53 29 20 6f 72 20 3c  UE/SUCCESS) or <
10f70 62 3e 30 3c 2f 62 3e 20 28 46 41 4c 53 45 2f 46  b>0</b> (FALSE/F
10f80 41 49 4c 55 52 45 29 3a 20 6f 72 20 3c 62 3e 2d  AILURE): or <b>-
10f90 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69 64  1</b> on invalid
10fa0 20 61 72 67 75 6d 65 6e 74 73 2e 3c 62 72 3e 0d   arguments.<br>.
10fb0 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c  .<u>Please note<
10fc0 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69  /u>: ..<ul>..<li
10fd0 3e 74 68 65 20 3c 62 3e 3c 69 3e 67 65 74 4d 61  >the <b><i>getMa
10fe0 70 55 52 4c 3c 2f 69 3e 3c 2f 62 3e 20 69 73 20  pURL</i></b> is 
10ff0 65 78 70 65 63 74 65 64 20 74 6f 20 72 65 70 72  expected to repr
11000 65 73 65 6e 74 20 74 68 65 20 62 61 73 65 2d 55  esent the base-U
11010 52 4c 20 66 6f 72 20 61 6c 6c 20 74 69 6c 65 64  RL for all tiled
11020 20 57 4d 53 20 47 65 74 4d 61 70 20 72 65 71 75   WMS GetMap requ
11030 65 73 74 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  ests.</li>..<li>
11040 74 68 65 20 3c 62 3e 3c 69 3e 62 6f 75 6e 64 69  the <b><i>boundi
11050 6e 67 42 6f 78 3c 2f 69 3e 3c 2f 62 3e 20 69 73  ngBox</i></b> is
11060 20 65 78 70 65 63 74 65 64 20 74 6f 20 72 65 70   expected to rep
11070 72 65 73 65 6e 74 20 74 68 65 20 6f 76 65 72 61  resent the overa
11080 6c 6c 20 65 78 74 65 6e 74 20 6f 66 20 74 68 65  ll extent of the
11090 20 53 65 63 74 69 6f 6e 3b 20 79 6f 75 20 63 6f   Section; you co
110a0 75 6c 64 20 65 76 65 6e 74 75 61 6c 6c 79 20 70  uld eventually p
110b0 61 73 73 20 61 6e 79 20 61 72 62 69 74 72 61 72  ass any arbitrar
110c0 79 20 6b 69 6e 64 20 6f 66 20 47 65 6f 6d 65 74  y kind of Geomet
110d0 72 79 2c 20 61 6e 64 20 74 68 65 20 42 6f 75 6e  ry, and the Boun
110e0 64 69 6e 67 20 42 6f 78 20 61 6b 61 20 4d 42 52  ding Box aka MBR
110f0 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74   will be automat
11100 69 63 61 6c 6c 79 20 64 65 74 65 72 6d 69 6e 65  ically determine
11110 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65  d.</li>..<li>the
11120 20 3c 62 3e 3c 69 3e 77 6d 73 56 65 72 73 69 6f   <b><i>wmsVersio
11130 6e 3c 2f 69 3e 3c 2f 62 3e 2c 20 3c 62 3e 3c 69  n</i></b>, <b><i
11140 3e 77 6d 73 4c 61 79 65 72 4e 61 6d 65 3c 2f 69  >wmsLayerName</i
11150 3e 3c 2f 62 3e 2c 20 3c 62 3e 3c 69 3e 77 6d 73  ></b>, <b><i>wms
11160 4c 61 79 65 72 53 74 79 6c 65 3c 2f 69 3e 3c 2f  LayerStyle</i></
11170 62 3e 2c 20 3c 62 3e 3c 69 3e 77 6d 73 49 6d 61  b>, <b><i>wmsIma
11180 67 65 46 6f 72 6d 61 74 3c 2f 69 3e 3c 2f 62 3e  geFormat</i></b>
11190 20 61 6e 64 20 3c 62 3e 3c 69 3e 6f 70 61 71 75   and <b><i>opaqu
111a0 65 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67 75 6d 65  e</i></b> argume
111b0 6e 74 73 20 63 6f 72 72 65 73 70 6f 6e 64 73 20  nts corresponds 
111c0 74 6f 20 74 68 65 20 65 71 75 69 76 61 6c 65 6e  to the equivalen
111d0 74 20 65 6c 65 6d 65 6e 74 73 20 72 65 71 75 69  t elements requi
111e0 72 65 64 20 69 6e 20 6f 72 64 65 72 20 74 6f 20  red in order to 
111f0 64 79 6e 61 6d 69 63 61 6c 6c 79 20 63 6f 6d 70  dynamically comp
11200 6f 73 65 20 61 6c 6c 20 57 4d 53 20 47 65 74 4d  ose all WMS GetM
11210 61 70 20 72 65 71 75 65 73 74 73 2e 3c 2f 6c 69  ap requests.</li
11220 3e 0d 0a 3c 6c 69 3e 61 20 73 69 6e 67 6c 65 20  >..<li>a single 
11230 57 4d 53 20 47 65 74 4d 61 70 20 72 65 71 75 65  WMS GetMap reque
11240 73 74 20 77 69 6c 6c 20 62 65 20 69 73 73 75 65  st will be issue
11250 64 20 66 6f 72 20 65 61 63 68 20 74 69 6c 65 20  d for each tile 
11260 72 65 71 75 69 72 65 64 20 62 79 20 74 68 65 20  required by the 
11270 53 65 63 74 69 6f 6e 3b 20 74 68 65 20 42 6f 75  Section; the Bou
11280 6e 64 69 6e 67 42 6f 78 20 6f 66 20 65 61 63 68  ndingBox of each
11290 20 69 6e 64 69 76 69 64 75 61 6c 20 74 69 6c 65   individual tile
112a0 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74   will be automat
112b0 69 63 61 6c 6c 79 20 64 65 74 65 72 6d 69 6e 65  ically determine
112c0 64 20 66 72 6f 6d 20 74 68 65 20 6f 76 65 72 61  d from the overa
112d0 6c 6c 20 53 65 63 74 69 6f 6e 27 73 20 42 6f 75  ll Section's Bou
112e0 6e 64 69 6e 67 42 6f 78 20 61 6e 64 20 74 68 65  ndingBox and the
112f0 20 3c 62 3e 3c 69 3e 77 6d 73 48 6f 72 7a 50 69   <b><i>wmsHorzPi
11300 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 69  xelResolution</i
11310 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e  ></b> and <b><i>
11320 77 6d 73 56 65 72 74 50 69 78 65 6c 52 65 73 6f  wmsVertPixelReso
11330 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 61  lution</i></b> a
11340 72 67 75 6d 65 6e 74 73 2e 3c 2f 6c 69 3e 0d 0a  rguments.</li>..
11350 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c  <li>the optional
11360 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 3c 69 3e   argument <b><i>
11370 73 77 61 70 58 59 3c 2f 69 3e 3c 2f 62 3e 20 63  swapXY</i></b> c
11380 6f 75 6c 64 20 62 65 20 6e 65 63 65 73 73 61 72  ould be necessar
11390 79 20 73 6f 6d 65 74 69 6d 65 73 20 69 6e 20 6f  y sometimes in o
113a0 72 64 65 72 20 74 6f 20 69 6e 76 65 72 74 20 74  rder to invert t
113b0 68 65 20 64 65 66 61 75 6c 74 20 57 4d 53 20 61  he default WMS a
113c0 78 65 73 20 6f 72 64 65 72 2e 3c 2f 6c 69 3e 0d  xes order.</li>.
113d0 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61  .<li>the optiona
113e0 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 3c 69  l argument <b><i
113f0 3e 70 72 6f 78 79 3c 2f 69 3e 3c 2f 62 3e 20 63  >proxy</i></b> c
11400 6f 75 6c 64 20 62 65 20 6e 65 63 65 73 73 61 72  ould be necessar
11410 79 20 73 6f 6d 65 74 69 6d 65 73 20 77 68 65 6e  y sometimes when
11420 20 61 63 63 65 73 73 69 6e 67 20 74 68 65 20 57   accessing the W
11430 45 42 20 66 72 6f 6d 20 62 65 68 69 6e 64 20 61  EB from behind a
11440 20 66 69 72 65 77 61 6c 6c 65 64 20 6e 65 74 77   firewalled netw
11450 6f 72 6b 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69  ork.</li>..<li>i
11460 66 20 74 68 65 20 6c 61 73 74 20 6f 70 74 69 6f  f the last optio
11470 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 28 65 78  nal argument (ex
11480 70 65 63 74 65 64 20 74 6f 20 62 65 20 6f 66 20  pected to be of 
11490 74 68 65 20 42 6f 6f 6c 65 61 6e 20 74 79 70 65  the Boolean type
114a0 29 20 69 73 6e 27 74 20 64 65 63 6c 61 72 65 64  ) isn't declared
114b0 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 53 51 4c   an internal SQL
114c0 20 54 72 61 6e 73 61 63 74 69 6f 6e 20 77 69 6c   Transaction wil
114d0 6c 20 62 65 20 69 6d 70 6c 69 63 69 74 6c 79 20  l be implicitly 
114e0 68 61 6e 64 6c 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c  handled.</li>..<
114f0 2f 75 6c 3e 0d 0a 3c 74 61 62 6c 65 20 77 69 64  /ul>..<table wid
11500 74 68 3d 22 31 30 30 25 22 20 62 67 63 6f 6c 6f  th="100%" bgcolo
11510 72 3d 22 23 66 66 64 30 38 30 22 20 63 65 6c 6c  r="#ffd080" cell
11520 70 61 64 64 69 6e 67 3d 22 36 22 3e 3c 74 72 3e  padding="6"><tr>
11530 3c 74 64 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20  <td>..<u>Please 
11540 6e 6f 74 65 20 76 65 72 79 20 77 65 6c 6c 3c 2f  note very well</
11550 75 3e 3a 20 74 68 69 73 20 53 51 4c 20 66 75 6e  u>: this SQL fun
11560 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 61 76  ction is only av
11570 61 69 6c 61 62 6c 65 20 77 68 65 6e 20 74 68 65  ailable when the
11580 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72   environment var
11590 69 61 62 6c 65 20 3c 62 3e 53 50 41 54 49 41 4c  iable <b>SPATIAL
115a0 49 54 45 5f 53 45 43 55 52 49 54 59 3d 72 65 6c  ITE_SECURITY=rel
115b0 61 78 65 64 3c 2f 62 3e 20 69 73 20 73 65 74 2e  axed</b> is set.
115c0 3c 2f 74 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c  </td></tr></tabl
115d0 65 3e 0d 0a 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e  e>..</td>..</tr>
115e0 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a  ..</table><br>..
115f0 3c 68 72 3e 0d 0a 3c 68 32 3e 53 51 4c 20 66 75  <hr>..<h2>SQL fu
11600 6e 63 74 69 6f 6e 73 20 65 78 70 6f 72 74 69 6e  nctions exportin
11610 67 20 72 61 77 20 72 61 73 74 65 72 20 64 61 74  g raw raster dat
11620 61 20 74 6f 20 65 78 74 65 72 6e 61 6c 20 66 69  a to external fi
11630 6c 65 73 20 28 43 6f 76 65 72 61 67 65 20 6f 72  les (Coverage or
11640 69 65 6e 74 65 64 29 3c 2f 68 32 3e 20 0d 0a 3c  iented)</h2> ..<
11650 74 61 62 6c 65 20 77 69 64 74 68 3d 22 31 30 30  table width="100
11660 25 22 20 62 6f 72 64 65 72 3d 22 31 22 20 62 67  %" border="1" bg
11670 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 30 22 20  color="#ffffe0" 
11680 63 65 6c 6c 65 73 70 61 63 69 6e 67 3d 22 34 22  cellespacing="4"
11690 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 36 22   cellpadding="6"
116a0 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 67 63 6f 6c  >..<tr><th bgcol
116b0 6f 72 3d 22 23 65 30 65 30 65 30 22 20 77 69 64  or="#e0e0e0" wid
116c0 74 68 3d 22 35 30 25 22 3e 53 79 6e 74 61 78 3c  th="50%">Syntax<
116d0 2f 74 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d  /th><th bgcolor=
116e0 22 23 65 30 65 30 65 30 22 20 77 69 64 74 68 3d  "#e0e0e0" width=
116f0 22 35 30 25 22 3e 53 75 6d 6d 61 72 79 3c 2f 74  "50%">Summary</t
11700 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64  h></tr>..<tr><td
11710 3e 3c 62 3e 52 4c 32 5f 57 72 69 74 65 47 65 6f  ><b>RL2_WriteGeo
11720 54 69 66 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62  Tiff</b> ( <b>db
11730 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74  Prefix</b> <i>St
11740 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f  ring</i> , <b>co
11750 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c  verageName</b> <
11760 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
11770 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c  b>filePath</b> <
11780 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
11790 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49  b>width</b> <i>I
117a0 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
117b0 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e  height</b> <i>In
117c0 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
117d0 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c  oundingBox</b> <
117e0 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c  i>BLOB-Geometry<
117f0 2f 69 3e 20 2c 20 3c 62 3e 70 69 78 65 6c 52 65  /i> , <b>pixelRe
11800 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e  solution</b> <i>
11810 44 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c  Double</i> ) : <
11820 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72  i>Integer</i><br
11830 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72  ><br>..<b>RL2_Wr
11840 69 74 65 47 65 6f 54 69 66 66 3c 2f 62 3e 20 28  iteGeoTiff</b> (
11850 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e   <b>dbPrefix</b>
11860 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
11870 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
11880 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
11890 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68  i> , <b>filePath
118a0 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
118b0 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62  i> , <b>width</b
118c0 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
118d0 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e   , <b>height</b>
118e0 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
118f0 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78  , <b>boundingBox
11900 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f  </b> <i>BLOB-Geo
11910 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68  metry</i> , <b>h
11920 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69  orzPixelResoluti
11930 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65  on</b> <i>Double
11940 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69  </i> , <b>vertPi
11950 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62  xelResolution</b
11960 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20  > <i>Double</i> 
11970 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  ) : <i>Integer</
11980 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52  i><br><br>..<b>R
11990 4c 32 5f 57 72 69 74 65 47 65 6f 54 69 66 66 3c  L2_WriteGeoTiff<
119a0 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69  /b> ( <b>dbPrefi
119b0 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  x</b> <i>String<
119c0 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67  /i> , <b>coverag
119d0 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  eName</b> <i>Str
119e0 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c  ing</i> , <b>fil
119f0 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72  ePath</b> <i>Str
11a00 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64  ing</i> , <b>wid
11a10 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  th</b> <i>Intege
11a20 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68  r</i> , <b>heigh
11a30 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  t</b> <i>Integer
11a40 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69  </i> , <b>boundi
11a50 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f  ngBox</b> <i>BLO
11a60 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c  B-Geometry</i> ,
11a70 20 3c 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73   <b>horzPixelRes
11a80 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44  olution</b> <i>D
11a90 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76  ouble</i> , <b>v
11aa0 65 72 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69  ertPixelResoluti
11ab0 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65  on</b> <i>Double
11ac0 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 74 68 57 6f  </i> , <b>withWo
11ad0 6c 64 46 69 6c 65 3c 2f 62 3e 20 3c 69 3e 49 6e  ldFile</b> <i>In
11ae0 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69  teger</i> ) : <i
11af0 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e  >Integer</i><br>
11b00 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69  <br>..<b>RL2_Wri
11b10 74 65 47 65 6f 54 69 66 66 3c 2f 62 3e 20 28 20  teGeoTiff</b> ( 
11b20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20  <b>dbPrefix</b> 
11b30 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
11b40 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
11b50 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
11b60 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c  > , <b>filePath<
11b70 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
11b80 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e  > , <b>width</b>
11b90 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
11ba0 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20  , <b>height</b> 
11bb0 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
11bc0 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c   <b>boundingBox<
11bd0 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d  /b> <i>BLOB-Geom
11be0 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f  etry</i> , <b>ho
11bf0 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rzPixelResolutio
11c00 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c  n</b> <i>Double<
11c10 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69 78  /i> , <b>vertPix
11c20 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e  elResolution</b>
11c30 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c   <i>Double</i> ,
11c40 20 3c 62 3e 77 69 74 68 57 6f 6c 64 46 69 6c 65   <b>withWoldFile
11c50 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
11c60 2f 69 3e 20 2c 20 3c 62 3e 74 69 66 66 43 6f 6d  /i> , <b>tiffCom
11c70 70 72 65 73 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e  pression</b> <i>
11c80 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c  String</i> ) : <
11c90 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72  i>Integer</i><br
11ca0 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72  ><br>..<b>RL2_Wr
11cb0 69 74 65 47 65 6f 54 69 66 66 3c 2f 62 3e 20 28  iteGeoTiff</b> (
11cc0 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e   <b>dbPrefix</b>
11cd0 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
11ce0 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
11cf0 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
11d00 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68  i> , <b>filePath
11d10 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
11d20 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62  i> , <b>width</b
11d30 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
11d40 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e   , <b>height</b>
11d50 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
11d60 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78  , <b>boundingBox
11d70 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f  </b> <i>BLOB-Geo
11d80 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68  metry</i> , <b>h
11d90 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69  orzPixelResoluti
11da0 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65  on</b> <i>Double
11db0 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69  </i> , <b>vertPi
11dc0 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62  xelResolution</b
11dd0 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20  > <i>Double</i> 
11de0 2c 20 3c 62 3e 77 69 74 68 57 6f 6c 64 46 69 6c  , <b>withWoldFil
11df0 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  e</b> <i>Integer
11e00 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 66 66 43 6f  </i> , <b>tiffCo
11e10 6d 70 72 65 73 73 69 6f 6e 3c 2f 62 3e 20 3c 69  mpression</b> <i
11e20 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
11e30 3e 74 69 66 66 54 69 6c 65 53 69 7a 65 3c 2f 62  >tiffTileSize</b
11e40 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
11e50 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c   ) : <i>Integer<
11e60 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69  /i></td>..<td>Wi
11e70 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f 20 65 78  ll attempt to ex
11e80 70 6f 72 74 20 72 61 77 20 72 61 73 74 65 72 20  port raw raster 
11e90 64 61 74 61 20 66 72 6f 6d 20 61 20 43 6f 76 65  data from a Cove
11ea0 72 61 67 65 20 69 6e 74 6f 20 61 6e 20 65 78 74  rage into an ext
11eb0 65 72 6e 61 6c 20 47 65 6f 54 49 46 46 20 66 69  ernal GeoTIFF fi
11ec0 6c 65 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72 65  le.<br>..Will re
11ed0 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28 54  turn <b>1</b> (T
11ee0 52 55 45 2f 53 55 43 43 45 53 53 29 20 6f 72 20  RUE/SUCCESS) or 
11ef0 3c 62 3e 30 3c 2f 62 3e 20 28 46 41 4c 53 45 2f  <b>0</b> (FALSE/
11f00 46 41 49 4c 55 52 45 29 3a 20 6f 72 20 3c 62 3e  FAILURE): or <b>
11f10 2d 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69  -1</b> on invali
11f20 64 20 61 72 67 75 6d 65 6e 74 73 2e 3c 62 72 3e  d arguments.<br>
11f30 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65  ..<u>Please note
11f40 3c 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c 6c  </u>: ..<ul>..<l
11f50 69 3e 54 68 65 20 3c 62 3e 3c 69 3e 64 62 50 72  i>The <b><i>dbPr
11f60 65 66 69 78 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67  efix</i></b> arg
11f70 75 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e 64 65  ument is intende
11f80 64 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65  d to specify the
11f90 20 41 54 54 41 43 48 45 44 2d 44 42 20 77 68 65   ATTACHED-DB whe
11fa0 72 65 20 74 68 65 20 43 6f 76 65 72 61 67 65 20  re the Coverage 
11fb0 69 73 20 65 78 70 65 63 74 65 64 20 74 6f 20 62  is expected to b
11fc0 65 20 66 6f 75 6e 64 3b 20 69 74 20 63 6f 75 6c  e found; it coul
11fd0 64 20 62 65 20 65 76 65 6e 74 75 61 6c 6c 79 20  d be eventually 
11fe0 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64  <b>NULL</b>, and
11ff0 20 69 6e 20 74 68 69 73 20 63 61 73 65 20 74 68   in this case th
12000 65 20 3c 62 3e 4d 41 49 4e 20 44 42 3c 2f 62 3e  e <b>MAIN DB</b>
12010 20 77 69 6c 6c 20 69 6d 70 6c 69 63 69 74 6c 79   will implicitly
12020 20 62 65 20 61 73 73 75 6d 65 64 2e 3c 2f 6c 69   be assumed.</li
12030 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69  >..<li>the <b><i
12040 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 69 3e  >boundingBox</i>
12050 3c 2f 62 3e 20 69 73 20 65 78 70 65 63 74 65 64  </b> is expected
12060 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20 74 68   to represent th
12070 65 20 6f 76 65 72 61 6c 6c 20 65 78 74 65 6e 74  e overall extent
12080 20 6f 66 20 74 68 65 20 65 78 70 6f 72 74 65 64   of the exported
12090 20 47 65 6f 54 49 46 46 3b 20 79 6f 75 20 63 6f   GeoTIFF; you co
120a0 75 6c 64 20 65 76 65 6e 74 75 61 6c 6c 79 20 70  uld eventually p
120b0 61 73 73 20 61 6e 79 20 61 72 62 69 74 72 61 72  ass any arbitrar
120c0 79 20 6b 69 6e 64 20 6f 66 20 47 65 6f 6d 65 74  y kind of Geomet
120d0 72 79 2c 20 61 6e 64 20 74 68 65 20 42 6f 75 6e  ry, and the Boun
120e0 64 69 6e 67 20 42 6f 78 20 61 6b 61 20 4d 42 52  ding Box aka MBR
120f0 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74   will be automat
12100 69 63 61 6c 6c 79 20 64 65 74 65 72 6d 69 6e 65  ically determine
12110 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65  d.</li>..<li>the
12120 20 3c 62 3e 3c 69 3e 68 6f 72 7a 50 69 78 65 6c   <b><i>horzPixel
12130 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f  Resolution</i></
12140 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e 76 65 72  b> and <b><i>ver
12150 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  tPixelResolution
12160 3c 2f 69 3e 3c 2f 62 3e 20 6d 75 73 74 20 65 78  </i></b> must ex
12170 61 63 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20  actly match the 
12180 43 6f 76 65 72 61 67 65 27 73 20 62 61 73 65 20  Coverage's base 
12190 72 65 73 6f 6c 75 74 69 6f 6e 20 6f 72 20 6f 6e  resolution or on
121a0 65 20 6f 66 20 74 68 65 20 72 65 73 6f 6c 75 74  e of the resolut
121b0 69 6f 6e 73 20 6d 61 64 65 20 61 76 61 69 6c 61  ions made availa
121c0 62 6c 65 20 62 79 20 74 68 65 20 63 6f 72 72 65  ble by the corre
121d0 73 70 6f 6e 64 69 6e 67 20 50 79 72 61 6d 69 64  sponding Pyramid
121e0 20 6c 65 76 65 6c 73 2e 3c 2f 6c 69 3e 0d 0a 3c   levels.</li>..<
121f0 6c 69 3e 61 6e 64 20 74 68 65 20 42 6f 75 6e 64  li>and the Bound
12200 69 6e 67 42 6f 78 20 6d 75 73 74 20 65 78 61 63  ingBox must exac
12210 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20 54 49  tly match the TI
12220 46 46 20 3c 62 3e 3c 69 3e 77 69 64 74 68 3c 2f  FF <b><i>width</
12230 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69  i></b> and <b><i
12240 3e 68 65 69 67 68 74 3c 2f 69 3e 3c 2f 62 3e 20  >height</i></b> 
12250 64 69 6d 65 6e 73 69 6f 6e 73 20 61 74 20 74 68  dimensions at th
12260 61 74 20 72 65 73 6f 6c 75 74 69 6f 6e 2e 3c 2f  at resolution.</
12270 6c 69 3e 0d 0a 3c 6c 69 3e 69 66 20 74 68 65 20  li>..<li>if the 
12280 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e  optional argumen
12290 74 20 3c 62 3e 3c 69 3e 77 69 74 68 57 6f 72 6c  t <b><i>withWorl
122a0 64 46 69 6c 65 3c 2f 69 3e 3c 2f 62 3e 20 69 73  dFile</i></b> is
122b0 20 73 65 74 20 74 6f 20 54 52 55 45 20 74 68 65   set to TRUE the
122c0 6e 20 61 6e 20 61 75 78 69 6c 69 61 72 79 20 57  n an auxiliary W
122d0 6f 72 6c 64 46 69 6c 65 20 77 69 6c 6c 20 62 65  orldFile will be
122e0 20 65 78 70 6f 72 74 65 64 20 61 73 20 77 65 6c   exported as wel
122f0 6c 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65  l.</li>..<li>the
12300 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65   optional argume
12310 6e 74 20 3c 62 3e 3c 69 3e 74 69 66 66 43 6f 6d  nt <b><i>tiffCom
12320 70 72 65 73 73 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e  pression</i></b>
12330 20 63 6f 75 6c 64 20 62 65 20 6f 6e 65 20 6f 66   could be one of
12340 20 3c 62 3e 27 4e 4f 4e 45 27 3c 2f 62 3e 2c 20   <b>'NONE'</b>, 
12350 3c 62 3e 27 44 45 46 4c 41 54 45 27 3c 2f 62 3e  <b>'DEFLATE'</b>
12360 2c 20 3c 62 3e 27 4c 5a 57 27 3c 2f 62 3e 2c 20  , <b>'LZW'</b>, 
12370 3c 62 3e 27 4a 50 45 47 27 3c 2f 62 3e 2c 20 3c  <b>'JPEG'</b>, <
12380 62 3e 27 46 41 58 33 27 3c 2f 62 3e 20 6f 72 20  b>'FAX3'</b> or 
12390 3c 62 3e 27 46 41 58 34 27 3c 2f 62 3e 3b 20 64  <b>'FAX4'</b>; d
123a0 65 66 61 75 6c 74 20 69 73 20 3c 62 3e 27 4e 4f  efault is <b>'NO
123b0 4e 45 27 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c  NE'</b>.</li>..<
123c0 6c 69 3e 74 68 65 20 6c 61 73 74 20 6f 70 74 69  li>the last opti
123d0 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 63 61  onal argument ca
123e0 6e 20 62 65 20 75 73 65 64 20 73 6f 20 74 6f 20  n be used so to 
123f0 73 70 65 63 69 66 79 20 74 68 65 20 70 72 65 66  specify the pref
12400 65 72 72 65 64 20 54 49 46 46 20 74 69 6c 65 20  erred TIFF tile 
12410 73 69 7a 65 20 28 6f 6e 6c 79 20 73 71 75 61 72  size (only squar
12420 65 20 74 69 6c 65 73 20 61 72 65 20 73 75 70 70  e tiles are supp
12430 6f 72 74 65 64 29 3b 20 64 65 66 61 75 6c 74 20  orted); default 
12440 69 73 20 3c 62 3e 32 35 36 3c 2f 62 3e 2e 3c 2f  is <b>256</b>.</
12450 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 74 61 62  li>..</ul>..<tab
12460 6c 65 20 77 69 64 74 68 3d 22 31 30 30 25 22 20  le width="100%" 
12470 62 67 63 6f 6c 6f 72 3d 22 23 66 66 64 30 38 30  bgcolor="#ffd080
12480 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 36  " cellpadding="6
12490 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 75 3e 50  "><tr><td>..<u>P
124a0 6c 65 61 73 65 20 6e 6f 74 65 20 76 65 72 79 20  lease note very 
124b0 77 65 6c 6c 3c 2f 75 3e 3a 20 74 68 69 73 20 53  well</u>: this S
124c0 51 4c 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f  QL function is o
124d0 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 77 68  nly available wh
124e0 65 6e 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65  en the environme
124f0 6e 74 20 76 61 72 69 61 62 6c 65 20 3c 62 3e 53  nt variable <b>S
12500 50 41 54 49 41 4c 49 54 45 5f 53 45 43 55 52 49  PATIALITE_SECURI
12510 54 59 3d 72 65 6c 61 78 65 64 3c 2f 62 3e 20 69  TY=relaxed</b> i
12520 73 20 73 65 74 2e 3c 2f 74 64 3e 3c 2f 74 72 3e  s set.</td></tr>
12530 3c 2f 74 61 62 6c 65 3e 3c 2f 74 64 3e 0d 0a 3c  </table></td>..<
12540 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62  /tr>..<tr><td><b
12550 3e 52 4c 32 5f 57 72 69 74 65 54 69 66 66 54 46  >RL2_WriteTiffTF
12560 57 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65  W</b> ( <b>dbPre
12570 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  fix</b> <i>Strin
12580 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72  g</i> , <b>cover
12590 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  ageName</b> <i>S
125a0 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66  tring</i> , <b>f
125b0 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53  ilePath</b> <i>S
125c0 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77  tring</i> , <b>w
125d0 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  idth</b> <i>Inte
125e0 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69  ger</i> , <b>hei
125f0 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  ght</b> <i>Integ
12600 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e  er</i> , <b>boun
12610 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42  dingBox</b> <i>B
12620 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e  LOB-Geometry</i>
12630 20 2c 20 3c 62 3e 70 69 78 65 6c 52 65 73 6f 6c   , <b>pixelResol
12640 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75  ution</b> <i>Dou
12650 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49  ble</i> ) : <i>I
12660 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62  nteger</i><br><b
12670 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65  r>..<b>RL2_Write
12680 54 69 66 66 54 46 57 3c 2f 62 3e 20 28 20 3c 62  TiffTFW</b> ( <b
12690 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69  >dbPrefix</b> <i
126a0 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
126b0 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62  >coverageName</b
126c0 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
126d0 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62  , <b>filePath</b
126e0 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
126f0 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c  , <b>width</b> <
12700 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
12710 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69  <b>height</b> <i
12720 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
12730 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62  b>boundingBox</b
12740 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74  > <i>BLOB-Geomet
12750 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a  ry</i> , <b>horz
12760 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c  PixelResolution<
12770 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69  /b> <i>Double</i
12780 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69 78 65 6c  > , <b>vertPixel
12790 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c  Resolution</b> <
127a0 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a  i>Double</i> ) :
127b0 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c   <i>Integer</i><
127c0 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f  br><br>..<b>RL2_
127d0 57 72 69 74 65 54 69 66 66 54 46 57 3c 2f 62 3e  WriteTiffTFW</b>
127e0 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f   ( <b>dbPrefix</
127f0 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
12800 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61   , <b>coverageNa
12810 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  me</b> <i>String
12820 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61  </i> , <b>filePa
12830 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  th</b> <i>String
12840 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c  </i> , <b>width<
12850 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
12860 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f  i> , <b>height</
12870 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
12880 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42  > , <b>boundingB
12890 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47  ox</b> <i>BLOB-G
128a0 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62  eometry</i> , <b
128b0 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75  >horzPixelResolu
128c0 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62  tion</b> <i>Doub
128d0 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74  le</i> , <b>vert
128e0 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c  PixelResolution<
128f0 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69  /b> <i>Double</i
12900 3e 20 2c 20 3c 62 3e 74 69 66 66 43 6f 6d 70 72  > , <b>tiffCompr
12910 65 73 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53 74  ession</b> <i>St
12920 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e  ring</i> ) : <i>
12930 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c  Integer</i><br><
12940 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69 74  br>..<b>RL2_Writ
12950 65 54 69 66 66 54 46 57 3c 2f 62 3e 20 28 20 3c  eTiffTFW</b> ( <
12960 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c  b>dbPrefix</b> <
12970 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
12980 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f  b>coverageName</
12990 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
129a0 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f   , <b>filePath</
129b0 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
129c0 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20   , <b>width</b> 
129d0 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
129e0 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c   <b>height</b> <
129f0 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
12a00 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f  <b>boundingBox</
12a10 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65  b> <i>BLOB-Geome
12a20 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72  try</i> , <b>hor
12a30 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  zPixelResolution
12a40 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f  </b> <i>Double</
12a50 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69 78 65  i> , <b>vertPixe
12a60 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20  lResolution</b> 
12a70 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20  <i>Double</i> , 
12a80 3c 62 3e 74 69 66 66 43 6f 6d 70 72 65 73 73 69  <b>tiffCompressi
12a90 6f 6e 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  on</b> <i>String
12aa0 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 66 66 54 69  </i> , <b>tiffTi
12ab0 6c 65 53 69 7a 65 3c 2f 62 3e 20 3c 69 3e 49 6e  leSize</b> <i>In
12ac0 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69  teger</i> ) : <i
12ad0 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64  >Integer</i></td
12ae0 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 61 74 74 65  >..<td>Will atte
12af0 6d 70 74 20 74 6f 20 65 78 70 6f 72 74 20 72 61  mpt to export ra
12b00 77 20 72 61 73 74 65 72 20 64 61 74 61 20 66 72  w raster data fr
12b10 6f 6d 20 61 20 43 6f 76 65 72 61 67 65 20 69 6e  om a Coverage in
12b20 74 6f 20 61 6e 20 65 78 74 65 72 6e 61 6c 20 20  to an external  
12b30 70 6c 61 69 6e 20 54 49 46 46 20 66 69 6c 65 20  plain TIFF file 
12b40 73 75 70 70 6f 72 74 65 64 20 62 79 20 61 6e 20  supported by an 
12b50 61 75 78 69 6c 69 61 72 79 20 57 6f 72 6c 64 46  auxiliary WorldF
12b60 69 6c 65 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72  ile.<br>..Will r
12b70 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28  eturn <b>1</b> (
12b80 54 52 55 45 2f 53 55 43 43 45 53 53 29 20 6f 72  TRUE/SUCCESS) or
12b90 20 3c 62 3e 30 3c 2f 62 3e 20 28 46 41 4c 53 45   <b>0</b> (FALSE
12ba0 2f 46 41 49 4c 55 52 45 29 3a 20 6f 72 20 3c 62  /FAILURE): or <b
12bb0 3e 2d 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c  >-1</b> on inval
12bc0 69 64 20 61 72 67 75 6d 65 6e 74 73 2e 3c 62 72  id arguments.<br
12bd0 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74  >..<u>Please not
12be0 65 3c 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c  e</u>: ..<ul>..<
12bf0 6c 69 3e 54 68 65 20 3c 62 3e 3c 69 3e 64 62 50  li>The <b><i>dbP
12c00 72 65 66 69 78 3c 2f 69 3e 3c 2f 62 3e 20 61 72  refix</i></b> ar
12c10 67 75 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e 64  gument is intend
12c20 65 64 20 74 6f 20 73 70 65 63 69 66 79 20 74 68  ed to specify th
12c30 65 20 41 54 54 41 43 48 45 44 2d 44 42 20 77 68  e ATTACHED-DB wh
12c40 65 72 65 20 74 68 65 20 43 6f 76 65 72 61 67 65  ere the Coverage
12c50 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f 20   is expected to 
12c60 62 65 20 66 6f 75 6e 64 3b 20 69 74 20 63 6f 75  be found; it cou
12c70 6c 64 20 62 65 20 65 76 65 6e 74 75 61 6c 6c 79  ld be eventually
12c80 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e   <b>NULL</b>, an
12c90 64 20 69 6e 20 74 68 69 73 20 63 61 73 65 20 74  d in this case t
12ca0 68 65 20 3c 62 3e 4d 41 49 4e 20 44 42 3c 2f 62  he <b>MAIN DB</b
12cb0 3e 20 77 69 6c 6c 20 69 6d 70 6c 69 63 69 74 6c  > will implicitl
12cc0 79 20 62 65 20 61 73 73 75 6d 65 64 2e 3c 2f 6c  y be assumed.</l
12cd0 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c  i>..<li>the <b><
12ce0 69 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 69  i>boundingBox</i
12cf0 3e 3c 2f 62 3e 20 69 73 20 65 78 70 65 63 74 65  ></b> is expecte
12d00 64 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20 74  d to represent t
12d10 68 65 20 6f 76 65 72 61 6c 6c 20 65 78 74 65 6e  he overall exten
12d20 74 20 6f 66 20 74 68 65 20 65 78 70 6f 72 74 65  t of the exporte
12d30 64 20 54 49 46 46 3b 20 79 6f 75 20 63 6f 75 6c  d TIFF; you coul
12d40 64 20 65 76 65 6e 74 75 61 6c 6c 79 20 70 61 73  d eventually pas
12d50 73 20 61 6e 79 20 61 72 62 69 74 72 61 72 79 20  s any arbitrary 
12d60 6b 69 6e 64 20 6f 66 20 47 65 6f 6d 65 74 72 79  kind of Geometry
12d70 2c 20 61 6e 64 20 74 68 65 20 42 6f 75 6e 64 69  , and the Boundi
12d80 6e 67 20 42 6f 78 20 61 6b 61 20 4d 42 52 20 77  ng Box aka MBR w
12d90 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69 63  ill be automatic
12da0 61 6c 6c 79 20 64 65 74 65 72 6d 69 6e 65 64 2e  ally determined.
12db0 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c  </li>..<li>the <
12dc0 62 3e 3c 69 3e 68 6f 72 7a 50 69 78 65 6c 52 65  b><i>horzPixelRe
12dd0 73 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e  solution</i></b>
12de0 20 61 6e 64 20 3c 62 3e 3c 69 3e 76 65 72 74 50   and <b><i>vertP
12df0 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
12e00 69 3e 3c 2f 62 3e 20 6d 75 73 74 20 65 78 61 63  i></b> must exac
12e10 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20 43 6f  tly match the Co
12e20 76 65 72 61 67 65 27 73 20 62 61 73 65 20 72 65  verage's base re
12e30 73 6f 6c 75 74 69 6f 6e 20 6f 72 20 6f 6e 65 20  solution or one 
12e40 6f 66 20 74 68 65 20 72 65 73 6f 6c 75 74 69 6f  of the resolutio
12e50 6e 73 20 6d 61 64 65 20 61 76 61 69 6c 61 62 6c  ns made availabl
12e60 65 20 62 79 20 74 68 65 20 63 6f 72 72 65 73 70  e by the corresp
12e70 6f 6e 64 69 6e 67 20 50 79 72 61 6d 69 64 20 6c  onding Pyramid l
12e80 65 76 65 6c 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69  evels.</li>..<li
12e90 3e 61 6e 64 20 74 68 65 20 42 6f 75 6e 64 69 6e  >and the Boundin
12ea0 67 42 6f 78 20 6d 75 73 74 20 65 78 61 63 74 6c  gBox must exactl
12eb0 79 20 6d 61 74 63 68 20 74 68 65 20 54 49 46 46  y match the TIFF
12ec0 20 3c 62 3e 3c 69 3e 77 69 64 74 68 3c 2f 69 3e   <b><i>width</i>
12ed0 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e 68  </b> and <b><i>h
12ee0 65 69 67 68 74 3c 2f 69 3e 3c 2f 62 3e 20 64 69  eight</i></b> di
12ef0 6d 65 6e 73 69 6f 6e 73 20 61 74 20 74 68 61 74  mensions at that
12f00 20 72 65 73 6f 6c 75 74 69 6f 6e 2e 3c 2f 6c 69   resolution.</li
12f10 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f  >..<li>the optio
12f20 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e  nal argument <b>
12f30 3c 69 3e 74 69 66 66 43 6f 6d 70 72 65 73 73 69  <i>tiffCompressi
12f40 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 63 6f 75 6c 64  on</i></b> could
12f50 20 62 65 20 6f 6e 65 20 6f 66 20 3c 62 3e 27 4e   be one of <b>'N
12f60 4f 4e 45 27 3c 2f 62 3e 2c 20 3c 62 3e 27 44 45  ONE'</b>, <b>'DE
12f70 46 4c 41 54 45 27 3c 2f 62 3e 2c 20 3c 62 3e 27  FLATE'</b>, <b>'
12f80 4c 5a 57 27 3c 2f 62 3e 2c 20 3c 62 3e 27 4a 50  LZW'</b>, <b>'JP
12f90 45 47 27 3c 2f 62 3e 2c 20 3c 62 3e 27 46 41 58  EG'</b>, <b>'FAX
12fa0 33 27 3c 2f 62 3e 20 6f 72 20 3c 62 3e 27 46 41  3'</b> or <b>'FA
12fb0 58 34 27 3c 2f 62 3e 3b 20 64 65 66 61 75 6c 74  X4'</b>; default
12fc0 20 69 73 20 3c 62 3e 27 4e 4f 4e 45 27 3c 2f 62   is <b>'NONE'</b
12fd0 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65  >.</li>..<li>the
12fe0 20 6c 61 73 74 20 6f 70 74 69 6f 6e 61 6c 20 61   last optional a
12ff0 72 67 75 6d 65 6e 74 20 63 61 6e 20 62 65 20 75  rgument can be u
13000 73 65 64 20 73 6f 20 74 6f 20 73 70 65 63 69 66  sed so to specif
13010 79 20 74 68 65 20 70 72 65 66 65 72 72 65 64 20  y the preferred 
13020 54 49 46 46 20 74 69 6c 65 20 73 69 7a 65 20 28  TIFF tile size (
13030 6f 6e 6c 79 20 73 71 75 61 72 65 20 74 69 6c 65  only square tile
13040 73 20 61 72 65 20 73 75 70 70 6f 72 74 65 64 29  s are supported)
13050 3b 20 64 65 66 61 75 6c 74 20 69 73 20 3c 62 3e  ; default is <b>
13060 32 35 36 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c  256</b>.</li>..<
13070 2f 75 6c 3e 0d 0a 3c 74 61 62 6c 65 20 77 69 64  /ul>..<table wid
13080 74 68 3d 22 31 30 30 25 22 20 62 67 63 6f 6c 6f  th="100%" bgcolo
13090 72 3d 22 23 66 66 64 30 38 30 22 20 63 65 6c 6c  r="#ffd080" cell
130a0 70 61 64 64 69 6e 67 3d 22 36 22 3e 3c 74 72 3e  padding="6"><tr>
130b0 3c 74 64 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20  <td>..<u>Please 
130c0 6e 6f 74 65 20 76 65 72 79 20 77 65 6c 6c 3c 2f  note very well</
130d0 75 3e 3a 20 74 68 69 73 20 53 51 4c 20 66 75 6e  u>: this SQL fun
130e0 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 61 76  ction is only av
130f0 61 69 6c 61 62 6c 65 20 77 68 65 6e 20 74 68 65  ailable when the
13100 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72   environment var
13110 69 61 62 6c 65 20 3c 62 3e 53 50 41 54 49 41 4c  iable <b>SPATIAL
13120 49 54 45 5f 53 45 43 55 52 49 54 59 3d 72 65 6c  ITE_SECURITY=rel
13130 61 78 65 64 3c 2f 62 3e 20 69 73 20 73 65 74 2e  axed</b> is set.
13140 3c 2f 74 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c  </td></tr></tabl
13150 65 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a  e></td>..</tr>..
13160 3c 74 72 3e 3c 74 64 3e 3c 62 3e 52 4c 32 5f 57  <tr><td><b>RL2_W
13170 72 69 74 65 54 69 66 66 3c 2f 62 3e 20 28 20 3c  riteTiff</b> ( <
13180 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c  b>dbPrefix</b> <
13190 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
131a0 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f  b>coverageName</
131b0 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
131c0 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f   , <b>filePath</
131d0 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
131e0 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20   , <b>width</b> 
131f0 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
13200 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c   <b>height</b> <
13210 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
13220 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f  <b>boundingBox</
13230 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65  b> <i>BLOB-Geome
13240 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 70 69 78  try</i> , <b>pix
13250 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e  elResolution</b>
13260 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 29   <i>Double</i> )
13270 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69   : <i>Integer</i
13280 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c  ><br><br>..<b>RL
13290 32 5f 57 72 69 74 65 54 69 66 66 3c 2f 62 3e 20  2_WriteTiff</b> 
132a0 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62  ( <b>dbPrefix</b
132b0 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
132c0 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d  , <b>coverageNam
132d0 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  e</b> <i>String<
132e0 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74  /i> , <b>filePat
132f0 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  h</b> <i>String<
13300 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f  /i> , <b>width</
13310 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
13320 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62  > , <b>height</b
13330 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
13340 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f   , <b>boundingBo
13350 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65  x</b> <i>BLOB-Ge
13360 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e  ometry</i> , <b>
13370 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74  horzPixelResolut
13380 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c  ion</b> <i>Doubl
13390 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50  e</i> , <b>vertP
133a0 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
133b0 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e  b> <i>Double</i>
133c0 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c   ) : <i>Integer<
133d0 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e  /i><br><br>..<b>
133e0 52 4c 32 5f 57 72 69 74 65 54 69 66 66 3c 2f 62  RL2_WriteTiff</b
133f0 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c  > ( <b>dbPrefix<
13400 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
13410 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e  > , <b>coverageN
13420 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ame</b> <i>Strin
13430 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50  g</i> , <b>fileP
13440 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ath</b> <i>Strin
13450 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68  g</i> , <b>width
13460 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
13470 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c  /i> , <b>height<
13480 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
13490 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67  i> , <b>bounding
134a0 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d  Box</b> <i>BLOB-
134b0 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c  Geometry</i> , <
134c0 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c  b>horzPixelResol
134d0 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75  ution</b> <i>Dou
134e0 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72  ble</i> , <b>ver
134f0 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  tPixelResolution
13500 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f  </b> <i>Double</
13510 69 3e 20 2c 20 3c 62 3e 74 69 66 66 43 6f 6d 70  i> , <b>tiffComp
13520 72 65 73 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53  ression</b> <i>S
13530 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69  tring</i> ) : <i
13540 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e  >Integer</i><br>
13550 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69  <br>..<b>RL2_Wri
13560 74 65 54 69 66 66 3c 2f 62 3e 20 28 20 3c 62 3e  teTiff</b> ( <b>
13570 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e  dbPrefix</b> <i>
13580 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
13590 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e  coverageName</b>
135a0 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
135b0 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e   <b>filePath</b>
135c0 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
135d0 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69   <b>width</b> <i
135e0 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
135f0 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e  b>height</b> <i>
13600 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
13610 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e  >boundingBox</b>
13620 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72   <i>BLOB-Geometr
13630 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50  y</i> , <b>horzP
13640 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
13650 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e  b> <i>Double</i>
13660 20 2c 20 3c 62 3e 76 65 72 74 50 69 78 65 6c 52   , <b>vertPixelR
13670 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69  esolution</b> <i
13680 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62  >Double</i> , <b
13690 3e 74 69 66 66 43 6f 6d 70 72 65 73 73 69 6f 6e  >tiffCompression
136a0 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
136b0 69 3e 20 2c 20 3c 62 3e 74 69 66 66 54 69 6c 65  i> , <b>tiffTile
136c0 53 69 7a 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  Size</b> <i>Inte
136d0 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49  ger</i> ) : <i>I
136e0 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d  nteger</i></td>.
136f0 0a 3c 74 64 3e 57 69 6c 6c 20 61 74 74 65 6d 70  .<td>Will attemp
13700 74 20 74 6f 20 65 78 70 6f 72 74 20 72 61 77 20  t to export raw 
13710 72 61 73 74 65 72 20 64 61 74 61 20 66 72 6f 6d  raster data from
13720 20 61 20 43 6f 76 65 72 61 67 65 20 69 6e 74 6f   a Coverage into
13730 20 61 6e 20 65 78 74 65 72 6e 61 6c 20 20 70 6c   an external  pl
13740 61 69 6e 20 54 49 46 46 20 66 69 6c 65 2e 3c 62  ain TIFF file.<b
13750 72 3e 0d 0a 57 69 6c 6c 20 72 65 74 75 72 6e 20  r>..Will return 
13760 3c 62 3e 31 3c 2f 62 3e 20 28 54 52 55 45 2f 53  <b>1</b> (TRUE/S
13770 55 43 43 45 53 53 29 20 6f 72 20 3c 62 3e 30 3c  UCCESS) or <b>0<
13780 2f 62 3e 20 28 46 41 4c 53 45 2f 46 41 49 4c 55  /b> (FALSE/FAILU
13790 52 45 29 3a 20 6f 72 20 3c 62 3e 2d 31 3c 2f 62  RE): or <b>-1</b
137a0 3e 20 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72 67  > on invalid arg
137b0 75 6d 65 6e 74 73 2e 3c 62 72 3e 0d 0a 3c 75 3e  uments.<br>..<u>
137c0 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a  Please note</u>:
137d0 20 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65   ..<ul>..<li>The
137e0 20 3c 62 3e 3c 69 3e 64 62 50 72 65 66 69 78 3c   <b><i>dbPrefix<
137f0 2f 69 3e 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74  /i></b> argument
13800 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20   is intended to 
13810 73 70 65 63 69 66 79 20 74 68 65 20 41 54 54 41  specify the ATTA
13820 43 48 45 44 2d 44 42 20 77 68 65 72 65 20 74 68  CHED-DB where th
13830 65 20 43 6f 76 65 72 61 67 65 20 69 73 20 65 78  e Coverage is ex
13840 70 65 63 74 65 64 20 74 6f 20 62 65 20 66 6f 75  pected to be fou
13850 6e 64 3b 20 69 74 20 63 6f 75 6c 64 20 62 65 20  nd; it could be 
13860 65 76 65 6e 74 75 61 6c 6c 79 20 3c 62 3e 4e 55  eventually <b>NU
13870 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69 6e 20 74  LL</b>, and in t
13880 68 69 73 20 63 61 73 65 20 74 68 65 20 3c 62 3e  his case the <b>
13890 4d 41 49 4e 20 44 42 3c 2f 62 3e 20 77 69 6c 6c  MAIN DB</b> will
138a0 20 69 6d 70 6c 69 63 69 74 6c 79 20 62 65 20 61   implicitly be a
138b0 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c  ssumed.</li>..<l
138c0 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 62 6f 75 6e  i>the <b><i>boun
138d0 64 69 6e 67 42 6f 78 3c 2f 69 3e 3c 2f 62 3e 20  dingBox</i></b> 
138e0 69 73 20 65 78 70 65 63 74 65 64 20 74 6f 20 72  is expected to r
138f0 65 70 72 65 73 65 6e 74 20 74 68 65 20 6f 76 65  epresent the ove
13900 72 61 6c 6c 20 65 78 74 65 6e 74 20 6f 66 20 74  rall extent of t
13910 68 65 20 65 78 70 6f 72 74 65 64 20 54 49 46 46  he exported TIFF
13920 3b 20 79 6f 75 20 63 6f 75 6c 64 20 65 76 65 6e  ; you could even
13930 74 75 61 6c 6c 79 20 70 61 73 73 20 61 6e 79 20  tually pass any 
13940 61 72 62 69 74 72 61 72 79 20 6b 69 6e 64 20 6f  arbitrary kind o
13950 66 20 47 65 6f 6d 65 74 72 79 2c 20 61 6e 64 20  f Geometry, and 
13960 74 68 65 20 42 6f 75 6e 64 69 6e 67 20 42 6f 78  the Bounding Box
13970 20 61 6b 61 20 4d 42 52 20 77 69 6c 6c 20 62 65   aka MBR will be
13980 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64   automatically d
13990 65 74 65 72 6d 69 6e 65 64 2e 3c 2f 6c 69 3e 0d  etermined.</li>.
139a0 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 68  .<li>the <b><i>h
139b0 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69  orzPixelResoluti
139c0 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c  on</i></b> and <
139d0 62 3e 3c 69 3e 76 65 72 74 50 69 78 65 6c 52 65  b><i>vertPixelRe
139e0 73 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e  solution</i></b>
139f0 20 6d 75 73 74 20 65 78 61 63 74 6c 79 20 6d 61   must exactly ma
13a00 74 63 68 20 74 68 65 20 43 6f 76 65 72 61 67 65  tch the Coverage
13a10 27 73 20 62 61 73 65 20 72 65 73 6f 6c 75 74 69  's base resoluti
13a20 6f 6e 20 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65  on or one of the
13a30 20 72 65 73 6f 6c 75 74 69 6f 6e 73 20 6d 61 64   resolutions mad
13a40 65 20 61 76 61 69 6c 61 62 6c 65 20 62 79 20 74  e available by t
13a50 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67  he corresponding
13a60 20 50 79 72 61 6d 69 64 20 6c 65 76 65 6c 73 2e   Pyramid levels.
13a70 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 6e 64 20 74  </li>..<li>and t
13a80 68 65 20 42 6f 75 6e 64 69 6e 67 42 6f 78 20 6d  he BoundingBox m
13a90 75 73 74 20 65 78 61 63 74 6c 79 20 6d 61 74 63  ust exactly matc
13aa0 68 20 74 68 65 20 54 49 46 46 20 3c 62 3e 3c 69  h the TIFF <b><i
13ab0 3e 77 69 64 74 68 3c 2f 69 3e 3c 2f 62 3e 20 61  >width</i></b> a
13ac0 6e 64 20 3c 62 3e 3c 69 3e 68 65 69 67 68 74 3c  nd <b><i>height<
13ad0 2f 69 3e 3c 2f 62 3e 20 64 69 6d 65 6e 73 69 6f  /i></b> dimensio
13ae0 6e 73 20 61 74 20 74 68 61 74 20 72 65 73 6f 6c  ns at that resol
13af0 75 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69  ution.</li>..<li
13b00 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72  >the optional ar
13b10 67 75 6d 65 6e 74 20 3c 62 3e 3c 69 3e 74 69 66  gument <b><i>tif
13b20 66 43 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 69 3e  fCompression</i>
13b30 3c 2f 62 3e 20 63 6f 75 6c 64 20 62 65 20 6f 6e  </b> could be on
13b40 65 20 6f 66 20 3c 62 3e 27 4e 4f 4e 45 27 3c 2f  e of <b>'NONE'</
13b50 62 3e 2c 20 3c 62 3e 27 44 45 46 4c 41 54 45 27  b>, <b>'DEFLATE'
13b60 3c 2f 62 3e 2c 20 3c 62 3e 27 4c 5a 57 27 3c 2f  </b>, <b>'LZW'</
13b70 62 3e 2c 20 3c 62 3e 27 4a 50 45 47 27 3c 2f 62  b>, <b>'JPEG'</b
13b80 3e 2c 20 3c 62 3e 27 46 41 58 33 27 3c 2f 62 3e  >, <b>'FAX3'</b>
13b90 20 6f 72 20 3c 62 3e 27 46 41 58 34 27 3c 2f 62   or <b>'FAX4'</b
13ba0 3e 3b 20 64 65 66 61 75 6c 74 20 69 73 20 3c 62  >; default is <b
13bb0 3e 27 4e 4f 4e 45 27 3c 2f 62 3e 2e 3c 2f 6c 69  >'NONE'</b>.</li
13bc0 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6c 61 73 74 20  >..<li>the last 
13bd0 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e  optional argumen
13be0 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 73 6f  t can be used so
13bf0 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 20   to specify the 
13c00 70 72 65 66 65 72 72 65 64 20 54 49 46 46 20 74  preferred TIFF t
13c10 69 6c 65 20 73 69 7a 65 20 28 6f 6e 6c 79 20 73  ile size (only s
13c20 71 75 61 72 65 20 74 69 6c 65 73 20 61 72 65 20  quare tiles are 
13c30 73 75 70 70 6f 72 74 65 64 29 3b 20 64 65 66 61  supported); defa
13c40 75 6c 74 20 69 73 20 3c 62 3e 32 35 36 3c 2f 62  ult is <b>256</b
13c50 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a  >.</li>..</ul>..
13c60 3c 74 61 62 6c 65 20 77 69 64 74 68 3d 22 31 30  <table width="10
13c70 30 25 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66  0%" bgcolor="#ff
13c80 64 30 38 30 22 20 63 65 6c 6c 70 61 64 64 69 6e  d080" cellpaddin
13c90 67 3d 22 36 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a  g="6"><tr><td>..
13ca0 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 20 76  <u>Please note v
13cb0 65 72 79 20 77 65 6c 6c 3c 2f 75 3e 3a 20 74 68  ery well</u>: th
13cc0 69 73 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20  is SQL function 
13cd0 69 73 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c  is only availabl
13ce0 65 20 77 68 65 6e 20 74 68 65 20 65 6e 76 69 72  e when the envir
13cf0 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20  onment variable 
13d00 3c 62 3e 53 50 41 54 49 41 4c 49 54 45 5f 53 45  <b>SPATIALITE_SE
13d10 43 55 52 49 54 59 3d 72 65 6c 61 78 65 64 3c 2f  CURITY=relaxed</
13d20 62 3e 20 69 73 20 73 65 74 2e 3c 2f 74 64 3e 3c  b> is set.</td><
13d30 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e 3c 2f 74 64  /tr></table></td
13d40 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74  >..</tr>..<tr><t
13d50 64 3e 3c 62 3e 52 4c 32 5f 57 72 69 74 65 54 72  d><b>RL2_WriteTr
13d60 69 70 6c 65 42 61 6e 64 47 65 6f 54 69 66 66 3c  ipleBandGeoTiff<
13d70 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69  /b> ( <b>dbPrefi
13d80 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  x</b> <i>String<
13d90 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67  /i> , <b>coverag
13da0 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  eName</b> <i>Str
13db0 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c  ing</i> , <b>fil
13dc0 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72  ePath</b> <i>Str
13dd0 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64  ing</i> , <b>wid
13de0 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  th</b> <i>Intege
13df0 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68  r</i> , <b>heigh
13e00 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  t</b> <i>Integer
13e10 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e  </i> , <b>bandIn
13e20 64 65 78 52 65 64 3c 2f 62 3e 20 3c 69 3e 49 6e  dexRed</b> <i>In
13e30 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
13e40 61 6e 64 49 6e 64 65 78 47 72 65 65 6e 3c 2f 62  andIndexGreen</b
13e50 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
13e60 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 42   , <b>bandIndexB
13e70 6c 75 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  lue</b> <i>Integ
13e80 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e  er</i> , <b>boun
13e90 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42  dingBox</b> <i>B
13ea0 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e  LOB-Geometry</i>
13eb0 20 2c 20 3c 62 3e 70 69 78 65 6c 52 65 73 6f 6c   , <b>pixelResol
13ec0 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75  ution</b> <i>Dou
13ed0 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49  ble</i> ) : <i>I
13ee0 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62  nteger</i><br><b
13ef0 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65  r>..<b>RL2_Write
13f00 54 72 69 70 6c 65 42 61 6e 64 47 65 6f 54 69 66  TripleBandGeoTif
13f10 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65  f</b> ( <b>dbPre
13f20 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  fix</b> <i>Strin
13f30 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72  g</i> , <b>cover
13f40 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  ageName</b> <i>S
13f50 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66  tring</i> , <b>f
13f60 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53  ilePath</b> <i>S
13f70 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77  tring</i> , <b>w
13f80 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  idth</b> <i>Inte
13f90 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69  ger</i> , <b>hei
13fa0 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  ght</b> <i>Integ
13fb0 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64  er</i> , <b>band
13fc0 49 6e 64 65 78 52 65 64 3c 2f 62 3e 20 3c 69 3e  IndexRed</b> <i>
13fd0 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
13fe0 3e 62 61 6e 64 49 6e 64 65 78 47 72 65 65 6e 3c  >bandIndexGreen<
13ff0 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
14000 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65  i> , <b>bandInde
14010 78 42 6c 75 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74  xBlue</b> <i>Int
14020 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62 3e 62  eger</i>  , <b>b
14030 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c  oundingBox</b> <
14040 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c  i>BLOB-Geometry<
14050 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50 69 78  /i> , <b>horzPix
14060 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e  elResolution</b>
14070 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c   <i>Double</i> ,
14080 20 3c 62 3e 76 65 72 74 50 69 78 65 6c 52 65 73   <b>vertPixelRes
14090 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44  olution</b> <i>D
140a0 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c 69  ouble</i> ) : <i
140b0 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e  >Integer</i><br>
140c0 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69  <br>..<b>RL2_Wri
140d0 74 65 54 72 69 70 6c 65 42 61 6e 64 47 65 6f 54  teTripleBandGeoT
140e0 69 66 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50  iff</b> ( <b>dbP
140f0 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72  refix</b> <i>Str
14100 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76  ing</i> , <b>cov
14110 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69  erageName</b> <i
14120 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
14130 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69  >filePath</b> <i
14140 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
14150 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
14160 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
14170 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
14180 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61  eger</i> , <b>ba
14190 6e 64 49 6e 64 65 78 52 65 64 3c 2f 62 3e 20 3c  ndIndexRed</b> <
141a0 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
141b0 3c 62 3e 62 61 6e 64 49 6e 64 65 78 47 72 65 65  <b>bandIndexGree
141c0 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  n</b> <i>Integer
141d0 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e  </i> , <b>bandIn
141e0 64 65 78 42 6c 75 65 3c 2f 62 3e 20 3c 69 3e 49  dexBlue</b> <i>I
141f0 6e 74 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62  nteger</i>  , <b
14200 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e  >boundingBox</b>
14210 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72   <i>BLOB-Geometr
14220 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50  y</i> , <b>horzP
14230 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
14240 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e  b> <i>Double</i>
14250 20 2c 20 3c 62 3e 76 65 72 74 50 69 78 65 6c 52   , <b>vertPixelR
14260 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69  esolution</b> <i
14270 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62  >Double</i> , <b
14280 3e 77 69 74 68 57 6f 6c 64 46 69 6c 65 3c 2f 62  >withWoldFile</b
14290 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
142a0 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c   ) : <i>Integer<
142b0 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e  /i><br><br>..<b>
142c0 52 4c 32 5f 57 72 69 74 65 54 72 69 70 6c 65 42  RL2_WriteTripleB
142d0 61 6e 64 47 65 6f 54 69 66 66 3c 2f 62 3e 20 28  andGeoTiff</b> (
142e0 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e   <b>dbPrefix</b>
142f0 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
14300 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
14310 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
14320 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68  i> , <b>filePath
14330 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
14340 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62  i> , <b>width</b
14350 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
14360 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e   , <b>height</b>
14370 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
14380 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 52 65  , <b>bandIndexRe
14390 64 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  d</b> <i>Integer
143a0 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e  </i> , <b>bandIn
143b0 64 65 78 47 72 65 65 6e 3c 2f 62 3e 20 3c 69 3e  dexGreen</b> <i>
143c0 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
143d0 3e 62 61 6e 64 49 6e 64 65 78 42 6c 75 65 3c 2f  >bandIndexBlue</
143e0 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
143f0 3e 20 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67  >  , <b>bounding
14400 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d  Box</b> <i>BLOB-
14410 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c  Geometry</i> , <
14420 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c  b>horzPixelResol
14430 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75  ution</b> <i>Dou
14440 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72  ble</i> , <b>ver
14450 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  tPixelResolution
14460 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f  </b> <i>Double</
14470 69 3e 20 2c 20 3c 62 3e 77 69 74 68 57 6f 6c 64  i> , <b>withWold
14480 46 69 6c 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  File</b> <i>Inte
14490 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 66  ger</i> , <b>tif
144a0 66 43 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 62 3e  fCompression</b>
144b0 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29   <i>String</i> )
144c0 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69   : <i>Integer</i
144d0 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c  ><br><br>..<b>RL
144e0 32 5f 57 72 69 74 65 54 72 69 70 6c 65 42 61 6e  2_WriteTripleBan
144f0 64 47 65 6f 54 69 66 66 3c 2f 62 3e 20 28 20 3c  dGeoTiff</b> ( <
14500 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c  b>dbPrefix</b> <
14510 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
14520 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f  b>coverageName</
14530 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
14540 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f   , <b>filePath</
14550 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
14560 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20   , <b>width</b> 
14570 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
14580 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c   <b>height</b> <
14590 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
145a0 3c 62 3e 62 61 6e 64 49 6e 64 65 78 52 65 64 3c  <b>bandIndexRed<
145b0 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
145c0 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65  i> , <b>bandInde
145d0 78 47 72 65 65 6e 3c 2f 62 3e 20 3c 69 3e 49 6e  xGreen</b> <i>In
145e0 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
145f0 61 6e 64 49 6e 64 65 78 42 6c 75 65 3c 2f 62 3e  andIndexBlue</b>
14600 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
14610 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f   , <b>boundingBo
14620 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65  x</b> <i>BLOB-Ge
14630 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e  ometry</i> , <b>
14640 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74  horzPixelResolut
14650 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c  ion</b> <i>Doubl
14660 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50  e</i> , <b>vertP
14670 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
14680 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e  b> <i>Double</i>
14690 20 2c 20 3c 62 3e 77 69 74 68 57 6f 6c 64 46 69   , <b>withWoldFi
146a0 6c 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  le</b> <i>Intege
146b0 72 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 66 66 43  r</i> , <b>tiffC
146c0 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 62 3e 20 3c  ompression</b> <
146d0 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
146e0 62 3e 74 69 66 66 54 69 6c 65 53 69 7a 65 3c 2f  b>tiffTileSize</
146f0 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
14700 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72  > ) : <i>Integer
14710 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57  </i></td>..<td>W
14720 69 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f 20 65  ill attempt to e
14730 78 70 6f 72 74 20 72 61 77 20 72 61 73 74 65 72  xport raw raster
14740 20 64 61 74 61 20 66 72 6f 6d 20 61 20 4d 55 4c   data from a MUL
14750 54 49 42 41 4e 44 20 6f 72 20 52 47 42 20 43 6f  TIBAND or RGB Co
14760 76 65 72 61 67 65 20 69 6e 74 6f 20 61 6e 20 65  verage into an e
14770 78 74 65 72 6e 61 6c 20 47 65 6f 54 49 46 46 20  xternal GeoTIFF 
14780 66 69 6c 65 20 6f 66 20 74 68 65 20 52 47 42 20  file of the RGB 
14790 74 79 70 65 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20  type.<br>..Will 
147a0 72 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20  return <b>1</b> 
147b0 28 54 52 55 45 2f 53 55 43 43 45 53 53 29 20 6f  (TRUE/SUCCESS) o
147c0 72 20 3c 62 3e 30 3c 2f 62 3e 20 28 46 41 4c 53  r <b>0</b> (FALS
147d0 45 2f 46 41 49 4c 55 52 45 29 3a 20 6f 72 20 3c  E/FAILURE): or <
147e0 62 3e 2d 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61  b>-1</b> on inva
147f0 6c 69 64 20 61 72 67 75 6d 65 6e 74 73 2e 3c 62  lid arguments.<b
14800 72 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f  r>..<u>Please no
14810 74 65 3c 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a  te</u>: ..<ul>..
14820 3c 6c 69 3e 54 68 65 20 3c 62 3e 3c 69 3e 64 62  <li>The <b><i>db
14830 50 72 65 66 69 78 3c 2f 69 3e 3c 2f 62 3e 20 61  Prefix</i></b> a
14840 72 67 75 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e  rgument is inten
14850 64 65 64 20 74 6f 20 73 70 65 63 69 66 79 20 74  ded to specify t
14860 68 65 20 41 54 54 41 43 48 45 44 2d 44 42 20 77  he ATTACHED-DB w
14870 68 65 72 65 20 74 68 65 20 43 6f 76 65 72 61 67  here the Coverag
14880 65 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f  e is expected to
14890 20 62 65 20 66 6f 75 6e 64 3b 20 69 74 20 63 6f   be found; it co
148a0 75 6c 64 20 62 65 20 65 76 65 6e 74 75 61 6c 6c  uld be eventuall
148b0 79 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61  y <b>NULL</b>, a
148c0 6e 64 20 69 6e 20 74 68 69 73 20 63 61 73 65 20  nd in this case 
148d0 74 68 65 20 3c 62 3e 4d 41 49 4e 20 44 42 3c 2f  the <b>MAIN DB</
148e0 62 3e 20 77 69 6c 6c 20 69 6d 70 6c 69 63 69 74  b> will implicit
148f0 6c 79 20 62 65 20 61 73 73 75 6d 65 64 2e 3c 2f  ly be assumed.</
14900 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e  li>..<li>the <b>
14910 3c 69 3e 62 61 6e 64 49 6e 64 65 78 52 65 64 3c  <i>bandIndexRed<
14920 2f 62 3e 3c 2f 69 3e 2c 20 3c 62 3e 3c 69 3e 62  /b></i>, <b><i>b
14930 61 6e 64 49 6e 64 65 78 47 72 65 65 6e 3c 2f 69  andIndexGreen</i
14940 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e  ></b> and <b><i>
14950 62 61 6e 64 49 6e 64 65 78 42 6c 75 65 3c 2f 69  bandIndexBlue</i
14960 3e 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 73 20  ></b> arguments 
14970 61 72 65 20 69 6e 74 65 6e 64 65 64 20 74 6f 20  are intended to 
14980 61 72 62 69 74 72 61 72 69 6c 79 20 63 6f 6d 70  arbitrarily comp
14990 6f 73 65 20 74 68 65 20 52 47 42 20 54 49 46 46  ose the RGB TIFF
149a0 20 73 74 61 72 74 69 6e 67 20 66 72 6f 6d 20 74   starting from t
149b0 68 65 20 42 61 6e 64 73 20 73 75 70 70 6f 72 74  he Bands support
149c0 65 64 20 62 79 20 74 68 65 20 43 6f 76 65 72 61  ed by the Covera
149d0 67 65 2e 0d 0a 3c 62 72 3e 3c 75 3e 50 6c 65 61  ge...<br><u>Plea
149e0 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 74 68 65  se note</u>: the
149f0 20 66 69 72 73 74 20 42 61 6e 64 20 61 6c 77 61   first Band alwa
14a00 79 73 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74  ys corresponds t
14a10 6f 20 69 6e 64 65 78 20 3c 62 3e 5a 45 52 4f 3c  o index <b>ZERO<
14a20 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68  /b></li>..<li>th
14a30 65 20 3c 62 3e 3c 69 3e 62 6f 75 6e 64 69 6e 67  e <b><i>bounding
14a40 42 6f 78 3c 2f 69 3e 3c 2f 62 3e 20 69 73 20 65  Box</i></b> is e
14a50 78 70 65 63 74 65 64 20 74 6f 20 72 65 70 72 65  xpected to repre
14a60 73 65 6e 74 20 74 68 65 20 6f 76 65 72 61 6c 6c  sent the overall
14a70 20 65 78 74 65 6e 74 20 6f 66 20 74 68 65 20 65   extent of the e
14a80 78 70 6f 72 74 65 64 20 47 65 6f 54 49 46 46 3b  xported GeoTIFF;
14a90 20 79 6f 75 20 63 6f 75 6c 64 20 65 76 65 6e 74   you could event
14aa0 75 61 6c 6c 79 20 70 61 73 73 20 61 6e 79 20 61  ually pass any a
14ab0 72 62 69 74 72 61 72 79 20 6b 69 6e 64 20 6f 66  rbitrary kind of
14ac0 20 47 65 6f 6d 65 74 72 79 2c 20 61 6e 64 20 74   Geometry, and t
14ad0 68 65 20 42 6f 75 6e 64 69 6e 67 20 42 6f 78 20  he Bounding Box 
14ae0 61 6b 61 20 4d 42 52 20 77 69 6c 6c 20 62 65 20  aka MBR will be 
14af0 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65  automatically de
14b00 74 65 72 6d 69 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a  termined.</li>..
14b10 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 68 6f  <li>the <b><i>ho
14b20 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rzPixelResolutio
14b30 6e 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62  n</i></b> and <b
14b40 3e 3c 69 3e 76 65 72 74 50 69 78 65 6c 52 65 73  ><i>vertPixelRes
14b50 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20  olution</i></b> 
14b60 6d 75 73 74 20 65 78 61 63 74 6c 79 20 6d 61 74  must exactly mat
14b70 63 68 20 74 68 65 20 43 6f 76 65 72 61 67 65 27  ch the Coverage'
14b80 73 20 62 61 73 65 20 72 65 73 6f 6c 75 74 69 6f  s base resolutio
14b90 6e 20 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65 20  n or one of the 
14ba0 72 65 73 6f 6c 75 74 69 6f 6e 73 20 6d 61 64 65  resolutions made
14bb0 20 61 76 61 69 6c 61 62 6c 65 20 62 79 20 74 68   available by th
14bc0 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20  e corresponding 
14bd0 50 79 72 61 6d 69 64 20 6c 65 76 65 6c 73 2e 3c  Pyramid levels.<
14be0 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 6e 64 20 74 68  /li>..<li>and th
14bf0 65 20 42 6f 75 6e 64 69 6e 67 42 6f 78 20 6d 75  e BoundingBox mu
14c00 73 74 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68  st exactly match
14c10 20 74 68 65 20 54 49 46 46 20 3c 62 3e 3c 69 3e   the TIFF <b><i>
14c20 77 69 64 74 68 3c 2f 69 3e 3c 2f 62 3e 20 61 6e  width</i></b> an
14c30 64 20 3c 62 3e 3c 69 3e 68 65 69 67 68 74 3c 2f  d <b><i>height</
14c40 69 3e 3c 2f 62 3e 20 64 69 6d 65 6e 73 69 6f 6e  i></b> dimension
14c50 73 20 61 74 20 74 68 61 74 20 72 65 73 6f 6c 75  s at that resolu
14c60 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  tion.</li>..<li>
14c70 69 66 20 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20  if the optional 
14c80 61 72 67 75 6d 65 6e 74 20 3c 62 3e 3c 69 3e 77  argument <b><i>w
14c90 69 74 68 57 6f 72 6c 64 46 69 6c 65 3c 2f 69 3e  ithWorldFile</i>
14ca0 3c 2f 62 3e 20 69 73 20 73 65 74 20 74 6f 20 54  </b> is set to T
14cb0 52 55 45 20 74 68 65 6e 20 61 6e 20 61 75 78 69  RUE then an auxi
14cc0 6c 69 61 72 79 20 57 6f 72 6c 64 46 69 6c 65 20  liary WorldFile 
14cd0 77 69 6c 6c 20 62 65 20 65 78 70 6f 72 74 65 64  will be exported
14ce0 20 61 73 20 77 65 6c 6c 2e 3c 2f 6c 69 3e 0d 0a   as well.</li>..
14cf0 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c  <li>the optional
14d00 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 3c 69 3e   argument <b><i>
14d10 74 69 66 66 43 6f 6d 70 72 65 73 73 69 6f 6e 3c  tiffCompression<
14d20 2f 69 3e 3c 2f 62 3e 20 63 6f 75 6c 64 20 62 65  /i></b> could be
14d30 20 6f 6e 65 20 6f 66 20 3c 62 3e 27 4e 4f 4e 45   one of <b>'NONE
14d40 27 3c 2f 62 3e 2c 20 3c 62 3e 27 44 45 46 4c 41  '</b>, <b>'DEFLA
14d50 54 45 27 3c 2f 62 3e 2c 20 3c 62 3e 27 4c 5a 57  TE'</b>, <b>'LZW
14d60 27 3c 2f 62 3e 2c 20 3c 62 3e 27 4a 50 45 47 27  '</b>, <b>'JPEG'
14d70 3c 2f 62 3e 2c 20 3c 62 3e 27 46 41 58 33 27 3c  </b>, <b>'FAX3'<
14d80 2f 62 3e 20 6f 72 20 3c 62 3e 27 46 41 58 34 27  /b> or <b>'FAX4'
14d90 3c 2f 62 3e 3b 20 64 65 66 61 75 6c 74 20 69 73  </b>; default is
14da0 20 3c 62 3e 27 4e 4f 4e 45 27 3c 2f 62 3e 2e 3c   <b>'NONE'</b>.<
14db0 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6c 61  /li>..<li>the la
14dc0 73 74 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75  st optional argu
14dd0 6d 65 6e 74 20 63 61 6e 20 62 65 20 75 73 65 64  ment can be used
14de0 20 73 6f 20 74 6f 20 73 70 65 63 69 66 79 20 74   so to specify t
14df0 68 65 20 70 72 65 66 65 72 72 65 64 20 54 49 46  he preferred TIF
14e00 46 20 74 69 6c 65 20 73 69 7a 65 20 28 6f 6e 6c  F tile size (onl
14e10 79 20 73 71 75 61 72 65 20 74 69 6c 65 73 20 61  y square tiles a
14e20 72 65 20 73 75 70 70 6f 72 74 65 64 29 3b 20 64  re supported); d
14e30 65 66 61 75 6c 74 20 69 73 20 3c 62 3e 32 35 36  efault is <b>256
14e40 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c  </b>.</li>..</ul
14e50 3e 0d 0a 3c 74 61 62 6c 65 20 77 69 64 74 68 3d  >..<table width=
14e60 22 31 30 30 25 22 20 62 67 63 6f 6c 6f 72 3d 22  "100%" bgcolor="
14e70 23 66 66 64 30 38 30 22 20 63 65 6c 6c 70 61 64  #ffd080" cellpad
14e80 64 69 6e 67 3d 22 36 22 3e 3c 74 72 3e 3c 74 64  ding="6"><tr><td
14e90 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74  >..<u>Please not
14ea0 65 20 76 65 72 79 20 77 65 6c 6c 3c 2f 75 3e 3a  e very well</u>:
14eb0 20 74 68 69 73 20 53 51 4c 20 66 75 6e 63 74 69   this SQL functi
14ec0 6f 6e 20 69 73 20 6f 6e 6c 79 20 61 76 61 69 6c  on is only avail
14ed0 61 62 6c 65 20 77 68 65 6e 20 74 68 65 20 65 6e  able when the en
14ee0 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62  vironment variab
14ef0 6c 65 20 3c 62 3e 53 50 41 54 49 41 4c 49 54 45  le <b>SPATIALITE
14f00 5f 53 45 43 55 52 49 54 59 3d 72 65 6c 61 78 65  _SECURITY=relaxe
14f10 64 3c 2f 62 3e 20 69 73 20 73 65 74 2e 3c 2f 74  d</b> is set.</t
14f20 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e 3c  d></tr></table><
14f30 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72  /td>..</tr>..<tr
14f40 3e 3c 74 64 3e 3c 62 3e 52 4c 32 5f 57 72 69 74  ><td><b>RL2_Writ
14f50 65 54 72 69 70 6c 65 42 61 6e 64 54 69 66 66 54  eTripleBandTiffT
14f60 46 57 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72  FW</b> ( <b>dbPr
14f70 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  efix</b> <i>Stri
14f80 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65  ng</i> , <b>cove
14f90 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e  rageName</b> <i>
14fa0 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
14fb0 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e  filePath</b> <i>
14fc0 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
14fd0 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74  width</b> <i>Int
14fe0 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65  eger</i> , <b>he
14ff0 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  ight</b> <i>Inte
15000 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e  ger</i> , <b>ban
15010 64 49 6e 64 65 78 52 65 64 3c 2f 62 3e 20 3c 69  dIndexRed</b> <i
15020 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
15030 62 3e 62 61 6e 64 49 6e 64 65 78 47 72 65 65 6e  b>bandIndexGreen
15040 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
15050 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64  /i> , <b>bandInd
15060 65 78 42 6c 75 65 3c 2f 62 3e 20 3c 69 3e 49 6e  exBlue</b> <i>In
15070 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
15080 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c  oundingBox</b> <
15090 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c  i>BLOB-Geometry<
150a0 2f 69 3e 20 2c 20 3c 62 3e 70 69 78 65 6c 52 65  /i> , <b>pixelRe
150b0 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e  solution</b> <i>
150c0 44 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c  Double</i> ) : <
150d0 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72  i>Integer</i><br
150e0 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72  ><br>..<b>RL2_Wr
150f0 69 74 65 54 72 69 70 6c 65 42 61 6e 64 54 69 66  iteTripleBandTif
15100 66 54 46 57 3c 2f 62 3e 20 28 20 3c 62 3e 64 62  fTFW</b> ( <b>db
15110 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74  Prefix</b> <i>St
15120 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f  ring</i> , <b>co
15130 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c  verageName</b> <
15140 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
15150 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c  b>filePath</b> <
15160 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
15170 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49  b>width</b> <i>I
15180 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
15190 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e  height</b> <i>In
151a0 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
151b0 61 6e 64 49 6e 64 65 78 52 65 64 3c 2f 62 3e 20  andIndexRed</b> 
151c0 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
151d0 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 47 72 65   <b>bandIndexGre
151e0 65 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  en</b> <i>Intege
151f0 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49  r</i> , <b>bandI
15200 6e 64 65 78 42 6c 75 65 3c 2f 62 3e 20 3c 69 3e  ndexBlue</b> <i>
15210 49 6e 74 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c  Integer</i>  , <
15220 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62  b>boundingBox</b
15230 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74  > <i>BLOB-Geomet
15240 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a  ry</i> , <b>horz
15250 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c  PixelResolution<
15260 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69  /b> <i>Double</i
15270 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69 78 65 6c  > , <b>vertPixel
15280 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c  Resolution</b> <
15290 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a  i>Double</i> ) :
152a0 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c   <i>Integer</i><
152b0 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f  br><br>..<b>RL2_
152c0 57 72 69 74 65 54 72 69 70 6c 65 42 61 6e 64 54  WriteTripleBandT
152d0 69 66 66 54 46 57 3c 2f 62 3e 20 28 20 3c 62 3e  iffTFW</b> ( <b>
152e0 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e  dbPrefix</b> <i>
152f0 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
15300 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e  coverageName</b>
15310 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
15320 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e   <b>filePath</b>
15330 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
15340 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69   <b>width</b> <i
15350 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
15360 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e  b>height</b> <i>
15370 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
15380 3e 62 61 6e 64 49 6e 64 65 78 52 65 64 3c 2f 62  >bandIndexRed</b
15390 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
153a0 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 47   , <b>bandIndexG
153b0 72 65 65 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  reen</b> <i>Inte
153c0 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e  ger</i> , <b>ban
153d0 64 49 6e 64 65 78 42 6c 75 65 3c 2f 62 3e 20 3c  dIndexBlue</b> <
153e0 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 20 2c  i>Integer</i>  ,
153f0 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c   <b>boundingBox<
15400 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d  /b> <i>BLOB-Geom
15410 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f  etry</i> , <b>ho
15420 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rzPixelResolutio
15430 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c  n</b> <i>Double<
15440 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69 78  /i> , <b>vertPix
15450 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e  elResolution</b>
15460 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c   <i>Double</i> ,
15470 20 3c 62 3e 74 69 66 66 43 6f 6d 70 72 65 73 73   <b>tiffCompress
15480 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ion</b> <i>Strin
15490 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74  g</i> ) : <i>Int
154a0 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e  eger</i><br><br>
154b0 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65 54 72  ..<b>RL2_WriteTr
154c0 69 70 6c 65 42 61 6e 64 54 69 66 66 54 46 57 3c  ipleBandTiffTFW<
154d0 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69  /b> ( <b>dbPrefi
154e0 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  x</b> <i>String<
154f0 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67  /i> , <b>coverag
15500 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  eName</b> <i>Str
15510 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c  ing</i> , <b>fil
15520 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72  ePath</b> <i>Str
15530 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64  ing</i> , <b>wid
15540 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  th</b> <i>Intege
15550 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68  r</i> , <b>heigh
15560 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  t</b> <i>Integer
15570 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e  </i> , <b>bandIn
15580 64 65 78 52 65 64 3c 2f 62 3e 20 3c 69 3e 49 6e  dexRed</b> <i>In
15590 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
155a0 61 6e 64 49 6e 64 65 78 47 72 65 65 6e 3c 2f 62  andIndexGreen</b
155b0 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
155c0 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 42   , <b>bandIndexB
155d0 6c 75 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  lue</b> <i>Integ
155e0 65 72 3c 2f 69 3e 20 20 2c 20 3c 62 3e 62 6f 75  er</i>  , <b>bou
155f0 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e  ndingBox</b> <i>
15600 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69  BLOB-Geometry</i
15610 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50 69 78 65 6c  > , <b>horzPixel
15620 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c  Resolution</b> <
15630 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c  i>Double</i> , <
15640 62 3e 76 65 72 74 50 69 78 65 6c 52 65 73 6f 6c  b>vertPixelResol
15650 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75  ution</b> <i>Dou
15660 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 66  ble</i> , <b>tif
15670 66 43 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 62 3e  fCompression</b>
15680 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
15690 20 3c 62 3e 74 69 66 66 54 69 6c 65 53 69 7a 65   <b>tiffTileSize
156a0 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
156b0 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67  /i> ) : <i>Integ
156c0 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  er</i></td>..<td
156d0 3e 57 69 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f  >Will attempt to
156e0 20 65 78 70 6f 72 74 20 72 61 77 20 72 61 73 74   export raw rast
156f0 65 72 20 64 61 74 61 20 66 72 6f 6d 20 61 20 4d  er data from a M
15700 55 4c 54 49 42 41 4e 44 20 6f 72 20 52 47 42 20  ULTIBAND or RGB 
15710 43 6f 76 65 72 61 67 65 20 69 6e 74 6f 20 61 6e  Coverage into an
15720 20 65 78 74 65 72 6e 61 6c 20 70 6c 61 69 6e 20   external plain 
15730 54 49 46 46 20 66 69 6c 65 20 6f 66 20 74 68 65  TIFF file of the
15740 20 52 47 42 20 74 79 70 65 20 73 75 70 70 6f 72   RGB type suppor
15750 74 65 64 20 62 79 20 61 6e 20 61 75 78 69 6c 69  ted by an auxili
15760 61 72 79 20 57 6f 72 6c 64 46 69 6c 65 2e 3c 62  ary WorldFile.<b
15770 72 3e 0d 0a 57 69 6c 6c 20 72 65 74 75 72 6e 20  r>..Will return 
15780 3c 62 3e 31 3c 2f 62 3e 20 28 54 52 55 45 2f 53  <b>1</b> (TRUE/S
15790 55 43 43 45 53 53 29 20 6f 72 20 3c 62 3e 30 3c  UCCESS) or <b>0<
157a0 2f 62 3e 20 28 46 41 4c 53 45 2f 46 41 49 4c 55  /b> (FALSE/FAILU
157b0 52 45 29 3a 20 6f 72 20 3c 62 3e 2d 31 3c 2f 62  RE): or <b>-1</b
157c0 3e 20 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72 67  > on invalid arg
157d0 75 6d 65 6e 74 73 2e 3c 62 72 3e 0d 0a 3c 75 3e  uments.<br>..<u>
157e0 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a  Please note</u>:
157f0 20 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65   ..<ul>..<li>The
15800 20 3c 62 3e 3c 69 3e 64 62 50 72 65 66 69 78 3c   <b><i>dbPrefix<
15810 2f 69 3e 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74  /i></b> argument
15820 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20   is intended to 
15830 73 70 65 63 69 66 79 20 74 68 65 20 41 54 54 41  specify the ATTA
15840 43 48 45 44 2d 44 42 20 77 68 65 72 65 20 74 68  CHED-DB where th
15850 65 20 43 6f 76 65 72 61 67 65 20 69 73 20 65 78  e Coverage is ex
15860 70 65 63 74 65 64 20 74 6f 20 62 65 20 66 6f 75  pected to be fou
15870 6e 64 3b 20 69 74 20 63 6f 75 6c 64 20 62 65 20  nd; it could be 
15880 65 76 65 6e 74 75 61 6c 6c 79 20 3c 62 3e 4e 55  eventually <b>NU
15890 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69 6e 20 74  LL</b>, and in t
158a0 68 69 73 20 63 61 73 65 20 74 68 65 20 3c 62 3e  his case the <b>
158b0 4d 41 49 4e 20 44 42 3c 2f 62 3e 20 77 69 6c 6c  MAIN DB</b> will
158c0 20 69 6d 70 6c 69 63 69 74 6c 79 20 62 65 20 61   implicitly be a
158d0 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c  ssumed.</li>..<l
158e0 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 62 61 6e 64  i>the <b><i>band
158f0 49 6e 64 65 78 52 65 64 3c 2f 62 3e 3c 2f 69 3e  IndexRed</b></i>
15900 2c 20 3c 62 3e 3c 69 3e 62 61 6e 64 49 6e 64 65  , <b><i>bandInde
15910 78 47 72 65 65 6e 3c 2f 69 3e 3c 2f 62 3e 20 61  xGreen</i></b> a
15920 6e 64 20 3c 62 3e 3c 69 3e 62 61 6e 64 49 6e 64  nd <b><i>bandInd
15930 65 78 42 6c 75 65 3c 2f 69 3e 3c 2f 62 3e 20 61  exBlue</i></b> a
15940 72 67 75 6d 65 6e 74 73 20 61 72 65 20 69 6e 74  rguments are int
15950 65 6e 64 65 64 20 74 6f 20 61 72 62 69 74 72 61  ended to arbitra
15960 72 69 6c 79 20 63 6f 6d 70 6f 73 65 20 74 68 65  rily compose the
15970 20 52 47 42 20 54 49 46 46 20 73 74 61 72 74 69   RGB TIFF starti
15980 6e 67 20 66 72 6f 6d 20 74 68 65 20 42 61 6e 64  ng from the Band
15990 73 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74  s supported by t
159a0 68 65 20 43 6f 76 65 72 61 67 65 2e 0d 0a 3c 62  he Coverage...<b
159b0 72 3e 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65  r><u>Please note
159c0 3c 2f 75 3e 3a 20 74 68 65 20 66 69 72 73 74 20  </u>: the first 
159d0 42 61 6e 64 20 61 6c 77 61 79 73 20 63 6f 72 72  Band always corr
159e0 65 73 70 6f 6e 64 73 20 74 6f 20 69 6e 64 65 78  esponds to index
159f0 20 3c 62 3e 5a 45 52 4f 3c 2f 62 3e 3c 2f 6c 69   <b>ZERO</b></li
15a00 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69  >..<li>the <b><i
15a10 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 69 3e  >boundingBox</i>
15a20 3c 2f 62 3e 20 69 73 20 65 78 70 65 63 74 65 64  </b> is expected
15a30 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20 74 68   to represent th
15a40 65 20 6f 76 65 72 61 6c 6c 20 65 78 74 65 6e 74  e overall extent
15a50 20 6f 66 20 74 68 65 20 65 78 70 6f 72 74 65 64   of the exported
15a60 20 54 49 46 46 3b 20 79 6f 75 20 63 6f 75 6c 64   TIFF; you could
15a70 20 65 76 65 6e 74 75 61 6c 6c 79 20 70 61 73 73   eventually pass
15a80 20 61 6e 79 20 61 72 62 69 74 72 61 72 79 20 6b   any arbitrary k
15a90 69 6e 64 20 6f 66 20 47 65 6f 6d 65 74 72 79 2c  ind of Geometry,
15aa0 20 61 6e 64 20 74 68 65 20 42 6f 75 6e 64 69 6e   and the Boundin
15ab0 67 20 42 6f 78 20 61 6b 61 20 4d 42 52 20 77 69  g Box aka MBR wi
15ac0 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69 63 61  ll be automatica
15ad0 6c 6c 79 20 64 65 74 65 72 6d 69 6e 65 64 2e 3c  lly determined.<
15ae0 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62  /li>..<li>the <b
15af0 3e 3c 69 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73  ><i>horzPixelRes
15b00 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20  olution</i></b> 
15b10 61 6e 64 20 3c 62 3e 3c 69 3e 76 65 72 74 50 69  and <b><i>vertPi
15b20 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 69  xelResolution</i
15b30 3e 3c 2f 62 3e 20 6d 75 73 74 20 65 78 61 63 74  ></b> must exact
15b40 6c 79 20 6d 61 74 63 68 20 74 68 65 20 43 6f 76  ly match the Cov
15b50 65 72 61 67 65 27 73 20 62 61 73 65 20 72 65 73  erage's base res
15b60 6f 6c 75 74 69 6f 6e 20 6f 72 20 6f 6e 65 20 6f  olution or one o
15b70 66 20 74 68 65 20 72 65 73 6f 6c 75 74 69 6f 6e  f the resolution
15b80 73 20 6d 61 64 65 20 61 76 61 69 6c 61 62 6c 65  s made available
15b90 20 62 79 20 74 68 65 20 63 6f 72 72 65 73 70 6f   by the correspo
15ba0 6e 64 69 6e 67 20 50 79 72 61 6d 69 64 20 6c 65  nding Pyramid le
15bb0 76 65 6c 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  vels.</li>..<li>
15bc0 61 6e 64 20 74 68 65 20 42 6f 75 6e 64 69 6e 67  and the Bounding
15bd0 42 6f 78 20 6d 75 73 74 20 65 78 61 63 74 6c 79  Box must exactly
15be0 20 6d 61 74 63 68 20 74 68 65 20 54 49 46 46 20   match the TIFF 
15bf0 3c 62 3e 3c 69 3e 77 69 64 74 68 3c 2f 69 3e 3c  <b><i>width</i><
15c00 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e 68 65  /b> and <b><i>he
15c10 69 67 68 74 3c 2f 69 3e 3c 2f 62 3e 20 64 69 6d  ight</i></b> dim
15c20 65 6e 73 69 6f 6e 73 20 61 74 20 74 68 61 74 20  ensions at that 
15c30 72 65 73 6f 6c 75 74 69 6f 6e 2e 3c 2f 6c 69 3e  resolution.</li>
15c40 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e  ..<li>the option
15c50 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 3c  al argument <b><
15c60 69 3e 74 69 66 66 43 6f 6d 70 72 65 73 73 69 6f  i>tiffCompressio
15c70 6e 3c 2f 69 3e 3c 2f 62 3e 20 63 6f 75 6c 64 20  n</i></b> could 
15c80 62 65 20 6f 6e 65 20 6f 66 20 3c 62 3e 27 4e 4f  be one of <b>'NO
15c90 4e 45 27 3c 2f 62 3e 2c 20 3c 62 3e 27 44 45 46  NE'</b>, <b>'DEF
15ca0 4c 41 54 45 27 3c 2f 62 3e 2c 20 3c 62 3e 27 4c  LATE'</b>, <b>'L
15cb0 5a 57 27 3c 2f 62 3e 2c 20 3c 62 3e 27 4a 50 45  ZW'</b>, <b>'JPE
15cc0 47 27 3c 2f 62 3e 2c 20 3c 62 3e 27 46 41 58 33  G'</b>, <b>'FAX3
15cd0 27 3c 2f 62 3e 20 6f 72 20 3c 62 3e 27 46 41 58  '</b> or <b>'FAX
15ce0 34 27 3c 2f 62 3e 3b 20 64 65 66 61 75 6c 74 20  4'</b>; default 
15cf0 69 73 20 3c 62 3e 27 4e 4f 4e 45 27 3c 2f 62 3e  is <b>'NONE'</b>
15d00 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20  .</li>..<li>the 
15d10 6c 61 73 74 20 6f 70 74 69 6f 6e 61 6c 20 61 72  last optional ar
15d20 67 75 6d 65 6e 74 20 63 61 6e 20 62 65 20 75 73  gument can be us
15d30 65 64 20 73 6f 20 74 6f 20 73 70 65 63 69 66 79  ed so to specify
15d40 20 74 68 65 20 70 72 65 66 65 72 72 65 64 20 54   the preferred T
15d50 49 46 46 20 74 69 6c 65 20 73 69 7a 65 20 28 6f  IFF tile size (o
15d60 6e 6c 79 20 73 71 75 61 72 65 20 74 69 6c 65 73  nly square tiles
15d70 20 61 72 65 20 73 75 70 70 6f 72 74 65 64 29 3b   are supported);
15d80 20 64 65 66 61 75 6c 74 20 69 73 20 3c 62 3e 32   default is <b>2
15d90 35 36 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 2f  56</b>.</li>..</
15da0 75 6c 3e 0d 0a 3c 74 61 62 6c 65 20 77 69 64 74  ul>..<table widt
15db0 68 3d 22 31 30 30 25 22 20 62 67 63 6f 6c 6f 72  h="100%" bgcolor
15dc0 3d 22 23 66 66 64 30 38 30 22 20 63 65 6c 6c 70  ="#ffd080" cellp
15dd0 61 64 64 69 6e 67 3d 22 36 22 3e 3c 74 72 3e 3c  adding="6"><tr><
15de0 74 64 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e  td>..<u>Please n
15df0 6f 74 65 20 76 65 72 79 20 77 65 6c 6c 3c 2f 75  ote very well</u
15e00 3e 3a 20 74 68 69 73 20 53 51 4c 20 66 75 6e 63  >: this SQL func
15e10 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 61 76 61  tion is only ava
15e20 69 6c 61 62 6c 65 20 77 68 65 6e 20 74 68 65 20  ilable when the 
15e30 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69  environment vari
15e40 61 62 6c 65 20 3c 62 3e 53 50 41 54 49 41 4c 49  able <b>SPATIALI
15e50 54 45 5f 53 45 43 55 52 49 54 59 3d 72 65 6c 61  TE_SECURITY=rela
15e60 78 65 64 3c 2f 62 3e 20 69 73 20 73 65 74 2e 3c  xed</b> is set.<
15e70 2f 74 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c 65  /td></tr></table
15e80 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c  ></td>..</tr>..<
15e90 74 72 3e 3c 74 64 3e 3c 62 3e 52 4c 32 5f 57 72  tr><td><b>RL2_Wr
15ea0 69 74 65 54 72 69 70 6c 65 42 61 6e 64 54 69 66  iteTripleBandTif
15eb0 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65  f</b> ( <b>dbPre
15ec0 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  fix</b> <i>Strin
15ed0 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72  g</i> , <b>cover
15ee0 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  ageName</b> <i>S
15ef0 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66  tring</i> , <b>f
15f00 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53  ilePath</b> <i>S
15f10 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77  tring</i> , <b>w
15f20 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  idth</b> <i>Inte
15f30 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69  ger</i> , <b>hei
15f40 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  ght</b> <i>Integ
15f50 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64  er</i> , <b>band
15f60 49 6e 64 65 78 52 65 64 3c 2f 62 3e 20 3c 69 3e  IndexRed</b> <i>
15f70 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
15f80 3e 62 61 6e 64 49 6e 64 65 78 47 72 65 65 6e 3c  >bandIndexGreen<
15f90 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
15fa0 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65  i> , <b>bandInde
15fb0 78 42 6c 75 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74  xBlue</b> <i>Int
15fc0 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f  eger</i> , <b>bo
15fd0 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69  undingBox</b> <i
15fe0 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f  >BLOB-Geometry</
15ff0 69 3e 20 2c 20 3c 62 3e 70 69 78 65 6c 52 65 73  i> , <b>pixelRes
16000 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44  olution</b> <i>D
16010 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c 69  ouble</i> ) : <i
16020 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e  >Integer</i><br>
16030 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69  <br>..<b>RL2_Wri
16040 74 65 54 72 69 70 6c 65 42 61 6e 64 54 69 66 66  teTripleBandTiff
16050 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66  </b> ( <b>dbPref
16060 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  ix</b> <i>String
16070 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61  </i> , <b>covera
16080 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74  geName</b> <i>St
16090 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69  ring</i> , <b>fi
160a0 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74  lePath</b> <i>St
160b0 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69  ring</i> , <b>wi
160c0 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  dth</b> <i>Integ
160d0 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67  er</i> , <b>heig
160e0 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ht</b> <i>Intege
160f0 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49  r</i> , <b>bandI
16100 6e 64 65 78 52 65 64 3c 2f 62 3e 20 3c 69 3e 49  ndexRed</b> <i>I
16110 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
16120 62 61 6e 64 49 6e 64 65 78 47 72 65 65 6e 3c 2f  bandIndexGreen</
16130 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
16140 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78  > , <b>bandIndex
16150 42 6c 75 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  Blue</b> <i>Inte
16160 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62 3e 62 6f  ger</i>  , <b>bo
16170 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69  undingBox</b> <i
16180 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f  >BLOB-Geometry</
16190 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50 69 78 65  i> , <b>horzPixe
161a0 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20  lResolution</b> 
161b0 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20  <i>Double</i> , 
161c0 3c 62 3e 76 65 72 74 50 69 78 65 6c 52 65 73 6f  <b>vertPixelReso
161d0 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f  lution</b> <i>Do
161e0 75 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e  uble</i> ) : <i>
161f0 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c  Integer</i><br><
16200 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69 74  br>..<b>RL2_Writ
16210 65 54 72 69 70 6c 65 42 61 6e 64 54 69 66 66 3c  eTripleBandTiff<
16220 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69  /b> ( <b>dbPrefi
16230 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  x</b> <i>String<
16240 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67  /i> , <b>coverag
16250 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  eName</b> <i>Str
16260 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c  ing</i> , <b>fil
16270 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72  ePath</b> <i>Str
16280 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64  ing</i> , <b>wid
16290 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  th</b> <i>Intege
162a0 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68  r</i> , <b>heigh
162b0 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  t</b> <i>Integer
162c0 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e  </i> , <b>bandIn
162d0 64 65 78 52 65 64 3c 2f 62 3e 20 3c 69 3e 49 6e  dexRed</b> <i>In
162e0 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
162f0 61 6e 64 49 6e 64 65 78 47 72 65 65 6e 3c 2f 62  andIndexGreen</b
16300 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
16310 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 42   , <b>bandIndexB
16320 6c 75 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  lue</b> <i>Integ
16330 65 72 3c 2f 69 3e 20 20 2c 20 3c 62 3e 62 6f 75  er</i>  , <b>bou
16340 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e  ndingBox</b> <i>
16350 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69  BLOB-Geometry</i
16360 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50 69 78 65 6c  > , <b>horzPixel
16370 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c  Resolution</b> <
16380 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c  i>Double</i> , <
16390 62 3e 76 65 72 74 50 69 78 65 6c 52 65 73 6f 6c  b>vertPixelResol
163a0 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75  ution</b> <i>Dou
163b0 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 66  ble</i> , <b>tif
163c0 66 43 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 62 3e  fCompression</b>
163d0 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29   <i>String</i> )
163e0 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69   : <i>Integer</i
163f0 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c  ><br><br>..<b>RL
16400 32 5f 57 72 69 74 65 54 72 69 70 6c 65 42 61 6e  2_WriteTripleBan
16410 64 54 69 66 66 3c 2f 62 3e 20 28 20 3c 62 3e 64  dTiff</b> ( <b>d
16420 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53  bPrefix</b> <i>S
16430 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63  tring</i> , <b>c
16440 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20  overageName</b> 
16450 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
16460 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20  <b>filePath</b> 
16470 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
16480 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e  <b>width</b> <i>
16490 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
164a0 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49  >height</b> <i>I
164b0 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
164c0 62 61 6e 64 49 6e 64 65 78 52 65 64 3c 2f 62 3e  bandIndexRed</b>
164d0 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
164e0 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 47 72  , <b>bandIndexGr
164f0 65 65 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  een</b> <i>Integ
16500 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64  er</i> , <b>band
16510 49 6e 64 65 78 42 6c 75 65 3c 2f 62 3e 20 3c 69  IndexBlue</b> <i
16520 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 20 2c 20  >Integer</i>  , 
16530 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f  <b>boundingBox</
16540 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65  b> <i>BLOB-Geome
16550 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72  try</i> , <b>hor
16560 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  zPixelResolution
16570 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f  </b> <i>Double</
16580 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69 78 65  i> , <b>vertPixe
16590 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20  lResolution</b> 
165a0 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20  <i>Double</i> , 
165b0 3c 62 3e 74 69 66 66 43 6f 6d 70 72 65 73 73 69  <b>tiffCompressi
165c0 6f 6e 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  on</b> <i>String
165d0 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 66 66 54 69  </i> , <b>tiffTi
165e0 6c 65 53 69 7a 65 3c 2f 62 3e 20 3c 69 3e 49 6e  leSize</b> <i>In
165f0 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69  teger</i> ) : <i
16600 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64  >Integer</i></td
16610 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 61 74 74 65  >..<td>Will atte
16620 6d 70 74 20 74 6f 20 65 78 70 6f 72 74 20 72 61  mpt to export ra
16630 77 20 72 61 73 74 65 72 20 64 61 74 61 20 66 72  w raster data fr
16640 6f 6d 20 61 20 4d 55 4c 54 49 42 41 4e 44 20 6f  om a MULTIBAND o
16650 72 20 52 47 42 20 43 6f 76 65 72 61 67 65 20 69  r RGB Coverage i
16660 6e 74 6f 20 61 6e 20 65 78 74 65 72 6e 61 6c 20  nto an external 
16670 70 6c 61 69 6e 20 54 49 46 46 20 66 69 6c 65 20  plain TIFF file 
16680 6f 66 20 74 68 65 20 52 47 42 20 74 79 70 65 2e  of the RGB type.
16690 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72 65 74 75 72  <br>..Will retur
166a0 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28 54 52 55 45  n <b>1</b> (TRUE
166b0 2f 53 55 43 43 45 53 53 29 20 6f 72 20 3c 62 3e  /SUCCESS) or <b>
166c0 30 3c 2f 62 3e 20 28 46 41 4c 53 45 2f 46 41 49  0</b> (FALSE/FAI
166d0 4c 55 52 45 29 3a 20 6f 72 20 3c 62 3e 2d 31 3c  LURE): or <b>-1<
166e0 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69 64 20 61  /b> on invalid a
166f0 72 67 75 6d 65 6e 74 73 2e 3c 62 72 3e 0d 0a 3c  rguments.<br>..<
16700 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75  u>Please note</u
16710 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54  >: ..<ul>..<li>T
16720 68 65 20 3c 62 3e 3c 69 3e 64 62 50 72 65 66 69  he <b><i>dbPrefi
16730 78 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67 75 6d 65  x</i></b> argume
16740 6e 74 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74  nt is intended t
16750 6f 20 73 70 65 63 69 66 79 20 74 68 65 20 41 54  o specify the AT
16760 54 41 43 48 45 44 2d 44 42 20 77 68 65 72 65 20  TACHED-DB where 
16770 74 68 65 20 43 6f 76 65 72 61 67 65 20 69 73 20  the Coverage is 
16780 65 78 70 65 63 74 65 64 20 74 6f 20 62 65 20 66  expected to be f
16790 6f 75 6e 64 3b 20 69 74 20 63 6f 75 6c 64 20 62  ound; it could b
167a0 65 20 65 76 65 6e 74 75 61 6c 6c 79 20 3c 62 3e  e eventually <b>
167b0 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69 6e  NULL</b>, and in
167c0 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 3c   this case the <
167d0 62 3e 4d 41 49 4e 20 44 42 3c 2f 62 3e 20 77 69  b>MAIN DB</b> wi
167e0 6c 6c 20 69 6d 70 6c 69 63 69 74 6c 79 20 62 65  ll implicitly be
167f0 20 61 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a   assumed.</li>..
16800 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 62 61  <li>the <b><i>ba
16810 6e 64 49 6e 64 65 78 52 65 64 3c 2f 62 3e 3c 2f  ndIndexRed</b></
16820 69 3e 2c 20 3c 62 3e 3c 69 3e 62 61 6e 64 49 6e  i>, <b><i>bandIn
16830 64 65 78 47 72 65 65 6e 3c 2f 69 3e 3c 2f 62 3e  dexGreen</i></b>
16840 20 61 6e 64 20 3c 62 3e 3c 69 3e 62 61 6e 64 49   and <b><i>bandI
16850 6e 64 65 78 42 6c 75 65 3c 2f 69 3e 3c 2f 62 3e  ndexBlue</i></b>
16860 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65 20 69   arguments are i
16870 6e 74 65 6e 64 65 64 20 74 6f 20 61 72 62 69 74  ntended to arbit
16880 72 61 72 69 6c 79 20 63 6f 6d 70 6f 73 65 20 74  rarily compose t
16890 68 65 20 52 47 42 20 54 49 46 46 20 73 74 61 72  he RGB TIFF star
168a0 74 69 6e 67 20 66 72 6f 6d 20 74 68 65 20 42 61  ting from the Ba
168b0 6e 64 73 20 73 75 70 70 6f 72 74 65 64 20 62 79  nds supported by
168c0 20 74 68 65 20 43 6f 76 65 72 61 67 65 2e 0d 0a   the Coverage...
168d0 3c 62 72 3e 3c 75 3e 50 6c 65 61 73 65 20 6e 6f  <br><u>Please no
168e0 74 65 3c 2f 75 3e 3a 20 74 68 65 20 66 69 72 73  te</u>: the firs
168f0 74 20 42 61 6e 64 20 61 6c 77 61 79 73 20 63 6f  t Band always co
16900 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 69 6e 64  rresponds to ind
16910 65 78 20 3c 62 3e 5a 45 52 4f 3c 2f 62 3e 3c 2f  ex <b>ZERO</b></
16920 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e  li>..<li>the <b>
16930 3c 69 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f  <i>boundingBox</
16940 69 3e 3c 2f 62 3e 20 69 73 20 65 78 70 65 63 74  i></b> is expect
16950 65 64 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20  ed to represent 
16960 74 68 65 20 6f 76 65 72 61 6c 6c 20 65 78 74 65  the overall exte
16970 6e 74 20 6f 66 20 74 68 65 20 65 78 70 6f 72 74  nt of the export
16980 65 64 20 54 49 46 46 3b 20 79 6f 75 20 63 6f 75  ed TIFF; you cou
16990 6c 64 20 65 76 65 6e 74 75 61 6c 6c 79 20 70 61  ld eventually pa
169a0 73 73 20 61 6e 79 20 61 72 62 69 74 72 61 72 79  ss any arbitrary
169b0 20 6b 69 6e 64 20 6f 66 20 47 65 6f 6d 65 74 72   kind of Geometr
169c0 79 2c 20 61 6e 64 20 74 68 65 20 42 6f 75 6e 64  y, and the Bound
169d0 69 6e 67 20 42 6f 78 20 61 6b 61 20 4d 42 52 20  ing Box aka MBR 
169e0 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69  will be automati
169f0 63 61 6c 6c 79 20 64 65 74 65 72 6d 69 6e 65 64  cally determined
16a00 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20  .</li>..<li>the 
16a10 3c 62 3e 3c 69 3e 68 6f 72 7a 50 69 78 65 6c 52  <b><i>horzPixelR
16a20 65 73 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62  esolution</i></b
16a30 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e 76 65 72 74  > and <b><i>vert
16a40 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c  PixelResolution<
16a50 2f 69 3e 3c 2f 62 3e 20 6d 75 73 74 20 65 78 61  /i></b> must exa
16a60 63 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20 43  ctly match the C
16a70 6f 76 65 72 61 67 65 27 73 20 62 61 73 65 20 72  overage's base r
16a80 65 73 6f 6c 75 74 69 6f 6e 20 6f 72 20 6f 6e 65  esolution or one
16a90 20 6f 66 20 74 68 65 20 72 65 73 6f 6c 75 74 69   of the resoluti
16aa0 6f 6e 73 20 6d 61 64 65 20 61 76 61 69 6c 61 62  ons made availab
16ab0 6c 65 20 62 79 20 74 68 65 20 63 6f 72 72 65 73  le by the corres
16ac0 70 6f 6e 64 69 6e 67 20 50 79 72 61 6d 69 64 20  ponding Pyramid 
16ad0 6c 65 76 65 6c 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c  levels.</li>..<l
16ae0 69 3e 61 6e 64 20 74 68 65 20 42 6f 75 6e 64 69  i>and the Boundi
16af0 6e 67 42 6f 78 20 6d 75 73 74 20 65 78 61 63 74  ngBox must exact
16b00 6c 79 20 6d 61 74 63 68 20 74 68 65 20 54 49 46  ly match the TIF
16b10 46 20 3c 62 3e 3c 69 3e 77 69 64 74 68 3c 2f 69  F <b><i>width</i
16b20 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e  ></b> and <b><i>
16b30 68 65 69 67 68 74 3c 2f 69 3e 3c 2f 62 3e 20 64  height</i></b> d
16b40 69 6d 65 6e 73 69 6f 6e 73 20 61 74 20 74 68 61  imensions at tha
16b50 74 20 72 65 73 6f 6c 75 74 69 6f 6e 2e 3c 2f 6c  t resolution.</l
16b60 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69  i>..<li>the opti
16b70 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62  onal argument <b
16b80 3e 3c 69 3e 74 69 66 66 43 6f 6d 70 72 65 73 73  ><i>tiffCompress
16b90 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 63 6f 75 6c  ion</i></b> coul
16ba0 64 20 62 65 20 6f 6e 65 20 6f 66 20 3c 62 3e 27  d be one of <b>'
16bb0 4e 4f 4e 45 27 3c 2f 62 3e 2c 20 3c 62 3e 27 44  NONE'</b>, <b>'D
16bc0 45 46 4c 41 54 45 27 3c 2f 62 3e 2c 20 3c 62 3e  EFLATE'</b>, <b>
16bd0 27 4c 5a 57 27 3c 2f 62 3e 2c 20 3c 62 3e 27 4a  'LZW'</b>, <b>'J
16be0 50 45 47 27 3c 2f 62 3e 2c 20 3c 62 3e 27 46 41  PEG'</b>, <b>'FA
16bf0 58 33 27 3c 2f 62 3e 20 6f 72 20 3c 62 3e 27 46  X3'</b> or <b>'F
16c00 41 58 34 27 3c 2f 62 3e 3b 20 64 65 66 61 75 6c  AX4'</b>; defaul
16c10 74 20 69 73 20 3c 62 3e 27 4e 4f 4e 45 27 3c 2f  t is <b>'NONE'</
16c20 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68  b>.</li>..<li>th
16c30 65 20 6c 61 73 74 20 6f 70 74 69 6f 6e 61 6c 20  e last optional 
16c40 61 72 67 75 6d 65 6e 74 20 63 61 6e 20 62 65 20  argument can be 
16c50 75 73 65 64 20 73 6f 20 74 6f 20 73 70 65 63 69  used so to speci
16c60 66 79 20 74 68 65 20 70 72 65 66 65 72 72 65 64  fy the preferred
16c70 20 54 49 46 46 20 74 69 6c 65 20 73 69 7a 65 20   TIFF tile size 
16c80 28 6f 6e 6c 79 20 73 71 75 61 72 65 20 74 69 6c  (only square til
16c90 65 73 20 61 72 65 20 73 75 70 70 6f 72 74 65 64  es are supported
16ca0 29 3b 20 64 65 66 61 75 6c 74 20 69 73 20 3c 62  ); default is <b
16cb0 3e 32 35 36 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a  >256</b>.</li>..
16cc0 3c 2f 75 6c 3e 0d 0a 3c 74 61 62 6c 65 20 77 69  </ul>..<table wi
16cd0 64 74 68 3d 22 31 30 30 25 22 20 62 67 63 6f 6c  dth="100%" bgcol
16ce0 6f 72 3d 22 23 66 66 64 30 38 30 22 20 63 65 6c  or="#ffd080" cel
16cf0 6c 70 61 64 64 69 6e 67 3d 22 36 22 3e 3c 74 72  lpadding="6"><tr
16d00 3e 3c 74 64 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65  ><td>..<u>Please
16d10 20 6e 6f 74 65 20 76 65 72 79 20 77 65 6c 6c 3c   note very well<
16d20 2f 75 3e 3a 20 74 68 69 73 20 53 51 4c 20 66 75  /u>: this SQL fu
16d30 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 61  nction is only a
16d40 76 61 69 6c 61 62 6c 65 20 77 68 65 6e 20 74 68  vailable when th
16d50 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61  e environment va
16d60 72 69 61 62 6c 65 20 3c 62 3e 53 50 41 54 49 41  riable <b>SPATIA
16d70 4c 49 54 45 5f 53 45 43 55 52 49 54 59 3d 72 65  LITE_SECURITY=re
16d80 6c 61 78 65 64 3c 2f 62 3e 20 69 73 20 73 65 74  laxed</b> is set
16d90 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62  .</td></tr></tab
16da0 6c 65 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d  le></td>..</tr>.
16db0 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 52 4c 32 5f  .<tr><td><b>RL2_
16dc0 57 72 69 74 65 4d 6f 6e 6f 42 61 6e 64 47 65 6f  WriteMonoBandGeo
16dd0 54 69 66 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62  Tiff</b> ( <b>db
16de0 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74  Prefix</b> <i>St
16df0 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f  ring</i> , <b>co
16e00 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c  verageName</b> <
16e10 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
16e20 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c  b>filePath</b> <
16e30 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
16e40 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49  b>width</b> <i>I
16e50 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
16e60 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e  height</b> <i>In
16e70 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
16e80 61 6e 64 49 6e 64 65 78 47 72 61 79 3c 2f 62 3e  andIndexGray</b>
16e90 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
16ea0 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78  , <b>boundingBox
16eb0 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f  </b> <i>BLOB-Geo
16ec0 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 70  metry</i> , <b>p
16ed0 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
16ee0 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e  b> <i>Double</i>
16ef0 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c   ) : <i>Integer<
16f00 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e  /i><br><br>..<b>
16f10 52 4c 32 5f 57 72 69 74 65 4d 6f 6e 6f 42 61 6e  RL2_WriteMonoBan
16f20 64 47 65 6f 54 69 66 66 3c 2f 62 3e 20 28 20 3c  dGeoTiff</b> ( <
16f30 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c  b>dbPrefix</b> <
16f40 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
16f50 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f  b>coverageName</
16f60 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
16f70 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f   , <b>filePath</
16f80 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
16f90 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20   , <b>width</b> 
16fa0 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
16fb0 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c   <b>height</b> <
16fc0 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
16fd0 3c 62 3e 62 61 6e 64 49 6e 64 65 78 47 72 61 79  <b>bandIndexGray
16fe0 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
16ff0 2f 69 3e 20 20 2c 20 3c 62 3e 62 6f 75 6e 64 69  /i>  , <b>boundi
17000 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f  ngBox</b> <i>BLO
17010 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c  B-Geometry</i> ,
17020 20 3c 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73   <b>horzPixelRes
17030 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44  olution</b> <i>D
17040 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76  ouble</i> , <b>v
17050 65 72 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69  ertPixelResoluti
17060 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65  on</b> <i>Double
17070 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65  </i> ) : <i>Inte
17080 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d  ger</i><br><br>.
17090 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65 4d 6f 6e  .<b>RL2_WriteMon
170a0 6f 42 61 6e 64 47 65 6f 54 69 66 66 3c 2f 62 3e  oBandGeoTiff</b>
170b0 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f   ( <b>dbPrefix</
170c0 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
170d0 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61   , <b>coverageNa
170e0 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  me</b> <i>String
170f0 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61  </i> , <b>filePa
17100 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  th</b> <i>String
17110 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c  </i> , <b>width<
17120 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
17130 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f  i> , <b>height</
17140 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
17150 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78  > , <b>bandIndex
17160 47 72 61 79 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  Gray</b> <i>Inte
17170 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62 3e 62 6f  ger</i>  , <b>bo
17180 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69  undingBox</b> <i
17190 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f  >BLOB-Geometry</
171a0 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50 69 78 65  i> , <b>horzPixe
171b0 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20  lResolution</b> 
171c0 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20  <i>Double</i> , 
171d0 3c 62 3e 76 65 72 74 50 69 78 65 6c 52 65 73 6f  <b>vertPixelReso
171e0 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f  lution</b> <i>Do
171f0 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69  uble</i> , <b>wi
17200 74 68 57 6f 6c 64 46 69 6c 65 3c 2f 62 3e 20 3c  thWoldFile</b> <
17210 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20  i>Integer</i> ) 
17220 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  : <i>Integer</i>
17230 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32  <br><br>..<b>RL2
17240 5f 57 72 69 74 65 4d 6f 6e 6f 42 61 6e 64 47 65  _WriteMonoBandGe
17250 6f 54 69 66 66 3c 2f 62 3e 20 28 20 3c 62 3e 64  oTiff</b> ( <b>d
17260 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53  bPrefix</b> <i>S
17270 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63  tring</i> , <b>c
17280 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20  overageName</b> 
17290 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
172a0 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20  <b>filePath</b> 
172b0 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
172c0 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e  <b>width</b> <i>
172d0 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
172e0 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49  >height</b> <i>I
172f0 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
17300 62 61 6e 64 49 6e 64 65 78 47 72 61 79 3c 2f 62  bandIndexGray</b
17310 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
17320 20 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42    , <b>boundingB
17330 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47  ox</b> <i>BLOB-G
17340 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62  eometry</i> , <b
17350 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75  >horzPixelResolu
17360 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62  tion</b> <i>Doub
17370 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74  le</i> , <b>vert
17380 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c  PixelResolution<
17390 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69  /b> <i>Double</i
173a0 3e 20 2c 20 3c 62 3e 77 69 74 68 57 6f 6c 64 46  > , <b>withWoldF
173b0 69 6c 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  ile</b> <i>Integ
173c0 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 66 66  er</i> , <b>tiff
173d0 43 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 62 3e 20  Compression</b> 
173e0 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20  <i>String</i> ) 
173f0 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  : <i>Integer</i>
17400 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32  <br><br>..<b>RL2
17410 5f 57 72 69 74 65 4d 6f 6e 6f 42 61 6e 64 47 65  _WriteMonoBandGe
17420 6f 54 69 66 66 3c 2f 62 3e 20 28 20 3c 62 3e 64  oTiff</b> ( <b>d
17430 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53  bPrefix</b> <i>S
17440 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63  tring</i> , <b>c
17450 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20  overageName</b> 
17460 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
17470 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20  <b>filePath</b> 
17480 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
17490 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e  <b>width</b> <i>
174a0 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
174b0 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49  >height</b> <i>I
174c0 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
174d0 62 61 6e 64 49 6e 64 65 78 47 72 61 79 3c 2f 62  bandIndexGray</b
174e0 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
174f0 20 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42    , <b>boundingB
17500 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47  ox</b> <i>BLOB-G
17510 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62  eometry</i> , <b
17520 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75  >horzPixelResolu
17530 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62  tion</b> <i>Doub
17540 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74  le</i> , <b>vert
17550 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c  PixelResolution<
17560 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69  /b> <i>Double</i
17570 3e 20 2c 20 3c 62 3e 77 69 74 68 57 6f 6c 64 46  > , <b>withWoldF
17580 69 6c 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  ile</b> <i>Integ
17590 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 66 66  er</i> , <b>tiff
175a0 43 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 62 3e 20  Compression</b> 
175b0 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
175c0 3c 62 3e 74 69 66 66 54 69 6c 65 53 69 7a 65 3c  <b>tiffTileSize<
175d0 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
175e0 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65  i> ) : <i>Intege
175f0 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e  r</i></td>..<td>
17600 57 69 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f 20  Will attempt to 
17610 65 78 70 6f 72 74 20 72 61 77 20 72 61 73 74 65  export raw raste
17620 72 20 64 61 74 61 20 66 72 6f 6d 20 61 20 4d 55  r data from a MU
17630 4c 54 49 42 41 4e 44 20 6f 72 20 52 47 42 20 43  LTIBAND or RGB C
17640 6f 76 65 72 61 67 65 20 69 6e 74 6f 20 61 6e 20  overage into an 
17650 65 78 74 65 72 6e 61 6c 20 47 65 6f 54 49 46 46  external GeoTIFF
17660 20 66 69 6c 65 20 6f 66 20 74 68 65 20 47 72 61   file of the Gra
17670 79 73 63 61 6c 65 20 74 79 70 65 2e 3c 62 72 3e  yscale type.<br>
17680 0d 0a 57 69 6c 6c 20 72 65 74 75 72 6e 20 3c 62  ..Will return <b
17690 3e 31 3c 2f 62 3e 20 28 54 52 55 45 2f 53 55 43  >1</b> (TRUE/SUC
176a0 43 45 53 53 29 20 6f 72 20 3c 62 3e 30 3c 2f 62  CESS) or <b>0</b
176b0 3e 20 28 46 41 4c 53 45 2f 46 41 49 4c 55 52 45  > (FALSE/FAILURE
176c0 29 3a 20 6f 72 20 3c 62 3e 2d 31 3c 2f 62 3e 20  ): or <b>-1</b> 
176d0 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d  on invalid argum
176e0 65 6e 74 73 2e 3c 62 72 3e 0d 0a 3c 75 3e 50 6c  ents.<br>..<u>Pl
176f0 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 0d  ease note</u>: .
17700 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 20 3c  .<ul>..<li>The <
17710 62 3e 3c 69 3e 64 62 50 72 65 66 69 78 3c 2f 69  b><i>dbPrefix</i
17720 3e 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 20 69  ></b> argument i
17730 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 73 70  s intended to sp
17740 65 63 69 66 79 20 74 68 65 20 41 54 54 41 43 48  ecify the ATTACH
17750 45 44 2d 44 42 20 77 68 65 72 65 20 74 68 65 20  ED-DB where the 
17760 43 6f 76 65 72 61 67 65 20 69 73 20 65 78 70 65  Coverage is expe
17770 63 74 65 64 20 74 6f 20 62 65 20 66 6f 75 6e 64  cted to be found
17780 3b 20 69 74 20 63 6f 75 6c 64 20 62 65 20 65 76  ; it could be ev
17790 65 6e 74 75 61 6c 6c 79 20 3c 62 3e 4e 55 4c 4c  entually <b>NULL
177a0 3c 2f 62 3e 2c 20 61 6e 64 20 69 6e 20 74 68 69  </b>, and in thi
177b0 73 20 63 61 73 65 20 74 68 65 20 3c 62 3e 4d 41  s case the <b>MA
177c0 49 4e 20 44 42 3c 2f 62 3e 20 77 69 6c 6c 20 69  IN DB</b> will i
177d0 6d 70 6c 69 63 69 74 6c 79 20 62 65 20 61 73 73  mplicitly be ass
177e0 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  umed.</li>..<li>
177f0 74 68 65 20 3c 62 3e 3c 69 3e 62 61 6e 64 49 6e  the <b><i>bandIn
17800 64 65 78 47 72 61 79 3c 2f 69 3e 3c 2f 62 3e 20  dexGray</i></b> 
17810 61 72 67 75 6d 65 6e 74 20 69 73 20 69 6e 74 65  argument is inte
17820 6e 64 65 64 20 74 6f 20 61 72 62 69 74 72 61 72  nded to arbitrar
17830 69 6c 79 20 63 6f 6d 70 6f 73 65 20 74 68 65 20  ily compose the 
17840 47 72 61 79 73 63 61 6c 65 20 54 49 46 46 20 73  Grayscale TIFF s
17850 74 61 72 74 69 6e 67 20 66 72 6f 6d 20 74 68 65  tarting from the
17860 20 42 61 6e 64 73 20 73 75 70 70 6f 72 74 65 64   Bands supported
17870 20 62 79 20 74 68 65 20 43 6f 76 65 72 61 67 65   by the Coverage
17880 2e 0d 0a 3c 62 72 3e 3c 75 3e 50 6c 65 61 73 65  ...<br><u>Please
17890 20 6e 6f 74 65 3c 2f 75 3e 3a 20 74 68 65 20 66   note</u>: the f
178a0 69 72 73 74 20 42 61 6e 64 20 61 6c 77 61 79 73  irst Band always
178b0 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20   corresponds to 
178c0 69 6e 64 65 78 20 3c 62 3e 5a 45 52 4f 3c 2f 62  index <b>ZERO</b
178d0 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20  ></li>..<li>the 
178e0 3c 62 3e 3c 69 3e 62 6f 75 6e 64 69 6e 67 42 6f  <b><i>boundingBo
178f0 78 3c 2f 69 3e 3c 2f 62 3e 20 69 73 20 65 78 70  x</i></b> is exp
17900 65 63 74 65 64 20 74 6f 20 72 65 70 72 65 73 65  ected to represe
17910 6e 74 20 74 68 65 20 6f 76 65 72 61 6c 6c 20 65  nt the overall e
17920 78 74 65 6e 74 20 6f 66 20 74 68 65 20 65 78 70  xtent of the exp
17930 6f 72 74 65 64 20 47 65 6f 54 49 46 46 3b 20 79  orted GeoTIFF; y
17940 6f 75 20 63 6f 75 6c 64 20 65 76 65 6e 74 75 61  ou could eventua
17950 6c 6c 79 20 70 61 73 73 20 61 6e 79 20 61 72 62  lly pass any arb
17960 69 74 72 61 72 79 20 6b 69 6e 64 20 6f 66 20 47  itrary kind of G
17970 65 6f 6d 65 74 72 79 2c 20 61 6e 64 20 74 68 65  eometry, and the
17980 20 42 6f 75 6e 64 69 6e 67 20 42 6f 78 20 61 6b   Bounding Box ak
17990 61 20 4d 42 52 20 77 69 6c 6c 20 62 65 20 61 75  a MBR will be au
179a0 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 74 65  tomatically dete
179b0 72 6d 69 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c  rmined.</li>..<l
179c0 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 68 6f 72 7a  i>the <b><i>horz
179d0 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c  PixelResolution<
179e0 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c  /i></b> and <b><
179f0 69 3e 76 65 72 74 50 69 78 65 6c 52 65 73 6f 6c  i>vertPixelResol
17a00 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 6d 75  ution</i></b> mu
17a10 73 74 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68  st exactly match
17a20 20 74 68 65 20 43 6f 76 65 72 61 67 65 27 73 20   the Coverage's 
17a30 62 61 73 65 20 72 65 73 6f 6c 75 74 69 6f 6e 20  base resolution 
17a40 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65 20 72 65  or one of the re
17a50 73 6f 6c 75 74 69 6f 6e 73 20 6d 61 64 65 20 61  solutions made a
17a60 76 61 69 6c 61 62 6c 65 20 62 79 20 74 68 65 20  vailable by the 
17a70 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 50 79  corresponding Py
17a80 72 61 6d 69 64 20 6c 65 76 65 6c 73 2e 3c 2f 6c  ramid levels.</l
17a90 69 3e 0d 0a 3c 6c 69 3e 61 6e 64 20 74 68 65 20  i>..<li>and the 
17aa0 42 6f 75 6e 64 69 6e 67 42 6f 78 20 6d 75 73 74  BoundingBox must
17ab0 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68 20 74   exactly match t
17ac0 68 65 20 54 49 46 46 20 3c 62 3e 3c 69 3e 77 69  he TIFF <b><i>wi
17ad0 64 74 68 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20  dth</i></b> and 
17ae0 3c 62 3e 3c 69 3e 68 65 69 67 68 74 3c 2f 69 3e  <b><i>height</i>
17af0 3c 2f 62 3e 20 64 69 6d 65 6e 73 69 6f 6e 73 20  </b> dimensions 
17b00 61 74 20 74 68 61 74 20 72 65 73 6f 6c 75 74 69  at that resoluti
17b10 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69 66  on.</li>..<li>if
17b20 20 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72   the optional ar
17b30 67 75 6d 65 6e 74 20 3c 62 3e 3c 69 3e 77 69 74  gument <b><i>wit
17b40 68 57 6f 72 6c 64 46 69 6c 65 3c 2f 69 3e 3c 2f  hWorldFile</i></
17b50 62 3e 20 69 73 20 73 65 74 20 74 6f 20 54 52 55  b> is set to TRU
17b60 45 20 74 68 65 6e 20 61 6e 20 61 75 78 69 6c 69  E then an auxili
17b70 61 72 79 20 57 6f 72 6c 64 46 69 6c 65 20 77 69  ary WorldFile wi
17b80 6c 6c 20 62 65 20 65 78 70 6f 72 74 65 64 20 61  ll be exported a
17b90 73 20 77 65 6c 6c 2e 3c 2f 6c 69 3e 0d 0a 3c 6c  s well.</li>..<l
17ba0 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61  i>the optional a
17bb0 72 67 75 6d 65 6e 74 20 3c 62 3e 3c 69 3e 74 69  rgument <b><i>ti
17bc0 66 66 43 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 69  ffCompression</i
17bd0 3e 3c 2f 62 3e 20 63 6f 75 6c 64 20 62 65 20 6f  ></b> could be o
17be0 6e 65 20 6f 66 20 3c 62 3e 27 4e 4f 4e 45 27 3c  ne of <b>'NONE'<
17bf0 2f 62 3e 2c 20 3c 62 3e 27 44 45 46 4c 41 54 45  /b>, <b>'DEFLATE
17c00 27 3c 2f 62 3e 2c 20 3c 62 3e 27 4c 5a 57 27 3c  '</b>, <b>'LZW'<
17c10 2f 62 3e 2c 20 3c 62 3e 27 4a 50 45 47 27 3c 2f  /b>, <b>'JPEG'</
17c20 62 3e 2c 20 3c 62 3e 27 46 41 58 33 27 3c 2f 62  b>, <b>'FAX3'</b
17c30 3e 20 6f 72 20 3c 62 3e 27 46 41 58 34 27 3c 2f  > or <b>'FAX4'</
17c40 62 3e 3b 20 64 65 66 61 75 6c 74 20 69 73 20 3c  b>; default is <
17c50 62 3e 27 4e 4f 4e 45 27 3c 2f 62 3e 2e 3c 2f 6c  b>'NONE'</b>.</l
17c60 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6c 61 73 74  i>..<li>the last
17c70 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65   optional argume
17c80 6e 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 73  nt can be used s
17c90 6f 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65  o to specify the
17ca0 20 70 72 65 66 65 72 72 65 64 20 54 49 46 46 20   preferred TIFF 
17cb0 74 69 6c 65 20 73 69 7a 65 20 28 6f 6e 6c 79 20  tile size (only 
17cc0 73 71 75 61 72 65 20 74 69 6c 65 73 20 61 72 65  square tiles are
17cd0 20 73 75 70 70 6f 72 74 65 64 29 3b 20 64 65 66   supported); def
17ce0 61 75 6c 74 20 69 73 20 3c 62 3e 32 35 36 3c 2f  ault is <b>256</
17cf0 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d  b>.</li>..</ul>.
17d00 0a 3c 74 61 62 6c 65 20 77 69 64 74 68 3d 22 31  .<table width="1
17d10 30 30 25 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66  00%" bgcolor="#f
17d20 66 64 30 38 30 22 20 63 65 6c 6c 70 61 64 64 69  fd080" cellpaddi
17d30 6e 67 3d 22 36 22 3e 3c 74 72 3e 3c 74 64 3e 0d  ng="6"><tr><td>.
17d40 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 20  .<u>Please note 
17d50 76 65 72 79 20 77 65 6c 6c 3c 2f 75 3e 3a 20 74  very well</u>: t
17d60 68 69 73 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e  his SQL function
17d70 20 69 73 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62   is only availab
17d80 6c 65 20 77 68 65 6e 20 74 68 65 20 65 6e 76 69  le when the envi
17d90 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65  ronment variable
17da0 20 3c 62 3e 53 50 41 54 49 41 4c 49 54 45 5f 53   <b>SPATIALITE_S
17db0 45 43 55 52 49 54 59 3d 72 65 6c 61 78 65 64 3c  ECURITY=relaxed<
17dc0 2f 62 3e 20 69 73 20 73 65 74 2e 3c 2f 74 64 3e  /b> is set.</td>
17dd0 3c 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e 3c 2f 74  </tr></table></t
17de0 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c  d>..</tr>..<tr><
17df0 74 64 3e 3c 62 3e 52 4c 32 5f 57 72 69 74 65 4d  td><b>RL2_WriteM
17e00 6f 6e 6f 42 61 6e 64 54 69 66 66 54 46 57 3c 2f  onoBandTiffTFW</
17e10 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78  b> ( <b>dbPrefix
17e20 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
17e30 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65  i> , <b>coverage
17e40 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Name</b> <i>Stri
17e50 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65  ng</i> , <b>file
17e60 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Path</b> <i>Stri
17e70 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74  ng</i> , <b>widt
17e80 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  h</b> <i>Integer
17e90 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74  </i> , <b>height
17ea0 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
17eb0 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64  /i> , <b>bandInd
17ec0 65 78 47 72 61 79 3c 2f 62 3e 20 3c 69 3e 49 6e  exGray</b> <i>In
17ed0 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
17ee0 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c  oundingBox</b> <
17ef0 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c  i>BLOB-Geometry<
17f00 2f 69 3e 20 2c 20 3c 62 3e 70 69 78 65 6c 52 65  /i> , <b>pixelRe
17f10 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e  solution</b> <i>
17f20 44 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c  Double</i> ) : <
17f30 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72  i>Integer</i><br
17f40 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72  ><br>..<b>RL2_Wr
17f50 69 74 65 4d 6f 6e 6f 42 61 6e 64 54 69 66 66 54  iteMonoBandTiffT
17f60 46 57 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72  FW</b> ( <b>dbPr
17f70 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  efix</b> <i>Stri
17f80 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65  ng</i> , <b>cove
17f90 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e  rageName</b> <i>
17fa0 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
17fb0 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e  filePath</b> <i>
17fc0 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
17fd0 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74  width</b> <i>Int
17fe0 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65  eger</i> , <b>he
17ff0 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  ight</b> <i>Inte
18000 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e  ger</i> , <b>ban
18010 64 49 6e 64 65 78 47 72 61 79 3c 2f 62 3e 20 3c  dIndexGray</b> <
18020 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 20 2c  i>Integer</i>  ,
18030 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c   <b>boundingBox<
18040 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d  /b> <i>BLOB-Geom
18050 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f  etry</i> , <b>ho
18060 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rzPixelResolutio
18070 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c  n</b> <i>Double<
18080 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69 78  /i> , <b>vertPix
18090 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e  elResolution</b>
180a0 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 29   <i>Double</i> )
180b0 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69   : <i>Integer</i
180c0 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c  ><br><br>..<b>RL
180d0 32 5f 57 72 69 74 65 4d 6f 6e 6f 42 61 6e 64 54  2_WriteMonoBandT
180e0 69 66 66 54 46 57 3c 2f 62 3e 20 28 20 3c 62 3e  iffTFW</b> ( <b>
180f0 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e  dbPrefix</b> <i>
18100 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
18110 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e  coverageName</b>
18120 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
18130 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e   <b>filePath</b>
18140 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
18150 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69   <b>width</b> <i
18160 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
18170 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e  b>height</b> <i>
18180 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
18190 3e 62 61 6e 64 49 6e 64 65 78 47 72 61 79 3c 2f  >bandIndexGray</
181a0 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
181b0 3e 20 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67  >  , <b>bounding
181c0 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d  Box</b> <i>BLOB-
181d0 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c  Geometry</i> , <
181e0 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c  b>horzPixelResol
181f0 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75  ution</b> <i>Dou
18200 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72  ble</i> , <b>ver
18210 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  tPixelResolution
18220 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f  </b> <i>Double</
18230 69 3e 20 2c 20 3c 62 3e 74 69 66 66 43 6f 6d 70  i> , <b>tiffComp
18240 72 65 73 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53  ression</b> <i>S
18250 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69  tring</i> ) : <i
18260 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e  >Integer</i><br>
18270 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69  <br>..<b>RL2_Wri
18280 74 65 4d 6f 6e 6f 42 61 6e 64 54 69 66 66 54 46  teMonoBandTiffTF
18290 57 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65  W</b> ( <b>dbPre
182a0 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  fix</b> <i>Strin
182b0 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72  g</i> , <b>cover
182c0 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  ageName</b> <i>S
182d0 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66  tring</i> , <b>f
182e0 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53  ilePath</b> <i>S
182f0 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77  tring</i> , <b>w
18300 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  idth</b> <i>Inte
18310 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69  ger</i> , <b>hei
18320 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  ght</b> <i>Integ
18330 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64  er</i> , <b>band
18340 49 6e 64 65 78 47 72 61 79 3c 2f 62 3e 20 3c 69  IndexGray</b> <i
18350 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 20 2c 20  >Integer</i>  , 
18360 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f  <b>boundingBox</
18370 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65  b> <i>BLOB-Geome
18380 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72  try</i> , <b>hor
18390 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  zPixelResolution
183a0 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f  </b> <i>Double</
183b0 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69 78 65  i> , <b>vertPixe
183c0 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20  lResolution</b> 
183d0 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20  <i>Double</i> , 
183e0 3c 62 3e 74 69 66 66 43 6f 6d 70 72 65 73 73 69  <b>tiffCompressi
183f0 6f 6e 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  on</b> <i>String
18400 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 66 66 54 69  </i> , <b>tiffTi
18410 6c 65 53 69 7a 65 3c 2f 62 3e 20 3c 69 3e 49 6e  leSize</b> <i>In
18420 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69  teger</i> ) : <i
18430 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64  >Integer</i></td
18440 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 61 74 74 65  >..<td>Will atte
18450 6d 70 74 20 74 6f 20 65 78 70 6f 72 74 20 72 61  mpt to export ra
18460 77 20 72 61 73 74 65 72 20 64 61 74 61 20 66 72  w raster data fr
18470 6f 6d 20 61 20 4d 55 4c 54 49 42 41 4e 44 20 6f  om a MULTIBAND o
18480 72 20 52 47 42 20 43 6f 76 65 72 61 67 65 20 69  r RGB Coverage i
18490 6e 74 6f 20 61 6e 20 65 78 74 65 72 6e 61 6c 20  nto an external 
184a0 70 6c 61 69 6e 20 54 49 46 46 20 66 69 6c 65 20  plain TIFF file 
184b0 6f 66 20 74 68 65 20 47 72 61 79 73 63 61 6c 65  of the Grayscale
184c0 20 74 79 70 65 20 73 75 70 70 6f 72 74 65 64 20   type supported 
184d0 62 79 20 61 6e 20 61 75 78 69 6c 69 61 72 79 20  by an auxiliary 
184e0 57 6f 72 6c 64 46 69 6c 65 2e 3c 62 72 3e 0d 0a  WorldFile.<br>..
184f0 57 69 6c 6c 20 72 65 74 75 72 6e 20 3c 62 3e 31  Will return <b>1
18500 3c 2f 62 3e 20 28 54 52 55 45 2f 53 55 43 43 45  </b> (TRUE/SUCCE
18510 53 53 29 20 6f 72 20 3c 62 3e 30 3c 2f 62 3e 20  SS) or <b>0</b> 
18520 28 46 41 4c 53 45 2f 46 41 49 4c 55 52 45 29 3a  (FALSE/FAILURE):
18530 20 6f 72 20 3c 62 3e 2d 31 3c 2f 62 3e 20 6f 6e   or <b>-1</b> on
18540 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e   invalid argumen
18550 74 73 2e 3c 62 72 3e 0d 0a 3c 75 3e 50 6c 65 61  ts.<br>..<u>Plea
18560 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 0d 0a 3c  se note</u>: ..<
18570 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 20 3c 62 3e  ul>..<li>The <b>
18580 3c 69 3e 64 62 50 72 65 66 69 78 3c 2f 69 3e 3c  <i>dbPrefix</i><
18590 2f 62 3e 20 61 72 67 75 6d 65 6e 74 20 69 73 20  /b> argument is 
185a0 69 6e 74 65 6e 64 65 64 20 74 6f 20 73 70 65 63  intended to spec
185b0 69 66 79 20 74 68 65 20 41 54 54 41 43 48 45 44  ify the ATTACHED
185c0 2d 44 42 20 77 68 65 72 65 20 74 68 65 20 43 6f  -DB where the Co
185d0 76 65 72 61 67 65 20 69 73 20 65 78 70 65 63 74  verage is expect
185e0 65 64 20 74 6f 20 62 65 20 66 6f 75 6e 64 3b 20  ed to be found; 
185f0 69 74 20 63 6f 75 6c 64 20 62 65 20 65 76 65 6e  it could be even
18600 74 75 61 6c 6c 79 20 3c 62 3e 4e 55 4c 4c 3c 2f  tually <b>NULL</
18610 62 3e 2c 20 61 6e 64 20 69 6e 20 74 68 69 73 20  b>, and in this 
18620 63 61 73 65 20 74 68 65 20 3c 62 3e 4d 41 49 4e  case the <b>MAIN
18630 20 44 42 3c 2f 62 3e 20 77 69 6c 6c 20 69 6d 70   DB</b> will imp
18640 6c 69 63 69 74 6c 79 20 62 65 20 61 73 73 75 6d  licitly be assum
18650 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68  ed.</li>..<li>th
18660 65 20 3c 62 3e 3c 69 3e 62 61 6e 64 49 6e 64 65  e <b><i>bandInde
18670 78 47 72 61 79 3c 2f 69 3e 3c 2f 62 3e 20 61 72  xGray</i></b> ar
18680 67 75 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e 64  gument is intend
18690 65 64 20 74 6f 20 61 72 62 69 74 72 61 72 69 6c  ed to arbitraril
186a0 79 20 63 6f 6d 70 6f 73 65 20 74 68 65 20 47 72  y compose the Gr
186b0 61 79 73 63 61 6c 65 20 54 49 46 46 20 73 74 61  ayscale TIFF sta
186c0 72 74 69 6e 67 20 66 72 6f 6d 20 74 68 65 20 42  rting from the B
186d0 61 6e 64 73 20 73 75 70 70 6f 72 74 65 64 20 62  ands supported b
186e0 79 20 74 68 65 20 43 6f 76 65 72 61 67 65 2e 0d  y the Coverage..
186f0 0a 3c 62 72 3e 3c 75 3e 50 6c 65 61 73 65 20 6e  .<br><u>Please n
18700 6f 74 65 3c 2f 75 3e 3a 20 74 68 65 20 66 69 72  ote</u>: the fir
18710 73 74 20 42 61 6e 64 20 61 6c 77 61 79 73 20 63  st Band always c
18720 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 69 6e  orresponds to in
18730 64 65 78 20 3c 62 3e 5a 45 52 4f 3c 2f 62 3e 3c  dex <b>ZERO</b><
18740 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62  /li>..<li>the <b
18750 3e 3c 69 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c  ><i>boundingBox<
18760 2f 69 3e 3c 2f 62 3e 20 69 73 20 65 78 70 65 63  /i></b> is expec
18770 74 65 64 20 74 6f 20 72 65 70 72 65 73 65 6e 74  ted to represent
18780 20 74 68 65 20 6f 76 65 72 61 6c 6c 20 65 78 74   the overall ext
18790 65 6e 74 20 6f 66 20 74 68 65 20 65 78 70 6f 72  ent of the expor
187a0 74 65 64 20 54 49 46 46 3b 20 79 6f 75 20 63 6f  ted TIFF; you co
187b0 75 6c 64 20 65 76 65 6e 74 75 61 6c 6c 79 20 70  uld eventually p
187c0 61 73 73 20 61 6e 79 20 61 72 62 69 74 72 61 72  ass any arbitrar
187d0 79 20 6b 69 6e 64 20 6f 66 20 47 65 6f 6d 65 74  y kind of Geomet
187e0 72 79 2c 20 61 6e 64 20 74 68 65 20 42 6f 75 6e  ry, and the Boun
187f0 64 69 6e 67 20 42 6f 78 20 61 6b 61 20 4d 42 52  ding Box aka MBR
18800 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74   will be automat
18810 69 63 61 6c 6c 79 20 64 65 74 65 72 6d 69 6e 65  ically determine
18820 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65  d.</li>..<li>the
18830 20 3c 62 3e 3c 69 3e 68 6f 72 7a 50 69 78 65 6c   <b><i>horzPixel
18840 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f  Resolution</i></
18850 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e 76 65 72  b> and <b><i>ver
18860 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  tPixelResolution
18870 3c 2f 69 3e 3c 2f 62 3e 20 6d 75 73 74 20 65 78  </i></b> must ex
18880 61 63 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20  actly match the 
18890 43 6f 76 65 72 61 67 65 27 73 20 62 61 73 65 20  Coverage's base 
188a0 72 65 73 6f 6c 75 74 69 6f 6e 20 6f 72 20 6f 6e  resolution or on
188b0 65 20 6f 66 20 74 68 65 20 72 65 73 6f 6c 75 74  e of the resolut
188c0 69 6f 6e 73 20 6d 61 64 65 20 61 76 61 69 6c 61  ions made availa
188d0 62 6c 65 20 62 79 20 74 68 65 20 63 6f 72 72 65  ble by the corre
188e0 73 70 6f 6e 64 69 6e 67 20 50 79 72 61 6d 69 64  sponding Pyramid
188f0 20 6c 65 76 65 6c 73 2e 3c 2f 6c 69 3e 0d 0a 3c   levels.</li>..<
18900 6c 69 3e 61 6e 64 20 74 68 65 20 42 6f 75 6e 64  li>and the Bound
18910 69 6e 67 42 6f 78 20 6d 75 73 74 20 65 78 61 63  ingBox must exac
18920 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20 54 49  tly match the TI
18930 46 46 20 3c 62 3e 3c 69 3e 77 69 64 74 68 3c 2f  FF <b><i>width</
18940 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69  i></b> and <b><i
18950 3e 68 65 69 67 68 74 3c 2f 69 3e 3c 2f 62 3e 20  >height</i></b> 
18960 64 69 6d 65 6e 73 69 6f 6e 73 20 61 74 20 74 68  dimensions at th
18970 61 74 20 72 65 73 6f 6c 75 74 69 6f 6e 2e 3c 2f  at resolution.</
18980 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74  li>..<li>the opt
18990 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c  ional argument <
189a0 62 3e 3c 69 3e 74 69 66 66 43 6f 6d 70 72 65 73  b><i>tiffCompres
189b0 73 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 63 6f 75  sion</i></b> cou
189c0 6c 64 20 62 65 20 6f 6e 65 20 6f 66 20 3c 62 3e  ld be one of <b>
189d0 27 4e 4f 4e 45 27 3c 2f 62 3e 2c 20 3c 62 3e 27  'NONE'</b>, <b>'
189e0 44 45 46 4c 41 54 45 27 3c 2f 62 3e 2c 20 3c 62  DEFLATE'</b>, <b
189f0 3e 27 4c 5a 57 27 3c 2f 62 3e 2c 20 3c 62 3e 27  >'LZW'</b>, <b>'
18a00 4a 50 45 47 27 3c 2f 62 3e 2c 20 3c 62 3e 27 46  JPEG'</b>, <b>'F
18a10 41 58 33 27 3c 2f 62 3e 20 6f 72 20 3c 62 3e 27  AX3'</b> or <b>'
18a20 46 41 58 34 27 3c 2f 62 3e 3b 20 64 65 66 61 75  FAX4'</b>; defau
18a30 6c 74 20 69 73 20 3c 62 3e 27 4e 4f 4e 45 27 3c  lt is <b>'NONE'<
18a40 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74  /b>.</li>..<li>t
18a50 68 65 20 6c 61 73 74 20 6f 70 74 69 6f 6e 61 6c  he last optional
18a60 20 61 72 67 75 6d 65 6e 74 20 63 61 6e 20 62 65   argument can be
18a70 20 75 73 65 64 20 73 6f 20 74 6f 20 73 70 65 63   used so to spec
18a80 69 66 79 20 74 68 65 20 70 72 65 66 65 72 72 65  ify the preferre
18a90 64 20 54 49 46 46 20 74 69 6c 65 20 73 69 7a 65  d TIFF tile size
18aa0 20 28 6f 6e 6c 79 20 73 71 75 61 72 65 20 74 69   (only square ti
18ab0 6c 65 73 20 61 72 65 20 73 75 70 70 6f 72 74 65  les are supporte
18ac0 64 29 3b 20 64 65 66 61 75 6c 74 20 69 73 20 3c  d); default is <
18ad0 62 3e 32 35 36 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d  b>256</b>.</li>.
18ae0 0a 3c 2f 75 6c 3e 0d 0a 3c 74 61 62 6c 65 20 77  .</ul>..<table w
18af0 69 64 74 68 3d 22 31 30 30 25 22 20 62 67 63 6f  idth="100%" bgco
18b00 6c 6f 72 3d 22 23 66 66 64 30 38 30 22 20 63 65  lor="#ffd080" ce
18b10 6c 6c 70 61 64 64 69 6e 67 3d 22 36 22 3e 3c 74  llpadding="6"><t
18b20 72 3e 3c 74 64 3e 0d 0a 3c 75 3e 50 6c 65 61 73  r><td>..<u>Pleas
18b30 65 20 6e 6f 74 65 20 76 65 72 79 20 77 65 6c 6c  e note very well
18b40 3c 2f 75 3e 3a 20 74 68 69 73 20 53 51 4c 20 66  </u>: this SQL f
18b50 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20  unction is only 
18b60 61 76 61 69 6c 61 62 6c 65 20 77 68 65 6e 20 74  available when t
18b70 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76  he environment v
18b80 61 72 69 61 62 6c 65 20 3c 62 3e 53 50 41 54 49  ariable <b>SPATI
18b90 41 4c 49 54 45 5f 53 45 43 55 52 49 54 59 3d 72  ALITE_SECURITY=r
18ba0 65 6c 61 78 65 64 3c 2f 62 3e 20 69 73 20 73 65  elaxed</b> is se
18bb0 74 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 3c 2f 74 61  t.</td></tr></ta
18bc0 62 6c 65 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e  ble></td>..</tr>
18bd0 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 52 4c 32  ..<tr><td><b>RL2
18be0 5f 57 72 69 74 65 4d 6f 6e 6f 42 61 6e 64 54 69  _WriteMonoBandTi
18bf0 66 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72  ff</b> ( <b>dbPr
18c00 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  efix</b> <i>Stri
18c10 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65  ng</i> , <b>cove
18c20 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e  rageName</b> <i>
18c30 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
18c40 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e  filePath</b> <i>
18c50 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
18c60 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74  width</b> <i>Int
18c70 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65  eger</i> , <b>he
18c80 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  ight</b> <i>Inte
18c90 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e  ger</i> , <b>ban
18ca0 64 49 6e 64 65 78 47 72 61 79 3c 2f 62 3e 20 3c  dIndexGray</b> <
18cb0 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
18cc0 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f  <b>boundingBox</
18cd0 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65  b> <i>BLOB-Geome
18ce0 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 70 69 78  try</i> , <b>pix
18cf0 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e  elResolution</b>
18d00 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 29   <i>Double</i> )
18d10 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69   : <i>Integer</i
18d20 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c  ><br><br>..<b>RL
18d30 32 5f 57 72 69 74 65 4d 6f 6e 6f 42 61 6e 64 54  2_WriteMonoBandT
18d40 69 66 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50  iff</b> ( <b>dbP
18d50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72  refix</b> <i>Str
18d60 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76  ing</i> , <b>cov
18d70 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69  erageName</b> <i
18d80 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
18d90 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69  >filePath</b> <i
18da0 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
18db0 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
18dc0 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
18dd0 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
18de0 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61  eger</i> , <b>ba
18df0 6e 64 49 6e 64 65 78 47 72 61 79 3c 2f 62 3e 20  ndIndexGray</b> 
18e00 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 20  <i>Integer</i>  
18e10 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78  , <b>boundingBox
18e20 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f  </b> <i>BLOB-Geo
18e30 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68  metry</i> , <b>h
18e40 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69  orzPixelResoluti
18e50 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65  on</b> <i>Double
18e60 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69  </i> , <b>vertPi
18e70 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62  xelResolution</b
18e80 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20  > <i>Double</i> 
18e90 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  ) : <i>Integer</
18ea0 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52  i><br><br>..<b>R
18eb0 4c 32 5f 57 72 69 74 65 4d 6f 6e 6f 42 61 6e 64  L2_WriteMonoBand
18ec0 54 69 66 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62  Tiff</b> ( <b>db
18ed0 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74  Prefix</b> <i>St
18ee0 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f  ring</i> , <b>co
18ef0 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c  verageName</b> <
18f00 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
18f10 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c  b>filePath</b> <
18f20 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
18f30 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49  b>width</b> <i>I
18f40 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
18f50 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e  height</b> <i>In
18f60 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
18f70 61 6e 64 49 6e 64 65 78 47 72 61 79 3c 2f 62 3e  andIndexGray</b>
18f80 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
18f90 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f   , <b>boundingBo
18fa0 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65  x</b> <i>BLOB-Ge
18fb0 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e  ometry</i> , <b>
18fc0 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74  horzPixelResolut
18fd0 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c  ion</b> <i>Doubl
18fe0 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50  e</i> , <b>vertP
18ff0 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
19000 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e  b> <i>Double</i>
19010 20 2c 20 3c 62 3e 74 69 66 66 43 6f 6d 70 72 65   , <b>tiffCompre
19020 73 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53 74 72  ssion</b> <i>Str
19030 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49  ing</i> ) : <i>I
19040 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62  nteger</i><br><b
19050 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65  r>..<b>RL2_Write
19060 4d 6f 6e 6f 42 61 6e 64 54 69 66 66 3c 2f 62 3e  MonoBandTiff</b>
19070 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f   ( <b>dbPrefix</
19080 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
19090 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61   , <b>coverageNa
190a0 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  me</b> <i>String
190b0 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61  </i> , <b>filePa
190c0 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  th</b> <i>String
190d0 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c  </i> , <b>width<
190e0 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
190f0 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f  i> , <b>height</
19100 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
19110 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78  > , <b>bandIndex
19120 47 72 61 79 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  Gray</b> <i>Inte
19130 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62 3e 62 6f  ger</i>  , <b>bo
19140 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69  undingBox</b> <i
19150 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f  >BLOB-Geometry</
19160 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50 69 78 65  i> , <b>horzPixe
19170 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20  lResolution</b> 
19180 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20  <i>Double</i> , 
19190 3c 62 3e 76 65 72 74 50 69 78 65 6c 52 65 73 6f  <b>vertPixelReso
191a0 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f  lution</b> <i>Do
191b0 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69  uble</i> , <b>ti
191c0 66 66 43 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 62  ffCompression</b
191d0 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
191e0 2c 20 3c 62 3e 74 69 66 66 54 69 6c 65 53 69 7a  , <b>tiffTileSiz
191f0 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  e</b> <i>Integer
19200 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65  </i> ) : <i>Inte
19210 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74  ger</i></td>..<t
19220 64 3e 57 69 6c 6c 20 61 74 74 65 6d 70 74 20 74  d>Will attempt t
19230 6f 20 65 78 70 6f 72 74 20 72 61 77 20 72 61 73  o export raw ras
19240 74 65 72 20 64 61 74 61 20 66 72 6f 6d 20 61 20  ter data from a 
19250 4d 55 4c 54 49 42 41 4e 44 20 6f 72 20 52 47 42  MULTIBAND or RGB
19260 20 43 6f 76 65 72 61 67 65 20 69 6e 74 6f 20 61   Coverage into a
19270 6e 20 65 78 74 65 72 6e 61 6c 20 70 6c 61 69 6e  n external plain
19280 20 54 49 46 46 20 66 69 6c 65 20 6f 66 20 74 68   TIFF file of th
19290 65 20 47 72 61 79 73 63 61 6c 65 20 74 79 70 65  e Grayscale type
192a0 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72 65 74 75  .<br>..Will retu
192b0 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28 54 52 55  rn <b>1</b> (TRU
192c0 45 2f 53 55 43 43 45 53 53 29 20 6f 72 20 3c 62  E/SUCCESS) or <b
192d0 3e 30 3c 2f 62 3e 20 28 46 41 4c 53 45 2f 46 41  >0</b> (FALSE/FA
192e0 49 4c 55 52 45 29 3a 20 6f 72 20 3c 62 3e 2d 31  ILURE): or <b>-1
192f0 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69 64 20  </b> on invalid 
19300 61 72 67 75 6d 65 6e 74 73 2e 3c 62 72 3e 0d 0a  arguments.<br>..
19310 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f  <u>Please note</
19320 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e  u>: ..<ul>..<li>
19330 54 68 65 20 3c 62 3e 3c 69 3e 64 62 50 72 65 66  The <b><i>dbPref
19340 69 78 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67 75 6d  ix</i></b> argum
19350 65 6e 74 20 69 73 20 69 6e 74 65 6e 64 65 64 20  ent is intended 
19360 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 20 41  to specify the A
19370 54 54 41 43 48 45 44 2d 44 42 20 77 68 65 72 65  TTACHED-DB where
19380 20 74 68 65 20 43 6f 76 65 72 61 67 65 20 69 73   the Coverage is
19390 20 65 78 70 65 63 74 65 64 20 74 6f 20 62 65 20   expected to be 
193a0 66 6f 75 6e 64 3b 20 69 74 20 63 6f 75 6c 64 20  found; it could 
193b0 62 65 20 65 76 65 6e 74 75 61 6c 6c 79 20 3c 62  be eventually <b
193c0 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69  >NULL</b>, and i
193d0 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20  n this case the 
193e0 3c 62 3e 4d 41 49 4e 20 44 42 3c 2f 62 3e 20 77  <b>MAIN DB</b> w
193f0 69 6c 6c 20 69 6d 70 6c 69 63 69 74 6c 79 20 62  ill implicitly b
19400 65 20 61 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e 0d  e assumed.</li>.
19410 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 62  .<li>the <b><i>b
19420 61 6e 64 49 6e 64 65 78 47 72 61 79 3c 2f 69 3e  andIndexGray</i>
19430 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 20 69 73  </b> argument is
19440 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 61 72 62   intended to arb
19450 69 74 72 61 72 69 6c 79 20 63 6f 6d 70 6f 73 65  itrarily compose
19460 20 74 68 65 20 47 72 61 79 73 63 61 6c 65 20 54   the Grayscale T
19470 49 46 46 20 73 74 61 72 74 69 6e 67 20 66 72 6f  IFF starting fro
19480 6d 20 74 68 65 20 42 61 6e 64 73 20 73 75 70 70  m the Bands supp
19490 6f 72 74 65 64 20 62 79 20 74 68 65 20 43 6f 76  orted by the Cov
194a0 65 72 61 67 65 2e 0d 0a 3c 62 72 3e 3c 75 3e 50  erage...<br><u>P
194b0 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20  lease note</u>: 
194c0 74 68 65 20 66 69 72 73 74 20 42 61 6e 64 20 61  the first Band a
194d0 6c 77 61 79 73 20 63 6f 72 72 65 73 70 6f 6e 64  lways correspond
194e0 73 20 74 6f 20 69 6e 64 65 78 20 3c 62 3e 5a 45  s to index <b>ZE
194f0 52 4f 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69  RO</b></li>..<li
19500 3e 74 68 65 20 3c 62 3e 3c 69 3e 62 6f 75 6e 64  >the <b><i>bound
19510 69 6e 67 42 6f 78 3c 2f 69 3e 3c 2f 62 3e 20 69  ingBox</i></b> i
19520 73 20 65 78 70 65 63 74 65 64 20 74 6f 20 72 65  s expected to re
19530 70 72 65 73 65 6e 74 20 74 68 65 20 6f 76 65 72  present the over
19540 61 6c 6c 20 65 78 74 65 6e 74 20 6f 66 20 74 68  all extent of th
19550 65 20 65 78 70 6f 72 74 65 64 20 54 49 46 46 3b  e exported TIFF;
19560 20 79 6f 75 20 63 6f 75 6c 64 20 65 76 65 6e 74   you could event
19570 75 61 6c 6c 79 20 70 61 73 73 20 61 6e 79 20 61  ually pass any a
19580 72 62 69 74 72 61 72 79 20 6b 69 6e 64 20 6f 66  rbitrary kind of
19590 20 47 65 6f 6d 65 74 72 79 2c 20 61 6e 64 20 74   Geometry, and t
195a0 68 65 20 42 6f 75 6e 64 69 6e 67 20 42 6f 78 20  he Bounding Box 
195b0 61 6b 61 20 4d 42 52 20 77 69 6c 6c 20 62 65 20  aka MBR will be 
195c0 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65  automatically de
195d0 74 65 72 6d 69 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a  termined.</li>..
195e0 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 68 6f  <li>the <b><i>ho
195f0 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rzPixelResolutio
19600 6e 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62  n</i></b> and <b
19610 3e 3c 69 3e 76 65 72 74 50 69 78 65 6c 52 65 73  ><i>vertPixelRes
19620 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20  olution</i></b> 
19630 6d 75 73 74 20 65 78 61 63 74 6c 79 20 6d 61 74  must exactly mat
19640 63 68 20 74 68 65 20 43 6f 76 65 72 61 67 65 27  ch the Coverage'
19650 73 20 62 61 73 65 20 72 65 73 6f 6c 75 74 69 6f  s base resolutio
19660 6e 20 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65 20  n or one of the 
19670 72 65 73 6f 6c 75 74 69 6f 6e 73 20 6d 61 64 65  resolutions made
19680 20 61 76 61 69 6c 61 62 6c 65 20 62 79 20 74 68   available by th
19690 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20  e corresponding 
196a0 50 79 72 61 6d 69 64 20 6c 65 76 65 6c 73 2e 3c  Pyramid levels.<
196b0 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 6e 64 20 74 68  /li>..<li>and th
196c0 65 20 42 6f 75 6e 64 69 6e 67 42 6f 78 20 6d 75  e BoundingBox mu
196d0 73 74 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68  st exactly match
196e0 20 74 68 65 20 54 49 46 46 20 3c 62 3e 3c 69 3e   the TIFF <b><i>
196f0 77 69 64 74 68 3c 2f 69 3e 3c 2f 62 3e 20 61 6e  width</i></b> an
19700 64 20 3c 62 3e 3c 69 3e 68 65 69 67 68 74 3c 2f  d <b><i>height</
19710 69 3e 3c 2f 62 3e 20 64 69 6d 65 6e 73 69 6f 6e  i></b> dimension
19720 73 20 61 74 20 74 68 61 74 20 72 65 73 6f 6c 75  s at that resolu
19730 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  tion.</li>..<li>
19740 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67  the optional arg
19750 75 6d 65 6e 74 20 3c 62 3e 3c 69 3e 74 69 66 66  ument <b><i>tiff
19760 43 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 69 3e 3c  Compression</i><
19770 2f 62 3e 20 63 6f 75 6c 64 20 62 65 20 6f 6e 65  /b> could be one
19780 20 6f 66 20 3c 62 3e 27 4e 4f 4e 45 27 3c 2f 62   of <b>'NONE'</b
19790 3e 2c 20 3c 62 3e 27 44 45 46 4c 41 54 45 27 3c  >, <b>'DEFLATE'<
197a0 2f 62 3e 2c 20 3c 62 3e 27 4c 5a 57 27 3c 2f 62  /b>, <b>'LZW'</b
197b0 3e 2c 20 3c 62 3e 27 4a 50 45 47 27 3c 2f 62 3e  >, <b>'JPEG'</b>
197c0 2c 20 3c 62 3e 27 46 41 58 33 27 3c 2f 62 3e 20  , <b>'FAX3'</b> 
197d0 6f 72 20 3c 62 3e 27 46 41 58 34 27 3c 2f 62 3e  or <b>'FAX4'</b>
197e0 3b 20 64 65 66 61 75 6c 74 20 69 73 20 3c 62 3e  ; default is <b>
197f0 27 4e 4f 4e 45 27 3c 2f 62 3e 2e 3c 2f 6c 69 3e  'NONE'</b>.</li>
19800 0d 0a 3c 6c 69 3e 74 68 65 20 6c 61 73 74 20 6f  ..<li>the last o
19810 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74  ptional argument
19820 20 63 61 6e 20 62 65 20 75 73 65 64 20 73 6f 20   can be used so 
19830 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 20 70  to specify the p
19840 72 65 66 65 72 72 65 64 20 54 49 46 46 20 74 69  referred TIFF ti
19850 6c 65 20 73 69 7a 65 20 28 6f 6e 6c 79 20 73 71  le size (only sq
19860 75 61 72 65 20 74 69 6c 65 73 20 61 72 65 20 73  uare tiles are s
19870 75 70 70 6f 72 74 65 64 29 3b 20 64 65 66 61 75  upported); defau
19880 6c 74 20 69 73 20 3c 62 3e 32 35 36 3c 2f 62 3e  lt is <b>256</b>
19890 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c  .</li>..</ul>..<
198a0 74 61 62 6c 65 20 77 69 64 74 68 3d 22 31 30 30  table width="100
198b0 25 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 64  %" bgcolor="#ffd
198c0 30 38 30 22 20 63 65 6c 6c 70 61 64 64 69 6e 67  080" cellpadding
198d0 3d 22 36 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 3c  ="6"><tr><td>..<
198e0 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 20 76 65  u>Please note ve
198f0 72 79 20 77 65 6c 6c 3c 2f 75 3e 3a 20 74 68 69  ry well</u>: thi
19900 73 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 69  s SQL function i
19910 73 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65  s only available
19920 20 77 68 65 6e 20 74 68 65 20 65 6e 76 69 72 6f   when the enviro
19930 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 3c  nment variable <
19940 62 3e 53 50 41 54 49 41 4c 49 54 45 5f 53 45 43  b>SPATIALITE_SEC
19950 55 52 49 54 59 3d 72 65 6c 61 78 65 64 3c 2f 62  URITY=relaxed</b
19960 3e 20 69 73 20 73 65 74 2e 3c 2f 74 64 3e 3c 2f  > is set.</td></
19970 74 72 3e 3c 2f 74 61 62 6c 65 3e 3c 2f 74 64 3e  tr></table></td>
19980 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64  ..</tr>..<tr><td
19990 3e 3c 62 3e 52 4c 32 5f 57 72 69 74 65 41 73 63  ><b>RL2_WriteAsc
199a0 69 69 47 72 69 64 3c 2f 62 3e 20 28 20 3c 62 3e  iiGrid</b> ( <b>
199b0 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e  dbPrefix</b> <i>
199c0 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
199d0 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e  coverageName</b>
199e0 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
199f0 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e   <b>filePath</b>
19a00 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
19a10 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69   <b>width</b> <i
19a20 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
19a30 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e  b>height</b> <i>
19a40 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
19a50 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e  >boundingBox</b>
19a60 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72   <i>BLOB-Geometr
19a70 79 3c 2f 69 3e 20 2c 20 3c 62 3e 70 69 78 65 6c  y</i> , <b>pixel
19a80 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c  Resolution</b> <
19a90 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a  i>Double</i> ) :
19aa0 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c   <i>Integer</i><
19ab0 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f  br><br>..<b>RL2_
19ac0 57 72 69 74 65 41 73 63 69 69 47 72 69 64 3c 2f  WriteAsciiGrid</
19ad0 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78  b> ( <b>dbPrefix
19ae0 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
19af0 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65  i> , <b>coverage
19b00 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Name</b> <i>Stri
19b10 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65  ng</i> , <b>file
19b20 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Path</b> <i>Stri
19b30 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74  ng</i> , <b>widt
19b40 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  h</b> <i>Integer
19b50 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74  </i> , <b>height
19b60 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
19b70 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e  /i> , <b>boundin
19b80 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42  gBox</b> <i>BLOB
19b90 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20  -Geometry</i> , 
19ba0 3c 62 3e 70 69 78 65 6c 52 65 73 6f 6c 75 74 69  <b>pixelResoluti
19bb0 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65  on</b> <i>Double
19bc0 3c 2f 69 3e 20 2c 20 3c 62 3e 69 73 50 69 78 65  </i> , <b>isPixe
19bd0 6c 43 65 6e 74 65 72 65 64 3c 2f 62 3e 20 3c 69  lCentered</b> <i
19be0 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a  >Integer</i> ) :
19bf0 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c   <i>Integer</i><
19c00 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f  br><br>..<b>RL2_
19c10 57 72 69 74 65 41 73 63 69 69 47 72 69 64 3c 2f  WriteAsciiGrid</
19c20 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78  b> ( <b>dbPrefix
19c30 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
19c40 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65  i> , <b>coverage
19c50 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Name</b> <i>Stri
19c60 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65  ng</i> , <b>file
19c70 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Path</b> <i>Stri
19c80 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74  ng</i> , <b>widt
19c90 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  h</b> <i>Integer
19ca0 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74  </i> , <b>height
19cb0 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
19cc0 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e  /i> , <b>boundin
19cd0 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42  gBox</b> <i>BLOB
19ce0 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20  -Geometry</i> , 
19cf0 3c 62 3e 70 69 78 65 6c 52 65 73 6f 6c 75 74 69  <b>pixelResoluti
19d00 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65  on</b> <i>Double
19d10 3c 2f 69 3e 20 2c 20 3c 62 3e 69 73 50 69 78 65  </i> , <b>isPixe
19d20 6c 43 65 6e 74 65 72 65 64 3c 2f 62 3e 20 3c 69  lCentered</b> <i
19d30 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 0d 0a  >Integer</i> ,..
19d40 3c 62 3e 64 65 63 69 6d 61 6c 44 69 67 69 74 73  <b>decimalDigits
19d50 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
19d60 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67  /i> ) : <i>Integ
19d70 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  er</i></td>..<td
19d80 3e 57 69 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f  >Will attempt to
19d90 20 65 78 70 6f 72 74 20 72 61 77 20 72 61 73 74   export raw rast
19da0 65 72 20 64 61 74 61 20 66 72 6f 6d 20 61 20 44  er data from a D
19db0 41 54 41 47 52 49 44 20 43 6f 76 65 72 61 67 65  ATAGRID Coverage
19dc0 20 69 6e 74 6f 20 61 6e 20 65 78 74 65 72 6e 61   into an externa
19dd0 6c 20 41 53 43 49 49 20 47 72 69 64 20 66 69 6c  l ASCII Grid fil
19de0 65 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72 65 74  e.<br>..Will ret
19df0 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28 54 52  urn <b>1</b> (TR
19e00 55 45 2f 53 55 43 43 45 53 53 29 20 6f 72 20 3c  UE/SUCCESS) or <
19e10 62 3e 30 3c 2f 62 3e 20 28 46 41 4c 53 45 2f 46  b>0</b> (FALSE/F
19e20 41 49 4c 55 52 45 29 3a 20 6f 72 20 3c 62 3e 2d  AILURE): or <b>-
19e30 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69 64  1</b> on invalid
19e40 20 61 72 67 75 6d 65 6e 74 73 2e 3c 62 72 3e 0d   arguments.<br>.
19e50 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c  .<u>Please note<
19e60 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69  /u>: ..<ul>..<li
19e70 3e 54 68 65 20 3c 62 3e 3c 69 3e 64 62 50 72 65  >The <b><i>dbPre
19e80 66 69 78 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67 75  fix</i></b> argu
19e90 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e 64 65 64  ment is intended
19ea0 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 20   to specify the 
19eb0 41 54 54 41 43 48 45 44 2d 44 42 20 77 68 65 72  ATTACHED-DB wher
19ec0 65 20 74 68 65 20 43 6f 76 65 72 61 67 65 20 69  e the Coverage i
19ed0 73 20 65 78 70 65 63 74 65 64 20 74 6f 20 62 65  s expected to be
19ee0 20 66 6f 75 6e 64 3b 20 69 74 20 63 6f 75 6c 64   found; it could
19ef0 20 62 65 20 65 76 65 6e 74 75 61 6c 6c 79 20 3c   be eventually <
19f00 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20  b>NULL</b>, and 
19f10 69 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65  in this case the
19f20 20 3c 62 3e 4d 41 49 4e 20 44 42 3c 2f 62 3e 20   <b>MAIN DB</b> 
19f30 77 69 6c 6c 20 69 6d 70 6c 69 63 69 74 6c 79 20  will implicitly 
19f40 62 65 20 61 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e  be assumed.</li>
19f50 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e  ..<li>the <b><i>
19f60 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 69 3e 3c  boundingBox</i><
19f70 2f 62 3e 20 69 73 20 65 78 70 65 63 74 65 64 20  /b> is expected 
19f80 74 6f 20 72 65 70 72 65 73 65 6e 74 20 74 68 65  to represent the
19f90 20 6f 76 65 72 61 6c 6c 20 65 78 74 65 6e 74 20   overall extent 
19fa0 6f 66 20 74 68 65 20 65 78 70 6f 72 74 65 64 20  of the exported 
19fb0 41 53 43 49 49 20 47 72 69 64 3b 20 79 6f 75 20  ASCII Grid; you 
19fc0 63 6f 75 6c 64 20 65 76 65 6e 74 75 61 6c 6c 79  could eventually
19fd0 20 70 61 73 73 20 61 6e 79 20 61 72 62 69 74 72   pass any arbitr
19fe0 61 72 79 20 6b 69 6e 64 20 6f 66 20 47 65 6f 6d  ary kind of Geom
19ff0 65 74 72 79 2c 20 61 6e 64 20 74 68 65 20 42 6f  etry, and the Bo
1a000 75 6e 64 69 6e 67 20 42 6f 78 20 61 6b 61 20 4d  unding Box aka M
1a010 42 52 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d  BR will be autom
1a020 61 74 69 63 61 6c 6c 79 20 64 65 74 65 72 6d 69  atically determi
1a030 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74  ned.</li>..<li>t
1a040 68 65 20 3c 62 3e 3c 69 3e 70 69 78 65 6c 52 65  he <b><i>pixelRe
1a050 73 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e  solution</i></b>
1a060 20 20 6d 75 73 74 20 65 78 61 63 74 6c 79 20 6d    must exactly m
1a070 61 74 63 68 20 74 68 65 20 43 6f 76 65 72 61 67  atch the Coverag
1a080 65 27 73 20 62 61 73 65 20 72 65 73 6f 6c 75 74  e's base resolut
1a090 69 6f 6e 20 6f 72 20 6f 6e 65 20 6f 66 20 74 68  ion or one of th
1a0a0 65 20 72 65 73 6f 6c 75 74 69 6f 6e 73 20 6d 61  e resolutions ma
1a0b0 64 65 20 61 76 61 69 6c 61 62 6c 65 20 62 79 20  de available by 
1a0c0 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e  the correspondin
1a0d0 67 20 50 79 72 61 6d 69 64 20 6c 65 76 65 6c 73  g Pyramid levels
1a0e0 3b 20 72 65 63 74 61 6e 67 75 6c 61 72 20 70 69  ; rectangular pi
1a0f0 78 65 6c 73 20 61 72 65 6e 27 74 20 73 75 70 70  xels aren't supp
1a100 6f 72 74 65 64 20 62 79 20 41 53 43 49 49 20 47  orted by ASCII G
1a110 72 69 64 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  rids.</li>..<li>
1a120 61 6e 64 20 74 68 65 20 42 6f 75 6e 64 69 6e 67  and the Bounding
1a130 42 6f 78 20 6d 75 73 74 20 65 78 61 63 74 6c 79  Box must exactly
1a140 20 6d 61 74 63 68 20 74 68 65 20 41 53 43 49 49   match the ASCII
1a150 20 47 72 69 64 20 3c 62 3e 3c 69 3e 77 69 64 74   Grid <b><i>widt
1a160 68 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62  h</i></b> and <b
1a170 3e 3c 69 3e 68 65 69 67 68 74 3c 2f 69 3e 3c 2f  ><i>height</i></
1a180 62 3e 20 64 69 6d 65 6e 73 69 6f 6e 73 20 61 74  b> dimensions at
1a190 20 74 68 61 74 20 72 65 73 6f 6c 75 74 69 6f 6e   that resolution
1a1a0 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20  .</li>..<li>the 
1a1b0 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e  optional argumen
1a1c0 74 20 3c 62 3e 3c 69 3e 69 73 50 69 78 65 6c 43  t <b><i>isPixelC
1a1d0 65 6e 74 65 72 65 64 3c 2f 69 3e 3c 2f 62 3e 20  entered</i></b> 
1a1e0 28 65 78 70 65 63 74 65 64 20 74 6f 20 62 65 20  (expected to be 
1a1f0 6f 66 20 74 68 65 20 42 6f 6f 6c 65 61 6e 20 74  of the Boolean t
1a200 79 70 65 29 20 64 65 74 65 72 6d 69 6e 65 73 20  ype) determines 
1a210 69 66 20 74 68 65 20 41 53 43 49 49 20 47 72 69  if the ASCII Gri
1a220 64 20 77 69 6c 6c 20 64 65 63 6c 61 72 65 20 3c  d will declare <
1a230 62 3e 78 6c 6c 63 65 6e 74 65 72 3c 2f 62 3e 20  b>xllcenter</b> 
1a240 61 6e 64 20 3c 62 3e 79 6c 6c 63 65 6e 74 65 72  and <b>yllcenter
1a250 3c 2f 62 3e 20 69 6e 73 74 65 61 64 20 6f 66 20  </b> instead of 
1a260 3c 62 3e 78 6c 6c 63 6f 72 6e 65 72 3c 2f 62 3e  <b>xllcorner</b>
1a270 20 61 6e 64 20 3c 62 3e 79 6c 6c 63 6f 6e 65 72   and <b>yllconer
1a280 3c 2f 62 3e 20 28 64 65 66 61 75 6c 74 20 69 73  </b> (default is
1a290 20 54 52 55 45 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c   TRUE).</li>..<l
1a2a0 69 3e 74 68 65 20 6c 61 73 74 20 6f 70 74 69 6f  i>the last optio
1a2b0 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 63 61 6e  nal argument can
1a2c0 20 62 65 20 75 73 65 64 20 73 6f 20 74 6f 20 73   be used so to s
1a2d0 70 65 63 69 66 79 20 68 6f 77 20 6d 61 6e 79 20  pecify how many 
1a2e0 64 65 63 69 6d 61 6c 20 64 69 67 69 74 73 20 68  decimal digits h
1a2f0 61 76 65 20 74 6f 20 62 65 20 65 78 70 6f 72 74  ave to be export
1a300 65 64 20 69 6e 74 6f 20 74 68 65 20 41 53 43 49  ed into the ASCI
1a310 49 20 47 72 69 64 3b 20 64 65 66 61 75 6c 74 20  I Grid; default 
1a320 69 73 20 3c 62 3e 34 3c 2f 62 3e 20 64 65 63 69  is <b>4</b> deci
1a330 6d 61 6c 20 64 69 67 69 74 73 2e 3c 2f 6c 69 3e  mal digits.</li>
1a340 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 74 61 62 6c 65 20  ..</ul>..<table 
1a350 77 69 64 74 68 3d 22 31 30 30 25 22 20 62 67 63  width="100%" bgc
1a360 6f 6c 6f 72 3d 22 23 66 66 64 30 38 30 22 20 63  olor="#ffd080" c
1a370 65 6c 6c 70 61 64 64 69 6e 67 3d 22 36 22 3e 3c  ellpadding="6"><
1a380 74 72 3e 3c 74 64 3e 0d 0a 3c 75 3e 50 6c 65 61  tr><td>..<u>Plea
1a390 73 65 20 6e 6f 74 65 20 76 65 72 79 20 77 65 6c  se note very wel
1a3a0 6c 3c 2f 75 3e 3a 20 74 68 69 73 20 53 51 4c 20  l</u>: this SQL 
1a3b0 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79  function is only
1a3c0 20 61 76 61 69 6c 61 62 6c 65 20 77 68 65 6e 20   available when 
1a3d0 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20  the environment 
1a3e0 76 61 72 69 61 62 6c 65 20 3c 62 3e 53 50 41 54  variable <b>SPAT
1a3f0 49 41 4c 49 54 45 5f 53 45 43 55 52 49 54 59 3d  IALITE_SECURITY=
1a400 72 65 6c 61 78 65 64 3c 2f 62 3e 20 69 73 20 73  relaxed</b> is s
1a410 65 74 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 3c 2f 74  et.</td></tr></t
1a420 61 62 6c 65 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72  able></td>..</tr
1a430 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74  >..</tr>..<tr><t
1a440 64 3e 3c 62 3e 52 4c 32 5f 57 72 69 74 65 4a 70  d><b>RL2_WriteJp
1a450 65 67 4a 47 57 3c 2f 62 3e 20 28 20 3c 62 3e 64  egJGW</b> ( <b>d
1a460 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53  bPrefix</b> <i>S
1a470 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63  tring</i> , <b>c
1a480 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20  overageName</b> 
1a490 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
1a4a0 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20  <b>filePath</b> 
1a4b0 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
1a4c0 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e  <b>width</b> <i>
1a4d0 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
1a4e0 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49  >height</b> <i>I
1a4f0 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
1a500 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20  boundingBox</b> 
1a510 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79  <i>BLOB-Geometry
1a520 3c 2f 69 3e 20 2c 20 3c 62 3e 70 69 78 65 6c 52  </i> , <b>pixelR
1a530 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69  esolution</b> <i
1a540 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a 20  >Double</i> ) : 
1a550 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62  <i>Integer</i><b
1a560 72 3e 3c 62 72 3e 3c 62 3e 52 4c 32 5f 57 72 69  r><br><b>RL2_Wri
1a570 74 65 4a 70 65 67 4a 47 57 3c 2f 62 3e 20 28 20  teJpegJGW</b> ( 
1a580 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20  <b>dbPrefix</b> 
1a590 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
1a5a0 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
1a5b0 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
1a5c0 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c  > , <b>filePath<
1a5d0 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
1a5e0 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e  > , <b>width</b>
1a5f0 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
1a600 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20  , <b>height</b> 
1a610 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
1a620 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c   <b>boundingBox<
1a630 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d  /b> <i>BLOB-Geom
1a640 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f  etry</i> , <b>ho
1a650 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rzPixelResolutio
1a660 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c  n</b> <i>Double<
1a670 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69 78  /i> , <b>vertPix
1a680 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e  elResolution</b>
1a690 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 29   <i>Double</i> )
1a6a0 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69   : <i>Integer</i
1a6b0 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c  ><br><br>..<b>RL
1a6c0 32 5f 57 72 69 74 65 4a 70 65 67 4a 47 57 3c 2f  2_WriteJpegJGW</
1a6d0 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78  b> ( <b>dbPrefix
1a6e0 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
1a6f0 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65  i> , <b>coverage
1a700 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Name</b> <i>Stri
1a710 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65  ng</i> , <b>file
1a720 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Path</b> <i>Stri
1a730 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74  ng</i> , <b>widt
1a740 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  h</b> <i>Integer
1a750 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74  </i> , <b>height
1a760 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
1a770 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e  /i> , <b>boundin
1a780 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42  gBox</b> <i>BLOB
1a790 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20  -Geometry</i> , 
1a7a0 3c 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f  <b>horzPixelReso
1a7b0 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f  lution</b> <i>Do
1a7c0 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65  uble</i> , <b>ve
1a7d0 72 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rtPixelResolutio
1a7e0 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c  n</b> <i>Double<
1a7f0 2f 69 3e 20 2c 20 3c 62 3e 71 75 61 6c 69 74 79  /i> , <b>quality
1a800 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
1a810 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67  /i> ) : <i>Integ
1a820 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  er</i></td>..<td
1a830 3e 57 69 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f  >Will attempt to
1a840 20 65 78 70 6f 72 74 20 72 61 77 20 72 61 73 74   export raw rast
1a850 65 72 20 64 61 74 61 20 66 72 6f 6d 20 61 20 47  er data from a G
1a860 52 41 59 53 43 41 4c 45 20 55 49 4e 54 38 20 6f  RAYSCALE UINT8 o
1a870 72 20 52 47 42 20 55 49 4e 54 38 20 43 6f 76 65  r RGB UINT8 Cove
1a880 72 61 67 65 20 69 6e 74 6f 20 61 6e 20 65 78 74  rage into an ext
1a890 65 72 6e 61 6c 20 4a 50 45 47 20 66 69 6c 65 20  ernal JPEG file 
1a8a0 73 75 70 70 6f 72 74 65 64 20 62 79 20 61 6e 20  supported by an 
1a8b0 61 75 78 69 6c 69 61 72 79 20 57 6f 72 6c 64 46  auxiliary WorldF
1a8c0 69 6c 65 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72  ile.<br>..Will r
1a8d0 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28  eturn <b>1</b> (
1a8e0 54 52 55 45 2f 53 55 43 43 45 53 53 29 20 6f 72  TRUE/SUCCESS) or
1a8f0 20 3c 62 3e 30 3c 2f 62 3e 20 28 46 41 4c 53 45   <b>0</b> (FALSE
1a900 2f 46 41 49 4c 55 52 45 29 3a 20 6f 72 20 3c 62  /FAILURE): or <b
1a910 3e 2d 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c  >-1</b> on inval
1a920 69 64 20 61 72 67 75 6d 65 6e 74 73 2e 3c 62 72  id arguments.<br
1a930 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74  >..<u>Please not
1a940 65 3c 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c  e</u>: ..<ul>..<
1a950 6c 69 3e 54 68 65 20 3c 62 3e 3c 69 3e 64 62 50  li>The <b><i>dbP
1a960 72 65 66 69 78 3c 2f 69 3e 3c 2f 62 3e 20 61 72  refix</i></b> ar
1a970 67 75 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e 64  gument is intend
1a980 65 64 20 74 6f 20 73 70 65 63 69 66 79 20 74 68  ed to specify th
1a990 65 20 41 54 54 41 43 48 45 44 2d 44 42 20 77 68  e ATTACHED-DB wh
1a9a0 65 72 65 20 74 68 65 20 43 6f 76 65 72 61 67 65  ere the Coverage
1a9b0 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f 20   is expected to 
1a9c0 62 65 20 66 6f 75 6e 64 3b 20 69 74 20 63 6f 75  be found; it cou
1a9d0 6c 64 20 62 65 20 65 76 65 6e 74 75 61 6c 6c 79  ld be eventually
1a9e0 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e   <b>NULL</b>, an
1a9f0 64 20 69 6e 20 74 68 69 73 20 63 61 73 65 20 74  d in this case t
1aa00 68 65 20 3c 62 3e 4d 41 49 4e 20 44 42 3c 2f 62  he <b>MAIN DB</b
1aa10 3e 20 77 69 6c 6c 20 69 6d 70 6c 69 63 69 74 6c  > will implicitl
1aa20 79 20 62 65 20 61 73 73 75 6d 65 64 2e 3c 2f 6c  y be assumed.</l
1aa30 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c  i>..<li>the <b><
1aa40 69 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 69  i>boundingBox</i
1aa50 3e 3c 2f 62 3e 20 69 73 20 65 78 70 65 63 74 65  ></b> is expecte
1aa60 64 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20 74  d to represent t
1aa70 68 65 20 6f 76 65 72 61 6c 6c 20 65 78 74 65 6e  he overall exten
1aa80 74 20 6f 66 20 74 68 65 20 65 78 70 6f 72 74 65  t of the exporte
1aa90 64 20 4a 50 45 47 3b 20 79 6f 75 20 63 6f 75 6c  d JPEG; you coul
1aaa0 64 20 65 76 65 6e 74 75 61 6c 6c 79 20 70 61 73  d eventually pas
1aab0 73 20 61 6e 79 20 61 72 62 69 74 72 61 72 79 20  s any arbitrary 
1aac0 6b 69 6e 64 20 6f 66 20 47 65 6f 6d 65 74 72 79  kind of Geometry
1aad0 2c 20 61 6e 64 20 74 68 65 20 42 6f 75 6e 64 69  , and the Boundi
1aae0 6e 67 20 42 6f 78 20 61 6b 61 20 4d 42 52 20 77  ng Box aka MBR w
1aaf0 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69 63  ill be automatic
1ab00 61 6c 6c 79 20 64 65 74 65 72 6d 69 6e 65 64 2e  ally determined.
1ab10 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c  </li>..<li>the <
1ab20 62 3e 3c 69 3e 68 6f 72 7a 50 69 78 65 6c 52 65  b><i>horzPixelRe
1ab30 73 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e  solution</i></b>
1ab40 20 61 6e 64 20 3c 62 3e 3c 69 3e 76 65 72 74 50   and <b><i>vertP
1ab50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
1ab60 69 3e 3c 2f 62 3e 20 6d 75 73 74 20 65 78 61 63  i></b> must exac
1ab70 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20 43 6f  tly match the Co
1ab80 76 65 72 61 67 65 27 73 20 62 61 73 65 20 72 65  verage's base re
1ab90 73 6f 6c 75 74 69 6f 6e 20 6f 72 20 6f 6e 65 20  solution or one 
1aba0 6f 66 20 74 68 65 20 72 65 73 6f 6c 75 74 69 6f  of the resolutio
1abb0 6e 73 20 6d 61 64 65 20 61 76 61 69 6c 61 62 6c  ns made availabl
1abc0 65 20 62 79 20 74 68 65 20 63 6f 72 72 65 73 70  e by the corresp
1abd0 6f 6e 64 69 6e 67 20 50 79 72 61 6d 69 64 20 6c  onding Pyramid l
1abe0 65 76 65 6c 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69  evels.</li>..<li
1abf0 3e 61 6e 64 20 74 68 65 20 42 6f 75 6e 64 69 6e  >and the Boundin
1ac00 67 42 6f 78 20 6d 75 73 74 20 65 78 61 63 74 6c  gBox must exactl
1ac10 79 20 6d 61 74 63 68 20 74 68 65 20 4a 50 45 47  y match the JPEG
1ac20 20 3c 62 3e 3c 69 3e 77 69 64 74 68 3c 2f 69 3e   <b><i>width</i>
1ac30 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e 68  </b> and <b><i>h
1ac40 65 69 67 68 74 3c 2f 69 3e 3c 2f 62 3e 20 64 69  eight</i></b> di
1ac50 6d 65 6e 73 69 6f 6e 73 20 61 74 20 74 68 61 74  mensions at that
1ac60 20 72 65 73 6f 6c 75 74 69 6f 6e 2e 3c 2f 6c 69   resolution.</li
1ac70 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6c 61 73 74 20  >..<li>the last 
1ac80 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e  optional argumen
1ac90 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 73 6f  t can be used so
1aca0 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 20   to specify the 
1acb0 70 72 65 66 65 72 72 65 64 20 4a 50 45 47 20 3c  preferred JPEG <
1acc0 62 3e 3c 69 3e 71 75 61 6c 69 74 79 3c 2f 69 3e  b><i>quality</i>
1acd0 3c 2f 62 3e 20 28 69 6e 20 74 68 65 20 72 61 6e  </b> (in the ran
1ace0 67 65 20 3c 62 3e 30 3c 2f 62 3e 20 2d 20 3c 62  ge <b>0</b> - <b
1acf0 3e 31 30 30 3c 2f 62 3e 29 3b 20 64 65 66 61 75  >100</b>); defau
1ad00 6c 74 20 69 73 20 3c 62 3e 38 30 3c 2f 62 3e 2e  lt is <b>80</b>.
1ad10 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 74  </li>..</ul>..<t
1ad20 61 62 6c 65 20 77 69 64 74 68 3d 22 31 30 30 25  able width="100%
1ad30 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 64 30  " bgcolor="#ffd0
1ad40 38 30 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d  80" cellpadding=
1ad50 22 36 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 75  "6"><tr><td>..<u
1ad60 3e 50 6c 65 61 73 65 20 6e 6f 74 65 20 76 65 72  >Please note ver
1ad70 79 20 77 65 6c 6c 3c 2f 75 3e 3a 20 74 68 69 73  y well</u>: this
1ad80 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 69 73   SQL function is
1ad90 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 20   only available 
1ada0 77 68 65 6e 20 74 68 65 20 65 6e 76 69 72 6f 6e  when the environ
1adb0 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 3c 62  ment variable <b
1adc0 3e 53 50 41 54 49 41 4c 49 54 45 5f 53 45 43 55  >SPATIALITE_SECU
1add0 52 49 54 59 3d 72 65 6c 61 78 65 64 3c 2f 62 3e  RITY=relaxed</b>
1ade0 20 69 73 20 73 65 74 2e 3c 2f 74 64 3e 3c 2f 74   is set.</td></t
1adf0 72 3e 3c 2f 74 61 62 6c 65 3e 3c 2f 74 64 3e 0d  r></table></td>.
1ae00 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e  .</tr>..<tr><td>
1ae10 3c 62 3e 52 4c 32 5f 57 72 69 74 65 4a 70 65 67  <b>RL2_WriteJpeg
1ae20 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66  </b> ( <b>dbPref
1ae30 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  ix</b> <i>String
1ae40 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61  </i> , <b>covera
1ae50 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74  geName</b> <i>St
1ae60 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69  ring</i> , <b>fi
1ae70 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74  lePath</b> <i>St
1ae80 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69  ring</i> , <b>wi
1ae90 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  dth</b> <i>Integ
1aea0 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67  er</i> , <b>heig
1aeb0 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ht</b> <i>Intege
1aec0 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64  r</i> , <b>bound
1aed0 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c  ingBox</b> <i>BL
1aee0 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20  OB-Geometry</i> 
1aef0 2c 20 3c 62 3e 70 69 78 65 6c 52 65 73 6f 6c 75  , <b>pixelResolu
1af00 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62  tion</b> <i>Doub
1af10 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e  le</i> ) : <i>In
1af20 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72  teger</i><br><br
1af30 3e 3c 62 3e 52 4c 32 5f 57 72 69 74 65 4a 70 65  ><b>RL2_WriteJpe
1af40 67 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65  g</b> ( <b>dbPre
1af50 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  fix</b> <i>Strin
1af60 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72  g</i> , <b>cover
1af70 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  ageName</b> <i>S
1af80 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 66  tring</i> , <b>f
1af90 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53  ilePath</b> <i>S
1afa0 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77  tring</i> , <b>w
1afb0 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  idth</b> <i>Inte
1afc0 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69  ger</i> , <b>hei
1afd0 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  ght</b> <i>Integ
1afe0 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e  er</i> , <b>boun
1aff0 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42  dingBox</b> <i>B
1b000 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e  LOB-Geometry</i>
1b010 20 2c 20 3c 62 3e 68 6f 72 7a 50 69 78 65 6c 52   , <b>horzPixelR
1b020 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69  esolution</b> <i
1b030 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62  >Double</i> , <b
1b040 3e 76 65 72 74 50 69 78 65 6c 52 65 73 6f 6c 75  >vertPixelResolu
1b050 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62  tion</b> <i>Doub
1b060 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e  le</i> ) : <i>In
1b070 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72  teger</i><br><br
1b080 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65 4a  >..<b>RL2_WriteJ
1b090 70 65 67 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50  peg</b> ( <b>dbP
1b0a0 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72  refix</b> <i>Str
1b0b0 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76  ing</i> , <b>cov
1b0c0 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69  erageName</b> <i
1b0d0 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
1b0e0 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69  >filePath</b> <i
1b0f0 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
1b100 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
1b110 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
1b120 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
1b130 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f  eger</i> , <b>bo
1b140 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69  undingBox</b> <i
1b150 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f  >BLOB-Geometry</
1b160 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50 69 78 65  i> , <b>horzPixe
1b170 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20  lResolution</b> 
1b180 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20  <i>Double</i> , 
1b190 3c 62 3e 76 65 72 74 50 69 78 65 6c 52 65 73 6f  <b>vertPixelReso
1b1a0 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f  lution</b> <i>Do
1b1b0 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 71 75  uble</i> , <b>qu
1b1c0 61 6c 69 74 79 3c 2f 62 3e 20 3c 69 3e 49 6e 74  ality</b> <i>Int
1b1d0 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e  eger</i> ) : <i>
1b1e0 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e  Integer</i></td>
1b1f0 0d 0a 3c 74 64 3e 57 69 6c 6c 20 61 74 74 65 6d  ..<td>Will attem
1b200 70 74 20 74 6f 20 65 78 70 6f 72 74 20 72 61 77  pt to export raw
1b210 20 72 61 73 74 65 72 20 64 61 74 61 20 66 72 6f   raster data fro
1b220 6d 20 61 20 47 52 41 59 53 43 41 4c 45 20 55 49  m a GRAYSCALE UI
1b230 4e 54 38 20 6f 72 20 52 47 42 20 55 49 4e 54 38  NT8 or RGB UINT8
1b240 20 43 6f 76 65 72 61 67 65 20 69 6e 74 6f 20 61   Coverage into a
1b250 6e 20 65 78 74 65 72 6e 61 6c 20 4a 50 45 47 20  n external JPEG 
1b260 66 69 6c 65 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20  file.<br>..Will 
1b270 72 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20  return <b>1</b> 
1b280 28 54 52 55 45 2f 53 55 43 43 45 53 53 29 20 6f  (TRUE/SUCCESS) o
1b290 72 20 3c 62 3e 30 3c 2f 62 3e 20 28 46 41 4c 53  r <b>0</b> (FALS
1b2a0 45 2f 46 41 49 4c 55 52 45 29 3a 20 6f 72 20 3c  E/FAILURE): or <
1b2b0 62 3e 2d 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61  b>-1</b> on inva
1b2c0 6c 69 64 20 61 72 67 75 6d 65 6e 74 73 2e 3c 62  lid arguments.<b
1b2d0 72 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f  r>..<u>Please no
1b2e0 74 65 3c 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a  te</u>: ..<ul>..
1b2f0 3c 6c 69 3e 54 68 65 20 3c 62 3e 3c 69 3e 64 62  <li>The <b><i>db
1b300 50 72 65 66 69 78 3c 2f 69 3e 3c 2f 62 3e 20 61  Prefix</i></b> a
1b310 72 67 75 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e  rgument is inten
1b320 64 65 64 20 74 6f 20 73 70 65 63 69 66 79 20 74  ded to specify t
1b330 68 65 20 41 54 54 41 43 48 45 44 2d 44 42 20 77  he ATTACHED-DB w
1b340 68 65 72 65 20 74 68 65 20 43 6f 76 65 72 61 67  here the Coverag
1b350 65 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f  e is expected to
1b360 20 62 65 20 66 6f 75 6e 64 3b 20 69 74 20 63 6f   be found; it co
1b370 75 6c 64 20 62 65 20 65 76 65 6e 74 75 61 6c 6c  uld be eventuall
1b380 79 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61  y <b>NULL</b>, a
1b390 6e 64 20 69 6e 20 74 68 69 73 20 63 61 73 65 20  nd in this case 
1b3a0 74 68 65 20 3c 62 3e 4d 41 49 4e 20 44 42 3c 2f  the <b>MAIN DB</
1b3b0 62 3e 20 77 69 6c 6c 20 69 6d 70 6c 69 63 69 74  b> will implicit
1b3c0 6c 79 20 62 65 20 61 73 73 75 6d 65 64 2e 3c 2f  ly be assumed.</
1b3d0 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e  li>..<li>the <b>
1b3e0 3c 69 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f  <i>boundingBox</
1b3f0 69 3e 3c 2f 62 3e 20 69 73 20 65 78 70 65 63 74  i></b> is expect
1b400 65 64 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20  ed to represent 
1b410 74 68 65 20 6f 76 65 72 61 6c 6c 20 65 78 74 65  the overall exte
1b420 6e 74 20 6f 66 20 74 68 65 20 65 78 70 6f 72 74  nt of the export
1b430 65 64 20 4a 50 45 47 3b 20 79 6f 75 20 63 6f 75  ed JPEG; you cou
1b440 6c 64 20 65 76 65 6e 74 75 61 6c 6c 79 20 70 61  ld eventually pa
1b450 73 73 20 61 6e 79 20 61 72 62 69 74 72 61 72 79  ss any arbitrary
1b460 20 6b 69 6e 64 20 6f 66 20 47 65 6f 6d 65 74 72   kind of Geometr
1b470 79 2c 20 61 6e 64 20 74 68 65 20 42 6f 75 6e 64  y, and the Bound
1b480 69 6e 67 20 42 6f 78 20 61 6b 61 20 4d 42 52 20  ing Box aka MBR 
1b490 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69  will be automati
1b4a0 63 61 6c 6c 79 20 64 65 74 65 72 6d 69 6e 65 64  cally determined
1b4b0 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20  .</li>..<li>the 
1b4c0 3c 62 3e 3c 69 3e 68 6f 72 7a 50 69 78 65 6c 52  <b><i>horzPixelR
1b4d0 65 73 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62  esolution</i></b
1b4e0 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e 76 65 72 74  > and <b><i>vert
1b4f0 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c  PixelResolution<
1b500 2f 69 3e 3c 2f 62 3e 20 6d 75 73 74 20 65 78 61  /i></b> must exa
1b510 63 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20 43  ctly match the C
1b520 6f 76 65 72 61 67 65 27 73 20 62 61 73 65 20 72  overage's base r
1b530 65 73 6f 6c 75 74 69 6f 6e 20 6f 72 20 6f 6e 65  esolution or one
1b540 20 6f 66 20 74 68 65 20 72 65 73 6f 6c 75 74 69   of the resoluti
1b550 6f 6e 73 20 6d 61 64 65 20 61 76 61 69 6c 61 62  ons made availab
1b560 6c 65 20 62 79 20 74 68 65 20 63 6f 72 72 65 73  le by the corres
1b570 70 6f 6e 64 69 6e 67 20 50 79 72 61 6d 69 64 20  ponding Pyramid 
1b580 6c 65 76 65 6c 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c  levels.</li>..<l
1b590 69 3e 61 6e 64 20 74 68 65 20 42 6f 75 6e 64 69  i>and the Boundi
1b5a0 6e 67 42 6f 78 20 6d 75 73 74 20 65 78 61 63 74  ngBox must exact
1b5b0 6c 79 20 6d 61 74 63 68 20 74 68 65 20 4a 50 45  ly match the JPE
1b5c0 47 20 3c 62 3e 3c 69 3e 77 69 64 74 68 3c 2f 69  G <b><i>width</i
1b5d0 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e  ></b> and <b><i>
1b5e0 68 65 69 67 68 74 3c 2f 69 3e 3c 2f 62 3e 20 64  height</i></b> d
1b5f0 69 6d 65 6e 73 69 6f 6e 73 20 61 74 20 74 68 61  imensions at tha
1b600 74 20 72 65 73 6f 6c 75 74 69 6f 6e 2e 3c 2f 6c  t resolution.</l
1b610 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6c 61 73 74  i>..<li>the last
1b620 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65   optional argume
1b630 6e 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 73  nt can be used s
1b640 6f 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65  o to specify the
1b650 20 70 72 65 66 65 72 72 65 64 20 4a 50 45 47 20   preferred JPEG 
1b660 3c 62 3e 3c 69 3e 71 75 61 6c 69 74 79 3c 2f 69  <b><i>quality</i
1b670 3e 3c 2f 62 3e 20 28 69 6e 20 74 68 65 20 72 61  ></b> (in the ra
1b680 6e 67 65 20 3c 62 3e 30 3c 2f 62 3e 20 2d 20 3c  nge <b>0</b> - <
1b690 62 3e 31 30 30 3c 2f 62 3e 29 3b 20 64 65 66 61  b>100</b>); defa
1b6a0 75 6c 74 20 69 73 20 3c 62 3e 38 30 3c 2f 62 3e  ult is <b>80</b>
1b6b0 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c  .</li>..</ul>..<
1b6c0 74 61 62 6c 65 20 77 69 64 74 68 3d 22 31 30 30  table width="100
1b6d0 25 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 64  %" bgcolor="#ffd
1b6e0 30 38 30 22 20 63 65 6c 6c 70 61 64 64 69 6e 67  080" cellpadding
1b6f0 3d 22 36 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 3c  ="6"><tr><td>..<
1b700 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 20 76 65  u>Please note ve
1b710 72 79 20 77 65 6c 6c 3c 2f 75 3e 3a 20 74 68 69  ry well</u>: thi
1b720 73 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 69  s SQL function i
1b730 73 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65  s only available
1b740 20 77 68 65 6e 20 74 68 65 20 65 6e 76 69 72 6f   when the enviro
1b750 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 3c  nment variable <
1b760 62 3e 53 50 41 54 49 41 4c 49 54 45 5f 53 45 43  b>SPATIALITE_SEC
1b770 55 52 49 54 59 3d 72 65 6c 61 78 65 64 3c 2f 62  URITY=relaxed</b
1b780 3e 20 69 73 20 73 65 74 2e 3c 2f 74 64 3e 3c 2f  > is set.</td></
1b790 74 72 3e 3c 2f 74 61 62 6c 65 3e 3c 2f 74 64 3e  tr></table></td>
1b7a0 0d 0a 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65  ..</tr>..</table
1b7b0 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a 3c 68 32  ><br>..<hr>..<h2
1b7c0 3e 53 51 4c 20 66 75 6e 63 74 69 6f 6e 73 20 65  >SQL functions e
1b7d0 78 70 6f 72 74 69 6e 67 20 72 61 77 20 72 61 73  xporting raw ras
1b7e0 74 65 72 20 64 61 74 61 20 74 6f 20 65 78 74 65  ter data to exte
1b7f0 72 6e 61 6c 20 66 69 6c 65 73 20 28 53 65 63 74  rnal files (Sect
1b800 69 6f 6e 20 6f 72 69 65 6e 74 65 64 29 3c 2f 68  ion oriented)</h
1b810 32 3e 20 0d 0a 3c 74 61 62 6c 65 20 77 69 64 74  2> ..<table widt
1b820 68 3d 22 31 30 30 25 22 20 62 6f 72 64 65 72 3d  h="100%" border=
1b830 22 31 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66  "1" bgcolor="#ff
1b840 66 66 65 30 22 20 63 65 6c 6c 65 73 70 61 63 69  ffe0" cellespaci
1b850 6e 67 3d 22 34 22 20 63 65 6c 6c 70 61 64 64 69  ng="4" cellpaddi
1b860 6e 67 3d 22 36 22 3e 0d 0a 3c 74 72 3e 3c 74 68  ng="6">..<tr><th
1b870 20 62 67 63 6f 6c 6f 72 3d 22 23 65 30 65 30 65   bgcolor="#e0e0e
1b880 30 22 20 77 69 64 74 68 3d 22 35 30 25 22 3e 53  0" width="50%">S
1b890 79 6e 74 61 78 3c 2f 74 68 3e 3c 74 68 20 62 67  yntax</th><th bg
1b8a0 63 6f 6c 6f 72 3d 22 23 65 30 65 30 65 30 22 20  color="#e0e0e0" 
1b8b0 77 69 64 74 68 3d 22 35 30 25 22 3e 53 75 6d 6d  width="50%">Summ
1b8c0 61 72 79 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c  ary</th></tr>..<
1b8d0 74 72 3e 3c 74 64 3e 3c 62 3e 52 4c 32 5f 57 72  tr><td><b>RL2_Wr
1b8e0 69 74 65 53 65 63 74 69 6f 6e 47 65 6f 54 69 66  iteSectionGeoTif
1b8f0 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65  f</b> ( <b>dbPre
1b900 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  fix</b> <i>Strin
1b910 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72  g</i> , <b>cover
1b920 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  ageName</b> <i>S
1b930 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73  tring</i> , <b>s
1b940 65 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e  ectionID</b> <i>
1b950 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
1b960 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69  >filePath</b> <i
1b970 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
1b980 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
1b990 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
1b9a0 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
1b9b0 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f  eger</i> , <b>bo
1b9c0 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69  undingBox</b> <i
1b9d0 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f  >BLOB-Geometry</
1b9e0 69 3e 20 2c 20 3c 62 3e 70 69 78 65 6c 52 65 73  i> , <b>pixelRes
1b9f0 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44  olution</b> <i>D
1ba00 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c 69  ouble</i> ) : <i
1ba10 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e  >Integer</i><br>
1ba20 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69  <br>..<b>RL2_Wri
1ba30 74 65 53 65 63 74 69 6f 6e 47 65 6f 54 69 66 66  teSectionGeoTiff
1ba40 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66  </b> ( <b>dbPref
1ba50 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  ix</b> <i>String
1ba60 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61  </i> , <b>covera
1ba70 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74  geName</b> <i>St
1ba80 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65  ring</i> , <b>se
1ba90 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e 49  ctionID</b> <i>I
1baa0 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
1bab0 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e  filePath</b> <i>
1bac0 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
1bad0 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74  width</b> <i>Int
1bae0 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65  eger</i> , <b>he
1baf0 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  ight</b> <i>Inte
1bb00 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75  ger</i> , <b>bou
1bb10 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e  ndingBox</b> <i>
1bb20 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69  BLOB-Geometry</i
1bb30 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50 69 78 65 6c  > , <b>horzPixel
1bb40 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c  Resolution</b> <
1bb50 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c  i>Double</i> , <
1bb60 62 3e 76 65 72 74 50 69 78 65 6c 52 65 73 6f 6c  b>vertPixelResol
1bb70 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75  ution</b> <i>Dou
1bb80 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49  ble</i> ) : <i>I
1bb90 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62  nteger</i><br><b
1bba0 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65  r>..<b>RL2_Write
1bbb0 53 65 63 74 69 6f 6e 47 65 6f 54 69 66 66 3c 2f  SectionGeoTiff</
1bbc0 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78  b> ( <b>dbPrefix
1bbd0 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
1bbe0 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65  i> , <b>coverage
1bbf0 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Name</b> <i>Stri
1bc00 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74  ng</i> , <b>sect
1bc10 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74  ionID</b> <i>Int
1bc20 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69  eger</i> , <b>fi
1bc30 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74  lePath</b> <i>St
1bc40 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69  ring</i> , <b>wi
1bc50 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  dth</b> <i>Integ
1bc60 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67  er</i> , <b>heig
1bc70 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ht</b> <i>Intege
1bc80 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64  r</i> , <b>bound
1bc90 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c  ingBox</b> <i>BL
1bca0 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20  OB-Geometry</i> 
1bcb0 2c 20 3c 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65  , <b>horzPixelRe
1bcc0 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e  solution</b> <i>
1bcd0 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e  Double</i> , <b>
1bce0 76 65 72 74 50 69 78 65 6c 52 65 73 6f 6c 75 74  vertPixelResolut
1bcf0 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c  ion</b> <i>Doubl
1bd00 65 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 74 68 57  e</i> , <b>withW
1bd10 6f 6c 64 46 69 6c 65 3c 2f 62 3e 20 3c 69 3e 49  oldFile</b> <i>I
1bd20 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c  nteger</i> ) : <
1bd30 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72  i>Integer</i><br
1bd40 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72  ><br>..<b>RL2_Wr
1bd50 69 74 65 53 65 63 74 69 6f 6e 47 65 6f 54 69 66  iteSectionGeoTif
1bd60 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65  f</b> ( <b>dbPre
1bd70 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  fix</b> <i>Strin
1bd80 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72  g</i> , <b>cover
1bd90 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  ageName</b> <i>S
1bda0 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73  tring</i> , <b>s
1bdb0 65 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e  ectionID</b> <i>
1bdc0 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
1bdd0 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69  >filePath</b> <i
1bde0 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
1bdf0 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
1be00 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
1be10 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
1be20 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f  eger</i> , <b>bo
1be30 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69  undingBox</b> <i
1be40 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f  >BLOB-Geometry</
1be50 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50 69 78 65  i> , <b>horzPixe
1be60 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20  lResolution</b> 
1be70 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20  <i>Double</i> , 
1be80 3c 62 3e 76 65 72 74 50 69 78 65 6c 52 65 73 6f  <b>vertPixelReso
1be90 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f  lution</b> <i>Do
1bea0 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69  uble</i> , <b>wi
1beb0 74 68 57 6f 6c 64 46 69 6c 65 3c 2f 62 3e 20 3c  thWoldFile</b> <
1bec0 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
1bed0 3c 62 3e 74 69 66 66 43 6f 6d 70 72 65 73 73 69  <b>tiffCompressi
1bee0 6f 6e 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  on</b> <i>String
1bef0 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65  </i> ) : <i>Inte
1bf00 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d  ger</i><br><br>.
1bf10 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65 53 65 63  .<b>RL2_WriteSec
1bf20 74 69 6f 6e 47 65 6f 54 69 66 66 3c 2f 62 3e 20  tionGeoTiff</b> 
1bf30 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62  ( <b>dbPrefix</b
1bf40 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
1bf50 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d  , <b>coverageNam
1bf60 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  e</b> <i>String<
1bf70 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e  /i> , <b>section
1bf80 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ID</b> <i>Intege
1bf90 72 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50  r</i> , <b>fileP
1bfa0 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ath</b> <i>Strin
1bfb0 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68  g</i> , <b>width
1bfc0 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
1bfd0 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c  /i> , <b>height<
1bfe0 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
1bff0 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67  i> , <b>bounding
1c000 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d  Box</b> <i>BLOB-
1c010 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c  Geometry</i> , <
1c020 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c  b>horzPixelResol
1c030 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75  ution</b> <i>Dou
1c040 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72  ble</i> , <b>ver
1c050 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  tPixelResolution
1c060 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f  </b> <i>Double</
1c070 69 3e 20 2c 20 3c 62 3e 77 69 74 68 57 6f 6c 64  i> , <b>withWold
1c080 46 69 6c 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  File</b> <i>Inte
1c090 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 66  ger</i> , <b>tif
1c0a0 66 43 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 62 3e  fCompression</b>
1c0b0 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
1c0c0 20 3c 62 3e 74 69 66 66 54 69 6c 65 53 69 7a 65   <b>tiffTileSize
1c0d0 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
1c0e0 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67  /i> ) : <i>Integ
1c0f0 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  er</i></td>..<td
1c100 3e 57 69 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f  >Will attempt to
1c110 20 65 78 70 6f 72 74 20 72 61 77 20 72 61 73 74   export raw rast
1c120 65 72 20 64 61 74 61 20 66 72 6f 6d 20 61 20 43  er data from a C
1c130 6f 76 65 72 61 67 65 20 69 6e 74 6f 20 61 6e 20  overage into an 
1c140 65 78 74 65 72 6e 61 6c 20 47 65 6f 54 49 46 46  external GeoTIFF
1c150 20 66 69 6c 65 3b 20 6f 6e 6c 79 20 74 68 65 20   file; only the 
1c160 54 69 6c 65 73 20 64 69 72 65 63 74 6c 79 20 62  Tiles directly b
1c170 65 6c 6f 6e 67 69 6e 67 20 74 6f 20 74 68 65 20  elonging to the 
1c180 73 65 6c 65 63 74 65 64 20 53 65 63 74 69 6f 6e  selected Section
1c190 20 77 69 6c 6c 20 62 65 20 63 6f 6e 73 69 64 65   will be conside
1c1a0 72 65 64 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72  red.<br>..Will r
1c1b0 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28  eturn <b>1</b> (
1c1c0 54 52 55 45 2f 53 55 43 43 45 53 53 29 20 6f 72  TRUE/SUCCESS) or
1c1d0 20 3c 62 3e 30 3c 2f 62 3e 20 28 46 41 4c 53 45   <b>0</b> (FALSE
1c1e0 2f 46 41 49 4c 55 52 45 29 3a 20 6f 72 20 3c 62  /FAILURE): or <b
1c1f0 3e 2d 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c  >-1</b> on inval
1c200 69 64 20 61 72 67 75 6d 65 6e 74 73 2e 3c 62 72  id arguments.<br
1c210 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74  >..<u>Please not
1c220 65 3c 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c  e</u>: ..<ul>..<
1c230 6c 69 3e 54 68 65 20 3c 62 3e 3c 69 3e 64 62 50  li>The <b><i>dbP
1c240 72 65 66 69 78 3c 2f 69 3e 3c 2f 62 3e 20 61 72  refix</i></b> ar
1c250 67 75 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e 64  gument is intend
1c260 65 64 20 74 6f 20 73 70 65 63 69 66 79 20 74 68  ed to specify th
1c270 65 20 41 54 54 41 43 48 45 44 2d 44 42 20 77 68  e ATTACHED-DB wh
1c280 65 72 65 20 74 68 65 20 43 6f 76 65 72 61 67 65  ere the Coverage
1c290 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f 20   is expected to 
1c2a0 62 65 20 66 6f 75 6e 64 3b 20 69 74 20 63 6f 75  be found; it cou
1c2b0 6c 64 20 62 65 20 65 76 65 6e 74 75 61 6c 6c 79  ld be eventually
1c2c0 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e   <b>NULL</b>, an
1c2d0 64 20 69 6e 20 74 68 69 73 20 63 61 73 65 20 74  d in this case t
1c2e0 68 65 20 3c 62 3e 4d 41 49 4e 20 44 42 3c 2f 62  he <b>MAIN DB</b
1c2f0 3e 20 77 69 6c 6c 20 69 6d 70 6c 69 63 69 74 6c  > will implicitl
1c300 79 20 62 65 20 61 73 73 75 6d 65 64 2e 3c 2f 6c  y be assumed.</l
1c310 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c  i>..<li>the <b><
1c320 69 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 69  i>boundingBox</i
1c330 3e 3c 2f 62 3e 20 69 73 20 65 78 70 65 63 74 65  ></b> is expecte
1c340 64 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20 74  d to represent t
1c350 68 65 20 6f 76 65 72 61 6c 6c 20 65 78 74 65 6e  he overall exten
1c360 74 20 6f 66 20 74 68 65 20 65 78 70 6f 72 74 65  t of the exporte
1c370 64 20 47 65 6f 54 49 46 46 3b 20 79 6f 75 20 63  d GeoTIFF; you c
1c380 6f 75 6c 64 20 65 76 65 6e 74 75 61 6c 6c 79 20  ould eventually 
1c390 70 61 73 73 20 61 6e 79 20 61 72 62 69 74 72 61  pass any arbitra
1c3a0 72 79 20 6b 69 6e 64 20 6f 66 20 47 65 6f 6d 65  ry kind of Geome
1c3b0 74 72 79 2c 20 61 6e 64 20 74 68 65 20 42 6f 75  try, and the Bou
1c3c0 6e 64 69 6e 67 20 42 6f 78 20 61 6b 61 20 4d 42  nding Box aka MB
1c3d0 52 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61  R will be automa
1c3e0 74 69 63 61 6c 6c 79 20 64 65 74 65 72 6d 69 6e  tically determin
1c3f0 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68  ed.</li>..<li>th
1c400 65 20 3c 62 3e 3c 69 3e 68 6f 72 7a 50 69 78 65  e <b><i>horzPixe
1c410 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c  lResolution</i><
1c420 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e 76 65  /b> and <b><i>ve
1c430 72 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rtPixelResolutio
1c440 6e 3c 2f 69 3e 3c 2f 62 3e 20 6d 75 73 74 20 65  n</i></b> must e
1c450 78 61 63 74 6c 79 20 6d 61 74 63 68 20 74 68 65  xactly match the
1c460 20 43 6f 76 65 72 61 67 65 27 73 20 62 61 73 65   Coverage's base
1c470 20 72 65 73 6f 6c 75 74 69 6f 6e 20 6f 72 20 6f   resolution or o
1c480 6e 65 20 6f 66 20 74 68 65 20 72 65 73 6f 6c 75  ne of the resolu
1c490 74 69 6f 6e 73 20 6d 61 64 65 20 61 76 61 69 6c  tions made avail
1c4a0 61 62 6c 65 20 62 79 20 74 68 65 20 63 6f 72 72  able by the corr
1c4b0 65 73 70 6f 6e 64 69 6e 67 20 50 79 72 61 6d 69  esponding Pyrami
1c4c0 64 20 6c 65 76 65 6c 73 2e 3c 2f 6c 69 3e 0d 0a  d levels.</li>..
1c4d0 3c 6c 69 3e 61 6e 64 20 74 68 65 20 42 6f 75 6e  <li>and the Boun
1c4e0 64 69 6e 67 42 6f 78 20 6d 75 73 74 20 65 78 61  dingBox must exa
1c4f0 63 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20 54  ctly match the T
1c500 49 46 46 20 3c 62 3e 3c 69 3e 77 69 64 74 68 3c  IFF <b><i>width<
1c510 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c  /i></b> and <b><
1c520 69 3e 68 65 69 67 68 74 3c 2f 69 3e 3c 2f 62 3e  i>height</i></b>
1c530 20 64 69 6d 65 6e 73 69 6f 6e 73 20 61 74 20 74   dimensions at t
1c540 68 61 74 20 72 65 73 6f 6c 75 74 69 6f 6e 2e 3c  hat resolution.<
1c550 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69 66 20 74 68 65  /li>..<li>if the
1c560 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65   optional argume
1c570 6e 74 20 3c 62 3e 3c 69 3e 77 69 74 68 57 6f 72  nt <b><i>withWor
1c580 6c 64 46 69 6c 65 3c 2f 69 3e 3c 2f 62 3e 20 69  ldFile</i></b> i
1c590 73 20 73 65 74 20 74 6f 20 54 52 55 45 20 74 68  s set to TRUE th
1c5a0 65 6e 20 61 6e 20 61 75 78 69 6c 69 61 72 79 20  en an auxiliary 
1c5b0 57 6f 72 6c 64 46 69 6c 65 20 77 69 6c 6c 20 62  WorldFile will b
1c5c0 65 20 65 78 70 6f 72 74 65 64 20 61 73 20 77 65  e exported as we
1c5d0 6c 6c 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68  ll.</li>..<li>th
1c5e0 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d  e optional argum
1c5f0 65 6e 74 20 3c 62 3e 3c 69 3e 74 69 66 66 43 6f  ent <b><i>tiffCo
1c600 6d 70 72 65 73 73 69 6f 6e 3c 2f 69 3e 3c 2f 62  mpression</i></b
1c610 3e 20 63 6f 75 6c 64 20 62 65 20 6f 6e 65 20 6f  > could be one o
1c620 66 20 3c 62 3e 27 4e 4f 4e 45 27 3c 2f 62 3e 2c  f <b>'NONE'</b>,
1c630 20 3c 62 3e 27 44 45 46 4c 41 54 45 27 3c 2f 62   <b>'DEFLATE'</b
1c640 3e 2c 20 3c 62 3e 27 4c 5a 57 27 3c 2f 62 3e 2c  >, <b>'LZW'</b>,
1c650 20 3c 62 3e 27 4a 50 45 47 27 3c 2f 62 3e 2c 20   <b>'JPEG'</b>, 
1c660 3c 62 3e 27 46 41 58 33 27 3c 2f 62 3e 20 6f 72  <b>'FAX3'</b> or
1c670 20 3c 62 3e 27 46 41 58 34 27 3c 2f 62 3e 3b 20   <b>'FAX4'</b>; 
1c680 64 65 66 61 75 6c 74 20 69 73 20 3c 62 3e 27 4e  default is <b>'N
1c690 4f 4e 45 27 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a  ONE'</b>.</li>..
1c6a0 3c 6c 69 3e 74 68 65 20 6c 61 73 74 20 6f 70 74  <li>the last opt
1c6b0 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 63  ional argument c
1c6c0 61 6e 20 62 65 20 75 73 65 64 20 73 6f 20 74 6f  an be used so to
1c6d0 20 73 70 65 63 69 66 79 20 74 68 65 20 70 72 65   specify the pre
1c6e0 66 65 72 72 65 64 20 54 49 46 46 20 74 69 6c 65  ferred TIFF tile
1c6f0 20 73 69 7a 65 20 28 6f 6e 6c 79 20 73 71 75 61   size (only squa
1c700 72 65 20 74 69 6c 65 73 20 61 72 65 20 73 75 70  re tiles are sup
1c710 70 6f 72 74 65 64 29 3b 20 64 65 66 61 75 6c 74  ported); default
1c720 20 69 73 20 3c 62 3e 32 35 36 3c 2f 62 3e 2e 3c   is <b>256</b>.<
1c730 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 74 61  /li>..</ul>..<ta
1c740 62 6c 65 20 77 69 64 74 68 3d 22 31 30 30 25 22  ble width="100%"
1c750 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 64 30 38   bgcolor="#ffd08
1c760 30 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22  0" cellpadding="
1c770 36 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 75 3e  6"><tr><td>..<u>
1c780 50 6c 65 61 73 65 20 6e 6f 74 65 20 76 65 72 79  Please note very
1c790 20 77 65 6c 6c 3c 2f 75 3e 3a 20 74 68 69 73 20   well</u>: this 
1c7a0 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  SQL function is 
1c7b0 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 77  only available w
1c7c0 68 65 6e 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d  hen the environm
1c7d0 65 6e 74 20 76 61 72 69 61 62 6c 65 20 3c 62 3e  ent variable <b>
1c7e0 53 50 41 54 49 41 4c 49 54 45 5f 53 45 43 55 52  SPATIALITE_SECUR
1c7f0 49 54 59 3d 72 65 6c 61 78 65 64 3c 2f 62 3e 20  ITY=relaxed</b> 
1c800 69 73 20 73 65 74 2e 3c 2f 74 64 3e 3c 2f 74 72  is set.</td></tr
1c810 3e 3c 2f 74 61 62 6c 65 3e 3c 2f 74 64 3e 0d 0a  ></table></td>..
1c820 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c  </tr>..<tr><td><
1c830 62 3e 52 4c 32 5f 57 72 69 74 65 53 65 63 74 69  b>RL2_WriteSecti
1c840 6f 6e 54 69 66 66 54 46 57 3c 2f 62 3e 20 28 20  onTiffTFW</b> ( 
1c850 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20  <b>dbPrefix</b> 
1c860 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
1c870 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
1c880 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
1c890 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 49 44  > , <b>sectionID
1c8a0 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
1c8b0 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74  /i> , <b>filePat
1c8c0 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  h</b> <i>String<
1c8d0 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f  /i> , <b>width</
1c8e0 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
1c8f0 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62  > , <b>height</b
1c900 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
1c910 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f   , <b>boundingBo
1c920 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65  x</b> <i>BLOB-Ge
1c930 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e  ometry</i> , <b>
1c940 70 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c  pixelResolution<
1c950 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69  /b> <i>Double</i
1c960 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72  > ) : <i>Integer
1c970 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62  </i><br><br>..<b
1c980 3e 52 4c 32 5f 57 72 69 74 65 53 65 63 74 69 6f  >RL2_WriteSectio
1c990 6e 54 69 66 66 54 46 57 3c 2f 62 3e 20 28 20 3c  nTiffTFW</b> ( <
1c9a0 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c  b>dbPrefix</b> <
1c9b0 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
1c9c0 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f  b>coverageName</
1c9d0 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
1c9e0 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 49 44 3c   , <b>sectionID<
1c9f0 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
1ca00 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68  i> , <b>filePath
1ca10 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
1ca20 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62  i> , <b>width</b
1ca30 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
1ca40 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e   , <b>height</b>
1ca50 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
1ca60 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78  , <b>boundingBox
1ca70 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f  </b> <i>BLOB-Geo
1ca80 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68  metry</i> , <b>h
1ca90 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69  orzPixelResoluti
1caa0 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65  on</b> <i>Double
1cab0 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69  </i> , <b>vertPi
1cac0 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62  xelResolution</b
1cad0 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20  > <i>Double</i> 
1cae0 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  ) : <i>Integer</
1caf0 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52  i><br><br>..<b>R
1cb00 4c 32 5f 57 72 69 74 65 53 65 63 74 69 6f 6e 54  L2_WriteSectionT
1cb10 69 66 66 54 46 57 3c 2f 62 3e 20 28 20 3c 62 3e  iffTFW</b> ( <b>
1cb20 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e  dbPrefix</b> <i>
1cb30 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
1cb40 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e  coverageName</b>
1cb50 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
1cb60 20 3c 62 3e 73 65 63 74 69 6f 6e 49 44 3c 2f 62   <b>sectionID</b
1cb70 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
1cb80 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f   , <b>filePath</
1cb90 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
1cba0 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20   , <b>width</b> 
1cbb0 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
1cbc0 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c   <b>height</b> <
1cbd0 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
1cbe0 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f  <b>boundingBox</
1cbf0 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65  b> <i>BLOB-Geome
1cc00 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72  try</i> , <b>hor
1cc10 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  zPixelResolution
1cc20 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f  </b> <i>Double</
1cc30 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69 78 65  i> , <b>vertPixe
1cc40 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20  lResolution</b> 
1cc50 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20  <i>Double</i> , 
1cc60 3c 62 3e 74 69 66 66 43 6f 6d 70 72 65 73 73 69  <b>tiffCompressi
1cc70 6f 6e 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  on</b> <i>String
1cc80 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65  </i> ) : <i>Inte
1cc90 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d  ger</i><br><br>.
1cca0 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65 53 65 63  .<b>RL2_WriteSec
1ccb0 74 69 6f 6e 54 69 66 66 54 46 57 3c 2f 62 3e 20  tionTiffTFW</b> 
1ccc0 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62  ( <b>dbPrefix</b
1ccd0 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
1cce0 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d  , <b>coverageNam
1ccf0 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  e</b> <i>String<
1cd00 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e  /i> , <b>section
1cd10 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ID</b> <i>Intege
1cd20 72 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50  r</i> , <b>fileP
1cd30 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ath</b> <i>Strin
1cd40 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68  g</i> , <b>width
1cd50 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
1cd60 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c  /i> , <b>height<
1cd70 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
1cd80 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67  i> , <b>bounding
1cd90 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d  Box</b> <i>BLOB-
1cda0 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c  Geometry</i> , <
1cdb0 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c  b>horzPixelResol
1cdc0 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75  ution</b> <i>Dou
1cdd0 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72  ble</i> , <b>ver
1cde0 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  tPixelResolution
1cdf0 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f  </b> <i>Double</
1ce00 69 3e 20 2c 20 3c 62 3e 74 69 66 66 43 6f 6d 70  i> , <b>tiffComp
1ce10 72 65 73 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53  ression</b> <i>S
1ce20 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 74  tring</i> , <b>t
1ce30 69 66 66 54 69 6c 65 53 69 7a 65 3c 2f 62 3e 20  iffTileSize</b> 
1ce40 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29  <i>Integer</i> )
1ce50 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69   : <i>Integer</i
1ce60 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c  ></td>..<td>Will
1ce70 20 61 74 74 65 6d 70 74 20 74 6f 20 65 78 70 6f   attempt to expo
1ce80 72 74 20 72 61 77 20 72 61 73 74 65 72 20 64 61  rt raw raster da
1ce90 74 61 20 66 72 6f 6d 20 61 20 43 6f 76 65 72 61  ta from a Covera
1cea0 67 65 20 69 6e 74 6f 20 61 6e 20 65 78 74 65 72  ge into an exter
1ceb0 6e 61 6c 20 20 70 6c 61 69 6e 20 54 49 46 46 20  nal  plain TIFF 
1cec0 66 69 6c 65 20 73 75 70 70 6f 72 74 65 64 20 62  file supported b
1ced0 79 20 61 6e 20 61 75 78 69 6c 69 61 72 79 20 57  y an auxiliary W
1cee0 6f 72 6c 64 46 69 6c 65 3b 20 6f 6e 6c 79 20 74  orldFile; only t
1cef0 68 65 20 54 69 6c 65 73 20 64 69 72 65 63 74 6c  he Tiles directl
1cf00 79 20 62 65 6c 6f 6e 67 69 6e 67 20 74 6f 20 74  y belonging to t
1cf10 68 65 20 73 65 6c 65 63 74 65 64 20 53 65 63 74  he selected Sect
1cf20 69 6f 6e 20 77 69 6c 6c 20 62 65 20 63 6f 6e 73  ion will be cons
1cf30 69 64 65 72 65 64 2e 3c 62 72 3e 0d 0a 57 69 6c  idered.<br>..Wil
1cf40 6c 20 72 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62  l return <b>1</b
1cf50 3e 20 28 54 52 55 45 2f 53 55 43 43 45 53 53 29  > (TRUE/SUCCESS)
1cf60 20 6f 72 20 3c 62 3e 30 3c 2f 62 3e 20 28 46 41   or <b>0</b> (FA
1cf70 4c 53 45 2f 46 41 49 4c 55 52 45 29 3a 20 6f 72  LSE/FAILURE): or
1cf80 20 3c 62 3e 2d 31 3c 2f 62 3e 20 6f 6e 20 69 6e   <b>-1</b> on in
1cf90 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73 2e  valid arguments.
1cfa0 3c 62 72 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20  <br>..<u>Please 
1cfb0 6e 6f 74 65 3c 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e  note</u>: ..<ul>
1cfc0 0d 0a 3c 6c 69 3e 54 68 65 20 3c 62 3e 3c 69 3e  ..<li>The <b><i>
1cfd0 64 62 50 72 65 66 69 78 3c 2f 69 3e 3c 2f 62 3e  dbPrefix</i></b>
1cfe0 20 61 72 67 75 6d 65 6e 74 20 69 73 20 69 6e 74   argument is int
1cff0 65 6e 64 65 64 20 74 6f 20 73 70 65 63 69 66 79  ended to specify
1d000 20 74 68 65 20 41 54 54 41 43 48 45 44 2d 44 42   the ATTACHED-DB
1d010 20 77 68 65 72 65 20 74 68 65 20 43 6f 76 65 72   where the Cover
1d020 61 67 65 20 69 73 20 65 78 70 65 63 74 65 64 20  age is expected 
1d030 74 6f 20 62 65 20 66 6f 75 6e 64 3b 20 69 74 20  to be found; it 
1d040 63 6f 75 6c 64 20 62 65 20 65 76 65 6e 74 75 61  could be eventua
1d050 6c 6c 79 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c  lly <b>NULL</b>,
1d060 20 61 6e 64 20 69 6e 20 74 68 69 73 20 63 61 73   and in this cas
1d070 65 20 74 68 65 20 3c 62 3e 4d 41 49 4e 20 44 42  e the <b>MAIN DB
1d080 3c 2f 62 3e 20 77 69 6c 6c 20 69 6d 70 6c 69 63  </b> will implic
1d090 69 74 6c 79 20 62 65 20 61 73 73 75 6d 65 64 2e  itly be assumed.
1d0a0 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c  </li>..<li>the <
1d0b0 62 3e 3c 69 3e 62 6f 75 6e 64 69 6e 67 42 6f 78  b><i>boundingBox
1d0c0 3c 2f 69 3e 3c 2f 62 3e 20 69 73 20 65 78 70 65  </i></b> is expe
1d0d0 63 74 65 64 20 74 6f 20 72 65 70 72 65 73 65 6e  cted to represen
1d0e0 74 20 74 68 65 20 6f 76 65 72 61 6c 6c 20 65 78  t the overall ex
1d0f0 74 65 6e 74 20 6f 66 20 74 68 65 20 65 78 70 6f  tent of the expo
1d100 72 74 65 64 20 54 49 46 46 3b 20 79 6f 75 20 63  rted TIFF; you c
1d110 6f 75 6c 64 20 65 76 65 6e 74 75 61 6c 6c 79 20  ould eventually 
1d120 70 61 73 73 20 61 6e 79 20 61 72 62 69 74 72 61  pass any arbitra
1d130 72 79 20 6b 69 6e 64 20 6f 66 20 47 65 6f 6d 65  ry kind of Geome
1d140 74 72 79 2c 20 61 6e 64 20 74 68 65 20 42 6f 75  try, and the Bou
1d150 6e 64 69 6e 67 20 42 6f 78 20 61 6b 61 20 4d 42  nding Box aka MB
1d160 52 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61  R will be automa
1d170 74 69 63 61 6c 6c 79 20 64 65 74 65 72 6d 69 6e  tically determin
1d180 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68  ed.</li>..<li>th
1d190 65 20 3c 62 3e 3c 69 3e 68 6f 72 7a 50 69 78 65  e <b><i>horzPixe
1d1a0 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c  lResolution</i><
1d1b0 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e 76 65  /b> and <b><i>ve
1d1c0 72 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rtPixelResolutio
1d1d0 6e 3c 2f 69 3e 3c 2f 62 3e 20 6d 75 73 74 20 65  n</i></b> must e
1d1e0 78 61 63 74 6c 79 20 6d 61 74 63 68 20 74 68 65  xactly match the
1d1f0 20 43 6f 76 65 72 61 67 65 27 73 20 62 61 73 65   Coverage's base
1d200 20 72 65 73 6f 6c 75 74 69 6f 6e 20 6f 72 20 6f   resolution or o
1d210 6e 65 20 6f 66 20 74 68 65 20 72 65 73 6f 6c 75  ne of the resolu
1d220 74 69 6f 6e 73 20 6d 61 64 65 20 61 76 61 69 6c  tions made avail
1d230 61 62 6c 65 20 62 79 20 74 68 65 20 63 6f 72 72  able by the corr
1d240 65 73 70 6f 6e 64 69 6e 67 20 50 79 72 61 6d 69  esponding Pyrami
1d250 64 20 6c 65 76 65 6c 73 2e 3c 2f 6c 69 3e 0d 0a  d levels.</li>..
1d260 3c 6c 69 3e 61 6e 64 20 74 68 65 20 42 6f 75 6e  <li>and the Boun
1d270 64 69 6e 67 42 6f 78 20 6d 75 73 74 20 65 78 61  dingBox must exa
1d280 63 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20 54  ctly match the T
1d290 49 46 46 20 3c 62 3e 3c 69 3e 77 69 64 74 68 3c  IFF <b><i>width<
1d2a0 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c  /i></b> and <b><
1d2b0 69 3e 68 65 69 67 68 74 3c 2f 69 3e 3c 2f 62 3e  i>height</i></b>
1d2c0 20 64 69 6d 65 6e 73 69 6f 6e 73 20 61 74 20 74   dimensions at t
1d2d0 68 61 74 20 72 65 73 6f 6c 75 74 69 6f 6e 2e 3c  hat resolution.<
1d2e0 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70  /li>..<li>the op
1d2f0 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20  tional argument 
1d300 3c 62 3e 3c 69 3e 74 69 66 66 43 6f 6d 70 72 65  <b><i>tiffCompre
1d310 73 73 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 63 6f  ssion</i></b> co
1d320 75 6c 64 20 62 65 20 6f 6e 65 20 6f 66 20 3c 62  uld be one of <b
1d330 3e 27 4e 4f 4e 45 27 3c 2f 62 3e 2c 20 3c 62 3e  >'NONE'</b>, <b>
1d340 27 44 45 46 4c 41 54 45 27 3c 2f 62 3e 2c 20 3c  'DEFLATE'</b>, <
1d350 62 3e 27 4c 5a 57 27 3c 2f 62 3e 2c 20 3c 62 3e  b>'LZW'</b>, <b>
1d360 27 4a 50 45 47 27 3c 2f 62 3e 2c 20 3c 62 3e 27  'JPEG'</b>, <b>'
1d370 46 41 58 33 27 3c 2f 62 3e 20 6f 72 20 3c 62 3e  FAX3'</b> or <b>
1d380 27 46 41 58 34 27 3c 2f 62 3e 3b 20 64 65 66 61  'FAX4'</b>; defa
1d390 75 6c 74 20 69 73 20 3c 62 3e 27 4e 4f 4e 45 27  ult is <b>'NONE'
1d3a0 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  </b>.</li>..<li>
1d3b0 74 68 65 20 6c 61 73 74 20 6f 70 74 69 6f 6e 61  the last optiona
1d3c0 6c 20 61 72 67 75 6d 65 6e 74 20 63 61 6e 20 62  l argument can b
1d3d0 65 20 75 73 65 64 20 73 6f 20 74 6f 20 73 70 65  e used so to spe
1d3e0 63 69 66 79 20 74 68 65 20 70 72 65 66 65 72 72  cify the preferr
1d3f0 65 64 20 54 49 46 46 20 74 69 6c 65 20 73 69 7a  ed TIFF tile siz
1d400 65 20 28 6f 6e 6c 79 20 73 71 75 61 72 65 20 74  e (only square t
1d410 69 6c 65 73 20 61 72 65 20 73 75 70 70 6f 72 74  iles are support
1d420 65 64 29 3b 20 64 65 66 61 75 6c 74 20 69 73 20  ed); default is 
1d430 3c 62 3e 32 35 36 3c 2f 62 3e 2e 3c 2f 6c 69 3e  <b>256</b>.</li>
1d440 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 74 61 62 6c 65 20  ..</ul>..<table 
1d450 77 69 64 74 68 3d 22 31 30 30 25 22 20 62 67 63  width="100%" bgc
1d460 6f 6c 6f 72 3d 22 23 66 66 64 30 38 30 22 20 63  olor="#ffd080" c
1d470 65 6c 6c 70 61 64 64 69 6e 67 3d 22 36 22 3e 3c  ellpadding="6"><
1d480 74 72 3e 3c 74 64 3e 0d 0a 3c 75 3e 50 6c 65 61  tr><td>..<u>Plea
1d490 73 65 20 6e 6f 74 65 20 76 65 72 79 20 77 65 6c  se note very wel
1d4a0 6c 3c 2f 75 3e 3a 20 74 68 69 73 20 53 51 4c 20  l</u>: this SQL 
1d4b0 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79  function is only
1d4c0 20 61 76 61 69 6c 61 62 6c 65 20 77 68 65 6e 20   available when 
1d4d0 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20  the environment 
1d4e0 76 61 72 69 61 62 6c 65 20 3c 62 3e 53 50 41 54  variable <b>SPAT
1d4f0 49 41 4c 49 54 45 5f 53 45 43 55 52 49 54 59 3d  IALITE_SECURITY=
1d500 72 65 6c 61 78 65 64 3c 2f 62 3e 20 69 73 20 73  relaxed</b> is s
1d510 65 74 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 3c 2f 74  et.</td></tr></t
1d520 61 62 6c 65 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72  able></td>..</tr
1d530 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 52 4c  >..<tr><td><b>RL
1d540 32 5f 57 72 69 74 65 53 65 63 74 69 6f 6e 54 69  2_WriteSectionTi
1d550 66 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72  ff</b> ( <b>dbPr
1d560 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  efix</b> <i>Stri
1d570 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65  ng</i> , <b>cove
1d580 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e  rageName</b> <i>
1d590 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
1d5a0 73 65 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69  sectionID</b> <i
1d5b0 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
1d5c0 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c  b>filePath</b> <
1d5d0 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
1d5e0 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49  b>width</b> <i>I
1d5f0 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
1d600 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e  height</b> <i>In
1d610 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
1d620 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c  oundingBox</b> <
1d630 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c  i>BLOB-Geometry<
1d640 2f 69 3e 20 2c 20 3c 62 3e 70 69 78 65 6c 52 65  /i> , <b>pixelRe
1d650 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e  solution</b> <i>
1d660 44 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c  Double</i> ) : <
1d670 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72  i>Integer</i><br
1d680 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72  ><br>..<b>RL2_Wr
1d690 69 74 65 53 65 63 74 69 6f 6e 54 69 66 66 3c 2f  iteSectionTiff</
1d6a0 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78  b> ( <b>dbPrefix
1d6b0 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
1d6c0 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65  i> , <b>coverage
1d6d0 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Name</b> <i>Stri
1d6e0 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74  ng</i> , <b>sect
1d6f0 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74  ionID</b> <i>Int
1d700 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69  eger</i> , <b>fi
1d710 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74  lePath</b> <i>St
1d720 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69  ring</i> , <b>wi
1d730 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  dth</b> <i>Integ
1d740 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67  er</i> , <b>heig
1d750 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ht</b> <i>Intege
1d760 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64  r</i> , <b>bound
1d770 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c  ingBox</b> <i>BL
1d780 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20  OB-Geometry</i> 
1d790 2c 20 3c 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65  , <b>horzPixelRe
1d7a0 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e  solution</b> <i>
1d7b0 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e  Double</i> , <b>
1d7c0 76 65 72 74 50 69 78 65 6c 52 65 73 6f 6c 75 74  vertPixelResolut
1d7d0 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c  ion</b> <i>Doubl
1d7e0 65 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74  e</i> ) : <i>Int
1d7f0 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e  eger</i><br><br>
1d800 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65 53 65  ..<b>RL2_WriteSe
1d810 63 74 69 6f 6e 54 69 66 66 3c 2f 62 3e 20 28 20  ctionTiff</b> ( 
1d820 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20  <b>dbPrefix</b> 
1d830 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
1d840 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
1d850 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
1d860 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 49 44  > , <b>sectionID
1d870 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
1d880 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74  /i> , <b>filePat
1d890 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  h</b> <i>String<
1d8a0 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f  /i> , <b>width</
1d8b0 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
1d8c0 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62  > , <b>height</b
1d8d0 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
1d8e0 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f   , <b>boundingBo
1d8f0 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65  x</b> <i>BLOB-Ge
1d900 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e  ometry</i> , <b>
1d910 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74  horzPixelResolut
1d920 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c  ion</b> <i>Doubl
1d930 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50  e</i> , <b>vertP
1d940 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
1d950 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e  b> <i>Double</i>
1d960 20 2c 20 3c 62 3e 74 69 66 66 43 6f 6d 70 72 65   , <b>tiffCompre
1d970 73 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53 74 72  ssion</b> <i>Str
1d980 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49  ing</i> ) : <i>I
1d990 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62  nteger</i><br><b
1d9a0 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65  r>..<b>RL2_Write
1d9b0 53 65 63 74 69 6f 6e 54 69 66 66 3c 2f 62 3e 20  SectionTiff</b> 
1d9c0 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62  ( <b>dbPrefix</b
1d9d0 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
1d9e0 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d  , <b>coverageNam
1d9f0 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  e</b> <i>String<
1da00 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e  /i> , <b>section
1da10 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ID</b> <i>Intege
1da20 72 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50  r</i> , <b>fileP
1da30 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ath</b> <i>Strin
1da40 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68  g</i> , <b>width
1da50 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
1da60 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c  /i> , <b>height<
1da70 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
1da80 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67  i> , <b>bounding
1da90 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d  Box</b> <i>BLOB-
1daa0 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c  Geometry</i> , <
1dab0 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c  b>horzPixelResol
1dac0 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75  ution</b> <i>Dou
1dad0 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72  ble</i> , <b>ver
1dae0 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  tPixelResolution
1daf0 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f  </b> <i>Double</
1db00 69 3e 20 2c 20 3c 62 3e 74 69 66 66 43 6f 6d 70  i> , <b>tiffComp
1db10 72 65 73 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53  ression</b> <i>S
1db20 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 74  tring</i> , <b>t
1db30 69 66 66 54 69 6c 65 53 69 7a 65 3c 2f 62 3e 20  iffTileSize</b> 
1db40 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29  <i>Integer</i> )
1db50 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69   : <i>Integer</i
1db60 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c  ></td>..<td>Will
1db70 20 61 74 74 65 6d 70 74 20 74 6f 20 65 78 70 6f   attempt to expo
1db80 72 74 20 72 61 77 20 72 61 73 74 65 72 20 64 61  rt raw raster da
1db90 74 61 20 66 72 6f 6d 20 61 20 43 6f 76 65 72 61  ta from a Covera
1dba0 67 65 20 69 6e 74 6f 20 61 6e 20 65 78 74 65 72  ge into an exter
1dbb0 6e 61 6c 20 20 70 6c 61 69 6e 20 54 49 46 46 20  nal  plain TIFF 
1dbc0 66 69 6c 65 3b 20 6f 6e 6c 79 20 74 68 65 20 54  file; only the T
1dbd0 69 6c 65 73 20 64 69 72 65 63 74 6c 79 20 62 65  iles directly be
1dbe0 6c 6f 6e 67 69 6e 67 20 74 6f 20 74 68 65 20 73  longing to the s
1dbf0 65 6c 65 63 74 65 64 20 53 65 63 74 69 6f 6e 20  elected Section 
1dc00 77 69 6c 6c 20 62 65 20 63 6f 6e 73 69 64 65 72  will be consider
1dc10 65 64 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72 65  ed.<br>..Will re
1dc20 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28 54  turn <b>1</b> (T
1dc30 52 55 45 2f 53 55 43 43 45 53 53 29 20 6f 72 20  RUE/SUCCESS) or 
1dc40 3c 62 3e 30 3c 2f 62 3e 20 28 46 41 4c 53 45 2f  <b>0</b> (FALSE/
1dc50 46 41 49 4c 55 52 45 29 3a 20 6f 72 20 3c 62 3e  FAILURE): or <b>
1dc60 2d 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69  -1</b> on invali
1dc70 64 20 61 72 67 75 6d 65 6e 74 73 2e 3c 62 72 3e  d arguments.<br>
1dc80 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65  ..<u>Please note
1dc90 3c 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c 6c  </u>: ..<ul>..<l
1dca0 69 3e 54 68 65 20 3c 62 3e 3c 69 3e 64 62 50 72  i>The <b><i>dbPr
1dcb0 65 66 69 78 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67  efix</i></b> arg
1dcc0 75 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e 64 65  ument is intende
1dcd0 64 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65  d to specify the
1dce0 20 41 54 54 41 43 48 45 44 2d 44 42 20 77 68 65   ATTACHED-DB whe
1dcf0 72 65 20 74 68 65 20 43 6f 76 65 72 61 67 65 20  re the Coverage 
1dd00 69 73 20 65 78 70 65 63 74 65 64 20 74 6f 20 62  is expected to b
1dd10 65 20 66 6f 75 6e 64 3b 20 69 74 20 63 6f 75 6c  e found; it coul
1dd20 64 20 62 65 20 65 76 65 6e 74 75 61 6c 6c 79 20  d be eventually 
1dd30 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64  <b>NULL</b>, and
1dd40 20 69 6e 20 74 68 69 73 20 63 61 73 65 20 74 68   in this case th
1dd50 65 20 3c 62 3e 4d 41 49 4e 20 44 42 3c 2f 62 3e  e <b>MAIN DB</b>
1dd60 20 77 69 6c 6c 20 69 6d 70 6c 69 63 69 74 6c 79   will implicitly
1dd70 20 62 65 20 61 73 73 75 6d 65 64 2e 3c 2f 6c 69   be assumed.</li
1dd80 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69  >..<li>the <b><i
1dd90 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 69 3e  >boundingBox</i>
1dda0 3c 2f 62 3e 20 69 73 20 65 78 70 65 63 74 65 64  </b> is expected
1ddb0 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20 74 68   to represent th
1ddc0 65 20 6f 76 65 72 61 6c 6c 20 65 78 74 65 6e 74  e overall extent
1ddd0 20 6f 66 20 74 68 65 20 65 78 70 6f 72 74 65 64   of the exported
1dde0 20 54 49 46 46 3b 20 79 6f 75 20 63 6f 75 6c 64   TIFF; you could
1ddf0 20 65 76 65 6e 74 75 61 6c 6c 79 20 70 61 73 73   eventually pass
1de00 20 61 6e 79 20 61 72 62 69 74 72 61 72 79 20 6b   any arbitrary k
1de10 69 6e 64 20 6f 66 20 47 65 6f 6d 65 74 72 79 2c  ind of Geometry,
1de20 20 61 6e 64 20 74 68 65 20 42 6f 75 6e 64 69 6e   and the Boundin
1de30 67 20 42 6f 78 20 61 6b 61 20 4d 42 52 20 77 69  g Box aka MBR wi
1de40 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69 63 61  ll be automatica
1de50 6c 6c 79 20 64 65 74 65 72 6d 69 6e 65 64 2e 3c  lly determined.<
1de60 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62  /li>..<li>the <b
1de70 3e 3c 69 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73  ><i>horzPixelRes
1de80 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20  olution</i></b> 
1de90 61 6e 64 20 3c 62 3e 3c 69 3e 76 65 72 74 50 69  and <b><i>vertPi
1dea0 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 69  xelResolution</i
1deb0 3e 3c 2f 62 3e 20 6d 75 73 74 20 65 78 61 63 74  ></b> must exact
1dec0 6c 79 20 6d 61 74 63 68 20 74 68 65 20 43 6f 76  ly match the Cov
1ded0 65 72 61 67 65 27 73 20 62 61 73 65 20 72 65 73  erage's base res
1dee0 6f 6c 75 74 69 6f 6e 20 6f 72 20 6f 6e 65 20 6f  olution or one o
1def0 66 20 74 68 65 20 72 65 73 6f 6c 75 74 69 6f 6e  f the resolution
1df00 73 20 6d 61 64 65 20 61 76 61 69 6c 61 62 6c 65  s made available
1df10 20 62 79 20 74 68 65 20 63 6f 72 72 65 73 70 6f   by the correspo
1df20 6e 64 69 6e 67 20 50 79 72 61 6d 69 64 20 6c 65  nding Pyramid le
1df30 76 65 6c 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  vels.</li>..<li>
1df40 61 6e 64 20 74 68 65 20 42 6f 75 6e 64 69 6e 67  and the Bounding
1df50 42 6f 78 20 6d 75 73 74 20 65 78 61 63 74 6c 79  Box must exactly
1df60 20 6d 61 74 63 68 20 74 68 65 20 54 49 46 46 20   match the TIFF 
1df70 3c 62 3e 3c 69 3e 77 69 64 74 68 3c 2f 69 3e 3c  <b><i>width</i><
1df80 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e 68 65  /b> and <b><i>he
1df90 69 67 68 74 3c 2f 69 3e 3c 2f 62 3e 20 64 69 6d  ight</i></b> dim
1dfa0 65 6e 73 69 6f 6e 73 20 61 74 20 74 68 61 74 20  ensions at that 
1dfb0 72 65 73 6f 6c 75 74 69 6f 6e 2e 3c 2f 6c 69 3e  resolution.</li>
1dfc0 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e  ..<li>the option
1dfd0 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 3c  al argument <b><
1dfe0 69 3e 74 69 66 66 43 6f 6d 70 72 65 73 73 69 6f  i>tiffCompressio
1dff0 6e 3c 2f 69 3e 3c 2f 62 3e 20 63 6f 75 6c 64 20  n</i></b> could 
1e000 62 65 20 6f 6e 65 20 6f 66 20 3c 62 3e 27 4e 4f  be one of <b>'NO
1e010 4e 45 27 3c 2f 62 3e 2c 20 3c 62 3e 27 44 45 46  NE'</b>, <b>'DEF
1e020 4c 41 54 45 27 3c 2f 62 3e 2c 20 3c 62 3e 27 4c  LATE'</b>, <b>'L
1e030 5a 57 27 3c 2f 62 3e 2c 20 3c 62 3e 27 4a 50 45  ZW'</b>, <b>'JPE
1e040 47 27 3c 2f 62 3e 2c 20 3c 62 3e 27 46 41 58 33  G'</b>, <b>'FAX3
1e050 27 3c 2f 62 3e 20 6f 72 20 3c 62 3e 27 46 41 58  '</b> or <b>'FAX
1e060 34 27 3c 2f 62 3e 3b 20 64 65 66 61 75 6c 74 20  4'</b>; default 
1e070 69 73 20 3c 62 3e 27 4e 4f 4e 45 27 3c 2f 62 3e  is <b>'NONE'</b>
1e080 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20  .</li>..<li>the 
1e090 6c 61 73 74 20 6f 70 74 69 6f 6e 61 6c 20 61 72  last optional ar
1e0a0 67 75 6d 65 6e 74 20 63 61 6e 20 62 65 20 75 73  gument can be us
1e0b0 65 64 20 73 6f 20 74 6f 20 73 70 65 63 69 66 79  ed so to specify
1e0c0 20 74 68 65 20 70 72 65 66 65 72 72 65 64 20 54   the preferred T
1e0d0 49 46 46 20 74 69 6c 65 20 73 69 7a 65 20 28 6f  IFF tile size (o
1e0e0 6e 6c 79 20 73 71 75 61 72 65 20 74 69 6c 65 73  nly square tiles
1e0f0 20 61 72 65 20 73 75 70 70 6f 72 74 65 64 29 3b   are supported);
1e100 20 64 65 66 61 75 6c 74 20 69 73 20 3c 62 3e 32   default is <b>2
1e110 35 36 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 2f  56</b>.</li>..</
1e120 75 6c 3e 0d 0a 3c 74 61 62 6c 65 20 77 69 64 74  ul>..<table widt
1e130 68 3d 22 31 30 30 25 22 20 62 67 63 6f 6c 6f 72  h="100%" bgcolor
1e140 3d 22 23 66 66 64 30 38 30 22 20 63 65 6c 6c 70  ="#ffd080" cellp
1e150 61 64 64 69 6e 67 3d 22 36 22 3e 3c 74 72 3e 3c  adding="6"><tr><
1e160 74 64 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e  td>..<u>Please n
1e170 6f 74 65 20 76 65 72 79 20 77 65 6c 6c 3c 2f 75  ote very well</u
1e180 3e 3a 20 74 68 69 73 20 53 51 4c 20 66 75 6e 63  >: this SQL func
1e190 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 61 76 61  tion is only ava
1e1a0 69 6c 61 62 6c 65 20 77 68 65 6e 20 74 68 65 20  ilable when the 
1e1b0 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69  environment vari
1e1c0 61 62 6c 65 20 3c 62 3e 53 50 41 54 49 41 4c 49  able <b>SPATIALI
1e1d0 54 45 5f 53 45 43 55 52 49 54 59 3d 72 65 6c 61  TE_SECURITY=rela
1e1e0 78 65 64 3c 2f 62 3e 20 69 73 20 73 65 74 2e 3c  xed</b> is set.<
1e1f0 2f 74 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c 65  /td></tr></table
1e200 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c  ></td>..</tr>..<
1e210 74 72 3e 3c 74 64 3e 3c 62 3e 52 4c 32 5f 57 72  tr><td><b>RL2_Wr
1e220 69 74 65 53 65 63 74 69 6f 6e 54 72 69 70 6c 65  iteSectionTriple
1e230 42 61 6e 64 47 65 6f 54 69 66 66 3c 2f 62 3e 20  BandGeoTiff</b> 
1e240 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62  ( <b>dbPrefix</b
1e250 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
1e260 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d  , <b>coverageNam
1e270 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  e</b> <i>String<
1e280 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e  /i> , <b>section
1e290 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ID</b> <i>Intege
1e2a0 72 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50  r</i> , <b>fileP
1e2b0 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ath</b> <i>Strin
1e2c0 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68  g</i> , <b>width
1e2d0 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
1e2e0 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c  /i> , <b>height<
1e2f0 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
1e300 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65  i> , <b>bandInde
1e310 78 52 65 64 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  xRed</b> <i>Inte
1e320 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e  ger</i> , <b>ban
1e330 64 49 6e 64 65 78 47 72 65 65 6e 3c 2f 62 3e 20  dIndexGreen</b> 
1e340 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
1e350 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 42 6c 75   <b>bandIndexBlu
1e360 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  e</b> <i>Integer
1e370 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69  </i> , <b>boundi
1e380 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f  ngBox</b> <i>BLO
1e390 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c  B-Geometry</i> ,
1e3a0 20 3c 62 3e 70 69 78 65 6c 52 65 73 6f 6c 75 74   <b>pixelResolut
1e3b0 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c  ion</b> <i>Doubl
1e3c0 65 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74  e</i> ) : <i>Int
1e3d0 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e  eger</i><br><br>
1e3e0 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65 53 65  ..<b>RL2_WriteSe
1e3f0 63 74 69 6f 6e 54 72 69 70 6c 65 42 61 6e 64 47  ctionTripleBandG
1e400 65 6f 54 69 66 66 3c 2f 62 3e 20 28 20 3c 62 3e  eoTiff</b> ( <b>
1e410 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e  dbPrefix</b> <i>
1e420 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
1e430 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e  coverageName</b>
1e440 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
1e450 20 3c 62 3e 73 65 63 74 69 6f 6e 49 44 3c 2f 62   <b>sectionID</b
1e460 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
1e470 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f   , <b>filePath</
1e480 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
1e490 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20   , <b>width</b> 
1e4a0 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
1e4b0 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c   <b>height</b> <
1e4c0 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
1e4d0 3c 62 3e 62 61 6e 64 49 6e 64 65 78 52 65 64 3c  <b>bandIndexRed<
1e4e0 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
1e4f0 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65  i> , <b>bandInde
1e500 78 47 72 65 65 6e 3c 2f 62 3e 20 3c 69 3e 49 6e  xGreen</b> <i>In
1e510 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
1e520 61 6e 64 49 6e 64 65 78 42 6c 75 65 3c 2f 62 3e  andIndexBlue</b>
1e530 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
1e540 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f   , <b>boundingBo
1e550 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65  x</b> <i>BLOB-Ge
1e560 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e  ometry</i> , <b>
1e570 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74  horzPixelResolut
1e580 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c  ion</b> <i>Doubl
1e590 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50  e</i> , <b>vertP
1e5a0 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
1e5b0 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e  b> <i>Double</i>
1e5c0 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c   ) : <i>Integer<
1e5d0 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e  /i><br><br>..<b>
1e5e0 52 4c 32 5f 57 72 69 74 65 53 65 63 74 69 6f 6e  RL2_WriteSection
1e5f0 54 72 69 70 6c 65 42 61 6e 64 47 65 6f 54 69 66  TripleBandGeoTif
1e600 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65  f</b> ( <b>dbPre
1e610 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  fix</b> <i>Strin
1e620 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72  g</i> , <b>cover
1e630 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  ageName</b> <i>S
1e640 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73  tring</i> , <b>s
1e650 65 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e  ectionID</b> <i>
1e660 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
1e670 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69  >filePath</b> <i
1e680 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
1e690 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
1e6a0 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
1e6b0 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
1e6c0 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61  eger</i> , <b>ba
1e6d0 6e 64 49 6e 64 65 78 52 65 64 3c 2f 62 3e 20 3c  ndIndexRed</b> <
1e6e0 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
1e6f0 3c 62 3e 62 61 6e 64 49 6e 64 65 78 47 72 65 65  <b>bandIndexGree
1e700 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  n</b> <i>Integer
1e710 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e  </i> , <b>bandIn
1e720 64 65 78 42 6c 75 65 3c 2f 62 3e 20 3c 69 3e 49  dexBlue</b> <i>I
1e730 6e 74 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62  nteger</i>  , <b
1e740 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e  >boundingBox</b>
1e750 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72   <i>BLOB-Geometr
1e760 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50  y</i> , <b>horzP
1e770 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
1e780 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e  b> <i>Double</i>
1e790 20 2c 20 3c 62 3e 76 65 72 74 50 69 78 65 6c 52   , <b>vertPixelR
1e7a0 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69  esolution</b> <i
1e7b0 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62  >Double</i> , <b
1e7c0 3e 77 69 74 68 57 6f 6c 64 46 69 6c 65 3c 2f 62  >withWoldFile</b
1e7d0 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
1e7e0 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c   ) : <i>Integer<
1e7f0 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e  /i><br><br>..<b>
1e800 52 4c 32 5f 57 72 69 74 65 53 65 63 74 69 6f 6e  RL2_WriteSection
1e810 54 72 69 70 6c 65 42 61 6e 64 47 65 6f 54 69 66  TripleBandGeoTif
1e820 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65  f</b> ( <b>dbPre
1e830 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  fix</b> <i>Strin
1e840 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72  g</i> , <b>cover
1e850 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  ageName</b> <i>S
1e860 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73  tring</i> , <b>s
1e870 65 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e  ectionID</b> <i>
1e880 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
1e890 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69  >filePath</b> <i
1e8a0 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
1e8b0 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
1e8c0 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
1e8d0 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
1e8e0 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61  eger</i> , <b>ba
1e8f0 6e 64 49 6e 64 65 78 52 65 64 3c 2f 62 3e 20 3c  ndIndexRed</b> <
1e900 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
1e910 3c 62 3e 62 61 6e 64 49 6e 64 65 78 47 72 65 65  <b>bandIndexGree
1e920 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  n</b> <i>Integer
1e930 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e  </i> , <b>bandIn
1e940 64 65 78 42 6c 75 65 3c 2f 62 3e 20 3c 69 3e 49  dexBlue</b> <i>I
1e950 6e 74 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62  nteger</i>  , <b
1e960 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e  >boundingBox</b>
1e970 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72   <i>BLOB-Geometr
1e980 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50  y</i> , <b>horzP
1e990 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
1e9a0 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e  b> <i>Double</i>
1e9b0 20 2c 20 3c 62 3e 76 65 72 74 50 69 78 65 6c 52   , <b>vertPixelR
1e9c0 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69  esolution</b> <i
1e9d0 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62  >Double</i> , <b
1e9e0 3e 77 69 74 68 57 6f 6c 64 46 69 6c 65 3c 2f 62  >withWoldFile</b
1e9f0 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
1ea00 20 2c 20 3c 62 3e 74 69 66 66 43 6f 6d 70 72 65   , <b>tiffCompre
1ea10 73 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53 74 72  ssion</b> <i>Str
1ea20 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49  ing</i> ) : <i>I
1ea30 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62  nteger</i><br><b
1ea40 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65  r>..<b>RL2_Write
1ea50 53 65 63 74 69 6f 6e 54 72 69 70 6c 65 42 61 6e  SectionTripleBan
1ea60 64 47 65 6f 54 69 66 66 3c 2f 62 3e 20 28 20 3c  dGeoTiff</b> ( <
1ea70 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c  b>dbPrefix</b> <
1ea80 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
1ea90 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f  b>coverageName</
1eaa0 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
1eab0 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 49 44 3c   , <b>sectionID<
1eac0 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
1ead0 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68  i> , <b>filePath
1eae0 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
1eaf0 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62  i> , <b>width</b
1eb00 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
1eb10 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e   , <b>height</b>
1eb20 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
1eb30 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 52 65  , <b>bandIndexRe
1eb40 64 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  d</b> <i>Integer
1eb50 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e  </i> , <b>bandIn
1eb60 64 65 78 47 72 65 65 6e 3c 2f 62 3e 20 3c 69 3e  dexGreen</b> <i>
1eb70 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
1eb80 3e 62 61 6e 64 49 6e 64 65 78 42 6c 75 65 3c 2f  >bandIndexBlue</
1eb90 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
1eba0 3e 20 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67  >  , <b>bounding
1ebb0 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d  Box</b> <i>BLOB-
1ebc0 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c  Geometry</i> , <
1ebd0 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c  b>horzPixelResol
1ebe0 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75  ution</b> <i>Dou
1ebf0 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72  ble</i> , <b>ver
1ec00 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  tPixelResolution
1ec10 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f  </b> <i>Double</
1ec20 69 3e 20 2c 20 3c 62 3e 77 69 74 68 57 6f 6c 64  i> , <b>withWold
1ec30 46 69 6c 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  File</b> <i>Inte
1ec40 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 66  ger</i> , <b>tif
1ec50 66 43 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 62 3e  fCompression</b>
1ec60 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
1ec70 20 3c 62 3e 74 69 66 66 54 69 6c 65 53 69 7a 65   <b>tiffTileSize
1ec80 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
1ec90 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67  /i> ) : <i>Integ
1eca0 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  er</i></td>..<td
1ecb0 3e 57 69 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f  >Will attempt to
1ecc0 20 65 78 70 6f 72 74 20 72 61 77 20 72 61 73 74   export raw rast
1ecd0 65 72 20 64 61 74 61 20 66 72 6f 6d 20 61 20 4d  er data from a M
1ece0 55 4c 54 49 42 41 4e 44 20 6f 72 20 52 47 42 20  ULTIBAND or RGB 
1ecf0 43 6f 76 65 72 61 67 65 20 69 6e 74 6f 20 61 6e  Coverage into an
1ed00 20 65 78 74 65 72 6e 61 6c 20 47 65 6f 54 49 46   external GeoTIF
1ed10 46 20 66 69 6c 65 20 6f 66 20 74 68 65 20 52 47  F file of the RG
1ed20 42 20 74 79 70 65 3b 20 6f 6e 6c 79 20 74 68 65  B type; only the
1ed30 20 54 69 6c 65 73 20 64 69 72 65 63 74 6c 79 20   Tiles directly 
1ed40 62 65 6c 6f 6e 67 69 6e 67 20 74 6f 20 74 68 65  belonging to the
1ed50 20 73 65 6c 65 63 74 65 64 20 53 65 63 74 69 6f   selected Sectio
1ed60 6e 20 77 69 6c 6c 20 62 65 20 63 6f 6e 73 69 64  n will be consid
1ed70 65 72 65 64 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20  ered.<br>..Will 
1ed80 72 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20  return <b>1</b> 
1ed90 28 54 52 55 45 2f 53 55 43 43 45 53 53 29 20 6f  (TRUE/SUCCESS) o
1eda0 72 20 3c 62 3e 30 3c 2f 62 3e 20 28 46 41 4c 53  r <b>0</b> (FALS
1edb0 45 2f 46 41 49 4c 55 52 45 29 3a 20 6f 72 20 3c  E/FAILURE): or <
1edc0 62 3e 2d 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61  b>-1</b> on inva
1edd0 6c 69 64 20 61 72 67 75 6d 65 6e 74 73 2e 3c 62  lid arguments.<b
1ede0 72 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f  r>..<u>Please no
1edf0 74 65 3c 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a  te</u>: ..<ul>..
1ee00 3c 6c 69 3e 54 68 65 20 3c 62 3e 3c 69 3e 64 62  <li>The <b><i>db
1ee10 50 72 65 66 69 78 3c 2f 69 3e 3c 2f 62 3e 20 61  Prefix</i></b> a
1ee20 72 67 75 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e  rgument is inten
1ee30 64 65 64 20 74 6f 20 73 70 65 63 69 66 79 20 74  ded to specify t
1ee40 68 65 20 41 54 54 41 43 48 45 44 2d 44 42 20 77  he ATTACHED-DB w
1ee50 68 65 72 65 20 74 68 65 20 43 6f 76 65 72 61 67  here the Coverag
1ee60 65 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f  e is expected to
1ee70 20 62 65 20 66 6f 75 6e 64 3b 20 69 74 20 63 6f   be found; it co
1ee80 75 6c 64 20 62 65 20 65 76 65 6e 74 75 61 6c 6c  uld be eventuall
1ee90 79 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61  y <b>NULL</b>, a
1eea0 6e 64 20 69 6e 20 74 68 69 73 20 63 61 73 65 20  nd in this case 
1eeb0 74 68 65 20 3c 62 3e 4d 41 49 4e 20 44 42 3c 2f  the <b>MAIN DB</
1eec0 62 3e 20 77 69 6c 6c 20 69 6d 70 6c 69 63 69 74  b> will implicit
1eed0 6c 79 20 62 65 20 61 73 73 75 6d 65 64 2e 3c 2f  ly be assumed.</
1eee0 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e  li>..<li>the <b>
1eef0 3c 69 3e 62 61 6e 64 49 6e 64 65 78 52 65 64 3c  <i>bandIndexRed<
1ef00 2f 62 3e 3c 2f 69 3e 2c 20 3c 62 3e 3c 69 3e 62  /b></i>, <b><i>b
1ef10 61 6e 64 49 6e 64 65 78 47 72 65 65 6e 3c 2f 69  andIndexGreen</i
1ef20 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e  ></b> and <b><i>
1ef30 62 61 6e 64 49 6e 64 65 78 42 6c 75 65 3c 2f 69  bandIndexBlue</i
1ef40 3e 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 73 20  ></b> arguments 
1ef50 61 72 65 20 69 6e 74 65 6e 64 65 64 20 74 6f 20  are intended to 
1ef60 61 72 62 69 74 72 61 72 69 6c 79 20 63 6f 6d 70  arbitrarily comp
1ef70 6f 73 65 20 74 68 65 20 52 47 42 20 54 49 46 46  ose the RGB TIFF
1ef80 20 73 74 61 72 74 69 6e 67 20 66 72 6f 6d 20 74   starting from t
1ef90 68 65 20 42 61 6e 64 73 20 73 75 70 70 6f 72 74  he Bands support
1efa0 65 64 20 62 79 20 74 68 65 20 43 6f 76 65 72 61  ed by the Covera
1efb0 67 65 2e 0d 0a 3c 62 72 3e 3c 75 3e 50 6c 65 61  ge...<br><u>Plea
1efc0 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 74 68 65  se note</u>: the
1efd0 20 66 69 72 73 74 20 42 61 6e 64 20 61 6c 77 61   first Band alwa
1efe0 79 73 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74  ys corresponds t
1eff0 6f 20 69 6e 64 65 78 20 3c 62 3e 5a 45 52 4f 3c  o index <b>ZERO<
1f000 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68  /b></li>..<li>th
1f010 65 20 3c 62 3e 3c 69 3e 62 6f 75 6e 64 69 6e 67  e <b><i>bounding
1f020 42 6f 78 3c 2f 69 3e 3c 2f 62 3e 20 69 73 20 65  Box</i></b> is e
1f030 78 70 65 63 74 65 64 20 74 6f 20 72 65 70 72 65  xpected to repre
1f040 73 65 6e 74 20 74 68 65 20 6f 76 65 72 61 6c 6c  sent the overall
1f050 20 65 78 74 65 6e 74 20 6f 66 20 74 68 65 20 65   extent of the e
1f060 78 70 6f 72 74 65 64 20 47 65 6f 54 49 46 46 3b  xported GeoTIFF;
1f070 20 79 6f 75 20 63 6f 75 6c 64 20 65 76 65 6e 74   you could event
1f080 75 61 6c 6c 79 20 70 61 73 73 20 61 6e 79 20 61  ually pass any a
1f090 72 62 69 74 72 61 72 79 20 6b 69 6e 64 20 6f 66  rbitrary kind of
1f0a0 20 47 65 6f 6d 65 74 72 79 2c 20 61 6e 64 20 74   Geometry, and t
1f0b0 68 65 20 42 6f 75 6e 64 69 6e 67 20 42 6f 78 20  he Bounding Box 
1f0c0 61 6b 61 20 4d 42 52 20 77 69 6c 6c 20 62 65 20  aka MBR will be 
1f0d0 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65  automatically de
1f0e0 74 65 72 6d 69 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a  termined.</li>..
1f0f0 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 68 6f  <li>the <b><i>ho
1f100 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rzPixelResolutio
1f110 6e 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62  n</i></b> and <b
1f120 3e 3c 69 3e 76 65 72 74 50 69 78 65 6c 52 65 73  ><i>vertPixelRes
1f130 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20  olution</i></b> 
1f140 6d 75 73 74 20 65 78 61 63 74 6c 79 20 6d 61 74  must exactly mat
1f150 63 68 20 74 68 65 20 43 6f 76 65 72 61 67 65 27  ch the Coverage'
1f160 73 20 62 61 73 65 20 72 65 73 6f 6c 75 74 69 6f  s base resolutio
1f170 6e 20 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65 20  n or one of the 
1f180 72 65 73 6f 6c 75 74 69 6f 6e 73 20 6d 61 64 65  resolutions made
1f190 20 61 76 61 69 6c 61 62 6c 65 20 62 79 20 74 68   available by th
1f1a0 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20  e corresponding 
1f1b0 50 79 72 61 6d 69 64 20 6c 65 76 65 6c 73 2e 3c  Pyramid levels.<
1f1c0 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 6e 64 20 74 68  /li>..<li>and th
1f1d0 65 20 42 6f 75 6e 64 69 6e 67 42 6f 78 20 6d 75  e BoundingBox mu
1f1e0 73 74 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68  st exactly match
1f1f0 20 74 68 65 20 54 49 46 46 20 3c 62 3e 3c 69 3e   the TIFF <b><i>
1f200 77 69 64 74 68 3c 2f 69 3e 3c 2f 62 3e 20 61 6e  width</i></b> an
1f210 64 20 3c 62 3e 3c 69 3e 68 65 69 67 68 74 3c 2f  d <b><i>height</
1f220 69 3e 3c 2f 62 3e 20 64 69 6d 65 6e 73 69 6f 6e  i></b> dimension
1f230 73 20 61 74 20 74 68 61 74 20 72 65 73 6f 6c 75  s at that resolu
1f240 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  tion.</li>..<li>
1f250 69 66 20 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20  if the optional 
1f260 61 72 67 75 6d 65 6e 74 20 3c 62 3e 3c 69 3e 77  argument <b><i>w
1f270 69 74 68 57 6f 72 6c 64 46 69 6c 65 3c 2f 69 3e  ithWorldFile</i>
1f280 3c 2f 62 3e 20 69 73 20 73 65 74 20 74 6f 20 54  </b> is set to T
1f290 52 55 45 20 74 68 65 6e 20 61 6e 20 61 75 78 69  RUE then an auxi
1f2a0 6c 69 61 72 79 20 57 6f 72 6c 64 46 69 6c 65 20  liary WorldFile 
1f2b0 77 69 6c 6c 20 62 65 20 65 78 70 6f 72 74 65 64  will be exported
1f2c0 20 61 73 20 77 65 6c 6c 2e 3c 2f 6c 69 3e 0d 0a   as well.</li>..
1f2d0 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c  <li>the optional
1f2e0 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 3c 69 3e   argument <b><i>
1f2f0 74 69 66 66 43 6f 6d 70 72 65 73 73 69 6f 6e 3c  tiffCompression<
1f300 2f 69 3e 3c 2f 62 3e 20 63 6f 75 6c 64 20 62 65  /i></b> could be
1f310 20 6f 6e 65 20 6f 66 20 3c 62 3e 27 4e 4f 4e 45   one of <b>'NONE
1f320 27 3c 2f 62 3e 2c 20 3c 62 3e 27 44 45 46 4c 41  '</b>, <b>'DEFLA
1f330 54 45 27 3c 2f 62 3e 2c 20 3c 62 3e 27 4c 5a 57  TE'</b>, <b>'LZW
1f340 27 3c 2f 62 3e 2c 20 3c 62 3e 27 4a 50 45 47 27  '</b>, <b>'JPEG'
1f350 3c 2f 62 3e 2c 20 3c 62 3e 27 46 41 58 33 27 3c  </b>, <b>'FAX3'<
1f360 2f 62 3e 20 6f 72 20 3c 62 3e 27 46 41 58 34 27  /b> or <b>'FAX4'
1f370 3c 2f 62 3e 3b 20 64 65 66 61 75 6c 74 20 69 73  </b>; default is
1f380 20 3c 62 3e 27 4e 4f 4e 45 27 3c 2f 62 3e 2e 3c   <b>'NONE'</b>.<
1f390 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6c 61  /li>..<li>the la
1f3a0 73 74 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75  st optional argu
1f3b0 6d 65 6e 74 20 63 61 6e 20 62 65 20 75 73 65 64  ment can be used
1f3c0 20 73 6f 20 74 6f 20 73 70 65 63 69 66 79 20 74   so to specify t
1f3d0 68 65 20 70 72 65 66 65 72 72 65 64 20 54 49 46  he preferred TIF
1f3e0 46 20 74 69 6c 65 20 73 69 7a 65 20 28 6f 6e 6c  F tile size (onl
1f3f0 79 20 73 71 75 61 72 65 20 74 69 6c 65 73 20 61  y square tiles a
1f400 72 65 20 73 75 70 70 6f 72 74 65 64 29 3b 20 64  re supported); d
1f410 65 66 61 75 6c 74 20 69 73 20 3c 62 3e 32 35 36  efault is <b>256
1f420 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c  </b>.</li>..</ul
1f430 3e 0d 0a 3c 74 61 62 6c 65 20 77 69 64 74 68 3d  >..<table width=
1f440 22 31 30 30 25 22 20 62 67 63 6f 6c 6f 72 3d 22  "100%" bgcolor="
1f450 23 66 66 64 30 38 30 22 20 63 65 6c 6c 70 61 64  #ffd080" cellpad
1f460 64 69 6e 67 3d 22 36 22 3e 3c 74 72 3e 3c 74 64  ding="6"><tr><td
1f470 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74  >..<u>Please not
1f480 65 20 76 65 72 79 20 77 65 6c 6c 3c 2f 75 3e 3a  e very well</u>:
1f490 20 74 68 69 73 20 53 51 4c 20 66 75 6e 63 74 69   this SQL functi
1f4a0 6f 6e 20 69 73 20 6f 6e 6c 79 20 61 76 61 69 6c  on is only avail
1f4b0 61 62 6c 65 20 77 68 65 6e 20 74 68 65 20 65 6e  able when the en
1f4c0 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62  vironment variab
1f4d0 6c 65 20 3c 62 3e 53 50 41 54 49 41 4c 49 54 45  le <b>SPATIALITE
1f4e0 5f 53 45 43 55 52 49 54 59 3d 72 65 6c 61 78 65  _SECURITY=relaxe
1f4f0 64 3c 2f 62 3e 20 69 73 20 73 65 74 2e 3c 2f 74  d</b> is set.</t
1f500 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e 3c  d></tr></table><
1f510 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72  /td>..</tr>..<tr
1f520 3e 3c 74 64 3e 3c 62 3e 52 4c 32 5f 57 72 69 74  ><td><b>RL2_Writ
1f530 65 53 65 63 74 69 6f 6e 54 72 69 70 6c 65 42 61  eSectionTripleBa
1f540 6e 64 54 69 66 66 54 46 57 3c 2f 62 3e 20 28 20  ndTiffTFW</b> ( 
1f550 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20  <b>dbPrefix</b> 
1f560 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
1f570 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
1f580 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
1f590 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 49 44  > , <b>sectionID
1f5a0 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
1f5b0 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74  /i> , <b>filePat
1f5c0 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  h</b> <i>String<
1f5d0 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f  /i> , <b>width</
1f5e0 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
1f5f0 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62  > , <b>height</b
1f600 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
1f610 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 52   , <b>bandIndexR
1f620 65 64 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ed</b> <i>Intege
1f630 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49  r</i> , <b>bandI
1f640 6e 64 65 78 47 72 65 65 6e 3c 2f 62 3e 20 3c 69  ndexGreen</b> <i
1f650 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
1f660 62 3e 62 61 6e 64 49 6e 64 65 78 42 6c 75 65 3c  b>bandIndexBlue<
1f670 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
1f680 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67  i> , <b>bounding
1f690 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d  Box</b> <i>BLOB-
1f6a0 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c  Geometry</i> , <
1f6b0 62 3e 70 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  b>pixelResolutio
1f6c0 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c  n</b> <i>Double<
1f6d0 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67  /i> ) : <i>Integ
1f6e0 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a  er</i><br><br>..
1f6f0 3c 62 3e 52 4c 32 5f 57 72 69 74 65 53 65 63 74  <b>RL2_WriteSect
1f700 69 6f 6e 54 72 69 70 6c 65 42 61 6e 64 54 69 66  ionTripleBandTif
1f710 66 54 46 57 3c 2f 62 3e 20 28 20 3c 62 3e 64 62  fTFW</b> ( <b>db
1f720 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74  Prefix</b> <i>St
1f730 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f  ring</i> , <b>co
1f740 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c  verageName</b> <
1f750 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
1f760 62 3e 73 65 63 74 69 6f 6e 49 44 3c 2f 62 3e 20  b>sectionID</b> 
1f770 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
1f780 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e   <b>filePath</b>
1f790 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
1f7a0 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69   <b>width</b> <i
1f7b0 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
1f7c0 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e  b>height</b> <i>
1f7d0 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
1f7e0 3e 62 61 6e 64 49 6e 64 65 78 52 65 64 3c 2f 62  >bandIndexRed</b
1f7f0 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
1f800 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 47   , <b>bandIndexG
1f810 72 65 65 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  reen</b> <i>Inte
1f820 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e  ger</i> , <b>ban
1f830 64 49 6e 64 65 78 42 6c 75 65 3c 2f 62 3e 20 3c  dIndexBlue</b> <
1f840 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 20 2c  i>Integer</i>  ,
1f850 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c   <b>boundingBox<
1f860 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d  /b> <i>BLOB-Geom
1f870 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f  etry</i> , <b>ho
1f880 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rzPixelResolutio
1f890 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c  n</b> <i>Double<
1f8a0 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69 78  /i> , <b>vertPix
1f8b0 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e  elResolution</b>
1f8c0 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 29   <i>Double</i> )
1f8d0 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69   : <i>Integer</i
1f8e0 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c  ><br><br>..<b>RL
1f8f0 32 5f 57 72 69 74 65 53 65 63 74 69 6f 6e 54 72  2_WriteSectionTr
1f900 69 70 6c 65 42 61 6e 64 54 69 66 66 54 46 57 3c  ipleBandTiffTFW<
1f910 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69  /b> ( <b>dbPrefi
1f920 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  x</b> <i>String<
1f930 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67  /i> , <b>coverag
1f940 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  eName</b> <i>Str
1f950 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65 63  ing</i> , <b>sec
1f960 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e  tionID</b> <i>In
1f970 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 66  teger</i> , <b>f
1f980 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53  ilePath</b> <i>S
1f990 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77  tring</i> , <b>w
1f9a0 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  idth</b> <i>Inte
1f9b0 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69  ger</i> , <b>hei
1f9c0 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  ght</b> <i>Integ
1f9d0 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64  er</i> , <b>band
1f9e0 49 6e 64 65 78 52 65 64 3c 2f 62 3e 20 3c 69 3e  IndexRed</b> <i>
1f9f0 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
1fa00 3e 62 61 6e 64 49 6e 64 65 78 47 72 65 65 6e 3c  >bandIndexGreen<
1fa10 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
1fa20 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65  i> , <b>bandInde
1fa30 78 42 6c 75 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74  xBlue</b> <i>Int
1fa40 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62 3e 62  eger</i>  , <b>b
1fa50 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c  oundingBox</b> <
1fa60 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c  i>BLOB-Geometry<
1fa70 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50 69 78  /i> , <b>horzPix
1fa80 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e  elResolution</b>
1fa90 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c   <i>Double</i> ,
1faa0 20 3c 62 3e 76 65 72 74 50 69 78 65 6c 52 65 73   <b>vertPixelRes
1fab0 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44  olution</b> <i>D
1fac0 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 74  ouble</i> , <b>t
1fad0 69 66 66 43 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f  iffCompression</
1fae0 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
1faf0 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c   ) : <i>Integer<
1fb00 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e  /i><br><br>..<b>
1fb10 52 4c 32 5f 57 72 69 74 65 53 65 63 74 69 6f 6e  RL2_WriteSection
1fb20 54 72 69 70 6c 65 42 61 6e 64 54 69 66 66 54 46  TripleBandTiffTF
1fb30 57 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65  W</b> ( <b>dbPre
1fb40 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  fix</b> <i>Strin
1fb50 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72  g</i> , <b>cover
1fb60 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  ageName</b> <i>S
1fb70 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73  tring</i> , <b>s
1fb80 65 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e  ectionID</b> <i>
1fb90 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
1fba0 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69  >filePath</b> <i
1fbb0 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
1fbc0 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
1fbd0 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
1fbe0 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
1fbf0 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61  eger</i> , <b>ba
1fc00 6e 64 49 6e 64 65 78 52 65 64 3c 2f 62 3e 20 3c  ndIndexRed</b> <
1fc10 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
1fc20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 47 72 65 65  <b>bandIndexGree
1fc30 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  n</b> <i>Integer
1fc40 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e  </i> , <b>bandIn
1fc50 64 65 78 42 6c 75 65 3c 2f 62 3e 20 3c 69 3e 49  dexBlue</b> <i>I
1fc60 6e 74 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62  nteger</i>  , <b
1fc70 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e  >boundingBox</b>
1fc80 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72   <i>BLOB-Geometr
1fc90 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50  y</i> , <b>horzP
1fca0 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
1fcb0 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e  b> <i>Double</i>
1fcc0 20 2c 20 3c 62 3e 76 65 72 74 50 69 78 65 6c 52   , <b>vertPixelR
1fcd0 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69  esolution</b> <i
1fce0 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62  >Double</i> , <b
1fcf0 3e 74 69 66 66 43 6f 6d 70 72 65 73 73 69 6f 6e  >tiffCompression
1fd00 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
1fd10 69 3e 20 2c 20 3c 62 3e 74 69 66 66 54 69 6c 65  i> , <b>tiffTile
1fd20 53 69 7a 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  Size</b> <i>Inte
1fd30 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49  ger</i> ) : <i>I
1fd40 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d  nteger</i></td>.
1fd50 0a 3c 74 64 3e 57 69 6c 6c 20 61 74 74 65 6d 70  .<td>Will attemp
1fd60 74 20 74 6f 20 65 78 70 6f 72 74 20 72 61 77 20  t to export raw 
1fd70 72 61 73 74 65 72 20 64 61 74 61 20 66 72 6f 6d  raster data from
1fd80 20 61 20 4d 55 4c 54 49 42 41 4e 44 20 6f 72 20   a MULTIBAND or 
1fd90 52 47 42 20 43 6f 76 65 72 61 67 65 20 69 6e 74  RGB Coverage int
1fda0 6f 20 61 6e 20 65 78 74 65 72 6e 61 6c 20 70 6c  o an external pl
1fdb0 61 69 6e 20 54 49 46 46 20 66 69 6c 65 20 6f 66  ain TIFF file of
1fdc0 20 74 68 65 20 52 47 42 20 74 79 70 65 20 73 75   the RGB type su
1fdd0 70 70 6f 72 74 65 64 20 62 79 20 61 6e 20 61 75  pported by an au
1fde0 78 69 6c 69 61 72 79 20 57 6f 72 6c 64 46 69 6c  xiliary WorldFil
1fdf0 65 3b 20 6f 6e 6c 79 20 74 68 65 20 54 69 6c 65  e; only the Tile
1fe00 73 20 64 69 72 65 63 74 6c 79 20 62 65 6c 6f 6e  s directly belon
1fe10 67 69 6e 67 20 74 6f 20 74 68 65 20 73 65 6c 65  ging to the sele
1fe20 63 74 65 64 20 53 65 63 74 69 6f 6e 20 77 69 6c  cted Section wil
1fe30 6c 20 62 65 20 63 6f 6e 73 69 64 65 72 65 64 2e  l be considered.
1fe40 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72 65 74 75 72  <br>..Will retur
1fe50 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28 54 52 55 45  n <b>1</b> (TRUE
1fe60 2f 53 55 43 43 45 53 53 29 20 6f 72 20 3c 62 3e  /SUCCESS) or <b>
1fe70 30 3c 2f 62 3e 20 28 46 41 4c 53 45 2f 46 41 49  0</b> (FALSE/FAI
1fe80 4c 55 52 45 29 3a 20 6f 72 20 3c 62 3e 2d 31 3c  LURE): or <b>-1<
1fe90 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69 64 20 61  /b> on invalid a
1fea0 72 67 75 6d 65 6e 74 73 2e 3c 62 72 3e 0d 0a 3c  rguments.<br>..<
1feb0 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75  u>Please note</u
1fec0 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54  >: ..<ul>..<li>T
1fed0 68 65 20 3c 62 3e 3c 69 3e 64 62 50 72 65 66 69  he <b><i>dbPrefi
1fee0 78 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67 75 6d 65  x</i></b> argume
1fef0 6e 74 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74  nt is intended t
1ff00 6f 20 73 70 65 63 69 66 79 20 74 68 65 20 41 54  o specify the AT
1ff10 54 41 43 48 45 44 2d 44 42 20 77 68 65 72 65 20  TACHED-DB where 
1ff20 74 68 65 20 43 6f 76 65 72 61 67 65 20 69 73 20  the Coverage is 
1ff30 65 78 70 65 63 74 65 64 20 74 6f 20 62 65 20 66  expected to be f
1ff40 6f 75 6e 64 3b 20 69 74 20 63 6f 75 6c 64 20 62  ound; it could b
1ff50 65 20 65 76 65 6e 74 75 61 6c 6c 79 20 3c 62 3e  e eventually <b>
1ff60 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69 6e  NULL</b>, and in
1ff70 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 3c   this case the <
1ff80 62 3e 4d 41 49 4e 20 44 42 3c 2f 62 3e 20 77 69  b>MAIN DB</b> wi
1ff90 6c 6c 20 69 6d 70 6c 69 63 69 74 6c 79 20 62 65  ll implicitly be
1ffa0 20 61 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a   assumed.</li>..
1ffb0 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 62 61  <li>the <b><i>ba
1ffc0 6e 64 49 6e 64 65 78 52 65 64 3c 2f 62 3e 3c 2f  ndIndexRed</b></
1ffd0 69 3e 2c 20 3c 62 3e 3c 69 3e 62 61 6e 64 49 6e  i>, <b><i>bandIn
1ffe0 64 65 78 47 72 65 65 6e 3c 2f 69 3e 3c 2f 62 3e  dexGreen</i></b>
1fff0 20 61 6e 64 20 3c 62 3e 3c 69 3e 62 61 6e 64 49   and <b><i>bandI
20000 6e 64 65 78 42 6c 75 65 3c 2f 69 3e 3c 2f 62 3e  ndexBlue</i></b>
20010 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65 20 69   arguments are i
20020 6e 74 65 6e 64 65 64 20 74 6f 20 61 72 62 69 74  ntended to arbit
20030 72 61 72 69 6c 79 20 63 6f 6d 70 6f 73 65 20 74  rarily compose t
20040 68 65 20 52 47 42 20 54 49 46 46 20 73 74 61 72  he RGB TIFF star
20050 74 69 6e 67 20 66 72 6f 6d 20 74 68 65 20 42 61  ting from the Ba
20060 6e 64 73 20 73 75 70 70 6f 72 74 65 64 20 62 79  nds supported by
20070 20 74 68 65 20 43 6f 76 65 72 61 67 65 2e 0d 0a   the Coverage...
20080 3c 62 72 3e 3c 75 3e 50 6c 65 61 73 65 20 6e 6f  <br><u>Please no
20090 74 65 3c 2f 75 3e 3a 20 74 68 65 20 66 69 72 73  te</u>: the firs
200a0 74 20 42 61 6e 64 20 61 6c 77 61 79 73 20 63 6f  t Band always co
200b0 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 69 6e 64  rresponds to ind
200c0 65 78 20 3c 62 3e 5a 45 52 4f 3c 2f 62 3e 3c 2f  ex <b>ZERO</b></
200d0 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e  li>..<li>the <b>
200e0 3c 69 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f  <i>boundingBox</
200f0 69 3e 3c 2f 62 3e 20 69 73 20 65 78 70 65 63 74  i></b> is expect
20100 65 64 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20  ed to represent 
20110 74 68 65 20 6f 76 65 72 61 6c 6c 20 65 78 74 65  the overall exte
20120 6e 74 20 6f 66 20 74 68 65 20 65 78 70 6f 72 74  nt of the export
20130 65 64 20 54 49 46 46 3b 20 79 6f 75 20 63 6f 75  ed TIFF; you cou
20140 6c 64 20 65 76 65 6e 74 75 61 6c 6c 79 20 70 61  ld eventually pa
20150 73 73 20 61 6e 79 20 61 72 62 69 74 72 61 72 79  ss any arbitrary
20160 20 6b 69 6e 64 20 6f 66 20 47 65 6f 6d 65 74 72   kind of Geometr
20170 79 2c 20 61 6e 64 20 74 68 65 20 42 6f 75 6e 64  y, and the Bound
20180 69 6e 67 20 42 6f 78 20 61 6b 61 20 4d 42 52 20  ing Box aka MBR 
20190 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69  will be automati
201a0 63 61 6c 6c 79 20 64 65 74 65 72 6d 69 6e 65 64  cally determined
201b0 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20  .</li>..<li>the 
201c0 3c 62 3e 3c 69 3e 68 6f 72 7a 50 69 78 65 6c 52  <b><i>horzPixelR
201d0 65 73 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62  esolution</i></b
201e0 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e 76 65 72 74  > and <b><i>vert
201f0 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c  PixelResolution<
20200 2f 69 3e 3c 2f 62 3e 20 6d 75 73 74 20 65 78 61  /i></b> must exa
20210 63 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20 43  ctly match the C
20220 6f 76 65 72 61 67 65 27 73 20 62 61 73 65 20 72  overage's base r
20230 65 73 6f 6c 75 74 69 6f 6e 20 6f 72 20 6f 6e 65  esolution or one
20240 20 6f 66 20 74 68 65 20 72 65 73 6f 6c 75 74 69   of the resoluti
20250 6f 6e 73 20 6d 61 64 65 20 61 76 61 69 6c 61 62  ons made availab
20260 6c 65 20 62 79 20 74 68 65 20 63 6f 72 72 65 73  le by the corres
20270 70 6f 6e 64 69 6e 67 20 50 79 72 61 6d 69 64 20  ponding Pyramid 
20280 6c 65 76 65 6c 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c  levels.</li>..<l
20290 69 3e 61 6e 64 20 74 68 65 20 42 6f 75 6e 64 69  i>and the Boundi
202a0 6e 67 42 6f 78 20 6d 75 73 74 20 65 78 61 63 74  ngBox must exact
202b0 6c 79 20 6d 61 74 63 68 20 74 68 65 20 54 49 46  ly match the TIF
202c0 46 20 3c 62 3e 3c 69 3e 77 69 64 74 68 3c 2f 69  F <b><i>width</i
202d0 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e  ></b> and <b><i>
202e0 68 65 69 67 68 74 3c 2f 69 3e 3c 2f 62 3e 20 64  height</i></b> d
202f0 69 6d 65 6e 73 69 6f 6e 73 20 61 74 20 74 68 61  imensions at tha
20300 74 20 72 65 73 6f 6c 75 74 69 6f 6e 2e 3c 2f 6c  t resolution.</l
20310 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69  i>..<li>the opti
20320 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62  onal argument <b
20330 3e 3c 69 3e 74 69 66 66 43 6f 6d 70 72 65 73 73  ><i>tiffCompress
20340 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 63 6f 75 6c  ion</i></b> coul
20350 64 20 62 65 20 6f 6e 65 20 6f 66 20 3c 62 3e 27  d be one of <b>'
20360 4e 4f 4e 45 27 3c 2f 62 3e 2c 20 3c 62 3e 27 44  NONE'</b>, <b>'D
20370 45 46 4c 41 54 45 27 3c 2f 62 3e 2c 20 3c 62 3e  EFLATE'</b>, <b>
20380 27 4c 5a 57 27 3c 2f 62 3e 2c 20 3c 62 3e 27 4a  'LZW'</b>, <b>'J
20390 50 45 47 27 3c 2f 62 3e 2c 20 3c 62 3e 27 46 41  PEG'</b>, <b>'FA
203a0 58 33 27 3c 2f 62 3e 20 6f 72 20 3c 62 3e 27 46  X3'</b> or <b>'F
203b0 41 58 34 27 3c 2f 62 3e 3b 20 64 65 66 61 75 6c  AX4'</b>; defaul
203c0 74 20 69 73 20 3c 62 3e 27 4e 4f 4e 45 27 3c 2f  t is <b>'NONE'</
203d0 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68  b>.</li>..<li>th
203e0 65 20 6c 61 73 74 20 6f 70 74 69 6f 6e 61 6c 20  e last optional 
203f0 61 72 67 75 6d 65 6e 74 20 63 61 6e 20 62 65 20  argument can be 
20400 75 73 65 64 20 73 6f 20 74 6f 20 73 70 65 63 69  used so to speci
20410 66 79 20 74 68 65 20 70 72 65 66 65 72 72 65 64  fy the preferred
20420 20 54 49 46 46 20 74 69 6c 65 20 73 69 7a 65 20   TIFF tile size 
20430 28 6f 6e 6c 79 20 73 71 75 61 72 65 20 74 69 6c  (only square til
20440 65 73 20 61 72 65 20 73 75 70 70 6f 72 74 65 64  es are supported
20450 29 3b 20 64 65 66 61 75 6c 74 20 69 73 20 3c 62  ); default is <b
20460 3e 32 35 36 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a  >256</b>.</li>..
20470 3c 2f 75 6c 3e 0d 0a 3c 74 61 62 6c 65 20 77 69  </ul>..<table wi
20480 64 74 68 3d 22 31 30 30 25 22 20 62 67 63 6f 6c  dth="100%" bgcol
20490 6f 72 3d 22 23 66 66 64 30 38 30 22 20 63 65 6c  or="#ffd080" cel
204a0 6c 70 61 64 64 69 6e 67 3d 22 36 22 3e 3c 74 72  lpadding="6"><tr
204b0 3e 3c 74 64 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65  ><td>..<u>Please
204c0 20 6e 6f 74 65 20 76 65 72 79 20 77 65 6c 6c 3c   note very well<
204d0 2f 75 3e 3a 20 74 68 69 73 20 53 51 4c 20 66 75  /u>: this SQL fu
204e0 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 61  nction is only a
204f0 76 61 69 6c 61 62 6c 65 20 77 68 65 6e 20 74 68  vailable when th
20500 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61  e environment va
20510 72 69 61 62 6c 65 20 3c 62 3e 53 50 41 54 49 41  riable <b>SPATIA
20520 4c 49 54 45 5f 53 45 43 55 52 49 54 59 3d 72 65  LITE_SECURITY=re
20530 6c 61 78 65 64 3c 2f 62 3e 20 69 73 20 73 65 74  laxed</b> is set
20540 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62  .</td></tr></tab
20550 6c 65 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d  le></td>..</tr>.
20560 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 52 4c 32 5f  .<tr><td><b>RL2_
20570 57 72 69 74 65 53 65 63 74 69 6f 6e 54 72 69 70  WriteSectionTrip
20580 6c 65 42 61 6e 64 54 69 66 66 3c 2f 62 3e 20 28  leBandTiff</b> (
20590 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e   <b>dbPrefix</b>
205a0 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
205b0 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
205c0 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
205d0 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 49  i> , <b>sectionI
205e0 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  D</b> <i>Integer
205f0 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61  </i> , <b>filePa
20600 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  th</b> <i>String
20610 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c  </i> , <b>width<
20620 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
20630 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f  i> , <b>height</
20640 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
20650 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78  > , <b>bandIndex
20660 52 65 64 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  Red</b> <i>Integ
20670 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64  er</i> , <b>band
20680 49 6e 64 65 78 47 72 65 65 6e 3c 2f 62 3e 20 3c  IndexGreen</b> <
20690 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
206a0 3c 62 3e 62 61 6e 64 49 6e 64 65 78 42 6c 75 65  <b>bandIndexBlue
206b0 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
206c0 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e  /i> , <b>boundin
206d0 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42  gBox</b> <i>BLOB
206e0 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20  -Geometry</i> , 
206f0 3c 62 3e 70 69 78 65 6c 52 65 73 6f 6c 75 74 69  <b>pixelResoluti
20700 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65  on</b> <i>Double
20710 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65  </i> ) : <i>Inte
20720 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d  ger</i><br><br>.
20730 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65 53 65 63  .<b>RL2_WriteSec
20740 74 69 6f 6e 54 72 69 70 6c 65 42 61 6e 64 54 69  tionTripleBandTi
20750 66 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72  ff</b> ( <b>dbPr
20760 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  efix</b> <i>Stri
20770 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65  ng</i> , <b>cove
20780 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e  rageName</b> <i>
20790 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
207a0 73 65 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69  sectionID</b> <i
207b0 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
207c0 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c  b>filePath</b> <
207d0 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
207e0 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49  b>width</b> <i>I
207f0 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
20800 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e  height</b> <i>In
20810 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
20820 61 6e 64 49 6e 64 65 78 52 65 64 3c 2f 62 3e 20  andIndexRed</b> 
20830 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
20840 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 47 72 65   <b>bandIndexGre
20850 65 6e 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  en</b> <i>Intege
20860 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49  r</i> , <b>bandI
20870 6e 64 65 78 42 6c 75 65 3c 2f 62 3e 20 3c 69 3e  ndexBlue</b> <i>
20880 49 6e 74 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c  Integer</i>  , <
20890 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62  b>boundingBox</b
208a0 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74  > <i>BLOB-Geomet
208b0 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a  ry</i> , <b>horz
208c0 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c  PixelResolution<
208d0 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69  /b> <i>Double</i
208e0 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69 78 65 6c  > , <b>vertPixel
208f0 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c  Resolution</b> <
20900 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a  i>Double</i> ) :
20910 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c   <i>Integer</i><
20920 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f  br><br>..<b>RL2_
20930 57 72 69 74 65 53 65 63 74 69 6f 6e 54 72 69 70  WriteSectionTrip
20940 6c 65 42 61 6e 64 54 69 66 66 3c 2f 62 3e 20 28  leBandTiff</b> (
20950 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e   <b>dbPrefix</b>
20960 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
20970 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
20980 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
20990 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 49  i> , <b>sectionI
209a0 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  D</b> <i>Integer
209b0 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61  </i> , <b>filePa
209c0 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  th</b> <i>String
209d0 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c  </i> , <b>width<
209e0 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
209f0 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f  i> , <b>height</
20a00 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
20a10 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78  > , <b>bandIndex
20a20 52 65 64 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  Red</b> <i>Integ
20a30 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64  er</i> , <b>band
20a40 49 6e 64 65 78 47 72 65 65 6e 3c 2f 62 3e 20 3c  IndexGreen</b> <
20a50 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20  i>Integer</i> , 
20a60 3c 62 3e 62 61 6e 64 49 6e 64 65 78 42 6c 75 65  <b>bandIndexBlue
20a70 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
20a80 2f 69 3e 20 20 2c 20 3c 62 3e 62 6f 75 6e 64 69  /i>  , <b>boundi
20a90 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f  ngBox</b> <i>BLO
20aa0 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c  B-Geometry</i> ,
20ab0 20 3c 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73   <b>horzPixelRes
20ac0 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44  olution</b> <i>D
20ad0 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76  ouble</i> , <b>v
20ae0 65 72 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69  ertPixelResoluti
20af0 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65  on</b> <i>Double
20b00 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 66 66 43 6f  </i> , <b>tiffCo
20b10 6d 70 72 65 73 73 69 6f 6e 3c 2f 62 3e 20 3c 69  mpression</b> <i
20b20 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20  >String</i> ) : 
20b30 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62  <i>Integer</i><b
20b40 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57  r><br>..<b>RL2_W
20b50 72 69 74 65 53 65 63 74 69 6f 6e 54 72 69 70 6c  riteSectionTripl
20b60 65 42 61 6e 64 54 69 66 66 3c 2f 62 3e 20 28 20  eBandTiff</b> ( 
20b70 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20  <b>dbPrefix</b> 
20b80 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
20b90 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
20ba0 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
20bb0 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 49 44  > , <b>sectionID
20bc0 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
20bd0 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74  /i> , <b>filePat
20be0 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  h</b> <i>String<
20bf0 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f  /i> , <b>width</
20c00 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
20c10 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62  > , <b>height</b
20c20 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
20c30 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 52   , <b>bandIndexR
20c40 65 64 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ed</b> <i>Intege
20c50 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49  r</i> , <b>bandI
20c60 6e 64 65 78 47 72 65 65 6e 3c 2f 62 3e 20 3c 69  ndexGreen</b> <i
20c70 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
20c80 62 3e 62 61 6e 64 49 6e 64 65 78 42 6c 75 65 3c  b>bandIndexBlue<
20c90 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
20ca0 69 3e 20 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e  i>  , <b>boundin
20cb0 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42  gBox</b> <i>BLOB
20cc0 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20  -Geometry</i> , 
20cd0 3c 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f  <b>horzPixelReso
20ce0 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f  lution</b> <i>Do
20cf0 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65  uble</i> , <b>ve
20d00 72 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rtPixelResolutio
20d10 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c  n</b> <i>Double<
20d20 2f 69 3e 20 2c 20 3c 62 3e 74 69 66 66 43 6f 6d  /i> , <b>tiffCom
20d30 70 72 65 73 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e  pression</b> <i>
20d40 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
20d50 74 69 66 66 54 69 6c 65 53 69 7a 65 3c 2f 62 3e  tiffTileSize</b>
20d60 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
20d70 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  ) : <i>Integer</
20d80 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c  i></td>..<td>Wil
20d90 6c 20 61 74 74 65 6d 70 74 20 74 6f 20 65 78 70  l attempt to exp
20da0 6f 72 74 20 72 61 77 20 72 61 73 74 65 72 20 64  ort raw raster d
20db0 61 74 61 20 66 72 6f 6d 20 61 20 4d 55 4c 54 49  ata from a MULTI
20dc0 42 41 4e 44 20 6f 72 20 52 47 42 20 43 6f 76 65  BAND or RGB Cove
20dd0 72 61 67 65 20 69 6e 74 6f 20 61 6e 20 65 78 74  rage into an ext
20de0 65 72 6e 61 6c 20 70 6c 61 69 6e 20 54 49 46 46  ernal plain TIFF
20df0 20 66 69 6c 65 20 6f 66 20 74 68 65 20 52 47 42   file of the RGB
20e00 20 74 79 70 65 3b 20 6f 6e 6c 79 20 74 68 65 20   type; only the 
20e10 54 69 6c 65 73 20 64 69 72 65 63 74 6c 79 20 62  Tiles directly b
20e20 65 6c 6f 6e 67 69 6e 67 20 74 6f 20 74 68 65 20  elonging to the 
20e30 73 65 6c 65 63 74 65 64 20 53 65 63 74 69 6f 6e  selected Section
20e40 20 77 69 6c 6c 20 62 65 20 63 6f 6e 73 69 64 65   will be conside
20e50 72 65 64 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72  red.<br>..Will r
20e60 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28  eturn <b>1</b> (
20e70 54 52 55 45 2f 53 55 43 43 45 53 53 29 20 6f 72  TRUE/SUCCESS) or
20e80 20 3c 62 3e 30 3c 2f 62 3e 20 28 46 41 4c 53 45   <b>0</b> (FALSE
20e90 2f 46 41 49 4c 55 52 45 29 3a 20 6f 72 20 3c 62  /FAILURE): or <b
20ea0 3e 2d 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c  >-1</b> on inval
20eb0 69 64 20 61 72 67 75 6d 65 6e 74 73 2e 3c 62 72  id arguments.<br
20ec0 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74  >..<u>Please not
20ed0 65 3c 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c  e</u>: ..<ul>..<
20ee0 6c 69 3e 54 68 65 20 3c 62 3e 3c 69 3e 64 62 50  li>The <b><i>dbP
20ef0 72 65 66 69 78 3c 2f 69 3e 3c 2f 62 3e 20 61 72  refix</i></b> ar
20f00 67 75 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e 64  gument is intend
20f10 65 64 20 74 6f 20 73 70 65 63 69 66 79 20 74 68  ed to specify th
20f20 65 20 41 54 54 41 43 48 45 44 2d 44 42 20 77 68  e ATTACHED-DB wh
20f30 65 72 65 20 74 68 65 20 43 6f 76 65 72 61 67 65  ere the Coverage
20f40 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f 20   is expected to 
20f50 62 65 20 66 6f 75 6e 64 3b 20 69 74 20 63 6f 75  be found; it cou
20f60 6c 64 20 62 65 20 65 76 65 6e 74 75 61 6c 6c 79  ld be eventually
20f70 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e   <b>NULL</b>, an
20f80 64 20 69 6e 20 74 68 69 73 20 63 61 73 65 20 74  d in this case t
20f90 68 65 20 3c 62 3e 4d 41 49 4e 20 44 42 3c 2f 62  he <b>MAIN DB</b
20fa0 3e 20 77 69 6c 6c 20 69 6d 70 6c 69 63 69 74 6c  > will implicitl
20fb0 79 20 62 65 20 61 73 73 75 6d 65 64 2e 3c 2f 6c  y be assumed.</l
20fc0 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c  i>..<li>the <b><
20fd0 69 3e 62 61 6e 64 49 6e 64 65 78 52 65 64 3c 2f  i>bandIndexRed</
20fe0 62 3e 3c 2f 69 3e 2c 20 3c 62 3e 3c 69 3e 62 61  b></i>, <b><i>ba
20ff0 6e 64 49 6e 64 65 78 47 72 65 65 6e 3c 2f 69 3e  ndIndexGreen</i>
21000 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e 62  </b> and <b><i>b
21010 61 6e 64 49 6e 64 65 78 42 6c 75 65 3c 2f 69 3e  andIndexBlue</i>
21020 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 73 20 61  </b> arguments a
21030 72 65 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 61  re intended to a
21040 72 62 69 74 72 61 72 69 6c 79 20 63 6f 6d 70 6f  rbitrarily compo
21050 73 65 20 74 68 65 20 52 47 42 20 54 49 46 46 20  se the RGB TIFF 
21060 73 74 61 72 74 69 6e 67 20 66 72 6f 6d 20 74 68  starting from th
21070 65 20 42 61 6e 64 73 20 73 75 70 70 6f 72 74 65  e Bands supporte
21080 64 20 62 79 20 74 68 65 20 43 6f 76 65 72 61 67  d by the Coverag
21090 65 2e 0d 0a 3c 62 72 3e 3c 75 3e 50 6c 65 61 73  e...<br><u>Pleas
210a0 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 74 68 65 20  e note</u>: the 
210b0 66 69 72 73 74 20 42 61 6e 64 20 61 6c 77 61 79  first Band alway
210c0 73 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f  s corresponds to
210d0 20 69 6e 64 65 78 20 3c 62 3e 5a 45 52 4f 3c 2f   index <b>ZERO</
210e0 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65  b></li>..<li>the
210f0 20 3c 62 3e 3c 69 3e 62 6f 75 6e 64 69 6e 67 42   <b><i>boundingB
21100 6f 78 3c 2f 69 3e 3c 2f 62 3e 20 69 73 20 65 78  ox</i></b> is ex
21110 70 65 63 74 65 64 20 74 6f 20 72 65 70 72 65 73  pected to repres
21120 65 6e 74 20 74 68 65 20 6f 76 65 72 61 6c 6c 20  ent the overall 
21130 65 78 74 65 6e 74 20 6f 66 20 74 68 65 20 65 78  extent of the ex
21140 70 6f 72 74 65 64 20 54 49 46 46 3b 20 79 6f 75  ported TIFF; you
21150 20 63 6f 75 6c 64 20 65 76 65 6e 74 75 61 6c 6c   could eventuall
21160 79 20 70 61 73 73 20 61 6e 79 20 61 72 62 69 74  y pass any arbit
21170 72 61 72 79 20 6b 69 6e 64 20 6f 66 20 47 65 6f  rary kind of Geo
21180 6d 65 74 72 79 2c 20 61 6e 64 20 74 68 65 20 42  metry, and the B
21190 6f 75 6e 64 69 6e 67 20 42 6f 78 20 61 6b 61 20  ounding Box aka 
211a0 4d 42 52 20 77 69 6c 6c 20 62 65 20 61 75 74 6f  MBR will be auto
211b0 6d 61 74 69 63 61 6c 6c 79 20 64 65 74 65 72 6d  matically determ
211c0 69 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  ined.</li>..<li>
211d0 74 68 65 20 3c 62 3e 3c 69 3e 68 6f 72 7a 50 69  the <b><i>horzPi
211e0 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 69  xelResolution</i
211f0 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e  ></b> and <b><i>
21200 76 65 72 74 50 69 78 65 6c 52 65 73 6f 6c 75 74  vertPixelResolut
21210 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 6d 75 73 74  ion</i></b> must
21220 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68 20 74   exactly match t
21230 68 65 20 43 6f 76 65 72 61 67 65 27 73 20 62 61  he Coverage's ba
21240 73 65 20 72 65 73 6f 6c 75 74 69 6f 6e 20 6f 72  se resolution or
21250 20 6f 6e 65 20 6f 66 20 74 68 65 20 72 65 73 6f   one of the reso
21260 6c 75 74 69 6f 6e 73 20 6d 61 64 65 20 61 76 61  lutions made ava
21270 69 6c 61 62 6c 65 20 62 79 20 74 68 65 20 63 6f  ilable by the co
21280 72 72 65 73 70 6f 6e 64 69 6e 67 20 50 79 72 61  rresponding Pyra
21290 6d 69 64 20 6c 65 76 65 6c 73 2e 3c 2f 6c 69 3e  mid levels.</li>
212a0 0d 0a 3c 6c 69 3e 61 6e 64 20 74 68 65 20 42 6f  ..<li>and the Bo
212b0 75 6e 64 69 6e 67 42 6f 78 20 6d 75 73 74 20 65  undingBox must e
212c0 78 61 63 74 6c 79 20 6d 61 74 63 68 20 74 68 65  xactly match the
212d0 20 54 49 46 46 20 3c 62 3e 3c 69 3e 77 69 64 74   TIFF <b><i>widt
212e0 68 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62  h</i></b> and <b
212f0 3e 3c 69 3e 68 65 69 67 68 74 3c 2f 69 3e 3c 2f  ><i>height</i></
21300 62 3e 20 64 69 6d 65 6e 73 69 6f 6e 73 20 61 74  b> dimensions at
21310 20 74 68 61 74 20 72 65 73 6f 6c 75 74 69 6f 6e   that resolution
21320 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20  .</li>..<li>the 
21330 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e  optional argumen
21340 74 20 3c 62 3e 3c 69 3e 74 69 66 66 43 6f 6d 70  t <b><i>tiffComp
21350 72 65 73 73 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20  ression</i></b> 
21360 63 6f 75 6c 64 20 62 65 20 6f 6e 65 20 6f 66 20  could be one of 
21370 3c 62 3e 27 4e 4f 4e 45 27 3c 2f 62 3e 2c 20 3c  <b>'NONE'</b>, <
21380 62 3e 27 44 45 46 4c 41 54 45 27 3c 2f 62 3e 2c  b>'DEFLATE'</b>,
21390 20 3c 62 3e 27 4c 5a 57 27 3c 2f 62 3e 2c 20 3c   <b>'LZW'</b>, <
213a0 62 3e 27 4a 50 45 47 27 3c 2f 62 3e 2c 20 3c 62  b>'JPEG'</b>, <b
213b0 3e 27 46 41 58 33 27 3c 2f 62 3e 20 6f 72 20 3c  >'FAX3'</b> or <
213c0 62 3e 27 46 41 58 34 27 3c 2f 62 3e 3b 20 64 65  b>'FAX4'</b>; de
213d0 66 61 75 6c 74 20 69 73 20 3c 62 3e 27 4e 4f 4e  fault is <b>'NON
213e0 45 27 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c  E'</b>.</li>..<l
213f0 69 3e 74 68 65 20 6c 61 73 74 20 6f 70 74 69 6f  i>the last optio
21400 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 63 61 6e  nal argument can
21410 20 62 65 20 75 73 65 64 20 73 6f 20 74 6f 20 73   be used so to s
21420 70 65 63 69 66 79 20 74 68 65 20 70 72 65 66 65  pecify the prefe
21430 72 72 65 64 20 54 49 46 46 20 74 69 6c 65 20 73  rred TIFF tile s
21440 69 7a 65 20 28 6f 6e 6c 79 20 73 71 75 61 72 65  ize (only square
21450 20 74 69 6c 65 73 20 61 72 65 20 73 75 70 70 6f   tiles are suppo
21460 72 74 65 64 29 3b 20 64 65 66 61 75 6c 74 20 69  rted); default i
21470 73 20 3c 62 3e 32 35 36 3c 2f 62 3e 2e 3c 2f 6c  s <b>256</b>.</l
21480 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 74 61 62 6c  i>..</ul>..<tabl
21490 65 20 77 69 64 74 68 3d 22 31 30 30 25 22 20 62  e width="100%" b
214a0 67 63 6f 6c 6f 72 3d 22 23 66 66 64 30 38 30 22  gcolor="#ffd080"
214b0 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 36 22   cellpadding="6"
214c0 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 75 3e 50 6c  ><tr><td>..<u>Pl
214d0 65 61 73 65 20 6e 6f 74 65 20 76 65 72 79 20 77  ease note very w
214e0 65 6c 6c 3c 2f 75 3e 3a 20 74 68 69 73 20 53 51  ell</u>: this SQ
214f0 4c 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e  L function is on
21500 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 77 68 65  ly available whe
21510 6e 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e  n the environmen
21520 74 20 76 61 72 69 61 62 6c 65 20 3c 62 3e 53 50  t variable <b>SP
21530 41 54 49 41 4c 49 54 45 5f 53 45 43 55 52 49 54  ATIALITE_SECURIT
21540 59 3d 72 65 6c 61 78 65 64 3c 2f 62 3e 20 69 73  Y=relaxed</b> is
21550 20 73 65 74 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 3c   set.</td></tr><
21560 2f 74 61 62 6c 65 3e 3c 2f 74 64 3e 0d 0a 3c 2f  /table></td>..</
21570 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e  tr>..<tr><td><b>
21580 52 4c 32 5f 57 72 69 74 65 53 65 63 74 69 6f 6e  RL2_WriteSection
21590 4d 6f 6e 6f 42 61 6e 64 47 65 6f 54 69 66 66 3c  MonoBandGeoTiff<
215a0 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69  /b> ( <b>dbPrefi
215b0 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  x</b> <i>String<
215c0 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67  /i> , <b>coverag
215d0 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72  eName</b> <i>Str
215e0 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65 63  ing</i> , <b>sec
215f0 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e  tionID</b> <i>In
21600 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 66  teger</i> , <b>f
21610 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53  ilePath</b> <i>S
21620 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77  tring</i> , <b>w
21630 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  idth</b> <i>Inte
21640 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69  ger</i> , <b>hei
21650 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  ght</b> <i>Integ
21660 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64  er</i> , <b>band
21670 49 6e 64 65 78 47 72 61 79 3c 2f 62 3e 20 3c 69  IndexGray</b> <i
21680 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
21690 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62  b>boundingBox</b
216a0 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74  > <i>BLOB-Geomet
216b0 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 70 69 78 65  ry</i> , <b>pixe
216c0 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20  lResolution</b> 
216d0 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 29 20  <i>Double</i> ) 
216e0 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  : <i>Integer</i>
216f0 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32  <br><br>..<b>RL2
21700 5f 57 72 69 74 65 53 65 63 74 69 6f 6e 4d 6f 6e  _WriteSectionMon
21710 6f 42 61 6e 64 47 65 6f 54 69 66 66 3c 2f 62 3e  oBandGeoTiff</b>
21720 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f   ( <b>dbPrefix</
21730 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
21740 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61   , <b>coverageNa
21750 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  me</b> <i>String
21760 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f  </i> , <b>sectio
21770 6e 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  nID</b> <i>Integ
21780 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65  er</i> , <b>file
21790 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Path</b> <i>Stri
217a0 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74  ng</i> , <b>widt
217b0 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  h</b> <i>Integer
217c0 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74  </i> , <b>height
217d0 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
217e0 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64  /i> , <b>bandInd
217f0 65 78 47 72 61 79 3c 2f 62 3e 20 3c 69 3e 49 6e  exGray</b> <i>In
21800 74 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62 3e  teger</i>  , <b>
21810 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20  boundingBox</b> 
21820 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79  <i>BLOB-Geometry
21830 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50 69  </i> , <b>horzPi
21840 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62  xelResolution</b
21850 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20  > <i>Double</i> 
21860 2c 20 3c 62 3e 76 65 72 74 50 69 78 65 6c 52 65  , <b>vertPixelRe
21870 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e  solution</b> <i>
21880 44 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c  Double</i> ) : <
21890 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72  i>Integer</i><br
218a0 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72  ><br>..<b>RL2_Wr
218b0 69 74 65 53 65 63 74 69 6f 6e 4d 6f 6e 6f 42 61  iteSectionMonoBa
218c0 6e 64 47 65 6f 54 69 66 66 3c 2f 62 3e 20 28 20  ndGeoTiff</b> ( 
218d0 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20  <b>dbPrefix</b> 
218e0 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
218f0 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
21900 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
21910 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 49 44  > , <b>sectionID
21920 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
21930 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74  /i> , <b>filePat
21940 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  h</b> <i>String<
21950 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f  /i> , <b>width</
21960 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
21970 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62  > , <b>height</b
21980 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
21990 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 47   , <b>bandIndexG
219a0 72 61 79 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  ray</b> <i>Integ
219b0 65 72 3c 2f 69 3e 20 20 2c 20 3c 62 3e 62 6f 75  er</i>  , <b>bou
219c0 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e  ndingBox</b> <i>
219d0 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69  BLOB-Geometry</i
219e0 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50 69 78 65 6c  > , <b>horzPixel
219f0 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c  Resolution</b> <
21a00 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c  i>Double</i> , <
21a10 62 3e 76 65 72 74 50 69 78 65 6c 52 65 73 6f 6c  b>vertPixelResol
21a20 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75  ution</b> <i>Dou
21a30 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 74  ble</i> , <b>wit
21a40 68 57 6f 6c 64 46 69 6c 65 3c 2f 62 3e 20 3c 69  hWoldFile</b> <i
21a50 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a  >Integer</i> ) :
21a60 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c   <i>Integer</i><
21a70 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52 4c 32 5f  br><br>..<b>RL2_
21a80 57 72 69 74 65 53 65 63 74 69 6f 6e 4d 6f 6e 6f  WriteSectionMono
21a90 42 61 6e 64 47 65 6f 54 69 66 66 3c 2f 62 3e 20  BandGeoTiff</b> 
21aa0 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62  ( <b>dbPrefix</b
21ab0 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
21ac0 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d  , <b>coverageNam
21ad0 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  e</b> <i>String<
21ae0 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e  /i> , <b>section
21af0 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ID</b> <i>Intege
21b00 72 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50  r</i> , <b>fileP
21b10 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ath</b> <i>Strin
21b20 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68  g</i> , <b>width
21b30 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
21b40 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c  /i> , <b>height<
21b50 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
21b60 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65  i> , <b>bandInde
21b70 78 47 72 61 79 3c 2f 62 3e 20 3c 69 3e 49 6e 74  xGray</b> <i>Int
21b80 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62 3e 62  eger</i>  , <b>b
21b90 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c  oundingBox</b> <
21ba0 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c  i>BLOB-Geometry<
21bb0 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50 69 78  /i> , <b>horzPix
21bc0 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e  elResolution</b>
21bd0 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c   <i>Double</i> ,
21be0 20 3c 62 3e 76 65 72 74 50 69 78 65 6c 52 65 73   <b>vertPixelRes
21bf0 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44  olution</b> <i>D
21c00 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 77  ouble</i> , <b>w
21c10 69 74 68 57 6f 6c 64 46 69 6c 65 3c 2f 62 3e 20  ithWoldFile</b> 
21c20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
21c30 20 3c 62 3e 74 69 66 66 43 6f 6d 70 72 65 73 73   <b>tiffCompress
21c40 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ion</b> <i>Strin
21c50 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74  g</i> ) : <i>Int
21c60 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e  eger</i><br><br>
21c70 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65 53 65  ..<b>RL2_WriteSe
21c80 63 74 69 6f 6e 4d 6f 6e 6f 42 61 6e 64 47 65 6f  ctionMonoBandGeo
21c90 54 69 66 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62  Tiff</b> ( <b>db
21ca0 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74  Prefix</b> <i>St
21cb0 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f  ring</i> , <b>co
21cc0 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c  verageName</b> <
21cd0 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
21ce0 62 3e 73 65 63 74 69 6f 6e 49 44 3c 2f 62 3e 20  b>sectionID</b> 
21cf0 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
21d00 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e   <b>filePath</b>
21d10 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
21d20 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69   <b>width</b> <i
21d30 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
21d40 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e  b>height</b> <i>
21d50 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
21d60 3e 62 61 6e 64 49 6e 64 65 78 47 72 61 79 3c 2f  >bandIndexGray</
21d70 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
21d80 3e 20 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67  >  , <b>bounding
21d90 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d  Box</b> <i>BLOB-
21da0 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c  Geometry</i> , <
21db0 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c  b>horzPixelResol
21dc0 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75  ution</b> <i>Dou
21dd0 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72  ble</i> , <b>ver
21de0 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  tPixelResolution
21df0 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f  </b> <i>Double</
21e00 69 3e 20 2c 20 3c 62 3e 77 69 74 68 57 6f 6c 64  i> , <b>withWold
21e10 46 69 6c 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  File</b> <i>Inte
21e20 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 66  ger</i> , <b>tif
21e30 66 43 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 62 3e  fCompression</b>
21e40 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
21e50 20 3c 62 3e 74 69 66 66 54 69 6c 65 53 69 7a 65   <b>tiffTileSize
21e60 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
21e70 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67  /i> ) : <i>Integ
21e80 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  er</i></td>..<td
21e90 3e 57 69 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f  >Will attempt to
21ea0 20 65 78 70 6f 72 74 20 72 61 77 20 72 61 73 74   export raw rast
21eb0 65 72 20 64 61 74 61 20 66 72 6f 6d 20 61 20 4d  er data from a M
21ec0 55 4c 54 49 42 41 4e 44 20 6f 72 20 52 47 42 20  ULTIBAND or RGB 
21ed0 43 6f 76 65 72 61 67 65 20 69 6e 74 6f 20 61 6e  Coverage into an
21ee0 20 65 78 74 65 72 6e 61 6c 20 47 65 6f 54 49 46   external GeoTIF
21ef0 46 20 66 69 6c 65 20 6f 66 20 74 68 65 20 47 72  F file of the Gr
21f00 61 79 73 63 61 6c 65 20 74 79 70 65 3b 20 6f 6e  ayscale type; on
21f10 6c 79 20 74 68 65 20 54 69 6c 65 73 20 64 69 72  ly the Tiles dir
21f20 65 63 74 6c 79 20 62 65 6c 6f 6e 67 69 6e 67 20  ectly belonging 
21f30 74 6f 20 74 68 65 20 73 65 6c 65 63 74 65 64 20  to the selected 
21f40 53 65 63 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20  Section will be 
21f50 63 6f 6e 73 69 64 65 72 65 64 2e 3c 62 72 3e 0d  considered.<br>.
21f60 0a 57 69 6c 6c 20 72 65 74 75 72 6e 20 3c 62 3e  .Will return <b>
21f70 31 3c 2f 62 3e 20 28 54 52 55 45 2f 53 55 43 43  1</b> (TRUE/SUCC
21f80 45 53 53 29 20 6f 72 20 3c 62 3e 30 3c 2f 62 3e  ESS) or <b>0</b>
21f90 20 28 46 41 4c 53 45 2f 46 41 49 4c 55 52 45 29   (FALSE/FAILURE)
21fa0 3a 20 6f 72 20 3c 62 3e 2d 31 3c 2f 62 3e 20 6f  : or <b>-1</b> o
21fb0 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65  n invalid argume
21fc0 6e 74 73 2e 3c 62 72 3e 0d 0a 3c 75 3e 50 6c 65  nts.<br>..<u>Ple
21fd0 61 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 0d 0a  ase note</u>: ..
21fe0 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 20 3c 62  <ul>..<li>The <b
21ff0 3e 3c 69 3e 64 62 50 72 65 66 69 78 3c 2f 69 3e  ><i>dbPrefix</i>
22000 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 20 69 73  </b> argument is
22010 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 73 70 65   intended to spe
22020 63 69 66 79 20 74 68 65 20 41 54 54 41 43 48 45  cify the ATTACHE
22030 44 2d 44 42 20 77 68 65 72 65 20 74 68 65 20 43  D-DB where the C
22040 6f 76 65 72 61 67 65 20 69 73 20 65 78 70 65 63  overage is expec
22050 74 65 64 20 74 6f 20 62 65 20 66 6f 75 6e 64 3b  ted to be found;
22060 20 69 74 20 63 6f 75 6c 64 20 62 65 20 65 76 65   it could be eve
22070 6e 74 75 61 6c 6c 79 20 3c 62 3e 4e 55 4c 4c 3c  ntually <b>NULL<
22080 2f 62 3e 2c 20 61 6e 64 20 69 6e 20 74 68 69 73  /b>, and in this
22090 20 63 61 73 65 20 74 68 65 20 3c 62 3e 4d 41 49   case the <b>MAI
220a0 4e 20 44 42 3c 2f 62 3e 20 77 69 6c 6c 20 69 6d  N DB</b> will im
220b0 70 6c 69 63 69 74 6c 79 20 62 65 20 61 73 73 75  plicitly be assu
220c0 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74  med.</li>..<li>t
220d0 68 65 20 3c 62 3e 3c 69 3e 62 61 6e 64 49 6e 64  he <b><i>bandInd
220e0 65 78 47 72 61 79 3c 2f 69 3e 3c 2f 62 3e 20 61  exGray</i></b> a
220f0 72 67 75 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e  rgument is inten
22100 64 65 64 20 74 6f 20 61 72 62 69 74 72 61 72 69  ded to arbitrari
22110 6c 79 20 63 6f 6d 70 6f 73 65 20 74 68 65 20 47  ly compose the G
22120 72 61 79 73 63 61 6c 65 20 54 49 46 46 20 73 74  rayscale TIFF st
22130 61 72 74 69 6e 67 20 66 72 6f 6d 20 74 68 65 20  arting from the 
22140 42 61 6e 64 73 20 73 75 70 70 6f 72 74 65 64 20  Bands supported 
22150 62 79 20 74 68 65 20 43 6f 76 65 72 61 67 65 2e  by the Coverage.
22160 0d 0a 3c 62 72 3e 3c 75 3e 50 6c 65 61 73 65 20  ..<br><u>Please 
22170 6e 6f 74 65 3c 2f 75 3e 3a 20 74 68 65 20 66 69  note</u>: the fi
22180 72 73 74 20 42 61 6e 64 20 61 6c 77 61 79 73 20  rst Band always 
22190 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 69  corresponds to i
221a0 6e 64 65 78 20 3c 62 3e 5a 45 52 4f 3c 2f 62 3e  ndex <b>ZERO</b>
221b0 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c  </li>..<li>the <
221c0 62 3e 3c 69 3e 62 6f 75 6e 64 69 6e 67 42 6f 78  b><i>boundingBox
221d0 3c 2f 69 3e 3c 2f 62 3e 20 69 73 20 65 78 70 65  </i></b> is expe
221e0 63 74 65 64 20 74 6f 20 72 65 70 72 65 73 65 6e  cted to represen
221f0 74 20 74 68 65 20 6f 76 65 72 61 6c 6c 20 65 78  t the overall ex
22200 74 65 6e 74 20 6f 66 20 74 68 65 20 65 78 70 6f  tent of the expo
22210 72 74 65 64 20 47 65 6f 54 49 46 46 3b 20 79 6f  rted GeoTIFF; yo
22220 75 20 63 6f 75 6c 64 20 65 76 65 6e 74 75 61 6c  u could eventual
22230 6c 79 20 70 61 73 73 20 61 6e 79 20 61 72 62 69  ly pass any arbi
22240 74 72 61 72 79 20 6b 69 6e 64 20 6f 66 20 47 65  trary kind of Ge
22250 6f 6d 65 74 72 79 2c 20 61 6e 64 20 74 68 65 20  ometry, and the 
22260 42 6f 75 6e 64 69 6e 67 20 42 6f 78 20 61 6b 61  Bounding Box aka
22270 20 4d 42 52 20 77 69 6c 6c 20 62 65 20 61 75 74   MBR will be aut
22280 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 74 65 72  omatically deter
22290 6d 69 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69  mined.</li>..<li
222a0 3e 74 68 65 20 3c 62 3e 3c 69 3e 68 6f 72 7a 50  >the <b><i>horzP
222b0 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
222c0 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69  i></b> and <b><i
222d0 3e 76 65 72 74 50 69 78 65 6c 52 65 73 6f 6c 75  >vertPixelResolu
222e0 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 6d 75 73  tion</i></b> mus
222f0 74 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68 20  t exactly match 
22300 74 68 65 20 43 6f 76 65 72 61 67 65 27 73 20 62  the Coverage's b
22310 61 73 65 20 72 65 73 6f 6c 75 74 69 6f 6e 20 6f  ase resolution o
22320 72 20 6f 6e 65 20 6f 66 20 74 68 65 20 72 65 73  r one of the res
22330 6f 6c 75 74 69 6f 6e 73 20 6d 61 64 65 20 61 76  olutions made av
22340 61 69 6c 61 62 6c 65 20 62 79 20 74 68 65 20 63  ailable by the c
22350 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 50 79 72  orresponding Pyr
22360 61 6d 69 64 20 6c 65 76 65 6c 73 2e 3c 2f 6c 69  amid levels.</li
22370 3e 0d 0a 3c 6c 69 3e 61 6e 64 20 74 68 65 20 42  >..<li>and the B
22380 6f 75 6e 64 69 6e 67 42 6f 78 20 6d 75 73 74 20  oundingBox must 
22390 65 78 61 63 74 6c 79 20 6d 61 74 63 68 20 74 68  exactly match th
223a0 65 20 54 49 46 46 20 3c 62 3e 3c 69 3e 77 69 64  e TIFF <b><i>wid
223b0 74 68 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c  th</i></b> and <
223c0 62 3e 3c 69 3e 68 65 69 67 68 74 3c 2f 69 3e 3c  b><i>height</i><
223d0 2f 62 3e 20 64 69 6d 65 6e 73 69 6f 6e 73 20 61  /b> dimensions a
223e0 74 20 74 68 61 74 20 72 65 73 6f 6c 75 74 69 6f  t that resolutio
223f0 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69 66 20  n.</li>..<li>if 
22400 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67  the optional arg
22410 75 6d 65 6e 74 20 3c 62 3e 3c 69 3e 77 69 74 68  ument <b><i>with
22420 57 6f 72 6c 64 46 69 6c 65 3c 2f 69 3e 3c 2f 62  WorldFile</i></b
22430 3e 20 69 73 20 73 65 74 20 74 6f 20 54 52 55 45  > is set to TRUE
22440 20 74 68 65 6e 20 61 6e 20 61 75 78 69 6c 69 61   then an auxilia
22450 72 79 20 57 6f 72 6c 64 46 69 6c 65 20 77 69 6c  ry WorldFile wil
22460 6c 20 62 65 20 65 78 70 6f 72 74 65 64 20 61 73  l be exported as
22470 20 77 65 6c 6c 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69   well.</li>..<li
22480 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72  >the optional ar
22490 67 75 6d 65 6e 74 20 3c 62 3e 3c 69 3e 74 69 66  gument <b><i>tif
224a0 66 43 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 69 3e  fCompression</i>
224b0 3c 2f 62 3e 20 63 6f 75 6c 64 20 62 65 20 6f 6e  </b> could be on
224c0 65 20 6f 66 20 3c 62 3e 27 4e 4f 4e 45 27 3c 2f  e of <b>'NONE'</
224d0 62 3e 2c 20 3c 62 3e 27 44 45 46 4c 41 54 45 27  b>, <b>'DEFLATE'
224e0 3c 2f 62 3e 2c 20 3c 62 3e 27 4c 5a 57 27 3c 2f  </b>, <b>'LZW'</
224f0 62 3e 2c 20 3c 62 3e 27 4a 50 45 47 27 3c 2f 62  b>, <b>'JPEG'</b
22500 3e 2c 20 3c 62 3e 27 46 41 58 33 27 3c 2f 62 3e  >, <b>'FAX3'</b>
22510 20 6f 72 20 3c 62 3e 27 46 41 58 34 27 3c 2f 62   or <b>'FAX4'</b
22520 3e 3b 20 64 65 66 61 75 6c 74 20 69 73 20 3c 62  >; default is <b
22530 3e 27 4e 4f 4e 45 27 3c 2f 62 3e 2e 3c 2f 6c 69  >'NONE'</b>.</li
22540 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6c 61 73 74 20  >..<li>the last 
22550 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e  optional argumen
22560 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 73 6f  t can be used so
22570 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 20   to specify the 
22580 70 72 65 66 65 72 72 65 64 20 54 49 46 46 20 74  preferred TIFF t
22590 69 6c 65 20 73 69 7a 65 20 28 6f 6e 6c 79 20 73  ile size (only s
225a0 71 75 61 72 65 20 74 69 6c 65 73 20 61 72 65 20  quare tiles are 
225b0 73 75 70 70 6f 72 74 65 64 29 3b 20 64 65 66 61  supported); defa
225c0 75 6c 74 20 69 73 20 3c 62 3e 32 35 36 3c 2f 62  ult is <b>256</b
225d0 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a  >.</li>..</ul>..
225e0 3c 74 61 62 6c 65 20 77 69 64 74 68 3d 22 31 30  <table width="10
225f0 30 25 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66  0%" bgcolor="#ff
22600 64 30 38 30 22 20 63 65 6c 6c 70 61 64 64 69 6e  d080" cellpaddin
22610 67 3d 22 36 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a  g="6"><tr><td>..
22620 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 20 76  <u>Please note v
22630 65 72 79 20 77 65 6c 6c 3c 2f 75 3e 3a 20 74 68  ery well</u>: th
22640 69 73 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20  is SQL function 
22650 69 73 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c  is only availabl
22660 65 20 77 68 65 6e 20 74 68 65 20 65 6e 76 69 72  e when the envir
22670 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20  onment variable 
22680 3c 62 3e 53 50 41 54 49 41 4c 49 54 45 5f 53 45  <b>SPATIALITE_SE
22690 43 55 52 49 54 59 3d 72 65 6c 61 78 65 64 3c 2f  CURITY=relaxed</
226a0 62 3e 20 69 73 20 73 65 74 2e 3c 2f 74 64 3e 3c  b> is set.</td><
226b0 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e 3c 2f 74 64  /tr></table></td
226c0 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74  >..</tr>..<tr><t
226d0 64 3e 3c 62 3e 52 4c 32 5f 57 72 69 74 65 53 65  d><b>RL2_WriteSe
226e0 63 74 69 6f 6e 4d 6f 6e 6f 42 61 6e 64 54 69 66  ctionMonoBandTif
226f0 66 54 46 57 3c 2f 62 3e 20 28 20 3c 62 3e 64 62  fTFW</b> ( <b>db
22700 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74  Prefix</b> <i>St
22710 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f  ring</i> , <b>co
22720 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c  verageName</b> <
22730 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
22740 62 3e 73 65 63 74 69 6f 6e 49 44 3c 2f 62 3e 20  b>sectionID</b> 
22750 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
22760 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e   <b>filePath</b>
22770 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
22780 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69   <b>width</b> <i
22790 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
227a0 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e  b>height</b> <i>
227b0 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
227c0 3e 62 61 6e 64 49 6e 64 65 78 47 72 61 79 3c 2f  >bandIndexGray</
227d0 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
227e0 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42  > , <b>boundingB
227f0 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47  ox</b> <i>BLOB-G
22800 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62  eometry</i> , <b
22810 3e 70 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  >pixelResolution
22820 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f  </b> <i>Double</
22830 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65  i> ) : <i>Intege
22840 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c  r</i><br><br>..<
22850 62 3e 52 4c 32 5f 57 72 69 74 65 53 65 63 74 69  b>RL2_WriteSecti
22860 6f 6e 4d 6f 6e 6f 42 61 6e 64 54 69 66 66 54 46  onMonoBandTiffTF
22870 57 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65  W</b> ( <b>dbPre
22880 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  fix</b> <i>Strin
22890 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72  g</i> , <b>cover
228a0 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53  ageName</b> <i>S
228b0 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73  tring</i> , <b>s
228c0 65 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e  ectionID</b> <i>
228d0 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62  Integer</i> , <b
228e0 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69  >filePath</b> <i
228f0 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
22900 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
22910 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
22920 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
22930 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61  eger</i> , <b>ba
22940 6e 64 49 6e 64 65 78 47 72 61 79 3c 2f 62 3e 20  ndIndexGray</b> 
22950 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 20  <i>Integer</i>  
22960 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78  , <b>boundingBox
22970 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f  </b> <i>BLOB-Geo
22980 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68  metry</i> , <b>h
22990 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69  orzPixelResoluti
229a0 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65  on</b> <i>Double
229b0 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69  </i> , <b>vertPi
229c0 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62  xelResolution</b
229d0 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20  > <i>Double</i> 
229e0 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  ) : <i>Integer</
229f0 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52  i><br><br>..<b>R
22a00 4c 32 5f 57 72 69 74 65 53 65 63 74 69 6f 6e 4d  L2_WriteSectionM
22a10 6f 6e 6f 42 61 6e 64 54 69 66 66 54 46 57 3c 2f  onoBandTiffTFW</
22a20 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78  b> ( <b>dbPrefix
22a30 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
22a40 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65  i> , <b>coverage
22a50 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Name</b> <i>Stri
22a60 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74  ng</i> , <b>sect
22a70 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74  ionID</b> <i>Int
22a80 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69  eger</i> , <b>fi
22a90 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74  lePath</b> <i>St
22aa0 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69  ring</i> , <b>wi
22ab0 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  dth</b> <i>Integ
22ac0 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67  er</i> , <b>heig
22ad0 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ht</b> <i>Intege
22ae0 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49  r</i> , <b>bandI
22af0 6e 64 65 78 47 72 61 79 3c 2f 62 3e 20 3c 69 3e  ndexGray</b> <i>
22b00 49 6e 74 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c  Integer</i>  , <
22b10 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62  b>boundingBox</b
22b20 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74  > <i>BLOB-Geomet
22b30 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a  ry</i> , <b>horz
22b40 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c  PixelResolution<
22b50 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69  /b> <i>Double</i
22b60 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69 78 65 6c  > , <b>vertPixel
22b70 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c  Resolution</b> <
22b80 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c  i>Double</i> , <
22b90 62 3e 74 69 66 66 43 6f 6d 70 72 65 73 73 69 6f  b>tiffCompressio
22ba0 6e 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  n</b> <i>String<
22bb0 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67  /i> ) : <i>Integ
22bc0 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a  er</i><br><br>..
22bd0 3c 62 3e 52 4c 32 5f 57 72 69 74 65 53 65 63 74  <b>RL2_WriteSect
22be0 69 6f 6e 4d 6f 6e 6f 42 61 6e 64 54 69 66 66 54  ionMonoBandTiffT
22bf0 46 57 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72  FW</b> ( <b>dbPr
22c00 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  efix</b> <i>Stri
22c10 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65  ng</i> , <b>cove
22c20 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e  rageName</b> <i>
22c30 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
22c40 73 65 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69  sectionID</b> <i
22c50 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
22c60 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c  b>filePath</b> <
22c70 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
22c80 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49  b>width</b> <i>I
22c90 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
22ca0 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e  height</b> <i>In
22cb0 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
22cc0 61 6e 64 49 6e 64 65 78 47 72 61 79 3c 2f 62 3e  andIndexGray</b>
22cd0 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
22ce0 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f   , <b>boundingBo
22cf0 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65  x</b> <i>BLOB-Ge
22d00 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e  ometry</i> , <b>
22d10 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74  horzPixelResolut
22d20 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c  ion</b> <i>Doubl
22d30 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50  e</i> , <b>vertP
22d40 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
22d50 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e  b> <i>Double</i>
22d60 20 2c 20 3c 62 3e 74 69 66 66 43 6f 6d 70 72 65   , <b>tiffCompre
22d70 73 73 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 53 74 72  ssion</b> <i>Str
22d80 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 74 69 66  ing</i> , <b>tif
22d90 66 54 69 6c 65 53 69 7a 65 3c 2f 62 3e 20 3c 69  fTileSize</b> <i
22da0 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a  >Integer</i> ) :
22db0 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c   <i>Integer</i><
22dc0 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 61  /td>..<td>Will a
22dd0 74 74 65 6d 70 74 20 74 6f 20 65 78 70 6f 72 74  ttempt to export
22de0 20 72 61 77 20 72 61 73 74 65 72 20 64 61 74 61   raw raster data
22df0 20 66 72 6f 6d 20 61 20 4d 55 4c 54 49 42 41 4e   from a MULTIBAN
22e00 44 20 6f 72 20 52 47 42 20 43 6f 76 65 72 61 67  D or RGB Coverag
22e10 65 20 69 6e 74 6f 20 61 6e 20 65 78 74 65 72 6e  e into an extern
22e20 61 6c 20 70 6c 61 69 6e 20 54 49 46 46 20 66 69  al plain TIFF fi
22e30 6c 65 20 6f 66 20 74 68 65 20 47 72 61 79 73 63  le of the Graysc
22e40 61 6c 65 20 74 79 70 65 20 73 75 70 70 6f 72 74  ale type support
22e50 65 64 20 62 79 20 61 6e 20 61 75 78 69 6c 69 61  ed by an auxilia
22e60 72 79 20 57 6f 72 6c 64 46 69 6c 65 3b 20 6f 6e  ry WorldFile; on
22e70 6c 79 20 74 68 65 20 54 69 6c 65 73 20 64 69 72  ly the Tiles dir
22e80 65 63 74 6c 79 20 62 65 6c 6f 6e 67 69 6e 67 20  ectly belonging 
22e90 74 6f 20 74 68 65 20 73 65 6c 65 63 74 65 64 20  to the selected 
22ea0 53 65 63 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20  Section will be 
22eb0 63 6f 6e 73 69 64 65 72 65 64 2e 3c 62 72 3e 0d  considered.<br>.
22ec0 0a 57 69 6c 6c 20 72 65 74 75 72 6e 20 3c 62 3e  .Will return <b>
22ed0 31 3c 2f 62 3e 20 28 54 52 55 45 2f 53 55 43 43  1</b> (TRUE/SUCC
22ee0 45 53 53 29 20 6f 72 20 3c 62 3e 30 3c 2f 62 3e  ESS) or <b>0</b>
22ef0 20 28 46 41 4c 53 45 2f 46 41 49 4c 55 52 45 29   (FALSE/FAILURE)
22f00 3a 20 6f 72 20 3c 62 3e 2d 31 3c 2f 62 3e 20 6f  : or <b>-1</b> o
22f10 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65  n invalid argume
22f20 6e 74 73 2e 3c 62 72 3e 0d 0a 3c 75 3e 50 6c 65  nts.<br>..<u>Ple
22f30 61 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 0d 0a  ase note</u>: ..
22f40 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 20 3c 62  <ul>..<li>The <b
22f50 3e 3c 69 3e 64 62 50 72 65 66 69 78 3c 2f 69 3e  ><i>dbPrefix</i>
22f60 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 20 69 73  </b> argument is
22f70 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 73 70 65   intended to spe
22f80 63 69 66 79 20 74 68 65 20 41 54 54 41 43 48 45  cify the ATTACHE
22f90 44 2d 44 42 20 77 68 65 72 65 20 74 68 65 20 43  D-DB where the C
22fa0 6f 76 65 72 61 67 65 20 69 73 20 65 78 70 65 63  overage is expec
22fb0 74 65 64 20 74 6f 20 62 65 20 66 6f 75 6e 64 3b  ted to be found;
22fc0 20 69 74 20 63 6f 75 6c 64 20 62 65 20 65 76 65   it could be eve
22fd0 6e 74 75 61 6c 6c 79 20 3c 62 3e 4e 55 4c 4c 3c  ntually <b>NULL<
22fe0 2f 62 3e 2c 20 61 6e 64 20 69 6e 20 74 68 69 73  /b>, and in this
22ff0 20 63 61 73 65 20 74 68 65 20 3c 62 3e 4d 41 49   case the <b>MAI
23000 4e 20 44 42 3c 2f 62 3e 20 77 69 6c 6c 20 69 6d  N DB</b> will im
23010 70 6c 69 63 69 74 6c 79 20 62 65 20 61 73 73 75  plicitly be assu
23020 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74  med.</li>..<li>t
23030 68 65 20 3c 62 3e 3c 69 3e 62 61 6e 64 49 6e 64  he <b><i>bandInd
23040 65 78 47 72 61 79 3c 2f 69 3e 3c 2f 62 3e 20 61  exGray</i></b> a
23050 72 67 75 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e  rgument is inten
23060 64 65 64 20 74 6f 20 61 72 62 69 74 72 61 72 69  ded to arbitrari
23070 6c 79 20 63 6f 6d 70 6f 73 65 20 74 68 65 20 47  ly compose the G
23080 72 61 79 73 63 61 6c 65 20 54 49 46 46 20 73 74  rayscale TIFF st
23090 61 72 74 69 6e 67 20 66 72 6f 6d 20 74 68 65 20  arting from the 
230a0 42 61 6e 64 73 20 73 75 70 70 6f 72 74 65 64 20  Bands supported 
230b0 62 79 20 74 68 65 20 43 6f 76 65 72 61 67 65 2e  by the Coverage.
230c0 0d 0a 3c 62 72 3e 3c 75 3e 50 6c 65 61 73 65 20  ..<br><u>Please 
230d0 6e 6f 74 65 3c 2f 75 3e 3a 20 74 68 65 20 66 69  note</u>: the fi
230e0 72 73 74 20 42 61 6e 64 20 61 6c 77 61 79 73 20  rst Band always 
230f0 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 69  corresponds to i
23100 6e 64 65 78 20 3c 62 3e 5a 45 52 4f 3c 2f 62 3e  ndex <b>ZERO</b>
23110 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 3c  </li>..<li>the <
23120 62 3e 3c 69 3e 62 6f 75 6e 64 69 6e 67 42 6f 78  b><i>boundingBox
23130 3c 2f 69 3e 3c 2f 62 3e 20 69 73 20 65 78 70 65  </i></b> is expe
23140 63 74 65 64 20 74 6f 20 72 65 70 72 65 73 65 6e  cted to represen
23150 74 20 74 68 65 20 6f 76 65 72 61 6c 6c 20 65 78  t the overall ex
23160 74 65 6e 74 20 6f 66 20 74 68 65 20 65 78 70 6f  tent of the expo
23170 72 74 65 64 20 54 49 46 46 3b 20 79 6f 75 20 63  rted TIFF; you c
23180 6f 75 6c 64 20 65 76 65 6e 74 75 61 6c 6c 79 20  ould eventually 
23190 70 61 73 73 20 61 6e 79 20 61 72 62 69 74 72 61  pass any arbitra
231a0 72 79 20 6b 69 6e 64 20 6f 66 20 47 65 6f 6d 65  ry kind of Geome
231b0 74 72 79 2c 20 61 6e 64 20 74 68 65 20 42 6f 75  try, and the Bou
231c0 6e 64 69 6e 67 20 42 6f 78 20 61 6b 61 20 4d 42  nding Box aka MB
231d0 52 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61  R will be automa
231e0 74 69 63 61 6c 6c 79 20 64 65 74 65 72 6d 69 6e  tically determin
231f0 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68  ed.</li>..<li>th
23200 65 20 3c 62 3e 3c 69 3e 68 6f 72 7a 50 69 78 65  e <b><i>horzPixe
23210 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c  lResolution</i><
23220 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69 3e 76 65  /b> and <b><i>ve
23230 72 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rtPixelResolutio
23240 6e 3c 2f 69 3e 3c 2f 62 3e 20 6d 75 73 74 20 65  n</i></b> must e
23250 78 61 63 74 6c 79 20 6d 61 74 63 68 20 74 68 65  xactly match the
23260 20 43 6f 76 65 72 61 67 65 27 73 20 62 61 73 65   Coverage's base
23270 20 72 65 73 6f 6c 75 74 69 6f 6e 20 6f 72 20 6f   resolution or o
23280 6e 65 20 6f 66 20 74 68 65 20 72 65 73 6f 6c 75  ne of the resolu
23290 74 69 6f 6e 73 20 6d 61 64 65 20 61 76 61 69 6c  tions made avail
232a0 61 62 6c 65 20 62 79 20 74 68 65 20 63 6f 72 72  able by the corr
232b0 65 73 70 6f 6e 64 69 6e 67 20 50 79 72 61 6d 69  esponding Pyrami
232c0 64 20 6c 65 76 65 6c 73 2e 3c 2f 6c 69 3e 0d 0a  d levels.</li>..
232d0 3c 6c 69 3e 61 6e 64 20 74 68 65 20 42 6f 75 6e  <li>and the Boun
232e0 64 69 6e 67 42 6f 78 20 6d 75 73 74 20 65 78 61  dingBox must exa
232f0 63 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20 54  ctly match the T
23300 49 46 46 20 3c 62 3e 3c 69 3e 77 69 64 74 68 3c  IFF <b><i>width<
23310 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c  /i></b> and <b><
23320 69 3e 68 65 69 67 68 74 3c 2f 69 3e 3c 2f 62 3e  i>height</i></b>
23330 20 64 69 6d 65 6e 73 69 6f 6e 73 20 61 74 20 74   dimensions at t
23340 68 61 74 20 72 65 73 6f 6c 75 74 69 6f 6e 2e 3c  hat resolution.<
23350 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70  /li>..<li>the op
23360 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20  tional argument 
23370 3c 62 3e 3c 69 3e 74 69 66 66 43 6f 6d 70 72 65  <b><i>tiffCompre
23380 73 73 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 63 6f  ssion</i></b> co
23390 75 6c 64 20 62 65 20 6f 6e 65 20 6f 66 20 3c 62  uld be one of <b
233a0 3e 27 4e 4f 4e 45 27 3c 2f 62 3e 2c 20 3c 62 3e  >'NONE'</b>, <b>
233b0 27 44 45 46 4c 41 54 45 27 3c 2f 62 3e 2c 20 3c  'DEFLATE'</b>, <
233c0 62 3e 27 4c 5a 57 27 3c 2f 62 3e 2c 20 3c 62 3e  b>'LZW'</b>, <b>
233d0 27 4a 50 45 47 27 3c 2f 62 3e 2c 20 3c 62 3e 27  'JPEG'</b>, <b>'
233e0 46 41 58 33 27 3c 2f 62 3e 20 6f 72 20 3c 62 3e  FAX3'</b> or <b>
233f0 27 46 41 58 34 27 3c 2f 62 3e 3b 20 64 65 66 61  'FAX4'</b>; defa
23400 75 6c 74 20 69 73 20 3c 62 3e 27 4e 4f 4e 45 27  ult is <b>'NONE'
23410 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  </b>.</li>..<li>
23420 74 68 65 20 6c 61 73 74 20 6f 70 74 69 6f 6e 61  the last optiona
23430 6c 20 61 72 67 75 6d 65 6e 74 20 63 61 6e 20 62  l argument can b
23440 65 20 75 73 65 64 20 73 6f 20 74 6f 20 73 70 65  e used so to spe
23450 63 69 66 79 20 74 68 65 20 70 72 65 66 65 72 72  cify the preferr
23460 65 64 20 54 49 46 46 20 74 69 6c 65 20 73 69 7a  ed TIFF tile siz
23470 65 20 28 6f 6e 6c 79 20 73 71 75 61 72 65 20 74  e (only square t
23480 69 6c 65 73 20 61 72 65 20 73 75 70 70 6f 72 74  iles are support
23490 65 64 29 3b 20 64 65 66 61 75 6c 74 20 69 73 20  ed); default is 
234a0 3c 62 3e 32 35 36 3c 2f 62 3e 2e 3c 2f 6c 69 3e  <b>256</b>.</li>
234b0 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 74 61 62 6c 65 20  ..</ul>..<table 
234c0 77 69 64 74 68 3d 22 31 30 30 25 22 20 62 67 63  width="100%" bgc
234d0 6f 6c 6f 72 3d 22 23 66 66 64 30 38 30 22 20 63  olor="#ffd080" c
234e0 65 6c 6c 70 61 64 64 69 6e 67 3d 22 36 22 3e 3c  ellpadding="6"><
234f0 74 72 3e 3c 74 64 3e 0d 0a 3c 75 3e 50 6c 65 61  tr><td>..<u>Plea
23500 73 65 20 6e 6f 74 65 20 76 65 72 79 20 77 65 6c  se note very wel
23510 6c 3c 2f 75 3e 3a 20 74 68 69 73 20 53 51 4c 20  l</u>: this SQL 
23520 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79  function is only
23530 20 61 76 61 69 6c 61 62 6c 65 20 77 68 65 6e 20   available when 
23540 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20  the environment 
23550 76 61 72 69 61 62 6c 65 20 3c 62 3e 53 50 41 54  variable <b>SPAT
23560 49 41 4c 49 54 45 5f 53 45 43 55 52 49 54 59 3d  IALITE_SECURITY=
23570 72 65 6c 61 78 65 64 3c 2f 62 3e 20 69 73 20 73  relaxed</b> is s
23580 65 74 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 3c 2f 74  et.</td></tr></t
23590 61 62 6c 65 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72  able></td>..</tr
235a0 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 52 4c  >..<tr><td><b>RL
235b0 32 5f 57 72 69 74 65 53 65 63 74 69 6f 6e 4d 6f  2_WriteSectionMo
235c0 6e 6f 42 61 6e 64 54 69 66 66 3c 2f 62 3e 20 28  noBandTiff</b> (
235d0 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e   <b>dbPrefix</b>
235e0 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
235f0 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
23600 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
23610 69 3e 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68  i> , <b>filePath
23620 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
23630 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62  i> , <b>width</b
23640 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
23650 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e   , <b>height</b>
23660 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
23670 2c 20 3c 62 3e 62 61 6e 64 49 6e 64 65 78 47 72  , <b>bandIndexGr
23680 61 79 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ay</b> <i>Intege
23690 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64  r</i> , <b>bound
236a0 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c  ingBox</b> <i>BL
236b0 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20  OB-Geometry</i> 
236c0 2c 20 3c 62 3e 70 69 78 65 6c 52 65 73 6f 6c 75  , <b>pixelResolu
236d0 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62  tion</b> <i>Doub
236e0 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e  le</i> ) : <i>In
236f0 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72  teger</i><br><br
23700 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65 53  >..<b>RL2_WriteS
23710 65 63 74 69 6f 6e 4d 6f 6e 6f 42 61 6e 64 54 69  ectionMonoBandTi
23720 66 66 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72  ff</b> ( <b>dbPr
23730 65 66 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  efix</b> <i>Stri
23740 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65  ng</i> , <b>cove
23750 72 61 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e  rageName</b> <i>
23760 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
23770 73 65 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69  sectionID</b> <i
23780 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c  >Integer</i> , <
23790 62 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c  b>filePath</b> <
237a0 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c  i>String</i> , <
237b0 62 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49  b>width</b> <i>I
237c0 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e  nteger</i> , <b>
237d0 68 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e  height</b> <i>In
237e0 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62  teger</i> , <b>b
237f0 61 6e 64 49 6e 64 65 78 47 72 61 79 3c 2f 62 3e  andIndexGray</b>
23800 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
23810 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f   , <b>boundingBo
23820 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65  x</b> <i>BLOB-Ge
23830 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e  ometry</i> , <b>
23840 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74  horzPixelResolut
23850 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c  ion</b> <i>Doubl
23860 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50  e</i> , <b>vertP
23870 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
23880 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e  b> <i>Double</i>
23890 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c   ) : <i>Integer<
238a0 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e  /i><br><br>..<b>
238b0 52 4c 32 5f 57 72 69 74 65 53 65 63 74 69 6f 6e  RL2_WriteSection
238c0 4d 6f 6e 6f 42 61 6e 64 54 69 66 66 3c 2f 62 3e  MonoBandTiff</b>
238d0 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f   ( <b>dbPrefix</
238e0 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  b> <i>String</i>
238f0 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61   , <b>coverageNa
23900 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  me</b> <i>String
23910 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f  </i> , <b>sectio
23920 6e 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  nID</b> <i>Integ
23930 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c 65  er</i> , <b>file
23940 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Path</b> <i>Stri
23950 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74  ng</i> , <b>widt
23960 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  h</b> <i>Integer
23970 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74  </i> , <b>height
23980 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
23990 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e 64  /i> , <b>bandInd
239a0 65 78 47 72 61 79 3c 2f 62 3e 20 3c 69 3e 49 6e  exGray</b> <i>In
239b0 74 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62 3e  teger</i>  , <b>
239c0 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20  boundingBox</b> 
239d0 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79  <i>BLOB-Geometry
239e0 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50 69  </i> , <b>horzPi
239f0 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62  xelResolution</b
23a00 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20  > <i>Double</i> 
23a10 2c 20 3c 62 3e 76 65 72 74 50 69 78 65 6c 52 65  , <b>vertPixelRe
23a20 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e  solution</b> <i>
23a30 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e  Double</i> , <b>
23a40 74 69 66 66 43 6f 6d 70 72 65 73 73 69 6f 6e 3c  tiffCompression<
23a50 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
23a60 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72  > ) : <i>Integer
23a70 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62  </i><br><br>..<b
23a80 3e 52 4c 32 5f 57 72 69 74 65 53 65 63 74 69 6f  >RL2_WriteSectio
23a90 6e 4d 6f 6e 6f 42 61 6e 64 54 69 66 66 3c 2f 62  nMonoBandTiff</b
23aa0 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c  > ( <b>dbPrefix<
23ab0 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
23ac0 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e  > , <b>coverageN
23ad0 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ame</b> <i>Strin
23ae0 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69  g</i> , <b>secti
23af0 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  onID</b> <i>Inte
23b00 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 66 69 6c  ger</i> , <b>fil
23b10 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72  ePath</b> <i>Str
23b20 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64  ing</i> , <b>wid
23b30 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  th</b> <i>Intege
23b40 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68  r</i> , <b>heigh
23b50 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  t</b> <i>Integer
23b60 3c 2f 69 3e 20 2c 20 3c 62 3e 62 61 6e 64 49 6e  </i> , <b>bandIn
23b70 64 65 78 47 72 61 79 3c 2f 62 3e 20 3c 69 3e 49  dexGray</b> <i>I
23b80 6e 74 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62  nteger</i>  , <b
23b90 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e  >boundingBox</b>
23ba0 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72   <i>BLOB-Geometr
23bb0 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f 72 7a 50  y</i> , <b>horzP
23bc0 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
23bd0 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e  b> <i>Double</i>
23be0 20 2c 20 3c 62 3e 76 65 72 74 50 69 78 65 6c 52   , <b>vertPixelR
23bf0 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69  esolution</b> <i
23c00 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62  >Double</i> , <b
23c10 3e 74 69 66 66 43 6f 6d 70 72 65 73 73 69 6f 6e  >tiffCompression
23c20 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
23c30 69 3e 20 2c 20 3c 62 3e 74 69 66 66 54 69 6c 65  i> , <b>tiffTile
23c40 53 69 7a 65 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  Size</b> <i>Inte
23c50 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49  ger</i> ) : <i>I
23c60 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d  nteger</i></td>.
23c70 0a 3c 74 64 3e 57 69 6c 6c 20 61 74 74 65 6d 70  .<td>Will attemp
23c80 74 20 74 6f 20 65 78 70 6f 72 74 20 72 61 77 20  t to export raw 
23c90 72 61 73 74 65 72 20 64 61 74 61 20 66 72 6f 6d  raster data from
23ca0 20 61 20 4d 55 4c 54 49 42 41 4e 44 20 6f 72 20   a MULTIBAND or 
23cb0 52 47 42 20 43 6f 76 65 72 61 67 65 20 69 6e 74  RGB Coverage int
23cc0 6f 20 61 6e 20 65 78 74 65 72 6e 61 6c 20 70 6c  o an external pl
23cd0 61 69 6e 20 54 49 46 46 20 66 69 6c 65 20 6f 66  ain TIFF file of
23ce0 20 74 68 65 20 47 72 61 79 73 63 61 6c 65 20 74   the Grayscale t
23cf0 79 70 65 3b 20 6f 6e 6c 79 20 74 68 65 20 54 69  ype; only the Ti
23d00 6c 65 73 20 64 69 72 65 63 74 6c 79 20 62 65 6c  les directly bel
23d10 6f 6e 67 69 6e 67 20 74 6f 20 74 68 65 20 73 65  onging to the se
23d20 6c 65 63 74 65 64 20 53 65 63 74 69 6f 6e 20 77  lected Section w
23d30 69 6c 6c 20 62 65 20 63 6f 6e 73 69 64 65 72 65  ill be considere
23d40 64 2e 3c 62 72 3e 0d 0a 57 69 6c 6c 20 72 65 74  d.<br>..Will ret
23d50 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28 54 52  urn <b>1</b> (TR
23d60 55 45 2f 53 55 43 43 45 53 53 29 20 6f 72 20 3c  UE/SUCCESS) or <
23d70 62 3e 30 3c 2f 62 3e 20 28 46 41 4c 53 45 2f 46  b>0</b> (FALSE/F
23d80 41 49 4c 55 52 45 29 3a 20 6f 72 20 3c 62 3e 2d  AILURE): or <b>-
23d90 31 3c 2f 62 3e 20 6f 6e 20 69 6e 76 61 6c 69 64  1</b> on invalid
23da0 20 61 72 67 75 6d 65 6e 74 73 2e 3c 62 72 3e 0d   arguments.<br>.
23db0 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c  .<u>Please note<
23dc0 2f 75 3e 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69  /u>: ..<ul>..<li
23dd0 3e 54 68 65 20 3c 62 3e 3c 69 3e 64 62 50 72 65  >The <b><i>dbPre
23de0 66 69 78 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67 75  fix</i></b> argu
23df0 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e 64 65 64  ment is intended
23e00 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 20   to specify the 
23e10 41 54 54 41 43 48 45 44 2d 44 42 20 77 68 65 72  ATTACHED-DB wher
23e20 65 20 74 68 65 20 43 6f 76 65 72 61 67 65 20 69  e the Coverage i
23e30 73 20 65 78 70 65 63 74 65 64 20 74 6f 20 62 65  s expected to be
23e40 20 66 6f 75 6e 64 3b 20 69 74 20 63 6f 75 6c 64   found; it could
23e50 20 62 65 20 65 76 65 6e 74 75 61 6c 6c 79 20 3c   be eventually <
23e60 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20  b>NULL</b>, and 
23e70 69 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65  in this case the
23e80 20 3c 62 3e 4d 41 49 4e 20 44 42 3c 2f 62 3e 20   <b>MAIN DB</b> 
23e90 77 69 6c 6c 20 69 6d 70 6c 69 63 69 74 6c 79 20  will implicitly 
23ea0 62 65 20 61 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e  be assumed.</li>
23eb0 0d 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e  ..<li>the <b><i>
23ec0 62 61 6e 64 49 6e 64 65 78 47 72 61 79 3c 2f 69  bandIndexGray</i
23ed0 3e 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 20 69  ></b> argument i
23ee0 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 61 72  s intended to ar
23ef0 62 69 74 72 61 72 69 6c 79 20 63 6f 6d 70 6f 73  bitrarily compos
23f00 65 20 74 68 65 20 47 72 61 79 73 63 61 6c 65 20  e the Grayscale 
23f10 54 49 46 46 20 73 74 61 72 74 69 6e 67 20 66 72  TIFF starting fr
23f20 6f 6d 20 74 68 65 20 42 61 6e 64 73 20 73 75 70  om the Bands sup
23f30 70 6f 72 74 65 64 20 62 79 20 74 68 65 20 43 6f  ported by the Co
23f40 76 65 72 61 67 65 2e 0d 0a 3c 62 72 3e 3c 75 3e  verage...<br><u>
23f50 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a  Please note</u>:
23f60 20 74 68 65 20 66 69 72 73 74 20 42 61 6e 64 20   the first Band 
23f70 61 6c 77 61 79 73 20 63 6f 72 72 65 73 70 6f 6e  always correspon
23f80 64 73 20 74 6f 20 69 6e 64 65 78 20 3c 62 3e 5a  ds to index <b>Z
23f90 45 52 4f 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c  ERO</b></li>..<l
23fa0 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 62 6f 75 6e  i>the <b><i>boun
23fb0 64 69 6e 67 42 6f 78 3c 2f 69 3e 3c 2f 62 3e 20  dingBox</i></b> 
23fc0 69 73 20 65 78 70 65 63 74 65 64 20 74 6f 20 72  is expected to r
23fd0 65 70 72 65 73 65 6e 74 20 74 68 65 20 6f 76 65  epresent the ove
23fe0 72 61 6c 6c 20 65 78 74 65 6e 74 20 6f 66 20 74  rall extent of t
23ff0 68 65 20 65 78 70 6f 72 74 65 64 20 54 49 46 46  he exported TIFF
24000 3b 20 79 6f 75 20 63 6f 75 6c 64 20 65 76 65 6e  ; you could even
24010 74 75 61 6c 6c 79 20 70 61 73 73 20 61 6e 79 20  tually pass any 
24020 61 72 62 69 74 72 61 72 79 20 6b 69 6e 64 20 6f  arbitrary kind o
24030 66 20 47 65 6f 6d 65 74 72 79 2c 20 61 6e 64 20  f Geometry, and 
24040 74 68 65 20 42 6f 75 6e 64 69 6e 67 20 42 6f 78  the Bounding Box
24050 20 61 6b 61 20 4d 42 52 20 77 69 6c 6c 20 62 65   aka MBR will be
24060 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64   automatically d
24070 65 74 65 72 6d 69 6e 65 64 2e 3c 2f 6c 69 3e 0d  etermined.</li>.
24080 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 68  .<li>the <b><i>h
24090 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69  orzPixelResoluti
240a0 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c  on</i></b> and <
240b0 62 3e 3c 69 3e 76 65 72 74 50 69 78 65 6c 52 65  b><i>vertPixelRe
240c0 73 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e  solution</i></b>
240d0 20 6d 75 73 74 20 65 78 61 63 74 6c 79 20 6d 61   must exactly ma
240e0 74 63 68 20 74 68 65 20 43 6f 76 65 72 61 67 65  tch the Coverage
240f0 27 73 20 62 61 73 65 20 72 65 73 6f 6c 75 74 69  's base resoluti
24100 6f 6e 20 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65  on or one of the
24110 20 72 65 73 6f 6c 75 74 69 6f 6e 73 20 6d 61 64   resolutions mad
24120 65 20 61 76 61 69 6c 61 62 6c 65 20 62 79 20 74  e available by t
24130 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67  he corresponding
24140 20 50 79 72 61 6d 69 64 20 6c 65 76 65 6c 73 2e   Pyramid levels.
24150 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 6e 64 20 74  </li>..<li>and t
24160 68 65 20 42 6f 75 6e 64 69 6e 67 42 6f 78 20 6d  he BoundingBox m
24170 75 73 74 20 65 78 61 63 74 6c 79 20 6d 61 74 63  ust exactly matc
24180 68 20 74 68 65 20 54 49 46 46 20 3c 62 3e 3c 69  h the TIFF <b><i
24190 3e 77 69 64 74 68 3c 2f 69 3e 3c 2f 62 3e 20 61  >width</i></b> a
241a0 6e 64 20 3c 62 3e 3c 69 3e 68 65 69 67 68 74 3c  nd <b><i>height<
241b0 2f 69 3e 3c 2f 62 3e 20 64 69 6d 65 6e 73 69 6f  /i></b> dimensio
241c0 6e 73 20 61 74 20 74 68 61 74 20 72 65 73 6f 6c  ns at that resol
241d0 75 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69  ution.</li>..<li
241e0 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72  >the optional ar
241f0 67 75 6d 65 6e 74 20 3c 62 3e 3c 69 3e 74 69 66  gument <b><i>tif
24200 66 43 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 69 3e  fCompression</i>
24210 3c 2f 62 3e 20 63 6f 75 6c 64 20 62 65 20 6f 6e  </b> could be on
24220 65 20 6f 66 20 3c 62 3e 27 4e 4f 4e 45 27 3c 2f  e of <b>'NONE'</
24230 62 3e 2c 20 3c 62 3e 27 44 45 46 4c 41 54 45 27  b>, <b>'DEFLATE'
24240 3c 2f 62 3e 2c 20 3c 62 3e 27 4c 5a 57 27 3c 2f  </b>, <b>'LZW'</
24250 62 3e 2c 20 3c 62 3e 27 4a 50 45 47 27 3c 2f 62  b>, <b>'JPEG'</b
24260 3e 2c 20 3c 62 3e 27 46 41 58 33 27 3c 2f 62 3e  >, <b>'FAX3'</b>
24270 20 6f 72 20 3c 62 3e 27 46 41 58 34 27 3c 2f 62   or <b>'FAX4'</b
24280 3e 3b 20 64 65 66 61 75 6c 74 20 69 73 20 3c 62  >; default is <b
24290 3e 27 4e 4f 4e 45 27 3c 2f 62 3e 2e 3c 2f 6c 69  >'NONE'</b>.</li
242a0 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6c 61 73 74 20  >..<li>the last 
242b0 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e  optional argumen
242c0 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 73 6f  t can be used so
242d0 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 20   to specify the 
242e0 70 72 65 66 65 72 72 65 64 20 54 49 46 46 20 74  preferred TIFF t
242f0 69 6c 65 20 73 69 7a 65 20 28 6f 6e 6c 79 20 73  ile size (only s
24300 71 75 61 72 65 20 74 69 6c 65 73 20 61 72 65 20  quare tiles are 
24310 73 75 70 70 6f 72 74 65 64 29 3b 20 64 65 66 61  supported); defa
24320 75 6c 74 20 69 73 20 3c 62 3e 32 35 36 3c 2f 62  ult is <b>256</b
24330 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a  >.</li>..</ul>..
24340 3c 74 61 62 6c 65 20 77 69 64 74 68 3d 22 31 30  <table width="10
24350 30 25 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66  0%" bgcolor="#ff
24360 64 30 38 30 22 20 63 65 6c 6c 70 61 64 64 69 6e  d080" cellpaddin
24370 67 3d 22 36 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a  g="6"><tr><td>..
24380 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 20 76  <u>Please note v
24390 65 72 79 20 77 65 6c 6c 3c 2f 75 3e 3a 20 74 68  ery well</u>: th
243a0 69 73 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20  is SQL function 
243b0 69 73 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c  is only availabl
243c0 65 20 77 68 65 6e 20 74 68 65 20 65 6e 76 69 72  e when the envir
243d0 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20  onment variable 
243e0 3c 62 3e 53 50 41 54 49 41 4c 49 54 45 5f 53 45  <b>SPATIALITE_SE
243f0 43 55 52 49 54 59 3d 72 65 6c 61 78 65 64 3c 2f  CURITY=relaxed</
24400 62 3e 20 69 73 20 73 65 74 2e 3c 2f 74 64 3e 3c  b> is set.</td><
24410 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e 3c 2f 74 64  /tr></table></td
24420 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74  >..</tr>..<tr><t
24430 64 3e 3c 62 3e 52 4c 32 5f 57 72 69 74 65 53 65  d><b>RL2_WriteSe
24440 63 74 69 6f 6e 41 73 63 69 69 47 72 69 64 3c 2f  ctionAsciiGrid</
24450 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66 69 78  b> ( <b>dbPrefix
24460 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
24470 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65  i> , <b>coverage
24480 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Name</b> <i>Stri
24490 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74  ng</i> , <b>sect
244a0 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74  ionID</b> <i>Int
244b0 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62 3e 66  eger</i>  , <b>f
244c0 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53  ilePath</b> <i>S
244d0 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77  tring</i> , <b>w
244e0 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65  idth</b> <i>Inte
244f0 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69  ger</i> , <b>hei
24500 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67  ght</b> <i>Integ
24510 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e  er</i> , <b>boun
24520 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42  dingBox</b> <i>B
24530 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e  LOB-Geometry</i>
24540 20 2c 20 3c 62 3e 70 69 78 65 6c 52 65 73 6f 6c   , <b>pixelResol
24550 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75  ution</b> <i>Dou
24560 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49  ble</i> ) : <i>I
24570 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62  nteger</i><br><b
24580 72 3e 0d 0a 3c 62 3e 52 4c 32 5f 57 72 69 74 65  r>..<b>RL2_Write
24590 53 65 63 74 69 6f 6e 41 73 63 69 69 47 72 69 64  SectionAsciiGrid
245a0 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66  </b> ( <b>dbPref
245b0 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  ix</b> <i>String
245c0 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61  </i> , <b>covera
245d0 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74  geName</b> <i>St
245e0 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65  ring</i> , <b>se
245f0 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e 49  ctionID</b> <i>I
24600 6e 74 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62  nteger</i>  , <b
24610 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69  >filePath</b> <i
24620 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
24630 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
24640 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
24650 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
24660 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f  eger</i> , <b>bo
24670 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69  undingBox</b> <i
24680 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f  >BLOB-Geometry</
24690 69 3e 20 2c 20 3c 62 3e 70 69 78 65 6c 52 65 73  i> , <b>pixelRes
246a0 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44  olution</b> <i>D
246b0 6f 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 69  ouble</i> , <b>i
246c0 73 50 69 78 65 6c 43 65 6e 74 65 72 65 64 3c 2f  sPixelCentered</
246d0 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
246e0 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72  > ) : <i>Integer
246f0 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62  </i><br><br>..<b
24700 3e 52 4c 32 5f 57 72 69 74 65 53 65 63 74 69 6f  >RL2_WriteSectio
24710 6e 41 73 63 69 69 47 72 69 64 3c 2f 62 3e 20 28  nAsciiGrid</b> (
24720 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e   <b>dbPrefix</b>
24730 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
24740 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65   <b>coverageName
24750 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
24760 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 49  i> , <b>sectionI
24770 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  D</b> <i>Integer
24780 3c 2f 69 3e 20 20 2c 20 3c 62 3e 66 69 6c 65 50  </i>  , <b>fileP
24790 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e  ath</b> <i>Strin
247a0 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68  g</i> , <b>width
247b0 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
247c0 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c  /i> , <b>height<
247d0 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
247e0 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67  i> , <b>bounding
247f0 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d  Box</b> <i>BLOB-
24800 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c  Geometry</i> , <
24810 62 3e 70 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  b>pixelResolutio
24820 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c  n</b> <i>Double<
24830 2f 69 3e 20 2c 20 3c 62 3e 69 73 50 69 78 65 6c  /i> , <b>isPixel
24840 43 65 6e 74 65 72 65 64 3c 2f 62 3e 20 3c 69 3e  Centered</b> <i>
24850 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 0d 0a 3c  Integer</i> ,..<
24860 62 3e 64 65 63 69 6d 61 6c 44 69 67 69 74 73 3c  b>decimalDigits<
24870 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
24880 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65  i> ) : <i>Intege
24890 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e  r</i></td>..<td>
248a0 57 69 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f 20  Will attempt to 
248b0 65 78 70 6f 72 74 20 72 61 77 20 72 61 73 74 65  export raw raste
248c0 72 20 64 61 74 61 20 66 72 6f 6d 20 61 20 44 41  r data from a DA
248d0 54 41 47 52 49 44 20 43 6f 76 65 72 61 67 65 20  TAGRID Coverage 
248e0 69 6e 74 6f 20 61 6e 20 65 78 74 65 72 6e 61 6c  into an external
248f0 20 41 53 43 49 49 20 47 72 69 64 20 66 69 6c 65   ASCII Grid file
24900 3b 20 6f 6e 6c 79 20 74 68 65 20 54 69 6c 65 73  ; only the Tiles
24910 20 64 69 72 65 63 74 6c 79 20 62 65 6c 6f 6e 67   directly belong
24920 69 6e 67 20 74 6f 20 74 68 65 20 73 65 6c 65 63  ing to the selec
24930 74 65 64 20 53 65 63 74 69 6f 6e 20 77 69 6c 6c  ted Section will
24940 20 62 65 20 63 6f 6e 73 69 64 65 72 65 64 2e 3c   be considered.<
24950 62 72 3e 0d 0a 57 69 6c 6c 20 72 65 74 75 72 6e  br>..Will return
24960 20 3c 62 3e 31 3c 2f 62 3e 20 28 54 52 55 45 2f   <b>1</b> (TRUE/
24970 53 55 43 43 45 53 53 29 20 6f 72 20 3c 62 3e 30  SUCCESS) or <b>0
24980 3c 2f 62 3e 20 28 46 41 4c 53 45 2f 46 41 49 4c  </b> (FALSE/FAIL
24990 55 52 45 29 3a 20 6f 72 20 3c 62 3e 2d 31 3c 2f  URE): or <b>-1</
249a0 62 3e 20 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72  b> on invalid ar
249b0 67 75 6d 65 6e 74 73 2e 3c 62 72 3e 0d 0a 3c 75  guments.<br>..<u
249c0 3e 50 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e  >Please note</u>
249d0 3a 20 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54 68  : ..<ul>..<li>Th
249e0 65 20 3c 62 3e 3c 69 3e 64 62 50 72 65 66 69 78  e <b><i>dbPrefix
249f0 3c 2f 69 3e 3c 2f 62 3e 20 61 72 67 75 6d 65 6e  </i></b> argumen
24a00 74 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f  t is intended to
24a10 20 73 70 65 63 69 66 79 20 74 68 65 20 41 54 54   specify the ATT
24a20 41 43 48 45 44 2d 44 42 20 77 68 65 72 65 20 74  ACHED-DB where t
24a30 68 65 20 43 6f 76 65 72 61 67 65 20 69 73 20 65  he Coverage is e
24a40 78 70 65 63 74 65 64 20 74 6f 20 62 65 20 66 6f  xpected to be fo
24a50 75 6e 64 3b 20 69 74 20 63 6f 75 6c 64 20 62 65  und; it could be
24a60 20 65 76 65 6e 74 75 61 6c 6c 79 20 3c 62 3e 4e   eventually <b>N
24a70 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69 6e 20  ULL</b>, and in 
24a80 74 68 69 73 20 63 61 73 65 20 74 68 65 20 3c 62  this case the <b
24a90 3e 4d 41 49 4e 20 44 42 3c 2f 62 3e 20 77 69 6c  >MAIN DB</b> wil
24aa0 6c 20 69 6d 70 6c 69 63 69 74 6c 79 20 62 65 20  l implicitly be 
24ab0 61 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c  assumed.</li>..<
24ac0 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 62 6f 75  li>the <b><i>bou
24ad0 6e 64 69 6e 67 42 6f 78 3c 2f 69 3e 3c 2f 62 3e  ndingBox</i></b>
24ae0 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f 20   is expected to 
24af0 72 65 70 72 65 73 65 6e 74 20 74 68 65 20 6f 76  represent the ov
24b00 65 72 61 6c 6c 20 65 78 74 65 6e 74 20 6f 66 20  erall extent of 
24b10 74 68 65 20 65 78 70 6f 72 74 65 64 20 41 53 43  the exported ASC
24b20 49 49 20 47 72 69 64 3b 20 79 6f 75 20 63 6f 75  II Grid; you cou
24b30 6c 64 20 65 76 65 6e 74 75 61 6c 6c 79 20 70 61  ld eventually pa
24b40 73 73 20 61 6e 79 20 61 72 62 69 74 72 61 72 79  ss any arbitrary
24b50 20 6b 69 6e 64 20 6f 66 20 47 65 6f 6d 65 74 72   kind of Geometr
24b60 79 2c 20 61 6e 64 20 74 68 65 20 42 6f 75 6e 64  y, and the Bound
24b70 69 6e 67 20 42 6f 78 20 61 6b 61 20 4d 42 52 20  ing Box aka MBR 
24b80 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69  will be automati
24b90 63 61 6c 6c 79 20 64 65 74 65 72 6d 69 6e 65 64  cally determined
24ba0 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20  .</li>..<li>the 
24bb0 3c 62 3e 3c 69 3e 70 69 78 65 6c 52 65 73 6f 6c  <b><i>pixelResol
24bc0 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 20 6d  ution</i></b>  m
24bd0 75 73 74 20 65 78 61 63 74 6c 79 20 6d 61 74 63  ust exactly matc
24be0 68 20 74 68 65 20 43 6f 76 65 72 61 67 65 27 73  h the Coverage's
24bf0 20 62 61 73 65 20 72 65 73 6f 6c 75 74 69 6f 6e   base resolution
24c00 20 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65 20 72   or one of the r
24c10 65 73 6f 6c 75 74 69 6f 6e 73 20 6d 61 64 65 20  esolutions made 
24c20 61 76 61 69 6c 61 62 6c 65 20 62 79 20 74 68 65  available by the
24c30 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 50   corresponding P
24c40 79 72 61 6d 69 64 20 6c 65 76 65 6c 73 3b 20 72  yramid levels; r
24c50 65 63 74 61 6e 67 75 6c 61 72 20 70 69 78 65 6c  ectangular pixel
24c60 73 20 61 72 65 6e 27 74 20 73 75 70 70 6f 72 74  s aren't support
24c70 65 64 20 62 79 20 41 53 43 49 49 20 47 72 69 64  ed by ASCII Grid
24c80 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 6e 64  s.</li>..<li>and
24c90 20 74 68 65 20 42 6f 75 6e 64 69 6e 67 42 6f 78   the BoundingBox
24ca0 20 6d 75 73 74 20 65 78 61 63 74 6c 79 20 6d 61   must exactly ma
24cb0 74 63 68 20 74 68 65 20 41 53 43 49 49 20 47 72  tch the ASCII Gr
24cc0 69 64 20 3c 62 3e 3c 69 3e 77 69 64 74 68 3c 2f  id <b><i>width</
24cd0 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69  i></b> and <b><i
24ce0 3e 68 65 69 67 68 74 3c 2f 69 3e 3c 2f 62 3e 20  >height</i></b> 
24cf0 64 69 6d 65 6e 73 69 6f 6e 73 20 61 74 20 74 68  dimensions at th
24d00 61 74 20 72 65 73 6f 6c 75 74 69 6f 6e 2e 3c 2f  at resolution.</
24d10 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74  li>..<li>the opt
24d20 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c  ional argument <
24d30 62 3e 3c 69 3e 69 73 50 69 78 65 6c 43 65 6e 74  b><i>isPixelCent
24d40 65 72 65 64 3c 2f 69 3e 3c 2f 62 3e 20 28 65 78  ered</i></b> (ex
24d50 70 65 63 74 65 64 20 74 6f 20 62 65 20 6f 66 20  pected to be of 
24d60 74 68 65 20 42 6f 6f 6c 65 61 6e 20 74 79 70 65  the Boolean type
24d70 29 20 64 65 74 65 72 6d 69 6e 65 73 20 69 66 20  ) determines if 
24d80 74 68 65 20 41 53 43 49 49 20 47 72 69 64 20 77  the ASCII Grid w
24d90 69 6c 6c 20 64 65 63 6c 61 72 65 20 3c 62 3e 78  ill declare <b>x
24da0 6c 6c 63 65 6e 74 65 72 3c 2f 62 3e 20 61 6e 64  llcenter</b> and
24db0 20 3c 62 3e 79 6c 6c 63 65 6e 74 65 72 3c 2f 62   <b>yllcenter</b
24dc0 3e 20 69 6e 73 74 65 61 64 20 6f 66 20 3c 62 3e  > instead of <b>
24dd0 78 6c 6c 63 6f 72 6e 65 72 3c 2f 62 3e 20 61 6e  xllcorner</b> an
24de0 64 20 3c 62 3e 79 6c 6c 63 6f 6e 65 72 3c 2f 62  d <b>yllconer</b
24df0 3e 20 28 64 65 66 61 75 6c 74 20 69 73 20 54 52  > (default is TR
24e00 55 45 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74  UE).</li>..<li>t
24e10 68 65 20 6c 61 73 74 20 6f 70 74 69 6f 6e 61 6c  he last optional
24e20 20 61 72 67 75 6d 65 6e 74 20 63 61 6e 20 62 65   argument can be
24e30 20 75 73 65 64 20 73 6f 20 74 6f 20 73 70 65 63   used so to spec
24e40 69 66 79 20 68 6f 77 20 6d 61 6e 79 20 64 65 63  ify how many dec
24e50 69 6d 61 6c 20 64 69 67 69 74 73 20 68 61 76 65  imal digits have
24e60 20 74 6f 20 62 65 20 65 78 70 6f 72 74 65 64 20   to be exported 
24e70 69 6e 74 6f 20 74 68 65 20 41 53 43 49 49 20 47  into the ASCII G
24e80 72 69 64 3b 20 64 65 66 61 75 6c 74 20 69 73 20  rid; default is 
24e90 3c 62 3e 34 3c 2f 62 3e 20 64 65 63 69 6d 61 6c  <b>4</b> decimal
24ea0 20 64 69 67 69 74 73 2e 3c 2f 6c 69 3e 0d 0a 3c   digits.</li>..<
24eb0 2f 75 6c 3e 0d 0a 3c 74 61 62 6c 65 20 77 69 64  /ul>..<table wid
24ec0 74 68 3d 22 31 30 30 25 22 20 62 67 63 6f 6c 6f  th="100%" bgcolo
24ed0 72 3d 22 23 66 66 64 30 38 30 22 20 63 65 6c 6c  r="#ffd080" cell
24ee0 70 61 64 64 69 6e 67 3d 22 36 22 3e 3c 74 72 3e  padding="6"><tr>
24ef0 3c 74 64 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20  <td>..<u>Please 
24f00 6e 6f 74 65 20 76 65 72 79 20 77 65 6c 6c 3c 2f  note very well</
24f10 75 3e 3a 20 74 68 69 73 20 53 51 4c 20 66 75 6e  u>: this SQL fun
24f20 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 61 76  ction is only av
24f30 61 69 6c 61 62 6c 65 20 77 68 65 6e 20 74 68 65  ailable when the
24f40 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72   environment var
24f50 69 61 62 6c 65 20 3c 62 3e 53 50 41 54 49 41 4c  iable <b>SPATIAL
24f60 49 54 45 5f 53 45 43 55 52 49 54 59 3d 72 65 6c  ITE_SECURITY=rel
24f70 61 78 65 64 3c 2f 62 3e 20 69 73 20 73 65 74 2e  axed</b> is set.
24f80 3c 2f 74 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c  </td></tr></tabl
24f90 65 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a  e></td>..</tr>..
24fa0 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c  </tr>..<tr><td><
24fb0 62 3e 52 4c 32 5f 57 72 69 74 65 53 65 63 74 69  b>RL2_WriteSecti
24fc0 6f 6e 4a 70 65 67 4a 47 57 3c 2f 62 3e 20 28 20  onJpegJGW</b> ( 
24fd0 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20  <b>dbPrefix</b> 
24fe0 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
24ff0 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c  <b>coverageName<
25000 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
25010 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 49 44  > , <b>sectionID
25020 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
25030 2f 69 3e 20 20 2c 20 3c 62 3e 66 69 6c 65 50 61  /i>  , <b>filePa
25040 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  th</b> <i>String
25050 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c  </i> , <b>width<
25060 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  /b> <i>Integer</
25070 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f  i> , <b>height</
25080 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
25090 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42  > , <b>boundingB
250a0 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47  ox</b> <i>BLOB-G
250b0 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62  eometry</i> , <b
250c0 3e 70 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e  >pixelResolution
250d0 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f  </b> <i>Double</
250e0 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65  i> ) : <i>Intege
250f0 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 3c 62 3e  r</i><br><br><b>
25100 52 4c 32 5f 57 72 69 74 65 53 65 63 74 69 6f 6e  RL2_WriteSection
25110 4a 70 65 67 4a 47 57 3c 2f 62 3e 20 28 20 3c 62  JpegJGW</b> ( <b
25120 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69  >dbPrefix</b> <i
25130 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
25140 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62  >coverageName</b
25150 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
25160 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 49 44 3c 2f  , <b>sectionID</
25170 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
25180 3e 20 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68  >  , <b>filePath
25190 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
251a0 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62  i> , <b>width</b
251b0 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
251c0 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e   , <b>height</b>
251d0 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
251e0 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78  , <b>boundingBox
251f0 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f  </b> <i>BLOB-Geo
25200 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68  metry</i> , <b>h
25210 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69  orzPixelResoluti
25220 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65  on</b> <i>Double
25230 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69  </i> , <b>vertPi
25240 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62  xelResolution</b
25250 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20  > <i>Double</i> 
25260 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  ) : <i>Integer</
25270 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 52  i><br><br>..<b>R
25280 4c 32 5f 57 72 69 74 65 53 65 63 74 69 6f 6e 4a  L2_WriteSectionJ
25290 70 65 67 4a 47 57 3c 2f 62 3e 20 28 20 3c 62 3e  pegJGW</b> ( <b>
252a0 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69 3e  dbPrefix</b> <i>
252b0 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e  String</i> , <b>
252c0 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62 3e  coverageName</b>
252d0 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
252e0 20 3c 62 3e 73 65 63 74 69 6f 6e 49 44 3c 2f 62   <b>sectionID</b
252f0 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
25300 20 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68 3c    , <b>filePath<
25310 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  /b> <i>String</i
25320 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62 3e  > , <b>width</b>
25330 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
25340 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e 20  , <b>height</b> 
25350 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
25360 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78 3c   <b>boundingBox<
25370 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f 6d  /b> <i>BLOB-Geom
25380 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68 6f  etry</i> , <b>ho
25390 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rzPixelResolutio
253a0 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c  n</b> <i>Double<
253b0 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69 78  /i> , <b>vertPix
253c0 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62 3e  elResolution</b>
253d0 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20 2c   <i>Double</i> ,
253e0 20 3c 62 3e 71 75 61 6c 69 74 79 3c 2f 62 3e 20   <b>quality</b> 
253f0 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29  <i>Integer</i> )
25400 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69   : <i>Integer</i
25410 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c  ></td>..<td>Will
25420 20 61 74 74 65 6d 70 74 20 74 6f 20 65 78 70 6f   attempt to expo
25430 72 74 20 72 61 77 20 72 61 73 74 65 72 20 64 61  rt raw raster da
25440 74 61 20 66 72 6f 6d 20 61 20 47 52 41 59 53 43  ta from a GRAYSC
25450 41 4c 45 20 55 49 4e 54 38 20 6f 72 20 52 47 42  ALE UINT8 or RGB
25460 20 55 49 4e 54 38 20 43 6f 76 65 72 61 67 65 20   UINT8 Coverage 
25470 69 6e 74 6f 20 61 6e 20 65 78 74 65 72 6e 61 6c  into an external
25480 20 4a 50 45 47 20 66 69 6c 65 20 73 75 70 70 6f   JPEG file suppo
25490 72 74 65 64 20 62 79 20 61 6e 20 61 75 78 69 6c  rted by an auxil
254a0 69 61 72 79 20 57 6f 72 6c 64 46 69 6c 65 3b 20  iary WorldFile; 
254b0 6f 6e 6c 79 20 74 68 65 20 54 69 6c 65 73 20 64  only the Tiles d
254c0 69 72 65 63 74 6c 79 20 62 65 6c 6f 6e 67 69 6e  irectly belongin
254d0 67 20 74 6f 20 74 68 65 20 73 65 6c 65 63 74 65  g to the selecte
254e0 64 20 53 65 63 74 69 6f 6e 20 77 69 6c 6c 20 62  d Section will b
254f0 65 20 63 6f 6e 73 69 64 65 72 65 64 2e 3c 62 72  e considered.<br
25500 3e 0d 0a 57 69 6c 6c 20 72 65 74 75 72 6e 20 3c  >..Will return <
25510 62 3e 31 3c 2f 62 3e 20 28 54 52 55 45 2f 53 55  b>1</b> (TRUE/SU
25520 43 43 45 53 53 29 20 6f 72 20 3c 62 3e 30 3c 2f  CCESS) or <b>0</
25530 62 3e 20 28 46 41 4c 53 45 2f 46 41 49 4c 55 52  b> (FALSE/FAILUR
25540 45 29 3a 20 6f 72 20 3c 62 3e 2d 31 3c 2f 62 3e  E): or <b>-1</b>
25550 20 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75   on invalid argu
25560 6d 65 6e 74 73 2e 3c 62 72 3e 0d 0a 3c 75 3e 50  ments.<br>..<u>P
25570 6c 65 61 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20  lease note</u>: 
25580 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 20  ..<ul>..<li>The 
25590 3c 62 3e 3c 69 3e 64 62 50 72 65 66 69 78 3c 2f  <b><i>dbPrefix</
255a0 69 3e 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 20  i></b> argument 
255b0 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 73  is intended to s
255c0 70 65 63 69 66 79 20 74 68 65 20 41 54 54 41 43  pecify the ATTAC
255d0 48 45 44 2d 44 42 20 77 68 65 72 65 20 74 68 65  HED-DB where the
255e0 20 43 6f 76 65 72 61 67 65 20 69 73 20 65 78 70   Coverage is exp
255f0 65 63 74 65 64 20 74 6f 20 62 65 20 66 6f 75 6e  ected to be foun
25600 64 3b 20 69 74 20 63 6f 75 6c 64 20 62 65 20 65  d; it could be e
25610 76 65 6e 74 75 61 6c 6c 79 20 3c 62 3e 4e 55 4c  ventually <b>NUL
25620 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69 6e 20 74 68  L</b>, and in th
25630 69 73 20 63 61 73 65 20 74 68 65 20 3c 62 3e 4d  is case the <b>M
25640 41 49 4e 20 44 42 3c 2f 62 3e 20 77 69 6c 6c 20  AIN DB</b> will 
25650 69 6d 70 6c 69 63 69 74 6c 79 20 62 65 20 61 73  implicitly be as
25660 73 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69  sumed.</li>..<li
25670 3e 74 68 65 20 3c 62 3e 3c 69 3e 62 6f 75 6e 64  >the <b><i>bound
25680 69 6e 67 42 6f 78 3c 2f 69 3e 3c 2f 62 3e 20 69  ingBox</i></b> i
25690 73 20 65 78 70 65 63 74 65 64 20 74 6f 20 72 65  s expected to re
256a0 70 72 65 73 65 6e 74 20 74 68 65 20 6f 76 65 72  present the over
256b0 61 6c 6c 20 65 78 74 65 6e 74 20 6f 66 20 74 68  all extent of th
256c0 65 20 65 78 70 6f 72 74 65 64 20 4a 50 45 47 3b  e exported JPEG;
256d0 20 79 6f 75 20 63 6f 75 6c 64 20 65 76 65 6e 74   you could event
256e0 75 61 6c 6c 79 20 70 61 73 73 20 61 6e 79 20 61  ually pass any a
256f0 72 62 69 74 72 61 72 79 20 6b 69 6e 64 20 6f 66  rbitrary kind of
25700 20 47 65 6f 6d 65 74 72 79 2c 20 61 6e 64 20 74   Geometry, and t
25710 68 65 20 42 6f 75 6e 64 69 6e 67 20 42 6f 78 20  he Bounding Box 
25720 61 6b 61 20 4d 42 52 20 77 69 6c 6c 20 62 65 20  aka MBR will be 
25730 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65  automatically de
25740 74 65 72 6d 69 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a  termined.</li>..
25750 3c 6c 69 3e 74 68 65 20 3c 62 3e 3c 69 3e 68 6f  <li>the <b><i>ho
25760 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rzPixelResolutio
25770 6e 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62  n</i></b> and <b
25780 3e 3c 69 3e 76 65 72 74 50 69 78 65 6c 52 65 73  ><i>vertPixelRes
25790 6f 6c 75 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20  olution</i></b> 
257a0 6d 75 73 74 20 65 78 61 63 74 6c 79 20 6d 61 74  must exactly mat
257b0 63 68 20 74 68 65 20 43 6f 76 65 72 61 67 65 27  ch the Coverage'
257c0 73 20 62 61 73 65 20 72 65 73 6f 6c 75 74 69 6f  s base resolutio
257d0 6e 20 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65 20  n or one of the 
257e0 72 65 73 6f 6c 75 74 69 6f 6e 73 20 6d 61 64 65  resolutions made
257f0 20 61 76 61 69 6c 61 62 6c 65 20 62 79 20 74 68   available by th
25800 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20  e corresponding 
25810 50 79 72 61 6d 69 64 20 6c 65 76 65 6c 73 2e 3c  Pyramid levels.<
25820 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 6e 64 20 74 68  /li>..<li>and th
25830 65 20 42 6f 75 6e 64 69 6e 67 42 6f 78 20 6d 75  e BoundingBox mu
25840 73 74 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68  st exactly match
25850 20 74 68 65 20 4a 50 45 47 20 3c 62 3e 3c 69 3e   the JPEG <b><i>
25860 77 69 64 74 68 3c 2f 69 3e 3c 2f 62 3e 20 61 6e  width</i></b> an
25870 64 20 3c 62 3e 3c 69 3e 68 65 69 67 68 74 3c 2f  d <b><i>height</
25880 69 3e 3c 2f 62 3e 20 64 69 6d 65 6e 73 69 6f 6e  i></b> dimension
25890 73 20 61 74 20 74 68 61 74 20 72 65 73 6f 6c 75  s at that resolu
258a0 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  tion.</li>..<li>
258b0 74 68 65 20 6c 61 73 74 20 6f 70 74 69 6f 6e 61  the last optiona
258c0 6c 20 61 72 67 75 6d 65 6e 74 20 63 61 6e 20 62  l argument can b
258d0 65 20 75 73 65 64 20 73 6f 20 74 6f 20 73 70 65  e used so to spe
258e0 63 69 66 79 20 74 68 65 20 70 72 65 66 65 72 72  cify the preferr
258f0 65 64 20 4a 50 45 47 20 3c 62 3e 3c 69 3e 71 75  ed JPEG <b><i>qu
25900 61 6c 69 74 79 3c 2f 69 3e 3c 2f 62 3e 20 28 69  ality</i></b> (i
25910 6e 20 74 68 65 20 72 61 6e 67 65 20 3c 62 3e 30  n the range <b>0
25920 3c 2f 62 3e 20 2d 20 3c 62 3e 31 30 30 3c 2f 62  </b> - <b>100</b
25930 3e 29 3b 20 64 65 66 61 75 6c 74 20 69 73 20 3c  >); default is <
25940 62 3e 38 30 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a  b>80</b>.</li>..
25950 3c 2f 75 6c 3e 0d 0a 3c 74 61 62 6c 65 20 77 69  </ul>..<table wi
25960 64 74 68 3d 22 31 30 30 25 22 20 62 67 63 6f 6c  dth="100%" bgcol
25970 6f 72 3d 22 23 66 66 64 30 38 30 22 20 63 65 6c  or="#ffd080" cel
25980 6c 70 61 64 64 69 6e 67 3d 22 36 22 3e 3c 74 72  lpadding="6"><tr
25990 3e 3c 74 64 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65  ><td>..<u>Please
259a0 20 6e 6f 74 65 20 76 65 72 79 20 77 65 6c 6c 3c   note very well<
259b0 2f 75 3e 3a 20 74 68 69 73 20 53 51 4c 20 66 75  /u>: this SQL fu
259c0 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 61  nction is only a
259d0 76 61 69 6c 61 62 6c 65 20 77 68 65 6e 20 74 68  vailable when th
259e0 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61  e environment va
259f0 72 69 61 62 6c 65 20 3c 62 3e 53 50 41 54 49 41  riable <b>SPATIA
25a00 4c 49 54 45 5f 53 45 43 55 52 49 54 59 3d 72 65  LITE_SECURITY=re
25a10 6c 61 78 65 64 3c 2f 62 3e 20 69 73 20 73 65 74  laxed</b> is set
25a20 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62  .</td></tr></tab
25a30 6c 65 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d  le></td>..</tr>.
25a40 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 52 4c 32 5f  .<tr><td><b>RL2_
25a50 57 72 69 74 65 53 65 63 74 69 6f 6e 4a 70 65 67  WriteSectionJpeg
25a60 3c 2f 62 3e 20 28 20 3c 62 3e 64 62 50 72 65 66  </b> ( <b>dbPref
25a70 69 78 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67  ix</b> <i>String
25a80 3c 2f 69 3e 20 2c 20 3c 62 3e 63 6f 76 65 72 61  </i> , <b>covera
25a90 67 65 4e 61 6d 65 3c 2f 62 3e 20 3c 69 3e 53 74  geName</b> <i>St
25aa0 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 73 65  ring</i> , <b>se
25ab0 63 74 69 6f 6e 49 44 3c 2f 62 3e 20 3c 69 3e 49  ctionID</b> <i>I
25ac0 6e 74 65 67 65 72 3c 2f 69 3e 20 20 2c 20 3c 62  nteger</i>  , <b
25ad0 3e 66 69 6c 65 50 61 74 68 3c 2f 62 3e 20 3c 69  >filePath</b> <i
25ae0 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
25af0 3e 77 69 64 74 68 3c 2f 62 3e 20 3c 69 3e 49 6e  >width</b> <i>In
25b00 74 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 68  teger</i> , <b>h
25b10 65 69 67 68 74 3c 2f 62 3e 20 3c 69 3e 49 6e 74  eight</b> <i>Int
25b20 65 67 65 72 3c 2f 69 3e 20 2c 20 3c 62 3e 62 6f  eger</i> , <b>bo
25b30 75 6e 64 69 6e 67 42 6f 78 3c 2f 62 3e 20 3c 69  undingBox</b> <i
25b40 3e 42 4c 4f 42 2d 47 65 6f 6d 65 74 72 79 3c 2f  >BLOB-Geometry</
25b50 69 3e 20 2c 20 3c 62 3e 70 69 78 65 6c 52 65 73  i> , <b>pixelRes
25b60 6f 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44  olution</b> <i>D
25b70 6f 75 62 6c 65 3c 2f 69 3e 20 29 20 3a 20 3c 69  ouble</i> ) : <i
25b80 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 62 72 3e  >Integer</i><br>
25b90 3c 62 72 3e 3c 62 3e 52 4c 32 5f 57 72 69 74 65  <br><b>RL2_Write
25ba0 53 65 63 74 69 6f 6e 4a 70 65 67 3c 2f 62 3e 20  SectionJpeg</b> 
25bb0 28 20 3c 62 3e 64 62 50 72 65 66 69 78 3c 2f 62  ( <b>dbPrefix</b
25bc0 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
25bd0 2c 20 3c 62 3e 63 6f 76 65 72 61 67 65 4e 61 6d  , <b>coverageNam
25be0 65 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c  e</b> <i>String<
25bf0 2f 69 3e 20 2c 20 3c 62 3e 73 65 63 74 69 6f 6e  /i> , <b>section
25c00 49 44 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65  ID</b> <i>Intege
25c10 72 3c 2f 69 3e 20 20 2c 20 3c 62 3e 66 69 6c 65  r</i>  , <b>file
25c20 50 61 74 68 3c 2f 62 3e 20 3c 69 3e 53 74 72 69  Path</b> <i>Stri
25c30 6e 67 3c 2f 69 3e 20 2c 20 3c 62 3e 77 69 64 74  ng</i> , <b>widt
25c40 68 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72  h</b> <i>Integer
25c50 3c 2f 69 3e 20 2c 20 3c 62 3e 68 65 69 67 68 74  </i> , <b>height
25c60 3c 2f 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c  </b> <i>Integer<
25c70 2f 69 3e 20 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e  /i> , <b>boundin
25c80 67 42 6f 78 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42  gBox</b> <i>BLOB
25c90 2d 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20  -Geometry</i> , 
25ca0 3c 62 3e 68 6f 72 7a 50 69 78 65 6c 52 65 73 6f  <b>horzPixelReso
25cb0 6c 75 74 69 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f  lution</b> <i>Do
25cc0 75 62 6c 65 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65  uble</i> , <b>ve
25cd0 72 74 50 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f  rtPixelResolutio
25ce0 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c  n</b> <i>Double<
25cf0 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67  /i> ) : <i>Integ
25d00 65 72 3c 2f 69 3e 3c 62 72 3e 3c 62 72 3e 0d 0a  er</i><br><br>..
25d10 3c 62 3e 52 4c 32 5f 57 72 69 74 65 53 65 63 74  <b>RL2_WriteSect
25d20 69 6f 6e 4a 70 65 67 3c 2f 62 3e 20 28 20 3c 62  ionJpeg</b> ( <b
25d30 3e 64 62 50 72 65 66 69 78 3c 2f 62 3e 20 3c 69  >dbPrefix</b> <i
25d40 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 3c 62  >String</i> , <b
25d50 3e 63 6f 76 65 72 61 67 65 4e 61 6d 65 3c 2f 62  >coverageName</b
25d60 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  > <i>String</i> 
25d70 2c 20 3c 62 3e 73 65 63 74 69 6f 6e 49 44 3c 2f  , <b>sectionID</
25d80 62 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  b> <i>Integer</i
25d90 3e 20 20 2c 20 3c 62 3e 66 69 6c 65 50 61 74 68  >  , <b>filePath
25da0 3c 2f 62 3e 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  </b> <i>String</
25db0 69 3e 20 2c 20 3c 62 3e 77 69 64 74 68 3c 2f 62  i> , <b>width</b
25dc0 3e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  > <i>Integer</i>
25dd0 20 2c 20 3c 62 3e 68 65 69 67 68 74 3c 2f 62 3e   , <b>height</b>
25de0 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
25df0 2c 20 3c 62 3e 62 6f 75 6e 64 69 6e 67 42 6f 78  , <b>boundingBox
25e00 3c 2f 62 3e 20 3c 69 3e 42 4c 4f 42 2d 47 65 6f  </b> <i>BLOB-Geo
25e10 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 3c 62 3e 68  metry</i> , <b>h
25e20 6f 72 7a 50 69 78 65 6c 52 65 73 6f 6c 75 74 69  orzPixelResoluti
25e30 6f 6e 3c 2f 62 3e 20 3c 69 3e 44 6f 75 62 6c 65  on</b> <i>Double
25e40 3c 2f 69 3e 20 2c 20 3c 62 3e 76 65 72 74 50 69  </i> , <b>vertPi
25e50 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f 62  xelResolution</b
25e60 3e 20 3c 69 3e 44 6f 75 62 6c 65 3c 2f 69 3e 20  > <i>Double</i> 
25e70 2c 20 3c 62 3e 71 75 61 6c 69 74 79 3c 2f 62 3e  , <b>quality</b>
25e80 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20   <i>Integer</i> 
25e90 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f  ) : <i>Integer</
25ea0 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c  i></td>..<td>Wil
25eb0 6c 20 61 74 74 65 6d 70 74 20 74 6f 20 65 78 70  l attempt to exp
25ec0 6f 72 74 20 72 61 77 20 72 61 73 74 65 72 20 64  ort raw raster d
25ed0 61 74 61 20 66 72 6f 6d 20 61 20 47 52 41 59 53  ata from a GRAYS
25ee0 43 41 4c 45 20 55 49 4e 54 38 20 6f 72 20 52 47  CALE UINT8 or RG
25ef0 42 20 55 49 4e 54 38 20 43 6f 76 65 72 61 67 65  B UINT8 Coverage
25f00 20 69 6e 74 6f 20 61 6e 20 65 78 74 65 72 6e 61   into an externa
25f10 6c 20 4a 50 45 47 20 66 69 6c 65 3b 20 6f 6e 6c  l JPEG file; onl
25f20 79 20 74 68 65 20 54 69 6c 65 73 20 64 69 72 65  y the Tiles dire
25f30 63 74 6c 79 20 62 65 6c 6f 6e 67 69 6e 67 20 74  ctly belonging t
25f40 6f 20 74 68 65 20 73 65 6c 65 63 74 65 64 20 53  o the selected S
25f50 65 63 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20 63  ection will be c
25f60 6f 6e 73 69 64 65 72 65 64 2e 3c 62 72 3e 0d 0a  onsidered.<br>..
25f70 57 69 6c 6c 20 72 65 74 75 72 6e 20 3c 62 3e 31  Will return <b>1
25f80 3c 2f 62 3e 20 28 54 52 55 45 2f 53 55 43 43 45  </b> (TRUE/SUCCE
25f90 53 53 29 20 6f 72 20 3c 62 3e 30 3c 2f 62 3e 20  SS) or <b>0</b> 
25fa0 28 46 41 4c 53 45 2f 46 41 49 4c 55 52 45 29 3a  (FALSE/FAILURE):
25fb0 20 6f 72 20 3c 62 3e 2d 31 3c 2f 62 3e 20 6f 6e   or <b>-1</b> on
25fc0 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e   invalid argumen
25fd0 74 73 2e 3c 62 72 3e 0d 0a 3c 75 3e 50 6c 65 61  ts.<br>..<u>Plea
25fe0 73 65 20 6e 6f 74 65 3c 2f 75 3e 3a 20 0d 0a 3c  se note</u>: ..<
25ff0 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 20 3c 62 3e  ul>..<li>The <b>
26000 3c 69 3e 64 62 50 72 65 66 69 78 3c 2f 69 3e 3c  <i>dbPrefix</i><
26010 2f 62 3e 20 61 72 67 75 6d 65 6e 74 20 69 73 20  /b> argument is 
26020 69 6e 74 65 6e 64 65 64 20 74 6f 20 73 70 65 63  intended to spec
26030 69 66 79 20 74 68 65 20 41 54 54 41 43 48 45 44  ify the ATTACHED
26040 2d 44 42 20 77 68 65 72 65 20 74 68 65 20 43 6f  -DB where the Co
26050 76 65 72 61 67 65 20 69 73 20 65 78 70 65 63 74  verage is expect
26060 65 64 20 74 6f 20 62 65 20 66 6f 75 6e 64 3b 20  ed to be found; 
26070 69 74 20 63 6f 75 6c 64 20 62 65 20 65 76 65 6e  it could be even
26080 74 75 61 6c 6c 79 20 3c 62 3e 4e 55 4c 4c 3c 2f  tually <b>NULL</
26090 62 3e 2c 20 61 6e 64 20 69 6e 20 74 68 69 73 20  b>, and in this 
260a0 63 61 73 65 20 74 68 65 20 3c 62 3e 4d 41 49 4e  case the <b>MAIN
260b0 20 44 42 3c 2f 62 3e 20 77 69 6c 6c 20 69 6d 70   DB</b> will imp
260c0 6c 69 63 69 74 6c 79 20 62 65 20 61 73 73 75 6d  licitly be assum
260d0 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68  ed.</li>..<li>th
260e0 65 20 3c 62 3e 3c 69 3e 62 6f 75 6e 64 69 6e 67  e <b><i>bounding
260f0 42 6f 78 3c 2f 69 3e 3c 2f 62 3e 20 69 73 20 65  Box</i></b> is e
26100 78 70 65 63 74 65 64 20 74 6f 20 72 65 70 72 65  xpected to repre
26110 73 65 6e 74 20 74 68 65 20 6f 76 65 72 61 6c 6c  sent the overall
26120 20 65 78 74 65 6e 74 20 6f 66 20 74 68 65 20 65   extent of the e
26130 78 70 6f 72 74 65 64 20 4a 50 45 47 3b 20 79 6f  xported JPEG; yo
26140 75 20 63 6f 75 6c 64 20 65 76 65 6e 74 75 61 6c  u could eventual
26150 6c 79 20 70 61 73 73 20 61 6e 79 20 61 72 62 69  ly pass any arbi
26160 74 72 61 72 79 20 6b 69 6e 64 20 6f 66 20 47 65  trary kind of Ge
26170 6f 6d 65 74 72 79 2c 20 61 6e 64 20 74 68 65 20  ometry, and the 
26180 42 6f 75 6e 64 69 6e 67 20 42 6f 78 20 61 6b 61  Bounding Box aka
26190 20 4d 42 52 20 77 69 6c 6c 20 62 65 20 61 75 74   MBR will be aut
261a0 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 74 65 72  omatically deter
261b0 6d 69 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69  mined.</li>..<li
261c0 3e 74 68 65 20 3c 62 3e 3c 69 3e 68 6f 72 7a 50  >the <b><i>horzP
261d0 69 78 65 6c 52 65 73 6f 6c 75 74 69 6f 6e 3c 2f  ixelResolution</
261e0 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 3c 69  i></b> and <b><i
261f0 3e 76 65 72 74 50 69 78 65 6c 52 65 73 6f 6c 75  >vertPixelResolu
26200 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 6d 75 73  tion</i></b> mus
26210 74 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68 20  t exactly match 
26220 74 68 65 20 43 6f 76 65 72 61 67 65 27 73 20 62  the Coverage's b
26230 61 73 65 20 72 65 73 6f 6c 75 74 69 6f 6e 20 6f  ase resolution o
26240 72 20 6f 6e 65 20 6f 66 20 74 68 65 20 72 65 73  r one of the res
26250 6f 6c 75 74 69 6f 6e 73 20 6d 61 64 65 20 61 76  olutions made av
26260 61 69 6c 61 62 6c 65 20 62 79 20 74 68 65 20 63  ailable by the c
26270 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 50 79 72  orresponding Pyr
26280 61 6d 69 64 20 6c 65 76 65 6c 73 2e 3c 2f 6c 69  amid levels.</li
26290 3e 0d 0a 3c 6c 69 3e 61 6e 64 20 74 68 65 20 42  >..<li>and the B
262a0 6f 75 6e 64 69 6e 67 42 6f 78 20 6d 75 73 74 20  oundingBox must 
262b0 65 78 61 63 74 6c 79 20 6d 61 74 63 68 20 74 68  exactly match th
262c0 65 20 4a 50 45 47 20 3c 62 3e 3c 69 3e 77 69 64  e JPEG <b><i>wid
262d0 74 68 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c  th</i></b> and <
262e0 62 3e 3c 69 3e 68 65 69 67 68 74 3c 2f 69 3e 3c  b><i>height</i><
262f0 2f 62 3e 20 64 69 6d 65 6e 73 69 6f 6e 73 20 61  /b> dimensions a
26300 74 20 74 68 61 74 20 72 65 73 6f 6c 75 74 69 6f  t that resolutio
26310 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65  n.</li>..<li>the
26320 20 6c 61 73 74 20 6f 70 74 69 6f 6e 61 6c 20 61   last optional a
26330 72 67 75 6d 65 6e 74 20 63 61 6e 20 62 65 20 75  rgument can be u
26340 73 65 64 20 73 6f 20 74 6f 20 73 70 65 63 69 66  sed so to specif
26350 79 20 74 68 65 20 70 72 65 66 65 72 72 65 64 20  y the preferred 
26360 4a 50 45 47 20 3c 62 3e 3c 69 3e 71 75 61 6c 69  JPEG <b><i>quali
26370 74 79 3c 2f 69 3e 3c 2f 62 3e 20 28 69 6e 20 74  ty</i></b> (in t
26380 68 65 20 72 61 6e 67 65 20 3c 62 3e 30 3c 2f 62  he range <b>0</b
26390 3e 20 2d 20 3c 62 3e 31 30 30 3c 2f 62 3e 29 3b  > - <b>100</b>);
263a0 20 64 65 66 61 75 6c 74 20 69 73 20 3c 62 3e 38   default is <b>8
263b0 30 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75  0</b>.</li>..</u
263c0 6c 3e 0d 0a 3c 74 61 62 6c 65 20 77 69 64 74 68  l>..<table width
263d0 3d 22 31 30 30 25 22 20 62 67 63 6f 6c 6f 72 3d  ="100%" bgcolor=
263e0 22 23 66 66 64 30 38 30 22 20 63 65 6c 6c 70 61  "#ffd080" cellpa
263f0 64 64 69 6e 67 3d 22 36 22 3e 3c 74 72 3e 3c 74  dding="6"><tr><t
26400 64 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f  d>..<u>Please no
26410 74 65 20 76 65 72 79 20 77 65 6c 6c 3c 2f 75 3e  te very well</u>
26420 3a 20 74 68 69 73 20 53 51 4c 20 66 75 6e 63 74  : this SQL funct
26430 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 61 76 61 69  ion is only avai
26440 6c 61 62 6c 65 20 77 68 65 6e 20 74 68 65 20 65  lable when the e
26450 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61  nvironment varia
26460 62 6c 65 20 3c 62 3e 53 50 41 54 49 41 4c 49 54  ble <b>SPATIALIT
26470 45 5f 53 45 43 55 52 49 54 59 3d 72 65 6c 61 78  E_SECURITY=relax
26480 65 64 3c 2f 62 3e 20 69 73 20 73 65 74 2e 3c 2f  ed</b> is set.</
26490 74 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e  td></tr></table>
264a0 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 2f  </td>..</tr>..</
264b0 74 61 62 6c 65 3e 0d 0a 3c 62 72 3e 3c 62 72 3e  table>..<br><br>
264c0 3c 68 72 3e 0d 0a 42 61 63 6b 20 74 6f 20 3c 61  <hr>..Back to <a
264d0 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f 77   href="https://w
264e0 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f 66  ww.gaia-gis.it/f
264f0 6f 73 73 69 6c 2f 6c 69 62 72 61 73 74 65 72 6c  ossil/librasterl
26500 69 74 65 32 2f 77 69 6b 69 3f 6e 61 6d 65 3d 72  ite2/wiki?name=r
26510 61 73 74 65 72 6c 69 74 65 32 2d 64 6f 63 22 3e  asterlite2-doc">
26520 52 61 73 74 65 72 4c 69 74 65 32 20 64 6f 63 20  RasterLite2 doc 
26530 69 6e 64 65 78 3c 2f 61 3e 0a 5a 20 39 32 33 33  index</a>.Z 9233
26540 66 39 34 64 35 37 35 65 36 61 33 37 62 38 65 39  f94d575e6a37b8e9
26550 64 36 36 63 61 61 65 33 31 65 37 36 0a           d66caae31e76.