NAME
    round - returns the rounded value of scalars or vectors

SYNOPSIS
      float  round( float  a );
      float1 round( float1 a );
      float2 round( float2 a );
      float3 round( float3 a );
      float4 round( float4 a );
 
      half   round( half  a );
      half1  round( half1 a );
      half2  round( half2 a );
      half3  round( half3 a );
      half4  round( half4 a );
 
      fixed  round( fixed  a );
      fixed1 round( fixed1 a );
      fixed2 round( fixed2 a );
      fixed3 round( fixed3 a );
      fixed4 round( fixed4 a );

PARAMETERS
    a       Scalar or vector.

DESCRIPTION
    Returns the rounded value of a scalar or vector.

    For vectors, the returned vector contains the rounded value of each
    element of the input vector.

    The round operation returns the nearest integer to the operand. The
    value returned by round() if the fractional portion of the operand is
    0.5 is profile dependent. On older profiles without built-in round()
    support, round-to-nearest up rounding is used. On profiles newer than
    fp40/vp40, round-to-nearest even is used.

REFERENCE IMPLEMENTATION
    round for float could be implemented this way:

      // round-to-nearest even profiles
      float round(float a)
      {
        float x = a + 0.5;
        float f = floor(x);
        if (x == f) {
          if (a > 0)
            r = f - fmod(f, 2);
          else  
            r = f + fmod(f, 2);
        }
      }

      // round-to-nearest up profiles
      float round(float a)
      {
        return floor(x + 0.5);
      }

PROFILE SUPPORT
    round is supported in all profiles except fp20.

SEE ALSO
    the ceil manpage, the floor manpage, the fmod manpage

