/reference-importer

Tool to help artists import videos as image sequence in Maya, without going through a video editing package. Supports multiple file formats, length trimming and specifying a target frame rate.

Primary LanguagePython

Reference Importer

Tool to help artists import videos as image sequence in Maya without going through a video editing package. Supports multiple file formats, length trimming and specifying a target frame rate.

Features

  • Video to image sequence conversion, for improved Reference Plane performance.
  • Automatic frame rate conversion (Forget about using Premiere Pro to change the frame rate of your reference!).
  • Automatic creation of a Reference Plane in Maya.
  • Multiplatform support (Windows, Mac and Linux).
  • Ffmpeg as the backend engine for video conversion.
  • Qt.py abstraction for multiple Maya versions support (2022+).

Installation

  1. Find the latest version under the Releases section.
  2. Download the right distribution for your platform.
    • Distributions use the following naming pattern: reference_importer_<version>_<platform>.zip
  3. Extract the zip file as a folder named reference_importer in your $MAYA_APP_DIR/<MAYA_VERSION>/scripts folder.

Usage

To launch Reference Importer, run the following Python script:

import reference_importer
reference_importer.run()

Workflow

  1. Select a video file in the UI.
  2. Set the desired start and end timecode.
    • End timecode will be populated by default to the end of the video.

    Use HH:MM:SS.ms as the timecode format.

  3. Set output image sequence name.
  4. Set the output format.
  5. Select the output directory for the sequence.
  6. Set the desired target frame rate.
  7. (Optional) Enable creation of an Image Plane in Maya for the sequence.
  8. Import the video!

Demonstration Video:

Reference Importer demonstration video