この投稿は、研究室の後輩へ向けたものですが、他の人の助けにもなればいいなということで、導入メモとして投稿します。
※色々初心者なので、「ここ違うよ！」・「ここは、この表現が良いよ！」等大歓迎です。
この作業は時間がかかります(大体2, 3時間)。
時間と心にゆとりのある時に実施下さいませ。
Halideって？
さわり初めで、詳しく分からないので
詳しくは、
- Halide公式のサイト
- 株式会社フィックスターズさんの公開SlideShare
を見てください。
めちゃくちゃ高速で画像処理ができるドメイン固有言語です（間違ってたらすいません）。
C++にライブラリとして導入することで使えます。
環境
- Windows 10
- Visual Studio 2019
下準備
最初に、ライブラリ導入ソフトであるvcpkgをインストールしなければなりません。
そのvcpkgをインストールするためにgitをインストールする必要があります。
※別に、vcpkgのgithubからクローンしてきてもいいです。
vcpkgでインストールされたライブラリは（ある設定をすれば）Visual Studio（以降VS）で
#include <〇〇.h>
と記述するだけで使える便利な代物です。
gitのインストール
gitの公式サイトへ行き、ダウンロード＆インストールします。
導入方法は、こちらのサイトが詳しいです。
vcpkgのインストール
gitのインストールが完了したら、次はvcpkgのインストールです。
コマンドプロンプトかpowershellかwindows terminalを立ち上げます。
その際、どこか分かりやすいところまでカレントディレクトリを移動します。
cd C:\
とか
cd D:\
とか
そのあとに、
git clone https://github.com/Microsoft/vcpkg.git
イメージ図
cd vcpkg
次に、vcpkg本体のビルドをする必要があります。
.\bootstrap-vcpkg.bat
イメージ図
 ↑が↓になればOK なんかエラーが出た時
