CUDA Driver API :: CUDA Toolkit Documentation

6.26. 纹理引用管理 [已弃用]

本节介绍低级别CUDA驱动程序应用程序编程接口中已弃用的纹理引用管理函数。

Functions

CUresult cuTexRefCreate ( CUtexref* pTexRef ): Creates a texture reference.
CUresult cuTexRefDestroy ( CUtexref hTexRef ): Destroys a texture reference.
CUresult cuTexRefGetAddress ( CUdeviceptr* pdptr, CUtexref hTexRef ): Gets the address associated with a texture reference.
CUresult cuTexRefGetAddressMode ( CUaddress_mode* pam, CUtexref hTexRef, int dim ): Gets the addressing mode used by a texture reference.
CUresult cuTexRefGetArray ( CUarray* phArray, CUtexref hTexRef ): Gets the array bound to a texture reference.
CUresult cuTexRefGetBorderColor ( float* pBorderColor, CUtexref hTexRef ): Gets the border color used by a texture reference.
CUresult cuTexRefGetFilterMode ( CUfilter_mode* pfm, CUtexref hTexRef ): Gets the filter-mode used by a texture reference.
CUresult cuTexRefGetFlags ( unsigned int* pFlags, CUtexref hTexRef ): Gets the flags used by a texture reference.
CUresult cuTexRefGetFormat ( CUarray_format* pFormat, int* pNumChannels, CUtexref hTexRef ): Gets the format used by a texture reference.
CUresult cuTexRefGetMaxAnisotropy ( int* pmaxAniso, CUtexref hTexRef ): Gets the maximum anisotropy for a texture reference.
CUresult cuTexRefGetMipmapFilterMode ( CUfilter_mode* pfm, CUtexref hTexRef ): Gets the mipmap filtering mode for a texture reference.
CUresult cuTexRefGetMipmapLevelBias ( float* pbias, CUtexref hTexRef ): Gets the mipmap level bias for a texture reference.
CUresult cuTexRefGetMipmapLevelClamp ( float* pminMipmapLevelClamp, float* pmaxMipmapLevelClamp, CUtexref hTexRef ): Gets the min/max mipmap level clamps for a texture reference.
CUresult cuTexRefGetMipmappedArray ( CUmipmappedArray* phMipmappedArray, CUtexref hTexRef ): Gets the mipmapped array bound to a texture reference.
CUresult cuTexRefSetAddress ( size_t* ByteOffset, CUtexref hTexRef, CUdeviceptr dptr, size_t bytes ): Binds an address as a texture reference.
CUresult cuTexRefSetAddress2D ( CUtexref hTexRef, const CUDA_ARRAY_DESCRIPTOR* desc, CUdeviceptr dptr, size_t Pitch ): Binds an address as a 2D texture reference.
CUresult cuTexRefSetAddressMode ( CUtexref hTexRef, int dim, CUaddress_mode am ): Sets the addressing mode for a texture reference.
CUresult cuTexRefSetArray ( CUtexref hTexRef, CUarray hArray, unsigned int Flags ): Binds an array as a texture reference.
CUresult cuTexRefSetBorderColor ( CUtexref hTexRef, float* pBorderColor ): Sets the border color for a texture reference.
CUresult cuTexRefSetFilterMode ( CUtexref hTexRef, CUfilter_mode fm ): Sets the filtering mode for a texture reference.
CUresult cuTexRefSetFlags ( CUtexref hTexRef, unsigned int Flags ): Sets the flags for a texture reference.
CUresult cuTexRefSetFormat ( CUtexref hTexRef, CUarray_format fmt, int NumPackedComponents ): Sets the format for a texture reference.
CUresult cuTexRefSetMaxAnisotropy ( CUtexref hTexRef, unsigned int maxAniso ): Sets the maximum anisotropy for a texture reference.
CUresult cuTexRefSetMipmapFilterMode ( CUtexref hTexRef, CUfilter_mode fm ): Sets the mipmap filtering mode for a texture reference.
CUresult cuTexRefSetMipmapLevelBias ( CUtexref hTexRef, float bias ): Sets the mipmap level bias for a texture reference.
CUresult cuTexRefSetMipmapLevelClamp ( CUtexref hTexRef, float minMipmapLevelClamp, float maxMipmapLevelClamp ): Sets the mipmap min/max mipmap level clamps for a texture reference.
CUresult cuTexRefSetMipmappedArray ( CUtexref hTexRef, CUmipmappedArray hMipmappedArray, unsigned int Flags ): Binds a mipmapped array to a texture reference.

