OCAD Wiki - English - User contributions [en]

DEM

2026-09-22T06:51:28Z

GRS: /* Merge Contour Lines By Selected Symbols File:Space.PNGThis function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartographyThis function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering */

A DEM (Digital Elevation Model) contains points with elevation data. DEM Data are based on LiDAR (Light Detection and Ranging) technology measurement, also known as Airborne Laser Scanning. There are DEM with point data arranged in a regular grid with a constant distance between the points. This distance is called cell size. Other DEM contain data points arranged irregularly (cloud-model).
Read more about this topic: http://en.wikipedia.org/wiki/Digital_elevation_model

[[File:Lidar.png|1000px]] 
''Left picture'': LiDAR systems emit laser pulses and detect the light scattered back from the atmosphere. The distance to the location of the scattering is calculated from the light travel time of the signals 
''Middle picture'': A laser beam splits as it hits objects. The result are multiple returns. The last return doesn’t always reach the ground. 
''Right picture'': The difference between first return (Digital Surface Model DSM) and last return (Digital Terrain Model DTM) can show object height. 
''Source: Lohani, Bharat. Airborne Altimetric LiDAR: Principle, Data Collection, Processing and Applications.''

==DEM Import Wizard [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Read more about importing DEM file on the page [[DEM Import Wizard]].

==Open [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Open an OCAD DEM file (*.ocdDem). OCAD 2018 can also open ocdDems created in OCAD 11 and OCAD 12.

The OCAD DEM file is a DEM grid in an OCAD internal file format created in the [[DEM Import Wizard]].
This file is optimized for fast access to the height values.

For more information (e.g. cell size) about this file open the [[DEM#Info|DEM Information dialog]].

==Show Frame [[File:Space.PNG]][[File:Mas40px.png|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Shows blue rectangle with the extent of the loaded DEM.

[[File:DemShowFrame.png]]

When moving the mouse cursor inside the frame the height values is show in the status bar together with the coordinate.

[[File:DemShowFrameStatusBar.png]]

==Resize [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Resize the loaded OCAD DEM file (make a subset) and save it as a new OCAD DEM file or overwrite the existing one.

[[File:DemResize.png]]

==Info [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Shows information about OCAD DEM file.

[[File:DemInfo.png]]

When moving the mouse cursor over the file name then the file name with path appears.

==Close [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

This function closes OCAD DEM file.

==Merge DEM [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose '''Merge''' from '''DEM''' menu to merge two different DEMs.

[[File:Merge.PNG]]

* '''DEM 1:''' Choose the first DEM.
* '''DEM 2:''' Choose the second DEM.

The two DEMs must have the same cell size.

==Calculate DEM Difference [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose '''Calculate DEM Difference''' from '''DEM''' menu. The '''Calculate DEM Difference''' dialog box appears.

[[File:CalculateDEMDifference.PNG]]

Usually it is the difference between a terrain model and a surface model.

* Add ''Upper DEM'' = DSM data file
* Add ''Lower DEM'' = DTM data file
* Click '''OK'''.

In the [[DEM Import Wizard]] it is possible to import DTM and DSM and create the DEM difference in one step.

To visualize the DEM difference choose '''[[DEM#Classify_Vegetation_Height|Classify Vegetation Height]]'''

[[File:Hint.jpg]] The extent of the ''Upper DEM'' and ''Lower DEM'' can be different. OCAD takes the overlapping area for the new DEM.

[[File:Hint.jpg]] The cell size of ''Upper DEM'' and ''Lower DEM'' can be different. OCAD takes the cell size of ''Upper DEM'' for the new DEM.

===Example===
This is an example to show what can result from the '''Calculate DEM Difference''' function.

This is a DTM (Digital Terrain Model) with a cell size of 5m shown as hypsometric map:

[[File:DTM5mHypso.PNG|300px]]

The next picture shows the DSM (Digital Surface Model) of the same area with a cell size of 2m as hypsometric map. The buildings (northern part) and forest (south western part) are slightly visible.

[[File:DSM2mHypso.PNG|300px]]

The next picture shows a '''Difference DEM''' with a cell size of 2m shown as raster background map after calculating the '''DEM Difference'''. In addition, heights were colored using the '''[[DEM#Classify Vegetation Height|Classify Vegetation Height]]''' function.

[[File:ClassifiedDifferenceDEM.PNG|300px]]

* The area with no difference of the DTM and the DSM are displayed white.
* A height difference up to 15m appears red.
* The greater the difference, the greener an area appears.

When moving the mouse cursor over the map the difference is shown in the '''[[Graphical User Interface#Status Bar|Status Bar]]'''.

''Data source: Test data Wabern from swisstopo.''

==Create Contour Lines [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose '''Create Contour Lines''' from '''DEM''' menu. The '''Create Contour Lines''' dialog box appears.

Read more about this function on the page [[DEM Import Wizard#Create Contour Lines|DEM Import Wizard]].

==Create Hypsometric Map [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose '''Create Hypsometric Map''' from '''DEM''' menu. The '''Create Hypsometric Map''' dialog box appears.

Read more about this function on the page [[DEM Import Wizard#Create Hypsometric Map|DEM Import Wizard]].

==Create Hill Shading [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose '''Create Hill Shading''' from '''DEM''' menu. The '''Create Hill Shading''' dialog box appears.

Read more about this function on the page [[DEM Import Wizard#Create Hill Shading|DEM Import Wizard]].

==Calculate Slope Gradient [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose '''Calculate Slope Gradient''' from '''DEM''' menu. The '''Calculate Slope Gradient''' dialog box appears.

Read more about this function on the page [[DEM Import Wizard#Calculate Slope Gradient|DEM Import Wizard]].

==Classify Vegetation Height [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose '''Classify Vegetation Height''' from '''DEM''' menu. The '''Classify Vegetation Height''' dialog box appears.

Read more about this function on the page [[DEM Import Wizard#Classify Vegetation Height|DEM Import Wizard]].

[[File:Hint.jpg]] Before running this command, make sure you have loaded the ''xxx_Diff.ocdDem'' as DEM and not the ''xxx_DTM.ocdDem''. Click '''Info''' in the '''DEM''' menu to see which file you have loaded. 

==Create Feature Map [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

==Merge Contour Lines By Selected Symbols [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
This is an obsolete function. It is still in the latest OCAD version due to compability issues. OCAD merges the contour lines automatically.
* Select the contour line symbols
* Choose '''Merge Contour Lines By Selected Symbols''' from DEM menu.
* The '''Merge Contour Lines By Selected Symbols''' dialog box appears.

[[File:MergeContourLinesBySelectedSymbols.png]]

==Create Profile [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
[[File:ProfileExample.PNG|600px]]

Find more information about this function on the '''[[DEM Profile]]''' page.

==Create optimized DEM for Course Setting [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
[[File:OptimizedDEMSettings.png]]

The DEM is typically created by the map maker as a basis for mapping. Course setters need a DEM to run the '''[[Route_Analyzer|Route Analyzer]]'''.
The DEM can passed on to the course setters as an optimized and compressed Course Setting DEM (ocdCsDem), which has greatly reduced file size with no quality loss for route calculation. In addition, the optimized DEM can be embedded directly into the map file or course setting file to make exchange easier.

===DEM files===
*'''Use loaded DEM''': If a DEM is already loaded, you can use it to create an optimized DEM.
*'''Use DEM(s) from folder''': Click the '''Add''' button to choose DEM files from a folder. You can choose multiple DEM files, but be aware that the grid size need to be the same. Click the '''Remove all''' button to remove the files from the list again.

===Optimized DEM===
*'''Embed into the map file''': Select this option to embed the optimized DEM directly into the file. You can embed the DEM into the map file or course setting file. The file size will increase.
*'''Save as external DEM file''': Save the optimized DEM as external file after its creation. When passing the course setting project to another person, make sure that the external DEM is also sent.
*'''Load (Instead of currently loaded)''': In OCAD, only one DEM can be loaded at the same time. When you create the optimized DEM, you can load it directly instead of the currently loaded (non-optimized) DEM.

==Remove embedded DEM [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Click this function to removed an embedded DEM. 
Run the '''[[Map#Optimize_and_Repair|Optimize and Repair]]''' command afterwards to reduce the file size again.

==Export [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

* Choose '''Export''' from DEM menu.
* The '''DEM Export''' dialog box appears.

[[File:DEMExport.PNG]]

The function exports the loaded DEM file to the following formats:
* ESRI ASCII Grid
::Select '''Create tiles''' for large DEMs to create tiles from 1001x1001 points.
* ASCII Grid XYZ

==LiDAR Point Cloud Manager [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

The '''LiDAR Point Cloud Manager''' analyzes the vegetation within the forest and creates a vegetation raster map.
Learn more on the '''[[LiDAR Point Cloud Manager]]''' page.

----
Back to [[Main Page]]

Base Colors

2025-09-05T11:13:39Z

GRS: Created page with "Base colors dialog"

Base colors dialog

Colors

2025-09-05T11:13:20Z

GRS: /* Base Colors */

==Colors [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:View40px.PNG|This function is available in OCAD Viewer.|link=https://www.ocad.com/en/downloads/ocad-viewer]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
''This function has limitations in the OCAD Viewer''

Choose this command in the '''Map''' menu to define the colors and spot colors of the map. The '''Colors''' dialog box is displayed. In this dialog all colors which you can use for the map are listed, can be edited, created or deleted.

[[File:hint.jpg|hint]]In the top right corner is a color '''search''' field.
 

[[File:ColorDialog.PNG]]

The colors are rendered on the screen and on the printer from the bottom up. The color on the bottom is rendered first and the color on the top is rendered last. Therefore, an object A with a color, which is below the color of another object B, appears behind object B on the map. 
The table contains 18 columns:

===Number and Name===
The first column provides you with a preview of the color defined in the corresponding row. The second and the third column are defined as follows:
*'''No.:''' In this column the color number is displayed. Each color must have a number between 0 and 32000. This number can be changed by clicking on it.
*'''Name:''' In this column a name with up to 45 characters must be given to each color. This name can be changed by clicking on it.



===CMYK (process) colors===
The CMYK (Cyan, Magenta, Yellow, Key (Black)) values of the color are displayed in those 4 columns. These values can be changed by clicking on it. The color preview will be updated immediately.

===Overprint===
In the '''Ov.''' column you can check the '''Overprint''' option. When overprinting is chosen for a color, the CMYK separations are not omitted (i.e. the CMYK seperations are printed/rendered under the color you overprint). This makes this color appearing darker when it is printed on another color. The following example should illustrate this:

[[File:Overprint.PNG]]

In the figure on the left side, overprinting for brown and black colors is active. In contrast, on the right side, overprinting is disabled for those colors. You can see that the brown contour lines appear darker in the green areas. Furthermore, there is a similar effect when the black path crosses the contour lines. 
It is noticeable that the contour lines do not appear darker when crossing the yellow area. This is due to the fact that the brown color as well as the yellow color have a cyan value of 0. Overprinting has therefore only an effect, if the upper color has at least one CMYK value which is 0 and, at the same time, this value is greater than 0 in the lower color.

In OCAD the overprinting effect is not shown. Overprinting affects only Color AI, EPS and PDF files as well as CMYK separations. Overprinting is also supported by some PostScript printers. 
[[File:Hint.jpg]] To show overprinting effect when printing PDF files from Adobe Acrobat Reader: Activate the '''Simulate overprint''' option in the '''Advanced Printer Settings''' .

===Opacity===
In this column the opacity of the color in percentage can be entered by clicking the value. 
An opacity value of 0 means that the color is not visible. 
An opacity value from 1 to 99 means that the color is transparent with the corresponding intensity. 
An opacity value of 100 means that the color is opaque.

[[File:Opacity.PNG]]

Black with 100%, 50% and 0% opacity.

===Usage===
If the '''Symbol''' column is checked, the color is used in at least one symbol.

If the '''Map''' column is checked, the color is used in at least one map object, including '''[[Image Objects|Image]]''' and '''[[Convert into Graphic Object|Graphic Objects]]'''.

===Spot Colors===
Spot colors are used if the map is printed with PMS (Pantone) colors. If the map is printed with 4 colors (CMYK), spot colors needn't be defined.

You can define a spot color value for each color. Click in the corresponding field and enter a value in percentage.
* A value of 100 means that the color appears black on the separation.
* A value of 0 means that the color appears white on the separation and erases any black color.
* An empty field means that the color has no effect on the separation.

[[File:Hint.jpg|hint]] The colors are rendered on the separation from the bottom up. The lowest color in the list is drawn first and the color on top of the list is drawn last. Therefore if you put 0 in one row, only colors below this row are erased.
 
[[File:Hint.jpg]]Putting a 0 is especially important for streets in order to enable automatic cleaning up of crossings. The color of the street infill must be above the color of the street sidelines. And in the row of the infill there must be a 0 for the spot color of the sidelines.

To create, edit and delete spot colors choose the '''[[Define Spot Colors]]''' item in the '''Map''' menu.

[[File:SpotColors.png]]

===Functions===
*'''Redraw screen when changing a color:''' OCAD redraws the map after changing a color. If the map has a lot of objects this takes some seconds. Uncheck this option to avoid the automatical redrawing of the screen.
*'''Move Up:''' Click the '''Move Up''' icon to move the selected color one row upwards in the color table.
*'''Move Down:''' Click the '''Move Down''' icon to move the selected color one row downwards in the color table.
*'''Add:''' Click this button to add a new color.
*'''Duplicate:''' Click this button to duplicate the selected color. The duplicated color is inserted below the selected color.
*'''Delete unused:''' Click this button to delete all colors that are neither used in any symbol nor any map object.
*'''Delete:''' Click this button to delete the selected color.
*'''Report:''' Click this button to save a report of the colors as a Word, Excel, Html or Text file. Open the report with the '''[[File#Open_Recently_Exported_Documents|Open Recently Exported Documents]]''' command from the '''File''' menu.

[[File:Hint.jpg|Hint]] If you have a map with a lot of objects, it may take some seconds until the '''Color''' dialog appears. OCAD is checking through all objects to find all colors used in the symbols and in the map. If you want OCAD to display the '''Colors''' dialog immediately, press the '''Shift''' key when choosing '''Colors''' in the '''Map''' menu. OCAD opens the dialog instantly and hides the '''Symbol''' and '''Map''' columns as well as the '''Delete unused''' button. This dialog looks as follows:

: [[File:ColorDialogHiddenColumns.png|Color dialog with hidden columns Symbol and Map and the hidden button Delete unused|600px]]

==Base Colors==
Click the '''Base colors''' button to edit the base colors in the [[Base Colors]] dialog.

==Choose Color from Color Picker==
Click the '''Choose color from color picker''' button to edit the selected color in the '''Color Picker''' dialog.

==Select Color Swatch==
Click the '''Select color swatch''' to compare the colors from the current opened OCAD file with a color swatch from a reference file in the [[Color Swatch]] dialog.

==Blend Mode==
Click the '''Blend Mode''' button to set the blend mode for each color in PDF export in [[Blend Mode]] dialog.

==Load Colors From [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command in the '''Map''' menu to load a color table from a different OCAD-File or text file. The '''Load Colors From''' dialog box is displayed. Choose a map or text file which the color table shall be loaded from. Click the '''Open''' button to continue. Another '''Load Colors From''' dialog box appears. You have two options:
* '''Replace existing colors:''' Choose this option to overwrite the existing color table of the current map with the new one.
* '''Add to existing colors:''' Choose this option to add the new colors to the existing color table.
Click the '''OK''' button to finish.

==Load Colors and Symbols From [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command in the '''Map''' menu to load a symbol set from a different OCAD-File. The '''Load Colors and Symbols From''' dialog box is displayed. Choose a map file which the symbol set shall be loaded from. Click the '''Open''' button to continue. Another '''Load Colors and Symbols From''' dialog box appears. You have two options:
* '''Replace existing colors and symbols:''' Choose this option to overwrite the existing symbol set and color table of the current map with the new ones.
* '''Add to existing colors and symbols:''' Choose this option to add the new symbols and colors to the existing ones.

'''Language''': If available, choose the language for the symbol description.

You have the option to use a '''[[Cross Reference Table|CRT-File]]''' to import the symbol set. In the first column of the cross reference table the symbol numbers of the current map are listed. In the second column symbol numbers of the other OCAD-File are listed, namely those numbers of symbols, which the current symbol has to be replaced with. As an example, a CRT row which is defined as <nowiki>526.000 813.001</nowiki>, means that the symbols of all objects with the symbol number 526.000 will get the symbol of the other OCAD-File with the number 813.001. 
Visit the '''[[Cross Reference Table]]''' page to get detailed information about using CRT-Files. Click the '''Load''' button to load a CRT-File.

Click the '''OK''' button to finish.

[[File:LoadColorsAndSymbolsFrom.png]]

[[File:Hint.jpg|hint]] OCAD opens the File Dialog in the folder of the last imported file. Press the '''Shift''' key to open a file from the ''Symbol'' folder. The ''Symbol'' folder is a subfolder of OCAD program folder (e.g. ''C:\Program Files\OCAD\OCAD 20xx Mapping Solution\Symbol'').

[[File:Hint.jpg|hint]] The error message "Cannot import symbol" appears if OCAD was not able to load a symbol. The '''Load Colors and Symbols From''' process is aborted.

==Example==
[[File:Colors Basics.gif]]
----
Back to [[Main Page]]

Colors

2025-09-05T11:12:52Z

GRS: /* Choose Color from Color Picker */

==Colors [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:View40px.PNG|This function is available in OCAD Viewer.|link=https://www.ocad.com/en/downloads/ocad-viewer]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
''This function has limitations in the OCAD Viewer''

Choose this command in the '''Map''' menu to define the colors and spot colors of the map. The '''Colors''' dialog box is displayed. In this dialog all colors which you can use for the map are listed, can be edited, created or deleted.

[[File:hint.jpg|hint]]In the top right corner is a color '''search''' field.
 

[[File:ColorDialog.PNG]]

The colors are rendered on the screen and on the printer from the bottom up. The color on the bottom is rendered first and the color on the top is rendered last. Therefore, an object A with a color, which is below the color of another object B, appears behind object B on the map. 
The table contains 18 columns:

===Number and Name===
The first column provides you with a preview of the color defined in the corresponding row. The second and the third column are defined as follows:
*'''No.:''' In this column the color number is displayed. Each color must have a number between 0 and 32000. This number can be changed by clicking on it.
*'''Name:''' In this column a name with up to 45 characters must be given to each color. This name can be changed by clicking on it.



===CMYK (process) colors===
The CMYK (Cyan, Magenta, Yellow, Key (Black)) values of the color are displayed in those 4 columns. These values can be changed by clicking on it. The color preview will be updated immediately.

===Overprint===
In the '''Ov.''' column you can check the '''Overprint''' option. When overprinting is chosen for a color, the CMYK separations are not omitted (i.e. the CMYK seperations are printed/rendered under the color you overprint). This makes this color appearing darker when it is printed on another color. The following example should illustrate this:

[[File:Overprint.PNG]]

In the figure on the left side, overprinting for brown and black colors is active. In contrast, on the right side, overprinting is disabled for those colors. You can see that the brown contour lines appear darker in the green areas. Furthermore, there is a similar effect when the black path crosses the contour lines. 
It is noticeable that the contour lines do not appear darker when crossing the yellow area. This is due to the fact that the brown color as well as the yellow color have a cyan value of 0. Overprinting has therefore only an effect, if the upper color has at least one CMYK value which is 0 and, at the same time, this value is greater than 0 in the lower color.

In OCAD the overprinting effect is not shown. Overprinting affects only Color AI, EPS and PDF files as well as CMYK separations. Overprinting is also supported by some PostScript printers. 
[[File:Hint.jpg]] To show overprinting effect when printing PDF files from Adobe Acrobat Reader: Activate the '''Simulate overprint''' option in the '''Advanced Printer Settings''' .

===Opacity===
In this column the opacity of the color in percentage can be entered by clicking the value. 
An opacity value of 0 means that the color is not visible. 
An opacity value from 1 to 99 means that the color is transparent with the corresponding intensity. 
An opacity value of 100 means that the color is opaque.

[[File:Opacity.PNG]]

Black with 100%, 50% and 0% opacity.

===Usage===
If the '''Symbol''' column is checked, the color is used in at least one symbol.

If the '''Map''' column is checked, the color is used in at least one map object, including '''[[Image Objects|Image]]''' and '''[[Convert into Graphic Object|Graphic Objects]]'''.

===Spot Colors===
Spot colors are used if the map is printed with PMS (Pantone) colors. If the map is printed with 4 colors (CMYK), spot colors needn't be defined.

You can define a spot color value for each color. Click in the corresponding field and enter a value in percentage.
* A value of 100 means that the color appears black on the separation.
* A value of 0 means that the color appears white on the separation and erases any black color.
* An empty field means that the color has no effect on the separation.

[[File:Hint.jpg|hint]] The colors are rendered on the separation from the bottom up. The lowest color in the list is drawn first and the color on top of the list is drawn last. Therefore if you put 0 in one row, only colors below this row are erased.
 
[[File:Hint.jpg]]Putting a 0 is especially important for streets in order to enable automatic cleaning up of crossings. The color of the street infill must be above the color of the street sidelines. And in the row of the infill there must be a 0 for the spot color of the sidelines.

To create, edit and delete spot colors choose the '''[[Define Spot Colors]]''' item in the '''Map''' menu.

[[File:SpotColors.png]]

===Functions===
*'''Redraw screen when changing a color:''' OCAD redraws the map after changing a color. If the map has a lot of objects this takes some seconds. Uncheck this option to avoid the automatical redrawing of the screen.
*'''Move Up:''' Click the '''Move Up''' icon to move the selected color one row upwards in the color table.
*'''Move Down:''' Click the '''Move Down''' icon to move the selected color one row downwards in the color table.
*'''Add:''' Click this button to add a new color.
*'''Duplicate:''' Click this button to duplicate the selected color. The duplicated color is inserted below the selected color.
*'''Delete unused:''' Click this button to delete all colors that are neither used in any symbol nor any map object.
*'''Delete:''' Click this button to delete the selected color.
*'''Report:''' Click this button to save a report of the colors as a Word, Excel, Html or Text file. Open the report with the '''[[File#Open_Recently_Exported_Documents|Open Recently Exported Documents]]''' command from the '''File''' menu.

[[File:Hint.jpg|Hint]] If you have a map with a lot of objects, it may take some seconds until the '''Color''' dialog appears. OCAD is checking through all objects to find all colors used in the symbols and in the map. If you want OCAD to display the '''Colors''' dialog immediately, press the '''Shift''' key when choosing '''Colors''' in the '''Map''' menu. OCAD opens the dialog instantly and hides the '''Symbol''' and '''Map''' columns as well as the '''Delete unused''' button. This dialog looks as follows:

: [[File:ColorDialogHiddenColumns.png|Color dialog with hidden columns Symbol and Map and the hidden button Delete unused|600px]]

==Base Colors==
Click the '''Base colors''' button to edit the base colors in the '''Base Colors''' dialog.

==Choose Color from Color Picker==
Click the '''Choose color from color picker''' button to edit the selected color in the '''Color Picker''' dialog.

==Select Color Swatch==
Click the '''Select color swatch''' to compare the colors from the current opened OCAD file with a color swatch from a reference file in the [[Color Swatch]] dialog.

==Blend Mode==
Click the '''Blend Mode''' button to set the blend mode for each color in PDF export in [[Blend Mode]] dialog.

==Load Colors From [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command in the '''Map''' menu to load a color table from a different OCAD-File or text file. The '''Load Colors From''' dialog box is displayed. Choose a map or text file which the color table shall be loaded from. Click the '''Open''' button to continue. Another '''Load Colors From''' dialog box appears. You have two options:
* '''Replace existing colors:''' Choose this option to overwrite the existing color table of the current map with the new one.
* '''Add to existing colors:''' Choose this option to add the new colors to the existing color table.
Click the '''OK''' button to finish.

==Load Colors and Symbols From [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command in the '''Map''' menu to load a symbol set from a different OCAD-File. The '''Load Colors and Symbols From''' dialog box is displayed. Choose a map file which the symbol set shall be loaded from. Click the '''Open''' button to continue. Another '''Load Colors and Symbols From''' dialog box appears. You have two options:
* '''Replace existing colors and symbols:''' Choose this option to overwrite the existing symbol set and color table of the current map with the new ones.
* '''Add to existing colors and symbols:''' Choose this option to add the new symbols and colors to the existing ones.

'''Language''': If available, choose the language for the symbol description.

You have the option to use a '''[[Cross Reference Table|CRT-File]]''' to import the symbol set. In the first column of the cross reference table the symbol numbers of the current map are listed. In the second column symbol numbers of the other OCAD-File are listed, namely those numbers of symbols, which the current symbol has to be replaced with. As an example, a CRT row which is defined as <nowiki>526.000 813.001</nowiki>, means that the symbols of all objects with the symbol number 526.000 will get the symbol of the other OCAD-File with the number 813.001. 
Visit the '''[[Cross Reference Table]]''' page to get detailed information about using CRT-Files. Click the '''Load''' button to load a CRT-File.

Click the '''OK''' button to finish.

[[File:LoadColorsAndSymbolsFrom.png]]

[[File:Hint.jpg|hint]] OCAD opens the File Dialog in the folder of the last imported file. Press the '''Shift''' key to open a file from the ''Symbol'' folder. The ''Symbol'' folder is a subfolder of OCAD program folder (e.g. ''C:\Program Files\OCAD\OCAD 20xx Mapping Solution\Symbol'').

[[File:Hint.jpg|hint]] The error message "Cannot import symbol" appears if OCAD was not able to load a symbol. The '''Load Colors and Symbols From''' process is aborted.

==Example==
[[File:Colors Basics.gif]]
----
Back to [[Main Page]]

Technical Data

2025-08-11T06:35:37Z

GRS: /* Computer / System Requirements */

= Computer / System Requirements=
* OCAD requires Windows 8, 10 or 11 (32- or 64-bit). OCAD is available as 32-bit and 64-bit software. OCAD does not run on [https://support.microsoft.com/en-us/windows/windows-10-and-windows-11-in-s-mode-faq-851057d6-1ee9-b9e5-c30b-93baebeebc85 Windows in S mode].
* OCAD is not compiled for ARM based computers, but runs on the emulation provided by Windows.
* 100 MB of free disk space for the installation
* At least 1 GB RAM (depends on the size of open maps and background maps). The OCAD program without any open map needs only 70 MB RAM.
* OCAD as 32-bit software can allocate up to approx. 3.5 GB RAM. OCAD as 64-bit software and can allocate more than 3.5 GB RAM if available.
* Screen resolution: 1280 x 1024 or higher recommended (needs to be multiplied with the screen scaling factor e.g. 2560 x 2048 when using 200% scaling)
* OCAD Mapping Solution: We recommend to install the [http://www.ocad.com/download/bde.exe Borland Database Engine] (import shape files, database connections to dBase files, using OCAD to create thematic maps) and the [http://www.microsoft.com/download/en/details.aspx?id=13255 Microsoft Access Database Engine] (database connections to Access/Excel files, using OCAD to create thematic maps).

[[File:hint.jpg]] OCAD 64-bit version cannot connect to Microsoft Excel/Access if the 32-bit version of Microsoft Access Database Engine is installed. The same with 64-bit Microsoft Access Database Engine and OCAD 32 bit version.
In this case use the same OCAD version as installed Microsoft Access Database Engine.

= 64-bit Version vs. 32-bit Version =
The 64-bit version of OCAD isn't faster than the 32-bit version. The big advantage of 64-bit is that OCAD can allocate more than 3 GB RAM if available on the computer. That is important when loading huge raster background maps or DEM files. 

OCAD 64-bit runs only on Windows 64-bit version. Nowadays, almost all computers are running on a 64-bit Windows version. OCAD 32-bit runs on both Windows 64-bit and 32-bit. The ocd files are 100% compatible between both versions. 

'''OCAD Orienteering''', '''OCAD Starter''', '''OCAD Course Setting''' and '''OCAD Viewer''' 
:OCAD Setup only installs the 64-bit version. If the installed Windows version is 32-bit, OCAD will only install an OCAD 32-version. 

'''OCAD Mapping Solution''' 
:OCAD Setup installs the 64-bit and 32-bit version. 
:Please note that not all OCAD functions are available in both versions:
:* Microsoft Access database files depend on the installed Access Database Engine version
:* dbf database file cannot be used in OCAD 64-bit version

= OCAD on Mac OS X =
Read the '''[[OCAD on Mac OS X]]''' article for more information.

= OCAD on Linux =
Read the '''[[OCAD on Linux]]''' article for more information.

= OCAD Limits =
* Maximal map size: 4 x 4 meters (OCAD Starter and Orienteering edition), 80 x 80 meters (Mapping Solution edition)
* Resolution (accuracy of coordinates) 0.01 mm
* 10000 objects (Starter edition), 16 million objects (OCAD Mapping Solution, Orienteering, Course Setting and Viewer edition)
* 4 million vertices for each object
* Unlimited number of symbols (number range 0.001 to 999'999.999)
* 32'000 colors (number range from 0 to 32'000)
* 2 GB file size

= OCAD File Format =
This description of the OCAD file format is intended for programmers who want to directly access the information in OCAD files.

* [[OCAD 12 File Format]]
* [http://www.ocad.com/wiki/ocad11/en/?title=Main_Page OCAD 11 File Format]
* [http://www.ocad.ch/docs/OCAD10Format.txt OCAD 10 File Format]
* [http://www.ocad.ch/docs/OCAD9Format.pdf OCAD 9/10 Graphic]
* [http://www.ocad.ch/docs/OCAD9Format.txt OCAD 9 File Format]
* [http://www.ocad.ch/docs/format8.txt OCAD 6/7/8 File Format]

= Recommendations =

==Mobile Mapping==

Mapping with a tablet in the terrain has some compelling advantages like real-time GPS positioning and the possibility to switch between different background maps. 
In case your background material isn't that great, you can get help of a GPS device so you can see you current position on the tablet.

There are two ways to use OCAD in the field.

'''1. OCAD Desktop, on Window devices''':

:Software: OCAD Orienteering Edition or OCAD Starter Edition
:Advantages: OCAD objects can be drawn directly.
:Disadvantages: Operation is not as ergonomic as in OCAD Sketch App.
:That's you: You like to draw the map directly in the terrain and see immediately, whether a situation on the map is clear and readable.

'''2. OCAD Sketch App, on iOS and Android devices''':

:Software: The '''[[OCAD Sketch App]]''' is available for free download and use in Apple App Store (iOS) and Google Play (Android). To prepare the data for the OCAD Sketch App and for final drawing, you need OCAD Desktop.
:Advantages: Very ergonomic and intuitive to use. Designed specifically for mobile mapping.
:Disadvantages: Only sketches can be drawn and not OCAD objects directly.
:That's you: You want to map as much as possible in the field and do the final drawing in the evening or on a rainy day on the computer at home.

===General things to consider===
*'''Battery'''
:Battery should last a working day. Battery lifetime is an issue and can vary not only from device to device but is also dependend on outside temperature.
:In cold conditions, a normal battery lifetime of 6 hours can be reduced to only 3-4 hours.
:Use an external battery pack/ power bank to extend battery lifetime. You can put the power bank into a bag and connected it directly by wire to the tablet or charge the tablet during a break.

*'''Stylus Pen'''
:A capacitive pen that works with your table is beneficial for precise drawing. General touchscreen pens might not work that precise.
:The OCAD Sketch App can also be used with fingers. However, drawing is more precise with a pen.

*'''Robustness'''
:How robust you want your tablet to be?
:E.g. do you want your tablet to be waterprof (rugged computers/ toughpads) or is it ok to pack it into a plastic bag, when it rains?

*'''GPS'''
:Many devices have internal GPS, which works very satisfactory in most cases.
:If your device has bad or no internal GPS, you can also use an external GPS.

*'''Compass'''
:If your device has a build-in compass, the OCAD Sketch App can use it to rotate the map view to magnetic north. Be aware that not all mobile devices have a build-in compass.

*'''RAM'''
:Your mobile device should have at least 4 GB RAM for the OCAD Sketch App to work smoothly.

===Tablets for OCAD Desktop (Windwos)===

Some recommendation of our customers (05.2022): 
*Microsoft Surface Pro
*Microsoft Surface Go
*Microsoft Surface 7
*Lenovo tablet (Intel Atom CPU Z3795)

[[File:Microsofttablet.jpg|250px]]

Also, you will find many '''rugged computers/ toughpads''' for tough environments as you will need it when mapping in the terrain. As a big plus point, these devices are working well in all weathers and are possible to use in rain. However, these devices are rather expensive if you are not a professional mapper and can cost up to a few thousand Euros. Also consider the weight of the device, which can be over 1kg.

More information can found e.g. on www.forest-it.se 
Some recommendation of our customers (05.2022): 
* Handheld Algiz 8X
* Trimble Yuma 2
* Panasonic Toughpad FZ-G1
* Gen2wave RP70
* FIDS Zelo
* Welo R10S

[[File:Toughpad.jpg|250px]]

===Tablets for OCAD Sketch App (iOS or Android)===

'''iOS devices''' 
No specific recommendation. All iPads can be used, e.g. iPad Air, iPad Air Mini.

Note: iPad Air Wi-Fi = No internal GPS | iPad Air Wi-Fi + Cellular = With Internal GPS

Alternative iPad Pencil: 
*ERS Digital Pencil

'''Android devices''' 
Some recommendation of our customers (05.2022): 

*SAMSUNG Galaxy Tab S6 LTE with Samsung S Pen
*Samsung Galaxy Tab Active3 (8 ", 64 GB) with Samsung S Pen.

Note: Samsung Galaxy Tabs with ''Lite'' have no build-in compass | Samsung Galaxy Tab have GPS.

===Smartphones for OCAD Sketch App (iOS or Android)===
You can use the OCAD Sketch App also on a mobile phone. 
For small corrections, this can be an easy alternative to the tablet. 
For larger projects, however, the use of a tablet is recommended. 

===External GPS device===
If your tablet has no or only bad internal GPS, it is a good idea to connect an external GPS receiver to have your current position shown in OCAD with a few meters accuracy. 
You can place the external GPS device on the top of your head for better reception (fastend it to a cap or helmet) and connected it via bluetooth directly to your tablet. GPS devices like Gramin Glo should last more than 10 hours. 
Some recommendation of our customers (05.2022): 
*Garmin GLO 2
*Navilock BT-821G Bluetooth GNSS Receiver MT3333
*GNS3000

==Draw Orienteering Maps and Course Setting==
Hardware:
* Desktop or Laptop with Windows
* 4 GB or more RAM (at least 8 GB RAM when working with big LiDAR Files)
Software:
* OCAD Orienteering Edition, OCAD Starter Edition or OCAD Course Setting Edition

==Map Publishing Companies==
Hardware:
* Desktop PC with Windows one or two screens
* 4 or more GB RAM
Software:
* OCAD Mapping Solution
Special OCAD Settings:
* Switch on the '''Faster text rendering''' in '''OCAD Preferences''' -> '''View''' tab in '''Options''' menu.
* Switch off the '''Anti-Aliasing''' mode in '''View''' menu. If Anti-Aliasing is switched off then OCAD draws the screen color by color. Otherwise OCAD draws the screen once after a short time.

= Digital Signature =
The OCAD program file and the OCAD setup file are signed with the [https://en.wikipedia.org/wiki/Code_signing digital signature] of OCAD AG. That confirms the software author and guarantee that the code has not been altered or corrupted since it was signed by use of a cryptographic hash. OCAD uses the digital signature algorithm sha256RSA.

That is the reason why OCAD doesn't run on Windows XP and Vista.

The see the digital signature open the context menu of the OCAD setup file (.exe file) in '''File Explorer''' and click '''Properies'''. The '''Properties dialog''' opens. Click the '''Digital Signature''' tab.
Click '''Details'''. In '''Digital Signature Details''' dialog is the '''Signer Name''' ''OCAD AG''.

[[File:DigitalSignature.png]] [[File:DigitalSignatureDetails.png]]

----
Back to [[Main Page]]

Previous Chapter: [[Tutorials]]

Technical Data

2025-08-11T06:35:21Z

GRS: /* Computer / System Requirements */

= Computer / System Requirements=
* OCAD requires Windows 8, 10 or 11 (32- or 64-bit). OCAD is available as 32-bit and 64-bit software. OCAD does not run on [https://support.microsoft.com/en-us/windows/windows-10-and-windows-11-in-s-mode-faq-851057d6-1ee9-b9e5-c30b-93baebeebc85 Windows in S mode].
* Thanks for the support request. OCAD is not compiled for ARM based computers, but runs on the emulation provided by Windows.
* 100 MB of free disk space for the installation
* At least 1 GB RAM (depends on the size of open maps and background maps). The OCAD program without any open map needs only 70 MB RAM.
* OCAD as 32-bit software can allocate up to approx. 3.5 GB RAM. OCAD as 64-bit software and can allocate more than 3.5 GB RAM if available.
* Screen resolution: 1280 x 1024 or higher recommended (needs to be multiplied with the screen scaling factor e.g. 2560 x 2048 when using 200% scaling)
* OCAD Mapping Solution: We recommend to install the [http://www.ocad.com/download/bde.exe Borland Database Engine] (import shape files, database connections to dBase files, using OCAD to create thematic maps) and the [http://www.microsoft.com/download/en/details.aspx?id=13255 Microsoft Access Database Engine] (database connections to Access/Excel files, using OCAD to create thematic maps).

[[File:hint.jpg]] OCAD 64-bit version cannot connect to Microsoft Excel/Access if the 32-bit version of Microsoft Access Database Engine is installed. The same with 64-bit Microsoft Access Database Engine and OCAD 32 bit version.
In this case use the same OCAD version as installed Microsoft Access Database Engine.

= 64-bit Version vs. 32-bit Version =
The 64-bit version of OCAD isn't faster than the 32-bit version. The big advantage of 64-bit is that OCAD can allocate more than 3 GB RAM if available on the computer. That is important when loading huge raster background maps or DEM files. 

OCAD 64-bit runs only on Windows 64-bit version. Nowadays, almost all computers are running on a 64-bit Windows version. OCAD 32-bit runs on both Windows 64-bit and 32-bit. The ocd files are 100% compatible between both versions. 

'''OCAD Orienteering''', '''OCAD Starter''', '''OCAD Course Setting''' and '''OCAD Viewer''' 
:OCAD Setup only installs the 64-bit version. If the installed Windows version is 32-bit, OCAD will only install an OCAD 32-version. 

'''OCAD Mapping Solution''' 
:OCAD Setup installs the 64-bit and 32-bit version. 
:Please note that not all OCAD functions are available in both versions:
:* Microsoft Access database files depend on the installed Access Database Engine version
:* dbf database file cannot be used in OCAD 64-bit version

= OCAD on Mac OS X =
Read the '''[[OCAD on Mac OS X]]''' article for more information.

= OCAD on Linux =
Read the '''[[OCAD on Linux]]''' article for more information.

= OCAD Limits =
* Maximal map size: 4 x 4 meters (OCAD Starter and Orienteering edition), 80 x 80 meters (Mapping Solution edition)
* Resolution (accuracy of coordinates) 0.01 mm
* 10000 objects (Starter edition), 16 million objects (OCAD Mapping Solution, Orienteering, Course Setting and Viewer edition)
* 4 million vertices for each object
* Unlimited number of symbols (number range 0.001 to 999'999.999)
* 32'000 colors (number range from 0 to 32'000)
* 2 GB file size

= OCAD File Format =
This description of the OCAD file format is intended for programmers who want to directly access the information in OCAD files.

* [[OCAD 12 File Format]]
* [http://www.ocad.com/wiki/ocad11/en/?title=Main_Page OCAD 11 File Format]
* [http://www.ocad.ch/docs/OCAD10Format.txt OCAD 10 File Format]
* [http://www.ocad.ch/docs/OCAD9Format.pdf OCAD 9/10 Graphic]
* [http://www.ocad.ch/docs/OCAD9Format.txt OCAD 9 File Format]
* [http://www.ocad.ch/docs/format8.txt OCAD 6/7/8 File Format]

= Recommendations =

==Mobile Mapping==

Mapping with a tablet in the terrain has some compelling advantages like real-time GPS positioning and the possibility to switch between different background maps. 
In case your background material isn't that great, you can get help of a GPS device so you can see you current position on the tablet.

There are two ways to use OCAD in the field.

'''1. OCAD Desktop, on Window devices''':

:Software: OCAD Orienteering Edition or OCAD Starter Edition
:Advantages: OCAD objects can be drawn directly.
:Disadvantages: Operation is not as ergonomic as in OCAD Sketch App.
:That's you: You like to draw the map directly in the terrain and see immediately, whether a situation on the map is clear and readable.

'''2. OCAD Sketch App, on iOS and Android devices''':

:Software: The '''[[OCAD Sketch App]]''' is available for free download and use in Apple App Store (iOS) and Google Play (Android). To prepare the data for the OCAD Sketch App and for final drawing, you need OCAD Desktop.
:Advantages: Very ergonomic and intuitive to use. Designed specifically for mobile mapping.
:Disadvantages: Only sketches can be drawn and not OCAD objects directly.
:That's you: You want to map as much as possible in the field and do the final drawing in the evening or on a rainy day on the computer at home.

===General things to consider===
*'''Battery'''
:Battery should last a working day. Battery lifetime is an issue and can vary not only from device to device but is also dependend on outside temperature.
:In cold conditions, a normal battery lifetime of 6 hours can be reduced to only 3-4 hours.
:Use an external battery pack/ power bank to extend battery lifetime. You can put the power bank into a bag and connected it directly by wire to the tablet or charge the tablet during a break.

*'''Stylus Pen'''
:A capacitive pen that works with your table is beneficial for precise drawing. General touchscreen pens might not work that precise.
:The OCAD Sketch App can also be used with fingers. However, drawing is more precise with a pen.

*'''Robustness'''
:How robust you want your tablet to be?
:E.g. do you want your tablet to be waterprof (rugged computers/ toughpads) or is it ok to pack it into a plastic bag, when it rains?

*'''GPS'''
:Many devices have internal GPS, which works very satisfactory in most cases.
:If your device has bad or no internal GPS, you can also use an external GPS.

*'''Compass'''
:If your device has a build-in compass, the OCAD Sketch App can use it to rotate the map view to magnetic north. Be aware that not all mobile devices have a build-in compass.

*'''RAM'''
:Your mobile device should have at least 4 GB RAM for the OCAD Sketch App to work smoothly.

===Tablets for OCAD Desktop (Windwos)===

Some recommendation of our customers (05.2022): 
*Microsoft Surface Pro
*Microsoft Surface Go
*Microsoft Surface 7
*Lenovo tablet (Intel Atom CPU Z3795)

[[File:Microsofttablet.jpg|250px]]

Also, you will find many '''rugged computers/ toughpads''' for tough environments as you will need it when mapping in the terrain. As a big plus point, these devices are working well in all weathers and are possible to use in rain. However, these devices are rather expensive if you are not a professional mapper and can cost up to a few thousand Euros. Also consider the weight of the device, which can be over 1kg.

More information can found e.g. on www.forest-it.se 
Some recommendation of our customers (05.2022): 
* Handheld Algiz 8X
* Trimble Yuma 2
* Panasonic Toughpad FZ-G1
* Gen2wave RP70
* FIDS Zelo
* Welo R10S

[[File:Toughpad.jpg|250px]]

===Tablets for OCAD Sketch App (iOS or Android)===

'''iOS devices''' 
No specific recommendation. All iPads can be used, e.g. iPad Air, iPad Air Mini.

Note: iPad Air Wi-Fi = No internal GPS | iPad Air Wi-Fi + Cellular = With Internal GPS

Alternative iPad Pencil: 
*ERS Digital Pencil

'''Android devices''' 
Some recommendation of our customers (05.2022): 

*SAMSUNG Galaxy Tab S6 LTE with Samsung S Pen
*Samsung Galaxy Tab Active3 (8 ", 64 GB) with Samsung S Pen.

Note: Samsung Galaxy Tabs with ''Lite'' have no build-in compass | Samsung Galaxy Tab have GPS.

===Smartphones for OCAD Sketch App (iOS or Android)===
You can use the OCAD Sketch App also on a mobile phone. 
For small corrections, this can be an easy alternative to the tablet. 
For larger projects, however, the use of a tablet is recommended. 

===External GPS device===
If your tablet has no or only bad internal GPS, it is a good idea to connect an external GPS receiver to have your current position shown in OCAD with a few meters accuracy. 
You can place the external GPS device on the top of your head for better reception (fastend it to a cap or helmet) and connected it via bluetooth directly to your tablet. GPS devices like Gramin Glo should last more than 10 hours. 
Some recommendation of our customers (05.2022): 
*Garmin GLO 2
*Navilock BT-821G Bluetooth GNSS Receiver MT3333
*GNS3000

==Draw Orienteering Maps and Course Setting==
Hardware:
* Desktop or Laptop with Windows
* 4 GB or more RAM (at least 8 GB RAM when working with big LiDAR Files)
Software:
* OCAD Orienteering Edition, OCAD Starter Edition or OCAD Course Setting Edition

==Map Publishing Companies==
Hardware:
* Desktop PC with Windows one or two screens
* 4 or more GB RAM
Software:
* OCAD Mapping Solution
Special OCAD Settings:
* Switch on the '''Faster text rendering''' in '''OCAD Preferences''' -> '''View''' tab in '''Options''' menu.
* Switch off the '''Anti-Aliasing''' mode in '''View''' menu. If Anti-Aliasing is switched off then OCAD draws the screen color by color. Otherwise OCAD draws the screen once after a short time.

= Digital Signature =
The OCAD program file and the OCAD setup file are signed with the [https://en.wikipedia.org/wiki/Code_signing digital signature] of OCAD AG. That confirms the software author and guarantee that the code has not been altered or corrupted since it was signed by use of a cryptographic hash. OCAD uses the digital signature algorithm sha256RSA.

That is the reason why OCAD doesn't run on Windows XP and Vista.

The see the digital signature open the context menu of the OCAD setup file (.exe file) in '''File Explorer''' and click '''Properies'''. The '''Properties dialog''' opens. Click the '''Digital Signature''' tab.
Click '''Details'''. In '''Digital Signature Details''' dialog is the '''Signer Name''' ''OCAD AG''.

[[File:DigitalSignature.png]] [[File:DigitalSignatureDetails.png]]

----
Back to [[Main Page]]

Previous Chapter: [[Tutorials]]

OCAD 12 File Format

2025-08-05T14:37:52Z

GRS: /* OCAD Object */

== General==
This is a description of the file format of OCAD 12 files.

See the [[Technical_Data#OCAD_File_Format|Technical Data]] page for other OCAD file formats.

Be aware that this is an internal format and may change in future versions.

=== Data types used ===
OCAD is written in 64-bit Delphi and this description uses the names for the data types as they appear in Delphi. However the same data types are available in other development systems like C++.

{| class="wikitable"
|-
| Integer|| 32-bit signed integer
|-
| Cardinal|| 32-bit unsigned integer
|-
| SmallInt || 16-bit signed integer
|-
| Word || 16-bit unsigned integer
|-
| WordBool || 16-bit boolean
|-
| String[x] ||
Widestring. The first byte contains the number of characters followed by the characters. The string is not zero-terminated. The maximum number of characters is x. It occupies x + 1 bytes in the file.
|-
| Double|| 64-bit floating point number
|-
| TDPoly || A special data type (64-bit) used for all coordinates and text. It is defined as
TDPoly = record x, y: integer; end;

The lowest 8 Bits are used to mark special points:

Marks for the x-coordinate: 
1: this point is the first bezier curve point 
2: this point is the second bezier curve point 
4: for double lines: there is no left line between this point and the next point 
8: this point is a area border line or a virtual line gap

Marks for y-coordinate: 
1: this point is a corner point 
2: this point is the first point of a hole in an area 
4: for double lines: there is no right line between this point and the next point 
8: this point is a dash point

The upper 24 bits contain the coordinate value measured in units of 0.01 mm.
|}

Note: all file positions are in bytes starting from the beginning of the file.

== File Header==
OCAD files start with a file header.

<PRE>
TFileHeader = record // size = 60 Byte
OCADMark: SmallInt; // 3245 (hex 0cad)
FileType: Byte; // file type (0: normal map, 1: course setting project, 8: file is saved in Server)
FileStatus: Byte; // not used
Version: SmallInt; // 12
Subversion: Byte; // number of subversion (0 for 12.0, 1 for 12.1 etc.)
SubSubversion: Byte; // number of subsubversion (0 for 12.0.0, 1 for 12.0.1)
FirstSymbolIndexBlk: Cardinal; // file position of the first symbol index block
ObjectIndexBlock: Cardinal; // file position of the object index block -> TObjectIndexBlock // max 65536 * 256 objects
OfflineSyncSerial: integer; // serialNumber for offline work in Server mode
CurrentFileVersion: integer; // file version for OCAD version
Internal: Cardinal; //
Internal: Cardinal; //
FirstStringIndexBlk: Cardinal; // file position of the first string index block
FileNamePos: Cardinal; // file position of the file name, used for temporary files only
FileNameSize: Cardinal; // size of the file name, used for temporary files only
Internal: Cardinal; //
Res1: Cardinal; // not used
Res2: Cardinal; // not used
MrStartBlockPosition: Cardinal; // file position of mulitple represention index block
</PRE>

== Symbols ==
Each Symbol Index Block contains the position of the next Symbol Index Block and the file position of 256 symbols.
<PRE>
TSymbolIndexBlock= record // Size: 1028 Bytes
NextSymbolIndexBlock: Cardinal;
SymbolPosition: array[0..255] of integer;
end;
</PRE>
=== Base Symbol ===
The different types of symbols are defined in different structures. There is an abstract type TBaseSym, which contains the fields common to all symbols types. It is used for programming reasons, but does not exist in real OCAD files.

<PRE>
TBaseSym = packed record
Size: integer; // Size of the symbol in bytes. This depends on the type. Coordinates following the symbol are included.
SymNum: integer; // Symbol number. This is 1000 times the symbol number.
// for example:
// 203.145 is stored as 203145
Otp: byte; // Object type
// 1: Point symbol
// 2: Line symbol or Line text symbol
// 3: Area symbol
// 4: Text symbol
// 6: Line text symbol
// 7: Rectangle symbol
Flags: byte; // 1: rotatable symbol (not oriented to north)
// 4: belongs to favorites
Selected: boolean; // Symbol is selected in the symbol box
Status: byte; // Status of the symbol
// 0: Normal
// 1: Protected
// 2: Hidden
// AND 16: selected
PreferredDrawingTool: byte; // Preferred drawing tool
// 0: off
// 1: Curve mode
// 2: Ellipse mode
// 3: Circle mode
// 4: Rectangular line mode
// 5: Rectangular area mode
// 6: Straight line mode
// 7: Freehand mode
// 8: Numeric mode
// 9: Stairway mode
CsMode: byte; // Course setting mode
// 0: not used for course setting
// 1: course symbol
// 2: control description symbol
CsObjType: byte; // Course setting object type
// 0: Start symbol (Point symbol)
// 1: Control symbol (Point symbol)
// 2: Finish symbol (Point symbol)
// 3: Marked route (Line symbol)
// 4: Control description symbol (Point symbol)
// 5: Course title (Text symbol)
// 6: Start number (Text symbol)
// 7: Relay variant (Text symbol)
// 8: Text block for control description (Text symbol)
CsCdFlags: byte; // Course setting control description flags
// a combination of the flags
// 64: available in column B
// 32: available in column C
// 16: available in column D
// 8: available in column E
// 4: available in column F
// 2: available in column G
// 1: available in column H
Extent: integer; // Extent how much the rendered symbols can reach outside the coordinates of an object with
// this symbol. For a point object it tells how far away from the coordinates of the object
// anything of the point symbol can appear
FilePos: cardinal; // Used internally. Value in the file is not defined.
notUsed1: Byte;
notUsed2: Byte;
nColors: SmallInt; // Number of colors of the symbol max. 14, -1: the number of colors is > 14
Colors: array[0..13] of SmallInt; // Colors of the symbol
Description: array[0..63] of char;// Description text
IconBits: array[0..483] of byte; // Each byte represents a pixel of the icon in a 256 color palette
SymbolTreeGroup: Array[0..63] of Word; // Group ID in the symbol tree, max 64 symbol groups
</PRE>

=== Point Symbol ===
Point symbols are stored with this structure:

<PRE>
TPointSym = packed record
Size: integer; // see TBaseSym
SymNum: integer; // see TBaseSym
Otp: byte; // 1
Flags: byte; // see TBaseSym
Selected: boolean; // see TBaseSym
Status: byte; // see TBaseSym
PreferredDrawingTool: byte; // see TBaseSym
CsMode: byte; // see TBaseSym
CsObjType: byte; // see TBaseSym
CsCDFlags: byte; // see TBaseSym
Extent: integer; // see TBaseSym
FilePos: cardinal; // see TBaseSym
notUsed1: Byte;
notUsed2: Byte;
nColors: SmallInt; // see TBaseSym
Colors: array[0..13] of SmallInt; // see TBaseSym
Description: array[0..63] of char; // see TBaseSym
IconBits: array[0..483] of byte; // see TBaseSym
SymbolTreeGroup: Array[0..63] of Word; // see TBaseSym
DataSize: word; // number of coordinates (each 8 bytes) which follow this structure, each object header
// counts as 2 Coordinates (16 bytes)
Reserved: SmallInt;
end;
</PRE>

After this structure follow the symbol elements which build that Point symbol. These symbol elements are stored in the following structure. Note that these symbol elements are stored in a different way than ordinary map objects.

<PRE>
TSymElt = record
stType: SmallInt; // type of the symbol element
// 1: line
// 2: area
// 3: circle
// 4: dot (filled circle)
stFlags: word; // Flags
// 1: line with round ends
stColor: SmallInt; // color of the object. This is the number which appears in
// the colors dialog box
stLineWidth: SmallInt; // line width for lines and circles unit 0.01 mm
stDiameter: SmallInt; // Diameter for circles and dots. The line width is included
// one time in this dimension for circles.
stnPoly: SmallInt; // number of coordinates
stRes1: SmallInt; // Not used
stRes2: SmallInt; // Not used
stPoly: array[0..32767] of TPoint; // coordinates of the symbol element
end;
</PRE>

If there are several objects, they just follow each other (only the coordinates used are stored). To determine the number of objects the DataSize variable must be used.

=== Line Symbol ===
Line symbols are stored in the following structure. In the explanation the terms used in the Line Symbol dialog box are shown.

<PRE>
TLineSym = packed record
Size: integer; // see TBaseSym
SymNum: integer; // see TBaseSym
Otp: byte; // 2
Flags: byte; // see TBaseSym
Selected: boolean; // see TBaseSym
Status: byte; // see TBaseSym
PreferredDrawingTool: byte; // see TBaseSym
CsMode: byte; // see TBaseSym
CsObjType: byte; // see TBaseSym
CsCDFlags: byte; // see TBaseSym
Extent: integer; // see TBaseSym
FilePos: cardinal; // see TBaseSym
notUsed1: Byte;
notUsed2: Byte;
nColors: SmallInt; // see TBaseSym
Colors: array[0..13] of SmallInt; // see TBaseSym
Description: array[0..63] of char; // see TBaseSym
IconBits: array[0..483] of byte; // see TBaseSym
SymbolTreeGroup: Array[0..63] of Word; // see TBaseSym
LineColor: SmallInt; // Line color
LineWidth: SmallInt; // Line width
LineStyle: SmallInt; // Line style
// 0: bevel joins/flat caps
// 1: round joins/round caps
// 4: miter joins/flat caps
DistFromStart: SmallInt; // Distance from start
DistToEnd: SmallInt; // Distance to the end
MainLength: SmallInt; // Main length a
EndLength: SmallInt; // End length b
MainGap: SmallInt; // Main gap C
SecGap: SmallInt; // Gap D
EndGap: SmallInt; // Gap E
MinSym: SmallInt; // -1: at least 0 gaps/symbols
// 0: at least 1 gap/symbol
// 1: at least 2 gaps/symbols
// etc.
nPrimSym: SmallInt; // No. of symbols
PrimSymDist: SmallInt; // Distance
DblMode: word; // Mode (Double line page)
DblFlags: word; // Double line flags
// 1: Fill color on
// 2: Background color on
DblFillColor: SmallInt; // Fill color
DblLeftColor: SmallInt; // Left line/Color
DblRightColor: SmallInt; // Right line/Color
DblWidth: SmallInt; // Width
DblLeftWidth: SmallInt; // Left line/Line width
DblRightWidth: SmallInt; // Right line/Line width
DblLength: SmallInt; // Dashed/Distance a
DblGap: SmallInt; // Dashed/Gap
DblBackgroundColor: SmallInt; // Reserved
DblRes: array[0..1] of SmallInt; // Reserved
DecMode: word; // Decrease mode
// 0: off
// 1: decreasing towards the end
// 2: decreasing towards both ends
// 3: decreasing towards first symbol of line
DecSymbolSize: SmallInt; // Last symbol size
DecSymbolDistance: boolean; // Option to disable decreasing symbol distance
DecSymbolWidth: boolean; // Option to decrease symbol width (of line, circle, area elements)
FrColor: SmallInt; // Color of the framing line
FrWidth: SmallInt; // Line width of the framing line
FrStyle: SmallInt; // Line style of the framing line
// 0: bevel joins/flat caps
// 1: round joins/round caps
// 4: miter joins/flat caps
// PointedEnd := LineStyle and 2 > 0;
PrimDSize: word; // number or coordinates (8 bytes) for the Main symbol A which follow this structure.
// Each symbol header counts as 2 coordinates (16 bytes).
SecDSize: word; // number or coordinates (8 bytes) for the Secondary symbol which follow the Main symbol A
// Each symbol header counts as 2 coordinates (16 bytes).
CornerDSize: word; // number or coordinates (8 bytes) for the Corner symbol which follow the Secondary symbol
// Each symbol header counts as 2 coordinates (16 bytes).
StartDSize: word; // number or coordinates (8 bytes) for the Start symbol C which follow the Corner symbol
// Each symbol header counts as 2 coordinates (16 bytes).
EndDSize: word; // number or coordinates (8 bytes) for the End symbol D which follow the Start symbol C
// Each symbol header counts as 2 coordinates (16 bytes).
UseSymbolFlags: Byte; // 1 = end symbol, 2 = start symbol, 4 = corner symbol, 8 = secondary symbol
Reserved: Byte;
end;
</PRE>

=== Area Symbol ===
Area symbols are stored in the following structure. In the explanation the terms
used in the Area Symbol dialog box are shown. The unit of all dimensions is 0.01 mm.

<PRE>
TAreaSym = packed record
Size: integer; // see TBaseSym
SymNum: integer; // see TBaseSym
Otp: byte; // 3
Flags: byte; // see TBaseSym
Selected: boolean; // see TBaseSym
Status: byte; // see TBaseSym
PreferredDrawingTool: byte; // see TBaseSym
CsMode: byte; // see TBaseSym
CsObjType: byte; // see TBaseSym
CsCDFlags: byte; // see TBaseSym
Extent: integer; // see TBaseSym
FilePos: cardinal; // see TBaseSym
notUsed1: Byte;
notUsed2: Byte;
nColors: SmallInt; // see TBaseSym
Colors: array[0..13] of SmallInt; // see TBaseSym
Description: array[0..63] of char; // see TBaseSym
IconBits: array[0..483] of byte; // see TBaseSym
SymbolTreeGroup: Array[0..63] of Word; // see TBaseSym
BorderSym: integer; // Symbol for border line activated if BorderOn is true
FillColor: SmallInt; // Fill color activated if FillOn is true
HatchMode: SmallInt; // Hatch mode
// 0: None
// 1: Single hatch
// 2: Cross hatch
HatchColor: SmallInt; // Color (Hatch page)
HatchLineWidth: SmallInt; // Line width
HatchDist: SmallInt; // Distance
HatchAngle1: SmallInt; // Angle 1
HatchAngle2: SmallInt; // Angle 2
FillOn: boolean; // Fill is activated
BorderOn: boolean; // Border line is activated
StructMode: byte; // Structure
// 0: None
// 1: aligned rows
// 2: shifted rows
StructDraw: byte; // Structure Drawing type
// 0: Clip (until OCAD 11)
// 1: draw elements completely inside area
// 2: draw elements with center inside area
// 3: draw elements partially inside area
StructWidth: SmallInt; // Width
StructHeight: SmallInt; // Height
StructAngle: SmallInt; // Angle
StructIrregularVarX: byte; // Horizontal variation in percent from StructWidth
StructIrregularVarY: byte; // Vertical variation in percent from StructHeight
StructIrregularMinDist: SmallInt; // Minimum distance between irregular symbols
StructRes: SmallInt; // Reserved
DataSize: word; // number of coordinates (each 8 bytes) which follow this structure, each object header
// counts as 2 Coordinates (16 bytes)
end;

</PRE>

=== Text Symbol ===
Text symbols are stored in the following structure. In the explanation the terms used in the Text Symbol dialog box are shown. The unit of all dimensions is 0.01 mm, except for the font sizes which are measured in 0.1 typographical points.

<PRE>
TTextSym = packed record
Size: integer; // see TBaseSym
SymNum: integer; // see TBaseSym
Otp: byte; // 4
Flags: byte; // see TBaseSym
Selected: boolean; // see TBaseSym
Status: byte; // see TBaseSym
PreferredDrawingTool: byte; // see TBaseSym
CsMode: byte; // see TBaseSym
CsObjType: byte; // see TBaseSym
CsCDFlags: byte; // see TBaseSym
Extent: integer; // see TBaseSym
FilePos: cardinal; // see TBaseSym
notUsed1: Byte;
notUsed2: Byte;
nColors: SmallInt; // see TBaseSym
Colors: array[0..13] of SmallInt; // see TBaseSym
Description: array[0..63] of char; // see TBaseSym
IconBits: array[0..483] of byte; // see TBaseSym
SymbolTreeGroup: Array[0..63] of Word; // see TBaseSym
FontName: string[31]; // TrueType font
FontColor: SmallInt; // Color
FontSize: SmallInt; // 10 times the size in pt
Weight: SmallInt; // Bold as used in the Windows GDI
// 400: normal
// 700: bold
Italic: boolean; // true if Italic is checked
Res1: byte; // not used
CharSpace: SmallInt; // Char. spacing
WordSpace: SmallInt; // Word spacing
Alignment: SmallInt; // Alignment
// 0: Bottom Left
// 1: Bottom Center
// 2: Bottom Right
// 3: Bottom Justified
// 4: Middle Left
// 5: Middle Center
// 6: Middle Right
// 7: only in LText!
// 8: Top Left
// 9: Top Center
// 10: Top Right
// 11: only in LText!
LineSpace: SmallInt; // Line spacing
ParaSpace: SmallInt; // Space after Paragraph
IndentFirst: SmallInt; // Indent first line
IndentOther: SmallInt; // Indent other lines
nTabs: SmallInt; // number of tabulators for text symbol
Tabs: array[0..31] of longint; // Tabulators
LBOn: wordbool; // true if Line below On is checked
LBColor: SmallInt; // Line color (Line below)
LBWidth: SmallInt; // Line width (Line below)
LBDist: SmallInt; // Distance from text
Res2: SmallInt;
FrMode: byte; // Framing mode
// 0: no framing
// 1: shadow framing
// 2: line framing
// 3: rectangle framing
FrLineStyle: byte; // Framing line style
// 0: default OCAD 8 Miter
// 2: ps_Join_Bevel
// 1: ps_Join_Round
// 4: ps_Join_Miter
PointSymOn: boolean; // Point symbol is activated
PointSymNumber: integer; // Point symbol for text symbol activated if PointSymOn is true
Res3: string[18]; // not used
FrLeft: SmallInt; // Left border for rectangle framing
FrBottom: SmallInt; // Bottom border for rectangle framing
FrRight: SmallInt; // Right border for rectangle framing
FrTop: SmallInt; // Top border for rectangle framing
FrColor: SmallInt; // Framing color
FrWidth: SmallInt; // Framing width for line framing
Res4: SmallInt; // not used
Res5: wordbool; // not used
FrOfX: SmallInt; // Horizontal offset for shadow framing
FrOfY: SmallInt; // Vertical offset for shadow framing
end;
</PRE>

=== Line Text Symbol ===
Line Text symbols are stored in the following structure. In the explanation the
terms used in the Line Text Symbol dialog box are shown. The unit of all dimensions
is 0.01 mm, except for the font sizes which are measured in 0.1 typographical points.

<PRE>
TLTextSym = packed record
Size: integer; // see TBaseSym
SymNum: integer; // see TBaseSym
Otp: byte; // 6
Flags: byte; // see TBaseSym
Selected: boolean; // see TBaseSym
Status: byte; // see TBaseSym
PreferredDrawingTool: byte; // see TBaseSym
CsMode: byte; // see TBaseSym
CsObjType: byte; // see TBaseSym
CsCDFlags: byte; // see TBaseSym
Extent: integer; // see TBaseSym
FilePos: cardinal; // see TBaseSym
notUsed1: Byte;
notUsed2: Byte;
nColors: SmallInt; // see TBaseSym
Colors: array[0..13] of SmallInt; // see TBaseSym
Description: array[0..63] of char; // see TBaseSym
IconBits: array[0..483] of byte; // see TBaseSym
SymbolTreeGroup: Array[0..63] of Word; // see TBaseSym
FontName: string[31]; // TrueType font
FontColor: SmallInt; // Color
FontSize: SmallInt; // 10 times the value entered in Size
Weight: SmallInt; // Bold as used in the Windows GDI
// 400: normal
// 700: bold
Italic: boolean; // true if Italic is checked
Res1: byte; // not used
CharSpace: SmallInt; // Char. spacing
WordSpace: SmallInt; // Word spacing
Alignment: SmallInt; // Alignment
// 0: Bottom Left
// 1: Bottom Center
// 2: Bottom Right
// 3: Bottom All line
// 4: Middle Left
// 5: Middle Center
// 6: Middle Right
// 7: Middle All line
// 8: Top Left
// 9: Top Center
// 10: Top Right
// 11: Top All line
FrMode: byte; // Framing mode
// 0: no framing
// 1: shadow framing
// 2: line framing
FrLineStyle: byte; // Framing line style
// 0: default OCAD 8 and 9.0 Miter
// 2: ps_Join_Bevel
// 1: ps_Join_Round
// 4: ps_Join_Miter
Res2: string[31]; // not used
FrColor: SmallInt; // Framing color
FrWidth: SmallInt; // Framing width for line framing
Res3: SmallInt; // not used
Res4: wordbool; // not used
FrOfX: SmallInt; // Horizontal offset for shadow framing
FrOfY: SmallInt; // Vertical offset for shadow framing
end;
</PRE>

=== Rectangle Symbol ===
Rectangle symbols are stored in the following structure. In the explanation the terms used in the Rectangle Symbol dialog box are shown. The unit of all dimensions is 0.01 mm.

<PRE>
TRectSym = packed record
Size: integer; // see TBaseSym
SymNum: integer; // see TBaseSym
Otp: byte; // 7
Flags: byte; // see TBaseSym
Selected: boolean; // see TBaseSym
Status: byte; // see TBaseSym
PreferredDrawingTool: byte; // see TBaseSym
CsMode: byte; // see TBaseSym
CsObjType: byte; // see TBaseSym
CsCDFlags: byte; // see TBaseSym
Extent: integer; // see TBaseSym
FilePos: cardinal; // see TBaseSym
notUsed1: Byte;
notUsed2: Byte;
nColors: SmallInt; // see TBaseSym
Colors: array[0..13] of SmallInt; // see TBaseSym
Description: array[0..63] of char; // see TBaseSym
IconBits: array[0..483] of byte; // see TBaseSym
SymbolTreeGroup: Array[0..63] of Word; // see TBaseSym
LineColor: SmallInt; // Line color
LineWidth: SmallInt; // Line width
Radius: SmallInt; // Corner radius
GridFlags: word; // A combination of the flags
// 1: Grid On
// 2: Numbered from the bottom
CellWidth: SmallInt; // Cell width
CellHeight: SmallInt; // Cell height
ResGridLineColor: SmallInt; // Reserved
ResGridLineWidth: SmallInt; // Reserved
UnnumCells: SmallInt; // Unnumbered Cells
UnnumText: string[3]; // Text in unnumbered Cells
LineStyle: SmallInt; // Line style
// 1: flat caps
// 0: round caps
// 4: flat caps
Res2: string[31]; // not used
ResFontColor: SmallInt; // Reserved
FontSize: SmallInt; // font size
Res3: SmallInt; // not used
Res4: wordbool; // not used
Res5: SmallInt; // not used
Res6: SmallInt; // not used
end;
</PRE>

== Objects ==
Each Object Index Block contains the position of the next Object Index Block and the file position and other information of 256 objects.

=== Object Index Block ===
<PRE>
TObjectIndexBlock = record // Size: 10296 Bytes
NextObjectIndexBlock: integer;
Table: array[0..255] of TObjectIndex;
end;
</PRE>

=== OCAD Object Index===
<PRE>
TObjectIndex = packed record // Size: 40 Byte
rc: LRect; // bounding box (lower left and upper right)
Pos: integer; // file position of the object -> TOcadObject
Len: integer; // number of coordinate pairs, the size of the object in the file is then calculated by: 32 + 8*Len
// Note: this is reserved space in the file, the effective length of the object may be shorter
Sym: integer; // -4 = layout vector object
// -3 = image object, imported from DTP formats (eg AI, PDF, SVG)
// -2 = graphic object
// -1 = imported, no symbol assigned or symbol number
ObjType: byte; // 1 = Point object
// 2 = Line object
// 3 = Area object
// 4 = Unformatted text
// 5 = Formatted text
// 6 = Line text
// 7 = Rectangle object
EncryptedMode: byte; // 0 = normal
// 1 = encoded object (TOcadObject)
Status: byte; // 0 = deleted (not undo) (eg from symbol editor or course setting)
// 1 = normal
// 2 = hidden
// 3 = deleted for undo
ViewType: byte; // 0 = normal object
// 1 = course setting object
// 2 = modified preview object
// 3 = unmodified preview object
// 4 = temporary object (symbol editor or control description)
Color: SmallInt; // Color number for graphic objects, -1 for image or layout objects
Group: SmallInt; // Group number of grouped objects
ImpLayer: SmallInt; // Layer number of imported objects, 0 means no layer number
DbDatasetHash: byte; // Internal use
DbKeyHash: byte; // Internal use
end;
</PRE>

=== OCAD Object ===
<PRE>
TOcadObject = packed record //
Sym: Integer; // >0 = symbol number
// -4 = layout vector object
// -3 = from PDF, AI
// -2 = graphic object
// -1 = imported, no symbol assigned or symbol number
Otp: Byte; // object typ
_Customer: Byte; //
Ang: SmallInt; // Angle, unit is 0.1 degrees, used for
// - point object
// - area objects with structure
// - unformatted text objects
// - rectangle objects
Col: integer; // Color number for graphic objects, color value for image or layout objects
LineWidth: SmallInt; // Line width for graphic, image and layout objects
DiamFlags: SmallInt; // Line style for graphic objects
ServerObjectId: Integer; // added for server objects
Height: Integer; // Height [1/256 mm]
CreationDate: Double // creation date
MultirepresentationId: Cardinal; // id references to the main object
ModificationDate: Double // modification date
nItem: Cardinal; // number of coordinates in the Poly array
nText: Word; // number of characters in the Poly, array used for storing text for line text objects and text objects
// for all other objects it is 0. Multiply by 8 to get the length in bytes.
nObjectString: Word; // length of object string. Multiply by 8 to get the length in bytes.
nDatabaseString: Word; // length of database link. Multiply by 8 to get the length in bytes.
ObjectStringType: Byte; // type of object string in Poly array
// None = 0
// Coures setting object = 1
// Coures setting preview object = 2
// Coures setting layout object = 3
// Coures setting thematic object = 4
Res1: Byte; // not used
Poly: TDPoly; // array[0..] coordinates of the object followed by a zero-terminated string
// if nText > 0 TCord is explained at the beginning of this description
end;
</PRE>

== Parameter Strings ==
The Parameter Strings contain all the information about the setup structure, background maps,course setting and database connection.

Similar to the symbols and objects there are String Index Blocks which contain the basic information for 256 Parameter Strings and the file position of the strings.

TStringIndexBlock contains the basic information for 256 strings
<PRE>
TStringIndexBlock = record
NextIndexBlock: Cardinal; // file position of the next StringIndexBlock, 0 if this is the last StringIndexBlock
Table: array[0..255] of TStringIndex;
end;
</PRE>

TStIndex contains the basic information for 1 string:
<PRE>
TStringIndex = packed record
Pos: Cardinal; // file position of string
Len: integer; // length reversed for the string
RecType: integer; // string typ number, if < 0 then deleted string
ObjIndex: integer; // index of the object
end;
</PRE>

StringIndexBlk in the FileHeader points to the first StringIndexBlock.

The strings (null terminated) have the following structure:
* first field: all characters until the first tab (character 9). The first field can be missing (the string starts with a tab).
* tab (character 9)
* code: this is the first character after the tab
* value: all characters until the next tab
* tab
* code
* value
* ...

Some of String Types (number < 1000) may have multiple instances of the same type. They have to be stored as lists.

<PRE>
si_Course = 2;
// First = CourseName
// C = Climb
// E = Extra distance
// F = from start number (auto created class)
// H = ClassName for control description (imported from event software)
// K = Combination (imported from event software)
// M = Map file
// R = number of runners/teams (auto created class)
// S = Map scale
// T = to start number (auto created class)
// Y = Course type (s = relay, o = one-man relay)
// L = Number of Legs (used for relay and one-man relay)
// s = start
// c = control
// m = marked route
// k = mandatory crossing point
// w = mandatory passage through out of bounds area
// g = map change
// f = finish
// l = leg variation starts
// b = branch of a leg variation starts
// p = end of a leg variation
// r = relay variation starts
// v = branch of a relay variation starts
// q = end of a relay variation
// e = used internally only (control number)
// i = used internally only (back to begin of variation)
// j = used internally only (line to end of variation)
// n = course name object
// u = start number object
// t = text block for control description
// o = other object
</PRE>
<PRE>
si_CsClass = 3;
// First = class name
// c = Course name
// f = FromNumber (relay)
// r = Number of runners
// t = ToNumber (relay)
</PRE>
<PRE>
si_DataSet = 4;
// First = dataset name
// e = dBase file
// d = ODBC data source
// u = database user name (encrypted)
// p = database password (encrypted)
// t = table
// k = key field
// r = secondary table, reference key
// s = secondary table, table key
// m = secondary table, key
// y = symbol field
// b = Assign new symbol when changing field value [boolean, false]
// x = text field
// f = size field
// l = length unit
// a = area unit
// c = decimals
// h = easting field
// v = northing field
// g = angle field
// j = date field
</PRE>
<PRE>
si_OimFile = 6;
</PRE>
<PRE>
si_BackgroundMap = 8;
// First = file name
// a = angle omega [double, 8]
// b = angle phi [double, 8]
// d = dim
// o = render with spot colors (only for raster background maps)
// p = assigned to spot color (only for raster background maps)
// q = subtract from spot color (0 = normal, 1 = subtract)
// r = visible in background favorites (0 = hidden, 1 = visible)
// s = visible in normal, spot color and draft mode (0 = hidden, 1 = visible)
// t = transparent
// x = offset x [double, 6]
// y = offset y [double, 6]
// u = pixel size x [double, 10]
// v = pixel size y [double, 10]
// i = is infrared image (0=undefined, 1=32bit-infrared, 2=32bit RGB)
// m = is WMS online background map
// k = WMS server name
// l = WMS layer name
// n = WMS layer scale range
</PRE>
<PRE>
si_Color = 9;
// First = name
// n = number
// c = cyan
// m = magenta
// y = yellow
// k = black
// o = overprint
// t = transparency
// s = spot color separation name
// p = percentage in the spot color separation
</PRE>
<PRE>
si_SpotColor = 10;
// First = name
// v = visible
// n = number
// f = frequency (lpi)
// a = angle
// c = cyan
// m = magenta
// y = yellow
// k = black
</PRE>
<PRE>
si_Zoom = 12;
// x = offset x
// y = offset y
// z = zoom
</PRE>
<PRE>
si_ImpLayer = 13;
// First = Name
// n = layer number
</PRE>
<PRE>
si_OimFind = 14;
// First = Name
// c = Condition
// d = Dataset
// f = From zoom
// h = Hint field
// n = Name field
// o = Hotspot type
// p = Pointer type
// s = Show hotspots
// l = List names(in listbox)
// t = To zoom
// u = URL field
// x = Prefix
// y = Postfix
// z = Target
// r = Pointer color red
// g = Pointer color green
// b = Pointer color blue
// R = Hotspot color red
// G = Hotspot color green
// B = Hotspot color blue
</PRE>
<PRE>
si_SymTree = 15;
// First = name
// g = group id
// v = visible
// e = is node expanded (boolean)
// i = Level in Tree
</PRE>
<PRE>
si_Bookmark = 18;
// First = bookmark name
// d = description
// x = offset x
// y = offset y
// z = zoom
</PRE>
<PRE>
si_Selection = 19;
// First = selection name
// n = number
// o = object ids
</PRE>
<PRE>
si_Group = 23;
// First = Name
// n = group number
</PRE>
<PRE>
si_RecentDocs = 24;
// First = file name
</PRE>
<PRE>
si_CsAutoCdAllocationTable = 25;
// First = Map symbol number (STRING)
// a = Control description symbol 0 (STRING)
// b = Control description symbol 1 (STRING)
// c = Control description symbol 2 (STRING)
// d = Control description symbol 3 (STRING)
// e = Control description symbol 4 (STRING)
// f = Control description symbol 5 (STRING)
// g = Control description dragged direction (STRING)
// h = Control description click (STRING)
</PRE>
<PRE>
si_RulerGuidesList = 26;
// h = horizontal guide (0=vertical, 1=horizontal)
// c = x or y ccordiante (INTEGER, OCAD coordinate)
</PRE>
<PRE>
si_LayoutObjects = 27;
// First = path for images; description for vector objects
// r = type: raster image object = 1; vector object = 0
// s = visible (0 = hidden, 1 = visible)
// a = angle omega
// b = angle phi
// d = dim
// t = transparent
// x = offset x
// y = offset y
// u = pixel size x
// v = pixel size y
// i = is infrared image (0=undefined, 1=32bit-infrared, 2=32bit RGB)
// n = ObjectIndex
</PRE>
<PRE>
si_PrintAndExportRectangleList = 29;
// First = Name
// b = bottom [integer, ocad unit]
// l = left [integer, ocad unit]
// r = right [integer, ocad unit]
// t = top [integer, ocad unit]
</PRE>
<PRE>
si_DisplayPar = 1024;
// f = Show symbol favorites
// g = selected symbol group
// s = selected symbol
// t = Show symbol tree
// h = horizontal splitter (pixel from top)
// v = vertical splitter (pixel from right)
// b = horizontal splitter for background map panel (pixel from top)
// i = display mode for unsymbolized objects (0=normal, 2=hidden)
// j = display mode for graphic objects (0=normal, 2=hidden)
// k = display mode for image objects (0=normal, 1=protect, 2=hidden)
// l = display mode for layout objects (0=normal, 2=hidden)
</PRE>
<PRE>
si_DemClassifyVegetationClassList = 30; //11-1112
// First = Name
// a = fromHeight100
// b = toHeight100
// c = fromColorCyan
// d = fromColorMagenta
// e = fromColorYellow
// f = fromColorBlack
// g = toColorCyan
// h = toColorMagenta
// i = toColorYellow
// j = toColorBlack
</PRE>
<PRE>
si_CsTextBlock = 31;
</PRE>
<PRE>
si_ThematicMapThemes = 32; //12-0192
</PRE>
<PRE>
si_ThematicMapVisualizationProperties = 33; //12-0192
</PRE>
<PRE>
si_ThematicMapObjects = 34; //12-0192
</PRE>
<PRE>
si_Layers = 35; //12-0192
</PRE>
<PRE>
si_SymbolStatusManager = 36;
// First = Name
// s = status string
</PRE>
<PRE>
si_MrBoundRects = 50;
</PRE>
<PRE>
si_MrProjectMatrix = 51;
</PRE>
<PRE>
si_MrOptions = 52;
</PRE>
<PRE>
si_DisplayPar = 1024;
// f = Show symbol favorites
// g = selected symbol group
// s = selected symbol
// t = Show symbol tree
// h = horizontal splitter (pixel from top)
// v = vertical splitter (pixel from right)
// b = horizontal splitter for background map panel (pixel from top)
// i = display mode for unsymbolized objects (0=normal, 2=hidden)
// j = display mode for graphic objects (0=normal, 2=hidden)
// k = display mode for image objects (0=normal, 1=protect, 2=hidden)
// l = display mode for layout objects (0=normal, 2=hidden)
</PRE>
<PRE>
si_OimPar = 1025;
// First = OpenLayers
// a = Anti-Aliasing [boolean]
// b = Border width [integer]
// A = Map title [string]
// C = Map subtitle [string]
// D = Base layer name [string]
// E = Editlayer enable [boolean]
// F = Searchbox enable [boolean]
// s = Search/listbox with selection [boolean]
// m = Do not create tiles [boolean]
// H = Show layer selector [boolean]
// I = Show overview map [boolean]
// i = Show overview map maximized [ boolean]
// K = Show mouse coordinates [boolean]
// P = Show Permalink [boolean]
// J = Font size in pt [integer]
// L = Subheader fontsize in pt [integer]
// R = Site background color red [integer: 0..255]
// G = Site background color green [integer: 0..255]
// B = Site background color blue [integer: 0..255]
// M = Border color [string] as hex e.g.: 00FF00 must be exact 6 values
// N = Header font color [string] as hex exapmle see border color
// O = Header background color [string] as hex
// T = Subheader font color [string] as hex
// Q = Subheader background color [string] as hex
// X = Filename of last Safeplace [string]
// f = Generate map from zoomlevel [integer]
// t = Generate map to zoomlevel [integer]
</PRE>
<PRE>
si_PrintPar = 1026;
// a = print scale
// l = landscape
// c = print (0 = color map, 1 = spot color separation)
// g = print screen grid
// d = screen grid color
// i = intensity
// w = additional width for lines and dots
// r = Range (0 entire map, 1 part of map, 2 one page)
// L = part of map left
// B = part of map bottom
// R = part of map right
// T = part of map top
// x = horizontal overlap
// y = vertical overlap
// b = print black (course setting only)
// m = Mirror (course setting only)
// s = HorScal (course setting only)
// t = VerScal (course setting only)
// p = reference point for part of map setup ([0..8])
</PRE>
<PRE>
si_CdPrintPar = 1027;
// s = Size
</PRE>
<PRE>
si_DefaultBackgroundMapsPar = 1028;
// s = default scale
</PRE>
<PRE>
si_EpsPar = 1029;
// r = EPS resolution
</PRE>
<PRE>
si_ViewPar = 1030;
// b = draft mode IGN for ocad-map [int: 0..100]
// c = draft mode IGN background maps [int: 0..100]
// d = hidden background maps
// m = draft mode for ocad-map [int: 0..100]
// t = draft mode background maps [int: 0..100]
// v = view mode (0=normal, 1=spot colors, 2=draft, 3=draft IGN)
// x = offset x
// y = offset y
// z = zoom
// h = hatch areas (0 = normal, 1 = hatched)
// k = keyline mode (0 = normal, 1 = keyline)
// i = map visible
// l = hidden layout
// OLD: a, p, s
</PRE>
<PRE>
si_CoursePar = 1031;
// a = create classes automatically
// b = background for control description
// B = draw white background also in draft mode (BOOL)
// c = numbering (0 = number, 1 = number and code, 2 = code only)
// d = control descriptions for all controls
// e = event title
// f = control frequencies (0 = number and frequencies, 1 = frequencies only)
// h = thicker horizonal line in control description (0=not, 1=every third, 2=every fourth)
// i = maximal length of control description (number of rows)
// l = distance to connection line
// n = distance to number
// o = lock for cs object positions (0=unlocked, 1=locked) (BOOL)
// p = fullstop after control number (BOOL)
// q = lock for cs courses (0=unlocked, 1=locked) (BOOL)
// r = export relay combinations
// s = cell size control description
// t = course title
// u = punching system (0=SportIdent, 1=Emit, 2=other) (Integer)
// w = write number of start to control description (BOOL)
</PRE>
<PRE>
si_TiffPar = 1032;
// c = compression (1 = no compression, 2 = CCITT, 4 = FaxG4, 5 = LZW)
</PRE>
<PRE>
si_TilesPar = 1033;
// w = width
// h = height
</PRE>
<PRE>
si_DbPar = 1034;
// d = dataset
// l = last code
// n = create new record
</PRE>
<PRE>
si_ExportPar = 1035;
// First = Format (AI, BMP, DXF, GIF, JPEG, OIM, PDF, Shape, SVG, TIFF)
// a = Anti-Aliasing
// b = combined spot colors
// c = color format (0 = 24 bit, 1 = 256 colors, 2 = grayscale, 3 = 1 bit, 4 = halftone screen)
// g = Raster (geo-referenced)export mode 0 = resolution, 1 = pixel size
// i = pixel size (in Meter)
// l = color correction (0 off, 1 on)
// o = spot color separations (0=CMYK, 1=spot colors)
// p = part of map (0 off, 1 on)
// q = JPEG quality (INTEGER, [0..100])
// r = resolution
// s = scale
// t = tiles (0 off, 1 on)
// w = world file
// z = compressed svg file (0 off, 1 on)
</PRE>
<PRE>
si_CsExpTextPar = 1037;
// C = classes (0 = courses, 1 = classes)
// L = export climbing (0 = off, 1 = on)
</PRE>
<PRE>
si_CsExpStatPar = 1038;
// C = classes (0 = courses, 1 = classes)
// a = separator 1
// b = tab 1
// c = separator 2
// d = tab 2
// e = separator 3
// f = tab 3
</PRE>
<PRE>
si_ScalePar = 1039;
// a = real world angle
// b = additional local easting offset in m
// c = additional local northing offset in m
// d = grid distance for real world in m [double, 6]
// g = grid distance for paper coordinates in mm [double, 6]
// i = grid and zone
// m = map scale
// r = real world cord (0 = paper, 1 = real world)
// x = real world offset easting
// y = real world offset northing
</PRE>
<PRE>
si_DbCreateObjPar = 1040;
// c = condition
// d = dataset
// t = text field
// m = unit of measure (m = m, km = km)
// u = horizontal offset
// v = vertical offset
// x = horizontal field
// y = vertical field
</PRE>
<PRE>
si_SelectedSpotColors = 1041;
</PRE>
<PRE>
si_XmlScriptPar = 1042;
// f = last used file
</PRE>
<PRE>
si_BackupPar = 1043;
// p = path
</PRE>
<PRE>
si_ExportPartOfMapPar = 1044;
// b = boundary (0=rectangular boundries, 1=selected object for boundries)
// s = export with selected object (0=false, 1=true)
// r = reference point for part of map setup ([0..8])
// l = export database links (0=false, 1=true)
</PRE>
<PRE>
si_DemPar = 1045;
// First = file
// l = DEM loaded
// f = Frame visible
// i = last used import folder
</PRE>
<PRE>
si_GpsImportFilePar = 1046;
// a = assign symbol (true/false)
// t = symbol number for tracks
// w = symbol number for waypoint
</PRE>
<PRE>
si_ImportCsv = 1047;
// n = point symbol number
// t = text symbol number
</PRE>
<PRE>
si_RelayCoursesDialog = 1048;
// First = last exported or printed course (STRING)
// l = legs (-1=All) (INT)
// p = variants selected (0=start numbers, 1=variants) (BOOL)
// s = start number (-1=All) (STRING)
// v = variants index (-1=All) (INT)
</PRE>
<PRE>
si_CsAutoControlDescription = 1049;
// First = ocd background map file name for auto control description (STRING)
// a = auto control description (0=off, 1=off) (BOOL)
</PRE>
<PRE>
si_GpxExportPar = 1050;
// First = description
// a = author
// k = keywords
// r = routes or tracks (true = routes, false = tracks)
</PRE>
<PRE>
si_KmlInfo = 1051;
// Description in ExpKml.pas
</PRE>
<PRE>
si_GpsRouteAnalyzer = 1052;
// First = Project file
</PRE>
<PRE>
si_CoordinateSystemPar = 1053; // only used for user defined grid
//First = description
// d = datumId
// e = ellipsoidId
// x = ellipsoid axis
// t = ellipsoid flattening
// r = projectionId
// m = false easting
// n = false northing
// f = scale factor
// c = central meridian
// o = longitude of origin
// a = latitude of origin
// s = standard parallel 1
// p = standard parallel 2
// l = location
// z = azimuth
// g = EPSG code
</PRE>
<PRE>
si_GraticulePar = 1054;
// h = horizontal distance
// v = vertical distance
// l = symbol number for grid lines
// t = symbol number for text labels
</PRE>
<PRE>
si_GraticuleNameIndexPar = 1055;
// s = style
// x = index origin of longitude
// y = index origin of latitude
// h = horizontal distance
// v = vertical distance
</PRE>
<PRE>
si_KmzExportPar = 1056;
// first = Name: string
// t = Tiles: integer (0 = no tiles, 1 = Garmin Custom Maps optimized, 2 = tiles)
</PRE>
<PRE>
si_LegendPar = 1057;
// u = show only Used Symbols
// v = show also hidden symbols
// h = icon Height
// w = icon Height
// y = line Spacing100
// p = show Point Symbols
// l = show Point Symbols
// a = show Point Symbols
// r = show Point Symbols
// t = show Point Symbols
// z = show Point Symbols
// d = description Symbol
// s = show Symbol Number
</PRE>
<PRE>
si_RulersPar = 1058;
// no First
// s = show (0=false, 1=true)
// x = ruler origin x (INTEGER, OCAD coordinate)
// y = ruler origin y (INTEGER, OCAD coordinate)
// m = move also ruler guides (0=false, 1=true)
</PRE>
<PRE>
si_RulerGuidesPar = 1059;
// no First
// s = show (0=false, 1=true)
// l = lock (0=false, 1=true)
</PRE>
<PRE>
si_DbOptions = 1060;
// c = create record when cutting object (0=false, 1=true)
// d = delete record when deleting object (0=false, 1=true)
</PRE>
<PRE>
si_MapNotes = 1061;
// First = text
</PRE>
<PRE>
si_SendFileByEmail = 1062;
// First = subject
// t = to
// d = add loaded DEM (0=false, 1=true)
// a = add loaded databases (0=false, 1=true)
// b = add loaded databases (0=false, 1=true)
// l = add loaded databases (0=false, 1=true)
</PRE>
<PRE>
si_MapGridPar = 1063;
// a = angle
// e = easting offset
// n = northing offset
// h = horizontal (easting) distance
// v = vertical (northing) distance
// x = create easting grid lines
// y = create northing grid lines
// j = create vertices at grid junctions
// l = symbol number for grid lines
// s = grid labels
// t = symbol number for text labels
</PRE>
<PRE>
si_DemSlopePar = 1064;
// m = Method: 0 = continuous; 1 = black/white
// c = Slope for black pixels in continuous method
// b = Slope for black pixels in black/white method
// l = load slope map as background map
</PRE>
<PRE>
si_DemProfilePar = 1065;
// First = profile template path
// a = scale option (0=auto-scale, 1=used defined scale)
// c = scale
// d = distance unit (0=km, 1=m)
// g = show grid (0=false, 1=true)
// m = time unit (0=h:mm)
// r = round time steps (0=no round, 5=round to 5 minutes, 10=round to 10 minutes)
// t = show text at the bottom of the profile (0=false, 1=true)
// x = length resolution
// z = elevation resolution
// k = elevation factor
</PRE>
<PRE>
si_DemHillshadingPar = 1066;
// m = Method: 0 = simple; 1 = combined
// a = azimut
// c = DEM cell size (0=false, 1=true)
// d = declination
// e = exaggeration
// i = interpolation mode (INTEGER)
// l = load hillshading as background map
// r = resolution
</PRE>
<PRE>
si_DemHypsometricMapPar = 1067;
// c = color ramp type [0..2] (INTEGER)
// l = load hillshading as background map
// w = use white color for elevation 0 (0=false, 1=true)
</PRE>
<PRE>
si_DemClassifyVegetationPar = 1068;
// m = Method: 0 = grayscale; 1 = colored
// g = Grayscale color ramp: 0 = linear, 1 = quadratic negative, 2 = quadratic positive
// l = load hillshading as background map
</PRE>
<PRE>
si_ShapeExportPar = 1069;
// a = item 'area objects' selected (0=false, 1=true)
// c = create projection file
// d = dataset ['all' = All Objects or name of dataset]
// l = item 'line objects' selected (0=false, 1=true)
// p = item 'point objects' selected (0=false, 1=true)
// r = replace word wrap by tilde (0=false, 1=true)
// t = item 'text objects' selected (0=false, 1=true)
// u = UTF-8 Encoding (0=false, 1=true)
</PRE>
<PRE>
si_DxfExportPar = 1070;
// a = convert text from ANSI to OEM (0=false, 1=true)
// o = convert text from OEM to Unicode (0=false, 1=true)
// s = only objects with selected symbol (0=false, 1=true)
// l = add symbol description in DXF layer name (0=false, 1=true)
// e = export OCAD Curves as DXF splines (0=false, 1=true)
// c = coordinates (0=m, 1=mm)
</PRE>
<PRE>
si_DemImportLasPar = 1071;
// u = unclassified
// g = ground
// l = low vegetation
// m = mean vegetation
// h = high vegetation
// b = buildings
// w = water class
// o = other class
// r = Return option
</PRE>
<PRE>
si_MapRoutingPar = 1072;
// f = from (0=Location, 1=Coordinate)
// l = from location
// e = from easting
// n = from northing
// T = to (0=Location, 1=Coordinate)
// L = to location
// E = to easting
// N = to northing
// d = add driving directions (0=false, 1=true)
</PRE>
<PRE>
si_ServerOfflineBaseObjectList = 1073;
</PRE>
<PRE>
si_SmoothPar = 1074;
// s = smooth tolerance
// a = keep vertices if angle change is greater then
// c = angle change tolerance
// d = keep vertices if curvature direction changes
</PRE>
<PRE>
si_GeneralizePar = 1075;
// a = delete vertices if angle change is less than
// c = angle change tolerance
// f = area factor (percent)
// g = generalization type: 0=simplification; 1=rectangle; 2=corner; 3=series
// i = keep corner vertices
// j = keep dash vertices
// n = number of rectangles
// r = rectangle option: 0=rectangle for each object; 1=one rectangle for all objects; 2=corner; 3=series
// t = offset tolerance (1/100mm)
</PRE>
<PRE>
si_PolylineToCurvePar = 1076;
// t = tangent length factor
// a = keep angle at polyline start/end
// i = Keep incontinuity if angle change is greater than
// v = angle incontinuity value
</PRE>
<PRE>
si_IntersectionPar = 1077;
// a = intersection option (0=insert vertex, 1=cut line, 2=add point object)
// v = vertex type (0=normal, 1=corner, 2=dash)
// s = point symbol number
// t = handle touching points as intersections
</PRE>
<PRE>
si_OcdLasPar = 1078;
// First = file
// l = DEM loaded
// f = Frame visible
</PRE>
<PRE>
si_ThematicMapPar = 1079;
// First = title
// a = title color
// b = title opacity
// c = title font name
// d = title font size
// e = title isBold
// f = title isItalic
// g = title alignment
// h = map height
// i = Actual theme
// m = additional information text color
// n = additional information text opacity
// p = additional information text font name
// q = additional information text font size
// r = additional information text isBold
// s = additional information text isItalic
// t = additional information text alignment
// w = map width
// x = additional information text
</PRE>
<PRE>
si_ThematicMapLegendPar = 1080;
// First = EMPTY
// a = legend title color
// b = legend title opacity
// c = legend title font name
// d = legend title font size
// e = legend title isBold
// f = legend title isItalic
// g = legend title alignment
// m = legend text color
// n = legend text opacity
// p = legend text font name
// q = legend text font size
// r = legend text isBold
// s = legend text isItalic
// t = legend text alignment
// v = add theme legend
// w = add basemap legend
</PRE>
<PRE>
si_ThematicMapScaleBarPar = 1081;
// First = EMPTY
// c = scale bar color
// d = scale bar line width
// m = scale text color
// n = scale text opacity
// p = scale text font name
// q = scale text font size
// r = scale text isBold
// s = scale text isItalic
// t = scale text alignment
// v = add scale bar
// w = add scale text
</PRE>
<PRE>
si_SelectObjectsByDatePar = 1082;
// c = Creation data checked (boolean: 0=false, 1=true)
// f = from dataTime (double)
// t = to dataTime (double)
// a = All objects checked (boolean: 0=false, 1=true)
</PRE>
<PRE>
si_DemCreateContourLinesPar = 1083;
// a = equidistance level 1, multiplyed by 100 (cardinal)
// b = equidistance level 2, multiplyed by 100 (cardinal)
// c = equidistance level 3, multiplyed by 100 (cardinal)
// d = symbol number level 1 (cardinal)
// e = symbol number level 2 (cardinal)
// f = symbol number level 3 (cardinal)
</PRE>

File:GeoPackageImport2.png

2025-06-12T06:40:33Z

GRS: GRS uploaded a new version of File:GeoPackageImport2.png

File:GeoPackageImport3.png

2025-06-12T06:40:11Z

GRS: GRS uploaded a new version of File:GeoPackageImport3.png

OCAD Preferences

2025-04-25T07:17:09Z

GRS: /* Scale Cursor Size */

[[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]

The OCAD Prefernces can be set in the '''[[Options]]''' menu.

''Some preferences are not available in the '''OCAD Starter''' and '''OCAD Course Setting''' editions.''
==GUI (Graphical User Interface)==
[[File:OcadPreferences UserInterface.png]]
===Right click in drawing area opens context menu===
If enabled, the context menu is shown by clicking on the drawing area with the right mouse button. 

[[File:ContextMenu.png]] 

[[File:ChangeToStraightLineMode.gif]]

In the upper part of the '''Context''' menu, you can switch between the current '''[[Drawing_an_Object|Drawing Mode]]''', the [[File:Icon SelectAndEditObject.PNG]] '''[[Select#Select and Edit Object|Select and Edit Object]]''' mode and the [[File:Icon SelectObjectAndEditVertex.PNG]] '''[[Select#Select Object and Edit Vertex|Select Object and Edit Vertex]] mode. 
In the lower part of the '''Context''' menu, you can change the view either with the [[File:Icon Pan.PNG]] '''[[View#Pan|Pan]]''', [[File:Icon ZoomIn.PNG]] '''[[View#Zoom_In|Zoom In]]''', [[File:Icon ZoomOut.PNG]] '''[[View#Zoom_Out|Zoom Out]]''' or the [[File:Icon ShowEntireMap.PNG]] '''[[View#Show_Entire_Map|Show Entire Map]]''' tool. 
 
If disabled, you can switch between the current '''[[Drawing_an_Object|Drawing Mode]]''' and the [[File:Icon SelectObjectAndEditVertex.PNG]] '''[[Select#Select Object and Edit Vertex|Select Object and Edit Vertex]]''' mode by clicking on the drawing area with the right mouse button.

=== Right mouse click toggles between drawing and editing tools===
This option is only activated if the '''Context menu in drawing area''' option is deactivated.

We recommend to deactivate this option when drawing on a tablet with a pen. In this case OCAD ignores the right click during drawing.

===Wider splitter between drawing area and symbol box===
If this option is enabled, the splitter between the symbol box and the drawing area appears wider as usual. This feature may improve the user-friendliness. 
[[File:WiderSplitter.PNG]]

===Toolbars===
Show or Hide the following toolbars in this field:

* '''[[Graphical_User_Interface#Editing_and_Drawing_Toolbar|Editing and Drawing Toolbar]]'''
* '''[[Graphical_User_Interface#Edit_Functions_Toolbar|Edit Functions Toolbar]]'''
* '''[[Graphical_User_Interface#Mobile_Toolbar|Mobile Toolbar]]'''
* '''[[Graphical_User_Interface#Numeric_Keypad_Toolbar|Numeric Keypad Toolbar]]'''
* '''[[Graphical_User_Interface#Sketch_Toolbar|Sketch Toolbar]]'''
* '''[[Graphical_User_Interface#Standard_Toolbar|Standard Toolbar]]'''
* '''[[Graphical_User_Interface#View_Toolbar|View Toolbar]]'''

Click the '''Reset''' button to reset the toolbar positions to the default settings. Please restart OCAD for the changes to take effect. This function is sometimes used if an undocked toolbar outside the screen.

Click the '''Customize''' button to add or remove icons to/from the toolbars.

===Status bar===
Choose the format of the coordinates appearing in the [[Graphical_User_Interface#Status_Bar|Status Bar]] in this box. 
[[File:StatusBarSettings.PNG]]

===Style===
Change the virtual appearance of the GUI by choosing one in the dropdown list.

===Reset docking panels===
Reset the docking panels (symbol box, GPS box and database box). OCAD restart needed to take effect.

Use this function if the symbol box is hidden.

==File==
[[File:OcadPreferences File.png]]
=== Auto file load when opening OCAD ===
Check this box to load the last map you worked on automatically when OCAD is started. Otherwise no map will be loaded.

=== Clear file history ===
Click this button to clear the file history from [[File#Open_Recently_Exported_Documents|Recently Exported Documents]] and [[File#Open_Recently_Used_OCAD_Files|Recently Used OCAD Files]].
If a drive from the file history files does not exist anymore, e.g. disconnected network drives, it may needs more time to open the [[File| File menu]]. This function solves the problem.

===Create ocd file association===
Click this button to associate the running OCAD edition with .ocd files.
OCAD must run as administrator to execute this function (change file association in Windows Registry).

[[File:Create ocd file association.png]]

Confirm to run as administrator.

[[File:CreateOcdFileAssociation2.png]]

Alternatively, go to '''Settings>Apps>Default apps''' and '''Chosse default apps by file type'''.

[[File:Hint.jpg]] Normally, default file type for .ocd files is set during installation. However, if you run OCAD in the Cloud, the default file type is not set.

=== Temporary OCAD Folder ===
While working on an open file OCAD is saving all changes to temporary file(s) in a tmp folder. This folder can be changed here. By default it is C:\Users\[USERNAME]\AppData\Roaming\OCAD\tmp.

OCAD saves the WMS images in this folder.

=== Ghostscript File Path ===
OCAD using Ghostscript to converting a pdf background map to a jpg file when [[Background_Map#Open_a_Background_Map|opening the pdf file]].

[https://ghostscript.com/releases/gsdnld.html Download] and install Ghostscript.

After the installation click the '''Choose (...)''' button to set the file path of the Ghostscript exe program file (e.g. ''C:\Program Files\gs\gs9.55.0\bin\gswin64.exe'').

[[File:GhostscriptFilePathNew.png]]

===Auto-backup===
Activate the checkbox '''Create auto-backup when opening OCAD file''' and every time you open an .ocd-file, OCAD will save a backup of this file. You can also create a backup manually by using the [[Create_Backup|'''Create Backup''']] funktion in the '''File''' menu.

Click the '''Choose''' button to set a file path for the auto-backup. 
Activate '''Compress file''' to save disk space.

[[File:Hint.jpg]] Remember to clean out the auto-backup directory from time to time.

[[File:Auto-backup.png]]

===Default coordinate system===

Set here the default coordinate system for your template files.

[[File:DefaultCoordinateSystem.png]]

==View==
[[File:OcadPreferences View.png]]
===User defined zoom in menu item===
Enter a value to specify the [[View#User_Defined|User Defined Zoom]]. Choose '''User Defined''' in the '''View''' menu to apply the specified zoom to the map.

===Use mouse wheel to zoom in and out instead of scrolling===
Use mouse the wheel to zoom in and out instead of scrolling.

Use ''CTRL + mouse wheel'' for vertical scrolling. 
Use ''CTRL + SHIFT + mouse wheel'' for horizontal scrolling.

[[File:Mousewheelscrolling.gif]]

===View mode loop===
With the '''View mode loop''' tool you can easily switch between different view modes. Select the view modes you want to switch between in the '''View mode loop''' box in the '''View''' category of '''OCAD Preferences'''. 
To use the '''View mode loop''' you have to define a '''[[Shortcuts|Shortcut]]''' for '''View - View Mode Loop'''. Afterwards you can switch between the set view modes using the '''[[Shortcuts|Shortcut]]'''.

Visit the '''[[View Mode#View Mode Loop|View Mode Loop]]''' article to get more information about this function.

===Color Correction===
On some monitors colors and gamma of the map are not displayed correctly. Use the controller to regulate the color and gamma manually. Click on the '''Standard''' button to set the '''Color Correction''' back to default.

===Redraw background automatically===
If this option is enabled, the map is redrawn after every single modification of the map (This may reduce the performance of OCAD). Otherwise you have to press the '''F5''' key or select '''Redraw''' in the '''View''' menu to redraw the map. 

[[File:RedrawBackgroundAutomatically.PNG]]

===Faster text rendering===
Enable the '''Faster text rendering''' option to render text faster and less precisely. This may increase the performance of OCAD. 

[[File:FasterTextRendering.PNG]]

===Screen Grid===
[[File:OCADPreferencesScreenGrid.PNG]]

In this section of the '''OCAD Preferences''' the color and the appearance of the '''[[View#Show Screen Grid|Screen Grid]]''' can be changed.

Change the '''Color''' by clicking the [[File:Icon_Setup.PNG]] '''Setup''' icon.

Click the '''Default''' button to reload the default gray color.

Choose a '''Style''' from the dropdown menu. The '''[[View#Show Screen Grid|Screen Grid]]''' can either be '''Solid''', '''Dashed''' or '''Dotted'''.

==Select==
[[File:OcadPreferences Select.png]] 
You can choose between two modes to select multiple objects:
* All objects must be with at least one vertex in the selection.
* All objects must be completely in the selection. 
[[File:OCADPreferences Select.gif]]

You can find more information about selecting multiple objects on this page: '''[[Select#Select and Edit Multiple Objects|Select and Edit Multiple Objects]]'''.

==Object==
[[File:OcadPreferences Object.png]]
===Object stretching===
If this option is activated, you are able to stretch objects in the [[File:Icon SelectAndEditObject.PNG]] '''[[Select#Select and Edit Object|Select and Edit Object]]''' mode. 
You can find more about stretching objects on this page: '''[[Select#Select and Edit Object|Select and Edit Object]]'''.

===Unsymbolized objects===
Choose a color for [[Unsymbolized Objects]] by clicking on the '''Setup''' [[File:Icon_Setup.PNG]] icon. The '''Color Picker''' dialog appears and you can configure the color.

==Drawing and Editing==
[[File:OcadPreferences Drawing.png]]
===Drawing Bézier curves===
Choose the preferred mode for drawing curves.
*In OCAD mode, only the direction of a dragged tangent is used. The distance from the normal vertices to the curve vertices is calculated automatically. This is the recommended mode.
*In Illustrator mode, the length of the dragged tangent is used to calculate the distance of the curve vertex.

[[File:OCADPreferences Bezier.gif]]

You can find more about drawing curves on the following page: '''[[Drawing an Object#Draw a Curve|Draw a Curve]]'''

=== Curve mode: Change to straight line mode when clicking in drawing area ===
Check this box to draw straight lines also in curve mode. See more in '''[[Drawing_an_Object#Change_to_Straight_Line_Mode|Change to Straight Line Mode]]'''

===Convert freehand to curve when drawing===
Check this box to convert lines and areas to curves when drawing in freehand mode. Otherwise they remain as polygons. The settings made in the '''Smooth when drawing freehand''' dropdown list of the '''Tolerances''' field determine the smoothing level. 
[[File:Freehand_To_Curve.PNG]]

===Freehand mode: Adapted for tablet with pen===
If you work with tablet and a pen, using the Frehand mode will be much more confortable with this option as you can draw objects like intended. 
Without this option, you would need to lift your pen some milimeters over your tablet when drawing an object. 
See video here a [https://youtu.be/Kd_ffinXkR0 video on YouTube]. 

[[File:FreehandModeforTablet.png]]

===Close Area Objects===
OCAD closes drawn area objects automatically if this option is checked. That means, if the start and end point of the object are different, OCAD adds an end point with the same position as the start point.

Choose [[Topology#Close_Area_Objects|'''Close Area Objects''']] in the '''Topology''' part of the '''Object''' menu to close already drawn area objects. 
[[File:Close_Area_Objects_When_Drawing.PNG]]

===Move closed start and end points of line and area objects together===
When this option is switched on, and the start and end points of a line or area object coincide (the line is closed), they are moved together during editing. If you move the start point, then the end point will also move. 
[[File:OCADPreferences MoveEndPoints.gif]]

=== Move line and area segments===
Activate this option to be able to move line and area segments. 
[[File:MoveSegments.gif]]

=== Join affects all line symbols in symbol group ===
When this option is switched on, OCAD [[Topology#Join|joins]] the ends of selected line objects that are in the same [[Symbol_Box#Symbol_Tree|symbol group]] (symbol tree). If deactivated, OCAD only joins if the line objects have the same symbol.

The option affects the [[File:Icon_Join.PNG]] [[Topology#Join|Join function]] and [[File:Icon_AutomaticJoining.PNG]] [[Topology#Automatic_Joining|Automatic Joining]] during drawing.

===Following existing objects===
Uncheck the '''Side lines of double lines''' option if side lines of double lines should not be traced when you are following existing lines. You can find more about this topic on the '''[[Drawing an Object#Following Existing Objects|Following Existing Objects]]''' page. 
[[File:Side_Lines_Of_Double_Lines.PNG]] 

===Tolerances===
*'''Select objects:''' This tolerance defines the maximum distance on each side of a thin line where you can click to select it. Objects with a thicker main line than the tolerance level can be selected by clicking on the entire line width. The default value is 5 pixels. 
:[[File:Hint.jpg]] This tolerance is further used in multiple tools like '''[[Cut#Cut_Line|Cut lines]]''', '''[[Cut#Cut_Area|Cut areas]]''', '''[[Drawing_an_Object#Following_Existing_Objects|Following existing objects]]''', '''[[Reshape|Reshape]]''', '''[[Vertices|Add Vertex, Remove Vertex, Change Vertex Type]]'''. 

*'''Snapping:''' If you activate the '''[[Snapping]]''' tool, moving a vertex close to an objects has a snapping effect. This tolerance defines the maximum distance you have to approach to the object, so that the vertex snaps to it. The default value is 5 pixels. 

*'''Join when drawing lines:''' This tolerance defines the maximum distance a vertex has to approach to another line end to [[Topology#Join|join]] it. The default value is 0.25 mm. If the line width is bigger than this tolerance then OCAD takes the line width as the tolerance. This tolerance is used for lines and areas 
:[[File:Joining_Lines.PNG]] 

*'''Merge lines:''' This tolerance defines the maximum distance two line endes can be apart to still get merged.

*'''Smooth when drawing freehand:''' There are three smoothing levels for freehand drawing mode: slightly, medium and strong. They correspond to 0, 1 and 2 in earlier OCAD versions. 
:[[File:Smoothing_Levels.PNG]] 

*'''Change to Bezier curve:''' This tolerance defines the maximum distance the vertices can move away from the original position by changing from polyline to Bezier curve. The default value is 0.10 mm. Note that the distance between the curve and the polyline can be greater between the vertices. 
:[[File:Change_To_Bezier.PNG]] 

*'''Smooth (generalization):''' This tolerance is used by the Douglas-Peucker smoothing algorithm. Vertices that are closer to the direct line between the previous and the next vertex are removed. The default value is 0.05 mm.

This smooth tolerance is also used in the 'Change to Polyline' function.
:[[File:Smooth.PNG]]

===Cursor color===
You can change the cursor color to black, red, blue, purple or yellow by selecting a color in the dropdown list.
====Scale Cursor Size====
Check this option to enlarge the cursor to the default size on high-DPI monitors.

===Mark===

Set the mark size to normal, large or very large. 
[[File:Mark_Size.PNG]]

Choose a mark color by clicking the [[File:Icon_Setup.PNG]] '''Setup''' icon. 
[[File:Mark_Color.PNG]]

The mark color is used during drawing and to mark the selected objects. 
[[File:Mark_Color_Drawing.PNG]]

The GPS cursor in GPS Real Time mode is also drawn with the choosen mark color. 
[[File:Mark_Color_GpsCursor.PNG]]

[[File:Hint.jpg]] OCAD uses the choosen mark color only on white background. Otherwise OCAD choose a color with high contrast to the background color. 
[[File:Mark_Color_HighContrast.PNG]]

===Legibility===
'''Show legibility halo''': The legibility halo shall support the cartographer to draw objects with enough distance to each other. 
The distance of this legibility halo is based on the IOF specifications for orienteering maps. The distance can also be defined by the user.

[[File:Live Preview.png]]

'''Check IOF minimum dimensions''': Activate this option to check directly during drawing whether the drawn line or area object corresponds to the minimum dimension of the IOF specifications for orienteering maps.

In the lower left corner of the screen, an indication appears whether the object has already fulfilled the minimum dimension or not. If this is the case, the indication appears green. If not, the indication appears red. In this case, an additional percentage indication shows by how much the object is too small.

[[File:CheckIOFMinimumDimensions.gif]]

===Enable live preview===
Enable this option to show the real dimension of objects during drawing.

The preview of the objects will be shown in the '''[[OCAD_Preferences#Mark|Mark Color]].

[[File:LivePreviewEnabled.gif]]

===Auto scroll===
Check this option if the map view should automatically scroll if you drag out of the drawing area. Disable '''Auto scroll''' if you have a slow PC.

===Change to Select and Edit Object mode when selecting two or more objects===
Check this option to automatically get the [[Select#Select_and_Edit_Object|Select and Edit Object mode]] when selecting two or more objects.

[[File:ChangeSelectMode.gif]]

==Symbol==
[[File:OcadPreferences Symbol.png]]
===Default symbol folder===
You can change the default symbol folder by clicking on the [[File:Icon_Setup.PNG]] '''Browse''' icon. Choose a folder as ''default symbol folder'' which you want to load symbols from when you create a new map. Click on the [[File:Icon_Delete2.PNG]] '''Delete''' icon to clear the current folder path. If no folder is selected, OCAD loads symbols from the ''Symbol'' folder in the ''OCAD program directory'' (usually: ''C:\Program Files\OCAD\OCAD 20xx\Symbol\'') when you want to create a new map. 

===Symbol===
* '''Selected symbol blinks in symbol box''': If you check this option, the selected symbol blinks in the symbol box. This makes it easier to recognize the selected symbol.
* '''Lock symbol positions in symbol box''': If you check this option, you are not able to drag and drop a symbol to a new position in the symbol box.
* '''Auto select symbol when selecting object''': If you check this option, the corresponding symbol is automatically selected when you select an object. This does not work when you select multiple objects.
* '''Change to drawing mode when selecting a symbol''': If you check this option, OCAD change to a drawing mode when selecting a symbol in the symbol box. If the symbol has a preffered drawing mode then OCAD change to this drawing mode.
* '''Set symbol status visible when changing to Protected''': Check this option if you prefer to have the same behaviour as in earlier OCAD versions. In this case OCAD always sets the symbol status Visible when changing to Protected.

==GPS==
[[File:OcadPreferences GPS.png]]
===GPS Log File===
Check the '''Log all positions sent from gps''' option to save all position sent from a GPS device in real time to a log file (Text-File). Click the [[File:Icon_Setup.PNG]] '''Browse''' icon to choose a folder, the log files are saved to. The log files are named with the date and time the real time GPS is enabled.

==Warnings==
[[File:OcadPreferences Warnings.png]]
===Warnings for hidden symbols===
These warnings can be activated when you either [[Printing Maps|print]], [[Export Files|export]] or [[Import Files|import]] a map. If you check those options, you will get a warning message if you have [[Symbol#Hide|hidden]] symbols on the map and you are trying to carry out one of mentioned operations.
===Moving warnings===
Enable the '''Move multiple objects''' option to get a warning message when you move [[Select#Select and Edit Multiple Objects|multiple objects]]. Use this option in order to guard against moving [[Select#Select and Edit Multiple Objects|multiple objects]] accidentally.
===Database warnings===
Check these options to show [[Database#Database_Compatibility|Database Compatibility]] warnings about 32/64bit and dBase.

==General==
[[File:OcadPreferences General.png]]
===Updater===
Disable the option '''Check for Service Updates when you start OCAD''' to not check for new free '''[[Service_Update|Service Updates]]''' when you start OCAD. Is some cases this check takes too long.

Known bugs are corrected in Service Updates. Additionally, new functions are added constantly with the subscription model. Therefore, we recommend using OCAD software always with the most recent Service Update to benefit from the quality improvements. The latest Service Update is also available on our website in the [https://www.ocad.com/en/service-update/ Download] section.

===OCAD Blog===
If this option is activated, new OCAD blog posts are shown when you start OCAD.

===Google API Key===
Enter here your Google API Key. This key is used in the [[New_Map_Wizard#Choose_Cross_Reference_Table|New Map Wizard]] to create a DEM via the Google Maps API.

Link: [https://developers.google.com/maps/documentation/javascript/get-api-key Get API Key]
===Geoviewer url===
Enter here the user-defined url to open a geoviewer clicking the '''Open Geoviewer''' icon [[File:IconGSV.PNG]] in the toolbar.

By default it is Google Street View.

Supported variables:
* {easting}
* {northing}
* {latitude}
* {longitude}
* {direction}

Examples:

* Apple Look Around Viewer: https://lookmap.eu.pythonanywhere.com/#c=17/{latitude}/{longitude}&p={latitude}/{longitude}&a={direction}/0
* Google Street View: http://maps.google.com/maps?q=&layer=c&cbll={latitude},{longitude}&cbp=11,{direction},0,0,0

* swisstopo map: https://map.geo.admin.ch/?lang=de&topic=ech&bgLayer=ch.swisstopo.swissimage&layers_opacity=0.8&layers_visibility=false&E={easting}&N={northing}&zoom=13

* mapy.cz: https://mapy.cz/zakladni?x={longitude}&y={latitude}&z=17

* Ordnance Survey map: https://osmaps.ordnancesurvey.co.uk/{latitude},{longitude},17

Error Messages

2025-02-17T12:02:33Z

GRS: /* Cannot create file activation file. Access denied. */

==Product Activation Error==
Each OCAD license can only be activated a [https://www.ocad.com/en/faq/#subscription-model certain number of times].

If this number of possible activations is used up, an error message will appear at the next activation attempt.

[[File:ProductActivationError.png]]

If possible, use the '''[[License Transfer Utility]]''' in the OCAD Help menu to transfer an OCAD license.

If you have no access to the OCAD license (e.g. PC crash, license is used by inactive member), fill out the [https://www.ocad.com/transfer/transferform.php Transfer form] or contact ''support@ocad.com'' and we can help you to reactivate the license.

==Script Error Open Street Map==

The integration of Open Street Map may not work with '''[[New_Map_Wizard#Choose_Location|New Map Wizard]]''' and '''[[Online Map Services]]'''.

How to solve this issue:

*Please makue sure you have installed the latest '''[[Service Update|OCAD Update]]'''.
*Visit '''[[Microsoft_Edge_WebView2|this page]]''' to fix the error.

[[File:ScriptErrorOSM.png]]

This bug will not be not fixed in OCAD 12.

==Web service for declination not available==
In order to find out the declination of a specific location, OCAD calls a [https://www.ngdc.noaa.gov/index.html NOAA web service]. This web service is not available from time to time, which is why an error appears in OCAD. Please try again later.

[[File:ServiceNotAvailableDeclination.png]]

==License has been deactivated==

[[File:LicenseDeactivated.png]]

This error may appear if OCAD Inc had to block your license, e.g. due to a license transfer.

Please go to ''C:\ProgramData\OCAD\OCAD 2018'', delete the activation file and start OCAD again. 

[[File:Hint.jpg]]Note: ''C:\ProgramData\'' is a hidden folder, see screenshot below. 
[[File:ActivationFile.PNG|750px|border]]

==Download OCAD Update does not work==
The OCAD Build 3226 - 3232 have a problem with a broken update link.

Read [[Download_Failed_Error|here]] how to fix it.

== Error in string resource. Invalid translation. Error code 208 ==
[[File:ErrorStringResource.PNG]]

This error message appears after installing an OCAD Service Update.

Cause: OCAD was running when installing the Service Update. The installer didn't replace the program file. The old program file is not compatible with the new string files.

Solution: Close OCAD first und install the current Service Update again.

== License ini file not found ==
OCAD could not create an ini file during the installation. The reason for this is usually a lack of security rights or an incorrect file name. 
Example incorrect file name: ''OCAD 2018 Course Setting License.5002 .ini'' instead of ''OCAD 2018 Course Setting License.5002.ini'' (no empty space after license number).

[[File:License ini file not found.png|450px]]
==Cannot create file activation file. Access denied.==
OCAD cannot write the activation frin in the program data folder ''C:\ProgramData\OCAD\OCAD 2018\''. This folder is by default hidden.

In this case, change the permission settings for the folder and xml activation file for '''Users''' to '''Write'''.

[[File:ActivationFilePermissions.png]]

==Other Errors==
Please contact info@ocad.com

File:ActivationFilePermissions.png

2025-02-17T12:01:20Z

GRS:

Error Messages

2025-02-17T12:00:54Z

GRS: /* Cannot create file activation file. Access denied. */

==Product Activation Error==
Each OCAD license can only be activated a [https://www.ocad.com/en/faq/#subscription-model certain number of times].

If this number of possible activations is used up, an error message will appear at the next activation attempt.

[[File:ProductActivationError.png]]

If possible, use the '''[[License Transfer Utility]]''' in the OCAD Help menu to transfer an OCAD license.

If you have no access to the OCAD license (e.g. PC crash, license is used by inactive member), fill out the [https://www.ocad.com/transfer/transferform.php Transfer form] or contact ''support@ocad.com'' and we can help you to reactivate the license.

==Script Error Open Street Map==

The integration of Open Street Map may not work with '''[[New_Map_Wizard#Choose_Location|New Map Wizard]]''' and '''[[Online Map Services]]'''.

How to solve this issue:

*Please makue sure you have installed the latest '''[[Service Update|OCAD Update]]'''.
*Visit '''[[Microsoft_Edge_WebView2|this page]]''' to fix the error.

[[File:ScriptErrorOSM.png]]

This bug will not be not fixed in OCAD 12.

==Web service for declination not available==
In order to find out the declination of a specific location, OCAD calls a [https://www.ngdc.noaa.gov/index.html NOAA web service]. This web service is not available from time to time, which is why an error appears in OCAD. Please try again later.

[[File:ServiceNotAvailableDeclination.png]]

==License has been deactivated==

[[File:LicenseDeactivated.png]]

This error may appear if OCAD Inc had to block your license, e.g. due to a license transfer.

Please go to ''C:\ProgramData\OCAD\OCAD 2018'', delete the activation file and start OCAD again. 

[[File:Hint.jpg]]Note: ''C:\ProgramData\'' is a hidden folder, see screenshot below. 
[[File:ActivationFile.PNG|750px|border]]

==Download OCAD Update does not work==
The OCAD Build 3226 - 3232 have a problem with a broken update link.

Read [[Download_Failed_Error|here]] how to fix it.

== Error in string resource. Invalid translation. Error code 208 ==
[[File:ErrorStringResource.PNG]]

This error message appears after installing an OCAD Service Update.

Cause: OCAD was running when installing the Service Update. The installer didn't replace the program file. The old program file is not compatible with the new string files.

Solution: Close OCAD first und install the current Service Update again.

== License ini file not found ==
OCAD could not create an ini file during the installation. The reason for this is usually a lack of security rights or an incorrect file name. 
Example incorrect file name: ''OCAD 2018 Course Setting License.5002 .ini'' instead of ''OCAD 2018 Course Setting License.5002.ini'' (no empty space after license number).

[[File:License ini file not found.png|450px]]
==Cannot create file activation file. Access denied.==
OCAD cannot write the activation frin in the program data folder ''C:\ProgramData\OCAD\OCAD 2018\''. This folder is by default hidden.
In this case, change the permission settings for the folder and xml activation file for the user to '''Write'''.

[[File:ActivationFilePermissions.png]]

==Other Errors==
Please contact info@ocad.com

Error Messages

2025-02-17T11:54:29Z

GRS: /* License ini file not found */

Tips with Keyboard and Mouse

2024-12-18T09:44:35Z

GRS: /* Editing */

This page summarises Tips and Tricks with Keyboard and Mouse to optimize your drawing and editing skills in OCAD. 
Click on the links for each function to learn more and see an animation.

==Navigation==
{|
|style="width:200px;" | Space + Mouse Drag|| Move the view. See also: [[File:Icon_Pan.PNG]] '''[[View#Pan|Pan Tool]]'''
|-
|Mouse Wheel Down|| [[View#Pan|Pan]] while holding the mouse wheel down.
|-
|Mouse Wheel + Ctrl|| Zoom in/Zoom out. See also: [[File:Icon_ZoomIn.PNG]] [[File:Icon_ZoomOut.PNG]] '''[[View#Zoom|Zoom Tools]]'''
|-
|Mouse Wheel|| Move the view vertically.
|-
|Mouse Wheel + Shift|| Move the view horizontally.
|-
|F5||[[View#Redraw|Redraw]]
|-
|'''Window''' > Tile||Fit all opened OCAD projects horizontally or vertically in the OCAD window
|}
There are some '''[[Shortcuts]]''' by default corresponding to view and navigation functions.

==Drawing==
{|
|style="width:200px;" |Shift + [[File:Icon CurveMode.PNG]] || [[Drawing_an_Object#Continuing_existing_objects|Continue an existing line or expand areas objects]]. Press the Shift key and click the start or end point of line or area object to be continued.
|-
|Shift + [[File:Icon CircleMode.PNG]]|| [[Drawing_an_Object#Draw_a_Circular_Object|Drawing circular objects]] from the center point.
|-
|Ctrl + [[File:Icon CurveMode.PNG]]|| [[Drawing an Object#Following Existing Objects|Following Existing Objects]].
|-
|Alt + [[File:Icon StraightLineMode.PNG]]|| [[Drawing_an_Object#Draw_Horizontal_Lines|Draw horizontal or vertical lines]]. Press the Alt key while drawing. The line snaps in a vertical or horizontal direction.
|-
|Tab|| [[Drawing_an_Object#Change_Drawing_Mode|Change drawing mode during drawing and editing]]. Press the Tab key until the desired drawing mode appears to change the drawing mode.
|-
|P|| Press the P key to change to the last used drawing mode.
|-
|Backspace|| Delete last vertex.
|-
|ESC|| Cancel drawing with ESC key.
|-
|Status Bar|| Length and agle of an line objects are shown in the [[Graphical_User_Interface#Status_Bar|Status Bar]].
|}

Visit the '''Drawing and Editing''' Section in the '''[[OCAD_Preferences#Drawing_and_Editing|OCAD Preferences]]''' to choose your favourite settings.

==Editing==
{|
|style="width:200px;" |[[File:Icon SelectObjectAndEditVertex.PNG]]|| [[Select#Select_Object_and_Edit_Vertex|Move Segments]]
|-
|Shift + [[File:Icon SelectAndEditObject.PNG]] or [[File:Icon SelectObjectAndEditVertex.PNG]]|| Object not selected: [[Select#Select_and_Edit_Multiple_Objects|add to the selected objects]]. As an alternative, drag an area with the Left Mouse Button. Selected object: [[Select#Select_and_Edit_Multiple_Objects|remove from selected objects]]. [[Select#Move_Single_Vertices|Keep right angle]] when moving a corner (e.g. building).
|-
|Ctrl + [[File:Icon SelectObjectAndEditVertex.PNG]]||[[Vertices#Remove_Vertex|Remove Vertex]]
|-
|Ctrl + [[File:Icon RemoveVertex.PNG]] + Mouse||[[Vertices#Remove_Vertex|Remove Vertex]] with ''Mouse Over''.
|-
|Shift + Ctrl + [[File:Icon SelectObjectAndEditVertex.PNG]]||[[Vertices#Add_Normal_Vertex|Add Vertex]]
|-
|Ctrl + Space + [[File:Icon SelectObjectAndEditVertex.PNG]]||[[Select#Toggle_between_vertices|Toggle]] between normal-dash-corner or toggle between straight and bezier curve segment.
|-
|Alt + [[File:Icon SelectObjectAndEditVertex.PNG]]||[[Select#Select_an_object_behind_an_object_already_selected|Select an object under a already selected object]].
|-
|Alt + [[File:Icon Cut.PNG]] or [[File:Icon Reshape.PNG]]|| [[Select#Select_next_object_for_editing|Select next object for editing]]
|-
|Arrow Keys||[[Select#Select_and_Edit_Object|Move selected objects (fine tuning)]]
|-
|Arrow Keys||Double Click on Vertex and [[Select#Move_Vertex_With_Arrow_Keys|Move Vertex With Arrow Keys]].
|-
|Tab + [[File:Icon SelectObjectAndEditVertex.PNG]]||[[Select#Move_neighboring_segments_and_congruent_vertices|Move neighboring Segments and congruent Vertices]] in one single step.
|-
|Shift + Arrow Keys||[[Select#Select_and_Edit_Object|Move selected objects (fast)]]
|-
|P||Get latest used drawing tool
|-
|R||Change to the [[Reshape|Reshape]] mode.
|-
|A||Change to the [[Select#Select_Object_and_Edit_Vertex|Select Object and Edit Vertex]] mode.
|-
|V||Change to the [[Select#Select_and_Edit_Object|Select and Edit Object]] mode.
|}

==Cutting==
{|
|style="width:200px;" |Ctrl + [[File:Icon Cut.PNG]]||[[Cut#Cut_Line|Insert a virtual gap]].
|-
|Shift + [[File:Icon Cut.PNG]]||[[Cut#Cut_Line|Dashed line: Insert a gap at the cutting point]]
|}

==Background Map==
{|
|style="width:200px;" |F9||[[Background_Map#Adjust_a_Background_Map|Adjust a Background Map]]
|-
|F10||[[Background_Map#Hide_all_Background_Maps|Hide all Background Maps]]
|}

==Varia==
{|
|style="width:200px;"|F2||[[Symbol#Normal_.28Visible_and_Selectable.29|Normal (Visible and Selectable)]]
|-
|F3||[[Symbol#Protect_Objects|Protect Objects]]
|-
|F4||[[Symbol#Hide_Objects|Hide Objects]]
|-
|'''File''' > Open Recently Exported Documents||[[File#Open_Recently_Exported_Documents|Shortcut to open exported OCAD Files, PDFs, PNG, ...]]
|-
|'''File''' > Open Recently Used OCAD Files||[[File#Open_Recently_Used_OCAD_Files|Shortcut to open an OCAD file which you recently opened.]]
|}

GPS

2024-12-02T07:46:35Z

GRS: /* Options */

[[File:RealTimeGPS.PNG]]
==Real Time GPS [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''GPS''' menu for mobile mapping with GPS. The GPS device must be connected to the computer via the COM interface with Bluetooth. 

[[File:Hint.jpg|hint]] If your GPS device is connected via an USB port or an internal GPS cannot be connected via Windows Location API, please install a software like '''[https://gpsgate.com/products/gpsgate_client GpsGate Splitter]''' to transfer the data to a virtual COM port (''Add Output -> Virtual COM port / NMEA filter'').

[[File:Hint.jpg|hint]] All COM ports that are listed in the Windows registry key ''HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM'' are available in OCAD.

===Real Time GPS Settings===
When you choose the '''Real Time GPS''' command from the '''GPS''' menu, the '''Real Time GPS Settings''' dialog appears.

[[File:RealTimeGpsSettings.png]]
====Connection Settings====
There are two Connection Settings:

=====COM=====

Choose this option to connect your GPS device with a COM port. Garmin devices typically use COM port 4 or 5.
# '''Port:''' Choose the COM port where the GPS device is connected. The GPS device must send the '''[https://en.wikipedia.org/wiki/NMEA_0183 NMEA 0183 Format]'''. 
# '''Baud rate:''' Choose the baud rate the serial port. NMEA 0183 defines 4800 bps but some devices may send data at a different speed. 
# '''Test:''' Click the '''Test''' button to open the '''[[GPS#Test GPS|Test GPS]]''' dialog box. The NMEA messages received from the GPS device are displayed there and you can verify the connection of the GPS device. Read more about this dialog in the '''[[GPS#Test GPS|Test GPS]]''' article on this page.

[[File:Hint.jpg]] In Windows, go to ''Settings > Bluetooth & Other devices > More Bluetooth Settings'' to see which COM ports your computer are using. OCAD uses the outgoing COM port of the connected device. 
[[File:Hint.jpg]] You can use an app (we tested ''Share GPS'') and connect your '''smartphone''' via bluetooth with the computer/tablet. After that, set up the connection via COM interface.

=====Windows Location API=====

Internal or external GPS devices can be connected using the [https://msdn.microsoft.com/en-us/library/windows/desktop/dd464636%28v=vs.85%29.aspx Windows Location API]. This options is recommended if the Windows computer does not anymore support COM ports.

The '''Location service''' must be activated in the Windows settings. For Windows 10 you can find this option in the '''Privacy''' settings -> '''Location'''. Switch on the '''Location service''' and switch on the app '''App connector'''.

Choose a sensor from the '''sensor list''' and click the '''Test''' button to test the connection settings.
The real time GPS works still in the habitual way.
: [[File:Hint.jpg|hint]] The GPS may needs to be manually activated as a location sensor in the '''Windows settings'''.
: [[File:Hint.jpg|hint]] if no sensor is listed, please use a tool like [[GPS#Real_Time_GPS|GpsGate Splitter]] to transfer the GPS signal to a virtual COM port.

====Requirements====
The following requirements can be given:
* '''DGPS, RTK, Float RTK:''' Check this option to use DGPS, RTK, Float RTK and define if the positions calculated without '''[https://en.wikipedia.org/wiki/DGPS DGPS]''', '''[https://en.wikipedia.org/wiki/Real_Time_Kinematic RTK]''', '''Float RTK''' are '''not saved''' or '''not saved and not shown'''.
: [[File:Hint.jpg|hint]] This option has only an effect if OCAD receives the '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Message]'''. Click the '''[[GPS#Test GPS|Test]]''' button to see what type of message is sent from the device.
* '''Min. 4 satellites:''' Check this option as a kind of precision requirement and define if the positions calculated from less than 4 satellites are '''not saved''' or '''not saved and not shown'''..
: [[File:Hint.jpg|hint]] This option has only an effect if OCAD receives the '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Message]'''. Click the '''[[GPS#Test GPS|Test]]''' button to see what type of message is sent from the device.
* '''HDOP:''' Check this option to define an upper limit for the '''[https://en.wikipedia.org/wiki/Dilution_of_precision_%28GPS%29 HDOP (Horizontal Dilution of Precision)]''' value and define if the positions calculated with a higher HDOP are '''not saved''' or '''not saved and not shown'''..

====Options====
* '''Filter:''' Check this option to activate a filter and specify how many GPS positions are averaged. This results in a more stable position, but the update is slower.
* '''Accuracy circle:''' This option is enabled when the '''Filter''' option is checked. Check this option to show the accuracy circle. This shows the accuracy of the last 5 measurements with a circle around the GPS marker.
* '''Auto scroll (moving map):''' Check this option to move the map to the screen center automatically when the GPS marker reachs the edge of the drawing area.
* '''Subtract antenna height from Z value:''' Check this option to define a correction for the Z value. The entered value gets subtracted from the measured height value.
*'''GPS Connection tail:''' Check this option to show GPS positions tail. 
- You can also choose the length of the tail. 
- The tail color is the same as the '''[[OCAD_Preferences#Mark|mark color]]''', which can be set in the OCAD Preferences. 
[[File:GpsRealTimeShowTail.png]]

====Coordinate system====
Click the '''Change''' button to change the coordinate system. The '''[[Create_a_New_Map#Coordinate_System|Coordinate System]]''' dialog box appears.

Click the '''Connect''' button to turn on the real time GPS mode. The '''GPS''' box is displayed in the lower right corner if the connection to the GPS device was successful.

Close the '''Real Time GPS Settings''' dialog or click the '''Disconnect''' button to turn off real time GPS.

===Test GPS===
Click the '''Test''' button in the '''Real Time GPS Settings''' dialog to open the '''Test GPS''' dialog.

[[File:Hint.jpg]] Test the GPS connection outside, so your GPS device can receive data. Move around a little bit, so your position gets updated.

[[File:TestGPS.PNG]]

If OCAD receives '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Messages]''', those messages are displayed in the '''Serial data''' field. Characters 4 to 6 show the abbreviation GGA (e.g. $XXGGA...). '''[https://www.gpsinformation.org/dale/nmea.htm#RMC RMC Messages]''' are displayed if OCAD does not receive any GGA messages. RMC messages contain no information about DGPS and the number of satellites. However, the position can still be used in OCAD. The serial data box remains empty, if the GPS device is sending neither of the two messages or if there is a connection problem. Check that you have selected the right port in the '''Real Time GPS Settings''' dialog box and that the GPS device is connected correctly to the PC.

'''GGA message example:'''
$GPGGA,092750.000,5321.6802,N,00630.3372,W,1,8,1.03,61.7,M,55.2,M,,*76
'''RMC message example:'''
$GPRMC,092750.000,A,5321.6802,N,00630.3372,W,0.02,31.66,280511,,,A*43

OCAD takes the serial data apart and displays it in a bit more user-friendly view below the '''Serial data''' box.

=== Mapping with Real Time GPS ===

The '''GPS''' box is displayed in the lower right corner if OCAD is successfully connected to a GPS device.

[[File:RealTimeGPSBox.PNG]]

The following information is given in this box:
* '''Easting:''' In this field the easting value of the coordinate is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''Northing:''' In this field the northing value of the coordinate is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''Height:''' In this field the height is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''DGPS:''' A green or red dot shows if a '''[https://en.wikipedia.org/wiki/Differential_GPS DGPS]''' signal is received.
* '''Satellites:''' In this field the number of received satellites is displayed. A Red number means that the requirements defined in the Real Time GPS Settings are not fulfilled.
* '''HDOP:''' The '''[https://en.wikipedia.org/wiki/HDOP HDOP (Horizontal Dilution of Precision)]''' is displayed in this field. HDOP is a quality indicator for the position of the useable satellites on the local sky. A Red number means that the requirements defined in the Real Time GPS Settings are not fulfilled.
* '''Precision (x Val):''' In this field the accuracy (root mean square) of specified number of the last measurements is displayed. The '''Filter length''' can be specified in the '''[[GPS#Options|Real Time GPS Settings]]''' dialog.

Below the information part of the box, there are several icons:
: [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''': Click this icon to create an OCAD object with the receiving GPS information. A symbol must be selected. Choose a point symbol and click the '''Start GPS Measurement''' icon to create an object at the position of the GPS marker. If a line or area symbol is selected, OCAD starts with the measurement and draws a vertice for every recieved position. The object is represented with a thin black line.
: [[File:Icon_PauseGPSMeasurement.PNG]] '''Pause GPS Measurement''': Click this icon to interrupt the GPS measurement without finishing the object. Click the icon again to continue with the measurement.
: [[File:Icon_StopGPSMeasurement.PNG]] ''' Stop GPS Measurement''': Click this icon to finish the line or area object. The object is displayed with the assigned symbol.
: [[File:Icon_FindGPSMarker.PNG]] '''Find GPS Marker''': Click this icon to move the view to the GPS marker. Enable the '''[[GPS#Options|Auto Scroll]]''' option to always move the view, when the GPS marker is leaving the current view.
: [[File:Icon_GPSFilter.PNG]] '''Filter''': Turn on or off the filter by clicking this icon. The filter can be adjusted in the '''[[GPS#Options|Real Time GPS Settings]]''' dialog.
: [[File:Icon_AccuracyCircle.PNG]] '''Accuracy Circle:''' Turn on or off the accuracy circle by clicking this icon. This shows the accuracy of the last 5 measurements with a circle around the GPS marker. This option is only available when the '''Filter''' is enabled.
: [[File:SelectVertexType.png]] '''Select Vertex Type''': In this dropdown list you can select between two types of '''[[Vertices]]''':
:: Choose the '''Normal Vertex''' option when a point should be added to the object for every position received from the GPS device.
:: Choose the '''Corner Vertex''' option when a position should be manually added to the object by clicking the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' button. This option is typically used to draw objects with straight parts and corners like a fence. If a point or text object is selected, the vertex type cannot be changed.
: [[File:Icon_AddGPSPositionToCalculateAverage.PNG]] '''Add GPS Position to Calculate Average''': Click this button for every position you want include into an average calculation. The number of added positions is shown in the button hint. Click the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' icon to create the object at the calculated average position. This function is only available when a point symbol is selected. This is especially useful when the GPS position of an uncrossable feature (e.g. small house, deep hole, huge tree etc.) is to be measured. Some points around the feature have to be recorded and by clicking the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' icon, the average point can be found.
: [[File:ShowTail.png]] '''Show Tail''':Click this buttom to show the GPS tail or not.
: [[File:Icon_OpenRealTimeGPSSettings.PNG]] '''Open Real Time GPS Settings''': This icon opens the '''[[GPS#Real Time GPS Settings|Real Time GPS Settings]]''' dialog box.

[[File:Hint.jpg|hint]] The GPS cursor is drawn with the mark color. Change the '''[[OCAD_Preferences#Mark|Mark Color]]''' in the '''Drawing and Editing''' part of the '''[[OCAD Preferences]]'''. 
[[File:Hint.jpg|hint]] Cold temperatures can shorten the runtime of the GPS battery. Sometimes it helps to warm up the GPS device for a few minutes. 
[[File:GpsRealTimeThickerCursor.png]]

===Example: Connection of tablet SURFACE and Garmin GLO===
Connection of tablet SURFACE with OS Windows 10 and OCAD Orienteering subscription and Garmin GLO.

#First of all, turn the tablet Bluetooth on.
#Turn the GNSS device on and open the Bluetooth settings on the tablet.
#Find and select the Garmin GLO GNSS and click "Pair the device".
#After pairing, connect the device.
#Wait until the Garmin GLO's green light is glowing and not flashing.
#Open OCAD with a georeferenced map.
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Select the port (try to test different ports to find which the device is connected to, it depends on the GPS port manager) and connect the GNSS.
#You should see a marker at your position.
#Make sure that the coordinate system of the map is the same as the GNSS coordinate system (can be adjusted in "Real-time GPS" options).

===Example: Connection of a notebook and Navilock BT-821G===
Connection of a notebook with OS Windows 10 and OCAD Orienteering subscription and Navilock BT-821G Bluetooth GNSS Receiver MT3333.

#First of all, turn on Navilock BT – 821G and wait when recognizes satellites.
#On your notebook, go to the Device Manager and turn Bluetooth on.
#:-Pair the device and connect BT – GPS – 396371.
#:-for a pairing is necessary to enter a code 0000 (Navilock recommendation).
#:-after entering a code, a connection is done.
#another Bluetooth Settings:
#:-view assigned COM port - for BT - 821G two ports one output and one input (it is from the point of view of connected device).
#Open OCAD with a georeferenced map.
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Select the port, baud rate = 4800 bps (it worked even with selected higher bps speed).
#You should see a marker at your position.
#Click the Test button in the Real Time GPS Settings dialog to open the Test GPS dialog.

===Example: Connection of rugged tablet and Garmin GLO===
Connection of rugged tablet with OS Windows and OCAD Orienteering subscription and Garmin GLO.

#Garmin GLO is predetermined to connect to the computer's COM3 port with a baud rate of 4800 bps.
#You should switch on the GLO before starting up OCAD, otherwise the connection most often fails, so make sure to do that first.
#Next open OCAD.
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Make sure you select the correct COM port and baud rate.
#Finally, make sure you've selected the correct reference system for where you'll be working.

==Import Data from GPS Device [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
This function is obsolete! If you want to import GPS data from GPS devices, import the waypoints and tracks with the corresponding software of the GPS device to the computer. Then use the '''[[GPS#Import from File|Import from File]]''' function in OCAD. As an alternative, for fieldwork, use the '''[[GPS#Real Time GPS|Real Time GPS]]''' function.

Choose this command to import tracks or waypoints from a '''GPS Garmin eTrex''' device. The GPS device must be connected to the PC with a serial data cable or Bluetooth.

* '''GPS:''' In this field the information about the GPS device is displayed.
* '''Status:''' In this field the status between OCAD and GPS is displayed.

'''Connection'''
* '''Connect GPS:''' Click this button to connect OCAD with the GPS device. After a successful connection the GPS information and the status are displayed.
* '''Settings:''' Click this button to change the GPS settings. The '''Import from GPS Settings''' dialog is displayed.

'''GPS data'''
* '''Get waypoints:''' Click this button to load all waypoints. Each waypoint is displayed with in a row in the GPS data field.
* '''Get tracks:''' Click this button to download all tracks. Each track is displayed with in a row in the GPS data field. Only the start point is displayed.
[[File:Hint.jpg|hint]] This command can take several minutes!

'''OCAD objects'''
* '''Set labels:''' Check this option to create also text objects with the name of the waypoints and tracks.
* '''CRT:''' Use a '''[[Cross Reference Table]]''' to assign symbols to the waypoints and tracks. OCAD creates '''[[Unsymbolized Objects]]''' if no '''[[Cross Reference Table]]''' is selected.
: Each line of the cross reference table contains the OCAD symbol number and the Garmin symbol name.
: Example of a cross reference table:
535.0 waypoint dot
536.0 campground symbol
540.0 scenic area symbol
* '''Create:''' Select the waypoints and tracks in the GPS data field and click this button to create OCAD objects from the selected GPS data. 
[[File:Hint.jpg|hint]] A popup menu appears when clicking the list with the GPS data with the right mouse button. In this popup menu you have the option to '''Select all''', '''Unselect all''' and '''Clear list'''. With the '''Clear list''' command all waypoints and tracks are removed. In addition, you can '''Make an OCAD object'''. By clicking this command, an OCAD object of the selected track or waypoint is created.

===Import from GPS Settings===
In this dialog box you can make the setting for the GPS data import. Verify also your settings on the GPS device (e.g. data format: GARMIN)!

* '''Port:''' Choose the port where the GPS device is connected.
* '''Speed data import:''' Choose the speed of the serial port. Garmin defines 9600 bps.
* '''Coordinate system:''' Click the '''Change''' button to select or change the coordinate system. The '''[[Create a New Map#Coordinate System|Coordinate System]]''' dialog box appears.

==Import from File [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command from the '''GPS''' menu to import a GPS data file to the current map. The '''Load GPS data from files''' dialog box is displayed. Initially all importable GPS data files are listed. The following file types can be imported:
* GPX files
* FRWD files
* NMEA files
The '''Import from File''' dialog appears, where all available waypoints and tracks from the imported file are listed. There are several options in the '''OCAD objects''' part of the dialog:

* '''Set label:''' Check this option to create also text objects with the name of the waypoints and tracks.
* '''Assign Symbols:''' Check this option to assign a specified symbol to the imported objects. Otherwise OCAD will create '''[[Unsymbolized Objects]]'''.
[[File:Hint.jpg|hint]] A popup menu appears when clicking the list with the GPS data with the right mouse button. In this popup menu you have the option to '''Select all''', '''Unselect all''' and '''Clear list'''. With the '''Clear list''' command all waypoints and tracks are removed. In addition, you can '''Make an OCAD object'''. By clicking this command, an OCAD object of the selected track or waypoint is created.

Click the '''Import''' button to import all selected tracks or waypoints in the list.

===GPS Map Offset===
This dialog box appears if the GPS coordinates are out of the maximum map size. Adjust the following parameters:

* '''Coordinate system''' If you work with GPS you must select a coordinate system. Click the '''Change''' button to select or change the coordinate system. The '''[[Create_a_New_Map#Coordinate_System|Coordinate System]]''' dialog box appears.
* '''Offset''' Choose here whether you want to change the OCAD real world coordinates or to keep the existing ones.
* '''New offset:''' Choose this option if no real world coordinates are defined for the map. OCAD already proposes reasonable values. You can leave theme unchanged.
* '''Existing offset and angle:''' Choose this option if the map already has real world coordinates and you want to fit the imported objects to the existing coordinates.

== Laser Rangefinder [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Read more about using the '''"TruPulse 360/360B" Laser Rangefinder''' on the '''[[Laser Rangefinder]]''' page

----
Back to [[Main Page]]

GPS

2024-12-02T07:41:28Z

GRS: /* COM */

[[File:RealTimeGPS.PNG]]
==Real Time GPS [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''GPS''' menu for mobile mapping with GPS. The GPS device must be connected to the computer via the COM interface with Bluetooth. 

[[File:Hint.jpg|hint]] If your GPS device is connected via an USB port or an internal GPS cannot be connected via Windows Location API, please install a software like '''[https://gpsgate.com/products/gpsgate_client GpsGate Splitter]''' to transfer the data to a virtual COM port (''Add Output -> Virtual COM port / NMEA filter'').

[[File:Hint.jpg|hint]] All COM ports that are listed in the Windows registry key ''HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM'' are available in OCAD.

===Real Time GPS Settings===
When you choose the '''Real Time GPS''' command from the '''GPS''' menu, the '''Real Time GPS Settings''' dialog appears.

[[File:RealTimeGpsSettings.png]]
====Connection Settings====
There are two Connection Settings:

=====COM=====

Choose this option to connect your GPS device with a COM port. Garmin devices typically use COM port 4 or 5.
# '''Port:''' Choose the COM port where the GPS device is connected. The GPS device must send the '''[https://en.wikipedia.org/wiki/NMEA_0183 NMEA 0183 Format]'''. 
# '''Baud rate:''' Choose the baud rate the serial port. NMEA 0183 defines 4800 bps but some devices may send data at a different speed. 
# '''Test:''' Click the '''Test''' button to open the '''[[GPS#Test GPS|Test GPS]]''' dialog box. The NMEA messages received from the GPS device are displayed there and you can verify the connection of the GPS device. Read more about this dialog in the '''[[GPS#Test GPS|Test GPS]]''' article on this page.

[[File:Hint.jpg]] In Windows, go to ''Settings > Bluetooth & Other devices > More Bluetooth Settings'' to see which COM ports your computer are using. OCAD uses the outgoing COM port of the connected device. 
[[File:Hint.jpg]] You can use an app (we tested ''Share GPS'') and connect your '''smartphone''' via bluetooth with the computer/tablet. After that, set up the connection via COM interface.

=====Windows Location API=====

Internal or external GPS devices can be connected using the [https://msdn.microsoft.com/en-us/library/windows/desktop/dd464636%28v=vs.85%29.aspx Windows Location API]. This options is recommended if the Windows computer does not anymore support COM ports.

The '''Location service''' must be activated in the Windows settings. For Windows 10 you can find this option in the '''Privacy''' settings -> '''Location'''. Switch on the '''Location service''' and switch on the app '''App connector'''.

Choose a sensor from the '''sensor list''' and click the '''Test''' button to test the connection settings.
The real time GPS works still in the habitual way.
: [[File:Hint.jpg|hint]] The GPS may needs to be manually activated as a location sensor in the '''Windows settings'''.
: [[File:Hint.jpg|hint]] if no sensor is listed, please use a tool like [[GPS#Real_Time_GPS|GpsGate Splitter]] to transfer the GPS signal to a virtual COM port.

====Requirements====
The following requirements can be given:
* '''DGPS, RTK, Float RTK:''' Check this option to use DGPS, RTK, Float RTK and define if the positions calculated without '''[https://en.wikipedia.org/wiki/DGPS DGPS]''', '''[https://en.wikipedia.org/wiki/Real_Time_Kinematic RTK]''', '''Float RTK''' are '''not saved''' or '''not saved and not shown'''.
: [[File:Hint.jpg|hint]] This option has only an effect if OCAD receives the '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Message]'''. Click the '''[[GPS#Test GPS|Test]]''' button to see what type of message is sent from the device.
* '''Min. 4 satellites:''' Check this option as a kind of precision requirement and define if the positions calculated from less than 4 satellites are '''not saved''' or '''not saved and not shown'''..
: [[File:Hint.jpg|hint]] This option has only an effect if OCAD receives the '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Message]'''. Click the '''[[GPS#Test GPS|Test]]''' button to see what type of message is sent from the device.
* '''HDOP:''' Check this option to define an upper limit for the '''[https://en.wikipedia.org/wiki/Dilution_of_precision_%28GPS%29 HDOP (Horizontal Dilution of Precision)]''' value and define if the positions calculated with a higher HDOP are '''not saved''' or '''not saved and not shown'''..

====Options====
* '''Filter:''' Check this option to activate a filter and specify how many GPS positions are averaged. This results in a more stable position, but the update is slower.
* '''Accuracy circle:''' This option is enabled when the '''Filter''' option is checked. Check this option to show the accuracy circle. This shows the accuracy of the last 5 measurements with a circle around the GPS marker.
* '''Auto scroll (moving map):''' Check this option to move the map automatically with the GPS marker.
* '''Subtract antenna height from Z value:''' Check this option to define a correction for the Z value. The entered value gets subtracted from the measured height value.
*'''GPS Connection tail:''' Check this option to show GPS positions tail. 
- You can also choose the length of the tail. 
- The tail color is the same as the '''[[OCAD_Preferences#Mark|mark color]]''', which can be set in the OCAD Preferences. 
[[File:GpsRealTimeShowTail.png]]

====Coordinate system====
Click the '''Change''' button to change the coordinate system. The '''[[Create_a_New_Map#Coordinate_System|Coordinate System]]''' dialog box appears.

Click the '''Connect''' button to turn on the real time GPS mode. The '''GPS''' box is displayed in the lower right corner if the connection to the GPS device was successful.

Close the '''Real Time GPS Settings''' dialog or click the '''Disconnect''' button to turn off real time GPS.

===Test GPS===
Click the '''Test''' button in the '''Real Time GPS Settings''' dialog to open the '''Test GPS''' dialog.

[[File:Hint.jpg]] Test the GPS connection outside, so your GPS device can receive data. Move around a little bit, so your position gets updated.

[[File:TestGPS.PNG]]

If OCAD receives '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Messages]''', those messages are displayed in the '''Serial data''' field. Characters 4 to 6 show the abbreviation GGA (e.g. $XXGGA...). '''[https://www.gpsinformation.org/dale/nmea.htm#RMC RMC Messages]''' are displayed if OCAD does not receive any GGA messages. RMC messages contain no information about DGPS and the number of satellites. However, the position can still be used in OCAD. The serial data box remains empty, if the GPS device is sending neither of the two messages or if there is a connection problem. Check that you have selected the right port in the '''Real Time GPS Settings''' dialog box and that the GPS device is connected correctly to the PC.

'''GGA message example:'''
$GPGGA,092750.000,5321.6802,N,00630.3372,W,1,8,1.03,61.7,M,55.2,M,,*76
'''RMC message example:'''
$GPRMC,092750.000,A,5321.6802,N,00630.3372,W,0.02,31.66,280511,,,A*43

OCAD takes the serial data apart and displays it in a bit more user-friendly view below the '''Serial data''' box.

=== Mapping with Real Time GPS ===

The '''GPS''' box is displayed in the lower right corner if OCAD is successfully connected to a GPS device.

[[File:RealTimeGPSBox.PNG]]

The following information is given in this box:
* '''Easting:''' In this field the easting value of the coordinate is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''Northing:''' In this field the northing value of the coordinate is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''Height:''' In this field the height is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''DGPS:''' A green or red dot shows if a '''[https://en.wikipedia.org/wiki/Differential_GPS DGPS]''' signal is received.
* '''Satellites:''' In this field the number of received satellites is displayed. A Red number means that the requirements defined in the Real Time GPS Settings are not fulfilled.
* '''HDOP:''' The '''[https://en.wikipedia.org/wiki/HDOP HDOP (Horizontal Dilution of Precision)]''' is displayed in this field. HDOP is a quality indicator for the position of the useable satellites on the local sky. A Red number means that the requirements defined in the Real Time GPS Settings are not fulfilled.
* '''Precision (x Val):''' In this field the accuracy (root mean square) of specified number of the last measurements is displayed. The '''Filter length''' can be specified in the '''[[GPS#Options|Real Time GPS Settings]]''' dialog.

Below the information part of the box, there are several icons:
: [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''': Click this icon to create an OCAD object with the receiving GPS information. A symbol must be selected. Choose a point symbol and click the '''Start GPS Measurement''' icon to create an object at the position of the GPS marker. If a line or area symbol is selected, OCAD starts with the measurement and draws a vertice for every recieved position. The object is represented with a thin black line.
: [[File:Icon_PauseGPSMeasurement.PNG]] '''Pause GPS Measurement''': Click this icon to interrupt the GPS measurement without finishing the object. Click the icon again to continue with the measurement.
: [[File:Icon_StopGPSMeasurement.PNG]] ''' Stop GPS Measurement''': Click this icon to finish the line or area object. The object is displayed with the assigned symbol.
: [[File:Icon_FindGPSMarker.PNG]] '''Find GPS Marker''': Click this icon to move the view to the GPS marker. Enable the '''[[GPS#Options|Auto Scroll]]''' option to always move the view, when the GPS marker is leaving the current view.
: [[File:Icon_GPSFilter.PNG]] '''Filter''': Turn on or off the filter by clicking this icon. The filter can be adjusted in the '''[[GPS#Options|Real Time GPS Settings]]''' dialog.
: [[File:Icon_AccuracyCircle.PNG]] '''Accuracy Circle:''' Turn on or off the accuracy circle by clicking this icon. This shows the accuracy of the last 5 measurements with a circle around the GPS marker. This option is only available when the '''Filter''' is enabled.
: [[File:SelectVertexType.png]] '''Select Vertex Type''': In this dropdown list you can select between two types of '''[[Vertices]]''':
:: Choose the '''Normal Vertex''' option when a point should be added to the object for every position received from the GPS device.
:: Choose the '''Corner Vertex''' option when a position should be manually added to the object by clicking the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' button. This option is typically used to draw objects with straight parts and corners like a fence. If a point or text object is selected, the vertex type cannot be changed.
: [[File:Icon_AddGPSPositionToCalculateAverage.PNG]] '''Add GPS Position to Calculate Average''': Click this button for every position you want include into an average calculation. The number of added positions is shown in the button hint. Click the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' icon to create the object at the calculated average position. This function is only available when a point symbol is selected. This is especially useful when the GPS position of an uncrossable feature (e.g. small house, deep hole, huge tree etc.) is to be measured. Some points around the feature have to be recorded and by clicking the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' icon, the average point can be found.
: [[File:ShowTail.png]] '''Show Tail''':Click this buttom to show the GPS tail or not.
: [[File:Icon_OpenRealTimeGPSSettings.PNG]] '''Open Real Time GPS Settings''': This icon opens the '''[[GPS#Real Time GPS Settings|Real Time GPS Settings]]''' dialog box.

[[File:Hint.jpg|hint]] The GPS cursor is drawn with the mark color. Change the '''[[OCAD_Preferences#Mark|Mark Color]]''' in the '''Drawing and Editing''' part of the '''[[OCAD Preferences]]'''. 
[[File:Hint.jpg|hint]] Cold temperatures can shorten the runtime of the GPS battery. Sometimes it helps to warm up the GPS device for a few minutes. 
[[File:GpsRealTimeThickerCursor.png]]

===Example: Connection of tablet SURFACE and Garmin GLO===
Connection of tablet SURFACE with OS Windows 10 and OCAD Orienteering subscription and Garmin GLO.

#First of all, turn the tablet Bluetooth on.
#Turn the GNSS device on and open the Bluetooth settings on the tablet.
#Find and select the Garmin GLO GNSS and click "Pair the device".
#After pairing, connect the device.
#Wait until the Garmin GLO's green light is glowing and not flashing.
#Open OCAD with a georeferenced map.
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Select the port (try to test different ports to find which the device is connected to, it depends on the GPS port manager) and connect the GNSS.
#You should see a marker at your position.
#Make sure that the coordinate system of the map is the same as the GNSS coordinate system (can be adjusted in "Real-time GPS" options).

===Example: Connection of a notebook and Navilock BT-821G===
Connection of a notebook with OS Windows 10 and OCAD Orienteering subscription and Navilock BT-821G Bluetooth GNSS Receiver MT3333.

#First of all, turn on Navilock BT – 821G and wait when recognizes satellites.
#On your notebook, go to the Device Manager and turn Bluetooth on.
#:-Pair the device and connect BT – GPS – 396371.
#:-for a pairing is necessary to enter a code 0000 (Navilock recommendation).
#:-after entering a code, a connection is done.
#another Bluetooth Settings:
#:-view assigned COM port - for BT - 821G two ports one output and one input (it is from the point of view of connected device).
#Open OCAD with a georeferenced map.
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Select the port, baud rate = 4800 bps (it worked even with selected higher bps speed).
#You should see a marker at your position.
#Click the Test button in the Real Time GPS Settings dialog to open the Test GPS dialog.

===Example: Connection of rugged tablet and Garmin GLO===
Connection of rugged tablet with OS Windows and OCAD Orienteering subscription and Garmin GLO.

#Garmin GLO is predetermined to connect to the computer's COM3 port with a baud rate of 4800 bps.
#You should switch on the GLO before starting up OCAD, otherwise the connection most often fails, so make sure to do that first.
#Next open OCAD.
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Make sure you select the correct COM port and baud rate.
#Finally, make sure you've selected the correct reference system for where you'll be working.

==Import Data from GPS Device [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
This function is obsolete! If you want to import GPS data from GPS devices, import the waypoints and tracks with the corresponding software of the GPS device to the computer. Then use the '''[[GPS#Import from File|Import from File]]''' function in OCAD. As an alternative, for fieldwork, use the '''[[GPS#Real Time GPS|Real Time GPS]]''' function.

Choose this command to import tracks or waypoints from a '''GPS Garmin eTrex''' device. The GPS device must be connected to the PC with a serial data cable or Bluetooth.

* '''GPS:''' In this field the information about the GPS device is displayed.
* '''Status:''' In this field the status between OCAD and GPS is displayed.

'''Connection'''
* '''Connect GPS:''' Click this button to connect OCAD with the GPS device. After a successful connection the GPS information and the status are displayed.
* '''Settings:''' Click this button to change the GPS settings. The '''Import from GPS Settings''' dialog is displayed.

'''GPS data'''
* '''Get waypoints:''' Click this button to load all waypoints. Each waypoint is displayed with in a row in the GPS data field.
* '''Get tracks:''' Click this button to download all tracks. Each track is displayed with in a row in the GPS data field. Only the start point is displayed.
[[File:Hint.jpg|hint]] This command can take several minutes!

'''OCAD objects'''
* '''Set labels:''' Check this option to create also text objects with the name of the waypoints and tracks.
* '''CRT:''' Use a '''[[Cross Reference Table]]''' to assign symbols to the waypoints and tracks. OCAD creates '''[[Unsymbolized Objects]]''' if no '''[[Cross Reference Table]]''' is selected.
: Each line of the cross reference table contains the OCAD symbol number and the Garmin symbol name.
: Example of a cross reference table:
535.0 waypoint dot
536.0 campground symbol
540.0 scenic area symbol
* '''Create:''' Select the waypoints and tracks in the GPS data field and click this button to create OCAD objects from the selected GPS data. 
[[File:Hint.jpg|hint]] A popup menu appears when clicking the list with the GPS data with the right mouse button. In this popup menu you have the option to '''Select all''', '''Unselect all''' and '''Clear list'''. With the '''Clear list''' command all waypoints and tracks are removed. In addition, you can '''Make an OCAD object'''. By clicking this command, an OCAD object of the selected track or waypoint is created.

===Import from GPS Settings===
In this dialog box you can make the setting for the GPS data import. Verify also your settings on the GPS device (e.g. data format: GARMIN)!

* '''Port:''' Choose the port where the GPS device is connected.
* '''Speed data import:''' Choose the speed of the serial port. Garmin defines 9600 bps.
* '''Coordinate system:''' Click the '''Change''' button to select or change the coordinate system. The '''[[Create a New Map#Coordinate System|Coordinate System]]''' dialog box appears.

==Import from File [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command from the '''GPS''' menu to import a GPS data file to the current map. The '''Load GPS data from files''' dialog box is displayed. Initially all importable GPS data files are listed. The following file types can be imported:
* GPX files
* FRWD files
* NMEA files
The '''Import from File''' dialog appears, where all available waypoints and tracks from the imported file are listed. There are several options in the '''OCAD objects''' part of the dialog:

* '''Set label:''' Check this option to create also text objects with the name of the waypoints and tracks.
* '''Assign Symbols:''' Check this option to assign a specified symbol to the imported objects. Otherwise OCAD will create '''[[Unsymbolized Objects]]'''.
[[File:Hint.jpg|hint]] A popup menu appears when clicking the list with the GPS data with the right mouse button. In this popup menu you have the option to '''Select all''', '''Unselect all''' and '''Clear list'''. With the '''Clear list''' command all waypoints and tracks are removed. In addition, you can '''Make an OCAD object'''. By clicking this command, an OCAD object of the selected track or waypoint is created.

Click the '''Import''' button to import all selected tracks or waypoints in the list.

===GPS Map Offset===
This dialog box appears if the GPS coordinates are out of the maximum map size. Adjust the following parameters:

* '''Coordinate system''' If you work with GPS you must select a coordinate system. Click the '''Change''' button to select or change the coordinate system. The '''[[Create_a_New_Map#Coordinate_System|Coordinate System]]''' dialog box appears.
* '''Offset''' Choose here whether you want to change the OCAD real world coordinates or to keep the existing ones.
* '''New offset:''' Choose this option if no real world coordinates are defined for the map. OCAD already proposes reasonable values. You can leave theme unchanged.
* '''Existing offset and angle:''' Choose this option if the map already has real world coordinates and you want to fit the imported objects to the existing coordinates.

== Laser Rangefinder [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Read more about using the '''"TruPulse 360/360B" Laser Rangefinder''' on the '''[[Laser Rangefinder]]''' page

----
Back to [[Main Page]]

OCAD Preferences

2024-11-04T11:57:00Z

GRS: /* Geoviewer url */

[[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]

The OCAD Prefernces can be set in the '''[[Options]]''' menu.

''Some preferences are not available in the '''OCAD Starter''' and '''OCAD Course Setting''' editions.''
==GUI (Graphical User Interface)==
[[File:OcadPreferences UserInterface.png]]
===Right click in drawing area opens context menu===
If enabled, the context menu is shown by clicking on the drawing area with the right mouse button. 

[[File:ContextMenu.png]] 

[[File:ChangeToStraightLineMode.gif]]

In the upper part of the '''Context''' menu, you can switch between the current '''[[Drawing_an_Object|Drawing Mode]]''', the [[File:Icon SelectAndEditObject.PNG]] '''[[Select#Select and Edit Object|Select and Edit Object]]''' mode and the [[File:Icon SelectObjectAndEditVertex.PNG]] '''[[Select#Select Object and Edit Vertex|Select Object and Edit Vertex]] mode. 
In the lower part of the '''Context''' menu, you can change the view either with the [[File:Icon Pan.PNG]] '''[[View#Pan|Pan]]''', [[File:Icon ZoomIn.PNG]] '''[[View#Zoom_In|Zoom In]]''', [[File:Icon ZoomOut.PNG]] '''[[View#Zoom_Out|Zoom Out]]''' or the [[File:Icon ShowEntireMap.PNG]] '''[[View#Show_Entire_Map|Show Entire Map]]''' tool. 
 
If disabled, you can switch between the current '''[[Drawing_an_Object|Drawing Mode]]''' and the [[File:Icon SelectObjectAndEditVertex.PNG]] '''[[Select#Select Object and Edit Vertex|Select Object and Edit Vertex]]''' mode by clicking on the drawing area with the right mouse button.

=== Right mouse click toggles between drawing and editing tools===
This option is only activated if the '''Context menu in drawing area''' option is deactivated.

We recommend to deactivate this option when drawing on a tablet with a pen. In this case OCAD ignores the right click during drawing.

===Wider splitter between drawing area and symbol box===
If this option is enabled, the splitter between the symbol box and the drawing area appears wider as usual. This feature may improve the user-friendliness. 
[[File:WiderSplitter.PNG]]

===Toolbars===
Show or Hide the following toolbars in this field:

* '''[[Graphical_User_Interface#Editing_and_Drawing_Toolbar|Editing and Drawing Toolbar]]'''
* '''[[Graphical_User_Interface#Edit_Functions_Toolbar|Edit Functions Toolbar]]'''
* '''[[Graphical_User_Interface#Mobile_Toolbar|Mobile Toolbar]]'''
* '''[[Graphical_User_Interface#Numeric_Keypad_Toolbar|Numeric Keypad Toolbar]]'''
* '''[[Graphical_User_Interface#Sketch_Toolbar|Sketch Toolbar]]'''
* '''[[Graphical_User_Interface#Standard_Toolbar|Standard Toolbar]]'''
* '''[[Graphical_User_Interface#View_Toolbar|View Toolbar]]'''

Click the '''Reset''' button to reset the toolbar positions to the default settings. Please restart OCAD for the changes to take effect. This function is sometimes used if an undocked toolbar outside the screen.

Click the '''Customize''' button to add or remove icons to/from the toolbars.

===Status bar===
Choose the format of the coordinates appearing in the [[Graphical_User_Interface#Status_Bar|Status Bar]] in this box. 
[[File:StatusBarSettings.PNG]]

===Style===
Change the virtual appearance of the GUI by choosing one in the dropdown list.

===Reset docking panels===
Reset the docking panels (symbol box, GPS box and database box). OCAD restart needed to take effect.

Use this function if the symbol box is hidden.

==File==
[[File:OcadPreferences File.png]]
=== Auto file load when opening OCAD ===
Check this box to load the last map you worked on automatically when OCAD is started. Otherwise no map will be loaded.

=== Clear file history ===
Click this button to clear the file history from [[File#Open_Recently_Exported_Documents|Recently Exported Documents]] and [[File#Open_Recently_Used_OCAD_Files|Recently Used OCAD Files]].
If a drive from the file history files does not exist anymore, e.g. disconnected network drives, it may needs more time to open the [[File| File menu]]. This function solves the problem.

===Create ocd file association===
Click this button to associate the running OCAD edition with .ocd files.
OCAD must run as administrator to execute this function (change file association in Windows Registry).

[[File:Create ocd file association.png]]

Confirm to run as administrator.

[[File:CreateOcdFileAssociation2.png]]

Alternatively, go to '''Settings>Apps>Default apps''' and '''Chosse default apps by file type'''.

[[File:Hint.jpg]] Normally, default file type for .ocd files is set during installation. However, if you run OCAD in the Cloud, the default file type is not set.

=== Temporary OCAD Folder ===
While working on an open file OCAD is saving all changes to temporary file(s) in a tmp folder. This folder can be changed here. By default it is C:\Users\[USERNAME]\AppData\Roaming\OCAD\tmp.

OCAD saves the WMS images in this folder.

=== Ghostscript File Path ===
OCAD using Ghostscript to converting a pdf background map to a jpg file when [[Background_Map#Open_a_Background_Map|opening the pdf file]].

[https://ghostscript.com/releases/gsdnld.html Download] and install Ghostscript.

After the installation click the '''Choose (...)''' button to set the file path of the Ghostscript exe program file (e.g. ''C:\Program Files\gs\gs9.55.0\bin\gswin64.exe'').

[[File:GhostscriptFilePathNew.png]]

===Auto-backup===
Activate the checkbox '''Create auto-backup when opening OCAD file''' and every time you open an .ocd-file, OCAD will save a backup of this file. You can also create a backup manually by using the [[Create_Backup|'''Create Backup''']] funktion in the '''File''' menu.

Click the '''Choose''' button to set a file path for the auto-backup. 
Activate '''Compress file''' to save disk space.

[[File:Hint.jpg]] Remember to clean out the auto-backup directory from time to time.

[[File:Auto-backup.png]]

===Default coordinate system===

Set here the default coordinate system for your template files.

[[File:DefaultCoordinateSystem.png]]

==View==
[[File:OcadPreferences View.png]]
===User defined zoom in menu item===
Enter a value to specify the [[View#User_Defined|User Defined Zoom]]. Choose '''User Defined''' in the '''View''' menu to apply the specified zoom to the map.

===Use mouse wheel to zoom in and out instead of scrolling===
Use mouse the wheel to zoom in and out instead of scrolling.

Use ''CTRL + mouse wheel'' for vertical scrolling. 
Use ''CTRL + SHIFT + mouse wheel'' for horizontal scrolling.

[[File:Mousewheelscrolling.gif]]

===View mode loop===
With the '''View mode loop''' tool you can easily switch between different view modes. Select the view modes you want to switch between in the '''View mode loop''' box in the '''View''' category of '''OCAD Preferences'''. 
To use the '''View mode loop''' you have to define a '''[[Shortcuts|Shortcut]]''' for '''View - View Mode Loop'''. Afterwards you can switch between the set view modes using the '''[[Shortcuts|Shortcut]]'''.

Visit the '''[[View Mode#View Mode Loop|View Mode Loop]]''' article to get more information about this function.

===Color Correction===
On some monitors colors and gamma of the map are not displayed correctly. Use the controller to regulate the color and gamma manually. Click on the '''Standard''' button to set the '''Color Correction''' back to default.

===Redraw background automatically===
If this option is enabled, the map is redrawn after every single modification of the map (This may reduce the performance of OCAD). Otherwise you have to press the '''F5''' key or select '''Redraw''' in the '''View''' menu to redraw the map. 

[[File:RedrawBackgroundAutomatically.PNG]]

===Faster text rendering===
Enable the '''Faster text rendering''' option to render text faster and less precisely. This may increase the performance of OCAD. 

[[File:FasterTextRendering.PNG]]

===Screen Grid===
[[File:OCADPreferencesScreenGrid.PNG]]

In this section of the '''OCAD Preferences''' the color and the appearance of the '''[[View#Show Screen Grid|Screen Grid]]''' can be changed.

Change the '''Color''' by clicking the [[File:Icon_Setup.PNG]] '''Setup''' icon.

Click the '''Default''' button to reload the default gray color.

Choose a '''Style''' from the dropdown menu. The '''[[View#Show Screen Grid|Screen Grid]]''' can either be '''Solid''', '''Dashed''' or '''Dotted'''.

==Select==
[[File:OcadPreferences Select.png]] 
You can choose between two modes to select multiple objects:
* All objects must be with at least one vertex in the selection.
* All objects must be completely in the selection. 
[[File:OCADPreferences Select.gif]]

You can find more information about selecting multiple objects on this page: '''[[Select#Select and Edit Multiple Objects|Select and Edit Multiple Objects]]'''.

==Object==
[[File:OcadPreferences Object.png]]
===Object stretching===
If this option is activated, you are able to stretch objects in the [[File:Icon SelectAndEditObject.PNG]] '''[[Select#Select and Edit Object|Select and Edit Object]]''' mode. 
You can find more about stretching objects on this page: '''[[Select#Select and Edit Object|Select and Edit Object]]'''.

===Unsymbolized objects===
Choose a color for [[Unsymbolized Objects]] by clicking on the '''Setup''' [[File:Icon_Setup.PNG]] icon. The '''Color Picker''' dialog appears and you can configure the color.

==Drawing and Editing==
[[File:OcadPreferences Drawing.png]]
===Drawing Bézier curves===
Choose the preferred mode for drawing curves.
*In OCAD mode, only the direction of a dragged tangent is used. The distance from the normal vertices to the curve vertices is calculated automatically. This is the recommended mode.
*In Illustrator mode, the length of the dragged tangent is used to calculate the distance of the curve vertex.

[[File:OCADPreferences Bezier.gif]]

You can find more about drawing curves on the following page: '''[[Drawing an Object#Draw a Curve|Draw a Curve]]'''

=== Curve mode: Change to straight line mode when clicking in drawing area ===
Check this box to draw straight lines also in curve mode. See more in '''[[Drawing_an_Object#Change_to_Straight_Line_Mode|Change to Straight Line Mode]]'''

===Convert freehand to curve when drawing===
Check this box to convert lines and areas to curves when drawing in freehand mode. Otherwise they remain as polygons. The settings made in the '''Smooth when drawing freehand''' dropdown list of the '''Tolerances''' field determine the smoothing level. 
[[File:Freehand_To_Curve.PNG]]

===Freehand mode: Adapted for tablet with pen===
If you work with tablet and a pen, using the Frehand mode will be much more confortable with this option as you can draw objects like intended. 
Without this option, you would need to lift your pen some milimeters over your tablet when drawing an object. 
See video here a [https://youtu.be/Kd_ffinXkR0 video on YouTube]. 

[[File:FreehandModeforTablet.png]]

===Close Area Objects===
OCAD closes drawn area objects automatically if this option is checked. That means, if the start and end point of the object are different, OCAD adds an end point with the same position as the start point.

Choose [[Topology#Close_Area_Objects|'''Close Area Objects''']] in the '''Topology''' part of the '''Object''' menu to close already drawn area objects. 
[[File:Close_Area_Objects_When_Drawing.PNG]]

===Move closed start and end points of line and area objects together===
When this option is switched on, and the start and end points of a line or area object coincide (the line is closed), they are moved together during editing. If you move the start point, then the end point will also move. 
[[File:OCADPreferences MoveEndPoints.gif]]

=== Move line and area segments===
Activate this option to be able to move line and area segments. 
[[File:MoveSegments.gif]]

=== Join affects all line symbols in symbol group ===
When this option is switched on, OCAD [[Topology#Join|joins]] the ends of selected line objects that are in the same [[Symbol_Box#Symbol_Tree|symbol group]] (symbol tree). If deactivated, OCAD only joins if the line objects have the same symbol.

The option affects the [[File:Icon_Join.PNG]] [[Topology#Join|Join function]] and [[File:Icon_AutomaticJoining.PNG]] [[Topology#Automatic_Joining|Automatic Joining]] during drawing.

===Following existing objects===
Uncheck the '''Side lines of double lines''' option if side lines of double lines should not be traced when you are following existing lines. You can find more about this topic on the '''[[Drawing an Object#Following Existing Objects|Following Existing Objects]]''' page. 
[[File:Side_Lines_Of_Double_Lines.PNG]] 

===Tolerances===
*'''Select objects:''' This tolerance defines the maximum distance on each side of a thin line where you can click to select it. Objects with a thicker main line than the tolerance level can be selected by clicking on the entire line width. The default value is 5 pixels. 
:[[File:Hint.jpg]] This tolerance is further used in multiple tools like '''[[Cut#Cut_Line|Cut lines]]''', '''[[Cut#Cut_Area|Cut areas]]''', '''[[Drawing_an_Object#Following_Existing_Objects|Following existing objects]]''', '''[[Reshape|Reshape]]''', '''[[Vertices|Add Vertex, Remove Vertex, Change Vertex Type]]'''. 

*'''Snapping:''' If you activate the '''[[Snapping]]''' tool, moving a vertex close to an objects has a snapping effect. This tolerance defines the maximum distance you have to approach to the object, so that the vertex snaps to it. The default value is 5 pixels. 

*'''Join when drawing lines:''' This tolerance defines the maximum distance a vertex has to approach to another line end to [[Topology#Join|join]] it. The default value is 0.25 mm. If the line width is bigger than this tolerance then OCAD takes the line width as the tolerance. This tolerance is used for lines and areas 
:[[File:Joining_Lines.PNG]] 

*'''Merge lines:''' This tolerance defines the maximum distance two line endes can be apart to still get merged.

*'''Smooth when drawing freehand:''' There are three smoothing levels for freehand drawing mode: slightly, medium and strong. They correspond to 0, 1 and 2 in earlier OCAD versions. 
:[[File:Smoothing_Levels.PNG]] 

*'''Change to Bezier curve:''' This tolerance defines the maximum distance the vertices can move away from the original position by changing from polyline to Bezier curve. The default value is 0.10 mm. Note that the distance between the curve and the polyline can be greater between the vertices. 
:[[File:Change_To_Bezier.PNG]] 

*'''Smooth (generalization):''' This tolerance is used by the Douglas-Peucker smoothing algorithm. Vertices that are closer to the direct line between the previous and the next vertex are removed. The default value is 0.05 mm.

This smooth tolerance is also used in the 'Change to Polyline' function.
:[[File:Smooth.PNG]]

===Cursor color===
You can change the cursor color to black, red, blue, purple or yellow by selecting a color in the dropdown list.
====Scale Cursor Size====
Check this option to enlarge the cursor to the default size on high-DPI monitors with Windows 10 Creators Update.

===Mark===

Set the mark size to normal, large or very large. 
[[File:Mark_Size.PNG]]

Choose a mark color by clicking the [[File:Icon_Setup.PNG]] '''Setup''' icon. 
[[File:Mark_Color.PNG]]

The mark color is used during drawing and to mark the selected objects. 
[[File:Mark_Color_Drawing.PNG]]

The GPS cursor in GPS Real Time mode is also drawn with the choosen mark color. 
[[File:Mark_Color_GpsCursor.PNG]]

[[File:Hint.jpg]] OCAD uses the choosen mark color only on white background. Otherwise OCAD choose a color with high contrast to the background color. 
[[File:Mark_Color_HighContrast.PNG]]

===Legibility===
'''Show legibility halo''': The legibility halo shall support the cartographer to draw objects with enough distance to each other. 
The distance of this legibility halo is based on the IOF specifications for orienteering maps. The distance can also be defined by the user.

[[File:Live Preview.png]]

'''Check IOF minimum dimensions''': Activate this option to check directly during drawing whether the drawn line or area object corresponds to the minimum dimension of the IOF specifications for orienteering maps.

In the lower left corner of the screen, an indication appears whether the object has already fulfilled the minimum dimension or not. If this is the case, the indication appears green. If not, the indication appears red. In this case, an additional percentage indication shows by how much the object is too small.

[[File:CheckIOFMinimumDimensions.gif]]

===Enable live preview===
Enable this option to show the real dimension of objects during drawing.

The preview of the objects will be shown in the '''[[OCAD_Preferences#Mark|Mark Color]].

[[File:LivePreviewEnabled.gif]]

===Auto scroll===
Check this option if the map view should automatically scroll if you drag out of the drawing area. Disable '''Auto scroll''' if you have a slow PC.

===Change to Select and Edit Object mode when selecting two or more objects===
Check this option to automatically get the [[Select#Select_and_Edit_Object|Select and Edit Object mode]] when selecting two or more objects.

[[File:ChangeSelectMode.gif]]

==Symbol==
[[File:OcadPreferences Symbol.png]]
===Default symbol folder===
You can change the default symbol folder by clicking on the [[File:Icon_Setup.PNG]] '''Browse''' icon. Choose a folder as ''default symbol folder'' which you want to load symbols from when you create a new map. Click on the [[File:Icon_Delete2.PNG]] '''Delete''' icon to clear the current folder path. If no folder is selected, OCAD loads symbols from the ''Symbol'' folder in the ''OCAD program directory'' (usually: ''C:\Program Files\OCAD\OCAD 20xx\Symbol\'') when you want to create a new map. 

===Symbol===
* '''Selected symbol blinks in symbol box''': If you check this option, the selected symbol blinks in the symbol box. This makes it easier to recognize the selected symbol.
* '''Lock symbol positions in symbol box''': If you check this option, you are not able to drag and drop a symbol to a new position in the symbol box.
* '''Auto select symbol when selecting object''': If you check this option, the corresponding symbol is automatically selected when you select an object. This does not work when you select multiple objects.
* '''Change to drawing mode when selecting a symbol''': If you check this option, OCAD change to a drawing mode when selecting a symbol in the symbol box. If the symbol has a preffered drawing mode then OCAD change to this drawing mode.
* '''Set symbol status visible when changing to Protected''': Check this option if you prefer to have the same behaviour as in earlier OCAD versions. In this case OCAD always sets the symbol status Visible when changing to Protected.

==GPS==
[[File:OcadPreferences GPS.png]]
===GPS Log File===
Check the '''Log all positions sent from gps''' option to save all position sent from a GPS device in real time to a log file (Text-File). Click the [[File:Icon_Setup.PNG]] '''Browse''' icon to choose a folder, the log files are saved to. The log files are named with the date and time the real time GPS is enabled.

==Warnings==
[[File:OcadPreferences Warnings.png]]
===Warnings for hidden symbols===
These warnings can be activated when you either [[Printing Maps|print]], [[Export Files|export]] or [[Import Files|import]] a map. If you check those options, you will get a warning message if you have [[Symbol#Hide|hidden]] symbols on the map and you are trying to carry out one of mentioned operations.
===Moving warnings===
Enable the '''Move multiple objects''' option to get a warning message when you move [[Select#Select and Edit Multiple Objects|multiple objects]]. Use this option in order to guard against moving [[Select#Select and Edit Multiple Objects|multiple objects]] accidentally.
===Database warnings===
Check these options to show [[Database#Database_Compatibility|Database Compatibility]] warnings about 32/64bit and dBase.

==General==
[[File:OcadPreferences General.png]]
===Updater===
Disable the option '''Check for Service Updates when you start OCAD''' to not check for new free '''[[Service_Update|Service Updates]]''' when you start OCAD. Is some cases this check takes too long.

Known bugs are corrected in Service Updates. Additionally, new functions are added constantly with the subscription model. Therefore, we recommend using OCAD software always with the most recent Service Update to benefit from the quality improvements. The latest Service Update is also available on our website in the [https://www.ocad.com/en/service-update/ Download] section.

===OCAD Blog===
If this option is activated, new OCAD blog posts are shown when you start OCAD.

===Google API Key===
Enter here your Google API Key. This key is used in the [[New_Map_Wizard#Choose_Cross_Reference_Table|New Map Wizard]] to create a DEM via the Google Maps API.

Link: [https://developers.google.com/maps/documentation/javascript/get-api-key Get API Key]
===Geoviewer url===
Enter here the user-defined url to open a geoviewer clicking the '''Open Geoviewer''' icon [[File:IconGSV.PNG]] in the toolbar.

By default it is Google Street View.

Supported variables:
* {easting}
* {northing}
* {latitude}
* {longitude}
* {direction}

Examples:

* Apple Look Around Viewer: https://lookmap.eu.pythonanywhere.com/#c=17/{latitude}/{longitude}&p={latitude}/{longitude}&a={direction}/0
* Google Street View: http://maps.google.com/maps?q=&layer=c&cbll={latitude},{longitude}&cbp=11,{direction},0,0,0

* swisstopo map: https://map.geo.admin.ch/?lang=de&topic=ech&bgLayer=ch.swisstopo.swissimage&layers_opacity=0.8&layers_visibility=false&E={easting}&N={northing}&zoom=13

* mapy.cz: https://mapy.cz/zakladni?x={longitude}&y={latitude}&z=17

* Ordnance Survey map: https://osmaps.ordnancesurvey.co.uk/{latitude},{longitude},17

DEM Import Wizard

2024-09-20T07:09:09Z

GRS: /* Create Contour Lines File:Space.PNGThis function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartographyThis function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering */

With the '''DEM Import Wizard''' you can import DEM data and create different outputs like Contour lines, a Hill shading map or a Vegetation height map. The main purpose of the DEM Wizard is to create base maps for orienteering map making.

[[File:Hint.jpg]] There is a tutorial which shows a possible way to '''[[Using_Airborne_Laserscanning_Data_for_Orienteering_Base_Map_Generation|proceed and use LiDAR data in OCAD for orienteering sport]]'''.

==DEM Import Data [[File:Space.PNG]][[File:Mas40px.png|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

The DEM Import Wizard is able to import files with regular and irregular DEM data. Supported DEM data formats are:
==== las, laz and zLas Files ====
The LAS format (*.las) is a file format designed for the interchange and archiving of lidar point cloud data.

The *.laz and *.zLas files are compressed LAS file.

OCAD uses the [http://www.cs.unc.edu/~isenburg/lastools/ laszip.exe] and [http://rapidlasso.com/2015/04/20/new-lasliberator-frees-lidar-from-closed-format/ LASliberator] tools form [http://www.cs.unc.edu/~isenburg/ Martin Isenburg] to decompress the laz and zLas files.

==== ASCII Grid XYZ file and Raw data ASCII XYZ file ====
File format *.xyz

==== ESRI ASCII Grid ====
File format *.asc

==== SRTM Files ====
This is a world wide available DEM data set from the Shuttle Radar Topography Mission (SRTM).
SRTM data (*.hgt) import requires that a coordinate system set in the OCAD map file.

Link: https://lta.cr.usgs.gov/SRTM1Arc

==== rar Files ====
Please note that OCAD can not handle file names with Non-ASCII character like ''Å''.

File format *.rar

==== GML file ====
File Format *.gml or *.xml

==== TIFF file ====
File Format *.tif 
Please not that normally a *.tif file is a raster image that is used as background map. However, some *.tif files can store DEM data and can therfore be imported and processed in the DEM Import Wizard.

==Start Import DEM Wizard==
Open the '''DEM Import Wizard''' in the '''DEM''' Menu. The DEM Import Wizard appears. Otherwise you can also drag and drop an DEM file from Windows File Explorer onto the OCAD drawing area.

[[File:DEMImportFilesEmpty.png]]

=== Importable Files ===

First use '''Add''' button to add at least 1 DEM to the '''DEM Import Wizard''' dialog. 
Alternatively, just drag&drop the files into the drawing area

You have three different options:
* Choose a las files which often contain both DTM and DSM data
* Choose only DTM data
* Choose DTM and DSM data

==== Choose las Files ====
* After adding a las file you can select the item and click the '''LAS Info''' button. The '''LAS File Header''' dialog opens wich shows the information from the file header like the ''Number of Points by Return'' or the ''Extent''.

[[File:DEMLasFileHeader.png]]

* Click on '''Show''' to see the tile in LasView.

[[File:ShowLasTile.png]]

==== Choose DTM Data ====
Add only the DTM file(s).

Please note that not all functions (e.g. vegetation height) are available if only DTM data are available.

[[File:DemImportWizard3.png]]

==== Choose DTM and DSM Data ====
Add the DTM file(s) on the left side and the DSM file(s) on the right.

[[File:DemImportWizard4.png]]

If the DSM have an other extent than the DTM then OCAD cuts to the DSM to the extent of the DTM or the choosen extent.

=== Coordinate System ===
Usually the DEM data are in the same coordinate system as the OCAD map. So no transformation is necessary.

OCAD supports the transformation during the DEM import. Click the '''Choose''' button to select the coordinate system of the DEM data.

[[File:DemImportWizard5.png]]

In this example OCAD transforms the DEM data from ''US State Plane (Feet)'' to the metric UTM Zone 18 North.

* '''Convert height values from Feet to Meters''': Optional it is possible to convert also the height values from Feet to Meters. Some DEM data in USA are provides in Feet.
* '''Convert height values from mm to Meters''': Optional it is possible to convert also the height values from Millimeters (mm) to Meters. Some DEM data in UK are provides in mm.
* '''Shift elevations below sea level''': OCAD cannot work with elevations below the sea level. OCAD shifts them to 0m when importing the data. This option is a temporary workaround. If the option is checked then OCAD shifts all elevations by 1000m. So check this option if you have terrain below the sea level.

=== Extent ===
DEM data are often big. So the calculation needs a lot of time and memory.
If you do not need the whole extent of DEM data you can enter here the used extent.

[[File:Hint.jpg]] The extent is in terms of the Map Coordinate System, not the Input Coordinate System.

Please note that when an object is selected in the drawing area and you open the DEM Import Wizard, OCAD uses the extent of the selected object as default extent.

[[File:DemImportWizard6.png]]

Click the '''Next''' button. OCAD imports the file(s). Depends on the file size of data this step can takes some minutes.
The '''Settings''' dialog appears.

== Settings ==
This dialog shows the information about the DEM data.

[[File:DEMSettings.png]]

=== Analyze Files ===
OCAD shows here the information about the map extent and the average number of point per square meter.

If the source file is a regular grid (data type of import files = grid), the '''Cell size''' box is set to read only. OCAD sets the same cell size for the imported DEM. For irregular DEM data source (data type of import files = raw) the cell size can be set in the 'cell size' box. For these DEM's OCAD interpolates a regular grid with the specified cell size during the import. The cell size depends on the import data and the further usage of the DEM.

[[File:Hint.jpg|hint]] The '''Cell size''' range is between 0.01 and 650 m. A resolution of 1 m is appropriate for orienteering base maps. 

=== File Name ===
During the import procedure the imported DEM must be saved in the OCAD DEM file format (*.ocdDem) and it is loaded to the OCAD map.

Choose here the file name of this DEM file.

If only one import file is choosen OCAD uses by default the file name of the import file. Otherwise the filename of the ocd map.

If the ocd file is untiteled OCAD exports the DEM files in the temporary user directory (''C:\Users\XXX\AppData\Roaming\OCAD\OCAD 20xx\Tmp'').

=== Options ===
OCAD can create different outputs depending on the choosen import data type (DTM and DSM or only DTM).

: [[DEM_Import_Wizard#Create_Contour_Lines|Create Contour Lines]]
: [[DEM_Import_Wizard#Create_Hypsometric_Map|Create Hypsometric Map]]
: [[DEM_Import_Wizard#Create_Hill_Shading|Create Hill Shading]]
: [[DEM_Import_Wizard#Calculate_Slope_Gradient|Calculate Slope Gradient]]
: [[DEM_Import_Wizard#Classify_Vegetation_Height|Classify Vegetation Height]]
: [[DEM_Import_Wizard#Create_Feature_Map|Create Feature Map]]
: [[DEM_Import_Wizard#Extract_Features|Extract features]]
: [[DEM_Import_Wizard#Create Raw Data Points Map|Create Raw Data Points Map]]
: [[DEM_Import_Wizard#Create ocdLas File for LiDAR Point Cloud Manager|Create ocdLas File for LiDAR Point Cloud Manager]]
: [[DEM_Import_Wizard#Create vegegetation base map|Create vegegetation base map]]

Check or uncheck these outputs. OCAD shows for each output a page with options later in the '''DEM Import Wizard'''.

== LAS Settings ==
The LAS Settings dialog is only visble when importing las/laz/zlas files.

[[File:DEMLasSettings.png]]

On the left side OCAD shows the information about the DTM, on the right to the DSM. If is possible to create both DEMs in one step or only one DEM.

Each point is classified. The value in the round brackets is the number of points for this classification.

* Click the '''Choose DTM''' button to reset the Classification ans Return Number option to the default values.
* Click the '''Choose DSM''' button to reset the Classification ans Return Number option to the default values.

Usually the default setting are right. But in some cases it makes sense to uncheck the overlap point for the DSM. It depends on the used data. Change also this settings if the data are not classified.

=== Create Intensity and Classification Map ===
Check the option '''Create intensity and classification map''' to create these maps. If created OCAD loads these raster maps as background maps.

==== Intensity Map ====
Each data point has an intensity of the returned laser beam. This intensity is shown in a grayscale map.

Example:

[[File:DemImportWizard9.png]]
==== Classification Map ====
Each data point has a classification or is unclassified. This classification is shown in a colored map.

Example:

[[File:DemImportWizard10.png]]

The classification tiff image has the following color index:
* 0 Created, never classified (light gray)
* 1 unclassified (red)
* 2 Ground (yellow)
* 3 Low Vegetation (light green)
* 4 Medium Vegetation (green)
* 5 High Vegetation (dark green)
* 6 Building (Generic) (gray)
* 7 Low point (noise) (gray)
* 9 Water (blue)
* 10 Bridge (brown)
* 11 Road (brown)
* 12 Overlap pointd (gray)

==Create Contour Lines [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose '''Create Contour Lines''' from '''DEM''' menu or from '''DEM Import Wizard'''. The '''Create Contour Lines''' dialog box appears.

[[File:DEMContourLines.png|640px]]

This function calculates contour lines based on the DEM.

*Choose between ''Custom contours'' and ''Smoothed contours''.
'''Create custom contours (no smoothing)''': Creates custom contour lines as you are used from older OCAD versions. There will be no smoothing. Use these contours for your fieldwork. You will see every terrain detail on it, provided you chose contour interval small enough. An contour intervall of 1m, based on a 1m grid, is good practice for orienteering maps.

'''Create smoothed contours using TPI''': TPI stands for Topographic Position Index, which is defined as the difference between a central pixel and the mean of its surrounding cells. Choosing this option, OCAD first creates a smoothed DEM using TPI and calculates contours afterwards in combination with 3D-smoothing. Some details may get lost, but results are very satisfying, especially in constant slopes. Use these contours, if you want to adopt the calculated contour lines directly to your map.

[[File:ContoursTPI.PNG|580px]] 
''Custom contour lines in brown, smoothed contour lines using TPI in blue.''

*Define 1-3 contour intervals (for example 1m, 5m, 25m) for custom and/or smoothed contour lines.
: [[File:Hint.jpg]] Contour interval values can be entered manually or chosen from the list.
*Choose a line symbol for each type appears. By default, the first three line symbols in the settings are pre-selected. '''Load symbols from template''' to get 12 line symbols at the bottom of your symbol box, which you can use for the settings.
[[File:LoadSymbolsFromTemplate.PNG]]

*Choose '''Use different symbols for depression''' to distinguish depressions from hills.

*Choose '''Convert TPI contours to bézier curves''' to convert the contours from polylines to bézier curves.

*Specify the minimum (lowest) and maximum (highest) contour for the calculation.

[[File:OcadTpiContourLinesBuerenflue.png]]

''This contour creation utilising Topographic Position Index was invented and published by Pyry Kettunen, Christian Koski and Juha Oksanen, Department of Geoinformatics and Cartography, Finnish Geospatial Research Institute, NLS-FI, Finland in 2017.'' 
''A design of contour generation for topographic maps with adaptive DEM smoothing. International Journal of Cartography 3(1): 19–30. DOI: 10.1080/23729333.2017.1300998'' 
''https://doi.org/10.1080/23729333.2017.1300998''

== Create Hypsometric Map ==

Choose '''Create Hypsometric Map''' from '''DEM''' menu or from '''DEM Import Wizard'''. The '''Create Hypsometric Map''' dialog box appears.

The progression is from highest at left to lowest at right.

[[File:CreateHypsometricMap.PNG]]

This function calculates a grayscale or colored hypsometric map as GeoTIFF file. Choose one of the color ramps.

Optionally you can set white color for areas with no data.

Optionally the created raster file is directly loaded as background map.

[[File:HypsometricMap.PNG]]

== Create Hill Shading ==
Choose '''Create Hill Shading''' from '''DEM''' menu or from '''DEM Import Wizard'''. The '''Create Hill Shading''' dialog box appears.

This function calculates a shaded relief picture (hill shading).

[[File:CreateHillShading.PNG]]
=== Shading method ===
There are two calculation methods available:
* '''Slope shading''' is optimized to see outlines of features like paths in a slope.
* '''Slope shading combined with oblique light shading''' is the recommended method if the hill shading should be used as a background relief of a map. Optionally the calculated hill shading is directly loaded as background map.
=== Resolution ===
Aside from the chosen method, there is to define the '''Resolution''' and the '''Interpolation''' mode if chosen.
The default interpolation mode is Bicubic, but there are 7 other algorithm.

=== Direction ===

'''Azimuth''': The direction of the light source is 315° (north-west).

'''Multi-directional''': This is a merged image from 4 different images, in which the light source comes from one cardinal direction each. This is the default setting.

[[File:HillShading multidirectional.png]] 
Left picture: Azimuth 315° | Right Picture: Multi-directional

'''Declination''' means the elevation of the light source Default setting is 45°.

An '''Exaggeration''' factor of 4 is pre-selected and can be altered.

=== Preview ===
The '''Preview...''' button allows you get a first impression of the current setting for your hillshading and can be use to optimize it.
Click and move with the left mouse button allows to pan the current view.

The '''Preview...''' button is only enabeld when importing a dem grid file or an ocddem is already loaded. This function is disabled when importing las/laz files.

[[File:HillShadingPreview.PNG]]

[[File:Hint.jpg|hint]]To detect point and line objects like paths or watercourses from DEM we recommend using the same resolution as the DEM. To create a relief and if the DEM cell size isn’t high then we recommend to set a smaller resolution.

[[File:Hint.jpg|hint]]The default export file format is JPEG and creates an 8 bit JPEG with in grayscale and a world file with the geo reference. If you decide to export the file in TIFF-format, only with resolution option ‘DEM cell size’ then OCAD creates an 8 bit grayscale tiff with color palette. Otherwise a 24 bit RGB tiff.

=== Hillshiding (slope shading) ===
[[File:HillShading.PNG]]

=== Hillshiding (slope shading combined with oblique light shading) ===
[[File:HillShading2.PNG]]

===Error Message ''Bitmap is too big''===
The size of the hill shading image is limited. If this error message appears please enter a bigger value for the interpolation.

==Calculate Slope Gradient==
Choose '''Calculate Slope Gradient''' from '''DEM''' menu or from '''DEM Import Wizard'''. The '''Calculate Slope Gradient''' dialog box appears.

[[File:CalculateSlopeGradient.PNG]]

==== Slope Gradient Method ====

Select one of two different methods:

* Continous (<x° = grayscale / >x° = black)
* Black/White (<x° = white / >x° = black)

Enter the slope gradient threshold. Slope gradinet values over this threshold will be displayed with black pixels.

The resulting picture can be used to identify cliffs an rock faces. The result can sometimes be significantly improved with a slight adjustment of the gradient threshold (between 42-45 degrees).

Slope gradient also shows paths or relief features independent from a azimut like the [[DEM#Create_Hill_Shading|Hill Shading]].

[[File:SlopeGradient.PNG]]

==== Extract Cliff Features From Black Pixels ====

Choose this option to automatically convert cliffs into vector symbols. OCAD vectorizes the black pixels from the slope gradient calculation. By adjusting the gradient threshold, you can influence the number of cliffs.

You can also adjust the '''Cliff minimum area''' and the '''Cliff minimum length''' in pixel. The higher this value is, the more distinctiv your cliffs need to be before OCAD vectorizes them.

Three symbols will be added automatically to your Symbol Box when choosing this option: One area symbol for bigger cliffs and two line symbols for smaller cliffs. Select the cliffs and [[Change_Symbol|change their Symbol]] if desired.

[[File:ExtractCliffFeatures.png|Bürenflue, Sample Map]]

[[File:ExtractCliffFeatures2.png|Eiger North Face, Grindelwald, Switzerland]]

== Classify Vegetation Height ==
Choose '''Classify Vegetation Height''' from '''DEM''' menu or from '''DEM Import Wizard'''. The '''Classify Vegetation Height''' dialog box appears.

[[File:DEMVegetationHeight.png]]

There are two different options to show vegetation height classification:

* Gray scale classification with options: Linear, Quadratic negative, Quadratic positive
* Colored classification: Define classes with a height and color range
: - Split a class into two classes by clicking the '''Split class''' button
: - Remove a class by clicking the '''Remove class''' button
: - Load the settings from a text file by clicking the '''Load''' button
:[[File:Hint.jpg]] Several templates with different color profiles can be loaded in OCAD for the calculation of the vegetation height map. 
:[[File:VegetationHeightMaps.png]]
: - Save the settings to a text file by clicking the '''Save''' button
: - Reset the classes and colors to the default settings by clicking the '''Reset classes to default''' button

[[File:VegetationHeightColor.PNG]]

==Create Feature Map==
Option to create a feature map to show near-ground objects, e.g. cars, walls, fences, stones or tree trunks.

'''Thresholds to reclassify all points above ground''': Enter the lower and upper value for point reclassification.

[[File:DEMCreateFeatureMap.png]]

The information content of the feature map depends on the terrain type, the settings you choose in the dialog and the quality of the LiDAR data, in particular the point density. 
With good data quality, the feature map can be a useful addition to the existing background maps, to detect objects and help the cartographer to determine the exact position in the terrain.

'''Example'''

[[File:Pontresina SlopeGradientStones.png]] 
''Slope Gradient Map''

[[File:FeatureMapStones.png]] 
''Feature Map''

[[File:MapStones.png]] 
''Orienteering Map''

LiDAR data from 2022, 29 points per square meter, 0.5m cell size, 0.0-2.0m threshold. 
In the Feature Map, e.g. stones becomes visible. The stones that are already visible in the Slope Gradient Map are probably overgrown and therefore classified as ground points.

Credit goes to Jeff Teutsch and his ''Lidar Case Study - Using simple ground reclassification to see features in data''.

==Extract Features==
Choose '''Extract features''' from '''DEM Import Wizard'''. The '''Extract features''' dialog box appears.

This function extracts automatically landform and vegetation features from your data. The function is computationally intensive and may take a while.

*'''Extract landform features''': Choose this option to extract landform features. Define symbols for ''knoll'' and ''small depression''.

*'''Extract vegetation features''': Choose this option to extract vegetation features. Define the ''tree symbol''.

For both landform and vegetation features, you can adjust the '''Minimum height'''.

The chosen symbols will be loaded directly to your map.

[[File:DemWizardExtractFeatures.png]]

[[File:DEMResulatExtractFeatures.png]]

Note: This function is (1) very dependend on the quality of the data and (2) the results should be treated with caution. In terms of LiDAR data, a small knoll looks very similar to a cluster of branches, a tree stump or a small fir tree. However, the results can give you a hint, which places you should check carefully during fieldwork.

== Create Raw Data Points Map ==

The Raw Data Points Map shows you where there are data and not.

There is no further dialogue for this option.

[[File:RawDataPointMap.png]]

== Create ocdLas File for LiDAR Point Cloud Manager ==

There is no further dialogue for this option.

The output is an ocdLas file, which contains all poitns of the LiDAR point cloud and it is optimized for the use with OCAD.

This file is used to analyze the vegetation. This file is often very big (> 1 GB).

Learn more about the ocdLas file functions on the '''[[LiDAR Point Cloud Manager]]''' page.

==Create Vegetation Base Map==
If you checked this option in the '''[[DEM_Import_Wizard#Settings|DEM Settings]]''', a Vegetation Base Map will be calculated with default values. 
To adjust the settings, you need to run the '''[[LiDAR_Point_Cloud_Manager|LiDAR Point Cloud Manager]]'''.

[[File:DEMVegetationBaseMap.png]]

== Summary==
This dialog is only visible in '''DEM Import Wizard'''. It shows the progress of the different functions.

[[File:DemImportWizardSummary.png]]

After finishing the process the dialog closes automatically.

DEM Import Wizard

2024-09-16T12:30:17Z

With the '''DEM Import Wizard''' you can import DEM data and create different outputs like Contour lines, a Hill shading map or a Vegetation height map. The main purpose of the DEM Wizard is to create base maps for orienteering map making.

[[File:Hint.jpg]] There is a tutorial which shows a possible way to '''[[Using_Airborne_Laserscanning_Data_for_Orienteering_Base_Map_Generation|proceed and use LiDAR data in OCAD for orienteering sport]]'''.

==DEM Import Data [[File:Space.PNG]][[File:Mas40px.png|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

The DEM Import Wizard is able to import files with regular and irregular DEM data. Supported DEM data formats are:
==== las, laz and zLas Files ====
The LAS format (*.las) is a file format designed for the interchange and archiving of lidar point cloud data.

The *.laz and *.zLas files are compressed LAS file.

OCAD uses the [http://www.cs.unc.edu/~isenburg/lastools/ laszip.exe] and [http://rapidlasso.com/2015/04/20/new-lasliberator-frees-lidar-from-closed-format/ LASliberator] tools form [http://www.cs.unc.edu/~isenburg/ Martin Isenburg] to decompress the laz and zLas files.

==== ASCII Grid XYZ file and Raw data ASCII XYZ file ====
File format *.xyz

==== ESRI ASCII Grid ====
File format *.asc

==== SRTM Files ====
This is a world wide available DEM data set from the Shuttle Radar Topography Mission (SRTM).
SRTM data (*.hgt) import requires that a coordinate system set in the OCAD map file.

Link: https://lta.cr.usgs.gov/SRTM1Arc

==== rar Files ====
Please note that OCAD can not handle file names with Non-ASCII character like ''Å''.

File format *.rar

==== GML file ====
File Format *.gml or *.xml

==== TIFF file ====
File Format *.tif 
Please not that normally a *.tif file is a raster image that is used as background map. However, some *.tif files can store DEM data and can therfore be imported and processed in the DEM Import Wizard.

==Start Import DEM Wizard==
Open the '''DEM Import Wizard''' in the '''DEM''' Menu. The DEM Import Wizard appears. Otherwise you can also drag and drop an DEM file from Windows File Explorer onto the OCAD drawing area.

[[File:DEMImportFilesEmpty.png]]

=== Importable Files ===

First use '''Add''' button to add at least 1 DEM to the '''DEM Import Wizard''' dialog. 
Alternatively, just drag&drop the files into the drawing area

You have three different options:
* Choose a las files which often contain both DTM and DSM data
* Choose only DTM data
* Choose DTM and DSM data

==== Choose las Files ====
* After adding a las file you can select the item and click the '''LAS Info''' button. The '''LAS File Header''' dialog opens wich shows the information from the file header like the ''Number of Points by Return'' or the ''Extent''.

[[File:DEMLasFileHeader.png]]

* Click on '''Show''' to see the tile in LasView.

[[File:ShowLasTile.png]]

==== Choose DTM Data ====
Add only the DTM file(s).

Please note that not all functions (e.g. vegetation height) are available if only DTM data are available.

[[File:DemImportWizard3.png]]

==== Choose DTM and DSM Data ====
Add the DTM file(s) on the left side and the DSM file(s) on the right.

[[File:DemImportWizard4.png]]

If the DSM have an other extent than the DTM then OCAD cuts to the DSM to the extent of the DTM or the choosen extent.

=== Coordinate System ===
Usually the DEM data are in the same coordinate system as the OCAD map. So no transformation is necessary.

OCAD supports the transformation during the DEM import. Click the '''Choose''' button to select the coordinate system of the DEM data.

[[File:DemImportWizard5.png]]

In this example OCAD transforms the DEM data from ''US State Plane (Feet)'' to the metric UTM Zone 18 North.

* '''Convert height values from Feet to Meters''': Optional it is possible to convert also the height values from Feet to Meters. Some DEM data in USA are provides in Feet.
* '''Convert height values from mm to Meters''': Optional it is possible to convert also the height values from Millimeters (mm) to Meters. Some DEM data in UK are provides in mm.
* '''Shift elevations below sea level''': OCAD cannot work with elevations below the sea level. OCAD shifts them to 0m when importing the data. This option is a temporary workaround. If the option is checked then OCAD shifts all elevations by 1000m. So check this option if you have terrain below the sea level.

=== Extent ===
DEM data are often big. So the calculation needs a lot of time and memory.
If you do not need the whole extent of DEM data you can enter here the used extent.

[[File:Hint.jpg]] The extent is in terms of the Map Coordinate System, not the Input Coordinate System.

Please note that when an object is selected in the drawing area and you open the DEM Import Wizard, OCAD uses the extent of the selected object as default extent.

[[File:DemImportWizard6.png]]

Click the '''Next''' button. OCAD imports the file(s). Depends on the file size of data this step can takes some minutes.
The '''Settings''' dialog appears.

== Settings ==
This dialog shows the information about the DEM data.

[[File:DEMSettings.png]]

=== Analyze Files ===
OCAD shows here the information about the map extent and the average number of point per square meter.

If the source file is a regular grid (data type of import files = grid), the '''Cell size''' box is set to read only. OCAD sets the same cell size for the imported DEM. For irregular DEM data source (data type of import files = raw) the cell size can be set in the 'cell size' box. For these DEM's OCAD interpolates a regular grid with the specified cell size during the import. The cell size depends on the import data and the further usage of the DEM.

[[File:Hint.jpg|hint]] The '''Cell size''' range is between 0.01 and 650 m. A resolution of 1 m is appropriate for orienteering base maps. 

=== File Name ===
During the import procedure the imported DEM must be saved in the OCAD DEM file format (*.ocdDem) and it is loaded to the OCAD map.

Choose here the file name of this DEM file.

If only one import file is choosen OCAD uses by default the file name of the import file. Otherwise the filename of the ocd map.

If the ocd file is untiteled OCAD exports the DEM files in the temporary user directory (''C:\Users\XXX\AppData\Roaming\OCAD\OCAD 20xx\Tmp'').

=== Options ===
OCAD can create different outputs depending on the choosen import data type (DTM and DSM or only DTM).

: [[DEM_Import_Wizard#Create_Contour_Lines|Create Contour Lines]]
: [[DEM_Import_Wizard#Create_Hypsometric_Map|Create Hypsometric Map]]
: [[DEM_Import_Wizard#Create_Hill_Shading|Create Hill Shading]]
: [[DEM_Import_Wizard#Calculate_Slope_Gradient|Calculate Slope Gradient]]
: [[DEM_Import_Wizard#Classify_Vegetation_Height|Classify Vegetation Height]]
: [[DEM_Import_Wizard#Create_Feature_Map|Create Feature Map]]
: [[DEM_Import_Wizard#Extract_Features|Extract features]]
: [[DEM_Import_Wizard#Create Raw Data Points Map|Create Raw Data Points Map]]
: [[DEM_Import_Wizard#Create ocdLas File for LiDAR Point Cloud Manager|Create ocdLas File for LiDAR Point Cloud Manager]]
: [[DEM_Import_Wizard#Create vegegetation base map|Create vegegetation base map]]

Check or uncheck these outputs. OCAD shows for each output a page with options later in the '''DEM Import Wizard'''.

== LAS Settings ==
The LAS Settings dialog is only visble when importing las/laz/zlas files.

[[File:DEMLasSettings.png]]

On the left side OCAD shows the information about the DTM, on the right to the DSM. If is possible to create both DEMs in one step or only one DEM.

Each point is classified. The value in the round brackets is the number of points for this classification.

* Click the '''Choose DTM''' button to reset the Classification ans Return Number option to the default values.
* Click the '''Choose DSM''' button to reset the Classification ans Return Number option to the default values.

Usually the default setting are right. But in some cases it makes sense to uncheck the overlap point for the DSM. It depends on the used data. Change also this settings if the data are not classified.

=== Create Intensity and Classification Map ===
Check the option '''Create intensity and classification map''' to create these maps. If created OCAD loads these raster maps as background maps.

==== Intensity Map ====
Each data point has an intensity of the returned laser beam. This intensity is shown in a grayscale map.

Example:

[[File:DemImportWizard9.png]]
==== Classification Map ====
Each data point has a classification or is unclassified. This classification is shown in a colored map.

Example:

[[File:DemImportWizard10.png]]

The classification tiff image has the following color index:
* 0 Created, never classified (light gray)
* 1 unclassified (red)
* 2 Ground (yellow)
* 3 Low Vegetation (light green)
* 4 Medium Vegetation (green)
* 5 High Vegetation (dark green)
* 6 Building (Generic) (gray)
* 7 Low point (noise) (gray)
* 9 Water (blue)
* 10 Bridge (brown)
* 11 Road (brown)
* 12 Overlap pointd (gray)

==Create Contour Lines [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose '''Create Contour Lines''' from '''DEM''' menu or from '''DEM Import Wizard'''. The '''Create Contour Lines''' dialog box appears.

[[File:DEMContourLines.png|640px]]

This function calculates contour lines based on the DEM.

*Choose between ''Custom contours'' and ''Smoothed contours''.
'''Create custom contours (no smoothing)''': Creates custom contour lines as you are used from older OCAD versions. There will be no smoothing. Use these contours for your fieldwork. You will see every terrain detail on it, provided you chose contour interval small enough. An contour intervall of 1m, based on a 1m grid, is good practice for orienteering maps.

'''Create smoothed contours using TPI''': TPI stands for Topographic Position Index, which is defined as the difference between a central pixel and the mean of its surrounding cells. Choosing this option, OCAD first creates a smoothed DEM using TPI and calculates contours afterwards in combination with 3D-smoothing. Some details may get lost, but results are very satisfying, especially in constant slopes. Use these contours, if you want to adopt the calculated contour lines directly to your map.

[[File:ContoursTPI.PNG|580px]] 
''Custom contour lines in brown, smoothed contour lines using TPI in blue.''

*Define 1-3 contour intervals (for example 1m, 5m, 25m) for custom and/or smoothed contour lines.
: [[File:Hint.jpg]] Contour interval values can be entered manually or chosen from the list.
*Choose a line symbol for each type appears. By default, the first three line symbols in the settings are pre-selected. '''Load symbols from template''' to get 12 line symbols at the bottom of your symbol box, which you can use for the settings.
[[File:LoadSymbolsFromTemplate.PNG]]

*Choose '''Use different symbols for depression''' to distinguish depressions from hills.

*Choose '''Convert TPI contours to bézier curves''' to convert the contours from polylines to bézier curves.

*Specify the minimum (lowest) and maximum (highest) contour for the calculation.

[[File:OcadTpiContourLinesBuerenflue.png]]

''The Topographic Position Index was invented and published by Pyry Kettunen, Christian Koski and Juha Oksanen, Department of Geoinformatics and Cartography, Finnish Geospatial Research Institute, NLS-FI, Finland in 2017.'' 
''A design of contour generation for topographic maps with adaptive DEM smoothing. International Journal of Cartography 3(1): 19–30. DOI: 10.1080/23729333.2017.1300998'' 
''https://doi.org/10.1080/23729333.2017.1300998''

== Create Hypsometric Map ==

Choose '''Create Hypsometric Map''' from '''DEM''' menu or from '''DEM Import Wizard'''. The '''Create Hypsometric Map''' dialog box appears.

The progression is from highest at left to lowest at right.

[[File:CreateHypsometricMap.PNG]]

This function calculates a grayscale or colored hypsometric map as GeoTIFF file. Choose one of the color ramps.

Optionally you can set white color for areas with no data.

Optionally the created raster file is directly loaded as background map.

[[File:HypsometricMap.PNG]]

== Create Hill Shading ==
Choose '''Create Hill Shading''' from '''DEM''' menu or from '''DEM Import Wizard'''. The '''Create Hill Shading''' dialog box appears.

This function calculates a shaded relief picture (hill shading).

[[File:CreateHillShading.PNG]]
=== Shading method ===
There are two calculation methods available:
* '''Slope shading''' is optimized to see outlines of features like paths in a slope.
* '''Slope shading combined with oblique light shading''' is the recommended method if the hill shading should be used as a background relief of a map. Optionally the calculated hill shading is directly loaded as background map.
=== Resolution ===
Aside from the chosen method, there is to define the '''Resolution''' and the '''Interpolation''' mode if chosen.
The default interpolation mode is Bicubic, but there are 7 other algorithm.

=== Direction ===

'''Azimuth''': The direction of the light source is 315° (north-west).

'''Multi-directional''': This is a merged image from 4 different images, in which the light source comes from one cardinal direction each. This is the default setting.

[[File:HillShading multidirectional.png]] 
Left picture: Azimuth 315° | Right Picture: Multi-directional

'''Declination''' means the elevation of the light source Default setting is 45°.

An '''Exaggeration''' factor of 4 is pre-selected and can be altered.

=== Preview ===
The '''Preview...''' button allows you get a first impression of the current setting for your hillshading and can be use to optimize it.
Click and move with the left mouse button allows to pan the current view.

The '''Preview...''' button is only enabeld when importing a dem grid file or an ocddem is already loaded. This function is disabled when importing las/laz files.

[[File:HillShadingPreview.PNG]]

[[File:Hint.jpg|hint]]To detect point and line objects like paths or watercourses from DEM we recommend using the same resolution as the DEM. To create a relief and if the DEM cell size isn’t high then we recommend to set a smaller resolution.

[[File:Hint.jpg|hint]]The default export file format is JPEG and creates an 8 bit JPEG with in grayscale and a world file with the geo reference. If you decide to export the file in TIFF-format, only with resolution option ‘DEM cell size’ then OCAD creates an 8 bit grayscale tiff with color palette. Otherwise a 24 bit RGB tiff.

=== Hillshiding (slope shading) ===
[[File:HillShading.PNG]]

=== Hillshiding (slope shading combined with oblique light shading) ===
[[File:HillShading2.PNG]]

===Error Message ''Bitmap is too big''===
The size of the hill shading image is limited. If this error message appears please enter a bigger value for the interpolation.

==Calculate Slope Gradient==
Choose '''Calculate Slope Gradient''' from '''DEM''' menu or from '''DEM Import Wizard'''. The '''Calculate Slope Gradient''' dialog box appears.

[[File:CalculateSlopeGradient.PNG]]

==== Slope Gradient Method ====

Select one of two different methods:

* Continous (<x° = grayscale / >x° = black)
* Black/White (<x° = white / >x° = black)

Enter the slope gradient threshold. Slope gradinet values over this threshold will be displayed with black pixels.

The resulting picture can be used to identify cliffs an rock faces. The result can sometimes be significantly improved with a slight adjustment of the gradient threshold (between 42-45 degrees).

Slope gradient also shows paths or relief features independent from a azimut like the [[DEM#Create_Hill_Shading|Hill Shading]].

[[File:SlopeGradient.PNG]]

==== Extract Cliff Features From Black Pixels ====

Choose this option to automatically convert cliffs into vector symbols. OCAD vectorizes the black pixels from the slope gradient calculation. By adjusting the gradient threshold, you can influence the number of cliffs.

You can also adjust the '''Cliff minimum area''' and the '''Cliff minimum length''' in pixel. The higher this value is, the more distinctiv your cliffs need to be before OCAD vectorizes them.

Three symbols will be added automatically to your Symbol Box when choosing this option: One area symbol for bigger cliffs and two line symbols for smaller cliffs. Select the cliffs and [[Change_Symbol|change their Symbol]] if desired.

[[File:ExtractCliffFeatures.png|Bürenflue, Sample Map]]

[[File:ExtractCliffFeatures2.png|Eiger North Face, Grindelwald, Switzerland]]

== Classify Vegetation Height ==
Choose '''Classify Vegetation Height''' from '''DEM''' menu or from '''DEM Import Wizard'''. The '''Classify Vegetation Height''' dialog box appears.

[[File:DEMVegetationHeight.png]]

There are two different options to show vegetation height classification:

* Gray scale classification with options: Linear, Quadratic negative, Quadratic positive
* Colored classification: Define classes with a height and color range
: - Split a class into two classes by clicking the '''Split class''' button
: - Remove a class by clicking the '''Remove class''' button
: - Load the settings from a text file by clicking the '''Load''' button
:[[File:Hint.jpg]] Several templates with different color profiles can be loaded in OCAD for the calculation of the vegetation height map. 
:[[File:VegetationHeightMaps.png]]
: - Save the settings to a text file by clicking the '''Save''' button
: - Reset the classes and colors to the default settings by clicking the '''Reset classes to default''' button

[[File:VegetationHeightColor.PNG]]

==Create Feature Map==
Option to create a feature map to show near-ground objects, e.g. cars, walls, fences, stones or tree trunks.

'''Thresholds to reclassify all points above ground''': Enter the lower and upper value for point reclassification.

[[File:DEMCreateFeatureMap.png]]

The information content of the feature map depends on the terrain type, the settings you choose in the dialog and the quality of the LiDAR data, in particular the point density. 
With good data quality, the feature map can be a useful addition to the existing background maps, to detect objects and help the cartographer to determine the exact position in the terrain.

'''Example'''

[[File:Pontresina SlopeGradientStones.png]] 
''Slope Gradient Map''

[[File:FeatureMapStones.png]] 
''Feature Map''

[[File:MapStones.png]] 
''Orienteering Map''

LiDAR data from 2022, 29 points per square meter, 0.5m cell size, 0.0-2.0m threshold. 
In the Feature Map, e.g. stones becomes visible. The stones that are already visible in the Slope Gradient Map are probably overgrown and therefore classified as ground points.

Credit goes to Jeff Teutsch and his ''Lidar Case Study - Using simple ground reclassification to see features in data''.

==Extract Features==
Choose '''Extract features''' from '''DEM Import Wizard'''. The '''Extract features''' dialog box appears.

This function extracts automatically landform and vegetation features from your data. The function is computationally intensive and may take a while.

*'''Extract landform features''': Choose this option to extract landform features. Define symbols for ''knoll'' and ''small depression''.

*'''Extract vegetation features''': Choose this option to extract vegetation features. Define the ''tree symbol''.

For both landform and vegetation features, you can adjust the '''Minimum height'''.

The chosen symbols will be loaded directly to your map.

[[File:DemWizardExtractFeatures.png]]

[[File:DEMResulatExtractFeatures.png]]

Note: This function is (1) very dependend on the quality of the data and (2) the results should be treated with caution. In terms of LiDAR data, a small knoll looks very similar to a cluster of branches, a tree stump or a small fir tree. However, the results can give you a hint, which places you should check carefully during fieldwork.

== Create Raw Data Points Map ==

The Raw Data Points Map shows you where there are data and not.

There is no further dialogue for this option.

[[File:RawDataPointMap.png]]

== Create ocdLas File for LiDAR Point Cloud Manager ==

There is no further dialogue for this option.

The output is an ocdLas file, which contains all poitns of the LiDAR point cloud and it is optimized for the use with OCAD.

This file is used to analyze the vegetation. This file is often very big (> 1 GB).

Learn more about the ocdLas file functions on the '''[[LiDAR Point Cloud Manager]]''' page.

==Create Vegetation Base Map==
If you checked this option in the '''[[DEM_Import_Wizard#Settings|DEM Settings]]''', a Vegetation Base Map will be calculated with default values. 
To adjust the settings, you need to run the '''[[LiDAR_Point_Cloud_Manager|LiDAR Point Cloud Manager]]'''.

[[File:DEMVegetationBaseMap.png]]

== Summary==
This dialog is only visible in '''DEM Import Wizard'''. It shows the progress of the different functions.

[[File:DemImportWizardSummary.png]]

After finishing the process the dialog closes automatically.

Edit Object

2024-04-24T07:09:12Z

GRS: /* Change Creation Date */

==Basic Functions [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
====Copy and Paste====
Visit the '''[[Object|Copy and Paste]]''' page to get some information about copying and pasting objects.
====Cut and Delete====
Visit the '''[[Object|Cut and Delete]]''' page to get some information about cutting and deleting objects.

==Edit Vertices and Objects==
Visit the '''[[Select#Select_and_Edit_Object|Select an Object]]''' page to get all information about selecting an object. 
Visit the '''[[Select#Select_Object_and_Edit_Vertex|Select and Edit Vertex]]''' page to get all information about editing vertices. 

==Edit Text==
Choose the '''[[Select#Select_Object_and_Edit_Vertex|Select Object and Edit Vertex]]''' tool [[File:Icon_SelectObjectAndEditVertex.PNG]] to select the text object or the line text object. Click with the mouse curser into the text at the position where you want to change it. 
[[File:Hint.jpg|hint]] Use '''double click''' to select a word. 
[[File:Hint.jpg|hint]] Click '''three times''' to select the whole text of an object.

==Rotate==
===Rotate an Object [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]===
:[[File:Rotate_Object.gif|Rotate an object]]
Choose '''Rotate''' in the '''Rotate Object''' submenu of the '''Object''' menu or click the [[File:Icon RotateObject.PNG]] '''Rotate Object''' icon in the '''Editing and Drawing Toolbar''' to rotate an object. This function is only enabled when an object is selected.

The cursor changes to the anchor point symbol ([[File:PointSymbol.JPG|point symbol]]) first. With this cursor you can define the center of the rotation (anchor point). Click on the desired location. When the anchor point is defined, the cursor changes to the rotate symbol ([[File:RotateSymbol.JPG|rotate symbol]]). Now you can rotate the object. Move the mouse pointer to a place distant from the anchor point, press and hold the left mouse button. With the button pressed, rotate the object as desired. The object gets shown with a draft line as "preview", until you release the mouse button to finish the rotation.

===Rotate an Object by Angle [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]===
:[[File:Rotate_Object_Angle.gif|Rotate an object by angle]]
''(This function is only enabled if one or several objects are selected)'' 
Select [[File:Icon RotateObjectAngle.png]] '''Rotate (Enter Angle)''' in the '''Rotate Object''' submenu of the '''Object''' menu to rotate the selected object(s) by angle. The '''Rotate (Enter Angle)''' dialog appears.
* Enter an ''angle'' in degrees.
* Choose a rotation center option (this option is only visible if several objects are selected). 
:-''Use selected objects centroid as common rotation center'' will use the selected objects centroid as one common rotation center. This option is set by default if also line or area objects are selected. 
:-''Use each object's centroid as rotation center'' will use each object's centroid as an individual rotation center. This option is set by default if only point or text objects are selected.
* Click the '''OK''' button to finish the process.
 

==Align Objects [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Visit the '''[[Align Objects]]''' page to find some information about the [[File:Icon_AlignObjectsHorizontal.PNG]] '''Align Object: Horizontal Coordinate''', [[File:Icon_AlignObjectsHorizontalCoordinateCentered.PNG]] '''Align Objects: Horizontal Coordinate Centered''' and the [[File:Icon_AlignObjectsVertical.PNG]] '''Align Object: Vertical Coordinate''' function.

==Distribute Objects==
Theese functions distribute the selected objects with equal space between. The set borders are the upmost/leftmost and the lowest/rightmost object.

[[File:IconDistributeObjects_Horizontal.PNG]]'''Distribute Objects: Horizontal Coordinate'''
This function distributes the objects horizontally.

:[[File:Distribute_Horizontal.gif|Distribute objects horizontally]]

[[File:IconDistributeObjects_Vertical.PNG]]'''Distribute Objects: Vertical Coordinate'''
This function distributes the objects vertically.

:[[File:Distribute_Vertical.gif|Distribute objects vertically]]

==Indicate Direction of Area Pattern or Point or Text Object [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command either from the '''Objects''' menu or click the corresponding button [[File:Icon_IndicateDirectionOfAreaPatternPointOrTextObject.PNG]] in the '''Editing and Drawing Toolbar''' to indicate the direction of an area pattern, point or text object. 
This function is only enabled if a point, area or text object is selected.
Choose this function to change the direction of a point object, of the pattern of an area object or of text. Indicate the new direction by dragging a line from the object in the desired direction. 
Click once into the drawing area and the selected object will be oriented to North. 
:[[File:Indicate_Direction.gif|Indicate direction of a point object]] [[File:Indicate_Direction_Area.gif|Indicate direction of an area pattern]]
Note the difference to the Rotate button, where you first mark the anchor point and then rotate the object. In this mode you just drag a long line for the new direction. The object remains in the same place.

==Cut a Hole or Area or Line==
Visit the '''[[Cut]]''' page to get some information about the [[File:Icon_CutHole.PNG]] '''Cut Hole''', [[File:Icon_CutArea.PNG]] '''Cut Area''' and the [[File:Icon_Cut.PNG]] '''Cut Line''' function.

==Crop Objects [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Visit the '''[[Crop Objects]]''' page to find some information about the '''Crop Objects''' button.

==Move Parallel==
Visit the '''[[Move_Parallel_and_Move_and_Duplicate_Parallel_by_Specified_Distance|Move Parallel]]''' page to find some information about the [[File:Icon_MoveParallel.PNG]] '''Move Parallel''' function.

==Move/Duplicate Parallel by Specified Distance==
Visit the '''[[Move_Parallel_and_Move_and_Duplicate_Parallel_by_Specified_Distance|Move/Duplicate Parallel by Specified Distance]]''' page to find some information about the [[File:Icon_MoveParallel.PNG]] '''Move/Duplicate Parallel by Specified Distance''' function.

==Reshape [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Visit the '''[[Reshape]]''' page to find some information about the [[File:Icon Reshape.PNG]] '''Reshape''' function.

==Interpolate Objects [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Visit the '''[[Interpolate Objects]]''' page to find some information about the [[File:Icon InterpolateObjects.PNG]] '''Interpolate Objects''' function.

==Duplicate [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
A description of the [[File:Icon DuplicateObject.PNG]] '''Duplicate''' function can be found on the '''[[Duplicate_and_Move_and_Duplicate|Duplicate]]''' page.
====Move and Duplicate [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]====
Visit the '''[[Duplicate_and_Move_and_Duplicate|Move and Duplicate]]''' page to get some information about this function.
====Mirror and Duplicate [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]====
Visit the '''[[Mirror and Duplicate]]''' page to get some information about this function.

==Stretch or Shrink==
:[[File:Stretch_Shrink.gif|stretch and shrink]]
You can select Objects and strech (enlarge / reduce) them. However, the objects will not stay at their original place.

To keep each object in place during the strech / shrink process, go to '''Stretch / Shrink''' in the '''Object''' menu.
In the following dialog, it's possible to define the new horizontal and vertical length (in %). By default, the '''Preserve horizontal / vertical ratio''' option is selected.

==Fill or Make Border or Duplicate Identically [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

:[[File:Fill.gif|Fill]]

You can find this functions either in the '''Object''' menu or you can click the corresponding button [[File:Icon_FillOrMakeBorder.PNG]] in the '''Edit Functions Toolbar'''.

This function is enabled when an object is selected on the map and a symbol is selected in the symbol box which is compatible with the selected object. For example, areas can be filled with other areas, or surrounded with line objects but you cannot fill them with point objects.
With this function it is possible to do several things:
* If you use this function when you have selected an object with the same symbol as selected in the symbol box, an identical copy of the object at the same position is made.
* If you use this function when you have selected an object with the same symbol type as the symbol selected in the symbol box (e.g both are area, line, text or point symbols), a copy of the object is made at the same position and the selected symbol in the symbol box is assigned to this new object.
* If you use this function when you have selected an area object in the drawing area and a line symbol in the symbol box, a border line around the area object is created.
* The other way round, if you use this function when you have selected a line object in the drawing area and an area symbol in the symbol box, the line object is filled with the area symbol.
* If you use this function when you have selected a hole, the hole is filled if you have selected an area in the symbol box or a border line is created if you have selected a line in the symbol box. Read more about holes [[Edit_Object#Cut_a_Hole_or_Area_or_Line|here]].
* If you use this function when you have selected a line object in the drawing area and a line text object in the symbol box, a line text symbol with the default text 'LTEXT' is created along the line object.
* If you use this function when you have selected an text or point object, the bounding box is filled if you have selected an area in the symbol box or a border line is created if you have selected a line in the symbol box.

==Merge [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

:[[File:Join_Merge.gif|join and merge]]

You can find this function in the '''Object''' menu or by clicking the [[File:Icon_Merge.PNG]] '''Merge''' button in the '''Edit Functions Toolbar'''.

With this function you can merge the selected objects. It is enabled if two or more line, area or text objects with the same symbol are selected.
 
 
'''Merge Line Objects''' 
To merge line objects, the start respectively the end points of the selected lines must be close together. You can set the merge tolerance in the [[OCAD_Preferences#Tolerances|Preferences]].
OCAD merges first objects with identically endpoints.
 
 
'''Merge Area Objects''' 
To merge area objects, the selected area objects have to overlap.
 
 
'''Merge Text Objects''' 
If you merge text objects, the text parts are positioned with a line break under the first text.

[[File:Hint.jpg|hint]] When drawing line or area objects, you can continue existing line or area objects, instead of merging them afterwards. To do this, keep the '''Shift''' key pressed and start drawing at the first or last vertex of the existing object.

[[File:Hint.jpg|hint]] in you want line ends to coincide, but the objects shall remain independent, use the '''[[Topology#Join]]''' function.

==Reverse Object Direction [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
:[[File:Reverse.gif|reverse object direction]]

You can find this function in the '''Object''' menu or by clicking the [[File:Icon_ReverseObject.PNG]] '''Reverse Object''' button in the '''Edit Functions Toolbar'''.

This function is enabled when a line, line text or area object is selected. It will reverse the direction of the object, the first vertex becomes the last one and vice versa.

Reverse object direction function is useful for objects with asymmetrical line symbols. If a line or borderline has tags to the right side, the tags will point to the left side after reversing. Line text appears on the other side of the line.
 

==Change to Polyline or Bezier Curve==
You can find some help about these functions on the '''[[Change_to_Polyline_and_Change_to_Bezier_Curve|Change to Polyline or Bezier Curve]]''' page.
==Convert to==
====Graphic Object [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]====
Visit the '''[[Convert into Graphic Object]]''' page to get some information about converting objects into graphic objects.
====Image Object [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]====
Visit the '''[[Convert into Image Object]]''' page to get some information about converting objects into image objects.
====Layout Object [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]====
Visit the '''[[Convert into Layout Object]]''' page to get some information about converting objects into layout objects.

==Create Color Gradient [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
With this function you can create a color gradient. Visit the '''[[Create Color Gradient]]''' page to get more information.

==Vertices==
====Add Vertex====
The commands for adding new vertices can be found in the '''Editing and Drawing Toolbar'''. 
[[File:Icon NormalVertex.PNG]] Add normal vertex 
[[File:Icon CornerVertex.PNG]] Add corner vertex 
[[File:Icon DashVertex.PNG]] Add dash vertex 
You can find more information about adding vertices on the '''[[Vertices#Add Vertex|Vertices]]''' page.

====Remove Vertex====
Click the [[File:Icon_RemoveVertex.PNG]] '''Remove Vertex''' button in the '''Editing and Drawing Toolbar''' to remove a vertex. 
You can find more information about removing vertices on the '''[[Vertices#Remove Vertex|Vertices]]''' page.

====Change Vertex Types to [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]====
You can find this function in the '''Object''' menu. You can find more information about this function on the '''[[Vertices#Change Vertex Types to|Vertices]]''' page.

[[File:Hint.jpg]]You can also '''[[Select#Toggle_between_vertices|toggle between normal-dash-corner vertex]].'''

==Change Symbol==
===Change Symbol of Object===
[[File:Icon ChangeSymbolOfObject.PNG]] '''[[Change Symbol|Change Symbol of Object]]''': With this function you can change a selected object's symbol. This command is enabled when at least one object is selected and the symbol selected in the symbol box is compatible with it.

===Change Symbol for all Objects with this Symbol===
[[File:Icon ChangeSymbolForAllObjectsWithThisSymbol.PNG]] '''[[Change Symbol|Change Symbol for all Objects with this Symbol]]''': This function changes all objects with a symbol A to symbol B.

You can find more information about the [[File:Icon ChangeSymbolOfObject.PNG]] '''Change Symbol of Object''' and the [[File:Icon ChangeSymbolForAllObjectsWithThisSymbol.PNG]] '''Change Symbol for all Objects with this Symbol''' functions on the '''[[Change Symbol]]''' page.

==Group and Ungroup [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Learn how to group and ungroup objects on the '''[[Group and Ungroup]]''' page.

==Find and Replace Text [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]]==
Choose this command in the '''Object''' menu to find and replace text of objects. The '''Find and Replace Text''' dialog box is displayed.

The texts are loaded in the text field if the map does not contain more than 50'000 objects. If you want to load the text objects anyway then click the 'Auto fill' check box. To avoid long waiting time OCAD loads only the first 5'000 text objects in the combo box.

Find text
# Enter a text you want to find.
# If you choose the '''Case sensitive''' option, capitalization of letters is considered in the '''Find''' function.
# Choose the '''Whole words''' only option if the '''Find''' function shall ignore parts of words.
# Click the '''Find''' button. OCAD will select an object found. Click the '''Find''' button again to find the next object.
Click the '''Delete object''' to delete the last found, selected object.

Replace with
# Enter a text that shall replace the word you looked for in the '''Find text''' part.
# Click the '''Replace''' button to replace the text in the last found object. Click the '''Replace all''' button to replace every text which matches with the '''Found''' text.
Click the '''Close''' button to quit the dialog.

[[File:Hint.jpg]] Press the '''Shift''' key when opening the dialog. Then OCAD does not load the texts in the combo box. If the map contains several thousand text objects then the loading of the text objects needs some time (up to one minute).

[[File:Hint.jpg]] [http://www.regular-expressions.info '''Regular expressions''']: Please note that regular expressions use '''*, +, . or ?''' as wildcards. These charaters have to be used with a backslash ex. \+ to find only the text objects with a + character.

[[File:Hint.jpg]] Enter ''#13#10'' to replace some characters with a new line.

==Insert Glyphs [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]]==
Visit the '''[[Insert Glyphs]]''' page to find information about glyphs in OCAD.

==Measure [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command from the '''Object''' menu or click the [[File:Icon_‎Measure.PNG|measure]] '''Measure''' icon in the '''Edit Functions Toolbar'''.
This command is enabled when line or area objects or 2 point objects are selected.

Choose this command to measure the length of the selected line object(s), the area of the selected area object(s) or the distance between 2 point objects. The result is displayed in the '''Measure Result''' dialog box.

[[File:ObjectMeasure.png]]

If you select multiple line or area objects ('''[[Select#Select and Edit Multiple Objects|Select Multiple Objects]]'''), the displayed length respectively area is the sum of all selected lines or areas.

The map scale is used for the calculation.

Click on the '''Copy''' button to copy the value to the Windows Clipboard.

==Change Creation Date [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''Object''' menu to change the creation date of the selected object(s).

#Select the desired objects and open the '''Change Creation Date''' dialog.
#Enter your desired creation date and time.
#:[[File:hint.jpg|hint]]For '''New date''' is automatically the current time and date.
#Click '''OK''' to change the date.

[[File:ChangeCreationDate.png]]

This function does not change the modification date of the selected object(s).

==Object Information [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command from the '''Object''' menu to get more information about the selected object(s). This command is enabled if at least 1 object is selected.

The following information is shown in the '''Object Information''' dialog:

* Object index (for internal use)
* Server object index (for only internal use)
* Object type
* Symbol
* Color
* Creation date
* Modification date
* Number of vertices
* Elevation [m]
* Length [m]
* Width | Height [mm]] (for objects with rectangle symbol)
* Area [m2]
* Angle [°]
* Coordinates [mm] or [m] (only if 1 object is selected)
[[File:ObjectInformation.png]]

[[File:Hint.jpg]] - This is a non-modal dialog. You can always add or remove objects from a selection even if the dialog box is opened. The information in the dialog gets updated instantly if you make any changes to the selection. 
: - It is possible to save a selection in the '''Object Information''' dialog when you select multiple objects ('''[[Select#Select and Edit Multiple Objects|Select Multiple Objects]]'''). Click the '''Save Selection''' button in the dialog. Learn more about saving selections on the '''[[Select#Save Selection|Save Selection]]''' page.
: - Double click on a cell and press the '''Ctrl + C''' keys to copy a cell value to the Windows Clipboard.
: - Click on the upper copy button to copy the object information or the lower copy button to copy coordinate values to the clipboard.
: - A double click on the top row of the collums allows to sort the values.
: - Double click in the elevation field to change the object elevation.

----
Back to [[Main Page]]

Layout

2024-04-08T16:14:49Z

GRS: /* Add Trim and Bleed Marks File:Space.PNGThis function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartographyThis function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering */

[[File:Order_Layout.png|x300px]]

{| style="float:right; background:transparent; padding:0px; margin:0px;"
|- valign="top"
|[[File:EditLayoutObjects.jpg|Edit Layout Objects]]
|}

Since Ocad 11, it's possible to add layout layers in the map. This layer may contain raster images and vector objects like lines, areas or text. The vector layout objects color model is CMYK. The layout images' one is RGB. PNG transparency is not supported. Spot colors are not supported by the OCAD layout layer. 
Layout objects cannot be selected, moved, removed or changed unless you choose the '''Edit Layout Objects''' command in the '''Layout''' menu.

==Edit Layout Objects [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Use this function in the '''Layout''' menu to add, remove or edit layout objects and define their properties. The '''Edit Layout Objects''' dialog appears on the right side of the window. Now you can move, edit or remove layout objects in the drawing area like normal objects.

[[File:Layout.gif]]

===Add a line, area or text layout object:===
# Click the '''Line''', '''Area''' or '''Text''' icon in the '''Edit Layout Objects''' dialog as a '''Type'''.
# Choose a '''Color'''. Click the color field to define the color with the '''[[Color Picker]]'''.
# If you have chosen a line, define the '''Line width''' in the '''Line properties''' category in mm. If you have chosen a text, choose a '''Font''' and a '''Text size''' in the '''Text properties''' category.
# The '''Opacity''' can be defined for each object.
# Draw the layout object with the regular drawing tools.
[[File:Hint.jpg]]To edit the drawn layout object select it and change the properties (color, line width etc.) in the '''Edit Layout Objects''' dialog or use the editing functions of OCAD ('''[[Edit Object]]''').

[[File:Hint.jpg]]The error message: "Font not found" appears if a layout object is linked to a font that is not installed on the PC. The font needs to be installed on the PC (restart OCAD after you installed the font) or another font must be chosen. Otherwise the font Arial is used.

===Add an image===
Click the '''Embed''' or '''Link''' button in the '''Images''' category of the '''Edit Layout Objects''' dialog. 
The supported image files are .bmp, .gif, .jpg, .png. 
A new dialog opens and you can browse an image. 
Move and resize the image objects by using the '''Select and Edit Object''' Tool. They can be moved with arrow keys as well.

====Embed====
By embedding the layout images directly in the OCAD file, the file size increases accordingly. However, when passing on OCAD files, it is no longer necessary to ensure that the layout images are also supplied and saved in the correct folder. 
Click the '''Open''' button to embed the image. 
When embedding a png image, an input box for image width will be shown. [[File:LayoutImage.png]]

====Link====
If your map contains layout images and you pass your file forward to another person, you need to send the layout images as well, as they are not part of the OCAD file. 
Click the '''Open''' button to link the image.

====Convert====
Select a linked image in the '''Layout object list''' and the '''Convert''' button will become active. Press the '''Convert''' button and the selected image will be embedded.

====Remove====
Remove a layout image by selecting it in the '''Layout object list''' and clicking the '''Remove''' button in the '''Images''' category of the '''Edit Layout Objects''' dialog.

===Layout Object List===
:All layout objects are listed in the '''Layout object list'''. It is possible to set them visible or hidden and to move them by drag and drop or the arrow keys.
:The error message "The maximum allowed entries of layout objects is reached" appears if the list contains the maximum of 256 entries.

[[File:LayoutObjectList.gif]]

===Parameters===
{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Object Type
! style="width:12em" | Parameter
! style="width:12em" | Properties
|-
| Line Object || Color Opacity Line width || '''[[Color Picker]]''' in [%] in [mm] 
|-
| Area Object || Color Opacity || '''[[Color Picker]]''' in [%] 
|-
| Text Object || Color Opacity Text properties || in [%] Font Size in [pt] Bold Italic Bottom left Bottom center Bottom right Fully justified
|-
| Images || Add Remove
|}

==Import Layout [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command in the '''Layout''' menu to import the layout objects from another OCAD map. The layout objects are placed in the center of the actual drawing area. This command is only available if you are in the '''Edit Layout Objects''' mode.

==Save Layout [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command from the '''Layout''' menu to save the layout objects to a separate OCAD file. This command is only available if you are in the '''Edit Layout Objects''' mode.

==Delete Layout [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''Layout''' menu to delete all the layout objects. This command is only available if you are in the '''Edit Layout Objects''' mode.

==Hide [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Select '''Hide''' in the '''Layout''' menu to hide all layout objects.

==Add North Arrow or Scale Bar [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
You can add predefined north arrows or scale bars to the Layout.
# Choose '''Edit Layout Objects''' in the '''Layout''' menu.
# Choose '''Add North Arrow or Scale Bar''' in the '''Layout''' menu.
# The '''Add North Arrow or Scale Bar''' dialog appears and you can choose between different north arrows and scale bars from the ''Templates'' folder of the OCAD directory (Usually ''C:\Program Files\OCAD\OCAD 20xx Edition\Templates'').
# Click the '''Open''' button to add the selected object to the layout objects.

[[File:Hint.jpg]] - In the OCAD directory you can find a PDF-File with an overview of all predefined north arrows and scale bars (Usually ''C:\Program Files\OCAD\OCAD 20xx Edition\Templates'').
: - North arrow and scale bar templates are black. You can change the color after adding them by choosing a color from the color field in the '''Edit Layout Objects''' dialog.

==Add Map Legend [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose the '''Add Map Legend''' function from the '''Layout''' menu to create a '''Map Legend'''. The '''Add Map Legend''' dialog appears. 
'''Legend Icon''' 
Define values for the legend icon in this part of the dialog. You have to set a value for the '''Icon height''', the '''Icon width''' and the '''Line spacing'''. If you want that only used symbols are shown in the legend, check the corresponding box. In the same way, you can decide wheter hidden symbols are shown in the legend or not. 
 
'''Symbol type''' 
Only the checked symbol types are taken into consideration for the map legend. Click the '''All''' button to check or click the '''None''' button to uncheck all symbol types. 
 
'''Legend Text''' 
Choose a symbol for the legend text. This must be a text symbol of course. If you want that the symbol number is shown in the legend text, check the corresponing option. 
Click the '''OK''' button to add the map legend.

[[File:Hint.jpg|hint]] This function creates symbolized map objects, not layout objects. Use the function '''[[Convert to Layout Object]]''' to convert them into layout objects.

==Add Trim and Bleed Marks [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
[[File:TrimAndBleedMarks.PNG]] 

This command adds trim and bleed marks as layout objects to the map.
# The easiest way to add trim and bleed marks is when you set the ruler guides to the border of the map and the map layout (e.g. A4 landscape format) first. Learn how to use the ruler guides on the '''[[Ruler Guides]]''' page. If you do not want to use '''Ruler Guides''' skip this step.
# Choose the '''Add Trim and Bleed Marks''' function in the '''Layout''' menu.
# The '''Add Trim and Bleed Marks''' dialog opens.
#: [[File:TrimAndBleedMarksDialog.PNG]]
# If you are using '''Ruler Guides''', click the '''Get ruler guides coordinates''' button in the '''Trim marks''' part of the dialog, select a style (see below) and then click the '''Add''' button. Trim marks with the coordinates of the ruler guides are added. If you are not using '''Ruler Guides''', enter the paper coordinates for the trim marks manually before clicking the '''Add''' button.
# Enter the offset for the bleed marks in the '''Bleed marks''' part of the dialog if you want to add them and select a style (see below). Then click the '''Add''' button.
#: [[File:TrimAndBleedMarksDifferentStyles.PNG]]
# Click the '''Close''' button to apply all adjustments and quit the dialog.
'''Trim and Bleed Marks''' are layout objects and can be edited and removed like other layout object. 
[[File:Hint.jpg]] With adding trim and/or bleed marks, OCAD adds automatically a '''print and export rectangle''' with the corresponding extent including the marks.

==Define Paper Size [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

This command defines the paper size. The paper size is visible in the drawing area.

==Create Graticule Name Index [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]]==
This command is only available if the map is georeferenced and a [[Create_a_New_Map#Set_Scale_and_Coordinate_System|coordinate system]] is set. The command calculates a name index based on the WGS84 graticule. 
Select one or more symbols in the symbol box before choosing the command. All text objects and line text objects with these symbol(s) are included to the index. 

[[File:CreateGraticuleNameIndex.png]]

'''Create Graticule Name Index Dialog''' 
* '''Index origin of longitude/latitude''': Enter index origin coordinates.
* '''Horizontal/vertical distance''': Enter the distance between the grid lines. 
* '''Angle''': Enter the angle of the grid. This angle is zero, if the grid is not rotated. 
* '''Style''': Choose a numbering style. One axis is always numbered "A, B, C..." and the other "1, 2, 3...". Alternatively, you can choose the WGS84 style. 
* '''Symbol''': Choose a text symbol. It is used as a symbol for the name index text objects.

After clicking the '''OK''' button a text object with the index will be added in the center of the drawing area and can be moved to the desired position.

[[File:Hint.jpg|hint]] This function creates symbolized map objects, not layout objects. Use the function '''[[Convert to Layout Object]]''' to convert the index to layout objects. 
[[File:Hint.jpg|hint]] '''[[Create_WGS84_Grid|Create WGS84 Grid]]''' is the corresponding function to create a graticule. 
[[File:Hint.jpg|hint]] Define a '''Tab''' in the name index text symbol therewith the indices are written in a column.
===Error Message ''Text is too long''===
Each text object in OCAD is limited by 32000 characters. This error message appears when the text has more charcaters. OCAD copies the full text string in the Windows Clipboard. In this case we recommend you to split the text string from Windows Clipboard in a Text editor and paste it into OCAD.

==Create Name Index [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]]==
Make sure you have selected one or more text or line text symbols in the symbol box before choosing '''Create Name Index''' in the '''Layout''' menu. The '''Create Name Index Dialog''' appears.

[[File:CreateNameIndexDialog.PNG]]

OCAD creates the name index from all objects from the selected text or line text symbols. For example, if you want to list all street names, select all symbols for street names in the symbol box. 

[[File:CreateNameIndex.PNG|600px]]

* '''Name index range''': Choose '''Entire map''' to create the index for the entire map or choose '''Part of map''' for a desired part. OCAD uses the part of maps defined in the [[Export_Files#Setup_Part_of_Map|print and export dialogs]].
* '''Horizontal/vertical offset''': Enter the coordinate of the upper left or lower left corner where the numbering of the grid starts (in this example the origin of the A1 square). The coordinate can be easily found out by reading them in the '''[[Graphical User Interface#Status Bar|Status Bar]]''' while hovering with the mouse over this point.
* '''Horizontal/vertical distance''': Enter the distance between the grid lines (in this example the distance from A to B square respectively from 1 to 2 square.
* '''Angle''': Enter the angle of the grid if it is rotated. Usually, namely in the case of exactly horizontal and vertical grid lines, the angle is zero.
* '''Style''': Choose a numbering style. One axis is always numbered "A, B, C..." and the other "1, 2, 3..."
* '''Symbol''': Choose a text symbol. It is used for the text objects, building the name index.

After clicking the '''OK''' button a text object with the index will be added in the center of the drawing area and can be moved to a desired position.

[[File:Hint.jpg|hint]] This function creates symbolized map objects, not layout objects. Use the function '''[[Convert to Layout Object]]''' to convert the index to layout objects. 
[[File:Hint.jpg|hint]] '''[[Map#Create_Map_Grid|Create Map Grid]]''' is the corresponding function to create a rectangular map grid. OCAD does not create a map grid with the '''Create Name Index''' function. 
[[File:Hint.jpg|hint]] Define a '''Tab''' in the name index text symbol therewith the indices are written in a column.

===Error Message ''Text is too long''===
Each text object in OCAD is limited by 32000 characters. This error message appears when the text has more charcaters. OCAD copies the full text string in the Windows Clipboard. In this case we recommend you to split the text string from Windows Clipboard in a Text editor and paste it into OCAD.

==Convert to Layout Object[[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Visit the '''[[Convert to Layout Object]]''' page to get some information about this function.

==Generate QR Code[[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose the '''Generate QR Code''' to generate and add a QR Code to your map.

You can now quickly and easily create a QR code of any text directly in OCAD and place it on the map. 
This way you can easily link from your map to further information, e.g. fact sheets, points of interest or live results.

[[File:GenerateQrCode.png]]

'''Text''': You can enter any text, e.g. an URL. If you read the QR code with your QR Scanner, this text will be displayed.

'''Quite zone''': The QR Code symbol area requires a margin or "quiet zone" around it to be read and used. The margin is a clear area around a symbol where nothing is printed.

'''Size''': Set the size in mm. You can also change the size by [[Select#Select_and_Edit_Object|selecting]] the QR Code and enlarge / reduce it.

'''Color''': Choose a color.

'''Add to map''': Adds the QR Code to the map.

[[File:GenerateQrCodeExample.png]]

[[File: Hint.jpg]] In OCAD, the QR Code is displayed as grouped '''[[Image_Objects|Image Objects]]'''. Make sure the Image Objects are not hidden (Menu [[Symbol#Image_Objects|'''Symbol > Image Objects''']])

Layout

2024-04-08T16:13:58Z

GRS: /* Define Paper Size File:Space.PNGThis function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartographyThis function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering */

[[File:Order_Layout.png|x300px]]

{| style="float:right; background:transparent; padding:0px; margin:0px;"
|- valign="top"
|[[File:EditLayoutObjects.jpg|Edit Layout Objects]]
|}

Since Ocad 11, it's possible to add layout layers in the map. This layer may contain raster images and vector objects like lines, areas or text. The vector layout objects color model is CMYK. The layout images' one is RGB. PNG transparency is not supported. Spot colors are not supported by the OCAD layout layer. 
Layout objects cannot be selected, moved, removed or changed unless you choose the '''Edit Layout Objects''' command in the '''Layout''' menu.

==Edit Layout Objects [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Use this function in the '''Layout''' menu to add, remove or edit layout objects and define their properties. The '''Edit Layout Objects''' dialog appears on the right side of the window. Now you can move, edit or remove layout objects in the drawing area like normal objects.

[[File:Layout.gif]]

===Add a line, area or text layout object:===
# Click the '''Line''', '''Area''' or '''Text''' icon in the '''Edit Layout Objects''' dialog as a '''Type'''.
# Choose a '''Color'''. Click the color field to define the color with the '''[[Color Picker]]'''.
# If you have chosen a line, define the '''Line width''' in the '''Line properties''' category in mm. If you have chosen a text, choose a '''Font''' and a '''Text size''' in the '''Text properties''' category.
# The '''Opacity''' can be defined for each object.
# Draw the layout object with the regular drawing tools.
[[File:Hint.jpg]]To edit the drawn layout object select it and change the properties (color, line width etc.) in the '''Edit Layout Objects''' dialog or use the editing functions of OCAD ('''[[Edit Object]]''').

[[File:Hint.jpg]]The error message: "Font not found" appears if a layout object is linked to a font that is not installed on the PC. The font needs to be installed on the PC (restart OCAD after you installed the font) or another font must be chosen. Otherwise the font Arial is used.

===Add an image===
Click the '''Embed''' or '''Link''' button in the '''Images''' category of the '''Edit Layout Objects''' dialog. 
The supported image files are .bmp, .gif, .jpg, .png. 
A new dialog opens and you can browse an image. 
Move and resize the image objects by using the '''Select and Edit Object''' Tool. They can be moved with arrow keys as well.

====Embed====
By embedding the layout images directly in the OCAD file, the file size increases accordingly. However, when passing on OCAD files, it is no longer necessary to ensure that the layout images are also supplied and saved in the correct folder. 
Click the '''Open''' button to embed the image. 
When embedding a png image, an input box for image width will be shown. [[File:LayoutImage.png]]

====Link====
If your map contains layout images and you pass your file forward to another person, you need to send the layout images as well, as they are not part of the OCAD file. 
Click the '''Open''' button to link the image.

====Convert====
Select a linked image in the '''Layout object list''' and the '''Convert''' button will become active. Press the '''Convert''' button and the selected image will be embedded.

====Remove====
Remove a layout image by selecting it in the '''Layout object list''' and clicking the '''Remove''' button in the '''Images''' category of the '''Edit Layout Objects''' dialog.

===Layout Object List===
:All layout objects are listed in the '''Layout object list'''. It is possible to set them visible or hidden and to move them by drag and drop or the arrow keys.
:The error message "The maximum allowed entries of layout objects is reached" appears if the list contains the maximum of 256 entries.

[[File:LayoutObjectList.gif]]

===Parameters===
{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Object Type
! style="width:12em" | Parameter
! style="width:12em" | Properties
|-
| Line Object || Color Opacity Line width || '''[[Color Picker]]''' in [%] in [mm] 
|-
| Area Object || Color Opacity || '''[[Color Picker]]''' in [%] 
|-
| Text Object || Color Opacity Text properties || in [%] Font Size in [pt] Bold Italic Bottom left Bottom center Bottom right Fully justified
|-
| Images || Add Remove
|}

==Import Layout [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command in the '''Layout''' menu to import the layout objects from another OCAD map. The layout objects are placed in the center of the actual drawing area. This command is only available if you are in the '''Edit Layout Objects''' mode.

==Save Layout [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command from the '''Layout''' menu to save the layout objects to a separate OCAD file. This command is only available if you are in the '''Edit Layout Objects''' mode.

==Delete Layout [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''Layout''' menu to delete all the layout objects. This command is only available if you are in the '''Edit Layout Objects''' mode.

==Hide [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Select '''Hide''' in the '''Layout''' menu to hide all layout objects.

==Add North Arrow or Scale Bar [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
You can add predefined north arrows or scale bars to the Layout.
# Choose '''Edit Layout Objects''' in the '''Layout''' menu.
# Choose '''Add North Arrow or Scale Bar''' in the '''Layout''' menu.
# The '''Add North Arrow or Scale Bar''' dialog appears and you can choose between different north arrows and scale bars from the ''Templates'' folder of the OCAD directory (Usually ''C:\Program Files\OCAD\OCAD 20xx Edition\Templates'').
# Click the '''Open''' button to add the selected object to the layout objects.

[[File:Hint.jpg]] - In the OCAD directory you can find a PDF-File with an overview of all predefined north arrows and scale bars (Usually ''C:\Program Files\OCAD\OCAD 20xx Edition\Templates'').
: - North arrow and scale bar templates are black. You can change the color after adding them by choosing a color from the color field in the '''Edit Layout Objects''' dialog.

==Add Map Legend [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose the '''Add Map Legend''' function from the '''Layout''' menu to create a '''Map Legend'''. The '''Add Map Legend''' dialog appears. 
'''Legend Icon''' 
Define values for the legend icon in this part of the dialog. You have to set a value for the '''Icon height''', the '''Icon width''' and the '''Line spacing'''. If you want that only used symbols are shown in the legend, check the corresponding box. In the same way, you can decide wheter hidden symbols are shown in the legend or not. 
 
'''Symbol type''' 
Only the checked symbol types are taken into consideration for the map legend. Click the '''All''' button to check or click the '''None''' button to uncheck all symbol types. 
 
'''Legend Text''' 
Choose a symbol for the legend text. This must be a text symbol of course. If you want that the symbol number is shown in the legend text, check the corresponing option. 
Click the '''OK''' button to add the map legend.

[[File:Hint.jpg|hint]] This function creates symbolized map objects, not layout objects. Use the function '''[[Convert to Layout Object]]''' to convert them into layout objects.

==Add Trim and Bleed Marks [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
[[File:TrimAndBleedMarks.PNG]] 

This command adds trim and bleed marks as layout objects to the map.
# The easiest way to add trim and bleed marks is when you set the ruler guides to the border of the map and the map layout (e.g. A4 landscape format) first. Learn how to use the ruler guides on the '''[[Ruler Guides]]''' page. If you do not want to use '''Ruler Guides''' skip this step.
# Choose the '''Add Trim and Bleed Marks''' function in the '''Layout''' menu.
# The '''Add Trim and Bleed Marks''' dialog opens.
#: [[File:TrimAndBleedMarksDialog.PNG]]
# If you are using '''Ruler Guides''', click the '''Get ruler guides coordinates''' button in the '''Trim marks''' part of the dialog, select a style (see below) and then click the '''Add''' button. Trim marks with the coordinates of the ruler guides are added. If you are not using '''Ruler Guides''', enter the paper coordinates for the trim marks manually before clicking the '''Add''' button.
# Enter the offset for the bleed marks in the '''Bleed marks''' part of the dialog if you want to add them and select a style (see below). Then click the '''Add''' button.
#: [[File:TrimAndBleedMarksDifferentStyles.PNG]]
# Click the '''Close''' button to apply all adjustments and quit the dialog.
'''Trim and Bleed Marks''' are layout objects and can be edited and removed like other layout object. 
[[File:Hint.jpg]] With adding trim and/or bleed marks, OCAD adds automatically a '''print and export rectangle''' with the corresponding extent including the marks.

==Define Paper Size
[[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

This command defines the paper size. The paper size is visible in the drawing area.

==Create Graticule Name Index [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]]==
This command is only available if the map is georeferenced and a [[Create_a_New_Map#Set_Scale_and_Coordinate_System|coordinate system]] is set. The command calculates a name index based on the WGS84 graticule. 
Select one or more symbols in the symbol box before choosing the command. All text objects and line text objects with these symbol(s) are included to the index. 

[[File:CreateGraticuleNameIndex.png]]

'''Create Graticule Name Index Dialog''' 
* '''Index origin of longitude/latitude''': Enter index origin coordinates.
* '''Horizontal/vertical distance''': Enter the distance between the grid lines. 
* '''Angle''': Enter the angle of the grid. This angle is zero, if the grid is not rotated. 
* '''Style''': Choose a numbering style. One axis is always numbered "A, B, C..." and the other "1, 2, 3...". Alternatively, you can choose the WGS84 style. 
* '''Symbol''': Choose a text symbol. It is used as a symbol for the name index text objects.

After clicking the '''OK''' button a text object with the index will be added in the center of the drawing area and can be moved to the desired position.

[[File:Hint.jpg|hint]] This function creates symbolized map objects, not layout objects. Use the function '''[[Convert to Layout Object]]''' to convert the index to layout objects. 
[[File:Hint.jpg|hint]] '''[[Create_WGS84_Grid|Create WGS84 Grid]]''' is the corresponding function to create a graticule. 
[[File:Hint.jpg|hint]] Define a '''Tab''' in the name index text symbol therewith the indices are written in a column.
===Error Message ''Text is too long''===
Each text object in OCAD is limited by 32000 characters. This error message appears when the text has more charcaters. OCAD copies the full text string in the Windows Clipboard. In this case we recommend you to split the text string from Windows Clipboard in a Text editor and paste it into OCAD.

==Create Name Index [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]]==
Make sure you have selected one or more text or line text symbols in the symbol box before choosing '''Create Name Index''' in the '''Layout''' menu. The '''Create Name Index Dialog''' appears.

[[File:CreateNameIndexDialog.PNG]]

OCAD creates the name index from all objects from the selected text or line text symbols. For example, if you want to list all street names, select all symbols for street names in the symbol box. 

[[File:CreateNameIndex.PNG|600px]]

* '''Name index range''': Choose '''Entire map''' to create the index for the entire map or choose '''Part of map''' for a desired part. OCAD uses the part of maps defined in the [[Export_Files#Setup_Part_of_Map|print and export dialogs]].
* '''Horizontal/vertical offset''': Enter the coordinate of the upper left or lower left corner where the numbering of the grid starts (in this example the origin of the A1 square). The coordinate can be easily found out by reading them in the '''[[Graphical User Interface#Status Bar|Status Bar]]''' while hovering with the mouse over this point.
* '''Horizontal/vertical distance''': Enter the distance between the grid lines (in this example the distance from A to B square respectively from 1 to 2 square.
* '''Angle''': Enter the angle of the grid if it is rotated. Usually, namely in the case of exactly horizontal and vertical grid lines, the angle is zero.
* '''Style''': Choose a numbering style. One axis is always numbered "A, B, C..." and the other "1, 2, 3..."
* '''Symbol''': Choose a text symbol. It is used for the text objects, building the name index.

After clicking the '''OK''' button a text object with the index will be added in the center of the drawing area and can be moved to a desired position.

[[File:Hint.jpg|hint]] This function creates symbolized map objects, not layout objects. Use the function '''[[Convert to Layout Object]]''' to convert the index to layout objects. 
[[File:Hint.jpg|hint]] '''[[Map#Create_Map_Grid|Create Map Grid]]''' is the corresponding function to create a rectangular map grid. OCAD does not create a map grid with the '''Create Name Index''' function. 
[[File:Hint.jpg|hint]] Define a '''Tab''' in the name index text symbol therewith the indices are written in a column.

===Error Message ''Text is too long''===
Each text object in OCAD is limited by 32000 characters. This error message appears when the text has more charcaters. OCAD copies the full text string in the Windows Clipboard. In this case we recommend you to split the text string from Windows Clipboard in a Text editor and paste it into OCAD.

==Convert to Layout Object[[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Visit the '''[[Convert to Layout Object]]''' page to get some information about this function.

==Generate QR Code[[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose the '''Generate QR Code''' to generate and add a QR Code to your map.

You can now quickly and easily create a QR code of any text directly in OCAD and place it on the map. 
This way you can easily link from your map to further information, e.g. fact sheets, points of interest or live results.

[[File:GenerateQrCode.png]]

'''Text''': You can enter any text, e.g. an URL. If you read the QR code with your QR Scanner, this text will be displayed.

'''Quite zone''': The QR Code symbol area requires a margin or "quiet zone" around it to be read and used. The margin is a clear area around a symbol where nothing is printed.

'''Size''': Set the size in mm. You can also change the size by [[Select#Select_and_Edit_Object|selecting]] the QR Code and enlarge / reduce it.

'''Color''': Choose a color.

'''Add to map''': Adds the QR Code to the map.

[[File:GenerateQrCodeExample.png]]

[[File: Hint.jpg]] In OCAD, the QR Code is displayed as grouped '''[[Image_Objects|Image Objects]]'''. Make sure the Image Objects are not hidden (Menu [[Symbol#Image_Objects|'''Symbol > Image Objects''']])

Layout

2024-04-08T16:13:02Z

[[File:Order_Layout.png|x300px]]

{| style="float:right; background:transparent; padding:0px; margin:0px;"
|- valign="top"
|[[File:EditLayoutObjects.jpg|Edit Layout Objects]]
|}

Since Ocad 11, it's possible to add layout layers in the map. This layer may contain raster images and vector objects like lines, areas or text. The vector layout objects color model is CMYK. The layout images' one is RGB. PNG transparency is not supported. Spot colors are not supported by the OCAD layout layer. 
Layout objects cannot be selected, moved, removed or changed unless you choose the '''Edit Layout Objects''' command in the '''Layout''' menu.

==Edit Layout Objects [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Use this function in the '''Layout''' menu to add, remove or edit layout objects and define their properties. The '''Edit Layout Objects''' dialog appears on the right side of the window. Now you can move, edit or remove layout objects in the drawing area like normal objects.

[[File:Layout.gif]]

===Add a line, area or text layout object:===
# Click the '''Line''', '''Area''' or '''Text''' icon in the '''Edit Layout Objects''' dialog as a '''Type'''.
# Choose a '''Color'''. Click the color field to define the color with the '''[[Color Picker]]'''.
# If you have chosen a line, define the '''Line width''' in the '''Line properties''' category in mm. If you have chosen a text, choose a '''Font''' and a '''Text size''' in the '''Text properties''' category.
# The '''Opacity''' can be defined for each object.
# Draw the layout object with the regular drawing tools.
[[File:Hint.jpg]]To edit the drawn layout object select it and change the properties (color, line width etc.) in the '''Edit Layout Objects''' dialog or use the editing functions of OCAD ('''[[Edit Object]]''').

[[File:Hint.jpg]]The error message: "Font not found" appears if a layout object is linked to a font that is not installed on the PC. The font needs to be installed on the PC (restart OCAD after you installed the font) or another font must be chosen. Otherwise the font Arial is used.

===Add an image===
Click the '''Embed''' or '''Link''' button in the '''Images''' category of the '''Edit Layout Objects''' dialog. 
The supported image files are .bmp, .gif, .jpg, .png. 
A new dialog opens and you can browse an image. 
Move and resize the image objects by using the '''Select and Edit Object''' Tool. They can be moved with arrow keys as well.

====Embed====
By embedding the layout images directly in the OCAD file, the file size increases accordingly. However, when passing on OCAD files, it is no longer necessary to ensure that the layout images are also supplied and saved in the correct folder. 
Click the '''Open''' button to embed the image. 
When embedding a png image, an input box for image width will be shown. [[File:LayoutImage.png]]

====Link====
If your map contains layout images and you pass your file forward to another person, you need to send the layout images as well, as they are not part of the OCAD file. 
Click the '''Open''' button to link the image.

====Convert====
Select a linked image in the '''Layout object list''' and the '''Convert''' button will become active. Press the '''Convert''' button and the selected image will be embedded.

====Remove====
Remove a layout image by selecting it in the '''Layout object list''' and clicking the '''Remove''' button in the '''Images''' category of the '''Edit Layout Objects''' dialog.

===Layout Object List===
:All layout objects are listed in the '''Layout object list'''. It is possible to set them visible or hidden and to move them by drag and drop or the arrow keys.
:The error message "The maximum allowed entries of layout objects is reached" appears if the list contains the maximum of 256 entries.

[[File:LayoutObjectList.gif]]

===Parameters===
{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Object Type
! style="width:12em" | Parameter
! style="width:12em" | Properties
|-
| Line Object || Color Opacity Line width || '''[[Color Picker]]''' in [%] in [mm] 
|-
| Area Object || Color Opacity || '''[[Color Picker]]''' in [%] 
|-
| Text Object || Color Opacity Text properties || in [%] Font Size in [pt] Bold Italic Bottom left Bottom center Bottom right Fully justified
|-
| Images || Add Remove
|}

==Import Layout [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command in the '''Layout''' menu to import the layout objects from another OCAD map. The layout objects are placed in the center of the actual drawing area. This command is only available if you are in the '''Edit Layout Objects''' mode.

==Save Layout [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command from the '''Layout''' menu to save the layout objects to a separate OCAD file. This command is only available if you are in the '''Edit Layout Objects''' mode.

==Delete Layout [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''Layout''' menu to delete all the layout objects. This command is only available if you are in the '''Edit Layout Objects''' mode.

==Hide [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Select '''Hide''' in the '''Layout''' menu to hide all layout objects.

==Add North Arrow or Scale Bar [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
You can add predefined north arrows or scale bars to the Layout.
# Choose '''Edit Layout Objects''' in the '''Layout''' menu.
# Choose '''Add North Arrow or Scale Bar''' in the '''Layout''' menu.
# The '''Add North Arrow or Scale Bar''' dialog appears and you can choose between different north arrows and scale bars from the ''Templates'' folder of the OCAD directory (Usually ''C:\Program Files\OCAD\OCAD 20xx Edition\Templates'').
# Click the '''Open''' button to add the selected object to the layout objects.

[[File:Hint.jpg]] - In the OCAD directory you can find a PDF-File with an overview of all predefined north arrows and scale bars (Usually ''C:\Program Files\OCAD\OCAD 20xx Edition\Templates'').
: - North arrow and scale bar templates are black. You can change the color after adding them by choosing a color from the color field in the '''Edit Layout Objects''' dialog.

==Add Map Legend [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose the '''Add Map Legend''' function from the '''Layout''' menu to create a '''Map Legend'''. The '''Add Map Legend''' dialog appears. 
'''Legend Icon''' 
Define values for the legend icon in this part of the dialog. You have to set a value for the '''Icon height''', the '''Icon width''' and the '''Line spacing'''. If you want that only used symbols are shown in the legend, check the corresponding box. In the same way, you can decide wheter hidden symbols are shown in the legend or not. 
 
'''Symbol type''' 
Only the checked symbol types are taken into consideration for the map legend. Click the '''All''' button to check or click the '''None''' button to uncheck all symbol types. 
 
'''Legend Text''' 
Choose a symbol for the legend text. This must be a text symbol of course. If you want that the symbol number is shown in the legend text, check the corresponing option. 
Click the '''OK''' button to add the map legend.

[[File:Hint.jpg|hint]] This function creates symbolized map objects, not layout objects. Use the function '''[[Convert to Layout Object]]''' to convert them into layout objects.

==Add Trim and Bleed Marks [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
[[File:TrimAndBleedMarks.PNG]] 

This command adds trim and bleed marks as layout objects to the map.
# The easiest way to add trim and bleed marks is when you set the ruler guides to the border of the map and the map layout (e.g. A4 landscape format) first. Learn how to use the ruler guides on the '''[[Ruler Guides]]''' page. If you do not want to use '''Ruler Guides''' skip this step.
# Choose the '''Add Trim and Bleed Marks''' function in the '''Layout''' menu.
# The '''Add Trim and Bleed Marks''' dialog opens.
#: [[File:TrimAndBleedMarksDialog.PNG]]
# If you are using '''Ruler Guides''', click the '''Get ruler guides coordinates''' button in the '''Trim marks''' part of the dialog, select a style (see below) and then click the '''Add''' button. Trim marks with the coordinates of the ruler guides are added. If you are not using '''Ruler Guides''', enter the paper coordinates for the trim marks manually before clicking the '''Add''' button.
# Enter the offset for the bleed marks in the '''Bleed marks''' part of the dialog if you want to add them and select a style (see below). Then click the '''Add''' button.
#: [[File:TrimAndBleedMarksDifferentStyles.PNG]]
# Click the '''Close''' button to apply all adjustments and quit the dialog.
'''Trim and Bleed Marks''' are layout objects and can be edited and removed like other layout object. 
[[File:Hint.jpg]] With adding trim and/or bleed marks, OCAD adds automatically a '''print and export rectangle''' with the corresponding extent including the marks.

==Define Paper Size [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

This command defines the paper size. The paper size is visible in the drawing area.

==Create Graticule Name Index [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]]==
This command is only available if the map is georeferenced and a [[Create_a_New_Map#Set_Scale_and_Coordinate_System|coordinate system]] is set. The command calculates a name index based on the WGS84 graticule. 
Select one or more symbols in the symbol box before choosing the command. All text objects and line text objects with these symbol(s) are included to the index. 

[[File:CreateGraticuleNameIndex.png]]

'''Create Graticule Name Index Dialog''' 
* '''Index origin of longitude/latitude''': Enter index origin coordinates.
* '''Horizontal/vertical distance''': Enter the distance between the grid lines. 
* '''Angle''': Enter the angle of the grid. This angle is zero, if the grid is not rotated. 
* '''Style''': Choose a numbering style. One axis is always numbered "A, B, C..." and the other "1, 2, 3...". Alternatively, you can choose the WGS84 style. 
* '''Symbol''': Choose a text symbol. It is used as a symbol for the name index text objects.

After clicking the '''OK''' button a text object with the index will be added in the center of the drawing area and can be moved to the desired position.

[[File:Hint.jpg|hint]] This function creates symbolized map objects, not layout objects. Use the function '''[[Convert to Layout Object]]''' to convert the index to layout objects. 
[[File:Hint.jpg|hint]] '''[[Create_WGS84_Grid|Create WGS84 Grid]]''' is the corresponding function to create a graticule. 
[[File:Hint.jpg|hint]] Define a '''Tab''' in the name index text symbol therewith the indices are written in a column.
===Error Message ''Text is too long''===
Each text object in OCAD is limited by 32000 characters. This error message appears when the text has more charcaters. OCAD copies the full text string in the Windows Clipboard. In this case we recommend you to split the text string from Windows Clipboard in a Text editor and paste it into OCAD.

==Create Name Index [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]]==
Make sure you have selected one or more text or line text symbols in the symbol box before choosing '''Create Name Index''' in the '''Layout''' menu. The '''Create Name Index Dialog''' appears.

[[File:CreateNameIndexDialog.PNG]]

OCAD creates the name index from all objects from the selected text or line text symbols. For example, if you want to list all street names, select all symbols for street names in the symbol box. 

[[File:CreateNameIndex.PNG|600px]]

* '''Name index range''': Choose '''Entire map''' to create the index for the entire map or choose '''Part of map''' for a desired part. OCAD uses the part of maps defined in the [[Export_Files#Setup_Part_of_Map|print and export dialogs]].
* '''Horizontal/vertical offset''': Enter the coordinate of the upper left or lower left corner where the numbering of the grid starts (in this example the origin of the A1 square). The coordinate can be easily found out by reading them in the '''[[Graphical User Interface#Status Bar|Status Bar]]''' while hovering with the mouse over this point.
* '''Horizontal/vertical distance''': Enter the distance between the grid lines (in this example the distance from A to B square respectively from 1 to 2 square.
* '''Angle''': Enter the angle of the grid if it is rotated. Usually, namely in the case of exactly horizontal and vertical grid lines, the angle is zero.
* '''Style''': Choose a numbering style. One axis is always numbered "A, B, C..." and the other "1, 2, 3..."
* '''Symbol''': Choose a text symbol. It is used for the text objects, building the name index.

After clicking the '''OK''' button a text object with the index will be added in the center of the drawing area and can be moved to a desired position.

[[File:Hint.jpg|hint]] This function creates symbolized map objects, not layout objects. Use the function '''[[Convert to Layout Object]]''' to convert the index to layout objects. 
[[File:Hint.jpg|hint]] '''[[Map#Create_Map_Grid|Create Map Grid]]''' is the corresponding function to create a rectangular map grid. OCAD does not create a map grid with the '''Create Name Index''' function. 
[[File:Hint.jpg|hint]] Define a '''Tab''' in the name index text symbol therewith the indices are written in a column.

===Error Message ''Text is too long''===
Each text object in OCAD is limited by 32000 characters. This error message appears when the text has more charcaters. OCAD copies the full text string in the Windows Clipboard. In this case we recommend you to split the text string from Windows Clipboard in a Text editor and paste it into OCAD.

==Convert to Layout Object[[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Visit the '''[[Convert to Layout Object]]''' page to get some information about this function.

==Generate QR Code[[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose the '''Generate QR Code''' to generate and add a QR Code to your map.

You can now quickly and easily create a QR code of any text directly in OCAD and place it on the map. 
This way you can easily link from your map to further information, e.g. fact sheets, points of interest or live results.

[[File:GenerateQrCode.png]]

'''Text''': You can enter any text, e.g. an URL. If you read the QR code with your QR Scanner, this text will be displayed.

'''Quite zone''': The QR Code symbol area requires a margin or "quiet zone" around it to be read and used. The margin is a clear area around a symbol where nothing is printed.

'''Size''': Set the size in mm. You can also change the size by [[Select#Select_and_Edit_Object|selecting]] the QR Code and enlarge / reduce it.

'''Color''': Choose a color.

'''Add to map''': Adds the QR Code to the map.

[[File:GenerateQrCodeExample.png]]

[[File: Hint.jpg]] In OCAD, the QR Code is displayed as grouped '''[[Image_Objects|Image Objects]]'''. Make sure the Image Objects are not hidden (Menu [[Symbol#Image_Objects|'''Symbol > Image Objects''']])

Map Transform

2024-02-14T12:50:58Z

GRS: /* Rotate Map to Magnetic North File:Space.PNGThis function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartographyThis function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteeringThis function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering */

[[File:TransformExample.PNG|800px]]

==Move [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Select the '''Transform''' item in the '''Map''' menu and choose '''Move'''.

The '''Move Map''' dialog appears. Depending on wheter you are using paper coordinates or real world coordinates ('''[[Create a New Map#Set Scale and Coordinate System|Set Scale and Coordinate System]]''') you can enter different values.

[[File:Move.PNG]]

With set paper coordinates enter a '''X''' and a '''Y''' value in mm. By clicking the '''OK''' button the map is moved in the desired direction. 
With set real world coordinates enter a value in m for easting and northing. By clicking the '''OK''' button the map is moved in the desired direction. 
Check the corresponding option to move also '''[[Background Map|Background Maps]]''', '''[[Layout|Layout Objects]]''' and '''[[View#Bookmarks|Bookmarks]]'''.

[[File:Hint.jpg|hint]] Do not use this dialog to change the real world coordinate offset if the map is georeferenced. To move a georeferenced map, use the '''[[Map Transform#Center Map to Drawing Area|Center Map to Drawing Area]]''' function in the '''Transform''' submenu of the '''[[Map]]''' menu and enter the new offset.

==Stretch or Shrink [[File:Space.PNG]][[File:Pro40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Std40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
[[File:StretchShrinkExample.PNG|800px]]

Select the '''Transform''' item in the '''Map''' menu and choose '''Stretch/Shrink'''.

The '''Stretch/Shrink Map''' dialog opens.

[[File:StretchShrink.PNG]]

Enter a percentage value for the horizontal strech/shrink and the vertical stretch/shrink. If both values are the same, the proportions of the map are kept. 
Check the corresponding boxes if you want to reflect the map horizontally or vertically. 
Click the '''OK''' button when you are finished.

==Mirror [[File:Space.PNG]][[File:Pro40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Std40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
[[File:MirrorExample.PNG|800px]]

Select the '''Transform''' item in the '''Map''' menu and choose '''Mirror'''.

The '''Mirror Map''' dialog opens, which is the same as the '''Stretch/Shrink Map''' dialog.

[[File:Mirror.PNG]]

Enter a percentage value for the horizontal strech/shrink and the vertical stretch/shrink. If both values are the same, the proportions of the map are kept. 
Check the corresponding boxes if you want to reflect the map horizontally or vertically. 
Click the '''OK''' button when you are finished.

==Rotate Map [[File:Space.PNG]][[File:Pro40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Std40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
[[File:RotateMapExample.PNG|800px]]

Select the '''Transform''' item in the '''Map''' menu and choose '''Rotate Map'''.

The '''Rotate Map''' dialog opens.

[[File:Rotate.PNG]]

Enter an angle in degrees and check the option '''Rotate objects with symbols orientated to north''' if yout want the symbols stay orientated to north when you use the Rotate function. 
[[File:Hint.jpg]] To consider the declination and rotate map to magnetic north, use the function '''[[Map_Transform#Rotate_Map_to_Magnetic_North|Rotate Map to Magnetic North]]''', which is more sophisticated than the function '''Rotate Map.

[[File:Hint.jpg]] Select a Point or Line Symbol and go to the symbol diaglog ('''Symbol>Edit''') and see that the option '''Orientated to north when rotating the map''' is checked for that particular symbol.

Check '''Rotate layout objects''' and your layout objects will be rotated as well. 
Layout images will not be rotated. 
Click the '''OK''' button to finish.
 
[[File:RotateMap.gif]]

==Rotate Map to Magnetic North [[File:Space.PNG]][[File:Pro40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Std40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

This function helps you to rotate your map so that magnetic north points straight up.

To do so, the function opens Open Street Map at your current position. It takes two values into consideration:
*'''Magnetic declination''': The angle between the direction of the magnetic meridians and the direction to the geographic North Pole at the observation site.
*'''Grid convergence''': The angle at the observation site between true north and grid north.
*'''Grid magnetic angle''': The sum of the two values above, by how much the map should be rotated.
[[File:Hint.jpg]]If you want to know more about declination, we can recommend our [https://ocad.com/blog/2018/10/declination-rotate-map/ OCAD blog]. 

*'''Current angle''': The current angle of your map.
*'''Rotate by''': By default, it is the value from the '''Grid magnetic angle''' field. You can adjust it manually if you wish.
*:Example: Current angle of your map is 0°, Grid magnetic angle is 2.1° and is supposed to change +0.12° per year. It would be an option to rotate the map by 2.6°. In this case, the deviation of your map would not be more than 0.5° for the next 8 years.

Click the '''OK''' button and your map will be aligned to magnetic north.

===Options===
*'''Do not rotate objects from selected symbols''': You may not want to rotate certain objects, e.g. texts or symbols you use for the layout. Select these symbols beforehand in the Symbol box. Hold the '''Shift''' and/or '''Ctrl''' key for multiple selection.
*'''Do not rotate image objects''': Set this option active, if you do not want to rotate image objects.
*'''Do not rotate layout objects''': Set this option active, if you do not want to rotate layout objects.

[[File:Hint.jpg]]Your map has to be georeferenced and a Coordinate System has to been set to use this function.

[[File:Hint.jpg]]If the web service is not available, plese see [[Error_Messages#Web_service_for_declination_not_available|here]].

[[File:Hint.jpg]]In the '''Map''' Menu, there are two more functions where you could rotate your map:
*'''[[Create_a_New_Map#Set_Scale_and_Coordinate_System|Set Scale and Coordinate System]]''': Do not edit the Angle in the function '''Set Scale and Coordinate System'''. Only change the angle there, if you start a new map and haven't drawn any objects yet.
*'''[[Map_Transform#Rotate_Map|Rotate Map]]''': The function '''Rotate Map''' is basically the same as '''Rotate Map to Magnetic North''', but not that sophisticated.

[[File:RotateMapToMagneticNorth.png]]

==Change Coordinate System [[File:Space.PNG]][[File:Pro40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Std40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Select the '''Transform''' item in the '''Map''' menu and choose '''Change Coordinate System'''.

The '''Change Coordinate System''' dialog opens.

[[File:ChangeCoordinateSystem.PNG]]

The current coordinate system is displayed in the '''Change map from''' part of the dialog. 
Click the '''Choose''' button in the '''Into''' part to choose a new coordinate system. Select the system in the '''[[Create_a_New_Map#Coordinate_System|Coordinate System]]''' dialog and click the '''OK''' button. 
The new offset is displayed in the '''Horizontal offset''' and '''Vertical offset''' fields and can be edited there, too. 

The option '''Scale symbols''' is only enabled when [http://en.wikipedia.org/wiki/Mercator_projection Google Mercator] coordinate system is choosen. If this option is checked then OCAD scales all symbols according to the new scale in the center of the map. The map looks similar as before the transformation.

Click the '''OK''' button when finished. OCAD converts every vertex' coordinate to UTM and then (if necessary) to the desired coordinate system. Due to different origins of the coordinate systems the map gets transformed (stretched/shrinked and rotated).

==Affine [[File:Space.PNG]][[File:Pro40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Std40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Select the '''Transform''' item in the '''Map''' menu and choose '''Affine''' to adjust the whole map on background map or on grid. With this function you can geo-reference the map.
The '''grid button''' must be pressed to see the grid.
You can use 1 to 12 points for the adjustment. For each point you do the following:
# Mark a point on map.
# Mark the same grid point on reference (background map or grid).

When you have adjusted enough points, press the '''Enter''' key on the keyboard. The map is rotated and stretched (Affine transformation) to get the best fit for the adjustment points.
You can achieve a precise adjustment with 4 adjustment points arranged in a rectangle. In this way you can compensate rotation and distortion. The horizontal and vertical scales will be adjusted individually.

[[File:Hint.jpg]] This function works in the same way as the '''[[Background_Map#Adjust_a_Background_Map|Adjust a Background Map]]''' function, but it is for the map.

==Rubbersheeting [[File:Space.PNG]][[File:Pro40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Std40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Select the '''Transform''' item in the '''Map''' menu and choose '''Rubbersheeting''' to adjust the map or a part of the map to a geo-referenced background map. The '''Rubbersheeting Transformation''' dialog appears.

[[File:Rubbersheeting.PNG]]

===Rubbersheeting perimeter===
The '''Rubbersheeting perimeter''' is an area in which the '''Rubbersheeting Transformation''' is carried out. Objects outside of the rubbersheeting perimeter are not transformed. 
Click the '''Define''' button and define the perimeter by drawing a polyline on the map (one corner per click). To define a new rubbersheeting perimeter click the '''Remove''' button to remove the actual one. Click the '''Load''' button to load an exported rubbersheeting perimeter (txt-File). Click the '''Save''' button to save the current perimeter.

===Rubbersheeting settings===
Check the corresponding boxes if you want to transform objects with protected symbols, transform layout objects or decrease rubbersheeting towards the border of the perimeter.

===Rubbersheeting points===
Click the '''Add''' button and do the following steps:
* Click a point on the map.
* Click the same point on the reference map (grid or background map). The rubbersheeting points are shown on the map by a red and a green cross and a connection line.
* Do the same procedure for other points.
* Click the '''Transform''' button to transform the map. Click the '''Save''' button to save the rubbersheeting points. Click the '''Remove''' button to remove the selected rubbersheeting point. Click the '''Remove all''' button to remove all rubbersheeting points. Click the '''Load''' button to load a saved selection of rubbersheeting points.

[[File:Rubbersheeting2.PNG]]

Click the '''Close''' button when finished.

[[File:Rubbersheeting3.PNG]]

[[File:Hint.jpg|hint]] -Click the '''Undo''' button in the [[Graphical_User_Interface#Standard_Toolbar|Standard Toolbar]] if you are not satisfied with the rubbersheeting transformation.
: -Uncheck rubbersheeting points in the '''Used''' column if they should not be included in the transformation. Unchecked rubbersheeting points appear in gray color on the map.
: -The rubbersheeting perimeter defines that only objects or vertices of objects within this perimeter are transformed. But it is possible that objects or vertices of objects are moved out of the perimeter by the transformation! Place rubbersheeting point pairs with the same position on the perimeter border to avoid this.
: -The '''[[Map Transform#Affine|Affine]]''' function is much easier to handle and gives more or less the same result.

==Local Transformation==
Local Transformation is an ''interactive'' tool to '''eliminate local distortions'''. This tool makes the adjustment of existing maps to geo-referenced base maps (hillshading, orthophotos etc.) easier and more accurate too. 
Select the Transform item in the '''Map''' menu and choose '''Local Transformation''' to open the '''Local Transformation''' dialog.
:[[File:LocalTransformation.png]]
# Define the ''Radius'' of transformation.
# Choose if objects with ''protected symbol'' and ''layout objects'' shall be transformed as well.
# Click on the '''Start the interactive transformation''' button.
# Press the left mouse button at the transformation center and move the mouse meanwhile to transform. The mouse up needs to be within the circle.
::[[File:hint.jpg|hint]] While pressing the left mouse button, the beforehand defined transformation radius will be shown with a blue circle.
::[[File:hint.jpg|hint]] Each vertex inside the circle will be transformed. Thus the transformation doesn't stop exactly at the border of the circle for line and area objects that are partially within the circle. They get transformed until their first vertex out of the circle.
::[[File:hint.jpg|hint]] It is possible to edit the map while having opened the non-modal '''Local Transformation''' dialog.
:[[File:LocalTransformationExample.png]]

==Center Map in Drawing Area [[File:Space.PNG]][[File:Pro40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Std40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Select the '''Transform''' item in the '''Map''' menu and choose '''Center Map in Drawing Area'''. The '''Center Map in Drawing Area''' dialog appears.

[[File:CenterMapToDrawingArea.png|800px]]

This function is often used to center a map drawn in OCAD Mapping Solution edition into the smaller drawing area from OCAD Orienteering, Starter or CS edition. OCAD moves the map offset, all objects, all background maps and all bookmarks. After this function the map is still geo-referenced.
In the dialog the extent with the existing map offset is shown in grey, the extent with the new offset in blue. The green rectangle shows the drawing area of OCAD Mapping Solution edition (80x80m), the orange the drawing area from Orienteering, Starter and CS edition (4x4m).
If a map should be visible in all OCAD editions then the entire map must fit in the 4x4m drawing area.

The proposed new map offset is displayed in the '''New map offset''' fields and can be edited there. This new map offset is calculated from the map and his visible background maps. If the background maps are hidden then OCAD calculates the new map offset only from the map.

[[File:Hint.jpg]] '''Look for area symbols with a hatching structure''' (e.g. north lines) that have been cut out to make underlying objects visible. For an ISOM 2017 1:10'000 map, the hatch for north lines area symbol has a distance of 30mm, which is 300m in reality. If you center the map to the drawing area, you should adjust the suggested offset so it is divisible by 300m, e.g. 3km. (Example: Existing offset: 619000, Suggested New Offset: 612000, Adjust Offset to: 613000).
After the transformation the map is not excalty centered, but all area structures with hatch distance divisible by 300m remain the same.

Click the '''Center map''' button to move the map to the center of the drawing area.

The geo-reference of the map is not changed.

----
Back to the '''[[Map]]''' page.

Send File by Email

2024-01-29T10:14:26Z

GRS: Replaced content with "Function is not availale anymore."

Function is not availale anymore.

File

2024-01-29T10:13:05Z

GRS: /* Send File by Email */

==New [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''File''' menu or click the [[File:Icon_New.PNG]] '''New''' button in the '''Standard''' toolbar to create a new, empty map. The '''New File''' dialog box is displayed. For further information visit the '''[[Create a New Map]]''' page.

==New Map Wizard[[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''File''' menu to create a new map using the wizard. The '''New Map Wizard''' dialog box appears. For further information visit the '''[[New Map Wizard]]''' page.

==New Course Setting Project Wizard[[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''File''' menu to create a new course setting project using the wizard. The '''New Course Setting Project Wizard''' dialog box appears. For further information visit the '''[[New Course Setting Project Wizard]]''' page.

==Open [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:View40px.PNG|This function is available in OCAD Viewer.|link=https://www.ocad.com/en/downloads/ocad-viewer]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''File''' menu or click the [[File:Icon_Open.PNG]] '''Open''' button in the '''Standard''' toolbar to open an existing map. The '''Open Map''' dialog box is displayed. Browse the map to be opened and click the '''Open''' button.

If the map was created with an earlier OCAD version, you will be asked if you want to convert it into the OCAD 2018 format. If you answer by clicking the '''No''' button, the map will not be opened.

OCAD 2018 can open maps from OCAD 6 to 2018. OCAD 2018 doesn't support earlier OCAD file formats.

[[File:Hint.jpg]] - Do not use this command to restore a backup copy from a floppy disk created with the '''[[Create Backup and Restore Backup|Create Backup]]''' command. Use the '''[[Create_Backup_and_Restore_Backup|Restore Backup]]''' command instead.
: - The error message "This OCAD version is not yet supported" appears if the file is an OCAD file from a higher OCAD version.
: - The error message "Format not correct" appears if the file is either damaged or not an OCAD file.
: - The '''Fonts Not Found''' dialog box appears if the map contains one or more fonts that are not installed on the computer. Probably the map was created on another computer. You must install the missing fonts in Windows or select other fonts. Otherwise a standard font is used for the missing ones.

==Open Sample Map [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:View40px.PNG|This function is available in OCAD Viewer.|link=https://www.ocad.com/en/downloads/ocad-viewer]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

This command chosen from the '''File''' menu opens the '''Open Sample Map''' dialog. There you can choose a sample file. The sample files are saved in the OCAD program subfolder ''Samples'' (usually ''C:\Program Files\OCAD\OCAD 20xx\Samples'').

==Close [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:View40px.PNG|This function is available in OCAD Viewer.|link=https://www.ocad.com/en/downloads/ocad-viewer]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''File''' menu to close the current map. If changes were made to the current map, then you will be asked if you want to save the changes.

==Save [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:View40px.PNG|This function is available in OCAD Viewer.|link=https://www.ocad.com/en/downloads/ocad-viewer]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command in the '''File''' menu or click the [[File:Icon_Save.PNG]] '''Save''' button in the '''Standard''' toolbar to save all changes in the current map on volume. If the current map has no name (untitled) the '''[[File#Save As|Save As]]''' dialog box will be displayed, where a name for the map can be entered.

==Save As [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:View40px.PNG|This function is available in OCAD Viewer.|link=https://www.ocad.com/en/downloads/ocad-viewer]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''File''' menu to save the current map under a new name. The '''Save As''' file dialog box is displayed.

You can use this command to save the map in a previous OCAD version (10, 11 or 12). Choose the format in the '''Save as type''' list.

To create a backup file use the '''[[Create_Backup_and_Restore_Backup |Create Backup]]''' command in the '''File''' menu.

[[File:Hint.jpg]] '''OCAD 2018 [[Course Setting for Orienteering|Course Setting]]''' files can be saved in an previous OCAD version if the file passes the '''[[Compatibility Check]]'''.

[[File:Hint.jpg]] All changes made since the old map was saved the last time are not written to the old map. They are only written to the new map.

[[File:Hint.jpg]] OCAD TRIAL can't save the ocd files in an earlier OCAD version.

==Undo [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:View40px.PNG|This function is available in OCAD Viewer.|link=https://www.ocad.com/en/downloads/ocad-viewer]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Click on the '''Undo''' icon [[File:Icon_Undo.PNG]] in the standard toolbar, press Ctrl+Z or select '''Undo''' in the '''File''' menu to undo the last draw or edit operation.

==Redo [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:View40px.PNG|This function is available in OCAD Viewer.|link=https://www.ocad.com/en/downloads/ocad-viewer]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Click on the '''Redo''' icon [[File:Icon_Redo.PNG]] in the standard toolbar, press Ctrl+Y or select '''Redo''' in the '''File''' menu to reverse the effect of the '''Undo''' operation.

==Print==
Print out the desired area of your map. Visit the '''[[Printing Maps|Printing Maps]]''' page to read all about printing.

==Import==
Choose this command to import an external file to the current map. Visit the '''[[Import Files|Import Files]]''' page for more information.

==Export==
Export the map in different file formats. See the '''[[Export Files|Export]]''' page for more information.

== Export OCAD Internet Map==
Export the map as an OCAD Internet Map. Read more about it on the '''[[OCAD Internet Map|Export OCAD Internet Map]]''' page.

==Export Encrypted File==
Export the map to encrypted OCAD file format. An encrypted OCAD map can only be loaded as a Background Map and cannot be edited. See the '''[[Encrypted_OCAD_File|Export Encrypted File]]''' page for more information.

==OCAD Sketch App Data Exchange==
Use this function in OCAD Desktop to export data to or import data from the OCAD Sketch App. See the '''[[OCAD_Sketch_App#OCAD_Sketch_App_Data_Exchange|OCAD Sketch App Data Exchange]]''' page for more information.

==Execute XML Script==
Choose this command to execute functions whose settings are defined in a XML file. Please find more information on the '''[[XML_Script|Execute XML Script]]''' page.

==Create Backup [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:View40px.PNG|This function is available in OCAD Viewer.|link=https://www.ocad.com/en/downloads/ocad-viewer]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
To create a backup of the currently opened file:
# Choose the '''Create Backup''' command in the '''[[File]]''' menu.
# The '''Backup''' dialog appears.
# OCAD creates a new folder called '''Backup''' and suggests a name for the backup file, which consists of the current date and time and the file name. Alternatively, you can enter an own name.
# Click the '''Save''' button to save the backup.

This function has not the same effect as the '''[[File#Save As|Save As]]''' function. After saving the backup you are still working on the old file.

==Open Recently Exported Documents [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:View40px.PNG|This function is available in OCAD Viewer.|link=https://www.ocad.com/en/downloads/ocad-viewer]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose '''Open Recently Exported Documents''' in the '''File''' menu to open a recently exported document from the opened OCAD file. The infomation about the recently exported documents are saved in the OCAD file that you have open. This function is not available if you do not have a file open.

Click on the '''Delete List''' command to clear the list.

Not existing files are disabled and cannot be opened.

==Open Recently Used OCAD Files [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:View40px.PNG|This function is available in OCAD Viewer.|link=https://www.ocad.com/en/downloads/ocad-viewer]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose '''Open Recently Used OCAD Files''' in the '''File''' menu to open an OCAD file which you recently opened.

Not existing files are disabled and cannot be opened.
==Exit OCAD==

Click on to exit OCAD.

----
Back to [[Main Page]]

OCAD TRIAL

2023-05-15T12:11:45Z

GRS: /* Register */

[[File:OCADTrial.jpg]]

OCAD can be downloaded as a free 14-day trial version.
==Register==
Please register for OCAD Trial on our website [https://www.ocad.com/en/trial/ https://www.ocad.com/en/trial/].

[[File:Trial1.png]]

You can choose which '''[https://www.ocad.com/en/#editions OCAD Edition]''' you want to test. You can test all editions if you like. 
The trial version contains the same functions as the full version with a few limitations.

An email with the license data and download link will be send by email.

[[File:Hint.jpg]]OCAD Trial is running only as a 64-bit version on Windows 8, 10 or 11. 

==Download and Installation==
Download, '''[[Installation|Install]]''' and '''[[Activation/Reactivation|Activate]]''' OCAD Trial.

==Start OCAD Trial==
The next time you start OCAD, you will see a dialogue:

===Continue to use the Trial Version===
Choose this option if you like to continue working with OCAD Trial. You see how many days are left from your Trial.

[[File:Trial2.png]]

===Buy an OCAD subscription license===
Fill out this form and buy an OCAD subscription license.

[[File:Trial3.png]]

===Enter the license data for the OCAD subscription license===
After you have bought an OCAD subscription license, you can enter your license data here. Your Trial version will be converted to an OCAD full license.

[[File:Trial4.png]]

XML Script

2023-04-18T08:10:33Z

GRS: /* Shape */

[[File:Mas40px.png|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]] ([[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]])

Choose this command to execute functions whose settings are defined in a XML file.

Note: Most parameters can only be used in the Mapping Solution Edition. In the Orienteering Edition, XML Script can be used for Lidar Import, DTM Import and WMTS Export.

==Introduction==

Select '''Execute XML Script''' from '''File''' menu or drag-and-drop then xml file to the OCAD window.

OCAD creates a log file in the temporary folder (''C:\Users\USERNAME\AppData\Roaming\OCAD\OCAD 20xx\Tmp'').

==XML Script General==

===File===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:40em" | Values / Description
|-
| File.New || File MapScale <del>Easting </del> <del>Northing</del> <del>Angle</del> || String Integer <del>Integer</del> <del>Integer</del> <del>Double</del> || file name of existing symbol set 10000 obsolete, use Map.ScaleAndCoordinateSystem obsolete, use Map.ScaleAndCoordinateSystem obsolete, use Map.ScaleAndCoordinateSystem
|-
| File.Open || File IgnoreMissingBackgroundMaps IgnoreMissingDatasets|| String Boolean Boolean|| ocd file name true, false (default: false) true, false (default: false)
|-
| File.Close|| Enabled || Boolean || true, false
|-
| File.Save || Enabled || Boolean || true, false
|-
| File.SaveAs || File || String || ocd file name
|-
| File.Import.Ocd || File Directory SymbolOption ColorOption || String String Integer Integer || File name [0..3] [0, 1]
|-
| File.Import.Dxf || Directory NewOffset HorizontalOffset VerticalOffset Angle MapScale || String Boolean Integer Integer Double Integer || Directory name ignored if NewOffset = false ignored if NewOffset = false ignored if NewOffset = false ignored if NewOffset = false
|-
| File.Import.GeoPackage || GpkgFilename TableName Layer CrtFilename || String String String String || 
|-
| File.MultipleFileImport
|| Directory SearchPattern CoordinateSystem NewOffset Horizontally Vertically Angle MapScale GridDistance DatabaseType Codepage KeyField LayerField LayerField2 ExtentMinimumEasting ExtentMaximumEasting ExtentMinimumNorthing ExtentMaximumNorthing
|| String String Integer Boolean Integer Integer Double Integer Double Integer Integer String String String Double Double Double Double
|| Directory of import files, e.g. ''C:\Shape\'' optional, e.g. SV*.shp [[Create_a_New_Map#Coordinate_System|Internal Grid ID]] |1000 = existing grid of OCAD file, -1 = WGS 84, 0 = dBase, 1 = Access 2007, 2 = Access 2003/2010, 3 = Do not create a database 0 = Default, Codepage number ' ' = Create new key field, field name ' ' = do not import layer information, field name ' ' = do not import 2nd layer information, field name, LayerField and LayerField2 content are concatenated by '_' 
|-
| File.Exit || Enabled || Boolean || true, false
|}

===View===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| View.Mode || || Enum types || normalMode, spotColorMode, draftMode
|-
| View.EntireMap || Enabled|| Boolean || true, false
|-
| View.MoveTo || X Y || Double Double ||  
|-
| View.Zoom ||   || Double ||  
|}

===Select===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Select.ObjectsBySymbol || SymbolNumber || Double || e.g. 526.002
|-
| Select.ObjectsBySymbol ||  ||  || use <Select.ObjectsBySymbol></Select.ObjectsBySymbol> to clear the selection
|}

===Object===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Object.ChangeVertexTypesTo || Type || Enum types || CornerVertex, DashVertex
|-
| Object.Fill || SymbolNumber || Double ||  
|-
| Object.ChangeSymbol || FromSymbolNumber FromImportedLayer ToSymbolNumber || Double String Double ||  
|-
| Object.ChangeSymbolSelectedObjects || SymbolNumber || Double || e.g. 101.001
|-
| Object.MergeObjectsBySymbol|| SymbolNumber || Double || e.g. 101.001
|}

===Symbol===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Symbol.SymbolStatusManager|| FileName SymbolStatusName|| String String || xml file name name of symbol status
|-
| Symbol.ChangeStatus|| SymbolNumber|| double|| e.g. 101.000 attribute status="visible", "protected" or "hidden"
|-
|}

===Map===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Map.OptimizeRepair|| Enabled|| Boolean || true, false
|-
| Map.ChangeScale || NewScale EnlargeReduceSymbols EnlargeReduceLineWidthOfImageAndGraphicObjects || Integer Boolean Boolean|| e. g. 10000 true, false true, false
|-
| Map.ConvertLayer|| CrtFile || String || crt file name
|-
| Map.DeleteObjectsBySymbol|| SymbolNumber SymbolTreeGroupName||Double, String String|| e.g. 526.002, ObjectsWithoutSymbol e.g. Streets
|-
| Map.ExportObjectsBySymbol|| File SymbolNumber SymbolTreeGroupName||Double String|| export ocd file name e.g. 526.002 e.g. Streets
|-
| Map.LoadSymbolsFrom || File || String || ocd file name (with symbols to be loaded) The option ''replace existing colors and symbols'' is used
|-
| Map.LoadSymbolTreeFrom|| FileName || String|| ocd file name
|-
| Map.ScaleAndCoordinateSystem || MapScale Easting Northing Angle CoordinateSystem|| Integer Integer Integer Double Integer|| e.g. 10000 e.g. 600000 e.g. 200000 e.g. 4.5 internal grid id
|-
| Map.Transform.ChangeCoordinateSystem || CoordinateSystem EastingOffset NorthingOffset ScaleSymbols|| Integer Integer Integer Boolean|| internal grid id true, false
|-
|}

===Database===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Database.Dataset.New || DatasetName DBaseFile OdbcDataSource Table KeyField SymbolField TextField SizeField LengthUnit AreaUnit Decimals HorizontalCoordinate VerticalCoordinate Username Passwort || String String String String String String String String String String Integer String String String String || mandatory     mandatory mandatory                     
|-
| Database.Dataset.Remove || Dataset || String Integer || ''all'' for all databases 3, 2, 1, ... for only one or several 
|-
| Database.Assign.Symbols || Dataset CntFile || String or Integer String || ''all'' for all databases, dataset name or 1, 2, 3... for only one database Condition table file
|-
| Database.Assign.Texts || Dataset TextField Condition Symbol ReplaceExistingObjects || String or Integer String String String Boolean || ''all'' for all databases, dataset name or 1, 2, 3... for only one database     e.g. 101.0, -1 for using existing symbol true, false (Default)
|-
| Database.SetObjectDirection || Dataset AngleField MathematicalFunction || String or Integer String String || ''all'' for all databases, dataset name or 1, 2, 3... for only one database   eg.: *180/3.14159
|-
| Database.CreateObjects || Dataset SelectSymbol Condition HorizontalCoordinate VerticalCoordinate Unit TextField HorizontalOffset VerticalOffset || Integer Double String String String Enum types String Double Double || 1, 2, 3, ... Number of dataset Symbol numer. ex. 207.0 SQL String (ex. SYMBOL LIKE 207.0) Database fieldname Database fieldname m, km Database fieldname    
|}

===Background Map===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:26em" | Values / Description
|-
| BackgroundMap.Open || FileName Visible VisibleInFavorites Dimm Transparent SpotColor Blockout Infrared|| String Boolean Boolean Integer Boolean String Boolean Integer ||   true, false; Default = true true, false; Default = true [0..100]; Default = 0 [only works if Blockout is false] true, false; Default = false [only works if Blockout is false] spot color name true, false; Default = false 0=undefined, 1=32bit-infrared, 2=32bit RGB
|-
| BackgroundMap.Visible||  || String|| filename only for already loaded background maps
|-
| BackgroundMap.Hide||  || String|| filename only for already loaded background maps
|-
| BackgroundMap.Remove||  || String|| ''all'' or filename
|-
| BackgroundMap.Reload a)||  || String|| ''all'' or filename
|}
a): Limited functionality. Not avaiable for all users.

===DEM [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]===
Read more about importing Lidar and DTM data on the page [[XML Script Lidar and DTM Import]].

===WMTS Export [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]===
Read more about exporting map tiles for [https://leafletjs.com/ Leaflet] on the page [[XML Script WMTS Export]].

=== Example ===
<PRE>
<?xml version="1.0" encoding="ISO-8859-1"?>


<OcadScript>

<File.New>

<File>C:\Export\Chlosterwald.ocd</File>
</File.New>

<File.MultipleFileImport>

<Directory>C:\Export\Files</Directory>
<CoordinateSystem>1000</CoordinateSystem>
<NewOffset>true</NewOffset>
<Horizontally>600000</Horizontally>
<Vertically>200000</Vertically>
<Angle>0</Angle>
<MapScale>10000</MapScale>
<GridDistance>500</GridDistance>
<LayerField>OBJECTVAL</LayerField>
</File.MultipleFileImport>

<Database.Assign.Texts>
<Dataset>all</Dataset>
<Condition/>
<TextField>TEXT</TextField>
<Symbol>902.000</Symbol>
<ReplaceExistingObjects>false</ReplaceExistingObjects>
</Database.Assign.Texts>

<Database.Assign.Angles>
<Dataset>all</Dataset>
<AngleField>ANGLE</AngleField>
</Database.Assign.Angles>

<Database.Assign.Symbols>
<Dataset>all</Dataset>
<CntFile>C:\Export\Chlosterwald.cnt</CntFile>
</Database.Assign.Symbols>

<Database.Dataset.Remove>
<Dataset>all</Dataset>
</Database.Dataset.Remove>

<Map.OptimizeRepair>
<Enabled>true</Enabled>
</Map.OptimizeRepair>

<View.EntireMap>
<Enabled>true</Enabled>
</View.EntireMap>

<File.Save>
<Enabled>false</Enabled>
</File.Save>

<File.SaveAs>
<File>C:\Export\Chlosterwald_Example.ocd</File>
</File.SaveAs>

<File.Close>
<Enabled>true</Enabled>
</File.Close>

<File.Exit>
<Enabled>false</Enabled>
</File.Exit>

</OcadScript>
</PRE>

==XML Script Thematic Maps [[File:Space.PNG]][[File:Mas40px.png|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]]==
{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:21em" | Values / Description
|-
| File.CreateThematicMap
|| <MapTheme> Name StatDataPath StatDataTable StatDataCommonField VisualizeAttributes AttributesValuesType Classify RepresentationFeature GeometryDataPath GeometryDataCommonField JoinType VisualizationMethod VisualizationType <VisualizationProperties> ScalingMode MaxSize MinSize FillColor StrokeColor StrokeMaxWidth StrokeMinWidth DecreaseStroke ShowZeroValue ShowNoData Opacity ThemeLegendTitle </VisualizationProperties> </MapTheme> <MapTitleStyle> Color Opacity Font Size isBold isItalic Alignment </MapTitleStyle> <LegendTitleStyle> see MapTitleStyle... </LegendTitleStyle> <LegendTextStyle> see MapTitleStyle... </LegendTextStyle> AddScaleBar AddScaleText AdditionalInformationText

|| string string string string string ValueType ClassifyType RepresentationFeatureType string string JoinType VisualizationMethodType VisualizationTypeType ScalingModeType double double FillColor StrokeColor double double boolean boolean boolean integer string ColorType integer string double boolean boolean AlignmentType ... ... boolean boolean string

|| Theme name statistic data file path Sheet or table for Excel or Access files Common Id field Attribute(s) to visualize: Ex. 2004 or 2009|2011 absolute, relative yes, no point, line, area Geometry data file path Common Id field see Thematic Map Data Types table see Thematic Map Data Types table see Thematic Map Data Types table see Thematic Map Data Types table max. size in mm min. size in mm fill color: ex. C=84 M=0 Y=128 K=0 stroke color: ex. C=0 M=0 Y=0 K=255 max. stroke width in mm min. stroke width in mm true, false true, false true, false % ThemeLegendTitle font color: ex. C=0 M=0 Y=0 K=255 opacity in % font name font size true, false true, false 0=align bottom left ... ... true, false true, false Ex. Coordinate system: Pseudo-Mercator
|}

===Thematic Map Data Types===
{| class="wikitable" style=" border="1"
|-
! style="width:14em" | Data type
! style="width:28em" | Values
|-
| ValueType || absolute, relative
|-
| ClassifyType || yes, no
|-
| RepresentationFeatureType || point, line, area
|-
| JoinType || 0=KeepAllRecords, 1=KeepOnlyMatchingRecords
|-
| VisualizationMethodType || mProportionalSymbols, vmProportionalLines, vmProportionalArrows, vmGraduatedSymbols, vmGraduatedLines, vmGraduatedArrows, vmChoropleths, vmCharts
|-
| VisualizationTypeType || vtProportionalBar, vtProportionalCircle, vtProportionalSquare, vtProportionalLine, vtProportionalArrow, vtGraduatedBar, vtGraduatedCircle, vtGraduatedSquare, vtGraduatedLine, vtGraduatedArrow, vtChoropleth, vtPieChart, vtWingChart, vtBarChart, vtDividedPieChart, vtDividedWingChart, vtDividedBarChart, vtStackedBarChart, vtPercentageStackedBarChart
|-
| ScalingModeType || 0=scaling by representation ratio, 1=scaling by max. size
|-
| DataClassificationMethodType|| cmManual, cmNaturalBreaks, cmEqualIntervals, cmQuantiles
|-
| ColorType || CMYK color definition [0..255]: C=84 M=0 Y=128 K=0
|}

=== Thematic Map Script Examples ===
The following example creates a '''thematic map''' with proportional squares about the population in europe 2011.
<PRE>
<?xml version="1.0" encoding="UTF-8"?>
<OcadScript>
<OcadVersion>OCAD 2018 - Mapping Solution 32-bit</OcadVersion>

<File.New>
<File>Thematic Map.ocd</File>
<MapScale>25000000</MapScale>
</File.New>

<File.SaveAs>
<File>Thematic Map Population Europe ProportionalSquare.ocd</File>
</File.SaveAs>

<File.CreateThematicMap>
<MapTheme>
<Name>Population 2011</Name>
<StatDataPath>C:\import\population.xls</StatDataPath>
<StatDataTable>Sheet0$</StatDataTable>
<StatDataCommonField>id</StatDataCommonField>
<VisualizeAttributes>2011</VisualizeAttributes>
<AttributesValuesType>absolute</AttributesValuesType>
<Classify>no</Classify>
<RepresentationFeature>point</RepresentationFeature>
<GeometryDataPath>C:\import\europe.shp</GeometryDataPath>
<GeometryDataCommonField>ne_10m_adm</GeometryDataCommonField>
<JoinType>0</JoinType>
<VisualizationMethod>vmProportionalSymbols</VisualizationMethod>
<VisualizationType>vtProportionalSquare</VisualizationType>
<VisualizationProperties>
<ScalingMode>1</ScalingMode>
<MaxSize>30.00</MaxSize>
<MinSize>1.00</MinSize>
<FillColor>C=84 M=0 Y=128 K=0</FillColor>
<StrokeColor>C=0 M=0 Y=0 K=181</StrokeColor>
<StrokeMaxWidth>0.40</StrokeMaxWidth>
<StrokeMinWidth>0.08</StrokeMinWidth>
<DecreaseStroke>true</DecreaseStroke>
<ShowZeroValue>true</ShowZeroValue>
<ShowNoData>true</ShowNoData>
<Opacity>80</Opacity>
<ThemeLegendTitle>Population</ThemeLegendTitle>
</VisualizationProperties>
</MapTheme>
<MapTitle>Population in Europe 2011</MapTitle>
<DefaultTextStyle>
<Color>C=0 M=0 Y=0 K=150</Color>
<Opacity>100</Opacity>
Arial
<Size>9.0</Size>
<isBold>0</isBold>
<isItalic>0</isItalic>
<Alignment>0</Alignment>
</DefaultTextStyle>
<MapTitleStyle>
<Opacity>80</Opacity>
<Size>24.00</Size>
<Alignment>1</Alignment>
</MapTitleStyle>
<AddThemeLegend>true</AddThemeLegend>
<AddBasemapLegend>true</AddBasemapLegend>
<LegendTitleStyle>
<Size>12.0</Size>
</LegendTitleStyle>
<LegendTextStyle>
<Size>9.0</Size>
</LegendTextStyle>
<AddScaleBar>true</AddScaleBar>
<AddScaleText>true</AddScaleText>
<AdditionalInformationText>OCAD ThematicMapper sample map</AdditionalInformationText>
</File.CreateThematicMap>

<File.Save>
<Enabled>true</Enabled>
</File.Save>
</OcadScript>
</PRE>

==XML Script Partial Map==
{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:50em" | Values / Description
|-
| Export || File coordSystem L, R, B, T|| String Enum types Float|| eg.: ‚ c:\export\PartialMap1.ocd ‘ OCAD creates files PartialMap1_#verticalPages_#horizontalPages.ocd mm (paper, m (real world) left, right, bottom, top
|-
| Export.loop || Enabled HorizontalPages VerticalPages HorizontalOverlap VerticalOverlap || Bool Integer Integer Float Float || true, false number of pages in horizontal direction number of pages in vertical direction horizontal overlap in [mm] or [m] vertical overlap in [mm] or [m]
|}

=== Example ===
The following example exports parts of an ocad map. 
<PRE>
<ocadScript> // comment
<partialMapScript>
<export id="0"> // first export section
<file>c:\export\PartialMap1.ocd</file> // export file
<coordSystem>mm</coordSystem> // paper oder real world coordinates
<T>100</T> // export rectangle with Top Left point and Bottom Right point
<L>0</L>
50
<R>50</R>
<loop> // the loop export several ocd files. For this example 21 files.
<enabled>true</enabled>
<horizontalPages>7</horizontalPages>
<verticalPages>3</verticalPages>
<horizontalOverlap>10</horizontalOverlap> // horizontal and vertical overlap.
<verticalOverlap>10</verticalOverlap>
</loop>
</export>

<export id="1"> // second export section
<file>c:\export\PartialMap2.ocd</file>
<coordSystem>mm</coordSystem>
<L>0</L>
<R>50</R>
50
<T>100</T>
<loop> // export only one ocd file
<enabled>false</enabled>
</loop>
</export> 
</partialMapScript>
</ocadScript>
</PRE>

==XML Script Print==

Print parameters can be saved in a XML script.

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Print.Printer || Name DmPaperSize DmDefaultSource DmPrintQuality DmColor DmMediaType || String Integer Integer Integer Integer Integer || Eg. ,HP Color LaserJet 2840 PCL' File->Print->Save XML Script->Open the Script and depending on which printer was choosen, the informations are there.
|-
| File.Print.Portrait || Enabled || Bool || true, false
|-
| File.Print.SpotColor || Enabled Colors|| Bool String|| true, false Name of the spot color(s)
|-
| File.Print.PartOfMap || Range Coordinates L, R, B, T || Integer Enum types Float || 1 mm (page), m (real world) Left, Right, Bottom, Top
|-
| File.Print.HorizontalOverlap ||   || Float ||
|-
| File.Print.VerticalOverlap ||   || Float ||
|-
| File.Print.PrintScale ||   || Integer || Eg. 25000
|-
| File.Print.Copies ||   || Integer || Number of copies
|-
| File.Print.Intensity ||   || Integer ||  
|-
| File.Print.LineWidth ||   || Integer ||  
|-
| File.Print.PrintScreenGrid || Enabled PrintScreenGridColor || Bool Integer || true, false Ocad color number
|}

==XML Script Export==

Watch out for the file endings. Resolution is only used if File.Export.GeoRef -> Enabled = false

===AI (Adobe Illustrator), PDF===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:20em" | Values / Description
|-
| File.Export || File Format Resolution ExportScale|| String Enum types Integer Integer|| eg.: ,c::\Export\Chlosterwald.ai‘ AI, PDF in dpi [40..2540] (only if the map has raster background maps) eg. '10000' for the scale 1:10'000
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|-
| File.Export || Colors || Enum types || normal, spotColors
|-
| File.Export.SpotColors || Combine Enabled|| Bool String|| true, false [only if Colors = spotColors] Spotcolor name [only if Colors = spotColors]
|}

===BMP, GIF, JPEG, PNG===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format Quality Resolution Anti-Aliasing ColorCorrection|| String Enum types Integer Integer Boolean Boolean|| eg.: ‚c:\Export\Chlosterwald.bmp‘ BMP, GIF, JPEG, PNG only for JPEG, [0..100] in dpi [40..2540] true, false true, false
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top for rotated maps use here the coordinate of the upper left und lower right corner
|-
| File.Export.Tiles || Enabled Width Height || Boolean Integer Integer || true, false [only if Enabled = true] [only if Enabled = true]
|-
|File.Export.GeoRef|| Enabled PixelSize CreateWorldFile || Bool Float Bool || true, false in meter [only if Enabled = true] true, false [only if Enabled = true]
|}

===EPS===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format ExportScale|| String Enum types Integer|| eg.: ‚c:\Export\Chlosterwald.eps ‘ EPS e.g. '10000' for the scale 1:10'000
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|-
| File.Export || Colors || Enum types || normal, spotColors
|-
| File.Export.SpotColors || Enabled || Spotcolor name || [only if Colors = spotColors]
|}

===SVG (Scalable Vector Graphics)===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format ExportScale CompressFile|| String Enum types Integer Boolean|| eg.: ‚c:\Export\Chlosterwald.svg ‘ SVG e.g. '10000' for the scale 1:10'000 true, false
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|}

===TIFF===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:20em" | Values / Description
|-
|File.Export || File Format Resolution Anti-Aliasing ColorCorrection|| String Enum types Integer Boolean Boolean|| eg.: ‚c:\Export\Chlosterwald.tif‘ TIFF in dpi [40..2540] true, false true, false
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|-
|File.Export.Tiles || Enabled Width Height || Bool Integer Integer || true, false [only if Enabled = true] [only if Enabled = true]
|-
|File.Export.GeoRef|| Enabled PixelSize CreateWorldFile || Bool Float Bool ||true, false in meter [only if Enabled = true] true, false [only if Enabled = true]
|-
| File.Export || Colors || Enum types || normal, spotColors
|-
| File.Export.SpotColors || Combine Enabled || Bool Spotcolor name || true, false [only if Colors = spotColors] [only if Colors = spotColors]
|-
|File.Export || ColorMode || Integer || 0 = 32 bit CMYK 1 = 24 bit RGB 2 = 256 colors 3 = grayscale 4 = 8 bit CMYK 5 = 1 bit black/white 6 = halftone screen [only if spotColor = true]
|-
|File.Export || Compression || Integer || 1 = no compression 2 = CCITT [only used with ColorMode 5/6] 4 = FaxG4 [only used with ColorMode 5/6] 5 = LZW
|}

===DXF===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format ExportScale ConvertAnsiToOem ConvertOemToUnicode ObjectsSelectedSymbols AddSymbolDescription UseCrtFileName ExportAsSplines Coordinates || String Enum types Integer Boolean Boolean Boolean Boolean String Boolean Enum types|| eg.: ‚c:\Export\Chlosterwald.dxf ‘ DXF e.g. '10000' for the scale 1:10'000 true, false true, false true, false true, false eg.: ‚c:\CRT\Chlosterwald.ocdCrt‘ true, false m, mm
|}

===Shape===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:25em" | Values / Description
|-
| File.Export
|| ExportPath File Format PointObjects LineObjects AreaObjects TextObjects EnvelopePolygonFromTextObjects Dataset WordWrap ProjectionFile Utf8Encoding
|| String String Enum types Boolean Boolean Boolean Boolean Boolean String Boolean Boolean Boolean
|| eg.: ‚c:\Export‘ (only path name) eg.: ‚c:\Export\test.shp‘ (using ExportPath OR File, not both) SHAPE true, false true, false true, false true, false true, false 'all' for all databases or dataset name true, false true, false true, false
|}

===Example===

The following example exports two pdf files in spot colors and two Shape files. Each OcadScript node can contain many
children.

<?xml version="1.0" encoding="ISO-8859-1"?>
<OcadScript> 
<File.Open>
<File>M:\OCAD2018\Changes\11-06xx\11-0663\Chlosterwald.ocd</File>
</File.Open> 
<File.Export> //PDF export
<File>M:\OCAD2018\Changes\11-06xx\11-0663\output\Chlosterwald.pdf</File>
<Format>PDF</Format>
<PartOfMap>
<Enabled>true</Enabled>
<Coordinates>mm</Coordinates>
<L>0</L>
<R>50</R>
50
<T>100</T>
</PartOfMap>
<ExportScale>10000</ExportScale>
<Colors>spotColors</Colors>
<SpotColors>
<Combine>false</Combine>
<Enabled>Blau</Enabled>
<Enabled>Gelb</Enabled>
</SpotColors>
</File.Export>

<File.Export> //Shape export
<ExportPath>M:\OCAD2018\Changes\11-06xx\11-0663\output\</ExportPath>
<Format>SHAPE</Format>
<PointObjects>false</PointObjects>
<LineObjects>true</LineObjects>
<AreaObjects>true</AreaObjects>
<TextObjects>false</TextObjects>
<EnvelopePolygonFromTextObjects>false</EnvelopePolygonFromTextObjects>
<Dataset>all</Dataset>
<WordWrap>true</WordWrap>
<ProjectionFile>false</ProjectionFile>
</File.Export> 
<File.Save>
<Enabled>true</Enabled>
</File.Save> 
<File.Close>
<Enabled>true</Enabled>
</File.Close>
</OcadScript>

==Run XML Script from the Command Line==

It is possible to execute a XML script file from the command line or from batch file.

Open the Windows command and enter the OCAD program name and the xml script file.
For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" "C:\Data\ExportScriptExample_PDF.xml"

Use the parameter ''/NewInstance'' to always create new OCAD instance.
For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" /NewInstance "C:\Data\ExportScriptExample_PDF.xml"

Do not forget to use the parameter <File.Open> to open the file, <File.Close> to close it and <File.Exit> to close OCAD.

==Open ocd File from the Command Line==
It is possible to open an ocd file from the command line with optional view parameters.

Open the Windows command and enter the OCAD program name and the ocd file name.

For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" "M:\Data\Map.ocd"

Additional OCAD supports the following optional view parameters to open an map at desired postion and view scale.

-c: center for view
-s: view scale

For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" -c 710000,231000 -s 2500 "M:\Data\Map.ocd"

----
Back to [[Main Page]]

XML Script

2023-04-12T07:45:33Z

GRS: /* Example */

[[File:Mas40px.png|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]] ([[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]])

Choose this command to execute functions whose settings are defined in a XML file.

Note: Most parameters can only be used in the Mapping Solution Edition. In the Orienteering Edition, XML Script can be used for Lidar Import, DTM Import and WMTS Export.

==Introduction==

Select '''Execute XML Script''' from '''File''' menu or drag-and-drop then xml file to the OCAD window.

OCAD creates a log file in the temporary folder (''C:\Users\USERNAME\AppData\Roaming\OCAD\OCAD 20xx\Tmp'').

==XML Script General==

===File===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:40em" | Values / Description
|-
| File.New || File MapScale <del>Easting </del> <del>Northing</del> <del>Angle</del> || String Integer <del>Integer</del> <del>Integer</del> <del>Double</del> || file name of existing symbol set 10000 obsolete, use Map.ScaleAndCoordinateSystem obsolete, use Map.ScaleAndCoordinateSystem obsolete, use Map.ScaleAndCoordinateSystem
|-
| File.Open || File IgnoreMissingBackgroundMaps IgnoreMissingDatasets|| String Boolean Boolean|| ocd file name true, false (default: false) true, false (default: false)
|-
| File.Close|| Enabled || Boolean || true, false
|-
| File.Save || Enabled || Boolean || true, false
|-
| File.SaveAs || File || String || ocd file name
|-
| File.Import.Ocd || File Directory SymbolOption ColorOption || String String Integer Integer || File name [0..3] [0, 1]
|-
| File.Import.Dxf || Directory NewOffset HorizontalOffset VerticalOffset Angle MapScale || String Boolean Integer Integer Double Integer || Directory name ignored if NewOffset = false ignored if NewOffset = false ignored if NewOffset = false ignored if NewOffset = false
|-
| File.Import.GeoPackage || GpkgFilename TableName Layer CrtFilename || String String String String || 
|-
| File.MultipleFileImport
|| Directory SearchPattern CoordinateSystem NewOffset Horizontally Vertically Angle MapScale GridDistance DatabaseType Codepage KeyField LayerField LayerField2 ExtentMinimumEasting ExtentMaximumEasting ExtentMinimumNorthing ExtentMaximumNorthing
|| String String Integer Boolean Integer Integer Double Integer Double Integer Integer String String String Double Double Double Double
|| Directory of import files, e.g. ''C:\Shape\'' optional, e.g. SV*.shp [[Create_a_New_Map#Coordinate_System|Internal Grid ID]] |1000 = existing grid of OCAD file, -1 = WGS 84, 0 = dBase, 1 = Access 2007, 2 = Access 2003/2010, 3 = Do not create a database 0 = Default, Codepage number ' ' = Create new key field, field name ' ' = do not import layer information, field name ' ' = do not import 2nd layer information, field name, LayerField and LayerField2 content are concatenated by '_' 
|-
| File.Exit || Enabled || Boolean || true, false
|}

===View===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| View.Mode || || Enum types || normalMode, spotColorMode, draftMode
|-
| View.EntireMap || Enabled|| Boolean || true, false
|-
| View.MoveTo || X Y || Double Double ||  
|-
| View.Zoom ||   || Double ||  
|}

===Select===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Select.ObjectsBySymbol || SymbolNumber || Double || e.g. 526.002
|-
| Select.ObjectsBySymbol ||  ||  || use <Select.ObjectsBySymbol></Select.ObjectsBySymbol> to clear the selection
|}

===Object===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Object.ChangeVertexTypesTo || Type || Enum types || CornerVertex, DashVertex
|-
| Object.Fill || SymbolNumber || Double ||  
|-
| Object.ChangeSymbol || FromSymbolNumber FromImportedLayer ToSymbolNumber || Double String Double ||  
|-
| Object.ChangeSymbolSelectedObjects || SymbolNumber || Double || e.g. 101.001
|-
| Object.MergeObjectsBySymbol|| SymbolNumber || Double || e.g. 101.001
|}

===Symbol===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Symbol.SymbolStatusManager|| FileName SymbolStatusName|| String String || xml file name name of symbol status
|-
| Symbol.ChangeStatus|| SymbolNumber|| double|| e.g. 101.000 attribute status="visible", "protected" or "hidden"
|-
|}

===Map===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Map.OptimizeRepair|| Enabled|| Boolean || true, false
|-
| Map.ChangeScale || NewScale EnlargeReduceSymbols EnlargeReduceLineWidthOfImageAndGraphicObjects || Integer Boolean Boolean|| e. g. 10000 true, false true, false
|-
| Map.ConvertLayer|| CrtFile || String || crt file name
|-
| Map.DeleteObjectsBySymbol|| SymbolNumber SymbolTreeGroupName||Double, String String|| e.g. 526.002, ObjectsWithoutSymbol e.g. Streets
|-
| Map.ExportObjectsBySymbol|| File SymbolNumber SymbolTreeGroupName||Double String|| export ocd file name e.g. 526.002 e.g. Streets
|-
| Map.LoadSymbolsFrom || File || String || ocd file name (with symbols to be loaded) The option ''replace existing colors and symbols'' is used
|-
| Map.LoadSymbolTreeFrom|| FileName || String|| ocd file name
|-
| Map.ScaleAndCoordinateSystem || MapScale Easting Northing Angle CoordinateSystem|| Integer Integer Integer Double Integer|| e.g. 10000 e.g. 600000 e.g. 200000 e.g. 4.5 internal grid id
|-
| Map.Transform.ChangeCoordinateSystem || CoordinateSystem EastingOffset NorthingOffset ScaleSymbols|| Integer Integer Integer Boolean|| internal grid id true, false
|-
|}

===Database===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Database.Dataset.New || DatasetName DBaseFile OdbcDataSource Table KeyField SymbolField TextField SizeField LengthUnit AreaUnit Decimals HorizontalCoordinate VerticalCoordinate Username Passwort || String String String String String String String String String String Integer String String String String || mandatory     mandatory mandatory                     
|-
| Database.Dataset.Remove || Dataset || String Integer || ''all'' for all databases 3, 2, 1, ... for only one or several 
|-
| Database.Assign.Symbols || Dataset CntFile || String or Integer String || ''all'' for all databases, dataset name or 1, 2, 3... for only one database Condition table file
|-
| Database.Assign.Texts || Dataset TextField Condition Symbol ReplaceExistingObjects || String or Integer String String String Boolean || ''all'' for all databases, dataset name or 1, 2, 3... for only one database     e.g. 101.0, -1 for using existing symbol true, false (Default)
|-
| Database.SetObjectDirection || Dataset AngleField MathematicalFunction || String or Integer String String || ''all'' for all databases, dataset name or 1, 2, 3... for only one database   eg.: *180/3.14159
|-
| Database.CreateObjects || Dataset SelectSymbol Condition HorizontalCoordinate VerticalCoordinate Unit TextField HorizontalOffset VerticalOffset || Integer Double String String String Enum types String Double Double || 1, 2, 3, ... Number of dataset Symbol numer. ex. 207.0 SQL String (ex. SYMBOL LIKE 207.0) Database fieldname Database fieldname m, km Database fieldname    
|}

===Background Map===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:26em" | Values / Description
|-
| BackgroundMap.Open || FileName Visible VisibleInFavorites Dimm Transparent SpotColor Blockout Infrared|| String Boolean Boolean Integer Boolean String Boolean Integer ||   true, false; Default = true true, false; Default = true [0..100]; Default = 0 [only works if Blockout is false] true, false; Default = false [only works if Blockout is false] spot color name true, false; Default = false 0=undefined, 1=32bit-infrared, 2=32bit RGB
|-
| BackgroundMap.Visible||  || String|| filename only for already loaded background maps
|-
| BackgroundMap.Hide||  || String|| filename only for already loaded background maps
|-
| BackgroundMap.Remove||  || String|| ''all'' or filename
|-
| BackgroundMap.Reload a)||  || String|| ''all'' or filename
|}
a): Limited functionality. Not avaiable for all users.

===DEM [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]===
Read more about importing Lidar and DTM data on the page [[XML Script Lidar and DTM Import]].

===WMTS Export [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]===
Read more about exporting map tiles for [https://leafletjs.com/ Leaflet] on the page [[XML Script WMTS Export]].

=== Example ===
<PRE>
<?xml version="1.0" encoding="ISO-8859-1"?>


<OcadScript>

<File.New>

<File>C:\Export\Chlosterwald.ocd</File>
</File.New>

<File.MultipleFileImport>

<Directory>C:\Export\Files</Directory>
<CoordinateSystem>1000</CoordinateSystem>
<NewOffset>true</NewOffset>
<Horizontally>600000</Horizontally>
<Vertically>200000</Vertically>
<Angle>0</Angle>
<MapScale>10000</MapScale>
<GridDistance>500</GridDistance>
<LayerField>OBJECTVAL</LayerField>
</File.MultipleFileImport>

<Database.Assign.Texts>
<Dataset>all</Dataset>
<Condition/>
<TextField>TEXT</TextField>
<Symbol>902.000</Symbol>
<ReplaceExistingObjects>false</ReplaceExistingObjects>
</Database.Assign.Texts>

<Database.Assign.Angles>
<Dataset>all</Dataset>
<AngleField>ANGLE</AngleField>
</Database.Assign.Angles>

<Database.Assign.Symbols>
<Dataset>all</Dataset>
<CntFile>C:\Export\Chlosterwald.cnt</CntFile>
</Database.Assign.Symbols>

<Database.Dataset.Remove>
<Dataset>all</Dataset>
</Database.Dataset.Remove>

<Map.OptimizeRepair>
<Enabled>true</Enabled>
</Map.OptimizeRepair>

<View.EntireMap>
<Enabled>true</Enabled>
</View.EntireMap>

<File.Save>
<Enabled>false</Enabled>
</File.Save>

<File.SaveAs>
<File>C:\Export\Chlosterwald_Example.ocd</File>
</File.SaveAs>

<File.Close>
<Enabled>true</Enabled>
</File.Close>

<File.Exit>
<Enabled>false</Enabled>
</File.Exit>

</OcadScript>
</PRE>

==XML Script Thematic Maps [[File:Space.PNG]][[File:Mas40px.png|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]]==
{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:21em" | Values / Description
|-
| File.CreateThematicMap
|| <MapTheme> Name StatDataPath StatDataTable StatDataCommonField VisualizeAttributes AttributesValuesType Classify RepresentationFeature GeometryDataPath GeometryDataCommonField JoinType VisualizationMethod VisualizationType <VisualizationProperties> ScalingMode MaxSize MinSize FillColor StrokeColor StrokeMaxWidth StrokeMinWidth DecreaseStroke ShowZeroValue ShowNoData Opacity ThemeLegendTitle </VisualizationProperties> </MapTheme> <MapTitleStyle> Color Opacity Font Size isBold isItalic Alignment </MapTitleStyle> <LegendTitleStyle> see MapTitleStyle... </LegendTitleStyle> <LegendTextStyle> see MapTitleStyle... </LegendTextStyle> AddScaleBar AddScaleText AdditionalInformationText

|| string string string string string ValueType ClassifyType RepresentationFeatureType string string JoinType VisualizationMethodType VisualizationTypeType ScalingModeType double double FillColor StrokeColor double double boolean boolean boolean integer string ColorType integer string double boolean boolean AlignmentType ... ... boolean boolean string

|| Theme name statistic data file path Sheet or table for Excel or Access files Common Id field Attribute(s) to visualize: Ex. 2004 or 2009|2011 absolute, relative yes, no point, line, area Geometry data file path Common Id field see Thematic Map Data Types table see Thematic Map Data Types table see Thematic Map Data Types table see Thematic Map Data Types table max. size in mm min. size in mm fill color: ex. C=84 M=0 Y=128 K=0 stroke color: ex. C=0 M=0 Y=0 K=255 max. stroke width in mm min. stroke width in mm true, false true, false true, false % ThemeLegendTitle font color: ex. C=0 M=0 Y=0 K=255 opacity in % font name font size true, false true, false 0=align bottom left ... ... true, false true, false Ex. Coordinate system: Pseudo-Mercator
|}

===Thematic Map Data Types===
{| class="wikitable" style=" border="1"
|-
! style="width:14em" | Data type
! style="width:28em" | Values
|-
| ValueType || absolute, relative
|-
| ClassifyType || yes, no
|-
| RepresentationFeatureType || point, line, area
|-
| JoinType || 0=KeepAllRecords, 1=KeepOnlyMatchingRecords
|-
| VisualizationMethodType || mProportionalSymbols, vmProportionalLines, vmProportionalArrows, vmGraduatedSymbols, vmGraduatedLines, vmGraduatedArrows, vmChoropleths, vmCharts
|-
| VisualizationTypeType || vtProportionalBar, vtProportionalCircle, vtProportionalSquare, vtProportionalLine, vtProportionalArrow, vtGraduatedBar, vtGraduatedCircle, vtGraduatedSquare, vtGraduatedLine, vtGraduatedArrow, vtChoropleth, vtPieChart, vtWingChart, vtBarChart, vtDividedPieChart, vtDividedWingChart, vtDividedBarChart, vtStackedBarChart, vtPercentageStackedBarChart
|-
| ScalingModeType || 0=scaling by representation ratio, 1=scaling by max. size
|-
| DataClassificationMethodType|| cmManual, cmNaturalBreaks, cmEqualIntervals, cmQuantiles
|-
| ColorType || CMYK color definition [0..255]: C=84 M=0 Y=128 K=0
|}

=== Thematic Map Script Examples ===
The following example creates a '''thematic map''' with proportional squares about the population in europe 2011.
<PRE>
<?xml version="1.0" encoding="UTF-8"?>
<OcadScript>
<OcadVersion>OCAD 2018 - Mapping Solution 32-bit</OcadVersion>

<File.New>
<File>Thematic Map.ocd</File>
<MapScale>25000000</MapScale>
</File.New>

<File.SaveAs>
<File>Thematic Map Population Europe ProportionalSquare.ocd</File>
</File.SaveAs>

<File.CreateThematicMap>
<MapTheme>
<Name>Population 2011</Name>
<StatDataPath>C:\import\population.xls</StatDataPath>
<StatDataTable>Sheet0$</StatDataTable>
<StatDataCommonField>id</StatDataCommonField>
<VisualizeAttributes>2011</VisualizeAttributes>
<AttributesValuesType>absolute</AttributesValuesType>
<Classify>no</Classify>
<RepresentationFeature>point</RepresentationFeature>
<GeometryDataPath>C:\import\europe.shp</GeometryDataPath>
<GeometryDataCommonField>ne_10m_adm</GeometryDataCommonField>
<JoinType>0</JoinType>
<VisualizationMethod>vmProportionalSymbols</VisualizationMethod>
<VisualizationType>vtProportionalSquare</VisualizationType>
<VisualizationProperties>
<ScalingMode>1</ScalingMode>
<MaxSize>30.00</MaxSize>
<MinSize>1.00</MinSize>
<FillColor>C=84 M=0 Y=128 K=0</FillColor>
<StrokeColor>C=0 M=0 Y=0 K=181</StrokeColor>
<StrokeMaxWidth>0.40</StrokeMaxWidth>
<StrokeMinWidth>0.08</StrokeMinWidth>
<DecreaseStroke>true</DecreaseStroke>
<ShowZeroValue>true</ShowZeroValue>
<ShowNoData>true</ShowNoData>
<Opacity>80</Opacity>
<ThemeLegendTitle>Population</ThemeLegendTitle>
</VisualizationProperties>
</MapTheme>
<MapTitle>Population in Europe 2011</MapTitle>
<DefaultTextStyle>
<Color>C=0 M=0 Y=0 K=150</Color>
<Opacity>100</Opacity>
Arial
<Size>9.0</Size>
<isBold>0</isBold>
<isItalic>0</isItalic>
<Alignment>0</Alignment>
</DefaultTextStyle>
<MapTitleStyle>
<Opacity>80</Opacity>
<Size>24.00</Size>
<Alignment>1</Alignment>
</MapTitleStyle>
<AddThemeLegend>true</AddThemeLegend>
<AddBasemapLegend>true</AddBasemapLegend>
<LegendTitleStyle>
<Size>12.0</Size>
</LegendTitleStyle>
<LegendTextStyle>
<Size>9.0</Size>
</LegendTextStyle>
<AddScaleBar>true</AddScaleBar>
<AddScaleText>true</AddScaleText>
<AdditionalInformationText>OCAD ThematicMapper sample map</AdditionalInformationText>
</File.CreateThematicMap>

<File.Save>
<Enabled>true</Enabled>
</File.Save>
</OcadScript>
</PRE>

==XML Script Partial Map==
{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:50em" | Values / Description
|-
| Export || File coordSystem L, R, B, T|| String Enum types Float|| eg.: ‚ c:\export\PartialMap1.ocd ‘ OCAD creates files PartialMap1_#verticalPages_#horizontalPages.ocd mm (paper, m (real world) left, right, bottom, top
|-
| Export.loop || Enabled HorizontalPages VerticalPages HorizontalOverlap VerticalOverlap || Bool Integer Integer Float Float || true, false number of pages in horizontal direction number of pages in vertical direction horizontal overlap in [mm] or [m] vertical overlap in [mm] or [m]
|}

=== Example ===
The following example exports parts of an ocad map. 
<PRE>
<ocadScript> // comment
<partialMapScript>
<export id="0"> // first export section
<file>c:\export\PartialMap1.ocd</file> // export file
<coordSystem>mm</coordSystem> // paper oder real world coordinates
<T>100</T> // export rectangle with Top Left point and Bottom Right point
<L>0</L>
50
<R>50</R>
<loop> // the loop export several ocd files. For this example 21 files.
<enabled>true</enabled>
<horizontalPages>7</horizontalPages>
<verticalPages>3</verticalPages>
<horizontalOverlap>10</horizontalOverlap> // horizontal and vertical overlap.
<verticalOverlap>10</verticalOverlap>
</loop>
</export>

<export id="1"> // second export section
<file>c:\export\PartialMap2.ocd</file>
<coordSystem>mm</coordSystem>
<L>0</L>
<R>50</R>
50
<T>100</T>
<loop> // export only one ocd file
<enabled>false</enabled>
</loop>
</export> 
</partialMapScript>
</ocadScript>
</PRE>

==XML Script Print==

Print parameters can be saved in a XML script.

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Print.Printer || Name DmPaperSize DmDefaultSource DmPrintQuality DmColor DmMediaType || String Integer Integer Integer Integer Integer || Eg. ,HP Color LaserJet 2840 PCL' File->Print->Save XML Script->Open the Script and depending on which printer was choosen, the informations are there.
|-
| File.Print.Portrait || Enabled || Bool || true, false
|-
| File.Print.SpotColor || Enabled Colors|| Bool String|| true, false Name of the spot color(s)
|-
| File.Print.PartOfMap || Range Coordinates L, R, B, T || Integer Enum types Float || 1 mm (page), m (real world) Left, Right, Bottom, Top
|-
| File.Print.HorizontalOverlap ||   || Float ||
|-
| File.Print.VerticalOverlap ||   || Float ||
|-
| File.Print.PrintScale ||   || Integer || Eg. 25000
|-
| File.Print.Copies ||   || Integer || Number of copies
|-
| File.Print.Intensity ||   || Integer ||  
|-
| File.Print.LineWidth ||   || Integer ||  
|-
| File.Print.PrintScreenGrid || Enabled PrintScreenGridColor || Bool Integer || true, false Ocad color number
|}

==XML Script Export==

Watch out for the file endings. Resolution is only used if File.Export.GeoRef -> Enabled = false

===AI (Adobe Illustrator), PDF===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:20em" | Values / Description
|-
| File.Export || File Format Resolution ExportScale|| String Enum types Integer Integer|| eg.: ,c::\Export\Chlosterwald.ai‘ AI, PDF in dpi [40..2540] (only if the map has raster background maps) eg. '10000' for the scale 1:10'000
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|-
| File.Export || Colors || Enum types || normal, spotColors
|-
| File.Export.SpotColors || Combine Enabled|| Bool String|| true, false [only if Colors = spotColors] Spotcolor name [only if Colors = spotColors]
|}

===BMP, GIF, JPEG, PNG===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format Quality Resolution Anti-Aliasing ColorCorrection|| String Enum types Integer Integer Boolean Boolean|| eg.: ‚c:\Export\Chlosterwald.bmp‘ BMP, GIF, JPEG, PNG only for JPEG, [0..100] in dpi [40..2540] true, false true, false
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top for rotated maps use here the coordinate of the upper left und lower right corner
|-
| File.Export.Tiles || Enabled Width Height || Boolean Integer Integer || true, false [only if Enabled = true] [only if Enabled = true]
|-
|File.Export.GeoRef|| Enabled PixelSize CreateWorldFile || Bool Float Bool || true, false in meter [only if Enabled = true] true, false [only if Enabled = true]
|}

===EPS===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format ExportScale|| String Enum types Integer|| eg.: ‚c:\Export\Chlosterwald.eps ‘ EPS e.g. '10000' for the scale 1:10'000
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|-
| File.Export || Colors || Enum types || normal, spotColors
|-
| File.Export.SpotColors || Enabled || Spotcolor name || [only if Colors = spotColors]
|}

===SVG (Scalable Vector Graphics)===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format ExportScale CompressFile|| String Enum types Integer Boolean|| eg.: ‚c:\Export\Chlosterwald.svg ‘ SVG e.g. '10000' for the scale 1:10'000 true, false
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|}

===TIFF===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:20em" | Values / Description
|-
|File.Export || File Format Resolution Anti-Aliasing ColorCorrection|| String Enum types Integer Boolean Boolean|| eg.: ‚c:\Export\Chlosterwald.tif‘ TIFF in dpi [40..2540] true, false true, false
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|-
|File.Export.Tiles || Enabled Width Height || Bool Integer Integer || true, false [only if Enabled = true] [only if Enabled = true]
|-
|File.Export.GeoRef|| Enabled PixelSize CreateWorldFile || Bool Float Bool ||true, false in meter [only if Enabled = true] true, false [only if Enabled = true]
|-
| File.Export || Colors || Enum types || normal, spotColors
|-
| File.Export.SpotColors || Combine Enabled || Bool Spotcolor name || true, false [only if Colors = spotColors] [only if Colors = spotColors]
|-
|File.Export || ColorMode || Integer || 0 = 32 bit CMYK 1 = 24 bit RGB 2 = 256 colors 3 = grayscale 4 = 8 bit CMYK 5 = 1 bit black/white 6 = halftone screen [only if spotColor = true]
|-
|File.Export || Compression || Integer || 1 = no compression 2 = CCITT [only used with ColorMode 5/6] 4 = FaxG4 [only used with ColorMode 5/6] 5 = LZW
|}

===DXF===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format ExportScale ConvertAnsiToOem ConvertOemToUnicode ObjectsSelectedSymbols AddSymbolDescription UseCrtFileName ExportAsSplines Coordinates || String Enum types Integer Boolean Boolean Boolean Boolean String Boolean Enum types|| eg.: ‚c:\Export\Chlosterwald.dxf ‘ DXF e.g. '10000' for the scale 1:10'000 true, false true, false true, false true, false eg.: ‚c:\CRT\Chlosterwald.ocdCrt‘ true, false m, mm
|}

===Shape===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:25em" | Values / Description
|-
| File.Export
|| ExportPath File Format PointObjects LineObjects AreaObjects TextObjects EnvelopePolygonFromTextObjects Dataset WordWrap ProjectionFile Utf8Encoding
|| String String Enum types Boolean Boolean Boolean Boolean Boolean String Integer Boolean Boolean Boolean
|| eg.: ‚c:\Export‘ (only path name) eg.: ‚c:\Export\test.shp‘ (using ExportPath OR File, not both) SHAPE true, false true, false true, false true, false true, false all for all databases 1, 2, 3, ... for only one database true, false true, false true, false
|}

===Example===

The following example exports two pdf files in spot colors and two Shape files. Each OcadScript node can contain many
children.

<?xml version="1.0" encoding="ISO-8859-1"?>
<OcadScript> 
<File.Open>
<File>M:\OCAD2018\Changes\11-06xx\11-0663\Chlosterwald.ocd</File>
</File.Open> 
<File.Export> //PDF export
<File>M:\OCAD2018\Changes\11-06xx\11-0663\output\Chlosterwald.pdf</File>
<Format>PDF</Format>
<PartOfMap>
<Enabled>true</Enabled>
<Coordinates>mm</Coordinates>
<L>0</L>
<R>50</R>
50
<T>100</T>
</PartOfMap>
<ExportScale>10000</ExportScale>
<Colors>spotColors</Colors>
<SpotColors>
<Combine>false</Combine>
<Enabled>Blau</Enabled>
<Enabled>Gelb</Enabled>
</SpotColors>
</File.Export>

<File.Export> //Shape export
<ExportPath>M:\OCAD2018\Changes\11-06xx\11-0663\output\</ExportPath>
<Format>SHAPE</Format>
<PointObjects>false</PointObjects>
<LineObjects>true</LineObjects>
<AreaObjects>true</AreaObjects>
<TextObjects>false</TextObjects>
<EnvelopePolygonFromTextObjects>false</EnvelopePolygonFromTextObjects>
<Dataset>all</Dataset>
<WordWrap>true</WordWrap>
<ProjectionFile>false</ProjectionFile>
</File.Export> 
<File.Save>
<Enabled>true</Enabled>
</File.Save> 
<File.Close>
<Enabled>true</Enabled>
</File.Close>
</OcadScript>

==Run XML Script from the Command Line==

It is possible to execute a XML script file from the command line or from batch file.

Open the Windows command and enter the OCAD program name and the xml script file.
For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" "C:\Data\ExportScriptExample_PDF.xml"

Use the parameter ''/NewInstance'' to always create new OCAD instance.
For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" /NewInstance "C:\Data\ExportScriptExample_PDF.xml"

Do not forget to use the parameter <File.Open> to open the file, <File.Close> to close it and <File.Exit> to close OCAD.

==Open ocd File from the Command Line==
It is possible to open an ocd file from the command line with optional view parameters.

Open the Windows command and enter the OCAD program name and the ocd file name.

For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" "M:\Data\Map.ocd"

Additional OCAD supports the following optional view parameters to open an map at desired postion and view scale.

-c: center for view
-s: view scale

For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" -c 710000,231000 -s 2500 "M:\Data\Map.ocd"

----
Back to [[Main Page]]

XML Script

2023-04-04T08:39:27Z

GRS: /* Symbol */

[[File:Mas40px.png|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]] ([[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]])

Choose this command to execute functions whose settings are defined in a XML file.

Note: Most parameters can only be used in the Mapping Solution Edition. In the Orienteering Edition, XML Script can be used for Lidar Import, DTM Import and WMTS Export.

==Introduction==

Select '''Execute XML Script''' from '''File''' menu or drag-and-drop then xml file to the OCAD window.

OCAD creates a log file in the temporary folder (''C:\Users\USERNAME\AppData\Roaming\OCAD\OCAD 20xx\Tmp'').

==XML Script General==

===File===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:40em" | Values / Description
|-
| File.New || File MapScale <del>Easting </del> <del>Northing</del> <del>Angle</del> || String Integer <del>Integer</del> <del>Integer</del> <del>Double</del> || file name of existing symbol set 10000 obsolete, use Map.ScaleAndCoordinateSystem obsolete, use Map.ScaleAndCoordinateSystem obsolete, use Map.ScaleAndCoordinateSystem
|-
| File.Open || File IgnoreMissingBackgroundMaps IgnoreMissingDatasets|| String Boolean Boolean|| ocd file name true, false (default: false) true, false (default: false)
|-
| File.Close|| Enabled || Boolean || true, false
|-
| File.Save || Enabled || Boolean || true, false
|-
| File.SaveAs || File || String || ocd file name
|-
| File.Import.Ocd || File Directory SymbolOption ColorOption || String String Integer Integer || File name [0..3] [0, 1]
|-
| File.Import.Dxf || Directory NewOffset HorizontalOffset VerticalOffset Angle MapScale || String Boolean Integer Integer Double Integer || Directory name ignored if NewOffset = false ignored if NewOffset = false ignored if NewOffset = false ignored if NewOffset = false
|-
| File.Import.GeoPackage || GpkgFilename TableName Layer CrtFilename || String String String String || 
|-
| File.MultipleFileImport
|| Directory SearchPattern CoordinateSystem NewOffset Horizontally Vertically Angle MapScale GridDistance DatabaseType Codepage KeyField LayerField LayerField2 ExtentMinimumEasting ExtentMaximumEasting ExtentMinimumNorthing ExtentMaximumNorthing
|| String String Integer Boolean Integer Integer Double Integer Double Integer Integer String String String Double Double Double Double
|| Directory of import files, e.g. ''C:\Shape\'' optional, e.g. SV*.shp [[Create_a_New_Map#Coordinate_System|Internal Grid ID]] |1000 = existing grid of OCAD file, -1 = WGS 84, 0 = dBase, 1 = Access 2007, 2 = Access 2003/2010, 3 = Do not create a database 0 = Default, Codepage number ' ' = Create new key field, field name ' ' = do not import layer information, field name ' ' = do not import 2nd layer information, field name, LayerField and LayerField2 content are concatenated by '_' 
|-
| File.Exit || Enabled || Boolean || true, false
|}

===View===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| View.Mode || || Enum types || normalMode, spotColorMode, draftMode
|-
| View.EntireMap || Enabled|| Boolean || true, false
|-
| View.MoveTo || X Y || Double Double ||  
|-
| View.Zoom ||   || Double ||  
|}

===Select===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Select.ObjectsBySymbol || SymbolNumber || Double || e.g. 526.002
|-
| Select.ObjectsBySymbol ||  ||  || use <Select.ObjectsBySymbol></Select.ObjectsBySymbol> to clear the selection
|}

===Object===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Object.ChangeVertexTypesTo || Type || Enum types || CornerVertex, DashVertex
|-
| Object.Fill || SymbolNumber || Double ||  
|-
| Object.ChangeSymbol || FromSymbolNumber FromImportedLayer ToSymbolNumber || Double String Double ||  
|-
| Object.ChangeSymbolSelectedObjects || SymbolNumber || Double || e.g. 101.001
|-
| Object.MergeObjectsBySymbol|| SymbolNumber || Double || e.g. 101.001
|}

===Symbol===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Symbol.SymbolStatusManager|| FileName SymbolStatusName|| String String || xml file name name of symbol status
|-
| Symbol.ChangeStatus|| SymbolNumber|| double|| e.g. 101.000 attribute status="visible", "protected" or "hidden"
|-
|}

===Map===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Map.OptimizeRepair|| Enabled|| Boolean || true, false
|-
| Map.ChangeScale || NewScale EnlargeReduceSymbols EnlargeReduceLineWidthOfImageAndGraphicObjects || Integer Boolean Boolean|| e. g. 10000 true, false true, false
|-
| Map.ConvertLayer|| CrtFile || String || crt file name
|-
| Map.DeleteObjectsBySymbol|| SymbolNumber SymbolTreeGroupName||Double, String String|| e.g. 526.002, ObjectsWithoutSymbol e.g. Streets
|-
| Map.ExportObjectsBySymbol|| File SymbolNumber SymbolTreeGroupName||Double String|| export ocd file name e.g. 526.002 e.g. Streets
|-
| Map.LoadSymbolsFrom || File || String || ocd file name (with symbols to be loaded) The option ''replace existing colors and symbols'' is used
|-
| Map.LoadSymbolTreeFrom|| FileName || String|| ocd file name
|-
| Map.ScaleAndCoordinateSystem || MapScale Easting Northing Angle CoordinateSystem|| Integer Integer Integer Double Integer|| e.g. 10000 e.g. 600000 e.g. 200000 e.g. 4.5 internal grid id
|-
| Map.Transform.ChangeCoordinateSystem || CoordinateSystem EastingOffset NorthingOffset ScaleSymbols|| Integer Integer Integer Boolean|| internal grid id true, false
|-
|}

===Database===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Database.Dataset.New || DatasetName DBaseFile OdbcDataSource Table KeyField SymbolField TextField SizeField LengthUnit AreaUnit Decimals HorizontalCoordinate VerticalCoordinate Username Passwort || String String String String String String String String String String Integer String String String String || mandatory     mandatory mandatory                     
|-
| Database.Dataset.Remove || Dataset || String Integer || ''all'' for all databases 3, 2, 1, ... for only one or several 
|-
| Database.Assign.Symbols || Dataset CntFile || String or Integer String || ''all'' for all databases, dataset name or 1, 2, 3... for only one database Condition table file
|-
| Database.Assign.Texts || Dataset TextField Condition Symbol ReplaceExistingObjects || String or Integer String String String Boolean || ''all'' for all databases, dataset name or 1, 2, 3... for only one database     e.g. 101.0, -1 for using existing symbol true, false (Default)
|-
| Database.SetObjectDirection || Dataset AngleField MathematicalFunction || String or Integer String String || ''all'' for all databases, dataset name or 1, 2, 3... for only one database   eg.: *180/3.14159
|-
| Database.CreateObjects || Dataset SelectSymbol Condition HorizontalCoordinate VerticalCoordinate Unit TextField HorizontalOffset VerticalOffset || Integer Double String String String Enum types String Double Double || 1, 2, 3, ... Number of dataset Symbol numer. ex. 207.0 SQL String (ex. SYMBOL LIKE 207.0) Database fieldname Database fieldname m, km Database fieldname    
|}

===Background Map===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:26em" | Values / Description
|-
| BackgroundMap.Open || FileName Visible VisibleInFavorites Dimm Transparent SpotColor Blockout Infrared|| String Boolean Boolean Integer Boolean String Boolean Integer ||   true, false; Default = true true, false; Default = true [0..100]; Default = 0 [only works if Blockout is false] true, false; Default = false [only works if Blockout is false] spot color name true, false; Default = false 0=undefined, 1=32bit-infrared, 2=32bit RGB
|-
| BackgroundMap.Visible||  || String|| filename only for already loaded background maps
|-
| BackgroundMap.Hide||  || String|| filename only for already loaded background maps
|-
| BackgroundMap.Remove||  || String|| ''all'' or filename
|-
| BackgroundMap.Reload a)||  || String|| ''all'' or filename
|}
a): Limited functionality. Not avaiable for all users.

===DEM [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]===
Read more about importing Lidar and DTM data on the page [[XML Script Lidar and DTM Import]].

===WMTS Export [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]===
Read more about exporting map tiles for [https://leafletjs.com/ Leaflet] on the page [[XML Script WMTS Export]].

=== Example ===
<PRE>
<?xml version="1.0" encoding="ISO-8859-1"?>


<OcadScript>

<File.New>

<File>C:\Export\Chlosterwald.ocd</File>
</File.New>

<File.MultipleFileImport>

<Directory>C:\Export\Files</Directory>
<CoordinateSystem>1000</CoordinateSystem>
<NewOffset>true</NewOffset>
<Horizontally>600000</Horizontally>
<Vertically>200000</Vertically>
<Angle>0</Angle>
<MapScale>10000</MapScale>
<GridDistance>500</GridDistance>
<LayerField>OBJECTVAL</LayerField>
</File.MultipleFileImport>

<Database.Assign.Texts>
<Dataset>all</Dataset>
<Condition/>
<TextField>TEXT</TextField>
<Symbol>902.000</Symbol>
<ReplaceExistingObjects>false</ReplaceExistingObjects>
</Database.Assign.Texts>

<Database.Assign.Angles>
<Dataset>all</Dataset>
<AngleField>ANGLE</AngleField>
</Database.Assign.Angles>

<Database.Assign.Symbols>
<Dataset>all</Dataset>
<CntFile>C:\Export\Chlosterwald.cnt</CntFile>
</Database.Assign.Symbols>

<Database.Dataset.Remove>
<Dataset>all</Dataset>
</Database.Dataset.Remove>

<Map.OptimizeRepair>
<Enabled>true</Enabled>
</Map.OptimizeRepair>

<View.EntireMap>
<Enabled>true</Enabled>
</View.EntireMap>

<File.Save>
<Enabled>false</Enabled>
</File.Save>

<File.SaveAs>
<File>C:\Export\Chlosterwald_Example.ocd</File>
</File.SaveAs>

<File.Close>
<Enabled>true</Enabled>
</File.Close>

<File.Exit>
<Enabled>false</Enabled>
</File.Exit>

</OcadScript>
</PRE>

==XML Script Thematic Maps [[File:Space.PNG]][[File:Mas40px.png|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]]==
{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:21em" | Values / Description
|-
| File.CreateThematicMap
|| <MapTheme> Name StatDataPath StatDataTable StatDataCommonField VisualizeAttributes AttributesValuesType Classify RepresentationFeature GeometryDataPath GeometryDataCommonField JoinType VisualizationMethod VisualizationType <VisualizationProperties> ScalingMode MaxSize MinSize FillColor StrokeColor StrokeMaxWidth StrokeMinWidth DecreaseStroke ShowZeroValue ShowNoData Opacity ThemeLegendTitle </VisualizationProperties> </MapTheme> <MapTitleStyle> Color Opacity Font Size isBold isItalic Alignment </MapTitleStyle> <LegendTitleStyle> see MapTitleStyle... </LegendTitleStyle> <LegendTextStyle> see MapTitleStyle... </LegendTextStyle> AddScaleBar AddScaleText AdditionalInformationText

|| string string string string string ValueType ClassifyType RepresentationFeatureType string string JoinType VisualizationMethodType VisualizationTypeType ScalingModeType double double FillColor StrokeColor double double boolean boolean boolean integer string ColorType integer string double boolean boolean AlignmentType ... ... boolean boolean string

|| Theme name statistic data file path Sheet or table for Excel or Access files Common Id field Attribute(s) to visualize: Ex. 2004 or 2009|2011 absolute, relative yes, no point, line, area Geometry data file path Common Id field see Thematic Map Data Types table see Thematic Map Data Types table see Thematic Map Data Types table see Thematic Map Data Types table max. size in mm min. size in mm fill color: ex. C=84 M=0 Y=128 K=0 stroke color: ex. C=0 M=0 Y=0 K=255 max. stroke width in mm min. stroke width in mm true, false true, false true, false % ThemeLegendTitle font color: ex. C=0 M=0 Y=0 K=255 opacity in % font name font size true, false true, false 0=align bottom left ... ... true, false true, false Ex. Coordinate system: Pseudo-Mercator
|}

===Thematic Map Data Types===
{| class="wikitable" style=" border="1"
|-
! style="width:14em" | Data type
! style="width:28em" | Values
|-
| ValueType || absolute, relative
|-
| ClassifyType || yes, no
|-
| RepresentationFeatureType || point, line, area
|-
| JoinType || 0=KeepAllRecords, 1=KeepOnlyMatchingRecords
|-
| VisualizationMethodType || mProportionalSymbols, vmProportionalLines, vmProportionalArrows, vmGraduatedSymbols, vmGraduatedLines, vmGraduatedArrows, vmChoropleths, vmCharts
|-
| VisualizationTypeType || vtProportionalBar, vtProportionalCircle, vtProportionalSquare, vtProportionalLine, vtProportionalArrow, vtGraduatedBar, vtGraduatedCircle, vtGraduatedSquare, vtGraduatedLine, vtGraduatedArrow, vtChoropleth, vtPieChart, vtWingChart, vtBarChart, vtDividedPieChart, vtDividedWingChart, vtDividedBarChart, vtStackedBarChart, vtPercentageStackedBarChart
|-
| ScalingModeType || 0=scaling by representation ratio, 1=scaling by max. size
|-
| DataClassificationMethodType|| cmManual, cmNaturalBreaks, cmEqualIntervals, cmQuantiles
|-
| ColorType || CMYK color definition [0..255]: C=84 M=0 Y=128 K=0
|}

=== Thematic Map Script Examples ===
The following example creates a '''thematic map''' with proportional squares about the population in europe 2011.
<PRE>
<?xml version="1.0" encoding="UTF-8"?>
<OcadScript>
<OcadVersion>OCAD 2018 - Mapping Solution 32-bit</OcadVersion>

<File.New>
<File>Thematic Map.ocd</File>
<MapScale>25000000</MapScale>
</File.New>

<File.SaveAs>
<File>Thematic Map Population Europe ProportionalSquare.ocd</File>
</File.SaveAs>

<File.CreateThematicMap>
<MapTheme>
<Name>Population 2011</Name>
<StatDataPath>C:\import\population.xls</StatDataPath>
<StatDataTable>Sheet0$</StatDataTable>
<StatDataCommonField>id</StatDataCommonField>
<VisualizeAttributes>2011</VisualizeAttributes>
<AttributesValuesType>absolute</AttributesValuesType>
<Classify>no</Classify>
<RepresentationFeature>point</RepresentationFeature>
<GeometryDataPath>C:\import\europe.shp</GeometryDataPath>
<GeometryDataCommonField>ne_10m_adm</GeometryDataCommonField>
<JoinType>0</JoinType>
<VisualizationMethod>vmProportionalSymbols</VisualizationMethod>
<VisualizationType>vtProportionalSquare</VisualizationType>
<VisualizationProperties>
<ScalingMode>1</ScalingMode>
<MaxSize>30.00</MaxSize>
<MinSize>1.00</MinSize>
<FillColor>C=84 M=0 Y=128 K=0</FillColor>
<StrokeColor>C=0 M=0 Y=0 K=181</StrokeColor>
<StrokeMaxWidth>0.40</StrokeMaxWidth>
<StrokeMinWidth>0.08</StrokeMinWidth>
<DecreaseStroke>true</DecreaseStroke>
<ShowZeroValue>true</ShowZeroValue>
<ShowNoData>true</ShowNoData>
<Opacity>80</Opacity>
<ThemeLegendTitle>Population</ThemeLegendTitle>
</VisualizationProperties>
</MapTheme>
<MapTitle>Population in Europe 2011</MapTitle>
<DefaultTextStyle>
<Color>C=0 M=0 Y=0 K=150</Color>
<Opacity>100</Opacity>
Arial
<Size>9.0</Size>
<isBold>0</isBold>
<isItalic>0</isItalic>
<Alignment>0</Alignment>
</DefaultTextStyle>
<MapTitleStyle>
<Opacity>80</Opacity>
<Size>24.00</Size>
<Alignment>1</Alignment>
</MapTitleStyle>
<AddThemeLegend>true</AddThemeLegend>
<AddBasemapLegend>true</AddBasemapLegend>
<LegendTitleStyle>
<Size>12.0</Size>
</LegendTitleStyle>
<LegendTextStyle>
<Size>9.0</Size>
</LegendTextStyle>
<AddScaleBar>true</AddScaleBar>
<AddScaleText>true</AddScaleText>
<AdditionalInformationText>OCAD ThematicMapper sample map</AdditionalInformationText>
</File.CreateThematicMap>

<File.Save>
<Enabled>true</Enabled>
</File.Save>
</OcadScript>
</PRE>

==XML Script Partial Map==
{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:50em" | Values / Description
|-
| Export || File coordSystem L, R, B, T|| String Enum types Float|| eg.: ‚ c:\export\PartialMap1.ocd ‘ OCAD creates files PartialMap1_#verticalPages_#horizontalPages.ocd mm (paper, m (real world) left, right, bottom, top
|-
| Export.loop || Enabled HorizontalPages VerticalPages HorizontalOverlap VerticalOverlap || Bool Integer Integer Float Float || true, false number of pages in horizontal direction number of pages in vertical direction horizontal overlap in [mm] or [m] vertical overlap in [mm] or [m]
|}

=== Example ===
The following example exports parts of an ocad map. 
<PRE>
<ocadScript> // comment
<partialMapScript> 
<export id="0"> // first export section
<file>c:\export\PartialMap1.ocd</file> // export file
<coordSystem>mm</coordSystem> // paper oder real world coordinates
<T>100</T> // export rectangle with Top Left point and Bottom Right point
<L>0</L>
50
<R>50</R>
<loop> // the loop export several ocd files. For this example 21 files.
<enabled>true</enabled>
<horizontalPages>7</horizontalPages>
<verticalPages>3</verticalPages>
<horizontalOverlap>10</horizontalOverlap> // horizontal and vertical overlap.
<verticalOverlap>10</verticalOverlap>
</loop>
</export>

<export id="1"> // second export section
<file>c:\export\PartialMap2.ocd</file>
<coordSystem>mm</coordSystem>
<L>0</L>
<R>50</R>
50
<T>100</T>
<loop> // export only one ocd file
<enabled>false</enabled>
</loop>
</export> 
</partialMapScript>
</ocadScript>
</PRE>

==XML Script Print==

Print parameters can be saved in a XML script.

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Print.Printer || Name DmPaperSize DmDefaultSource DmPrintQuality DmColor DmMediaType || String Integer Integer Integer Integer Integer || Eg. ,HP Color LaserJet 2840 PCL' File->Print->Save XML Script->Open the Script and depending on which printer was choosen, the informations are there.
|-
| File.Print.Portrait || Enabled || Bool || true, false
|-
| File.Print.SpotColor || Enabled Colors|| Bool String|| true, false Name of the spot color(s)
|-
| File.Print.PartOfMap || Range Coordinates L, R, B, T || Integer Enum types Float || 1 mm (page), m (real world) Left, Right, Bottom, Top
|-
| File.Print.HorizontalOverlap ||   || Float ||
|-
| File.Print.VerticalOverlap ||   || Float ||
|-
| File.Print.PrintScale ||   || Integer || Eg. 25000
|-
| File.Print.Copies ||   || Integer || Number of copies
|-
| File.Print.Intensity ||   || Integer ||  
|-
| File.Print.LineWidth ||   || Integer ||  
|-
| File.Print.PrintScreenGrid || Enabled PrintScreenGridColor || Bool Integer || true, false Ocad color number
|}

==XML Script Export==

Watch out for the file endings. Resolution is only used if File.Export.GeoRef -> Enabled = false

===AI (Adobe Illustrator), PDF===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:20em" | Values / Description
|-
| File.Export || File Format Resolution ExportScale|| String Enum types Integer Integer|| eg.: ,c::\Export\Chlosterwald.ai‘ AI, PDF in dpi [40..2540] (only if the map has raster background maps) eg. '10000' for the scale 1:10'000
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|-
| File.Export || Colors || Enum types || normal, spotColors
|-
| File.Export.SpotColors || Combine Enabled|| Bool String|| true, false [only if Colors = spotColors] Spotcolor name [only if Colors = spotColors]
|}

===BMP, GIF, JPEG, PNG===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format Quality Resolution Anti-Aliasing ColorCorrection|| String Enum types Integer Integer Boolean Boolean|| eg.: ‚c:\Export\Chlosterwald.bmp‘ BMP, GIF, JPEG, PNG only for JPEG, [0..100] in dpi [40..2540] true, false true, false
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top for rotated maps use here the coordinate of the upper left und lower right corner
|-
| File.Export.Tiles || Enabled Width Height || Boolean Integer Integer || true, false [only if Enabled = true] [only if Enabled = true]
|-
|File.Export.GeoRef|| Enabled PixelSize CreateWorldFile || Bool Float Bool || true, false in meter [only if Enabled = true] true, false [only if Enabled = true]
|}

===EPS===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format ExportScale|| String Enum types Integer|| eg.: ‚c:\Export\Chlosterwald.eps ‘ EPS e.g. '10000' for the scale 1:10'000
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|-
| File.Export || Colors || Enum types || normal, spotColors
|-
| File.Export.SpotColors || Enabled || Spotcolor name || [only if Colors = spotColors]
|}

===SVG (Scalable Vector Graphics)===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format ExportScale CompressFile|| String Enum types Integer Boolean|| eg.: ‚c:\Export\Chlosterwald.svg ‘ SVG e.g. '10000' for the scale 1:10'000 true, false
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|}

===TIFF===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:20em" | Values / Description
|-
|File.Export || File Format Resolution Anti-Aliasing ColorCorrection|| String Enum types Integer Boolean Boolean|| eg.: ‚c:\Export\Chlosterwald.tif‘ TIFF in dpi [40..2540] true, false true, false
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|-
|File.Export.Tiles || Enabled Width Height || Bool Integer Integer || true, false [only if Enabled = true] [only if Enabled = true]
|-
|File.Export.GeoRef|| Enabled PixelSize CreateWorldFile || Bool Float Bool ||true, false in meter [only if Enabled = true] true, false [only if Enabled = true]
|-
| File.Export || Colors || Enum types || normal, spotColors
|-
| File.Export.SpotColors || Combine Enabled || Bool Spotcolor name || true, false [only if Colors = spotColors] [only if Colors = spotColors]
|-
|File.Export || ColorMode || Integer || 0 = 32 bit CMYK 1 = 24 bit RGB 2 = 256 colors 3 = grayscale 4 = 8 bit CMYK 5 = 1 bit black/white 6 = halftone screen [only if spotColor = true]
|-
|File.Export || Compression || Integer || 1 = no compression 2 = CCITT [only used with ColorMode 5/6] 4 = FaxG4 [only used with ColorMode 5/6] 5 = LZW
|}

===DXF===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format ExportScale ConvertAnsiToOem ConvertOemToUnicode ObjectsSelectedSymbols AddSymbolDescription UseCrtFileName ExportAsSplines Coordinates || String Enum types Integer Boolean Boolean Boolean Boolean String Boolean Enum types|| eg.: ‚c:\Export\Chlosterwald.dxf ‘ DXF e.g. '10000' for the scale 1:10'000 true, false true, false true, false true, false eg.: ‚c:\CRT\Chlosterwald.ocdCrt‘ true, false m, mm
|}

===Shape===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:25em" | Values / Description
|-
| File.Export
|| ExportPath File Format PointObjects LineObjects AreaObjects TextObjects EnvelopePolygonFromTextObjects Dataset WordWrap ProjectionFile Utf8Encoding
|| String String Enum types Boolean Boolean Boolean Boolean Boolean String Integer Boolean Boolean Boolean
|| eg.: ‚c:\Export‘ (only path name) eg.: ‚c:\Export\test.shp‘ (using ExportPath OR File, not both) SHAPE true, false true, false true, false true, false true, false all for all databases 1, 2, 3, ... for only one database true, false true, false true, false
|}

===Example===

The following example exports two pdf files in spot colors and two Shape files. Each OcadScript node can contain many
children.

<?xml version="1.0" encoding="ISO-8859-1"?>
<OcadScript> 
<File.Open>
<File>M:\OCAD2018\Changes\11-06xx\11-0663\Chlosterwald.ocd</File>
</File.Open> 
<File.Export> //PDF export
<File>M:\OCAD2018\Changes\11-06xx\11-0663\output\Chlosterwald.pdf</File>
<Format>PDF</Format>
<PartOfMap>
<Enabled>true</Enabled>
<Coordinates>mm</Coordinates>
<L>0</L>
<R>50</R>
50
<T>100</T>
</PartOfMap>
<ExportScale>10000</ExportScale>
<Colors>spotColors</Colors>
<SpotColors>
<Combine>false</Combine>
<Enabled>Blau</Enabled>
<Enabled>Gelb</Enabled>
</SpotColors>
</File.Export>

<File.Export> //Shape export
<ExportPath>M:\OCAD2018\Changes\11-06xx\11-0663\output\</ExportPath>
<Format>SHAPE</Format>
<PointObjects>false</PointObjects>
<LineObjects>true</LineObjects>
<AreaObjects>true</AreaObjects>
<TextObjects>false</TextObjects>
<EnvelopePolygonFromTextObjects>false</EnvelopePolygonFromTextObjects>
<Dataset>all</Dataset>
<WordWrap>true</WordWrap>
<ProjectionFile>false</ProjectionFile>
</File.Export> 
<File.Save>
<Enabled>true</Enabled>
</File.Save> 
<File.Close>
<Enabled>true</Enabled>
</File.Close>
</OcadScript>

==Run XML Script from the Command Line==

It is possible to execute a XML script file from the command line or from batch file.

Open the Windows command and enter the OCAD program name and the xml script file.
For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" "C:\Data\ExportScriptExample_PDF.xml"

Use the parameter ''/NewInstance'' to always create new OCAD instance.
For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" /NewInstance "C:\Data\ExportScriptExample_PDF.xml"

Do not forget to use the parameter <File.Open> to open the file, <File.Close> to close it and <File.Exit> to close OCAD.

==Open ocd File from the Command Line==
It is possible to open an ocd file from the command line with optional view parameters.

Open the Windows command and enter the OCAD program name and the ocd file name.

For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" "M:\Data\Map.ocd"

Additional OCAD supports the following optional view parameters to open an map at desired postion and view scale.

-c: center for view
-s: view scale

For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" -c 710000,231000 -s 2500 "M:\Data\Map.ocd"

----
Back to [[Main Page]]

Technical Data

2023-03-24T08:49:29Z

GRS: /* Computer / System Requirements */

= Computer / System Requirements=
* OCAD requires Windows 8, 10 or 11 (32- or 64-bit). OCAD is available as 32-bit and 64-bit software. OCAD does not run on [https://support.microsoft.com/en-us/windows/windows-10-and-windows-11-in-s-mode-faq-851057d6-1ee9-b9e5-c30b-93baebeebc85 Windows in S mode].
* 100 MB of free disk space for the installation
* At least 1 GB RAM (depends on the size of open maps and background maps). The OCAD program without any open map needs only 70 MB RAM.
* OCAD as 32-bit software can allocate up to approx. 3.5 GB RAM. OCAD as 64-bit software and can allocate more than 3.5 GB RAM if available.
* Screen resolution: 1280 x 1024 or higher recommended (needs to be multiplied with the screen scaling factor e.g. 2560 x 2048 when using 200% scaling)
* OCAD Mapping Solution: We recommend to install the [http://www.ocad.com/download/bde.exe Borland Database Engine] (import shape files, database connections to dBase files, using OCAD to create thematic maps) and the [http://www.microsoft.com/download/en/details.aspx?id=13255 Microsoft Access Database Engine] (database connections to Access/Excel files, using OCAD to create thematic maps).

[[File:hint.jpg]] OCAD 64-bit version cannot connect to Microsoft Excel/Access if the 32-bit version of Microsoft Access Database Engine is installed. The same with 64-bit Microsoft Access Database Engine and OCAD 32 bit version.
In this case use the same OCAD version as installed Microsoft Access Database Engine.

= 64-bit Version vs. 32-bit Version =
The 64-bit version of OCAD isn't faster than the 32-bit version. The big advantage of 64-bit is that OCAD can allocate more than 3 GB RAM if available on the computer. That is important when loading huge raster background maps or DEM files. 

OCAD 64-bit runs only on Windows 64-bit version. Nowadays, almost all computers are running on a 64-bit Windows version. OCAD 32-bit runs on both Windows 64-bit and 32-bit. The ocd files are 100% compatible between both versions. 

'''OCAD Orienteering''', '''OCAD Starter''', '''OCAD Course Setting''' and '''OCAD Viewer''' 
:OCAD Setup only installs the 64-bit version. If the installed Windows version is 32-bit, OCAD will only install an OCAD 32-version. 

'''OCAD Mapping Solution''' 
:OCAD Setup installs the 64-bit and 32-bit version. 
:Please note that not all OCAD functions are available in both versions:
:* Microsoft Access database files depend on the installed Access Database Engine version
:* dbf database file cannot be used in OCAD 64-bit version

= OCAD on Mac OS X =
Read the '''[[OCAD on Mac OS X]]''' article for more information.

= OCAD on Linux =
Read the '''[[OCAD on Linux]]''' article for more information.

= OCAD Limits =
* Maximal map size: 4 x 4 meters (OCAD Starter and Orienteering edition), 80 x 80 meters (Mapping Solution edition)
* Resolution (accuracy of coordinates) 0.01 mm
* 10000 objects (Starter edition), 16 million objects (OCAD Mapping Solution, Orienteering, Course Setting and Viewer edition)
* 4 million vertices for each object
* Unlimited number of symbols (number range 0.001 to 999'999.999)
* 32'000 colors (number range from 0 to 32'000)
* 2 GB file size

= OCAD File Format =
This description of the OCAD file format is intended for programmers who want to directly access the information in OCAD files.

* [[OCAD 12 File Format]]
* [http://www.ocad.com/wiki/ocad11/en/?title=Main_Page OCAD 11 File Format]
* [http://www.ocad.ch/docs/OCAD10Format.txt OCAD 10 File Format]
* [http://www.ocad.ch/docs/OCAD9Format.pdf OCAD 9/10 Graphic]
* [http://www.ocad.ch/docs/OCAD9Format.txt OCAD 9 File Format]
* [http://www.ocad.ch/docs/format8.txt OCAD 6/7/8 File Format]

= Recommendations =

==Mobile Mapping==

Mapping with a tablet in the terrain has some compelling advantages like real-time GPS positioning and the possibility to switch between different background maps. 
In case your background material isn't that great, you can get help of a GPS device so you can see you current position on the tablet.

There are two ways to use OCAD in the field.

'''1. OCAD Desktop, on Window devices''':

:Software: OCAD Orienteering Edition or OCAD Starter Edition
:Advantages: OCAD objects can be drawn directly.
:Disadvantages: Operation is not as ergonomic as in OCAD Sketch App.
:That's you: You like to draw the map directly in the terrain and see immediately, whether a situation on the map is clear and readable.

'''2. OCAD Sketch App, on iOS and Android devices''':

:Software: The OCAD Sketch App is available for free download and use in Apple App Store (iOS) and Google Play (Android). To prepare the data for the OCAD Sketch App and for final drawing, you need OCAD Desktop.
:Advantages: Very ergonomic and intuitive to use. Designed specifically for mobile mapping.
:Disadvantages: Only sketches can be drawn and not OCAD objects directly.
:That's you: You want to map as much as possible in the field and do the final drawing in the evening or on a rainy day on the computer at home.

===General things to consider===
*'''Battery'''
:Battery should last a working day. Battery lifetime is an issue and can vary not only from device to device but is also dependend on outside temperature.
:In cold conditions, a normal battery lifetime of 6 hours can be reduced to only 3-4 hours.
:Use an external battery pack/ power bank to extend battery lifetime. You can put the power bank into a bag and connected it directly by wire to the tablet or charge the tablet during a break.

*'''Stylus Pen'''
:A capacitive pen that works with your table is beneficial for precise drawing. General touchscreen pens might not work that precise.
:The OCAD Sketch App can also be used with fingers. However, drawing is more precise with a pen.

*'''Robustness'''
:How robust you want your tablet to be?
:E.g. do you want your tablet to be waterprof (rugged computers/ toughpads) or is it ok to pack it into a plastic bag, when it rains?

*'''GPS'''
:Many devices have internal GPS, which works very satisfactory in most cases.
:If your device has bad or no internal GPS, you can also use an external GPS.

*'''Compass'''
:If your device has a build-in compass, the OCAD Sketch App can use it to rotate the map view to magnetic north.

===Tablets for OCAD Desktop (Windwos)===

Some recommendation of our customers (05.2022): 
*Microsoft Surface Pro
*Microsoft Surface Go
*Microsoft Surface 7
*Lenovo tablet (Intel Atom CPU Z3795)

Also, you will find many '''rugged computers/ toughpads''' for tough environments as you will need it when mapping in the terrain. As a big plus point, these devices are working well in all weathers and are possible to use in rain. However, these devices are rather expensive if you are not a professional mapper and can cost up to a few thousand Euros. Also consider the weight of the device, which can be over 1kg.

More information can found e.g. on www.forest-it.se 
Some recommendation of our customers (05.2022): 
* Handheld Algiz 8X
* Trimble Yuma 2
* Panasonic Toughpad FZ-G1
* Gen2wave RP70
* FIDS Zelo
* Welo R10S

===Tablets for OCAD Sketch App (iOS or Android)===

'''iOS devices''' 
No specific recommendation. All iPads can be used, e.g. iPad Air, iPad Air Mini.

Note: iPad Air Wi-Fi = No internal GPS | iPad Air Wi-Fi + Cellular = With Internal GPS

Alternative iPad Pencil: 
*ERS Digital Pencil

'''Android devices''' 
Some recommendation of our customers (05.2022): 

*SAMSUNG Galaxy Tab S6 LTE with Samsung S Pen
*Samsung Galaxy Tab Active3 (8 ", 64 GB) with Samsung S Pen.

Note: Samsung Galaxy Tabs with ''Lite'' have no build-in compass | Samsung Galaxy Tab have GPS.

===Smartphones for OCAD Sketch App (iOS or Android)===
You can use the OCAD Sketch App also on a mobile phone. 
For small corrections, this can be an easy alternative to the tablet. 
For larger projects, however, the use of a tablet is recommended. 

===External GPS device===
If your tablet has no or only bad internal GPS, it is a good idea to connect an external GPS receiver to have your current position shown in OCAD with a few meters accuracy. 
You can place the external GPS device on the top of your head for better reception (fastend it to a cap or helmet) and connected it via bluetooth directly to your tablet. GPS devices like Gramin Glo should last more than 10 hours. 
Some recommendation of our customers (05.2022): 
*Garmin GLO 2
*Navilock BT-821G Bluetooth GNSS Receiver MT3333
*GNS3000

==Draw Orienteering Maps and Course Setting==
Hardware:
* Desktop or Laptop with Windows
* 4 GB or more RAM (at least 8 GB RAM when working with big LiDAR Files)
Software:
* OCAD Orienteering Edition, OCAD Starter Edition or OCAD Course Setting Edition

==Map Publishing Companies==
Hardware:
* Desktop PC with Windows one or two screens
* 4 or more GB RAM
Software:
* OCAD Mapping Solution
Special OCAD Settings:
* Switch on the '''Faster text rendering''' in '''OCAD Preferences''' -> '''View''' tab in '''Options''' menu.
* Switch off the '''Anti-Aliasing''' mode in '''View''' menu. If Anti-Aliasing is switched off then OCAD draws the screen color by color. Otherwise OCAD draws the screen once after a short time.

= Digital Signature =
The OCAD program file and the OCAD setup file are signed with the [https://en.wikipedia.org/wiki/Code_signing digital signature] of OCAD AG. That confirms the software author and guarantee that the code has not been altered or corrupted since it was signed by use of a cryptographic hash. OCAD uses the digital signature algorithm sha256RSA.

That is the reason why OCAD doesn't run on Windows XP and Vista.

The see the digital signature open the context menu of the OCAD setup file (.exe file) in '''File Explorer''' and click '''Properies'''. The '''Properties dialog''' opens. Click the '''Digital Signature''' tab.
Click '''Details'''. In '''Digital Signature Details''' dialog is the '''Signer Name''' ''OCAD AG''.

[[File:DigitalSignature.png]]

----
Back to [[Main Page]]

Previous Chapter: [[Tutorials]]

Drawing Orienteering Maps in OCAD

2023-02-20T11:58:39Z

GRS: /* Run OCAD */

The focus of this tutorial is how to draw an orienteering map with OCAD.

If you update an old existing map, please see the page '''[[Updating Orienteering Maps in OCAD]]'''.

==About OCAD==
===Structure of the OCAD User Interface===
The image below shows you the '''[[Graphical_User_Interface|OCAD User Interface]]'''. 
[[File:GUI.JPG|800px]]

===OCAD Help===
OCAD provides numerous help material. You will find a detailed list in the '''[[Help]]''' menu.

===Service Update===
Regular and free updates are included in the OCAD subscription model. The Service Update corrects known bugs and adds the latest cartography tools and enhancements to your OCAD.

Therefore we recommend using OCAD software always with the most recent Service Update to benefit from the quality improvements. 
Please download the current Service Update from the '''Help -> OCAD Update''' function in the OCAD program.

The content of the Service Update is listed in the '''[http://ocad.com/OCAD2018/OCAD_2018_Update.txt Release notes]'''. Your current version of OCAD can be seen under '''[[About OCAD]]''' in the '''Help''' menu.

==New Map==

You can start a new map either as described below or by using the '''[[New Map Wizard]]'''. The New Map Wizard is especially helpful if like to georeference your map and import directly cadastral data.

===Start a New Map File===

Before start mapping you should define which type of map you want to draw, which symbol set you want to use and which scale the map should have. For this tutorial we want to draw an normal forest orienteering map in scale 1:10'000.

To create a new map:
#Select '''New''' in the '''File''' menu. The '''New File''' dialog box appears.
#:[[File:NewFile.PNG]]
# Choose a map type. OCAD provides predefined symbol sets to help you begin drawing your map immediately. Choose the symbol set '''Orienteering Map ISOM 2017 10000.ocd'''.
# Deside in which '''scale''' the map shall be drawn. Set the scale to 1:10'000.
# Choose the language of the symbol set (if available).
# By clicking the '''OK''' button, OCAD creates a new map and copies the chosen symbol set to it.
 
Click '''[[Create_a_New_Map#Create_a_New_Map|here]]''' to learn more about this step.

===Set Scale and Coordinate System===
Select the '''Set Scale and Coordinate System''' item from the '''[[Map]]''' menu. The '''Set Scale and Coordinate System''' dialog box appears.

[[File:SetScaleAnd CoordinateSystem.PNG]]

====Enter the Map Scale====
Enter a scale and click the '''OK''' button. 
[[File:Hint.jpg|hint]] Do not use this dialog to change the scale after entering the initial values. To increase or decrease the size of the map subsequently, use the '''[[Map#Change_Scale|Change Scale]]''' function in the '''[[Map]]''' menu.

====Georeference the Map====
Before loading a georeferenced '''[[Background Map]]''', work with '''[[GPS]]''' data or import '''[[DEM|Spatial Base Data]]''', we recommend that you first georeference the map. Georeferencing means, that you assign space-related reference information to objects in a spatial reference system. Shortly: A georeferenced map is assigned to a coordinate system. You should contact c to find out which coordinate system will best suit your needs.

# Choose wheter you want define '''Paper coordinates''' (in mm) or '''Real world coordinates'''. We choose '''Real world coordinates''' for this tutorial.
# In the '''Easting offset''' and '''Northing offset''' fields, enter the coordinate values for the center of your map. This option is used to ensure that imported '''[[DEM|Spatial Base Data]]''', georeferenced '''[[Background Map|Background Maps]]''' and '''[[GPS]]''' measurements do not lie outside the drawing area.
# The coordinate system can be rotated by entering a value in the '''Angle''' field. The "Angle" is the deviation from the magnetic North to the coordinate system. You can only Apply the Angle, if no objects have been drawn yet. If you have already drawn objects, use the '''[[Map_Transform#Rotate_Map_to_Magnetic_North|Rotate Map to Magnetic North]]''' function instead.
# In the '''Grid distance''' field, enter the desired distance for the '''[[View#Show_Screen_Grid|Coordinate Grid]] lines.

====Coordinate System====
Click the '''Choose''' button to define a coordinate system. The '''Coordinate System''' dialog appears.

[[File:CoordinateSystemDialog.PNG]]

Choose the desired coordinate system. OCAD supports a lot of coordinate systems.

Click '''[[Create_a_New_Map#Set_Scale_and_Coordinate_System|here]]''' to learn more about Scale, Coordinate System and Georeferencing.

==Create the Base Map for the Field Work==
Before you go mapping into the terrain, you should try to create the best possible base map. The more
you invest in your base map, the faster and more accurate your mapping will be.
In OCAD you can import spatial data, load old orienteering maps, derive own base maps with LiDAR data, connect to WMS/WMTS
and combine them.

===Raster Base Maps===
Typically, the orthophotos and topographic maps for orienteering maps are delivered as raster files.
OCAD supports, among others, the most common used raster files: JPG, TIFF and PNG.

Orthophotos and topographic maps are mostly georeferenced. Raster files are georeferenced, when
the pixels are referenced with the coordinates. Normally the georeferencing data is saved in a world
file in the same folder. The world file has the same file name as the raster file, but with another file extension: Picture1.JPG → Picture1.JGW,
Picture2.TIFF → Picture2.TFW, Picture3.PNG → Picture3.PGW.

====Open Georeferenced Raster Base Map as Background Map====
Click to '''[[Background_Map|Background Map->Open]]'''

If there's not yet a coordinate system and offset, the '''[[Background_Map#Use_a_Georeferenced_Raster_Map_as_Background_Map|Background Map (Georeferenced)]]''' dialog appears and shows the proposed georeferencing of the selected background map.

Click '''OK'''.

The georeferencing raster files will be automatically displayed at the right position.

====Open not Georeferenced Raster Base Map as a Background Map====
Click to '''[[Background_Map|Background Map->Open]]'''

It the seleced file is [[Background_Map#Use_a_Non_Georeferenced_Raster_Map_as_Background_Map|not georeferenced]] (e.g. an old orienteering map), you need to enter a resolution for the background map (e.g. 300 dpi) and click the '''OK''' button. 
[[File:NonGeoreferencedRasterMap.png]]

The background map is displayed at the center of the current drawing area. The raster map (background map) now needs to be adjusted with the map ('''[[Background_Map#Adjust_a_Background_Map|Adjust a Background Map]]'''). In other words, it needs to be referenced with the map coordinate system. 
[[File:AdjustBackgroundMap.gif]]

[[File:Hint.jpg]]We recommend you to print the grid on the base map. Thereby you can adjust your scanned base map easier.
In the dialog '''[[Printing_Maps|File->Print]]''' select '''Print screen grid''' and choose the '''Grid color'''.

===Preparation of LiDAR Data===
LiDAR data is often a base for orienteering maps and highly recommended to use if available. LiDAR
data is available as a point cloud in the las/laz file format. With LiDAR data, you can easily get lot of
information about the terrain and the vegetation, which will make mapping much faster and more
accurate.

For this purpose, there's an extra tutorial about '''[[Using Airborne Laserscanning Data for Orienteering Base Map Generation]]'''.
There you will learn, how to proceed LiDAR data in OCAD and how to use them when drawing orienteering maps..

[[File:DEMVegetationHeightExample.png|800px]]

===Import Vector Data===
Vector data can also be used to create the base map. The advantage is that vector data contain point, line, area and text objects which are directly converted to map objects during the import into OCAD. It saves a lot of time because especially in urban surroundings many map objects can be created automatically instead of being digitized manually.
Governmental data is generally available as DXF or Shape files. OCAD can also import other vector data formats like PDF, AI, SVG or OSM (Open Street Map).

#Go to '''File->Import'''
#Choose an '''[[Import_Files|importable file]], e.g. a dxf-file.
#:[[File:DxfImport1.png]]
#The vector data is shown as '''Unsymbolized objects''' in the drawing area. You can symbolize the objects automatically:
#:'''Map → [[Map#Convert_Imported_Layers_to_Symbols|Convert Imported Layers to Symbols…]]'''
#:[[File:DxfImport3.png]]
#The map now shows all objects with the assigned symbols.

[[File:Hint.jpg]] You can also '''[[Import_Files#Converting_a_Layer_Manually|Convert the imported Layers manually]]'''. 
[[File:ConvertImportedLayers.gif]]

===Connect to WMS/WMTS===
You can connect to a '''[[WMS|WMS (Web Map Service) or WMTS (Web Map Tile Service)]]''' and use their images as background maps in OCAD. There are already many predefined connections in OCAD, which you can use.

===Combine Base Maps===
As you could see, there are several background maps which are very useful for mapping.

If you use a tablet for field mapping, then you can switch between the different base maps.

If you work with paper and pen, you need to arrange your background maps is a way, that the information of several background maps are visible. In the OCAD Menu, go to '''[[Background_Map#Manage_Background_Maps|Background Map -> Manage]]'''. Here you can set your favourite background maps visible. To see several background maps at once, make them visible and use dimming.

As we mentioned above, it's good practice to invest in a proper base map. This includes also to sketch features based on hill shadings, orthophotos, ect.

If you have already objects on your map, make use of the '''[[View_Mode#Draft_Mode|Draft Mode]]''' . In the draft mode the map is display transparent and the background maps are visible.

[[File:DEMReadyForMapping.PNG|800px]]

==Mapping in the terrain==
Nowadays, with the right background material and equipment, mapping in the terrain is not about the right place of the object - it is about which objects should be on the map. This process is called generalisation and is done differently by every cartographer. Also, it is more important to draw the object right relative to the others than exactly true-to-location.

===Paper and Pen===
+ Mapping in the terrain with pen and paper is probably still the preferred method by most cartographer. Field work normally goes faster and the final drawing can be made at home, where you work more efficiently and weather independent. You don't have to worry about the battery running out or the tablet breaking down.

- In bad weather, a protective film and special pens are necessary. Other negative points are the lack of options to connect a GPS and switch between differnt background maps.

[[File:MappingTerrain.png|800px]]

In the example above, the following color were used: 
Black: Buildings, streets, paved area, rocks, stones 
Red: Terrain, canopies/passages, open land 
Blue: Water, wells, walls, fences 
Green: Vegetation, hedges, trees 

===Mobile Mapping===

Mapping with a tablet in the terrain has some compelling advantages like real-time GPS positioning and the possibility to switch between different background maps.
In case your background material isn't that great, you can get help of a GPS device so you can see you current position on the tablet.

====OCAD on Windows Tablet====
[[File:Hint.jpg]] If you are interested in buying a tablet, you can find some recommendations '''[[Technical_Data#Mobile_Mapping|here]]'''.

+ In addition to a GPS, a '''[[Laser_Rangefinder|Laser Rangefinder]]''' can be used, if the GPS signal and terrain model data is poor.

+ Another advantage of drawing a map directly in the terrain, is that you get a better sense for generalization. You can directly see how the map looks like and if there are too many objects on it or not.

- Operation is not as ergonomic as in OCAD Sketch App.

[[File:RuggedTablet.png]]

====OCAD on Android or iOS devices====
[[File:Hint.jpg]] If you are interested in buying a tablet, you can find some recommendations '''[[Technical_Data#Mobile_Mapping|here]]'''.

The '''[[OCAD_Sketch_App|OCAD Sketch App]]''' complements the desktop version of OCAD and runs on Android and iOS devices. It is designed for mapping in the field – both for new mapping as well as revisions, feedback from course planners or map reviewers. Drawing pen, different colors and line widths and eraser enable fast and ergonomic sketching. GPS routes can be tracked and the compass can be used to adjust the map orientation. Map projects are transferred from desktop version of OCAD to the OCAD Sketch App and synchronized back after mapping. The download and use of the app is free of charge.

+ Very ergonomic and intuitive to use. Designed specifically for mobile mapping.

- Only sketches can be drawn and not OCAD objects directly.

If you are interested in buying a tablet, you can find some recommendations '''[[Technical_Data#Mobile_Mapping|here]]'''.

[[File:WPSliderSketchApp04.png]]

==Prepare your field work for digitizing==
===Scan Field Work, Open it as a Background Map and Adjust===
When you are back from mapping with paper and pen...
#Scan your field work and save it in a raster format (JPG, TIFF or PNG).
#'''Background Map->Open'''
#'''[[Background_Map#Adjust_a_Background_Map|Adjust your Background Map]]''' (F9)

===Background Map Options===
Go to '''Background Map -> Manage'''
In the Manage Background Map dialog a table is displayed, in which all loaded background maps are listed. 
[[File:ManageBackgroundMap1.png]]
* '''V (Visible):''' You can make a background map visible or hide it by clicking the corresponding cell in this column. An eye icon in this column means that the background map is visible. 
: [[File:Hint.jpg|hint]] To hide all background maps temporary use the '''[[Background Map#Hide all Background Maps|Hide All]]''' command in the '''Background Map''' menu.
* '''F (Visible in Background Favorites view mode):''' You can make a background map visible or hide it in the '''[[View_Mode#Draft_Mode_Only_Background_Map_Favorites|Background Favorites]]''' by clicking the corresponding cell in this column. An eye icon in this column means that the background map is visible in the '''[[View_Mode#Draft_Mode_Only_Background_Map_Favorites|Background Favorites]]'''.
* '''Dim:''' In this column you can enter a value in percentage to make the background map appear brighter, i.e. to dim it. 0% means the background map is displayed in its original colors. 100% means the background map appears completely white. Dimming is used to get a better distinction between the background map and the map.
* '''T (Transparent):''' If more than one background map is opened you can set them transparent so that both are visible. Activate this option by clicking the corresponding cell in this column.

[[File:Hint.jpg]]The order of the background maps can be changed with the arrow icons [[File:MoveUpDown.png]] or with drag and drop.

===Display Background Maps===
Choose the '''Hide All''' command in the '''Background Map''' menu or press the '''F10''' key to hide all background maps temporarily or make them visible when they are hidden.

Change to '''[[View_Mode#Draft_Mode|Draft Mode]]'''. With the draft mode slider you can set the transparency for the map and the background maps

==Draw an Object on the Map==
To draw an object, click on the symbol in the symbol box first, then choose the drawing tool in the toolbar and finally draw the object in the drawing area. 
Please read the Wiki Page '''[[Drawing_an_Object|Drawing an Object ]]''' to learn more about it. 

[[File:DrawingMap.gif]]

==Edit Objects==
To edit an object, there are many edit tools:
*Edit tools in the Edit and Drawing Toolbar
:[[File:EditAndDrawingToolbar.png]]

*Edit functions in the Edit Functions Toolbar
:[[File:EditFunctionsToolbar.png]]

To edit an object, the object has to been selected:
*Select and Edit Object(s) [[File:Icon_SelectAndEditObject.PNG]] e.g. move an object

*Select Object and Edit Vertex [[File:Icon SelectObjectAndEditVertex.PNG]] e.g. insert, move, remove a vertex

Find more information on the '''[[Edit Object]]''' page.

==Check Legibility of your Map==
The term '''Generalisation''' was mentioned already above and deals with the question, which objects are important and should be on a map and which are not. The problem is seldom that there are too few objects on the map, but often are too many and too small objects on the map. This has to do with more accurate background maps, on which you see every detail.

Be also aware, that orienteering maps are no cadastral maps. Readability is much more important than position accuracy. You are allowed to cheat, e.g. make buildings smaller to emphasize a passage.

OCAD has a function called '''[[Map#Check_Legibility|Check Legibility]]''' that helps you verifying your map. 
Use this function to check minimum distances between objects, minimum length of line objects or minimum size of area objects according to ISOM 2017.

PS: The live preview for point and line objects can be turned on in the '''OCAD Preferences''' under '''[[OCAD_Preferences#Enable_live_preview|Enable Live Preview]]'''. There you can also activate the '''Show legibility halo''' function. A legibility halo shall support the cartographer to draw objects with enough distance to each other.

[[File:CheckLegability areaSize.PNG]]

==Colors and Symbols==
===Colors===
In the '''Map -> [[Colors]]''' dialog you can manage the colors of the symbols. You shouldn’t change something in the list, when you don’t know what you are doing.
The order of the colors in the color list regulates the overlaying: a color covers at the printing all the colors that are below.

The actual ISOM Symbol Sets of OCAD contains the latest CMYK color value. However, they may change from time to time. The latest CMYK color values can be found [[https://orienteering.org/resources/mapping/ here]].

===Symbols===
====Symbol Sets for Orienteering Maps====
OCAD delivers many predefined Symbol Sets for Orienteering maps and are part of OCAD.
Choose one of the Symbol Set, when you start a new file '''File -> New'''.
The latest ISOM (International Specification for Orienteering Maps) is ISOM 2017 for Forest Maps. If your
map is still in an older ISOM standard, you can change the symbols to ISOM 2017 under '''Map -> [[Symbol_Set_Conversion|Symbol Set Conversion]]'''.

For Sprint Maps the latest specification is ISSprOM 2019.
The symbol sets are also delivered for Ski and Bike orienteering.

==Print and Export==

===Print===
Go to '''File>Print''' (or Ctrl+P) to print your map. Select printer, scale and extend. Read more on the '''[[Printing Maps]]''' page.

[[File:Hint.jpg]] Print your map in the intended scale after a while. Check if you can read all details. Remember to keep at least the minimum dimensions defined by the IOF. The '''[[Map#Check_Legibility|Check Legibility]]''' function helps you with that. When working with 64x zoom level, you easily get too small and too many symbols on your map.

===Export Files===
Go to '''File>Export''' (or Ctrl+E) to export your map. Set output file, quality and extend. Read more on the '''[[Export Files]]''' page.

[[File:Hint.jpg]] You can't export a PDF, when you are in the '''[[View_Mode|Draft View]]''' mode. Change to the Normal mode.

[[File:Hint.jpg]] Due to color display, we recommend you to always create a PDF first out of OCAD and print this PDF afterwards. OCAD works with CMYK Colors and they will only be displayed correctly this way. What you see on your screen are RGB-Colors from the Windows Graphics Device Interface (GDI). When you print maps directly out of OCAD, OCAD converts the CMYK values first in RGB values and your printer driver back to CMYK values. This way it may come to changes in the color values.

[[File:ColorDisplay.png|800px]]

==Tipps and Tricks==
*Create a '''[[Map#Create_Map_Grid|Map Grid]]''' and set e.g. to 10m to get a be better sense of distance in the terrain.
*[[Tips_with_Keyboard_and_Mouse|Tips with Keyboard and Mouse]] to optimize your drawing and editing skills in OCAD.
*Read '''[[Copy_from_Map_to_Map|here]]''' how to copy objects or symbols from one map to another map or how to create a own Symbol Set.

GPS

2023-02-20T11:57:41Z

GRS: /* Example: Connection of rugged tablet and Garmin GLO */

[[File:RealTimeGPS.PNG]]
==Real Time GPS [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''GPS''' menu for mobile mapping with GPS. The GPS device must be connected to the computer via the COM interface with Bluetooth. 

[[File:Hint.jpg|hint]] If your GPS device is connected via an USB port or an internal GPS cannot be connected via Windows Location API, please install a software like '''[https://gpsgate.com/products/gpsgate_client GpsGate Splitter]''' to transfer the data to a virtual COM port (''Add Output -> Virtual COM port / NMEA filter'').

[[File:Hint.jpg|hint]] All COM ports that are listed in the Windows registry key ''HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM'' are available in OCAD.

===Real Time GPS Settings===
When you choose the '''Real Time GPS''' command from the '''GPS''' menu, the '''Real Time GPS Settings''' dialog appears.

[[File:RealTimeGpsSettings.png]]
====Connection Settings====
There are two Connection Settings:

=====COM=====

Choose this option to connect your GPS device with a COM port. Garmin devices typically use COM port 4 or 5.
# '''Port:''' Choose the COM port where the GPS device is connected. The GPS device must send the '''[https://en.wikipedia.org/wiki/NMEA_0183 NMEA 0183 Format]'''. 
# '''Baud rate:''' Choose the baud rate the serial port. NMEA 0183 defines 4800 bps but some devices may send data at a different speed. 
# '''Test:''' Click the '''Test''' button to open the '''[[GPS#Test GPS|Test GPS]]''' dialog box. The NMEA messages received from the GPS device are displayed there and you can verify the connection of the GPS device. Read more about this dialog in the '''[[GPS#Test GPS|Test GPS]]''' article on this page.

[[File:Hint.jpg]] In Windows, go to ''Settings > Bluetooth & Other devices > More Bluetooth Settings'' to see which COM ports your computer are using. OCAD uses the outgoing COM port of the connected device. 
[[File:Hint.jpg]] You can use an app (we tested ''Share GPS'') and connect your '''smarphone''' via bluetooth with the computer/tablet. After that, set up the connection via COM interface.

=====Windows Location API=====

Internal or external GPS devices can be connected using the [https://msdn.microsoft.com/en-us/library/windows/desktop/dd464636%28v=vs.85%29.aspx Windows Location API]. This options is recommended if the Windows computer does not anymore support COM ports.

The '''Location service''' must be activated in the Windows settings. For Windows 10 you can find this option in the '''Privacy''' settings -> '''Location'''. Switch on the '''Location service''' and switch on the app '''App connector'''.

Choose a sensor from the '''sensor list''' and click the '''Test''' button to test the connection settings.
The real time GPS works still in the habitual way.
: [[File:Hint.jpg|hint]] The GPS may needs to be manually activated as a location sensor in the '''Windows settings'''.
: [[File:Hint.jpg|hint]] if no sensor is listed, please use a tool like [[GPS#Real_Time_GPS|GpsGate Splitter]] to transfer the GPS signal to a virtual COM port.

====Requirements====
The following requirements can be given:
* '''DGPS, RTK, Float RTK:''' Check this option to use DGPS, RTK, Float RTK and define if the positions calculated without '''[https://en.wikipedia.org/wiki/DGPS DGPS]''', '''[https://en.wikipedia.org/wiki/Real_Time_Kinematic RTK]''', '''Float RTK''' are '''not saved''' or '''not saved and not shown'''.
: [[File:Hint.jpg|hint]] This option has only an effect if OCAD receives the '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Message]'''. Click the '''[[GPS#Test GPS|Test]]''' button to see what type of message is sent from the device.
* '''Min. 4 satellites:''' Check this option as a kind of precision requirement and define if the positions calculated from less than 4 satellites are '''not saved''' or '''not saved and not shown'''..
: [[File:Hint.jpg|hint]] This option has only an effect if OCAD receives the '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Message]'''. Click the '''[[GPS#Test GPS|Test]]''' button to see what type of message is sent from the device.
* '''HDOP:''' Check this option to define an upper limit for the '''[https://en.wikipedia.org/wiki/Dilution_of_precision_%28GPS%29 HDOP (Horizontal Dilution of Precision)]''' value and define if the positions calculated with a higher HDOP are '''not saved''' or '''not saved and not shown'''..

====Options====
* '''Filter:''' Check this option to activate a filter and specify how many GPS positions are averaged. This results in a more stable position, but the update is slower.
* '''Accuracy circle:''' This option is enabled when the '''Filter''' option is checked. Check this option to show the accuracy circle. This shows the accuracy of the last 5 measurements with a circle around the GPS marker.
* '''Auto scroll (moving map):''' Check this option to move the map automatically with the GPS marker.
* '''Subtract antenna height from Z value:''' Check this option to define a correction for the Z value. The entered value gets subtracted from the measured height value.
*'''GPS Connection tail:''' Check this option to show GPS positions tail. 
- You can also choose the length of the tail. 
- The tail color is the same as the '''[[OCAD_Preferences#Mark|mark color]]''', which can be set in the OCAD Preferences. 
[[File:GpsRealTimeShowTail.png]]

====Coordinate system====
Click the '''Change''' button to change the coordinate system. The '''[[Create_a_New_Map#Coordinate_System|Coordinate System]]''' dialog box appears.

Click the '''Connect''' button to turn on the real time GPS mode. The '''GPS''' box is displayed in the lower right corner if the connection to the GPS device was successful.

Close the '''Real Time GPS Settings''' dialog or click the '''Disconnect''' button to turn off real time GPS.

===Test GPS===
Click the '''Test''' button in the '''Real Time GPS Settings''' dialog to open the '''Test GPS''' dialog.

[[File:Hint.jpg]] Test the GPS connection outside, so your GPS device can receive data. Move around a little bit, so your position gets updated.

[[File:TestGPS.PNG]]

If OCAD receives '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Messages]''', those messages are displayed in the '''Serial data''' field. Characters 4 to 6 show the abbreviation GGA (e.g. $XXGGA...). '''[https://www.gpsinformation.org/dale/nmea.htm#RMC RMC Messages]''' are displayed if OCAD does not receive any GGA messages. RMC messages contain no information about DGPS and the number of satellites. However, the position can still be used in OCAD. The serial data box remains empty, if the GPS device is sending neither of the two messages or if there is a connection problem. Check that you have selected the right port in the '''Real Time GPS Settings''' dialog box and that the GPS device is connected correctly to the PC.

'''GGA message example:'''
$GPGGA,092750.000,5321.6802,N,00630.3372,W,1,8,1.03,61.7,M,55.2,M,,*76
'''RMC message example:'''
$GPRMC,092750.000,A,5321.6802,N,00630.3372,W,0.02,31.66,280511,,,A*43

OCAD takes the serial data apart and displays it in a bit more user-friendly view below the '''Serial data''' box.

=== Mapping with Real Time GPS ===

The '''GPS''' box is displayed in the lower right corner if OCAD is successfully connected to a GPS device.

[[File:RealTimeGPSBox.PNG]]

The following information is given in this box:
* '''Easting:''' In this field the easting value of the coordinate is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''Northing:''' In this field the northing value of the coordinate is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''Height:''' In this field the height is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''DGPS:''' A green or red dot shows if a '''[https://en.wikipedia.org/wiki/Differential_GPS DGPS]''' signal is received.
* '''Satellites:''' In this field the number of received satellites is displayed. A Red number means that the requirements defined in the Real Time GPS Settings are not fulfilled.
* '''HDOP:''' The '''[https://en.wikipedia.org/wiki/HDOP HDOP (Horizontal Dilution of Precision)]''' is displayed in this field. HDOP is a quality indicator for the position of the useable satellites on the local sky. A Red number means that the requirements defined in the Real Time GPS Settings are not fulfilled.
* '''Precision (x Val):''' In this field the accuracy (root mean square) of specified number of the last measurements is displayed. The '''Filter length''' can be specified in the '''[[GPS#Options|Real Time GPS Settings]]''' dialog.

Below the information part of the box, there are several icons:
: [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''': Click this icon to create an OCAD object with the receiving GPS information. A symbol must be selected. Choose a point symbol and click the '''Start GPS Measurement''' icon to create an object at the position of the GPS marker. If a line or area symbol is selected, OCAD starts with the measurement and draws a vertice for every recieved position. The object is represented with a thin black line.
: [[File:Icon_PauseGPSMeasurement.PNG]] '''Pause GPS Measurement''': Click this icon to interrupt the GPS measurement without finishing the object. Click the icon again to continue with the measurement.
: [[File:Icon_StopGPSMeasurement.PNG]] ''' Stop GPS Measurement''': Click this icon to finish the line or area object. The object is displayed with the assigned symbol.
: [[File:Icon_FindGPSMarker.PNG]] '''Find GPS Marker''': Click this icon to move the view to the GPS marker. Enable the '''[[GPS#Options|Auto Scroll]]''' option to always move the view, when the GPS marker is leaving the current view.
: [[File:Icon_GPSFilter.PNG]] '''Filter''': Turn on or off the filter by clicking this icon. The filter can be adjusted in the '''[[GPS#Options|Real Time GPS Settings]]''' dialog.
: [[File:Icon_AccuracyCircle.PNG]] '''Accuracy Circle:''' Turn on or off the accuracy circle by clicking this icon. This shows the accuracy of the last 5 measurements with a circle around the GPS marker. This option is only available when the '''Filter''' is enabled.
: [[File:SelectVertexType.png]] '''Select Vertex Type''': In this dropdown list you can select between two types of '''[[Vertices]]''':
:: Choose the '''Normal Vertex''' option when a point should be added to the object for every position received from the GPS device.
:: Choose the '''Corner Vertex''' option when a position should be manually added to the object by clicking the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' button. This option is typically used to draw objects with straight parts and corners like a fence. If a point or text object is selected, the vertex type cannot be changed.
: [[File:Icon_AddGPSPositionToCalculateAverage.PNG]] '''Add GPS Position to Calculate Average''': Click this button for every position you want include into an average calculation. The number of added positions is shown in the button hint. Click the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' icon to create the object at the calculated average position. This function is only available when a point symbol is selected. This is especially useful when the GPS position of an uncrossable feature (e.g. small house, deep hole, huge tree etc.) is to be measured. Some points around the feature have to be recorded and by clicking the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' icon, the average point can be found.
: [[File:ShowTail.png]] '''Show Tail''':Click this buttom to show the GPS tail or not.
: [[File:Icon_OpenRealTimeGPSSettings.PNG]] '''Open Real Time GPS Settings''': This icon opens the '''[[GPS#Real Time GPS Settings|Real Time GPS Settings]]''' dialog box.

[[File:Hint.jpg|hint]] The GPS cursor is drawn with the mark color. Change the '''[[OCAD_Preferences#Mark|Mark Color]]''' in the '''Drawing and Editing''' part of the '''[[OCAD Preferences]]'''. 
[[File:Hint.jpg|hint]] Cold temperatures can shorten the runtime of the GPS battery. Sometimes it helps to warm up the GPS device for a few minutes. 
[[File:GpsRealTimeThickerCursor.png]]

===Example: Connection of tablet SURFACE and Garmin GLO===
Connection of tablet SURFACE with OS Windows 10 and OCAD Orienteering subscription and Garmin GLO.

#First of all, turn the tablet Bluetooth on.
#Turn the GNSS device on and open the Bluetooth settings on the tablet.
#Find and select the Garmin GLO GNSS and click "Pair the device".
#After pairing, connect the device.
#Wait until the Garmin GLO's green light is glowing and not flashing.
#Open OCAD with a georeferenced map.
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Select the port (try to test different ports to find which the device is connected to, it depends on the GPS port manager) and connect the GNSS.
#You should see a marker at your position.
#Make sure that the coordinate system of the map is the same as the GNSS coordinate system (can be adjusted in "Real-time GPS" options).

===Example: Connection of a notebook and Navilock BT-821G===
Connection of a notebook with OS Windows 10 and OCAD Orienteering subscription and Navilock BT-821G Bluetooth GNSS Receiver MT3333.

#First of all, turn on Navilock BT – 821G and wait when recognizes satellites.
#On your notebook, go to the Device Manager and turn Bluetooth on.
#:-Pair the device and connect BT – GPS – 396371.
#:-for a pairing is necessary to enter a code 0000 (Navilock recommendation).
#:-after entering a code, a connection is done.
#another Bluetooth Settings:
#:-view assigned COM port - for BT - 821G two ports one output and one input (it is from the point of view of connected device).
#Open OCAD with a georeferenced map.
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Select the port, baud rate = 4800 bps (it worked even with selected higher bps speed).
#You should see a marker at your position.
#Click the Test button in the Real Time GPS Settings dialog to open the Test GPS dialog.

===Example: Connection of rugged tablet and Garmin GLO===
Connection of rugged tablet with OS Windows and OCAD Orienteering subscription and Garmin GLO.

#Garmin GLO is predetermined to connect to the computer's COM3 port with a baud rate of 4800 bps.
#You should switch on the GLO before starting up OCAD, otherwise the connection most often fails, so make sure to do that first.
#Next open OCAD.
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Make sure you select the correct COM port and baud rate.
#Finally, make sure you've selected the correct reference system for where you'll be working.

==Import Data from GPS Device [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
This function is obsolete! If you want to import GPS data from GPS devices, import the waypoints and tracks with the corresponding software of the GPS device to the computer. Then use the '''[[GPS#Import from File|Import from File]]''' function in OCAD. As an alternative, for fieldwork, use the '''[[GPS#Real Time GPS|Real Time GPS]]''' function.

Choose this command to import tracks or waypoints from a '''GPS Garmin eTrex''' device. The GPS device must be connected to the PC with a serial data cable or Bluetooth.

* '''GPS:''' In this field the information about the GPS device is displayed.
* '''Status:''' In this field the status between OCAD and GPS is displayed.

'''Connection'''
* '''Connect GPS:''' Click this button to connect OCAD with the GPS device. After a successful connection the GPS information and the status are displayed.
* '''Settings:''' Click this button to change the GPS settings. The '''Import from GPS Settings''' dialog is displayed.

'''GPS data'''
* '''Get waypoints:''' Click this button to load all waypoints. Each waypoint is displayed with in a row in the GPS data field.
* '''Get tracks:''' Click this button to download all tracks. Each track is displayed with in a row in the GPS data field. Only the start point is displayed.
[[File:Hint.jpg|hint]] This command can take several minutes!

'''OCAD objects'''
* '''Set labels:''' Check this option to create also text objects with the name of the waypoints and tracks.
* '''CRT:''' Use a '''[[Cross Reference Table]]''' to assign symbols to the waypoints and tracks. OCAD creates '''[[Unsymbolized Objects]]''' if no '''[[Cross Reference Table]]''' is selected.
: Each line of the cross reference table contains the OCAD symbol number and the Garmin symbol name.
: Example of a cross reference table:
535.0 waypoint dot
536.0 campground symbol
540.0 scenic area symbol
* '''Create:''' Select the waypoints and tracks in the GPS data field and click this button to create OCAD objects from the selected GPS data. 
[[File:Hint.jpg|hint]] A popup menu appears when clicking the list with the GPS data with the right mouse button. In this popup menu you have the option to '''Select all''', '''Unselect all''' and '''Clear list'''. With the '''Clear list''' command all waypoints and tracks are removed. In addition, you can '''Make an OCAD object'''. By clicking this command, an OCAD object of the selected track or waypoint is created.

===Import from GPS Settings===
In this dialog box you can make the setting for the GPS data import. Verify also your settings on the GPS device (e.g. data format: GARMIN)!

* '''Port:''' Choose the port where the GPS device is connected.
* '''Speed data import:''' Choose the speed of the serial port. Garmin defines 9600 bps.
* '''Coordinate system:''' Click the '''Change''' button to select or change the coordinate system. The '''[[Create a New Map#Coordinate System|Coordinate System]]''' dialog box appears.

==Import from File [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command from the '''GPS''' menu to import a GPS data file to the current map. The '''Load GPS data from files''' dialog box is displayed. Initially all importable GPS data files are listed. The following file types can be imported:
* GPX files
* FRWD files
* NMEA files
The '''Import from File''' dialog appears, where all available waypoints and tracks from the imported file are listed. There are several options in the '''OCAD objects''' part of the dialog:

* '''Set label:''' Check this option to create also text objects with the name of the waypoints and tracks.
* '''Assign Symbols:''' Check this option to assign a specified symbol to the imported objects. Otherwise OCAD will create '''[[Unsymbolized Objects]]'''.
[[File:Hint.jpg|hint]] A popup menu appears when clicking the list with the GPS data with the right mouse button. In this popup menu you have the option to '''Select all''', '''Unselect all''' and '''Clear list'''. With the '''Clear list''' command all waypoints and tracks are removed. In addition, you can '''Make an OCAD object'''. By clicking this command, an OCAD object of the selected track or waypoint is created.

Click the '''Import''' button to import all selected tracks or waypoints in the list.

===GPS Map Offset===
This dialog box appears if the GPS coordinates are out of the maximum map size. Adjust the following parameters:

* '''Coordinate system''' If you work with GPS you must select a coordinate system. Click the '''Change''' button to select or change the coordinate system. The '''[[Create_a_New_Map#Coordinate_System|Coordinate System]]''' dialog box appears.
* '''Offset''' Choose here whether you want to change the OCAD real world coordinates or to keep the existing ones.
* '''New offset:''' Choose this option if no real world coordinates are defined for the map. OCAD already proposes reasonable values. You can leave theme unchanged.
* '''Existing offset and angle:''' Choose this option if the map already has real world coordinates and you want to fit the imported objects to the existing coordinates.

== Laser Rangefinder [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Read more about using the '''"TruPulse 360/360B" Laser Rangefinder''' on the '''[[Laser Rangefinder]]''' page

----
Back to [[Main Page]]

GPS

2023-02-20T11:57:28Z

GRS: /* Example: Connection of a notebook and Navilock BT-821G */

[[File:RealTimeGPS.PNG]]
==Real Time GPS [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''GPS''' menu for mobile mapping with GPS. The GPS device must be connected to the computer via the COM interface with Bluetooth. 

[[File:Hint.jpg|hint]] If your GPS device is connected via an USB port or an internal GPS cannot be connected via Windows Location API, please install a software like '''[https://gpsgate.com/products/gpsgate_client GpsGate Splitter]''' to transfer the data to a virtual COM port (''Add Output -> Virtual COM port / NMEA filter'').

[[File:Hint.jpg|hint]] All COM ports that are listed in the Windows registry key ''HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM'' are available in OCAD.

===Real Time GPS Settings===
When you choose the '''Real Time GPS''' command from the '''GPS''' menu, the '''Real Time GPS Settings''' dialog appears.

[[File:RealTimeGpsSettings.png]]
====Connection Settings====
There are two Connection Settings:

=====COM=====

Choose this option to connect your GPS device with a COM port. Garmin devices typically use COM port 4 or 5.
# '''Port:''' Choose the COM port where the GPS device is connected. The GPS device must send the '''[https://en.wikipedia.org/wiki/NMEA_0183 NMEA 0183 Format]'''. 
# '''Baud rate:''' Choose the baud rate the serial port. NMEA 0183 defines 4800 bps but some devices may send data at a different speed. 
# '''Test:''' Click the '''Test''' button to open the '''[[GPS#Test GPS|Test GPS]]''' dialog box. The NMEA messages received from the GPS device are displayed there and you can verify the connection of the GPS device. Read more about this dialog in the '''[[GPS#Test GPS|Test GPS]]''' article on this page.

[[File:Hint.jpg]] In Windows, go to ''Settings > Bluetooth & Other devices > More Bluetooth Settings'' to see which COM ports your computer are using. OCAD uses the outgoing COM port of the connected device. 
[[File:Hint.jpg]] You can use an app (we tested ''Share GPS'') and connect your '''smarphone''' via bluetooth with the computer/tablet. After that, set up the connection via COM interface.

=====Windows Location API=====

Internal or external GPS devices can be connected using the [https://msdn.microsoft.com/en-us/library/windows/desktop/dd464636%28v=vs.85%29.aspx Windows Location API]. This options is recommended if the Windows computer does not anymore support COM ports.

The '''Location service''' must be activated in the Windows settings. For Windows 10 you can find this option in the '''Privacy''' settings -> '''Location'''. Switch on the '''Location service''' and switch on the app '''App connector'''.

Choose a sensor from the '''sensor list''' and click the '''Test''' button to test the connection settings.
The real time GPS works still in the habitual way.
: [[File:Hint.jpg|hint]] The GPS may needs to be manually activated as a location sensor in the '''Windows settings'''.
: [[File:Hint.jpg|hint]] if no sensor is listed, please use a tool like [[GPS#Real_Time_GPS|GpsGate Splitter]] to transfer the GPS signal to a virtual COM port.

====Requirements====
The following requirements can be given:
* '''DGPS, RTK, Float RTK:''' Check this option to use DGPS, RTK, Float RTK and define if the positions calculated without '''[https://en.wikipedia.org/wiki/DGPS DGPS]''', '''[https://en.wikipedia.org/wiki/Real_Time_Kinematic RTK]''', '''Float RTK''' are '''not saved''' or '''not saved and not shown'''.
: [[File:Hint.jpg|hint]] This option has only an effect if OCAD receives the '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Message]'''. Click the '''[[GPS#Test GPS|Test]]''' button to see what type of message is sent from the device.
* '''Min. 4 satellites:''' Check this option as a kind of precision requirement and define if the positions calculated from less than 4 satellites are '''not saved''' or '''not saved and not shown'''..
: [[File:Hint.jpg|hint]] This option has only an effect if OCAD receives the '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Message]'''. Click the '''[[GPS#Test GPS|Test]]''' button to see what type of message is sent from the device.
* '''HDOP:''' Check this option to define an upper limit for the '''[https://en.wikipedia.org/wiki/Dilution_of_precision_%28GPS%29 HDOP (Horizontal Dilution of Precision)]''' value and define if the positions calculated with a higher HDOP are '''not saved''' or '''not saved and not shown'''..

====Options====
* '''Filter:''' Check this option to activate a filter and specify how many GPS positions are averaged. This results in a more stable position, but the update is slower.
* '''Accuracy circle:''' This option is enabled when the '''Filter''' option is checked. Check this option to show the accuracy circle. This shows the accuracy of the last 5 measurements with a circle around the GPS marker.
* '''Auto scroll (moving map):''' Check this option to move the map automatically with the GPS marker.
* '''Subtract antenna height from Z value:''' Check this option to define a correction for the Z value. The entered value gets subtracted from the measured height value.
*'''GPS Connection tail:''' Check this option to show GPS positions tail. 
- You can also choose the length of the tail. 
- The tail color is the same as the '''[[OCAD_Preferences#Mark|mark color]]''', which can be set in the OCAD Preferences. 
[[File:GpsRealTimeShowTail.png]]

====Coordinate system====
Click the '''Change''' button to change the coordinate system. The '''[[Create_a_New_Map#Coordinate_System|Coordinate System]]''' dialog box appears.

Click the '''Connect''' button to turn on the real time GPS mode. The '''GPS''' box is displayed in the lower right corner if the connection to the GPS device was successful.

Close the '''Real Time GPS Settings''' dialog or click the '''Disconnect''' button to turn off real time GPS.

===Test GPS===
Click the '''Test''' button in the '''Real Time GPS Settings''' dialog to open the '''Test GPS''' dialog.

[[File:Hint.jpg]] Test the GPS connection outside, so your GPS device can receive data. Move around a little bit, so your position gets updated.

[[File:TestGPS.PNG]]

If OCAD receives '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Messages]''', those messages are displayed in the '''Serial data''' field. Characters 4 to 6 show the abbreviation GGA (e.g. $XXGGA...). '''[https://www.gpsinformation.org/dale/nmea.htm#RMC RMC Messages]''' are displayed if OCAD does not receive any GGA messages. RMC messages contain no information about DGPS and the number of satellites. However, the position can still be used in OCAD. The serial data box remains empty, if the GPS device is sending neither of the two messages or if there is a connection problem. Check that you have selected the right port in the '''Real Time GPS Settings''' dialog box and that the GPS device is connected correctly to the PC.

'''GGA message example:'''
$GPGGA,092750.000,5321.6802,N,00630.3372,W,1,8,1.03,61.7,M,55.2,M,,*76
'''RMC message example:'''
$GPRMC,092750.000,A,5321.6802,N,00630.3372,W,0.02,31.66,280511,,,A*43

OCAD takes the serial data apart and displays it in a bit more user-friendly view below the '''Serial data''' box.

=== Mapping with Real Time GPS ===

The '''GPS''' box is displayed in the lower right corner if OCAD is successfully connected to a GPS device.

[[File:RealTimeGPSBox.PNG]]

The following information is given in this box:
* '''Easting:''' In this field the easting value of the coordinate is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''Northing:''' In this field the northing value of the coordinate is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''Height:''' In this field the height is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''DGPS:''' A green or red dot shows if a '''[https://en.wikipedia.org/wiki/Differential_GPS DGPS]''' signal is received.
* '''Satellites:''' In this field the number of received satellites is displayed. A Red number means that the requirements defined in the Real Time GPS Settings are not fulfilled.
* '''HDOP:''' The '''[https://en.wikipedia.org/wiki/HDOP HDOP (Horizontal Dilution of Precision)]''' is displayed in this field. HDOP is a quality indicator for the position of the useable satellites on the local sky. A Red number means that the requirements defined in the Real Time GPS Settings are not fulfilled.
* '''Precision (x Val):''' In this field the accuracy (root mean square) of specified number of the last measurements is displayed. The '''Filter length''' can be specified in the '''[[GPS#Options|Real Time GPS Settings]]''' dialog.

Below the information part of the box, there are several icons:
: [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''': Click this icon to create an OCAD object with the receiving GPS information. A symbol must be selected. Choose a point symbol and click the '''Start GPS Measurement''' icon to create an object at the position of the GPS marker. If a line or area symbol is selected, OCAD starts with the measurement and draws a vertice for every recieved position. The object is represented with a thin black line.
: [[File:Icon_PauseGPSMeasurement.PNG]] '''Pause GPS Measurement''': Click this icon to interrupt the GPS measurement without finishing the object. Click the icon again to continue with the measurement.
: [[File:Icon_StopGPSMeasurement.PNG]] ''' Stop GPS Measurement''': Click this icon to finish the line or area object. The object is displayed with the assigned symbol.
: [[File:Icon_FindGPSMarker.PNG]] '''Find GPS Marker''': Click this icon to move the view to the GPS marker. Enable the '''[[GPS#Options|Auto Scroll]]''' option to always move the view, when the GPS marker is leaving the current view.
: [[File:Icon_GPSFilter.PNG]] '''Filter''': Turn on or off the filter by clicking this icon. The filter can be adjusted in the '''[[GPS#Options|Real Time GPS Settings]]''' dialog.
: [[File:Icon_AccuracyCircle.PNG]] '''Accuracy Circle:''' Turn on or off the accuracy circle by clicking this icon. This shows the accuracy of the last 5 measurements with a circle around the GPS marker. This option is only available when the '''Filter''' is enabled.
: [[File:SelectVertexType.png]] '''Select Vertex Type''': In this dropdown list you can select between two types of '''[[Vertices]]''':
:: Choose the '''Normal Vertex''' option when a point should be added to the object for every position received from the GPS device.
:: Choose the '''Corner Vertex''' option when a position should be manually added to the object by clicking the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' button. This option is typically used to draw objects with straight parts and corners like a fence. If a point or text object is selected, the vertex type cannot be changed.
: [[File:Icon_AddGPSPositionToCalculateAverage.PNG]] '''Add GPS Position to Calculate Average''': Click this button for every position you want include into an average calculation. The number of added positions is shown in the button hint. Click the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' icon to create the object at the calculated average position. This function is only available when a point symbol is selected. This is especially useful when the GPS position of an uncrossable feature (e.g. small house, deep hole, huge tree etc.) is to be measured. Some points around the feature have to be recorded and by clicking the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' icon, the average point can be found.
: [[File:ShowTail.png]] '''Show Tail''':Click this buttom to show the GPS tail or not.
: [[File:Icon_OpenRealTimeGPSSettings.PNG]] '''Open Real Time GPS Settings''': This icon opens the '''[[GPS#Real Time GPS Settings|Real Time GPS Settings]]''' dialog box.

[[File:Hint.jpg|hint]] The GPS cursor is drawn with the mark color. Change the '''[[OCAD_Preferences#Mark|Mark Color]]''' in the '''Drawing and Editing''' part of the '''[[OCAD Preferences]]'''. 
[[File:Hint.jpg|hint]] Cold temperatures can shorten the runtime of the GPS battery. Sometimes it helps to warm up the GPS device for a few minutes. 
[[File:GpsRealTimeThickerCursor.png]]

===Example: Connection of tablet SURFACE and Garmin GLO===
Connection of tablet SURFACE with OS Windows 10 and OCAD Orienteering subscription and Garmin GLO.

#First of all, turn the tablet Bluetooth on.
#Turn the GNSS device on and open the Bluetooth settings on the tablet.
#Find and select the Garmin GLO GNSS and click "Pair the device".
#After pairing, connect the device.
#Wait until the Garmin GLO's green light is glowing and not flashing.
#Open OCAD with a georeferenced map.
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Select the port (try to test different ports to find which the device is connected to, it depends on the GPS port manager) and connect the GNSS.
#You should see a marker at your position.
#Make sure that the coordinate system of the map is the same as the GNSS coordinate system (can be adjusted in "Real-time GPS" options).

===Example: Connection of a notebook and Navilock BT-821G===
Connection of a notebook with OS Windows 10 and OCAD Orienteering subscription and Navilock BT-821G Bluetooth GNSS Receiver MT3333.

#First of all, turn on Navilock BT – 821G and wait when recognizes satellites.
#On your notebook, go to the Device Manager and turn Bluetooth on.
#:-Pair the device and connect BT – GPS – 396371.
#:-for a pairing is necessary to enter a code 0000 (Navilock recommendation).
#:-after entering a code, a connection is done.
#another Bluetooth Settings:
#:-view assigned COM port - for BT - 821G two ports one output and one input (it is from the point of view of connected device).
#Open OCAD with a georeferenced map.
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Select the port, baud rate = 4800 bps (it worked even with selected higher bps speed).
#You should see a marker at your position.
#Click the Test button in the Real Time GPS Settings dialog to open the Test GPS dialog.

===Example: Connection of rugged tablet and Garmin GLO===
Connection of rugged tablet with OS Windows and OCAD Orienteering subscription and Garmin GLO.

#Garmin GLO is predetermined to connect to the computer's COM3 port with a baud rate of 4800 bps.
#You should switch on the GLO before starting up OCAD, otherwise the connection most often fails, so make sure to do that first.
#Next open OCAD (both versions 32-bit and 64-bit version are ready).
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Make sure you select the correct COM port and baud rate.
#Finally, make sure you've selected the correct reference system for where you'll be working.

==Import Data from GPS Device [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
This function is obsolete! If you want to import GPS data from GPS devices, import the waypoints and tracks with the corresponding software of the GPS device to the computer. Then use the '''[[GPS#Import from File|Import from File]]''' function in OCAD. As an alternative, for fieldwork, use the '''[[GPS#Real Time GPS|Real Time GPS]]''' function.

Choose this command to import tracks or waypoints from a '''GPS Garmin eTrex''' device. The GPS device must be connected to the PC with a serial data cable or Bluetooth.

* '''GPS:''' In this field the information about the GPS device is displayed.
* '''Status:''' In this field the status between OCAD and GPS is displayed.

'''Connection'''
* '''Connect GPS:''' Click this button to connect OCAD with the GPS device. After a successful connection the GPS information and the status are displayed.
* '''Settings:''' Click this button to change the GPS settings. The '''Import from GPS Settings''' dialog is displayed.

'''GPS data'''
* '''Get waypoints:''' Click this button to load all waypoints. Each waypoint is displayed with in a row in the GPS data field.
* '''Get tracks:''' Click this button to download all tracks. Each track is displayed with in a row in the GPS data field. Only the start point is displayed.
[[File:Hint.jpg|hint]] This command can take several minutes!

'''OCAD objects'''
* '''Set labels:''' Check this option to create also text objects with the name of the waypoints and tracks.
* '''CRT:''' Use a '''[[Cross Reference Table]]''' to assign symbols to the waypoints and tracks. OCAD creates '''[[Unsymbolized Objects]]''' if no '''[[Cross Reference Table]]''' is selected.
: Each line of the cross reference table contains the OCAD symbol number and the Garmin symbol name.
: Example of a cross reference table:
535.0 waypoint dot
536.0 campground symbol
540.0 scenic area symbol
* '''Create:''' Select the waypoints and tracks in the GPS data field and click this button to create OCAD objects from the selected GPS data. 
[[File:Hint.jpg|hint]] A popup menu appears when clicking the list with the GPS data with the right mouse button. In this popup menu you have the option to '''Select all''', '''Unselect all''' and '''Clear list'''. With the '''Clear list''' command all waypoints and tracks are removed. In addition, you can '''Make an OCAD object'''. By clicking this command, an OCAD object of the selected track or waypoint is created.

===Import from GPS Settings===
In this dialog box you can make the setting for the GPS data import. Verify also your settings on the GPS device (e.g. data format: GARMIN)!

* '''Port:''' Choose the port where the GPS device is connected.
* '''Speed data import:''' Choose the speed of the serial port. Garmin defines 9600 bps.
* '''Coordinate system:''' Click the '''Change''' button to select or change the coordinate system. The '''[[Create a New Map#Coordinate System|Coordinate System]]''' dialog box appears.

==Import from File [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command from the '''GPS''' menu to import a GPS data file to the current map. The '''Load GPS data from files''' dialog box is displayed. Initially all importable GPS data files are listed. The following file types can be imported:
* GPX files
* FRWD files
* NMEA files
The '''Import from File''' dialog appears, where all available waypoints and tracks from the imported file are listed. There are several options in the '''OCAD objects''' part of the dialog:

* '''Set label:''' Check this option to create also text objects with the name of the waypoints and tracks.
* '''Assign Symbols:''' Check this option to assign a specified symbol to the imported objects. Otherwise OCAD will create '''[[Unsymbolized Objects]]'''.
[[File:Hint.jpg|hint]] A popup menu appears when clicking the list with the GPS data with the right mouse button. In this popup menu you have the option to '''Select all''', '''Unselect all''' and '''Clear list'''. With the '''Clear list''' command all waypoints and tracks are removed. In addition, you can '''Make an OCAD object'''. By clicking this command, an OCAD object of the selected track or waypoint is created.

Click the '''Import''' button to import all selected tracks or waypoints in the list.

===GPS Map Offset===
This dialog box appears if the GPS coordinates are out of the maximum map size. Adjust the following parameters:

* '''Coordinate system''' If you work with GPS you must select a coordinate system. Click the '''Change''' button to select or change the coordinate system. The '''[[Create_a_New_Map#Coordinate_System|Coordinate System]]''' dialog box appears.
* '''Offset''' Choose here whether you want to change the OCAD real world coordinates or to keep the existing ones.
* '''New offset:''' Choose this option if no real world coordinates are defined for the map. OCAD already proposes reasonable values. You can leave theme unchanged.
* '''Existing offset and angle:''' Choose this option if the map already has real world coordinates and you want to fit the imported objects to the existing coordinates.

== Laser Rangefinder [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Read more about using the '''"TruPulse 360/360B" Laser Rangefinder''' on the '''[[Laser Rangefinder]]''' page

----
Back to [[Main Page]]

GPS

2023-02-20T11:57:17Z

GRS: /* Example: Connection of tablet SURFACE and Garmin GLO */

[[File:RealTimeGPS.PNG]]
==Real Time GPS [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''GPS''' menu for mobile mapping with GPS. The GPS device must be connected to the computer via the COM interface with Bluetooth. 

[[File:Hint.jpg|hint]] If your GPS device is connected via an USB port or an internal GPS cannot be connected via Windows Location API, please install a software like '''[https://gpsgate.com/products/gpsgate_client GpsGate Splitter]''' to transfer the data to a virtual COM port (''Add Output -> Virtual COM port / NMEA filter'').

[[File:Hint.jpg|hint]] All COM ports that are listed in the Windows registry key ''HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM'' are available in OCAD.

===Real Time GPS Settings===
When you choose the '''Real Time GPS''' command from the '''GPS''' menu, the '''Real Time GPS Settings''' dialog appears.

[[File:RealTimeGpsSettings.png]]
====Connection Settings====
There are two Connection Settings:

=====COM=====

Choose this option to connect your GPS device with a COM port. Garmin devices typically use COM port 4 or 5.
# '''Port:''' Choose the COM port where the GPS device is connected. The GPS device must send the '''[https://en.wikipedia.org/wiki/NMEA_0183 NMEA 0183 Format]'''. 
# '''Baud rate:''' Choose the baud rate the serial port. NMEA 0183 defines 4800 bps but some devices may send data at a different speed. 
# '''Test:''' Click the '''Test''' button to open the '''[[GPS#Test GPS|Test GPS]]''' dialog box. The NMEA messages received from the GPS device are displayed there and you can verify the connection of the GPS device. Read more about this dialog in the '''[[GPS#Test GPS|Test GPS]]''' article on this page.

[[File:Hint.jpg]] In Windows, go to ''Settings > Bluetooth & Other devices > More Bluetooth Settings'' to see which COM ports your computer are using. OCAD uses the outgoing COM port of the connected device. 
[[File:Hint.jpg]] You can use an app (we tested ''Share GPS'') and connect your '''smarphone''' via bluetooth with the computer/tablet. After that, set up the connection via COM interface.

=====Windows Location API=====

Internal or external GPS devices can be connected using the [https://msdn.microsoft.com/en-us/library/windows/desktop/dd464636%28v=vs.85%29.aspx Windows Location API]. This options is recommended if the Windows computer does not anymore support COM ports.

The '''Location service''' must be activated in the Windows settings. For Windows 10 you can find this option in the '''Privacy''' settings -> '''Location'''. Switch on the '''Location service''' and switch on the app '''App connector'''.

Choose a sensor from the '''sensor list''' and click the '''Test''' button to test the connection settings.
The real time GPS works still in the habitual way.
: [[File:Hint.jpg|hint]] The GPS may needs to be manually activated as a location sensor in the '''Windows settings'''.
: [[File:Hint.jpg|hint]] if no sensor is listed, please use a tool like [[GPS#Real_Time_GPS|GpsGate Splitter]] to transfer the GPS signal to a virtual COM port.

====Requirements====
The following requirements can be given:
* '''DGPS, RTK, Float RTK:''' Check this option to use DGPS, RTK, Float RTK and define if the positions calculated without '''[https://en.wikipedia.org/wiki/DGPS DGPS]''', '''[https://en.wikipedia.org/wiki/Real_Time_Kinematic RTK]''', '''Float RTK''' are '''not saved''' or '''not saved and not shown'''.
: [[File:Hint.jpg|hint]] This option has only an effect if OCAD receives the '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Message]'''. Click the '''[[GPS#Test GPS|Test]]''' button to see what type of message is sent from the device.
* '''Min. 4 satellites:''' Check this option as a kind of precision requirement and define if the positions calculated from less than 4 satellites are '''not saved''' or '''not saved and not shown'''..
: [[File:Hint.jpg|hint]] This option has only an effect if OCAD receives the '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Message]'''. Click the '''[[GPS#Test GPS|Test]]''' button to see what type of message is sent from the device.
* '''HDOP:''' Check this option to define an upper limit for the '''[https://en.wikipedia.org/wiki/Dilution_of_precision_%28GPS%29 HDOP (Horizontal Dilution of Precision)]''' value and define if the positions calculated with a higher HDOP are '''not saved''' or '''not saved and not shown'''..

====Options====
* '''Filter:''' Check this option to activate a filter and specify how many GPS positions are averaged. This results in a more stable position, but the update is slower.
* '''Accuracy circle:''' This option is enabled when the '''Filter''' option is checked. Check this option to show the accuracy circle. This shows the accuracy of the last 5 measurements with a circle around the GPS marker.
* '''Auto scroll (moving map):''' Check this option to move the map automatically with the GPS marker.
* '''Subtract antenna height from Z value:''' Check this option to define a correction for the Z value. The entered value gets subtracted from the measured height value.
*'''GPS Connection tail:''' Check this option to show GPS positions tail. 
- You can also choose the length of the tail. 
- The tail color is the same as the '''[[OCAD_Preferences#Mark|mark color]]''', which can be set in the OCAD Preferences. 
[[File:GpsRealTimeShowTail.png]]

====Coordinate system====
Click the '''Change''' button to change the coordinate system. The '''[[Create_a_New_Map#Coordinate_System|Coordinate System]]''' dialog box appears.

Click the '''Connect''' button to turn on the real time GPS mode. The '''GPS''' box is displayed in the lower right corner if the connection to the GPS device was successful.

Close the '''Real Time GPS Settings''' dialog or click the '''Disconnect''' button to turn off real time GPS.

===Test GPS===
Click the '''Test''' button in the '''Real Time GPS Settings''' dialog to open the '''Test GPS''' dialog.

[[File:Hint.jpg]] Test the GPS connection outside, so your GPS device can receive data. Move around a little bit, so your position gets updated.

[[File:TestGPS.PNG]]

If OCAD receives '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Messages]''', those messages are displayed in the '''Serial data''' field. Characters 4 to 6 show the abbreviation GGA (e.g. $XXGGA...). '''[https://www.gpsinformation.org/dale/nmea.htm#RMC RMC Messages]''' are displayed if OCAD does not receive any GGA messages. RMC messages contain no information about DGPS and the number of satellites. However, the position can still be used in OCAD. The serial data box remains empty, if the GPS device is sending neither of the two messages or if there is a connection problem. Check that you have selected the right port in the '''Real Time GPS Settings''' dialog box and that the GPS device is connected correctly to the PC.

'''GGA message example:'''
$GPGGA,092750.000,5321.6802,N,00630.3372,W,1,8,1.03,61.7,M,55.2,M,,*76
'''RMC message example:'''
$GPRMC,092750.000,A,5321.6802,N,00630.3372,W,0.02,31.66,280511,,,A*43

OCAD takes the serial data apart and displays it in a bit more user-friendly view below the '''Serial data''' box.

=== Mapping with Real Time GPS ===

The '''GPS''' box is displayed in the lower right corner if OCAD is successfully connected to a GPS device.

[[File:RealTimeGPSBox.PNG]]

The following information is given in this box:
* '''Easting:''' In this field the easting value of the coordinate is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''Northing:''' In this field the northing value of the coordinate is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''Height:''' In this field the height is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''DGPS:''' A green or red dot shows if a '''[https://en.wikipedia.org/wiki/Differential_GPS DGPS]''' signal is received.
* '''Satellites:''' In this field the number of received satellites is displayed. A Red number means that the requirements defined in the Real Time GPS Settings are not fulfilled.
* '''HDOP:''' The '''[https://en.wikipedia.org/wiki/HDOP HDOP (Horizontal Dilution of Precision)]''' is displayed in this field. HDOP is a quality indicator for the position of the useable satellites on the local sky. A Red number means that the requirements defined in the Real Time GPS Settings are not fulfilled.
* '''Precision (x Val):''' In this field the accuracy (root mean square) of specified number of the last measurements is displayed. The '''Filter length''' can be specified in the '''[[GPS#Options|Real Time GPS Settings]]''' dialog.

Below the information part of the box, there are several icons:
: [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''': Click this icon to create an OCAD object with the receiving GPS information. A symbol must be selected. Choose a point symbol and click the '''Start GPS Measurement''' icon to create an object at the position of the GPS marker. If a line or area symbol is selected, OCAD starts with the measurement and draws a vertice for every recieved position. The object is represented with a thin black line.
: [[File:Icon_PauseGPSMeasurement.PNG]] '''Pause GPS Measurement''': Click this icon to interrupt the GPS measurement without finishing the object. Click the icon again to continue with the measurement.
: [[File:Icon_StopGPSMeasurement.PNG]] ''' Stop GPS Measurement''': Click this icon to finish the line or area object. The object is displayed with the assigned symbol.
: [[File:Icon_FindGPSMarker.PNG]] '''Find GPS Marker''': Click this icon to move the view to the GPS marker. Enable the '''[[GPS#Options|Auto Scroll]]''' option to always move the view, when the GPS marker is leaving the current view.
: [[File:Icon_GPSFilter.PNG]] '''Filter''': Turn on or off the filter by clicking this icon. The filter can be adjusted in the '''[[GPS#Options|Real Time GPS Settings]]''' dialog.
: [[File:Icon_AccuracyCircle.PNG]] '''Accuracy Circle:''' Turn on or off the accuracy circle by clicking this icon. This shows the accuracy of the last 5 measurements with a circle around the GPS marker. This option is only available when the '''Filter''' is enabled.
: [[File:SelectVertexType.png]] '''Select Vertex Type''': In this dropdown list you can select between two types of '''[[Vertices]]''':
:: Choose the '''Normal Vertex''' option when a point should be added to the object for every position received from the GPS device.
:: Choose the '''Corner Vertex''' option when a position should be manually added to the object by clicking the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' button. This option is typically used to draw objects with straight parts and corners like a fence. If a point or text object is selected, the vertex type cannot be changed.
: [[File:Icon_AddGPSPositionToCalculateAverage.PNG]] '''Add GPS Position to Calculate Average''': Click this button for every position you want include into an average calculation. The number of added positions is shown in the button hint. Click the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' icon to create the object at the calculated average position. This function is only available when a point symbol is selected. This is especially useful when the GPS position of an uncrossable feature (e.g. small house, deep hole, huge tree etc.) is to be measured. Some points around the feature have to be recorded and by clicking the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' icon, the average point can be found.
: [[File:ShowTail.png]] '''Show Tail''':Click this buttom to show the GPS tail or not.
: [[File:Icon_OpenRealTimeGPSSettings.PNG]] '''Open Real Time GPS Settings''': This icon opens the '''[[GPS#Real Time GPS Settings|Real Time GPS Settings]]''' dialog box.

[[File:Hint.jpg|hint]] The GPS cursor is drawn with the mark color. Change the '''[[OCAD_Preferences#Mark|Mark Color]]''' in the '''Drawing and Editing''' part of the '''[[OCAD Preferences]]'''. 
[[File:Hint.jpg|hint]] Cold temperatures can shorten the runtime of the GPS battery. Sometimes it helps to warm up the GPS device for a few minutes. 
[[File:GpsRealTimeThickerCursor.png]]

===Example: Connection of tablet SURFACE and Garmin GLO===
Connection of tablet SURFACE with OS Windows 10 and OCAD Orienteering subscription and Garmin GLO.

#First of all, turn the tablet Bluetooth on.
#Turn the GNSS device on and open the Bluetooth settings on the tablet.
#Find and select the Garmin GLO GNSS and click "Pair the device".
#After pairing, connect the device.
#Wait until the Garmin GLO's green light is glowing and not flashing.
#Open OCAD with a georeferenced map.
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Select the port (try to test different ports to find which the device is connected to, it depends on the GPS port manager) and connect the GNSS.
#You should see a marker at your position.
#Make sure that the coordinate system of the map is the same as the GNSS coordinate system (can be adjusted in "Real-time GPS" options).

===Example: Connection of a notebook and Navilock BT-821G===
Connection of a notebook with OS Windows 10 and OCAD Orienteering subscription and Navilock BT-821G Bluetooth GNSS Receiver MT3333.

#First of all, turn on Navilock BT – 821G and wait when recognizes satellites.
#On your notebook, go to the Device Manager and turn Bluetooth on.
#:-Pair the device and connect BT – GPS – 396371.
#:-for a pairing is necessary to enter a code 0000 (Navilock recommendation).
#:-after entering a code, a connection is done.
#another Bluetooth Settings:
#:-view assigned COM port - for BT - 821G two ports one output and one input (it is from the point of view of connected device).
#Open OCAD (both 32-bit and 64-bit version is ready) with a georeferenced map.
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Select the port, baud rate = 4800 bps (it worked even with selected higher bps speed).
#You should see a marker at your position.
#Click the Test button in the Real Time GPS Settings dialog to open the Test GPS dialog.

===Example: Connection of rugged tablet and Garmin GLO===
Connection of rugged tablet with OS Windows and OCAD Orienteering subscription and Garmin GLO.

#Garmin GLO is predetermined to connect to the computer's COM3 port with a baud rate of 4800 bps.
#You should switch on the GLO before starting up OCAD, otherwise the connection most often fails, so make sure to do that first.
#Next open OCAD (both versions 32-bit and 64-bit version are ready).
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Make sure you select the correct COM port and baud rate.
#Finally, make sure you've selected the correct reference system for where you'll be working.

==Import Data from GPS Device [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
This function is obsolete! If you want to import GPS data from GPS devices, import the waypoints and tracks with the corresponding software of the GPS device to the computer. Then use the '''[[GPS#Import from File|Import from File]]''' function in OCAD. As an alternative, for fieldwork, use the '''[[GPS#Real Time GPS|Real Time GPS]]''' function.

Choose this command to import tracks or waypoints from a '''GPS Garmin eTrex''' device. The GPS device must be connected to the PC with a serial data cable or Bluetooth.

* '''GPS:''' In this field the information about the GPS device is displayed.
* '''Status:''' In this field the status between OCAD and GPS is displayed.

'''Connection'''
* '''Connect GPS:''' Click this button to connect OCAD with the GPS device. After a successful connection the GPS information and the status are displayed.
* '''Settings:''' Click this button to change the GPS settings. The '''Import from GPS Settings''' dialog is displayed.

'''GPS data'''
* '''Get waypoints:''' Click this button to load all waypoints. Each waypoint is displayed with in a row in the GPS data field.
* '''Get tracks:''' Click this button to download all tracks. Each track is displayed with in a row in the GPS data field. Only the start point is displayed.
[[File:Hint.jpg|hint]] This command can take several minutes!

'''OCAD objects'''
* '''Set labels:''' Check this option to create also text objects with the name of the waypoints and tracks.
* '''CRT:''' Use a '''[[Cross Reference Table]]''' to assign symbols to the waypoints and tracks. OCAD creates '''[[Unsymbolized Objects]]''' if no '''[[Cross Reference Table]]''' is selected.
: Each line of the cross reference table contains the OCAD symbol number and the Garmin symbol name.
: Example of a cross reference table:
535.0 waypoint dot
536.0 campground symbol
540.0 scenic area symbol
* '''Create:''' Select the waypoints and tracks in the GPS data field and click this button to create OCAD objects from the selected GPS data. 
[[File:Hint.jpg|hint]] A popup menu appears when clicking the list with the GPS data with the right mouse button. In this popup menu you have the option to '''Select all''', '''Unselect all''' and '''Clear list'''. With the '''Clear list''' command all waypoints and tracks are removed. In addition, you can '''Make an OCAD object'''. By clicking this command, an OCAD object of the selected track or waypoint is created.

===Import from GPS Settings===
In this dialog box you can make the setting for the GPS data import. Verify also your settings on the GPS device (e.g. data format: GARMIN)!

* '''Port:''' Choose the port where the GPS device is connected.
* '''Speed data import:''' Choose the speed of the serial port. Garmin defines 9600 bps.
* '''Coordinate system:''' Click the '''Change''' button to select or change the coordinate system. The '''[[Create a New Map#Coordinate System|Coordinate System]]''' dialog box appears.

==Import from File [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command from the '''GPS''' menu to import a GPS data file to the current map. The '''Load GPS data from files''' dialog box is displayed. Initially all importable GPS data files are listed. The following file types can be imported:
* GPX files
* FRWD files
* NMEA files
The '''Import from File''' dialog appears, where all available waypoints and tracks from the imported file are listed. There are several options in the '''OCAD objects''' part of the dialog:

* '''Set label:''' Check this option to create also text objects with the name of the waypoints and tracks.
* '''Assign Symbols:''' Check this option to assign a specified symbol to the imported objects. Otherwise OCAD will create '''[[Unsymbolized Objects]]'''.
[[File:Hint.jpg|hint]] A popup menu appears when clicking the list with the GPS data with the right mouse button. In this popup menu you have the option to '''Select all''', '''Unselect all''' and '''Clear list'''. With the '''Clear list''' command all waypoints and tracks are removed. In addition, you can '''Make an OCAD object'''. By clicking this command, an OCAD object of the selected track or waypoint is created.

Click the '''Import''' button to import all selected tracks or waypoints in the list.

===GPS Map Offset===
This dialog box appears if the GPS coordinates are out of the maximum map size. Adjust the following parameters:

* '''Coordinate system''' If you work with GPS you must select a coordinate system. Click the '''Change''' button to select or change the coordinate system. The '''[[Create_a_New_Map#Coordinate_System|Coordinate System]]''' dialog box appears.
* '''Offset''' Choose here whether you want to change the OCAD real world coordinates or to keep the existing ones.
* '''New offset:''' Choose this option if no real world coordinates are defined for the map. OCAD already proposes reasonable values. You can leave theme unchanged.
* '''Existing offset and angle:''' Choose this option if the map already has real world coordinates and you want to fit the imported objects to the existing coordinates.

== Laser Rangefinder [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Read more about using the '''"TruPulse 360/360B" Laser Rangefinder''' on the '''[[Laser Rangefinder]]''' page

----
Back to [[Main Page]]

Online Map Services

2023-02-20T11:56:09Z

GRS:

How to Change Default Program Association

2023-02-20T11:54:33Z

GRS:

After the installation ocd files are assicated with OCAD 64-bit version.
For OCAD Mapping Solution there is also an [[Technical_Data#64-bit_Version_vs._32-bit_Version|32-bit version]].

To change to 32-bit do the following steps:

[[File:Default Program Association 1.png]]

Go to any ocd file. Click the right mouse button on the ocd file to open the context menu and click '''Open with...'''.

[[File:Default Program Association 2.png]]

Check '''Always use this app to open .ocd files''' and click '''More apps'''

[[File:Default Program Association 3.png]]

Scroll down and click '''Look for another app on this PC'''

[[File:Default Program Association 4.png]]

Change to the OCAD program folder (usually C:\Program Files\OCAD\OCAD 20xx Orienteering) and choose the ''OCAD Orienteering_64bit'' file.
Click the '''Open''' file.

How to Change Default Program Association

2023-02-20T11:53:03Z

GRS:

After the installation ocd files are assicated with OCAD 64-bit version.
For OCAD Orienteering and OCAD Mapping Solution there is also an [[Technical_Data#64-bit_Version_vs._32-bit_Version|32-bit version]].

To change to 32-bit do the following steps:

[[File:Default Program Association 1.png]]

Go to any ocd file. Click the right mouse button on the ocd file to open the context menu and click '''Open with...'''.

[[File:Default Program Association 2.png]]

Check '''Always use this app to open .ocd files''' and click '''More apps'''

[[File:Default Program Association 3.png]]

Scroll down and click '''Look for another app on this PC'''

[[File:Default Program Association 4.png]]

Change to the OCAD program folder (usually C:\Program Files\OCAD\OCAD 20xx Orienteering) and choose the ''OCAD Orienteering_64bit'' file.
Click the '''Open''' file.

Technical Data

2023-02-20T11:46:40Z

GRS: /* 64-bit Version vs. 32-bit Version */

= Computer / System Requirements=
* OCAD requires Windows 8, 10 or 11 (32- or 64-bit). OCAD is available as 32-bit and 64-bit software.
* 100 MB of free disk space for the installation
* At least 1 GB RAM (depends on the size of open maps and background maps). The OCAD program without any open map needs only 70 MB RAM.
* OCAD as 32-bit software can allocate up to approx. 3.5 GB RAM. OCAD as 64-bit software and can allocate more than 3.5 GB RAM if available.
* Screen resolution: 1280 x 1024 or higher recommended (needs to be multiplied with the screen scaling factor e.g. 2560 x 2048 when using 200% scaling)
* OCAD Mapping Solution: We recommend to install the [http://www.ocad.com/download/bde.exe Borland Database Engine] (import shape files, database connections to dBase files, using OCAD to create thematic maps) and the [http://www.microsoft.com/download/en/details.aspx?id=13255 Microsoft Access Database Engine 32-bit] (database connections to Access/Excel files, using OCAD to create thematic maps).

[[File:hint.jpg]] OCAD 64-bit version cannot connect to Microsoft Excel/Access if the 32-bit version of Microsoft Access Database Engine is installed. The same with 64-bit Microsoft Access Database Engine and OCAD 32 bit version.
In this case use the same OCAD version as installed Microsoft Access Database Engine..

= 64-bit Version vs. 32-bit Version =
'''OCAD Orienteering''', '''OCAD Starter''', '''OCAD Course Setting''' and '''OCAD Viewer''': OCAD Setup installs the 64-bit or 32 bit version depends on the installed Windows version. 

'''OCAD Mapping Solution''': OCAD Setup installs the 64-bit and 32-bit version. 

Please note, the 64-bit version isn't faster than the 32-bit version. The big advantage of 64 bit is that OCAD can allocate more than 3 GB RAM if available on the computer. That is important when loading huge raster background maps or DEM files. 

OCAD 64-bit runs only in Windows 64-bit version. Nowadays, almost all computers are running on a 64-bit Windows version. OCAD 32-bit runs on both Windows 64-bit and 32-bit. The ocd files are 100% compatible between both versions. 

Please note that not all OCAD functions are available in both versions. The restrictions for OCAD 64-bit version are:
* dbf database file cannot be used
* Microsoft Access database files depend on the installed Access Database Engine

= OCAD on Mac OS X =
Read the '''[[OCAD on Mac OS X]]''' article for more information.

= OCAD on Linux =
Read the '''[[OCAD on Linux]]''' article for more information.

= OCAD Limits =
* Maximal map size: 4 x 4 meters (OCAD Starter and Orienteering edition), 80 x 80 meters (Mapping Solution edition)
* Resolution (accuracy of coordinates) 0.01 mm
* 10000 objects (Starter edition), 16 million objects (OCAD Mapping Solution, Orienteering, Course Setting and Viewer edition)
* 4 million vertices for each object
* Unlimited number of symbols (number range 0.001 to 999'999.999)
* 32'000 colors (number range from 0 to 32'000)
* 2 GB file size

= OCAD File Format =
This description of the OCAD file format is intended for programmers who want to directly access the information in OCAD files.

* [[OCAD 12 File Format]]
* [http://www.ocad.com/wiki/ocad11/en/?title=Main_Page OCAD 11 File Format]
* [http://www.ocad.ch/docs/OCAD10Format.txt OCAD 10 File Format]
* [http://www.ocad.ch/docs/OCAD9Format.pdf OCAD 9/10 Graphic]
* [http://www.ocad.ch/docs/OCAD9Format.txt OCAD 9 File Format]
* [http://www.ocad.ch/docs/format8.txt OCAD 6/7/8 File Format]

= Recommendations =

==Mobile Mapping==

Mapping with a tablet in the terrain has some compelling advantages like real-time GPS positioning and the possibility to switch between different background maps. 
In case your background material isn't that great, you can get help of a GPS device so you can see you current position on the tablet.

There are two ways to use OCAD in the field.

'''1. OCAD Desktop, on Window devices''':

:Software: OCAD Orienteering Edition or OCAD Starter Edition
:Advantages: OCAD objects can be drawn directly.
:Disadvantages: Operation is not as ergonomic as in OCAD Sketch App.
:That's you: You like to draw the map directly in the terrain and see immediately, whether a situation on the map is clear and readable.

'''2. OCAD Sketch App, on iOS and Android devices''':

:Software: The OCAD Sketch App is available for free download and use in Apple App Store (iOS) and Google Play (Android). To prepare the data for the OCAD Sketch App and for final drawing, you need OCAD Desktop.
:Advantages: Very ergonomic and intuitive to use. Designed specifically for mobile mapping.
:Disadvantages: Only sketches can be drawn and not OCAD objects directly.
:That's you: You want to map as much as possible in the field and do the final drawing in the evening or on a rainy day on the computer at home.

===General things to consider===
*'''Battery'''
:Battery should last a working day. Battery lifetime is an issue and can vary not only from device to device but is also dependend on outside temperature.
:In cold conditions, a normal battery lifetime of 6 hours can be reduced to only 3-4 hours.
:Use an external battery pack/ power bank to extend battery lifetime. You can put the power bank into a bag and connected it directly by wire to the tablet or charge the tablet during a break.

*'''Stylus Pen'''
:A capacitive pen that works with your table is beneficial for precise drawing. General touchscreen pens might not work that precise.
:The OCAD Sketch App can also be used with fingers. However, drawing is more precise with a pen.

*'''Robustness'''
:How robust you want your tablet to be?
:E.g. do you want your tablet to be waterprof (rugged computers/ toughpads) or is it ok to pack it into a plastic bag, when it rains?

*'''GPS'''
:Many devices have internal GPS, which works very satisfactory in most cases.
:If your device has bad or no internal GPS, you can also use an external GPS.

*'''Compass'''
:If your device has a build-in compass, the OCAD Sketch App can use it to rotate the map view to magnetic north.

===Tablets for OCAD Desktop (Windwos)===

Some recommendation of our customers (05.2022): 
*Microsoft Surface Pro
*Microsoft Surface Go
*Microsoft Surface 7
*Lenovo tablet (Intel Atom CPU Z3795)

Also, you will find many '''rugged computers/ toughpads''' for tough environments as you will need it when mapping in the terrain. As a big plus point, these devices are working well in all weathers and are possible to use in rain. However, these devices are rather expensive if you are not a professional mapper and can cost up to a few thousand Euros. Also consider the weight of the device, which can be over 1kg.

More information can found e.g. on www.forest-it.se 
Some recommendation of our customers (05.2022): 
* Handheld Algiz 8X
* Trimble Yuma 2
* Panasonic Toughpad FZ-G1
* Gen2wave RP70
* FIDS Zelo
* Welo R10S

===Tablets for OCAD Sketch App (iOS or Android)===

'''iOS devices''' 
No specific recommendation. All iPads can be used, e.g. iPad Air, iPad Air Mini.

Note: iPad Air Wi-Fi = No internal GPS | iPad Air Wi-Fi + Cellular = With Internal GPS

Alternative iPad Pencil: 
*ERS Digital Pencil

'''Android devices''' 
Some recommendation of our customers (05.2022): 

*SAMSUNG Galaxy Tab S6 LTE with Samsung S Pen
*Samsung Galaxy Tab Active3 (8 ", 64 GB) with Samsung S Pen.

Note: Samsung Galaxy Tabs with ''Lite'' have no build-in compass | Samsung Galaxy Tab have GPS.

===Smartphones for OCAD Sketch App (iOS or Android)===
You can use the OCAD Sketch App also on a mobile phone. 
For small corrections, this can be an easy alternative to the tablet. 
For larger projects, however, the use of a tablet is recommended. 

===External GPS device===
If your tablet has no or only bad internal GPS, it is a good idea to connect an external GPS receiver to have your current position shown in OCAD with a few meters accuracy. 
You can place the external GPS device on the top of your head for better reception (fastend it to a cap or helmet) and connected it via bluetooth directly to your tablet. GPS devices like Gramin Glo should last more than 10 hours. 
Some recommendation of our customers (05.2022): 
*Garmin GLO 2
*Navilock BT-821G Bluetooth GNSS Receiver MT3333
*GNS3000

==Draw Orienteering Maps and Course Setting==
Hardware:
* Desktop or Laptop with Windows
* 4 GB or more RAM (at least 8 GB RAM when working with big LiDAR Files)
Software:
* OCAD Orienteering Edition, OCAD Starter Edition or OCAD Course Setting Edition

==Map Publishing Companies==
Hardware:
* Desktop PC with Windows one or two screens
* 4 or more GB RAM
Software:
* OCAD Mapping Solution
Special OCAD Settings:
* Switch on the '''Faster text rendering''' in '''OCAD Preferences''' -> '''View''' tab in '''Options''' menu.
* Switch off the '''Anti-Aliasing''' mode in '''View''' menu. If Anti-Aliasing is switched off then OCAD draws the screen color by color. Otherwise OCAD draws the screen once after a short time.

= Digital Signature =
The OCAD program file and the OCAD setup file are signed with the [https://en.wikipedia.org/wiki/Code_signing digital signature] of OCAD AG. That confirms the software author and guarantee that the code has not been altered or corrupted since it was signed by use of a cryptographic hash. OCAD uses the digital signature algorithm sha256RSA.

That is the reason why OCAD doesn't run on Windows XP and Vista.

The see the digital signature open the context menu of the OCAD setup file (.exe file) in '''File Explorer''' and click '''Properies'''. The '''Properties dialog''' opens. Click the '''Digital Signature''' tab.
Click '''Details'''. In '''Digital Signature Details''' dialog is the '''Signer Name''' ''OCAD AG''.

[[File:DigitalSignature.png]]

----
Back to [[Main Page]]

Previous Chapter: [[Tutorials]]

OCAD 12 and 2018 Updater

2023-02-20T10:26:07Z

GRS: /* Download */

The OCAD 12 and 2018 Updater can be used as a general overview and update tool for OCAD installations.

With this tool, you can download the latest [[Service_Update|OCAD Update]].

==Download==
Download the 64-bit version here:
* [https://www.ocad.com/download/Ocad2020/Ocad12_2020_Updater_64-bit.exe Download]

After the download run the program.

==OCAD 12 and 2018 Updater==
[[File:Ocad12And2019Updater.png|800px]]

The green OK icon indicate that you have installed the latest update.

Otherwise click on the '''Download Update and install''' to download the latest version from our server and install it.

[[File:Ocad12And2019UpdaterInstall.png]]

* Confirm to install an update
* After the installation click '''Check again''' to see if the installation was successfully.

OCAD 12 and 2018 Updater

2023-02-20T10:20:09Z

GRS: /* Download */

The OCAD 12 and 2018 Updater can be used as a general overview and update tool for OCAD installations.

With this tool, you can download the latest [[Service_Update|OCAD Update]].

==Download==
Download the 64-bit version here:
* [https://www.ocad.com/download/Ocad2020/Ocad12_2020_Updater_64-bit.exe Download 64-bit]

After the download run the program.

==OCAD 12 and 2018 Updater==
[[File:Ocad12And2019Updater.png|800px]]

The green OK icon indicate that you have installed the latest update.

Otherwise click on the '''Download Update and install''' to download the latest version from our server and install it.

[[File:Ocad12And2019UpdaterInstall.png]]

* Confirm to install an update
* After the installation click '''Check again''' to see if the installation was successfully.

XML Script Lidar and DTM Import

2023-02-06T13:48:04Z

GRS: /* Example */

[[File:Mas40px.png|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]

LiDAR data are invaluable for mapping, as highly accurate contour lines and base maps can be created. 
But when processing LiDAR data (las or laz file format) and DTM for larger areas, a computer can quickly become overloaded because not enough RAM is available and crashes. 
To avoid this, you have to work with XML scripts for larger projects. This may seem complicated at first glance, but don’t worry: All you have to do is copy code and make some adjustments.

[[File:LiDARImportXML.png]]

''Huge areas can be calculated in one single step.''

This is what you need to do:

*Create the folder structure first. '''[https://www.ocad.com/downloads/XML_LiDAR.zip Download]''' and unzip our folder structure in your chosen directory.
*Create a new, empty OCAD File with the desired symbol set, map scale and georeferencing. The '''[[New_Map_Wizard|New Map Wizard]]''' can help you with that.
*Save this file as ''Template.ocd'' (means overwrite the ''Template.ocd'' file in the folder structure).
*Put your LiDAR files in the folder ''0_LAZ''.
*Open the ''XML_Script.xml'' file with a text editor and '''adjust the file pathes''' in the document, e.g. from ''C:\Tmp\XML_LiDAR\Template.ocd'' to ''S:\O Map ZG\Template.ocd''.
*In the OCAD File menu, go to '''[[XML_Script|Execute XML Script]]''' and run the script.

Before you run the script with all your data, it's recommended to put only a few LiDAR files into the ''0_LAZ'' folder and see if everything works. If it does, put all LiDAR files there and clean all folders from output data from the testrun.

The XML function for importing las/laz files and creating contour lines and vegetation map is also available in the OCAD Orienteering edition.

==Example==
This script imports laz data and create contour lines and the vegetation base map. 
The single tiles are calculated separately and then cropped and merged together in the end.

<PRE>
<?xml version="1.0" encoding="ISO-8859-1"?>
<OcadScript>

<File.Open>
<File>C:\Tmp\XML_LiDAR\Template.ocd</File>
</File.Open>

<File.SaveAs>
<File>C:\Tmp\XML_LiDAR\1_ocdDem\Map.ocd</File>
</File.SaveAs>

<Dem.DemImport>
<LasImport>
<Directory>C:\Tmp\XML_LiDAR\0_LAZ\</Directory>
</LasImport>
<CreateOcdDem>
<Enabled>true</Enabled>
<Cellsize100>100</Cellsize100>
<CreateVegetationBaseMap>false</CreateVegetationBaseMap>

<LasDtm>
<Enabled>true</Enabled>
<Classification>
<Unclassified>false</Unclassified>
<Ground>true</Ground>
<LowVegetation>false</LowVegetation>
<MeanVegetation>false</MeanVegetation>
<HighVegetation>false</HighVegetation>
<Building>false</Building>
<LowPoint>false</LowPoint>
<Water>true</Water>
<OverlapPoints>false</OverlapPoints>
<Other>false</Other>
</Classification>
<ReturnType>1</ReturnType>
<CreateIntensityMap>false</CreateIntensityMap>
<CreateClassificationMap>false</CreateClassificationMap>
</LasDtm>

<LasDsm>
<Enabled>false</Enabled>
<Classification>
<Unclassified>false</Unclassified>
<Ground>true</Ground>
<LowVegetation>true</LowVegetation>
<MeanVegetation>true</MeanVegetation>
<HighVegetation>true</HighVegetation>
<Building>true</Building>
<LowPoint>true</LowPoint>
<Water>true</Water>
<OverlapPoints>false</OverlapPoints>
<Other>false</Other>
</Classification>
<ReturnType>2</ReturnType>
<CreateIntensityMap>false</CreateIntensityMap>
<CreateClassificationMap>false</CreateClassificationMap>
</LasDsm>
</CreateOcdDem>
<CreateOcdLas>
<Enabled>true</Enabled>
</CreateOcdLas>
</Dem.DemImport>

<File.Save>
<Enabled>true</Enabled>
</File.Save>
<File.Close>
<Enabled>true</Enabled>
</File.Close>


<File.Open>
<File>C:\Tmp\XML_LiDAR\Template.ocd</File>
</File.Open>
<File.SaveAs>
<File>C:\Tmp\XML_LiDAR\2_ocdDemMatching\Map_Matching.ocd</File>
</File.SaveAs>
<Dem.MatchTiles>
<InputFolder>C:\Tmp\XML_LiDAR\1_ocdDem\</InputFolder>
<OutputFolder>C:\Tmp\XML_LiDAR\2_ocdDemMatching\</OutputFolder>
</Dem.MatchTiles>
<File.Save>
<Enabled>true</Enabled>
</File.Save>
<File.Close>
<Enabled>true</Enabled>
</File.Close>


<File.Open>
<File>C:\Tmp\XML_LiDAR\Template.ocd</File>
</File.Open>
<File.SaveAs>
<File>C:\Tmp\XML_LiDAR\3_ocdDemMerging\Map_Merging.ocd</File>
</File.SaveAs>
<Dem.MergeTiles>
<InputFolder>C:\Tmp\XML_LiDAR\2_ocdDemMatching\</InputFolder>
<OutputFolder>C:\Tmp\XML_LiDAR\3_ocdDemMerging\</OutputFolder>
<TileSize>5000</TileSize>
</Dem.MergeTiles>
<File.Save>
<Enabled>true</Enabled>
</File.Save>
<File.Close>
<Enabled>true</Enabled>
</File.Close>


<File.Open>
<File>C:\Tmp\XML_LiDAR\Template.ocd</File>
</File.Open>
<File.SaveAs>
<File>C:\Tmp\XML_LiDAR\4_ocdDem_Cropped\Map_Cropped.ocd</File>
</File.SaveAs>
<Dem.CropTiles>
<InputFolder>C:\Tmp\XML_LiDAR\3_ocdDemMerging\</InputFolder>
<OutputFolder>C:\Tmp\XML_LiDAR\4_ocdDem_Cropped\</OutputFolder>
<TileSize>5000</TileSize>
</Dem.CropTiles>
<File.Save>
<Enabled>true</Enabled>
</File.Save>
<File.Close>
<Enabled>true</Enabled>
</File.Close>


<Dem.CreateContourLines>
<Enabled>true</Enabled>
<TemplateFile>C:\Tmp\XML_LiDAR\Template.ocd</TemplateFile>
<InputFolder>C:\Tmp\XML_LiDAR\4_ocdDem_Cropped\</InputFolder>
<OutputFolder>C:\Tmp\XML_LiDAR\5_CreateContourLines\</OutputFolder>
<TileSizeCropping>0</TileSizeCropping>
<Merging>true</Merging>
<EquidistanceOriginal>500</EquidistanceOriginal>
<CreateNotSmoothedContours>false</CreateNotSmoothedContours>
<EquidistanceLevel1>250</EquidistanceLevel1>
<EquidistanceLevel2>1250</EquidistanceLevel2>
<EquidistanceLevel3>0</EquidistanceLevel3>
<SymbolNumberLevel1>101000</SymbolNumberLevel1>
<SymbolNumberLevel2>102000</SymbolNumberLevel2>
<SymbolNumberLevel3>0</SymbolNumberLevel3>
<CreateSmoothedContoursUsingTpi>true</CreateSmoothedContoursUsingTpi>
<EquidistanceTpiOriginal>250</EquidistanceTpiOriginal>
<EquidistanceTpiLevel1>250</EquidistanceTpiLevel1>
<EquidistanceTpiLevel2>1250</EquidistanceTpiLevel2>
<EquidistanceTpiLevel3>0</EquidistanceTpiLevel3>
<SymbolNumberTpiLevel1>101000</SymbolNumberTpiLevel1>
<SymbolNumberTpiLevel2>102000</SymbolNumberTpiLevel2>
<SymbolNumberTpiLevel3>0</SymbolNumberTpiLevel3>
<UseDifferentSymbolsForDepressions>false</UseDifferentSymbolsForDepressions>
<SymbolNumberLevel1Depr>0</SymbolNumberLevel1Depr>
<SymbolNumberLevel2Depr>0</SymbolNumberLevel2Depr>
<SymbolNumberLevel3Depr>0</SymbolNumberLevel3Depr>
<SymbolNumberTpiLevel1Depr>0</SymbolNumberTpiLevel1Depr>
<SymbolNumberTpiLevel2Depr>0</SymbolNumberTpiLevel2Depr>
<SymbolNumberTpiLevel3Depr>0</SymbolNumberTpiLevel3Depr>
<ConvertTpiContoursToBezier>true</ConvertTpiContoursToBezier>
<DeleteCombinedDemFile>true</DeleteCombinedDemFile>
<MinimumContourValue>0</MinimumContourValue>
<MaximumContourValue>0</MaximumContourValue>
<IsMaxContourLength>false</IsMaxContourLength>
<MaxContourLength>0</MaxContourLength>
</Dem.CreateContourLines>


<File.Open>
<File>C:\Tmp\XML_LiDAR\Template.ocd</File>
</File.Open>
<File.SaveAs>
<File>C:\Tmp\XML_LiDAR\6_ImportAllOcds\Contour Lines.ocd</File>
</File.SaveAs>
<File.Import.Ocd>
<Directory>C:\Tmp\XML_LiDAR\5_CreateContourLines\</Directory>
<SymbolOption>0</SymbolOption>
<ColorOption>0</ColorOption>
</File.Import.Ocd>
<File.Save>
<Enabled>true</Enabled>
</File.Save>
<File.Close>
<Enabled>true</Enabled>
</File.Close>


<File.Open>
<File>C:\Tmp\XML_LiDAR\Template.ocd</File>
</File.Open>

<File.SaveAs>
<File>C:\Tmp\XML_LiDAR\7_png\Map_Vegetation.ocd</File>
</File.SaveAs>

<Dem.CreateVegetationBaseMap>
<Enabled>true</Enabled>
<InputFolder>C:\Tmp\XML_LiDAR\1_ocdDem\</InputFolder>
<OutputFolder>C:\Tmp\XML_LiDAR\7_png\</OutputFolder>

<CellSize>1</CellSize>

<NeighborhoodKernelUndergrowth>3</NeighborhoodKernelUndergrowth>
<ThresholdUndergrowthLow>0.00</ThresholdUndergrowthLow>
<ThresholdUndergrowthHigh>0.00</ThresholdUndergrowthHigh>
<ThresholdUndergrowthSlow>+1.00</ThresholdUndergrowthSlow>
<ThresholdUndergrowthDifficult>+1.00</ThresholdUndergrowthDifficult>

<NeighborhoodKernelVegetation>5</NeighborhoodKernelVegetation>
<ThresholdVegetationLow>0.30</ThresholdVegetationLow>
<ThresholdVegetationHigh>3.00</ThresholdVegetationHigh>

<ThresholdVegetationSlow>-0.40</ThresholdVegetationSlow>
<ThresholdVegetationDifficult>-0.20</ThresholdVegetationDifficult>
<ThresholdVegetationVeryDifficult>+0.20</ThresholdVegetationVeryDifficult>

<ThresholdOverlapPointsLow>0.30</ThresholdOverlapPointsLow>
<ShowAreaWithNoData>false</ShowAreaWithNoData>
<UseFilter>true</UseFilter>
<LasClassification>
<NeverClassified>false</NeverClassified>
<Unclassified>false</Unclassified>
<Ground>true</Ground>
<LowVegetation>true</LowVegetation>
<MediumVegetation>true</MediumVegetation>
<HighVegetation>true</HighVegetation>
<Building>false</Building>
<LowPoint>false</LowPoint>
<HighPoint>false</HighPoint>
<Water>false</Water>
<Railroad>false</Railroad>
<Road>false</Road>
<Overlap>false</Overlap>
<WireGuard>false</WireGuard>
<WireConductor>false</WireConductor>
<TransmissionTower>false</TransmissionTower>
<WireStructurConnector>false</WireStructurConnector>
<Bridge>false</Bridge>
<Other>false</Other>
</LasClassification>
</Dem.CreateVegetationBaseMap>

<File.Save>
<Enabled>true</Enabled>
</File.Save>

<File.Close>
<Enabled>true</Enabled>
</File.Close>


<File.Open>
<File>C:\Tmp\XML_LiDAR\Template.ocd</File>
</File.Open>

<File.SaveAs>
<File>C:\Tmp\XML_LiDAR\8_mergePNG\Map_mergeVegetation.ocd</File>
</File.SaveAs>

<Dem.MergeRasterMapTiles>
<Enabled>true</Enabled>
<InputFolder>C:\Tmp\XML_LiDAR\7_png\</InputFolder>
<OutputFolder>C:\Tmp\XML_LiDAR\8_mergePNG\</OutputFolder>
<TileSizeMeter>10000</TileSizeMeter>
</Dem.MergeRasterMapTiles>

<File.Save>
<Enabled>true</Enabled>
</File.Save>

<File.Close>
<Enabled>true</Enabled>
</File.Close>
</OcadScript>
</PRE>

XML Script Lidar and DTM Import

2023-02-06T13:47:07Z

GRS: /* Example */

[[File:Mas40px.png|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]

LiDAR data are invaluable for mapping, as highly accurate contour lines and base maps can be created. 
But when processing LiDAR data (las or laz file format) and DTM for larger areas, a computer can quickly become overloaded because not enough RAM is available and crashes. 
To avoid this, you have to work with XML scripts for larger projects. This may seem complicated at first glance, but don’t worry: All you have to do is copy code and make some adjustments.

[[File:LiDARImportXML.png]]

''Huge areas can be calculated in one single step.''

This is what you need to do:

*Create the folder structure first. '''[https://www.ocad.com/downloads/XML_LiDAR.zip Download]''' and unzip our folder structure in your chosen directory.
*Create a new, empty OCAD File with the desired symbol set, map scale and georeferencing. The '''[[New_Map_Wizard|New Map Wizard]]''' can help you with that.
*Save this file as ''Template.ocd'' (means overwrite the ''Template.ocd'' file in the folder structure).
*Put your LiDAR files in the folder ''0_LAZ''.
*Open the ''XML_Script.xml'' file with a text editor and '''adjust the file pathes''' in the document, e.g. from ''C:\Tmp\XML_LiDAR\Template.ocd'' to ''S:\O Map ZG\Template.ocd''.
*In the OCAD File menu, go to '''[[XML_Script|Execute XML Script]]''' and run the script.

Before you run the script with all your data, it's recommended to put only a few LiDAR files into the ''0_LAZ'' folder and see if everything works. If it does, put all LiDAR files there and clean all folders from output data from the testrun.

The XML function for importing las/laz files and creating contour lines and vegetation map is also available in the OCAD Orienteering edition.

==Example==
This script imports laz data and create contour lines and the vegetation base map. 
The single tiles are calculated separately and then cropped and merged together in the end.

<PRE>
<?xml version="1.0" encoding="ISO-8859-1"?>
<OcadScript>

<File.Open>
<File>C:\Tmp\XML_LiDAR\Template.ocd</File>
</File.Open>

<File.SaveAs>
<File>C:\Tmp\XML_LiDAR\1_ocdDem\Map.ocd</File>
</File.SaveAs>

<Dem.DemImport>
<LasImport>
<Directory>C:\Tmp\XML_LiDAR\0_LAZ\</Directory>
</LasImport>
<CreateOcdDem>
<Enabled>true</Enabled>
<Cellsize100>100</Cellsize100>
<CreateVegetationBaseMap>false</CreateVegetationBaseMap>

<LasDtm>
<Enabled>true</Enabled>
<Classification>
<Unclassified>false</Unclassified>
<Ground>true</Ground>
<LowVegetation>false</LowVegetation>
<MeanVegetation>false</MeanVegetation>
<HighVegetation>false</HighVegetation>
<Building>false</Building>
<LowPoint>false</LowPoint>
<Water>true</Water>
<OverlapPoints>false</OverlapPoints>
<Other>false</Other>
</Classification>
<ReturnType>1</ReturnType>
<CreateAndLoadIntensityAndClassificationMap>false</CreateAndLoadIntensityAndClassificationMap>
</LasDtm>

<LasDsm>
<Enabled>false</Enabled>
<Classification>
<Unclassified>false</Unclassified>
<Ground>true</Ground>
<LowVegetation>true</LowVegetation>
<MeanVegetation>true</MeanVegetation>
<HighVegetation>true</HighVegetation>
<Building>true</Building>
<LowPoint>true</LowPoint>
<Water>true</Water>
<OverlapPoints>false</OverlapPoints>
<Other>false</Other>
</Classification>
<ReturnType>2</ReturnType>
<CreateIntensityMap>false</CreateIntensityMap>
<CreateIntensityMap>false</CreateIntensityMap>
</LasDsm>
</CreateOcdDem>
<CreateOcdLas>
<Enabled>true</Enabled>
</CreateOcdLas>
</Dem.DemImport>

<File.Save>
<Enabled>true</Enabled>
</File.Save>
<File.Close>
<Enabled>true</Enabled>
</File.Close>


<File.Open>
<File>C:\Tmp\XML_LiDAR\Template.ocd</File>
</File.Open>
<File.SaveAs>
<File>C:\Tmp\XML_LiDAR\2_ocdDemMatching\Map_Matching.ocd</File>
</File.SaveAs>
<Dem.MatchTiles>
<InputFolder>C:\Tmp\XML_LiDAR\1_ocdDem\</InputFolder>
<OutputFolder>C:\Tmp\XML_LiDAR\2_ocdDemMatching\</OutputFolder>
</Dem.MatchTiles>
<File.Save>
<Enabled>true</Enabled>
</File.Save>
<File.Close>
<Enabled>true</Enabled>
</File.Close>


<File.Open>
<File>C:\Tmp\XML_LiDAR\Template.ocd</File>
</File.Open>
<File.SaveAs>
<File>C:\Tmp\XML_LiDAR\3_ocdDemMerging\Map_Merging.ocd</File>
</File.SaveAs>
<Dem.MergeTiles>
<InputFolder>C:\Tmp\XML_LiDAR\2_ocdDemMatching\</InputFolder>
<OutputFolder>C:\Tmp\XML_LiDAR\3_ocdDemMerging\</OutputFolder>
<TileSize>5000</TileSize>
</Dem.MergeTiles>
<File.Save>
<Enabled>true</Enabled>
</File.Save>
<File.Close>
<Enabled>true</Enabled>
</File.Close>


<File.Open>
<File>C:\Tmp\XML_LiDAR\Template.ocd</File>
</File.Open>
<File.SaveAs>
<File>C:\Tmp\XML_LiDAR\4_ocdDem_Cropped\Map_Cropped.ocd</File>
</File.SaveAs>
<Dem.CropTiles>
<InputFolder>C:\Tmp\XML_LiDAR\3_ocdDemMerging\</InputFolder>
<OutputFolder>C:\Tmp\XML_LiDAR\4_ocdDem_Cropped\</OutputFolder>
<TileSize>5000</TileSize>
</Dem.CropTiles>
<File.Save>
<Enabled>true</Enabled>
</File.Save>
<File.Close>
<Enabled>true</Enabled>
</File.Close>


<Dem.CreateContourLines>
<Enabled>true</Enabled>
<TemplateFile>C:\Tmp\XML_LiDAR\Template.ocd</TemplateFile>
<InputFolder>C:\Tmp\XML_LiDAR\4_ocdDem_Cropped\</InputFolder>
<OutputFolder>C:\Tmp\XML_LiDAR\5_CreateContourLines\</OutputFolder>
<TileSizeCropping>0</TileSizeCropping>
<Merging>true</Merging>
<EquidistanceOriginal>500</EquidistanceOriginal>
<CreateNotSmoothedContours>false</CreateNotSmoothedContours>
<EquidistanceLevel1>250</EquidistanceLevel1>
<EquidistanceLevel2>1250</EquidistanceLevel2>
<EquidistanceLevel3>0</EquidistanceLevel3>
<SymbolNumberLevel1>101000</SymbolNumberLevel1>
<SymbolNumberLevel2>102000</SymbolNumberLevel2>
<SymbolNumberLevel3>0</SymbolNumberLevel3>
<CreateSmoothedContoursUsingTpi>true</CreateSmoothedContoursUsingTpi>
<EquidistanceTpiOriginal>250</EquidistanceTpiOriginal>
<EquidistanceTpiLevel1>250</EquidistanceTpiLevel1>
<EquidistanceTpiLevel2>1250</EquidistanceTpiLevel2>
<EquidistanceTpiLevel3>0</EquidistanceTpiLevel3>
<SymbolNumberTpiLevel1>101000</SymbolNumberTpiLevel1>
<SymbolNumberTpiLevel2>102000</SymbolNumberTpiLevel2>
<SymbolNumberTpiLevel3>0</SymbolNumberTpiLevel3>
<UseDifferentSymbolsForDepressions>false</UseDifferentSymbolsForDepressions>
<SymbolNumberLevel1Depr>0</SymbolNumberLevel1Depr>
<SymbolNumberLevel2Depr>0</SymbolNumberLevel2Depr>
<SymbolNumberLevel3Depr>0</SymbolNumberLevel3Depr>
<SymbolNumberTpiLevel1Depr>0</SymbolNumberTpiLevel1Depr>
<SymbolNumberTpiLevel2Depr>0</SymbolNumberTpiLevel2Depr>
<SymbolNumberTpiLevel3Depr>0</SymbolNumberTpiLevel3Depr>
<ConvertTpiContoursToBezier>true</ConvertTpiContoursToBezier>
<DeleteCombinedDemFile>true</DeleteCombinedDemFile>
<MinimumContourValue>0</MinimumContourValue>
<MaximumContourValue>0</MaximumContourValue>
<IsMaxContourLength>false</IsMaxContourLength>
<MaxContourLength>0</MaxContourLength>
</Dem.CreateContourLines>


<File.Open>
<File>C:\Tmp\XML_LiDAR\Template.ocd</File>
</File.Open>
<File.SaveAs>
<File>C:\Tmp\XML_LiDAR\6_ImportAllOcds\Contour Lines.ocd</File>
</File.SaveAs>
<File.Import.Ocd>
<Directory>C:\Tmp\XML_LiDAR\5_CreateContourLines\</Directory>
<SymbolOption>0</SymbolOption>
<ColorOption>0</ColorOption>
</File.Import.Ocd>
<File.Save>
<Enabled>true</Enabled>
</File.Save>
<File.Close>
<Enabled>true</Enabled>
</File.Close>


<File.Open>
<File>C:\Tmp\XML_LiDAR\Template.ocd</File>
</File.Open>

<File.SaveAs>
<File>C:\Tmp\XML_LiDAR\7_png\Map_Vegetation.ocd</File>
</File.SaveAs>

<Dem.CreateVegetationBaseMap>
<Enabled>true</Enabled>
<InputFolder>C:\Tmp\XML_LiDAR\1_ocdDem\</InputFolder>
<OutputFolder>C:\Tmp\XML_LiDAR\7_png\</OutputFolder>

<CellSize>1</CellSize>

<NeighborhoodKernelUndergrowth>3</NeighborhoodKernelUndergrowth>
<ThresholdUndergrowthLow>0.00</ThresholdUndergrowthLow>
<ThresholdUndergrowthHigh>0.00</ThresholdUndergrowthHigh>
<ThresholdUndergrowthSlow>+1.00</ThresholdUndergrowthSlow>
<ThresholdUndergrowthDifficult>+1.00</ThresholdUndergrowthDifficult>

<NeighborhoodKernelVegetation>5</NeighborhoodKernelVegetation>
<ThresholdVegetationLow>0.30</ThresholdVegetationLow>
<ThresholdVegetationHigh>3.00</ThresholdVegetationHigh>

<ThresholdVegetationSlow>-0.40</ThresholdVegetationSlow>
<ThresholdVegetationDifficult>-0.20</ThresholdVegetationDifficult>
<ThresholdVegetationVeryDifficult>+0.20</ThresholdVegetationVeryDifficult>

<ThresholdOverlapPointsLow>0.30</ThresholdOverlapPointsLow>
<ShowAreaWithNoData>false</ShowAreaWithNoData>
<UseFilter>true</UseFilter>
<LasClassification>
<NeverClassified>false</NeverClassified>
<Unclassified>false</Unclassified>
<Ground>true</Ground>
<LowVegetation>true</LowVegetation>
<MediumVegetation>true</MediumVegetation>
<HighVegetation>true</HighVegetation>
<Building>false</Building>
<LowPoint>false</LowPoint>
<HighPoint>false</HighPoint>
<Water>false</Water>
<Railroad>false</Railroad>
<Road>false</Road>
<Overlap>false</Overlap>
<WireGuard>false</WireGuard>
<WireConductor>false</WireConductor>
<TransmissionTower>false</TransmissionTower>
<WireStructurConnector>false</WireStructurConnector>
<Bridge>false</Bridge>
<Other>false</Other>
</LasClassification>
</Dem.CreateVegetationBaseMap>

<File.Save>
<Enabled>true</Enabled>
</File.Save>

<File.Close>
<Enabled>true</Enabled>
</File.Close>


<File.Open>
<File>C:\Tmp\XML_LiDAR\Template.ocd</File>
</File.Open>

<File.SaveAs>
<File>C:\Tmp\XML_LiDAR\8_mergePNG\Map_mergeVegetation.ocd</File>
</File.SaveAs>

<Dem.MergeRasterMapTiles>
<Enabled>true</Enabled>
<InputFolder>C:\Tmp\XML_LiDAR\7_png\</InputFolder>
<OutputFolder>C:\Tmp\XML_LiDAR\8_mergePNG\</OutputFolder>
<TileSizeMeter>10000</TileSizeMeter>
</Dem.MergeRasterMapTiles>

<File.Save>
<Enabled>true</Enabled>
</File.Save>

<File.Close>
<Enabled>true</Enabled>
</File.Close>
</OcadScript>
</PRE>

GPS

2022-12-29T08:55:18Z

GRS: /* Example: Connection of a notebook and Navilock BT-821G */

[[File:RealTimeGPS.PNG]]
==Real Time GPS [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==

Choose this command from the '''GPS''' menu for mobile mapping with GPS. The GPS device must be connected to the computer via the COM interface with Bluetooth. 

[[File:Hint.jpg|hint]] If your GPS device is connected via an USB port or an internal GPS cannot be connected via Windows Location API, please install a software like '''[https://gpsgate.com/products/gpsgate_client GpsGate Splitter]''' to transfer the data to a virtual COM port (''Add Output -> Virtual COM port / NMEA filter'').

[[File:Hint.jpg|hint]] All COM ports that are listed in the Windows registry key ''HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM'' are available in OCAD.

===Real Time GPS Settings===
When you choose the '''Real Time GPS''' command from the '''GPS''' menu, the '''Real Time GPS Settings''' dialog appears.

[[File:RealTimeGpsSettings.png]]
====Connection Settings====
There are two Connection Settings:

=====COM=====

Choose this option to connect your GPS device with a COM port. Garmin devices typically use COM port 4 or 5.
# '''Port:''' Choose the COM port where the GPS device is connected. The GPS device must send the '''[https://en.wikipedia.org/wiki/NMEA_0183 NMEA 0183 Format]'''. 
# '''Baud rate:''' Choose the baud rate the serial port. NMEA 0183 defines 4800 bps but some devices may send data at a different speed. 
# '''Test:''' Click the '''Test''' button to open the '''[[GPS#Test GPS|Test GPS]]''' dialog box. The NMEA messages received from the GPS device are displayed there and you can verify the connection of the GPS device. Read more about this dialog in the '''[[GPS#Test GPS|Test GPS]]''' article on this page.

[[File:Hint.jpg]] In Windows, go to ''Settings > Bluetooth & Other devices > More Bluetooth Settings'' to see which COM ports your computer are using. OCAD uses the outgoing COM port of the connected device. 
[[File:Hint.jpg]] You can use an app (we tested ''Share GPS'') and connect your '''smarphone''' via bluetooth with the computer/tablet. After that, set up the connection via COM interface.

=====Windows Location API=====

Internal or external GPS devices can be connected using the [https://msdn.microsoft.com/en-us/library/windows/desktop/dd464636%28v=vs.85%29.aspx Windows Location API]. This options is recommended if the Windows computer does not anymore support COM ports.

The '''Location service''' must be activated in the Windows settings. For Windows 10 you can find this option in the '''Privacy''' settings -> '''Location'''. Switch on the '''Location service''' and switch on the app '''App connector'''.

Choose a sensor from the '''sensor list''' and click the '''Test''' button to test the connection settings.
The real time GPS works still in the habitual way.
: [[File:Hint.jpg|hint]] The GPS may needs to be manually activated as a location sensor in the '''Windows settings'''.
: [[File:Hint.jpg|hint]] if no sensor is listed, please use a tool like [[GPS#Real_Time_GPS|GpsGate Splitter]] to transfer the GPS signal to a virtual COM port.

====Requirements====
The following requirements can be given:
* '''DGPS, RTK, Float RTK:''' Check this option to use DGPS, RTK, Float RTK and define if the positions calculated without '''[https://en.wikipedia.org/wiki/DGPS DGPS]''', '''[https://en.wikipedia.org/wiki/Real_Time_Kinematic RTK]''', '''Float RTK''' are '''not saved''' or '''not saved and not shown'''.
: [[File:Hint.jpg|hint]] This option has only an effect if OCAD receives the '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Message]'''. Click the '''[[GPS#Test GPS|Test]]''' button to see what type of message is sent from the device.
* '''Min. 4 satellites:''' Check this option as a kind of precision requirement and define if the positions calculated from less than 4 satellites are '''not saved''' or '''not saved and not shown'''..
: [[File:Hint.jpg|hint]] This option has only an effect if OCAD receives the '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Message]'''. Click the '''[[GPS#Test GPS|Test]]''' button to see what type of message is sent from the device.
* '''HDOP:''' Check this option to define an upper limit for the '''[https://en.wikipedia.org/wiki/Dilution_of_precision_%28GPS%29 HDOP (Horizontal Dilution of Precision)]''' value and define if the positions calculated with a higher HDOP are '''not saved''' or '''not saved and not shown'''..

====Options====
* '''Filter:''' Check this option to activate a filter and specify how many GPS positions are averaged. This results in a more stable position, but the update is slower.
* '''Accuracy circle:''' This option is enabled when the '''Filter''' option is checked. Check this option to show the accuracy circle. This shows the accuracy of the last 5 measurements with a circle around the GPS marker.
* '''Auto scroll (moving map):''' Check this option to move the map automatically with the GPS marker.
* '''Subtract antenna height from Z value:''' Check this option to define a correction for the Z value. The entered value gets subtracted from the measured height value.
*'''GPS Connection tail:''' Check this option to show GPS positions tail. 
- You can also choose the length of the tail. 
- The tail color is the same as the '''[[OCAD_Preferences#Mark|mark color]]''', which can be set in the OCAD Preferences. 
[[File:GpsRealTimeShowTail.png]]

====Coordinate system====
Click the '''Change''' button to change the coordinate system. The '''[[Create_a_New_Map#Coordinate_System|Coordinate System]]''' dialog box appears.

Click the '''Connect''' button to turn on the real time GPS mode. The '''GPS''' box is displayed in the lower right corner if the connection to the GPS device was successful.

Close the '''Real Time GPS Settings''' dialog or click the '''Disconnect''' button to turn off real time GPS.

===Test GPS===
Click the '''Test''' button in the '''Real Time GPS Settings''' dialog to open the '''Test GPS''' dialog.

[[File:Hint.jpg]] Test the GPS connection outside, so your GPS device can receive data. Move around a little bit, so your position gets updated.

[[File:TestGPS.PNG]]

If OCAD receives '''[https://de.wikipedia.org/wiki/NMEA_0183#Global_Positioning_System_Fix_Data_(GGA) GGA Messages]''', those messages are displayed in the '''Serial data''' field. Characters 4 to 6 show the abbreviation GGA (e.g. $XXGGA...). '''[https://www.gpsinformation.org/dale/nmea.htm#RMC RMC Messages]''' are displayed if OCAD does not receive any GGA messages. RMC messages contain no information about DGPS and the number of satellites. However, the position can still be used in OCAD. The serial data box remains empty, if the GPS device is sending neither of the two messages or if there is a connection problem. Check that you have selected the right port in the '''Real Time GPS Settings''' dialog box and that the GPS device is connected correctly to the PC.

'''GGA message example:'''
$GPGGA,092750.000,5321.6802,N,00630.3372,W,1,8,1.03,61.7,M,55.2,M,,*76
'''RMC message example:'''
$GPRMC,092750.000,A,5321.6802,N,00630.3372,W,0.02,31.66,280511,,,A*43

OCAD takes the serial data apart and displays it in a bit more user-friendly view below the '''Serial data''' box.

=== Mapping with Real Time GPS ===

The '''GPS''' box is displayed in the lower right corner if OCAD is successfully connected to a GPS device.

[[File:RealTimeGPSBox.PNG]]

The following information is given in this box:
* '''Easting:''' In this field the easting value of the coordinate is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''Northing:''' In this field the northing value of the coordinate is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''Height:''' In this field the height is displayed. If the '''[[GPS#Options|Filter]]''' is activated, then it is the averaged value.
* '''DGPS:''' A green or red dot shows if a '''[https://en.wikipedia.org/wiki/Differential_GPS DGPS]''' signal is received.
* '''Satellites:''' In this field the number of received satellites is displayed. A Red number means that the requirements defined in the Real Time GPS Settings are not fulfilled.
* '''HDOP:''' The '''[https://en.wikipedia.org/wiki/HDOP HDOP (Horizontal Dilution of Precision)]''' is displayed in this field. HDOP is a quality indicator for the position of the useable satellites on the local sky. A Red number means that the requirements defined in the Real Time GPS Settings are not fulfilled.
* '''Precision (x Val):''' In this field the accuracy (root mean square) of specified number of the last measurements is displayed. The '''Filter length''' can be specified in the '''[[GPS#Options|Real Time GPS Settings]]''' dialog.

Below the information part of the box, there are several icons:
: [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''': Click this icon to create an OCAD object with the receiving GPS information. A symbol must be selected. Choose a point symbol and click the '''Start GPS Measurement''' icon to create an object at the position of the GPS marker. If a line or area symbol is selected, OCAD starts with the measurement and draws a vertice for every recieved position. The object is represented with a thin black line.
: [[File:Icon_PauseGPSMeasurement.PNG]] '''Pause GPS Measurement''': Click this icon to interrupt the GPS measurement without finishing the object. Click the icon again to continue with the measurement.
: [[File:Icon_StopGPSMeasurement.PNG]] ''' Stop GPS Measurement''': Click this icon to finish the line or area object. The object is displayed with the assigned symbol.
: [[File:Icon_FindGPSMarker.PNG]] '''Find GPS Marker''': Click this icon to move the view to the GPS marker. Enable the '''[[GPS#Options|Auto Scroll]]''' option to always move the view, when the GPS marker is leaving the current view.
: [[File:Icon_GPSFilter.PNG]] '''Filter''': Turn on or off the filter by clicking this icon. The filter can be adjusted in the '''[[GPS#Options|Real Time GPS Settings]]''' dialog.
: [[File:Icon_AccuracyCircle.PNG]] '''Accuracy Circle:''' Turn on or off the accuracy circle by clicking this icon. This shows the accuracy of the last 5 measurements with a circle around the GPS marker. This option is only available when the '''Filter''' is enabled.
: [[File:SelectVertexType.png]] '''Select Vertex Type''': In this dropdown list you can select between two types of '''[[Vertices]]''':
:: Choose the '''Normal Vertex''' option when a point should be added to the object for every position received from the GPS device.
:: Choose the '''Corner Vertex''' option when a position should be manually added to the object by clicking the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' button. This option is typically used to draw objects with straight parts and corners like a fence. If a point or text object is selected, the vertex type cannot be changed.
: [[File:Icon_AddGPSPositionToCalculateAverage.PNG]] '''Add GPS Position to Calculate Average''': Click this button for every position you want include into an average calculation. The number of added positions is shown in the button hint. Click the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' icon to create the object at the calculated average position. This function is only available when a point symbol is selected. This is especially useful when the GPS position of an uncrossable feature (e.g. small house, deep hole, huge tree etc.) is to be measured. Some points around the feature have to be recorded and by clicking the [[File:Icon_StartGPSMeasurement.PNG]] '''Start GPS Measurement''' icon, the average point can be found.
: [[File:ShowTail.png]] '''Show Tail''':Click this buttom to show the GPS tail or not.
: [[File:Icon_OpenRealTimeGPSSettings.PNG]] '''Open Real Time GPS Settings''': This icon opens the '''[[GPS#Real Time GPS Settings|Real Time GPS Settings]]''' dialog box.

[[File:Hint.jpg|hint]] The GPS cursor is drawn with the mark color. Change the '''[[OCAD_Preferences#Mark|Mark Color]]''' in the '''Drawing and Editing''' part of the '''[[OCAD Preferences]]'''. 
[[File:Hint.jpg|hint]] Cold temperatures can shorten the runtime of the GPS battery. Sometimes it helps to warm up the GPS device for a few minutes. 
[[File:GpsRealTimeThickerCursor.png]]

===Example: Connection of tablet SURFACE and Garmin GLO===
Connection of tablet SURFACE with OS Windows 10 and OCAD Orienteering subscription and Garmin GLO.

#First of all, turn the tablet Bluetooth on.
#Turn the GNSS device on and open the Bluetooth settings on the tablet.
#Find and select the Garmin GLO GNSS and click "Pair the device".
#After pairing, connect the device.
#Wait until the Garmin GLO's green light is glowing and not flashing.
#Open OCAD (both 32-bit and 64-bit version is ready) with a georeferenced map.
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Select the port (try to test different ports to find which the device is connected to, it depends on the GPS port manager) and connect the GNSS.
#You should see a marker at your position.
#Make sure that the coordinate system of the map is the same as the GNSS coordinate system (can be adjusted in "Real-time GPS" options).

===Example: Connection of a notebook and Navilock BT-821G===
Connection of a notebook with OS Windows 10 and OCAD Orienteering subscription and Navilock BT-821G Bluetooth GNSS Receiver MT3333.

#First of all, turn on Navilock BT – 821G and wait when recognizes satellites.
#On your notebook, go to the Device Manager and turn Bluetooth on.
#:-Pair the device and connect BT – GPS – 396371.
#:-for a pairing is necessary to enter a code 0000 (Navilock recommendation).
#:-after entering a code, a connection is done.
#another Bluetooth Settings:
#:-view assigned COM port - for BT - 821G two ports one output and one input (it is from the point of view of connected device).
#Open OCAD (both 32-bit and 64-bit version is ready) with a georeferenced map.
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Select the port, baud rate = 4800 bps (it worked even with selected higher bps speed).
#You should see a marker at your position.
#Click the Test button in the Real Time GPS Settings dialog to open the Test GPS dialog.

===Example: Connection of rugged tablet and Garmin GLO===
Connection of rugged tablet with OS Windows and OCAD Orienteering subscription and Garmin GLO.

#Garmin GLO is predetermined to connect to the computer's COM3 port with a baud rate of 4800 bps.
#You should switch on the GLO before starting up OCAD, otherwise the connection most often fails, so make sure to do that first.
#Next open OCAD (both versions 32-bit and 64-bit version are ready).
#In the '''GPS''' menu, go to '''Real-Time GPS'''.
#Make sure you select the correct COM port and baud rate.
#Finally, make sure you've selected the correct reference system for where you'll be working.

==Import Data from GPS Device [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
This function is obsolete! If you want to import GPS data from GPS devices, import the waypoints and tracks with the corresponding software of the GPS device to the computer. Then use the '''[[GPS#Import from File|Import from File]]''' function in OCAD. As an alternative, for fieldwork, use the '''[[GPS#Real Time GPS|Real Time GPS]]''' function.

Choose this command to import tracks or waypoints from a '''GPS Garmin eTrex''' device. The GPS device must be connected to the PC with a serial data cable or Bluetooth.

* '''GPS:''' In this field the information about the GPS device is displayed.
* '''Status:''' In this field the status between OCAD and GPS is displayed.

'''Connection'''
* '''Connect GPS:''' Click this button to connect OCAD with the GPS device. After a successful connection the GPS information and the status are displayed.
* '''Settings:''' Click this button to change the GPS settings. The '''Import from GPS Settings''' dialog is displayed.

'''GPS data'''
* '''Get waypoints:''' Click this button to load all waypoints. Each waypoint is displayed with in a row in the GPS data field.
* '''Get tracks:''' Click this button to download all tracks. Each track is displayed with in a row in the GPS data field. Only the start point is displayed.
[[File:Hint.jpg|hint]] This command can take several minutes!

'''OCAD objects'''
* '''Set labels:''' Check this option to create also text objects with the name of the waypoints and tracks.
* '''CRT:''' Use a '''[[Cross Reference Table]]''' to assign symbols to the waypoints and tracks. OCAD creates '''[[Unsymbolized Objects]]''' if no '''[[Cross Reference Table]]''' is selected.
: Each line of the cross reference table contains the OCAD symbol number and the Garmin symbol name.
: Example of a cross reference table:
535.0 waypoint dot
536.0 campground symbol
540.0 scenic area symbol
* '''Create:''' Select the waypoints and tracks in the GPS data field and click this button to create OCAD objects from the selected GPS data. 
[[File:Hint.jpg|hint]] A popup menu appears when clicking the list with the GPS data with the right mouse button. In this popup menu you have the option to '''Select all''', '''Unselect all''' and '''Clear list'''. With the '''Clear list''' command all waypoints and tracks are removed. In addition, you can '''Make an OCAD object'''. By clicking this command, an OCAD object of the selected track or waypoint is created.

===Import from GPS Settings===
In this dialog box you can make the setting for the GPS data import. Verify also your settings on the GPS device (e.g. data format: GARMIN)!

* '''Port:''' Choose the port where the GPS device is connected.
* '''Speed data import:''' Choose the speed of the serial port. Garmin defines 9600 bps.
* '''Coordinate system:''' Click the '''Change''' button to select or change the coordinate system. The '''[[Create a New Map#Coordinate System|Coordinate System]]''' dialog box appears.

==Import from File [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Choose this command from the '''GPS''' menu to import a GPS data file to the current map. The '''Load GPS data from files''' dialog box is displayed. Initially all importable GPS data files are listed. The following file types can be imported:
* GPX files
* FRWD files
* NMEA files
The '''Import from File''' dialog appears, where all available waypoints and tracks from the imported file are listed. There are several options in the '''OCAD objects''' part of the dialog:

* '''Set label:''' Check this option to create also text objects with the name of the waypoints and tracks.
* '''Assign Symbols:''' Check this option to assign a specified symbol to the imported objects. Otherwise OCAD will create '''[[Unsymbolized Objects]]'''.
[[File:Hint.jpg|hint]] A popup menu appears when clicking the list with the GPS data with the right mouse button. In this popup menu you have the option to '''Select all''', '''Unselect all''' and '''Clear list'''. With the '''Clear list''' command all waypoints and tracks are removed. In addition, you can '''Make an OCAD object'''. By clicking this command, an OCAD object of the selected track or waypoint is created.

Click the '''Import''' button to import all selected tracks or waypoints in the list.

===GPS Map Offset===
This dialog box appears if the GPS coordinates are out of the maximum map size. Adjust the following parameters:

* '''Coordinate system''' If you work with GPS you must select a coordinate system. Click the '''Change''' button to select or change the coordinate system. The '''[[Create_a_New_Map#Coordinate_System|Coordinate System]]''' dialog box appears.
* '''Offset''' Choose here whether you want to change the OCAD real world coordinates or to keep the existing ones.
* '''New offset:''' Choose this option if no real world coordinates are defined for the map. OCAD already proposes reasonable values. You can leave theme unchanged.
* '''Existing offset and angle:''' Choose this option if the map already has real world coordinates and you want to fit the imported objects to the existing coordinates.

== Laser Rangefinder [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Read more about using the '''"TruPulse 360/360B" Laser Rangefinder''' on the '''[[Laser Rangefinder]]''' page

----
Back to [[Main Page]]

Import GeoPackages

2022-12-29T08:14:42Z

GRS:

[[File:Pro40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Std40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]

A GeoPackage (GPKG) is a data format for geographic information system implemented as a SQLite database container.

Choose the *.gpkg format in the file import dialog to import [https://en.wikipedia.org/wiki/GeoPackage GeoPackages].

In the first dialog choose the datasets to import. By default, all datasets with data are selected.

[[File:GeoPackageImport1.png]]

In the second you can choose the database for the layer information and a [[Cross_Reference_Table|crt file]] to convert the imported objects to symbolized objects.

[[File:GeoPackageImport2.png]]

[[File:GeoPackageImport3.png]]

Cross Reference Table

2022-12-29T08:13:19Z

GRS:

A '''Cross Reference Table (CRT)''' contains data which refers to related or synonymous information elsewhere, usually within the same document. Therefore, a '''Cross Reference Table''' helps OCAD to transcribe data (symbols, text etc.) with new information.

A '''CRT-File''' (with the ending .ocdCrt) is a text file with the necessary information for the translation. All '''CRT-Files''' which are saved by OCAD contain a table with two columns. Information from the second column gets translated into the information of first column. 
[[File:Hint.jpg|hint]] In some cases it is the other way round.

The following table from the '''[[Map#Convert Imported Layers to Symbols|Convert Imported Layers to Symbols]]''' function can be taken as an example. In the first column symbol numbers of the OCAD File are listed. In the second column the layer names are listed. The two columns are separated by a space character or a '''[Tab]'''. OCAD converts now each layer to an object with the symbol listed in the first column.

101.000 CONTOUR
102.000 INDEXCONTOUR
103.000 FORMLINE
502.000 ROAD
506.000 PATH
527.000 BUILDING

CRT-Files are used for many OCAD functions:
{| class="wikitable"
|-
! Function !! First Column !! Second Column
|-
| '''[[Map#Convert Imported Layers to Symbols|Convert Imported Layers to Symbols]]''' || Symbol number || Layer name
|-
| '''[[Map#Convert Text Objects to Point Objects|Convert Text Objects to Point Objects]]''' || Symbol number of point object || Plain text
|-
| '''[[Map#Convert Text Objects from OEM to Unicode|Convert Text Objects from OEM to Unicode]]''' || Unicode (0..65535) || OEM character code (0..255)
|-
| '''[[Colors#Load_Colors_and_Symbols_From|Load Colors and Symbols From]]''' || Symbol number of the current OCAD-File || Symbol number of the symbol to replace with of the other OCAD-File
|-
| '''[[Import Files#Import OCAD Map|Import OCAD Map]]''' || Symbol number of the map to be imported || Symbol number of the currently opened OCAD-File
|-
| '''[[Import Files#Import DXF File|Import DXF File]]''' || Symbol number in the OCAD Map || Name of the corresponding DXF-Layer
|-
| '''[[Import_GeoPackages|Import GeoPackages]]''' || Symbol number in the OCAD Map || Name of the corresponding DXF-Layer
|-
| '''[[Import Files#Import PDF Files|Import PDF File]]''' || Symbol number in the OCAD Map || Name of the corresponding layer in the PDF-File
|-
| '''[[Import Open Street Map Files]]''' || Symbol number in the OSM symbol set || Name of the corresponding layer in the OSM-File
|-
| More are following... || - || -
|}

In some of the functions, the CRT-File can be created, edited, loaded or saved directly in the function dialog. This part of the dialog looks as follows:

[[File:CrossReferenceTable.PNG]]

You have the following options:
* '''Load:''' Click this button to load an existing CRT-File.
* '''Save:''' Click this button to save the changes to a CRT-File.
* '''Save as:''' Click this button to save the changes to a different CRT-File.
* '''First Column (in the example OEM [0..255]):''' In this column you can select or enter the data which you want to translate.
* '''Second Columng (in the example Unicode [0..65535]):''' In this column you can select or enter the data which the first column shall be translated into.
* '''Move Up:''' Click the '''Move up''' icon to move the selected line upwards in the table.
* '''Move Down:''' Click the '''Move down''' icon to move the selected line downwards in the table.
* '''Add:''' Click this button to add a reference to the list.
* '''Delete:''' Click this button to delete the selected reference.

You can edit a CRT-File with a text editor (e.g. Microsoft Notepad), too.

==Examples==
===Load Colors and Symbols From===
The CRT-File of the '''[[Colors#Load_Colors_and_Symbols_From|Load Colors and Symbols From]]''' function is defined as follows:

In the first column of the cross reference table the symbol numbers of the current map are listed. In the second column symbol numbers of the other OCAD-File are listed, namely those numbers of symbols, which the current symbol has to be replaced with.

'''Example:'''

526.000 813.001

If a row of the CRT-File looks as in the example, the symobls of all objects with the symbol number 526.00 will get the symbol of the other OCAD-File with the number 813.001.

===Import OCAD-Files===
The CRT-File of the '''[[Import Files#Import OCAD Map|Import OCAD Map]]''' function is defined as follows:

In the first column of the cross reference table the symbol numbers of the map to be imported have to be listed. In the second column the symbol numbers of the currently opened OCAD-File have to be listed.

'''Example:'''

101.000 305.000

All objects with the symbol 101.000 in the file which is to be imported are assigned with the symbol 305.000 of the currently opened OCAD-File.

===Import DXF-Files===
Click the '''CRT''' button in the '''[[Import Files#Import DXF File|Import DXF File]]''' dialog box to load a cross reference table. A cross reference table is used when '''Importing''' or '''Exporting a DXF file'''. It defines how DXF layers are translated to OCAD symbols and vice versa.

Each line in this file contains an OCAD symbol number and the name of the corresponding DXF layer. The two are separated by a space character. Use an application such as Microsoft Notepad to create a cross reference table.

This is an example:
101.000 CONTOUR
102.000 INDEXCONTOUR
103.000 FORMLINE
502.000 ROAD
506.000 PATH
527.000 BUILDING

When importing from DXF to OCAD, all objects in the DXF file with the layer name CONTOUR are translated into symbol 101.000. When exporting from OCAD to DXF, all objects with the symbol 101.000 get the layer name CONTOUR.
Choose '''Convert layers''' from the '''Map''' menu to create a CRT file for an imported map.

[[File:Hint.jpg]] ''-1'' as symbol number means that OCAD delete these objects.

[[File:Hint.jpg]] Convert DXF Geobau layers to OCAD ISSOM symbol set with this CRT-Table: [https://www.ocad.com/download/samples/DxfGeobau_to_Issom.zip DxfGeobau_to_Issom.zip]

===Import PDF-Files===
When you import a PDF-File in an OCAD map, you are asked if you want to save a CRT-File. This CRT-File is helpful when you want to convert the layers in the PDF-File to symbols later on. The layer names are saved in the second column of the file. In the first column you will have to enter the corresponding symbol number manually.

===Import Open Street Map Files===
The corresponding CRT-File to the '''[[Import Open Street Map Files]]''' function in the OCAD directory looks as follows:

1001.0 way_highway_motorway
1001.1 way_highway_motorway_tunnel_yes
1002.0 way_highway_motorway_link
1002.1 way_highway_motorway_link_tunnel_yes
1003.0 way_highway_trunk
.
.
.

In the first column, the symbol numbers of the Open Street Map symbol set are listed. In the second column, the name of the corresponding Open Street Map object can be found.

At the end of the importing process you have to save another CRT-File. This is the same CRT-File as the loaded one but, in addition, the layer names of objects, which the standard symbol set does not provide, are added with a symbol number 0.0.
You can add these symbols to the symbol set and enter the number directly in the CRT-File with a normal Text Editor (e.g. Microsoft Notepad). Then use the '''[[Map#Convert Imported Layers to Symbols|Convert Imported Layers to Symbols]]''' function to symbolize the '''[[Unsymbolized Objects]]'''.

XML Script

2022-12-28T09:37:09Z

GRS: /* File */

[[File:Mas40px.png|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]] ([[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]])

Choose this command to execute functions whose settings are defined in a XML file.

Note: Most parameters can only be used in the Mapping Solution Edition. In the Orienteering Edition, XML Script can be used for Lidar Import, DTM Import and WMTS Export.

==Introduction==

Select '''Execute XML Script''' from '''File''' menu or drag-and-drop then xml file to the OCAD window.

OCAD creates a log file in the temporary folder (''C:\Users\USERNAME\AppData\Roaming\OCAD\OCAD 20xx\Tmp'').

==XML Script General==

===File===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:40em" | Values / Description
|-
| File.New || File MapScale <del>Easting </del> <del>Northing</del> <del>Angle</del> || String Integer <del>Integer</del> <del>Integer</del> <del>Double</del> || file name of existing symbol set 10000 obsolete, use Map.ScaleAndCoordinateSystem obsolete, use Map.ScaleAndCoordinateSystem obsolete, use Map.ScaleAndCoordinateSystem
|-
| File.Open || File IgnoreMissingBackgroundMaps IgnoreMissingDatasets|| String Boolean Boolean|| ocd file name true, false (default: false) true, false (default: false)
|-
| File.Close|| Enabled || Boolean || true, false
|-
| File.Save || Enabled || Boolean || true, false
|-
| File.SaveAs || File || String || ocd file name
|-
| File.Import.Ocd || File Directory SymbolOption ColorOption || String String Integer Integer || File name [0..3] [0, 1]
|-
| File.Import.Dxf || Directory NewOffset HorizontalOffset VerticalOffset Angle MapScale || String Boolean Integer Integer Double Integer || Directory name ignored if NewOffset = false ignored if NewOffset = false ignored if NewOffset = false ignored if NewOffset = false
|-
| File.Import.GeoPackage || GpkgFilename TableName Layer CrtFilename || String String String String || 
|-
| File.MultipleFileImport
|| Directory SearchPattern CoordinateSystem NewOffset Horizontally Vertically Angle MapScale GridDistance DatabaseType Codepage KeyField LayerField LayerField2 ExtentMinimumEasting ExtentMaximumEasting ExtentMinimumNorthing ExtentMaximumNorthing
|| String String Integer Boolean Integer Integer Double Integer Double Integer Integer String String String Double Double Double Double
|| Directory of import files, e.g. ''C:\Shape\'' optional, e.g. SV*.shp [[Create_a_New_Map#Coordinate_System|Internal Grid ID]] |1000 = existing grid of OCAD file, -1 = WGS 84, 0 = dBase, 1 = Access 2007, 2 = Access 2003/2010, 3 = Do not create a database 0 = Default, Codepage number ' ' = Create new key field, field name ' ' = do not import layer information, field name ' ' = do not import 2nd layer information, field name, LayerField and LayerField2 content are concatenated by '_' 
|-
| File.Exit || Enabled || Boolean || true, false
|}

===View===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| View.Mode || || Enum types || normalMode, spotColorMode, draftMode
|-
| View.EntireMap || Enabled|| Boolean || true, false
|-
| View.MoveTo || X Y || Double Double ||  
|-
| View.Zoom ||   || Double ||  
|}

===Select===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Select.ObjectsBySymbol || SymbolNumber || Double || e.g. 526.002
|-
| Select.ObjectsBySymbol ||  ||  || use <Select.ObjectsBySymbol></Select.ObjectsBySymbol> to clear the selection
|}

===Object===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Object.ChangeVertexTypesTo || Type || Enum types || CornerVertex, DashVertex
|-
| Object.Fill || SymbolNumber || Double ||  
|-
| Object.ChangeSymbol || FromSymbolNumber FromImportedLayer ToSymbolNumber || Double String Double ||  
|-
| Object.ChangeSymbolSelectedObjects || SymbolNumber || Double || e.g. 101.001
|-
| Object.MergeObjectsBySymbol|| SymbolNumber || Double || e.g. 101.001
|}

===Symbol===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Symbol.SymbolStatusManager|| FileName SymbolStatusName|| String String || xml file name name of symbol status
|-
| Symbol.ChangeStatus|| SymbolNumber|| double|| e.g. 101.000 attribute status="hidden", "protected" or "hidden"
|-
|}

===Map===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Map.OptimizeRepair|| Enabled|| Boolean || true, false
|-
| Map.ChangeScale || NewScale EnlargeReduceSymbols EnlargeReduceLineWidthOfImageAndGraphicObjects || Integer Boolean Boolean|| e. g. 10000 true, false true, false
|-
| Map.ConvertLayer|| CrtFile || String || crt file name
|-
| Map.DeleteObjectsBySymbol|| SymbolNumber SymbolTreeGroupName||Double, String String|| e.g. 526.002, ObjectsWithoutSymbol e.g. Streets
|-
| Map.ExportObjectsBySymbol|| File SymbolNumber SymbolTreeGroupName||Double String|| export ocd file name e.g. 526.002 e.g. Streets
|-
| Map.LoadSymbolsFrom || File || String || ocd file name (with symbols to be loaded) The option ''replace existing colors and symbols'' is used
|-
| Map.LoadSymbolTreeFrom|| FileName || String|| ocd file name
|-
| Map.ScaleAndCoordinateSystem || MapScale Easting Northing Angle CoordinateSystem|| Integer Integer Integer Double Integer|| e.g. 10000 e.g. 600000 e.g. 200000 e.g. 4.5 internal grid id
|-
| Map.Transform.ChangeCoordinateSystem || CoordinateSystem EastingOffset NorthingOffset ScaleSymbols|| Integer Integer Integer Boolean|| internal grid id true, false
|-
|}

===Database===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| Database.Dataset.New || DatasetName DBaseFile OdbcDataSource Table KeyField SymbolField TextField SizeField LengthUnit AreaUnit Decimals HorizontalCoordinate VerticalCoordinate Username Passwort || String String String String String String String String String String Integer String String String String || mandatory     mandatory mandatory                     
|-
| Database.Dataset.Remove || Dataset || String Integer || ''all'' for all databases 3, 2, 1, ... for only one or several 
|-
| Database.Assign.Symbols || Dataset CntFile || String or Integer String || ''all'' for all databases, dataset name or 1, 2, 3... for only one database Condition table file
|-
| Database.Assign.Texts || Dataset TextField Condition Symbol ReplaceExistingObjects || String or Integer String String String Boolean || ''all'' for all databases, dataset name or 1, 2, 3... for only one database     e.g. 101.0, -1 for using existing symbol true, false (Default)
|-
| Database.SetObjectDirection || Dataset AngleField MathematicalFunction || String or Integer String String || ''all'' for all databases, dataset name or 1, 2, 3... for only one database   eg.: *180/3.14159
|-
| Database.CreateObjects || Dataset SelectSymbol Condition HorizontalCoordinate VerticalCoordinate Unit TextField HorizontalOffset VerticalOffset || Integer Double String String String Enum types String Double Double || 1, 2, 3, ... Number of dataset Symbol numer. ex. 207.0 SQL String (ex. SYMBOL LIKE 207.0) Database fieldname Database fieldname m, km Database fieldname    
|}

===Background Map===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:26em" | Values / Description
|-
| BackgroundMap.Open || FileName Visible VisibleInFavorites Dimm Transparent SpotColor Blockout Infrared|| String Boolean Boolean Integer Boolean String Boolean Integer ||   true, false; Default = true true, false; Default = true [0..100]; Default = 0 [only works if Blockout is false] true, false; Default = false [only works if Blockout is false] spot color name true, false; Default = false 0=undefined, 1=32bit-infrared, 2=32bit RGB
|-
| BackgroundMap.Visible||  || String|| filename only for already loaded background maps
|-
| BackgroundMap.Hide||  || String|| filename only for already loaded background maps
|-
| BackgroundMap.Remove||  || String|| ''all'' or filename
|-
| BackgroundMap.Reload a)||  || String|| ''all'' or filename
|}
a): Limited functionality. Not avaiable for all users.

===DEM [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]===
Read more about importing Lidar and DTM data on the page [[XML Script Lidar and DTM Import]].

===WMTS Export [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]===
Read more about exporting map tiles for [https://leafletjs.com/ Leaflet] on the page [[XML Script WMTS Export]].

=== Example ===
<PRE>
<?xml version="1.0" encoding="ISO-8859-1"?>


<OcadScript>

<File.New>

<File>C:\Export\Chlosterwald.ocd</File>
</File.New>

<File.MultipleFileImport>

<Directory>C:\Export\Files</Directory>
<CoordinateSystem>1000</CoordinateSystem>
<NewOffset>true</NewOffset>
<Horizontally>600000</Horizontally>
<Vertically>200000</Vertically>
<Angle>0</Angle>
<MapScale>10000</MapScale>
<GridDistance>500</GridDistance>
<LayerField>OBJECTVAL</LayerField>
</File.MultipleFileImport>

<Database.Assign.Texts>
<Dataset>all</Dataset>
<Condition/>
<TextField>TEXT</TextField>
<Symbol>902.000</Symbol>
<ReplaceExistingObjects>false</ReplaceExistingObjects>
</Database.Assign.Texts>

<Database.Assign.Angles>
<Dataset>all</Dataset>
<AngleField>ANGLE</AngleField>
</Database.Assign.Angles>

<Database.Assign.Symbols>
<Dataset>all</Dataset>
<CntFile>C:\Export\Chlosterwald.cnt</CntFile>
</Database.Assign.Symbols>

<Database.Dataset.Remove>
<Dataset>all</Dataset>
</Database.Dataset.Remove>

<Map.OptimizeRepair>
<Enabled>true</Enabled>
</Map.OptimizeRepair>

<View.EntireMap>
<Enabled>true</Enabled>
</View.EntireMap>

<File.Save>
<Enabled>false</Enabled>
</File.Save>

<File.SaveAs>
<File>C:\Export\Chlosterwald_Example.ocd</File>
</File.SaveAs>

<File.Close>
<Enabled>true</Enabled>
</File.Close>

<File.Exit>
<Enabled>false</Enabled>
</File.Exit>

</OcadScript>
</PRE>

==XML Script Thematic Maps [[File:Space.PNG]][[File:Mas40px.png|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]]==
{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:21em" | Values / Description
|-
| File.CreateThematicMap
|| <MapTheme> Name StatDataPath StatDataTable StatDataCommonField VisualizeAttributes AttributesValuesType Classify RepresentationFeature GeometryDataPath GeometryDataCommonField JoinType VisualizationMethod VisualizationType <VisualizationProperties> ScalingMode MaxSize MinSize FillColor StrokeColor StrokeMaxWidth StrokeMinWidth DecreaseStroke ShowZeroValue ShowNoData Opacity ThemeLegendTitle </VisualizationProperties> </MapTheme> <MapTitleStyle> Color Opacity Font Size isBold isItalic Alignment </MapTitleStyle> <LegendTitleStyle> see MapTitleStyle... </LegendTitleStyle> <LegendTextStyle> see MapTitleStyle... </LegendTextStyle> AddScaleBar AddScaleText AdditionalInformationText

|| string string string string string ValueType ClassifyType RepresentationFeatureType string string JoinType VisualizationMethodType VisualizationTypeType ScalingModeType double double FillColor StrokeColor double double boolean boolean boolean integer string ColorType integer string double boolean boolean AlignmentType ... ... boolean boolean string

|| Theme name statistic data file path Sheet or table for Excel or Access files Common Id field Attribute(s) to visualize: Ex. 2004 or 2009|2011 absolute, relative yes, no point, line, area Geometry data file path Common Id field see Thematic Map Data Types table see Thematic Map Data Types table see Thematic Map Data Types table see Thematic Map Data Types table max. size in mm min. size in mm fill color: ex. C=84 M=0 Y=128 K=0 stroke color: ex. C=0 M=0 Y=0 K=255 max. stroke width in mm min. stroke width in mm true, false true, false true, false % ThemeLegendTitle font color: ex. C=0 M=0 Y=0 K=255 opacity in % font name font size true, false true, false 0=align bottom left ... ... true, false true, false Ex. Coordinate system: Pseudo-Mercator
|}

===Thematic Map Data Types===
{| class="wikitable" style=" border="1"
|-
! style="width:14em" | Data type
! style="width:28em" | Values
|-
| ValueType || absolute, relative
|-
| ClassifyType || yes, no
|-
| RepresentationFeatureType || point, line, area
|-
| JoinType || 0=KeepAllRecords, 1=KeepOnlyMatchingRecords
|-
| VisualizationMethodType || mProportionalSymbols, vmProportionalLines, vmProportionalArrows, vmGraduatedSymbols, vmGraduatedLines, vmGraduatedArrows, vmChoropleths, vmCharts
|-
| VisualizationTypeType || vtProportionalBar, vtProportionalCircle, vtProportionalSquare, vtProportionalLine, vtProportionalArrow, vtGraduatedBar, vtGraduatedCircle, vtGraduatedSquare, vtGraduatedLine, vtGraduatedArrow, vtChoropleth, vtPieChart, vtWingChart, vtBarChart, vtDividedPieChart, vtDividedWingChart, vtDividedBarChart, vtStackedBarChart, vtPercentageStackedBarChart
|-
| ScalingModeType || 0=scaling by representation ratio, 1=scaling by max. size
|-
| DataClassificationMethodType|| cmManual, cmNaturalBreaks, cmEqualIntervals, cmQuantiles
|-
| ColorType || CMYK color definition [0..255]: C=84 M=0 Y=128 K=0
|}

=== Thematic Map Script Examples ===
The following example creates a '''thematic map''' with proportional squares about the population in europe 2011.
<PRE>
<?xml version="1.0" encoding="UTF-8"?>
<OcadScript>
<OcadVersion>OCAD 2018 - Mapping Solution 32-bit</OcadVersion>

<File.New>
<File>Thematic Map.ocd</File>
<MapScale>25000000</MapScale>
</File.New>

<File.SaveAs>
<File>Thematic Map Population Europe ProportionalSquare.ocd</File>
</File.SaveAs>

<File.CreateThematicMap>
<MapTheme>
<Name>Population 2011</Name>
<StatDataPath>C:\import\population.xls</StatDataPath>
<StatDataTable>Sheet0$</StatDataTable>
<StatDataCommonField>id</StatDataCommonField>
<VisualizeAttributes>2011</VisualizeAttributes>
<AttributesValuesType>absolute</AttributesValuesType>
<Classify>no</Classify>
<RepresentationFeature>point</RepresentationFeature>
<GeometryDataPath>C:\import\europe.shp</GeometryDataPath>
<GeometryDataCommonField>ne_10m_adm</GeometryDataCommonField>
<JoinType>0</JoinType>
<VisualizationMethod>vmProportionalSymbols</VisualizationMethod>
<VisualizationType>vtProportionalSquare</VisualizationType>
<VisualizationProperties>
<ScalingMode>1</ScalingMode>
<MaxSize>30.00</MaxSize>
<MinSize>1.00</MinSize>
<FillColor>C=84 M=0 Y=128 K=0</FillColor>
<StrokeColor>C=0 M=0 Y=0 K=181</StrokeColor>
<StrokeMaxWidth>0.40</StrokeMaxWidth>
<StrokeMinWidth>0.08</StrokeMinWidth>
<DecreaseStroke>true</DecreaseStroke>
<ShowZeroValue>true</ShowZeroValue>
<ShowNoData>true</ShowNoData>
<Opacity>80</Opacity>
<ThemeLegendTitle>Population</ThemeLegendTitle>
</VisualizationProperties>
</MapTheme>
<MapTitle>Population in Europe 2011</MapTitle>
<DefaultTextStyle>
<Color>C=0 M=0 Y=0 K=150</Color>
<Opacity>100</Opacity>
Arial
<Size>9.0</Size>
<isBold>0</isBold>
<isItalic>0</isItalic>
<Alignment>0</Alignment>
</DefaultTextStyle>
<MapTitleStyle>
<Opacity>80</Opacity>
<Size>24.00</Size>
<Alignment>1</Alignment>
</MapTitleStyle>
<AddThemeLegend>true</AddThemeLegend>
<AddBasemapLegend>true</AddBasemapLegend>
<LegendTitleStyle>
<Size>12.0</Size>
</LegendTitleStyle>
<LegendTextStyle>
<Size>9.0</Size>
</LegendTextStyle>
<AddScaleBar>true</AddScaleBar>
<AddScaleText>true</AddScaleText>
<AdditionalInformationText>OCAD ThematicMapper sample map</AdditionalInformationText>
</File.CreateThematicMap>

<File.Save>
<Enabled>true</Enabled>
</File.Save>
</OcadScript>
</PRE>

==XML Script Partial Map==
{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:50em" | Values / Description
|-
| Export || File coordSystem L, R, B, T|| String Enum types Float|| eg.: ‚ c:\export\PartialMap1.ocd ‘ OCAD creates files PartialMap1_#verticalPages_#horizontalPages.ocd mm (paper, m (real world) left, right, bottom, top
|-
| Export.loop || Enabled HorizontalPages VerticalPages HorizontalOverlap VerticalOverlap || Bool Integer Integer Float Float || true, false number of pages in horizontal direction number of pages in vertical direction horizontal overlap in [mm] or [m] vertical overlap in [mm] or [m]
|}

=== Example ===
The following example exports parts of an ocad map. 
<PRE>
<ocadScript> // comment
<partialMapScript> 
<export id="0"> // first export section
<file>c:\export\PartialMap1.ocd</file> // export file
<coordSystem>mm</coordSystem> // paper oder real world coordinates
<T>100</T> // export rectangle with Top Left point and Bottom Right point
<L>0</L>
50
<R>50</R>
<loop> // the loop export several ocd files. For this example 21 files.
<enabled>true</enabled>
<horizontalPages>7</horizontalPages>
<verticalPages>3</verticalPages>
<horizontalOverlap>10</horizontalOverlap> // horizontal and vertical overlap.
<verticalOverlap>10</verticalOverlap>
</loop>
</export>

<export id="1"> // second export section
<file>c:\export\PartialMap2.ocd</file>
<coordSystem>mm</coordSystem>
<L>0</L>
<R>50</R>
50
<T>100</T>
<loop> // export only one ocd file
<enabled>false</enabled>
</loop>
</export> 
</partialMapScript>
</ocadScript>
</PRE>

==XML Script Print==

Print parameters can be saved in a XML script.

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Print.Printer || Name DmPaperSize DmDefaultSource DmPrintQuality DmColor DmMediaType || String Integer Integer Integer Integer Integer || Eg. ,HP Color LaserJet 2840 PCL' File->Print->Save XML Script->Open the Script and depending on which printer was choosen, the informations are there.
|-
| File.Print.Portrait || Enabled || Bool || true, false
|-
| File.Print.SpotColor || Enabled Colors|| Bool String|| true, false Name of the spot color(s)
|-
| File.Print.PartOfMap || Range Coordinates L, R, B, T || Integer Enum types Float || 1 mm (page), m (real world) Left, Right, Bottom, Top
|-
| File.Print.HorizontalOverlap ||   || Float ||
|-
| File.Print.VerticalOverlap ||   || Float ||
|-
| File.Print.PrintScale ||   || Integer || Eg. 25000
|-
| File.Print.Copies ||   || Integer || Number of copies
|-
| File.Print.Intensity ||   || Integer ||  
|-
| File.Print.LineWidth ||   || Integer ||  
|-
| File.Print.PrintScreenGrid || Enabled PrintScreenGridColor || Bool Integer || true, false Ocad color number
|}

==XML Script Export==

Watch out for the file endings. Resolution is only used if File.Export.GeoRef -> Enabled = false

===AI (Adobe Illustrator), PDF===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:20em" | Values / Description
|-
| File.Export || File Format Resolution ExportScale|| String Enum types Integer Integer|| eg.: ,c::\Export\Chlosterwald.ai‘ AI, PDF in dpi [40..2540] (only if the map has raster background maps) eg. '10000' for the scale 1:10'000
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|-
| File.Export || Colors || Enum types || normal, spotColors
|-
| File.Export.SpotColors || Combine Enabled|| Bool String|| true, false [only if Colors = spotColors] Spotcolor name [only if Colors = spotColors]
|}

===BMP, GIF, JPEG, PNG===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format Quality Resolution Anti-Aliasing ColorCorrection|| String Enum types Integer Integer Boolean Boolean|| eg.: ‚c:\Export\Chlosterwald.bmp‘ BMP, GIF, JPEG, PNG only for JPEG, [0..100] in dpi [40..2540] true, false true, false
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top for rotated maps use here the coordinate of the upper left und lower right corner
|-
| File.Export.Tiles || Enabled Width Height || Boolean Integer Integer || true, false [only if Enabled = true] [only if Enabled = true]
|-
|File.Export.GeoRef|| Enabled PixelSize CreateWorldFile || Bool Float Bool || true, false in meter [only if Enabled = true] true, false [only if Enabled = true]
|}

===EPS===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format ExportScale|| String Enum types Integer|| eg.: ‚c:\Export\Chlosterwald.eps ‘ EPS e.g. '10000' for the scale 1:10'000
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|-
| File.Export || Colors || Enum types || normal, spotColors
|-
| File.Export.SpotColors || Enabled || Spotcolor name || [only if Colors = spotColors]
|}

===SVG (Scalable Vector Graphics)===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format ExportScale CompressFile|| String Enum types Integer Boolean|| eg.: ‚c:\Export\Chlosterwald.svg ‘ SVG e.g. '10000' for the scale 1:10'000 true, false
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|}

===TIFF===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:20em" | Values / Description
|-
|File.Export || File Format Resolution Anti-Aliasing ColorCorrection|| String Enum types Integer Boolean Boolean|| eg.: ‚c:\Export\Chlosterwald.tif‘ TIFF in dpi [40..2540] true, false true, false
|-
| File.Export.PartOfMap || Enabled Coordinates L, R, B, T || Bool Enum types Float || true, false mm (page), m (real world) left, right, bottom, top
|-
|File.Export.Tiles || Enabled Width Height || Bool Integer Integer || true, false [only if Enabled = true] [only if Enabled = true]
|-
|File.Export.GeoRef|| Enabled PixelSize CreateWorldFile || Bool Float Bool ||true, false in meter [only if Enabled = true] true, false [only if Enabled = true]
|-
| File.Export || Colors || Enum types || normal, spotColors
|-
| File.Export.SpotColors || Combine Enabled || Bool Spotcolor name || true, false [only if Colors = spotColors] [only if Colors = spotColors]
|-
|File.Export || ColorMode || Integer || 0 = 32 bit CMYK 1 = 24 bit RGB 2 = 256 colors 3 = grayscale 4 = 8 bit CMYK 5 = 1 bit black/white 6 = halftone screen [only if spotColor = true]
|-
|File.Export || Compression || Integer || 1 = no compression 2 = CCITT [only used with ColorMode 5/6] 4 = FaxG4 [only used with ColorMode 5/6] 5 = LZW
|}

===DXF===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:19em" | Values / Description
|-
| File.Export || File Format ExportScale ConvertAnsiToOem ConvertOemToUnicode ObjectsSelectedSymbols AddSymbolDescription UseCrtFileName ExportAsSplines Coordinates || String Enum types Integer Boolean Boolean Boolean Boolean String Boolean Enum types|| eg.: ‚c:\Export\Chlosterwald.dxf ‘ DXF e.g. '10000' for the scale 1:10'000 true, false true, false true, false true, false eg.: ‚c:\CRT\Chlosterwald.ocdCrt‘ true, false m, mm
|}

===Shape===

{| class="wikitable" style=" border="1"
|-
! style="width:13em" | Node <OcadScript>
! style="width:12em" | Parameter
! style="width:8em" | Data type
! style="width:25em" | Values / Description
|-
| File.Export
|| ExportPath File Format PointObjects LineObjects AreaObjects TextObjects EnvelopePolygonFromTextObjects Dataset WordWrap ProjectionFile Utf8Encoding
|| String String Enum types Boolean Boolean Boolean Boolean Boolean String Integer Boolean Boolean Boolean
|| eg.: ‚c:\Export‘ (only path name) eg.: ‚c:\Export\test.shp‘ (using ExportPath OR File, not both) SHAPE true, false true, false true, false true, false true, false all for all databases 1, 2, 3, ... for only one database true, false true, false true, false
|}

===Example===

The following example exports two pdf files in spot colors and two Shape files. Each OcadScript node can contain many
children.

<?xml version="1.0" encoding="ISO-8859-1"?>
<OcadScript> 
<File.Open>
<File>M:\OCAD2018\Changes\11-06xx\11-0663\Chlosterwald.ocd</File>
</File.Open> 
<File.Export> //PDF export
<File>M:\OCAD2018\Changes\11-06xx\11-0663\output\Chlosterwald.pdf</File>
<Format>PDF</Format>
<PartOfMap>
<Enabled>true</Enabled>
<Coordinates>mm</Coordinates>
<L>0</L>
<R>50</R>
50
<T>100</T>
</PartOfMap>
<ExportScale>10000</ExportScale>
<Colors>spotColors</Colors>
<SpotColors>
<Combine>false</Combine>
<Enabled>Blau</Enabled>
<Enabled>Gelb</Enabled>
</SpotColors>
</File.Export>

<File.Export> //Shape export
<ExportPath>M:\OCAD2018\Changes\11-06xx\11-0663\output\</ExportPath>
<Format>SHAPE</Format>
<PointObjects>false</PointObjects>
<LineObjects>true</LineObjects>
<AreaObjects>true</AreaObjects>
<TextObjects>false</TextObjects>
<EnvelopePolygonFromTextObjects>false</EnvelopePolygonFromTextObjects>
<Dataset>all</Dataset>
<WordWrap>true</WordWrap>
<ProjectionFile>false</ProjectionFile>
</File.Export> 
<File.Save>
<Enabled>true</Enabled>
</File.Save> 
<File.Close>
<Enabled>true</Enabled>
</File.Close>
</OcadScript>

==Run XML Script from the Command Line==

It is possible to execute a XML script file from the command line or from batch file.

Open the Windows command and enter the OCAD program name and the xml script file.
For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" "C:\Data\ExportScriptExample_PDF.xml"

Use the parameter ''/NewInstance'' to always create new OCAD instance.
For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" /NewInstance "C:\Data\ExportScriptExample_PDF.xml"

Do not forget to use the parameter <File.Open> to open the file, <File.Close> to close it and <File.Exit> to close OCAD.

==Open ocd File from the Command Line==
It is possible to open an ocd file from the command line with optional view parameters.

Open the Windows command and enter the OCAD program name and the ocd file name.

For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" "M:\Data\Map.ocd"

Additional OCAD supports the following optional view parameters to open an map at desired postion and view scale.

-c: center for view
-s: view scale

For example:

"C:\Program Files\OCAD\OCAD 2018\Ocad2018.exe" -c 710000,231000 -s 2500 "M:\Data\Map.ocd"

----
Back to [[Main Page]]

File:GeoPackageImport3.png

2022-12-22T13:25:41Z

GRS:

Import GeoPackages

2022-12-22T13:25:30Z

GRS:

[[File:Pro40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Std40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]

A GeoPackage (GPKG) is a data format for geographic information system implemented as a SQLite database container.

Choose the *.gpkg format in the file import dialog to import [https://en.wikipedia.org/wiki/GeoPackage GeoPackages].

In the first dialog choose the datasets to import. By default, all datasets with data are selected.

[[File:GeoPackageImport1.png]]

In the second you can choose the database for the layer information and a crt file to convert the imported objects to symbolized objects.

[[File:GeoPackageImport2.png]]

[[File:GeoPackageImport3.png]]