インテルのみ表示可能 — GUID: ftb1641567923132
Ixiasoft
インテルのみ表示可能 — GUID: ftb1641567923132
Ixiasoft
12.5. Chroma Resampler IPのソフトウェアAPI
レジスター定義ヘッダーファイル: intel_vvp_crs_regs.h
インクルード・ファイル: intel_vvp_crs.h
名前 | 説明 |
---|---|
intel_vvp_crs_init | Chroma Resamplerインスタンスを初期化します。 |
intel_vvp_core_* | Video and Vision Processing IPのソフトウェア・プログラミング・モデルで定義されたアクセサー。Liteがオンの場合に書き込み可能。LiteがオフでDebug featuresがオンの場合には、読み出しが可能です。 |
intel_vvp_crs_get_lite_mode | Lite Modeがオンの場合に返します。 |
intel_vvp_crs_get_debug_enabled | Debug featuresがオンの場合に返します。 |
intel_vvp_crs_is_conversion_supported | IPが指定されたクロマ・リサンプリングをサポートしているかどうかを返します。 |
intel_vvp_crs_is_running | 現在、IPがビデオデータを処理しているかどうかを返します。 |
intel_vvp_crs_get_commit_status | コミットされていない書き込みを返します。 |
intel_vvp_crs_get_status | ステータスレジスターを読み出します。 |
intel_vvp_crs_set_output_subsampling | 現在の出力のサブサンプリングを選択します。 |
intel_vvp_crs_get_output_subsampling | 現在選択されている出力サブサンプリングを返します。 |
intel_vvp_crs_commit_writes | すべての未処理の書き込みをコミットします。 |
enum eIntelCrsSubsampling
- メンバー
-
kIntelVvpCrsSubsampling420 (0) – 4:2:0サブサンプリング。クロマプレーンの解像度は垂直方向と水平方向に半分になります。
kIntelVvpCrsSubsampling422 (2) – 4:2:2サブサンプリング。クロマプレーンの解像度は水平方向に半分になります。
kIntelVvpCrsSubsampling444 (3) – 4:4:4サブサンプリング。クロマプレーンは完全にサンプリングされます。
kIntelVvpCrsSubsamplingInvalid (1) – 無効なサブサンプリング (エラーを示すために使用)
- 説明
-
サポートされているクロマ・サブサンプリングの列挙
intel_vvp_crs_init
- プロトタイプ
-
int intel_vvp_crs_init(intel_vvp_crs_instance *instance, intel_vvp_core_base base);
- 説明
-
Chroma Resamplerインスタンスを初期化します。ベースアドレスで読み出されたベンダーIDまたは製品IDが一致しない場合、またはレジスターマップのバージョンがサポートされていない場合、初期化は早期に停止します。それ以外の場合、関数はIPコンパイル時のパラメーター化の読み出しと格納を続行します。インスタンスは完全に初期化されていないため、ゼロ以外のエラーコードを返した場合はアプリケーションでそれ以上使用しないでください。
- 引数
-
インスタンス – intel_vvp_crs_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
ベース - レジスターマップのベースアドレス
- 戻り値
-
成功の場合はkIntelVvpCoreOk (0)、エラーの場合は負のエラーコード
コアのベンダーIDがインテルFPGAベンダーID (0x6AF7) ではない場合は、kIntelVvpCoreVidErr
product_idがChroma Resampler製品IDと一致しない場合は、kIntelVvpCorePidErr
インスタンスがヌルポインターの場合は、kIntelVvpCoreInstanceErr
レジスターマップがサポートされていない場合は、kIntelVvpCrsRegMapVersionErr
intel_vvp_crs_get_lite_mode
- プロトタイプ
-
bool intel_vvp_crs_get_lite_mode(intel_vvp_crs_instance *instance);
- 説明
-
LITE_MODEレジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_crs_instanceである必要があります。
- 引数
-
インスタンス – intel_vvp_crs_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
- 戻り値
-
IPがライトモードでパラメーター化されている場合は、Trueを返します。
intel_vvp_crs_get_debug_enabled
- プロトタイプ
-
bool intel_vvp_crs_get_debug_enabled(intel_vvp_crs_instance *instance);
- 説明
-
DEBUG_ENABLEDレジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_crs_instanceである必要があります。
- 引数
-
インスタンス – intel_vvp_crs_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
- 戻り値
-
デバッグ機能がイネーブルになってIPがパラメーター化されている場合は、Trueを返します。
intel_vvp_crs_is_conversion_supported
- プロトタイプ
-
bool intel_vvp_crs_is_conversion_supported (intel_vvp_crs_instance *instance, eIntelCrsSubsampling input_subsampling, eIntelCrsSubsampling output_subsampling);
- 説明
-
MAX_WIDTHレジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_crs_instanceである必要があります。
- 引数
-
インスタンス – intel_vvp_crs_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
input_subsampling – 入力サブサンプリング
output_subsampling – 出力サブサンプリング
- 戻り値
-
入力サブサンプリングから出力サブサンプリングへのクロマ・リサンプリング、またはパススルーがサポートされている場合
intel_vvp_crs_is_running
- プロトタイプ
-
bool intel_vvp_crs_is_running(intel_vvp_crs_instance* instance);
- 説明
-
STATUSレジスターの実行ビットを読み出して返します。インスタンスは、完全に初期化された有効なintel_vvp_crs_instanceである必要があります。
- 引数
-
インスタンス – intel_vvp_crs_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
- 戻り値
-
現在、IPが入力フィールドを受信/格納している場合はTrue、2つの入力フィールドの間にある場合はFalseを返します。
intel_vvp_crs_get_commit_status
- プロトタイプ
-
bool intel_vvp_crs_get_commit_status(intel_vvp_crs_instance* instance);
- 説明
-
STATUSレジスターのコミット保留ビットを読み出して返します。インスタンスは完全に初期化され、フルモードでコンフィグレーションされた有効なintel_vvp_crs_instanceである必要があります。
- 引数
-
インスタンス – intel_vvp_crs_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
- 戻り値
-
IPがフルモードでコンフィグレーションされており、エージェント・インターフェイスにコミットされていない書き込みが含まれている場合は、Trueとなります。
intel_vvp_crs_get_status
- プロトタイプ
-
uint32_t intel_vvp_crs_get_status(intel_vvp_crs_instance* instance);
- 説明
-
STATUSレジスターを読み出します。インスタンスは、完全に初期化された有効なintel_vvp_crs_instanceである必要があります。
- 引数
-
インスタンス – intel_vvp_crs_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
- 戻り値
-
STATUSレジスターの内容を返します。
intel_vvp_crs_set_output_subsampling
- プロトタイプ
-
int intel_vvp_crs_set_output_subsampling(intel_vvp_crs_instance* instance, eIntelCrsSubsampling output_subsampling);
- 説明
-
必要な出力サブサンプリングを選択します。intel_vvp_core_set img_info_subsamplingを使用して、ライトモードで入力サブサンプリングを設定します。インスタンスは、完全に初期化された有効なintel_vvp_crs_instanceである必要があります。この呼び出しでは、IPが要求されたクロマ・リサンプリング変換をサポートしているかどうかはチェックされず、入力/出力の選択がサポートされていない場合はデフォルトの変換が使用されます。
- 引数
-
インスタンス – intel_vvp_crs_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
output_subsampling – 要求された出力サブサンプリング
- 戻り値
-
kIntelVvpCoreOk、またはエラーの場合は負のエラーコード
インスタンスがNULLポインターの場合、kIntelVvpCoreInstanceErr
出力サブサンプリングが無効な場合、kIntelVvpCrsParamErr
intel_vvp_crs_get_output_subsampling
- プロトタイプ
-
eIntelCrsSubsampling intel_vvp_crs_get_output_subsampling(intel_vvp_crs_instance* instance);
- 説明
-
OUTPUT_SUBSAMPLINGレジスターを読み出します。インスタンスは、完全に初期化された有効なintel_vvp_crs_instanceである必要があります。
- 引数
-
インスタンス – intel_vvp_crs_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
- 戻り値
-
OUTPUT_SUBSAMPLINGレジスターに書き込まれた最後の値、またはエラーの場合はkIntelVvpCrsSubsamplingInvalid
intel_vvp_crs_commit_writes
- プロトタイプ
-
int intel_vvp_crs_commit_writes(intel_vvp_crs_instance* instance)
- 説明
-
次のフィールドを処理する前に、ペンディング中の書き込みをすべてコミットします。インスタンスは有効であり、フルモードでパラメーター化されている必要があります。
- 引数
-
インスタンス – intel_vvp_crs_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
- 戻り値
-
成功の場合はkIntelVvpCoreOk (0)、それ以外の場合は負のエラーコード