こんな感じのエラーが出たら、VSにC++が入っていないと怒られちゃっています。  なので、ツールと機能を取得から  [C++によるデスクトップ開発]にチェックを入れて導入してあげてください。 そうすれば、きっとうまくいきます。
1. おまじない
.\vcpkg integrate install
と打ってあげましょう。
こうすることで、めんどくさい事せずにVSでライブラリを使えます。
イメージ図
取り敢えず、ここまで出来たら
.\vcpkg help
と打ってみましょう。使い方のリストが出てきます。
2. Halide導入
一番時間がかかるところです。
.\vcpkg search halide
と打ってみると、halideの名の付くパッケージがリストアップされます。
イメージ図
.\vcpkg install halide:x86-windows halide:x64-windows
または
.\vcpkg install halide:x86-windows
や
.\vcpkg install halide:x64-windows
でもいいですここはお好みで。というより、お使いのPCと相談してください。
イメージ図
なんかエラー出たやん
VSに英語の言語パックを追加しないといけません。 なので、ツールと機能を取得から[言語パック]へ移動し、英語にチェックを入れましょう。 他にもエラー出たんやけど
これは、ATLとMFCが無いのでVSに入れてねってことです(ATLとMFCが何なのかは私もわかりません)。 なので、ツールと機能を取得から [最新のv142ビルドツール用C++ ATL], [最新のv142ビルドツール用C++ MFC]にチェックを入れてあげましょう。 .\vcpkg list
でさっきインストールしたものを見てみましょう。
こんな感じになってると思います。
3. VSでHalideをincludeしてみよう
VSでC++を空のプロジェクトとして作成したら、main.cppを作って
#include <Halide.h>
int main(){
return 0;
}
でうまくいくと思います。
OpenCVと合わせて使うとき
@fukushima1981さんが投稿された記事の中に載せられてるコードがとても便利です（vcpkgでOpenCVを導入して使ってください）。
しかしながら、vcpkgによりライブラリ群を導入したことで、いくつか消さなければならない記述が出てきます。
#pragma comment(lib, "opencv_core331.lib")
#pragma comment(lib, "opencv_imgcodecs331.lib")
#pragma comment(lib, "opencv_highgui331.lib")
#pragma comment(lib, "Halide.lib")
これらを消さねばなりません。
理由については、コチラのページに詳細が掛かれています。
つまり競合しちゃうわけですね。
それを踏まえて、vcpkgで導入したverのコードを下に示します。
とても便利なので、ヘッダファイルにして、#includeしても良さそうです。
#pragma once
#include <opencv2/opencv.hpp>
#include "Halide.h"
using namespace Halide;
//OpenCV for Halide functions
//中でcv::imreadをコール．
Buffer<uint8_t> imread(cv::String name);
//中でcv::imwriteをコール．
void imwrite(cv::String name, const Buffer<uint8_t>& src);
//HalideのbufferからOpenCVのMatへ変換
void convertHalide2Mat(const Buffer<uint8_t>& src, cv::Mat& dest);
//OpenCVのMatからHalideのbufferへ変換
void convertMat2Halide(cv::Mat& src, Buffer<uint8_t>& dest);
//ucharのバッファ表示用
void imshow(cv::String name, const Buffer<uint8_t>& src);
//shortのバッファ表示用．可視化のデータはucharなのでオフセットとスケールで０～２５５へのキャストを調整
void imshow16(cv::String name, const Buffer<int16_t>& src, double offset = 0.0, double scale = 1.0);
//アルファブレンドをして出力を比較デバッグ用関数
void guiAlphaBlend(Buffer<uint8_t>& src1, Buffer<uint8_t>& src2, cv::String name = "alpha blend");
Func copy(Buffer<uint8_t>& src)
{
Var x("x"), y("y"), c("c");
Func output("output");
output(x, y, c) = src(x, y, c);
return output;
}
//utility function with OpenCV
void convertMat2Halide(cv::Mat& src, Buffer<uint8_t>& dest)
{
const int ch = src.channels();
if (ch == 1)
{
for (int j = 0; j < src.rows; j++)
{
for (int i = 0; i < src.cols; i++)
{
dest(i, j) = src.at<uchar>(j, i);
}
}
}
else if (ch == 3)
{
for (int j = 0; j < src.rows; j++)
{
for (int i = 0; i < src.cols; i++)
{
dest(i, j, 0) = src.at<uchar>(j, 3 * i);
dest(i, j, 1) = src.at<uchar>(j, 3 * i + 1);
dest(i, j, 2) = src.at<uchar>(j, 3 * i + 2);
}
}
}
}
Buffer<uint8_t> imread(cv::String name)
{
cv::Mat a = cv::imread(name);
if (a.empty()) std::cout << name << " is empty" << std::endl;
Buffer<uint8_t> ret(a.cols, a.rows, a.channels());
convertMat2Halide(a, ret);
return ret;
}
void convertHalide2Mat(const Buffer<uint8_t>& src, cv::Mat& dest)
{
if (dest.empty()) dest.create(cv::Size(src.width(), src.height()), CV_MAKETYPE(CV_8U, src.channels()));
const int ch = dest.channels();
if (ch == 1)
{
for (int j = 0; j < dest.rows; j++)
{
for (int i = 0; i < dest.cols; i++)
{
dest.at<uchar>(j, i) = src(i, j);
}
}
}
else if (ch == 3)
{
for (int j = 0; j < dest.rows; j++)
{
for (int i = 0; i < dest.cols; i++)
{
dest.at<uchar>(j, 3 * i + 0) = src(i, j, 0);
dest.at<uchar>(j, 3 * i + 1) = src(i, j, 1);
dest.at<uchar>(j, 3 * i + 2) = src(i, j, 2);
}
}
}
}
void imwrite(cv::String name, const Buffer<uint8_t>& src)
{
cv::Mat a(cv::Size(src.width(), src.height()), CV_MAKETYPE(CV_8U, src.channels()));
convertHalide2Mat(src, a);
cv::imwrite(name, a);
}
void imshow(cv::String name, const Buffer<uint8_t>& src)
{
cv::Mat a(cv::Size(src.width(), src.height()), CV_MAKETYPE(CV_8U, src.channels()));
convertHalide2Mat(src, a);
cv::imshow(name, a);
}
void imshow16(cv::String name, const Buffer<int16_t>& src, double offset, double scale)
{
cv::Mat a(cv::Size(src.width(), src.height()), CV_MAKETYPE(CV_8U, src.channels()));
const int ch = a.channels();
if (ch == 1)
{
for (int j = 0; j < a.rows; j++)
{
for (int i = 0; i < a.cols; i++)
{
a.at<uchar>(j, i) = cv::saturate_cast<uchar>(scale * src(i, j) + offset);
}
}
}
else if (ch == 3)
{
for (int j = 0; j < a.rows; j++)
{
for (int i = 0; i < a.cols; i++)
{
a.at<uchar>(j, 3 * i + 0) = cv::saturate_cast<uchar>(scale * src(i, j, 0) + +offset);
a.at<uchar>(j, 3 * i + 1) = cv::saturate_cast<uchar>(scale * src(i, j, 1) + +offset);
a.at<uchar>(j, 3 * i + 2) = cv::saturate_cast<uchar>(scale * src(i, j, 2) + +offset);
}
}
}
cv::imshow(name, a);
}
void guiAlphaBlend(Buffer<uint8_t>& src1, Buffer<uint8_t>& src2, cv::String name)
{
cv::Mat s1(cv::Size(src1.width(), src1.height()), CV_MAKETYPE(CV_8U, src1.channels()));
cv::Mat s2(cv::Size(src1.width(), src1.height()), CV_MAKETYPE(CV_8U, src1.channels()));
convertHalide2Mat(src1, s1);
convertHalide2Mat(src2, s2);
cv::namedWindow(name);
int a = 0; cv::createTrackbar("alpha", name, &a, 100);
int key = 0;
while (key != 'q')
{
cv::Mat show;
cv::addWeighted(s1, 1.0 - a / 100.0, s2, a / 100.0, 0.0, show);
cv::imshow(name, show);
key = cv::waitKey(1);
}
cv::destroyWindow(name);
}
参考サイト
https://github.com/microsoft/vcpkg
Visual Studio 2017 で MFC アプリ開発機能を追加するには
C/C++ パッケージマネージャvcpkgの使い方
OpenCVによるHalideプログラミングの開発支援
CMake&vcpkgでつまずいた点