our previous tutorial<\/a> where we explain how to use them in detail.<\/p>\nThe LOOP_COUNT user variable should now appear inside the right panel of the script editor. The Loop Count<\/em> property of the Sequence Loop Marker accepts a number starting from 1; if the user enters 0, we will set the property to infinite.<\/p>\n\n![\"01](\"https:\/\/blog.criware.com\/wp-content\/uploads\/2024\/03\/01-User-Variable.png\")
<\/p>\n
Scripting<\/h1>\n
Since we want to create the Loop Marker based on a Waveform Region, we need to retrieve information about the selected Waveform, determine the Material it references, and find out the Cue it is associated with.<\/p>\n
\n- We use get_selected_objects<\/em> to retrieve the ID of the selected Waveform Region.<\/li>\n
- Then, the get_parent<\/em> function is called to get the Cue to which the Waveform Region belongs.<\/li>\n
- To get the Material, we simply use the get_value<\/em> function on the LinkMaterial<\/em> property of the Waveform Region.<\/li>\n<\/ul>\n
# Get selected Waveform Regions\r\nselected_waveforms = acproject.get_selected_objects(\"WaveformRegion\")[\"data\"]\r\nif<\/strong> not<\/strong> selected_waveforms:\r\n\tacdebug.warning(\"Please select a Waveform Region\")\r\n\tsys.exit()\r\n\r\n# Get the Cue in which the Waveform Region is located\r\ncue = acproject.get_parent(selected_waveforms[0], \"Cue\")[\"data\"]\r\n\r\n# Get the Material referenced by the Waveform Region\r\nmaterial = acproject.get_value(selected_waveforms[0], \"LinkMaterial\")[\"data\"]\r\n<\/code><\/pre>\nTo retrieve the start and end times of the selected Waveform Region:<\/p>\n
\n- We call get_value<\/em> on the DelayTimeMS<\/em> property to know where the Waveform is starting in the Cue.<\/li>\n
- For the end time, we need to look at the Material associated with the Waveform. Based on the sample rate and the number of samples used by the Material, we can easily calculate the duration in milliseconds. This value is then added to the start time of the waveform to get the precise time at which it ends in the Cue.<\/li>\n<\/ul>\n
# Get the start time of the Waveform Region in the Sequence\r\nwaveform_start = acproject.get_value(selected_waveforms[0], \"DelayTimeMS\")[\"data\"]\r\n\r\n# Get the length of the Waveform Region by calculating the duration of the Material\r\nmaterial_sample_rate = acproject.get_value(material, \"SamplingRate\")[\"data\"]\r\nmaterial_samples = acproject.get_value(material, \"SampleFrames\")[\"data\"]\r\nmaterial_duration = (1000 * float(material_samples)) \/ float(material_sample_rate)\r\n\r\n# Calculate the end time in ms of the Waveform Region in the Sequence\r\nwaveform_end = (float(waveform_start) + material_duration)\r\n<\/code><\/pre>\nWe now have all the required information to create the Sequence Loop Marker:<\/p>\n
\n- Create the Loop Marker at the Cue level by using the create_object<\/em> function.<\/li>\n
- Test if the InfinityLoopFlag<\/em> property must be set to True<\/em> (when the LOOP_COUNT User Variable is lesser than 1). Otherwise, use the number stored in LOOP_COUNT to set the value of the LoopCount<\/em> property.<\/li>\n
- Finally use the waveform_end and waveform_start variables to set the MarkerEndTime and MarkerStartTime properties, respectively.<\/li>\n<\/ul>\n
# Create the Sequence Loop Marker\r\nmarker = acproject.create_object(cue, \"LoopMarker\", \"My Loop\")[\"data\"]\r\n\r\n# Set the number of loops, loop start, and loop end\r\nif<\/strong> LOOP_COUNT < 1:\r\n\tacproject.set_value(marker, \"InfinityLoopFlag\", \"True\")\r\nelse<\/strong>:\r\n\tacproject.set_value(marker, \"LoopCount\", LOOP_COUNT)\r\nacproject.set_value(marker, \"MarkerEndTime\", waveform_end)\r\nacproject.set_value(marker, \"MarkerStartTime\", waveform_start)\r\n<\/code><\/pre>\nThis is all we need! You can download the full script below and test it. Simply select a Waveform Region in a Cue, and run the script. A Sequence Loop Marker matching the length of the Waveform will be automatically created.<\/p>\n
\n
![\"zip\"](\"https:\/\/blog.criware.com\/wp-content\/uploads\/2018\/06\/zip.png\")
Script_RobotAPI_CreateLoopMarker<\/a>\n<\/div>\n","protected":false},"excerpt":{"rendered":"There are several ways to loop audio content in Atom Craft. At the Material level, you can either keep the<\/p>\n","protected":false},"author":2,"featured_media":5306,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"colormag_page_container_layout":"default_layout","colormag_page_sidebar_layout":"default_layout","footnotes":""},"categories":[5,7],"tags":[],"class_list":["post-5281","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-adx","category-tutorials"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/posts\/5281","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/comments?post=5281"}],"version-history":[{"count":18,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/posts\/5281\/revisions"}],"predecessor-version":[{"id":5568,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/posts\/5281\/revisions\/5568"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/media\/5306"}],"wp:attachment":[{"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/media?parent=5281"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/categories?post=5281"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/tags?post=5281"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}