nn::gd::CTR::Memory::CopyTexture2DResourceBlockToLinear Member Function

Syntax

static nnResult CopyTexture2DResourceBlockToLinear(
     const Texture2DResource * source,
     s32 srcMipLevelIndex,
     u32 srcOffestY,
     s32 srcCountRow,
     const Texture2DResource * dest,
     s32 dstMipLevelIndex,
     u32 dstOffestY,
     DownScalingMode downScalingMode,
     gdBool yFlip
);
static nnResult CopyTexture2DResourceBlockToLinear(
     const Texture2DResource * source,
     s32 srcMipLevelIndex,
     u32 srcOffestY,
     u8 * dstAddr,
     u32 dstWidth,
     u32 dstHeight,
     u32 dstFormat,
     DownScalingMode downScalingMode,
     gdBool yFlip
);

List of Overloaded Member Functions

CopyTexture2DResourceBlockToLinear ( const Texture2DResource *, s32, u32, s32, const Texture2DResource *, s32, u32, DownScalingMode, gdBool ) Adds a command to the current command list for converting the source Texture2DResource resource from a block image to a linear image and transferring it to the destination Texture2DResource.
CopyTexture2DResourceBlockToLinear ( const Texture2DResource *, s32, u32, u8 *, u32, u32, u32, DownScalingMode, gdBool ) Adds a command to the current command list for converting the source Texture2DResource resource from a block image to a linear image and transferring it to the specified address.

Description of CopyTexture2DResourceBlockToLinear ( const Texture2DResource *, s32, u32, s32, const Texture2DResource *, s32, u32, DownScalingMode, gdBool )

Pixel formats that can be specified for the source and destination:

NATIVE_FORMAT_RGBA_8888
NATIVE_FORMAT_RGB_888
NATIVE_FORMAT_RGBA_4444
NATIVE_FORMAT_RGBA_5551
 NATIVE_FORMAT_RGB_565

The transfer source memory layout must be either LAYOUT_BLOCK_8 or LAYOUT_BLOCK_32. The transfer destination memory layout must be LAYOUT_LINEAR. The data transferred is automatically clipped when the source memory region (including srcMipLevelIndex, srcOffestY, and srcCountRow) is bigger than the destination region (including srcMipLevelIndex, srcOffestY, and srcCountRow). An error occurs if the source region is smaller than the destination region. When converting the pixel format, the source pixel size must be the same as or smaller than the destination pixel size. In other words, conversions that increase the pixel size are not possible. This process calls the nngxAddB2LTransferCommand function.

This function is added to the command list. See the Programming Guide for details.

Description of CopyTexture2DResourceBlockToLinear ( const Texture2DResource *, s32, u32, u8 *, u32, u32, u32, DownScalingMode, gdBool )

Pixel formats that can be specified for the source and destination:

NATIVE_FORMAT_RGBA_8888
NATIVE_FORMAT_RGB_888
NATIVE_FORMAT_RGBA_4444
NATIVE_FORMAT_RGBA_5551
 NATIVE_FORMAT_RGB_565

The transfer source memory layout must be either LAYOUT_BLOCK_8 or LAYOUT_BLOCK_32. The transfer destination memory layout must be LAYOUT_LINEAR. The data transferred is automatically clipped when the source memory region (including srcMipLevelIndex, srcOffestY, and srcCountRow) is bigger than the destination region (including srcMipLevelIndex, srcOffestY, and srcCountRow). An error occurs if the source region is smaller than the destination region. When converting the pixel format, the source pixel size must be the same as or smaller than the destination pixel size. In other words, conversions that increase the pixel size are not possible. This process calls the nngxAddB2LTransferCommand function.

This function is added to the command list. See the Programming Guide for details.

CONFIDENTIAL