Functions

CUresult cuTexRefCreate ( CUtexref* pTexRef )

创建一个纹理引用。

参数

pTexRef: - Returned texture reference

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Creates a texture reference and returns its handle in *pTexRef. Once created, the application must call cuTexRefSetArray() or cuTexRefSetAddress() to associate the reference with allocated memory. Other texture reference functions are used to specify the format and interpretation (addressing, filtering, etc.) to be used when the memory is read through this texture reference.

另请参阅：

cuTexRefDestroy

CUresult cuTexRefDestroy ( CUtexref hTexRef )

销毁一个纹理引用。

参数

hTexRef: - Texture reference to destroy

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Destroys the texture reference specified by hTexRef.

另请参阅：

cuTexRefCreate

CUresult cuTexRefGetAddress ( CUdeviceptr* pdptr, CUtexref hTexRef )

获取与纹理引用关联的地址。

参数

pdptr: - Returned device address
hTexRef: - Texture reference

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Returns in *pdptr the base address bound to the texture reference hTexRef, or returns CUDA_ERROR_INVALID_VALUE if the texture reference is not bound to any device memory range.

另请参阅：

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefGetAddressMode ( CUaddress_mode* pam, CUtexref hTexRef, int dim )

获取纹理引用所使用的寻址模式。

参数

pam: - Returned addressing mode
hTexRef: - Texture reference
dim: - Dimension

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Returns in *pam the addressing mode corresponding to the dimension dim of the texture reference hTexRef. Currently, the only valid value for dim are 0 and 1.

另请参阅：

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefGetArray ( CUarray* phArray, CUtexref hTexRef )

获取绑定到纹理引用的数组。

参数

phArray: - Returned array
hTexRef: - Texture reference

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Returns in *phArray the CUDA array bound to the texture reference hTexRef, or returns CUDA_ERROR_INVALID_VALUE if the texture reference is not bound to any CUDA array.

另请参阅：

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefGetBorderColor ( float* pBorderColor, CUtexref hTexRef )

获取纹理引用所使用的边框颜色。

参数

pBorderColor: - Returned Type and Value of RGBA color
hTexRef: - Texture reference

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Returns in pBorderColor, values of the RGBA color used by the texture reference hTexRef. The color value is of type float and holds color components in the following sequence: pBorderColor[0] holds 'R' component pBorderColor[1] holds 'G' component pBorderColor[2] holds 'B' component pBorderColor[3] holds 'A' component

另请参阅：

cuTexRefSetAddressMode, cuTexRefSetAddressMode, cuTexRefSetBorderColor

CUresult cuTexRefGetFilterMode ( CUfilter_mode* pfm, CUtexref hTexRef )

获取纹理引用所使用的过滤模式。

参数

pfm: - Returned filtering mode
hTexRef: - Texture reference

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Returns in *pfm the filtering mode of the texture reference hTexRef.

另请参阅：

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefGetFlags ( unsigned int* pFlags, CUtexref hTexRef )

获取纹理引用所使用的标志。

参数

pFlags: - Returned flags
hTexRef: - Texture reference

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Returns in *pFlags the flags of the texture reference hTexRef.

另请参阅：

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFormat

CUresult cuTexRefGetFormat ( CUarray_format* pFormat, int* pNumChannels, CUtexref hTexRef )

获取纹理引用所使用的格式。

参数

pFormat: - Returned format
pNumChannels: - Returned number of components
hTexRef: - Texture reference

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Returns in *pFormat and *pNumChannels the format and number of components of the CUDA array bound to the texture reference hTexRef. If pFormat or pNumChannels is NULL, it will be ignored.

另请参阅：

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags

CUresult cuTexRefGetMaxAnisotropy ( int* pmaxAniso, CUtexref hTexRef )

获取纹理引用的最大各向异性值。

