us.temerity.pipeline.plugin.DLTextureAction.v2_2_1
Class DLTextureAction

java.lang.Object
  us.temerity.pipeline.Named
      us.temerity.pipeline.PluginID
          us.temerity.pipeline.BasePlugin
              us.temerity.pipeline.BaseAction
                  us.temerity.pipeline.plugin.CommonActionUtils
                      us.temerity.pipeline.plugin.PythonActionUtils
                          us.temerity.pipeline.plugin.DLTextureAction.v2_2_1.DLTextureAction

All Implemented Interfaces:

Serializable, Cloneable, Comparable<PluginID>, Glueable

public class DLTextureAction
extends PythonActionUtils

Generates optimized 3Delight textures and environment maps from source images.

Converts the images which make up the primary file sequence of one of the source nodes into the texture maps which make up the primary file sequence of this node.

See the 3Delight documentation for tdlmake(1) for details.

This action defines the following single valued parameters:

Image Source

The source node which contains the images files to convert.

Quality

The strategy for selecting the source image when downsampling mipmap levels:

• Low - Use previous mipmap level.
• Medium - Use 2nd previous mipmap level.
• High - Use 4th previous mipmap level.

Filter

The filter used to downsample the source images to generate the mipmap levels.

• Box
• Triangle
• Gaussian
• Catmul-Rom
• Bessel
• Sinc

Filter Window

Windowing function used to soften boundry of Bessel or Sinc filters. Ignored for all other filters.

• Lanczos
• Hamming
• Hann
• Blackman
• None

S Filter Width
T Filter Width

Overrides the width (diameter) of the downsizing filter in the S/T directions.

Blur Factor

Scale factor applied to the filter function.

Format

The format of generated texture map files.

• Texture
• EnvMap (latitude/longitude environment map)

S Mode
T Mode

The method used to lookup texels outside the [0,1] S/T coordinate range:

• Black - Use black for all values outside [0,1] range.
• Clamp - Use border texel color for values outside [0,1] range.
• Periodic - Tiles texture outside [0,1] range.

Flip

Whether and how to flip the output texture maps:

• None - No flipping is performed.
• S-Only - Flip image in the S direction.
• T-Only - Flip image in the T direction.
• Both - Flip in both the S and T directions.

Compression

The compression method to use for the output texture maps.

By default, the "python" program is used by this action to run the "tdlmake" commands. An alternative program can be specified by setting PYTHON_BINARY in the Toolset environment to the name of the Python interpertor this Action should use. When naming an alternative Python interpretor under Windows, make sure to include the ".exe" extension in the program name.

See Also:

Serialized Form

Field Summary

static String	aBlurFactor
static String	aCompression
static String	aFilter
static String	aFilterWindow
static String	aFlip
static String	aFormat
static String	aImageSource
static String	aMode
static String	aQuality
static String	aSFilterWidth
static String	aSMode
static String	aTFilterWidth
static String	aTMode

Fields inherited from class us.temerity.pipeline.plugin.CommonActionUtils

aExtraOptions

Fields inherited from class us.temerity.pipeline.BasePlugin

pDescription

Fields inherited from class us.temerity.pipeline.PluginID

pVendor, pVersionID

Fields inherited from class us.temerity.pipeline.Named

pName

Constructor Summary

DLTextureAction()

Method Summary

SubProcessHeavy

prep(ActionAgenda agenda, File outFile, File errFile) Construct a SubProcessHeavy instance which when executed will fulfill the given action agenda.

Methods inherited from class us.temerity.pipeline.plugin.PythonActionUtils

createPythonSubProcess, createPythonSubProcess, createPythonSubProcess, getPythonFileVerify, getPythonFileVerify, getPythonFileVerify, getPythonFileVerify, getPythonFileVerify, getPythonFileVerify, getPythonIndent, getPythonLaunchHeader, getPythonLaunchPipeHeader, getPythonProgram, getPythonProgram

Methods inherited from class us.temerity.pipeline.plugin.CommonActionUtils

