This wiki page describes how the OCAD App works. 
To the main page of the '''[[OCAD App]]''' | To the '''[[OCAD App Data Exchange]]''' page.

[[File:Hint.jpg|30px]] There are small differences between the operating systems Android, iOS and Windows. This documentation has been produced using all three so images may look slightly different at times.

=Registration=
After starting the App, the first thing the user must do is select a language, this also can be changed at any time later by using the [[OCAD_App_Manual#Language|Settings]].

The full functionality of the OCAD App is available after registration. To register the user needs to enter a valid email address and their name.

A user should use the same email address if they use multiple devices. These pieces of information can then be used to manage imports from the App into OCAD Desktop so that user will know from whom an upload comes from and which of their devices.

[[File:Hint.jpg]] If the user has multiple devices they plan to register, the same email address should be used and each device should have a unique name for that user. 
For example: “iPad”, “iPhone”, “Android Tablet”, “Robs Phone” etc. If two devices have the same name it may make importing data from the App to OCAD Desktop confusing to the user as they may not know exactly which device the data comes from.

==Email and Name==
Enter a valid email address: 
[[File:Ocadapp registrationEmail.png|350px]]

After entering a valid email address, the user is prompted to enter their name: 
[[File:Ocadapp registrationName.png|350px]]

After entering a name an email will be sent to the address: 
[[File:Ocadapp requestSent.png|350px]]

Tap on the link in the address to complete the registration. 
[[File:Ocadapp registrationConfirmEmail.png|350px]]

The App will detect the confirmation, tapping on the ''Continue'' button will take the user to the '''[[OCAD_App_Manual#Projects|Projects]]''' page.

==Other Functionality==
The User Interface Language can be changed. 
Using the [[File:settings.svg|border|30px]]button, some settings can be changed.

==Demo Mode==
*The user can evaluate the App using two [[OCAD_App_Manual#Download_a_Sample_Project|sample projects]].
*The user CANNOT download or import any other project.
*The sample projects can be edited in any way, note that certain functions may not work fully such as the GPS functionality which requires being at the real location of the sample maps.
*The user CANNOT upload the sample projects to the OCAD server.
*The user can delete and re-import the sample projects any time.
*No notifications or any other information is sent to OCAD in demo mode.
*The registration page will always be shown until an email address is entered.
*After entering an email address or choosing Demo mode the App will go to the '''[[OCAD_App_Manual#Projects|Projects]]''' page.

==Technical Notes==
*The Registration requires an Internet connection.
*OCAD stores the email address and name for each registered user. It also stores a list of devices for each user, the device name and the device id is stored.
*Only one user can be registered at one time for the App on a single device.
*The user and device registration is NOT a login mechanism. There is no password.
*If the user wants to change email address or name, they must first unregister the user from the device – see '''[[OCAD_App_Manual#User_Settings|User Settings]]'''.
*If the user is unregistered from the device all projects WILL BE PRESERVED on the device, they can continue to be edited, but the user CANNOT Upload or Export the project until a new registration is made.
*If a user has multiple devices, they will NOT be prompted for a name when registering the second and subsequent devices.
*If a user has multiple devices, then unregistering one will remove it from the list of devices for that user on the OCAD server. When the last device is unregistered, the user will also be deleted.

=Projects=
[[File:Ocadapp ProjectsPage.png]]

The projects page will contain a list of projects.

==Add Project==
To Add a project, it must be imported to the App. During this process, an OCAD file is converted into a native App format which provides better performance for drawing and viewing large maps. 
Tap on the [[File:Project add.svg|border|30px]] button to add a project.

[[File:Ocadapp AddProject.png]]

When adding a project, it will first be downloaded, then processed, this could take a few minutes for large projects and depends on Internet speed and device performance. 
The App does not write changes directly to the OCAD file which is stored on the device, all data and changes are stored in internal storage.

===From QR Code===
If your device has a camera that is accessible from the App (permissions may be required) then the user can scan a QR code from OCAD Desktop to download and import a project.

The user can now also scan a QR code using the camera on your device and it will open the OCAD App and start the import of that project.

===From Project ID===
The OCAD Desktop produces a link in the App Data Exchange process; this link contains an ID which can be pasted into the entry field. If a link or id is detected on the clipboard it will be automatically pasted into the ID field. 
For example: <nowiki>https://app.ocad.com/project/6da31400-4a94-43e8-7ae6-8e8ece235b04</nowiki>

[[File:Ocadapp DownloadProject.png|400px]]

The user can paste the whole link or just the ID.

If the user has this link in an email or other message it can now be tapped/clicked which will open the OCAD App and download the project.

===From Folder===
Although it is generally preferred and recommended to use the OCAD Cloud Transfer Services to move projects back and forth from the OCAD Desktop to the OCAD App, there may be times when manual copying of data is required. For example:
*The user has no internet connection
*The transfer project or even map file has been lost on OCAD Desktop so the user cannot use the cloud-transfer to retrieve the map.
*The user is concerned about the security of their project being on the internet.

There are slightly different techniques depending on whether the device is Android or iOS. The process involves:
#OCAD Desktop export
#Copying to the iOS or Android device
#Importing on the device
#The user makes changes to the project on the device
#Export from the device
#Copy from the iOS or Android device to the Windows computer
#Import to OCAD Desktop

Information about these processes can be found in the '''[[OCAD_App_Manual#Appendix_C_-_Folder_Transfer|Appendix C]]'''.

===Sample Projects===
The two sample projects can be downloaded at any time.

===Download a Sample Project===
The two sample projects can be downloaded at any time.
*The sample projects can be edited in any way, note that certain functions may not work fully such as the GPS functionality which requires being at the real location of the sample maps.
*The user CANNOT upload the sample projects to the OCAD server.
*The user can delete and re-import the sample projects any time.

==The projects page==

===Refresh the Projects List===
To refresh the projects list, tap on the [[File:Refresh.svg|border|30px]] button. See [[OCAD_App_Manual#Project_Update_from_Desktop|Project Update from Desktop]] for more details.

===Settings===
Tapping the [[File:Settings.svg|border|30px]] button will take the user to the settings page, see [[OCAD_App_Manual#Settings_2|Settings]]

===Internet Status===
At the bottom of the Projects page there is a small cloud icon beside the App version information: 
[[File:Ocadapp InternetStatus.png| px]]

Tapping on the cloud will reveal the internet status and if the App is connected to the OCAD server: 
[[File:Ocadapp InternetStatusConnected.png| px]]

If the user cannot download or upload a project, then it could be that the device has either:
*no internet connection – a red cloud
*a problem with connection to the OCAD server – an orange cloud

An error message will appear indicating the problem beside the cloud icon. 
[[File:Hint.jpg]] The App does not maintain a permanent connection to the OCAD server, it is only required when:
*Downloading a project
*Uploading a project
*Updating a project
*Refreshing the list of Projects
*Registering the user
*Sending log files or projects to OCAD Support

===The Projects List===
The list of projects can be displayed as tiles [[File:Grid view.svg|border|30px]] or as a list [[File:Bulleted list.svg|border|30px]] by toggling the button on the top right:

[[File:Grid view.svg|border|30px]] Tiles 
[[File:Ocadapp ProjectListTiles.png|300px]]

[[File:Bulleted list.svg|border|30px]] List 
[[File:Ocadapp ProjectListList.png|300px]]

The projects can also be sorted alphabetically by name or by modified date (newest at the top): 
[[File:Ocadapp ProjectListSort.png|200px]]

==Project Management==
Tap on the project to open it.

Tapping on the [[File:More vert.svg|border|30px]] button will open the project options:

[[File:Ocadapp ProjectOptions.png|500px]]

===Open===
Tapping on the project '''Open''' button will also open the project.

===Upload===
Once changes have been made, the project can be uploaded to the OCAD server, then imported to the OCAD Desktop. 
A positioning file can be optionally included when uploading. This will make a ''position.db'' file available for import into OCAD Desktop.

===Delete===
A project can be deleted; a confirmation warning is shown. There is no way to reverse this action.

===Advanced===
Other functionality may appear here, currently:
*Export
*QR Code
*Repair
*Backups
*Send Project to Support

[[File:Ocadapp_ProjectManagementAdvanced2.png]]

'''Export''' 
See the [[OCAD_App_Data_Exchange|OCAD App Data Exchange]] page for more information. Tapping on the “Include positioning file” checkbox above will also export the position.db file.

'''QR Code''' 
This QR represents the selected project, it can be used to download the project to a new device. Note that:
*It will download the latest version of the project that was exported from OCAD Desktop and exists on the OCAD Cloud transfer service.
*It requires an internet connection.
*The downloaded project will have the same permissions that were set up in the Cloud Transfer Service.

Use this function to easily share a project with friends or download the project to a secondary device.

'''Repair''' 
This function repairs the map tiles which are used for the map rendering. Try it when the map layer and/or the project thumbnail preview in the project list show only white pixels or if the App crashes when opening a project.

'''Backups''' 
The '''Backup Actions''' popup window opens after tapping on this menu item. There you can choose one of them and use it to do a '''Restore''' or an '''Upload''' to the OCAD Cloud Transfer. 
[[File:Ocadapp_ProjectManagementAdvanced_BackupActions.png]]

Note that '''Restore''' will replace the current version of your project on the device.

'''Send Project to Support''' 
When sending a project to OCAD Support the user will be prompted to enter a reason for sending it. Please only send projects if:
*We have requested you to do so to provide support which could include fixing a bug or recovering data.
*The project cannot repeatedly be opened and the user needs help.
Note that background files and images are NOT included when sending a project to OCAD Support. Sending a project to OCAD Support requires an internet connection.

===Project Status===
The most recent download/upload action is shown below the project. 
Beside it is a small green arrow, tapping this arrow will open the History below. 
[[File:Ocadapp ProjectStatus.png|320px]]

Tapping the small arrow or list will close it again. 
[[File:Ocadapp ProjectStatusCloseHistory.png|320px]]

For example, if there is a new update of a project on the OCAD server then refreshing the list will provide an indication of this, see [[OCAD_App_Manual#Project_Update_from_Desktop|Project Update from Desktop]].

===Project Update from Desktop===
If the project has been updated and exported from the Desktop,
then refreshing the Projects list will indicate that an updated version of the Project is available for download.

[[File:Ocadapp ProjectUpdateDesktop.png|485px]]

Tapping the [[File:Cloud update.svg|border|30px]] button will update the Project on the App, or alternatively use the Update option:

[[File:Ocadapp CloudUpdate.png|485px]] 
'''Important!''' When updating, only Background maps and a few settings for the project are preserved. All other data is deleted, and new data is re-imported. 
If the user has any changes that have NOT been uploaded to the OCAD Server and then imported and merged with the OCAD file on the Desktop, then those changes will be lost!

The other possible notification here is if the transfer project has been deleted on the OCAD Desktop. 
If this is the case, and there are changes that need transferring to the OCAD Desktop, then the project will need to be exported from the App and manually transferred to the user’s computer.

Note: These notifications for cloud transfer projects will only appear if the App is connected to the Internet and the OCAD Server – see [[OCAD_App_Manual#Internet_Status|Internet Status]].

===Project Lifecycle===
When a project is exported from the OCAD Desktop to the OCAD Cloud Transfer it will remain on the server for 7 days. After that it will be automatically deleted.

However, the project could still obviously be in use both on the App and on OCAD Desktop. The user can still upload (or export) the project and then import changes from the App.

=Project Editing=
After opening a project, the map and editing tools will be seen on the Project page:

[[File:Ocadapp ProjectEditing.png|600px]]

==Project Toolbar==

[[File:Ocadapp ProjectToolbar.png|600px]]

'''Important:''' There is no ''Save'' button on the OCAD App. All changes are saved almost immediately to internal storage. 
Note that some actions need to be completed before saving will occur – such as drawing a line or area object.

===Close===
The project can be closed using the [[File:Close cross.svg|border|30px]] button.

===GPS Functions===
GPS functions are accessed via the [[File:Location line.svg|border|30px]] button. See [[OCAD_App_Manual#GPS_Functions_2|GPS Functions]] for more details.

===Map Layers and Notes===
To open a panel containing information about map layers and notes tap the [[File:Detail panel.svg|border|30px]] button. 
This panel contains two tabs, firstly for [[OCAD_App_Manual#Map_Layers|map layers]]: 
[[File:Ocadapp MapLayer.png| px]]

and secondly for [[OCAD_App_Manual#Notes|notes]]: 
[[File:Ocadapp Notes.png| px]]

This panel can behave as either a temporary “popup” panel or docked to the right-hand side by tapping the [[File:Panel right docked.svg|border|30px]] button on the right: 
[[File:Ocadapp PanelRightDocked.png| px]]

If the panel is docked, then the width can be adjusted by dragging the left edge of the panel. 
[[File:Ocadapp PanelDrag.png| px]]

===Settings===
Tapping the [[File:Settings.svg|border|30px]] button will take the user to the settings page, see [[OCAD_App_Manual#Settings_2|Settings]].

==Status Bar==
Below the project toolbar is a status bar which provides various pieces of information such as:
*The stylus / finger / mouse actions that are available for the currently active tool.
*The type of selected objects and how many of each.
*The length or surface area if one object is selected.
*The GPS status on the device.

[[File:Ocadapp StatusBar.png| px]]

===Interactions===
The [[File:Tap.svg|border|30px]] icon indicates that the map will accept a tap action on the map for the currently active tool, the associated text describes the behavior.

The [[File:Finger drag.svg|border|30px]] icon indicates that the map will accept a swipe/drag type action on the map for the currently active tool, the associated text describes the behavior.

If the screen is too narrow to display the texts, then tapping the icons will display them:

[[File:Ocadapp InteractionsTap.png| px]]

===Selections===
Selecting many objects on the map generates a summary of the selection in the status bar. 
Depending on how many objects are selected, this could be a single count or a count per symbol type:

[[File:Ocadapp Selection.png| px]]

In this case 3 knolls [[File:Ocadapp SelectionKnoll.png| px]], 1 track [[File:Ocadapp SelectionTrack.png| px]] and 5 green areas [[File:Ocadapp SelectionGreenArea.png| px]]

Tapping on the symbol icons in the status bar will show a panel with details of the selection. 
Tapping on the items in the panel will select and deselect them. 
By recursively filtering a selection using this functionality the user can drill down to one or more specific objects that they want to edit or delete.

In this example the user has tapped the second and fourth green areas which are now selected in the list, so they are selected on the map:

[[File:Ocadapp SelectionSelectGreenArea.png]]

Tapping outside the panel will close it leaving the desired objects selected. 
In the following example the user chooses all the green, yellow and brown dotted areas:

[[File:Ocadapp SelectionSelectGreenYellowDottedArea.png]]

Then closes the popup panel and selects 3 green and 2 yellow areas:

[[File:Ocadapp SelectionSelectGreenYellowArea.png]]

This technique means the user can easily iteratively filter objects so that only the desired ones remain selected.

More information about editing selected objects can be found in [[OCAD_App_Manual#Editing_Selected_Map_Objects|Editing Selected Map Objects]].

To close the small panel just tap again on the map outside the panel.

===Measurements===
If one object is selected, then its length or area is shown.

Length 
[[File:Ocadapp MeasureLength.png| px]]

Area 
[[File:Ocadapp MeasureArea.png| px]]

===GPS Status===
The GPS icon shows the state of the GPS connection:

[[File:Ocadapp GPSStatus.png|150px]]

Red: No connection or the user is outside the map area. 
Orange: Poor connection if the accuracy is > 20m. 
Green: Good connection with accuracy < 20m. 
Tapping on the icon will show a text message indicating Lost, Poor or Good connection status.

==Map==
Below the main toolbar and status bar is the map.

===Finger Gestures===
All the tools have various gestures, most of which are intuitive such as the two-finger pinch to zoom in and out. 
This gesture works on all tools. Other gestures are described in the sections for each respective tool.

===Buttons===
Near the top of the map is a compass and some buttons:

[[File:Ocadapp Buttons.png|600px]]

Note that if the user’s device does not have a GPS or Compass then some of these buttons may be hidden.
*The [[File:Zoom extent.svg|border|30px]] button which zooms to the whole extent of the map. This button can change to the button if the map is not orientated to north on the device.
*The [[File:Zoom in.svg|border|30px]] button can be used to zoom in.
*The [[File:Zoom out.svg|border|30px]] button can be used to zoom out.
*The [[File:Counter 1.svg|border|30px]][[File:Counter 2.svg|border|30px]][[File:Counter 3.svg|border|30px]] buttons which are configurable zoom buttons. See [[OCAD_App_Manual#Configurable Zoom Buttons|Configurable Zoom Buttons]].
*The [[File:Position.svg|border|30px]] button can be used to re-center the map to the user’s position – if the device has a GPS. By double-tapping the button it will change to [[File:Position auto.svg|border|30px]] and the device will keep the map centered as the user moves.
*The [[File:Compass.svg|border|30px]] button can be used to orientate the map to north on the device. Double-tapping it and the button will change to [[File:Compass auto.svg|border|30px]] which means the device will keep the map orientated to north as the user moves.

===Configurable Zoom Buttons===
The App has 3 configurable buttons which can be set to different zoom scales. They are not set to any specific numeric scale. 
When tapping one of these zoom buttons the App will go to the specified scale, auto-rotate and auto-center the map (if the device has a compass and GPS). 
The auto-rotate and auto-center functions can be turned off in the [[OCAD_App_Manual#Zoom|Settings]].

When starting the App the first time a red [[File:Counter 1_red.svg|border|30px]] zoom button will appear, tapping it will open the Quick-configuration panel:

[[File:Ocadapp ConfigurableZoomButtoms.png|350px]]

Tapping the Set button will set the [[File:Counter 1.svg|border|30px]] button to the current map scale. Tapping the checkbox to the left will hide the button on the map.

The user can configure up to 3 buttons to different zoom levels. 
To change a button to a different zoom level, just zoom to that level, open the panel using the [[File:Settings_rect.svg|border|30px]] button on the map toolbar and tap Set again.

===Scale Bar===
At the bottom of the map is a scale bar.

[[File:Ocadapp ScaleBar.png| px]]

==Map Toolbar==
Central to all map editing is the toolbar which could look something like this depending on the type of editing tool selected:

[[File:Ocadapp MapToolbar.png| px]]

It can be moved to a new location using the [[File:Drag.svg|border|30px]] button on the bottom left. It can also be docked to the bottom of the App – see [[OCAD_App_Manual#Toolbar_Position|Settings - Toolbar Position]].

It can be resized using the [[File:Resize.svg|border|30px]] button on the bottom right.

===Button Themes===
Some buttons have a background theme:
*Green – confirmation button to complete a process.
*Red – destructive button to cancel a process or delete something.
*Blue – a behavior to change how a tool works – only ''one'' or ''none'' can ever be active.
*Yellow – an option to change how a tool works – ''none, one or many'' can be active.

===Button Rows===
There are four main types of rows in the toolbar:
*Top row – contains behaviors, options, and actions appropriate to the current active tool.
*Notes + Sketch row – contains the Notes [[File:Bubble text.svg|border|30px]] button on the left and the sketch color buttons.
*Symbol buttons – in the example above there are two rows of symbols, to access other symbols not in the two rows tap on the symbol selector [[File:Grid.svg|border|30px]] button to the left.

[[File:Hint.jpg]] Long-press on a symbol to see its symbol number and symbol name.

*Bottom row which contains:
**The Drag [[File:Drag.svg|border|30px]] button.
**The Undo [[File:Undo.svg|border|30px]] and Redo [[File:Redo.svg|border|30px]] buttons, see [[OCAD_App_Manual#Undo_-_Redo|Undo - Redo]].
**The Pan [[File:Pan.svg|border|30px]] button.
**Sometimes the symbol selector [[File:Grid.svg|border|30px]] button can appear here if there are no rows of symbols above.
**The Select [[File:Select.svg|border|30px]] button, see [[OCAD_App_Manual#Selections|Status bar Selection]] and [[OCAD_App_Manual#Editing_Selected_Map_Objects|Editing Selected Map Objects]].
**The Draw [[File:Stylus.svg|border|30px]] button which changes icon depending on what is to be drawn. The icon can be either a Sketch color & width or a symbol, see [[OCAD_App_Manual#Drawing_Objects|Drawing New Map-Objects]] and [[OCAD_App_Manual#Drawing|Sketch – Drawing]].
**The Sketch Erase [[File:Eraser.svg|border|30px]] button, see [[OCAD_App_Manual#Erasing|Sketch - Erasing]].
**The Quick Configuration [[File:Settings rect.svg|border|30px]] button, see [[OCAD_App_Manual#Map_Toolbar|Map Toolbar]].
**The resize [[File:Resize.svg|border|30px]] button on the bottom right.

Note that the Sketch/Note and Symbol rows can be scrolled horizontally if the screen device is not wide enough for all buttons:

[[File:Ocadapp ButtonRowsScroll.png| px]]

See also [[OCAD_App_Manual#Drawing_2|Settings – Drawing]] and [[OCAD_App_Manual#Symbols|Settings – Symbol favorites]] for more configuration options.

===The Quick Configuration Button===
The quick configuration [[File:Settings rect.svg|border|30px]] button displays a panel where the user can quickly perform the following options:
*Turn on or off editing Sketches – this will hide all Sketching and erasing tools.
*Turn on or off editing of map objects – this will hide all Map-object editing tools.<nowiki>*</nowiki>
*Set the [[OCAD_App_Manual#Configurable_Zoom_Buttons|configurable zoom buttons]].
*Change the symbol toolbar rows to a different ''Symbol favorites''. See [[OCAD_App_Manual#Symbols|Settings – Symbol favorites]] for more information.
*Tapping the [[File:stylus.svg|border|30px]] button will take the user to the Settings page and [[OCAD_App_Manual#Symbols|Symbol Favorites tab]].

[[File:Ocadapp QuickConfigButton.png| px]]

<nowiki>*</nowiki> If the current project was exported [[OCAD_App_Data_Exchange#Arrange_Export|without the permission for Map-Object editing]] then the ''Edit map objects'' option here will be Off and disabled.

==Drawing New Map Objects==
There are point, line and area Symbols, each have differing behavior, option, and actions buttons.

[[File:Ocadapp DrawingObjects.png| px]]

To start drawing tap on one of the symbols, this symbol becomes the active drawing tool which can be seen in the lower toolbar.

To select a different symbol which is not in the user’s rows of symbols tap on the symbol selector [[File:Grid.svg|border|30px]] button to show a panel with all other symbols:

[[File:Ocadapp SelectAnotherSymbol.png|650px]]

An alternative way to change the symbol is to select a map object of the desired symbol type. Note that this will NOT change the active tool in the App to the drawing tool.

[[File:Ocadapp ChangeSymbolSelectMapObject.png| px]]

In the above example a green object is selected, and so the drawing symbol type is changed to the green symbol. 
The selection tool is still active. To start drawing green symbols just tap on the green symbol drawing button in the toolbar.

===Points===
Point objects can be created with a single tap to screen. If the point objects can be placed directionally then tap and drag to adjust the orientation, releasing the drag will create the object.

===Lines and Areas===
The default behavior for drawing lines is to use the curve-and-straight behavior [[File:Draw curve straight.svg|border|30px]]

[[File:Ocadapp DrawCurve.png| px]]

If the user taps and drags the stylus/finger/mouse a Bezier curve will be created, but if the user taps and releases, then taps again elsewhere then straight lines will be created between the tapped points.

[[File:Ocadapp DrawRectangular.png| px]]

The rectangular [[File:Draw rectangular.svg|border|30px]] behavior can be used too:

[[File:Ocadapp DrawRectangularBuilding.png| px]]

Use the ''backspace'' [[File:Backspace.svg|border|30px]] button to remove the last added point.

===Re-using Geometry - Following===
When using the curve behavior, it is possible to ''follow'' the geometry of one or more other existing line/area objects by using the follow [[File:Snap and follow.svg|border|30px]] option. 
In the following example the green area is drawn following the track to the north, then the edge of the yellow, then across the white forest and then follows the dashed track. 
When the finger/stylus/mouse is following a line, it shows a light blue cursor on that line – this blue circle is only visible on Android devices:

[[File:Ocadapp FollowingOption.png| px]]

===Finishing or Discarding===
To finish drawing a line or area tap on either the finish [[File:Finish line.svg|border|30px]] or finish-and-close [[File:Finish close.svg|border|30px]] buttons:

[[File:Ocadapp FinishingButtons.png| px]]

This will save the object on the device. Note that area objects only have the finish-and-close button.

If the user wants to discard the entire new object before finishing, they can tap the [[File:Delete bin.svg|border|30px]] button.

===Object Preview===
Object preview while drawing only works on Android and with a special stylus, but not on iOS.

==Editing Selected Map Objects==
The user can select one or many objects at the same time when the selection tool [[File:Select.svg|border|30px]] is active.

[[File:Ocadapp SelectionTool.png|350px]]

As mentioned in [[OCAD_App_Manual#Selections|Status bar - Selection]], the status bar at the top contains information about what is selected.

===De-selecting Map Objects===
To de-select map objects either:
*Tap outside the area covered by the selected objects.
*Tap again on the select tool [[File:Select.svg|border|30px]].

===Edit Actions===
When objects are selected:

*They can be deleted using the delete [[File:Delete bin.svg|border|30px]] button on the toolbar.
*They can be converted to objects of a different symbol type using the change-symbol [[File:Change symbol.svg|border|30px]] action:

[[File:Ocadapp ChangeSymbol.png|650px]]

It is only possible to change points to points, but lines and areas can be changed to lines OR areas. Here five objects which are of three different green symbols are changed to an orange symbol.

*They can have their direction or side changed using the side/direction [[File:Reverse.svg|border|30px]] action if the selected symbols have such attributes:

[[File:Ocadapp ReverseSymbol.png|650px]]

There are different behaviors that the finger/stylus/mouse can have when using the selection tool: edit, cut, re-shape, and add/remove points, these are described below.

===Edit Selection Behavior===
'''Important:''' There is NO button for this default edit behavior, it is active when NO OTHER behavior is selected.
:[[File:Ocadapp EditSelectionBehavior.png]]

When using this behavior, the user can:
*Move objects.
*Rotate directional point objects.
*Edit the object’s geometry.

'''Move objects'''
:To move all the selected objects, tap and drag the dashed selection rectangle.
:[[File:Ocadapp MoveObejcts.png|200px]]

'''Rotate Directional Point Objects'''
:Directional point objects display a small selection arrow attached to the point. This arrow can be tapped and dragged around the point to change its direction.
:In this example 3 directional point objects are selected and then each is rotated individually:
[[File:Ocadapp RotateDirectionalPointObject.png|200px]]

'''Edit Object Geometry'''
:To edit the geometry, the user can tap and drag one of:
:*A rectangular object’s blue square corner vertex:
::[[File:Ocadapp MoveCornerVertex.png]]

:*A curved object’s blue square side handle to change the size of the object:
::[[File:Ocadapp MoveCurveVertex.png]]

:*A curved object’s blue circle Bezier handle to change the curvature of the side:
::[[File:Ocadapp MoveBezierHandle.png]]

===Cut Selection Behavior===
Select an object and activate the [[File:Cut.svg|border|30px]] behavior. Both lines and areas can be cut.

Cutting a line removes part of that line where the cut is made, this could result in the object being split into two objects if the cut is in the middle; or just a truncation if the cut is near one end or the other.

Cutting an area is demonstrated below.

[[File:Ocadapp ActivateCutBehavior.png| px]]

Tap on the edge and draw a ''cut'' line across the object:

[[File:Ocadapp CutArea.png| px]]

Tap on the finish [[File:Finish line.svg|border|30px]] button to complete the cut.
At any point the last cut-point can be deleted using the [[File:Backspace.svg|border|30px]] button, or aborted using the [[File:Close cross.svg|border|30px]] button. 
There are now two objects selected as can be seen in the status bar:

[[File:Ocadapp AreaCutTwoParts.png| px]]

Either part can now be moved or modified independently:

[[File:Ocadapp EditCutArea.png| px]]

''Note that the current implementation only allows cutting an object in two pieces. Cutting a hole is not [yet] implemented.''

===The Re-Shape Selection Behavior===
The geometry of an existing object can be changed by using the re-shape [[File:Reshape.svg|border|30px]] behavior, select an object and tap the behavior button:

[[File:Ocadapp ReshapStart.png| px]]

Starting on the edge of the object, draw the new geometry, finishing on the line again:

[[File:Ocadapp ReshapeDraw.png| px]]

Tap on the finish [[File:Finish line.svg|border|30px]] button to complete and save the re-shaped map object:

[[File:Ocadapp ReshapeFinish.png| px]]

There is still only one object, but it now has a new geometry.

===Add & Remove Points Behavior===
Geometry points can be added or removed using the Add/Remove Points behavior [[File:Add remove point.svg|border|30px]] button, select an object:

[[File:Ocadapp AddRemovePoints.png| px]]

Tapping on the point on the left will remove it. Tapping on the edge on the right will create a new point:

[[File:Ocadapp AddRemovePointsComplete.png| px]]

''Note that Bezier control points (round blue circles) cannot be removed.''

===Change vertex type===
A vertex can have one of 3 different modes which affect the distribution of dashes and other things along a line. When the vertex type behavior [[File:Ocadapp VertexTypeBehavior.png]] is selected, tapping on a vertex will toggle the vertex type between the 3 different values.
:[[File:Ocadapp NormalVertex.png]] Normal vertex
:[[File:Ocadapp DashVertex.png]] Dash vertex
:[[File:Ocadapp CornerVertex.png]] Corner vertex

[[File:Ocadapp DifferentVertexTypes.png]]

More information about vertices can be found [[Vertices|here]].

===Editing Holes in Areas===
There are no specific tools to add or delete holes in areas (at present), however the points in an existing hole can be moved, added or removed. 
[[File:Hint.jpg]] By removing all the points for the hole, the hole can be deleted. Or by adding/editing points to the hole it can modified or enlarged.

===Hide and Protect Map Objects===
Long-press on a symbol in the map toolbar to hide or protect its objects.

'''Hidden''' 
Hidden map objects are not visible and selectable. 
Hidden symbols appear with a gray cross (x) in the map toolbar.

'''Protected''' 
Protected map objects are visible but not normally selectable. 
Protected symbols appear with a gray diagonal in the map toolbar.

The user can edit protected map objects by selecting the symbol and then changing to the selection tool [[File:Select.svg|border|30px]]. 
While the protected symbol is the active symbol it will be both selectable and the user can create new map objects of that symbol type.

[[File:OCAD App Hide And Protect Objects.png]]

===Course Setting Objects===
Course setting projects can be opened using the App.
There is currently no functionality for editing course setting objects, and the control numbers are now drawn in a fixed position to the north-east of the control circle.

The App can be used as an aid for checking control sites before a competition in much the same way the OCAD Sketch App could.

In the future more functionality will be added to support course setting.

[[File:Ocadapp CourseSettingObjects.png]]

==Minimum Distances==
There is currently no specific tool or way to show the minimum distance between features on a map. We hope to add such functionality sometime in the future.

==Map Layers==
To manipulate the visibility, opacity and transparency of the various layers in the App, open the right-hand details panel and select the layers [[File:Layers.svg|border|30px]] tab on the left.

[[File:Ocadapp MapLayers.png|650px]]

The layers in this list are drawn in the order of the list, so background maps are drawn on the screen first, then the map, and finally the sketches and notes. Only the background maps can have their draw-order changed.

The visibility of any layer can be changed by tapping the Checkbox [[File:Check box.svg|border|30px]]

The sliders [[File:Ocadapp MapLayerSlider.png| px]] are used to adjust the opacity of each layer. Except for the notes where the slider adjusts the size of the note icon on the map.

The transparency of a background layer can be turned on/off user the [[File:Transparent map.svg|border|30px]] button.

The order of the background layers can be adjusted using the drag [[File:Drag.svg|border|30px]] buttons. When the panel is docked and narrow, the names of the background layers are abbreviated while trying to keep them unique in the list. 
To find the actual name of an abbreviated layer name tap on it and a message will briefly appear with the full name.

The [[File:Ocadapp MapLayersShowAllNone.png| px]] buttons turn on/off all background layers at once.

The [[File:Ocadapp MapLayersToggle.png| px]] button will turn on/off the currently selected layers – the App will remember the currently selected layers, which only get updated when tapping on a checkbox or using All or None. 
The number on the button indicates the number of layers the toggle is operating on.

==Sketches==
Sketches are raster drawings placed on top of the map. Using sketches for line and area type objects can be faster and more convenient than drawing map objects on a small device. They are also transferred to the OCAD Desktop.

===Drawing===
The App has different Sketch colors and widths for making sketches.

[[File:Ocadapp Sketches.png|500px]]

Each color always remembers the width used with it, so the user does not have to change width each time they change to a different color. The widths of each color are also visible in the button icons (for example the thick dark green in the image above).

Filtering and sorting unused colors can be done in the [[OCAD_App_Manual#Drawing_2|Settings - Drawing - Sketching]].

The visibility and opacity of all Sketches can be adjusted using the [[OCAD_App_Manual#Map_Layers|Map Layers panel]].

===Erasing===
The eraser tool [[File:Eraser.svg|border|30px]] can be used to delete sketches. The size of the eraser can be adjusted using the slider [[File:Ocadapp EraserSlider.png|150px]] at the top of the map toolbar. 
The eraser is round and removes sketches when the user taps and drags the eraser across the map.

[[File:Ocadapp ErasingSketches.png|500px]]

Resulting in all sketches being removed:

[[File:Ocadapp ErasingSketchesDone.png|500px]]

===Single Color Erasing===
The single-color eraser allows the user to erase sketches of a specific sketch color. The Single-Color Eraser behavior button [[File:Eraser.svg|border|30px]] appears on the top left of the Map Toolbar whenever a sketch color is selected. 
Tapping on another sketch color switches back to sketch drawing. 
In this example the red sketch color is selected, and the “erase single color” behavior is activated:

[[File:Ocadapp SingleColorErasing.png|500px]]

Only the red sketches are erased when dragging across the map:

[[File:Ocadapp SingleColorErasingDone.png|500px]]

The dark green and white sketches remain.

==Notes==
Notes are temporary objects like sketches, placed on top of the map; they have a text field and a color. They are also transferred to the OCAD Desktop.

===Creating a New Note===
Tap the Notes tool [[File:Bubble text.svg|border|30px]] button to start the notes tool which has three behaviors (create, move, select):

[[File:Ocadapp CreateNewNote.png|650px]]

The add note [[File:Bubble add.svg|border|30px]] behavior button should appear. 
Tapping on the map should create a note in that position on the map:

[[File:Ocadapp AddNoteToMap.png|400px]]

The note is represented by an icon on the map. At the same time, a note editor panel will appear on top of the map.

The text editor contains unique default text ''Note 1,2,3'' etc.

The color of a note can be changed by selecting one of the other colors below the text editor using the [[File:Ocadapp NotesColor.png|100px]] buttons. Note that other colors can be added here by changing the list of colors in [[OCAD_App_Manual#Drawing_2|Settings – Drawing - Notes]].

Tapping the [[File:drag_bar_bottom.svg|border|30px]] button to the right of the colors will navigate the user to [[OCAD_App_Manual#Notes_2|Settings – Drawing - Notes]].

When the user starts to create a note, the create-note behavior button changes to a move behavior [[File:Move.svg|border|30px]] button, this will allow the user to reposition the note they are currently editing.

To save the note tap on the [[File:Confirm.svg|border|30px]] button below the text editor.

To discard a note without saving, tap on the [[File:close_cross.svg|border|30px]] button below the text editor.

If the user’s device supports speech-to-text [[File:Ocadapp SpeechToTextIcon.png|30px]] technology, the user can use spoken text to record a note: 
[[File:Ocadapp SpeechToTextNote.png]]

'''Important''': If the user changes tool before confirming/saving a note then the note will be automatically saved. If they did not want this note they could tap undo or delete it.

===Selecting Notes===
When the note tool is active the other behavior is the select notes [[File:Select.svg|border|30px]] button. The user can select one or many notes by tapping or dragging a rectangle on the map:

[[File:Ocadapp SelectNote.png| px]]

When notes are selected the user can:
*Start to edit the note using the edit-note [[File:Edit note.svg|border|30px]] button – ONLY appears if one note is selected.
*Zoom to the selected notes on the map using the zoom-to [[File:Zoom to note.svg|border|30px]] button.
*Delete the selected notes using the delete [[File:delete_bin.svg|border|30px]] button.

To de-select all notes tap elsewhere on the map.

===The Note Icon===
The note icon changes slightly depending on whether it is:
*Being edited (red arrow below)
*Is Selected (2 purple arrows below)
*Is not selected or being edited (the other purple note)

The currently edited note always has a thick border and is shaded; selected notes have shading and a thin border.

[[File:Ocadapp NoteIcon.png|500px]]

===The Notes List===
The details panel on the right-hand side of the App also has a notes tab containing the list of notes and other sorting and filtering functions:

[[File:Ocadapp NotesList.png|500px]]

The notes selection on the list and map is synchronized so selecting one in the list will select it on the map and vice versa.

After selecting one or more notes in the list the user can use the zoom-to [[File:Zoom to note.svg|border|30px]] button on the map toolbar to find those notes on the map. And the [[File:delete_bin.svg|border|30px]] button on the map toolbar deletes those selected notes.

The items in the list only display the first line of a note, the user must edit a note to see the rest of the text.

Double-tapping a note in the list will:
*Zoom to that single note.
*Start the editor for that note so the user can change the text or color. Then the user can:
:*Use the [[File:Confirm.svg|border|30px]] button to save changes.
:*Use the [[File:close_cross.svg|border|30px]] button to discard without changing.

===Notes Sorting===
The user can use the sort [[File:Sort alpha down.svg|border|30px]] button to re-order the notes in the list – this button has four toggle values which cycle when tapped:
*Alphabetical descending [[File:Sort alpha down.svg|border|30px]]
*Alphabetical ascending [[File:Sort alpha up.svg|border|30px]]
*Modification date descending [[File:Sort date down.svg|border|30px]]
*Modification date ascending [[File:Sort date up.svg|border|30px]]

''In the following images in the next section variations of the sorting button can be seen.''

===Notes Filtering===
The notes list can be filtered by either:
*Text
*The Notes appearing in the current map viewport.

''Note that the filter only hides notes from the list, not from the map.'' 
Enter text in the filter field and the list will be filtered:

[[File:Ocadapp NotesFiltering.png| px]]

Tapping the [[File:close_cross.svg|border|30px]] button will clear the text filter.

Turning on the viewport filter [[File:Filter map.svg|border|30px]] button will show only the notes currently visible on the map:

[[File:Ocadapp NotesViewportFilter.png|500px]]

In this case AAA and BBB cannot be seen in the list because they are outside the map’s visible area. Zooming in and out or panning the map will modify the notes in the list as they become visible or hidden.

===Deleting===
There is no warning when deleting one or more notes because it is an undoable action, see [[OCAD_App_Manual#Undo_-_Redo|Undo-Redo]].

===Notes on OCAD Desktop===
To see notes on OCAD Desktop they must be imported in the same way as Sketches. They can then be managed using the '''[[Sketch]]''' menu: 
[[File:Ocadapp NotesonOCADDesktop.png|400px]]

==Undo - Redo==
The Undo [[File:Undo.svg|border|30px]] and Redo [[File:Redo.svg|border|30px]] buttons provide a way for the user to revert an action or re-do one that was recently reverted.

All editing actions are ''undo'' and ''redo''-able as single atomic actions. Atomic actions affect one or many objects at the same time. Some examples of these actions are listed below. 
If an example has the word ''confirm'' afterwards then the undo action occurs when tapping the green confirm button. 
*Creating a point map-object.
*Creating a line or area map-object - confirm.
*Deleting many map objects of different symbol types.
*Moving many objects at the same time.
*Cutting one object – confirm.
*Re-shaping one object - confirm.
*Adding or deleting a single geometry point.
*Changing direction or side of many objects at the same time.
*Changing many different objects of differing symbols to one symbol type.
*Drawing a single sketch.
*Erasing many sketches with one drag on the map.
*Erasing sketches of a single color.
*Creating a note - confirm.
*Editing a note – includes changing text, color, or position - confirm.
*Deleting many notes at the same time.
*Generating a sketch or line/area map-object from the GPS – confirm.

Some things which are NOT undo-able: 
*Tapping the backspace when creating, cutting, or re-shaping a line/area.
*Notes sorting and filtering.
*Panning or zooming, or setting fixed zoom levels.
*Filtering the map objects selection using the status bar functions.
*Changing anything in the Background layers tab.
*Changing any setting in the Quick Configuration Panel
*Changing anything in the Settings page and tabs.

==GPS Functions==
If the user’s device has GPS functionality, then both sketches and map-objects can be generated from GPS data. Start by opening the GPS panel using the GPS [[File:Location line.svg|border|30px]] button:

[[File:Ocadapp GPSPanel.png|500px]]

This panel has the following buttons:
*The sketch and symbol – line/area selector [[File:Ocadapp SketchSymbolSelector.png| px]] button.
*The line / area, start & stop recording [[File:Location record start.svg|border|30px]] button.
*The pause recording [[File:Location record pause.svg|border|30px]] button.
*The smoothing [[File:Ocadapp GPSSmoothingSlider.png| px]] slider.
*The curve mode [[File:Gps curve.svg|border|30px]] button if a symbol is being generated.
*The straight-line mode [[File:Gps rectangular.svg|border|30px]] button if a symbol is being generated.
*The finish [[File:Finish line.svg|border|30px]] button if a sketch or line symbol is being generated.
*The finish-and-close [[File:Finish close.svg|border|30px]] button if a line or area symbol is being generated.
*The discard [[File:delete_bin.svg|border|30px]] button.

===Record a Sketch===
To start recording ensure the device has GPS reception and you have positioning turned on – you should see a purple cross identify where you are standing on the map, use the [[File:Position.svg|border|30px]] button to center the map where you are standing.

Tap on the selector [[File:Ocadapp SketchSymbolSelector.png|30px]] button:

[[File:Ocadapp SketchRecordingStart.png| px]]

Select the desired color and line width, tap the [[File:Close cross.svg|border|30px]] to close the selector panel. Start to move, the GPS sketch will start to be generated when the user has moved at least 1-2 meters:

[[File:Ocadapp SketchRecordingMove.png| px]]

While recording the button will change icon to a pause image [[File:Location record pause.svg|border|30px]] and the border of the button will flash on/off to indicate that recording is ongoing.

The slider above is in the left position which means there is less smoothing, and more points are used. Moving the slider to the right removes lots of the intermediate points:

[[File:Ocadapp SketchRecordingSlider.png| px]]

The slider can be adjusted while drawing is on-going. The user can also change color or line width while the recording too.

[[File:Ocadapp SketchRecordingFinish.png| px]]

To finish the drawing tap the finish [[File:Finish line.svg|border|30px]] or finish-and-close [[File:Finish close.svg|border|30px]] button as above, the object is now saved.

Tapping undo will remove the sketch and re-load it into the recorder whereupon the user could resume recording again. This will only work if the ''GPS-finish'' was the last action performed.

''Note that when drawing a sketch there is no Bezier curve fitting, it only does point reduction.''

===Record a Map Object===
Open the selector again and change to the Symbols tab, only line or area symbols will be displayed:

[[File:Ocadapp MapObjectRecordingStart.png| px]]

Select the desired symbol type. Similarly to sketch generation the user can change symbol type at any time during recording.

Start recording. The slider is to the left so more points are used in the generation. The curve mode is active, so the line is a curve and smoothed.

[[File:Ocadapp MapObjectRecordingCurveSliderLeft.png| px]]

Moving the slider to the right and less points are used to make the curve:

[[File:Ocadapp MapObjectRecordingCureSliderRight.png| px]]

Changing to more points and straight-line mode and the map-object now looks like this:

[[File:Ocadapp MapObjectRecordingStraightLineSliderLeft.png| px]]

And moving the slider to the right reduces the number of points used:

[[File:Ocadapp MapObjectRecordingStraightLineSliderRight.png| px]]

Once the user is happy with the best approximation of the object they are generating, they can tap on the finish [[File:Finish line.svg|border|30px]] or finish-and-close [[File:Finish close.svg|border|30px]] button. The object is then saved.

[[File:Ocadapp MapObjectRecordingFinish.png| px]]

Tapping undo will remove the object and re-load it into the recorder whereupon the user could resume recording again. This will only work if the ''GPS-finish'' was the last action performed

===Pausing Recording===
Note that the drawing can be paused and resumed at any time, only while the recording is ongoing will points be added to the geometry. This means the user can: 
a) Start recording, some points are added… 
b) Pause recording. 
c) Move away from the recording position to inspect and draw something else… 
d) Move back to the approximate recording position and resume. 
e) Some more points are recorded, then the user finishes. 
f) The sketch/map-object generated will not include the movement in ‘3’ and ‘4’ above.

===Undo-Redo===
Both the Finish and Discard actions are undoable.

If the user taps on Finish the sketch or map-object is created. If then the user taps undo the sketch or map-object will be deleted and reloaded back into the GPS recording tool. The user can then:
*Re-start recording to continue adding points to the geometry.
*Change sketch color or width, or change symbol.
*Change the finish action to finish-and-close
*Change the smoothing or curve/straight option
If the user taps the discard [[File:delete_bin.svg|border|30px]] button the geometry being generated will be deleted. Tapping undo will add the geometry back in to the GPS recording tool and the user can continue generating their geometry.

Redo actions generally have the inverse behavior of undo which would be re-finishing the sketch/object, but without changes; or discarding the geometry again.

===Hiding the GPS Toolbar===
If the user closes the GPS toolbar while recording, the generating geometry will be hidden on the map, but the main GPS button will still flash to indicate that the recording is on-going. 
Opening the GPS-toolbar again and the geometry will be displayed again. 
Hidden, but flashing:

[[File:Ocadapp HideGPSToolbar.png| px]]

=Settings=
The App currently has three variations of the Settings Page which contain one or more tabs depending on the context of the page. To show the Settings Page, tap on the settings [[File:Settings.svg|border|30px]] button.
#During email registration – a page a tab with [[OCAD_App_Manual#Support|support]] information is shown.
#From the Projects page – a page with tabs for [[OCAD_App_Manual#General|general]], [[OCAD_App_Manual#Positioning|positioning]], [[OCAD_App_Manual#Drawing_2|drawing]], and [[OCAD_App_Manual#Support|support]] is shown.
#From the Project page – a page with tabs for [[OCAD_App_Manual#General|general]], [[OCAD_App_Manual#Positioning|positioning]], [[OCAD_App_Manual#Symbols|symbols]], [[OCAD_App_Manual#Drawing_2|drawing]], and [[OCAD_App_Manual#Support|support]] is shown.

[[File:Ocadapp ProjectSettings.png| px]]

Tapping the close [[File:Close cross.svg|border|30px]] button will close the settings page and return the App to whichever page was visible beforehand.

==Conventions==
On a settings page the user will see small arrow buttons.

[[File:Ocadapp ProjectSettingsArrowButtons.png| px]]

This is an expander button. If the checkbox is tapped, then the expander can also be tapped to display more options related to the setting.

When expanded there is a vertical green line below the checkbox indicating the scope of the sub-settings which appear below to the right:

[[File:Ocadapp ProjectSettingsArrowButtonsExpand.png| px]]

The following sections describe the different settings on each tab:

==General==
This tab displays general settings:

===Theme===
The OCAD App has both light and dark modes:

[[File:Ocadapp SettingsLightMode.png|75px]] [[File:Ocadapp SettingsDarkMode.png|75px]]

The System defined option will use whatever mode the operating system of the device is using.

===Language===
The App currently different languages to choose from.

[[File:Ocadapp SettingsLanguage.png|75px]]

===Button Size===
The user can decide on the desired button size in the App by adjusting the slider:

[[File:Ocadapp SettingsButtonSize.png|500px]]

The number of buttons across the screen width is also indicated, this may be useful when designing [[OCAD_App_Manual#Symbols|Symbol Favorites]] or when using small devices such as phones.

A smaller size may be suitable for use with a stylus, while bigger sizes are better with fingers.

===Screen Margin===
Some devices are insensitive to tapping around the edges, the user can increase the margin around the App, so the edge is not used:

[[File:Ocadapp SettingsScreenMargin.png]]

===Toolbar Position===
The toolbar has two positions:
*Floating and moveable
*Docked to the bottom of the screen.

[[File:Ocadapp SettingsToolbarPosition.png|500px]]

The default setting for this is “Device defined” which means that if the device screen width is less than the approximate size of about: ''(8 buttons) x (the button size)'' 
Then the toolbar will be docked at the bottom, if greater than this size it will be floating.

===Zoom===
These settings can be used to hide the zoom in and out buttons. The auto-rotate and auto-center functions of the Fixed zoom level actions can also be turned off.

[[File:Ocadapp SettingsZoomButtons.png|350px]]

===Compass===
If the device has a compass (internal or external) then this setting is visible. The size of the compass can also be specified:

[[File:Ocadapp SettingsShowCompass.png|500px]]

===Status bar===
The status bar can be hidden.
If it is visible:
*It can be positioned at the top or bottom of the screen.
*The text tooltips can be shown or hidden.
[[File:Ocadapp SettingsShowStatusBar.png|200px]]

===Scale Bar===
The scale bar on the map can be hidden:

[[File:Ocadapp SettingsShowScaleBar.png|500px]]

===North Lines===
The App can display magnetic north lines overlayed on the map with an equidistance given in millimeters. Note that these north lines only exist in the App, they are not the same as drawn north lines.

[[File:Ocadapp SettingsShowNorthLines.png|200px]]

===Demo Projects===
The two options to add demo projects to the App can be hidden with this checkbox.

===User Settings===
Tapping on the User Settings button:

[[File:Ocadapp SettingsUserSettings.png]]

Will open the User Settings page:

[[File:Ocadapp SettingsUserSettingsPage.png]]

Tapping the ''Unregister'' button will unregister the device from the OCAD server. See [[OCAD_App_Manual#Registration|Registration]] and [[OCAD_App_Manual#Technical_Notes|Technical Notes]] for more information.

There is currently no way to change the email address or name without unregistering and re-registering.

Note: This requires an Internet connection.

Important: Unregistering a device will NOT delete the projects on the device, but unless there is a registered user then any projects on the device cannot be uploaded to the cloud transfer service or exported.

==Positioning==
The tab contains generic settings for GPS and positioning functionality.

[[File:Ocadapp SettingsPositioning.png|400px]]

===Positioning===
The user’s current position on the map can be displayed using an indicator, the size, color and type can be modified:

[[File:Ocadapp SettingsPositioningShowCurrentPosition.png|500px]]

Tapping the default color [[File:Ocadapp SettingsPositioningDefaultColorSquare.png|30px]] square will reset the color back to purple. 
The number of GPS satellites available affects the precision of the position, the accuracy of the position can be shown on the map by tapping the “Show position precision” checkbox. 
This will display a shaded circle around the location on the map. A smaller circle indicates a more accurate position.

===Logging and tail===
The App can also record the user’s position and display the tracking of where they have been.

Background logging can be enabled which means the app will continue to record its position even when another app is active on the device. This usually requires approving permission on the device.

The visibility and length of the tail can be changed, as well the Color.

[[File:Ocadapp SettingsPositioningLogPosition.png|500px]]

Tapping the default color [[File:Ocadapp SettingsPositioningDefaultColorSquare.png|30px]] square will reset the color back to purple.

==Symbols==
The Symbols tab shows the configuration interface for editing “symbol favorites”. Symbol favorites are a way for the user to configure the symbol rows on the map toolbar, so they only need to see the symbols they use regularly. 
But it is possible to have more than one symbol favorites, so the user can have one for sand-dune terrain, and another for mountain terrain. Or for city parks and another for indoor maps. 
There is no limit to the number of different favorites.

The app comes with three predefined favorites ((their definitions can be found in an [[OCAD_App_Manual#Appendix_B_-_Default_Symbol_Favorites|Appendix B]]):
*Forest Symbols
*Sprint Symbols
*No sets

These cannot be deleted but can be hidden if not needed.

The user interface for symbol favorites is split into two parts, the favorites selector, and the favorites editor.

===Favorites Selector===
At the top of the Symbols tab there are functions for selecting the active favorites and buttons for creating and duplicating favorites:

[[File:Ocadapp SettingsSymbols.png|500px]]

The create favorites [[File:Heart plus.svg|border|30px]] button can be used to create new favorites.

The duplicate favorites [[File:Favorites copy.svg|border|30px]] button can be used to create a new copy of the current active favorites.

Use the drop-down menu [[File:Ocadapp SelectSymbolFavorite.png|150px]] to select the active favorites. The active favorites are the ones that will appear in the map toolbar. The user can also use the [[OCAD_App_Manual#The_Quick_Configuration_Button|Quick Configuration Panel]] to change the active favorites. This will also select the favorites that can be modified in the [[OCAD_App_Manual#Favorites_Editor|Favorites Editor]] below.

===Favorites Editor===
The favorites editor can edit ONE favorites at a time.

[[File:Ocadapp SettingsSymbolsFavoritesEditor.png|500px]]

The favorites have a name which can be changed (apart from the predefined favorites) to something appropriate such as ''Sand dunes'', ''Indoor'', ''Mountain'' or ''Forest Protected'' etc.

If the favorites are predefined then the Reset [[File:Refresh.svg|border|30px]] button appears, this will change the predefined favorites back to their original configuration.

The [[File:Ocadapp SettingsSymbolsVisibleCheckbox.png|80px]] checkbox can be used to hide a favorites from the [[OCAD_App_Manual#The_Quick_Configuration_Button|Quick Configuration Panel]]. This is useful if the user never makes Sprint maps, they can then just hide ''Sprint Symbols''.

===Sets===
A favorites is made up of ''sets''. A set represents a row in the map toolbar. It is possible to have up to five user-defined sets (or rows) in a favorites. Each set can contain many symbols, if there are too many for the width of the screen then row scrollbars are used in the map toolbar.

The number of sets and number of symbols in each set is up to the user to decide, but obviously the button size, screen size and orientation (portrait / landscape) will affect how the rows will look in the map toolbar.

To add a new set tap on the add set [[File:Playlist add.svg|border|30px]] button. To delete a set tap on the delete set [[File:Delete bin.svg|border|30px]] button beside the set to be deleted. The delete action will show a warning because deleting a set is not undoable, all changes are saved immediately.

===The Other Set===
Below the defined sets (1-5) will appear the “Other” set. This is where the user should put the symbols they do not use or only occasionally.

'''Important''': The Symbols favorites are project independent, but when editing the favorites only those symbols which are in the current project will be shown. And the symbol icon for a particular symbol always comes from the project file. In one project the symbol number 100.001 could be a road and in another type of project it could be a tree. Internally favorites are just a definition of sets, and each set has a list of symbol numbers. When opening a project, the app makes a mathematical intersection merging each favorites with the symbols in the project. Any symbol in a favorite set that is NOT in a project will remain in that set but will not be visible. And any symbol not in a user-defined set but exists in a project will be placed in the ''Other'' set.

Symbols in the “Other” set appear in the symbol selector panel which appears when tapping the symbol sector [[File:Grid.svg|border|30px]] button.

Note: The order of symbols in the ''Other'' set is not currently saved.

===Protected Symbols===
Protected symbols are those which are not normally selectable on the map and the user would not usually want to add or edit them. The ''Protected'' set appears below the ''Other'' set.

[[File:Ocadapp SettingsSymbolsProtectedSymbols.png| px]]

More information about protected symbols can be found in [[OCAD_App_Manual#Editing_Protected_Map-Objects|Editing protected map objects]].

===Editing Sets===
The symbols in the sets are edited by dragging them from one set to another. The order of the symbols in each set can also be edited by dragging symbols to the left and right within a set.

The user can drag one or many symbols from ONE set into another, for example, the user is going to move these four water symbols from Other to Set 1 and place them before the rock symbols:

[[File:Ocadapp SettingsSymbolsEditingSets.png|650px]]

Result:

[[File:Ocadapp SettingsSymbolsEditingSetsDone.png|650px]]

Note: only symbols from one set at a time can be dragged to another set.

A grey symbol selector [[File:Grid.svg|border|30px]] button icon always appears at the start of the last user-defined set. This is to indicate a placeholder to the user that the symbol selector button will appear in this position in the map toolbar.

To deselect all symbols, tap on the deselect [[File:Remove selection.svg|border|30px]] button here:

[[File:Ocadapp SettingsSymbolsDeselectSymbols.png|500px]]

===Delete a Symbol Favorites===
At the bottom of a symbol favorites is a delete [[File:Delete bin.svg|border|30px]] button which can be used to delete the current symbols favorites:

[[File:Ocadapp SettingsSymbolsDeleteSymbolFavorites.png| px]]

Note that this will display a warning as deleting a favorites is NOT undoable, all changes are saved immediately.

===Example Scenarios===

The following are three example scenarios demonstrating the possibilities of Symbol Favorites:
*'''Using a tablet in the mountains'''
Set up two favorites: Mountain and Mountain village.

[[File:Ocadapp SettingsSymbolsExampleMountain.png|650px]]

[[File:Ocadapp SettingsSymbolsExampleMountainVillage.png|650px]]

Make all other favorites hidden, then when out in the field the user can easily swap between the two sets of favorites using the [[OCAD_App_Manual#The_Quick_Configuration_Button|Quick Configuration Panel]]:

[[File:Ocadapp SettingsSymbolsQuickToolbar.png|500px]]

*'''Working with Protected Symbols'''
The user could set up different favorites for those times they want to edit protected map-objects:

[[File:Ocadapp SettingsSymbolsProtectedMapObjects.png|500px]]

While using this favorites the normally protected symbols are all editable. Revert to the normal Forest Symbols favorites afterwards.

*'''Phone'''
Working with limited space, creating a couple of favorites and using the No Sets favorites if doing a lot of sketching. In this case the user has decided that 8 buttons wide is about right for using their finger to draw. So, three rows of 8 symbols. The user can have common symbols between the sets if needed too:

[[File:Ocadapp SettingsSymbolsPhoneSprint1.png|250px]]
[[File:Ocadapp SettingsSymbolsPhoneSprint2.png|250px]]
[[File:Ocadapp SettingsSymbolsPhoneNoSets.png|250px]]

==Drawing==
On the Drawing tab there are settings for the selection and order of colors for sketching and notes.

[[File:Ocadapp SettingsDrawing.png]]

===Sketching===
By tapping a sketch color button, it can be turned on and off. Only those colors which are ''on'' will appear in the map toolbar.

To change the order of the colors, tap, hold, and drag one color at a time to a new position in the list.

===Notes===
By tapping a note color button, it can be turned on and off. Only those colors which are ''on'' will appear at the bottom of the note editor.

To change the order of the colors, tap, hold, and drag one color at a time to a new position in the list.

The Notes tool button can be hidden or positioned in different locations in the App.

[[File:Ocadapp SettingsNotes.png]]

===Map Objects===
*'''Show legibility halo''': The legibility halo shall support the cartographer to draw point and line objects with enough distance to each other. 
The distance of the legibility halo is based on the IOF specifications for orienteering maps.

[[File:OCAD App Legibility Halo Line Object.png|300px]]

[[File:OCAD App Legibility Halo Point Object.png|300px]]

==Support==
The Support setting tab contains advanced information and actions for sending information back to OCAD.

At the top is a Help section with links to the App Manual and the OCAD Wiki.

Note: A project can also be sent to OCAD Support using a function in the [[OCAD_App_Manual#Advanced|Advanced]] section of Project Options.

[[File:Ocadapp SettingsSupport.png|500px]]

===Log Settings===
The app logs activity by the user in a text file on the device. If the user encounters problems with the App they are encouraged to turn on “Extra app logging” then send the log files to OCAD for analysis.

The log files are stored locally on the device. A new log file is created each day and once the log file reaches a certain size (16MB). Older log files are automatically deleted by the app regularly.

The user can send one or more log files to OCAD (internet connection required). When sending a log file, the user should also write a message to describe what they were doing and why they are sending the log file(s).

IMPORTANT: When describing what the user is doing please try and specify to the nearest minute when the crash or problem occurred – this helps us a lot!

When sending a message with a log file only the first 1000 characters are sent, to send more text see [[OCAD_App_Manual#Sending_Feedback|Sending Feedback]] below.

Each log file has a link which can be tapped to open it on the device, this could be useful if the user needs to send part of a log file to OCAD, or if the Send function fails.

===Sending Feedback===
The user can send feedback messages to OCAD using the Message function. There is no limit to the size of text that can be submitted.

===App Settings===
The app’s App settings contain small pieces of information like the color order of the notes, or the position of the floating toolbar. There are currently about one hundred different things stored here. To send a copy of the settings for the current device, the user can do so by selecting the ''App settings file'' checkbox and tapping the ''Send to OCAD'' button. Only do this if requested to do so by OCAD as it may be useful to help resolve problems.

===Other Information===

[[File:Ocadapp SettingsSupport OtherInformation.png]]

The App privacy policy can be found here by clicking on the link: ''www.ocad.com/en/privacy/''

The current app version is displayed here.

If a project is open, then the ID of the project is displayed here, there is a copy [[File:Content copy.svg|border|30px]] button to the right which will copy the currently open projects id to the clipboard on the device.

=Appendices=
==Appendix A - App Updates==
The following sections describe functionality updates between recent versions of the App and this document.

'''Version 1.1.0.79'''
*Legibility Halo can be shown for point and line objects, see [[OCAD_App_Manual#Map_Objects|here]].
*Long-press on symbol shows symbol number and symbol name, see [[OCAD_App_Manual#Button_Rows|here]]
*Long-press on symbol gives possibility to hide or protect objects, see [[OCAD_App_Manual#Hide_and_Protect_Map_Objects|here]].
*Japanese and Chinese (traditional) language has been added.
*Performance improvements.

'''Version 1.0.5.71'''
*Good, poor, lost GPS Status indicators added to the status bar, see [[OCAD_App_Manual#GPS_Status|here]].
*Fixed zoom level auto-rotate and auto-center can now turned off in Settings, see [[OCAD_App_Manual#Zoom|here]].

'''Version 0.9.2.62'''
*3 configurable fixed zoom level buttons added, see [[OCAD_App_Manual#Configurable_Zoom_Buttons|here]]
*Scan Project QR code on the App to share a project with another device, see [[OCAD_App_Manual#Advanced|here]].
*Send Project to OCAD Support button added, see [[OCAD_App_Manual#Advanced|here]].
*Italian language has been added.

'''Version 0.9.1.60'''
*Directional point objects can now be rotated, see [[OCAD_App_Manual#Edit_Selection_Behavior|here]].
*Geometry vertex type can now be toggled between the value normal, dash and corner, see [[OCAD_App_Manual#Change_vertex_type|here]].
*Chinese and Portuguese languages have been added.

==Appendix B - Default Symbol Favorites==
'''Forest Symbols''' 
Set 1: ''101000, 102000, 103000, 103001, 109000, 110000, 111000, 112000, 201001, 202001, 202002, 202003, 203100, 204000, 205000, 207000'' 
Set 2: ''303000, 308001, 311000, 313000, 417000, 418000, 419000, 503000, 504000, 505000, 506000, 507000, 508000, 530000, 531000'' 
Protected: 
''Open land, paved area, out-of-bounds area: 401000, 501000, 501001, 520000, 520004'' 
''DEM Wizard smoothed contour symbols :10060000, 10061000, 10062000, 10060001, 10061001, 10062001, 10080000, 10081000, 10082000'' 
Protected + hidden: 
''DEM Wizard unsmoothed contour symbols: 10050000, 10051000, 10052000, 10050001, 10051001, 10052001''

'''Sprint Symbols''' 
Set 1: ''204000, 301000, 311000, 313000, 417000, 418000, 419000, 530000, 531000, 401000, 406000, 410000, 411002'' 
Set 2: ''501001, 501021, 501100, 513100, 513200, 515000, 516000, 518000, 520001, 521000, 522000, 532000'' 
Protected: 
''Open land, paved area, out-of-bounds area: 401000, 501000, 501001, 520000, 520004'' 
''DEM Wizard smoothed contour symbols :10060000, 10061000, 10062000, 10060001, 10061001, 10062001, 10080000, 10081000, 10082000'' 
''New Map Wizard - Swiss survey data symbols: 999000, 999001, 999010, 999011, 999512, 999513, 999515, 999521, 999522, 999523'' 
Protected + hidden: 
''DEM Wizard unsmoothed contour symbols: 10050000, 10051000, 10052000, 10050001, 10051001, 10052001'' 

==Appendix C - Folder Transfer==
Use the following sections as a guide for transferring a project to and from the App without using the cloud transfer or any internet connection.

Requirements:
*A cable to connect your device to your Windows Computer
*For iOS it is necessary to use iTunes from Apple and to have enabled “Trust” between the device and Windows so that Windows will be able to read and write files.

There may be other ways and techniques to copy the files to and from a device, but the ways described below use ordinary Windows folders.

===OCAD Desktop Export===

On the third step of the Data-exchange process the user can select “USB cable” as the transfer option:

[[File:Ocadapp FolderTransfer TransferOption.png]]

Clicking on the “Open folder and copy data” will open a Windows explorer window in a location like this:

:''C:\Users\user-name\AppData\Roaming\OCAD\OCAD 2018\Tmp\_OcadAppExchangeData\_DesktopToApp''

[[File:Ocadapp FolderTransfer TransferFolderToApp.png]]

The user should then copy this transfer project folder to the OCAD folder on their device. It is important to copy the WHOLE folder with ALL contents, see next sections.

===Copying to Android===
Copy the project folder from the step above to the location:

:''This PC\Galaxy Tab S8 \Internal storage\Android\data\com.ocad.app\files''

[[File:Ocadapp FolderTransfer TransferFolderToAppAndroid.png]]

After copying, there should be the “Bürenflue Export” project folder like this:

[[File:Ocadapp FolderTransfer TransferFolderToAppAndroidDone.png]]

The user can now open the OCAD App to import the project, see below.

===Copying to iOS===
Open iTunes on Windows and click on the device button:

[[File:Ocadapp FolderTransfer TransferFolderToAppiOS.png]]

Then click on:
#“File Sharing”
#Find the “OCAD” App
#Drag the whole folder from the “_DesktopToApp” folder into the right-hand side of the of iTunes where the list of folders is.
#Click on “Sync” to transfer the data to your iOS device

[[File:Ocadapp FolderTransfer_TransferFolderToAppiOSDone.png]]

Important: Do not try and use “Add File:” as this does not copy whole folders. 
When the “sync” has completed your project will be able to be imported into the OCAD App, see below. 
Note that copying the project files to iOS works similarly by using iCloud.

===Importing on the device===
Once the folder is moved to the above locations on the device, start the OCAD App, then click on [[File:Project add.svg|border|30px]] and “From folder”, the App will scan the folder and find the projects to import, select the desired project and tap on “Import”:

[[File:Ocadapp FolderTransfer ImportFromDevice.png]]

When the project import has completed, the user should be able to work with it in the same way as if it had been imported via the Cloud Transfer Service.

After importing, the files in the “Bürenflue Export” folder will be automatically removed, this is important as if the user was to do another “OCAD Desktop Export” and “copy” then the App will prompt the user to update their project on the App, see [[OCAD_App_Manual#Project_Lifecycle_2|Project Lifecycle]] below.

The “Bürenflue Export” folder is not deleted as it is used later for the export.

===Export from the device===
Tapping on the [[File:More vert.svg|border|30px]] button will open the project options, select the Export option.

[[File:Ocadapp FolderTransfer ExportFromDevice.png]]

This will export the project data from the internal storage and create files that can be copied back to the Windows computer and imported into OCAD Desktop. The export will create a folder similar to this:

:''export_iPhone_a43aae3a-debf-471e-849c-2290c526bab8''

or:

:''export_Galaxy Tab S8_a43aae3a-debf-471e-849c-2290c526bab8''

in the “Bürenflue Export” folder on the device. The names of the folders are unique to the device, this will enable the OCAD Desktop user to import data from various devices without risk of overwriting data.

Tapping on the “Include positioning file” checkbox above will also export the position.db file to the same location.

===Copy from Android===
Copy the export folder

:''export_Galaxy Tab S8_e667dd18-a34d-4223-94cb-e7c093cf5bb3''

From

:''This PC\Galaxy Tab S8\Internal storage\Android\data\com.ocad.app\files\Bürenflue Export''

To:

:''C:\Users\<user_name>\AppData\Roaming\OCAD\OCAD 2018\Tmp\_OcadAppExchangeData\_AppToDesktop\Bürenflue Export''

Important: Note that _AppToDesktop and _DesktopToApp are two different folder, ensure you copy to the correct one!

[[File:Ocadapp FolderTransfer CopyFromAndroid.png]]

The project can now be imported into OCAD Desktop.

===Copy from iOS===
Open iTunes and follow the initial instructions in [[OCAD_App_Manual#Copy_from_iOS|Copying to iOS]] above selecting File Sharing and the OCAD App. Then:
#Sync the data, this will copy the Bürenflue Export folder to your computer
#Select the Bürenflue Export folder
#The user may need to scroll down the screen to see the Add File… and Save… buttons
#Click on the Save… button

[[File:Ocadapp FolderTransfer_CopyFromiOS.png]]

After clicking Save… navigate to the folder:

:''C:\Users\<…user name…> \AppData\Roaming\OCAD\OCAD 2018\Tmp\_OcadAppExchangeData\_AppToDesktop''

Make sure the folder _AppToDesktop is selected in the Folder field (3).

[[File:Ocadapp FolderTransfer_CopyFromiOS2.png]]

Important: Note that _AppToDesktop and _DesktopToApp are two different folder, ensure you select the correct one!

After copying there will be a sub-folder in the project folder called something like:

:''export_iPhone_a43aae3a-debf-471e-849c-2290c526bab8''

[[File:Ocadapp FolderTransfer_CopyFromiOS3.png]]

Warning: If the project folder Bürenflue Export already exists the user will be prompted to overwrite it, and iTunes will OVERWRITE EVERYTHING. So, if there are export folders from other devices they will BE DELETED.

To work around this the user could save the folder elsewhere and copy it later to the _AppToDesktop folder. Or make sure previous imports have been completed using OCAD Desktop before saving the folder here.

Note that copying the project files from iOS works similarly by using iCloud.

===Import to OCAD Desktop===
From OCAD Desktop, select the menu item File – OCAD App Data Exchange. Select the transfer project “Bürenflue Export”, then in the panel below are listed the two exports from different devices. Click on “Import data from App”:

[[File:Ocadapp FolderTransfer ImportToOCADDesktop.png]]

This window is displayed for the “USB cable” transfer project, click on “Get importable files”:

[[File:Ocadapp FolderTransfer ImportToOCADDesktopGetFiles.png]]

This window is displayed with the available device imports:

[[File:Ocadapp FolderTransfer ImportToOCADDesktopImportFiles.png]]

Select one and click on Import Data and follow the usual procedure for importing data.

===Project Lifecycle===
After following the above procedure once, it is possible to re-export from OCAD Desktop again, copy to the device again, then tap Refresh (1) above the Projects List on the device. An orange message should appear in the list (2), tap to update the project with the latest version of the project from the Desktop.

[[File:Ocadapp FolderTransfer RefreshProjectList.png]]

After updating the project can be opened, edited, closed, re-exported, copied back to Windows and re-imported.

A project can have multiple users using one or more devices, using this copying system makes the process of working offline relatively easy.

===Technical Details===
The following details describe the files if a user needs to transfer files in other ways, such as email etc. Using a ZIP file could be recommended for this.

'''OCAD Desktop Exported files.''' 
The following items are exported from the OCAD Desktop and placed in a transfer project folder such as “Bürenflue Export”:
*“map.ocdExchange” – an OCAD file that can be imported to the App.
*“project.ocdInfo” – a small file containing transfer information.
*“back” folder - containing background images
The name of the folder containing these items should be the same as the transfer project in OCAD Desktop.

'''OCAD App Exported files.''' 
The export process creates a sub folder of the project transfer folder “Bürenflue Export”. The sub-folder name is constructed from “export”_”device-name”_”branch-ID”. This export sub-folder should contain two or three files:
*“map.ocdExchange” – an OCAD file that can be imported to the Desktop.
*“project.ocdInfo” – a small file containing transfer information.
*“position.db” – an optional file containing positioning information if the user also exports this.
Note that the background images are not exported as they cannot be changed on the App.

==Appendix D - Technical Notes==
'''Data Storage'''

The OCAD exchange files transferred to the device are only ever read on the device, some information in the files is copied to other hidden storage files on the device.

Only by exporting or uploading a project are OCAD exchange files created from the data in the internal storage.

The user should not copy or delete files in the directory: 
:''This PC\Galaxy Tab S8\Internal storage\Android\data\com.ocad.app\files\_projectdata''

Changing these files will break a project on the device and probably make it impossible to upload or export the project.

The files in this directory are required by a project to display the map correctly, but they do NOT contain the changes the user makes by editing the project.

If the user requires more space on their device, then background files (in the “back” folder) can be deleted manually without breaking a project. Deleting any other file will break the project.

'''Security'''

When using the OCAD Cloud-Transfer service the user may be concerned about security as there is no password or encryption involved in the process. Project security is based on the concept of anonymity, the user is the only person that has the project-id, there is no list of these ids anywhere, they are randomly generated 128 bit numbers so it is practically impossible to guess. See [https://en.wikipedia.org/wiki/Universally_unique_identifier Universally unique identifier - Wikipedia]. If the user shares an id with others, then there is a risk if those users share it.

File:Ocadapp ProjectManagementAdvanced BackupActions.png

2026-07-17T11:29:08Z

KLH:

OCAD App Manual

2026-07-17T11:22:27Z

KLH: /* Advanced */

This wiki page describes how the OCAD App works. 
To the main page of the '''[[OCAD App]]''' | To the '''[[OCAD App Data Exchange]]''' page.

[[File:Hint.jpg|30px]] There are small differences between the operating systems Android, iOS and Windows. This documentation has been produced using all three so images may look slightly different at times.

=Registration=
After starting the App, the first thing the user must do is select a language, this also can be changed at any time later by using the [[OCAD_App_Manual#Language|Settings]].

The full functionality of the OCAD App is available after registration. To register the user needs to enter a valid email address and their name.

A user should use the same email address if they use multiple devices. These pieces of information can then be used to manage imports from the App into OCAD Desktop so that user will know from whom an upload comes from and which of their devices.

[[File:Hint.jpg]] If the user has multiple devices they plan to register, the same email address should be used and each device should have a unique name for that user. 
For example: “iPad”, “iPhone”, “Android Tablet”, “Robs Phone” etc. If two devices have the same name it may make importing data from the App to OCAD Desktop confusing to the user as they may not know exactly which device the data comes from.

==Email and Name==
Enter a valid email address: 
[[File:Ocadapp registrationEmail.png|350px]]

After entering a valid email address, the user is prompted to enter their name: 
[[File:Ocadapp registrationName.png|350px]]

After entering a name an email will be sent to the address: 
[[File:Ocadapp requestSent.png|350px]]

Tap on the link in the address to complete the registration. 
[[File:Ocadapp registrationConfirmEmail.png|350px]]

The App will detect the confirmation, tapping on the ''Continue'' button will take the user to the '''[[OCAD_App_Manual#Projects|Projects]]''' page.

==Other Functionality==
The User Interface Language can be changed. 
Using the [[File:settings.svg|border|30px]]button, some settings can be changed.

==Demo Mode==
*The user can evaluate the App using two [[OCAD_App_Manual#Download_a_Sample_Project|sample projects]].
*The user CANNOT download or import any other project.
*The sample projects can be edited in any way, note that certain functions may not work fully such as the GPS functionality which requires being at the real location of the sample maps.
*The user CANNOT upload the sample projects to the OCAD server.
*The user can delete and re-import the sample projects any time.
*No notifications or any other information is sent to OCAD in demo mode.
*The registration page will always be shown until an email address is entered.
*After entering an email address or choosing Demo mode the App will go to the '''[[OCAD_App_Manual#Projects|Projects]]''' page.

==Technical Notes==
*The Registration requires an Internet connection.
*OCAD stores the email address and name for each registered user. It also stores a list of devices for each user, the device name and the device id is stored.
*Only one user can be registered at one time for the App on a single device.
*The user and device registration is NOT a login mechanism. There is no password.
*If the user wants to change email address or name, they must first unregister the user from the device – see '''[[OCAD_App_Manual#User_Settings|User Settings]]'''.
*If the user is unregistered from the device all projects WILL BE PRESERVED on the device, they can continue to be edited, but the user CANNOT Upload or Export the project until a new registration is made.
*If a user has multiple devices, they will NOT be prompted for a name when registering the second and subsequent devices.
*If a user has multiple devices, then unregistering one will remove it from the list of devices for that user on the OCAD server. When the last device is unregistered, the user will also be deleted.

=Projects=
[[File:Ocadapp ProjectsPage.png]]

The projects page will contain a list of projects.

==Add Project==
To Add a project, it must be imported to the App. During this process, an OCAD file is converted into a native App format which provides better performance for drawing and viewing large maps. 
Tap on the [[File:Project add.svg|border|30px]] button to add a project.

[[File:Ocadapp AddProject.png]]

When adding a project, it will first be downloaded, then processed, this could take a few minutes for large projects and depends on Internet speed and device performance. 
The App does not write changes directly to the OCAD file which is stored on the device, all data and changes are stored in internal storage.

===From QR Code===
If your device has a camera that is accessible from the App (permissions may be required) then the user can scan a QR code from OCAD Desktop to download and import a project.

The user can now also scan a QR code using the camera on your device and it will open the OCAD App and start the import of that project.

===From Project ID===
The OCAD Desktop produces a link in the App Data Exchange process; this link contains an ID which can be pasted into the entry field. If a link or id is detected on the clipboard it will be automatically pasted into the ID field. 
For example: <nowiki>https://app.ocad.com/project/6da31400-4a94-43e8-7ae6-8e8ece235b04</nowiki>

[[File:Ocadapp DownloadProject.png|400px]]

The user can paste the whole link or just the ID.

If the user has this link in an email or other message it can now be tapped/clicked which will open the OCAD App and download the project.

===From Folder===
Although it is generally preferred and recommended to use the OCAD Cloud Transfer Services to move projects back and forth from the OCAD Desktop to the OCAD App, there may be times when manual copying of data is required. For example:
*The user has no internet connection
*The transfer project or even map file has been lost on OCAD Desktop so the user cannot use the cloud-transfer to retrieve the map.
*The user is concerned about the security of their project being on the internet.

There are slightly different techniques depending on whether the device is Android or iOS. The process involves:
#OCAD Desktop export
#Copying to the iOS or Android device
#Importing on the device
#The user makes changes to the project on the device
#Export from the device
#Copy from the iOS or Android device to the Windows computer
#Import to OCAD Desktop

Information about these processes can be found in the '''[[OCAD_App_Manual#Appendix_C_-_Folder_Transfer|Appendix C]]'''.

===Sample Projects===
The two sample projects can be downloaded at any time.

===Download a Sample Project===
The two sample projects can be downloaded at any time.
*The sample projects can be edited in any way, note that certain functions may not work fully such as the GPS functionality which requires being at the real location of the sample maps.
*The user CANNOT upload the sample projects to the OCAD server.
*The user can delete and re-import the sample projects any time.

==The projects page==

===Refresh the Projects List===
To refresh the projects list, tap on the [[File:Refresh.svg|border|30px]] button. See [[OCAD_App_Manual#Project_Update_from_Desktop|Project Update from Desktop]] for more details.

===Settings===
Tapping the [[File:Settings.svg|border|30px]] button will take the user to the settings page, see [[OCAD_App_Manual#Settings_2|Settings]]

===Internet Status===
At the bottom of the Projects page there is a small cloud icon beside the App version information: 
[[File:Ocadapp InternetStatus.png| px]]

Tapping on the cloud will reveal the internet status and if the App is connected to the OCAD server: 
[[File:Ocadapp InternetStatusConnected.png| px]]

If the user cannot download or upload a project, then it could be that the device has either:
*no internet connection – a red cloud
*a problem with connection to the OCAD server – an orange cloud

An error message will appear indicating the problem beside the cloud icon. 
[[File:Hint.jpg]] The App does not maintain a permanent connection to the OCAD server, it is only required when:
*Downloading a project
*Uploading a project
*Updating a project
*Refreshing the list of Projects
*Registering the user
*Sending log files or projects to OCAD Support

===The Projects List===
The list of projects can be displayed as tiles [[File:Grid view.svg|border|30px]] or as a list [[File:Bulleted list.svg|border|30px]] by toggling the button on the top right:

[[File:Grid view.svg|border|30px]] Tiles 
[[File:Ocadapp ProjectListTiles.png|300px]]

[[File:Bulleted list.svg|border|30px]] List 
[[File:Ocadapp ProjectListList.png|300px]]

The projects can also be sorted alphabetically by name or by modified date (newest at the top): 
[[File:Ocadapp ProjectListSort.png|200px]]

==Project Management==
Tap on the project to open it.

Tapping on the [[File:More vert.svg|border|30px]] button will open the project options:

[[File:Ocadapp ProjectOptions.png|500px]]

===Open===
Tapping on the project '''Open''' button will also open the project.

===Upload===
Once changes have been made, the project can be uploaded to the OCAD server, then imported to the OCAD Desktop. 
A positioning file can be optionally included when uploading. This will make a ''position.db'' file available for import into OCAD Desktop.

===Delete===
A project can be deleted; a confirmation warning is shown. There is no way to reverse this action.

===Advanced===
Other functionality may appear here, currently:
*Export
*QR Code
*Repair
*Backups
*Send Project to Support

[[File:Ocadapp_ProjectManagementAdvanced2.png]]

'''Export''' 
See the [[OCAD_App_Data_Exchange|OCAD App Data Exchange]] page for more information. Tapping on the “Include positioning file” checkbox above will also export the position.db file.

'''QR Code''' 
This QR represents the selected project, it can be used to download the project to a new device. Note that:
*It will download the latest version of the project that was exported from OCAD Desktop and exists on the OCAD Cloud transfer service.
*It requires an internet connection.
*The downloaded project will have the same permissions that were set up in the Cloud Transfer Service.

Use this function to easily share a project with friends or download the project to a secondary device.

'''Repair''' 
This function repairs the map tiles which are used for the map rendering. Try it when the map layer and/or the project thumbnail preview in the project list show only white pixels or if the App crashes when opening a project.

'''Send Project to Support''' 
When sending a project to OCAD Support the user will be prompted to enter a reason for sending it. Please only send projects if:
*We have requested you to do so to provide support which could include fixing a bug or recovering data.
*The project cannot repeatedly be opened and the user needs help.
Note that background files and images are NOT included when sending a project to OCAD Support. Sending a project to OCAD Support requires an internet connection.

===Project Status===
The most recent download/upload action is shown below the project. 
Beside it is a small green arrow, tapping this arrow will open the History below. 
[[File:Ocadapp ProjectStatus.png|320px]]

Tapping the small arrow or list will close it again. 
[[File:Ocadapp ProjectStatusCloseHistory.png|320px]]

For example, if there is a new update of a project on the OCAD server then refreshing the list will provide an indication of this, see [[OCAD_App_Manual#Project_Update_from_Desktop|Project Update from Desktop]].

===Project Update from Desktop===
If the project has been updated and exported from the Desktop,
then refreshing the Projects list will indicate that an updated version of the Project is available for download.

[[File:Ocadapp ProjectUpdateDesktop.png|485px]]

Tapping the [[File:Cloud update.svg|border|30px]] button will update the Project on the App, or alternatively use the Update option:

[[File:Ocadapp CloudUpdate.png|485px]] 
'''Important!''' When updating, only Background maps and a few settings for the project are preserved. All other data is deleted, and new data is re-imported. 
If the user has any changes that have NOT been uploaded to the OCAD Server and then imported and merged with the OCAD file on the Desktop, then those changes will be lost!

The other possible notification here is if the transfer project has been deleted on the OCAD Desktop. 
If this is the case, and there are changes that need transferring to the OCAD Desktop, then the project will need to be exported from the App and manually transferred to the user’s computer.

Note: These notifications for cloud transfer projects will only appear if the App is connected to the Internet and the OCAD Server – see [[OCAD_App_Manual#Internet_Status|Internet Status]].

===Project Lifecycle===
When a project is exported from the OCAD Desktop to the OCAD Cloud Transfer it will remain on the server for 7 days. After that it will be automatically deleted.

However, the project could still obviously be in use both on the App and on OCAD Desktop. The user can still upload (or export) the project and then import changes from the App.

=Project Editing=
After opening a project, the map and editing tools will be seen on the Project page:

[[File:Ocadapp ProjectEditing.png|600px]]

==Project Toolbar==

[[File:Ocadapp ProjectToolbar.png|600px]]

'''Important:''' There is no ''Save'' button on the OCAD App. All changes are saved almost immediately to internal storage. 
Note that some actions need to be completed before saving will occur – such as drawing a line or area object.

===Close===
The project can be closed using the [[File:Close cross.svg|border|30px]] button.

===GPS Functions===
GPS functions are accessed via the [[File:Location line.svg|border|30px]] button. See [[OCAD_App_Manual#GPS_Functions_2|GPS Functions]] for more details.

===Map Layers and Notes===
To open a panel containing information about map layers and notes tap the [[File:Detail panel.svg|border|30px]] button. 
This panel contains two tabs, firstly for [[OCAD_App_Manual#Map_Layers|map layers]]: 
[[File:Ocadapp MapLayer.png| px]]

and secondly for [[OCAD_App_Manual#Notes|notes]]: 
[[File:Ocadapp Notes.png| px]]

This panel can behave as either a temporary “popup” panel or docked to the right-hand side by tapping the [[File:Panel right docked.svg|border|30px]] button on the right: 
[[File:Ocadapp PanelRightDocked.png| px]]

If the panel is docked, then the width can be adjusted by dragging the left edge of the panel. 
[[File:Ocadapp PanelDrag.png| px]]

===Settings===
Tapping the [[File:Settings.svg|border|30px]] button will take the user to the settings page, see [[OCAD_App_Manual#Settings_2|Settings]].

==Status Bar==
Below the project toolbar is a status bar which provides various pieces of information such as:
*The stylus / finger / mouse actions that are available for the currently active tool.
*The type of selected objects and how many of each.
*The length or surface area if one object is selected.
*The GPS status on the device.

[[File:Ocadapp StatusBar.png| px]]

===Interactions===
The [[File:Tap.svg|border|30px]] icon indicates that the map will accept a tap action on the map for the currently active tool, the associated text describes the behavior.

The [[File:Finger drag.svg|border|30px]] icon indicates that the map will accept a swipe/drag type action on the map for the currently active tool, the associated text describes the behavior.

If the screen is too narrow to display the texts, then tapping the icons will display them:

[[File:Ocadapp InteractionsTap.png| px]]

===Selections===
Selecting many objects on the map generates a summary of the selection in the status bar. 
Depending on how many objects are selected, this could be a single count or a count per symbol type:

[[File:Ocadapp Selection.png| px]]

In this case 3 knolls [[File:Ocadapp SelectionKnoll.png| px]], 1 track [[File:Ocadapp SelectionTrack.png| px]] and 5 green areas [[File:Ocadapp SelectionGreenArea.png| px]]

Tapping on the symbol icons in the status bar will show a panel with details of the selection. 
Tapping on the items in the panel will select and deselect them. 
By recursively filtering a selection using this functionality the user can drill down to one or more specific objects that they want to edit or delete.

In this example the user has tapped the second and fourth green areas which are now selected in the list, so they are selected on the map:

[[File:Ocadapp SelectionSelectGreenArea.png]]

Tapping outside the panel will close it leaving the desired objects selected. 
In the following example the user chooses all the green, yellow and brown dotted areas:

[[File:Ocadapp SelectionSelectGreenYellowDottedArea.png]]

Then closes the popup panel and selects 3 green and 2 yellow areas:

[[File:Ocadapp SelectionSelectGreenYellowArea.png]]

This technique means the user can easily iteratively filter objects so that only the desired ones remain selected.

More information about editing selected objects can be found in [[OCAD_App_Manual#Editing_Selected_Map_Objects|Editing Selected Map Objects]].

To close the small panel just tap again on the map outside the panel.

===Measurements===
If one object is selected, then its length or area is shown.

Length 
[[File:Ocadapp MeasureLength.png| px]]

Area 
[[File:Ocadapp MeasureArea.png| px]]

===GPS Status===
The GPS icon shows the state of the GPS connection:

[[File:Ocadapp GPSStatus.png|150px]]

Red: No connection or the user is outside the map area. 
Orange: Poor connection if the accuracy is > 20m. 
Green: Good connection with accuracy < 20m. 
Tapping on the icon will show a text message indicating Lost, Poor or Good connection status.

==Map==
Below the main toolbar and status bar is the map.

===Finger Gestures===
All the tools have various gestures, most of which are intuitive such as the two-finger pinch to zoom in and out. 
This gesture works on all tools. Other gestures are described in the sections for each respective tool.

===Buttons===
Near the top of the map is a compass and some buttons:

[[File:Ocadapp Buttons.png|600px]]

Note that if the user’s device does not have a GPS or Compass then some of these buttons may be hidden.
*The [[File:Zoom extent.svg|border|30px]] button which zooms to the whole extent of the map. This button can change to the button if the map is not orientated to north on the device.
*The [[File:Zoom in.svg|border|30px]] button can be used to zoom in.
*The [[File:Zoom out.svg|border|30px]] button can be used to zoom out.
*The [[File:Counter 1.svg|border|30px]][[File:Counter 2.svg|border|30px]][[File:Counter 3.svg|border|30px]] buttons which are configurable zoom buttons. See [[OCAD_App_Manual#Configurable Zoom Buttons|Configurable Zoom Buttons]].
*The [[File:Position.svg|border|30px]] button can be used to re-center the map to the user’s position – if the device has a GPS. By double-tapping the button it will change to [[File:Position auto.svg|border|30px]] and the device will keep the map centered as the user moves.
*The [[File:Compass.svg|border|30px]] button can be used to orientate the map to north on the device. Double-tapping it and the button will change to [[File:Compass auto.svg|border|30px]] which means the device will keep the map orientated to north as the user moves.

===Configurable Zoom Buttons===
The App has 3 configurable buttons which can be set to different zoom scales. They are not set to any specific numeric scale. 
When tapping one of these zoom buttons the App will go to the specified scale, auto-rotate and auto-center the map (if the device has a compass and GPS). 
The auto-rotate and auto-center functions can be turned off in the [[OCAD_App_Manual#Zoom|Settings]].

When starting the App the first time a red [[File:Counter 1_red.svg|border|30px]] zoom button will appear, tapping it will open the Quick-configuration panel:

[[File:Ocadapp ConfigurableZoomButtoms.png|350px]]

Tapping the Set button will set the [[File:Counter 1.svg|border|30px]] button to the current map scale. Tapping the checkbox to the left will hide the button on the map.

The user can configure up to 3 buttons to different zoom levels. 
To change a button to a different zoom level, just zoom to that level, open the panel using the [[File:Settings_rect.svg|border|30px]] button on the map toolbar and tap Set again.

===Scale Bar===
At the bottom of the map is a scale bar.

[[File:Ocadapp ScaleBar.png| px]]

==Map Toolbar==
Central to all map editing is the toolbar which could look something like this depending on the type of editing tool selected:

[[File:Ocadapp MapToolbar.png| px]]

It can be moved to a new location using the [[File:Drag.svg|border|30px]] button on the bottom left. It can also be docked to the bottom of the App – see [[OCAD_App_Manual#Toolbar_Position|Settings - Toolbar Position]].

It can be resized using the [[File:Resize.svg|border|30px]] button on the bottom right.

===Button Themes===
Some buttons have a background theme:
*Green – confirmation button to complete a process.
*Red – destructive button to cancel a process or delete something.
*Blue – a behavior to change how a tool works – only ''one'' or ''none'' can ever be active.
*Yellow – an option to change how a tool works – ''none, one or many'' can be active.

===Button Rows===
There are four main types of rows in the toolbar:
*Top row – contains behaviors, options, and actions appropriate to the current active tool.
*Notes + Sketch row – contains the Notes [[File:Bubble text.svg|border|30px]] button on the left and the sketch color buttons.
*Symbol buttons – in the example above there are two rows of symbols, to access other symbols not in the two rows tap on the symbol selector [[File:Grid.svg|border|30px]] button to the left.

[[File:Hint.jpg]] Long-press on a symbol to see its symbol number and symbol name.

*Bottom row which contains:
**The Drag [[File:Drag.svg|border|30px]] button.
**The Undo [[File:Undo.svg|border|30px]] and Redo [[File:Redo.svg|border|30px]] buttons, see [[OCAD_App_Manual#Undo_-_Redo|Undo - Redo]].
**The Pan [[File:Pan.svg|border|30px]] button.
**Sometimes the symbol selector [[File:Grid.svg|border|30px]] button can appear here if there are no rows of symbols above.
**The Select [[File:Select.svg|border|30px]] button, see [[OCAD_App_Manual#Selections|Status bar Selection]] and [[OCAD_App_Manual#Editing_Selected_Map_Objects|Editing Selected Map Objects]].
**The Draw [[File:Stylus.svg|border|30px]] button which changes icon depending on what is to be drawn. The icon can be either a Sketch color & width or a symbol, see [[OCAD_App_Manual#Drawing_Objects|Drawing New Map-Objects]] and [[OCAD_App_Manual#Drawing|Sketch – Drawing]].
**The Sketch Erase [[File:Eraser.svg|border|30px]] button, see [[OCAD_App_Manual#Erasing|Sketch - Erasing]].
**The Quick Configuration [[File:Settings rect.svg|border|30px]] button, see [[OCAD_App_Manual#Map_Toolbar|Map Toolbar]].
**The resize [[File:Resize.svg|border|30px]] button on the bottom right.

Note that the Sketch/Note and Symbol rows can be scrolled horizontally if the screen device is not wide enough for all buttons:

[[File:Ocadapp ButtonRowsScroll.png| px]]

See also [[OCAD_App_Manual#Drawing_2|Settings – Drawing]] and [[OCAD_App_Manual#Symbols|Settings – Symbol favorites]] for more configuration options.

===The Quick Configuration Button===
The quick configuration [[File:Settings rect.svg|border|30px]] button displays a panel where the user can quickly perform the following options:
*Turn on or off editing Sketches – this will hide all Sketching and erasing tools.
*Turn on or off editing of map objects – this will hide all Map-object editing tools.<nowiki>*</nowiki>
*Set the [[OCAD_App_Manual#Configurable_Zoom_Buttons|configurable zoom buttons]].
*Change the symbol toolbar rows to a different ''Symbol favorites''. See [[OCAD_App_Manual#Symbols|Settings – Symbol favorites]] for more information.
*Tapping the [[File:stylus.svg|border|30px]] button will take the user to the Settings page and [[OCAD_App_Manual#Symbols|Symbol Favorites tab]].

[[File:Ocadapp QuickConfigButton.png| px]]

<nowiki>*</nowiki> If the current project was exported [[OCAD_App_Data_Exchange#Arrange_Export|without the permission for Map-Object editing]] then the ''Edit map objects'' option here will be Off and disabled.

==Drawing New Map Objects==
There are point, line and area Symbols, each have differing behavior, option, and actions buttons.

[[File:Ocadapp DrawingObjects.png| px]]

To start drawing tap on one of the symbols, this symbol becomes the active drawing tool which can be seen in the lower toolbar.

To select a different symbol which is not in the user’s rows of symbols tap on the symbol selector [[File:Grid.svg|border|30px]] button to show a panel with all other symbols:

[[File:Ocadapp SelectAnotherSymbol.png|650px]]

An alternative way to change the symbol is to select a map object of the desired symbol type. Note that this will NOT change the active tool in the App to the drawing tool.

[[File:Ocadapp ChangeSymbolSelectMapObject.png| px]]

In the above example a green object is selected, and so the drawing symbol type is changed to the green symbol. 
The selection tool is still active. To start drawing green symbols just tap on the green symbol drawing button in the toolbar.

===Points===
Point objects can be created with a single tap to screen. If the point objects can be placed directionally then tap and drag to adjust the orientation, releasing the drag will create the object.

===Lines and Areas===
The default behavior for drawing lines is to use the curve-and-straight behavior [[File:Draw curve straight.svg|border|30px]]

[[File:Ocadapp DrawCurve.png| px]]

If the user taps and drags the stylus/finger/mouse a Bezier curve will be created, but if the user taps and releases, then taps again elsewhere then straight lines will be created between the tapped points.

[[File:Ocadapp DrawRectangular.png| px]]

The rectangular [[File:Draw rectangular.svg|border|30px]] behavior can be used too:

[[File:Ocadapp DrawRectangularBuilding.png| px]]

Use the ''backspace'' [[File:Backspace.svg|border|30px]] button to remove the last added point.

===Re-using Geometry - Following===
When using the curve behavior, it is possible to ''follow'' the geometry of one or more other existing line/area objects by using the follow [[File:Snap and follow.svg|border|30px]] option. 
In the following example the green area is drawn following the track to the north, then the edge of the yellow, then across the white forest and then follows the dashed track. 
When the finger/stylus/mouse is following a line, it shows a light blue cursor on that line – this blue circle is only visible on Android devices:

[[File:Ocadapp FollowingOption.png| px]]

===Finishing or Discarding===
To finish drawing a line or area tap on either the finish [[File:Finish line.svg|border|30px]] or finish-and-close [[File:Finish close.svg|border|30px]] buttons:

[[File:Ocadapp FinishingButtons.png| px]]

This will save the object on the device. Note that area objects only have the finish-and-close button.

If the user wants to discard the entire new object before finishing, they can tap the [[File:Delete bin.svg|border|30px]] button.

===Object Preview===
Object preview while drawing only works on Android and with a special stylus, but not on iOS.

==Editing Selected Map Objects==
The user can select one or many objects at the same time when the selection tool [[File:Select.svg|border|30px]] is active.

[[File:Ocadapp SelectionTool.png|350px]]

As mentioned in [[OCAD_App_Manual#Selections|Status bar - Selection]], the status bar at the top contains information about what is selected.

===De-selecting Map Objects===
To de-select map objects either:
*Tap outside the area covered by the selected objects.
*Tap again on the select tool [[File:Select.svg|border|30px]].

===Edit Actions===
When objects are selected:

*They can be deleted using the delete [[File:Delete bin.svg|border|30px]] button on the toolbar.
*They can be converted to objects of a different symbol type using the change-symbol [[File:Change symbol.svg|border|30px]] action:

[[File:Ocadapp ChangeSymbol.png|650px]]

It is only possible to change points to points, but lines and areas can be changed to lines OR areas. Here five objects which are of three different green symbols are changed to an orange symbol.

*They can have their direction or side changed using the side/direction [[File:Reverse.svg|border|30px]] action if the selected symbols have such attributes:

[[File:Ocadapp ReverseSymbol.png|650px]]

There are different behaviors that the finger/stylus/mouse can have when using the selection tool: edit, cut, re-shape, and add/remove points, these are described below.

===Edit Selection Behavior===
'''Important:''' There is NO button for this default edit behavior, it is active when NO OTHER behavior is selected.
:[[File:Ocadapp EditSelectionBehavior.png]]

When using this behavior, the user can:
*Move objects.
*Rotate directional point objects.
*Edit the object’s geometry.

'''Move objects'''
:To move all the selected objects, tap and drag the dashed selection rectangle.
:[[File:Ocadapp MoveObejcts.png|200px]]

'''Rotate Directional Point Objects'''
:Directional point objects display a small selection arrow attached to the point. This arrow can be tapped and dragged around the point to change its direction.
:In this example 3 directional point objects are selected and then each is rotated individually:
[[File:Ocadapp RotateDirectionalPointObject.png|200px]]

'''Edit Object Geometry'''
:To edit the geometry, the user can tap and drag one of:
:*A rectangular object’s blue square corner vertex:
::[[File:Ocadapp MoveCornerVertex.png]]

:*A curved object’s blue square side handle to change the size of the object:
::[[File:Ocadapp MoveCurveVertex.png]]

:*A curved object’s blue circle Bezier handle to change the curvature of the side:
::[[File:Ocadapp MoveBezierHandle.png]]

===Cut Selection Behavior===
Select an object and activate the [[File:Cut.svg|border|30px]] behavior. Both lines and areas can be cut.

Cutting a line removes part of that line where the cut is made, this could result in the object being split into two objects if the cut is in the middle; or just a truncation if the cut is near one end or the other.

Cutting an area is demonstrated below.

[[File:Ocadapp ActivateCutBehavior.png| px]]

Tap on the edge and draw a ''cut'' line across the object:

[[File:Ocadapp CutArea.png| px]]

Tap on the finish [[File:Finish line.svg|border|30px]] button to complete the cut.
At any point the last cut-point can be deleted using the [[File:Backspace.svg|border|30px]] button, or aborted using the [[File:Close cross.svg|border|30px]] button. 
There are now two objects selected as can be seen in the status bar:

[[File:Ocadapp AreaCutTwoParts.png| px]]

Either part can now be moved or modified independently:

[[File:Ocadapp EditCutArea.png| px]]

''Note that the current implementation only allows cutting an object in two pieces. Cutting a hole is not [yet] implemented.''

===The Re-Shape Selection Behavior===
The geometry of an existing object can be changed by using the re-shape [[File:Reshape.svg|border|30px]] behavior, select an object and tap the behavior button:

[[File:Ocadapp ReshapStart.png| px]]

Starting on the edge of the object, draw the new geometry, finishing on the line again:

[[File:Ocadapp ReshapeDraw.png| px]]

Tap on the finish [[File:Finish line.svg|border|30px]] button to complete and save the re-shaped map object:

[[File:Ocadapp ReshapeFinish.png| px]]

There is still only one object, but it now has a new geometry.

===Add & Remove Points Behavior===
Geometry points can be added or removed using the Add/Remove Points behavior [[File:Add remove point.svg|border|30px]] button, select an object:

[[File:Ocadapp AddRemovePoints.png| px]]

Tapping on the point on the left will remove it. Tapping on the edge on the right will create a new point:

[[File:Ocadapp AddRemovePointsComplete.png| px]]

''Note that Bezier control points (round blue circles) cannot be removed.''

===Change vertex type===
A vertex can have one of 3 different modes which affect the distribution of dashes and other things along a line. When the vertex type behavior [[File:Ocadapp VertexTypeBehavior.png]] is selected, tapping on a vertex will toggle the vertex type between the 3 different values.
:[[File:Ocadapp NormalVertex.png]] Normal vertex
:[[File:Ocadapp DashVertex.png]] Dash vertex
:[[File:Ocadapp CornerVertex.png]] Corner vertex

[[File:Ocadapp DifferentVertexTypes.png]]

More information about vertices can be found [[Vertices|here]].

===Editing Holes in Areas===
There are no specific tools to add or delete holes in areas (at present), however the points in an existing hole can be moved, added or removed. 
[[File:Hint.jpg]] By removing all the points for the hole, the hole can be deleted. Or by adding/editing points to the hole it can modified or enlarged.

===Hide and Protect Map Objects===
Long-press on a symbol in the map toolbar to hide or protect its objects.

'''Hidden''' 
Hidden map objects are not visible and selectable. 
Hidden symbols appear with a gray cross (x) in the map toolbar.

'''Protected''' 
Protected map objects are visible but not normally selectable. 
Protected symbols appear with a gray diagonal in the map toolbar.

The user can edit protected map objects by selecting the symbol and then changing to the selection tool [[File:Select.svg|border|30px]]. 
While the protected symbol is the active symbol it will be both selectable and the user can create new map objects of that symbol type.

[[File:OCAD App Hide And Protect Objects.png]]

===Course Setting Objects===
Course setting projects can be opened using the App.
There is currently no functionality for editing course setting objects, and the control numbers are now drawn in a fixed position to the north-east of the control circle.

The App can be used as an aid for checking control sites before a competition in much the same way the OCAD Sketch App could.

In the future more functionality will be added to support course setting.

[[File:Ocadapp CourseSettingObjects.png]]

==Minimum Distances==
There is currently no specific tool or way to show the minimum distance between features on a map. We hope to add such functionality sometime in the future.

==Map Layers==
To manipulate the visibility, opacity and transparency of the various layers in the App, open the right-hand details panel and select the layers [[File:Layers.svg|border|30px]] tab on the left.

[[File:Ocadapp MapLayers.png|650px]]

The layers in this list are drawn in the order of the list, so background maps are drawn on the screen first, then the map, and finally the sketches and notes. Only the background maps can have their draw-order changed.

The visibility of any layer can be changed by tapping the Checkbox [[File:Check box.svg|border|30px]]

The sliders [[File:Ocadapp MapLayerSlider.png| px]] are used to adjust the opacity of each layer. Except for the notes where the slider adjusts the size of the note icon on the map.

The transparency of a background layer can be turned on/off user the [[File:Transparent map.svg|border|30px]] button.

The order of the background layers can be adjusted using the drag [[File:Drag.svg|border|30px]] buttons. When the panel is docked and narrow, the names of the background layers are abbreviated while trying to keep them unique in the list. 
To find the actual name of an abbreviated layer name tap on it and a message will briefly appear with the full name.

The [[File:Ocadapp MapLayersShowAllNone.png| px]] buttons turn on/off all background layers at once.

The [[File:Ocadapp MapLayersToggle.png| px]] button will turn on/off the currently selected layers – the App will remember the currently selected layers, which only get updated when tapping on a checkbox or using All or None. 
The number on the button indicates the number of layers the toggle is operating on.

==Sketches==
Sketches are raster drawings placed on top of the map. Using sketches for line and area type objects can be faster and more convenient than drawing map objects on a small device. They are also transferred to the OCAD Desktop.

===Drawing===
The App has different Sketch colors and widths for making sketches.

[[File:Ocadapp Sketches.png|500px]]

Each color always remembers the width used with it, so the user does not have to change width each time they change to a different color. The widths of each color are also visible in the button icons (for example the thick dark green in the image above).

Filtering and sorting unused colors can be done in the [[OCAD_App_Manual#Drawing_2|Settings - Drawing - Sketching]].

The visibility and opacity of all Sketches can be adjusted using the [[OCAD_App_Manual#Map_Layers|Map Layers panel]].

===Erasing===
The eraser tool [[File:Eraser.svg|border|30px]] can be used to delete sketches. The size of the eraser can be adjusted using the slider [[File:Ocadapp EraserSlider.png|150px]] at the top of the map toolbar. 
The eraser is round and removes sketches when the user taps and drags the eraser across the map.

[[File:Ocadapp ErasingSketches.png|500px]]

Resulting in all sketches being removed:

[[File:Ocadapp ErasingSketchesDone.png|500px]]

===Single Color Erasing===
The single-color eraser allows the user to erase sketches of a specific sketch color. The Single-Color Eraser behavior button [[File:Eraser.svg|border|30px]] appears on the top left of the Map Toolbar whenever a sketch color is selected. 
Tapping on another sketch color switches back to sketch drawing. 
In this example the red sketch color is selected, and the “erase single color” behavior is activated:

[[File:Ocadapp SingleColorErasing.png|500px]]

Only the red sketches are erased when dragging across the map:

[[File:Ocadapp SingleColorErasingDone.png|500px]]

The dark green and white sketches remain.

==Notes==
Notes are temporary objects like sketches, placed on top of the map; they have a text field and a color. They are also transferred to the OCAD Desktop.

===Creating a New Note===
Tap the Notes tool [[File:Bubble text.svg|border|30px]] button to start the notes tool which has three behaviors (create, move, select):

[[File:Ocadapp CreateNewNote.png|650px]]

The add note [[File:Bubble add.svg|border|30px]] behavior button should appear. 
Tapping on the map should create a note in that position on the map:

[[File:Ocadapp AddNoteToMap.png|400px]]

The note is represented by an icon on the map. At the same time, a note editor panel will appear on top of the map.

The text editor contains unique default text ''Note 1,2,3'' etc.

The color of a note can be changed by selecting one of the other colors below the text editor using the [[File:Ocadapp NotesColor.png|100px]] buttons. Note that other colors can be added here by changing the list of colors in [[OCAD_App_Manual#Drawing_2|Settings – Drawing - Notes]].

Tapping the [[File:drag_bar_bottom.svg|border|30px]] button to the right of the colors will navigate the user to [[OCAD_App_Manual#Notes_2|Settings – Drawing - Notes]].

When the user starts to create a note, the create-note behavior button changes to a move behavior [[File:Move.svg|border|30px]] button, this will allow the user to reposition the note they are currently editing.

To save the note tap on the [[File:Confirm.svg|border|30px]] button below the text editor.

To discard a note without saving, tap on the [[File:close_cross.svg|border|30px]] button below the text editor.

If the user’s device supports speech-to-text [[File:Ocadapp SpeechToTextIcon.png|30px]] technology, the user can use spoken text to record a note: 
[[File:Ocadapp SpeechToTextNote.png]]

'''Important''': If the user changes tool before confirming/saving a note then the note will be automatically saved. If they did not want this note they could tap undo or delete it.

===Selecting Notes===
When the note tool is active the other behavior is the select notes [[File:Select.svg|border|30px]] button. The user can select one or many notes by tapping or dragging a rectangle on the map:

[[File:Ocadapp SelectNote.png| px]]

When notes are selected the user can:
*Start to edit the note using the edit-note [[File:Edit note.svg|border|30px]] button – ONLY appears if one note is selected.
*Zoom to the selected notes on the map using the zoom-to [[File:Zoom to note.svg|border|30px]] button.
*Delete the selected notes using the delete [[File:delete_bin.svg|border|30px]] button.

To de-select all notes tap elsewhere on the map.

===The Note Icon===
The note icon changes slightly depending on whether it is:
*Being edited (red arrow below)
*Is Selected (2 purple arrows below)
*Is not selected or being edited (the other purple note)

The currently edited note always has a thick border and is shaded; selected notes have shading and a thin border.

[[File:Ocadapp NoteIcon.png|500px]]

===The Notes List===
The details panel on the right-hand side of the App also has a notes tab containing the list of notes and other sorting and filtering functions:

[[File:Ocadapp NotesList.png|500px]]

The notes selection on the list and map is synchronized so selecting one in the list will select it on the map and vice versa.

After selecting one or more notes in the list the user can use the zoom-to [[File:Zoom to note.svg|border|30px]] button on the map toolbar to find those notes on the map. And the [[File:delete_bin.svg|border|30px]] button on the map toolbar deletes those selected notes.

The items in the list only display the first line of a note, the user must edit a note to see the rest of the text.

Double-tapping a note in the list will:
*Zoom to that single note.
*Start the editor for that note so the user can change the text or color. Then the user can:
:*Use the [[File:Confirm.svg|border|30px]] button to save changes.
:*Use the [[File:close_cross.svg|border|30px]] button to discard without changing.

===Notes Sorting===
The user can use the sort [[File:Sort alpha down.svg|border|30px]] button to re-order the notes in the list – this button has four toggle values which cycle when tapped:
*Alphabetical descending [[File:Sort alpha down.svg|border|30px]]
*Alphabetical ascending [[File:Sort alpha up.svg|border|30px]]
*Modification date descending [[File:Sort date down.svg|border|30px]]
*Modification date ascending [[File:Sort date up.svg|border|30px]]

''In the following images in the next section variations of the sorting button can be seen.''

===Notes Filtering===
The notes list can be filtered by either:
*Text
*The Notes appearing in the current map viewport.

''Note that the filter only hides notes from the list, not from the map.'' 
Enter text in the filter field and the list will be filtered:

[[File:Ocadapp NotesFiltering.png| px]]

Tapping the [[File:close_cross.svg|border|30px]] button will clear the text filter.

Turning on the viewport filter [[File:Filter map.svg|border|30px]] button will show only the notes currently visible on the map:

[[File:Ocadapp NotesViewportFilter.png|500px]]

In this case AAA and BBB cannot be seen in the list because they are outside the map’s visible area. Zooming in and out or panning the map will modify the notes in the list as they become visible or hidden.

===Deleting===
There is no warning when deleting one or more notes because it is an undoable action, see [[OCAD_App_Manual#Undo_-_Redo|Undo-Redo]].

===Notes on OCAD Desktop===
To see notes on OCAD Desktop they must be imported in the same way as Sketches. They can then be managed using the '''[[Sketch]]''' menu: 
[[File:Ocadapp NotesonOCADDesktop.png|400px]]

==Undo - Redo==
The Undo [[File:Undo.svg|border|30px]] and Redo [[File:Redo.svg|border|30px]] buttons provide a way for the user to revert an action or re-do one that was recently reverted.

All editing actions are ''undo'' and ''redo''-able as single atomic actions. Atomic actions affect one or many objects at the same time. Some examples of these actions are listed below. 
If an example has the word ''confirm'' afterwards then the undo action occurs when tapping the green confirm button. 
*Creating a point map-object.
*Creating a line or area map-object - confirm.
*Deleting many map objects of different symbol types.
*Moving many objects at the same time.
*Cutting one object – confirm.
*Re-shaping one object - confirm.
*Adding or deleting a single geometry point.
*Changing direction or side of many objects at the same time.
*Changing many different objects of differing symbols to one symbol type.
*Drawing a single sketch.
*Erasing many sketches with one drag on the map.
*Erasing sketches of a single color.
*Creating a note - confirm.
*Editing a note – includes changing text, color, or position - confirm.
*Deleting many notes at the same time.
*Generating a sketch or line/area map-object from the GPS – confirm.

Some things which are NOT undo-able: 
*Tapping the backspace when creating, cutting, or re-shaping a line/area.
*Notes sorting and filtering.
*Panning or zooming, or setting fixed zoom levels.
*Filtering the map objects selection using the status bar functions.
*Changing anything in the Background layers tab.
*Changing any setting in the Quick Configuration Panel
*Changing anything in the Settings page and tabs.

==GPS Functions==
If the user’s device has GPS functionality, then both sketches and map-objects can be generated from GPS data. Start by opening the GPS panel using the GPS [[File:Location line.svg|border|30px]] button:

[[File:Ocadapp GPSPanel.png|500px]]

This panel has the following buttons:
*The sketch and symbol – line/area selector [[File:Ocadapp SketchSymbolSelector.png| px]] button.
*The line / area, start & stop recording [[File:Location record start.svg|border|30px]] button.
*The pause recording [[File:Location record pause.svg|border|30px]] button.
*The smoothing [[File:Ocadapp GPSSmoothingSlider.png| px]] slider.
*The curve mode [[File:Gps curve.svg|border|30px]] button if a symbol is being generated.
*The straight-line mode [[File:Gps rectangular.svg|border|30px]] button if a symbol is being generated.
*The finish [[File:Finish line.svg|border|30px]] button if a sketch or line symbol is being generated.
*The finish-and-close [[File:Finish close.svg|border|30px]] button if a line or area symbol is being generated.
*The discard [[File:delete_bin.svg|border|30px]] button.

===Record a Sketch===
To start recording ensure the device has GPS reception and you have positioning turned on – you should see a purple cross identify where you are standing on the map, use the [[File:Position.svg|border|30px]] button to center the map where you are standing.

Tap on the selector [[File:Ocadapp SketchSymbolSelector.png|30px]] button:

[[File:Ocadapp SketchRecordingStart.png| px]]

Select the desired color and line width, tap the [[File:Close cross.svg|border|30px]] to close the selector panel. Start to move, the GPS sketch will start to be generated when the user has moved at least 1-2 meters:

[[File:Ocadapp SketchRecordingMove.png| px]]

While recording the button will change icon to a pause image [[File:Location record pause.svg|border|30px]] and the border of the button will flash on/off to indicate that recording is ongoing.

The slider above is in the left position which means there is less smoothing, and more points are used. Moving the slider to the right removes lots of the intermediate points:

[[File:Ocadapp SketchRecordingSlider.png| px]]

The slider can be adjusted while drawing is on-going. The user can also change color or line width while the recording too.

[[File:Ocadapp SketchRecordingFinish.png| px]]

To finish the drawing tap the finish [[File:Finish line.svg|border|30px]] or finish-and-close [[File:Finish close.svg|border|30px]] button as above, the object is now saved.

Tapping undo will remove the sketch and re-load it into the recorder whereupon the user could resume recording again. This will only work if the ''GPS-finish'' was the last action performed.

''Note that when drawing a sketch there is no Bezier curve fitting, it only does point reduction.''

===Record a Map Object===
Open the selector again and change to the Symbols tab, only line or area symbols will be displayed:

[[File:Ocadapp MapObjectRecordingStart.png| px]]

Select the desired symbol type. Similarly to sketch generation the user can change symbol type at any time during recording.

Start recording. The slider is to the left so more points are used in the generation. The curve mode is active, so the line is a curve and smoothed.

[[File:Ocadapp MapObjectRecordingCurveSliderLeft.png| px]]

Moving the slider to the right and less points are used to make the curve:

[[File:Ocadapp MapObjectRecordingCureSliderRight.png| px]]

Changing to more points and straight-line mode and the map-object now looks like this:

[[File:Ocadapp MapObjectRecordingStraightLineSliderLeft.png| px]]

And moving the slider to the right reduces the number of points used:

[[File:Ocadapp MapObjectRecordingStraightLineSliderRight.png| px]]

Once the user is happy with the best approximation of the object they are generating, they can tap on the finish [[File:Finish line.svg|border|30px]] or finish-and-close [[File:Finish close.svg|border|30px]] button. The object is then saved.

[[File:Ocadapp MapObjectRecordingFinish.png| px]]

Tapping undo will remove the object and re-load it into the recorder whereupon the user could resume recording again. This will only work if the ''GPS-finish'' was the last action performed

===Pausing Recording===
Note that the drawing can be paused and resumed at any time, only while the recording is ongoing will points be added to the geometry. This means the user can: 
a) Start recording, some points are added… 
b) Pause recording. 
c) Move away from the recording position to inspect and draw something else… 
d) Move back to the approximate recording position and resume. 
e) Some more points are recorded, then the user finishes. 
f) The sketch/map-object generated will not include the movement in ‘3’ and ‘4’ above.

===Undo-Redo===
Both the Finish and Discard actions are undoable.

If the user taps on Finish the sketch or map-object is created. If then the user taps undo the sketch or map-object will be deleted and reloaded back into the GPS recording tool. The user can then:
*Re-start recording to continue adding points to the geometry.
*Change sketch color or width, or change symbol.
*Change the finish action to finish-and-close
*Change the smoothing or curve/straight option
If the user taps the discard [[File:delete_bin.svg|border|30px]] button the geometry being generated will be deleted. Tapping undo will add the geometry back in to the GPS recording tool and the user can continue generating their geometry.

Redo actions generally have the inverse behavior of undo which would be re-finishing the sketch/object, but without changes; or discarding the geometry again.

===Hiding the GPS Toolbar===
If the user closes the GPS toolbar while recording, the generating geometry will be hidden on the map, but the main GPS button will still flash to indicate that the recording is on-going. 
Opening the GPS-toolbar again and the geometry will be displayed again. 
Hidden, but flashing:

[[File:Ocadapp HideGPSToolbar.png| px]]

=Settings=
The App currently has three variations of the Settings Page which contain one or more tabs depending on the context of the page. To show the Settings Page, tap on the settings [[File:Settings.svg|border|30px]] button.
#During email registration – a page a tab with [[OCAD_App_Manual#Support|support]] information is shown.
#From the Projects page – a page with tabs for [[OCAD_App_Manual#General|general]], [[OCAD_App_Manual#Positioning|positioning]], [[OCAD_App_Manual#Drawing_2|drawing]], and [[OCAD_App_Manual#Support|support]] is shown.
#From the Project page – a page with tabs for [[OCAD_App_Manual#General|general]], [[OCAD_App_Manual#Positioning|positioning]], [[OCAD_App_Manual#Symbols|symbols]], [[OCAD_App_Manual#Drawing_2|drawing]], and [[OCAD_App_Manual#Support|support]] is shown.

[[File:Ocadapp ProjectSettings.png| px]]

Tapping the close [[File:Close cross.svg|border|30px]] button will close the settings page and return the App to whichever page was visible beforehand.

==Conventions==
On a settings page the user will see small arrow buttons.

[[File:Ocadapp ProjectSettingsArrowButtons.png| px]]

This is an expander button. If the checkbox is tapped, then the expander can also be tapped to display more options related to the setting.

When expanded there is a vertical green line below the checkbox indicating the scope of the sub-settings which appear below to the right:

[[File:Ocadapp ProjectSettingsArrowButtonsExpand.png| px]]

The following sections describe the different settings on each tab:

==General==
This tab displays general settings:

===Theme===
The OCAD App has both light and dark modes:

[[File:Ocadapp SettingsLightMode.png|75px]] [[File:Ocadapp SettingsDarkMode.png|75px]]

The System defined option will use whatever mode the operating system of the device is using.

===Language===
The App currently different languages to choose from.

[[File:Ocadapp SettingsLanguage.png|75px]]

===Button Size===
The user can decide on the desired button size in the App by adjusting the slider:

[[File:Ocadapp SettingsButtonSize.png|500px]]

The number of buttons across the screen width is also indicated, this may be useful when designing [[OCAD_App_Manual#Symbols|Symbol Favorites]] or when using small devices such as phones.

A smaller size may be suitable for use with a stylus, while bigger sizes are better with fingers.

===Screen Margin===
Some devices are insensitive to tapping around the edges, the user can increase the margin around the App, so the edge is not used:

[[File:Ocadapp SettingsScreenMargin.png]]

===Toolbar Position===
The toolbar has two positions:
*Floating and moveable
*Docked to the bottom of the screen.

[[File:Ocadapp SettingsToolbarPosition.png|500px]]

The default setting for this is “Device defined” which means that if the device screen width is less than the approximate size of about: ''(8 buttons) x (the button size)'' 
Then the toolbar will be docked at the bottom, if greater than this size it will be floating.

===Zoom===
These settings can be used to hide the zoom in and out buttons. The auto-rotate and auto-center functions of the Fixed zoom level actions can also be turned off.

[[File:Ocadapp SettingsZoomButtons.png|350px]]

===Compass===
If the device has a compass (internal or external) then this setting is visible. The size of the compass can also be specified:

[[File:Ocadapp SettingsShowCompass.png|500px]]

===Status bar===
The status bar can be hidden.
If it is visible:
*It can be positioned at the top or bottom of the screen.
*The text tooltips can be shown or hidden.
[[File:Ocadapp SettingsShowStatusBar.png|200px]]

===Scale Bar===
The scale bar on the map can be hidden:

[[File:Ocadapp SettingsShowScaleBar.png|500px]]

===North Lines===
The App can display magnetic north lines overlayed on the map with an equidistance given in millimeters. Note that these north lines only exist in the App, they are not the same as drawn north lines.

[[File:Ocadapp SettingsShowNorthLines.png|200px]]

===Demo Projects===
The two options to add demo projects to the App can be hidden with this checkbox.

===User Settings===
Tapping on the User Settings button:

[[File:Ocadapp SettingsUserSettings.png]]

Will open the User Settings page:

[[File:Ocadapp SettingsUserSettingsPage.png]]

Tapping the ''Unregister'' button will unregister the device from the OCAD server. See [[OCAD_App_Manual#Registration|Registration]] and [[OCAD_App_Manual#Technical_Notes|Technical Notes]] for more information.

There is currently no way to change the email address or name without unregistering and re-registering.

Note: This requires an Internet connection.

Important: Unregistering a device will NOT delete the projects on the device, but unless there is a registered user then any projects on the device cannot be uploaded to the cloud transfer service or exported.

==Positioning==
The tab contains generic settings for GPS and positioning functionality.

[[File:Ocadapp SettingsPositioning.png|400px]]

===Positioning===
The user’s current position on the map can be displayed using an indicator, the size, color and type can be modified:

[[File:Ocadapp SettingsPositioningShowCurrentPosition.png|500px]]

Tapping the default color [[File:Ocadapp SettingsPositioningDefaultColorSquare.png|30px]] square will reset the color back to purple. 
The number of GPS satellites available affects the precision of the position, the accuracy of the position can be shown on the map by tapping the “Show position precision” checkbox. 
This will display a shaded circle around the location on the map. A smaller circle indicates a more accurate position.

===Logging and tail===
The App can also record the user’s position and display the tracking of where they have been.

Background logging can be enabled which means the app will continue to record its position even when another app is active on the device. This usually requires approving permission on the device.

The visibility and length of the tail can be changed, as well the Color.

[[File:Ocadapp SettingsPositioningLogPosition.png|500px]]

Tapping the default color [[File:Ocadapp SettingsPositioningDefaultColorSquare.png|30px]] square will reset the color back to purple.

==Symbols==
The Symbols tab shows the configuration interface for editing “symbol favorites”. Symbol favorites are a way for the user to configure the symbol rows on the map toolbar, so they only need to see the symbols they use regularly. 
But it is possible to have more than one symbol favorites, so the user can have one for sand-dune terrain, and another for mountain terrain. Or for city parks and another for indoor maps. 
There is no limit to the number of different favorites.

The app comes with three predefined favorites ((their definitions can be found in an [[OCAD_App_Manual#Appendix_B_-_Default_Symbol_Favorites|Appendix B]]):
*Forest Symbols
*Sprint Symbols
*No sets

These cannot be deleted but can be hidden if not needed.

The user interface for symbol favorites is split into two parts, the favorites selector, and the favorites editor.

===Favorites Selector===
At the top of the Symbols tab there are functions for selecting the active favorites and buttons for creating and duplicating favorites:

[[File:Ocadapp SettingsSymbols.png|500px]]

The create favorites [[File:Heart plus.svg|border|30px]] button can be used to create new favorites.

The duplicate favorites [[File:Favorites copy.svg|border|30px]] button can be used to create a new copy of the current active favorites.

Use the drop-down menu [[File:Ocadapp SelectSymbolFavorite.png|150px]] to select the active favorites. The active favorites are the ones that will appear in the map toolbar. The user can also use the [[OCAD_App_Manual#The_Quick_Configuration_Button|Quick Configuration Panel]] to change the active favorites. This will also select the favorites that can be modified in the [[OCAD_App_Manual#Favorites_Editor|Favorites Editor]] below.

===Favorites Editor===
The favorites editor can edit ONE favorites at a time.

[[File:Ocadapp SettingsSymbolsFavoritesEditor.png|500px]]

The favorites have a name which can be changed (apart from the predefined favorites) to something appropriate such as ''Sand dunes'', ''Indoor'', ''Mountain'' or ''Forest Protected'' etc.

If the favorites are predefined then the Reset [[File:Refresh.svg|border|30px]] button appears, this will change the predefined favorites back to their original configuration.

The [[File:Ocadapp SettingsSymbolsVisibleCheckbox.png|80px]] checkbox can be used to hide a favorites from the [[OCAD_App_Manual#The_Quick_Configuration_Button|Quick Configuration Panel]]. This is useful if the user never makes Sprint maps, they can then just hide ''Sprint Symbols''.

===Sets===
A favorites is made up of ''sets''. A set represents a row in the map toolbar. It is possible to have up to five user-defined sets (or rows) in a favorites. Each set can contain many symbols, if there are too many for the width of the screen then row scrollbars are used in the map toolbar.

The number of sets and number of symbols in each set is up to the user to decide, but obviously the button size, screen size and orientation (portrait / landscape) will affect how the rows will look in the map toolbar.

To add a new set tap on the add set [[File:Playlist add.svg|border|30px]] button. To delete a set tap on the delete set [[File:Delete bin.svg|border|30px]] button beside the set to be deleted. The delete action will show a warning because deleting a set is not undoable, all changes are saved immediately.

===The Other Set===
Below the defined sets (1-5) will appear the “Other” set. This is where the user should put the symbols they do not use or only occasionally.

'''Important''': The Symbols favorites are project independent, but when editing the favorites only those symbols which are in the current project will be shown. And the symbol icon for a particular symbol always comes from the project file. In one project the symbol number 100.001 could be a road and in another type of project it could be a tree. Internally favorites are just a definition of sets, and each set has a list of symbol numbers. When opening a project, the app makes a mathematical intersection merging each favorites with the symbols in the project. Any symbol in a favorite set that is NOT in a project will remain in that set but will not be visible. And any symbol not in a user-defined set but exists in a project will be placed in the ''Other'' set.

Symbols in the “Other” set appear in the symbol selector panel which appears when tapping the symbol sector [[File:Grid.svg|border|30px]] button.

Note: The order of symbols in the ''Other'' set is not currently saved.

===Protected Symbols===
Protected symbols are those which are not normally selectable on the map and the user would not usually want to add or edit them. The ''Protected'' set appears below the ''Other'' set.

[[File:Ocadapp SettingsSymbolsProtectedSymbols.png| px]]

More information about protected symbols can be found in [[OCAD_App_Manual#Editing_Protected_Map-Objects|Editing protected map objects]].

===Editing Sets===
The symbols in the sets are edited by dragging them from one set to another. The order of the symbols in each set can also be edited by dragging symbols to the left and right within a set.

The user can drag one or many symbols from ONE set into another, for example, the user is going to move these four water symbols from Other to Set 1 and place them before the rock symbols:

[[File:Ocadapp SettingsSymbolsEditingSets.png|650px]]

Result:

[[File:Ocadapp SettingsSymbolsEditingSetsDone.png|650px]]

Note: only symbols from one set at a time can be dragged to another set.

A grey symbol selector [[File:Grid.svg|border|30px]] button icon always appears at the start of the last user-defined set. This is to indicate a placeholder to the user that the symbol selector button will appear in this position in the map toolbar.

To deselect all symbols, tap on the deselect [[File:Remove selection.svg|border|30px]] button here:

[[File:Ocadapp SettingsSymbolsDeselectSymbols.png|500px]]

===Delete a Symbol Favorites===
At the bottom of a symbol favorites is a delete [[File:Delete bin.svg|border|30px]] button which can be used to delete the current symbols favorites:

[[File:Ocadapp SettingsSymbolsDeleteSymbolFavorites.png| px]]

Note that this will display a warning as deleting a favorites is NOT undoable, all changes are saved immediately.

===Example Scenarios===

The following are three example scenarios demonstrating the possibilities of Symbol Favorites:
*'''Using a tablet in the mountains'''
Set up two favorites: Mountain and Mountain village.

[[File:Ocadapp SettingsSymbolsExampleMountain.png|650px]]

[[File:Ocadapp SettingsSymbolsExampleMountainVillage.png|650px]]

Make all other favorites hidden, then when out in the field the user can easily swap between the two sets of favorites using the [[OCAD_App_Manual#The_Quick_Configuration_Button|Quick Configuration Panel]]:

[[File:Ocadapp SettingsSymbolsQuickToolbar.png|500px]]

*'''Working with Protected Symbols'''
The user could set up different favorites for those times they want to edit protected map-objects:

[[File:Ocadapp SettingsSymbolsProtectedMapObjects.png|500px]]

While using this favorites the normally protected symbols are all editable. Revert to the normal Forest Symbols favorites afterwards.

*'''Phone'''
Working with limited space, creating a couple of favorites and using the No Sets favorites if doing a lot of sketching. In this case the user has decided that 8 buttons wide is about right for using their finger to draw. So, three rows of 8 symbols. The user can have common symbols between the sets if needed too:

[[File:Ocadapp SettingsSymbolsPhoneSprint1.png|250px]]
[[File:Ocadapp SettingsSymbolsPhoneSprint2.png|250px]]
[[File:Ocadapp SettingsSymbolsPhoneNoSets.png|250px]]

==Drawing==
On the Drawing tab there are settings for the selection and order of colors for sketching and notes.

[[File:Ocadapp SettingsDrawing.png]]

===Sketching===
By tapping a sketch color button, it can be turned on and off. Only those colors which are ''on'' will appear in the map toolbar.

To change the order of the colors, tap, hold, and drag one color at a time to a new position in the list.

===Notes===
By tapping a note color button, it can be turned on and off. Only those colors which are ''on'' will appear at the bottom of the note editor.

To change the order of the colors, tap, hold, and drag one color at a time to a new position in the list.

The Notes tool button can be hidden or positioned in different locations in the App.

[[File:Ocadapp SettingsNotes.png]]

===Map Objects===
*'''Show legibility halo''': The legibility halo shall support the cartographer to draw point and line objects with enough distance to each other. 
The distance of the legibility halo is based on the IOF specifications for orienteering maps.

[[File:OCAD App Legibility Halo Line Object.png|300px]]

[[File:OCAD App Legibility Halo Point Object.png|300px]]

==Support==
The Support setting tab contains advanced information and actions for sending information back to OCAD.

At the top is a Help section with links to the App Manual and the OCAD Wiki.

Note: A project can also be sent to OCAD Support using a function in the [[OCAD_App_Manual#Advanced|Advanced]] section of Project Options.

[[File:Ocadapp SettingsSupport.png|500px]]

===Log Settings===
The app logs activity by the user in a text file on the device. If the user encounters problems with the App they are encouraged to turn on “Extra app logging” then send the log files to OCAD for analysis.

The log files are stored locally on the device. A new log file is created each day and once the log file reaches a certain size (16MB). Older log files are automatically deleted by the app regularly.

The user can send one or more log files to OCAD (internet connection required). When sending a log file, the user should also write a message to describe what they were doing and why they are sending the log file(s).

IMPORTANT: When describing what the user is doing please try and specify to the nearest minute when the crash or problem occurred – this helps us a lot!

When sending a message with a log file only the first 1000 characters are sent, to send more text see [[OCAD_App_Manual#Sending_Feedback|Sending Feedback]] below.

Each log file has a link which can be tapped to open it on the device, this could be useful if the user needs to send part of a log file to OCAD, or if the Send function fails.

===Sending Feedback===
The user can send feedback messages to OCAD using the Message function. There is no limit to the size of text that can be submitted.

===App Settings===
The app’s App settings contain small pieces of information like the color order of the notes, or the position of the floating toolbar. There are currently about one hundred different things stored here. To send a copy of the settings for the current device, the user can do so by selecting the ''App settings file'' checkbox and tapping the ''Send to OCAD'' button. Only do this if requested to do so by OCAD as it may be useful to help resolve problems.

===Other Information===

[[File:Ocadapp SettingsSupport OtherInformation.png]]

The App privacy policy can be found here by clicking on the link: ''www.ocad.com/en/privacy/''

The current app version is displayed here.

If a project is open, then the ID of the project is displayed here, there is a copy [[File:Content copy.svg|border|30px]] button to the right which will copy the currently open projects id to the clipboard on the device.

=Appendices=
==Appendix A - App Updates==
The following sections describe functionality updates between recent versions of the App and this document.

'''Version 1.1.0.79'''
*Legibility Halo can be shown for point and line objects, see [[OCAD_App_Manual#Map_Objects|here]].
*Long-press on symbol shows symbol number and symbol name, see [[OCAD_App_Manual#Button_Rows|here]]
*Long-press on symbol gives possibility to hide or protect objects, see [[OCAD_App_Manual#Hide_and_Protect_Map_Objects|here]].
*Japanese and Chinese (traditional) language has been added.
*Performance improvements.

'''Version 1.0.5.71'''
*Good, poor, lost GPS Status indicators added to the status bar, see [[OCAD_App_Manual#GPS_Status|here]].
*Fixed zoom level auto-rotate and auto-center can now turned off in Settings, see [[OCAD_App_Manual#Zoom|here]].

'''Version 0.9.2.62'''
*3 configurable fixed zoom level buttons added, see [[OCAD_App_Manual#Configurable_Zoom_Buttons|here]]
*Scan Project QR code on the App to share a project with another device, see [[OCAD_App_Manual#Advanced|here]].
*Send Project to OCAD Support button added, see [[OCAD_App_Manual#Advanced|here]].
*Italian language has been added.

'''Version 0.9.1.60'''
*Directional point objects can now be rotated, see [[OCAD_App_Manual#Edit_Selection_Behavior|here]].
*Geometry vertex type can now be toggled between the value normal, dash and corner, see [[OCAD_App_Manual#Change_vertex_type|here]].
*Chinese and Portuguese languages have been added.

==Appendix B - Default Symbol Favorites==
'''Forest Symbols''' 
Set 1: ''101000, 102000, 103000, 103001, 109000, 110000, 111000, 112000, 201001, 202001, 202002, 202003, 203100, 204000, 205000, 207000'' 
Set 2: ''303000, 308001, 311000, 313000, 417000, 418000, 419000, 503000, 504000, 505000, 506000, 507000, 508000, 530000, 531000'' 
Protected: 
''Open land, paved area, out-of-bounds area: 401000, 501000, 501001, 520000, 520004'' 
''DEM Wizard smoothed contour symbols :10060000, 10061000, 10062000, 10060001, 10061001, 10062001, 10080000, 10081000, 10082000'' 
Protected + hidden: 
''DEM Wizard unsmoothed contour symbols: 10050000, 10051000, 10052000, 10050001, 10051001, 10052001''

'''Sprint Symbols''' 
Set 1: ''204000, 301000, 311000, 313000, 417000, 418000, 419000, 530000, 531000, 401000, 406000, 410000, 411002'' 
Set 2: ''501001, 501021, 501100, 513100, 513200, 515000, 516000, 518000, 520001, 521000, 522000, 532000'' 
Protected: 
''Open land, paved area, out-of-bounds area: 401000, 501000, 501001, 520000, 520004'' 
''DEM Wizard smoothed contour symbols :10060000, 10061000, 10062000, 10060001, 10061001, 10062001, 10080000, 10081000, 10082000'' 
''New Map Wizard - Swiss survey data symbols: 999000, 999001, 999010, 999011, 999512, 999513, 999515, 999521, 999522, 999523'' 
Protected + hidden: 
''DEM Wizard unsmoothed contour symbols: 10050000, 10051000, 10052000, 10050001, 10051001, 10052001'' 

==Appendix C - Folder Transfer==
Use the following sections as a guide for transferring a project to and from the App without using the cloud transfer or any internet connection.

Requirements:
*A cable to connect your device to your Windows Computer
*For iOS it is necessary to use iTunes from Apple and to have enabled “Trust” between the device and Windows so that Windows will be able to read and write files.

There may be other ways and techniques to copy the files to and from a device, but the ways described below use ordinary Windows folders.

===OCAD Desktop Export===

On the third step of the Data-exchange process the user can select “USB cable” as the transfer option:

[[File:Ocadapp FolderTransfer TransferOption.png]]

Clicking on the “Open folder and copy data” will open a Windows explorer window in a location like this:

:''C:\Users\user-name\AppData\Roaming\OCAD\OCAD 2018\Tmp\_OcadAppExchangeData\_DesktopToApp''

[[File:Ocadapp FolderTransfer TransferFolderToApp.png]]

The user should then copy this transfer project folder to the OCAD folder on their device. It is important to copy the WHOLE folder with ALL contents, see next sections.

===Copying to Android===
Copy the project folder from the step above to the location:

:''This PC\Galaxy Tab S8 \Internal storage\Android\data\com.ocad.app\files''

[[File:Ocadapp FolderTransfer TransferFolderToAppAndroid.png]]

After copying, there should be the “Bürenflue Export” project folder like this:

[[File:Ocadapp FolderTransfer TransferFolderToAppAndroidDone.png]]

The user can now open the OCAD App to import the project, see below.

===Copying to iOS===
Open iTunes on Windows and click on the device button:

[[File:Ocadapp FolderTransfer TransferFolderToAppiOS.png]]

Then click on:
#“File Sharing”
#Find the “OCAD” App
#Drag the whole folder from the “_DesktopToApp” folder into the right-hand side of the of iTunes where the list of folders is.
#Click on “Sync” to transfer the data to your iOS device

[[File:Ocadapp FolderTransfer_TransferFolderToAppiOSDone.png]]

Important: Do not try and use “Add File:” as this does not copy whole folders. 
When the “sync” has completed your project will be able to be imported into the OCAD App, see below. 
Note that copying the project files to iOS works similarly by using iCloud.

===Importing on the device===
Once the folder is moved to the above locations on the device, start the OCAD App, then click on [[File:Project add.svg|border|30px]] and “From folder”, the App will scan the folder and find the projects to import, select the desired project and tap on “Import”:

[[File:Ocadapp FolderTransfer ImportFromDevice.png]]

When the project import has completed, the user should be able to work with it in the same way as if it had been imported via the Cloud Transfer Service.

After importing, the files in the “Bürenflue Export” folder will be automatically removed, this is important as if the user was to do another “OCAD Desktop Export” and “copy” then the App will prompt the user to update their project on the App, see [[OCAD_App_Manual#Project_Lifecycle_2|Project Lifecycle]] below.

The “Bürenflue Export” folder is not deleted as it is used later for the export.

===Export from the device===
Tapping on the [[File:More vert.svg|border|30px]] button will open the project options, select the Export option.

[[File:Ocadapp FolderTransfer ExportFromDevice.png]]

This will export the project data from the internal storage and create files that can be copied back to the Windows computer and imported into OCAD Desktop. The export will create a folder similar to this:

:''export_iPhone_a43aae3a-debf-471e-849c-2290c526bab8''

or:

:''export_Galaxy Tab S8_a43aae3a-debf-471e-849c-2290c526bab8''

in the “Bürenflue Export” folder on the device. The names of the folders are unique to the device, this will enable the OCAD Desktop user to import data from various devices without risk of overwriting data.

Tapping on the “Include positioning file” checkbox above will also export the position.db file to the same location.

===Copy from Android===
Copy the export folder

:''export_Galaxy Tab S8_e667dd18-a34d-4223-94cb-e7c093cf5bb3''

From

:''This PC\Galaxy Tab S8\Internal storage\Android\data\com.ocad.app\files\Bürenflue Export''

To:

:''C:\Users\<user_name>\AppData\Roaming\OCAD\OCAD 2018\Tmp\_OcadAppExchangeData\_AppToDesktop\Bürenflue Export''

Important: Note that _AppToDesktop and _DesktopToApp are two different folder, ensure you copy to the correct one!

[[File:Ocadapp FolderTransfer CopyFromAndroid.png]]

The project can now be imported into OCAD Desktop.

===Copy from iOS===
Open iTunes and follow the initial instructions in [[OCAD_App_Manual#Copy_from_iOS|Copying to iOS]] above selecting File Sharing and the OCAD App. Then:
#Sync the data, this will copy the Bürenflue Export folder to your computer
#Select the Bürenflue Export folder
#The user may need to scroll down the screen to see the Add File… and Save… buttons
#Click on the Save… button

[[File:Ocadapp FolderTransfer_CopyFromiOS.png]]

After clicking Save… navigate to the folder:

:''C:\Users\<…user name…> \AppData\Roaming\OCAD\OCAD 2018\Tmp\_OcadAppExchangeData\_AppToDesktop''

Make sure the folder _AppToDesktop is selected in the Folder field (3).

[[File:Ocadapp FolderTransfer_CopyFromiOS2.png]]

Important: Note that _AppToDesktop and _DesktopToApp are two different folder, ensure you select the correct one!

After copying there will be a sub-folder in the project folder called something like:

:''export_iPhone_a43aae3a-debf-471e-849c-2290c526bab8''

[[File:Ocadapp FolderTransfer_CopyFromiOS3.png]]

Warning: If the project folder Bürenflue Export already exists the user will be prompted to overwrite it, and iTunes will OVERWRITE EVERYTHING. So, if there are export folders from other devices they will BE DELETED.

To work around this the user could save the folder elsewhere and copy it later to the _AppToDesktop folder. Or make sure previous imports have been completed using OCAD Desktop before saving the folder here.

Note that copying the project files from iOS works similarly by using iCloud.

===Import to OCAD Desktop===
From OCAD Desktop, select the menu item File – OCAD App Data Exchange. Select the transfer project “Bürenflue Export”, then in the panel below are listed the two exports from different devices. Click on “Import data from App”:

[[File:Ocadapp FolderTransfer ImportToOCADDesktop.png]]

This window is displayed for the “USB cable” transfer project, click on “Get importable files”:

[[File:Ocadapp FolderTransfer ImportToOCADDesktopGetFiles.png]]

This window is displayed with the available device imports:

[[File:Ocadapp FolderTransfer ImportToOCADDesktopImportFiles.png]]

Select one and click on Import Data and follow the usual procedure for importing data.

===Project Lifecycle===
After following the above procedure once, it is possible to re-export from OCAD Desktop again, copy to the device again, then tap Refresh (1) above the Projects List on the device. An orange message should appear in the list (2), tap to update the project with the latest version of the project from the Desktop.

[[File:Ocadapp FolderTransfer RefreshProjectList.png]]

After updating the project can be opened, edited, closed, re-exported, copied back to Windows and re-imported.

A project can have multiple users using one or more devices, using this copying system makes the process of working offline relatively easy.

===Technical Details===
The following details describe the files if a user needs to transfer files in other ways, such as email etc. Using a ZIP file could be recommended for this.

'''OCAD Desktop Exported files.''' 
The following items are exported from the OCAD Desktop and placed in a transfer project folder such as “Bürenflue Export”:
*“map.ocdExchange” – an OCAD file that can be imported to the App.
*“project.ocdInfo” – a small file containing transfer information.
*“back” folder - containing background images
The name of the folder containing these items should be the same as the transfer project in OCAD Desktop.

'''OCAD App Exported files.''' 
The export process creates a sub folder of the project transfer folder “Bürenflue Export”. The sub-folder name is constructed from “export”_”device-name”_”branch-ID”. This export sub-folder should contain two or three files:
*“map.ocdExchange” – an OCAD file that can be imported to the Desktop.
*“project.ocdInfo” – a small file containing transfer information.
*“position.db” – an optional file containing positioning information if the user also exports this.
Note that the background images are not exported as they cannot be changed on the App.

==Appendix D - Technical Notes==
'''Data Storage'''

The OCAD exchange files transferred to the device are only ever read on the device, some information in the files is copied to other hidden storage files on the device.

Only by exporting or uploading a project are OCAD exchange files created from the data in the internal storage.

The user should not copy or delete files in the directory: 
:''This PC\Galaxy Tab S8\Internal storage\Android\data\com.ocad.app\files\_projectdata''

Changing these files will break a project on the device and probably make it impossible to upload or export the project.

The files in this directory are required by a project to display the map correctly, but they do NOT contain the changes the user makes by editing the project.

If the user requires more space on their device, then background files (in the “back” folder) can be deleted manually without breaking a project. Deleting any other file will break the project.

'''Security'''

When using the OCAD Cloud-Transfer service the user may be concerned about security as there is no password or encryption involved in the process. Project security is based on the concept of anonymity, the user is the only person that has the project-id, there is no list of these ids anywhere, they are randomly generated 128 bit numbers so it is practically impossible to guess. See [https://en.wikipedia.org/wiki/Universally_unique_identifier Universally unique identifier - Wikipedia]. If the user shares an id with others, then there is a risk if those users share it.

OCAD App Manual

2026-07-17T11:20:37Z

KLH: /* Advanced */

This wiki page describes how the OCAD App works. 
To the main page of the '''[[OCAD App]]''' | To the '''[[OCAD App Data Exchange]]''' page.

[[File:Hint.jpg|30px]] There are small differences between the operating systems Android, iOS and Windows. This documentation has been produced using all three so images may look slightly different at times.

=Registration=
After starting the App, the first thing the user must do is select a language, this also can be changed at any time later by using the [[OCAD_App_Manual#Language|Settings]].

The full functionality of the OCAD App is available after registration. To register the user needs to enter a valid email address and their name.

A user should use the same email address if they use multiple devices. These pieces of information can then be used to manage imports from the App into OCAD Desktop so that user will know from whom an upload comes from and which of their devices.

[[File:Hint.jpg]] If the user has multiple devices they plan to register, the same email address should be used and each device should have a unique name for that user. 
For example: “iPad”, “iPhone”, “Android Tablet”, “Robs Phone” etc. If two devices have the same name it may make importing data from the App to OCAD Desktop confusing to the user as they may not know exactly which device the data comes from.

==Email and Name==
Enter a valid email address: 
[[File:Ocadapp registrationEmail.png|350px]]

After entering a valid email address, the user is prompted to enter their name: 
[[File:Ocadapp registrationName.png|350px]]

After entering a name an email will be sent to the address: 
[[File:Ocadapp requestSent.png|350px]]

Tap on the link in the address to complete the registration. 
[[File:Ocadapp registrationConfirmEmail.png|350px]]

The App will detect the confirmation, tapping on the ''Continue'' button will take the user to the '''[[OCAD_App_Manual#Projects|Projects]]''' page.

==Other Functionality==
The User Interface Language can be changed. 
Using the [[File:settings.svg|border|30px]]button, some settings can be changed.

==Demo Mode==
*The user can evaluate the App using two [[OCAD_App_Manual#Download_a_Sample_Project|sample projects]].
*The user CANNOT download or import any other project.
*The sample projects can be edited in any way, note that certain functions may not work fully such as the GPS functionality which requires being at the real location of the sample maps.
*The user CANNOT upload the sample projects to the OCAD server.
*The user can delete and re-import the sample projects any time.
*No notifications or any other information is sent to OCAD in demo mode.
*The registration page will always be shown until an email address is entered.
*After entering an email address or choosing Demo mode the App will go to the '''[[OCAD_App_Manual#Projects|Projects]]''' page.

==Technical Notes==
*The Registration requires an Internet connection.
*OCAD stores the email address and name for each registered user. It also stores a list of devices for each user, the device name and the device id is stored.
*Only one user can be registered at one time for the App on a single device.
*The user and device registration is NOT a login mechanism. There is no password.
*If the user wants to change email address or name, they must first unregister the user from the device – see '''[[OCAD_App_Manual#User_Settings|User Settings]]'''.
*If the user is unregistered from the device all projects WILL BE PRESERVED on the device, they can continue to be edited, but the user CANNOT Upload or Export the project until a new registration is made.
*If a user has multiple devices, they will NOT be prompted for a name when registering the second and subsequent devices.
*If a user has multiple devices, then unregistering one will remove it from the list of devices for that user on the OCAD server. When the last device is unregistered, the user will also be deleted.

=Projects=
[[File:Ocadapp ProjectsPage.png]]

The projects page will contain a list of projects.

==Add Project==
To Add a project, it must be imported to the App. During this process, an OCAD file is converted into a native App format which provides better performance for drawing and viewing large maps. 
Tap on the [[File:Project add.svg|border|30px]] button to add a project.

[[File:Ocadapp AddProject.png]]

When adding a project, it will first be downloaded, then processed, this could take a few minutes for large projects and depends on Internet speed and device performance. 
The App does not write changes directly to the OCAD file which is stored on the device, all data and changes are stored in internal storage.

===From QR Code===
If your device has a camera that is accessible from the App (permissions may be required) then the user can scan a QR code from OCAD Desktop to download and import a project.

The user can now also scan a QR code using the camera on your device and it will open the OCAD App and start the import of that project.

===From Project ID===
The OCAD Desktop produces a link in the App Data Exchange process; this link contains an ID which can be pasted into the entry field. If a link or id is detected on the clipboard it will be automatically pasted into the ID field. 
For example: <nowiki>https://app.ocad.com/project/6da31400-4a94-43e8-7ae6-8e8ece235b04</nowiki>

[[File:Ocadapp DownloadProject.png|400px]]

The user can paste the whole link or just the ID.

If the user has this link in an email or other message it can now be tapped/clicked which will open the OCAD App and download the project.

===From Folder===
Although it is generally preferred and recommended to use the OCAD Cloud Transfer Services to move projects back and forth from the OCAD Desktop to the OCAD App, there may be times when manual copying of data is required. For example:
*The user has no internet connection
*The transfer project or even map file has been lost on OCAD Desktop so the user cannot use the cloud-transfer to retrieve the map.
*The user is concerned about the security of their project being on the internet.

There are slightly different techniques depending on whether the device is Android or iOS. The process involves:
#OCAD Desktop export
#Copying to the iOS or Android device
#Importing on the device
#The user makes changes to the project on the device
#Export from the device
#Copy from the iOS or Android device to the Windows computer
#Import to OCAD Desktop

Information about these processes can be found in the '''[[OCAD_App_Manual#Appendix_C_-_Folder_Transfer|Appendix C]]'''.

===Sample Projects===
The two sample projects can be downloaded at any time.

===Download a Sample Project===
The two sample projects can be downloaded at any time.
*The sample projects can be edited in any way, note that certain functions may not work fully such as the GPS functionality which requires being at the real location of the sample maps.
*The user CANNOT upload the sample projects to the OCAD server.
*The user can delete and re-import the sample projects any time.

==The projects page==

===Refresh the Projects List===
To refresh the projects list, tap on the [[File:Refresh.svg|border|30px]] button. See [[OCAD_App_Manual#Project_Update_from_Desktop|Project Update from Desktop]] for more details.

===Settings===
Tapping the [[File:Settings.svg|border|30px]] button will take the user to the settings page, see [[OCAD_App_Manual#Settings_2|Settings]]

===Internet Status===
At the bottom of the Projects page there is a small cloud icon beside the App version information: 
[[File:Ocadapp InternetStatus.png| px]]

Tapping on the cloud will reveal the internet status and if the App is connected to the OCAD server: 
[[File:Ocadapp InternetStatusConnected.png| px]]

If the user cannot download or upload a project, then it could be that the device has either:
*no internet connection – a red cloud
*a problem with connection to the OCAD server – an orange cloud

An error message will appear indicating the problem beside the cloud icon. 
[[File:Hint.jpg]] The App does not maintain a permanent connection to the OCAD server, it is only required when:
*Downloading a project
*Uploading a project
*Updating a project
*Refreshing the list of Projects
*Registering the user
*Sending log files or projects to OCAD Support

===The Projects List===
The list of projects can be displayed as tiles [[File:Grid view.svg|border|30px]] or as a list [[File:Bulleted list.svg|border|30px]] by toggling the button on the top right:

[[File:Grid view.svg|border|30px]] Tiles 
[[File:Ocadapp ProjectListTiles.png|300px]]

[[File:Bulleted list.svg|border|30px]] List 
[[File:Ocadapp ProjectListList.png|300px]]

The projects can also be sorted alphabetically by name or by modified date (newest at the top): 
[[File:Ocadapp ProjectListSort.png|200px]]

==Project Management==
Tap on the project to open it.

Tapping on the [[File:More vert.svg|border|30px]] button will open the project options:

[[File:Ocadapp ProjectOptions.png|500px]]

===Open===
Tapping on the project '''Open''' button will also open the project.

===Upload===
Once changes have been made, the project can be uploaded to the OCAD server, then imported to the OCAD Desktop. 
A positioning file can be optionally included when uploading. This will make a ''position.db'' file available for import into OCAD Desktop.

===Delete===
A project can be deleted; a confirmation warning is shown. There is no way to reverse this action.

===Advanced===
Other functionality may appear here, currently:
*Export
*QR Code
*Repair
*Backups
*Send Project to Support

[[File:Ocadapp_ProjectManagementAdvanced2.png]]

'''Export''' 
See the [[OCAD_App_Data_Exchange|OCAD App Data Exchange]] page for more information. Tapping on the “Include positioning file” checkbox above will also export the position.db file.

'''QR Code''' 
This QR represents the selected project, it can be used to download the project to a new device. Note that:
*It will download the latest version of the project that was exported from OCAD Desktop and exists on the OCAD Cloud transfer service.
*It requires an internet connection.
*The downloaded project will have the same permissions that were set up in the Cloud Transfer Service.

Use this function to easily share a project with friends or download the project to a secondary device.

'''Repair'''
This function repairs the map tiles which are used for the map rendering. Try it when a project's map or it's preview on the project list show only white pixels or if the App crashes when opening a project.

'''Send Project to Support''' 
When sending a project to OCAD Support the user will be prompted to enter a reason for sending it. Please only send projects if:
*We have requested you to do so to provide support which could include fixing a bug or recovering data.
*The project cannot repeatedly be opened and the user needs help.
Note that background files and images are NOT included when sending a project to OCAD Support. Sending a project to OCAD Support requires an internet connection.

===Project Status===
The most recent download/upload action is shown below the project. 
Beside it is a small green arrow, tapping this arrow will open the History below. 
[[File:Ocadapp ProjectStatus.png|320px]]

Tapping the small arrow or list will close it again. 
[[File:Ocadapp ProjectStatusCloseHistory.png|320px]]

For example, if there is a new update of a project on the OCAD server then refreshing the list will provide an indication of this, see [[OCAD_App_Manual#Project_Update_from_Desktop|Project Update from Desktop]].

===Project Update from Desktop===
If the project has been updated and exported from the Desktop,
then refreshing the Projects list will indicate that an updated version of the Project is available for download.

[[File:Ocadapp ProjectUpdateDesktop.png|485px]]

Tapping the [[File:Cloud update.svg|border|30px]] button will update the Project on the App, or alternatively use the Update option:

[[File:Ocadapp CloudUpdate.png|485px]] 
'''Important!''' When updating, only Background maps and a few settings for the project are preserved. All other data is deleted, and new data is re-imported. 
If the user has any changes that have NOT been uploaded to the OCAD Server and then imported and merged with the OCAD file on the Desktop, then those changes will be lost!

The other possible notification here is if the transfer project has been deleted on the OCAD Desktop. 
If this is the case, and there are changes that need transferring to the OCAD Desktop, then the project will need to be exported from the App and manually transferred to the user’s computer.

Note: These notifications for cloud transfer projects will only appear if the App is connected to the Internet and the OCAD Server – see [[OCAD_App_Manual#Internet_Status|Internet Status]].

===Project Lifecycle===
When a project is exported from the OCAD Desktop to the OCAD Cloud Transfer it will remain on the server for 7 days. After that it will be automatically deleted.

However, the project could still obviously be in use both on the App and on OCAD Desktop. The user can still upload (or export) the project and then import changes from the App.

=Project Editing=
After opening a project, the map and editing tools will be seen on the Project page:

[[File:Ocadapp ProjectEditing.png|600px]]

==Project Toolbar==

[[File:Ocadapp ProjectToolbar.png|600px]]

'''Important:''' There is no ''Save'' button on the OCAD App. All changes are saved almost immediately to internal storage. 
Note that some actions need to be completed before saving will occur – such as drawing a line or area object.

===Close===
The project can be closed using the [[File:Close cross.svg|border|30px]] button.

===GPS Functions===
GPS functions are accessed via the [[File:Location line.svg|border|30px]] button. See [[OCAD_App_Manual#GPS_Functions_2|GPS Functions]] for more details.

===Map Layers and Notes===
To open a panel containing information about map layers and notes tap the [[File:Detail panel.svg|border|30px]] button. 
This panel contains two tabs, firstly for [[OCAD_App_Manual#Map_Layers|map layers]]: 
[[File:Ocadapp MapLayer.png| px]]

and secondly for [[OCAD_App_Manual#Notes|notes]]: 
[[File:Ocadapp Notes.png| px]]

This panel can behave as either a temporary “popup” panel or docked to the right-hand side by tapping the [[File:Panel right docked.svg|border|30px]] button on the right: 
[[File:Ocadapp PanelRightDocked.png| px]]

If the panel is docked, then the width can be adjusted by dragging the left edge of the panel. 
[[File:Ocadapp PanelDrag.png| px]]

===Settings===
Tapping the [[File:Settings.svg|border|30px]] button will take the user to the settings page, see [[OCAD_App_Manual#Settings_2|Settings]].

==Status Bar==
Below the project toolbar is a status bar which provides various pieces of information such as:
*The stylus / finger / mouse actions that are available for the currently active tool.
*The type of selected objects and how many of each.
*The length or surface area if one object is selected.
*The GPS status on the device.

[[File:Ocadapp StatusBar.png| px]]

===Interactions===
The [[File:Tap.svg|border|30px]] icon indicates that the map will accept a tap action on the map for the currently active tool, the associated text describes the behavior.

The [[File:Finger drag.svg|border|30px]] icon indicates that the map will accept a swipe/drag type action on the map for the currently active tool, the associated text describes the behavior.

If the screen is too narrow to display the texts, then tapping the icons will display them:

[[File:Ocadapp InteractionsTap.png| px]]

===Selections===
Selecting many objects on the map generates a summary of the selection in the status bar. 
Depending on how many objects are selected, this could be a single count or a count per symbol type:

[[File:Ocadapp Selection.png| px]]

In this case 3 knolls [[File:Ocadapp SelectionKnoll.png| px]], 1 track [[File:Ocadapp SelectionTrack.png| px]] and 5 green areas [[File:Ocadapp SelectionGreenArea.png| px]]

Tapping on the symbol icons in the status bar will show a panel with details of the selection. 
Tapping on the items in the panel will select and deselect them. 
By recursively filtering a selection using this functionality the user can drill down to one or more specific objects that they want to edit or delete.

In this example the user has tapped the second and fourth green areas which are now selected in the list, so they are selected on the map:

[[File:Ocadapp SelectionSelectGreenArea.png]]

Tapping outside the panel will close it leaving the desired objects selected. 
In the following example the user chooses all the green, yellow and brown dotted areas:

[[File:Ocadapp SelectionSelectGreenYellowDottedArea.png]]

Then closes the popup panel and selects 3 green and 2 yellow areas:

[[File:Ocadapp SelectionSelectGreenYellowArea.png]]

This technique means the user can easily iteratively filter objects so that only the desired ones remain selected.

More information about editing selected objects can be found in [[OCAD_App_Manual#Editing_Selected_Map_Objects|Editing Selected Map Objects]].

To close the small panel just tap again on the map outside the panel.

===Measurements===
If one object is selected, then its length or area is shown.

Length 
[[File:Ocadapp MeasureLength.png| px]]

Area 
[[File:Ocadapp MeasureArea.png| px]]

===GPS Status===
The GPS icon shows the state of the GPS connection:

[[File:Ocadapp GPSStatus.png|150px]]

Red: No connection or the user is outside the map area. 
Orange: Poor connection if the accuracy is > 20m. 
Green: Good connection with accuracy < 20m. 
Tapping on the icon will show a text message indicating Lost, Poor or Good connection status.

==Map==
Below the main toolbar and status bar is the map.

===Finger Gestures===
All the tools have various gestures, most of which are intuitive such as the two-finger pinch to zoom in and out. 
This gesture works on all tools. Other gestures are described in the sections for each respective tool.

===Buttons===
Near the top of the map is a compass and some buttons:

[[File:Ocadapp Buttons.png|600px]]

Note that if the user’s device does not have a GPS or Compass then some of these buttons may be hidden.
*The [[File:Zoom extent.svg|border|30px]] button which zooms to the whole extent of the map. This button can change to the button if the map is not orientated to north on the device.
*The [[File:Zoom in.svg|border|30px]] button can be used to zoom in.
*The [[File:Zoom out.svg|border|30px]] button can be used to zoom out.
*The [[File:Counter 1.svg|border|30px]][[File:Counter 2.svg|border|30px]][[File:Counter 3.svg|border|30px]] buttons which are configurable zoom buttons. See [[OCAD_App_Manual#Configurable Zoom Buttons|Configurable Zoom Buttons]].
*The [[File:Position.svg|border|30px]] button can be used to re-center the map to the user’s position – if the device has a GPS. By double-tapping the button it will change to [[File:Position auto.svg|border|30px]] and the device will keep the map centered as the user moves.
*The [[File:Compass.svg|border|30px]] button can be used to orientate the map to north on the device. Double-tapping it and the button will change to [[File:Compass auto.svg|border|30px]] which means the device will keep the map orientated to north as the user moves.

===Configurable Zoom Buttons===
The App has 3 configurable buttons which can be set to different zoom scales. They are not set to any specific numeric scale. 
When tapping one of these zoom buttons the App will go to the specified scale, auto-rotate and auto-center the map (if the device has a compass and GPS). 
The auto-rotate and auto-center functions can be turned off in the [[OCAD_App_Manual#Zoom|Settings]].

When starting the App the first time a red [[File:Counter 1_red.svg|border|30px]] zoom button will appear, tapping it will open the Quick-configuration panel:

[[File:Ocadapp ConfigurableZoomButtoms.png|350px]]

Tapping the Set button will set the [[File:Counter 1.svg|border|30px]] button to the current map scale. Tapping the checkbox to the left will hide the button on the map.

The user can configure up to 3 buttons to different zoom levels. 
To change a button to a different zoom level, just zoom to that level, open the panel using the [[File:Settings_rect.svg|border|30px]] button on the map toolbar and tap Set again.

===Scale Bar===
At the bottom of the map is a scale bar.

[[File:Ocadapp ScaleBar.png| px]]

==Map Toolbar==
Central to all map editing is the toolbar which could look something like this depending on the type of editing tool selected:

[[File:Ocadapp MapToolbar.png| px]]

It can be moved to a new location using the [[File:Drag.svg|border|30px]] button on the bottom left. It can also be docked to the bottom of the App – see [[OCAD_App_Manual#Toolbar_Position|Settings - Toolbar Position]].

It can be resized using the [[File:Resize.svg|border|30px]] button on the bottom right.

===Button Themes===
Some buttons have a background theme:
*Green – confirmation button to complete a process.
*Red – destructive button to cancel a process or delete something.
*Blue – a behavior to change how a tool works – only ''one'' or ''none'' can ever be active.
*Yellow – an option to change how a tool works – ''none, one or many'' can be active.

===Button Rows===
There are four main types of rows in the toolbar:
*Top row – contains behaviors, options, and actions appropriate to the current active tool.
*Notes + Sketch row – contains the Notes [[File:Bubble text.svg|border|30px]] button on the left and the sketch color buttons.
*Symbol buttons – in the example above there are two rows of symbols, to access other symbols not in the two rows tap on the symbol selector [[File:Grid.svg|border|30px]] button to the left.

[[File:Hint.jpg]] Long-press on a symbol to see its symbol number and symbol name.

*Bottom row which contains:
**The Drag [[File:Drag.svg|border|30px]] button.
**The Undo [[File:Undo.svg|border|30px]] and Redo [[File:Redo.svg|border|30px]] buttons, see [[OCAD_App_Manual#Undo_-_Redo|Undo - Redo]].
**The Pan [[File:Pan.svg|border|30px]] button.
**Sometimes the symbol selector [[File:Grid.svg|border|30px]] button can appear here if there are no rows of symbols above.
**The Select [[File:Select.svg|border|30px]] button, see [[OCAD_App_Manual#Selections|Status bar Selection]] and [[OCAD_App_Manual#Editing_Selected_Map_Objects|Editing Selected Map Objects]].
**The Draw [[File:Stylus.svg|border|30px]] button which changes icon depending on what is to be drawn. The icon can be either a Sketch color & width or a symbol, see [[OCAD_App_Manual#Drawing_Objects|Drawing New Map-Objects]] and [[OCAD_App_Manual#Drawing|Sketch – Drawing]].
**The Sketch Erase [[File:Eraser.svg|border|30px]] button, see [[OCAD_App_Manual#Erasing|Sketch - Erasing]].
**The Quick Configuration [[File:Settings rect.svg|border|30px]] button, see [[OCAD_App_Manual#Map_Toolbar|Map Toolbar]].
**The resize [[File:Resize.svg|border|30px]] button on the bottom right.

Note that the Sketch/Note and Symbol rows can be scrolled horizontally if the screen device is not wide enough for all buttons:

[[File:Ocadapp ButtonRowsScroll.png| px]]

See also [[OCAD_App_Manual#Drawing_2|Settings – Drawing]] and [[OCAD_App_Manual#Symbols|Settings – Symbol favorites]] for more configuration options.

===The Quick Configuration Button===
The quick configuration [[File:Settings rect.svg|border|30px]] button displays a panel where the user can quickly perform the following options:
*Turn on or off editing Sketches – this will hide all Sketching and erasing tools.
*Turn on or off editing of map objects – this will hide all Map-object editing tools.<nowiki>*</nowiki>
*Set the [[OCAD_App_Manual#Configurable_Zoom_Buttons|configurable zoom buttons]].
*Change the symbol toolbar rows to a different ''Symbol favorites''. See [[OCAD_App_Manual#Symbols|Settings – Symbol favorites]] for more information.
*Tapping the [[File:stylus.svg|border|30px]] button will take the user to the Settings page and [[OCAD_App_Manual#Symbols|Symbol Favorites tab]].

[[File:Ocadapp QuickConfigButton.png| px]]

<nowiki>*</nowiki> If the current project was exported [[OCAD_App_Data_Exchange#Arrange_Export|without the permission for Map-Object editing]] then the ''Edit map objects'' option here will be Off and disabled.

==Drawing New Map Objects==
There are point, line and area Symbols, each have differing behavior, option, and actions buttons.

[[File:Ocadapp DrawingObjects.png| px]]

To start drawing tap on one of the symbols, this symbol becomes the active drawing tool which can be seen in the lower toolbar.

To select a different symbol which is not in the user’s rows of symbols tap on the symbol selector [[File:Grid.svg|border|30px]] button to show a panel with all other symbols:

[[File:Ocadapp SelectAnotherSymbol.png|650px]]

An alternative way to change the symbol is to select a map object of the desired symbol type. Note that this will NOT change the active tool in the App to the drawing tool.

[[File:Ocadapp ChangeSymbolSelectMapObject.png| px]]

In the above example a green object is selected, and so the drawing symbol type is changed to the green symbol. 
The selection tool is still active. To start drawing green symbols just tap on the green symbol drawing button in the toolbar.

===Points===
Point objects can be created with a single tap to screen. If the point objects can be placed directionally then tap and drag to adjust the orientation, releasing the drag will create the object.

===Lines and Areas===
The default behavior for drawing lines is to use the curve-and-straight behavior [[File:Draw curve straight.svg|border|30px]]

[[File:Ocadapp DrawCurve.png| px]]

If the user taps and drags the stylus/finger/mouse a Bezier curve will be created, but if the user taps and releases, then taps again elsewhere then straight lines will be created between the tapped points.

[[File:Ocadapp DrawRectangular.png| px]]

The rectangular [[File:Draw rectangular.svg|border|30px]] behavior can be used too:

[[File:Ocadapp DrawRectangularBuilding.png| px]]

Use the ''backspace'' [[File:Backspace.svg|border|30px]] button to remove the last added point.

===Re-using Geometry - Following===
When using the curve behavior, it is possible to ''follow'' the geometry of one or more other existing line/area objects by using the follow [[File:Snap and follow.svg|border|30px]] option. 
In the following example the green area is drawn following the track to the north, then the edge of the yellow, then across the white forest and then follows the dashed track. 
When the finger/stylus/mouse is following a line, it shows a light blue cursor on that line – this blue circle is only visible on Android devices:

[[File:Ocadapp FollowingOption.png| px]]

===Finishing or Discarding===
To finish drawing a line or area tap on either the finish [[File:Finish line.svg|border|30px]] or finish-and-close [[File:Finish close.svg|border|30px]] buttons:

[[File:Ocadapp FinishingButtons.png| px]]

This will save the object on the device. Note that area objects only have the finish-and-close button.

If the user wants to discard the entire new object before finishing, they can tap the [[File:Delete bin.svg|border|30px]] button.

===Object Preview===
Object preview while drawing only works on Android and with a special stylus, but not on iOS.

==Editing Selected Map Objects==
The user can select one or many objects at the same time when the selection tool [[File:Select.svg|border|30px]] is active.

[[File:Ocadapp SelectionTool.png|350px]]

As mentioned in [[OCAD_App_Manual#Selections|Status bar - Selection]], the status bar at the top contains information about what is selected.

===De-selecting Map Objects===
To de-select map objects either:
*Tap outside the area covered by the selected objects.
*Tap again on the select tool [[File:Select.svg|border|30px]].

===Edit Actions===
When objects are selected:

*They can be deleted using the delete [[File:Delete bin.svg|border|30px]] button on the toolbar.
*They can be converted to objects of a different symbol type using the change-symbol [[File:Change symbol.svg|border|30px]] action:

[[File:Ocadapp ChangeSymbol.png|650px]]

It is only possible to change points to points, but lines and areas can be changed to lines OR areas. Here five objects which are of three different green symbols are changed to an orange symbol.

*They can have their direction or side changed using the side/direction [[File:Reverse.svg|border|30px]] action if the selected symbols have such attributes:

[[File:Ocadapp ReverseSymbol.png|650px]]

There are different behaviors that the finger/stylus/mouse can have when using the selection tool: edit, cut, re-shape, and add/remove points, these are described below.

===Edit Selection Behavior===
'''Important:''' There is NO button for this default edit behavior, it is active when NO OTHER behavior is selected.
:[[File:Ocadapp EditSelectionBehavior.png]]

When using this behavior, the user can:
*Move objects.
*Rotate directional point objects.
*Edit the object’s geometry.

'''Move objects'''
:To move all the selected objects, tap and drag the dashed selection rectangle.
:[[File:Ocadapp MoveObejcts.png|200px]]

'''Rotate Directional Point Objects'''
:Directional point objects display a small selection arrow attached to the point. This arrow can be tapped and dragged around the point to change its direction.
:In this example 3 directional point objects are selected and then each is rotated individually:
[[File:Ocadapp RotateDirectionalPointObject.png|200px]]

'''Edit Object Geometry'''
:To edit the geometry, the user can tap and drag one of:
:*A rectangular object’s blue square corner vertex:
::[[File:Ocadapp MoveCornerVertex.png]]

:*A curved object’s blue square side handle to change the size of the object:
::[[File:Ocadapp MoveCurveVertex.png]]

:*A curved object’s blue circle Bezier handle to change the curvature of the side:
::[[File:Ocadapp MoveBezierHandle.png]]

===Cut Selection Behavior===
Select an object and activate the [[File:Cut.svg|border|30px]] behavior. Both lines and areas can be cut.

Cutting a line removes part of that line where the cut is made, this could result in the object being split into two objects if the cut is in the middle; or just a truncation if the cut is near one end or the other.

Cutting an area is demonstrated below.

[[File:Ocadapp ActivateCutBehavior.png| px]]

Tap on the edge and draw a ''cut'' line across the object:

[[File:Ocadapp CutArea.png| px]]

Tap on the finish [[File:Finish line.svg|border|30px]] button to complete the cut.
At any point the last cut-point can be deleted using the [[File:Backspace.svg|border|30px]] button, or aborted using the [[File:Close cross.svg|border|30px]] button. 
There are now two objects selected as can be seen in the status bar:

[[File:Ocadapp AreaCutTwoParts.png| px]]

Either part can now be moved or modified independently:

[[File:Ocadapp EditCutArea.png| px]]

''Note that the current implementation only allows cutting an object in two pieces. Cutting a hole is not [yet] implemented.''

===The Re-Shape Selection Behavior===
The geometry of an existing object can be changed by using the re-shape [[File:Reshape.svg|border|30px]] behavior, select an object and tap the behavior button:

[[File:Ocadapp ReshapStart.png| px]]

Starting on the edge of the object, draw the new geometry, finishing on the line again:

[[File:Ocadapp ReshapeDraw.png| px]]

Tap on the finish [[File:Finish line.svg|border|30px]] button to complete and save the re-shaped map object:

[[File:Ocadapp ReshapeFinish.png| px]]

There is still only one object, but it now has a new geometry.

===Add & Remove Points Behavior===
Geometry points can be added or removed using the Add/Remove Points behavior [[File:Add remove point.svg|border|30px]] button, select an object:

[[File:Ocadapp AddRemovePoints.png| px]]

Tapping on the point on the left will remove it. Tapping on the edge on the right will create a new point:

[[File:Ocadapp AddRemovePointsComplete.png| px]]

''Note that Bezier control points (round blue circles) cannot be removed.''

===Change vertex type===
A vertex can have one of 3 different modes which affect the distribution of dashes and other things along a line. When the vertex type behavior [[File:Ocadapp VertexTypeBehavior.png]] is selected, tapping on a vertex will toggle the vertex type between the 3 different values.
:[[File:Ocadapp NormalVertex.png]] Normal vertex
:[[File:Ocadapp DashVertex.png]] Dash vertex
:[[File:Ocadapp CornerVertex.png]] Corner vertex

[[File:Ocadapp DifferentVertexTypes.png]]

More information about vertices can be found [[Vertices|here]].

===Editing Holes in Areas===
There are no specific tools to add or delete holes in areas (at present), however the points in an existing hole can be moved, added or removed. 
[[File:Hint.jpg]] By removing all the points for the hole, the hole can be deleted. Or by adding/editing points to the hole it can modified or enlarged.

===Hide and Protect Map Objects===
Long-press on a symbol in the map toolbar to hide or protect its objects.

'''Hidden''' 
Hidden map objects are not visible and selectable. 
Hidden symbols appear with a gray cross (x) in the map toolbar.

'''Protected''' 
Protected map objects are visible but not normally selectable. 
Protected symbols appear with a gray diagonal in the map toolbar.

The user can edit protected map objects by selecting the symbol and then changing to the selection tool [[File:Select.svg|border|30px]]. 
While the protected symbol is the active symbol it will be both selectable and the user can create new map objects of that symbol type.

[[File:OCAD App Hide And Protect Objects.png]]

===Course Setting Objects===
Course setting projects can be opened using the App.
There is currently no functionality for editing course setting objects, and the control numbers are now drawn in a fixed position to the north-east of the control circle.

The App can be used as an aid for checking control sites before a competition in much the same way the OCAD Sketch App could.

In the future more functionality will be added to support course setting.

[[File:Ocadapp CourseSettingObjects.png]]

==Minimum Distances==
There is currently no specific tool or way to show the minimum distance between features on a map. We hope to add such functionality sometime in the future.

==Map Layers==
To manipulate the visibility, opacity and transparency of the various layers in the App, open the right-hand details panel and select the layers [[File:Layers.svg|border|30px]] tab on the left.

[[File:Ocadapp MapLayers.png|650px]]

The layers in this list are drawn in the order of the list, so background maps are drawn on the screen first, then the map, and finally the sketches and notes. Only the background maps can have their draw-order changed.

The visibility of any layer can be changed by tapping the Checkbox [[File:Check box.svg|border|30px]]

The sliders [[File:Ocadapp MapLayerSlider.png| px]] are used to adjust the opacity of each layer. Except for the notes where the slider adjusts the size of the note icon on the map.

The transparency of a background layer can be turned on/off user the [[File:Transparent map.svg|border|30px]] button.

The order of the background layers can be adjusted using the drag [[File:Drag.svg|border|30px]] buttons. When the panel is docked and narrow, the names of the background layers are abbreviated while trying to keep them unique in the list. 
To find the actual name of an abbreviated layer name tap on it and a message will briefly appear with the full name.

The [[File:Ocadapp MapLayersShowAllNone.png| px]] buttons turn on/off all background layers at once.

The [[File:Ocadapp MapLayersToggle.png| px]] button will turn on/off the currently selected layers – the App will remember the currently selected layers, which only get updated when tapping on a checkbox or using All or None. 
The number on the button indicates the number of layers the toggle is operating on.

==Sketches==
Sketches are raster drawings placed on top of the map. Using sketches for line and area type objects can be faster and more convenient than drawing map objects on a small device. They are also transferred to the OCAD Desktop.

===Drawing===
The App has different Sketch colors and widths for making sketches.

[[File:Ocadapp Sketches.png|500px]]

Each color always remembers the width used with it, so the user does not have to change width each time they change to a different color. The widths of each color are also visible in the button icons (for example the thick dark green in the image above).

Filtering and sorting unused colors can be done in the [[OCAD_App_Manual#Drawing_2|Settings - Drawing - Sketching]].

The visibility and opacity of all Sketches can be adjusted using the [[OCAD_App_Manual#Map_Layers|Map Layers panel]].

===Erasing===
The eraser tool [[File:Eraser.svg|border|30px]] can be used to delete sketches. The size of the eraser can be adjusted using the slider [[File:Ocadapp EraserSlider.png|150px]] at the top of the map toolbar. 
The eraser is round and removes sketches when the user taps and drags the eraser across the map.

[[File:Ocadapp ErasingSketches.png|500px]]

Resulting in all sketches being removed:

[[File:Ocadapp ErasingSketchesDone.png|500px]]

===Single Color Erasing===
The single-color eraser allows the user to erase sketches of a specific sketch color. The Single-Color Eraser behavior button [[File:Eraser.svg|border|30px]] appears on the top left of the Map Toolbar whenever a sketch color is selected. 
Tapping on another sketch color switches back to sketch drawing. 
In this example the red sketch color is selected, and the “erase single color” behavior is activated:

[[File:Ocadapp SingleColorErasing.png|500px]]

Only the red sketches are erased when dragging across the map:

[[File:Ocadapp SingleColorErasingDone.png|500px]]

The dark green and white sketches remain.

==Notes==
Notes are temporary objects like sketches, placed on top of the map; they have a text field and a color. They are also transferred to the OCAD Desktop.

===Creating a New Note===
Tap the Notes tool [[File:Bubble text.svg|border|30px]] button to start the notes tool which has three behaviors (create, move, select):

[[File:Ocadapp CreateNewNote.png|650px]]

The add note [[File:Bubble add.svg|border|30px]] behavior button should appear. 
Tapping on the map should create a note in that position on the map:

[[File:Ocadapp AddNoteToMap.png|400px]]

The note is represented by an icon on the map. At the same time, a note editor panel will appear on top of the map.

The text editor contains unique default text ''Note 1,2,3'' etc.

The color of a note can be changed by selecting one of the other colors below the text editor using the [[File:Ocadapp NotesColor.png|100px]] buttons. Note that other colors can be added here by changing the list of colors in [[OCAD_App_Manual#Drawing_2|Settings – Drawing - Notes]].

Tapping the [[File:drag_bar_bottom.svg|border|30px]] button to the right of the colors will navigate the user to [[OCAD_App_Manual#Notes_2|Settings – Drawing - Notes]].

When the user starts to create a note, the create-note behavior button changes to a move behavior [[File:Move.svg|border|30px]] button, this will allow the user to reposition the note they are currently editing.

To save the note tap on the [[File:Confirm.svg|border|30px]] button below the text editor.

To discard a note without saving, tap on the [[File:close_cross.svg|border|30px]] button below the text editor.

If the user’s device supports speech-to-text [[File:Ocadapp SpeechToTextIcon.png|30px]] technology, the user can use spoken text to record a note: 
[[File:Ocadapp SpeechToTextNote.png]]

'''Important''': If the user changes tool before confirming/saving a note then the note will be automatically saved. If they did not want this note they could tap undo or delete it.

===Selecting Notes===
When the note tool is active the other behavior is the select notes [[File:Select.svg|border|30px]] button. The user can select one or many notes by tapping or dragging a rectangle on the map:

[[File:Ocadapp SelectNote.png| px]]

When notes are selected the user can:
*Start to edit the note using the edit-note [[File:Edit note.svg|border|30px]] button – ONLY appears if one note is selected.
*Zoom to the selected notes on the map using the zoom-to [[File:Zoom to note.svg|border|30px]] button.
*Delete the selected notes using the delete [[File:delete_bin.svg|border|30px]] button.

To de-select all notes tap elsewhere on the map.

===The Note Icon===
The note icon changes slightly depending on whether it is:
*Being edited (red arrow below)
*Is Selected (2 purple arrows below)
*Is not selected or being edited (the other purple note)

The currently edited note always has a thick border and is shaded; selected notes have shading and a thin border.

[[File:Ocadapp NoteIcon.png|500px]]

===The Notes List===
The details panel on the right-hand side of the App also has a notes tab containing the list of notes and other sorting and filtering functions:

[[File:Ocadapp NotesList.png|500px]]

The notes selection on the list and map is synchronized so selecting one in the list will select it on the map and vice versa.

After selecting one or more notes in the list the user can use the zoom-to [[File:Zoom to note.svg|border|30px]] button on the map toolbar to find those notes on the map. And the [[File:delete_bin.svg|border|30px]] button on the map toolbar deletes those selected notes.

The items in the list only display the first line of a note, the user must edit a note to see the rest of the text.

Double-tapping a note in the list will:
*Zoom to that single note.
*Start the editor for that note so the user can change the text or color. Then the user can:
:*Use the [[File:Confirm.svg|border|30px]] button to save changes.
:*Use the [[File:close_cross.svg|border|30px]] button to discard without changing.

===Notes Sorting===
The user can use the sort [[File:Sort alpha down.svg|border|30px]] button to re-order the notes in the list – this button has four toggle values which cycle when tapped:
*Alphabetical descending [[File:Sort alpha down.svg|border|30px]]
*Alphabetical ascending [[File:Sort alpha up.svg|border|30px]]
*Modification date descending [[File:Sort date down.svg|border|30px]]
*Modification date ascending [[File:Sort date up.svg|border|30px]]

''In the following images in the next section variations of the sorting button can be seen.''

===Notes Filtering===
The notes list can be filtered by either:
*Text
*The Notes appearing in the current map viewport.

''Note that the filter only hides notes from the list, not from the map.'' 
Enter text in the filter field and the list will be filtered:

[[File:Ocadapp NotesFiltering.png| px]]

Tapping the [[File:close_cross.svg|border|30px]] button will clear the text filter.

Turning on the viewport filter [[File:Filter map.svg|border|30px]] button will show only the notes currently visible on the map:

[[File:Ocadapp NotesViewportFilter.png|500px]]

In this case AAA and BBB cannot be seen in the list because they are outside the map’s visible area. Zooming in and out or panning the map will modify the notes in the list as they become visible or hidden.

===Deleting===
There is no warning when deleting one or more notes because it is an undoable action, see [[OCAD_App_Manual#Undo_-_Redo|Undo-Redo]].

===Notes on OCAD Desktop===
To see notes on OCAD Desktop they must be imported in the same way as Sketches. They can then be managed using the '''[[Sketch]]''' menu: 
[[File:Ocadapp NotesonOCADDesktop.png|400px]]

==Undo - Redo==
The Undo [[File:Undo.svg|border|30px]] and Redo [[File:Redo.svg|border|30px]] buttons provide a way for the user to revert an action or re-do one that was recently reverted.

All editing actions are ''undo'' and ''redo''-able as single atomic actions. Atomic actions affect one or many objects at the same time. Some examples of these actions are listed below. 
If an example has the word ''confirm'' afterwards then the undo action occurs when tapping the green confirm button. 
*Creating a point map-object.
*Creating a line or area map-object - confirm.
*Deleting many map objects of different symbol types.
*Moving many objects at the same time.
*Cutting one object – confirm.
*Re-shaping one object - confirm.
*Adding or deleting a single geometry point.
*Changing direction or side of many objects at the same time.
*Changing many different objects of differing symbols to one symbol type.
*Drawing a single sketch.
*Erasing many sketches with one drag on the map.
*Erasing sketches of a single color.
*Creating a note - confirm.
*Editing a note – includes changing text, color, or position - confirm.
*Deleting many notes at the same time.
*Generating a sketch or line/area map-object from the GPS – confirm.

Some things which are NOT undo-able: 
*Tapping the backspace when creating, cutting, or re-shaping a line/area.
*Notes sorting and filtering.
*Panning or zooming, or setting fixed zoom levels.
*Filtering the map objects selection using the status bar functions.
*Changing anything in the Background layers tab.
*Changing any setting in the Quick Configuration Panel
*Changing anything in the Settings page and tabs.

==GPS Functions==
If the user’s device has GPS functionality, then both sketches and map-objects can be generated from GPS data. Start by opening the GPS panel using the GPS [[File:Location line.svg|border|30px]] button:

[[File:Ocadapp GPSPanel.png|500px]]

This panel has the following buttons:
*The sketch and symbol – line/area selector [[File:Ocadapp SketchSymbolSelector.png| px]] button.
*The line / area, start & stop recording [[File:Location record start.svg|border|30px]] button.
*The pause recording [[File:Location record pause.svg|border|30px]] button.
*The smoothing [[File:Ocadapp GPSSmoothingSlider.png| px]] slider.
*The curve mode [[File:Gps curve.svg|border|30px]] button if a symbol is being generated.
*The straight-line mode [[File:Gps rectangular.svg|border|30px]] button if a symbol is being generated.
*The finish [[File:Finish line.svg|border|30px]] button if a sketch or line symbol is being generated.
*The finish-and-close [[File:Finish close.svg|border|30px]] button if a line or area symbol is being generated.
*The discard [[File:delete_bin.svg|border|30px]] button.

===Record a Sketch===
To start recording ensure the device has GPS reception and you have positioning turned on – you should see a purple cross identify where you are standing on the map, use the [[File:Position.svg|border|30px]] button to center the map where you are standing.

Tap on the selector [[File:Ocadapp SketchSymbolSelector.png|30px]] button:

[[File:Ocadapp SketchRecordingStart.png| px]]

Select the desired color and line width, tap the [[File:Close cross.svg|border|30px]] to close the selector panel. Start to move, the GPS sketch will start to be generated when the user has moved at least 1-2 meters:

[[File:Ocadapp SketchRecordingMove.png| px]]

While recording the button will change icon to a pause image [[File:Location record pause.svg|border|30px]] and the border of the button will flash on/off to indicate that recording is ongoing.

The slider above is in the left position which means there is less smoothing, and more points are used. Moving the slider to the right removes lots of the intermediate points:

[[File:Ocadapp SketchRecordingSlider.png| px]]

The slider can be adjusted while drawing is on-going. The user can also change color or line width while the recording too.

[[File:Ocadapp SketchRecordingFinish.png| px]]

To finish the drawing tap the finish [[File:Finish line.svg|border|30px]] or finish-and-close [[File:Finish close.svg|border|30px]] button as above, the object is now saved.

Tapping undo will remove the sketch and re-load it into the recorder whereupon the user could resume recording again. This will only work if the ''GPS-finish'' was the last action performed.

''Note that when drawing a sketch there is no Bezier curve fitting, it only does point reduction.''

===Record a Map Object===
Open the selector again and change to the Symbols tab, only line or area symbols will be displayed:

[[File:Ocadapp MapObjectRecordingStart.png| px]]

Select the desired symbol type. Similarly to sketch generation the user can change symbol type at any time during recording.

Start recording. The slider is to the left so more points are used in the generation. The curve mode is active, so the line is a curve and smoothed.

[[File:Ocadapp MapObjectRecordingCurveSliderLeft.png| px]]

Moving the slider to the right and less points are used to make the curve:

[[File:Ocadapp MapObjectRecordingCureSliderRight.png| px]]

Changing to more points and straight-line mode and the map-object now looks like this:

[[File:Ocadapp MapObjectRecordingStraightLineSliderLeft.png| px]]

And moving the slider to the right reduces the number of points used:

[[File:Ocadapp MapObjectRecordingStraightLineSliderRight.png| px]]

Once the user is happy with the best approximation of the object they are generating, they can tap on the finish [[File:Finish line.svg|border|30px]] or finish-and-close [[File:Finish close.svg|border|30px]] button. The object is then saved.

[[File:Ocadapp MapObjectRecordingFinish.png| px]]

Tapping undo will remove the object and re-load it into the recorder whereupon the user could resume recording again. This will only work if the ''GPS-finish'' was the last action performed

===Pausing Recording===
Note that the drawing can be paused and resumed at any time, only while the recording is ongoing will points be added to the geometry. This means the user can: 
a) Start recording, some points are added… 
b) Pause recording. 
c) Move away from the recording position to inspect and draw something else… 
d) Move back to the approximate recording position and resume. 
e) Some more points are recorded, then the user finishes. 
f) The sketch/map-object generated will not include the movement in ‘3’ and ‘4’ above.

===Undo-Redo===
Both the Finish and Discard actions are undoable.

If the user taps on Finish the sketch or map-object is created. If then the user taps undo the sketch or map-object will be deleted and reloaded back into the GPS recording tool. The user can then:
*Re-start recording to continue adding points to the geometry.
*Change sketch color or width, or change symbol.
*Change the finish action to finish-and-close
*Change the smoothing or curve/straight option
If the user taps the discard [[File:delete_bin.svg|border|30px]] button the geometry being generated will be deleted. Tapping undo will add the geometry back in to the GPS recording tool and the user can continue generating their geometry.

Redo actions generally have the inverse behavior of undo which would be re-finishing the sketch/object, but without changes; or discarding the geometry again.

===Hiding the GPS Toolbar===
If the user closes the GPS toolbar while recording, the generating geometry will be hidden on the map, but the main GPS button will still flash to indicate that the recording is on-going. 
Opening the GPS-toolbar again and the geometry will be displayed again. 
Hidden, but flashing:

[[File:Ocadapp HideGPSToolbar.png| px]]

=Settings=
The App currently has three variations of the Settings Page which contain one or more tabs depending on the context of the page. To show the Settings Page, tap on the settings [[File:Settings.svg|border|30px]] button.
#During email registration – a page a tab with [[OCAD_App_Manual#Support|support]] information is shown.
#From the Projects page – a page with tabs for [[OCAD_App_Manual#General|general]], [[OCAD_App_Manual#Positioning|positioning]], [[OCAD_App_Manual#Drawing_2|drawing]], and [[OCAD_App_Manual#Support|support]] is shown.
#From the Project page – a page with tabs for [[OCAD_App_Manual#General|general]], [[OCAD_App_Manual#Positioning|positioning]], [[OCAD_App_Manual#Symbols|symbols]], [[OCAD_App_Manual#Drawing_2|drawing]], and [[OCAD_App_Manual#Support|support]] is shown.

[[File:Ocadapp ProjectSettings.png| px]]

Tapping the close [[File:Close cross.svg|border|30px]] button will close the settings page and return the App to whichever page was visible beforehand.

==Conventions==
On a settings page the user will see small arrow buttons.

[[File:Ocadapp ProjectSettingsArrowButtons.png| px]]

This is an expander button. If the checkbox is tapped, then the expander can also be tapped to display more options related to the setting.

When expanded there is a vertical green line below the checkbox indicating the scope of the sub-settings which appear below to the right:

[[File:Ocadapp ProjectSettingsArrowButtonsExpand.png| px]]

The following sections describe the different settings on each tab:

==General==
This tab displays general settings:

===Theme===
The OCAD App has both light and dark modes:

[[File:Ocadapp SettingsLightMode.png|75px]] [[File:Ocadapp SettingsDarkMode.png|75px]]

The System defined option will use whatever mode the operating system of the device is using.

===Language===
The App currently different languages to choose from.

[[File:Ocadapp SettingsLanguage.png|75px]]

===Button Size===
The user can decide on the desired button size in the App by adjusting the slider:

[[File:Ocadapp SettingsButtonSize.png|500px]]

The number of buttons across the screen width is also indicated, this may be useful when designing [[OCAD_App_Manual#Symbols|Symbol Favorites]] or when using small devices such as phones.

A smaller size may be suitable for use with a stylus, while bigger sizes are better with fingers.

===Screen Margin===
Some devices are insensitive to tapping around the edges, the user can increase the margin around the App, so the edge is not used:

[[File:Ocadapp SettingsScreenMargin.png]]

===Toolbar Position===
The toolbar has two positions:
*Floating and moveable
*Docked to the bottom of the screen.

[[File:Ocadapp SettingsToolbarPosition.png|500px]]

The default setting for this is “Device defined” which means that if the device screen width is less than the approximate size of about: ''(8 buttons) x (the button size)'' 
Then the toolbar will be docked at the bottom, if greater than this size it will be floating.

===Zoom===
These settings can be used to hide the zoom in and out buttons. The auto-rotate and auto-center functions of the Fixed zoom level actions can also be turned off.

[[File:Ocadapp SettingsZoomButtons.png|350px]]

===Compass===
If the device has a compass (internal or external) then this setting is visible. The size of the compass can also be specified:

[[File:Ocadapp SettingsShowCompass.png|500px]]

===Status bar===
The status bar can be hidden.
If it is visible:
*It can be positioned at the top or bottom of the screen.
*The text tooltips can be shown or hidden.
[[File:Ocadapp SettingsShowStatusBar.png|200px]]

===Scale Bar===
The scale bar on the map can be hidden:

[[File:Ocadapp SettingsShowScaleBar.png|500px]]

===North Lines===
The App can display magnetic north lines overlayed on the map with an equidistance given in millimeters. Note that these north lines only exist in the App, they are not the same as drawn north lines.

[[File:Ocadapp SettingsShowNorthLines.png|200px]]

===Demo Projects===
The two options to add demo projects to the App can be hidden with this checkbox.

===User Settings===
Tapping on the User Settings button:

[[File:Ocadapp SettingsUserSettings.png]]

Will open the User Settings page:

[[File:Ocadapp SettingsUserSettingsPage.png]]

Tapping the ''Unregister'' button will unregister the device from the OCAD server. See [[OCAD_App_Manual#Registration|Registration]] and [[OCAD_App_Manual#Technical_Notes|Technical Notes]] for more information.

There is currently no way to change the email address or name without unregistering and re-registering.

Note: This requires an Internet connection.

Important: Unregistering a device will NOT delete the projects on the device, but unless there is a registered user then any projects on the device cannot be uploaded to the cloud transfer service or exported.

==Positioning==
The tab contains generic settings for GPS and positioning functionality.

[[File:Ocadapp SettingsPositioning.png|400px]]

===Positioning===
The user’s current position on the map can be displayed using an indicator, the size, color and type can be modified:

[[File:Ocadapp SettingsPositioningShowCurrentPosition.png|500px]]

Tapping the default color [[File:Ocadapp SettingsPositioningDefaultColorSquare.png|30px]] square will reset the color back to purple. 
The number of GPS satellites available affects the precision of the position, the accuracy of the position can be shown on the map by tapping the “Show position precision” checkbox. 
This will display a shaded circle around the location on the map. A smaller circle indicates a more accurate position.

===Logging and tail===
The App can also record the user’s position and display the tracking of where they have been.

Background logging can be enabled which means the app will continue to record its position even when another app is active on the device. This usually requires approving permission on the device.

The visibility and length of the tail can be changed, as well the Color.

[[File:Ocadapp SettingsPositioningLogPosition.png|500px]]

Tapping the default color [[File:Ocadapp SettingsPositioningDefaultColorSquare.png|30px]] square will reset the color back to purple.

==Symbols==
The Symbols tab shows the configuration interface for editing “symbol favorites”. Symbol favorites are a way for the user to configure the symbol rows on the map toolbar, so they only need to see the symbols they use regularly. 
But it is possible to have more than one symbol favorites, so the user can have one for sand-dune terrain, and another for mountain terrain. Or for city parks and another for indoor maps. 
There is no limit to the number of different favorites.

The app comes with three predefined favorites ((their definitions can be found in an [[OCAD_App_Manual#Appendix_B_-_Default_Symbol_Favorites|Appendix B]]):
*Forest Symbols
*Sprint Symbols
*No sets

These cannot be deleted but can be hidden if not needed.

The user interface for symbol favorites is split into two parts, the favorites selector, and the favorites editor.

===Favorites Selector===
At the top of the Symbols tab there are functions for selecting the active favorites and buttons for creating and duplicating favorites:

[[File:Ocadapp SettingsSymbols.png|500px]]

The create favorites [[File:Heart plus.svg|border|30px]] button can be used to create new favorites.

The duplicate favorites [[File:Favorites copy.svg|border|30px]] button can be used to create a new copy of the current active favorites.

Use the drop-down menu [[File:Ocadapp SelectSymbolFavorite.png|150px]] to select the active favorites. The active favorites are the ones that will appear in the map toolbar. The user can also use the [[OCAD_App_Manual#The_Quick_Configuration_Button|Quick Configuration Panel]] to change the active favorites. This will also select the favorites that can be modified in the [[OCAD_App_Manual#Favorites_Editor|Favorites Editor]] below.

===Favorites Editor===
The favorites editor can edit ONE favorites at a time.

[[File:Ocadapp SettingsSymbolsFavoritesEditor.png|500px]]

The favorites have a name which can be changed (apart from the predefined favorites) to something appropriate such as ''Sand dunes'', ''Indoor'', ''Mountain'' or ''Forest Protected'' etc.

If the favorites are predefined then the Reset [[File:Refresh.svg|border|30px]] button appears, this will change the predefined favorites back to their original configuration.

The [[File:Ocadapp SettingsSymbolsVisibleCheckbox.png|80px]] checkbox can be used to hide a favorites from the [[OCAD_App_Manual#The_Quick_Configuration_Button|Quick Configuration Panel]]. This is useful if the user never makes Sprint maps, they can then just hide ''Sprint Symbols''.

===Sets===
A favorites is made up of ''sets''. A set represents a row in the map toolbar. It is possible to have up to five user-defined sets (or rows) in a favorites. Each set can contain many symbols, if there are too many for the width of the screen then row scrollbars are used in the map toolbar.

The number of sets and number of symbols in each set is up to the user to decide, but obviously the button size, screen size and orientation (portrait / landscape) will affect how the rows will look in the map toolbar.

To add a new set tap on the add set [[File:Playlist add.svg|border|30px]] button. To delete a set tap on the delete set [[File:Delete bin.svg|border|30px]] button beside the set to be deleted. The delete action will show a warning because deleting a set is not undoable, all changes are saved immediately.

===The Other Set===
Below the defined sets (1-5) will appear the “Other” set. This is where the user should put the symbols they do not use or only occasionally.

'''Important''': The Symbols favorites are project independent, but when editing the favorites only those symbols which are in the current project will be shown. And the symbol icon for a particular symbol always comes from the project file. In one project the symbol number 100.001 could be a road and in another type of project it could be a tree. Internally favorites are just a definition of sets, and each set has a list of symbol numbers. When opening a project, the app makes a mathematical intersection merging each favorites with the symbols in the project. Any symbol in a favorite set that is NOT in a project will remain in that set but will not be visible. And any symbol not in a user-defined set but exists in a project will be placed in the ''Other'' set.

Symbols in the “Other” set appear in the symbol selector panel which appears when tapping the symbol sector [[File:Grid.svg|border|30px]] button.

Note: The order of symbols in the ''Other'' set is not currently saved.

===Protected Symbols===
Protected symbols are those which are not normally selectable on the map and the user would not usually want to add or edit them. The ''Protected'' set appears below the ''Other'' set.

[[File:Ocadapp SettingsSymbolsProtectedSymbols.png| px]]

More information about protected symbols can be found in [[OCAD_App_Manual#Editing_Protected_Map-Objects|Editing protected map objects]].

===Editing Sets===
The symbols in the sets are edited by dragging them from one set to another. The order of the symbols in each set can also be edited by dragging symbols to the left and right within a set.

The user can drag one or many symbols from ONE set into another, for example, the user is going to move these four water symbols from Other to Set 1 and place them before the rock symbols:

[[File:Ocadapp SettingsSymbolsEditingSets.png|650px]]

Result:

[[File:Ocadapp SettingsSymbolsEditingSetsDone.png|650px]]

Note: only symbols from one set at a time can be dragged to another set.

A grey symbol selector [[File:Grid.svg|border|30px]] button icon always appears at the start of the last user-defined set. This is to indicate a placeholder to the user that the symbol selector button will appear in this position in the map toolbar.

To deselect all symbols, tap on the deselect [[File:Remove selection.svg|border|30px]] button here:

[[File:Ocadapp SettingsSymbolsDeselectSymbols.png|500px]]

===Delete a Symbol Favorites===
At the bottom of a symbol favorites is a delete [[File:Delete bin.svg|border|30px]] button which can be used to delete the current symbols favorites:

[[File:Ocadapp SettingsSymbolsDeleteSymbolFavorites.png| px]]

Note that this will display a warning as deleting a favorites is NOT undoable, all changes are saved immediately.

===Example Scenarios===

The following are three example scenarios demonstrating the possibilities of Symbol Favorites:
*'''Using a tablet in the mountains'''
Set up two favorites: Mountain and Mountain village.

[[File:Ocadapp SettingsSymbolsExampleMountain.png|650px]]

[[File:Ocadapp SettingsSymbolsExampleMountainVillage.png|650px]]

Make all other favorites hidden, then when out in the field the user can easily swap between the two sets of favorites using the [[OCAD_App_Manual#The_Quick_Configuration_Button|Quick Configuration Panel]]:

[[File:Ocadapp SettingsSymbolsQuickToolbar.png|500px]]

*'''Working with Protected Symbols'''
The user could set up different favorites for those times they want to edit protected map-objects:

[[File:Ocadapp SettingsSymbolsProtectedMapObjects.png|500px]]

While using this favorites the normally protected symbols are all editable. Revert to the normal Forest Symbols favorites afterwards.

*'''Phone'''
Working with limited space, creating a couple of favorites and using the No Sets favorites if doing a lot of sketching. In this case the user has decided that 8 buttons wide is about right for using their finger to draw. So, three rows of 8 symbols. The user can have common symbols between the sets if needed too:

[[File:Ocadapp SettingsSymbolsPhoneSprint1.png|250px]]
[[File:Ocadapp SettingsSymbolsPhoneSprint2.png|250px]]
[[File:Ocadapp SettingsSymbolsPhoneNoSets.png|250px]]

==Drawing==
On the Drawing tab there are settings for the selection and order of colors for sketching and notes.

[[File:Ocadapp SettingsDrawing.png]]

===Sketching===
By tapping a sketch color button, it can be turned on and off. Only those colors which are ''on'' will appear in the map toolbar.

To change the order of the colors, tap, hold, and drag one color at a time to a new position in the list.

===Notes===
By tapping a note color button, it can be turned on and off. Only those colors which are ''on'' will appear at the bottom of the note editor.

To change the order of the colors, tap, hold, and drag one color at a time to a new position in the list.

The Notes tool button can be hidden or positioned in different locations in the App.

[[File:Ocadapp SettingsNotes.png]]

===Map Objects===
*'''Show legibility halo''': The legibility halo shall support the cartographer to draw point and line objects with enough distance to each other. 
The distance of the legibility halo is based on the IOF specifications for orienteering maps.

[[File:OCAD App Legibility Halo Line Object.png|300px]]

[[File:OCAD App Legibility Halo Point Object.png|300px]]

==Support==
The Support setting tab contains advanced information and actions for sending information back to OCAD.

At the top is a Help section with links to the App Manual and the OCAD Wiki.

Note: A project can also be sent to OCAD Support using a function in the [[OCAD_App_Manual#Advanced|Advanced]] section of Project Options.

[[File:Ocadapp SettingsSupport.png|500px]]

===Log Settings===
The app logs activity by the user in a text file on the device. If the user encounters problems with the App they are encouraged to turn on “Extra app logging” then send the log files to OCAD for analysis.

The log files are stored locally on the device. A new log file is created each day and once the log file reaches a certain size (16MB). Older log files are automatically deleted by the app regularly.

The user can send one or more log files to OCAD (internet connection required). When sending a log file, the user should also write a message to describe what they were doing and why they are sending the log file(s).

IMPORTANT: When describing what the user is doing please try and specify to the nearest minute when the crash or problem occurred – this helps us a lot!

When sending a message with a log file only the first 1000 characters are sent, to send more text see [[OCAD_App_Manual#Sending_Feedback|Sending Feedback]] below.

Each log file has a link which can be tapped to open it on the device, this could be useful if the user needs to send part of a log file to OCAD, or if the Send function fails.

===Sending Feedback===
The user can send feedback messages to OCAD using the Message function. There is no limit to the size of text that can be submitted.

===App Settings===
The app’s App settings contain small pieces of information like the color order of the notes, or the position of the floating toolbar. There are currently about one hundred different things stored here. To send a copy of the settings for the current device, the user can do so by selecting the ''App settings file'' checkbox and tapping the ''Send to OCAD'' button. Only do this if requested to do so by OCAD as it may be useful to help resolve problems.

===Other Information===

[[File:Ocadapp SettingsSupport OtherInformation.png]]

The App privacy policy can be found here by clicking on the link: ''www.ocad.com/en/privacy/''

The current app version is displayed here.

If a project is open, then the ID of the project is displayed here, there is a copy [[File:Content copy.svg|border|30px]] button to the right which will copy the currently open projects id to the clipboard on the device.

=Appendices=
==Appendix A - App Updates==
The following sections describe functionality updates between recent versions of the App and this document.

'''Version 1.1.0.79'''
*Legibility Halo can be shown for point and line objects, see [[OCAD_App_Manual#Map_Objects|here]].
*Long-press on symbol shows symbol number and symbol name, see [[OCAD_App_Manual#Button_Rows|here]]
*Long-press on symbol gives possibility to hide or protect objects, see [[OCAD_App_Manual#Hide_and_Protect_Map_Objects|here]].
*Japanese and Chinese (traditional) language has been added.
*Performance improvements.

'''Version 1.0.5.71'''
*Good, poor, lost GPS Status indicators added to the status bar, see [[OCAD_App_Manual#GPS_Status|here]].
*Fixed zoom level auto-rotate and auto-center can now turned off in Settings, see [[OCAD_App_Manual#Zoom|here]].

'''Version 0.9.2.62'''
*3 configurable fixed zoom level buttons added, see [[OCAD_App_Manual#Configurable_Zoom_Buttons|here]]
*Scan Project QR code on the App to share a project with another device, see [[OCAD_App_Manual#Advanced|here]].
*Send Project to OCAD Support button added, see [[OCAD_App_Manual#Advanced|here]].
*Italian language has been added.

'''Version 0.9.1.60'''
*Directional point objects can now be rotated, see [[OCAD_App_Manual#Edit_Selection_Behavior|here]].
*Geometry vertex type can now be toggled between the value normal, dash and corner, see [[OCAD_App_Manual#Change_vertex_type|here]].
*Chinese and Portuguese languages have been added.

==Appendix B - Default Symbol Favorites==
'''Forest Symbols''' 
Set 1: ''101000, 102000, 103000, 103001, 109000, 110000, 111000, 112000, 201001, 202001, 202002, 202003, 203100, 204000, 205000, 207000'' 
Set 2: ''303000, 308001, 311000, 313000, 417000, 418000, 419000, 503000, 504000, 505000, 506000, 507000, 508000, 530000, 531000'' 
Protected: 
''Open land, paved area, out-of-bounds area: 401000, 501000, 501001, 520000, 520004'' 
''DEM Wizard smoothed contour symbols :10060000, 10061000, 10062000, 10060001, 10061001, 10062001, 10080000, 10081000, 10082000'' 
Protected + hidden: 
''DEM Wizard unsmoothed contour symbols: 10050000, 10051000, 10052000, 10050001, 10051001, 10052001''

'''Sprint Symbols''' 
Set 1: ''204000, 301000, 311000, 313000, 417000, 418000, 419000, 530000, 531000, 401000, 406000, 410000, 411002'' 
Set 2: ''501001, 501021, 501100, 513100, 513200, 515000, 516000, 518000, 520001, 521000, 522000, 532000'' 
Protected: 
''Open land, paved area, out-of-bounds area: 401000, 501000, 501001, 520000, 520004'' 
''DEM Wizard smoothed contour symbols :10060000, 10061000, 10062000, 10060001, 10061001, 10062001, 10080000, 10081000, 10082000'' 
''New Map Wizard - Swiss survey data symbols: 999000, 999001, 999010, 999011, 999512, 999513, 999515, 999521, 999522, 999523'' 
Protected + hidden: 
''DEM Wizard unsmoothed contour symbols: 10050000, 10051000, 10052000, 10050001, 10051001, 10052001'' 

==Appendix C - Folder Transfer==
Use the following sections as a guide for transferring a project to and from the App without using the cloud transfer or any internet connection.

Requirements:
*A cable to connect your device to your Windows Computer
*For iOS it is necessary to use iTunes from Apple and to have enabled “Trust” between the device and Windows so that Windows will be able to read and write files.

There may be other ways and techniques to copy the files to and from a device, but the ways described below use ordinary Windows folders.

===OCAD Desktop Export===

On the third step of the Data-exchange process the user can select “USB cable” as the transfer option:

[[File:Ocadapp FolderTransfer TransferOption.png]]

Clicking on the “Open folder and copy data” will open a Windows explorer window in a location like this:

:''C:\Users\user-name\AppData\Roaming\OCAD\OCAD 2018\Tmp\_OcadAppExchangeData\_DesktopToApp''

[[File:Ocadapp FolderTransfer TransferFolderToApp.png]]

The user should then copy this transfer project folder to the OCAD folder on their device. It is important to copy the WHOLE folder with ALL contents, see next sections.

===Copying to Android===
Copy the project folder from the step above to the location:

:''This PC\Galaxy Tab S8 \Internal storage\Android\data\com.ocad.app\files''

[[File:Ocadapp FolderTransfer TransferFolderToAppAndroid.png]]

After copying, there should be the “Bürenflue Export” project folder like this:

[[File:Ocadapp FolderTransfer TransferFolderToAppAndroidDone.png]]

The user can now open the OCAD App to import the project, see below.

===Copying to iOS===
Open iTunes on Windows and click on the device button:

[[File:Ocadapp FolderTransfer TransferFolderToAppiOS.png]]

Then click on:
#“File Sharing”
#Find the “OCAD” App
#Drag the whole folder from the “_DesktopToApp” folder into the right-hand side of the of iTunes where the list of folders is.
#Click on “Sync” to transfer the data to your iOS device

[[File:Ocadapp FolderTransfer_TransferFolderToAppiOSDone.png]]

Important: Do not try and use “Add File:” as this does not copy whole folders. 
When the “sync” has completed your project will be able to be imported into the OCAD App, see below. 
Note that copying the project files to iOS works similarly by using iCloud.

===Importing on the device===
Once the folder is moved to the above locations on the device, start the OCAD App, then click on [[File:Project add.svg|border|30px]] and “From folder”, the App will scan the folder and find the projects to import, select the desired project and tap on “Import”:

[[File:Ocadapp FolderTransfer ImportFromDevice.png]]

When the project import has completed, the user should be able to work with it in the same way as if it had been imported via the Cloud Transfer Service.

After importing, the files in the “Bürenflue Export” folder will be automatically removed, this is important as if the user was to do another “OCAD Desktop Export” and “copy” then the App will prompt the user to update their project on the App, see [[OCAD_App_Manual#Project_Lifecycle_2|Project Lifecycle]] below.

The “Bürenflue Export” folder is not deleted as it is used later for the export.

===Export from the device===
Tapping on the [[File:More vert.svg|border|30px]] button will open the project options, select the Export option.

[[File:Ocadapp FolderTransfer ExportFromDevice.png]]

This will export the project data from the internal storage and create files that can be copied back to the Windows computer and imported into OCAD Desktop. The export will create a folder similar to this:

:''export_iPhone_a43aae3a-debf-471e-849c-2290c526bab8''

or:

:''export_Galaxy Tab S8_a43aae3a-debf-471e-849c-2290c526bab8''

in the “Bürenflue Export” folder on the device. The names of the folders are unique to the device, this will enable the OCAD Desktop user to import data from various devices without risk of overwriting data.

Tapping on the “Include positioning file” checkbox above will also export the position.db file to the same location.

===Copy from Android===
Copy the export folder

:''export_Galaxy Tab S8_e667dd18-a34d-4223-94cb-e7c093cf5bb3''

From

:''This PC\Galaxy Tab S8\Internal storage\Android\data\com.ocad.app\files\Bürenflue Export''

To:

:''C:\Users\<user_name>\AppData\Roaming\OCAD\OCAD 2018\Tmp\_OcadAppExchangeData\_AppToDesktop\Bürenflue Export''

Important: Note that _AppToDesktop and _DesktopToApp are two different folder, ensure you copy to the correct one!

[[File:Ocadapp FolderTransfer CopyFromAndroid.png]]

The project can now be imported into OCAD Desktop.

===Copy from iOS===
Open iTunes and follow the initial instructions in [[OCAD_App_Manual#Copy_from_iOS|Copying to iOS]] above selecting File Sharing and the OCAD App. Then:
#Sync the data, this will copy the Bürenflue Export folder to your computer
#Select the Bürenflue Export folder
#The user may need to scroll down the screen to see the Add File… and Save… buttons
#Click on the Save… button

[[File:Ocadapp FolderTransfer_CopyFromiOS.png]]

After clicking Save… navigate to the folder:

:''C:\Users\<…user name…> \AppData\Roaming\OCAD\OCAD 2018\Tmp\_OcadAppExchangeData\_AppToDesktop''

Make sure the folder _AppToDesktop is selected in the Folder field (3).

[[File:Ocadapp FolderTransfer_CopyFromiOS2.png]]

Important: Note that _AppToDesktop and _DesktopToApp are two different folder, ensure you select the correct one!

After copying there will be a sub-folder in the project folder called something like:

:''export_iPhone_a43aae3a-debf-471e-849c-2290c526bab8''

[[File:Ocadapp FolderTransfer_CopyFromiOS3.png]]

Warning: If the project folder Bürenflue Export already exists the user will be prompted to overwrite it, and iTunes will OVERWRITE EVERYTHING. So, if there are export folders from other devices they will BE DELETED.

To work around this the user could save the folder elsewhere and copy it later to the _AppToDesktop folder. Or make sure previous imports have been completed using OCAD Desktop before saving the folder here.

Note that copying the project files from iOS works similarly by using iCloud.

===Import to OCAD Desktop===
From OCAD Desktop, select the menu item File – OCAD App Data Exchange. Select the transfer project “Bürenflue Export”, then in the panel below are listed the two exports from different devices. Click on “Import data from App”:

[[File:Ocadapp FolderTransfer ImportToOCADDesktop.png]]

This window is displayed for the “USB cable” transfer project, click on “Get importable files”:

[[File:Ocadapp FolderTransfer ImportToOCADDesktopGetFiles.png]]

This window is displayed with the available device imports:

[[File:Ocadapp FolderTransfer ImportToOCADDesktopImportFiles.png]]

Select one and click on Import Data and follow the usual procedure for importing data.

===Project Lifecycle===
After following the above procedure once, it is possible to re-export from OCAD Desktop again, copy to the device again, then tap Refresh (1) above the Projects List on the device. An orange message should appear in the list (2), tap to update the project with the latest version of the project from the Desktop.

[[File:Ocadapp FolderTransfer RefreshProjectList.png]]

After updating the project can be opened, edited, closed, re-exported, copied back to Windows and re-imported.

A project can have multiple users using one or more devices, using this copying system makes the process of working offline relatively easy.

===Technical Details===
The following details describe the files if a user needs to transfer files in other ways, such as email etc. Using a ZIP file could be recommended for this.

'''OCAD Desktop Exported files.''' 
The following items are exported from the OCAD Desktop and placed in a transfer project folder such as “Bürenflue Export”:
*“map.ocdExchange” – an OCAD file that can be imported to the App.
*“project.ocdInfo” – a small file containing transfer information.
*“back” folder - containing background images
The name of the folder containing these items should be the same as the transfer project in OCAD Desktop.

'''OCAD App Exported files.''' 
The export process creates a sub folder of the project transfer folder “Bürenflue Export”. The sub-folder name is constructed from “export”_”device-name”_”branch-ID”. This export sub-folder should contain two or three files:
*“map.ocdExchange” – an OCAD file that can be imported to the Desktop.
*“project.ocdInfo” – a small file containing transfer information.
*“position.db” – an optional file containing positioning information if the user also exports this.
Note that the background images are not exported as they cannot be changed on the App.

==Appendix D - Technical Notes==
'''Data Storage'''

The OCAD exchange files transferred to the device are only ever read on the device, some information in the files is copied to other hidden storage files on the device.

Only by exporting or uploading a project are OCAD exchange files created from the data in the internal storage.

The user should not copy or delete files in the directory: 
:''This PC\Galaxy Tab S8\Internal storage\Android\data\com.ocad.app\files\_projectdata''

Changing these files will break a project on the device and probably make it impossible to upload or export the project.

The files in this directory are required by a project to display the map correctly, but they do NOT contain the changes the user makes by editing the project.

If the user requires more space on their device, then background files (in the “back” folder) can be deleted manually without breaking a project. Deleting any other file will break the project.

'''Security'''

When using the OCAD Cloud-Transfer service the user may be concerned about security as there is no password or encryption involved in the process. Project security is based on the concept of anonymity, the user is the only person that has the project-id, there is no list of these ids anywhere, they are randomly generated 128 bit numbers so it is practically impossible to guess. See [https://en.wikipedia.org/wiki/Universally_unique_identifier Universally unique identifier - Wikipedia]. If the user shares an id with others, then there is a risk if those users share it.

OCAD App Manual

2026-07-17T11:14:34Z

KLH: /* Advanced */

This wiki page describes how the OCAD App works. 
To the main page of the '''[[OCAD App]]''' | To the '''[[OCAD App Data Exchange]]''' page.

[[File:Hint.jpg|30px]] There are small differences between the operating systems Android, iOS and Windows. This documentation has been produced using all three so images may look slightly different at times.

=Registration=
After starting the App, the first thing the user must do is select a language, this also can be changed at any time later by using the [[OCAD_App_Manual#Language|Settings]].

The full functionality of the OCAD App is available after registration. To register the user needs to enter a valid email address and their name.

A user should use the same email address if they use multiple devices. These pieces of information can then be used to manage imports from the App into OCAD Desktop so that user will know from whom an upload comes from and which of their devices.

[[File:Hint.jpg]] If the user has multiple devices they plan to register, the same email address should be used and each device should have a unique name for that user. 
For example: “iPad”, “iPhone”, “Android Tablet”, “Robs Phone” etc. If two devices have the same name it may make importing data from the App to OCAD Desktop confusing to the user as they may not know exactly which device the data comes from.

==Email and Name==
Enter a valid email address: 
[[File:Ocadapp registrationEmail.png|350px]]

After entering a valid email address, the user is prompted to enter their name: 
[[File:Ocadapp registrationName.png|350px]]

After entering a name an email will be sent to the address: 
[[File:Ocadapp requestSent.png|350px]]

Tap on the link in the address to complete the registration. 
[[File:Ocadapp registrationConfirmEmail.png|350px]]

The App will detect the confirmation, tapping on the ''Continue'' button will take the user to the '''[[OCAD_App_Manual#Projects|Projects]]''' page.

==Other Functionality==
The User Interface Language can be changed. 
Using the [[File:settings.svg|border|30px]]button, some settings can be changed.

==Demo Mode==
*The user can evaluate the App using two [[OCAD_App_Manual#Download_a_Sample_Project|sample projects]].
*The user CANNOT download or import any other project.
*The sample projects can be edited in any way, note that certain functions may not work fully such as the GPS functionality which requires being at the real location of the sample maps.
*The user CANNOT upload the sample projects to the OCAD server.
*The user can delete and re-import the sample projects any time.
*No notifications or any other information is sent to OCAD in demo mode.
*The registration page will always be shown until an email address is entered.
*After entering an email address or choosing Demo mode the App will go to the '''[[OCAD_App_Manual#Projects|Projects]]''' page.

==Technical Notes==
*The Registration requires an Internet connection.
*OCAD stores the email address and name for each registered user. It also stores a list of devices for each user, the device name and the device id is stored.
*Only one user can be registered at one time for the App on a single device.
*The user and device registration is NOT a login mechanism. There is no password.
*If the user wants to change email address or name, they must first unregister the user from the device – see '''[[OCAD_App_Manual#User_Settings|User Settings]]'''.
*If the user is unregistered from the device all projects WILL BE PRESERVED on the device, they can continue to be edited, but the user CANNOT Upload or Export the project until a new registration is made.
*If a user has multiple devices, they will NOT be prompted for a name when registering the second and subsequent devices.
*If a user has multiple devices, then unregistering one will remove it from the list of devices for that user on the OCAD server. When the last device is unregistered, the user will also be deleted.

=Projects=
[[File:Ocadapp ProjectsPage.png]]

The projects page will contain a list of projects.

==Add Project==
To Add a project, it must be imported to the App. During this process, an OCAD file is converted into a native App format which provides better performance for drawing and viewing large maps. 
Tap on the [[File:Project add.svg|border|30px]] button to add a project.

[[File:Ocadapp AddProject.png]]

When adding a project, it will first be downloaded, then processed, this could take a few minutes for large projects and depends on Internet speed and device performance. 
The App does not write changes directly to the OCAD file which is stored on the device, all data and changes are stored in internal storage.

===From QR Code===
If your device has a camera that is accessible from the App (permissions may be required) then the user can scan a QR code from OCAD Desktop to download and import a project.

The user can now also scan a QR code using the camera on your device and it will open the OCAD App and start the import of that project.

===From Project ID===
The OCAD Desktop produces a link in the App Data Exchange process; this link contains an ID which can be pasted into the entry field. If a link or id is detected on the clipboard it will be automatically pasted into the ID field. 
For example: <nowiki>https://app.ocad.com/project/6da31400-4a94-43e8-7ae6-8e8ece235b04</nowiki>

[[File:Ocadapp DownloadProject.png|400px]]

The user can paste the whole link or just the ID.

If the user has this link in an email or other message it can now be tapped/clicked which will open the OCAD App and download the project.

===From Folder===
Although it is generally preferred and recommended to use the OCAD Cloud Transfer Services to move projects back and forth from the OCAD Desktop to the OCAD App, there may be times when manual copying of data is required. For example:
*The user has no internet connection
*The transfer project or even map file has been lost on OCAD Desktop so the user cannot use the cloud-transfer to retrieve the map.
*The user is concerned about the security of their project being on the internet.

There are slightly different techniques depending on whether the device is Android or iOS. The process involves:
#OCAD Desktop export
#Copying to the iOS or Android device
#Importing on the device
#The user makes changes to the project on the device
#Export from the device
#Copy from the iOS or Android device to the Windows computer
#Import to OCAD Desktop

Information about these processes can be found in the '''[[OCAD_App_Manual#Appendix_C_-_Folder_Transfer|Appendix C]]'''.

===Sample Projects===
The two sample projects can be downloaded at any time.

===Download a Sample Project===
The two sample projects can be downloaded at any time.
*The sample projects can be edited in any way, note that certain functions may not work fully such as the GPS functionality which requires being at the real location of the sample maps.
*The user CANNOT upload the sample projects to the OCAD server.
*The user can delete and re-import the sample projects any time.

==The projects page==

===Refresh the Projects List===
To refresh the projects list, tap on the [[File:Refresh.svg|border|30px]] button. See [[OCAD_App_Manual#Project_Update_from_Desktop|Project Update from Desktop]] for more details.

===Settings===
Tapping the [[File:Settings.svg|border|30px]] button will take the user to the settings page, see [[OCAD_App_Manual#Settings_2|Settings]]

===Internet Status===
At the bottom of the Projects page there is a small cloud icon beside the App version information: 
[[File:Ocadapp InternetStatus.png| px]]

Tapping on the cloud will reveal the internet status and if the App is connected to the OCAD server: 
[[File:Ocadapp InternetStatusConnected.png| px]]

If the user cannot download or upload a project, then it could be that the device has either:
*no internet connection – a red cloud
*a problem with connection to the OCAD server – an orange cloud

An error message will appear indicating the problem beside the cloud icon. 
[[File:Hint.jpg]] The App does not maintain a permanent connection to the OCAD server, it is only required when:
*Downloading a project
*Uploading a project
*Updating a project
*Refreshing the list of Projects
*Registering the user
*Sending log files or projects to OCAD Support

===The Projects List===
The list of projects can be displayed as tiles [[File:Grid view.svg|border|30px]] or as a list [[File:Bulleted list.svg|border|30px]] by toggling the button on the top right:

[[File:Grid view.svg|border|30px]] Tiles 
[[File:Ocadapp ProjectListTiles.png|300px]]

[[File:Bulleted list.svg|border|30px]] List 
[[File:Ocadapp ProjectListList.png|300px]]

The projects can also be sorted alphabetically by name or by modified date (newest at the top): 
[[File:Ocadapp ProjectListSort.png|200px]]

==Project Management==
Tap on the project to open it.

Tapping on the [[File:More vert.svg|border|30px]] button will open the project options:

[[File:Ocadapp ProjectOptions.png|500px]]

===Open===
Tapping on the project '''Open''' button will also open the project.

===Upload===
Once changes have been made, the project can be uploaded to the OCAD server, then imported to the OCAD Desktop. 
A positioning file can be optionally included when uploading. This will make a ''position.db'' file available for import into OCAD Desktop.

===Delete===
A project can be deleted; a confirmation warning is shown. There is no way to reverse this action.

===Advanced===
Other functionality may appear here, currently:
*Export
*QR Code
*Repair
*Backups
*Send Project to Support

[[File:Ocadapp_ProjectManagementAdvanced2.png]]

'''Export''' 
See the [[OCAD_App_Data_Exchange|OCAD App Data Exchange]] page for more information. Tapping on the “Include positioning file” checkbox above will also export the position.db file.

'''QR Code''' 
This QR represents the selected project, it can be used to download the project to a new device. Note that:
*It will download the latest version of the project that was exported from OCAD Desktop and exists on the OCAD Cloud transfer service.
*It requires an internet connection.
*The downloaded project will have the same permissions that were set up in the Cloud Transfer Service.

Use this function to easily share a project with friends or download the project to a secondary device.

'''Send Project to Support''' 
When sending a project to OCAD Support the user will be prompted to enter a reason for sending it. Please only send projects if:
*We have requested you to do so to provide support which could include fixing a bug or recovering data.
*The project cannot repeatedly be opened and the user needs help.
Note that background files and images are NOT included when sending a project to OCAD Support. Sending a project to OCAD Support requires an internet connection.

===Project Status===
The most recent download/upload action is shown below the project. 
Beside it is a small green arrow, tapping this arrow will open the History below. 
[[File:Ocadapp ProjectStatus.png|320px]]

Tapping the small arrow or list will close it again. 
[[File:Ocadapp ProjectStatusCloseHistory.png|320px]]

For example, if there is a new update of a project on the OCAD server then refreshing the list will provide an indication of this, see [[OCAD_App_Manual#Project_Update_from_Desktop|Project Update from Desktop]].

===Project Update from Desktop===
If the project has been updated and exported from the Desktop,
then refreshing the Projects list will indicate that an updated version of the Project is available for download.

[[File:Ocadapp ProjectUpdateDesktop.png|485px]]

Tapping the [[File:Cloud update.svg|border|30px]] button will update the Project on the App, or alternatively use the Update option:

[[File:Ocadapp CloudUpdate.png|485px]] 
'''Important!''' When updating, only Background maps and a few settings for the project are preserved. All other data is deleted, and new data is re-imported. 
If the user has any changes that have NOT been uploaded to the OCAD Server and then imported and merged with the OCAD file on the Desktop, then those changes will be lost!

The other possible notification here is if the transfer project has been deleted on the OCAD Desktop. 
If this is the case, and there are changes that need transferring to the OCAD Desktop, then the project will need to be exported from the App and manually transferred to the user’s computer.

Note: These notifications for cloud transfer projects will only appear if the App is connected to the Internet and the OCAD Server – see [[OCAD_App_Manual#Internet_Status|Internet Status]].

===Project Lifecycle===
When a project is exported from the OCAD Desktop to the OCAD Cloud Transfer it will remain on the server for 7 days. After that it will be automatically deleted.

However, the project could still obviously be in use both on the App and on OCAD Desktop. The user can still upload (or export) the project and then import changes from the App.

=Project Editing=
After opening a project, the map and editing tools will be seen on the Project page:

[[File:Ocadapp ProjectEditing.png|600px]]

==Project Toolbar==

[[File:Ocadapp ProjectToolbar.png|600px]]

'''Important:''' There is no ''Save'' button on the OCAD App. All changes are saved almost immediately to internal storage. 
Note that some actions need to be completed before saving will occur – such as drawing a line or area object.

===Close===
The project can be closed using the [[File:Close cross.svg|border|30px]] button.

===GPS Functions===
GPS functions are accessed via the [[File:Location line.svg|border|30px]] button. See [[OCAD_App_Manual#GPS_Functions_2|GPS Functions]] for more details.

===Map Layers and Notes===
To open a panel containing information about map layers and notes tap the [[File:Detail panel.svg|border|30px]] button. 
This panel contains two tabs, firstly for [[OCAD_App_Manual#Map_Layers|map layers]]: 
[[File:Ocadapp MapLayer.png| px]]

and secondly for [[OCAD_App_Manual#Notes|notes]]: 
[[File:Ocadapp Notes.png| px]]

This panel can behave as either a temporary “popup” panel or docked to the right-hand side by tapping the [[File:Panel right docked.svg|border|30px]] button on the right: 
[[File:Ocadapp PanelRightDocked.png| px]]

If the panel is docked, then the width can be adjusted by dragging the left edge of the panel. 
[[File:Ocadapp PanelDrag.png| px]]

===Settings===
Tapping the [[File:Settings.svg|border|30px]] button will take the user to the settings page, see [[OCAD_App_Manual#Settings_2|Settings]].

==Status Bar==
Below the project toolbar is a status bar which provides various pieces of information such as:
*The stylus / finger / mouse actions that are available for the currently active tool.
*The type of selected objects and how many of each.
*The length or surface area if one object is selected.
*The GPS status on the device.

[[File:Ocadapp StatusBar.png| px]]

===Interactions===
The [[File:Tap.svg|border|30px]] icon indicates that the map will accept a tap action on the map for the currently active tool, the associated text describes the behavior.

The [[File:Finger drag.svg|border|30px]] icon indicates that the map will accept a swipe/drag type action on the map for the currently active tool, the associated text describes the behavior.

If the screen is too narrow to display the texts, then tapping the icons will display them:

[[File:Ocadapp InteractionsTap.png| px]]

===Selections===
Selecting many objects on the map generates a summary of the selection in the status bar. 
Depending on how many objects are selected, this could be a single count or a count per symbol type:

[[File:Ocadapp Selection.png| px]]

In this case 3 knolls [[File:Ocadapp SelectionKnoll.png| px]], 1 track [[File:Ocadapp SelectionTrack.png| px]] and 5 green areas [[File:Ocadapp SelectionGreenArea.png| px]]

Tapping on the symbol icons in the status bar will show a panel with details of the selection. 
Tapping on the items in the panel will select and deselect them. 
By recursively filtering a selection using this functionality the user can drill down to one or more specific objects that they want to edit or delete.

In this example the user has tapped the second and fourth green areas which are now selected in the list, so they are selected on the map:

[[File:Ocadapp SelectionSelectGreenArea.png]]

Tapping outside the panel will close it leaving the desired objects selected. 
In the following example the user chooses all the green, yellow and brown dotted areas:

[[File:Ocadapp SelectionSelectGreenYellowDottedArea.png]]

Then closes the popup panel and selects 3 green and 2 yellow areas:

[[File:Ocadapp SelectionSelectGreenYellowArea.png]]

This technique means the user can easily iteratively filter objects so that only the desired ones remain selected.

More information about editing selected objects can be found in [[OCAD_App_Manual#Editing_Selected_Map_Objects|Editing Selected Map Objects]].

To close the small panel just tap again on the map outside the panel.

===Measurements===
If one object is selected, then its length or area is shown.

Length 
[[File:Ocadapp MeasureLength.png| px]]

Area 
[[File:Ocadapp MeasureArea.png| px]]

===GPS Status===
The GPS icon shows the state of the GPS connection:

[[File:Ocadapp GPSStatus.png|150px]]

Red: No connection or the user is outside the map area. 
Orange: Poor connection if the accuracy is > 20m. 
Green: Good connection with accuracy < 20m. 
Tapping on the icon will show a text message indicating Lost, Poor or Good connection status.

==Map==
Below the main toolbar and status bar is the map.

===Finger Gestures===
All the tools have various gestures, most of which are intuitive such as the two-finger pinch to zoom in and out. 
This gesture works on all tools. Other gestures are described in the sections for each respective tool.

===Buttons===
Near the top of the map is a compass and some buttons:

[[File:Ocadapp Buttons.png|600px]]

Note that if the user’s device does not have a GPS or Compass then some of these buttons may be hidden.
*The [[File:Zoom extent.svg|border|30px]] button which zooms to the whole extent of the map. This button can change to the button if the map is not orientated to north on the device.
*The [[File:Zoom in.svg|border|30px]] button can be used to zoom in.
*The [[File:Zoom out.svg|border|30px]] button can be used to zoom out.
*The [[File:Counter 1.svg|border|30px]][[File:Counter 2.svg|border|30px]][[File:Counter 3.svg|border|30px]] buttons which are configurable zoom buttons. See [[OCAD_App_Manual#Configurable Zoom Buttons|Configurable Zoom Buttons]].
*The [[File:Position.svg|border|30px]] button can be used to re-center the map to the user’s position – if the device has a GPS. By double-tapping the button it will change to [[File:Position auto.svg|border|30px]] and the device will keep the map centered as the user moves.
*The [[File:Compass.svg|border|30px]] button can be used to orientate the map to north on the device. Double-tapping it and the button will change to [[File:Compass auto.svg|border|30px]] which means the device will keep the map orientated to north as the user moves.

===Configurable Zoom Buttons===
The App has 3 configurable buttons which can be set to different zoom scales. They are not set to any specific numeric scale. 
When tapping one of these zoom buttons the App will go to the specified scale, auto-rotate and auto-center the map (if the device has a compass and GPS). 
The auto-rotate and auto-center functions can be turned off in the [[OCAD_App_Manual#Zoom|Settings]].

When starting the App the first time a red [[File:Counter 1_red.svg|border|30px]] zoom button will appear, tapping it will open the Quick-configuration panel:

[[File:Ocadapp ConfigurableZoomButtoms.png|350px]]

Tapping the Set button will set the [[File:Counter 1.svg|border|30px]] button to the current map scale. Tapping the checkbox to the left will hide the button on the map.

The user can configure up to 3 buttons to different zoom levels. 
To change a button to a different zoom level, just zoom to that level, open the panel using the [[File:Settings_rect.svg|border|30px]] button on the map toolbar and tap Set again.

===Scale Bar===
At the bottom of the map is a scale bar.

[[File:Ocadapp ScaleBar.png| px]]

==Map Toolbar==
Central to all map editing is the toolbar which could look something like this depending on the type of editing tool selected:

[[File:Ocadapp MapToolbar.png| px]]

It can be moved to a new location using the [[File:Drag.svg|border|30px]] button on the bottom left. It can also be docked to the bottom of the App – see [[OCAD_App_Manual#Toolbar_Position|Settings - Toolbar Position]].

It can be resized using the [[File:Resize.svg|border|30px]] button on the bottom right.

===Button Themes===
Some buttons have a background theme:
*Green – confirmation button to complete a process.
*Red – destructive button to cancel a process or delete something.
*Blue – a behavior to change how a tool works – only ''one'' or ''none'' can ever be active.
*Yellow – an option to change how a tool works – ''none, one or many'' can be active.

===Button Rows===
There are four main types of rows in the toolbar:
*Top row – contains behaviors, options, and actions appropriate to the current active tool.
*Notes + Sketch row – contains the Notes [[File:Bubble text.svg|border|30px]] button on the left and the sketch color buttons.
*Symbol buttons – in the example above there are two rows of symbols, to access other symbols not in the two rows tap on the symbol selector [[File:Grid.svg|border|30px]] button to the left.

[[File:Hint.jpg]] Long-press on a symbol to see its symbol number and symbol name.

*Bottom row which contains:
**The Drag [[File:Drag.svg|border|30px]] button.
**The Undo [[File:Undo.svg|border|30px]] and Redo [[File:Redo.svg|border|30px]] buttons, see [[OCAD_App_Manual#Undo_-_Redo|Undo - Redo]].
**The Pan [[File:Pan.svg|border|30px]] button.
**Sometimes the symbol selector [[File:Grid.svg|border|30px]] button can appear here if there are no rows of symbols above.
**The Select [[File:Select.svg|border|30px]] button, see [[OCAD_App_Manual#Selections|Status bar Selection]] and [[OCAD_App_Manual#Editing_Selected_Map_Objects|Editing Selected Map Objects]].
**The Draw [[File:Stylus.svg|border|30px]] button which changes icon depending on what is to be drawn. The icon can be either a Sketch color & width or a symbol, see [[OCAD_App_Manual#Drawing_Objects|Drawing New Map-Objects]] and [[OCAD_App_Manual#Drawing|Sketch – Drawing]].
**The Sketch Erase [[File:Eraser.svg|border|30px]] button, see [[OCAD_App_Manual#Erasing|Sketch - Erasing]].
**The Quick Configuration [[File:Settings rect.svg|border|30px]] button, see [[OCAD_App_Manual#Map_Toolbar|Map Toolbar]].
**The resize [[File:Resize.svg|border|30px]] button on the bottom right.

Note that the Sketch/Note and Symbol rows can be scrolled horizontally if the screen device is not wide enough for all buttons:

[[File:Ocadapp ButtonRowsScroll.png| px]]

See also [[OCAD_App_Manual#Drawing_2|Settings – Drawing]] and [[OCAD_App_Manual#Symbols|Settings – Symbol favorites]] for more configuration options.

===The Quick Configuration Button===
The quick configuration [[File:Settings rect.svg|border|30px]] button displays a panel where the user can quickly perform the following options:
*Turn on or off editing Sketches – this will hide all Sketching and erasing tools.
*Turn on or off editing of map objects – this will hide all Map-object editing tools.<nowiki>*</nowiki>
*Set the [[OCAD_App_Manual#Configurable_Zoom_Buttons|configurable zoom buttons]].
*Change the symbol toolbar rows to a different ''Symbol favorites''. See [[OCAD_App_Manual#Symbols|Settings – Symbol favorites]] for more information.
*Tapping the [[File:stylus.svg|border|30px]] button will take the user to the Settings page and [[OCAD_App_Manual#Symbols|Symbol Favorites tab]].

[[File:Ocadapp QuickConfigButton.png| px]]

<nowiki>*</nowiki> If the current project was exported [[OCAD_App_Data_Exchange#Arrange_Export|without the permission for Map-Object editing]] then the ''Edit map objects'' option here will be Off and disabled.

==Drawing New Map Objects==
There are point, line and area Symbols, each have differing behavior, option, and actions buttons.

[[File:Ocadapp DrawingObjects.png| px]]

To start drawing tap on one of the symbols, this symbol becomes the active drawing tool which can be seen in the lower toolbar.

To select a different symbol which is not in the user’s rows of symbols tap on the symbol selector [[File:Grid.svg|border|30px]] button to show a panel with all other symbols:

[[File:Ocadapp SelectAnotherSymbol.png|650px]]

An alternative way to change the symbol is to select a map object of the desired symbol type. Note that this will NOT change the active tool in the App to the drawing tool.

[[File:Ocadapp ChangeSymbolSelectMapObject.png| px]]

In the above example a green object is selected, and so the drawing symbol type is changed to the green symbol. 
The selection tool is still active. To start drawing green symbols just tap on the green symbol drawing button in the toolbar.

===Points===
Point objects can be created with a single tap to screen. If the point objects can be placed directionally then tap and drag to adjust the orientation, releasing the drag will create the object.

===Lines and Areas===
The default behavior for drawing lines is to use the curve-and-straight behavior [[File:Draw curve straight.svg|border|30px]]

[[File:Ocadapp DrawCurve.png| px]]

If the user taps and drags the stylus/finger/mouse a Bezier curve will be created, but if the user taps and releases, then taps again elsewhere then straight lines will be created between the tapped points.

[[File:Ocadapp DrawRectangular.png| px]]

The rectangular [[File:Draw rectangular.svg|border|30px]] behavior can be used too:

[[File:Ocadapp DrawRectangularBuilding.png| px]]

Use the ''backspace'' [[File:Backspace.svg|border|30px]] button to remove the last added point.

===Re-using Geometry - Following===
When using the curve behavior, it is possible to ''follow'' the geometry of one or more other existing line/area objects by using the follow [[File:Snap and follow.svg|border|30px]] option. 
In the following example the green area is drawn following the track to the north, then the edge of the yellow, then across the white forest and then follows the dashed track. 
When the finger/stylus/mouse is following a line, it shows a light blue cursor on that line – this blue circle is only visible on Android devices:

[[File:Ocadapp FollowingOption.png| px]]

===Finishing or Discarding===
To finish drawing a line or area tap on either the finish [[File:Finish line.svg|border|30px]] or finish-and-close [[File:Finish close.svg|border|30px]] buttons:

[[File:Ocadapp FinishingButtons.png| px]]

This will save the object on the device. Note that area objects only have the finish-and-close button.

If the user wants to discard the entire new object before finishing, they can tap the [[File:Delete bin.svg|border|30px]] button.

===Object Preview===
Object preview while drawing only works on Android and with a special stylus, but not on iOS.

==Editing Selected Map Objects==
The user can select one or many objects at the same time when the selection tool [[File:Select.svg|border|30px]] is active.

[[File:Ocadapp SelectionTool.png|350px]]

As mentioned in [[OCAD_App_Manual#Selections|Status bar - Selection]], the status bar at the top contains information about what is selected.

===De-selecting Map Objects===
To de-select map objects either:
*Tap outside the area covered by the selected objects.
*Tap again on the select tool [[File:Select.svg|border|30px]].

===Edit Actions===
When objects are selected:

*They can be deleted using the delete [[File:Delete bin.svg|border|30px]] button on the toolbar.
*They can be converted to objects of a different symbol type using the change-symbol [[File:Change symbol.svg|border|30px]] action:

[[File:Ocadapp ChangeSymbol.png|650px]]

It is only possible to change points to points, but lines and areas can be changed to lines OR areas. Here five objects which are of three different green symbols are changed to an orange symbol.

*They can have their direction or side changed using the side/direction [[File:Reverse.svg|border|30px]] action if the selected symbols have such attributes:

[[File:Ocadapp ReverseSymbol.png|650px]]

There are different behaviors that the finger/stylus/mouse can have when using the selection tool: edit, cut, re-shape, and add/remove points, these are described below.

===Edit Selection Behavior===
'''Important:''' There is NO button for this default edit behavior, it is active when NO OTHER behavior is selected.
:[[File:Ocadapp EditSelectionBehavior.png]]

When using this behavior, the user can:
*Move objects.
*Rotate directional point objects.
*Edit the object’s geometry.

'''Move objects'''
:To move all the selected objects, tap and drag the dashed selection rectangle.
:[[File:Ocadapp MoveObejcts.png|200px]]

'''Rotate Directional Point Objects'''
:Directional point objects display a small selection arrow attached to the point. This arrow can be tapped and dragged around the point to change its direction.
:In this example 3 directional point objects are selected and then each is rotated individually:
[[File:Ocadapp RotateDirectionalPointObject.png|200px]]

'''Edit Object Geometry'''
:To edit the geometry, the user can tap and drag one of:
:*A rectangular object’s blue square corner vertex:
::[[File:Ocadapp MoveCornerVertex.png]]

:*A curved object’s blue square side handle to change the size of the object:
::[[File:Ocadapp MoveCurveVertex.png]]

:*A curved object’s blue circle Bezier handle to change the curvature of the side:
::[[File:Ocadapp MoveBezierHandle.png]]

===Cut Selection Behavior===
Select an object and activate the [[File:Cut.svg|border|30px]] behavior. Both lines and areas can be cut.

Cutting a line removes part of that line where the cut is made, this could result in the object being split into two objects if the cut is in the middle; or just a truncation if the cut is near one end or the other.

Cutting an area is demonstrated below.

[[File:Ocadapp ActivateCutBehavior.png| px]]

Tap on the edge and draw a ''cut'' line across the object:

[[File:Ocadapp CutArea.png| px]]

Tap on the finish [[File:Finish line.svg|border|30px]] button to complete the cut.
At any point the last cut-point can be deleted using the [[File:Backspace.svg|border|30px]] button, or aborted using the [[File:Close cross.svg|border|30px]] button. 
There are now two objects selected as can be seen in the status bar:

[[File:Ocadapp AreaCutTwoParts.png| px]]

Either part can now be moved or modified independently:

[[File:Ocadapp EditCutArea.png| px]]

''Note that the current implementation only allows cutting an object in two pieces. Cutting a hole is not [yet] implemented.''

===The Re-Shape Selection Behavior===
The geometry of an existing object can be changed by using the re-shape [[File:Reshape.svg|border|30px]] behavior, select an object and tap the behavior button:

[[File:Ocadapp ReshapStart.png| px]]

Starting on the edge of the object, draw the new geometry, finishing on the line again:

[[File:Ocadapp ReshapeDraw.png| px]]

Tap on the finish [[File:Finish line.svg|border|30px]] button to complete and save the re-shaped map object:

[[File:Ocadapp ReshapeFinish.png| px]]

There is still only one object, but it now has a new geometry.

===Add & Remove Points Behavior===
Geometry points can be added or removed using the Add/Remove Points behavior [[File:Add remove point.svg|border|30px]] button, select an object:

[[File:Ocadapp AddRemovePoints.png| px]]

Tapping on the point on the left will remove it. Tapping on the edge on the right will create a new point:

[[File:Ocadapp AddRemovePointsComplete.png| px]]

''Note that Bezier control points (round blue circles) cannot be removed.''

===Change vertex type===
A vertex can have one of 3 different modes which affect the distribution of dashes and other things along a line. When the vertex type behavior [[File:Ocadapp VertexTypeBehavior.png]] is selected, tapping on a vertex will toggle the vertex type between the 3 different values.
:[[File:Ocadapp NormalVertex.png]] Normal vertex
:[[File:Ocadapp DashVertex.png]] Dash vertex
:[[File:Ocadapp CornerVertex.png]] Corner vertex

[[File:Ocadapp DifferentVertexTypes.png]]

More information about vertices can be found [[Vertices|here]].

===Editing Holes in Areas===
There are no specific tools to add or delete holes in areas (at present), however the points in an existing hole can be moved, added or removed. 
[[File:Hint.jpg]] By removing all the points for the hole, the hole can be deleted. Or by adding/editing points to the hole it can modified or enlarged.

===Hide and Protect Map Objects===
Long-press on a symbol in the map toolbar to hide or protect its objects.

'''Hidden''' 
Hidden map objects are not visible and selectable. 
Hidden symbols appear with a gray cross (x) in the map toolbar.

'''Protected''' 
Protected map objects are visible but not normally selectable. 
Protected symbols appear with a gray diagonal in the map toolbar.

The user can edit protected map objects by selecting the symbol and then changing to the selection tool [[File:Select.svg|border|30px]]. 
While the protected symbol is the active symbol it will be both selectable and the user can create new map objects of that symbol type.

[[File:OCAD App Hide And Protect Objects.png]]

===Course Setting Objects===
Course setting projects can be opened using the App.
There is currently no functionality for editing course setting objects, and the control numbers are now drawn in a fixed position to the north-east of the control circle.

The App can be used as an aid for checking control sites before a competition in much the same way the OCAD Sketch App could.

In the future more functionality will be added to support course setting.

[[File:Ocadapp CourseSettingObjects.png]]

==Minimum Distances==
There is currently no specific tool or way to show the minimum distance between features on a map. We hope to add such functionality sometime in the future.

==Map Layers==
To manipulate the visibility, opacity and transparency of the various layers in the App, open the right-hand details panel and select the layers [[File:Layers.svg|border|30px]] tab on the left.

[[File:Ocadapp MapLayers.png|650px]]

The layers in this list are drawn in the order of the list, so background maps are drawn on the screen first, then the map, and finally the sketches and notes. Only the background maps can have their draw-order changed.

The visibility of any layer can be changed by tapping the Checkbox [[File:Check box.svg|border|30px]]

The sliders [[File:Ocadapp MapLayerSlider.png| px]] are used to adjust the opacity of each layer. Except for the notes where the slider adjusts the size of the note icon on the map.

The transparency of a background layer can be turned on/off user the [[File:Transparent map.svg|border|30px]] button.

The order of the background layers can be adjusted using the drag [[File:Drag.svg|border|30px]] buttons. When the panel is docked and narrow, the names of the background layers are abbreviated while trying to keep them unique in the list. 
To find the actual name of an abbreviated layer name tap on it and a message will briefly appear with the full name.

The [[File:Ocadapp MapLayersShowAllNone.png| px]] buttons turn on/off all background layers at once.

The [[File:Ocadapp MapLayersToggle.png| px]] button will turn on/off the currently selected layers – the App will remember the currently selected layers, which only get updated when tapping on a checkbox or using All or None. 
The number on the button indicates the number of layers the toggle is operating on.

==Sketches==
Sketches are raster drawings placed on top of the map. Using sketches for line and area type objects can be faster and more convenient than drawing map objects on a small device. They are also transferred to the OCAD Desktop.

===Drawing===
The App has different Sketch colors and widths for making sketches.

[[File:Ocadapp Sketches.png|500px]]

Each color always remembers the width used with it, so the user does not have to change width each time they change to a different color. The widths of each color are also visible in the button icons (for example the thick dark green in the image above).

Filtering and sorting unused colors can be done in the [[OCAD_App_Manual#Drawing_2|Settings - Drawing - Sketching]].

The visibility and opacity of all Sketches can be adjusted using the [[OCAD_App_Manual#Map_Layers|Map Layers panel]].

===Erasing===
The eraser tool [[File:Eraser.svg|border|30px]] can be used to delete sketches. The size of the eraser can be adjusted using the slider [[File:Ocadapp EraserSlider.png|150px]] at the top of the map toolbar. 
The eraser is round and removes sketches when the user taps and drags the eraser across the map.

[[File:Ocadapp ErasingSketches.png|500px]]

Resulting in all sketches being removed:

[[File:Ocadapp ErasingSketchesDone.png|500px]]

===Single Color Erasing===
The single-color eraser allows the user to erase sketches of a specific sketch color. The Single-Color Eraser behavior button [[File:Eraser.svg|border|30px]] appears on the top left of the Map Toolbar whenever a sketch color is selected. 
Tapping on another sketch color switches back to sketch drawing. 
In this example the red sketch color is selected, and the “erase single color” behavior is activated:

[[File:Ocadapp SingleColorErasing.png|500px]]

Only the red sketches are erased when dragging across the map:

[[File:Ocadapp SingleColorErasingDone.png|500px]]

The dark green and white sketches remain.

==Notes==
Notes are temporary objects like sketches, placed on top of the map; they have a text field and a color. They are also transferred to the OCAD Desktop.

===Creating a New Note===
Tap the Notes tool [[File:Bubble text.svg|border|30px]] button to start the notes tool which has three behaviors (create, move, select):

[[File:Ocadapp CreateNewNote.png|650px]]

The add note [[File:Bubble add.svg|border|30px]] behavior button should appear. 
Tapping on the map should create a note in that position on the map:

[[File:Ocadapp AddNoteToMap.png|400px]]

The note is represented by an icon on the map. At the same time, a note editor panel will appear on top of the map.

The text editor contains unique default text ''Note 1,2,3'' etc.

The color of a note can be changed by selecting one of the other colors below the text editor using the [[File:Ocadapp NotesColor.png|100px]] buttons. Note that other colors can be added here by changing the list of colors in [[OCAD_App_Manual#Drawing_2|Settings – Drawing - Notes]].

Tapping the [[File:drag_bar_bottom.svg|border|30px]] button to the right of the colors will navigate the user to [[OCAD_App_Manual#Notes_2|Settings – Drawing - Notes]].

When the user starts to create a note, the create-note behavior button changes to a move behavior [[File:Move.svg|border|30px]] button, this will allow the user to reposition the note they are currently editing.

To save the note tap on the [[File:Confirm.svg|border|30px]] button below the text editor.

To discard a note without saving, tap on the [[File:close_cross.svg|border|30px]] button below the text editor.

If the user’s device supports speech-to-text [[File:Ocadapp SpeechToTextIcon.png|30px]] technology, the user can use spoken text to record a note: 
[[File:Ocadapp SpeechToTextNote.png]]

'''Important''': If the user changes tool before confirming/saving a note then the note will be automatically saved. If they did not want this note they could tap undo or delete it.

===Selecting Notes===
When the note tool is active the other behavior is the select notes [[File:Select.svg|border|30px]] button. The user can select one or many notes by tapping or dragging a rectangle on the map:

[[File:Ocadapp SelectNote.png| px]]

When notes are selected the user can:
*Start to edit the note using the edit-note [[File:Edit note.svg|border|30px]] button – ONLY appears if one note is selected.
*Zoom to the selected notes on the map using the zoom-to [[File:Zoom to note.svg|border|30px]] button.
*Delete the selected notes using the delete [[File:delete_bin.svg|border|30px]] button.

To de-select all notes tap elsewhere on the map.

===The Note Icon===
The note icon changes slightly depending on whether it is:
*Being edited (red arrow below)
*Is Selected (2 purple arrows below)
*Is not selected or being edited (the other purple note)

The currently edited note always has a thick border and is shaded; selected notes have shading and a thin border.

[[File:Ocadapp NoteIcon.png|500px]]

===The Notes List===
The details panel on the right-hand side of the App also has a notes tab containing the list of notes and other sorting and filtering functions:

[[File:Ocadapp NotesList.png|500px]]

The notes selection on the list and map is synchronized so selecting one in the list will select it on the map and vice versa.

After selecting one or more notes in the list the user can use the zoom-to [[File:Zoom to note.svg|border|30px]] button on the map toolbar to find those notes on the map. And the [[File:delete_bin.svg|border|30px]] button on the map toolbar deletes those selected notes.

The items in the list only display the first line of a note, the user must edit a note to see the rest of the text.

Double-tapping a note in the list will:
*Zoom to that single note.
*Start the editor for that note so the user can change the text or color. Then the user can:
:*Use the [[File:Confirm.svg|border|30px]] button to save changes.
:*Use the [[File:close_cross.svg|border|30px]] button to discard without changing.

===Notes Sorting===
The user can use the sort [[File:Sort alpha down.svg|border|30px]] button to re-order the notes in the list – this button has four toggle values which cycle when tapped:
*Alphabetical descending [[File:Sort alpha down.svg|border|30px]]
*Alphabetical ascending [[File:Sort alpha up.svg|border|30px]]
*Modification date descending [[File:Sort date down.svg|border|30px]]
*Modification date ascending [[File:Sort date up.svg|border|30px]]

''In the following images in the next section variations of the sorting button can be seen.''

===Notes Filtering===
The notes list can be filtered by either:
*Text
*The Notes appearing in the current map viewport.

''Note that the filter only hides notes from the list, not from the map.'' 
Enter text in the filter field and the list will be filtered:

[[File:Ocadapp NotesFiltering.png| px]]

Tapping the [[File:close_cross.svg|border|30px]] button will clear the text filter.

Turning on the viewport filter [[File:Filter map.svg|border|30px]] button will show only the notes currently visible on the map:

[[File:Ocadapp NotesViewportFilter.png|500px]]

In this case AAA and BBB cannot be seen in the list because they are outside the map’s visible area. Zooming in and out or panning the map will modify the notes in the list as they become visible or hidden.

===Deleting===
There is no warning when deleting one or more notes because it is an undoable action, see [[OCAD_App_Manual#Undo_-_Redo|Undo-Redo]].

===Notes on OCAD Desktop===
To see notes on OCAD Desktop they must be imported in the same way as Sketches. They can then be managed using the '''[[Sketch]]''' menu: 
[[File:Ocadapp NotesonOCADDesktop.png|400px]]

==Undo - Redo==
The Undo [[File:Undo.svg|border|30px]] and Redo [[File:Redo.svg|border|30px]] buttons provide a way for the user to revert an action or re-do one that was recently reverted.

All editing actions are ''undo'' and ''redo''-able as single atomic actions. Atomic actions affect one or many objects at the same time. Some examples of these actions are listed below. 
If an example has the word ''confirm'' afterwards then the undo action occurs when tapping the green confirm button. 
*Creating a point map-object.
*Creating a line or area map-object - confirm.
*Deleting many map objects of different symbol types.
*Moving many objects at the same time.
*Cutting one object – confirm.
*Re-shaping one object - confirm.
*Adding or deleting a single geometry point.
*Changing direction or side of many objects at the same time.
*Changing many different objects of differing symbols to one symbol type.
*Drawing a single sketch.
*Erasing many sketches with one drag on the map.
*Erasing sketches of a single color.
*Creating a note - confirm.
*Editing a note – includes changing text, color, or position - confirm.
*Deleting many notes at the same time.
*Generating a sketch or line/area map-object from the GPS – confirm.

Some things which are NOT undo-able: 
*Tapping the backspace when creating, cutting, or re-shaping a line/area.
*Notes sorting and filtering.
*Panning or zooming, or setting fixed zoom levels.
*Filtering the map objects selection using the status bar functions.
*Changing anything in the Background layers tab.
*Changing any setting in the Quick Configuration Panel
*Changing anything in the Settings page and tabs.

==GPS Functions==
If the user’s device has GPS functionality, then both sketches and map-objects can be generated from GPS data. Start by opening the GPS panel using the GPS [[File:Location line.svg|border|30px]] button:

[[File:Ocadapp GPSPanel.png|500px]]

This panel has the following buttons:
*The sketch and symbol – line/area selector [[File:Ocadapp SketchSymbolSelector.png| px]] button.
*The line / area, start & stop recording [[File:Location record start.svg|border|30px]] button.
*The pause recording [[File:Location record pause.svg|border|30px]] button.
*The smoothing [[File:Ocadapp GPSSmoothingSlider.png| px]] slider.
*The curve mode [[File:Gps curve.svg|border|30px]] button if a symbol is being generated.
*The straight-line mode [[File:Gps rectangular.svg|border|30px]] button if a symbol is being generated.
*The finish [[File:Finish line.svg|border|30px]] button if a sketch or line symbol is being generated.
*The finish-and-close [[File:Finish close.svg|border|30px]] button if a line or area symbol is being generated.
*The discard [[File:delete_bin.svg|border|30px]] button.

===Record a Sketch===
To start recording ensure the device has GPS reception and you have positioning turned on – you should see a purple cross identify where you are standing on the map, use the [[File:Position.svg|border|30px]] button to center the map where you are standing.

Tap on the selector [[File:Ocadapp SketchSymbolSelector.png|30px]] button:

[[File:Ocadapp SketchRecordingStart.png| px]]

Select the desired color and line width, tap the [[File:Close cross.svg|border|30px]] to close the selector panel. Start to move, the GPS sketch will start to be generated when the user has moved at least 1-2 meters:

[[File:Ocadapp SketchRecordingMove.png| px]]

While recording the button will change icon to a pause image [[File:Location record pause.svg|border|30px]] and the border of the button will flash on/off to indicate that recording is ongoing.

The slider above is in the left position which means there is less smoothing, and more points are used. Moving the slider to the right removes lots of the intermediate points:

[[File:Ocadapp SketchRecordingSlider.png| px]]

The slider can be adjusted while drawing is on-going. The user can also change color or line width while the recording too.

[[File:Ocadapp SketchRecordingFinish.png| px]]

To finish the drawing tap the finish [[File:Finish line.svg|border|30px]] or finish-and-close [[File:Finish close.svg|border|30px]] button as above, the object is now saved.

Tapping undo will remove the sketch and re-load it into the recorder whereupon the user could resume recording again. This will only work if the ''GPS-finish'' was the last action performed.

''Note that when drawing a sketch there is no Bezier curve fitting, it only does point reduction.''

===Record a Map Object===
Open the selector again and change to the Symbols tab, only line or area symbols will be displayed:

[[File:Ocadapp MapObjectRecordingStart.png| px]]

Select the desired symbol type. Similarly to sketch generation the user can change symbol type at any time during recording.

Start recording. The slider is to the left so more points are used in the generation. The curve mode is active, so the line is a curve and smoothed.

[[File:Ocadapp MapObjectRecordingCurveSliderLeft.png| px]]

Moving the slider to the right and less points are used to make the curve:

[[File:Ocadapp MapObjectRecordingCureSliderRight.png| px]]

Changing to more points and straight-line mode and the map-object now looks like this:

[[File:Ocadapp MapObjectRecordingStraightLineSliderLeft.png| px]]

And moving the slider to the right reduces the number of points used:

[[File:Ocadapp MapObjectRecordingStraightLineSliderRight.png| px]]

Once the user is happy with the best approximation of the object they are generating, they can tap on the finish [[File:Finish line.svg|border|30px]] or finish-and-close [[File:Finish close.svg|border|30px]] button. The object is then saved.

[[File:Ocadapp MapObjectRecordingFinish.png| px]]

Tapping undo will remove the object and re-load it into the recorder whereupon the user could resume recording again. This will only work if the ''GPS-finish'' was the last action performed

===Pausing Recording===
Note that the drawing can be paused and resumed at any time, only while the recording is ongoing will points be added to the geometry. This means the user can: 
a) Start recording, some points are added… 
b) Pause recording. 
c) Move away from the recording position to inspect and draw something else… 
d) Move back to the approximate recording position and resume. 
e) Some more points are recorded, then the user finishes. 
f) The sketch/map-object generated will not include the movement in ‘3’ and ‘4’ above.

===Undo-Redo===
Both the Finish and Discard actions are undoable.

If the user taps on Finish the sketch or map-object is created. If then the user taps undo the sketch or map-object will be deleted and reloaded back into the GPS recording tool. The user can then:
*Re-start recording to continue adding points to the geometry.
*Change sketch color or width, or change symbol.
*Change the finish action to finish-and-close
*Change the smoothing or curve/straight option
If the user taps the discard [[File:delete_bin.svg|border|30px]] button the geometry being generated will be deleted. Tapping undo will add the geometry back in to the GPS recording tool and the user can continue generating their geometry.

Redo actions generally have the inverse behavior of undo which would be re-finishing the sketch/object, but without changes; or discarding the geometry again.

===Hiding the GPS Toolbar===
If the user closes the GPS toolbar while recording, the generating geometry will be hidden on the map, but the main GPS button will still flash to indicate that the recording is on-going. 
Opening the GPS-toolbar again and the geometry will be displayed again. 
Hidden, but flashing:

[[File:Ocadapp HideGPSToolbar.png| px]]

=Settings=
The App currently has three variations of the Settings Page which contain one or more tabs depending on the context of the page. To show the Settings Page, tap on the settings [[File:Settings.svg|border|30px]] button.
#During email registration – a page a tab with [[OCAD_App_Manual#Support|support]] information is shown.
#From the Projects page – a page with tabs for [[OCAD_App_Manual#General|general]], [[OCAD_App_Manual#Positioning|positioning]], [[OCAD_App_Manual#Drawing_2|drawing]], and [[OCAD_App_Manual#Support|support]] is shown.
#From the Project page – a page with tabs for [[OCAD_App_Manual#General|general]], [[OCAD_App_Manual#Positioning|positioning]], [[OCAD_App_Manual#Symbols|symbols]], [[OCAD_App_Manual#Drawing_2|drawing]], and [[OCAD_App_Manual#Support|support]] is shown.

[[File:Ocadapp ProjectSettings.png| px]]

Tapping the close [[File:Close cross.svg|border|30px]] button will close the settings page and return the App to whichever page was visible beforehand.

==Conventions==
On a settings page the user will see small arrow buttons.

[[File:Ocadapp ProjectSettingsArrowButtons.png| px]]

This is an expander button. If the checkbox is tapped, then the expander can also be tapped to display more options related to the setting.

When expanded there is a vertical green line below the checkbox indicating the scope of the sub-settings which appear below to the right:

[[File:Ocadapp ProjectSettingsArrowButtonsExpand.png| px]]

The following sections describe the different settings on each tab:

==General==
This tab displays general settings:

===Theme===
The OCAD App has both light and dark modes:

[[File:Ocadapp SettingsLightMode.png|75px]] [[File:Ocadapp SettingsDarkMode.png|75px]]

The System defined option will use whatever mode the operating system of the device is using.

===Language===
The App currently different languages to choose from.

[[File:Ocadapp SettingsLanguage.png|75px]]

===Button Size===
The user can decide on the desired button size in the App by adjusting the slider:

[[File:Ocadapp SettingsButtonSize.png|500px]]

The number of buttons across the screen width is also indicated, this may be useful when designing [[OCAD_App_Manual#Symbols|Symbol Favorites]] or when using small devices such as phones.

A smaller size may be suitable for use with a stylus, while bigger sizes are better with fingers.

===Screen Margin===
Some devices are insensitive to tapping around the edges, the user can increase the margin around the App, so the edge is not used:

[[File:Ocadapp SettingsScreenMargin.png]]

===Toolbar Position===
The toolbar has two positions:
*Floating and moveable
*Docked to the bottom of the screen.

[[File:Ocadapp SettingsToolbarPosition.png|500px]]

The default setting for this is “Device defined” which means that if the device screen width is less than the approximate size of about: ''(8 buttons) x (the button size)'' 
Then the toolbar will be docked at the bottom, if greater than this size it will be floating.

===Zoom===
These settings can be used to hide the zoom in and out buttons. The auto-rotate and auto-center functions of the Fixed zoom level actions can also be turned off.

[[File:Ocadapp SettingsZoomButtons.png|350px]]

===Compass===
If the device has a compass (internal or external) then this setting is visible. The size of the compass can also be specified:

[[File:Ocadapp SettingsShowCompass.png|500px]]

===Status bar===
The status bar can be hidden.
If it is visible:
*It can be positioned at the top or bottom of the screen.
*The text tooltips can be shown or hidden.
[[File:Ocadapp SettingsShowStatusBar.png|200px]]

===Scale Bar===
The scale bar on the map can be hidden:

[[File:Ocadapp SettingsShowScaleBar.png|500px]]

===North Lines===
The App can display magnetic north lines overlayed on the map with an equidistance given in millimeters. Note that these north lines only exist in the App, they are not the same as drawn north lines.

[[File:Ocadapp SettingsShowNorthLines.png|200px]]

===Demo Projects===
The two options to add demo projects to the App can be hidden with this checkbox.

===User Settings===
Tapping on the User Settings button:

[[File:Ocadapp SettingsUserSettings.png]]

Will open the User Settings page:

[[File:Ocadapp SettingsUserSettingsPage.png]]

Tapping the ''Unregister'' button will unregister the device from the OCAD server. See [[OCAD_App_Manual#Registration|Registration]] and [[OCAD_App_Manual#Technical_Notes|Technical Notes]] for more information.

There is currently no way to change the email address or name without unregistering and re-registering.

Note: This requires an Internet connection.

Important: Unregistering a device will NOT delete the projects on the device, but unless there is a registered user then any projects on the device cannot be uploaded to the cloud transfer service or exported.

==Positioning==
The tab contains generic settings for GPS and positioning functionality.

[[File:Ocadapp SettingsPositioning.png|400px]]

===Positioning===
The user’s current position on the map can be displayed using an indicator, the size, color and type can be modified:

[[File:Ocadapp SettingsPositioningShowCurrentPosition.png|500px]]

Tapping the default color [[File:Ocadapp SettingsPositioningDefaultColorSquare.png|30px]] square will reset the color back to purple. 
The number of GPS satellites available affects the precision of the position, the accuracy of the position can be shown on the map by tapping the “Show position precision” checkbox. 
This will display a shaded circle around the location on the map. A smaller circle indicates a more accurate position.

===Logging and tail===
The App can also record the user’s position and display the tracking of where they have been.

Background logging can be enabled which means the app will continue to record its position even when another app is active on the device. This usually requires approving permission on the device.

The visibility and length of the tail can be changed, as well the Color.

[[File:Ocadapp SettingsPositioningLogPosition.png|500px]]

Tapping the default color [[File:Ocadapp SettingsPositioningDefaultColorSquare.png|30px]] square will reset the color back to purple.

==Symbols==
The Symbols tab shows the configuration interface for editing “symbol favorites”. Symbol favorites are a way for the user to configure the symbol rows on the map toolbar, so they only need to see the symbols they use regularly. 
But it is possible to have more than one symbol favorites, so the user can have one for sand-dune terrain, and another for mountain terrain. Or for city parks and another for indoor maps. 
There is no limit to the number of different favorites.

The app comes with three predefined favorites ((their definitions can be found in an [[OCAD_App_Manual#Appendix_B_-_Default_Symbol_Favorites|Appendix B]]):
*Forest Symbols
*Sprint Symbols
*No sets

These cannot be deleted but can be hidden if not needed.

The user interface for symbol favorites is split into two parts, the favorites selector, and the favorites editor.

===Favorites Selector===
At the top of the Symbols tab there are functions for selecting the active favorites and buttons for creating and duplicating favorites:

[[File:Ocadapp SettingsSymbols.png|500px]]

The create favorites [[File:Heart plus.svg|border|30px]] button can be used to create new favorites.

The duplicate favorites [[File:Favorites copy.svg|border|30px]] button can be used to create a new copy of the current active favorites.

Use the drop-down menu [[File:Ocadapp SelectSymbolFavorite.png|150px]] to select the active favorites. The active favorites are the ones that will appear in the map toolbar. The user can also use the [[OCAD_App_Manual#The_Quick_Configuration_Button|Quick Configuration Panel]] to change the active favorites. This will also select the favorites that can be modified in the [[OCAD_App_Manual#Favorites_Editor|Favorites Editor]] below.

===Favorites Editor===
The favorites editor can edit ONE favorites at a time.

[[File:Ocadapp SettingsSymbolsFavoritesEditor.png|500px]]

The favorites have a name which can be changed (apart from the predefined favorites) to something appropriate such as ''Sand dunes'', ''Indoor'', ''Mountain'' or ''Forest Protected'' etc.

If the favorites are predefined then the Reset [[File:Refresh.svg|border|30px]] button appears, this will change the predefined favorites back to their original configuration.

The [[File:Ocadapp SettingsSymbolsVisibleCheckbox.png|80px]] checkbox can be used to hide a favorites from the [[OCAD_App_Manual#The_Quick_Configuration_Button|Quick Configuration Panel]]. This is useful if the user never makes Sprint maps, they can then just hide ''Sprint Symbols''.

===Sets===
A favorites is made up of ''sets''. A set represents a row in the map toolbar. It is possible to have up to five user-defined sets (or rows) in a favorites. Each set can contain many symbols, if there are too many for the width of the screen then row scrollbars are used in the map toolbar.

The number of sets and number of symbols in each set is up to the user to decide, but obviously the button size, screen size and orientation (portrait / landscape) will affect how the rows will look in the map toolbar.

To add a new set tap on the add set [[File:Playlist add.svg|border|30px]] button. To delete a set tap on the delete set [[File:Delete bin.svg|border|30px]] button beside the set to be deleted. The delete action will show a warning because deleting a set is not undoable, all changes are saved immediately.

===The Other Set===
Below the defined sets (1-5) will appear the “Other” set. This is where the user should put the symbols they do not use or only occasionally.

'''Important''': The Symbols favorites are project independent, but when editing the favorites only those symbols which are in the current project will be shown. And the symbol icon for a particular symbol always comes from the project file. In one project the symbol number 100.001 could be a road and in another type of project it could be a tree. Internally favorites are just a definition of sets, and each set has a list of symbol numbers. When opening a project, the app makes a mathematical intersection merging each favorites with the symbols in the project. Any symbol in a favorite set that is NOT in a project will remain in that set but will not be visible. And any symbol not in a user-defined set but exists in a project will be placed in the ''Other'' set.

Symbols in the “Other” set appear in the symbol selector panel which appears when tapping the symbol sector [[File:Grid.svg|border|30px]] button.

Note: The order of symbols in the ''Other'' set is not currently saved.

===Protected Symbols===
Protected symbols are those which are not normally selectable on the map and the user would not usually want to add or edit them. The ''Protected'' set appears below the ''Other'' set.

[[File:Ocadapp SettingsSymbolsProtectedSymbols.png| px]]

More information about protected symbols can be found in [[OCAD_App_Manual#Editing_Protected_Map-Objects|Editing protected map objects]].

===Editing Sets===
The symbols in the sets are edited by dragging them from one set to another. The order of the symbols in each set can also be edited by dragging symbols to the left and right within a set.

The user can drag one or many symbols from ONE set into another, for example, the user is going to move these four water symbols from Other to Set 1 and place them before the rock symbols:

[[File:Ocadapp SettingsSymbolsEditingSets.png|650px]]

Result:

[[File:Ocadapp SettingsSymbolsEditingSetsDone.png|650px]]

Note: only symbols from one set at a time can be dragged to another set.

A grey symbol selector [[File:Grid.svg|border|30px]] button icon always appears at the start of the last user-defined set. This is to indicate a placeholder to the user that the symbol selector button will appear in this position in the map toolbar.

To deselect all symbols, tap on the deselect [[File:Remove selection.svg|border|30px]] button here:

[[File:Ocadapp SettingsSymbolsDeselectSymbols.png|500px]]

===Delete a Symbol Favorites===
At the bottom of a symbol favorites is a delete [[File:Delete bin.svg|border|30px]] button which can be used to delete the current symbols favorites:

[[File:Ocadapp SettingsSymbolsDeleteSymbolFavorites.png| px]]

Note that this will display a warning as deleting a favorites is NOT undoable, all changes are saved immediately.

===Example Scenarios===

The following are three example scenarios demonstrating the possibilities of Symbol Favorites:
*'''Using a tablet in the mountains'''
Set up two favorites: Mountain and Mountain village.

[[File:Ocadapp SettingsSymbolsExampleMountain.png|650px]]

[[File:Ocadapp SettingsSymbolsExampleMountainVillage.png|650px]]

Make all other favorites hidden, then when out in the field the user can easily swap between the two sets of favorites using the [[OCAD_App_Manual#The_Quick_Configuration_Button|Quick Configuration Panel]]:

[[File:Ocadapp SettingsSymbolsQuickToolbar.png|500px]]

*'''Working with Protected Symbols'''
The user could set up different favorites for those times they want to edit protected map-objects:

[[File:Ocadapp SettingsSymbolsProtectedMapObjects.png|500px]]

While using this favorites the normally protected symbols are all editable. Revert to the normal Forest Symbols favorites afterwards.

*'''Phone'''
Working with limited space, creating a couple of favorites and using the No Sets favorites if doing a lot of sketching. In this case the user has decided that 8 buttons wide is about right for using their finger to draw. So, three rows of 8 symbols. The user can have common symbols between the sets if needed too:

[[File:Ocadapp SettingsSymbolsPhoneSprint1.png|250px]]
[[File:Ocadapp SettingsSymbolsPhoneSprint2.png|250px]]
[[File:Ocadapp SettingsSymbolsPhoneNoSets.png|250px]]

==Drawing==
On the Drawing tab there are settings for the selection and order of colors for sketching and notes.

[[File:Ocadapp SettingsDrawing.png]]

===Sketching===
By tapping a sketch color button, it can be turned on and off. Only those colors which are ''on'' will appear in the map toolbar.

To change the order of the colors, tap, hold, and drag one color at a time to a new position in the list.

===Notes===
By tapping a note color button, it can be turned on and off. Only those colors which are ''on'' will appear at the bottom of the note editor.

To change the order of the colors, tap, hold, and drag one color at a time to a new position in the list.

The Notes tool button can be hidden or positioned in different locations in the App.

[[File:Ocadapp SettingsNotes.png]]

===Map Objects===
*'''Show legibility halo''': The legibility halo shall support the cartographer to draw point and line objects with enough distance to each other. 
The distance of the legibility halo is based on the IOF specifications for orienteering maps.

[[File:OCAD App Legibility Halo Line Object.png|300px]]

[[File:OCAD App Legibility Halo Point Object.png|300px]]

==Support==
The Support setting tab contains advanced information and actions for sending information back to OCAD.

At the top is a Help section with links to the App Manual and the OCAD Wiki.

Note: A project can also be sent to OCAD Support using a function in the [[OCAD_App_Manual#Advanced|Advanced]] section of Project Options.

[[File:Ocadapp SettingsSupport.png|500px]]

===Log Settings===
The app logs activity by the user in a text file on the device. If the user encounters problems with the App they are encouraged to turn on “Extra app logging” then send the log files to OCAD for analysis.

The log files are stored locally on the device. A new log file is created each day and once the log file reaches a certain size (16MB). Older log files are automatically deleted by the app regularly.

The user can send one or more log files to OCAD (internet connection required). When sending a log file, the user should also write a message to describe what they were doing and why they are sending the log file(s).

IMPORTANT: When describing what the user is doing please try and specify to the nearest minute when the crash or problem occurred – this helps us a lot!

When sending a message with a log file only the first 1000 characters are sent, to send more text see [[OCAD_App_Manual#Sending_Feedback|Sending Feedback]] below.

Each log file has a link which can be tapped to open it on the device, this could be useful if the user needs to send part of a log file to OCAD, or if the Send function fails.

===Sending Feedback===
The user can send feedback messages to OCAD using the Message function. There is no limit to the size of text that can be submitted.

===App Settings===
The app’s App settings contain small pieces of information like the color order of the notes, or the position of the floating toolbar. There are currently about one hundred different things stored here. To send a copy of the settings for the current device, the user can do so by selecting the ''App settings file'' checkbox and tapping the ''Send to OCAD'' button. Only do this if requested to do so by OCAD as it may be useful to help resolve problems.

===Other Information===

[[File:Ocadapp SettingsSupport OtherInformation.png]]

The App privacy policy can be found here by clicking on the link: ''www.ocad.com/en/privacy/''

The current app version is displayed here.

If a project is open, then the ID of the project is displayed here, there is a copy [[File:Content copy.svg|border|30px]] button to the right which will copy the currently open projects id to the clipboard on the device.

=Appendices=
==Appendix A - App Updates==
The following sections describe functionality updates between recent versions of the App and this document.

'''Version 1.1.0.79'''
*Legibility Halo can be shown for point and line objects, see [[OCAD_App_Manual#Map_Objects|here]].
*Long-press on symbol shows symbol number and symbol name, see [[OCAD_App_Manual#Button_Rows|here]]
*Long-press on symbol gives possibility to hide or protect objects, see [[OCAD_App_Manual#Hide_and_Protect_Map_Objects|here]].
*Japanese and Chinese (traditional) language has been added.
*Performance improvements.

'''Version 1.0.5.71'''
*Good, poor, lost GPS Status indicators added to the status bar, see [[OCAD_App_Manual#GPS_Status|here]].
*Fixed zoom level auto-rotate and auto-center can now turned off in Settings, see [[OCAD_App_Manual#Zoom|here]].

'''Version 0.9.2.62'''
*3 configurable fixed zoom level buttons added, see [[OCAD_App_Manual#Configurable_Zoom_Buttons|here]]
*Scan Project QR code on the App to share a project with another device, see [[OCAD_App_Manual#Advanced|here]].
*Send Project to OCAD Support button added, see [[OCAD_App_Manual#Advanced|here]].
*Italian language has been added.

'''Version 0.9.1.60'''
*Directional point objects can now be rotated, see [[OCAD_App_Manual#Edit_Selection_Behavior|here]].
*Geometry vertex type can now be toggled between the value normal, dash and corner, see [[OCAD_App_Manual#Change_vertex_type|here]].
*Chinese and Portuguese languages have been added.

==Appendix B - Default Symbol Favorites==
'''Forest Symbols''' 
Set 1: ''101000, 102000, 103000, 103001, 109000, 110000, 111000, 112000, 201001, 202001, 202002, 202003, 203100, 204000, 205000, 207000'' 
Set 2: ''303000, 308001, 311000, 313000, 417000, 418000, 419000, 503000, 504000, 505000, 506000, 507000, 508000, 530000, 531000'' 
Protected: 
''Open land, paved area, out-of-bounds area: 401000, 501000, 501001, 520000, 520004'' 
''DEM Wizard smoothed contour symbols :10060000, 10061000, 10062000, 10060001, 10061001, 10062001, 10080000, 10081000, 10082000'' 
Protected + hidden: 
''DEM Wizard unsmoothed contour symbols: 10050000, 10051000, 10052000, 10050001, 10051001, 10052001''

'''Sprint Symbols''' 
Set 1: ''204000, 301000, 311000, 313000, 417000, 418000, 419000, 530000, 531000, 401000, 406000, 410000, 411002'' 
Set 2: ''501001, 501021, 501100, 513100, 513200, 515000, 516000, 518000, 520001, 521000, 522000, 532000'' 
Protected: 
''Open land, paved area, out-of-bounds area: 401000, 501000, 501001, 520000, 520004'' 
''DEM Wizard smoothed contour symbols :10060000, 10061000, 10062000, 10060001, 10061001, 10062001, 10080000, 10081000, 10082000'' 
''New Map Wizard - Swiss survey data symbols: 999000, 999001, 999010, 999011, 999512, 999513, 999515, 999521, 999522, 999523'' 
Protected + hidden: 
''DEM Wizard unsmoothed contour symbols: 10050000, 10051000, 10052000, 10050001, 10051001, 10052001'' 

==Appendix C - Folder Transfer==
Use the following sections as a guide for transferring a project to and from the App without using the cloud transfer or any internet connection.

Requirements:
*A cable to connect your device to your Windows Computer
*For iOS it is necessary to use iTunes from Apple and to have enabled “Trust” between the device and Windows so that Windows will be able to read and write files.

There may be other ways and techniques to copy the files to and from a device, but the ways described below use ordinary Windows folders.

===OCAD Desktop Export===

On the third step of the Data-exchange process the user can select “USB cable” as the transfer option:

[[File:Ocadapp FolderTransfer TransferOption.png]]

Clicking on the “Open folder and copy data” will open a Windows explorer window in a location like this:

:''C:\Users\user-name\AppData\Roaming\OCAD\OCAD 2018\Tmp\_OcadAppExchangeData\_DesktopToApp''

[[File:Ocadapp FolderTransfer TransferFolderToApp.png]]

The user should then copy this transfer project folder to the OCAD folder on their device. It is important to copy the WHOLE folder with ALL contents, see next sections.

===Copying to Android===
Copy the project folder from the step above to the location:

:''This PC\Galaxy Tab S8 \Internal storage\Android\data\com.ocad.app\files''

[[File:Ocadapp FolderTransfer TransferFolderToAppAndroid.png]]

After copying, there should be the “Bürenflue Export” project folder like this:

[[File:Ocadapp FolderTransfer TransferFolderToAppAndroidDone.png]]

The user can now open the OCAD App to import the project, see below.

===Copying to iOS===
Open iTunes on Windows and click on the device button:

[[File:Ocadapp FolderTransfer TransferFolderToAppiOS.png]]

Then click on:
#“File Sharing”
#Find the “OCAD” App
#Drag the whole folder from the “_DesktopToApp” folder into the right-hand side of the of iTunes where the list of folders is.
#Click on “Sync” to transfer the data to your iOS device

[[File:Ocadapp FolderTransfer_TransferFolderToAppiOSDone.png]]

Important: Do not try and use “Add File:” as this does not copy whole folders. 
When the “sync” has completed your project will be able to be imported into the OCAD App, see below. 
Note that copying the project files to iOS works similarly by using iCloud.

===Importing on the device===
Once the folder is moved to the above locations on the device, start the OCAD App, then click on [[File:Project add.svg|border|30px]] and “From folder”, the App will scan the folder and find the projects to import, select the desired project and tap on “Import”:

[[File:Ocadapp FolderTransfer ImportFromDevice.png]]

When the project import has completed, the user should be able to work with it in the same way as if it had been imported via the Cloud Transfer Service.

After importing, the files in the “Bürenflue Export” folder will be automatically removed, this is important as if the user was to do another “OCAD Desktop Export” and “copy” then the App will prompt the user to update their project on the App, see [[OCAD_App_Manual#Project_Lifecycle_2|Project Lifecycle]] below.

The “Bürenflue Export” folder is not deleted as it is used later for the export.

===Export from the device===
Tapping on the [[File:More vert.svg|border|30px]] button will open the project options, select the Export option.

[[File:Ocadapp FolderTransfer ExportFromDevice.png]]

This will export the project data from the internal storage and create files that can be copied back to the Windows computer and imported into OCAD Desktop. The export will create a folder similar to this:

:''export_iPhone_a43aae3a-debf-471e-849c-2290c526bab8''

or:

:''export_Galaxy Tab S8_a43aae3a-debf-471e-849c-2290c526bab8''

in the “Bürenflue Export” folder on the device. The names of the folders are unique to the device, this will enable the OCAD Desktop user to import data from various devices without risk of overwriting data.

Tapping on the “Include positioning file” checkbox above will also export the position.db file to the same location.

===Copy from Android===
Copy the export folder

:''export_Galaxy Tab S8_e667dd18-a34d-4223-94cb-e7c093cf5bb3''

From

:''This PC\Galaxy Tab S8\Internal storage\Android\data\com.ocad.app\files\Bürenflue Export''

To:

:''C:\Users\<user_name>\AppData\Roaming\OCAD\OCAD 2018\Tmp\_OcadAppExchangeData\_AppToDesktop\Bürenflue Export''

Important: Note that _AppToDesktop and _DesktopToApp are two different folder, ensure you copy to the correct one!

[[File:Ocadapp FolderTransfer CopyFromAndroid.png]]

The project can now be imported into OCAD Desktop.

===Copy from iOS===
Open iTunes and follow the initial instructions in [[OCAD_App_Manual#Copy_from_iOS|Copying to iOS]] above selecting File Sharing and the OCAD App. Then:
#Sync the data, this will copy the Bürenflue Export folder to your computer
#Select the Bürenflue Export folder
#The user may need to scroll down the screen to see the Add File… and Save… buttons
#Click on the Save… button

[[File:Ocadapp FolderTransfer_CopyFromiOS.png]]

After clicking Save… navigate to the folder:

:''C:\Users\<…user name…> \AppData\Roaming\OCAD\OCAD 2018\Tmp\_OcadAppExchangeData\_AppToDesktop''

Make sure the folder _AppToDesktop is selected in the Folder field (3).

[[File:Ocadapp FolderTransfer_CopyFromiOS2.png]]

Important: Note that _AppToDesktop and _DesktopToApp are two different folder, ensure you select the correct one!

After copying there will be a sub-folder in the project folder called something like:

:''export_iPhone_a43aae3a-debf-471e-849c-2290c526bab8''

[[File:Ocadapp FolderTransfer_CopyFromiOS3.png]]

Warning: If the project folder Bürenflue Export already exists the user will be prompted to overwrite it, and iTunes will OVERWRITE EVERYTHING. So, if there are export folders from other devices they will BE DELETED.

To work around this the user could save the folder elsewhere and copy it later to the _AppToDesktop folder. Or make sure previous imports have been completed using OCAD Desktop before saving the folder here.

Note that copying the project files from iOS works similarly by using iCloud.

===Import to OCAD Desktop===
From OCAD Desktop, select the menu item File – OCAD App Data Exchange. Select the transfer project “Bürenflue Export”, then in the panel below are listed the two exports from different devices. Click on “Import data from App”:

[[File:Ocadapp FolderTransfer ImportToOCADDesktop.png]]

This window is displayed for the “USB cable” transfer project, click on “Get importable files”:

[[File:Ocadapp FolderTransfer ImportToOCADDesktopGetFiles.png]]

This window is displayed with the available device imports:

[[File:Ocadapp FolderTransfer ImportToOCADDesktopImportFiles.png]]

Select one and click on Import Data and follow the usual procedure for importing data.

===Project Lifecycle===
After following the above procedure once, it is possible to re-export from OCAD Desktop again, copy to the device again, then tap Refresh (1) above the Projects List on the device. An orange message should appear in the list (2), tap to update the project with the latest version of the project from the Desktop.

[[File:Ocadapp FolderTransfer RefreshProjectList.png]]

After updating the project can be opened, edited, closed, re-exported, copied back to Windows and re-imported.

A project can have multiple users using one or more devices, using this copying system makes the process of working offline relatively easy.

===Technical Details===
The following details describe the files if a user needs to transfer files in other ways, such as email etc. Using a ZIP file could be recommended for this.

'''OCAD Desktop Exported files.''' 
The following items are exported from the OCAD Desktop and placed in a transfer project folder such as “Bürenflue Export”:
*“map.ocdExchange” – an OCAD file that can be imported to the App.
*“project.ocdInfo” – a small file containing transfer information.
*“back” folder - containing background images
The name of the folder containing these items should be the same as the transfer project in OCAD Desktop.

'''OCAD App Exported files.''' 
The export process creates a sub folder of the project transfer folder “Bürenflue Export”. The sub-folder name is constructed from “export”_”device-name”_”branch-ID”. This export sub-folder should contain two or three files:
*“map.ocdExchange” – an OCAD file that can be imported to the Desktop.
*“project.ocdInfo” – a small file containing transfer information.
*“position.db” – an optional file containing positioning information if the user also exports this.
Note that the background images are not exported as they cannot be changed on the App.

==Appendix D - Technical Notes==
'''Data Storage'''

The OCAD exchange files transferred to the device are only ever read on the device, some information in the files is copied to other hidden storage files on the device.

Only by exporting or uploading a project are OCAD exchange files created from the data in the internal storage.

The user should not copy or delete files in the directory: 
:''This PC\Galaxy Tab S8\Internal storage\Android\data\com.ocad.app\files\_projectdata''

Changing these files will break a project on the device and probably make it impossible to upload or export the project.

The files in this directory are required by a project to display the map correctly, but they do NOT contain the changes the user makes by editing the project.

If the user requires more space on their device, then background files (in the “back” folder) can be deleted manually without breaking a project. Deleting any other file will break the project.

'''Security'''

When using the OCAD Cloud-Transfer service the user may be concerned about security as there is no password or encryption involved in the process. Project security is based on the concept of anonymity, the user is the only person that has the project-id, there is no list of these ids anywhere, they are randomly generated 128 bit numbers so it is practically impossible to guess. See [https://en.wikipedia.org/wiki/Universally_unique_identifier Universally unique identifier - Wikipedia]. If the user shares an id with others, then there is a risk if those users share it.

File:Ocadapp ProjectManagementAdvanced2.png

2026-07-17T11:13:45Z

KLH:

File:Ocadapp SettingsSupport Backup.png

2026-07-17T10:53:08Z

KLH:

OCAD Sketch App

2025-05-27T10:48:25Z

KLH: /* USB cable */

=Introduction=
The OCAD Sketch App complements the desktop version of OCAD. 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.

Please visit also '''https://www.ocad.com/app''' for Frequently Asked Questions (FAQ) and further information about the App.

[[File:WPSliderSketchApp04.png]]
==Installation of the OCAD Sketch App==
The OCAD Sketch App is available in the Apple App Store (iOS) and Google Play Store (Android). Search for ''OCAD Sketch'', 

You can also click on the link on your mobile device or scan the QR code.

*'''iOS''': https://apps.apple.com/ch/app/ocad-sketch/id1570317033

:[[File:QRCode iOS.PNG|150px]]

*'''Android''': https://play.google.com/store/apps/details?id=com.ocad.mobile

:[[File:QRCode Android.PNG|150px]]

:[[File:Achtung.PNG|20px]]When scanning this QR code with your mobile device, please tap only on the option to open the above iOS or Android link.
: '''Never tap on any install buttons within the QR app (this can install advertising or phishing app's)!'''

:[[File:Hint.jpg]]The OCAD Sketch App is also available in [https://appgallery.huawei.com/app/C107018265 Huawai's AppGallery]. However, the App has not been tested, nor will it be supported on Huawei devices.

==Updating the App==
New versions of the app will typically be released first as beta updates for our testers.
To become an OCAD Sketch App tester, please use the links below:

*Google Play (Android): [https://play.google.com/apps/testing/com.ocad.mobile https://play.google.com/apps/testing/com.ocad.mobile]
*TestFlight (iOS): [https://testflight.apple.com/join/qO2zr90M https://testflight.apple.com/join/qO2zr90M]

When the beta test phase is over, there will be an official update available in the app stores for all users of the OCAD Sketch App. 

*Go to Google Play Store (Android) or Apple App Store (iOS).
*Search for ''OCAD Sketch''.
*''Update'' the OCAD Sketch App.

Read the '''[[OCAD_Sketch_App#Updates|Updates]]''' section for recent changes.

==Next steps after the installtion==

*Learn more in the '''[[OCAD_Sketch_App#OCAD_Sketch_App_Data_Exchange|OCAD Sketch App Data Exchange]]''' section how to transfer a project to your mobile device.
*Request a link or a QR code for a project from another person, e.g. a club member.
*You can also download the '''[[OCAD_Sketch_App#Demo_Project|Demo Project]]'''

==Further Information==
*Detailed explanation video on YouTube in English: https://youtu.be/QcKxjnAuuVY
*Detailliertes Erklärungsvideo auf YouTube auf Deutsch: https://youtu.be/GhvJRy5IJig
*Please visit [https://www.ocad.com/app https://www.ocad.com/app] for Frequently Asked Questions (FAQ) and further information about the App.
*Recommendations for [https://www.ocad.com/wiki/ocad/en/index.php?title=Technical_Data#Recommendations suitable mobile devices].

=OCAD Sketch App Data Exchange [[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 the '''OCAD Sketch App Data Exchange''' tool in OCAD Desktop to export data to or import data from the OCAD Sketch App. 
A file must be open for the function to be selected.

==Export data to App==
Open the '''OCAD Sketch App Data Exchange''' tool from the '''File''' menu.

You will be notified that the file will be saved. 
[[File:OCADSketchAppSave.png|500px]]

===Manage Transfer Projects===
[[File:OCADSketchAppDataExchange_ManageTransferProjects.png|750px]]

====Select Transfer project====
*'''Create''' a new transfer project. Enter a project name. The project name will be displayed in the OCAD Sketch App.
*'''Rename''' an existing transfer project.
*'''Delete''' an existing transfer project. 
[[File:Hint.jpg]] A QR code will be shown if you select a project that was already uploaded to OCAD Cloud Transfer. 
[[File:Achtung.PNG|20px]] '''Deleting a project in the desktop version of OCAD means that sketches for this project no longer can be imported via OCAD Cloud Transfer, even when recreating a project with the same name!''' 
You can still select a transfer project if you change the file name.

====Transfer direction====
Select a transfer project in the list above and choose the transfer direction. If you select a transfer project for which data has already been uploaded, its data will be overwritten.

'''Export data to App''': Use this option if you like to export your map and background maps to the app for field work. This option is described below. 
'''Import data from App''': Use this option if you like to import sketches from field work into OCAD Desktop, e.g. for final drawing. Read more about this step in the '''[[OCAD_Sketch_App#Import_data_from_App|Import data from App]]''' Section.

===Arrange Export===
[[File:OCADSketchAppDataExchange_ArrangeExport.png|750px]]

====Extent====
* '''Entire map''': Includes the extent of the entire map and all its background maps.

* '''Part of map''': Choose a predefined extent or define a new one. You can define a new extent by clicking on '''Define''' or open the '''[[Export_Files#Setup_Part_of_Map|Setup Part of Map]]''' dialog and save an extent there.

[[File:Hint.jpg]] The extent of a sketch app project is currently limited to 4x4 meters. 
[[File:Hint.jpg]] The part of map option is reset when transforming the map to another coordinate system or rotating the map to magnetic north.

====Background Maps====
* Choose the background maps that shall be exported to the OCAD Sketch App. Use ''SHIFT'' key to select multiple files. Use ''CTRL'' key to unselect a selected file.

====Resolution====
* Select a map resolution. This is used for the ocd map file which is displayed as a PNG image in the Sketch App. 
: Default settings: map scale > 1:5000 with 762 dpi (1 px = 0.033 mm) | map scale <= 1:5000 with 1270 dpi (1 px = 0.020 mm)
[[File:Hint.jpg]] The resolution should be better than your thinnest lines or smallest gaps. Otherwise they may cannot be well recognized in the PNG.

====Execute data processing====
* Click '''Execute data processing''' button to prepare the data for export.

[[File:Hint.jpg]]Note: This step can take several minutes if you have chosen a large extent or large background maps.

===Transfer and Share===
[[File:OCADSketchAppDataExchange_TransferAndShare_Cloud.png|750px]]

Choose one of the '''Data transfer options'''.

====OCAD Cloud Transfer====
''The project is uploaded to the OCAD Cloud Transfer which creates a QR code and a link to download the project to your mobile device.''

Choose this option and click '''Upload to OCAD Cloud Transfer'''.

A '''green hint''' shows you if the upload was successful and the QR code and link is shown in the '''Share''' section.

:'''QR Code''' 
:Scan the image with your mobile device (Photo or QR Scan App) and confirm to open the link. The project will be loaded automatically into the OCAD Sketch App.
:You can also copy the QR code or the link to the clipboard and may send it to someone else by email, SMS, WhatsApp, ect.
:The QR code will alo be displayed in the [[OCAD_Sketch_App#Manage_Transfer_Projects|Manage Transfer Projects]] section, if you select the newly uploaded project there.

:'''Project ID''' 
:Alternatively, open the link ''(e.g. <nowiki>https://mobile.ocad.com/project/af1bc2df-2abc-42a7-a190-0eeb97fb1e95</nowiki>)'' directly on your mobile device or open a project by [[OCAD_Sketch_App#Open_a_project|clicking on the '+' sign]] and entering the project ID (e.g. af1bc2df-2abc-42a7-a190-0eeb97fb1e95).

[[File:Achtung.PNG|20px]] The files will be removed from the OCAD Cloud Transfer after 7 days. Once you downloaded the data to your mobile device, the data will remain there even if the project is removed from the OCAD Cloud Transfer.

'''Close''' the dialog.

[[File:OCADSketchAppDataExchange_TransferAndShare_CloudUploaded.png|750px]]

====Data exchange folder====
''This option is probably smooth if you use a data exchange service app like DropBox, iCloud or OneDrive on your mobile device.''

# Choose this option and choose or create a ''Sketch App Data Exchange root folder'' on the DropBox etc. (e.g. ''C:\Users\Username\Dropbox\OcadSketchAppExchange'').
# Click '''Copy to data exchange folder''' to copy the files to the destination folder. 
# On your mobile device copy the files from the data exchange service app to the OCAD Sketch App '''files''' folder (e.g. \Android\data\com.ocad.mobile\files or iOS: Files\On My iPad\OCAD Sketch)

[[File:Hint.jpg]] In fact the files are copied to a subfolder ''_DesktopToApp\[ProjectName]'' of your chosen root folder. 
[[File:Hint.jpg]] OCAD remembers the ''Sketch App Data Exchange root folder'' and it will be set by default for upcoming transfer projects.

'''Close''' the dialog.

====USB cable====
''Copy the project folder manually to your mobile device.''

Choose this option and click '''Open folder'''. The '''Windows Explorer''' opens at the folder which contains the project folder.

Now copy the entire project folder to the OCAD Sketch App '''files''' folder on your mobile device (e.g. on Android: ''\Android\data\com.ocad.mobile\files'' or on iOS: ''Files\On My iPad\OCAD Sketch'').

'''Close''' the dialog.

[[File:Hint.jpg]] On Windows computers this option can only be used for Android devices. For iOS: Please load the project folder to the iCloud Drive and move it on the iOS device from there to ''Files\On My iPad\OCAD Sketch''. 
[[File:Hint.jpg]] May a notification appears on your mobile device where you need to allow file transfer.

==Import Data from App==
Open the '''OCAD Sketch App Data Transfer''' tool from the '''File''' menu.

===Manage Transfer Projects===

* '''Select transfer project''': as you like to import data from the OCAD Sketch App, you need to select the project that was used for the export.

* '''Transfer direction''': Choose '''Import data from App''' to import sketches from field work into OCAD Desktop, e.g. for final drawing.

===Transfer Options===
[[File:OCADSketchAppDataExchange_TransferOptions_Cloud.png|750px]]

Choose one of the '''Data transfer options''':

* '''OCAD Cloud Transfer''': Choose this option if the project was sent from OCAD Sketch App to OCAD Cloud Transfer after field work.

* '''Data exchange folder''': Copy the relevant files* on your mobile device to the data exchange folder e.g. ''Dropbox\OCAD Sketch App\'''_AppToDesktop'''\[ProjectName]''

* '''USB cable''': Copy the relevant files* from your mobile device to this folder in the OCAD AppData folder: 
: ''C:\Users\[USERNAME]\AppData\Roaming\OCAD\OCAD 2018\Tmp\_OcadSketchAppDataTransfer\'''_AppToDesktop'''\[ProjectName]''

: ''* Relevant files: '''map.ocd''' (the field work sketch is saved here) | '''position.db''' (GPS positions are logged here, if the option was activated). You find the files in the OCAD Sketch App files folder (e.g. \Android\data\com.ocad.mobile\files or iOS: Files\On My iPad\OCAD Sketch)''

'''For all 3 options:''' Click the '''Get importable files''' button to get a list of all importable files. The wizard jumps to the next step.

===Arrange Import===

[[File:OCADSketchAppDataExchange ArrangeImport.png|750px]]

====Choose files for import====
Choose the files you want to import. Use ''Shift'' key to select multiple files.
* '''GPS log import settings''': Optional: Assign a line symbol to the GPS log track.
[[File:Hint.jpg]] Sketches are imported to the '''[[Sketch#Sketch_Menu|OCAD Sketch layer]]'''. You can also import the '''map.ocd''' file (located in the OCAD Sketch App files folder on the mobile device, e.g. \Android\data\com.ocad.mobile\files or iOS: Files\On My iPad\OCAD Sketch), which contains the field work sketch into another mapping project using the '''[[Sketch#Sketch_Menu|Sketch >Import]]''' tool, e.g. to import sketches also into a larger overview map. The coordinate system and map extent need to be the same in such a case. 
[[File:Hint.jpg]] GPS positions log tracks are imported as unsymbolized or symbolized objects

Click '''Import data''' to import the file(s). 
All sketches added or modified in the app are imported. 
A '''green hint''' shows you if the imort was successful.

'''Close''' the dialog.

=Usage=

==Open a project==
Tap on a project item to open it.

If there is no project yet, then you must first load one or multiple map project onto the app.

*Read in the '''[[OCAD_Sketch_App#OCAD Sketch App Data Exchange|OCAD Sketch App Data Exchange]]''' section how you can transfer a project from OCAD Desktop to your mobile device.

*If you have no own project, you can also request a link or a QR code for a project from another person, e.g. club member or download our '''[[OCAD_Sketch_App#Demo_Project|Demo Project]]'''.

The first time you work with the app. you will be asked if OCAD Sketch App is allowed to retrieve the device location. Agree, if you want to work with internal GPS.

If your device has no compass, you will get notified when starting a project. Features requiring compass won't work in this case.

[[File:OCADSketchApp App GeneralSettings.jpg|border|400px]]

===General Settings===
[[File:Sketchapp settings.svg|30px]]

*'''Username''': Enter a username of 3 characters or more. This name does not have to be a real name but is merely used as an identification tag for the work that the user will do using the device.
*'''Debug logs enabled''': Enable debug logs, which OCAD may need to reproduce errors.
*'''Help''': Click the button to open OCAD Wiki.
*'''Share feedback''': Click the button to share feedback with OCAD.

The currently installed version is shown at the bottom, e.g. ''OCAD Sketch version 1.3.10.86''

===Project Settings===
[[File:Sketchapp menu.svg|30px]]

*'''Restore backup''': Option to restore a backup version of your project. Activate the '''Save backup versions''' checkbox in the '''[[OCAD_Sketch_App#Settings_.28GPS.2C_Compass.2C_North_lines....29|Project Settings]]''' tab.
*'''Send to OCAD Cloud Transfer''': Upload your project to the OCAD Cloud Transfer, so you can import the project later on in OCAD Desktop.
*'''Delete from phone''': Delete the project from your mobile device.

==OCAD Sketch UI==
[[File:OCADSketchApp App GUI.jpg||border|400px]]

===Finger gestures===
'''2 Fingers''' 
Use 2 Finger gestures to Zoom, Pan and/or Rotate the map.

'''1 Finger''' 
Use 1 Finger gestures with the tools from the bottom toolbar: 
* Pan / Draw Sketch / Erase Sketch
* Double tap with 1 Finger to zoom in (only if the Pan tool is active)

===Undo Redo (Draw/Erase)===
[[File:Sketchapp_revert.svg|30px]]
Undo the last draw/erase operation

[[File:Sketchapp redo.svg|30px]]
Redo the last draw/erase operation

===Layers ===
[[File:Sketchapp layers.svg|30px]]
Show/hide/dim layers (map and background map)

[[File:Sketchapp check-square.svg|30px]]
You can make a background map visible or hide it by clicking the checkbox.

[[File:Sketchapp drag.svg|30px]]
Drag a background layer to a different position in the list (change order).

[[File:OCADSketchApp App Dim.jpg|90px]]
Dim a background map, i.e. make the background map appear brighter. Slider to the right means the background map is displayed in its original colors. Slider to the left means the background map appears completely white or transparent.

[[File:Hint.jpg]] The ''map.png'' is transparent by default. 
[[File:Hint.jpg]] Whether the other background maps are transparent or not, depends on their '''[[Background_Map#Visibility_options|Transparent option]]''' in OCAD Desktop.

===Settings (GPS, Compass, North lines...)===
[[File:Sketchapp settings.svg|30px]]

*'''Show current position''': Shows your current position based on your device GPS. Your project must me correctly georeferenced and you must be within the project extent to see your position.
: [[File:Hint.jpg]] Check the geo-referencing of your OCAD file if this message appears: "Your position is currently outside of the map area..." but the GPS position is correctly shown in other apps like Google Maps. Use '''Backgroud Map''' -> '''[[Online_Map_Services|Online Map Services...]]''': The geo-referencing is wrong if the map viewer shows a place on earth that is different to your map's location.
*'''Show position precision''': Shows the expected precision of your current position.
*'''Log positions in project''': Logs your position to a gpx file, which can later be imported in OCAD Desktop. Only works when the device is awake.
*'''Always allow background logging''': Will always log GPS position, even if app is running in the background (e.g. using another app on the device, such as taking a photo) or device is not awake (e.g. put device in pocket while travel).

:- Note that this may also requires allowing "Always" tracking in the Location settings on your device
:- Note that changing this option can require to close and re-open the project
:- Note that it may also not works in low-power mode
:- Note that it may not works on all devices

*'''Show position tail''': Shows the position tail. Adjust the '''tail color''' and '''tail length''' if needed.
: [[File:Hint.jpg]] This option requires that '''Log positions in project''' is turned on
*'''Only show today's tail''': Show only tail from points from today.
*'''Eraser size''': Option to customize the eraser size.
*'''Show zoom buttons''': Show/Hide the Zoom-In/Out buttons
*'''Show compass''': Shows compass. Only available if your device has a [[Technical_Data#General_things_to_consider|build-in compass]].
*'''Show scale bar''': Shows a scale bar for better sense of distance.
*'''Show north lines''': Shows north lines on the map. Adjust the '''Distance between north lines''' if needed.
*'''Save backup versions''': Saves a backup of your project automatically according to the specified '''Backup interval'''.
: [[File:Hint.jpg]] A backup can be restored when the project is closed '''[[OCAD_Sketch_App#Project_Settings|Restore a backup]]'''.
*'''Straighten lines''': If you stop drawing for 1 second and still press the on the display, the previous line segment(s) will be straightened. This option can be activated always, never or only for scales 0 - 1:5000 (sprint maps).

===Project Management===
[[File:Sketchapp menu.svg|30px]]
'''Close Project''' Closes your project.

===Align North / Maximize===
[[File:sketchapp_align_north.svg|30px]]
If map view is rotated -> Reset map view rotation (north lines parallel to device screen).

[[File:Sketchapp maximize.svg|30px]]
If map view is not rotated -> Show entire map.

===Zoom===
[[File:Sketchapp plus.svg|30px]]
Zoom in

[[File:Sketchapp minus.svg|30px]]
Zoom out

[[File:Hint.jpg]] You can also zoom in/ zoom out with 2 fingers gestures.

===Position===
[[File:Sketchapp position.svg|30px]]
Single Tap: Center map to current position (1 x)

[[File:Sketchapp position auto.svg|30px]]
Double Tap: Center map to position (permanently).

[[File:Hint.jpg]]
Center map works only if '''Show current position''' is turned on.

===Compass===
[[File:Sketchapp compass.svg|30px]]
Single Tap: Rotate map view to current magnetic north (1 x)

[[File:Sketchapp compass auto.svg|30px]]
Double Tap: Rotate map view to magnetic north (permanently).

[[File:Hint.jpg]] If your device has no [[Technical_Data#General_things_to_consider|compass]], this tool will not be visible.

===Pan===
[[File:Sketchapp move.svg|30px]]
Pan the map with a pen or 1 finger gestures. Double click to zoom in.

[[File:Hint.jpg]] You can also zoom in/ zoom out with 2 fingers gestures.

===Draw Sketch===
[[File:Sketchapp draw.svg|30px]]

Click on the '''Draw Sketch''' button. Now you can start sketching with the specified line color/width.

You can either draw with your fingers or with a capacitive pen, which is beneficial for precise drawing (e.g. Samsung S Pen on Samsung Galaxy Note/Tab). In cold weather, a pen and gloves are suitable.

All your drawing will be saved automatically. You do not have to save the file. Once you are done with sketching, just close the project.

===Choose Sketch Width / Color===
[[File:Sketchapp line.png|30px]]

Click on the Choose Sketch Width / Color button if you like another color or line width for sketching.

There are 6 different line width and 13 different colors available. On devices with a small screen (e.g. smartphones), you can scroll to the left to see all colors. Click the [[File:DrawColors.svg|30px]] button to filter and sort the sketch colours.

Line widths are: 0.05 mm | 0.10 mm | 0.2 mm | 0.4 mm | 0.6 mm | 0.8 mm

[[File:Hint.jpg]] Important ISOM 2017 width 1:10'000 scale:
:Form line: 0.15 mm
:Contour / Narrow ride: 0.21 mm
:Small footpath: 0.27 mm
:Index contour / Passable cliff: 0.38 mm
:Impassable cliff / Road: 0.52 mm

[[File:Hint.jpg]] Important ISSprOM 2019 width 1:4000 scale:
:Step or edge of paved area: 0.1 mm
:Contour: 0.21 mm
:Uncrossable walls/ fences / hedges: 0.4 mm

===Erase Sketch===
[[File:Sketchapp eraser.svg|30px]]
Erase objects by running the eraser over them.

===Start/Stop GPS Tracking===
[[File:Sketchapp map-pin.svg|30px]]
Current color/width is used.

Double Tap creates a point feature (Start/Stop at same position)

GPS Tracking supports you to determine your current position. You can either use the internal GPS of your device (default) or connect to an external GPS.

GPS Tracking is always active, even if the app is running in the background.

==Upload the sketches again==
Usually a map is not drawn in one day, but the terrain survey and drawing on PC alternate several times until a map is finished.

You have two options for this:

*Overwrite existing project
:In the OCAD Sketch App you can open an existing project as you wish and continue mapping. If you upload the project again, it will be indicated in brackets that it is a new version when you import it into OCAD Desktop.
:[[File:OCADSketchAppImportVersion.png]]

*Create new transfer project
:Before each terrain survey, create a new transfer project (e.g., Project_xy_02) and load it in the OCAD Sketch App. This can be useful if you have already drawn parts of the map.

==Cooperation of several map maker==
When uploading a map project to OCAD Cloud Transfer, you will receive a QR code and link that you can share.

It is important to bear in mind:
*It is possible for different mappers to use the same QR code/link to download the project, work with it in the OCAD Sketch App and then upload it again using OCAD Cloud Transfer.
*The sketches can only be imported into OCAD Desktop in the map file with which the project was created.
*Alternatively, the sketches can be imported into OCAD under menu Sketch > Import. To do this, select the file map.ocd from your internal device memory (Android\data\com.ocad.mobile\files\...).

==Tipps==
Make sure that auto-rotate screen is deactivated on the mobile device.

=Demo Project=
Do you want to test the OCAD Sketch app but don't have a project available right now? Then download our demo project.

'''Step 1''': [[OCAD Sketch App#Installation of the OCAD Sketch App|Download]] the OCAD Sketch App to your mobile device.

'''Step 2''': Scan the following QR code with your mobile device.

::[[File:QR Code Demoproject.PNG]]

'''Step 3''': [[OCAD Sketch App#Open a project|Open]] the demo project.

'''Step 4''': Start sketching.

[[File:Hint.jpg]]Note: 
''Since you are most likely outside the project area, the position display will not work.'' 
''You cannot upload the demo project to OCAD Cloud Transfer.''

=Errors and Warnings=
*'''URL not found on this server''' ''(solved with OCAD Sketch Version 1.3.5, published in the App Store 2023-06-05)''
On Android devices, the default browser may opens with the error message ''The requested URL was not found on this server'' after scanning the QR code or opening the link for the OCAD Cloud Transfer.

'''Solution 1'''
# Go to the general device Settings > Apps > Default apps > Opening links.
Select OCAD Sketch > Enable ''Open supported links''
Tap ''Supported web addresses'' > Enable "mobile.ocad.com" 

'''Solution 2'''
# Go to the general device Settings > Apps > Default apps
Try with another Browser app (as default browser)

'''Workaround if the solution above does not help''': Enter the '''[[OCAD_Sketch_App#OCAD_Cloud_Transfer|Project ID]]''' directly on your mobile device by clicking on the '+' sign in the [[OCAD_Sketch_App#Open_a_project|project list]] and entering the project ID (e.g. af1bc2df-2abc-42a7-a190-0eeb97fb1e95).

*'''Phishing Message Warning''' 
One user reported that after installing OCAD Sketch he got a message with subject ''ocad-sketch_MediaNess''. '''This is a phishing message which has nothing to do with OCAD Sketch App'''. Please delete this message any even more important: Do not click on any links within the message!

=Updates=
;Version 1.4
: - Added the ability to filter and sort the sketch colours
: - Show/Hide the Zoom-In/Out buttons
: - Show/Dim/Hide the Sketch-Features layer on the map
: - Eraser can now be resized
: - All background layers can be shown or hidden all at once
: - Sketch features deletion undo-redo now uses a mouse action per transaction
: - Performance improvements and bug fixes

[[File:SketchAppUpdate1p4.gif]]

;Version 1.3
: - Additional colors for sketching
: - Improved position display of the internal GPS on Android devices
: - Scale bar added

;Version 1.2
: - Solved issues with panning the map
: - Solved issues with coordinate transformations

;Version 1.1
: - Added option to straighten lines with a long press
: - Added option to download projects, if link or QR code is not working
: - Optimized performance of position tail
: - Optimized drawing with an active pencil
: - Optimized map navigation

'''[[OCAD_Sketch_App#Updating_the_App|How to update the App]]'''

=Last but not least=
Credit goes to Yannis Güdel who helped us to develop the OCAD Sketch App and supported us with his ideas and knowledge.

Layout

2025-05-14T08:04:01Z

2022-03-18T13:21:36Z

KLH: /* USB cable */

[[File:Hint.jpg]] OCAD Sketch App - '''Beta Release'''. We have tested the OCAD Sketch App intensively and successfully on various devices over the last few weeks. However, errors may still occur. Therefore, we recommend to create regular backups. If you have any feedback, please use the ''Share Feedback'' tool in the '''[[OCAD Sketch App#General Settings|General Settings]]'''.

Known bugs are listed here: '''[[OCAD Sketch App#Known Bugs|Known Bugs]]'''

=Introduction=
The OCAD Sketch App complements the desktop version of OCAD. 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.

==Installation of the OCAD Sketch App==
The beta version of the OCAD Sketch App is not yet available in the Apple App Store and Google Play. 
You need to use the following links to download the OCAD Sketch App beta version to your mobile device. 
Click on the link on your mobile device or scan the QR code.

*'''iOS''': https://testflight.apple.com/join/qO2zr90M

:[[File:Qr-Testflight-OCAD Sketch iOS.png]]

*'''Android''': https://play.google.com/store/apps/details?id=com.ocad.mobile

:[[File:Qr-GooglePlayStore-OCAD Sketch Android.png]]

:[[File:Achtung.PNG]]
: When scanning this QR code with your mobile device, please tap only on the option to open the above iOS or Android link.
: '''Never tap on any install buttons within the QR app (this can install advertising or pishing app's)!'''

After the official release, the app can be downloaded and used for free in the Apple App Store (iOS), or Google Play (Android).

==Further Information==
*Detailed explanation video on YouTube in English: https://youtu.be/QcKxjnAuuVY
*Detailliertes Erklärungsvideo auf YouTube auf Deutsch: https://youtu.be/GhvJRy5IJig
*Please visit [https://www.ocad.com/app https://www.ocad.com/app] for Frequently Asked Questions (FAQ) and further information about the App.

=OCAD Sketch App Data Exchange=
Use the '''OCAD Sketch App Data Exchange''' tool in OCAD Desktop to export data to or import data from the OCAD Sketch App. 
A file must be open for the function to be selected.

==Export data to App==
Open the '''OCAD Sketch App Data Exchange''' tool from the '''File''' menu.

===Manage Transfer Projects===
[[File:OCADSketchAppDataExchange_ManageTransferProjects.png|750px]]

====Select Transfer project====
*'''Create''' a new transfer project. Enter a project name. The project name will be displayed in the OCAD Sketch App.
*'''Rename''' an existing transfer project.
*'''Delete''' an existing transfer project. 
[[File:Achtung.PNG|20px]] '''Deleting a project in the desktop version of OCAD means that sketches for this project no longer can be imported via OCAD Cloud Transfer, even when recreating a project with the same name!'''

====Transfer direction====
Select a transfer project in the list above and choose the transfer direction. If you select a transfer project for which data has already been uploaded, its data will be overwritten.

'''Export data to App''': Use this option if you like to export your map and background maps to the app for field work. This option is described below. 
'''Import data from App''': Use this option if you like to import sketches from field work into OCAD Desktop, e.g. for final drawing. Read more about this step in the '''[[OCAD_Sketch_App#Import_data_from_App|Import data from App]]''' Section.

===Arrange Export===
[[File:OCADSketchAppDataExchange_ArrangeExport.png|750px]]

====Extent====
* '''Entire map''': Includes the extent of the entire map and all its background maps.

* '''Part of map''': Choose a predefined extent or define a new one. You can define a new extent by clicking on '''Define''' or open the '''[[Export_Files#Setup_Part_of_Map|Setup Part of Map]]''' dialog and save an extent there.

====Background Maps====
* Choose the background maps that shall be exported to the OCAD Sketch App. Use ''SHIFT'' key to select multiple files. Use ''CTRL'' key to unselect a selected file.

====Resolution====
* Select a map resolution. This is used for the ocd map file which is displayed as a PNG image in the Sketch App. 
: Default settings: map scale > 1:5000 with 762 dpi (1 px = 0.033 mm) | map scale <= 1:5000 with 1270 dpi (1 px = 0.020 mm)
[[File:Hint.jpg]] The resolution should be better than your thinnest lines or smallest gaps. Otherwise they may cannot be well recognized in the PNG.

====Execute data processing====
* Click '''Execute data processing''' button to prepare the data for export.

[[File:Hint.jpg]]Note: This step can take several minutes if you have chosen a large extent or large background maps.

===Transfer and Share===
[[File:OCADSketchAppDataExchange_TransferAndShare_Cloud.png|750px]]

Choose one of the '''Data transfer options'''.

====OCAD Cloud Transfer====
''The project is uploaded to the OCAD Cloud Transfer which creates a QR code to download the project to your mobile device.''

Choose this option and click '''Upload to OCAD Cloud Transfer'''.

A '''green hint''' shows you if the upload was successful and the QR code is shown in the '''Share''' section.

Scan the image directly with your mobile device (Photo or QR Scan App) and confirm to open the link. The project will be loaded automatically into the OCAD Sketch App.

As an alternative you can Copy the QR code to the clipboard and may send it to someone by email.

[[File:Achtung.PNG|20px]] The files will be removed from the OCAD Cloud Transfer after 7 days. Once you downloaded the data to your mobile device, the data will remain there even if the project is removed from the OCAD Cloud Transfer.

'''Close''' the dialog.

[[File:OCADSketchAppDataExchange_TransferAndShare_CloudUploaded.png|750px]]

====Data exchange folder====
''This option is probably smooth if you use a data exchange service app like DropBox, iCloud or OneDrive on your mobile device.''

# Choose this option and choose or create a ''Sketch App Data Exchange root folder'' on the DropBox etc. (e.g. ''C:\Users\Username\Dropbox\OcadSketchAppExchange'').
# Click '''Copy to data exchange folder''' to copy the files to the destination folder. 
# On your mobile device copy the files from the data exchange service app to the OCAD Sketch App '''files''' folder (e.g. \Android\data\com.ocad.mobile\files or iOS: Files\On My iPad\OCAD Sketch)

[[File:Hint.jpg]] In fact the files are copied to a subfolder ''_DesktopToApp\[ProjectName]'' of your chosen root folder. 
[[File:Hint.jpg]] OCAD remembers the ''Sketch App Data Exchange root folder'' and it will be set by default for upcoming transfer projects.

'''Close''' the dialog.

====USB cable====
''Copy the project folder manually to your mobile device.''

Choose this option and click '''Open folder'''.

The '''Windows Explorer''' opens at the folder which contains the project folder.

Now copy the entire project folder to the OCAD Sketch App '''files''' folder on your mobile device (e.g. \Android\data\com.ocad.mobile\files).

[[File:Hint.jpg]] This option can only be used on Android devices. 
[[File:Hint.jpg]] May a notification appears on your Android device where you need to allow file transfer via USB.

=== Close===
'''Close''' the dialog after finishing data exchange.

==Import Data from App==
Open the '''OCAD Sketch App Data Transfer''' tool from the '''File''' menu.

===Manage Transfer Projects===

* '''Select transfer project''': as you like to import data from the OCAD Sketch App, you need to select the project that was used for the export.

* '''Transfer direction''': Choose '''Import data from App''' to import sketches from field work into OCAD Desktop, e.g. for final drawing.

===Transfer Options===
[[File:OCADSketchAppDataExchange_TransferOptions_Cloud.png|750px]]

Choose one of the '''Data transfer options''':

* '''OCAD Cloud Transfer''': Choose this option if the project was sent from OCAD Sketch App to OCAD Cloud Transfer after field work.

* '''Data exchange folder''': Copy the relevant files* on your mobile device to the data exchange folder e.g. ''Dropbox\OCAD Sketch App\'''_AppToDesktop'''\[ProjectName]''

* '''USB cable''': Copy the relevant files* from your mobile device to this folder in the OCAD AppData folder: 
: ''C:\Users\[USERNAME]\AppData\Roaming\OCAD\OCAD 2018\Tmp\_OcadSketchAppDataTransfer\'''_AppToDesktop'''\[ProjectName]''

: ''* Relevant files: '''map.ocd''' (the field work sketch is saved here) | '''position.db''' (GPS positions are logged here, if the option was activated)''

'''For all 3 options:''' Click the '''Get importable files''' button to get a list of all importable files. The wizard jumps to the next step.

===Arrange Import===

[[File:OCADSketchAppDataExchange ArrangeImport.png|750px]]

====Choose files for import====
Choose the files you want to import. Use ''Shift'' key to select multiple files.
* '''GPS log import settings''': Optional: Assign a line symbol to the GPS log track.
[[File:Hint.jpg]] Sketches are imported to the '''[[Sketch#Sketch_Menu|OCAD Sketch layer]]''' 
[[File:Hint.jpg]] GPS positions log tracks are imported as unsymbolized or symbolized objects

Click '''Import data''' to import the file(s).

'''Close''' the dialog.

=Usage=

==Open a project==
You can load multiple projects on one device. Learn more in the '''[[OCAD_Sketch_App#OCAD Sketch App Data Exchange|OCAD Sketch App Data Exchange]]''' section how to transfer a project to your mobile device.

You can also download the '''[[OCAD_Sketch_App#Demo_Project|Demo Project]]'''.

Tap on a project item to open it.

The first time you work with the app. you will be asked if OCAD Sketch App is allowed to retrieve the device location. Agree, if you want to work with internal GPS.

If your device has no compass, you will get notified when starting a project. Features requiring compass won't work in this case.

[[File:OCADSketchApp App GeneralSettings.jpg|border|400px]]

===General Settings===
[[File:Sketchapp settings.svg|30px]]

Open the general settings to adjust your username, get help or share feedback with the developers.

===Project Settings===
[[File:Sketchapp menu.svg|30px]]

*'''Restore backup''': Option to restore a backup version of your project. Activate the '''Save backup versions''' checkbox in the '''[[OCAD_Sketch_App#Settings_.28GPS.2C_Compass.2C_North_lines....29|Project Settings]]''' tab.
*'''Send to OCAD Cloud Transfer''': Upload your project to the OCAD Cloud Transfer, so you can import the project later on in OCAD Desktop.
*'''Delete from phone''': Delete the project from your mobile device.

==OCAD Sketch UI==
[[File:OCADSketchApp App GUI.jpg||border|400px]]

===Finger gestures===
'''2 Fingers''' 
Use 2 Finger gestures to Zoom, Pan and/or Rotate the map.

'''1 Finger''' 
Use 1 Finger gestures with the tools from the bottom toolbar: 
* Pan / Draw Sketch / Erase Sketch
* Double tap with 1 Finger to zoom in (only if the Pan tool is active)

===Undo Redo (Draw/Erase)===
[[File:Sketchapp_revert.svg|30px]]
Undo the last draw/erase operation

[[File:Sketchapp redo.svg|30px]]
Redo the last draw/erase operation

===Layers ===
[[File:Sketchapp layers.svg|30px]]
Show/hide/dim layers (map and background map)

[[File:Sketchapp check-square.svg|30px]]
You can make a background map visible or hide it by clicking the checkbox.

[[File:Sketchapp drag.svg|30px]]
Drag a background layer to a different position in the list (change order).

[[File:OCADSketchApp App Dim.jpg|90px]]
Dim a background map, i.e. make the background map appear brighter. Slider to the right means the background map is displayed in its original colors. Slider to the left means the background map appears completely white or transparent.

[[File:Hint.jpg]] The ''map.png'' is transparent by default. 
[[File:Hint.jpg]] Whether the other background maps are transparent or not, depends on their '''[[Background_Map#Visibility_options|Transparent option]]''' in OCAD Desktop.

===Settings (GPS, Compass, North lines...)===
[[File:Sketchapp settings.svg|30px]]

*'''Show current position''': Shows your current position based on your device GPS. Your project must me correctly georeferenced and you must be within the project extent to see your position.
*'''Show position precision''': Shows the expected precision of your current position.
*'''Log position to file''': Logs your position to a gpx file, which can later be imported in OCAD Desktop.
*'''Show positions log tail''': Shows the position log tail. Adjust the '''tail color''' and '''tail length''' if needed.
: [[File:Hint.jpg]] This option requires that '''Log position to file''' is turned on
*'''Show north lines''': Show north lines on the map. Adjust the '''Distance between north lines''' if needed.
*'''Show compass''': Shows compass. Only available if your device has a build-in compass.
*'''Save backup versions''': Saves a backup of your project automatically according to the specified '''Backup interval'''.
: [[File:Hint.jpg]] A backup can be restored when the project is closed '''[[OCAD_Sketch_App#Project_Settings|Restore a backup]]'''.

===Project Management===
[[File:Sketchapp menu.svg|30px]]
'''Close Project''' Closes your project.

===Align North / Maximize===
[[File:sketchapp_align_north.svg|30px]]
If map view is rotated -> Reset map view rotation (north lines parallel to device screen).

[[File:Sketchapp maximize.svg|30px]]
If map view is not rotated -> Show entire map.

===Zoom===
[[File:Sketchapp plus.svg|30px]]
Zoom in

[[File:Sketchapp minus.svg|30px]]
Zoom out

[[File:Hint.jpg]] You can also zoom in/ zoom out with 2 fingers gestures.

===Position===
[[File:Sketchapp position.svg|30px]]
Single Tap: Center map to current position (1 x)

[[File:Sketchapp position auto.svg|30px]]
Double Tap: Center map to position (permanently).

[[File:Hint.jpg]]
Center map works only if '''Show current position''' is turned on.

===Compass===
[[File:Sketchapp compass.svg|30px]]
Single Tap: Rotate map view to current magnetic north (1 x)

[[File:Sketchapp compass auto.svg|30px]]
Double Tap: Rotate map view to magnetic north (permanently).

[[File:Hint.jpg]] If your device has no compass, this tool will not be visible.

===Pan===
[[File:Sketchapp move.svg|30px]]
Pan the map with a pen or 1 finger gestures. Double click to zoom in.

[[File:Hint.jpg]] You can also zoom in/ zoom out with 2 fingers gestures.

===Draw Sketch===
[[File:Sketchapp draw.svg|30px]]

Click on the '''Draw Sketch''' button. Now you can start sketching with the specified line color/width.

You can either draw with your fingers or with a capacitive pen, which is beneficial for precise drawing (e.g. Samsung S Pen on Samsung Galaxy Note/Tab). In cold weather, a pen and gloves are suitable.

All your drawing will be saved automatically. You do not have to save the file. Once you are done with sketching, just close the project.

===Choose Sketch Width / Color===
[[File:Sketchapp line.png|30px]]

Click on the Choose Sketch Width / Color button if you like another color or line width for sketching.

There are 6 different line width and 13 different colors available. On devices with a small screen (e.g. smartphones), you can scroll to the left to see all colors.

Line widths are: 0.05 mm | 0.10 mm | 0.2 mm | 0.4 mm | 0.8 mm | 1.6 mm

[[File:Hint.jpg]] Important ISOM 2017 width 1:10'000 scale:
:Contour / Narrow ride: 0.21 mm
:Index contour / Impassable cliff: 0.38 mm
:Form line: 0.15 mm
:Impassable cliff / Road: 0.52 mm
:Passable cliff: 0.38 mm
:Small footpath: 0.27 mm

[[File:Hint.jpg]] Important ISSprOM 2019 width 1:4000 scale:
:Uncrossable walls/ fences / hedges: 0.4 mm
:Step or edge of paved area: 0.1 mm
:Contour: 0.21 mm

===Erase Sketch===
[[File:Sketchapp eraser.svg|30px]]
Erase objects by running the eraser over them.

===Start/Stop GPS Tracking===
[[File:Sketchapp map-pin.svg|30px]]
Current color/width is used.

Double Tap creates a point feature (Start/Stop at same position)

GPS Tracking supports you to determine your current position. You can either use the internal GPS of your device (default) or connect to an external GPS.

GPS recording is active, even if you switch to another map (e.g. browse in the internet or make a phone call while mapping). Only if you close the OCAD Sketch App, the position recording will stop.

=Demo Project=
Do you want to test the OCAD Sketch app but don't have a project available right now? Then download our demo project.

'''Step 1''': [[OCAD Sketch App#Installation of the OCAD Sketch App|Download]] the OCAD Sketch App to your mobile device.

'''Step 2''': Scan the following QR code with your mobile device.

::[[File:QR Code Demoproject.PNG]]

'''Step 3''': [[OCAD Sketch App#Open a project|Open]] the demo project.

''Note:'' 
''Since you are most likely outside the project area, the position display will not work.'' 
''You cannot upload the demo project to OCAD Cloud Transfer.''

=Known Bugs=
* North lines are currently oriented to geographic north instead of magnetic north
* On Android devices the upload of OCAD-Files larger than 10MB to OCAD Cloud Transfer failes

=Pishing Message Warning=
* One user reported that after installing OCAD Sketch he got a message with subject ''ocad-sketch_MediaNess''. '''This is a pishing message which has nothing to do with OCAD Sketch App'''. Please delete this message any even more important: Do not click on any links within the message!