Documentation

JSON export

You can use the JSON format to export your animation project from TVPaint Animation to After Effects. This type of export allows you to keep your project the way it was in TVPaint Animation, with all the layers, and to keep working on it in After Effects.

Click on File > Export to… which will open the export window. The JSON export will be found in the Clip : Layers structure tab, Structure drop down menu > JSON (.json + images).



You can check the Export All Images option to export all of your instances (exposure cells and empty images will then be exported as well).

Visible Layers: if you check this option, only the layers that are visible in your TVPaint Animation project will be exported. If it is not checked, all the layers will be exported.

The Write JSON file option will let you choose if you want a .json file to be created as well or not.

Folder Pattern: sets the pattern of the folder name that will be exported. The folder name will be computed from the defined pattern by replacing the following special characters:

%[[0|]number]pfn: project (file) name
%[[0|]number]cn: clip name
%[[0|]number]li: layer index
%[[0|number]ln: layer name
%[[0|]number]di: folder number (to have an incremental number)





File Pattern: sets the pattern of the file name. The file name will be computed from the defined pattern by replacing the following special characters:


_%[[0|]number]pfn: project (file) name
_%[[0|]number]cn: clip name
_%[[0| ]number]li: layer index
_%[[0| ]number]ln: layer name
_%[[0| ]number]di: folder number (see folder pattern)
_%[[0| ]number]ii: instance index
_%[[0| ]number]in: instance name
_%[[0| ]number]fi: file number (to have an incremental number)




Exclude Names: sets the instances names which won’t be exported. If you want to exclude multiple names, separate them with [;].

Format: you can select the format of your images for the exported footage.
You will get different types of options depending on the format you choose.

It is also possible for you to change your images’ dimensions while exporting using the Convert to section’s parameters.

Background: if this option is checked, the background will be exported in every instance.

Ignore Duplicate Images: select this option when you don’t want duplicated images to be exported.

Finally, you can choose to create a folder for each layer by checking the Create folder for layers option.

Before exporting, create a folder in which all the export files will be sent and set it as your destination in Browse (the export doesn’t create a folder.)

Once you’ve launched After Effects, you need to fetch the script allowing you to import your sequence.

macOS users: if you’re using an earlier macOS version than Big Sur, the import script will only work when launched from After Effects’ default workspace. You can switch to a different workspace after the import has been made.

Go to File > Scripts > Run Script File. In the window that appears, choose AfterEffects Import TVPaint JSON.jsx script.
The script is located in the installation folder of TVPaint Animation 11.

You can also download the script here.

The script generates an Import TVPaint window where you can change the settings of the import.




You can choose to import or not the camera, if there is a camera in your project. If you check Import Camera, there are two other options you need to choose from: As Key values and As Raw values.
As Key values: imports the camera with its different movement keys in the timeline.
As Raw values: imports the camera without the keys, creating one key for each image, making the timing of the camera no longer editable.

Layer Colors and Blending Modes import all the colors and blending modes of your layers.

Time Remap retrieves your animations’ timings so that instances are displayed in After Effect’s timeline the same way they are displayed in TVPaint’s timeline. Unchecking this option allows you to import your project’s images only.

Pre/Post Behaviours imports the behaviours you’ve set in your different layers.

After Effects doesn’t have the same variety of pre/post behaviours. Depending on your choices of behaviours, you might have odd results in the import.

Sequence Sorting for Time Remap: you can choose to import the names of your images in the timeline (especially useful for Japanese animation).

Index imports the default name of your images and Name imports the name you gave to your images.



If you choose to import your images’ names while the Time Remap option is selected, the images’ order in After Effect’s timeline will be the same than in your TVPaint project. However, they will keep their names and will be sorted accordingly in the composition sequences.
The names are sorted first by numbers (0-9), then letters (A-Z), and finally symbols. Those names are converted in numbers in After Effects and are sorted in numerical order.



IndexNames

You can finally click on Browse and fetch the .json file previously generated after the export in your project folder.
Your sequence is imported and you can edit it in After Effects.