# CAMERA_SetTrimmingParams

## 構文

  `#include <twl/camera.h>`
  `void CAMERA_SetTrimmingParams(u16 x1, u16 y1, u16 x2, u16 y2);`

## 引数

x1 | トリミング開始位置(ピクセル単位)
y1 | トリミング開始位置(ピクセル単位)
x2 | トリミング終了位置(ピクセル単位)
y2 | トリミング終了位置(ピクセル単位)

## 返り値

なし

## 説明

トリミングを行う位置を指定します。
x1,y1のピクセルはトリミング範囲に含まれます。x2,y2のピクセルはトリミングには含まれません。
本関数を使用する際には、`CAMERA_SetTrimming()` でトリミングを有効にしておく必要があります。
本関数で指定する画像の開始位置(y1)、終了位置(y2)は必ず偶数である必要があります。
本関数でトリミング範囲を正しく指定しなかった場合の挙動は、以下のようになります。

- トリミング開始位置がトリミング終了位置より大きい場合（x1 > x2 もしくは y1 > y2）、本関数は何も処理をせずに返ります。
- トリミング終了位置がカメラ解像度の範囲外にある場合、元画像の端までがトリミング範囲とされ、データの保存がされます。
  例えば、カメラ解像度がCAMERA_SIZE_QVGA（320,240）の場合に、x1=160, y1=120, x2=400, y2=200 と指定した場合のトリミング範囲は、(160,120)から(320,200)になります。
  同様に、x1=160, y1=120, x2=240, y2=360 と指定した場合のトリミング範囲は、(160,120)から(240,240)になります。
- トリミング開始位置がカメラ解像度の範囲外にある場合、データの保存が行われなくなります。

## 参照

`CAMERA_SetTrimming`、`CAMERA_SetTrimmingParamsCenter`

## 履歴

2007/11/15 トリミング範囲が不正だった場合の挙動について説明追加
2007/10/23 説明追加
2007/10/02 初版