Projects Compatibility

Wrap project file is a simple text file in JSON format. It uses it’s own versioning to mark changes between formats. It’s noted in formatVersion number value in a project file. A single project format version may be shared by several Wrap releases, though for the time being the majority raises it.

{
    "formatVersion": 64,
    "nodes": {
        "LoadGeom": {...},
        "LoadImage": {...}
    },
    "commonDir": "",
    "pythonCode": "",
    "timeline": {...}
}

Loading Projects Troubleshooting

Wrap supports all projects created in previous versions. After detecting the project’s format version, it performs a sequential chain of conversions to update it. However, if errors occur, you may first consult the examples below.

The project was created in a newer version

Wrap doesn’t support forward compatibility and any project with higher format version can’t be opened at all. It is risky to downgrade a project, but it can be done manually when necessary, please check the Project File Edit page.

Excess or missing params in node

Such error may only occur if after finishing all project and nodes conversions data still doesn’t satisfies node’s interface. Most likely it’s a bug or a consequence of manual editing the project file format version. Please contact support@faceform.com to solve this issue. Please provide the full error message by copying it from the appearing box. It would be helpful if you could send a project file if possible.

Error while converting

Such error occurs while updating project file data to the actual state. The error should contain concrete version numbers and failed requirements. Most likely it’s a bug or a consequence of manual editing the project file format version. Please contact support@faceform.com to solve this issue. Please provide the full error message by copying it from the appearing box. It would be helpful if you could send a project file if possible.

Unknown node type

The most common case for this error is trying to open Wrap4D project in Wrap. Any node marked with Only in Wrap4D in it’s doc page (e.x. LoadScreenPoints node) won’t open in usuall Wrap. Unknown types are not errors, but strict assertions. This problem can be resolved by excluding exclusive Wrap4D nodes manually from the project before opening it in Wrap.

Can’t read project format version

Opened document probably isn’t a Wrap project or is somehow corrupted. If you suspect that the software has corrupted or reset your project, please contact support@faceform.com to report.

Failed to parse opened JSON document

Opened document probably isn’t a JSON document. You can easily verify whether it looks like one or not by opening it in any text editor. Just compare it’s structure to the code above or with the Project File Edit page.