Header file

When using Text-based formats, you can define a header file in the common converter settings. This header file can contain fixed text or macros, that will be replaced using correct values. Most of these work also with title file.

Common macros

Following macros are available in header file and title file:

Macro	Description
#DATE	Current date in native format.
#TIME	Current time in native format.
#DATETIME	Current time in ISO 8601 format.
#TIMESTAMP	UTC time in ISO 8601 format.
#FILEPATH	Original file name with full path
#FILENAME	Original file name without full path
#TYPENAME	File type name
#POINTS	Amount of single points in file
#LINES	Amount of lines in file
#POINTCOUNT	Total amount points in file
#MINX, #MAXX	X-coordinate minimum and maximum in file
#MINY, #MAXY	Y-coordinate minimum and maximum in file
#MINZ, #MAXZ	Z-coordinate minimum and maximum in file
#MINA, #MAXA	Minimum and maximum section value in profile file or cross section
#MINB, #MAXB	Minimum and maximum side offset in profile file or cross section
#MINC, #MAXC	Minimum and maximum point distance in cross section
#SCALE	Printing scale (e.g. 1:2000 or 1:1000/1:100 with profile Z-scaling)
#SCALEZ	Printing height scale in window settings
#PAPER	Paper size from print settings (e.g. A4)
#PAPERSIZE	Paper size in millimeters from print settings (e.g. 290 x 200)
#TOLXMIN,#TOLXMAX	X-component minimum and maximum tolerance in control settings
#TOLYMIN,#TOLYMAX	Y-component minimum and maximum tolerance in control settings
#TOLZMIN,#TOLZMAX	Y-component minimum and maximum tolerance in control settings
#TOLXY,#TOLXYZ	Maximum XY- and XYZ-control tolerance in in control settings

Header macros

Following macros are available only in header file:

Macro	Description
#SAVEPATH	Saved file name with full path
#SAVENAME	Saved file name without full path
#FORMAT	Used write format name
#FUNCTION	Used format converter function
#CODELIST	List of codes and their descriptions in the file

Title macros

Following macros are available only in title file:

Macro	Description
#INFO1	Info field given in title settings
#INFO2	Info field given in title settings
#INFO3	Info field given in title settings
#AUTOSYSTEM	Automatic coordinate system name
#AUTOEPSG	Automatic coordinate system name EPSG code

Additionally, project macros are available. Their values are searched from converter settings, active project or common project settings in this order.

Same macros work also with template files.

You can use also attributes from the file by putting $-sign in front of the attribute name.

$PROJECT               The value from file PROJECT-attribute.
$DATE                  The value from file DATE-attribute.

Date, time and numeric type attribute values can be formatted using common value formatting rules (e.g. $SCALE%.2, #DATE%YYYY-MM-DD or #TIME%hh:mm:ss). Date and time default formats come from operating system settings.

Example:

!
! File:                #filename
! Type:                #typename
! Funktion:            #function
! Standard time:       #(date%YYYY-MM-DD)T#(time%hh:mm:ss)+02
!
! Single points:       #points
! Lines:               #lines
! Points:              #pointcount
!
! Organization:        #organization
! Email:               #email
! Coding:              #codesys
!
! Limits:              (#(minx), #(miny)) - (#(maxx), #(maxy))
!
! Scale:               $(SCALE%.2)
!

Result:

!
! File:                arc.xyz
! Type:                Vector file
! Funktion:            Text
! Standard time:       2009-07-27T15:01:42+02
!
! Single points:       1
! Lines:               11
! Points:              51
!
! Organization:        3D-system Oy
! Email:               mikko@3d-system.fi
! Coding:              code_54.dat
!
! Limits:              (6697069.046, 3444038.514) - (6697351.622, 3444463.728)
!
! Scale:               1000.00
!
    Code      Id             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