MIPS-3D Built-in Functions - Using the GNU Compiler Collection (GCC)
Description: Using the GNU Compiler Collection (GCC)

Previous: Paired-Single Built-in Functions, Up: MIPS Loongson Built-in Functions

##### 6.54.9.3 MIPS-3D Built-in Functions

The MIPS-3D Application-Specific Extension (ASE) includes additional paired-single instructions that are designed to improve the performance of 3D graphics operations. Support for these instructions is controlled by the `-mips3d` command-line option.

The functions listed below map directly to a particular MIPS-3D instruction. Please refer to the architecture specification for more details on what each instruction does.

`v2sf __builtin_mips_addr_ps (v2sf, v2sf)`
  Reduction add (`addr.ps`).
`v2sf __builtin_mips_mulr_ps (v2sf, v2sf)`
  Reduction multiply (`mulr.ps`).
`v2sf __builtin_mips_cvt_pw_ps (v2sf)`
  Convert paired single to paired word (`cvt.pw.ps`).
`v2sf __builtin_mips_cvt_ps_pw (v2sf)`
  Convert paired word to paired single (`cvt.ps.pw`).
`float __builtin_mips_recip1_s (float)`
`double __builtin_mips_recip1_d (double)`
`v2sf __builtin_mips_recip1_ps (v2sf)`
  Reduced precision reciprocal (sequence step 1) (`recip1.`fmt).
`float __builtin_mips_recip2_s (float, float)`
`double __builtin_mips_recip2_d (double, double)`
`v2sf __builtin_mips_recip2_ps (v2sf, v2sf)`
  Reduced precision reciprocal (sequence step 2) (`recip2.`fmt).
`float __builtin_mips_rsqrt1_s (float)`
`double __builtin_mips_rsqrt1_d (double)`
`v2sf __builtin_mips_rsqrt1_ps (v2sf)`
  Reduced precision reciprocal square root (sequence step 1) (`rsqrt1.`fmt).
`float __builtin_mips_rsqrt2_s (float, float)`
`double __builtin_mips_rsqrt2_d (double, double)`
`v2sf __builtin_mips_rsqrt2_ps (v2sf, v2sf)`
  Reduced precision reciprocal square root (sequence step 2) (`rsqrt2.`fmt).

The following multi-instruction functions are also available. In each case, cond can be any of the 16 floating-point conditions: `f`, `un`, `eq`, `ueq`, `olt`, `ult`, `ole`, `ule`, `sf`, `ngle`, `seq`, `ngl`, `lt`, `nge`, `le` or `ngt`.

`int __builtin_mips_cabs_`cond`_s (float` a`, float` b`)`
`int __builtin_mips_cabs_`cond`_d (double` a`, double` b`)`
  Absolute comparison of two scalar values (`cabs.`cond`.`fmt, `bc1t`/`bc1f`).

  These functions compare a and b using `cabs.`cond`.s` or `cabs.`cond`.d` and return the result as a boolean value. For example:

                float a, b;
                if (__builtin_mips_cabs_eq_s (a, b))
                  true ();
                else
                  false ();

`int __builtin_mips_upper_cabs_`cond`_ps (v2sf` a`, v2sf` b`)`
`int __builtin_mips_lower_cabs_`cond`_ps (v2sf` a`, v2sf` b`)`
  Absolute comparison of two paired-single values (`cabs.`cond`.ps`, `bc1t`/`bc1f`).

  These functions compare a and b using `cabs.`cond`.ps` and return either the upper or lower half of the result. For example:

                v2sf a, b;
                if (__builtin_mips_upper_cabs_eq_ps (a, b))
                  upper_halves_are_equal ();
                else
                  upper_halves_are_unequal ();

                if (__builtin_mips_lower_cabs_eq_ps (a, b))
                  lower_halves_are_equal ();
                else
                  lower_halves_are_unequal ();

`v2sf __builtin_mips_movt_cabs_`cond`_ps (v2sf` a`, v2sf` b`, v2sf` c`, v2sf` d`)`
`v2sf __builtin_mips_movf_cabs_`cond`_ps (v2sf` a`, v2sf` b`, v2sf` c`, v2sf` d`)`
  Conditional move based on absolute comparison (`cabs.`cond`.ps`, `movt.ps`/`movf.ps`).

  The `movt` functions return the value x computed by:

                cabs.cond.ps cc,a,b
                mov.ps x,c
                movt.ps x,d,cc

  The `movf` functions are similar but use `movf.ps` instead of `movt.ps`.

`int __builtin_mips_any_c_`cond`_ps (v2sf` a`, v2sf` b`)`
`int __builtin_mips_all_c_`cond`_ps (v2sf` a`, v2sf` b`)`
`int __builtin_mips_any_cabs_`cond`_ps (v2sf` a`, v2sf` b`)`
`int __builtin_mips_all_cabs_`cond`_ps (v2sf` a`, v2sf` b`)`
  Comparison of two paired-single values (`c.`cond`.ps`/`cabs.`cond`.ps`, `bc1any2t`/`bc1any2f`).

  These functions compare a and b using `c.`cond`.ps` or `cabs.`cond`.ps`. The `any` forms return true if either result is true and the `all` forms return true if both results are true. For example:

                v2sf a, b;
                if (__builtin_mips_any_c_eq_ps (a, b))
                  one_is_true ();
                else
                  both_are_false ();

                if (__builtin_mips_all_c_eq_ps (a, b))
                  both_are_true ();
                else
                  one_is_false ();

`int __builtin_mips_any_c_`cond`_4s (v2sf` a`, v2sf` b`, v2sf` c`, v2sf` d`)`
`int __builtin_mips_all_c_`cond`_4s (v2sf` a`, v2sf` b`, v2sf` c`, v2sf` d`)`
`int __builtin_mips_any_cabs_`cond`_4s (v2sf` a`, v2sf` b`, v2sf` c`, v2sf` d`)`
`int __builtin_mips_all_cabs_`cond`_4s (v2sf` a`, v2sf` b`, v2sf` c`, v2sf` d`)`
  Comparison of four paired-single values (`c.`cond`.ps`/`cabs.`cond`.ps`, `bc1any4t`/`bc1any4f`).

  These functions use `c.`cond`.ps` or `cabs.`cond`.ps` to compare a with b and to compare c with d. The `any` forms return true if any of the four results are true and the `all` forms return true if all four results are true. For example:

                v2sf a, b, c, d;
                if (__builtin_mips_any_c_eq_4s (a, b, c, d))
                  some_are_true ();
                else
                  all_are_false ();

                if (__builtin_mips_all_c_eq_4s (a, b, c, d))
                  all_are_true ();
                else
                  some_are_false ();