; Format Definitions for the SCFileUtil program.
;
; The identifier for each format definition must be included in [] and must be 
; unique e.g. [My new download format].
;
; Each format definition needs to indicate the Name to be displayed in the 
; format selection combo box.  You must ensure that all the download and 
; upload format definitions have unique names (included in []), but you can 
; assign the same format Name to a download and an upload definition.
;
; Each format definition needs to indicate the Direction it is defined for:
; Download or Upload.  The Download definitions handle data being downloaded 
; from the Survey Controller and the Upload definitions handle data being sent 
; to the Survey Controller or DC file.
;
; Each format definition needs to indicate the format Style - Fixed or Comma
;    Fixed indicates that the format uses Fixed width fields
;    Comma indicates that the format uses comma separated fields
;
; Each format definition can include the file Extension to be presented as 
; the default for the file to be output or selected.  Use the Extension 
; identifier for this.  If not specified the default extension is txt.
;
; Each format definition can contain an ExternalProgram reference.  This 
; reference to an external program must provide the full path and file name 
; for the program to be run.  For example, a reference like the following 
; could be defined:
;   ExternalProgram=c:\Utility\ConvertFile.exe
; The ability to specify the use of an external program is so that special 
; processing of complex file formats can be carried out prior to the SCFileUtil
; program reading the selected file on Upload, or after the SCFileUtil program 
; has output its defined file on download.
;
; In the case of an Upload definition, any specified external program will be 
; run immediately after the file to be uploaded has been selected.  The name 
; of the selected file is available in the Registry entry 
; HKEY_CURRENT_USER\Software\Trimble\SCFileUtil\UploadFile to allow the 
; external program to locate the selected file.  The external program can then 
; process the selected file in any way required, but the file output by the 
; program must have the same name as that originally selected, and must be in 
; the format as defined in the format definition fields.  The SCFileUtil 
; program will continue its processing of the file after the external program 
; has terminated (i.e. the external program is handled in a modal manner).
;
; In the case of a Download definition, any specified external program will be 
; run immediately after the SCFileUtil program has saved the output ASCII file 
; created as per the format definition and using the file name specified.  The 
; name of the saved file is available in the Registry entry 
; HKEY_CURRENT_USER\Software\Trimble\SCFileUtil\DownloadFile to allow the 
; external program to locate the saved file.  The external program can then 
; process the saved file in any way required, but the file output by the 
; program should have the same name as that originally selected for the saved 
; file.  Focus will return to the SCFileUtil program after the external program
; has terminated (i.e. the external program is handled in a modal manner).
;
; Each format can contain a definition of a PadCharacter.  This is a character 
; that will be used to pad out any empty space in fixed format definitions.
; If no PadCharacter is specified then by default the space character is used 
; as the pad character.  If you wish to specifically define the space character 
; as the PadCharacter then you must use double quotes eg. PadCharacter=" " to 
; define it.
;
; Each format can contain multiple fixed definition Header and Footer lines. 
; The Header lines are defined using Header1, Header2 etc as their identifiers.
; For example the definition: 
;   Header1=This is a header line
; will output 'This is a header line' as the first line in any downloaded file.
; Footer lines can be defined in exactly the same way (Footer1, Footer2 etc) 
; and any Footer lines defined will be output as the last lines in the 
; downloaded file.  In Upload definitions the appropriate number of Header and 
; Footer lines are simply skipped when the ASCII file is read for uploading.
;
; Each download format can specify whether any user entered notes encountered 
; in the downloaded job should be output to the created file.  The definition 
; IncludeNotes=Yes must be included in the format specification.  By default 
; note records are not included in downloaded files.
;
; When user entered notes are specified for inclusion in a download format it is 
; possible to specify a prefix to be included before each note that is written 
; to the file using the NotePrefix definition eg. NotePrefix=" 09 ".
;
; Each field in a file definition must be identified using Fieldx where x is 
; the field number.  The parameters for each field must follow in the specified
; order separated by commas.  The parameters that must be defined for each 
; field are as follow:
;    Source name     Standard sources are Name, Northing, Easting, Elevation, 
;                    Code, Space, Text, Skip, NewLine, Counter, HzPrecision, 
;                    VtPrecision, PDOP, NbrSatellites or AllAttributes but 
;                    other attributes assigned to the surveyed points can be 
;                    referenced as a Source name.  The Space option will output
;                    the number of spaces specified as the Width.  The 
;                    AllAttributes option will output all the attributes 
;                    associated with a point as comma separated attribute name,
;                    attribute value pairs - this option is only valid with 
;                    comma separated style files ie. Style=Comma.  The Text 
;                    option will output the text string that is supplied as the
;                    Default value for the field.  The Skip option only applies
;                    to Upload definitions and will skip the number of 
;                    characters specified as the Width value.  The NewLine 
;                    option can be used to handle definitions such as the GDM 
;                    format where the fields associated with a single point 
;                    cover more than one line.  The Counter option is valid 
;                    for download definitions only and provides an incrementing
;                    counter for each point output.  Typically for upload 
;                    definitions any counter in a format would be skipped 
;                    using the Skip option.
;    Type            This can be set to 'String' or 'Number' to indicate the 
;                    type of value involved.
;    Width           This specifies the width of the column for output - will 
;                    be ignored in the case of a comma separated format style.
;    Decimal places  This specifies the number of decimal places to be output 
;                    for a numeric value.  If you are dealing with a format 
;                    that uses implied decimal places (ie. there is no decimal 
;                    character in the number) prefix the decimal places value 
;                    with a negative character to indicate how many decimal 
;                    places are implied.  For example a decimal places value of
;                    -3 indicates 3 implied decimal places (the value 
;                    effectively needs to be divided by 1000 to provide the 
;                    actual value). Set to 0 for String items or integer 
;                    values.
;    Justification   This can be set to 'Left' or 'Right' to indicate how a 
;                    value should be justified within a column.
;    Default         This allows you to specify an optional default value to 
;                    be assigned to the field if no value is available in the 
;                    data.  Leading or trailing spaces for the Default value 
;                    can be handled by enclosing the string in double quotes 
;                    eg. "  Default  ".
;
; Special notes relating to Upload definitions
; 1. The only Source names recognised for the Upload definition fields are 
;    Name, Northing, Easting, Elevation, Code, Space, Text and Skip.  Any 
;    other Source names will be ignored.
; 2. To allow an uploaded point name to be assembled from more than one field 
;    in an ASCII file multiple Name fields can be defined with each field 
;    being assigned a suffix eg. Name1, Name2 etc (to a maximum of 9 Name 
;    fields).  When there is a single Name field to be extracted no suffix is 
;    required.  A separation character can be specified for separating the 
;    different segments of a Name by specifying it as the default value for 
;    the field - any separation character specified for the first field will 
;    be ignored. 

