Symbol Library

GENESIS64 comes with a powerful tool called Symbol Library, which is located in the Symbols tab. It shares the same location as the Object Explorer and Toolbox tabs in the Workbench. Symbols are pre-made representations of commonly used display objects, such as gauges and knobs, and some are also pre-animated. These symbols can be used (both static and dynamic) to quickly create animated displays by dragging them from the Symbol Library onto the display. You can also add your own symbols to the Symbol Library; simply drag and drop your symbols from the display into the Symbol Library window. The animated graphic objects, along with any attached scripts, are automatically saved and categorized for you. You can create, rename, and delete category folders and symbol files within the Symbol Library. Refer to the Symbol Library Menu Commands table below for additional information.

 

The Symbol Library is available when GraphWorX64 is in Configuration Mode. It can be freely floating or docked to any side of the display: left, top, right, or bottom, as shown in the figure below. You can show and hide the Symbol Library by using Symbols check box in the Show/Hide section of the 2D GraphWorX64 View tab.

 

The Symbols Panel Showing Gauges

 

Searching for Symbols

You can quickly find the symbols needed for a particular display by entering search terms into the text box located near the top of the Symbol Library tool.

Search terms are associated words and descriptions that help find the desired symbol. Select the search button (magnifying glass) or press the Enter key on the keyboard to find symbols associated with the search term. Search for symbols by name, function, industry, color, and style. When using multiple terms, their sequence will not affect the search results (e.g. searching for "2D Yellow Pipe" will yield the same results as "Pipe 2D Yellow"). The symbols in currently opened category or currently shown set of search results auto-save whenever a search operation is initiated.

 

Note: Similar to other ICONICS search features, the symbol library utilizes wildcard character searches. Use * to find any number of characters, use ? to find any single character and # to find any single digit.

 

 

Symbol Search Pane

 

The associated symbols, along with the total number of symbols found, will then appear in the Symbol Library tool. Symbols from this pane can be dragged and dropped directly onto the canvas.

 

You can edit a symbol's properties directly in the search results to customize a symbol further or to make future searches easier. To do this, either right-click a search result and select "Edit Symbol Properties", or select a search result and press Ctrl+E on the keyboard. For more information about editing symbol properties, see the Edit Symbol Properties section below.

 

You will also find symbols that are closely related to a particular search result by opening the result's symbol library category. To do this, either right-click a search result and select "Open Containing Category", or select a search result and press Ctrl+O on the keyboard.

 

Alternatively, you can add symbols by locating them within their categories. Opening a category will display the contents within the symbol search pane.

 

Symbol Library Category Search

 

Symbol search history is also available directly below the search field. You can delete the search history by selecting the "Clear Search History" button.

 

Edit Search Settings

For more control over the types of results that appear after completing a search for symbols, you can edit more advanced settings using the Edit Symbol Search Settings window (shown below). To access this dialog, select the disclosure arrow next to the search button and select "Edit Search Settings..."

 

Edit Search Settings

 

 This will open the Edit Symbol Search Settings window.

 

Edit Symbol Search Settings

 

The options available in this dialogue include:

Word Variations Setting

The Edit Word Variations window contains the search term in the first column and the variations on that term in the second. The original search term and each of the variations are fully interchangeable, though.

