File Translator Examples

Reader Method

You need to implement a reader() method if you wish to load a file type that is supported by your file translator.

The haveReadMethod() method checks if the translator provides a read method. In the LepTranslator class, the method returns true because the reader() method exists.

bool LepTranslator::haveReadMethod () const
{
    return true;
}

The reader() method reads each line of the file and returns a MS::kFailure if it cannot be opened by the translator. If a file type cannot be recognized by the translator, the method creates a new object via MEL to support the data in that file.

MStatus LepTranslator::reader ( const MFileObject& file,
    const MString& options, MPxFileTranslator::FileAccessMode mode)
{
#if defined (OSMac_)
    char nameBuffer[MAXPATHLEN];
    strcpy (nameBuffer, file.fullName().asChar());
    const MString fname(nameBuffer);
#else
    const MString fname = file.fullName();
#endif    
    MStatus rval(MS::kSuccess);
    const int maxLineSize = 1024;
    char buf[maxLineSize];
    ifstream inputfile(fname.asChar(), ios::in);
    if (!inputfile) {
        // open failed
        cerr << fname << ": could not be opened for reading\n";
        return MS::kFailure;
    }
    if (!inputfile.getline (buf, maxLineSize)) {
        cerr << "file " << fname << " contained no lines ... aborting\n";
        return MS::kFailure;
    }
    if (0 != strncmp(buf, magic.asChar(), magic.length())) {
        cerr << "first line of file " << fname;
        cerr << " did not contain " << magic.asChar() << " ... aborting\n";
        return MS::kFailure;
    }
    while (inputfile.getline (buf, maxLineSize)) { 
        //processing each line of the file
        MString cmdString;
        cmdString.set(buf);
        if (!MGlobal::executeCommand(cmdString))
            rval = MS::kFailure;
    }
    inputfile.close();
    return rval;
}

Lines of files are processed in order to add new objects to the model.

Writer Method

You need to include a writer() method if you want to save a file type that is supported by your translator.

The haveWriteMethod() method checks if the translator has a write method. In the polyExporter class, the method returns true because the writer() method is implemented.

bool polyExporter::haveWriteMethod() const 
{
    return true;
}

The writer() method provides a message through the script editor and returns a status to indicate the results.

In this example, only ‘export all’ and ‘export selection’ options are allowed when trying to save data. Other options will result in the display of a failure message through the script editor and returns a MS:kFailure, which indicates that the file type cannot be understood by the translator. For your plug-in, you will have to set your own identifier string. If the method is successful, the data will be saved as a new file in a file type that is supported by the translator.

MStatus polyExporter::writer(const MFileObject& file,
    const MString& /*options*/,    MPxFileTranslator::FileAccessMode mode) 
{
#if defined (OSMac_)
        char nameBuffer[MAXPATHLEN];
        strcpy (nameBuffer, file.fullName().asChar());
        const MString fileName(nameBuffer);
#else
        const MString fileName = file.fullName();
#endif
        ofstream newFile(fileName.asChar(), ios::out);
    if (!newFile) {
        MGlobal::displayError(fileName + ": could not be opened for reading");
        return MS::kFailure;
    }
    newFile.setf(ios::unitbuf);
    writeHeader(newFile);
    if (MPxFileTranslator::kExportAccessMode == mode) {
        if (MStatus::kFailure == exportAll(newFile)) {
            return MStatus::kFailure;
        }
    } 
    else if (MPxFileTranslator::kExportActiveAccessMode == mode) {
        if (MStatus::kFailure == exportSelection(newFile)) {
            return MStatus::kFailure;
        }
    } 
    else {
        return MStatus::kFailure;
    }
    writeFooter(newFile);
    newFile.flush();
    newFile.close();
    MGlobal::displayInfo("Export to " + fileName + " successful!");
    return MS::kSuccess;
}

IdentifyFile Method

This method is typically used to check if the file extension of the file in question is the correct file type for the translator.

When a file is encountered, Maya calls the identifyFile() method and queries each translator until it finds an appropriate match. The method is given an MFileObject indicating the file being checked and a pointer name to the initial file contents. In this example below, any file types being passed to this method other than .anim will result in MS::kNotMyFileType being returned, which indicates that the translator cannot understand the file type. Otherwise, the file is understood by the translator and is able to operate in Maya through the translator plug-in.

MPxFileTranslator::MFileKind
animExportUtil::identifyFile (
    const MFileObject &file,
    const char * /*buffer*/,
    short /*size*/
) const
{
    const char *name = file.name().asChar();
    int nameLength = (int)strlen(name);
    if ((nameLength > 5) && !strcasecmp(name+nameLength-5, ".anim")) {
        return (kIsMyFileType);
    }
    return (kNotMyFileType);
}

File Extensions

The defaultExtension() method defines the default file extension of a translator and returns a string.

MString polyRawExporter::defaultExtension () const 
{
    return MString("raw");
}

In this example, Maya calls the method and saves the file with a .raw file extension. Note that the period should not be included in the extension name.

FileAccess Mode

The fileAccessMode() is an enum method that returns the type of file access mode that Maya is currently in. There are six types of file access modes in Maya.

In this example, the mode is kImportAccessMode, which is when Maya imports data into the scene.

if (mode == kImportAccessMode) {
    status = importAnim(animFile, pasteFlags);
}