Applies to Matrix key projects
Key options are set using the Key > Key Options menu. These options allow you to specify aspects of the behaviour of your key when opened in the Lucid Player. In most cases, the key user can change these settings when using the player. For more information, consult the Lucid Player Help.
The Key option dialog has a number of options accessible via the tabs on the left. Select the desired tab option to view the options available.
The default options settings should cover most types of keys when opened in the Player. You should understand and carefully consider the implications of changing any of these settings.
Key Options
The Key options allow you to adjust the default operational settings the Lucid Player will use when it opens the key.
Matching Options
In the Lucid Player, Matching Options determine the way in which two special scores, Present by Misinterpretation and Uncertain are handled. See the Player Help for more information.
Allow Misinterpretations
With Allow Misinterpretations checked, the Player will be set to treat entities scored using By Misinterpretation scores in the same way as ones scored using Common and Rare. This is the correct behaviour for normal identification as it allows you to pre-empt likely mistakes made by a user.
With Allow Misinterpretations unchecked, the Player will be set to treat entities scored using the By Misinterpretation scores in the same way as ones scored as Absent.
See the topic Present by misinterpretation for more information.
Retain uncertains
With Retain Uncertains checked, the Player will be set to treat entities scored as Uncertain for a feature in the same way as ones scored as Common. This is the correct behaviour for normal identification.
With Retain Uncertains unchecked, the Player will be set to treat entities scored as Uncertain for a feature in the same way as ones scored as Absent.
See the topic Uncertain for more information.
Sort Mode
In the Lucid Player, the Sorting Mode determines the way in which entities that do not match the selected features are handled. See the Player Help for more information.
Filtered
With Sort Mode set to Filtered, entities that do not match the currently chosen features will be removed from Entities Remaining into Entities Discarded. This is the most common mode for using the key.
Ranked
With Sort Mode set to Ranked, the Entities Discarded panel is removed and all entities remain in Entities Remaining throughout the key session. Entities are prefixed with a percentage value showing the proportion of chosen features that match the entity; the entities list is ranked by this value.
Matching Mode
In the Lucid Player, the Matching Mode determines the way in which the selection of one or more states of a feature results in entities being retained or discarded. See the Player Help for more information.
Any State
With Any State checked, the Player will be set to use the Any State match method. Under this method, an entity scored for several states of a feature will be retained in Entities Remaining if any of its scored states is selected. This is the default mode for normal identifications.
For instance, if a key has a feature Flower colour with states white, cream, yellow, red, and blue, and a user selects white and cream, Entities Remaining will list all entities with white or cream flowers.
All States
With All States checked, the Player will be set to use the All States match method. Under this method, an entity scored for several states of a feature will be retained in Entities Remaining only if all its scored states are selected.
For instance, if a key has a feature Flower colour with states white, cream, yellow, red, and blue, and a user selects white and cream, Entities Remaining will list only entities scored for both (and only) white and cream flowers.
Automation Options
In the Lucid3 Player, two functions Best and Prune Redundants can be automated so they are invoked after each state is selected. See the Player Help for more information.
Auto Best
Check Auto Best to set the Player to invoke the Best function automatically after each state is selected.
Auto Prune
Check Auto Prune to set the Player to invoke the Prune Redundants function automatically after each state is selected.
Display Options
The Display options allow you to set how the Player interface and key should look when opened in the Lucid Player.
Features
Tree View
Check Tree View to set the Player to show the Features in Tree View (hierarchical view) mode. Selecting this option will automatically toggle off the List View, if selected.
List View
Check List View to set the Player to show Features in List View (flat list view) mode. Selecting this option will automatically toggle off the Tree View, if selected.
Feature Thumbnails
Check Feature Thumbnails to show thumbnail images in the keys Features.
Feature Gallery
Check Feature Gallery to show feature states in a gallery view rather than the vertical view.
Expand Top Level Nodes
Select Expand Top Level Nodes to open each of the top (root) level Features listed in the key when opened by the Player.
Note
This option will be ignored if the Features are set to List View.
Entities
Tree View
Check Tree View to set the Player to show the Entities in Tree View (hierarchical view) mode. Selecting this option will automatically toggle off the List View, if selected.
List View
Check List View to set the Player to show Entities in List View (flat list view) mode. Selecting this option will automatically toggle off the Tree View, if selected.
Image View
Check Image View to select the Entities remaining image gallery as the default Entities view in the Player for the key.
Entity Thumbnails
Check Entity Thumbnails to set the Player to show default Entity thumbnails in either Tree View or List View.
Expand Top Level Nodes
Select Expand Top Level Nodes to open each of the top (root) level Entities listed in the key when opened by the Player.
Note
This option will be ignored if the Entities are set to List View.
Language
Locale
The local drop down box displays the available Player language files available. Additional language files can be created via the Lucid Builder and will be automatically listed here. For more information on creating language files see Multilingual Support.
Note
Certain languages, including eastern Asian languages such as Japanese, Chinese, and Thai, require specific font's to be able to display the extended character sets. If you are translating interface strings, or deploying a key using these languages, please add the font to the Lucid Player deployment folder (or an on-line source. E.g. Google Fonts.) and make a style sheet reference in the player container HTML file.
Media Options
Media options determine the default settings for media when added to the key via the Builder.
Thumbnails
Max. Dimension (px)
The maximum height and/or width the thumbnail will be created to. See the ‘Aspect Fit’ option below for additional details that effect the thumbnail creation.
Aspect Fit
If checked (default), then the thumbnail will be created keeping its aspect ratio within the maximum dimension set. This stops the thumbnail from being distorted when fitting (size) to the maximum dimension.
Media Panel
Display Image Thumbnails
If checked, thumbnail images, rather than the filename will be displayed within the Builder’s Media Panel.
Defaults
Image Caption
The Image Caption allows you to set a default caption for images. The default caption will be applied within the Media Panel caption text box when the image is first attached. You can override the default caption by replacing it with your preferred caption text.
Image Copyright
The Image Copyright option allows you to set a default copyright label to images. You can override the default copyright label by replacing it with your preferred copyright text within the Media Panel.
HTML Caption
The HTML Caption allows you to set a default caption for HTML pages attached to the key. The default HTML caption text will be applied within the Media Panel caption text box when the HTML file is first attached. You can override the default caption by replacing it with your preferred caption text.
Item Name as Caption
If the Item Name as Caption is checked then the default caption for an attached image or HTML file will be the label text of the selected item (e.g. Feature, Feature State or Entity). You can override the default caption by replacing it with your preferred caption text within the Media Panel.
Descriptions Panel
Entity Descriptions
Output Template
The Output Template option allows you to save your preferred template for customising the keys description structure. The output template is an XML based file with a ‘.xml’ file extension.
Transformation File
The Transformation Template option allows you to save your preferred template for transforming the XML based key data to “human” readable format. The transformation template file is an XSL based file with a ‘.xsl’ file extension.