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

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

	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.

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.
ResultInvalidTextureFormat	The pixel format bit size must be the same for the source and dest resources.

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

Data is automatically clipped if the clipped area is separated from the source or destination area. A function with the same functionality as nngxAddBlockImageCopyCommand is called internally. This function adds commands to the command list. Refer to the Programming Manual for details.

2011/02/17

Initial version.