解説クラスＣｏｐｙＣｌｅａｒ（３）
解説クラスＣｏｐｙＣｌｅａｒ（３）
２０２４年２月２６初講（初稿）
この解説文章は、
解説『解説クラスＣｏｐｙＣｌｅａｒ（２）』の続きです！
（４－７）画像の幾何変換
int MagnifyImage( // 画像の拡大・縮小
TypeArray* ps, // Ｓ配列
TypeArray* pd, // Ｄ配列
double zh, // 水平拡大率
double zv, // 垂直拡大率
int dataSize=1, // 画素サイズ
int sw=FALSE ); // 補間SW（真:補間）
int MoveImage( // 画像の平行移動
TypeArray* ps, // Ｓ配列
TypeArray* pd, // Ｄ配列
double x, // Ｘ座標
double y, // Ｙ座標
int dataSize=1, // 画素サイズ
int sw=FALSE ); // 補間SW（真:補間）
int MirrorImage( // 画像の鏡像
TypeArray* ps, // Ｓ配列
TypeArray* pd, // Ｄ配列
int k, // １：左右反転
// ２：上下反転
// ３：上下左右反転
int dataSize=1 ); // 画素サイズ（省略時＝１）
int MirrorImage( // 画像の鏡像：自分自身
TypeArray* image, // 画像
int k, // １：左右反転
// ２：上下反転
// ３：上下左右反転
int dataSize=1 ); // 画素サイズ（省略時＝１）
int RotateImage( // 画像の回転
TypeArray* ps, // Ｓ配列
TypeArray* pd, // Ｄ配列
double a, // 回転角：ラジアン
double x1, // Ｓ配列回転中心ｘ
double y1, // Ｓ配列回転中心ｙ
double x2, // Ｄ配列回転中心ｘ
double y2, // Ｄ配列回転中心ｙ
int dataSize=1, // 画素サイズ（省略時＝１）
int sw=FALSE ); // 補間SW（真:補間）
int RotateImageInterpolate( // 画像の回転：補間版
TypeArray* ps, // Ｓ配列
TypeArray* pd, // Ｄ配列
double a, // 回転角：ラジアン
double x1, // Ｓ配列回転中心ｘ
double y1, // Ｓ配列回転中心ｙ
double x2, // Ｄ配列回転中心ｘ
double y2, // Ｄ配列回転中心ｙ
int dataSize=1 ); // 画素サイズ（省略時＝１）
int RotateImageReal( // 画像の回転：補間版
TypeArray* ps, // Ｓ配列
TypeArray* pd, // Ｄ配列
double a, // 回転角：ラジアン
double x1, // Ｓ配列回転中心ｘ
double y1, // Ｓ配列回転中心ｙ
double x2, // Ｄ配列回転中心ｘ
double y2, // Ｄ配列回転中心ｙ
int dataSize=1 ); // 画素サイズ（省略時＝１）この章では、（拡大・縮小）関数群、（平行移動）関数群、
（鏡像）関数群、（回転）関数群、関数群を紹介します！
（４－７－１）関数「int MagnifyImage(
TypeArray* ps,TypeArray* pd,
double zh,double zv,int dataSize=1,int sw=FALSE);」
int MagnifyImage( // 画像の拡大・縮小
TypeArray* ps, // Ｓ配列
TypeArray* pd, // Ｄ配列
double zh, // 水平拡大率
double zv, // 垂直拡大率
int dataSize=1, // 画素サイズ
int sw=FALSE ); // 補間SW（真:補間）「Magnify」は、英単語「magnify」で「拡大」を意味
します！
「Image」は、画像ですので画像の拡大ですが拡大の意味を
拡大解釈して画像の拡大・縮小を行う関数です！
仮引数「TypeArray* ps,」は、元画像（Ｓ）
仮引数「TypeArray* pd,」は、結果画像（Ｄ）
仮引数「double zh,」は、水平方向（Ｘ軸方向）の
拡大（縮尺）率と倍精度浮動小数点数で指定！
仮引数「double zv,」は、垂直方向（Ｙ軸方向）の
拡大（縮尺）率と倍精度浮動小数点数で指定！
★注意★「zh,zv」の「z」は、英語「Camerazoom」の略
として「z」で表現元々は、オノマトペ（多分「ズー音」と
カメラメカの動作音）らしい？！その為に
関数名「magnify」と意味が有る物を使用し引数に「z」を
使用しました！
仮引数「int dataSize=1,」は、通常省略時（dataSize=1）
で１画素単位処理ですが、ＢＭＰ構造も処理出来る様にした
事でＢＭＰならば、（dataSize=3）としてカラー画像を処理
します！
仮引数「int sw=FALSE);」は、補間SW（真:補間、
省略時＝偽と非補間）★注意★補間は拡大時にモザイク状態
に成るのは非補間でグラデーションが付くのが補間処理を掛
けた結果です★備考★勿論、グラデーションが付いた方が、
処理が遅く成りますので必要な場合以外は無駄な処理？？
★詳細★は、
後で説明：【ファイル「CopyClear.cpp」及びファイル
「CopyClear300.cpp」が対象】します！
（４－７－２）関数「int MoveImage(
TypeArray* ps,TypeArray* pd,
double x,double y,int dataSize=1,int sw=FALSE);」
int MoveImage( // 画像の平行移動
TypeArray* ps, // Ｓ配列
TypeArray* pd, // Ｄ配列
double x, // Ｘ座標
double y, // Ｙ座標
int dataSize=1, // 画素サイズ
int sw=FALSE ); // 補間SW（真:補間）「Move」は、ムーブ動かすを意味
「Image」は、画像で画像を平行移動させる幾何変換です！
仮引数「TypeArray* ps,」は、元画像（Ｓ）
仮引数「TypeArray* pd,」は、結果画像（Ｄ）
仮引数「double x,」は、水平方向（Ｘ軸方向）移動座標を
倍精度浮動小数点数で指定！
仮引数「double y,」は、垂直方向（Ｙ軸方向）移動座標を
倍精度浮動小数点数で指定！
仮引数「int dataSize=1,」は、通常省略時（dataSize=1）
で１画素単位処理ですが、ＢＭＰ構造も処理出来る様にした
事でＢＭＰならば、（dataSize=3）としてカラー画像を処理
します！
仮引数「int sw=FALSE);」は、補間SW（真:補間、
省略時＝偽と非補間）★注意★補間は移動時に移動割合で
画素の値を調整します！★備考★勿論、調整が付いた方が、
処理が遅く成りますので必要な場合以外は無駄な処理？？
★注意★コピペとの違いは、移動量が整数値で無く画素の
途中でも細かく指定出来る事です！
★詳細★は、後で説明：【ファイル「CopyClear350.cpp」が
対象】します！
（４－７－３）関数「int MirrorImage(
TypeArray* ps,TypeArray* pd,int k,int dataSize=1);
int MirrorImage( // 画像の鏡像
TypeArray* ps, // Ｓ配列
TypeArray* pd, // Ｄ配列
int k, // １：左右反転
// ２：上下反転
// ３：上下左右反転
int dataSize=1 ); // 画素サイズ（省略時＝１）「Mirror」は、ミラー鏡を意味！
「Image」は、画像で画像の鏡像を作成する幾何変換です！
仮引数「TypeArray* ps,」は、元画像（Ｓ）
仮引数「TypeArray* pd,」は、結果画像（Ｄ）
仮引数「int k,」は、鏡像の種類≪左右反転・上下反転・
上下左右反転≫を示します！
仮引数「int dataSize=1,」は、通常省略時（dataSize=1）
で１画素単位処理ですが、ＢＭＰ構造も処理出来る様にした
事でＢＭＰならば、（dataSize=3）としてカラー画像を
処理します！
★詳細★は、後で説明：
【ファイル「CopyClear310.cpp」が対象】します！
（４－７－４）関数「int MirrorImage(
TypeArray* image,int k,int dataSize=1);
int MirrorImage( // 画像の鏡像：自分自身
TypeArray* image, // 画像
int k, // １：左右反転
// ２：上下反転
// ３：上下左右反転
int dataSize=1 ); // 画素サイズ（省略時＝１）「Mirror」は、ミラー鏡を意味！
「Image」は、画像で画像の鏡像を作成する幾何変換です！
仮引数「TypeArray* image,」は、画像を示し、
画像の一項演算子的に自分自身の鏡像を作成します！
★注意★勿論、多重定義（オーバーロード）関数です！
仮引数「int k,」は、鏡像の種類≪左右反転・上下反転・
上下左右反転≫を示します！
仮引数「int dataSize=1,」は、通常省略時（dataSize=1）
で１画素単位処理ですが、ＢＭＰ構造も処理出来る様にした
事でＢＭＰならば、（dataSize=3）としてカラー画像を処理
します！
★詳細★は、後で説明：
【ファイル「CopyClear310.cpp」が対象】します！
（４－７－５）関数を「int RotateImage(
TypeArray* ps,TypeArray* pd,
double a,double x1,double y1,
double x2,double y2,
int dataSize=1,int sw=FALSE);」
int RotateImage( // 画像の回転
TypeArray* ps, // Ｓ配列
TypeArray* pd, // Ｄ配列
double a, // 回転角：ラジアン
double x1, // Ｓ配列回転中心ｘ
double y1, // Ｓ配列回転中心ｙ
double x2, // Ｄ配列回転中心ｘ
double y2, // Ｄ配列回転中心ｙ
int dataSize=1, // 画素サイズ（省略時＝１）
int sw=FALSE ); // 補間SW（真:補間）
int RotateImageInterpolate( // 画像の回転：補間版「Rotate」は、英単語「Rotate」回転するで
「Image」は、画像で画像の回転結果画像を作成します！
★注意★ここで回転は、「ローテーション」平面上の一点を
中心に回転する方式です！
仮引数「TypeArray* ps,」は、元画像（Ｓ）
仮引数「TypeArray* pd,」は、結果画像（Ｄ）
仮引数「double a,」は、回転角度です！
仮引数「double x1,」は、元画像用の回転中心Ｘ座標です！
仮引数「double y1,」は、元画像用の回転中心Ｙ座標です！
仮引数「double x2,」は結果画像用の回転中心Ｘ座標です！
仮引数「double y2,」は結果画像用の回転中心Ｙ座標です！
仮引数「int dataSize=1,」は、通常省略時（dataSize=1）
で１画素単位処理ですが、ＢＭＰ構造も処理出来る様にした
事でＢＭＰならば、（dataSize=3）としてカラー画像を処理
します！
仮引数「int sw=FALSE);」は、補間SW（真:補間、
省略時＝偽と非補間）★注意★補間は回転時に元画像画素が
補正無しに成るのが非補間でグラデーションが付くのが補間
処理を掛けた結果です★備考★勿論、グラデーションが付い
た方が、処理が遅く成りますので必要な場合以外は無駄な
処理？？
★詳細★は、後で説明：【ファイル「CopyClear310.cpp」及
びファイル「CopyClear330.cpp」及びファイル
「CopyClear340.cpp」が対象】します！
（４－７－６）関数を「int RotateImageInt erpolate(
TypeArray* ps,TypeArray* pd,
double a,double x1,double y1,
double x2,double y2,int dataSize=1);」
int RotateImageInterpolate( // 画像の回転：補間版
TypeArray* ps, // Ｓ配列
TypeArray* pd, // Ｄ配列
double a, // 回転角：ラジアン
double x1, // Ｓ配列回転中心ｘ
double y1, // Ｓ配列回転中心ｙ
double x2, // Ｄ配列回転中心ｘ
double y2, // Ｄ配列回転中心ｙ
int dataSize=1 ); // 画素サイズ（省略時＝１）「Rotate」は、英単語「Rotate」回転するで
「Image」は、画像で画像の回転結果画像を作成します！
「Interpolate」は、英単語「Interpolate」補間する
です！
★注意★ここで回転は、「ローテーション」平面上の一点を
中心に回転する方式です！そして補間する場合の処理です！
仮引数「TypeArray* ps,」は、元画像（Ｓ）
仮引数「TypeArray* pd,」は、結果画像（Ｄ）
仮引数「double a,」は、回転角度です！
仮引数「double x1,」は、元画像用の回転中心Ｘ座標です！
仮引数「double y1,」は、元画像用の回転中心Ｙ座標です！
仮引数「double x2,」は結果画像用の回転中心Ｘ座標です！
仮引数「double y2,」は結果画像用の回転中心Ｙ座標です！
仮引数「int dataSize=1,」は、通常省略時（dataSize=1）
で１画素単位処理ですが、ＢＭＰ構造も処理出来る様にした
事でＢＭＰならば、（dataSize=3）としてカラー画像を処理
します！
★詳細★は、後で説明：【ファイル「CopyClear310.cpp」及
びファイル「CopyClear330.cpp」及びファイル
「CopyClear340.cpp」が対象】します！
（４－７－７）関数を「int RotateImageReal(
TypeArray* ps,TypeArray* pd,
double a,double x1,double y1,
double x2,double y2,int dataSize=1);」
int RotateImageReal( // 画像の回転：補間版
TypeArray* ps, // Ｓ配列
TypeArray* pd, // Ｄ配列
double a, // 回転角：ラジアン
double x1, // Ｓ配列回転中心ｘ
double y1, // Ｓ配列回転中心ｙ
double x2, // Ｄ配列回転中心ｘ
double y2, // Ｄ配列回転中心ｙ
int dataSize=1 ); // 画素サイズ（省略時＝１）「Rotate」は、英単語「Rotate」回転するで
「Image」は、画像で画像の回転結果画像を作成します！
「int erpolate」は、英単語「int erpolate」補間する
です！
★注意★ここで回転は、「ローテーション」平面上の一点を
中心に回転する方式です！そして補間する場合の処理です！
仮引数「TypeArray* ps,」は、元画像（Ｓ）
仮引数「TypeArray* pd,」は、結果画像（Ｄ）
仮引数「double a,」は、回転角度です！
仮引数「double x1,」は、元画像用の回転中心Ｘ座標です！
仮引数「double y1,」は、元画像用の回転中心Ｙ座標です！
仮引数「double x2,」は結果画像用の回転中心Ｘ座標です！
仮引数「double y2,」は結果画像用の回転中心Ｙ座標です！
仮引数「int dataSize=1,」は、通常省略時（dataSize=1）
で１画素単位処理ですが、ＢＭＰ構造も処理出来る様にした
事でＢＭＰならば、（dataSize=3）としてカラー画像を処理
します！
★詳細★は、後で説明：
【ファイル「CopyClear340.cpp」が対象】します！
★注意★関数「RotateImageInterpolate()」との違いは、
詳細で説明します！
★★備考★★
次から、このヘッダーファイル「CopyClear.h」が、
関数「int Sort();」の定義とガラット様子が変わるので
この解説文章は、一旦、ここで終了し、
ここで「解説クラスＣｏｐｙＣｌｅａｒ（３）」を
終わります！
講義として切れ目が良いと判断したからです！
続きは、「解説クラスＣｏｐｙＣｌｅａｒ（４）」に
成ります引き続き御贔屓して受講して下さい！
★備考★
解説『解説クラスＴｙｐｅＡｒｒａｙ』でも記載したが、
ｎｏｔｅエディタの変な特性でコピペした文章の半角「*」
が消されたり、空白「」が消される事が多々あります！
注意して手作業で修正している筈ですが、必ず、ｃｏｄｅ
機能で表示して居る物を正しいとして確認して下さい