G-API グラフコンパイル引数

コンパイル引数: コンパイル処理を制御するデータ構造。続き...

詳細説明

コンパイル引数: コンパイル処理を制御するデータ構造。

G-APIには、cv::GComputation::apply() や cv::GComputation::compile() に渡せる多数のグラフコンパイルオプションが用意されている。既知のコンパイルオプションはこのページに列挙されているが、追加のバックエンドが独自のコンパイルオプションを導入することもある（G-APIは cv::compile_args() に渡せるあらゆるものを透過的に受け付ける。オプションが解釈されるかどうかは下層のバックエンドに依存する）。

例えば、ある計算が次のように実行されるとする:

 cv::GComputation sobelEdge(cv::GIn(in), cv::GOut(out));
    sobelEdge.apply(input, output);

どのカーネルを用いてコンパイルするかを指定する追加の引数は、次のように渡せる:

 cv::GKernelPackage kernels = cv::gapi::combine
        (cv::gapi::core::fluid::kernels(),
 cv::gapi::imgproc::fluid::kernels());
    sobelEdge.apply(input, output, cv::compile_args(kernels));

名前空間
namespace	cv::gapi

クラス
struct	cv::gapi::plaidml::config
	この構造体は、実験的なPlaidMLバックエンドの基本的な引数を表す。 続き...
struct	cv::GCompileArg
	任意のコンパイル引数を表す。 続きを読む...
struct	cv::GFluidOutputRois
	この構造体により、Fluidバックエンドがグラフ内で生成する出力画像領域を制御できる。 続きを読む...
struct	cv::GFluidParallelFor
	この構造体により、Fluidが並列領域を実行する方法をカスタマイズできる。 続きを読む...
struct	cv::GFluidParallelOutputRois
	この構造体は、Fluidバックエンドに対してグラフ内で複数の並列出力領域を生成するよう強制する。これらの領域は並列に実行される。 続きを読む...
class	cv::GKernelPackage
	異種カーネル実装の集合およびグラフ変換のためのコンテナクラス。 続きを読む...
struct	cv::gapi::GNetPackage
	ネットワーク設定のためのコンテナクラス。GKernelPackage に類似する。このオブジェクトを構築するには cv::gapi::networks() を使用する。 続き...
struct	cv::gapi::use_only
	cv::gapi::use_only() は、cv::GComputation::compile() で指定したカーネルのみをG-APIに使用させる（そのパッケージに加えてデフォルトで利用可能なカーネルは拡張しない）よう指示する特別なコンビネータである。 続き...

型定義
using	cv::GCompileArgs = std::vector<GCompileArg>

関数
template<typename... Ts>
GCompileArgs	cv::compile_args (Ts &&... args)
	引数のリスト（パラメータパック）を、コンパイル引数のベクトル(cv::GCompileArg)にラップする。
template<typename... KK>
GKernelPackage	cv::gapi::kernels ()
	可変長テンプレート引数で指定したカーネルと変換を含むカーネルパッケージオブジェクトを生成する。
template<typename... FF>
GKernelPackage	cv::gapi::kernels (FF &... functors)
cv::GCompileArgs &	cv::operator+= (cv::GCompileArgs &lhs, const cv::GCompileArgs &rhs)

型定義詳解

GCompileArgs

using cv::GCompileArgs = std::vector<GCompileArg>

#include <opencv2/gapi/gcommon.hpp>

関数詳解

compile_args()

template<typename... Ts>

GCompileArgs cv::compile_args

(

Ts &&...

args

)

#include <opencv2/gapi/gcommon.hpp>

引数のリスト（パラメータパック）をコンパイル引数（cv::GCompileArg）のベクトルにラップする。

kernels() [1/2]

template<typename... KK>

GKernelPackage cv::gapi::kernels

(

)

#include <opencv2/gapi/gkernel.hpp>

可変長テンプレート引数で指定されたカーネルと変換を含むカーネルパッケージオブジェクトを生成する。

G-APIでは、カーネル実装と変換は型である。各バックエンドは独自のカーネルAPI（GAPI_OCV_KERNEL() や GAPI_FLUID_KERNEL() など）を持つが、これらのAPIはいずれもカーネル実装ごとに新しい型を定義する。

（いずれかの方法で定義された）カーネル実装と変換をシステムに渡すには、この関数を使用する。例:

 cv::GKernelPackage pkg = cv::gapi::kernels
        < CustomAdd
        , CustomFilter2D
        , CustomRGB2YUV
        >();

kernels() 自体はオブジェクトを返す関数であって型ではないため、末尾に () を付けることが重要である。すなわち関数呼び出しでなければならない。

この関数の呼び出しグラフ:

kernels() [2/2]

template<typename... FF>

GKernelPackage cv::gapi::kernels

(

FF &...

functors

)

#include <opencv2/gapi/gkernel.hpp>

この関数の呼び出しグラフ:

operator+=()

cv::GCompileArgs & cv::operator+= ( cv::GCompileArgs & lhs, const cv::GCompileArgs & rhs )

inline

#include <opencv2/gapi/gcommon.hpp>