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
);

Arguments

Name Description
in source Pointer to the Texture2DResource resource transfer source.
in srcMipLevelIndex Specifies the index of the mipmap level of the transfer source. If -1 is specified, the last mipmap level index is used.
in srcOffestY Specifies the Y offset of the transfer source. This value must be a multiple of srcBlockSize and less than the height of the mipmap level of the transfer source.
in srcCountRow Specifies the height to transfer. If -1 is specified, transfer is made at a size found by subtracting srcOffestY from the height of the transfer source resource. srcCountRow is a multiple of srcBlockSize. srcOffestY + srcCountRow must be equal to or less than the height of the transfer source resource.
in dest Specifies a pointer to the Texture2DResource of the transfer destination.
in dstMipLevelIndex Specifies the index of the mipmap level of the transfer destination. If -1 is specified, the last mipmap level index is used.
in dstOffestY Specifies the Y offset of the transfer destination.
in downScalingMode Specifies antialiasing filter mode.
in yFlip The transferred image is flipped vertically when yflip is GD_TRUE. The image is not flipped when GD_FALSE.

Return Values

Returns the result of the operation.
Value Description
Result::IsSuccess Process was successful.
ResultNullParameter NULL was specified for source or dest.
ResultInvalidMemoryLayout Either the transfer source resource is not LAYOUT_BLOCK_8 or LAYOUT_BLOCK_32 format, or the transfer destination is not LAYOUT_LINEAR.
ResultInvalidTextureOffset srcOffsetY and srcCountRow are not multiples of the memory layout. Or, dstOffestY is larger than the transfer destination. Or, the transfer source offset is larger than the transfer source resource. Or, downScalingMode is invalid. Or, the transfer destination offset is larger than the transfer destination resource.
ResultInvalidTextureMipLevelIndex The mipmap level index of the transfer source or transfer destination is invalid.
ResultInvalidTextureFormat The pixel format of the transfer source or transfer destination is invalid.

Description

Adds a command for converting the source Texture2DResource resource from a block image to a linear image and transferring it to the destination Texture2DResource.

Revision History

2011/02/21
Initial version.

CONFIDENTIAL