CREAMMS: Preparació de capes per a la seva publicació amb el servidor de mapes

Aquest programa serveix per preparar una capa de punts per a ser visualitzada com a un nivell de zoom raster en el servidor de mapes de MiraMon.
La opció 2 serveix per a preparar un nivell de zoom per a la visualització sobre el navegador. Donat que els zoom prepreparats són més ràpids que els interpolats directament pel programa, caldrà preparar tots els nivells de zoom que sigui més probable que el navegador ofereix-hi. Generalment es preparen els nivells de zoom múltiples de 1, 2 i 5. La preparació d'un nivell de zoom genera una carpeta amb un conjunt de fitxers JPEG, IMG o GIF. Com que el format JPEG és un format amb degradació, el programa decideix generar IMG's quan el fitxer d'entrada és vectorial (o per tant temàtic) o quan el fitxer ràster va acompanyat d'una paleta. Quan desitgem preparar un nivell de zoom per una ortofoto de 8 bits (amb paleta), caldrà especificar /FORMAT=JPEG per millorar el comportament per defecte. En el cas d'un ràster IMG sense paleta o d'una combinació RGB, el programa decideix generar JPEG de grisos i de color respectivament.

En la opció 1 tots els gif's han de compartir la mateixa paleta per evitar canvis de color.

Sintaxi:
CreaMMS 1 Directori FitxerLST costat FitxerPNT
CreaMMS 2 Directori FitxerLST ncol nfil Fitxer [NomPaleta]
CreaMMS 2 Directori FitxerLST ncol nfil FitxerIMG
CreaMMS 2 Directori FitxerLST ncol nfil FitxerR FitxerG FitxerB
CreaMMS 3 FitxerIMGSortida costat exageracio FitxerTop

Opció 1: Prepara una capa de punts per ser visualitzada.
- Directori: Directori on es crearan tots fitxers que formen el nivell de zoom generat.
- FitxerLST: Fitxer s'escriurà la llista de noms de fitxer que formen el nivell de zoom generat. Generalment cal col·locar-lo al directori anterior.
- costat: És la mida de píxel del ràster del nivell de zoom que estem generant.
- FitxerPNT: Fitxer PNT origen a preparar com a un nivell de zoom del mms.
- /TRACTAMENT=S per punts com a símbols (icones GIF). Per defecte val S.
  - /VALOR_CONSTANT= Nom del fitxer del símbol GIF per a representar tots els punts. No useu junt amb /CAMP.
  - /CAMP= Camp de la base de dades a l'estil BD4. No useu junt amb /VALOR_CONSTANT. Per saber més sobre els valors d'aquests paràmetres seguiu les consideracions del document de sintaxi general.
  - /TAULA_SIMBOLS= És el nom del fitxer dbf que fa de taula de simbolització on hi ha el camp clau d'enllaç, els nom de fitxer símbol GIF/PNG per a representar cada punt i una eventual descripció (no usada per aquest programa) . No useu junt amb /VALOR_CONSTANT.
- /TRACTAMENT=T per punts com a textos.
  - /CAMP_TEXT_MOSTRAR= Camp la base de dades a l'estil BD4 que conté els textos que volem mostrar, els textos que apareixeran en cada punt de la capa.
  - /VALOR_CONSTANT= Format de la font en que es representaran tots els textos rasteritzats. No useu junt amb /CAMP.
  - /CAMP= Camp de la base de dades a l'estil BD4 que indica el format de la font per a cada valor de text rasteritzat. No useu junt amb /VALOR_CONSTANT. Per saber més sobre els valors d'aquests paràmetres seguiu les consideracions del document de sintaxi general.
  - /TAULA_SIMBOLS= És el nom del fitxer dbf que fa de taula de simbolització de textos on hi ha el camp que enllaça amb el camp indicat anteriorment i el format de la font per cada un dels valors del camp. No useu junt amb /VALOR_CONSTANT.
