Contents
A specialized version of PxrTexture to project textures, designed to work with PxrProjectionStack.
It has additional functionalities to optimize texturing and apply multiple textures at once.
Input Parameters
Filename
The filename of the texture. This parameter must be supplied.
This parameters shouldn't be left empty, otherwise the missing color will be projected instead.
First Channel Offset
First channel offset to be looked up for filename.
Filter
Selects different reconstruction filters that can be used during texture lookup. The filters available for PxrProjectionLayer are:
| Value | Filter |
|---|---|
| 0 | Nearest |
| 1 | Box |
| 2 | Bilinear |
| 3 | Bspline |
| 6 | Gaussian |
| 7 | Lagrangian |
Blur
Specifies how much to blur the image retrieved from the texture file.
Mip Interpolate
Selects whether to interpolate between adjacent resolutions in the multi-resolution texture, resulting in smoother transitions between levels.
Missing Color
If there is an error opening the texture, use this color.
Missing Alpha
If there is an error opening the texture, use this alpha.
Linearize
Apply the reverse sRGB transform your texture. If you are painting textures in sRGB space (default for most paint packages) but viewing your data in data linear space, your textures will look washed out. This will apply the sRGB transform to your texture, which should make it appear visually linear again.
PreMultiply
Enable this if you want the final color to be multiplied by the alpha.
Mask
A black and white mask can be used to avoid reading texture on points that won't be visible. PxrProjectionLayer is providing such an output (resultMask) to avoid reading texels that are either occluded or outside of the projection window.
Channels
Manifold
Provides the range over which to apply the texture. Plug a PxrProjector here to provide mapping coordinates to the texture function. Defaults to s,t.
Color Space
From Colorspace
The native color space of the texture usually sRGB/Rec709
To Colorspace
The target color space. Defaults to the global scene-setting, which defaults to Rec709
Advanced Texture Settings
MipBias
Bias mip selection chosen for rendering to either a higher (negative integers) or lower resolution (positive integers) selection.
MaxResolution
Clamp mip selection to a preferred maximum level. This may prevent the highest resolutions from being rendered depending on your selection.
OptimizeIndirect
Sets texture filter to Box (inexpensive) on indirect hits instead of the selected filter used for other visible effects.
Output Parameters
resultRGB
resultR
The R channel result
resultG
The G channel result
resultB
The B channel result
resultA
The Alpha channel, which takes into account the mask provided through the mask input.
outNumChannels
The number of channels output by this layer. This is the number of textures defined in channelsFilenames. This should always be connected to PxrProjectionStack's layersNumChannels parameter so it may unpack the channel data.
outChannelsRGB
The RGB channel data, packed in a single output. PxrProjectionStack needs to know the number of available channels through a connection with outNumChannels to be able to unpack the data.