[Fixed Format N-E Download]
Name=Fixed Format (N-E)
Direction=Download
Style=Fixed
Extension=txt
PadCharacter=" "
Description=Fixed format file
Field1=Name, String, 20, 0, Left
Field2=Northing, Number, 15, 3, Right
Field3=Easting, Number, 15, 3, Right
Field4=Elevation, Number, 15, 3, Right
Field5=Code, String, 20, 0, Right

[Fixed Format E-N Download]
Name=Fixed Format (E-N)
Direction=Download
Style=Fixed
Extension=txt
Description=Fixed format file
Field1=Name, String, 20, 0, Left
Field2=Easting, Number, 15, 3, Right
Field3=Northing, Number, 15, 3, Right
Field4=Elevation, Number, 15, 3, Right
Field5=Code, String, 20, 0, Right

[Fixed Format N-E Upload]
Name=Fixed Format (N-E)
Direction=Upload
Style=Fixed
Extension=txt
;ExternalProgram=c:\Windows\Notepad.exe
Description=Fixed format file
Field1=Name, String, 20, 0, Left
Field2=Northing, Number, 15, 3, Right
Field3=Easting, Number, 15, 3, Right
Field4=Elevation, Number, 15, 3, Right
Field5=Code, String, 20, 0, Right

[Comma Format Download]
Name=Comma Format with all attributes
Direction=Download
Style=Comma
Extension=csv
;ExternalProgram=c:\Windows\Notepad.exe
Description=Comma separated file
Field1=Name, String, 0, 0, Right
Field2=Northing, Number, 0, 3, Right
Field3=Easting, Number, 0, 3, Right
Field4=Elevation, Number, 0, 3, Right
Field5=Code, String, 0, 0, Right
Field6=Text, String, 0, 0, Right, HzPrec=
Field7=HzPrecision, Number, 0, 3, Right
Field8=Text, String, 0, 0, Right, VtPrec=
Field9=VtPrecision, Number, 0, 3, Right
Field10=PDOP, Number, 0, 1, Right
Field11=NbrSatellites, Number, 0, 0, Right
Field12=AllAttributes, Number, 0, 3, Right