Opció 2: Prepara una capa ràster temàtica, continua o un vector per a ser visualitzada. En qualsevol d'aquesta casos, la capa pot estar formada per una llista de fitxers.
- Directori: Directori on es crearan tots fitxers que formen el nivell de zoom generat.
- FitxerLST: Fitxer on escric la llista de noms de fitxer que formen el nivell de zoom generat. General cal col·locar-lo al directori anterior.
- ncol: Nombre de columnes de cada tessel·la generada. Generalment s'usa el valor 800.
- nfil: Nombre de files de cada tessel·la generada. Generalment s'usa el valor 800 (o 48000 quan el format és JPEG indexat).
- Alguns paràmetres depenen del tipus de capa o llista de capes d'origen.
  - Origen ràster
    - /CANVI_COSTAT= És el factor sencer de expansió/contracció de les imatges. Segueix els criteris de CanviRes. En aquest context només té sentit un valor negatiu. El valor per defecte és no aplicar cap expansió/contracció i respectar la mida cel·la original. El programa aplica un criteri de mitjana per imatges RGB o grisos o una moda en per a les imatges amb paleta.
      - /CRITERI_INTERPOL Fa servir la mateixa sintaxi del programa CanviRes. Se suporta 'C' per valor central, 'm' per mitjana, 'M' per moda i 'd' per mediana. El programa pren el criteri de mitjana per imatges RGB i moda per imatges amb paleta. Quan les imatges amb paleta representen objectes lineals, el criteri de moda és poc adient donat que genera línies trencades; tampoc ho es per imatges de variaciò continua amb paleta. Aquest paràmetre permet imposar un criteri de mitjana en aquests casos o usar la mediana que dona millors interpolacions quan el canvi de costat és gran. Remplaça el paràmetre /IMPOSA_CANVIRES_MITJANA que desapareix.
    - La feina de lectura d'imatges originals necessària per a un canvi de píxel superior a 5 és prou alta per a justificar de guardar els resultats intermedis per reaprofitar-los en la generació de canvis de costat encara més grans. El programa decideix guardar els resultats intermedis, encara que no se l'hi indiqui, a partir de canvi de costat de píxel més gran que 5. Les imatges no optimitzades intermèdies guardades resideixen en directoris que comencen per a la lletra i
      - /INTERMEDI= El valor 1 força a guardar resultats intermedis per a posterior generació de zooms de costat de píxel més grans, encara que el canvi de costat sol·licitat sigui inferior a 5. El valor 0 indica que els resultats intermedis no es volen guardar mai, fins hi tot per a canvis de costat majors a 5. Quan l'entrada és un JPEG o una llista de JPEG's aquest paràmetre no aplica donat que es pot fer servir qualsevol zoom de costat inferior per generar un qualsevol nivell de full superior.
    - /VORA= Indica que cal ignorar una vora de n cel·les de cadascuna de les imatges originals. Serveix per eliminar una possible vora negra o blanca de les imatges originals o qualsevol altre efecte de vora d'una imatge tractada per fulls. Aquest problema s'ha observat en les ortofotos 25k d'algunes versions.
    - Origen ràster d'imatge fotogràfica o imatge de teledetecció.
      - /QUALITAT= Coincideix amb el paràmetre de JPEGIMG i només aplica per a una sortida JPEG (generalment la usada en rasters continus). Es recomana un valor de qualitat entre 75 i 85.
      - Quan es generen canvis de costat de píxel més gran que 5 la degradació cromàtica de les imatges pot ser excessiva, donant imatges poc contrastades, marronosa (per imatges de color) o grises (per imatges de grisos). Aquesta degradació es pot corregir aplicant optimitzacions de contrast sobre les imatges dels resultats intermedis guardats, per tal de que la generació dels canvis de costat majors es pugui fer amb millor qualitat. Cal insistir que les optimitzacions s'apliquen sobre els resultats intermedis guardats i no sobre la tessel·lació generada durant aquesta execució. Els paràmetres següents governen aquest grau d'optimització. Les imatges optimitzades intermèdies guardades resideixen en directoris que comencen per la lletra o.
        
        /OPCIO_OPTI= Indica que es vol aplicar la optimització i el tipus d'optimització de l'histograma aplicat als resultats intermedis guardats. 1 per optimització global de l'histograma, 2 per a optimització de l'histograma de finestres flotants (recomanat) i 0 per no optimitzar. El valor per defecte és 0.
        /COSTAT_OPTI= Costat de la finestra d'optimització en la opció d'optimització 2. El valor per defecte és 301. No aplica per optimitzacions 1 o 0.
        /PERCENT_BAIX= Percentatge a ignorar de la cua baixa de l'histograma d'optimització. Els valors dins d'aquest percentatge són saturats al valor mínim. Per defecte val 1.5.
        /PERCENT_ALT= Percentatge a ignorar de la cua alta de l'histograma d'optimització. Els valors dins d'aquest percentatge són saturats al valor màxim. Per defecte val 1.5.
        /IGNOR_NODATA= Ignorar la definició dels sensedades durant les optimitzacions. 0 per fer cas a la definió de valor de fons indicat a les metadades de les imatges, 1 per considerar el valor 0 i 2 per a considerar 255. El valor per defecte és 0.
      - Alguns paràmetres depenen del format de la imatge
        
        Origen ràster color a partir de 3 canals IMG (24 bits) (p.ex. Ortofoto color).
        
        FitxerR, FitxerG, FitxerB: Els tres canals IMG byte per construir un JPEG de color real.
        
        Origen ràster color a partir d'una fitxer IMG de 8 bits amb paleta (generalment optimitzada).
        
        Fitxer: fitxer IMG (o llista de fitxers IMG).
        NomPaleta: Nom de la paleta de color.
        /FORMAT=JPEG Per qualsevol mode la opció 2 podeu indicar el format de sortida que voleu, indicant GIF o JPEG. En general, no s'ha indicar aquest paràmetre, donat que el format es decideix automàticament, però és útil en aquest mode, donat que el programa decidiria una sortida GIF i un tractament categòric però resulta millor un format JPEG i un tractament continu.
        
        Origen ràster de grisos (p.ex. Ortofoto B/N) o imatge JPEG (ja sigui de color o de grisos).
        
        FitxerIMG: Imatge IMG byte (o llista de fitxers IMG byte)
        
        Origen ràster JPEG (ja sigui de color real o de grisos).
        
        FitxerIMG: Imatge JPEG de color o de grisos (o llista de fitxers JPEG).
    - Origen ràster categòric/temàtic (p.ex. un ràster d'usos del sol) amb paleta o continu amb paleta (p.ex. un Model digital de terreny com podria ser un mapa de temperatures).
      - Fitxer: fitxer IMG (o llista de fitxers IMG).
      - NomPaleta: Nom de la paleta de color.
      - /VALOR_MIN= Valor mínim que es fa servir per estirar la paleta de colors. Per defecte es fa servir el valors mínim de cada full. Només resulta útil per imatges continues amb paleta.
      - /VALOR_MAX= Valor màxim que es fa servir per estirar la paleta de colors. Per defecte es fa servir el valors màxim de cada full. Només resulta útil per imatges continues amb paleta.
      - /EXAGERACIO= És el factor de exageració o regruiximent. Per a un fitxer que representi punts, el radi de punt és (exageracio+0.5)*costat. Per a un fitxer que representi línies, el gruix de la línia és (2*exageracio+1)*costat.
  - Origen vector de línies o polígons (Si voleu punts useu l'opció 1).
    - Fitxer: Nom del fitxer vectorial estructurat de línies o polígons.
    - NomPaleta: Nom de la paleta de color. S'ha d'indicar si s'una /CAMP= i no si s'usa /COLOR_CONSTANT=.
    - /COSTAT= És la mida de píxel a rasteritzar.
    - /COLOR_CONSTANT= Per a fitxers de línies rasteritzar un color constant. Per a fitxer de polígons rasteritzar un color constant en l'interior del polígon. El valor ha de ser un color escrit com (r,g,b) (on r, g i b representen la intensitat de vermell, verd i blau respectivament de 0 a 255). No useu junt amb /CAMP.
    - /CAMP= Camp de la base de dades a l'estil BD4. Conté el camp que indexa el color, és a dir, els valors dels índexs de la paleta que es fan servir per pintar cada objecte de tipus línia o els interiors dels objectes de tipus polígons. No useu junt amb /VALOR_CONSTANT Per saber més sobre els valors d'aquests paràmetres seguiu les consideracions del document de sintaxi general.
    - /COLOR_CONSTANT_VORA= Només per a fitxers de polígons on indica el rasteritzar un color constant a la vora del polígon. El valor ha de ser un color escrit com (r,g,b) (on r, g i b representen la intensitat de vermell, verd i blau respectivament de 0 a 255).No useu junt amb /CAMP_VORA
    - /CAMP_VORA= Només per a fitxers de polígons on és el camp de la base de dades a l'estil BD4 que indexa el color que es fa servir per pintar les vores dels polígons. No useu junt amb /VALOR_CONSTANT_VORA Per saber més sobre els valors d'aquests paràmetres seguiu les consideracions del document de sintaxi general.
    - En el cas de fitxers de polígons si no s'indica /COLOR_CONSTANT ni /CAMP l'interior del polígon no es pintarà. I el mateix per les vores, si no s'indica ni /COLOR_CONSTANT_VORA ni /CAMP_VORA no es pintarà la vora del polígons. Però és obligatòri indicar almenys una de les dues coses.
    - En el cas de fitxers de línies s'ha d'indicar o bé /COLOR_CONSTANT o bé /CAMP.
    - /MANTENIR_VECTORS Els vectors que s'han necessitat es mantenen en memòria fins al final. Això fa les execucions una mica més ràpides però necessiten més memòria.
    - /EXAGERACIO= És el factor de exageració o regruiximent de línies; el gruix de la línia és (2*exageracio+1)*costat.
  - Origen mapa o capa de MiraMon.
    - Fitxer: Nom del mapa o capa (preferiblement amb la simbolització definides des de MiraMon dins del mapa o el rel de la capa).
    - /MM32 Indica que la capa ha de ser tractada amb la simbolització de MiraMon. Si la capa és una mapa sempre es tracta el mapa amb la simbolització de MiraMon i no cal aquesta opció.
    - /COSTAT= És la mida de píxel a rasteritzar.
    - Nota: aquesta opció presenta algunes restriccions sobre altres paràmetres. Així:
      - /IMATGE_BUIDA= és ignorat i sempre es creen les tessel·les encara que siguin buides.
      - ncol i nfil no poden superar la mida de la pantalla i ncol no pot ser més petit de 150.
  - /IMATGE_BUIDA= Coincideix amb el paràmetre de Mosaic i serveix per eliminar les tessel·les buides que no aporten informació. Els valors més útils provoquen que s'esborri la tessel·la si:
    - 0: tots els valors són iguals.
    - 1: tots els valors són sensedades.
    - 2: no s'esborren les tessel·les encara que tots els valors siguin iguals o sensedades.
    - si no s'indica aquest paràmetre, no es generen imatges buides.
  - /TESSELLA_SENCERA Si s'indica aquest paràmetre totes les tessel·les tindran la mateixa mida, tot i que superin l'àmbit de la capa original, on no hi hagi dades s'omplirà amb sensedades. Per defecte (sense aquest paràmetre) les tessel·les s'ajusten a l'àmbit de la capa, com que la divisió comença a d'alt i a l'esquerra, les tessel·les del marge dret o del marge inferior poden tenir una mida inferior a la indicada.
  - /ORIGEN_INFERIOR_ESQUERRA Per defecte la tesselació commença per la part superior esquerra. Si s'indica aquest paràmetre la tesselació comença per a la part inferior esquerra.
  - Noms de les tesseles
    - Comportament per defecte: Els noms de fitxer de la tesselació tenen un nom accendent de 0 a n-1 que es correspon amb l'índex de cel·la linea. A partir de n>500 els fitxers s'acumulen en subdirectories de 500 fitxers per a facilitar la gestió de fitxers.
    - /INDEXA_J_I Els noms de tesselació s'estructuren amb subdirectoris que tenen índexs de files i noms que són índex de columnes.
    - /INDEXA_I_J Els noms de tesselació s'estructuren amb subdirectoris que tenen índexs de columnes i noms que són índex de files.
  - /MINX=,/MAXX=,/MINY=,/MAXY= Per defecte l'origen de la indexació es calcula a partir de l'àmbit de les imatges originals. Amb aquests paràmetres es força una indexació en base l'envolupant donada. Resulta especialment indicat per a permetre regerarar una part d'una preparació prèvia o quan els índexs són importants, com en el cas del WMTS.
  - /METATILE= El nombre de tessel·les que es generen al mateix temps en una matriu de n*n. Aixi si indique 4 es generen 16 tiles a l'hora. Resultat útil per accelerar les preparacions que es fan des de fitxers JPEG. Per defecte val 1.
  - /REVISIO Permet revisar la preparació de capes. Aquest mode revisa les tessel·les ja creades i regenera les tessel·les que puguin faltar, creant les llistes finals de nou. És particularment útil quan el prepara una capa molt gran si cal interrompre el procés i reprendre’l més tard; quan es distribueix una preparació entre diverses màquines (per assegurar-se que el producte unificat és complet i regenerar la llista) o quan es descobreix que algunes tessel·les s’han creat malament per algun defecte de les capes originals (un cop corregit el defecte i esborrades les tessel•les afectades es pot executar una revisió). Es possible combinar-ho amb un proces de generació de tessel·lats parcials però no es recomana.
  - Paràmetres que cal indicar per a generar fitxers segons l'estandard WMTS
    - /IMATGE_BUIDA=2 /TESSELLA_SENCERA /FORMAT=PNG /INDEXA_J_I
    Si ho prefereiu, podeu fer servir el paràmetre /WMTS que és equivalent a /IMATGE_BUIDA=2 /TESSELLA_SENCERA /INDEXA_J_I i deixa sense posar /ORIGEN_INFERIOR_ESQUERRA. També podeu fer servir /WMTS_I_J per intercanviar els índex I i J, la qual cosa és útil pel "WMTS simple".
  - Generació de tessel·lats parcials.
    - Generació parcial en base un àmbit. El programa regenerarà com a mínim l'envolupant indicada. Com que l'espai està tesselat, l'envolupant finalment regenerada pot ser més gran (particularment si es fan servir metatiles. La principal gràcia d'aquesta alternativa és que si es vol regenerar una àrea a diferents nivells de zoom, l'àmbit és independent del nivell de zoom.
      - /MINX_TROS=, /MAXX_TROS=, /MINY_TROS=, /MAXY_TROS= Defineix l'envolupant mínima que està regenerada. No cal indicar tots 4 paràmetres. En cas de no indicar-se es fa servir el criteri habitual per determinar aquesta frontera.
    - Per defecte es genera una tessel·lació de l'espai des de la part superior esquerra fins a la part inferior dreta de l'àmbit cobert per totes les imatges d'origen (Aquest criteri canvia si useu /ORIGEN_INFERIOR_ESQUERRA). A més, cada tessel·la té un índex de fila-columna i un índex de cel·la lineal.
    - Generació parcial d'unes quantes files linials des d'un origen a un destí determinat per índexs de fila i columna.
      - /COL_MIN_TROS= Índex de columna dels trossos de la tessel·lació per on iniciar a tallar. Per defecte val 0.
      - /FIL_MIN_TROS= Índex de fila dels trossos de la tessel·lació per on iniciar a tallar. Per defecte val 0.
      - /COL_MAX_TROS= Índex de columna dels trossos de la tessel·lació per on acabar de tallar. Per defecte val el nombre de trossos per columna menys 1.
      - /FIL_MAX_TROS= Índex de fila dels trossos de la tessel·lació per on acabar de tallar. Per defecte val el nombre de trossos per fila menys 1.
    - Generació parcial d'unes quantes tessel·les de dins d'un rectangle determinat per índexs de fila i columna mínims i màxims.
      - /MIN_MAX_TROS_RECTANGLE Indica que els 4 paràmetres posteriors defineixen un rectangle. Canvia el significat de /COL_MIN_TROS pel que es descriu a continuació.
      - /COL_MIN_TROS= Índex de columna mínim dels trossos de la tessel·lació que es regeneraran. Per defecte val 0.
      - /COL_MAX_TROS= Índex de columna màxim dels trossos de la tessel·lació que es regeneraran. Per defecte val el nombre de trossos per columna menys 1.
      - /FIL_MIN_TROS= Índex de fila mínim dels trossos de la tessel·lació que es regeneraran. Per defecte val 0.
      - /FIL_MAX_TROS= Índex de fila màxim dels trossos de la tessel·lació que es regeneraran. Per defecte val el nombre de trossos per fila menys 1.
    - Generació parcial d'unes quantes files des d'un origen a un destí determinat per índexs de tessel·la (que es correspon amb el nom de fitxer si no s'ha indicat /INDEXA_J_I).
      - /I_MIN_TROS= Índex de tros dels trossos de la tessel·lació per on iniciar a tallar. No aplica si s'indica /MIN_MAX_TROS_RECTANGLE. Per defecte val 0.
      - /I_MAX_TROS= Índex de tros dels trossos de la tessel·lació per on acabar de tallar. No aplica si s'indica /MIN_MAX_TROS_RECTANGLE. Per defecte val el nombre de trossos menys 1.
- Opció 3: Prepara una capa de punts/línies o polígons per a ser consultada per localització.
  - FitxerIMGSortida: És un fitxer ràster temàtic d'identificadors gràfics.
  - costat: És la mida de píxel del ràster del nivell de zoom que estem generant.
  - exageracio: És el factor de exageració. Per a un fitxer de punts, el radi de punt és (exageracio+0.5)*costat. Per a un fitxer de línies, el gruix de la línia és (2*exageracio+1)*costat. Per a un fitxer de polígons no aplica. Indiqueu 0.
  - FitxerTop: Fitxer topològic a preparar per a la consulta d'un nivell de zoom del servidor.
Aquest programa només suporta fitxers REL4.