Simplygon 9 Documentation

# SimplygonQuery command

# Description

The SimplygonQuery command provides functionality for fetching information (such as mesh- and material information) that was collected during the last Simplygon call. See the complete list of flags below.

# Syntax

    # Flags and args

    Short flag Long flag Argument(s) Description
    ver Version <none> Gets the Simplygon API version.
    gpm GetProcessedMeshes <none> Returns a list of processed mesh names from the last run.
    spm SelectProcessedMeshes <none> Selects all processed meshes generated by the last Simplygon call.
    mrm MeshReusesMaterial string meshName Returns material name if the material is shared, otherwise empty string. (deprecated)
    rms MeshReusesMaterials string meshName Return a list of material names if the material is shared, otherwise empty list. Use this if you expect multi-material meshes back from Simplygon.
    gmm GetMaterialForMesh string meshName Returns material name for the specified mesh. This can be used for single-material meshes, for example a mesh of which material has gone through material baking. (deprecated)
    mfm GetMaterialsForMesh string meshName Return a list of material names for the specified mesh. This can be used for both single- and multi-material meshes, can be used in combination with gmi.
    gmi GetMaterialIdsForMesh string meshName Return a list of material ids for multi-material meshes that has not gone through material baking. Material baking will always result in one single material with material id 0 (the material returned by reuse, if any will cover the entire asset).
    gm GetMaterials <none> Returns a list of material names from the last run.
    gcm GetChannelsForMaterial string materialName Returns a list of material channel names for the specified material.
    gtc GetTexturePathForChannel string materialName
    string channelName    		 Returns the texture path for the specified material channel.
    gpp GetProcessedOutputPaths <none> Returns the processed output file paths.

    # Examples

    This section contains some examples written in MEL and Python. We've left out some parts of the scripts to keep things as simple as possible.

    • import maya.cmds as cmds must be declared at the top of each Python script.
    • reductionPipeline settings-path must be declared for both MEL and Python scripts where it makes sense.
    • a scene-selection is made before each Simplygon-command.

    # Get processed meshes

    Returns a string array of the names of the processed meshes from the most recent Simplygon-command. The result can be used select or rename processed objects.

      # Get processed output files

      Returns a string array of the names of the processed meshes from the most recent Simplygon-command in combination with -isf and -osf. The resulting file-paths can be used when importing files manually.

        # Get materials for mesh

        Returns a string array of material-names for the processed mesh.

          # Get material-ids for mesh

          Returns a int array of material-ids for the processed mesh.

            # Get materials

            Returns a string array of material-names from the most recent Simplygon run.

              # Get material channels for material

              Returns a string array of material-channels from the given material.

                # Get texture-path for material-channel

                Returns a string array of texture-paths from the given material-channel.

                  # Mesh reuses materials

                  Returns a string array of materials that the mesh is reusing, empty if not reusing. Points into the material list that can be fetched by -gmi.

                    # Get material for mesh (deprecated)

                    Returns the first/only material-name for the processed mesh.

                      # Mesh reuses material (deprecated)

                      Returns a the name of the material that the mesh is reusing, empty if not reusing.

                        ← SimplygonPipeline command →