PEXTextureMap PEXCreateMipmapTM( Display *display, int dimensionality, int texel_type, int num_levels, PEXMipmapLevel *levels )
The resource ID for a PEX Texture Map.
Invoke PEXCreateMipmapTM to create a mipmap texture resource that you can reference from a texture mapping LUT.
The dimensionality argument indicates the dimension of the texture map being created. Levels provides the actual texel data. Texel_type indicates the type of texel data as well as the components of the newly created texture resource.
The num_levels of mipmap levels in the levels argument are ordered to define the texture map, starting with the base level. Each member includes the dimension in each direction of that level of the texture map. The texels are assumed to be stored in t0-t1-t2 order, with t0 varying fastest and t2 varying slowest. The texture coordinates are normalized, so the first through last texel correspond to the texel coordinate range 0.0 to 1.0.
Inquire MaxFastTMSize with the function PEXGetImpDepConstants to determine whether there is a maximum size in any dimension on the base level which must be respected to achieve optimized implementation. If PEX has such a limit, then it treats larger texture maps in an implementation-dependent way. PEX implementations may have other restrictions on the dimensions of each level of the texture map. Inquire PowerOfTwoTMRequired with PEXGetImpDepConstants to determine if each dimension must be a power of two. Inquire SquareTMRequired with the same request to determine if all the dimensions on each level must be equal to one another.
For a list of related topics and for a list of all texture mapping functions, see Texture Mapping.