参数

pmaxAniso: - Returned maximum anisotropy
hTexRef: - Texture reference

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Returns the maximum anisotropy in pmaxAniso that's used when reading memory through the texture reference hTexRef.

另请参阅：

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefGetMipmapFilterMode ( CUfilter_mode* pfm, CUtexref hTexRef )

获取纹理引用的mipmap过滤模式。

参数

pfm: - Returned mipmap filtering mode
hTexRef: - Texture reference

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Returns the mipmap filtering mode in pfm that's used when reading memory through the texture reference hTexRef.

另请参阅：

CUresult cuTexRefGetMipmapLevelBias ( float* pbias, CUtexref hTexRef )

获取纹理引用的mipmap级别偏差。

参数

pbias: - Returned mipmap level bias
hTexRef: - Texture reference

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Returns the mipmap level bias in pBias that's added to the specified mipmap level when reading memory through the texture reference hTexRef.

另请参阅：

CUresult cuTexRefGetMipmapLevelClamp ( float* pminMipmapLevelClamp, float* pmaxMipmapLevelClamp, CUtexref hTexRef )

获取纹理引用的最小/最大mipmap级别钳制值。

参数

pminMipmapLevelClamp: - Returned mipmap min level clamp
pmaxMipmapLevelClamp: - Returned mipmap max level clamp
hTexRef: - Texture reference

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Returns the min/max mipmap level clamps in pminMipmapLevelClamp and pmaxMipmapLevelClamp that's used when reading memory through the texture reference hTexRef.

另请参阅：

CUresult cuTexRefGetMipmappedArray ( CUmipmappedArray* phMipmappedArray, CUtexref hTexRef )

获取绑定到纹理引用的mipmapped数组。

参数

phMipmappedArray: - Returned mipmapped array
hTexRef: - Texture reference

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Returns in *phMipmappedArray the CUDA mipmapped array bound to the texture reference hTexRef, or returns CUDA_ERROR_INVALID_VALUE if the texture reference is not bound to any CUDA mipmapped array.

另请参阅：

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetAddress ( size_t* ByteOffset, CUtexref hTexRef, CUdeviceptr dptr, size_t bytes )

将地址绑定为纹理引用。

参数

ByteOffset: - Returned byte offset
hTexRef: - Texture reference to bind
dptr: - Device pointer to bind
bytes: - Size of memory to bind in bytes

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Binds a linear address range to the texture reference hTexRef. Any previous address or CUDA array state associated with the texture reference is superseded by this function. Any memory previously bound to hTexRef is unbound.

由于硬件对纹理基址有对齐要求，cuTexRefSetAddress()会在*ByteOffset中返回一个字节偏移量，该偏移量必须应用于纹理获取操作才能从目标内存中读取数据。这个偏移量需要除以纹素大小，并传递给从纹理读取的内核，以便应用于tex1Dfetch()函数。

如果设备内存指针是从cuMemAlloc()返回的，则偏移量保证为0，可以将NULL作为ByteOffset参数传递。

线性地址范围内的元素（或纹理元素）总数不能超过CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE1D_LINEAR_WIDTH。元素数量计算公式为(bytes / bytesPerElement)，其中bytesPerElement由数据格式和通过cuTexRefSetFormat()设置的组件数量决定。

另请参阅：

cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetAddress2D ( CUtexref hTexRef, const CUDA_ARRAY_DESCRIPTOR* desc, CUdeviceptr dptr, size_t Pitch )

将地址绑定为2D纹理引用。

参数

hTexRef: - Texture reference to bind
desc: - Descriptor of CUDA array
dptr: - Device pointer to bind
Pitch: - Line pitch in bytes

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

在内核中使用tex2D()函数需要调用cuTexRefSetArray()将对应的纹理引用绑定到数组，或者调用cuTexRefSetAddress2D()将纹理引用绑定到线性内存。

对同一纹理引用，调用cuTexRefSetFormat()的操作不能发生在调用cuTexRefSetAddress2D()之后。

要求dptr必须对齐到硬件特定的纹理对齐边界。您可以使用设备属性CU_DEVICE_ATTRIBUTE_TEXTURE_ALIGNMENT查询该值。如果提供的dptr未对齐，将返回CUDA_ERROR_INVALID_VALUE错误。

