nn::gd::CTR::Memory::CopyTextureSubResource Member Function

Syntax

static nnResult CopyTextureSubResource(
     const Texture2DResource * source,
     s32 srcMipLevelIndex,
     const Rect & rect,
     const Texture2DResource * dest,
     s32 dstMipLevelIndex,
     s32 destPosX,
     s32 destPosY
);

Arguments

Name Description
in source Specifies a pointer to the source Texture2DResource resource.
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 rect Specifies the clipping area of the source. If -1 is specified for rect.width or rect.height, width or height of the source resource is used.
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 destPosX Specifies the X-position of the destination memory.
in destPosY Specifies the Y-position of the destination memory.

Return Values

Returns the result of the operation.
Value Description
Result::IsSuccess Process was successful.
ResultNullParameter NULL was specified for source or dest.
ResultInvalidSubRegionResolution The PosX, PosY, width, or height of Rect is not a multiple of 16. Or, the width or height of Rect is less than zero. Or, destPosX or destPosY is not a multiple of 16.
ResultInvalidTextureMipLevelIndex The index of the source or destination mipmap is larger than the mipmap level of the respective resource.

Description

Adds a command to the current command list for transferring a source Texture2DResource texture to the destination Texture2DResource texture.

Revision History

2011/02/17
Initial version.

CONFIDENTIAL