## ExportCustomFile

### Introduced

v8.0 (2010)

### Description

Exports the scene contents to a custom file. The custom file type must be registered in an export custom converter event (see PluginRegistrar.RegisterConverterEvent for more information about how to specify the extension of the filename).
This command fires the following events: siOnBeginFileExport, the custom exporter registered for the matching file extension, and siOnEndFileExport, in that order.
The FileType context attribute of the siOnBeginFileExport, siOnCustomFileExport and siOnEndFileExport events will have the siFileTypeCustom value when this command is called.
Warning: If there is no custom exporter event registered with the matching file extension, the command will fail and an error will be logged.

### Scripting Syntax

    ExportCustomFile( FileName, [Target], [Frame], [UserData] );

### Parameters

Parameter | Type | Description
--- | --- | ---
FileName | String | The full path name of the custom exported file.
Target | String | The objects to be exported. Default Value: Selected object
Frame | Integer | Frame at which to export the specified objects. This information is only accessible from the custom converter export event callback. Default Value: Current frame.
UserData | Parameter-dependent | Any data that needs to be accessible from the custom converter export event callback.

### Examples

#### Python Example

    #

    # First of all, an export converter event must be registered with the extension of the file to export.

    #

    from win32com.client import constants as c

    def 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 XSI know that this plug-in implements custom import/export events for ABC files

    	in_reg.RegisterConverterEvent( "ABCTextImport", c.siOnCustomFileImport, "ABC" )

    	in_reg.RegisterConverterEvent( "ABCTextExport", c.siOnCustomFileExport, "ABC" )

    	return 1

    def ABCTextImport_OnEvent( in_ctxt ) :

    	app = Application

    	app.LogMessage( "ABC Text Import Event called..." )

    	app.LogMessage( "FileName: " + in_ctxt.GetAttribute("FileName") )

    	app.LogMessage( "Target: " + str(in_ctxt.GetAttribute("Target")) )

    	app.LogMessage( "FileType: " + str(in_ctxt.GetAttribute("FileType")) )

    	app.LogMessage( "Frame: " + str(in_ctxt.GetAttribute("Frame")) )

    	app.LogMessage( "UserData: " + str(in_ctxt.GetAttribute("UserData")) )

    def ABCTextExport_OnEvent( in_ctxt ) :

    	app = Application

    	app.LogMessage( "ABC Text Export Event called...");

    	app.LogMessage( "FileName: " + in_ctxt.GetAttribute("FileName") );

    	app.LogMessage( "Target: " + str(in_ctxt.GetAttribute("Target")) );

    	app.LogMessage( "FileType: " + str(in_ctxt.GetAttribute("FileType")) )

    	app.LogMessage( "Frame: " + str(in_ctxt.GetAttribute("Frame")) )

    	app.LogMessage( "UserData: " + str(in_ctxt.GetAttribute("UserData")) );

    #

    # Then, the ExportCustomFile command may be called from any script.

    #

    Application.ExportCustomFile( "MyABCfile.abc", "Scene_Root", 50, "ABCExportOptions" )

    #---------------------------------------------------------

    # Output from this script:

    # INFO : ABC Text Export Event called...

    # INFO : FileName: MyABCfile.abc

    # INFO : Target: Scene_Root

    # INFO : FileType: 31

    # INFO : Frame: 50.0

    # INFO : UserData: ABCExportOptions

    #---------------------------------------------------------

### See Also

ImportCustomFile