# GX_LoadClearImageColor

## C Specification

  `#include <nitro/gx/gx_load.h>`
  `void GX_LoadClearImageColor(const void *pSrc, u32 szByte);`

## Description

This function uses DMA to transfer the clear image (color) to the clear image slot. The DMA channel that is used is `GX_DMAID` (defined in `gxcommon.h`). `szByte` must be a multiple of 4. Call between `GX_BeginLoadClearImage` and `GX_EndLoadClearImage`.

Notes:

- The DMA transfer is carried out internally, so the transfer source data must be flushed to main memory using a function such as `DC_FlushRange` prior to the process.
- If the regions for transfer source and transfer destination overlap, the operation result is not guaranteed.
- Do not call `GX_SetBankForClearImage`, `GX_ResetBankForClearImage`, or `GX_DisableBankForClearImage` between `GX_BeginLoadClearImage` and `GX_EndLoadClearImage`.

## Arguments

`pSrc` | Pointer to transfer source
`szByte` | Transfer size (in bytes)

## Return Values

None

## See Also

`GX_BeginLoadClearImage`, `GX_LoadClearImageDepth`, `GX_EndLoadClearImage`

## Revision History

02/09/2004 Revised and added to the description
01/19/2004 Initial Version