Let´s take and, &, 'n, and also, as well as for an example. If you search for "and", the results will include those that match any of {&, 'n, and also, as well as}. Also, if you search for "&", the search results will include {and, 'n, and also, as well as}.

If any of the variations include spaces, searching for them with variations enabled requires to put quotation marks around them. For example, given the above variations, searching for [and also] will not yield the same results of the other variations, but ["and also"] will.

The word variation table will be saved in the user settings as a *.csv string. The user settings file will most likely be under

C:\Users\...\AppData\Local\IsolatedStorage\<random letter folder>\<random letter folder>\Url.<random letters>\AssemFiles\ICONICS\GraphWorX64

 

Rebuild Symbol Index

The Symbol Library tool uses an index to speed up the searching process. To ensure the most complete and consistent search results possible, you can rebuild this index. This option is particularly useful if a new symbol category has been added to the symbol library.

 

To rebuild the symbol library index, select the disclosure arrow next to the Search for Symbols button. From this drop down menu, select the Rebuild Symbol Index option. Selecting this option will initiate indexing of the symbol library and display the progress in the symbol search pane. The symbols currently-opened category or currently-shown set of search results auto-save whenever a symbol index rebuild is initiated.

 

Indexing Symbol Categories

 

Once the symbol library index has been rebuilt, you can search for all symbols in the symbol library, including the ones recently added.

Advanced Search

For even more control over the types of results that appear when searching for symbols, apply more detailed parameters using the symbol library advanced search tool.

To use this tool, select the disclosure arrow next to the Search for Symbols button. From this drop down menu, select the Advanced Search... option. In the Find Type group, specify the symbol properties to consider:

 

Symbol Library Advanced Search

 

Option:

Looks in the:

Adds to the Find What drop-down list:

Text

Text property of symbols

 

Dynamic Data Source

OPC tags used as data sources in symbols' DataSource property

All data sources referenced in the current selection

Name

Name property of symbols

All symbol names in the current selection

Title

Title property of symbols

 

Description

Description property of symbols

 

Share Keyword

ShareKeyword property of symbols

 

Custom Data

CustomData property of symbols

 

File Name

Names of referenced files

Names of all files referenced in the current selection

 

·       Look In

§        Current Selection - searches the symbol that is currently selected in the Symbols tab

§        Current Category - searches the category that is currently open in the Symbols tab.

§        All Categories - searches all categories in the Symbol Library. Selecting this option will cause the search to open every category in the Symbols tab; depending on how many categories there are and their size, this could take some time.

·       Find what  - Specify the desired text, including tags, object names, or file names of symbols. Click the ellipsis button to open the Data Browser to help you. The Data Browser can be helpful when entering a search string that is composed of a complex path to a data source or some other string that is difficult to enter precisely or remember. Use additional filters such as Match whole word only and Match case to further limit results

§        Match whole word only - When checked, the search will find symbols only when entire words from the search query are matched.

§        Match case - When checked, the search will find symbols only when the lower-case and upper-case characters within the search query are matched.

Perform the search by clicking one of the following buttons. Matches are displayed in the Results section at the bottom of the dialog.

   ·   Click the Find Next button to find the first instance of what you are looking for and highlights it in the Symbols tab. If the match is not the one you are looking for, continue clicking the Find Next button until you find the one you want.

   ·   Click the Find All button to find all instances of what you are looking for. This option is helpful if you want a complete list of instances or if you can want to save the results to a file, or copy the results to the clipboard. This option may take time to complete, depending on the breadth of your search criteria and the focus of your search.

 

Once you have results, you can view or save them:

  1. To navigate to any symbol listed in the results, double-click it. This highlights the symbol in the Symbols tab; it may take time to load the symbol's category into the Symbols tab first.

  2. To copy the search criteria and the results to the clipboard, click the copy button . You can then paste the report into a file or work area of your choosing.

  3. To save the results in a comma-delimited file (.CSV), click the Save button . The Save As dialog box will display, allowing you to name the file and select where you want to save it.

  4. To save and open the comma-delimited results file in an Excel spreadsheet, click the Save to Excel button . The results open in Excel, where you can modify it and save it in any format supported by your Excel filters.

Saving a New Symbol

Saving a new symbol is useful whenever you wish to categorize a newly created symbol or customize an existing symbol.

 

To save a symbol from the display to the symbol library, right-click on the symbol and select "copy." Then, right-click within the symbol pane and select "paste."   

 

The new symbol will now be visible within the Symbol Library tool and is available for viewing within the currently-opened category and in all future searches.

 

Note: If users wish to save a symbol category that is located on a network machine, they should copy the symbol category onto a local machine, save the category and copy the category with updated index files back onto the network machine.

 

Deleting a Symbol

Deleting a symbol allows you to delete any symbol from the library that is no longer needed or repetitive.

 

To delete a symbol from the library, right-click on the symbol within its containing category and select delete.

 

A Confirm Symbol Delete window will appear affirming you wish to delete the selected symbol. Select "Yes" to delete the symbol.

 

Edit Symbol Properties

Editing symbol properties can be used to update new symbols, alter symbol properties or utilize the Share Keyword function.

 

Symbol Properties Window

 

Note: If symbol properties are altered from their default settings, this will affect the symbol search results. For example, if a user changes the search terms of a specific symbol, these search terms will then be retained when conducting a search and will yield the altered symbol in addition to the symbols containing that search term by default.

 

Adding a New Category

You can create a new category to reorganize existing symbols or to contain an entirely new set of symbols. To add a category to the symbol library, right-click within the Symbols window and select "Add New Category", or press Ctrl+N on the keyboard. Selecting this will open the Category Property window.

 

New Category Properties Window

 

From here, fill out the following fields:

Select OK to create the new category. The new category will now be available from the drop-down category menu within the Symbol Library tool.

Edit Category Properties

The Category Properties window can also be used to modify an existing category. To open the Category Properties window, right-click within the Symbols window and select "Edit Category Properties", or press Ctrl+G on the keyboard. This will open the Category Properties window.

 

Category Properties Window

Return to Top

Symbol Library Menu Commands

The GraphWorX64 Symbols tab displays the symbol library's menu by clicking the symbols library icon or right-clicking a symbol on the tab.

Command

Function

View

Specifies the size (small, medium, or large) of the symbol icons in the Symbols Library.

Open Existing Category

Enables you to browse for and select an existing symbol category file.

Add New Category

Opens the Category Properties dialog box, which allows you to create a new symbol category file. For more information, see Creating a New Category for Symbols.

Save Selected Category

Saves changes made to the current category.

Save Selected Category As

Makes a copy of the current category under a different name.

Remove Selected Category

Removes the selected symbol category from the list of available categories.

Edit Categories List

Opens the Edit File List dialog box, which allows you to add or remove symbol categories; to use this dialog, refer to the Edit File List Dialog Box topic.

Export > Export as Smart Tile Template Library

If a category contains smart tiles, you can save the set of symbols as a template library to reduce smart tile configuration time when creating similar symbols later.

Undo

Reverses the last editing action.

Undo To

Reverses multiple editing actions.

Redo

Restores the last editing action that was undone.

Redo To

Restores multiple editing actions that were undone.

Cut

Removes the selected symbol from the category and keeps a temporary copy available for pasting in a different category or in the display.

Copy

Copies the selected symbol.

Paste

Pastes a symbol into the currently loaded category.

Delete

Deletes the selected symbol from the category.

Find

Opens the Find dialog box (used for advanced symbol searches). Enter a string to search for in the Find What field.

Replace

The Replace operation works in a similar way and replaces the Find What string(s) with the Replace With string(s). This command can be used for advanced symbol searches. All dialog options are the same, except that the Replace dialog box has a field called Replace With.

Edit Category Properties

Opens the Category Properties dialog box, which allows editing the symbol category properties. For more information, see Edit a Smart Symbol Properties.

Edit Symbol Properties

Opens the Symbol Properties dialog box, which allows editing the symbol search terms and other properties.

 

See also:

Smart Symbol Basics

Smart Symbols Quick Start

Using the Symbols Library