Pitch 必须与硬件特定的纹理间距对齐。可以使用设备属性 CU_DEVICE_ATTRIBUTE_TEXTURE_PITCH_ALIGNMENT 查询该值。如果提供了未对齐的 Pitch，将返回 CUDA_ERROR_INVALID_VALUE。

宽度和高度（以元素或纹素为单位指定）分别不得超过CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LINEAR_WIDTH和CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LINEAR_HEIGHT。以字节为单位指定的Pitch不得超过CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LINEAR_PITCH。

另请参阅：

cuTexRefSetAddress, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetAddressMode ( CUtexref hTexRef, int dim, CUaddress_mode am )

设置纹理引用的寻址模式。

参数

hTexRef: - Texture reference
dim: - Dimension
am: - Addressing mode to set

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Specifies the addressing mode am for the given dimension dim of the texture reference hTexRef. If dim is zero, the addressing mode is applied to the first parameter of the functions used to fetch from the texture; if dim is 1, the second, and so on. CUaddress_mode is defined as:

‎   typedef enum CUaddress_mode_enum {
            CU_TR_ADDRESS_MODE_WRAP = 0,
            CU_TR_ADDRESS_MODE_CLAMP = 1,
            CU_TR_ADDRESS_MODE_MIRROR = 2,
            CU_TR_ADDRESS_MODE_BORDER = 3
         } CUaddress_mode;

请注意，如果hTexRef绑定到线性内存，此调用将无效。此外，如果未设置标志CU_TRSF_NORMALIZED_COORDINATES，则唯一支持的寻址模式是CU_TR_ADDRESS_MODE_CLAMP。

另请参阅：

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetArray ( CUtexref hTexRef, CUarray hArray, unsigned int Flags )

将数组绑定为纹理引用。

参数

hTexRef: - Texture reference to bind
hArray: - Array to bind
Flags: - Options (must be CU_TRSA_OVERRIDE_FORMAT)

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Binds the CUDA array hArray to the texture reference hTexRef. Any previous address or CUDA array state associated with the texture reference is superseded by this function. Flags must be set to CU_TRSA_OVERRIDE_FORMAT. Any CUDA array previously bound to hTexRef is unbound.

另请参阅：

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetBorderColor ( CUtexref hTexRef, float* pBorderColor )

设置纹理参考的边框颜色。

参数

hTexRef: - Texture reference
pBorderColor: - RGBA color

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Specifies the value of the RGBA color via the pBorderColor to the texture reference hTexRef. The color value supports only float type and holds color components in the following sequence: pBorderColor[0] holds 'R' component pBorderColor[1] holds 'G' component pBorderColor[2] holds 'B' component pBorderColor[3] holds 'A' component

请注意，颜色值仅在地址模式设置为CU_TR_ADDRESS_MODE_BORDER时才能设置（通过cuTexRefSetAddressMode）。使用整数边框颜色值的应用程序需要将其值"reinterpret_cast"为浮点类型。

另请参阅：

cuTexRefSetAddressMode, cuTexRefGetAddressMode, cuTexRefGetBorderColor

CUresult cuTexRefSetFilterMode ( CUtexref hTexRef, CUfilter_mode fm )

设置纹理引用的过滤模式。

参数

hTexRef: - Texture reference
fm: - Filtering mode to set

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Specifies the filtering mode fm to be used when reading memory through the texture reference hTexRef. CUfilter_mode_enum is defined as:

‎   typedef enum CUfilter_mode_enum {
            CU_TR_FILTER_MODE_POINT = 0,
            CU_TR_FILTER_MODE_LINEAR = 1
         } CUfilter_mode;

请注意，如果hTexRef绑定到线性内存，此调用将无效。

另请参阅：

CUresult cuTexRefSetFlags ( CUtexref hTexRef, unsigned int Flags )

设置纹理引用的标志位。

参数

hTexRef: - Texture reference
Flags: - Optional flags to set

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Specifies optional flags via Flags to specify the behavior of data returned through the texture reference hTexRef. The valid flags are:

