Differences

This shows you the differences between two versions of the page.

--- macros:function:timelines.importmarkersfromstring [2023/04/03 11:24] – icke_siegen
+++ macros:function:timelines.importmarkersfromstring [2023/04/04 06:41] (current) – external edit 127.0.0.1
@@ Line 21: / Line 21: @@
 **This article was written with massive help from Gregory Haynes; I couldn't have figured this out myself.**
-There is also the function [[https://api.avolites.com/16.0/api/Timelines.ImportMarkers.html|Timelines.ImportMarkers]], however that would expect an XML object as importMappingVersion while this fuction here parses a string which is much easier to handle.
+There is also the function [[https://api.avolites.com/16.0/api/Timelines.ImportMarkers.html|Timelines.ImportMarkers]], however that would expect an XML object as importMappingVersion while this function here parses a string which is much easier to handle.
 == Arguments ==
@@ Line 40: / Line 40: @@
 The smallest possible string as importMappingVersion is ''"&lt;Version /&gt;"'' which essentially is ''"<Version />"'' with the angled brackets written as entities (otherwise they'd be interpreted as XML which would break the macro XML)
-> There is also an XML file included with the personality library (e.g. ''C:\Program Files\Avolites\Titan\FixtureLibrary\MarkerImportMapping.xml'') which includes multiple options that can be selected in the UI in the context menu. There is also the provision for a similar file to be in the user fixture library directory.
+> Here is an example of what that string could be (single quotes used instead of double quotes to make it easier to use in a string):
-<file xml>
+''<Version id='1' name='2020' headerRow='true'><externalId name='#' index='0' /><legend name='Name' index='1' /><time name='Start' index='2' format=%%''%% /></Version>'' (again the angled brackets need to be written as entities ''&lt;'' and ''&gt;'' when using this).
-<MarkerImportMappings schemaVersion="1.0" xmlns="http://avolites.com/MakerImportMapping.xsd">
-  <MarkerImportMapping id="reaper" name="Reaper">
-    <Version id="1" name="2020" headerRow="true">
-      <externalId name="#" index="0" />
-      <legend name="Name" index="1" />
-      <time name="Start" index="2" format="h':'mm':'ss':'ff" />
-    </Version>
-  </MarkerImportMapping>
-</MarkerImportMappings>
-</file>
-> You should recognise the Version section as the bit being passed into the function. Perhaps if the string contained "Reaper", "Reaper:2020" or "reaper:1" it ought to be able to lookup the appropriate mapping from the library.
+  * **csvFilePath** is the absolute path (including filename) to the file which is to be imported, e.g. ''"C:\Users\{username}\Documents\Titan\Markers\test.csv"''.
+  * **frameRate** is the framerate to import. This is important to convert frame numbers with different framerates (not tested yet). The API lists [[https://api.avolites.com/16.0/api/Avolites.Acw.Titan.AcwFrameRate.html|AcwFrameRate]] as Enumeration:
+^ Value ^ Description |
+| Fps24 | 24 frames/sec |
+| Fps25 | 25 frames/sec |
+| Fps29DF | 29.97 frames/sec ('drop frame') |
+| Fps30	| 30 frames/sec |
+| Fps44	| internal timecode, 44 frames/sec |
+| Fps100 | Winamp and how it is displayed in the Cue View |
+| Fps60	| 60 frames/sec |
+| Fps1000 | Milliseconds |
+However it looks like you need to use [[macros:function:Timecode.ParseFrameRate|]] in order to convert the vaue into a proper framerate object, e.g. ''Timecode.ParseFrameRate(100)''.