addExtraOptionsParam, addExtraOptionsParamToLayout, createScriptSubProcess, createSubProcess, createSubProcess, createSubProcess, createSubProcess, createTempCopySubProcess, createTempScript, escPath, escPath, getExtraOptionsArgs, getPrimarySourcePath, getPrimarySourcePath, getPrimarySourcePath, getPrimarySourcePaths, getPrimarySourcePaths, getPrimarySourcePaths, getPrimaryTargetPath, getPrimaryTargetPath, getPrimaryTargetPath, getPrimaryTargetPaths, getPrimaryTargetPaths, getPrimaryTargetPaths, getSecondarySourceBooleanParamValue, getSecondarySourceDoubleParamValue, getSecondarySourceDoubleParamValue, getSecondarySourceEnumParamIndex, getSecondarySourceIntegerParamValue, getSecondarySourceIntegerParamValue, getSecondarySourceLongParamValue, getSecondarySourceLongParamValue, getSecondarySourceOptionalBooleanParamValue, getSecondarySourceStringParamValue, getSecondarySourceStringParamValue, getSingleBooleanParamValue, getSingleDoubleParamValue, getSingleDoubleParamValue, getSingleEnumParamIndex, getSingleIntegerParamValue, getSingleIntegerParamValue, getSingleLongParamValue, getSingleLongParamValue, getSingleOptionalBooleanParamValue, getSingleStringParamValue, getSingleStringParamValue, getSingleTuple2dParamValue, getSingleTuple2dParamValue, getSingleTuple2dParamValue, getSingleTuple2iParamValue, getSingleTuple2iParamValue, getSingleTuple2iParamValue, getSingleTuple3dParamValue, getSingleTuple3dParamValue, getSingleTuple3dParamValue, getSingleTuple3iParamValue, getSingleTuple3iParamValue, getSingleTuple3iParamValue, getSingleTuple4dParamValue, getSingleTuple4dParamValue, getSingleTuple4dParamValue, getSourceBooleanParamValue, getSourceDoubleParamValue, getSourceDoubleParamValue, getSourceEnumParamIndex, getSourceIntegerParamValue, getSourceIntegerParamValue, getSourceLongParamValue, getSourceLongParamValue, getSourceOptionalBooleanParamValue, getSourceStringParamValue, getSourceStringParamValue, getWorkingNodeFilePath, getWorkingNodeFilePath, getWorkingNodeFilePath, getWorkingNodeFilePath, getWorkingNodeFilePaths

Methods inherited from class us.temerity.pipeline.BaseAction

addPreset, addPresetValues, addSingleParam, chmod, cleanupLater, clearAllLinkParams, clearLinkParams, clone, createTemp, createTemp, equals, equalSingleParams, equalSourceParams, fromGlue, getInitialSourceParams, getPluginType, getPresetChoices, getPresetValues, getSecondarySequences, getSecondarySourceNames, getSecondarySourceParam, getSecondarySourceParams, getSecondarySourceParamValue, getSingleLayout, getSingleParam, getSingleParams, getSingleParamValue, getSourceLayout, getSourceNames, getSourceParam, getSourceParams, getSourceParamValue, getTempDir, getTempPath, hasSecondarySourceParams, hasSingleParams, hasSourceParams, initSecondarySourceParams, initSourceParams, removeAllSourceParams, removeSecondarySourceParams, removeSecondarySourceParams, removeSourceParams, setSecondarySourceParamValue, setSingleLayout, setSingleParamValue, setSingleParamValues, setSourceLayout, setSourceParamValue, setSourceParamValues, supportsSourceParams, toGlue

Methods inherited from class us.temerity.pipeline.BasePlugin

addSupport, compareTo, getDescription, getFullMessage, getPluginID, getResource, getResources, getResourceSize, getSupports, isUnderDevelopment, removeSupport, setSupports, supports, toString, underDevelopment

Methods inherited from class us.temerity.pipeline.PluginID

getVendor, getVersionID

Methods inherited from class us.temerity.pipeline.Named

getName

Methods inherited from class java.lang.Object

finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

aImageSource

public static final String aImageSource

See Also:

Constant Field Values

aQuality

public static final String aQuality

See Also:

Constant Field Values

aFilter

public static final String aFilter

See Also:

Constant Field Values

aFilterWindow

public static final String aFilterWindow

See Also:

Constant Field Values

aSFilterWidth

public static final String aSFilterWidth

See Also:

Constant Field Values

aTFilterWidth

public static final String aTFilterWidth

See Also:

Constant Field Values

aBlurFactor

public static final String aBlurFactor

See Also:

Constant Field Values

aFormat

public static final String aFormat

See Also:

Constant Field Values

aSMode

public static final String aSMode

See Also:

Constant Field Values

aTMode

public static final String aTMode

See Also:

Constant Field Values

aMode

public static final String aMode

See Also:

Constant Field Values

aFlip

public static final String aFlip

See Also:

Constant Field Values

aCompression

public static final String aCompression

See Also:

Constant Field Values

Constructor Detail

DLTextureAction

public DLTextureAction()

Method Detail

prep

public SubProcessHeavy prep(ActionAgenda agenda,
                            File outFile,
                            File errFile)
                     throws PipelineException

Construct a SubProcessHeavy instance which when executed will fulfill the given action agenda.

Overrides:

prep in class BaseAction

Parameters:

agenda - The agenda to be accomplished by the action.

outFile - The file to which all STDOUT output is redirected.

errFile - The file to which all STDERR output is redirected.

Returns:

The SubProcess which will fulfill the agenda.

Throws:

PipelineException - If unable to prepare a SubProcess due to illegal, missing or imcompatable information in the action agenda or a general failure of the prep method code.