Funciones intrínsecas
En la tabla siguiente, se enumeran las funciones intrínsecas disponibles en HLSL. Cada función tiene una breve descripción y un vínculo a una página de referencia que incluye más detalles sobre el argumento de entrada y el tipo de valor devuelto.
| Nombre | Descripción | Modelo de sombreador mínimo |
|---|---|---|
| abort | Finaliza la llamada de dibujo o distribución actual que se está ejecutando. | 4 |
| abs | Valor absoluto (por componente). | 1¹ |
| acos | Devuelve el arcocoseno de cada componente de x. | 1¹ |
| all | Prueba si todos los componentes de x son distintos de cero. | 1¹ |
| AllMemoryBarrier | Bloquea la ejecución de todos los subprocesos de un grupo hasta que se hayan completado todos los accesos a la memoria. | 5 |
| AllMemoryBarrierWithGroupSync | Bloquea la ejecución de todos los subprocesos de un grupo hasta que se hayan completado todos los accesos a la memoria y todos los subprocesos en el grupo hayan alcanzado esta llamada. | 5 |
| cualquiera | Prueba si algún componente de x es distinto de cero. | 1¹ |
| asdouble | Reinterpreta un valor convertido en un doble. | 5 |
| asfloat | Convierte el tipo de entrada en un valor flotante. | 4 |
| asin | Devuelve el arcoseno de cada componente de x. | 1¹ |
| asint | Convierte el tipo de entrada en un entero. | 4 |
| asuint | Reinterpreta el patrón de bits de un tipo de 64 bits en un entero sin signo. | 5 |
| asuint | Convierte el tipo de entrada en un entero sin signo. | 4 |
| atan | Devuelve el arcotangente de x. | 1¹ |
| atan2 | Devuelve el arcotangente de dos valores (x, y). | 1¹ |
| ceil | Devuelve el entero más pequeño que es mayor que o igual a x. | 1¹ |
| CheckAccessFullyMapped | Determina si todos los valores de una operación de muestra o carga a la que se ha accedido asignó mosaicos en un recurso en mosaico. | 5 |
| clamp | Fija x al rango [mín., máx.]. | 1¹ |
| clip | Descarta el píxel actual, si algún componente de x es menor que cero. | 1¹ |
| cos | Devuelve el coseno de x. | 1¹ |
| cosh | Devuelve el coseno hiperbólico de x. | 1¹ |
| countbits | Cuenta el número de bits (por componente) en el entero de entrada. | 5 |
| cross | Devuelve el producto cruzado de dos vectores 3D. | 1¹ |
| D3DCOLORtoUBYTE4 | Mezcla y modifica la escala de componentes del vector x 4D para compensar la falta de soporte UBYTE4 en algún hardware. | 1¹ |
| ddx | Devuelve la derivada parcial de x con respecto a la coordenada x del espacio de la pantalla. | 2¹ |
| ddx_coarse | Calcula una derivada parcial de baja precisión con respecto a la coordenada x del espacio de la pantalla. | 5 |
| ddx_fine | Calcula una derivada parcial de alta precisión con respecto a la coordenada x del espacio de la pantalla. | 5 |
| ddy | Devuelve la derivada parcial de x con respecto a la coordenada y del espacio de la pantalla. | 2¹ |
| ddy_coarse | Calcula una derivada parcial de baja precisión con respecto a la coordenada y del espacio de la pantalla. | 5 |
| ddy_fine | Calcula una derivada parcial de alta precisión con respecto a la coordenada y del espacio de la pantalla. | 5 |
| degrees | Convierte x de radianes a grados. | 1¹ |
| determinant | Devuelve el determinante de la matriz cuadrada m. | 1¹ |
| DeviceMemoryBarrier | Bloquea la ejecución de todos los subprocesos de un grupo hasta que se hayan completado todos los accesos a la memoria del dispositivo. | 5 |
| DeviceMemoryBarrierWithGroupSync | Bloquea la ejecución de todos los subprocesos de un grupo hasta que se hayan completado todos los accesos a la memoria del dispositivo y todos los subprocesos en el grupo hayan alcanzado esta llamada. | 5 |
| distance | Devuelve la distancia entre dos puntos. | 1¹ |
| dot | Devuelve el producto escalar de dos vectores. | 1 |
| dst | Calcula un vector de distancia. | 5 |
| errorf | Envía un mensaje de error a la cola de información. | 4 |
| EvaluateAttributeCentroid | Evalúa en el centroide de píxeles. | 5 |
| EvaluateAttributeAtSample | Evalúa en la ubicación de ejemplo indexada. | 5 |
| EvaluateAttributeSnapped | Evalúa en el centroide de píxeles con un desplazamiento. | 5 |
| exp | Devuelve el exponente con base e. | 1¹ |
| exp2 | Exponente con base 2 (por componente). | 1¹ |
| f16tof32 | Convierte el valor float16 almacenado en la mitad baja de la uint en un valor flotante. | 5 |
| f32tof16 | Convierte una entrada en un tipo float16. | 5 |
| faceforward | Devuelve -n * sign(dot(i, ng)). | 1¹ |
| firstbithigh | Obtiene la ubicación del primer bit establecido a partir del bit de orden más alto y hacia abajo, por componente. | 5 |
| firstbitlow | Devuelve la ubicación del primer bit establecido a partir del bit de orden más bajo y hacia arriba, por componente. | 5 |
| floor | Devuelve el entero más grande que es menor que o igual a x. | 1¹ |
| fma | Devuelve la suma multiplicada fusionada de doble precisión de a * b + c. | 5 |
| fmod | Devuelve el resto de punto flotante de x/y. | 1¹ |
| frac | Devuelve la parte fraccionaria de x. | 1¹ |
| frexp | Devuelve la mantisa y el exponente de x. | 2¹ |
| fwidth | Devuelve abs(ddx(x)) + abs(ddy(x)) | 2¹ |
| GetRenderTargetSampleCount | Devuelve el número de ejemplos de destino de representación. | 4 |
| GetRenderTargetSamplePosition | Devuelve una posición de ejemplo (x,y) para un índice de ejemplo determinado. | 4 |
| GroupMemoryBarrier | Bloquea la ejecución de todos los subprocesos de un grupo hasta que se hayan completado todos los accesos compartidos de grupo. | 5 |
| GroupMemoryBarrierWithGroupSync | Bloquea la ejecución de todos los subprocesos de un grupo hasta que se hayan completado todos los accesos compartidos de grupo se hayan completado y todos los subprocesos en el grupo hayan alcanzado esta llamada. | 5 |
| InterlockedAdd | Realiza un agregado atómico garantizado de valor a la variable de recurso dest. | 5 |
| InterlockedAnd | Realiza un and atómico garantizado. | 5 |
| InterlockedCompareExchange | Compara de forma atómica la entrada con el valor de comparación e intercambia el resultado. | 5 |
| InterlockedCompareStore | Compara de forma atómica la entrada con el valor de comparación. | 5 |
| InterlockedExchange | Asigna valor a dest y devuelve el valor original. | 5 |
| InterlockedMax | Realiza un max atómico garantizado. | 5 |
| InterlockedMin | Realiza un min atómico garantizado. | 5 |
| InterlockedOr | Realiza un or atómico garantizado. | 5 |
| InterlockedXor | Realiza un xor atómico garantizado. | 5 |
| isfinite | Devuelve true si x es finito; false en caso contrario. | 1¹ |
| isinf | Devuelve true si x es +INF o -INF; false en caso contrario. | 1¹ |
| isnan | Devuelve true si x es NAN o QNAN; false en caso contrario. | 1¹ |
| ldexp | Devuelve x * 2exp | 1¹ |
| length | Devuelve la longitud del vector v. | 1¹ |
| lerp | Devuelve x + s(y - x). | 1¹ |
| lit | Devuelve un vector de iluminación (ambiente, difuso, especular, 1) | 1¹ |
| log | Devuelve el logaritmo con base-e de x. | 1¹ |
| log10 | Devuelve el logaritmo con base-10 de x. | 1¹ |
| log2 | Devuelve el logaritmo con base-2 de x. | 1¹ |
| mad | Realiza una operación de multiplicación o adición aritmética en tres valores. | 5 |
| max | Selecciona el mayor entre x y y. | 1¹ |
| min | Selecciona el menor entre x y y. | 1¹ |
| modf | Divide el valor x en partes fraccionales y enteras. | 1¹ |
| msad4 | Compara un valor de referencia de 4 bytes y un valor de origen de 8 bytes y acumula un vector de 4 sumas. | 5 |
| mul | Realiza la multiplicación de matriz mediante x y y. | 1 |
| noise | Genera un valor aleatorio mediante el algoritmo de ruido Perlin. | 1¹ |
| normalize | Devuelve un vector normalizado. | 1¹ |
| pow | Devuelve xy. | 1¹ |
| printf | Envía un mensaje de sombreador personalizado a la cola de información. | 4 |
| Process2DQuadTessFactorsAvg | Genera los factores de teselación corregidos para un parche cuádruple. | 5 |
| Process2DQuadTessFactorsMax | Genera los factores de teselación corregidos para un parche cuádruple. | 5 |
| Process2DQuadTessFactorsMin | Genera los factores de teselación corregidos para un parche cuádruple. | 5 |
| ProcessIsolineTessFactors | Genera los factores de teselación redondeados para una isolínea. | 5 |
| ProcessQuadTessFactorsAvg | Genera los factores de teselación corregidos para un parche cuádruple. | 5 |
| ProcessQuadTessFactorsMax | Genera los factores de teselación corregidos para un parche cuádruple. | 5 |
| ProcessQuadTessFactorsMin | Genera los factores de teselación corregidos para un parche cuádruple. | 5 |
| ProcessTriTessFactorsAvg | Genera los factores de teselación corregidos para un parche triple. | 5 |
| ProcessTriTessFactorsMax | Genera los factores de teselación corregidos para un parche triple. | 5 |
| ProcessTriTessFactorsMin | Genera los factores de teselación corregidos para un parche triple. | 5 |
| radians | Convierte x de grados a radianes. | 1 |
| rcp | Calcula una recíproca rápida, aproximada y por componente. | 5 |
| reflect | Devuelve un vector de reflejo. | 1 |
| refract | Devuelve el vector de refracción. | 1¹ |
| reversebits | Invierte el orden de los bits, por componente. | 5 |
| round | Redondea x al entero más próximo. | 1¹ |
| rsqrt | Devuelve 1 / sqrt(x) | 1¹ |
| saturate | Fija x al rango [0, 1] | 1 |
| sign | Calcula el signo de x. | 1¹ |
| sin | Devuelve el seno de x. | 1¹ |
| sincos | Devuelve el seno y coseno de x. | 1¹ |
| sinh | Devuelve el seno hiperbólico de x. | 1¹ |
| smoothstep | Devuelve una interpolación de Hermite suave entre 0 y 1. | 1¹ |
| sqrt | Raíz cuadrada (por componente) | 1¹ |
| step | Devuelve (x >= a) ? 1 : 0 | 1¹ |
| tan | Devuelve la tangente de x. | 1¹ |
| tanh | Devuelve la tangente hiperbólica de x. | 1¹ |
| tex1D(s, t) | Búsqueda de texturas 1D. | 1 |
| tex1D(s, t, ddx, ddy) | Búsqueda de texturas 1D. | 2¹ |
| tex1Dbias | Búsqueda de textura 1D con sesgo. | 2¹ |
| tex1Dgrad | Búsqueda de textura 1D con un degradado. | 2¹ |
| tex1Dlod | Búsqueda de textura 1D con LOD. | 3¹ |
| tex1Dproj | Búsqueda de textura 1D con división proyectiva. | 2¹ |
| tex2D(s, t) | Búsqueda de texturas 2D. | 1¹ |
| tex2D(s, t, ddx, ddy) | Búsqueda de texturas 2D. | 2¹ |
| tex2Dbias | Búsqueda de textura 2D con sesgo. | 2¹ |
| tex2Dgrad | Búsqueda de textura 2D con un degradado. | 2¹ |
| tex2Dlod | Búsqueda de textura 2D con LOD. | 3 |
| tex2Dproj | Búsqueda de textura 2D con división proyectiva. | 2¹ |
| tex3D(s, t) | Búsqueda de textura 3D. | 1¹ |
| tex3D(s, t, ddx, ddy) | Búsqueda de textura 3D. | 2¹ |
| tex3Dbias | Búsqueda de textura 3D con sesgo. | 2¹ |
| tex3Dgrad | Búsqueda de textura 3D con un degradado. | 2¹ |
| tex3Dlod | Búsqueda de textura 3D con LOD. | 3¹ |
| tex3Dproj | Búsqueda de textura 3D con división proyectiva. | 2¹ |
| texCUBE(s, t) | Búsqueda de textura de cubo. | 1¹ |
| texCUBE(s, t, ddx, ddy) | Búsqueda de textura de cubo. | 2¹ |
| texCUBEbias | Búsqueda de textura de cubo con sesgo. | 2¹ |
| texCUBEgrad | Búsqueda de textura de cubo con un degradado. | 2¹ |
| texCUBElod | Búsqueda de textura de cubo con LOD. | 3¹ |
| texCUBEproj | Búsqueda de textura de cubo con división proyectiva. | 2¹ |
| transpose | Devuelve la transposición de la matriz m. | 1 |
| trunc | Trunca los valores de punto flotante a valores enteros. | 1 |
¹ Consulte la página de referencia para las restricciones.
Tipos de componentes y plantillas
Las declaraciones de función intrínseca de HLSL usan tipos de componentes y tipos de plantilla para los argumentos de parámetros de entrada y los valores de devolución. Los tipos disponibles aparecen en la siguiente tabla.
| Estos tipos de plantillas | Descripción | Admiten estos tipos de datos |
|---|---|---|
| matriz | hasta 16 componentes en función de la declaración | Tipos básicos de HLSL |
| object | objeto sampler | sampler, sampler1D, sampler2D, sampler3D, samplerCUBE |
| escalar | 1 componente | Tipos básicos de HLSL |
| vector | 1 componente mínimo, 4 componentes máximo (inclusive) | Tipos básicos de HLSL |
Consulte también