[Comma Format Upload]
Name=Comma Format (Name,N,E,El,Code)
Direction=Upload
Style=Comma
Extension=csv
Description=Comma separated file
Field1=Name, String, 0, 0, Right
Field2=Northing, Number, 0, 3, Right
Field3=Easting, Number, 0, 3, Right
Field4=Elevation, Number, 0, 3, Right
Field5=Code, String, 0, 0, Right

[MMH360 Format Download]
Name=MMH360 Format
Direction=Download
Style=Fixed
Extension=360
Description=MMH360 format file
Field1=RSK-luku, Number, 7, 1, Right, 0.1
Field2=Maastonumero, Number, 4, 0, Right
Field3=Name, String, 7, 0, Right
Field4=Space, String, 4, 0, Right
Field5=Kohdeluokka, Number, 3, 0, Right
Field6=Maanpintanäkyvyys, Number, 1, 0, Right
Field7=Toimitustieto, Number, 1, 0, Right
Field8=Northing, Number, 12, 3, Right
Field9=Easting, Number, 12, 3, Right
Field10=Elevation, Number, 16, 3, Right

[Four Fields Format Download]
Name=Four Fields Format
Direction=Download
Style=Fixed
Extension=txt
Description=Four Fields format file
Field1=Pinta, Number, 8, 0, Right
Field2=Taiteviiva, Number, 8, 0, Right
Field3=Koodi, Number, 8, 0, Right
Field4=Name, String, 8, 0, Right
Field5=Northing, Number, 14, 3, Right
Field6=Easting, Number, 14, 3, Right
Field7=Elevation, Number, 14, 3, Right

[MMH360 Format Upload]
Name=MMH360 Format
Direction=Upload
Style=Fixed
Extension=360
Description=MMH360 format file
Field1=Skip, String, 7, 0, Right
Field2=Name1, String, 4, 0, Right
Field3=Name2, String, 7, 0, Right, -
Field4=Code, String, 9, 0, Right
Field5=Northing, Number, 12, 3, Right
Field6=Easting, Number, 12, 3, Right
Field7=Elevation, Number, 16, 3, Right

[Four Fields Format Upload]
Name=Four Fields Format
Direction=Upload
Style=Fixed
Extension=txt
Description=MMH360 format file
Field1=Skip, String, 8, 0, Right
Field2=Name1, String, 8, 0, Right
Field3=Code, String, 8, 0, Right
Field4=Name2, String, 8, 0, Right, -
Field5=Northing, Number, 14, 3, Right
Field6=Easting, Number, 14, 3, Right
Field7=Elevation, Number, 14, 3, Right

