module module_name(・・・)

• pixel
: 画素ごとに分割
• row
: 行ごとに分割
• column
: 列ごとに分割
• box[w][h]
: 小領域ごとに分割
• all
: 分割しない

• 並列処理命令

画像処理モジュール内に記述された処理は逐次命令となり、並列処理は行われません。VIOSでは並列処理を行うにはparallel文を使用します。以下にその使用例を示します。


　　/* 逐次処理部分を記述します */
　　‥‥
　　parallel{
　　　　/* 並列処理部分を記述します */
　　　　‥‥
　　}

VIOSでは、parallel文内部においては、画像はワーキングセットごとに分割されるため、画像の画素値へのアクセス方法が通常のC言語などのプログラムとは多少異なりますparallel文内部でのアクセス方法は以下の通りです。
• Image1[x][y]
: 相対座標指定
それぞれのワーキングセットが保持している画像の左上を(0, 0)とする相対座標(x, y)の位置にある画素へアクセスします。座標の指定を省き[]と記述した場合は、座標値0が指定されたものとします。


• Image1[[x]][[y]];
: 絶対座標指定
画像全体における絶対座標(x, y)の位置にある画素へアクセスします。

分割方法にallが適用されている画像については、相対座標指定、絶対座標指定ともに同一の処理となります。どちらの指定を用いた場合も、アクセスされる画素が同一ワーキングセット外にある場合は次に示すboundary命令で指定された方法で画素値を取得します。


• boundaryによる画素値取得法の指定
  
画素値の取得の際、ワーキングセットが持っていない画素へのアクセスを行うと、ネットワークを介したホスト上にあるワーキングセットから画素値を取得する状況が生じます。これは処理時間に非常に大きな影響を与えるため、VIOSでは次に示すboundary命令により、ネットワークを介したアクセスを避けることが可能です。


• プログラム中での記述方法


#vios boundary 画像変数名 アクセス方法


• 画像変数名 : アクセス方法を指定する画像変数名を記述します。



• アクセス方法 : ワーキングセット外の画素へのアクセス方法を次の中から選びます。


• nocheck : ワーキングセット外かどうかチェックしません。
• get : ネットワークを介してワーキングセット外の画素値を取得します。
• complete : ワーキングセットの持つ情報から画素値を補完します。
• const 数値 : 数値で指定した値で代用します。

なお、デフォルトの(boundary指定を行わない)場合は、nocheckが適用されます。


• 内部関数
• hotx, hoty
: 分割画像の注目画素の絶対位置を取得します。parallel文内において使用します。

  x = hotx(Image1);   // 画像Image1の絶対座標におけるx座標を変数xに代入します。
  y = hoty(Image1);   // 画像Image1の絶対座標におけるy座標を変数yに代入します。

• width, height
: 指定の画像の分割前の横方向、縦方向の大きさを取得します。

  w = width(Image1);  // 画像Image1の横方向（x方向）の大きさを変数wに代入します。
  h = height(Image1); // 画像Image1の縦方向（y方向）の大きさを変数hに代入します。

• その他の命令
画像処理モジュール内では以下のものを用いることができます。


• 変数
: C言語で用いることのできる変数のうち、ポインタ変数、構造体、文字以外の変数を用いることができます。宣言はC言語と同様に{}ブロックの最初に行います。また、モジュール内すべてでアクセス可能な大域変数は、モジュール内の先頭の位置に記述します。モジュール引数の数値パラメータも大域変数として扱われます。


• 演算子
: C言語で用いることのできる演算子のうち、ポインタ、構造体に関するもの以外の演算子が使用可能です。


• 文
: C言語と同様の文が使用可能です。


• 数学関数
: sin, cos, tan, asin, acos, atan, logの数学関数が使用可能です。


• メインフロー記述部

VIOSでは、ユーザが定義した画像処理モジュールをメインフロー記述部から呼び出すことにより画像処理を行います。メインフロー記述部は、以下のように記述します。

main()
{
  image Image1, Image2; 　　　　　　　     // 画像データを保持する変数を宣言します。
  
  Image1 = load("画像ファイル名1");        // 変数Image1に画像ファイルを読み込みます。

  usermodule(Image1, Image2);　　　　　　　// ユーザが定義したモジュールを呼び出します。
  disp(Image2);      　　　　　　　        // Image2を画面に表示します。
  save(Image2, "画像ファイル名2");         // Image2を「画像ファイル名2」の名前で保存します。
}