CU_TRSF_READ_AS_INTEGER，该标志会抑制默认行为（即将整数数据转换为[0,1]范围内的浮点数据）。请注意，无论是否指定此标志，32位整数格式的纹理都不会被转换；
CU_TRSF_NORMALIZED_COORDINATES，该参数会抑制默认的纹理坐标范围行为（默认范围为[0, Dim)，其中Dim是CUDA数组的宽度或高度）。相反，使用该参数时，纹理坐标[0, 1.0)将引用数组维度的整个范围；
CU_TRSF_DISABLE_TRILINEAR_OPTIMIZATION，该选项禁用所有三线性过滤优化。三线性优化通过允许在能够近似预期结果的场景中对纹理进行双线性过滤，从而提高纹理过滤性能。

另请参阅：

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetFormat ( CUtexref hTexRef, CUarray_format fmt, int NumPackedComponents )

设置纹理引用的格式。

参数

hTexRef: - Texture reference
fmt: - Format to set
NumPackedComponents: - Number of components per array element

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Specifies the format of the data to be read by the texture reference hTexRef. fmt and NumPackedComponents are exactly analogous to the Format and NumChannels members of the CUDA_ARRAY_DESCRIPTOR structure: They specify the format of each component and the number of components per array element.

另请参阅：

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat, cudaCreateChannelDesc

CUresult cuTexRefSetMaxAnisotropy ( CUtexref hTexRef, unsigned int maxAniso )

设置纹理引用的最大各向异性。

参数

hTexRef: - Texture reference
maxAniso: - Maximum anisotropy

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Specifies the maximum anisotropy maxAniso to be used when reading memory through the texture reference hTexRef.

请注意，如果hTexRef绑定到线性内存，此调用将无效。

另请参阅：

CUresult cuTexRefSetMipmapFilterMode ( CUtexref hTexRef, CUfilter_mode fm )

设置纹理引用的mipmap过滤模式。

参数

hTexRef: - Texture reference
fm: - Filtering mode to set

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Specifies the mipmap filtering mode fm to be used when reading memory through the texture reference hTexRef. CUfilter_mode_enum is defined as:

‎   typedef enum CUfilter_mode_enum {
            CU_TR_FILTER_MODE_POINT = 0,
            CU_TR_FILTER_MODE_LINEAR = 1
         } CUfilter_mode;

请注意，如果hTexRef未绑定到mipmapped数组，此调用将无效。

另请参阅：

CUresult cuTexRefSetMipmapLevelBias ( CUtexref hTexRef, float bias )

为纹理引用设置mipmap级别偏移。

参数

hTexRef: - Texture reference
bias: - Mipmap level bias

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Specifies the mipmap level bias bias to be added to the specified mipmap level when reading memory through the texture reference hTexRef.

请注意，如果hTexRef未绑定到mipmapped数组，此调用将无效。

另请参阅：

CUresult cuTexRefSetMipmapLevelClamp ( CUtexref hTexRef, float minMipmapLevelClamp, float maxMipmapLevelClamp )

为纹理引用设置mipmap最小/最大mipmap级别钳位值。

参数

hTexRef: - Texture reference
minMipmapLevelClamp: - Mipmap min level clamp
maxMipmapLevelClamp: - Mipmap max level clamp

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Specifies the min/max mipmap level clamps, minMipmapLevelClamp and maxMipmapLevelClamp respectively, to be used when reading memory through the texture reference hTexRef.

请注意，如果hTexRef未绑定到mipmapped数组，此调用将无效。

另请参阅：

CUresult cuTexRefSetMipmappedArray ( CUtexref hTexRef, CUmipmappedArray hMipmappedArray, unsigned int Flags )

将mipmapped数组绑定到纹理引用。

参数

hTexRef: - Texture reference to bind
hMipmappedArray: - Mipmapped array to bind
Flags: - Options (must be CU_TRSA_OVERRIDE_FORMAT)

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述

Binds the CUDA mipmapped array hMipmappedArray to the texture reference hTexRef. Any previous address or CUDA array state associated with the texture reference is superseded by this function. Flags must be set to CU_TRSA_OVERRIDE_FORMAT. Any CUDA array previously bound to hTexRef is unbound.

另请参阅：