Back to the Main Page → Back to Motive Documentation → Back to Assets → Back to Skeleton Tracking page
This page includes detailed step-by-step instructions on customizing the skeleton XML files.
In order to customize the skeleton marker labels, colors, and sticks, a skeleton XML file needs be exported from an existing skeleton, customized, and loaded onto the skeleton of the same markerset. For example, if you exported a Baseline (41) skeleton and modified the labeling XML file, same Baseline (41) 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 Skeleton Pane, and create a skeleton. You can also export a skeleton XML from an existing skeleton asset.
b) Right-click on a skeleton asset in the Project 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.
a) To customize the Marker Colors and Sticks, open the exported XML file using a text editor and scroll down to the Markers and MarkerSticks section. If the Markers and MarkerSticks section does not exist in the exported XML file, you could be using an old skeleton created before Motive 1.10. Updating and exporting old skeleton will provide these sections in the XML.
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 instances of the XML.
Now that you have customized the XML file, it can be loaded each time when creating new skeletons. In the Skeleton Pane, 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.
If you manually added extra markers to a skeleton, you must rename the skeleton after creating it. See more at the Added Markers section.
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 automatically logged. 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 the skeleton 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.
Applying Customized XML with Added Markers
1) Motive: Skeleton pane Create the skeleton using the markers without including the extra markers.
2) Motive: Perspective View pane Add the extra markers onto the selected skeleton asset. See how to add markers.
3) Motive: Project pane: Select the skeleton and click Rename Markers to import the customized skeleton XML template.
4) Motive: Project pane: When working with a recorded Take, first delete the existing marker labels using the Delete Marker Labels from the Project pane, and auto-label the Take to label the markers using the imported XML file.