# NNS_G2dCharCanvasDrawChar

## 構文

      #include <nnsys/g2d/g2d_CharCanvas.h>

      int NNS_G2dCharCanvasDrawChar(
      	const NNSG2dCharCanvas* pCC,
      	const NNSG2dFont* pFont,
      	int x,
      	int y,
      	int cl,
      	u16 ccode
      );

## 引数

pCC | [IN] CharCanvas へのポインタ
pFont | [IN] フォント へのポインタ
x | [IN] 文字の左上 x 座標 (CharCanvas座標系)
y | [IN] 文字の左上 y 座標 (CharCanvas座標系)
cl | [IN] 文字の描画に用いる基準カラーNo.
ccode | [IN] 描画する文字の文字コード

## 返り値

描画した文字の文字幅(=左スペース+グリフ幅)を返します。
`x + [返り値]` が描画した文字の右端を表す事になります。

## 説明

CharCanvas pCC に フォント pFont を使って文字 ccode を描画します。
文字の描画には透過色と cl から連続する必要な数の色がつかわれます。 例えば 3bpp (23=8色) のフォントで cl に 5 を指定すると 透過色(カラーNo. 0) とカラーNo. 5〜11 の計8色を使って描画を行います。

座標は CharCanvas 左上隅を (0, 0) とする座標系をとります。
x, y はそれぞれ
- [文字のグリフ幅] < x < [CharCanvas領域幅] - [文字の左スペース幅]
- [フォント高] < y < [CharCanvas領域高]
を満たしていなければなりません。
文字は座標 (x, y) が下図の赤点の位置になるように描画されます。

縦書きフォントでは座標 (x, y) が上図の青点の位置になるように描画されます。

## 参照

`NNS_G2dCharCanvasDrawGlyph`

## 履歴

2007/03/14 縦書き/縦持ちフォントに対応。
2005/05/25 初版