Instructions - vs_3_0

This section contains reference information for the vertex shader version 3_0 instructions.

There are several types of vertex shader instructions, as shown in the table. Columns to the right mean the following:

  • Instruction slots - Number of instruction slots used by each instruction.
  • Setup - Non-arithmetic instructions. Every shader must have a version instruction and it must be the first instruction.
  • Arithmetic - These instructions provide the mathematical operations in a shader.
  • Texture - These instructions support texture address lookup.
  • Flow control - These instructions add flow control such as loops, repeats, and if bool - vs...else...endif comparisons.
  • New - These instructions are new to this version.

Instruction Set

Name Description Instruction slots Setup Arithmetic Texture Flow control New
abs - vs Absolute value 1 x
add - vs Add two vectors 1 x
break - vs Break out of a loop - vs...endloop - vs or rep...endrep block 1 x
break_comp - vs Conditionally break out of a loop - vs...endloop - vs or rep...endrep block, with a comparison 3 x
breakp - vs Break out of a loop - vs...endloop - vs or rep...endrep block, based on a predicate 3 x
call - vs Call a subroutine 2 x
callnz bool - vs Call a subroutine if a Boolean register is not zero 3 x
callnz pred - vs Call a subroutine if a predicate register is not zero 3 x
crs - vs Cross product 2 x
dcl_usage input (sm1, sm2, sm3 - vs asm) Declare input vertex registers (see Registers - vs_3_0) 0 x
dcl_samplerType (sm3 - vs asm) Declare the texture dimension for a sampler 0 x x
def - vs Define constants 0 x
defb - vs Declare a Boolean constant 0 x
defi - vs Declare an integer constant 0 x
dp3 - vs Three-component dot product 1 x
dp4 - vs Four-component dot product 1 x
dst - vs Distance 1 x
else - vs Begin an else block 1 x
endif - vs End an if bool - vs...else block 1 x
endloop - vs End of a loop - vs block 2 x
endrep - vs End of a repeat block 2 x
exp - vs Full precision 2x 1 x
exp - vs Partial precision 2x 1 x
frc - vs Fractional component 1 x
if bool - vs Begin an if bool - vs block (using a Boolean condition) 3 x
if_comp - vs Begin an if bool - vs block, with a comparison 3 x
if pred - vs Begin an if bool - vs block with a predicate condition 3 x
label - vs Label 0 x
lit - vs Calculate lighting 3 x
log - vs Full precision log₂(x) 1 x
logp - vs Partial precision log₂(x) 1 x
loop - vs Loop 3 x
lrp - vs Linear interpolation 2 x
m3x2 - vs 3x2 multiply 2 x
m3x3 - vs 3x3 multiply 3 x
m3x4 - vs 3x4 multiply 4 x
m4x3 - vs 4x3 multiply 3 x
m4x4 - vs 4x4 multiply 4 x
mad - vs Multiply and add 1 x
max - vs Maximum 1 x
min - vs Minimum 1 x
mov - vs Move 1 x
mova - vs Move data from a floating point register to an integer register 1 x
mul - vs Multiply 1 x
nop - vs No operation 1 x
nrm - vs Normalize 3 x
pow - vs xy 3 x
rcp - vs Reciprocal 1 x
rep - vs Repeat 3 x
ret - vs End of a subroutine 1 x
rsq - vs Reciprocal square root 1 x
setp_comp - vs Set the predicate register 1 x
sge - vs Greater than or equal compare 1 x
sgn - vs Sign 3 x
sincos - vs Sine and cosine 8 x
slt - vs Less than compare 1 x
sub - vs Subtract 1 x
texldl - vs Texture load with user-adjustable level-of-detail See note 1 x x
vs Version 0 x

 

Notes:

  • if the texture is a cube map, slots = 5; otherwise slots = 2

Vertex Shader Instructions