解説クラスＣｏｐｙＣｌｅａｒ（３４）
解説クラスＣｏｐｙＣｌｅａｒ（３４）
２０２５年２月２３稿（初講）
この解説は、膨大なクラス「class CopyClear」の定義を
記載したファイル「CopyClear.h」の順番に従い解説して
行く為に今回は、「private:属性」の関数の説明を行う
事にします！今回は「BinarizationMyselfBase()」関数から
説明します！
この解説文章は、
解説『解説クラスＣｏｐｙＣｌｅａｒ（３３）』の続きです
（４－１５－９３）関数「void BinarizationMyselfBase(
BYTE* p,int h,int data)｛・・・｝」
/************************************************************************/
/***** ２値変換：自分自身：Ｃ関数専用：０以外を出力値にする：ｘ方向*****/
/************************************************************************/
void CopyClear::BinarizationMyselfBase(
BYTE *p, // 画像ポインタ
int h, // 水平幅
int data // 出力値：≠０時
){
int h4; // 水平幅÷４
h4 = h / 4; // 水平幅÷４
h -= h4 * 4; // ÷４の余りを算出
while( --h4 >= 0 ){ // ４画素単位で繰返
if( *p ){ // ０以外なら
*p = data; // 出力値をセット
} //
p++; //
if( *p ){ //
*p = data; //
} //
p++; //
if( *p ){ //
*p = data; //
} //
p++; //
if( *p ){ //
*p = data; //
} //
p++; //
} //
while( --h >= 0 ){ // 残りの範囲で
if( *p ){ // ０以外なら
*p = data; // 出力値をセット
} //
p++; //
} //
}☆備考☆この関数はファイル「CopyClear030.cpp」に存在！
★注意★この関数は「private:属性」ですのでライブラリの
外から使用不能です！
（Ａ）関数「BinarizationMyselfBase();」の【関数名】
「Binarization」は、二値化を意味し、
「Myself」は、英単語「Myself」の意味通り「自分自身」
です!
「Base」は、基本を意味します！
この関数「BinarizationMyselfBase()」は、自分自身を
二値化する基本部を意味します！
（Ｂ）関数「void BinarizationMyselfBase();」の【返値】
返値を返さない関数です！
★注意★詰り、実引数の検査を実行時に行いませんので
使用する時は、正しい実引数を記載する必要が有ります！
（Ｃ）関数「BinarizationMyselfBase()」の【仮引数】
void CopyClear::BinarizationMyselfBase(
BYTE *p, // 画像ポインタ
int h, // 水平幅
int data // 出力値：≠０時
){「BYTE* p,」は、１バイト画素単位処理ポインタ
「int h,」は、水平幅
「int data」は、二値化（≠0）時の変換データ
（Ｄ）関数「BinarizationMyselfBase()」の【アルゴリズム】
){
int h4; // 水平幅÷４
h4 = h / 4; // 水平幅÷４
h -= h4 * 4; // ÷４の余りを算出
while( --h4 >= 0 ){ // ４画素単位で繰返
if( *p ){ // ０以外なら
*p = data; // 出力値をセット
} //
p++; //
if( *p ){ //
*p = data; //
} //
p++; //
if( *p ){ //
*p = data; //
} //
p++; //
if( *p ){ //
*p = data; //
} //
p++; //
} //
while( --h >= 0 ){ // 残りの範囲で
if( *p ){ // ０以外なら
*p = data; // 出力値をセット
} //
p++; //
} //
}（Ｄ－１）ローカル変数
){
int h4; // 水平幅÷４「int h4;」は、ループカウンタ≪水平幅÷４と４単位毎≫
（Ｄ―２）アルゴリズムコード
h4 = h / 4; // 水平幅÷４
h -= h4 * 4; // ÷４の余りを算出
while( --h4 >= 0 ){ // ４画素単位で繰返
if( *p ){ // ０以外なら
*p = data; // 出力値をセット
} //
p++; //
if( *p ){ //
*p = data; //
} //
p++; //
if( *p ){ //
*p = data; //
} //
p++; //
if( *p ){ //
*p = data; //
} //
p++; //
} //
while( --h >= 0 ){ // 残りの範囲で
if( *p ){ // ０以外なら
*p = data; // 出力値をセット
} //
p++; //
} //
}「h4=h/4;」は、４単位毎のループカウンタ算出
「h-=h4*4;」は、４単位毎の余りのループカウンタ算出
ダウンカウンタ方式でｗｈｉｌｅ構文「--h4>=0」とループ
条件でループ本体
「if(*p){*p=data;}p++;if(*p){*p=data;}p++;
if(*p){*p=data;}p++;if(*p){*p=data;}p++;」と基本単位
１画素の処理「if(*p){*p=data;}p++;」を４組み並べて
高速化処理を行い！１画素の処理
「if(*p){*p=data;}p++;」は、ｉｆ条件「*p」と「≠0」
なら「*p=data;」と仮引数「int data」の値をセットし
「p++;」ポインタを次の画素へ進める
そして「while(--h>=0){if(*p){*p=data;}p++;}」と
４単位に満たない余りの処理を行います！
★備考★
４単位に画素の処理を行って居るのが高速化と言って居る
のに少ないとお考えの方に、実験≪コンパイラＭＣＣ６８Ｋ
でＣＰＵ６８０６０「６８Ｋシリーズ最終最高ＣＰＵでデー
タキャッシュ装備」での実際の処理時間比較≫で最適な数と
判断しています！これ以上、多いと無駄と判断！
更に、名称「Base」で「基本部」と説明して居ますが、
多くの処理で「水平方向の処理」が連続する画素を処理する
場合の「基本」と理解して下さい！
（４－１５－９４）関数「void BinarizationNonZeoBase(
BYTE* ps,BYTE* pd,int h,int data
)｛・・・｝」
/************************************************************************/
/***** ２値変換：Ｓ→Ｄ：Ｃ関数専用：０以外を出力値にする：ｘ方向 *****/
/************************************************************************/
void CopyClear::BinarizationNonZeoBase(
BYTE *ps, // Ｓ画像ポインタ
BYTE *pd, // Ｄ画像ポインタ
int h, // 水平幅
int data // 出力値：≠０時
){
int h4; // 水平幅÷４
int zero; // ０データ
int d; // 出力値
zero = 0; // ０データセット
h4 = h / 4; // 水平幅÷４
h -= h4 * 4; // ÷４の余りを算出
while( --h4 >= 0 ){ // ４画素単位で繰返
d = zero; // ０で初期化し
if( *ps++ ){ // ０以外なら
d = data; // 出力値をセット
} //
*pd++ = d; // 出力
d = zero; //
if( *ps++ ){ //
d = data; //
} //
*pd++ = d; //
d = zero; //
if( *ps++ ){ //
d = data; //
} //
*pd++ = d; //
d = zero; //
if( *ps++ ){ //
d = data; //
} //
*pd++ = d; //
} //
while( --h >= 0 ){ // 残りの範囲で
d = zero; // ０で初期化し
if( *ps++ ){ // ０以外なら
d = data; // 出力値をセット
} //
*pd++ = d; // 出力
} //
}☆備考☆この関数はファイル「CopyClear030.cpp」に存在！
★注意★この関数は「private:属性」ですのでライブラリの
外から使用不能です！
（Ａ）関数「BinarizationNonZeoBase();」の【関数名】
「Binarization」は、二値化を意味し、
「NonZeo」は、カタカナ語「ノンゼロ」の意味通り「≠０」
です!
「Base」は、基本を意味します！
この関数「BinarizationNonZeoBase()」は、「≠０」二値化
する基本部を意味します！
（Ｂ）関数「void BinarizationNonZeoBase();」の【返値】
返値を返さない関数です！
★注意★詰り、実引数の検査を実行時に行いませんので
使用する時は、正しい実引数を記載する必要が有ります！
（Ｃ）関数「BinarizationNonZeoBase()」の【仮引数】
void CopyClear::BinarizationNonZeoBase(
BYTE *ps, // Ｓ画像ポインタ
BYTE *pd, // Ｄ画像ポインタ
int h, // 水平幅
int data // 出力値：≠０時
){「BYTE* ps,」は、Ｓ（元）画像画素単位処理ポインタ
「BYTE* pd,」は、Ｄ（結果）画像画素単位処理ポインタ
「int h,」は、水平幅
「int data」は、二値化（≠0）時の変換データ
「Base」は、基本部と言う意味で基本的な水平方向処理を
行います！★備考★
多くの処理で「水平方向の処理」が連続する画素を処理する
場合の「基本」と理解して下さい！
（Ｄ）関数「BinarizationNonZeoBase()」の【アルゴリズム】
){
int h4; // 水平幅÷４
int zero; // ０データ
int d; // 出力値
zero = 0; // ０データセット
h4 = h / 4; // 水平幅÷４
h -= h4 * 4; // ÷４の余りを算出
while( --h4 >= 0 ){ // ４画素単位で繰返
d = zero; // ０で初期化し
if( *ps++ ){ // ０以外なら
d = data; // 出力値をセット
} //
*pd++ = d; // 出力
d = zero; //
if( *ps++ ){ //
d = data; //
} //
*pd++ = d; //
d = zero; //
if( *ps++ ){ //
d = data; //
} //
*pd++ = d; //
d = zero; //
if( *ps++ ){ //
d = data; //
} //
*pd++ = d; //
} //
while( --h >= 0 ){ // 残りの範囲で
d = zero; // ０で初期化し
if( *ps++ ){ // ０以外なら
d = data; // 出力値をセット
} //
*pd++ = d; // 出力
} //
}（Ｄ－１）ローカル変数
){
int h4; // 水平幅÷４
int zero; // ０データ
int d; // 出力値「int h4;」は、ループカウンタ≪水平幅÷４と４単位毎≫
「int zero;」は、Ｓ（元）画像画素が「＝0」の時の結果
「int d;」は、Ｄ（結果）画像画素データ
（Ｄ―２）アルゴリズムコード
zero = 0; // ０データセット
h4 = h / 4; // 水平幅÷４
h -= h4 * 4; // ÷４の余りを算出
while( --h4 >= 0 ){ // ４画素単位で繰返
d = zero; // ０で初期化し
if( *ps++ ){ // ０以外なら
d = data; // 出力値をセット
} //
*pd++ = d; // 出力
d = zero; //
if( *ps++ ){ //
d = data; //
} //
*pd++ = d; //
d = zero; //
if( *ps++ ){ //
d = data; //
} //
*pd++ = d; //
d = zero; //
if( *ps++ ){ //
d = data; //
} //
*pd++ = d; //
} //
while( --h >= 0 ){ // 残りの範囲で
d = zero; // ０で初期化し
if( *ps++ ){ // ０以外なら
d = data; // 出力値をセット
} //
*pd++ = d; // 出力
} //
}「zero=0;」は、「＝0」と０画素の値を変数にセット
★備考★往々にして直に数値を記載する依りＣＰＵの
レジスターにセットされる機械コードを生成するコンパイル
システムの方が多いので高速化の為に使用！
「h4=h/4;」は、４単位毎のループカウンタ算出
「h-=h4*4;」は、４単位毎の余りのループカウンタ算出
ダウンカウンタ方式でｗｈｉｌｅ構文「--h4>=0」とループ
条件でループ本体「d=zero;if(*ps++){d=data;}*pd++=d;」
が４組み並べて４画素ループさせている？！その１単位
は、「d=zero;」で初期化、
ｉｆ構文「if(*ps++){d=data;}」と条件「*ps++」の
「≠0」で「d=data;」とセットし、結果画素書き込み
「*pd++=d;」で書き込む！★備考★「*ps++」でポインタを
次の画素に移動している事に注意！
そして「while(--h>=0){d=zero;if(*ps++){d=data;}
*pd++=d;}」と４単位に満たない余りの処理を行います！
★備考★
４単位に画素の処理を行って居るのが高速化と言って居る
のに少ないとお考えの方に、実験≪コンパイラＭＣＣ６８Ｋ
でＣＰＵ６８０６０「６８Ｋシリーズ最終最高ＣＰＵでデー
タキャッシュ装備」での実際の処理時間比較≫で最適な数と
判断しています！これ以上、多いと無駄と判断！
（４－１５－９５）関数「void BinarizationXYBase(
BYTE* ps,BYTE* pd,int h,int t,
int data,int low)｛・・・｝」
/************************************************************************/
/***** ２値変換：Ｓ→Ｄ：Ｃ関数専用：ＸＹ座標とＨＶで部分範囲用 *****/
/***** ｘ方向：※ＬＵＴを使用しないので狭い範囲の２値化に向きます※*****/
/************************************************************************/
void CopyClear::BinarizationXYBase(
BYTE *ps, // Ｓ画像ポインタ
BYTE *pd, // Ｄ画像ポインタ
int h, // 水平幅
int t, // しきい値 0..255
int data, // 出力値：高位（省略時255）
int low // 出力値：低位（省略時０）
){
int h4; // 水平幅÷４
int d; // 出力値
h4 = h / 4; // 水平幅÷４
h -= h4 * 4; // ÷４の余りを算出
while( --h4 >= 0 ){ // ４画素単位で繰返
d = low; // 出力値：低をセット
if( *ps++ > t ){ // しきい値Overなら
d = data; // 出力値：高をセット
} //
*pd++ = d; // 出力
d = low; //
if( *ps++ > t ){ //
d = data; //
} //
*pd++ = d; //
d = low; //
if( *ps++ > t ){ //
d = data; //
} //
*pd++ = d; //
d = low; //
if( *ps++ > t ){ //
d = data; //
} //
*pd++ = d; //
} //
while( --h >= 0 ){ // 残りの範囲で
d = low; // 出力値：低をセット
if( *ps++ > t ){ // しきい値Overなら
d = data; // 出力値：高をセット
} //
*pd++ = d; // 出力
} //
}☆備考☆この関数はファイル「CopyClear030.cpp」に存在！
★注意★この関数は「private:属性」ですのでライブラリの
外から使用不能です！
（Ａ）関数「BinarizationXYBase();」の【関数名】
「Binarization」は、二値化を意味し、
「XY」は、ＸＹ座標、詰り、二次元画像の意味です!
「Base」は、基本を意味します！
この関数「BinarizationXYBase()」は、二値化する
基本部としてＸ座標方向の処理を意味します！
（Ｂ）関数「void BinarizationXYBase();」の【返値】
返値を返さない関数です！
★注意★詰り、実引数の検査を実行時に行いませんので
使用する時は、正しい実引数を記載する必要が有ります！
（Ｃ）関数「BinarizationXYBase()」の【仮引数】
void CopyClear::BinarizationXYBase(
BYTE *ps, // Ｓ画像ポインタ
BYTE *pd, // Ｄ画像ポインタ
int h, // 水平幅
int t, // しきい値 0..255
int data, // 出力値：高位（省略時255）
int low // 出力値：低位（省略時０）
){「BYTE* ps,」は、Ｓ（元）画像画素単位処理ポインタ
「BYTE* pd,」は、Ｄ（結果）画像画素単位処理ポインタ
「int h,」は、水平幅
「int t,」は、閾値
「int data,」は、白画素（閾値越えた値）の結果値
「int low」は、黒画素（閾値以下）の結果値
「int data」は、二値化（≠0）時の変換データ
（Ｄ）関数「BinarizationXYBase()」の【アルゴリズム】
){
int h4; // 水平幅÷４
int d; // 出力値
h4 = h / 4; // 水平幅÷４
h -= h4 * 4; // ÷４の余りを算出
while( --h4 >= 0 ){ // ４画素単位で繰返
d = low; // 出力値：低をセット
if( *ps++ > t ){ // しきい値Overなら
d = data; // 出力値：高をセット
} //
*pd++ = d; // 出力
d = low; //
if( *ps++ > t ){ //
d = data; //
} //
*pd++ = d; //
d = low; //
if( *ps++ > t ){ //
d = data; //
} //
*pd++ = d; //
d = low; //
if( *ps++ > t ){ //
d = data; //
} //
*pd++ = d; //
} //
while( --h >= 0 ){ // 残りの範囲で
d = low; // 出力値：低をセット
if( *ps++ > t ){ // しきい値Overなら
d = data; // 出力値：高をセット
} //
*pd++ = d; // 出力
} //
}（Ｄ－１）ローカル変数
){
int h4; // 水平幅÷４
int d; // 出力値「int h4;」は、ループカウンタ≪水平幅÷４と４単位毎≫
「int d;」は、Ｄ（結果）画像画素データ
（Ｄ―２）アルゴリズムコード
h4 = h / 4; // 水平幅÷４
h -= h4 * 4; // ÷４の余りを算出
while( --h4 >= 0 ){ // ４画素単位で繰返
d = low; // 出力値：低をセット
if( *ps++ > t ){ // しきい値Overなら
d = data; // 出力値：高をセット
} //
*pd++ = d; // 出力
d = low; //
if( *ps++ > t ){ //
d = data; //
} //
*pd++ = d; //
d = low; //
if( *ps++ > t ){ //
d = data; //
} //
*pd++ = d; //
d = low; //
if( *ps++ > t ){ //
d = data; //
} //
*pd++ = d; //
} //
while( --h >= 0 ){ // 残りの範囲で
d = low; // 出力値：低をセット
if( *ps++ > t ){ // しきい値Overなら
d = data; // 出力値：高をセット
} //
*pd++ = d; // 出力
} //
}「h4=h/4;」は、４単位毎のループカウンタ算出
「h-=h4*4;」は、４単位毎の余りのループカウンタ算出
ダウンカウンタ方式でｗｈｉｌｅ構文「--h4>=0」とループ
条件でループ本体「d=low;if(*ps++){d=data;}*pd++=d;」
が４組み並べて４画素ループさせている？！その１単位
は、「d=low;」で初期化、
ｉｆ構文「if(*ps++){d=data;}」と条件「*ps++」の
「≠0」で「d=data;」とセットし、結果画素書き込み
「*pd++=d;」で書き込む！★備考★「*ps++」でポインタを
次の画素に移動している事に注意！
そして「while(--h>=0){d=low;if(*ps++){d=data;}
*pd++=d;}」と４単位に満たない余りの処理を行います！
★備考★
４単位に画素の処理を行って居るのが高速化と言って居る
のに少ないとお考えの方に、実験≪コンパイラＭＣＣ６８Ｋ
でＣＰＵ６８０６０「６８Ｋシリーズ最終最高ＣＰＵでデー
タキャッシュ装備」での実際の処理時間比較≫で最適な数と
判断しています！これ以上、多いと無駄と判断！
ココまでで区切り≪「private:属性」の関数の並びが、
「BinarizationXYBase()」関数までと二値化変換の基本部が
終了したので
次から「ConvertRgbToMonoBase()」と色変換系関数の説明に
なるので≫が良いので終わります？！
継続追加は有りません！★備考★
勿論、記載ミスは直して行きますが！
引き続き、
新規解説『解説クラスＣｏｐｙＣｌｅａｒ（３５）』を
御贔屓下さい！