[GDM points format download]
Name=GDM area file
Direction=Download
Style=Fixed
Extension=are
Description=Points in GDM area file
Field1=Text, String, 2, 0, Left, 5=
Field2=Name, String, 0, 0, Left
Field3=NewLine, String, 0, 0, Left
Field4=Text, String, 2, 0, Left, 4=
Field5=Code, String, 0, 0, Left
Field6=NewLine, String, 0, 0, Left
Field7=Text, String, 3, 0, Left, 37=
Field8=Northing, Number, 0, 3, Left
Field9=NewLine, String, 0, 0, Left
Field10=Text, String, 3, 0, Left, 38=
Field11=Easting, Number, 0, 3, Right
Field12=NewLine, String, 0, 0, Left
Field13=Text, String, 3, 0, Left, 39=
Field14=Elevation, Number, 0, 3, Right

[GDM points format upload]
Name=GDM area file
Direction=Upload
Style=Fixed
Extension=are
Description=Points in GDM area file
Field1=Text, String, 2, 0, Left, 5=
Field2=Name, String, 0, 0, Left
Field3=NewLine, String, 0, 0, Left
Field4=Text, String, 2, 0, Left, 4=
Field5=Code, String, 0, 0, Left
Field6=NewLine, String, 0, 0, Left
Field7=Text, String, 3, 0, Left, 37=
Field8=Northing, Number, 0, 3, Left
Field9=NewLine, String, 0, 0, Left
Field10=Text, String, 3, 0, Left, 38=
Field11=Easting, Number, 0, 3, Right
Field12=NewLine, String, 0, 0, Left
Field13=Text, String, 3, 0, Left, 39=
Field14=Elevation, Number, 0, 3, Right

[GDM points format (Tree attribs) download]
Name=GDM area file with Tree attributes
Direction=Download
Style=Fixed
Extension=are
Description=Points in GDM area file
Field1=Text, String, 2, 0, Left, 5=
Field2=Name, String, 0, 0, Left
Field3=NewLine, String, 0, 0, Left
Field4=Text, String, 2, 0, Left, 4=
Field5=Code, String, 0, 0, Left
Field6=NewLine, String, 0, 0, Left
Field7=Text, String, 3, 0, Left, 91=
Field8=Girth, Number, 0, 2, Left
Field9=NewLine, String, 0, 0, Left
Field10=Text, String, 3, 0, Left, 92=
Field11=Spread, Number, 0, 2, Left
Field12=NewLine, String, 0, 0, Left
Field13=Text, String, 3, 0, Left, 93=
Field14=Height, Number, 0, 2, Left
Field15=NewLine, String, 0, 0, Left
Field16=Text, String, 3, 0, Left, 37=
Field17=Northing, Number, 0, 3, Left
Field18=NewLine, String, 0, 0, Left
Field19=Text, String, 3, 0, Left, 38=
Field20=Easting, Number, 0, 3, Right
Field21=NewLine, String, 0, 0, Left
Field22=Text, String, 3, 0, Left, 39=
Field23=Elevation, Number, 0, 3, Right

[Leica GSI-16 points download (m)]
Name=Leica GSI-16 points download (m)
Direction=Download
Style=Fixed
Extension=gsi
PadCharacter=0
Description=Metric Leica GSI-16 points file
Footer1=! ----+
Field1=Text, String, 3, 0, Left, *11
Field2=Counter, Number, 4, 0, Right
Field3=Text, String, 1, 0, Left, +
Field4=Name, String, 16, 0, Right
Field5=Text, String, 8, 0, Left, " 81..10+"
Field6=Easting, Number, 16, -3, Right
Field7=Text, String, 8, 0, Left, " 82..10+"
Field8=Northing, Number, 16, -3, Right
Field9=Text, String, 8, 0, Left, " 83..10+"
Field10=Elevation, Number, 16, -3, Right
Field11=Text, String, 8, 0, Left, " 71....+"
Field12=Code, String, 16, 0, Right
Field13=Text, String, 1, 0, Left, " "

