materialxgltf.gltf2Mtlx Namespace Reference

Utility and command line interface to convert from a glTF file to a MaterialX file. More...

Functions
	gltf2Mtlx (gltfFileName, mtlxFileName, options=GLTF2MtlxOptions())
	Utility to convert a glTF file to MaterialX file.
	main ()
	Command line interface to convert from a glTF file to a MaterialX file.

Detailed Description

Utility and command line interface to convert from a glTF file to a MaterialX file.

Function Documentation

gltf2Mtlx()

materialxgltf.gltf2Mtlx.gltf2Mtlx	(		gltfFileName,
			mtlxFileName,
			options = GLTF2MtlxOptions() )

Utility to convert a glTF file to MaterialX file.

Parameters

gltfFileName	Path to glTF file to convert
mtlxFileName	Path to MaterialX file to write
options	Options for conversion

Definition at line 12 of file gltf2Mtlx.py.

def gltf2Mtlx(gltfFileName, mtlxFileName, options=GLTF2MtlxOptions()):
    '''
    @brief Utility to convert a glTF file to MaterialX file
 
    @param gltfFileName Path to glTF file to convert
    @param mtlxFileName Path to MaterialX file to write
    @param options Options for conversion
    '''
    status = True
    err = ''
 
    gltf2MtlxReader = GLTF2MtlxReader()
    gltf2MtlxReader.setOptions(options)
    doc = gltf2MtlxReader.convert(gltfFileName)
    if not doc:
        status = False
        err = 'Error converting glTF file to MaterialX file'
    else:
        status, err = doc.validate()
        if not status:
            print('Validation error: ', err)
        #print(mx.writeToXmlString(doc))
        Util.writeMaterialXDoc(doc, mtlxFileName)
 
    return status, err
 

main()

materialxgltf.gltf2Mtlx.main

(

)

Command line interface to convert from a glTF file to a MaterialX file.

Definition at line 38 of file gltf2Mtlx.py.

def main():
    '''
    @brief Command line interface to convert from a glTF file to a MaterialX file
    '''
    parser = argparse.ArgumentParser(description='Utility to convert a glTF file to MaterialX file')
    parser.add_argument(dest='gltfFileName', help='Path containing glTF file to convert.')
    parser.add_argument('-fn', '--mtlxFileName', dest='mtlxFileName', default='', help='Name of MaterialX output file. If not specified the glTF name with "_converted.mtlx" suffix will be used')
    parser.add_argument('-ca', '--createAssignments', dest='createAssignments', type=mx.stringToBoolean, default=True, help='Create material assignments. Default is True')
    parser.add_argument('-ai','--addAllInputs', dest='addAllInputs', type=mx.stringToBoolean, default=False, help='Add all definition inputs to MaterialX shader nodes. Default is False')
    parser.add_argument('-ax', '--assignXform', dest='assignXform', type=mx.stringToBoolean, default=False, help='Assign to transforms vs shapes. Default is False'   )
 
    opts = parser.parse_args()
 
    # Check input glTF file
    gltfFileName = opts.gltfFileName
    if not os.path.exists(gltfFileName):
        print('Cannot find input file: ', gltfFileName)
        exit(-1)    
 
    # Set up MTLX file name
    mtlxFilePath = gltfFileName + '_converted.mtlx'
    if opts.mtlxFileName:
        mtlxFilePath = opts.mtlxFileName 
 
    # Perform conversion
    options = GLTF2MtlxOptions()
    options['createAssignments'] = opts.createAssignments    
    options['addAllInputs'] = opts.addAllInputs
    options['assignXform'] = opts.assignXform
    converted, err = gltf2Mtlx(gltfFileName, mtlxFilePath, options)
    print('Converted glTF file %s to MaterialX file: %s. Status: %s.' % (gltfFileName, mtlxFilePath, converted))
    if not converted:
        print('- Error: ', err)