A Blender 4.0.2 add-on. Provides the ability to convert the Blender frames to Project Diva timestamps.
Although the code is of my authorship, I need to thank ThisIsHH for exploring this sort of tool earlier. From what he achieved, I was able to re-work it and build on top of that.
This repo houses a Blender add-on designed to help Project Diva modders. The add-on automatically maps a frame number from Blender to a Diva Script timestamp. Diva Script or DSC as I'll use from now on, is the file extension for Project Diva scripts.
The current section will explain what the add-on has to offer.
Depending on the frame you're on, the main panel will display the current DSC timestamp.
Warning
The calculation is done based on the Blender scene current FPS. Different FPS will output different timestamps.
The second subpanel has 2 buttons. Click on the Copy Current DSC Time button to copy the current frame DSC timestamp.
You'll notice the video above shows a lot more on the clipboard than just the timestamp. The default output is something like this:
TIME(...) # This is where the DSC timestamp will be placed
CHANGE_FIELD(...) # This is a counter ranging from 1 to n (default value is 1)
MOVIE_DISP(1)
MOVIE_PLAY(1)
DATA_CAMERA(0, 1)If you don't feel like having all these commands, you might want to change the source code. More info here.
Need to export several frames? Using timeline markers, you can mark multiple frames. Then, click on Copy All Markers DSC Time button to convert and export them all.
If you are in dire need of extra output, you can explore the Extra Text subpanel. From there, you can add as many lines as you need. You can also remove some or all lines if not needed anymore. Keep in mind the new lines will be appended to the end of the default text, as a suffix.
If you're not feeling comfortable with the add-on output, you can change it and it's not that hard! On the dsc_time_exporter_main.py, look for this function:
def stringify_marker(dsc_time: int, i: int=1):
return f'TIME({dsc_time});\n' + \
f'CHANGE_FIELD({i});\n' + \
'MOVIE_DISP(1);\n' + \
'MOVIE_PLAY(1);\n' + \
'DATA_CAMERA(0, 1);\n'The dsc_time parameter is what you're looking for. Supposing you only want this, the new code should look like this:
def stringify_marker(dsc_time: int, i: int=1):
return f'{dsc_time}\n'Please, keep the \n so line breaks are applied!
I don't have any planed updates. However, if you feel like something could be changed, don't hesitate to create an issue! Feel free to also create a Pull Request in case you have an update yourself!