materialxgltf.core.Util Class Reference

Basic I/O Utilities. More...

Static Public Member Functions
(mx.Document, list)	createMaterialXDoc ()
	Utility to create a MaterialX document with the default libraries loaded.
bool	skipLibraryElement (elem)
	Utility to skip library elements when iterating over elements in a document.
	writeMaterialXDoc (doc, filename, predicate=skipLibraryElement)
	Utility to write a MaterialX document to a file.
	writeMaterialXDocString (doc, predicate=skipLibraryElement)
	Utility to write a MaterialX document to string.
list	makeFilePathsRelative (doc, docPath)
	Utility to make file paths relative to a document path.

Detailed Description

Basic I/O Utilities.

Definition at line 30 of file core.py.

Member Function Documentation

createMaterialXDoc()

(mx.Document, list) materialxgltf.core.Util.createMaterialXDoc ( )

static

Utility to create a MaterialX document with the default libraries loaded.

Returns

The created MaterialX document and the list of loaded library filenames.

Definition at line 33 of file core.py.

    def createMaterialXDoc() -> (mx.Document, list):
        '''
        @brief Utility to create a MaterialX document with the default libraries loaded.
        @return The created MaterialX document and the list of loaded library filenames.
        '''
        doc = mx.createDocument()
        stdlib = mx.createDocument()
        libFiles = []
        searchPath = mx.getDefaultDataSearchPath()
        libFiles = mx.loadLibraries(mx.getDefaultDataLibraryFolders(), searchPath, stdlib)
        doc.importLibrary(stdlib)
 
        return doc, libFiles
 

makeFilePathsRelative()

list materialxgltf.core.Util.makeFilePathsRelative ( doc, docPath )

static

Utility to make file paths relative to a document path.

Parameters

doc	The MaterialX document to update.
docPath	The path to make file paths relapy -tive to.

Returns

List of tuples of unresolved and resolved file paths.

Definition at line 86 of file core.py.

    def makeFilePathsRelative(doc, docPath) -> list:
        '''
        @brief Utility to make file paths relative to a document path
        @param doc The MaterialX document to update.
        @param docPath The path to make file paths relapy -tive to.
        @return List of tuples of unresolved and resolved file paths.
        '''
        result = []
 
        for elem in doc.traverseTree():
                valueElem = None
                if elem.isA(mx.ValueElement):
                    valueElem = elem
                if not valueElem or valueElem.getType() != mx.FILENAME_TYPE_STRING:
                    continue
 
                unresolvedValue = mx.FilePath(valueElem.getValueString())
                if unresolvedValue.isEmpty():
                    continue
 
                elementResolver = valueElem.createStringResolver()
                if unresolvedValue.isAbsolute():
                    elementResolver.setFilePrefix('')
                resolvedValue = valueElem.getResolvedValueString(elementResolver)
                resolvedValue = mx.FilePath(resolvedValue).getBaseName()
                valueElem.setValueString(resolvedValue)
 
                if unresolvedValue != resolvedValue:
                    result.append([unresolvedValue.asString(mx.FormatPosix), resolvedValue])
 
        return result  
 

skipLibraryElement()

bool materialxgltf.core.Util.skipLibraryElement ( elem )

static

Utility to skip library elements when iterating over elements in a document.

Returns

True if the element is not in a library, otherwise False.

Definition at line 48 of file core.py.

    def skipLibraryElement(elem) -> bool:
        '''
        @brief Utility to skip library elements when iterating over elements in a document.
        @return True if the element is not in a library, otherwise False.
        '''
        return not elem.hasSourceUri()
 

writeMaterialXDoc()

materialxgltf.core.Util.writeMaterialXDoc ( doc, filename, predicate = skipLibraryElement )

static

Utility to write a MaterialX document to a file.

Parameters

doc	The MaterialX document to write.
filename	The name of the file to write to.
predicate	A predicate function to determine if an element should be written. Default is to skip library elements.

Definition at line 56 of file core.py.

    def writeMaterialXDoc(doc, filename, predicate=skipLibraryElement):
        '''
        @brief Utility to write a MaterialX document to a file.
        @param doc The MaterialX document to write.
        @param filename The name of the file to write to.
        @param predicate A predicate function to determine if an element should be written. Default is to skip library elements.
        '''
        writeOptions = mx.XmlWriteOptions()
        writeOptions.writeXIncludeEnable = False
        writeOptions.elementPredicate = predicate
 
        if filename:
            mx.writeToXmlFile(doc, filename, writeOptions)
    

writeMaterialXDocString()

materialxgltf.core.Util.writeMaterialXDocString ( doc, predicate = skipLibraryElement )

static

Utility to write a MaterialX document to string.

Parameters

doc	The MaterialX document to write.
predicate	A predicate function to determine if an element should be written. Default is to skip library elements.

Returns

The XML string representation of the MaterialX document.

Definition at line 71 of file core.py.

    def writeMaterialXDocString(doc, predicate=skipLibraryElement):
        '''
        @brief Utility to write a MaterialX document to string.
        @param doc The MaterialX document to write.
        @param predicate A predicate function to determine if an element should be written. Default is to skip library elements.
        @return The XML string representation of the MaterialX document.
        '''
        writeOptions = mx.XmlWriteOptions()
        writeOptions.writeXIncludeEnable = False
        writeOptions.elementPredicate = predicate
 
        result =  mx.writeToXmlString(doc, writeOptions)
        return result
    

---

The documentation for this class was generated from the following file:

• core.py