Specifications on t...
 
Notifications
Clear all

Specifications on the TIM File XML

13 Posts
4 Users
0 Reactions
6,280 Views
Posts: 5
Topic starter
(@thewball)
Active Member
Joined: 5 years ago
[#56184]

Hello!

I am looking into developing a companion program for Vixen 3 that takes .TIM files as an input. Are there any specification on what the file contains and how things should be formatted? It looks like an XML file with sections for media, effects, marks, and values of row settings. Can someone point me in the right direction of what all of the xml tags are and how things are formatted with the keys? Specifically I am looking for the way the times are formatted. Assuming it is Prefixed with PT and the min and second marks follow.

Thanks for the help!!


12 Replies
jchuchla
Posts: 8698
(@jchuchla)
Illustrious Member
Joined: 15 years ago

I may be phrasing this the wrong way, but we don't actually have a spec for the file format. The contents of the file are determined by the modules that contribute to it. Each module is responsible for its own data objects, and those are all serialized out to the XML file. So the format of each specific object is defined by the module that created it.

We generally don't recommend interacting with the data in these files from outside the software itself.

What specifically are you looking to accomplish? There's probably a better way to go about it than directly interacting with the tim file.


Reply
Posts: 5
Topic starter
(@thewball)
Active Member
Joined: 5 years ago

Thank you so much for the reply, Jon!

I am looking into creating an interface for MIDI 'recording' into a TIM file, so basically 'Live Recording' on/off timestamps with the MIDI format and then parsing that into the XML Vixen can understand.

I saw there was an epic for it, but looks like it is stagnant and my C# just isn't there to be a meaningful contributor, unless you would like some unprofessional code. My thoughts were to create a 'converter' using something like Python that would take in a midi file and output the XML.

Do you have any suggestions on other ways I could accomplish this/

Here is the ticket:
https://vixenlights.atlassian.net/browse/VIX-428

Thanks so much!


Reply
Posts: 5
Topic starter
(@thewball)
Active Member
Joined: 5 years ago

Thank you for the reply!
I am not sure if my replies are sticking here, but I am looking to basically make a companion program using Python to take the on/off/pitch of specific notes in midi files and map them to effects and record those as a export that as a .tim file. I know there was an epic to the midi integration, but unfortunately my C# is virtually non-existent and I would have a hard time contributing in a best practice or meaningful way code wise.

Do you have any suggestions on how to go about this or make the recording/sequencing process quicker?
Thank you!


Reply
jchuchla
Posts: 8698
(@jchuchla)
Illustrious Member
Joined: 15 years ago

Can you outline a sample mapping? What effect type would you want it to create? What would the note number correspond with in vixen? What would the intensity correspond with? etc?

Perhaps an easier option would be to leverage the vixen mark system. Import is already supported there in various formats. The audacity format is probably the most universal/flexible. marks have a start time, and optionally have a duration and label. Start and duration sound like an obvious mapping. Note number could be the label. Here's a link to the audacity label format.
https://manual.audacityteam.org/man/importing_and_exporting_labels.html


Reply
Page 1 / 3
Share: