跳至内容

DXTextureCreate

DXTextureCreate

从传递图像中剪切的指定大小的矩形中创建2D结构。

int  DXTextureCreate(
   int             context,         // 图形环境句柄
   ENUM_DX_FORMAT  format,          // 像素颜色格式
   uint            width,           // 源图像宽度
   uint            height,          // 源图像高度
   const void&     data[],          // 源图像像素数组
   uint            data_x,          // 用于创建结构的矩形X坐标
   uint            data_y,          // 用于创建结构的矩形Y坐标
   uint            data_width,      // 用于创建结构的矩形宽度
   uint            data_height      // 用于创建结构的矩形高度
   );

参数

context

[in] 在DXContextCreate()中创建的图形环境的句柄。

format

[in] 从ENUM_DX_FORMAT枚举设置的像素颜色格式。

width

[in] 结构所基于的图像宽度。

height

[in] 结构所基于的图像高度。

data

[in] 结构所基于的图像像素数组。

data_x

[in] 用于创建结构的矩形X坐标(X偏移量)。

data_y

[in] 用于创建结构的矩形Y坐标(Y偏移量)。

data_width

[in] 用于创建结构的矩形宽度。

data_height

[in] 用于创建结构的矩形高度。

返回值

在出现错误时的结构句柄或INVALID_HANDLE。若要接收错误代码,应该调用GetLastError()函数。

注意

创建的不再使用的句柄应该由DXRelease()函数明确释放。

ENUM_DX_FORMAT

