What does it do ? It scans all of the visible layers in the current clip and stores the instances heads and image marks (and the instances names but it seems there is a little bug here).
When you load the panel, there are two buttons : "Sheet Key" and "Sheet Inbetweens". They were asked by a user in Japan. Their core functions are basically the same, but they do it differently. I will explain the differences later.
Let's concentrate on "Sheet Key"
So, let's show 2 examples.
Let's take this timeline : 9 layers, 3 of them are visible, 184 images.
When clicking on "Sheet Key", the script will scan the layers, then draw a table. This will be the result : The script produces a new project named Timesheet with the following dimensions : 3748 x 1324 (A3)
What do we have ?
At the top :
- A field named Title containing the project's name, and a field named Ep.no left blank (was requested by our Japanese user)
- A field named Cut.no, containing the characters between the first "_" and second "_" characters in the project's name (was requested by our Japanese user)
- A field named Duration, containing the duration, calculated like this : Integer division of total number of frames by the frame rate + the rest of the images.
- A field named Animator name, filled with the Author's name.
- A field named Page, indicating the current page of the Timesheet.
The main part :
We have two identical tables, organized as follows:
- In the first 7 columns, the name of the instances heads that have an image mark are circled in red. For now, it is only "0". Obivously, it's advised that the names of the instances should be numbers, and not words (otherwise it can't fit).
The exposures are reprensented by a black line.
Exposures having an image mark are reprensented by a black dot.
The first two characters of the layer name are on top.
- There is a column named Dialog where you can write informations about the dialog. The script does not fill this column.
- The column at the right is used by the "Sheet Inbetween" script. I will come back later to this.
- The last column, named Camera can be used to write informations about the camera. The script does not fill this column.
- You can see a red line : it represents the Mark Out value.
Here is the result in that case : (there are still 184 images)
- 16 layers and 72 images can be displayed (instead of 7 layers and 144 images).
- The Dialog column is near the Camera column.
Now, on to the "Inbetweens" part.
The goal of the Timesheet script is to compare the evolution between the moment when you draw the Key Animations, and the moment when you draw the Inbetweens. So, when you click on the Sheet Inbetween button, here's what will happen :
- The script will look in the currently opened projects for a project named Timesheet (remember, it's the project created by the Sheet Key). If it is found, then it will scan the current visible layers for the instances heads and the image marks and switch to the Timesheet project, then fill the "Inbetweens" part of the Timesheet.
- If the Timesheet project isn't loaded in TVPaint Animation, the script will warn you, and open a File Requester. You will need to look for the project in your computer, and the script will load it, and perform the same operations as described before.
Update, 17/05/2016 :
- The "Animator Name" part is now filled with the project's author name (Project tab > Author)
- Post-behavior is now reflected :
- If it is "Ping-pong", then "RETURN" will be written at the end.
- If "Loop", then "REPEAT".
- If "None", there will be a red cross at the end.
- If "Hold", then there will a red line.
- The table is more 'readable' : each 6 lines, there is a thicker line, and each 24 lines an even more thicker one (the Timesheet is designed to work with projects that are on 24 frames per second).
- The project created by the script is now named OriginalProjectName_ts. Hence, when using the Inbetweens button, the script will look for a project named OriginalProjectName_ts instead of just "Timesheet" (if such project isn't found, it still opens a File Requester)
- All of the bugs mentionned before have been fixed, and the script should be faster than before.
Have fun !
(and don't forget to report any bugs you will find !)