Alkutiedosto

Tekstipohjaisten formaattien alkuun voidaan yleisissä muunninasetuksissa antaa alkutiedosto, jossa on vakiotekstiä tai makroja, jotka korvataan oikeilla arvoilla. Suurin osa näistä toimii myös otsikkotiedoston kanssa.

Yleiset makrot

Alkutiedosto ja otsikkotiedosto tunnistavat seuraavat makrot:

Makro	Kuvaus
#DATE	Tämänhetkinen päiväys paikallisessa muodossa.
#TIME	Tämänhetkinen kellonaika paikallisessa muodossa.
#DATETIME	Tämänhetkinen aika ISO 8601 -muodossa.
#TIMESTAMP	UTC-aika ISO 8601 -muodossa.
#FILEPATH	Alkuperäinen tiedostonimi koko polun kanssa
#FILENAME	Alkuperäinen tiedostonimi ilman hakemistopolkua
#TYPENAME	Tiedoston tyypin nimi
#POINTS	Hajapisteiden tai kairausten määrä tiedostossa
#LINES	Viivojen tai profiilien määrä tiedostossa
#TRIANGLES	Näkyvien kolmioiden määrä tiedostossa
#POINTCOUNT	Pisteiden kokonaismäärä tiedostossa
#TOTALLENGTH	Tiedoston viivojen yhteispituus
#AVERAGELENGTH	Tiedoston viivojen keskiarvopituus
#TOTALAREA	Tiedoston alueiden yhteispinta-ala
#AVERAGELENGTH	Tiedoston alueiden keskiarvopinta-ala
#MINX, #MAXX	Tiedoston X-koordinaatin minimi ja maksimi
#MINY, #MAXY	Tiedoston Y-koordinaatin minimi ja maksimi
#MINZ, #MAXZ	Tiedoston Z-koordinaatin minimi ja maksimi
#MINA, #MAXA	Paaluluvun minimi ja maksimi profiilitiedostoissa tai poikkileikkauksessa
#MINB, #MAXB	Sivumitan minimi ja maksimi profiilitiedostoissa tai poikkileikkauksessa
#MINC, #MAXC	Pisteiden etäisyyden minimi ja maksimi poikkileikkauksessa
#SCALE	Tulostusmittakaava (esim. 1:2000 tai 1:1000/1:100 Z-kertoimen kanssa)
#SCALEZ	Tulostuksen pystymittakaava ikkuna-asetuksissa
#PAPER	Tulostusasetuksissa määrätty paperikoko (esim. A4)
#PAPERSIZE	Tulostusasetuksissa määrätty paperikoko millimetreinä (esim. 290 x 200)
#TOLXMIN, #TOLXMAX	Tarkeasetuksissa määrätty X-komponentin minimi- ja maksimitoleranssi
#TOLYMIN, #TOLYMAX	Tarkeasetuksissa määrätty Y-komponentin minimi- ja maksimitoleranssi
#TOLZMIN, #TOLZMAX	Tarkeasetuksissa määrätty Z-komponentin minimi- ja maksimitoleranssi
#TOLXY, #TOLXYZ	Tarkeasetuksissa määrätty XY- ja XYZ-tarkkeen maksimitoleranssi

Alkutiedostomakrot

Alkutiedosto tunnistaa lisäksi seuraavat makrot:

Makro	Kuvaus
#SAVEPATH	Talletettu tiedostonimi koko polun kanssa
#SAVENAME	Talletettu tiedostonimi ilman hakemistopolkua
#FORMAT	Kirjoitusformaatin nimi
#FUNCTION	Kirjoitukseen käytetty muunninfunktio
#CODELIST	Tiedostossa olevien koodien listaus selityksineen

Otsikkotiedostomakrot

Otsikkotiedosto tunnistaa lisäksi seuraavat makrot:

Makro	Kuvaus
#INFO1	Otsikkotiedoston asetuksissa annettu infokenttä
#INFO2	Otsikkotiedoston asetuksissa annettu infokenttä
#INFO3	Otsikkotiedoston asetuksissa annettu infokenttä
#AUTOSYSTEM	Automaattinen koordinaattijärjestelmän nimi
#AUTOEPSG	Automaattinen koordinaattijärjestelmän EPSG-koodi

Lisäksi voidaan käyttää projektimakroja, joiden arvot haetaan joko muuntimen asetuksista, aktiivisesta projektista tai yleisistä projektiasetuksista tässä järjestyksessä.

Samat makrot toimivat myös mallinetiedostojen kanssa.

Voit käyttää myös tiedoston ominaisuuksia antamalla ominaisuuden nimen eteen $-merkin:

$PROJECT               Tiedoston PROJECT-ominaisuuden arvo.
$DATE                  Tiedoston DATE-ominaisuuden arvo.

Päivämäärä-, kellonaika- ja numeromuotoisia ominaisuuksien arvoja voi formatoida yleisillä muotoilumäärittelyillä (esim. $SCALE%.2, #DATE%YYYY-MM-DD tai #TIME%hh:mm:ss). Päivämäärän ja kellonajan oletusmuodot haetaan käyttöjärjestelmän asetuksista.

Esimerkki:

!
! Tiedosto:            #filename
! Tyyppi:              #typename
! Funktio:             #function
! Standardiaika:       #(date%YYYY-MM-DD)T#(time%hh:mm:ss)+02
!
! Hajapisteet:         #points
! Viivat:              #lines
! Pisteet:             #pointcount
!
! Yritys:              #organization
! Email:               #email
! Koodaus:             #codesys
!
! Rajat:               (#(minx), #(miny)) - (#(maxx), #(maxy))
!
! Mittakaava:          $(SCALE%.2)
!

Tulos:

!
! Tiedosto:            arc.xyz
! Tyyppi:              Vektoritiedosto
! Funktio:             Text
! Standardiaika:       2009-07-27T15:01:42+02
!
! Hajapisteet:         1
! Viivat:              11
! Pisteet:             51
!
! Yritys:              3D-system Oy
! Email:               mikko@3d-system.fi
! Koodaus:             code_54.dat
!
! Rajat:               (6697069.046, 3444038.514) - (6697351.622, 3444463.728)
!
! Mittakaava:          1000.00
!
   Koodi  Tunnus             X             Y             Z
               5   6697251.000   3444093.000         0.000
     127       1   6697069.046   3444187.820         0.000
     127       2   6697146.595   3444209.931         0.000
     127       3   6697127.048   3444274.149         0.000