D3DSHADER_INSTRUCTION_OPCODE_TYPE enumeration (d3d9types.h)
This section lists the shader operation codes that can be contained in the first 16 bits (0 - 15) of an Instruction token. The sections that follow describe the token format of the instructions that correspond to the operation codes.
Syntax
typedef enum _D3DSHADER_INSTRUCTION_OPCODE_TYPE {
D3DSIO_NOP,
D3DSIO_MOV,
D3DSIO_ADD,
D3DSIO_SUB,
D3DSIO_MAD,
D3DSIO_MUL,
D3DSIO_RCP,
D3DSIO_RSQ,
D3DSIO_DP3,
D3DSIO_DP4,
D3DSIO_MIN,
D3DSIO_MAX,
D3DSIO_SLT,
D3DSIO_SGE,
D3DSIO_EXP,
D3DSIO_LOG,
D3DSIO_LIT,
D3DSIO_DST,
D3DSIO_LRP,
D3DSIO_FRC,
D3DSIO_M4x4,
D3DSIO_M4x3,
D3DSIO_M3x4,
D3DSIO_M3x3,
D3DSIO_M3x2,
D3DSIO_CALL,
D3DSIO_CALLNZ,
D3DSIO_LOOP,
D3DSIO_RET,
D3DSIO_ENDLOOP,
D3DSIO_LABEL,
D3DSIO_DCL,
D3DSIO_POW,
D3DSIO_CRS,
D3DSIO_SGN,
D3DSIO_ABS,
D3DSIO_NRM,
D3DSIO_SINCOS,
D3DSIO_REP,
D3DSIO_ENDREP,
D3DSIO_IF,
D3DSIO_IFC,
D3DSIO_ELSE,
D3DSIO_ENDIF,
D3DSIO_BREAK,
D3DSIO_BREAKC,
D3DSIO_MOVA,
D3DSIO_DEFB,
D3DSIO_DEFI,
D3DSIO_TEXCOORD,
D3DSIO_TEXKILL,
D3DSIO_TEX,
D3DSIO_TEXBEM,
D3DSIO_TEXBEML,
D3DSIO_TEXREG2AR,
D3DSIO_TEXREG2GB,
D3DSIO_TEXM3x2PAD,
D3DSIO_TEXM3x2TEX,
D3DSIO_TEXM3x3PAD,
D3DSIO_TEXM3x3TEX,
D3DSIO_RESERVED0,
D3DSIO_TEXM3x3SPEC,
D3DSIO_TEXM3x3VSPEC,
D3DSIO_EXPP,
D3DSIO_LOGP,
D3DSIO_CND,
D3DSIO_DEF,
D3DSIO_TEXREG2RGB,
D3DSIO_TEXDP3TEX,
D3DSIO_TEXM3x2DEPTH,
D3DSIO_TEXDP3,
D3DSIO_TEXM3x3,
D3DSIO_TEXDEPTH,
D3DSIO_CMP,
D3DSIO_BEM,
D3DSIO_DP2ADD,
D3DSIO_DSX,
D3DSIO_DSY,
D3DSIO_TEXLDD,
D3DSIO_SETP,
D3DSIO_TEXLDL,
D3DSIO_BREAKP,
D3DSIO_PHASE,
D3DSIO_COMMENT,
D3DSIO_END,
D3DSIO_FORCE_DWORD
} D3DSHADER_INSTRUCTION_OPCODE_TYPE;
Constants
D3DSIO_NOPThe NOP instruction performs a no-op, or no operation. Format instruction token that contains D3DSIO_NOP. |
D3DSIO_MOVThe MOV instruction moves data between registers. Format instruction token that contains D3DSIO_MOV. The instruction length is 2. destination parameter token. source parameter token. Comments Can be used for floating-point data and to update address registers. When used to update address registers, the values are converted from floating-point using rounding to nearest. |
D3DSIO_ADDThe ADD instruction adds two source vectors and stores the result in the destination. Format instruction token that contains D3DSIO_ADD. destination parameter token. first source parameter token. second source parameter token. |
D3DSIO_SUBThe SUB instruction subtracts two source vectors and stores the result in the destination. Format instruction token that contains D3DSIO_SUB. Instruction length is 3. destination parameter token. first source parameter token. second source parameter token. |
D3DSIO_MADThe MAD instruction multiplies the first and second sources and adds the third source. Format instruction token that contains D3DSIO_MAD. Instruction length is 4. destination parameter token. first source parameter token. second source parameter token. third source parameter token. |
D3DSIO_MULThe MUL instruction multiplies two source vectors and stores the result in the destination. Format instruction token that contains D3DSIO_MUL. Instruction length is 3. destination parameter token. first source parameter token. second source parameter token. |
D3DSIO_RCPThe RCP instruction computes the reciprocal of the source and stores the result in the destination. Format instruction token that contains D3DSIO_RCP. Instruction length is 2. destination parameter token. source parameter token. Requires explicit use of replicate swizzle, that is, the X, Y, Z, or W swizzle component (or the R, G, B, or A equivalent) must be specified. |
D3DSIO_RSQThe RSQ instruction computes the reciprocal square root of the source and stores the result in the destination. Format instruction token that contains D3DSIO_RSQ. Instruction length is 2. destination parameter token. source parameter token. Requires explicit use of replicate swizzle, that is, the X, Y, Z, or W swizzle component (or the R, G, B, or A equivalent) must be specified. |
D3DSIO_DP3The DP3 instruction computes the three-component (RGB) dot product of the source registers, and stores the result in the destination. Format instruction token that contains D3DSIO_DP3. Instruction length is 3. destination parameter token. first source parameter token. second source parameter token. |
D3DSIO_DP4The DP4 instruction computes the four-component (RGBA) dot product of the source registers, and stores the result in the destination. Format instruction token that contains D3DSIO_DP4. Instruction length is 3. destination parameter token. first source parameter token. second source parameter token. |
D3DSIO_MINThe MIN instruction determines the minimum of the sources, and stores the minimum source in the destination. Format instruction token that contains D3DSIO_MIN. Instruction length is 3. destination parameter token. first source parameter token. second source parameter token. |
D3DSIO_MAXThe MAX instruction determines the maximum of the sources, and stores the maximum source in the destination. Format instruction token that contains D3DSIO_MAX. Instruction length is 3. destination parameter token. first source parameter token. second source parameter token. |
D3DSIO_SLTThe SLT instruction determines whether the first source is less than the second source, and stores the sign (1.0f for TRUE and 0.0f for FALSE) in the destination. Format instruction token that contains D3DSIO_SLT. Instruction length is 3. destination parameter token. first source parameter token. second source parameter token. |
D3DSIO_SGEThe SGE instruction determines whether the first source is greater than or equal to the second source, and stores the sign (1.0f for TRUE and 0.0f for FALSE) in the destination. Format instruction token that contains D3DSIO_SGE. Instruction length is 3. destination parameter token. first source parameter token. second source parameter token. |
D3DSIO_EXPThe EXP instruction provides full precision exponential 2x. Format instruction token that contains D3DSIO_EXP. Instruction length is 2. destination parameter token. source parameter token. Requires explicit use of replicate swizzle, that is, the X, Y, Z, or W swizzle component (or the R, G, B, or A equivalent) must be specified. Comments The EXP instruction provides at least 21 bits of precision. |
D3DSIO_LOGThe LOG instruction calculates full precision log₂(x). Format instruction token that contains D3DSIO_LOG. Instruction length is 2. destination parameter token. source parameter token. The source parameter token requires explicit use of replicate swizzle, that is, the X, Y, Z, or W swizzle component (or the R, G, B, or A equivalent) must be specified. Comments The LOG instruction provides at least 21 bits of precision. |
D3DSIO_LITThe LIT instruction provides partial support for lighting by calculating lighting coefficients from two dot products and an exponent. Format instruction token that contains D3DSIO_LIT. Instruction length is 2. destination parameter token. source parameter token. Comments Reduced precision arithmetic is acceptable in evaluating the destination Y component (in write mask). An implementation must support at least eight fraction bits in the power argument. Dot products are calculated with normalized vectors, and clamp limits are -128 to 128. Error should correspond to a LOGP and EXPP combination, or no more than approximately one least significant bit (LSB) for an 8-bit color component. |
D3DSIO_DSTThe DST instruction calculates a distance vector, and stores the result in the destination. Format instruction token that contains D3DSIO_DST. Instruction length is 3. destination parameter token. first source parameter token. second source parameter token. |
D3DSIO_LRPThe LRP instruction interpolates linearly between the second and third sources by a proportion specified in the first source, and stores the result in the destination. Format instruction token that contains D3DSIO_LRP. Instruction length is 4. destination parameter token. first source parameter token. second source parameter token. third source parameter token Comments The LRP instruction can be used with floating-point data or integer data. When the LRP instruction is used to update integer registers, the values are converted from floating-point using rounding to the nearest integer. The LRP instruction must be used to update the address registers. |
D3DSIO_FRCThe FRC instruction returns the fractional portion of each input component. Format instruction token that contains D3DSIO_FRC. Instruction length is 2. destination parameter token. source parameter token. Comments Each component of the result is in the range from 0.0 through 1.0. For version vertex or pixel version 1_1, the allowable write masks are Y and XY (X is not allowed). |
D3DSIO_M4x4The M4x4 instruction computes the product of a 4-component vector and a 4x4 matrix, and stores the result in the destination. Format instruction token that contains D3DSIO_M4x4. Instruction length is 3. destination parameter token. The XYZW mask is required. first source parameter token. second source parameter token. Swizzle components and negate modifiers are invalid. |
D3DSIO_M4x3TThe M4x3 instruction computes the product of a 4-component vector and a 4x3 matrix, and stores the result in the destination. Format instruction token that contains D3DSIO_M4x3. Instruction length is 3. destination parameter token. The XYZ mask is required. first source parameter token. second source parameter token. Swizzle components and negate modifiers are invalid. |
D3DSIO_M3x4The M3x4 instruction computes the product of a 3-component vector and a 3x4 matrix, and stores the result in the destination. Format instruction token that contains D3DSIO_M3x4. Instruction length is 3. destination parameter token. The XYZW mask is required. first source parameter token. second source parameter token. Swizzle components and negate modifiers are invalid. |
D3DSIO_M3x3The M3x3 instruction computes the product of a 3-component vector and a 3x3 matrix, and stores the result in the destination. Format instruction token that contains D3DSIO_M3x3. Instruction length is 3. destination parameter token. The XYZ mask is required. first source parameter token. second source parameter token. Swizzle components and negate modifiers are invalid. |
D3DSIO_M3x2The M3x2 instruction computes the product of a 3-component vector and a 3x2 matrix, and stores the result in the destination. Format instruction token that contains D3DSIO_M3x2. Instruction length is 3. destination parameter token. The XY mask is required. first source parameter token. second source parameter token. Swizzle components and negate modifiers are invalid. |
D3DSIO_CALLThe CALL instruction performs a function call to the instruction marked with the provided label index. Format instruction token that contains D3DSIO_CALL. label token (source parameter token using the D3DSPR_LABEL register type). |
D3DSIO_CALLNZThe CALLNZ instruction performs a conditional (if not zero) call to the instruction marked by the label index. Format instruction token that contains D3DSIO_CALLNZ. label token (source parameter token using the D3DSPR_LABEL register type). source parameter token using the D3DSPR_CONSTBOOL register type. |
D3DSIO_LOOPThe LOOP instruction begins a LOOP...ENDLOOP block. Format instruction token that contains D3DSIO_LOOP. first source parameter token using the D3DSPR_LOOP register type. The X component specifies the iteration count; the Y component specifies the initial value of the current loop counter register; and the Z component specifies the increment for the current loop counter register. This register requires explicit use of the replicate swizzle, that is, .XYZW (RGBA) component masks must be specified. Comments Only integer registers can be used in the LOOP instruction. The LOOP instruction is provided for iteration, and supports an auto-incremented loop counter register that can be used to index the constant array. When nested, any time the loop counter register is used, it refers to the current loop. |
D3DSIO_RETThe RET instruction returns from a subroutine or marks the end of the main function. Format instruction token that contains D3DSIO_RET. Comments If a shader contains no subroutines, using RET at the end of the main program is optional. |
D3DSIO_ENDLOOPThe ENDLOOP instruction marks the end of a LOOP block. Format instruction token that contains D3DSIO_ENDLOOP. |
D3DSIO_LABELThe LABEL instruction marks the next instruction with a label index. Format instruction token that contains D3DSIO_LABEL. source parameter token using the D3DSPR_LABEL register type and a register number. |
D3DSIO_DCLSpecifies the DCL instruction token. |
D3DSIO_POWThe POW instruction calculates full precision (first source)second source, and stores the result in the destination. Format instruction token that contains D3DSIO_POW. Instruction length is 3. destination parameter token. first source parameter token. second source parameter token. Comments Both sources require explicit use of replicate swizzle, that is, the X, Y, Z, or W swizzle component (or the R, G, B, or A equivalent) must be specified. The POW instruction provides at least 15 bits of precision. |
D3DSIO_CRSThe CRS instruction computes a cross product using the right-hand rule. Format instruction token that contains D3DSIO_CRS. destination parameter token. first source parameter token. second source parameter token. |
D3DSIO_SGNThe SGN instruction determines the sign of the source and stores the sign (-1 for negative, 0 for 0, and 1 for positive) in the destination. Format instruction token that contains D3DSIO_SGN. Instruction length is 4. destination parameter token. first source parameter token. second source parameter token using the D3DSPR_TEMP register type. third source parameter token using the D3DSPR_TEMP register type. Comments The second and third sources could be used as temporary registers. |
D3DSIO_ABSThe ABS instruction computes the absolute value of the source and stores the result in the destination. Format instruction token that contains D3DSIO_ABS. destination parameter token. source parameter token. |
D3DSIO_NRMThe NRM instruction normalizes a 4-D vector. Format instruction token that contains D3DSIO_NRM. Instruction length is 2. destination parameter token. source parameter token. |
D3DSIO_SINCOSThe SINCOS instruction computes sine and cosine of the source. |
D3DSIO_REPThe REP instruction starts a REPEAT...ENDREP block. Format instruction token that contains D3DSIO_REP. source parameter token using the D3DSPR_CONSTINT register type. The X component specifies the iteration count. Comments Only integer registers can be used in the REP instruction. |
D3DSIO_ENDREPThe ENDREP instruction marks the end of a REP block. Format instruction token that contains D3DSIO_ENDREP. |
D3DSIO_IFThe IF instruction begins an IF block. Format instruction token that contains D3DSIO_IF. source parameter token using the D3DSPR_CONSTBOOL register type. Comments If the source Boolean register is TRUE, the code enclosed by the IF statement and the matching ELSE (or ENDIF if ELSE is not used) is executed; otherwise the execution passes to the code enclosed by the ELSE-ENDIF statements (ELSE exists) or out of the IF block (ELSE does not exist). |
D3DSIO_IFCThe IFC instruction begins an IF block with a comparison. Format instruction token that contains D3DSIO_IFC. first source parameter token. second source parameter token. Comments The IFC instruction skips a block of code, based on the comparison between sources. Both sources require explicit use of replicate swizzle, that is, the X, Y, Z, or W swizzle component (or the R, G, B, or A equivalent) must be specified. If the comparison between all source components is TRUE, the code enclosed by the IF statement and the matching ELSE instruction (or ENDIF instruction if ELSE is not used) is executed; otherwise the execution passes to the code enclosed by the ELSE-ENDIF statements (ELSE exists) or out of the IF block (ELSE does not exist). |
D3DSIO_ELSEThe ELSE instruction starts an ELSE block. Format instruction token that contains D3DSIO_ELSE. Comments If the source Boolean register in the corresponding IF instruction is true, the code that is enclosed by the IF and the matching ELSE is executed, otherwise execution passes to the code that is enclosed by the ELSE and the ENDIF instructions. |
D3DSIO_ENDIFThe ENDIF instruction ends an IF...ELSE block. Format instruction token that contains D3DSIO_ENDIF. |
D3DSIO_BREAKThe BREAK instruction breaks out of the current loop at the nearest endloop or endrep. Format instruction token that contains D3DSIO_BREAK. |
D3DSIO_BREAKCThe BREAKC instruction breaks out of the current loop at the nearest endloop or endrep, based on the comparison criteria between two sources. Format instruction token that contains D3DSIO_BREAKC. first source parameter token. second source parameter token. |
D3DSIO_MOVAThe MOVA instruction moves data from floating-point register to integer register. Format instruction token that contains D3DSIO_MOVA. Instruction length is 2. destination parameter token. source parameter token. Comments The values are converted from floating-point using rounding to nearest. The address register is the only destination register allowed. |
D3DSIO_DEFBThe DEFB instruction defines a Boolean constant value, which should be loaded anytime a shader is set to a device. This instruction can be used in vertex shader 2_0 and later versions. Boolean constants that are set by the current vertex shader take precedence over constants that are set by the D3DDP2OP_SETVERTEXSHADERCONSTB operation. Format instruction token that contains D3DSIO_DEFB. Instruction length is 2. destination parameter token. The register type must be D3DSPR_CONSTBOOL. DWORD token contains the Boolean value, where nonzero indicates TRUE; zero indicates FALSE. |
D3DSIO_DEFIThe DEFI instruction defines an integer constant value, which should be loaded anytime a shader is set to a device. Constants that are set by the current vertex shader take precedence over constants that are set by the D3DDP2OP_SETVERTEXSHADERCONSTI operation. Format instruction token that contains D3DSIO_DEFI. Instruction length is 5. destination parameter token. The register type must be D3DSPR_CONSTINT. 4 DWORD token contains four 32-bit signed integers. |
D3DSIO_TEXCOORDThe TEXCOORD instruction copies texture coordinate data (UVW1) as color data (RGBA). Format instruction token that contains D3DSIO_TEXCOORD. destination parameter token. source parameter token. The source parameter token is for pixel shader version 1_4 only. Comments The texcoord and texcrd assembler instructions both use the D3DSIO_TEXCOORD operation code. The texcoord instruction applies to pixel shader versions 1_0 through 1_3; it has one destination parameter token and no source parameter token associated with it. The texcrd instruction applies to pixel shader version 1_4; it has one destination parameter token and one source parameter token associated with it. |
D3DSIO_TEXKILLThe TEXKILL instruction cancels rendering of the current pixel if any of the first three components (UVW) of the texture coordinates is less than zero. Format instruction token that contains D3DSIO_TEXKILL. destination parameter token (behaves similarly to a source token). Comments If any of the components of the destination token is less than zero, terminate the pixel shader and discard the outputs. The following features apply to the destination token:
|
D3DSIO_TEXThe TEX instruction loads destination with color data (RGBA) that is sampled from the source texture. Format instruction token that contains D3DSIO_TEX. destination parameter token using the D3DSPR_PREDICATE register type. The following source tokens are for pixel shader version 1_4 and later only: - first source parameter token provides the texture coordinates for the texture sample. - second source parameter token using the D3DSPR_SAMPLER register type. The second source parameter token identifies the texture sampler number to sample. Comments The tex and texld assembler instructions both use the D3DSIO_TEX operation code. The tex instruction applies to pixel shader versions 1_0 through 1_3; it has one destination parameter token and no source parameter tokens associated with it. The texld instruction applies to pixel shader version 1_4 and later; it has one destination parameter token and two source parameter tokens associated with it. |
D3DSIO_TEXBEMThe TEXBEM instruction applies a bump environment-map transform by modifying the texture address data of the destination register, using address perturbation data (U,V), and a 2-D bump environment matrix. Format instruction token that contains D3DSIO_TEXBEM. destination parameter token. source parameter token. |
D3DSIO_TEXBEMLThe TEXBEML instruction applies a bump environment-map transform with luminance correction. Format instruction token that contains D3DSIO_TEXBEML. destination parameter token. source parameter token. Comments The bump environment-map transform with luminance correction is accomplished by modifying the texture address data of the destination register, using address perturbation data (U.V), a 2-D bump environment matrix, and luminance. |
D3DSIO_TEXREG2ARThe TEXREG2AR instruction interprets the alpha and red color components of the source as texture address data (U,V) in order to sample the texture at the stage corresponding to the destination register number. The result is stored in the destination. Format instruction token that contains D3DSIO_TEXREG2AR. destination parameter token. source parameter token. Comments The TEXREG2AR instruction is useful for color-space remapping operations. It supports two-dimensional (2-D) coordinates. The source register must use unsigned data; if the source register uses signed or mixed data, the operation produces invalid results. |
D3DSIO_TEXREG2GBThe TEXREG2GB instruction interprets the green and blue color components of the source as texture address data (U,V) in order to sample the texture at the stage corresponding to the destination register number. The result is stored in the destination. Format instruction token that contains D3DSIO_TEXREG2GB. destination parameter token. source parameter token. Comments The TEXREG2GB instruction is useful for color-space remapping operations. It supports two-dimensional (2-D) coordinates. The source register must use unsigned data; if the source register uses signed or mixed data, the operation produces invalid results. |
D3DSIO_TEXM3x2PADThe TEXM3x2PAD instruction performs the first row multiplication of a two-row matrix multiply. Format instruction token that contains D3DSIO_TEXM3x2PAD. destination parameter token. source parameter token. Comments The TEXM3x2PAD instruction cannot be used by itself; it must be combined with either the TEXM3x2TEX or TEXM3x2DEPTH instructions. |
D3DSIO_TEXM3x2TEXThe TEXM3x2TEX instruction performs the final row of a 3x2 matrix multiply and uses the result in a texture lookup. Format instruction token that contains D3DSIO_TEXM3x2TEX. destination parameter token. source parameter token. Comments The TEXM3x2TEX instruction must be used with the TEXM3x2PAD instruction. |
D3DSIO_TEXM3x3PADThe TEXM3x3PAD instruction performs the first or second row multiply of a three-row matrix multiply. Format instruction token that contains D3DSIO_TEXM3x3PAD. destination parameter token. source parameter token. Comments The TEXM3x3PAD instruction cannot be used by itself; it must be combined with the TEXM3x3 instruction, TEXM3x3SPEC instruction, TEXM3x3VSPEC instruction, or TEXM3x3TEX instruction. |
D3DSIO_TEXM3x3TEXThe TEXM3x3TEX instruction performs a 3x3 matrix multiply and uses the result in a texture lookup. Format instruction token that contains D3DSIO_TEXM3x3TEX. destination parameter token. source parameter token. Comments The TEXM3x3TEX instruction must be used with two TEXM3x3PAD instructions. It is used as the final of three instructions representing a 3x3 matrix multiply operation, followed by a texture lookup. The 3x3 matrix is comprised of the texture coordinates of the third texture stage and the two preceding texture stages. The resulting three-component vector (U,V,W) is used to sample the texture in stage 3. Any texture assigned to the preceding two texture stages is ignored. The 3x3 matrix multiply is typically useful for orienting a normal vector to the correct tangent space for the surface being rendered. |
D3DSIO_RESERVED0This instruction is reserved for internal use. |
D3DSIO_TEXM3x3SPECThe TEXM3x3SPEC instruction performs a 3x3 matrix multiply and uses the result in a texture lookup. Used for specular reflection and environment mapping. Format instruction token that contains D3DSIO_TEXM3x3SPEC. destination parameter token. first source parameter token. second source parameter token. Comments The TEXM3x3SPEC instruction must be used with two TEXM3x3PAD instruction. This instruction set can be used for specular reflection and environment mapping. The TEXM3x3SPEC instruction performs the final row of a 3x3 matrix multiply, uses the resulting vector as a normal vector to reflect an eye-ray vector, and then uses the reflected vector to perform a texture lookup. The shader reads the eye-ray vector from a constant register. The 3x3 matrix multiply is typically useful for orienting a normal vector to the correct tangent space for the surface being rendered. The 3x3 matrix is comprised of the texture coordinates of the third texture stage and the two preceding texture stages. The resulting post reflection vector (U,V,W) is used to sample the texture on the final texture stage. Any texture assigned to the preceding two texture stages is ignored. |
D3DSIO_TEXM3x3VSPECThe TEXM3x3VSPEC instruction performs a 3x3 matrix multiply and uses the result in a texture lookup. Format instruction token that contains D3DSIO_TEXM3x3VSPEC. destination parameter token. source parameter token. Comments The TEXM3x3VSPEC instruction must be used with two TEXM3x3PAD instructions. This instruction set can be used for specular reflection and environment mapping where the eye-ray vector is not constant. If the eye-ray vector is constant, the TEXM3x3SPEC instruction performs the same matrix multiply and texture lookup. The TEXM3x3VSPEC instruction performs the final row of a 3x3 matrix multiply operation, interprets the resulting vector as a normal vector to reflect an eye-ray vector, and then uses the reflected vector as a texture address for a texture lookup. It works just like TEXM3X3SPEC, except that the eye-ray vector is taken from the fourth component of the texture coordinates. The 3x3 matrix multiply is typically useful for orienting a normal vector to the correct tangent space for the surface being rendered. The 3x3 matrix is comprised of the texture coordinates of the third texture stage and the two preceding texture stages. The resulting postreflection vector (UVW) is used to sample the texture in stage 3. Any texture assigned to the preceding two texture stages is ignored. |
D3DSIO_EXPPThe EXPP instruction provides partial precision exponential 2x. Format instruction token that contains D3DSIO_EXPP. Instruction length is 2. destination parameter token. source parameter token. Requires explicit use of replicate swizzle, that is, the X, Y, Z, or W swizzle component (or the R, G, B, or A equivalent) must be specified. Comments The EXPP instruction provides at least 10 bits of precision. |
D3DSIO_LOGPThe LOGP instruction calculates partial precision log₂(x). Format instruction token that contains D3DSIO_LOGP. Instruction length is 2. destination parameter token. source parameter token. Requires explicit use of replicate swizzle, that is, the X, Y, Z, or W swizzle component (or the R, G, B, or A equivalent) must be specified. Comments The LOGP instruction provides at least 10 bits of precision. |
D3DSIO_CNDThe CND instruction chooses between the second and third sources, based on the first source being greater than 0.5, and stores the result in the destination. Format instruction token that contains D3DSIO_CND. destination parameter token. first source parameter token. second source parameter token. third source parameter token. |
D3DSIO_DEFThe DEF instruction defines a constant value, which should be loaded anytime a shader is set to a device. This instruction can be used in all vertex shader versions. Constants that are set by the current vertex shader take precedence over constants that are set by the D3DDP2OP_SETVERTEXSHADERCONST operation. Format instruction token that contains D3DSIO_DEF. Instruction length is 5. destination parameter token. The register type must be D3DSPR_CONST, D3DSPR_CONST2, D3DSPR_CONST3, or D3DSPR_CONST4. 4 DWORD tokens. A 4-D floating-point number or 4-D integer number. |
D3DSIO_TEXREG2RGBThe TEXREG2RGB instruction interprets the red, green, and blue (RGB) color components of the source as texture address data (U,V,W) in order to sample the texture at the stages corresponding to the destination register number. The result is stored in the destination. Format instruction token that contains D3DSIO_TEXREG2RGB. destination parameter token. source parameter token. Comments The TEXREG2RGB instruction is useful for color-space remapping operations. It supports two-dimensional (2-D) and three-dimensional (3-D) coordinates. It can be used just like the TEXREG2AR instruction or TEXREG2GB instruction to remap 2-D data. However, the TEXREG2RGB instruction also supports 3-D data so it can be used with cube maps and 3-D volume textures. |
D3DSIO_TEXDP3TEXThe TEXDP3TEX instruction performs three-component dot product and uses the result to do a 1-D texture lookup. Format instruction token that contains D3DSIO_TEXDP3TEX. destination parameter token. source parameter token. |
D3DSIO_TEXM3x2DEPTHThe TEXM3x2DEPTH instruction calculates the depth value to be used in depth testing for a pixel. Format instruction token that contains D3DSIO_TEXM3x2DEPTH. destination parameter token. source parameter token. Comments The TEXM3x2DEPTH instruction must be used with the TEXM3x2PAD instruction. |
D3DSIO_TEXDP3The TEXDP3 instruction performs a three-component dot product between data in the texture register number and the texture coordinate set corresponding to the destination register number. Format instruction token that contains D3DSIO_TEXDP3. destination parameter token. source parameter token. |
D3DSIO_TEXM3x3The TEXM3x3 instruction performs 3x3 matrix multiply when used in conjunction with two TEXM3x3PAD instructions. Format instruction token that contains D3DSIO_TEXM3x3. destination parameter token. source parameter token. Comments The TEXM3x3 instruction must be used with two TEXM3X3PAD instructions. It is used as the final of three instructions representing a 3x3 matrix multiply operation. The 3x3 matrix is comprised of the texture coordinates of the third texture stage, and by the two preceding texture stages. Any texture assigned to any of the three texture stages is ignored. The TEXM3x3 instruction is the same as the TEXM3x3TEX instruction, without the texture lookup. |
D3DSIO_TEXDEPTHThe TEXDEPTH instruction calculates depth value to be used in pixel depth buffer comparison test. Format instruction token that contains D3DSIO_TEXDEPTH. destination parameter token. |
D3DSIO_CMPThe CMP instruction chooses between the second and third sources, based on the first source being greater than or equal to zero, and stores the result in the destination. The comparison is done per channel. Format instruction token that contains D3DSIO_CMP. destination parameter token. first source parameter token. second source parameter token. third source parameter token. |
D3DSIO_BEMThe BEM instruction applies a bump environment-map transform. Format instruction token that contains D3DSIO_BEM. destination parameter token. first source parameter token. second source parameter token. |
D3DSIO_DP2ADDThe DP2ADD instruction performs a 2-D dot product and scalar addition, and stores the result in the destination. Format instruction token that contains D3DSIO_DP2ADD. Instruction length is 4. destination parameter token. first source parameter token. second source parameter token. third source parameter token. |
D3DSIO_DSXThe DSX instruction computes the rate of change of the source in the x direction, and stores the result in the destination. Format instruction token that contains D3DSIO_DSX. Instruction length is 2. destination parameter token. Accepts all write masks. source parameter token. Accepts all swizzles. Comments The DSX instruction always computes gradients on the current contents of registers in pixels, regardless of whether the pixels are active either due to flow control or due to being off the edge of a primitive. These pixels are executed in lockstep. |
D3DSIO_DSYThe DSY instruction computes the rate of change of the source in the y direction, and stores the result in the destination. Format instruction token that contains D3DSIO_DSY. Instruction length is 2. destination parameter token. Accepts all write masks. source parameter token. Accepts all swizzles. Comments The DSY instruction always computes gradients on the current contents of registers in pixels, regardless of whether the pixels are active either due to flow control or due to being off the edge of a primitive. These pixels are executed in lockstep. |
D3DSIO_TEXLDDThe TEXLDD instruction samples a texture using the texture coordinates in the first source token, the sampler specified by the second source token, and the gradients (DSX and DSY) from the third and fourth source tokens. Format instruction token that contains D3DSIO_TEXLDD. Instruction length is 5. destination parameter token. Accepts all write masks. first source parameter token. second source parameter token that must use the D3DSPR_SAMPLER register type. The sampler states that are supported are D3DSAMP_MAXMIPLEVEL and D3DSAMP_MIPMAPLODBIAS. Comments All sources support arbitrary swizzles. All write masks are valid on the destination. |
D3DSIO_SETPThe SETP instruction sets the predicate register. Format instruction token that contains D3DSIO_SETP. Instruction length is 3. destination parameter token using the D3DSPR_PREDICATE register type. Requires write masks. first source parameter token. Swizzle components must be specified. second source parameter token. Swizzle components must be specified. Comments For each channel that can be written according to the destination write mask, save the Boolean result of the comparison operation between the corresponding channels of the sources (after the source modifier swizzles are resolved). |
D3DSIO_TEXLDLThe TEXLDL instruction samples a texture at a particular sampler using the provided texture coordinates. The particular level of detail (LOD) that is sampled must be specified as the fourth (W) component of the texture coordinate. Format instruction token that contains D3DSIO_TEXLDL. Instruction length is 3. destination parameter token using the D3DSPR_PREDICATE register type. first source parameter token provides the texture coordinates for the texture sample. second source parameter token using the D3DSPR_SAMPLER register type. Identifies the texture sampler number to sample. The Negate source modifier cannot be specified. Swizzle can be specified. The sampler number must be declared at the beginning of the shader. Comments The default values for missing components of the destination token's write mask are either 0 or 1, and depend on the texture format. The number of coordinates that are required to perform the texture sample depends on how the sampler number was declared. If it was declared as a cube, a 3-component texture coordinate (RGB) is required. Validation enforces that coordinates that are provided to texld are sufficient for the texture dimension that is declared for the sampler. Sampling a texture with lower dimensions than are present in the texture coordinate is valid. Conversely, sampling a texture with higher dimensions than are present in the texture coordinate is invalid. Sampling unsigned RGB textures results in float values that are from 0.0 to 1.0. Sampling signed textures results in float values that are from -1.0 to 1.0. Sampling floating-point textures results in either the Float16 to MAX_FLOAT16 range being preserved, or the Float32 to Max range of pipeline being preserved. |
D3DSIO_BREAKPThe BREAK PRED instruction breaks out of the current loop at the nearest endloop or endrep by using one of the components of the predicate register as a condition to determine whether to perform the instruction. Format instruction token that contains D3DSIO_BREAKP. source parameter token using the D3DSPR_PREDICATE register type with a replicate swizzle (each channel uses the same source component). The NOT (0xd) source modifier in bits 27:24 is permitted. |
D3DSIO_PHASEApplies to Pixel shader version 1_4 only. The PHASE instruction marks the transition between pixel shader version 1 and 2. If no phase instruction is present, the entire shader runs as if it is a phase 2 shader. Format instruction token that contains D3DSIO_PHASE. Comments Shader instructions that occur before the PHASE instruction are phase 1 instructions. All other instructions are phase 2 instructions. By having two phases for instructions, the maximum number of instructions per shader is increased. The alpha component of temporary registers do not persist across the phase transition. In other words, the alpha component must be reinitialized after the phase instruction. |
D3DSIO_COMMENTSpecifies the comment token. |
D3DSIO_ENDSpecifies the end token. |
D3DSIO_FORCE_DWORDForces a 32-bit size. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows Vista and later versions of the Windows operating systems. |
| Header | d3d9types.h |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for