[Leica GSI-16 points upload (m)]
Name=Leica GSI-16 points upload (m)
Direction=Upload
Style=Fixed
Extension=gsi
PadCharacter=0
Description=Metric Leica GSI-16 points file
Field1=Text, String, 3, 0, Left, *11
Field2=Skip, String, 5, 0, Left
Field3=Name, String, 16, 0, Right
Field4=Text, String, 8, 0, Left, " 81..10+"
Field5=Easting, Number, 16, -3, Right
Field6=Text, String, 8, 0, Left, " 82..10+"
Field7=Northing, Number, 16, -3, Right
Field8=Text, String, 8, 0, Left, " 83..10+"
Field9=Elevation, Number, 16, -3, Right
Field10=Text, String, 8, 0, Left, " 71....+"
Field11=Code, String, 16, 0, Right
Field12=Text, String, 1, 0, Left, " "

[Leica GSI-16 points download (ft)]
Name=Leica GSI-16 points download (ft)
Direction=Download
Style=Fixed
Extension=gsi
PadCharacter=0
Description=Feet Leica GSI-16 points file
Footer1=! ----+
Field1=Text, String, 3, 0, Left, *11
Field2=Counter, Number, 4, 0, Right
Field3=Text, String, 1, 0, Left, +
Field4=Name, String, 16, 0, Right
Field5=Text, String, 8, 0, Left, " 81..11+"
Field6=Easting, Number, 16, -3, Right
Field7=Text, String, 8, 0, Left, " 82..11+"
Field8=Northing, Number, 16, -3, Right
Field9=Text, String, 8, 0, Left, " 83..11+"
Field10=Elevation, Number, 16, -3, Right
Field11=Text, String, 8, 0, Left, " 71....+"
Field12=Code, String, 16, 0, Right
Field13=Text, String, 1, 0, Left, " "

[Leica GSI-16 points upload (ft)]
Name=Leica GSI-16 points upload (ft)
Direction=Upload
Style=Fixed
Extension=gsi
PadCharacter=0
Description=Feet Leica GSI-16 points file
Field1=Text, String, 3, 0, Left, *11
Field2=Skip, String, 5, 0, Left
Field3=Name, String, 16, 0, Right
Field4=Text, String, 8, 0, Left, " 81..11+"
Field5=Easting, Number, 16, -3, Right
Field6=Text, String, 8, 0, Left, " 82..11+"
Field7=Northing, Number, 16, -3, Right
Field8=Text, String, 8, 0, Left, " 83..11+"
Field9=Elevation, Number, 16, -3, Right
Field10=Text, String, 8, 0, Left, " 71....+"
Field11=Code, String, 16, 0, Right
Field12=Text, String, 1, 0, Left, " "

[KOF download format]
Name=KOF download format
Direction=Download
Style=Fixed
Extension=kof
PadCharacter= 
Description=KOF format coordinate file
IncludeNotes=Yes
NotePrefix=" 09 "
Header1=-00 Sample Survey Controller data converted to KOF format
Header2=-00 Suitable header lines can be set up in definition files for each
Header3=-00 coordinate system used in Norway with the zone number indicated
Header4=-00 in the file format definition name
Field1=Text, String, 1, 0, Left, " "
Field2=Text, String, 2, 0, Right, 05
Field3=Text, String, 1, 0, Left, " "
Field4=Name, String, 10, 0, Left
Field5=Text, String, 1, 0, Left, " "
Field6=Code, String, 8, 0, Left
Field7=Text, String, 1, 0, Left, " "
Field8=Easting, Number, 12, 3, Right
Field9=Text, String, 1, 0, Left, " "
Field10=Northing, Number, 11, 3, Right
Field11=Text, String, 1, 0, Left, " "
Field12=Elevation, Number, 8, 3, Right
Field13=Text, String, 1, 0, Left, " "
Field14=Text, String, 8, 0, Left, "  "
Field15=Text, String, 1, 0, Left, " "
Field16=Text, String, 1, 0, Left, "       "