Adding Files, Understanding Base Locations

Top  Previous  Next

Each project is anchored in two base locations:

The project folder (the one where the .TPR project file resides);
The source library set folder.

The base location is like a starting point from which TIDE looks for a file. File paths in the .TPR file are specified with reference to their base location (more).

Typically, all project files (excluding library files) reside in the project folder itself. But what if you specify a file outside the project folder? TIDE will memorize a relative path from the project folder to this file. Moving the project folder to another location won't change that. When the project is opened from that new location, TIDE will still use the path relative to the new location.

It is not possible to specify an absolute location for the files in the project tree.

It is, however, possible to specify the relative or the absolute path with the include statement.


Click to enlarge
Click to enlarge

The project tree shows each file as anchored in the project folder or the library set folder.

Note how all library files appear in a separate tree branch called "Libraries".

The number next to the Libraries tag is the currently selected library set.


tide_button_addfileFile > Project Files > Add New File: Adding a new file to a project always uses the project folder as a reference.


tide_button_addexistingfileFile > Project Files > Add Existing File: Adding an existing file to a project allows you to choose the base location (project or libraries).



note_warning-wtFiles added from libraries are locked for editing by default. This is to remind you that it is a very bad practice to alter library files. You can unlock a file (right click > Unlock) but we really don't recommend this. Want to modify a library? Copy this library's files into your project's folder and add them as "your" files (base location = project folder).