{"id":72771,"date":"2016-07-07T12:25:34","date_gmt":"2016-07-07T12:25:34","guid":{"rendered":"http:\/\/www.esri.com\/arcgis-blog\/products\/product\/uncategorized\/working-with-mil-std-2525d-symbology-using-quartz-runtime\/"},"modified":"2018-03-26T21:09:34","modified_gmt":"2018-03-26T21:09:34","slug":"working-with-mil-std-2525d-symbology-using-quartz-runtime","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/defense\/defense\/working-with-mil-std-2525d-symbology-using-quartz-runtime","title":{"rendered":"Working with MIL-STD-2525D Symbology using Quartz Runtime"},"author":3731,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[24641,23261],"tags":[30201,24621,24631,28311],"industry":[],"product":[36921,42661,36601],"class_list":["post-72771","blog","type-blog","status-publish","format-standard","hentry","category-defense","category-field-mobility","tag-arcgis-for-defense","tag-qml","tag-qt","tag-qt-sdk","product-api-cqt","product-arcgis-solutions","product-developers"],"acf":{"short_description":"Introduction\n\nA few weeks ago, Esri released Quartz beta's for all of the ArcGIS Runtime SDKs. If you are an ArcGIS Runtime SDK developer...","flexible_content":[{"acf_fc_layout":"content","content":"

Introduction<\/span><\/p>\n

A few weeks ago, Esri released Quartz beta’s for all of the ArcGIS Runtime SDKs<\/a>. If you are an ArcGIS Runtime SDK developer, we hope you have had some time to dive in and investigate the new Quartz features and provide feedback to the development teams. We invite you to continue collaborating with us. So far, we have received a wealth of excellent feedback and great catches, so please keep them coming.<\/p>\n

We know that many of you have been waiting anxiously for Quartz’s support for displaying your data using military symbology. The purpose of this blog is to introduce how it all works and to help you get started working with military symbology.<\/p>\n

For those of you that used military symbology in pre-Quartz versions of ArcGIS Runtime. Heads up! These concepts now apply to both Graphics and Features. Military symbology can be used for rendering points, lines and polygons in either a GraphicOverlay<\/a> or a FeatureLayer. This is different from pre-Quartz versions of Runtime, where military symbology could only be displayed as Graphics.<\/p>\n

The Symbol Dictionary<\/span><\/p>\n

Let’s begin by looking at the SymbolDictionary class.\u00a0A\u00a0SymbolDictionary<\/a>\u00a0makes use of what is known as \u00a0a\u00a0*.stylx<\/code>\u00a0file. The stylx file contains the symbol primitives for a given symbology specification (such as MIL-STD-2525D), as well as a rule engine that parses input fields from the dictionary. New symbols from the input attributes are assembled based on the attributes of the Feature or Graphic and prepared for rendering. The stylx file is\u00a0in the form of a binary SQLite database, created from ArcGIS Pro.<\/p>\n

The\u00a0SymbolDictionary\u00a0constructor takes a given specification, such as “mil2525d”. Each specification depends on attribute names that define the symbology and text of each feature. For example, the MIL-STD-2525D specification looks for attributes named “identity”, “symbolset”, “symbolentity”, and “modifier1”, among many others. These attributes are used to select different symbol primitives in the style file that are assembled to create a unique symbol.<\/p>\n

In the current Beta releases for Java and Qt, we provide a pre-built stylx file for you in the SDK. It only contains the specification for MIL-STD-2525D. Other military specs are coming in the Final release, scheduled for November, including MIL-STD-2525B and C.\u00a0You may be asking yourself, “I wonder if I can create one of these from scratch in Pro, then use it straight away to display my own custom symbology.<\/em>“. Well, not quite yet, but\u00a0the long-term plan is to provide this capability, as well as the capability to modify and use existing symbol dictionaries.<\/p>\n

The Dictionary Renderer<\/span><\/p>\n

The companion class to our SymbolDictionary is the DictionaryRenderer. Working together, these two classes make things happen! The DictionaryRenderer<\/a> class is responsible for the actual visualization of the symbols on the map from the symbol dictionary we just talked about. DictionaryRenderer\u00a0uses the attributes from the symbol dictionary to display unique multi-layer symbols based on those attributes.<\/p>\n

In order to display features using the\u00a0DictionaryRenderer, you must make sure the\u00a0DictionaryRenderer\u00a0and associated\u00a0SymbolDictionary\u00a0know which attributes in your data to use. This can be achieved in multiple ways:<\/p>\n