Main Page → Motive Documentation → Assets → Skeleton Tracking → Marker Name XML Files
This page includes detailed step-by-step instructions on customizing the marker name XML files for skeletons and MarkerSet assets.
In order to customize the skeleton marker labels, marker colors, and marker sticks, a Marker XML file needs be exported, customized, and loaded back in. For skeletons, modified Marker XML files can only be used with the same markerset template. In other words, if you exported a Baseline (41) skeleton and modified the labeling XML file, same Baseline (41) markerset needs to be created in order to import the customized XML file. The following section describes the steps for customizing skeleton XML templates.
a) First, choose a markerset from the Builder pane, and create a skeleton.
b) Right-click on a skeleton asset in the Assets pane, and select Export Markers.
c) In the export dialog window, select a directory to save the Marker Name Template (.xml) file. Click Save to export.
a) Open the exported XML file using a text editor. It will contain corresponding marker label information under the MarkerNameMap section.
b) Customize the marker labels from the XML file. Under the MakerNames section of the XML, modify labels for thename variables with the desired name, but do not change labels for oldName variables. The order of the markers should remain the same.
c) If you changed marker labels, the corresponding marker names must also be renamed within the Marker and MarkerSticks definitions as well. Otherwise, the marker colors and marker sticks will not be defined properly.
b) Here, you can customize the marker colors and the marker sticks. For each marker name, you must use exactly same marker labels that were defined by the MarkerNames section of the same XML file. If any marker label was changed in the MarkerNames section, the changed name must be reflected in the respective colors and sticks definitions as well. In other words, if a Custom_Name was assigned under name for a label in the MarkerNameMap section <Marker name="Custom_Name" oldName="Original_Name" />, the same Custom_Name must be used to rename all the respective marker names within Marker and MarkerSticks elements of the XML.
Now that you have customized the XML file, it can be loaded each time when creating new skeletons. In the Builder pane under skeleton creation options, select the corresponding markerset. Then, under the Marker Names drop down menu, choose (…) to browse to import the XML file. When you Create the skeleton, the custom marker labels, marker sticks, and marker labels will be applied. You will need to auto-label the take again if you are working on a recorded TAK file.
You can also apply customized XML into an existing skeleton using the renaming feature. Right-click on a skeleton asset in the Project pane and select the Rename Markers from the context menu, and this will bring up a dialog window for importing a skeleton XML template. Import the customized XML template and modified labels will be applied to the asset. This feature must also be used if extra markers were added to the default XML template.
In order to replace the existing labels with the modified labels, you will need to first delete the existing markers labels and auto-label the skeleton asset again with the renamed markers, or you can Reconstruct and Auto-label the entire Take again.
XML definitions can also be applied to added markers on a skeleton asset. When extra markers were added to a skeleton, its exported XML file will have the corresponding marker labels logged at the end of the MarkerNames section, and the labels for these markers can be customized from the exported XML file. The marker color and sticks definitions for extra markers will not be created automatically. To assign the marker colors and sticks for the extra markers, you will need to type additional instances which exactly copies the format that is used in other instances.
A newly created skeleton will not contain the added markers within the asset. To apply the customized XML for the extra markers, you must first create a skeleton of the same markerset and add the extra markers before importing the XML. When adding multiple markers, it is important that they are added in exactly the same order that it was added on the skeleton which was exported; Otherwise, the extra labels will be assigned incorrectly. After adding the corresponding markers, use the Rename Markers feature to apply the customized XML file. Lastly, auto-labeled the Take to assign the corresponding marker definitions onto the skeleton.