ID匹配DXGI_FORMAT
DX_FORMAT_UNKNOWN0DXGI_FORMAT_UNKNOWN
DX_FORMAT_R32G32B32A32_TYPELESS1DXGI_FORMAT_R32G32B32A32_TYPELESS
DX_FORMAT_R32G32B32A32_FLOAT2DXGI_FORMAT_R32G32B32A32_FLOAT
DX_FORMAT_R32G32B32A32_UINT3DXGI_FORMAT_R32G32B32A32_UINT
DX_FORMAT_R32G32B32A32_SINT4DXGI_FORMAT_R32G32B32A32_SINT
DX_FORMAT_R32G32B32_TYPELESS5DXGI_FORMAT_R32G32B32_TYPELESS
DX_FORMAT_R32G32B32_FLOAT6DXGI_FORMAT_R32G32B32_FLOAT
DX_FORMAT_R32G32B32_UINT7DXGI_FORMAT_R32G32B32_UINT
DX_FORMAT_R32G32B32_SINT8DXGI_FORMAT_R32G32B32_SINT
DX_FORMAT_R16G16B16A16_TYPELESS9DXGI_FORMAT_R16G16B16A16_TYPELESS
DX_FORMAT_R16G16B16A16_FLOAT10DXGI_FORMAT_R16G16B16A16_FLOAT
DX_FORMAT_R16G16B16A16_UNORM11/DXGI_FORMAT_R16G16B16A16_UNORM
DX_FORMAT_R16G16B16A16_UINT12/DXGI_FORMAT_R16G16B16A16_UINT
DX_FORMAT_R16G16B16A16_SNORM13DXGI_FORMAT_R16G16B16A16_SNORM
DX_FORMAT_R16G16B16A16_SINT14/DXGI_FORMAT_R16G16B16A16_SINT
DX_FORMAT_R32G32_TYPELESS15DXGI_FORMAT_R32G32_TYPELESS
DX_FORMAT_R32G32_FLOAT16/DXGI_FORMAT_R32G32_FLOAT
DX_FORMAT_R32G32_UINT17DXGI_FORMAT_R32G32_UINT
DX_FORMAT_R32G32_SINT18DXGI_FORMAT_R32G32_SINT
DX_FORMAT_R32G8X24_TYPELESS19/DXGI_FORMAT_R32G8X24_TYPELESS
DX_FORMAT_D32_FLOAT_S8X24_UINT20DXGI_FORMAT_D32_FLOAT_S8X24_UINT
DX_FORMAT_R32_FLOAT_X8X24_TYPELESS21DXGI_FORMAT_R32_FLOAT_X8X24_TYPELESS
DX_FORMAT_X32_TYPELESS_G8X24_UINT22DXGI_FORMAT_X32_TYPELESS_G8X24_UINT
DX_FORMAT_R10G10B10A2_TYPELESS23/DXGI_FORMAT_R10G10B10A2_TYPELESS
DX_FORMAT_R10G10B10A2_UNORM24/DXGI_FORMAT_R10G10B10A2_UNORM
DX_FORMAT_R10G10B10A2_UINT25/DXGI_FORMAT_R10G10B10A2_UINT
DX_FORMAT_R11G11B10_FLOAT26/DXGI_FORMAT_R11G11B10_FLOAT
DX_FORMAT_R8G8B8A8_TYPELESS27/DXGI_FORMAT_R8G8B8A8_TYPELESS
DX_FORMAT_R8G8B8A8_UNORM28DXGI_FORMAT_R8G8B8A8_UNORM
DX_FORMAT_R8G8B8A8_UNORM_SRGB29DXGI_FORMAT_R8G8B8A8_UNORM_SRGB
DX_FORMAT_R8G8B8A8_UINT30DXGI_FORMAT_R8G8B8A8_UINT
DX_FORMAT_R8G8B8A8_SNORM31DXGI_FORMAT_R8G8B8A8_SNORM
DX_FORMAT_R8G8B8A8_SINT32DXGI_FORMAT_R8G8B8A8_SINT
DX_FORMAT_R16G16_TYPELESS33DXGI_FORMAT_R16G16_TYPELESS
DX_FORMAT_R16G16_FLOAT34DXGI_FORMAT_R16G16_FLOAT
DX_FORMAT_R16G16_UNORM35DXGI_FORMAT_R16G16_UNORM
DX_FORMAT_R16G16_UINT36DXGI_FORMAT_R16G16_UINT
DX_FORMAT_R16G16_SNORM37DXGI_FORMAT_R16G16_SNORM
DX_FORMAT_R16G16_SINT38DXGI_FORMAT_R16G16_SINT
DX_FORMAT_R32_TYPELESS39DXGI_FORMAT_R32_TYPELESS
DX_FORMAT_D32_FLOAT40DXGI_FORMAT_D32_FLOAT
DX_FORMAT_R32_FLOAT41DXGI_FORMAT_R32_FLOAT
DX_FORMAT_R32_UINT42DXGI_FORMAT_R32_UINT
DX_FORMAT_R32_SINT43DXGI_FORMAT_R32_SINT
DX_FORMAT_R24G8_TYPELESS44DXGI_FORMAT_R24G8_TYPELESS
DX_FORMAT_D24_UNORM_S8_UINT45DXGI_FORMAT_D24_UNORM_S8_UINT
DX_FORMAT_R24_UNORM_X8_TYPELESS46DXGI_FORMAT_R24_UNORM_X8_TYPELESS
DX_FORMAT_X24_TYPELESS_G8_UINT47DXGI_FORMAT_X24_TYPELESS_G8_UINT
DX_FORMAT_R8G8_TYPELESS48DXGI_FORMAT_R8G8_TYPELESS
DX_FORMAT_R8G8_UNORM49DXGI_FORMAT_R8G8_UNORM
DX_FORMAT_R8G8_UINT50DXGI_FORMAT_R8G8_UINT
DX_FORMAT_R8G8_SNORM51DXGI_FORMAT_R8G8_SNORM
DX_FORMAT_R8G8_SINT52DXGI_FORMAT_R8G8_SINT
DX_FORMAT_R16_TYPELESS53DXGI_FORMAT_R16_TYPELESS
DX_FORMAT_R16_FLOAT54DXGI_FORMAT_R16_FLOAT
DX_FORMAT_D16_UNORM55DXGI_FORMAT_D16_UNORM
DX_FORMAT_R16_UNORM56DXGI_FORMAT_R16_UNORM
DX_FORMAT_R16_UINT57DXGI_FORMAT_R16_UINT
DX_FORMAT_R16_SNORM58DXGI_FORMAT_R16_SNORM
DX_FORMAT_R16_SINT59DXGI_FORMAT_R16_SINT
DX_FORMAT_R8_TYPELESS60DXGI_FORMAT_R8_TYPELESS
DX_FORMAT_R8_UNORM61DXGI_FORMAT_R8_UNORM
DX_FORMAT_R8_UINT62DXGI_FORMAT_R8_UINT
DX_FORMAT_R8_SNORM63DXGI_FORMAT_R8_SNORM
DX_FORMAT_R8_SINT64DXGI_FORMAT_R8_SINT
DX_FORMAT_A8_UNORM65DXGI_FORMAT_A8_UNORM
DX_FORMAT_R1_UNORM66DXGI_FORMAT_R1_UNORM
DX_FORMAT_R9G9B9E5_SHAREDEXP67DXGI_FORMAT_R9G9B9E5_SHAREDEXP
DX_FORMAT_R8G8_B8G8_UNORM68DXGI_FORMAT_R8G8_B8G8_UNORM
DX_FORMAT_G8R8_G8B8_UNORM69DXGI_FORMAT_G8R8_G8B8_UNORM
DX_FORMAT_BC1_TYPELESS70DXGI_FORMAT_BC1_TYPELESS
DX_FORMAT_BC1_UNORM71DXGI_FORMAT_BC1_UNORM
DX_FORMAT_BC1_UNORM_SRGB72DXGI_FORMAT_BC1_UNORM_SRGB
DX_FORMAT_BC2_TYPELESS73DXGI_FORMAT_BC2_TYPELESS
DX_FORMAT_BC2_UNORM74DXGI_FORMAT_BC2_UNORM
DX_FORMAT_BC2_UNORM_SRGB75DXGI_FORMAT_BC2_UNORM_SRGB
DX_FORMAT_BC3_TYPELESS76DXGI_FORMAT_BC3_TYPELESS
DX_FORMAT_BC3_UNORM77DXGI_FORMAT_BC3_UNORM
DX_FORMAT_BC3_UNORM_SRGB78DXGI_FORMAT_BC3_UNORM_SRGB
DX_FORMAT_BC4_TYPELESS79DXGI_FORMAT_BC4_TYPELESS
DX_FORMAT_BC4_UNORM80DXGI_FORMAT_BC4_UNORM
DX_FORMAT_BC4_SNORM81DXGI_FORMAT_BC4_SNORM
DX_FORMAT_BC5_TYPELESS82DXGI_FORMAT_BC5_TYPELESS
DX_FORMAT_BC5_UNORM83DXGI_FORMAT_BC5_UNORM
DX_FORMAT_BC5_SNORM84DXGI_FORMAT_BC5_SNORM
DX_FORMAT_B5G6R5_UNORM85DXGI_FORMAT_B5G6R5_UNORM
DX_FORMAT_B5G5R5A1_UNORM86DXGI_FORMAT_B5G5R5A1_UNORM
DX_FORMAT_B8G8R8A8_UNORM87DXGI_FORMAT_B8G8R8A8_UNORM
DX_FORMAT_B8G8R8X8_UNORM88DXGI_FORMAT_B8G8R8X8_UNORM
DX_FORMAT_R10G10B10_XR_BIAS_A2_UNORM89DXGI_FORMAT_R10G10B10_XR_BIAS_A2_UNORM
DX_FORMAT_B8G8R8A8_TYPELESS90DXGI_FORMAT_B8G8R8A8_TYPELESS
DX_FORMAT_B8G8R8A8_UNORM_SRGB91DXGI_FORMAT_B8G8R8A8_UNORM_SRGB
DX_FORMAT_B8G8R8X8_TYPELESS92DXGI_FORMAT_B8G8R8X8_TYPELESS
DX_FORMAT_B8G8R8X8_UNORM_SRGB93DXGI_FORMAT_B8G8R8X8_UNORM_SRGB
DX_FORMAT_BC6H_TYPELESS94DXGI_FORMAT_BC6H_TYPELESS
DX_FORMAT_BC6H_UF1695DXGI_FORMAT_BC6H_UF16
DX_FORMAT_BC6H_SF1696DXGI_FORMAT_BC6H_SF16
DX_FORMAT_BC7_TYPELESS97DXGI_FORMAT_BC7_TYPELESS
DX_FORMAT_BC7_UNORM98DXGI_FORMAT_BC7_UNORM
DX_FORMAT_BC7_UNORM_SRGB99DXGI_FORMAT_BC7_UNORM_SRGB
DX_FORMAT_AYUV100DXGI_FORMAT_AYUV
DX_FORMAT_Y410101DXGI_FORMAT_Y410
DX_FORMAT_Y416102DXGI_FORMAT_Y416
DX_FORMAT_NV12103DXGI_FORMAT_NV12
DX_FORMAT_P010104DXGI_FORMAT_P010
DX_FORMAT_P016105DXGI_FORMAT_P016
DX_FORMAT_420_OPAQUE106DXGI_FORMAT_420_OPAQUE
DX_FORMAT_YUY2107DXGI_FORMAT_YUY2
DX_FORMAT_Y210108DXGI_FORMAT_Y210
DX_FORMAT_Y216109DXGI_FORMAT_Y216
DX_FORMAT_NV11110DXGI_FORMAT_NV11
DX_FORMAT_AI44111DXGI_FORMAT_AI44
DX_FORMAT_IA44112DXGI_FORMAT_IA44
DX_FORMAT_P8113DXGI_FORMAT_P8
DX_FORMAT_A8P8114DXGI_FORMAT_A8P8
DX_FORMAT_B4G4R4A4_UNORM115DXGI_FORMAT_B4G4R4A4_UNORM
DX_FORMAT_P208130DXGI_FORMAT_P208
DX_FORMAT_V208131DXGI_FORMAT_V208
DX_FORMAT_V408132DXGI_FORMAT_V408
DX_FORMAT_FORCE_UINT0xffffffffDXGI_FORMAT_FORCE_UINT