CAMERA_SetTrimmingParams

構文

#include <twl/camera.h>

void CAMERA_SetTrimmingParams(u16 x1, u16 y1, u16 x2, u16 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 初版