Previewing Video Previous

Chapter 1, Managing Projects
Archiving or Restoring



An archive of a project can contain all or part of the project's folders and contents, as well as the project preferences. When archiving linked compositions, all versions of the linked composition are included. If you archive a link, Toxik archives the object to which the link points, not the link itself.

When archiving a composition, you should save all versions. Otherwise, when you restore the composition, you may be missing some versions. Also, if you are archiving any dependencies, such as linked composition, media, paint strokes, and LUTs all compositions are opened to locates them.

Note: You cannot append an archive.

You can archive and restore elements, such as projects, compositions, and folders. However, to enable you to selectively archive and restore certain elements of the archive (such as linked compositions, media LUTS, and paint strokes), Toxik generates not just an .xml file, but also an archive folder containing the .txarchive file, as well as .zip files which store external dependencies.

Note: Archives created with earlier versions of Toxik have the .dlarchive extension and are supported for backward compatibility.

When you archive a project, you can produce compressed or non-compressed .zip files. The maximum size of a .zip file cannot exceed 2 GB. However, if it does, then the file is skipped and the archiving process continues.

The name of each .zip file is generated by the archive name, the type of external dependency it contains, and an index. For example, MyArchive.MEDIA.0001.zip, MyArchive.MEDIA.0002.zip, MyArchive.PAINT_STROKES.0001.zip.

The archive output folder uses the archive name you specify. This folder is created by default in the archive folder specified in the Project Preferences window (Archive tab)--see Setting Project Preferences.

You can configure the archive operation as either a local or remote background task. By default it is a background task on the local machine.

As for most tasks, you can use scripting to improve efficiency. Consult the online Toxik Python API documentation for help with scripts (in the Windows Start menu, choose Programs > Autodesk > Autodesk Toxik 2009 > Toxik Documentation > Scripting API).

To archive the current composition:
  1. Select Composition > Archive.

  2. In the dialog that appears, enter a name for the archive and click OK.

    Note: The Python script for archiving does not recognize file names that contain any of the following characters: *?:"<> (asterisk, question mark, colon, quote mark, open angle bracket, close angle bracket). A file name with any of these characters causes the archiving script to fail.

    If you are archiving a published composition, the following dialog appears in which you can choose the archiving options. External dependencies, such as linked compositions, paint strokes, 1D LUTs, and 3D LUTs are on by default for all external dependency types, with the exception of media.

    Show full-size image

  3. Select the archiving options and click OK.

    All external dependency files are stored in one or many .zip files named after their type (for example, MEDIA, PAINT_STROKES, 1D_LUT, 3D_LUT).

    Warning: Changing the name of a .zip file, moving or transferring an archive will result in undefined restoration behavior.

To archive an element:
  1. In the Library Browser, in the Folder list, navigate to and select the element you want to archive.

  2. In the Folder contents area, right-click the element to archive and select Archive.

  3. In the dialog that appears, enter a name for the archive and click OK.

    Note: The Python script for archiving does not recognize file names that contain any of the following characters: *?:"<> (i.e. asterisk, question mark, colon, quote mark, open angle bracket, close angle bracket). A file name with any of these characters causes the archiving script to fail.

    If you are archiving a published composition, the following dialog appears in which you can choose the archiving options. External dependencies, such as linked compositions, paint strokes, 1D LUTs, and 3D LUTs are on by default for all external dependency types, with the exception of media.

    Show full-size image

  4. Select the archiving options and click OK.

    All external dependency files are stored in one or many .zip files named after their type (for example, MEDIA, PAINT_STROKES, 1D_LUT, 3D_LUT).

    Warning: Changing the name of a .zip file, moving or transferring an archive will result in undefined restoration behavior.

Archiving Linked Compositions Top

You can recursively archive the compositions to which a composition is linked. Linked composition archiving is optional and is on by default. Linked compositions are stored in the same .xml file as the compositions selected for archiving. You can archive a composition and its linked compositions in the same way that you archive a composition.

To archive a composition:
  1. In the Library Browser, in the Folder list, navigate to and select the element you want to archive.

  2. In the Folder contents area, right-click the element you want to archive and select Archive.

  3. In the dialog that appears, enter a name for the archive and click OK.

    Note: The Python script for archiving does not recognize file names that contain any of the following characters: *?:"<> (i.e. asterisk, question mark, colon, quote mark, open angle bracket, close angle bracket). A file name with any of these characters causes the archiving script to fail.

    Show full-size image

    Warning: Changing the name of a .zip file, moving or transferring an archive will result in undefined restoration behavior.

  4. Select Linked Compositions and any other archiving option, and click OK.

    All external dependency files are stored in one or many .zip files named after their type (for example, MEDIA, PAINT_STROKES, 1D_LUT, 3D_LUT).

Restoring Archives Top

Unlike archiving, all the compositions in the archive, including the linked compositions, are restored. That is, there is no selective restoring of compositions.

Note: When restoring an archive that contains a user and its settings, the user is skipped and a warning message is displayed.

To restore an archived element:
  1. In the Import Browser, navigate in the Folder list and locate the archive element in the default archives folder--see Setting Project Preferences.

  2. Right-click the .txarchive file in the folder contents area and choose Restore.

    Show full-size image

    Depending on the dependencies (if any), you are prompted to restore the archived dependencies.

  3. Select the dependencies to restore.

  4. Relocate the restored archive and its dependencies.

    The external dependencies in the .zip files are restored. If some .zip files are missing because they were moved, transferred, or renamed, the external dependency files will not be restored. However, they can be relocated.

Relocating Dependencies Top

You can change the location of external dependencies in an archive when you restore the archive. The ability to relocate external files allows an archived file created on a Windows environment to be restored in a UNIX environment and vice versa.

Once you choose to restore an archive and any external dependencies, a relocation dialog box appears showing the path used by the external dependency files in the archive.

To relocate external dependencies:
Changing Default Archive and Restore Settings Top

You can change the default settings for archiving and restoring.

To change the default archive and restore settings:
  1. Do one of the following:

    The Project Preferences window is displayed.

  2. Select the Archive tab and set the preferences for archive and restore operations--see Setting Project Preferences.

    Show full-size image

Previous