The Item Palette

The Item Palette is used to place icons and text onto Control Panel Editor panels. The palette is a tabbed window with tabs for each item type. The common method all items use to add an item to a panel is "Drag and Drop". Each tab has a bordered Preview panel containing a labeled Drag to Panel panel. Drag the item inside this border over to your Panel. In the cases where the icon represents a layout device (e.g. a turnout, a sensor, etc.), tab may also contain a table of elements configured for that device type. select a row from a table to associate that particular device with the icon - and then drag the icon to the Panel.

The window shown when the Edit XYZ menu item of a panel item is invoked shows the corresponding Item Palette tab pane without the labeled Drag to Panel panel.

Iconic Items

Some device types need a set of icons to depict each of their states The Item Palette provides multiple sets of icons to choose from to associate with a device. There is a radio button for each icon set defined for the tab item. For example, under the sensor tab you may have sets of large jewels, small jewels, each size with several sets with different colors for active and inactive - e.g. red-green, yellow-dark, etc.

The individual icons are displayed in the preview on the background of the last editor to open the Item Palette. since 4.9.7 Choosing a different background in the "View On:" combo box, may help in determining what parts of the icon are opaque and what parts are transparent.

Editing and Creating New Icon Sets

When the Item Palette is customized by editing icon sets or by adding of deleting sets, exiting PanelPro will open a dialog box asking whether you want to save your changes. When changes are saved the Item Palette is stored in the CatalogTrees.xml file in the preferences directory.

Table Items

The items associated with a table (eg. Turnouts, Sensors, Lights, Signal Heads) have a pick list of their items displayed. Under the table is a Add New Table Item button. This button opens the corresponding device table from the Tools menu for you to create a new device item.
Tabs with tables require a device to be selected (a row in the table) before the an icon can be dragged to a control panel to represent it.

Special Cases

Since 4.21
Should all of the icon sets of a device type be deleted, a Restore Defaults button is displayed. This button reinstalls the default icons listed in the file, JMRI/xml/defaultPanelIcons.xml. Holding the keys Ctrl and A down while clicking the New Icon Set button will reinstall any missing default icon sets for that tab.

Previously, the Indicator Turnout tab had additional buttons to add and delete status icons when the Edit Icons button was pressed. Now these buttons are displayed only if the keys Ctrl and A are held down while clicking Edit Icons.

Item Palette Tabs

More about Indicator Track

Indicator track (i.e. both track segments and turnouts) have colors to display status of the track circuit they represent. When the track circuit is configured by an OBlock, and the Portals and Paths it contains, the following status states are be displayed by color:

Indicator Track Tab

Enter the name of the track circuit (OBlock) this track icon represents into the Occupancy Circuit field. The Open Detector Picklist button opens a picklist showing the defined OBlock track circuits. Drag or copy the name to the Occupancy Circuit field. Do Not use the "Sensor Table" tab of the picklist unless there are no OBlocks configured and you only want to use the "Occupied/Unoccupied" status.

When a valid OBlock name is entered in the Occupancy Circuit field and the icon dragged and dropped onto the panel, after selectiing it a CircuitPath panel is added to the tab showing all the paths that have been defined for the OBlock. Check the paths of the track circuit that pass over this icon. When these paths are part of an allocated route or are occupied by a warranted train, they show that status by color.

Below the Occupancy Circuit field is a checkbox labeled Display Train Name when occupied. When a warranted train occupies the track circuit, circuit icons having this box checked, show a marker with the occupying train's id. Most likely, you will only want one of the icons in the track circuit to display the train id.

Indicator Turnout Tab

This tab has the same functions as the Indicator Track tab with the addition of a turnout table. A turnout must be selected from the Turnout Table to be able to drag an icon to a control panel.

The [Show Icons] button displays the icon set in a matrix where the rows show the status icons for each state of the turnout - Closed, Thrown, Inconsistent, and Unknown.

When an Edit Icons window is displayed all icons are shown, Icons from the Icon Catalog may be dragged and dropped to any icon shown.