Projects view

VS Code provides the Explorer view to browse through files and folders. To be able to fully represent your project and offer custom functionality, Sigasi offers a very similar Projects View. This view also offers a file browser for your projects, but it includes external folders that are not physically part of your project. This is especially useful for including external IP in your projects.

The Projects View offers a lot of custom Sigasi functionality, such as library mapping, version setting, and project settings, without overloading the Explorer view .

Buttons in the projects view

Create and open a new project, or open an existing project
Create a new file
Create a new folder
Forcefully refresh the contents of the projects view
Collapse all folders in the projects view
More Actions
- Follow Cursor: links the projects view with the editor
- Hide Excluded Files: toggles whether excluded files should be hidden
- Configure Excluded Files: opens settings to configure file exclusions

Excluding files

Files can be excluded from showing up in the Projects View. By default, Sigasi project configuration files like .project, .library-mapping.xml, and .settings are filtered. The filtering can be customized through the following settings, accessible through the Configure Excluded Files button under More Actions… :

The sigasi.projectsView.exclude setting specifies a list of glob patterns to match files that will be excluded.
The sigasi.projectsView.excludeNonHdlFiles setting ensures only HDL files are shown.
The sigasi.projectsView.inheritGlobalExclude setting determines whether the global exclusion filter from VS Code should also be applied.

Filtering can be toggled through the Hide Excluded Files toggle button under More Actions…

Excluded files are still processed by Sigasi. To exclude them from processing, remove them from the build.

Sigasi Projects in the Projects View

To accommodate new Sigasi Projects (preview) concepts, the Projects View represents such projects differently. The structure of the captured project is visualized in two different forms: as a filesystem centric Design perspective and as a logical Targets perspective.

The Design perspective allows navigating the structure of all directories that contribute to the project. The captured information from the build script might refer to files from various locations on disk or configured include paths, or rely on files that are located on shared drives. All the directories are accessible in the Design folder.

The Targets perspective reveals the logical structure of the project. For each defined target, a folder represents the libraries and their associated files. The files are rendered in the order of compilation wherever possible. This view will also reveal if some files are mentioned in the build scripts but are missing on disk.

You can open source files in the Targets perspective from the Code Lens at the top of the file.