Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • The type of node using the texture: pattern, light, light filter lightfilter or imageplane.
  • A set of base parameters for that type of node
  • one or more rules to modify the base parameters when considering the file's name, the bit depth, etc.

...

Code Block
languagejs
themeFadeToGrey
{
    "pattern": {
        "args": {
            "texture_type": "regular",
            "smode": "periodic",
            "tmode": "periodic",
            "texture_format": "pixar",
            "texture_filter": "catmull-rom",
            "resize": "up-",
            "data_type": null,
            "compression": "lossless",
            "compression_level": null
        },
        "rules": {
            "'_i8t' in '%(img_name)s'": {
                "args": {
                    "texture_format": "tiff",
                    "data_type": "byte"
                }
            }
		}
	}
}

Category

Here, the category is pattern, but there are other pre-defined categories: light, lightfilter and imageplane.

args

This section is a dictionary representing default txmake parameter values for the current category. The key names (texture_type, smode, tmode, etc) are coming from the TxParams class of the txmanager python module.

rules

Here we define a set of rules that will be executed in the file's order. The key string should evaluate as a python expression once substituted.

There are a number of available substitution tokens:

tokencontents
node_typethe node type (PxrDiskLight, PxrTexture, etc).
img_atlasTrue if the texture is a UDIM or Mudbox texture set.
img_namethe image name, without its file extension.
img_extthe image's file extension, with its leading dot.
img_typethe image's data type: int or float
img_depththe image's bit depth: 8, 16, 32

In the example above, the rule:

Code Block
languagejs
themeFadeToGrey
"'_i8t' in '%(img_name)s'": {
	"args": {
		"texture_format": "tiff",
		"data_type": "byte"
	}
}
matches "_i8t" in the image name, which is interpreted as shorthand for "8 bits integer tiff format" and sets the texture format to "tiff" and the image to "byte" (8 bits integer, see txmake documentation).