| Scripting Resources for DigitalMicrograph™ |
Example: Traversing Persistent Tag Group |
|
Function |
Shows how to navigate through the persistent tag group to locate the tag group names, where the taggroup name is known |
Version |
version:20091003, v1.0 |
Author |
D. R. G. Mitchell |
Acknowledgements |
- |
Comments |
The persistent tag group contains the information displayed in tags window (File/Global Info). This information is non-volatile, and will persist after the script has finished or DM has been shut down. This makes it the ideal way to save information such as preferences and settings. Furthermore, it is easy to save tag groups in a settings file, to subsequently update the persistent tags, or for transfer to another PC - for example as a settings file to load preferences with a script. See the example script Taggroup Creation-Adding-Saving to Global Info. |
System Requirements |
Should be compatible with all recent versions of DigitalMicrograph. |
Known Issues |
- |
Supported |
Yes |
Included Files |
Main script file. |
Source Code |
// Example to show how to access the titles of a series of existing tags // In this case the tags are listed as // DiffTools // Camera Lengths // 1.2cm, value // 1.5cm, value etc
// D. R. G. Mitchell, Oct 2009 // version:20091003, v1.0 // adminnospam@dmscripting.com (remove the nospam to make this email address work)
// Get the persistent tag group
taggroup ptags=getpersistenttaggroup()
// Get the target taggroup
taggroup difftags ptags.taggroupgettagastaggroup("DiffTools:Camera Lengths",difftags)
// Cound the number of tags within it
number tagcount=difftags.taggroupcounttags()
number i string tagstring
// Access the titles of the tags for(i=0;i<tagcount; i++) { getnthpersistentnotetitle("DiffTools:Camera Lengths",i,tagstring) result("\n"+tagstring) }
// Access the values stored in each tag
number tagval
for(i=0;i<tagcount;i++) { getnthpersistentnotetitle("DiffTools:Camera Lengths",i,tagstring)
string fulltagpath="DiffTools:Camera Lengths:"+tagstring
getpersistentnumbernote(fulltagpath,tagval) result("\n"+tagstring+" : "+tagval)
}
|