help.TixlChanges

Important Changes from Tooll3 to Tixl 4

Tixl is almost a complete rewrite, so many features now work fundamentally differently than in Tooll3. This page walks you through the most important changes:

• Project Handling
• User Settings
• Resources

Project Handling

In Tooll3, your user data and operators were intermixed with the editor files. This made upgrading the editor a real headache, because you had to migrate your projects into the new version.

With Tixl, this has changed completely: your projects are now gathered in a dedicated project folder. By default, this is your Documents folder, e.g.:

C:/Users/YourName/Documents/TiXL/

You can adjust this path in the settings menu: TiXL → Settings → Project Settings

Structure of a Project Folder

In most cases, you probably won’t need to worry about this — but if you’re curious, a typical project folder looks like this:

• MyProject/ – The root folder

  • bin/ – Compiled output; regenerated on each startup

  • obj/ – Intermediate build files; also regenerated

  • dependencies/ – Optional folder for large binary assets, DLLs, and drivers required to export your project as an executable

  • Resources/ – Place all images, videos, shaders, soundtracks, etc. here

    • images/ – Optional subfolder to group your images

      • myImage.png – An actual resource file

  • ProjectX.csproj – Project definition file

  • ProjectX.cs – Your project’s C# operators

  • ProjectX.t3 – Operator definitions (inputs, outputs, ops, connections)

  • ProjectX.t3ui – UI layout and metadata (comments, annotations, layout)

Resource Paths

There are three types of resource paths:

1. Relative to your project — e.g. images/myImage.png
2. Cross-project reference — e.g. /t3/images/frog3.jpg (note the leading /t3/ to specify the source project)
3. Absolute paths — e.g. C:/somewhere/something.jpg

Although absolute paths are supported when entered manually, we strongly recommend using your project’s Resources/ folder. It makes exporting and project management easier and ensures that your assets are included in backups.

File Picking

As of v4.0.2, TiXL’s file browser is still a proof-of-concept. A more advanced version is in development.

When clicking a filepath field in a parameter, TiXL will list all available resources, grouped by project. You can search by filename or path to filter the list: