目次はじめに概要プロジェクトウィンドウフレームワークユーザークラスサンプルコンストラクタデストラクタ OnUserIO()

Size: px

Start display at page:

Download "目次はじめに概要プロジェクトウィンドウフレームワークユーザークラスサンプルコンストラクタデストラクタ OnUserIO()"

いっけいうえや
5 years ago
Views:

1 Photonfocus 社インテリジェントカメラ SM2 シリーズチュートリアル株式会社アプロリンク

2 目次はじめに概要プロジェクトウィンドウフレームワークユーザークラスサンプルコンストラクタデストラクタ OnUserIO() OnImage() サンプルコンストラクタデストラクタ OnUserIO() OnImage() サンプルコンストラクタデストラクタ OnUserIO() OnImage() その他のサンプル改定履歴

3 はじめにこの度は株式会社アプロリンク取り扱い製品をご使用いただき誠にありがとうございますご使用の前にこの資料をお読みいただき正しくお使い下さい本書はお客様が Windows/MAC の基本操作に習熟している事を前提にしております本書内で使用されている表示画面イラスト等は説明用に作成されたものですお客様の環境により実際の表示画像と違う場合がございますご使用のパソコン周辺機器オペーレーティングソフトなどお客様のご利用環境により正常に動作しない場合があります本書に使用する内容の一部または全部は株式会社アプロリンクによる許可なく転載することはできません本書の内容について万一不審な点や記載漏れなどお気付きの点がありましたらご連絡下さい本書の内容に疑問点などが生じた場合はメーカー発行の英文技術資料および英文マニュアルを正しい情報として下さい本書の内容は予告なしに変更する場合がありますのでご了承ください 2

1 概要このドキュメントは Photonfocus 社インテリジェントカメラ SM2 シリーズのソフトウェアフレームワークの基本コンセプトを紹介するものです Texas Instruments(TI) 社 Code Composer Studio(CCS) 開発キットの基礎知識 ( プロジェクトのオープンコンパイルターゲット DSP へのロード ) は含んでおりません Code

4 1 概要このドキュメントは Photonfocus 社インテリジェントカメラ SM2 シリーズのソフトウェアフレームワークの基本コンセプトを紹介するものです Texas Instruments(TI) 社 Code Composer Studio(CCS) 開発キットの基礎知識 ( プロジェクトのオープンコンパイルターゲット DSP へのロード ) は含んでおりません Code Composer Studio(CCS) のサポートについては Texas Instruments(TI) 社製品販売店にお問い合わせください 1-1 プロジェクトウィンドウプロジェクトをオープンした後各プロジェクトの各種ファイルはプロジェクトファイル一覧ウィンドウで表示されます図 1-1 プロジェクトファイル一覧ファイルの種類 : DSP/BIOS コンフィグファイル DSP/BIOS マルチタスクカーネルコンフィグファイルを利用して実行時に DSP / BIOS API で使用するためのオブジェクトとプロパティを設定することができますこれらのオブジェクトはスレッドスレッドの優先順位 I / O ストリームイベントログメモリ割り込みハンドラが含まれています生成ファイル DSP/BIOS で自動生成されたファイルですインクルードファイルビルドプロセスでプログラムが自動的にインクルードファイルを検索しますので手動で追加する必要がありませんプロジェクトをビルドした後インクルードファイルがプロジェクトウィンドウで表示されますライブラリプリコンパイル関数ライブラリソースユーザーソースコードファイル CMD リンカーコマンドファイルプログラムとデータセクションをメモリにマッピングするファイルです 3

5 1-2 フレームワーク SM2 シリーズカメラ用のソフトウェアはソースコードプリコンパイルされたライブラリ (Framework.lib) として提供されているフレームワークに構成されています下記機能の各種 C++ クラスが含まれています : カメラセンサーから DSP メモリへ画像転送カメラパラメータの変更ロードと保存イーサネットインターフェイスの提供ユーザー入力の取り扱いグラフィカルユーザーインターフェース (GUI) ユーザークラスユーザーで実装するアプリケーションのクラスは : アプリケーションダイアログクラス CDlgApp ですヘッダファイル CDlgApp.hpp と実装ファイル CDLgApp.cpp で構成されておりこのクラスで画面の左側にダイアログを生成しカメラ取得画像へのアクセスを提供しますこのクラスは以下の 4 つの関数を宣言します : コンストラクタ (CDlgApp()) - クラスの構築 - ユーザー変数の初期化などデストラクタ ( CDlgApp()) - クラスのクリーンアップ - メモリの解放など OnUserIO() - この関数は自動的にフレームワークによって呼び出されます - キーボードやマウス等のユーザー入力の処理に使用されます OnImage() - 画像取得後この関数はフレームワークによって呼び出されます - 画像処理に使用されます 4

6 2 サンプル 1 このサンプルはカメラのライブ画像を表示しユーザー入力を処理するサンプルです図 2-1 サンプルコンストラクタコンストラクタで関数 ReadIcon("B_BACK.PNG", 98, 98) で micro SD カードからアイコンイメージをロードしアプリケーションダイアログ (GUI_DlgAddIconButton()) にアイコンボタンを追加しましたこのボタンが識別子 DLG_ABORT を取得しボタンをクリックするとダイアログから出てメインダイアログに戻ります CDlgApp::CDlgApp(CPSApp *phapp, int x, int y, int Width, int Height) :CDlg(pHApp, x, y, Width, Height) SetID(DLG_APP); // Set Id of dialog GUI_DlgSetTitle(&m_Dlg, "Example 1"); // Change title of dialog // Add cancel button int iheight = m_pa->m_icon[icon_back].height; GUI_DlgAddIconButton(&m_Dlg, 110, Height - (iheight + 8), 98, 98, "_Back", &m_pa->m_icon[icon_back], DLG_ABORT); 5

7 2-2 デストラクタ GUI_DlgFree(&m_Dlg) を利用してダイアログのメモリを解放します CDlgApp::~CDlgApp() GUI_DlgFree(&m_Dlg); 2-3 OnUserIO() この関数は最初にダイアログにアプリケーションのフォーカスにあるかどうかをチェックします即ちこのダイアログはプログラムのアクティブダイアログでありユーザ入力を処理することを指しています次に関数 GUI_DlgWork() が呼び出されますユーザーが Constructor(ID = DLG_ABORT) で作成されたボタンを選択した場合フォーカスはアプリケーションのメインダイアログに戻りますユーザー入力後ダイアログは GUI_DlgRefresh() で画面上に描画されます int CDlgApp::OnUserIO(int nkey) m_activity = 0; if ((*m_dlgfocus == m_id) && (*m_dlgnewfocus == m_id)) // m_activity contains an event ID of the last user input m_activity = GUI_DlgWork(&m_Dlg, nkey); switch (m_activity) case DLG_ABORT: // Return focus to main dialog *m_dlgnewfocus = DLG_MAIN; pdlgmain->enable(1); // Enable DlgMain again m_pa->m_view = m_pa->m_viewold; m_visible = 0; // Hide example dialog break; if (m_activity) // Update dialog after user interaction GUI_DlgRefresh(&m_Dlg); return m_activity; 6

8 2-4 OnImage() カメラからのグレー画像を RGB 画像にコピー変換します int CDlgApp::OnImage(YIMAGE *psrc, CIMAGE *pdst) // Copy the image from psrc to pdst GUI_CopyYArea2RGB(pSrc, pdst, 0, 0, psrc->width, psrc->height, 0, 0); return 0; 7

3 サンプル 2 このサンプルはサンプル 1 をベースとしたものでありシンプルな画像処理とより多くのユーザー入力を処理します図 3-1 サンプル 2 3-1 コンストラクタこのコンストラクタはサンプル 1 をベースにしていますスライダーダイアログ項目に割り当てられている新しいメンバー変数 m_thresh を追加しています m_thresh = 128; // Create

9 3 サンプル 2 このサンプルはサンプル 1 をベースとしたものでありシンプルな画像処理とより多くのユーザー入力を処理します図 3-1 サンプルコンストラクタこのコンストラクタはサンプル 1 をベースにしていますスライダーダイアログ項目に割り当てられている新しいメンバー変数 m_thresh を追加しています m_thresh = 128; // Create dialog edit slider GUI_DlgAddEditSlider(&m_Dlg, 8, 32, Width-16, "_Threshold", &m_thresh, 0, 255, 1); 3-2 デストラクタサンプル 1 と同様です 3-3 OnUserIO() サンプル 1 をベースとしています m_thresh の値が自動的に GUI_DlgWork() 関数で変更されます 8

10 3-4 OnImage() カメラ画像に二値化処理を追加します画像の各画素を閾値と比較され大きい値は白 (255) により小さい値が黒 (0) に設定されています int CDlgApp::OnImage(YIMAGE *psrc, CIMAGE *pdst) unsigned char *restrict py = psrc->py; // Shortcut to camera image pointer // Threshold image for (int i=0; i<psrc->width*psrc->height; i++) py[i] = (py[i]>m_thresh)? 255 : 0; // Copy the image from psrc to pdst GUI_CopyYArea2RGB(pSrc, pdst, 0, 0, psrc->width, psrc->height, 0, 0); return 0; 注意これは DSP 用の最速の二値化アルゴリズムではありません 9

11 4 サンプル 3 このサンプルもサンプル 1 をベースとしたものでありカメラのパラメータを変更するサンプルです図 4-1 サンプル 3 10

12 4-1 コンストラクタこのコンストラクタもサンプル 1 をベースにしています新しいメンバー変数 m_exposuretime を追加し編集スライダは露光時間の値の範囲により良い適応を取得するために対数モードに切り替えられます露出機能へのポインタはアプリケーションのメインクラス (m_pa - > m_pexposuretime) からメンバーをアクセスすることで生成します現在のカメラパラメータ値が GetValue() で最小値と最大値が GetMin() や GetMax() で読み込まれます SetValue() 関数は新しい値を設定します CFeature *pexposuretime = m_pa->m_pexposuretime; // Shortcut to exposure feature m_exposuretime = pexposuretime->getvalue(); // Copy value of exposure into member variable // Create dialog buttons GUI_DlgAddButton(&m_Dlg, 8, 32, Width-16, 24, "Exposure _10000", 1); GUI_DlgAddButton(&m_Dlg, 8, 64, Width-16, 24, "Exposure _20000", 2); // Create dialog edit slider DLG_ITEMD *pitem = GUI_DlgAddEditSlider(&m_Dlg, 8, 96, Width-16, "_Exp", &m_exposuretime, pexposuretime->getmin(), pexposuretime->getmax(), 3); GUI_DlgSetEditSliderType(pItem, DLG_ES_LOGARITHMIC); 4-2 デストラクタサンプル 1 と同様です 4-3 OnUserIO() この関数は GUI_DlgWork() で他のユーザー入力イベントを処理しますボタン 1 又は 2 を選択して露光時間を指定しますスライダを移動した場合 GUI_DlgWork() の戻り値は DLG_VALUE_ になりますこの場合 GUI_GetSelectedID() でアクティブ項目の識別子を決定します戻り値の Id が一致した場合露光時間が変更されます 11

13 int CDlgApp::OnUserIO(int nkey) CFeature *pexposuretime = m_pa->m_pexposuretime; // Shortcut m_activity = 0; if ((*m_dlgfocus == m_id) && (*m_dlgnewfocus == m_id)) m_activity = GUI_DlgWork(&m_Dlg, nkey); // m_activity contains an event ID of the last user input switch (m_activity) case 1: // Button 1 pexposuretime->setvalue(10000); m_exposuretime = 10000; break; case 2: // Button 2 pexposuretime->setvalue(20000); m_exposuretime = 20000; break; case DLG_VALUE_CHANGED: // Slider value has changed if (GUI_DlgGetSelectedID(&m_Dlg) == 3) // Exposure edit slider pexposuretime->setvalue(m_exposuretime); break; case DLG_ABORT: *m_dlgnewfocus = DLG_MAIN; pdlgmain->enable(1); m_pa->m_view = m_pa->m_viewold; m_visible = 0; break; if (m_activity) GUI_DlgRefresh(&m_Dlg); return m_activity; 4-4 OnImage() サンプル 1 と同様です 12

5 その他のサンプル prj_imagelib プロジェクトは TI 社の高度に最適化された画像ライブラリの一部の機能へのアクセスを提供しますユーザーは SDK プロジェクトとライブラリ (IMG_thr_gt2max() IMG_thr_le2min() IMG_perimeter() IMG_sobel ())

14 5 その他のサンプル prj_imagelib プロジェクトは TI 社の高度に最適化された画像ライブラリの一部の機能へのアクセスを提供しますユーザーは SDK プロジェクトとライブラリ (IMG_thr_gt2max() IMG_thr_le2min() IMG_perimeter() IMG_sobel ()) から異なるエッジ検出機能の切り替え ROI を選択することができます図 5-1 Image LIB と Halcon のサンプルもう一つのサンプル (prj_halcon) がプロジェクトに Halcon ライブラリを統合する方法を示しています画像処理ステップは閾値セグメンテーションモフォロジと物体の特徴の検出です 13

15 改定履歴日付内容 Revision 初版

文書番号 :PFA012 Revision :1.01 Photonfocus 社 PFRemote 機能 Window 株式会社アプロリンク

文書番号 :PFA012 Revision :1.01 Photonfocus 社 PFRemote 機能 Window 株式会社アプロリンク Photonfocus 社 PFRemote 機能 Window 株式会社アプロリンク目次はじめに... 2 1 バージョン確認... 3 2 Window タブ... 4 2-1 Region of Interest... 4 2-2 Decimation... 5 2-3 Crosshairs... 6 2-4 Multi-ROI... 7 改定履歴... 9 1 はじめにこの度は株式会社アプロリンク取り扱い製品をご使用いただき誠にありがとうございます

目次 はじめに 概要 プロジェクトウィンドウ フレームワーク ユーザークラス サンプル コンストラクタ デストラクタ OnUserIO()

目次はじめに概要プロジェクトウィンドウフレームワークユーザークラスサンプルコンストラクタデストラクタ OnUserIO()