## PluginRegistrar.RegisterConverterEvent

### Introduced

v6.0

### Description

Registers a Converter Event. The event's callback is invoked whenever a file using a custom-defined file type has to be imported or exported.

### C# Syntax

    PluginItem PluginRegistrar.RegisterConverterEvent( String in_eventName, siEventID in_eventID, String in_eventExtension );

### Scripting Syntax

    oReturn = PluginRegistrar.RegisterConverterEvent( Name, Type, Extension );

### Return Value

PluginItem

### Parameters

Parameter | Type | Description
--- | --- | ---
Name | String | The name of the custom converter event to register. It should begin with a letter and contain only letters, numbers and the underscore character. If a converter event name contains spaces (for example, "My Converter"), the callback function names must omit the spaces (for example, "MyConverter_Init"). Softimage expects the handler function associated to the registered event to be formatted as follows: {event name}_OnEvent.
Type | siEventID | Type of event to register. Note: The following identifiers are supported: siOnCustomFileImport and siOnCustomFileExport
Extension | String | The file Extension to register the converter event for. The Extension should not contain any delimiters and be uppercase, so "TXT" for example is the extension for a file like "myfile.txt".

### Examples

#### JScript Example

    function XSILoadPlugin( in_reg )
    {
            in_reg.Author = "ABC" ;
            in_reg.Name = "ABC Text Converter plugin" ;
            in_reg.Major = 1;
            in_reg.Minor = 0;
            in_reg.URL = "www.abc.com"
            // Let Softimage know that this plugin implements a custom import and export event for txt files
            in_reg.RegisterConverterEvent("ABCTextImport",siOnCustomFileImport,"TXT");
            in_reg.RegisterConverterEvent("ABCTextExport",siOnCustomFileExport,"TXT");
            return true ;
    }

### See Also

Plugin.Items Definition Callbacks for Events