VHDL and Verilog for Visual Studio

Documentation

V3S | Coding | Library View


Support

  VHDL
  Verilog

How to Access

V3S main menu

Description

Opens a view which shows the current project's library hierarchy.

Documentation

Important Remark: The Library View is only updated upon saving a source file. This is due to performance reasons, especially for big projects. You can at any time click the Refresh-button in the Library View's menu bar.

The Library View window is a very handy toolwindow which allows the user to quickly navigate through a project's code base. The view organizes the entire project according to its library definitions rather than its design hierarchy (there is a separate view for this - refer to   Hierarchy View). The following image shows a screenshot of the Library View for the sample project which can be created by the project wizard (see also   New Project Wizard).

Library View, showing most details

The top-level nodes of the Library View are formed of all libraries that are defined in the project. Each library then contains, organized as tree, all items and elements that belong to it. Depending on the detail-settings (see below for further information), this sub-tree is more or less detailed. In contrast to the image above, the next screenshot shows the same project's Library View with the least details.

Library View, showing least details

The following table summarizes all icons of the menu-bar as well as all other important functionality concerning the Library View windows.


Sorting: If this button is active, the subtrees are sorted alphabetically from A to Z by the nodes' displayed names.

Sorting: If this button is active, the subtrees are sorted by category. This means, that all entities are grouped, all architectures are grouped, all packages are grouped, ...

Sorting: If this button is active, the subtrees are sorted by order of declaration within the respective source files. Thus the order of nodes of the tree corresponds to the order of declaration/definition within the respective source file.

Details: When this button is selected, the least details are shown. This basically means that only the libraries with their direct children are displayed (refer to the second screenshot above). For libraries this means that the corresponding entities, architecture and packages are included in the view.

Details: If this button is active, a medium level of details are shown in the view. This basically means that one level of detail is added to the tree: For each architecture, entity and package, also their direct children are displayed (i.e., functions, signals, constants, etc.)

Details: If this button is active, most details are shown in the view. First of all, a new level is inserted directly following the library name (refer to the first screenshot above): The filename. Now each library first includes a list of files that are part of the respective library. Concerning the subtrees, all information is now included in the tree: For functions, also their parameters and local variables are included, for components also their generic and port definitions are included, for record-types the single fields are included, ...

Include Standard Libraries: If this button is selected, the Library View also includes the standard libraries IEEE and STD. Otherwise, the standard libraries are omitted.

Refresh: Manually update the view. Notice that the view is automatically updated only upon saving a source file. A manual refresh can be forced with this button at any time.
Navigation: You can use the arrow keys to navigate through the tree nodes. Either use the mouse (left-click) or press Enter to jump to the declaration/definition of the currently selected node.
Context-menu: Right-clicking any node of the tree opens the node-specific context menu. Refer to the table below for details.

There is a node-specific context-menu available for each node. Depending on the type of the node, some of the entries might be disabled.

Context-Menu of Library View

Goto Declaration Jumps to the source code location of the currently selected element in the Library View. This is the same as simply left-clicking the node or pressing Enter.
Find References Finds all references of the currently selected node in the entire project. This is the same as the Find All References... command in the V3S main menu or the code-editor's context menu.
Rename... Opens the Rename... dialog for the currently selected node. This is the same as the Rename... command in the V3S main menu or the code-editor's context menu.
Create Testbench... Opens the Create Testbench... dialog for the currently selected node. The node must be an entity. This is the same as the Create Testbench... command in the V3S main menu or the code-editor's context menu.

See also:

© 2013 - 2017 by ViDE-Software Contact | Terms | Imprint