setp (Vertex Shader)

---

Set the predicate register.

Syntax

setp_comp dst, src0, src1

Where:

• _comp is a per-channel comparison between the two source registers. It can be one of the following:

  Syntax	Comparison
  _gt	Greater than
  _lt	Less than
  _ge	Greater than or equal
  _le	Less than or equal
  _eq	Equal to
  _ne	Not equal to

• dst is the Predicate register, p0.
• src0 is a source register.
• src1 is a source register.

Remarks

Vertex shader versions	1_1	2_0	2_x	2_sw	3_0	3_sw
setp			x	x	x	x

This instruction operates as:

per channel in destination write mask
{
  dst.channel = src0.channel cmp src1.channel
}

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 src0 and src1 (after the source modifier swizzles have been resolved).

Source registers allow arbitrary component swizzles to be specified.

The destination register allows arbitrary write masks.

The dest register must be the predicate register.

Applying the Predicate Register

Once the predicate register has been initialized with setp, it can be used to control an instruction per component. Here's the syntax:

([!]p0[.swizzle]) instruction dest, srcReg, ...

Where:

• [!] is an optional boolean NOT
• p0 is the predicate register
• [.swizzle] is an optional swizzle to apply to the contents of the predicate register before using it to mask the instruction. The available swizzles are: .xyzw (default when none specified), or any replicate swizzle: .x/.r, .y/.g, .z/.b or .a/.w.
• instruction is any aritmetic, or texture instruction. This cannot be a static or dynamic flow control instruction.
• dest, srcReg, ... are the registers required by the instruction

Assuming the predicate register has been set up with (true, true, false, false) component values, it can be applied to this instruction:

// given r0 = 0,0,1,1
// given r1 = 1,1,0,0
setp_le p0, r0, r1
(p0) add r2, r3, r4

to perform a 2 component add.

r2.x = r3.x + r4.x
r2.y = r3.y + r4.y

The x and y components of r1 will not be written since the predicate register contained false in components z and w.

Applying the predicate register to an arithmetic or texture instruction increases it's instruction slot count by 1.

The predicate register can also be applied to if pred, callnz pred and break pred instructions. These flow control instructions do not have any increase in the instruction slot count when using the predicate register.

For these instructions, the slot count is what is listed in the slot count table (link?), and there is no increment of 1 as in other cases.

Minimum operating system	Windows 98