Msako技術資料　

Size: px

Start display at page:

Download "Msako技術資料　"

さいぞうかたいわ
5 years ago
Views:

1 2015/06/29 MsakoAPI プログラミングガイド ( 改訂第 5 版 ) この資料は Msako MsakoAPI 1.8 以降に適応する Visual Studio のツールボックスに MsakoAPI を加えるプログラムに MsakoTranceiver を組み込む Msako と接続する Msako の基本情報を取得する Msako のパラメータを取得設定する動体検知のイベントを処理する動体検知の詳細データを取得する動体検知を開始停止するスナップショット画像を取得する再構成する再起動する外部機器で発生した異常を通知するイベント番号一覧を取得するイベント情報を取得するイベント画像を取得するサンプルプログラムを実行する 1

2 Visual Studio のツールボックスに MsakoAPI を加える新しい Windows フォームアプリケーションプロジェクトを作成するツールボックスの余白の部分でマウス右ボタンを押しアイテムの選択を選ぶ 2

3 ツールボックスアイテムの選択にて参照ボタンを押し MsakoAPI の DLL ファイル MsakoAPI.dll を指定するすると一覧に右のように追加されるツールボックスには MsakoTranceiver のアイコンが表示される 3

4 プログラムに MsakoTranceiver を組み込むツールボックスの MsakoTranceiver のアイコンをドラッグしてフォームの上でドロップする MsakoTranceiver1 という名前のコンポーネントが作成されてフォームの下に表示される 4

5 メッセージハンドラをオーバーライドする Protected Overrides Sub WndProc(ByRef m As Message) MsakoTranceiver1.WndProc(m) MyBase.WndProc(m) End Sub C#.NET の場合 protected override void WndProc(ref Message m) { MsakoTranceiver1.WndProc(ref m); base.wndproc(ref m); } 5

6 Msako と接続する MsakoAPI を使う場合先ず最初に Msako と接続しなければならない接続する相手の Msako は特定の1つであるここで注意しておかなければならないのは接続を試みる時点でシステムには2つ以上の Msako が存在する場合もあるということである 1つのシステム内で複数のカメラがあった場合それらを使用する Msako も複数個起動する Msako と接続するためには MsakoTranceiver クラスの Discover メソッドを使用するこのメソッドはシステム内にある Msako を探索する次の例はボタンコントロールを押したときにこのメソッドは呼ぶ例であるただしこれは 1 例でありどのタイミングで Msako と接続するかはプログラマに任せられている Private Sub btndiscover_click(byval sender As System.Object, ByVal e As System.EventArgs) Handles btndiscover.click If MsakoTranceiver1.Discover() <> MT_RESULT.MT_SUCCESS Then MessageBox.Show("Fail Discover()") End Sub C#.NET の場合 private void btndiscover_click(object sender, EventArgs e) { if (MsakoTranceiver1.Discover()!= MT_RESULT.MT_SUCCESS) MessageBox.Show("Fail Discover()"); } 上の例のように引数なしで Discover メソッドを呼んだ場合探索して発見した Msako のうち 1 番目の Msako に接続される探索した結果 Msako が見つからない場合このメソッドは MT_RESULT.MT_NOCONNECTION を返す探索した結果いくつの Msako が見つかったかは PeerCount プロパティを調べればわかる接続先の Msako を変更するためには SelectedIndex プロパティーを変更すればよいどのような順序で Msako が発見されるかは規則は無いが発見したそれぞれの Msako のウィンドウハンドルが GetPeerAt メソッドによって取得できるので取得したウィンドウハンドルを手がかりに相手の Msako を特定することが可能だまた後述する基本情報取得用のメソッドを使ってそれぞれの Msako の画像の大きさなどを調べ上げることもできる 6

7 Msako の基本情報を取得する接続している Msako について次の情報を得ることができるカメラ名カメラ別名撮影場所カメラ識別番号画像の横幅画像の高さ画像回転角 Msako の状態処理時間これらの情報を得るために次のメソッドが用意されている GetDeviceName GetAlias GetLocation GetCameraId GetImageSize GetStatus 次の例はカメラ名を取得してメッセージボックスに表示する例である Dim name As String = String.Empty If MsakoTranceiver1.GetDeviceName(name) = MT_RESULT.MT_SUCCESS Then MessageBox.Show(name) Else MessageBox.Show("Fail GetDeviceName()") C#.NET の場合 string name = string.empty; if (MsakoTranceiver1.GetDeviceName(ref name) == MT_RESULT.MT_SUCCESS) MessageBox.Show(name); else MessageBox.Show("Fail GetDeviceName()"); 7

8 Msako のパラメータを取得設定する接続している Msako に設定されているパラメータの値を取得したり変更することができる対象となるパラメータは次の通りである感度 (MP_SENSE_LEVEL) サンプル速度 (MP_FRAME_RATE) ブロックの大きさ (MP_BLOCK_SIZE) バッファ数 (MP_NUM_BUFFER) ターゲット数 (MP_NUM_TARGET) 閃光フィルタ (MP_FLASH_COMP) 頭部拡張補正 (MP_HEAD_COMP) ブロック結合度 (MP_BLOCK_COH) 警報レベル (MP_ALARM_LEVEL) 自動サンプル速度 (MP_AUTO_SPEED) これらのパラメータの値を取得するには GetParameter メソッドを設定するには SetParameter メソッドを使う次の例は感度を取得してメッセージボックスに表示する例である Dim pdata As MM_PARAM_DATA = New MM_PARAM_DATA() pdata.type = MM_PARAM_TYPE.MP_SENSE_LEVEL If MsakoTranceiver1.GetParameter(pdata) = MT_RESULT.MT_SUCCESS Then MessageBox.Show(pdata.param.int_value.ToString()) Else MessageBox.Show("Fail GetParameter()") C#.NET の場合 MM_PARAM_DATA pdata = new MM_PARAM_DATA(); pdata.type = MM_PARAM_TYPE.MP_SENSE_LEVEL; if (MsakoTranceiver1.GetParameter(ref pdata) == MT_RESULT.MT_SUCCESS) MessageBox.Show(pdata.param.int_value.ToString()); else MessageBox.Show("Fail GetParameter()"); 8

9 動体検知のイベントを処理する Msako が動体を検知したことは MsakoTranceiver のイベント 1 として通知される従ってプログラマは MsakoTranceiver のイベントハンドラーを作成することによって Msako が動体を検知したことに応じた処理を実施することができる MsakoTranceiver には次のイベント 1 がある Initialized Terminated Started Stoped EventStart EventEnd EventAlarm NoMotion MotionDetected Motion 2 Msako が起動した Msako が停止した動体検知を開始した動体検知を停止した動体検知のイベントが発生した動体検知のイベントが終了した動体検知のイベントが警告モードになった動きまセンサーが検知した動体検知フレームを検出した動体検知フレームの詳細データこれらのイベントについてイベントハンドラーを作成する方法は通常の.NET アプリケーションと同じ要領である Visual Studio のフォームに表示されている MsakoTranceiver のインスタンスを選択しプロパティウィンドウに表示されたイベント名をダブルクリックすれば自動的に空のイベントハンドラが作成されるプログラマは作製された空のイベントハンドラーに処理したい内容を書き足してゆく次の例は MotionDetected に対するイベントハンドラである Private Sub MsakoTranceiver1_MotionDetected(ByVal sender As System.Object, ByVal e As MsakoAPI.MsakoEventArgs) Handles MsakoTranceiver1.MotionDetected MessageBox.Show(" 動体を検知しました ") End Sub C#.NET の場合 private void MsakoTranceiver1_MotionDetected(object sender, MsakoEventArgs e) { MessageBox.Show(" 動体を検知しました "); } 1 Msako の動体検知イベントと.NET のクラスのイベントは別のものであるので区別して理解すること 2 Motion イベントについてはそれ以外と区別して後の章で説明する 9

10 MsakoTranceiver1 という名前のコンポーネントを選択しプロパティーウィンドウのイベント MotionDetected をダブルクリックするするとコードウィンドウが開いて MsakoTranceiver1_MotionDetected という名前の空のイベントハンドラが作成されるここに自分の処理を書き加えてゆく 10

11 動体検知の詳細データを取得するフレームごとに動体検知の過程で算出したデータを取得することができるこれらのデータを取得するにはあらかじめ MsakoTranceiver の Listen メソッドを使って接続している Msako にデータの配信を依頼しておく必要がある検知したフレームの日時イベントが開始した日時イベント番号フレーム番号総移動ピクセル数認識されたターゲット数ターゲットごとの情報ターゲットの識別子ターゲットに含まれる移動ピクセル数ターゲットの重心の座標ターゲットの範囲ターゲットの色ターゲットのスポット領域これらのデータは前の章では説明しなかったが前の章と同様に MsakoTranceiver の Motion イベントとして通知されるしたがってイベントハンドラの中で処理することも同様であるただしこのイベントハンドラには MotionEventArgs という引数が渡されるこの MotionEventArgs 引数には MM_MOTION_DATA 型の構造体が含まれていてこの構造体に上記の詳細データが記述されている次の例は 1 番目のターゲットの重心の座標をフォーム上のテキストボックスに表示する例である Private Sub MsakoTranceiver1_Motion(ByVal sender As System.Object, ByVal e As MsakoAPI.MotionEventArgs) Handles MsakoTranceiver1.Motion textcx.text = e.mdata.target0.center_x.tostring() textcy.text = e.mdata.target0.center_y.tostring() End Sub C#.NET の場合 private void MsakoTranceiver1_Motion(object sender, MotionEventArgs e) { textcx.text = e.mdata.target0.center_x.tostring(); textcy.text = e.mdata.target0.center_y.tostring(); } 11

12 動体検知を開始停止する Msako の動体検知を開始停止するには MsakoTranceiver の Start メソッド Stop メソッドを使うこれらのメソッドにはタイムアウト時間の引数があるここで指定した時間内に Msako が起動しなかった場合このメソッドは MT_RESULT.MT_TIMEOUT を返すプログラマはそれぞれのシステムに応じてこのタイムアウト時間を適宜設定する次の例はフォーム上のボタンが押されると開始停止する例で開始に 3 秒停止に 1 秒のタイムアウト時間を設定している Private Sub btnstart_click(byval sender As System.Object, ByVal e As System.EventArgs) Handles btnstart.click If MsakoTranceiver1.Start(3000) <> MT_RESULT.MT_SUCCESS Then MessageBox.Show("Fail Start()") End Sub Private Sub btnstop_click(byval sender As System.Object, ByVal e As System.EventArgs) Handles btnstop.click If MsakoTranceiver1.Stop(1000) <> MT_RESULT.MT_SUCCESS Then MessageBox.Show("Fail Stop()") End Sub C#.NET の場合 private void btnstart_click(object sender, EventArgs e) { if (MsakoTranceiver1.Start(3000)!= MT_RESULT.MT_SUCCESS) MessageBox.Show("Fail Start()"); } private void btnstop_click(object sender, EventArgs e) { if (MsakoTranceiver1.Stop(1000)!= MT_RESULT.MT_SUCCESS) MessageBox.Show("Fail Stop()"); } 12

13 スナップショット画像を取得する Msako の最新のスナップショット画像を取得するには MsakoTranceiver の GetSnapshot メソッドを使うこのメソッドは引数で指定した Bitmap オブジェクトに取得した画像を返すただし Msako が停止している場合は全体が黒い画像を返す次の例はタイムアウト時間を 200 ミリ秒に設定してスナップショット画像を取得する例である Dim bmpsnapshot As Bitmap = Nothing If MsakoTranceiver1.GetSnapshot(bmpSnapshot, 200) <> MT_RESULT.MT_SUCCESS Then MessageBox.Show("Fail GetSnapshot()") C#.NET の場合 Bitmap bmpsnapshot = null; if (MsakoTranceiver1.GetSnapshot(ref bmpsnapshot, 200)!= MT_RESULT.MT_SUCCESS) MessageBox.Show("Fail GetSnapshot()"); 13

14 再構成する Msako の設定値を再度読み込ませるためには MsakoTranceiver の Configure メソッドを使う次の例はタイムアウト時間を 2 秒に設定して再構成する例である If MsakoTranceiver1.Configure(2000) <> MT_RESULT.MT_SUCCESS Then MessageBox.Show("Fail Configure()") C#.NET の場合 if (MsakoTranceiver1.Configure(2000)!= MT_RESULT.MT_SUCCESS) MessageBox.Show("Fail Configure()"); 再起動する Msako の再起動するためには MsakoTranceiver の Reset メソッドを使う If MsakoTranceiver1.Reset() <> MT_RESULT.MT_SUCCESS Then MessageBox.Show("Fail Reset()") C#.NET の場合 if (MsakoTranceiver1.Reset()!= MT_RESULT.MT_SUCCESS) MessageBox.Show("Fail Reset()"); 14

15 外部機器で発生した異常を通知するセンサなど外部機器が捉えた異常を Msako に通知するためには MsakoTranceiver の Alarm メソッドを使う次の例は画面上にある4つのチェックボックスの値を各警報チャネルのビット値にみたてて通知する例である ch4 = 1, ch3 = 1, ch2 = 0, ch1 = 1 Dim channels As Integer channels = 0 If chkalarm1.checked Then channels = channels Or &H1 If chkalarm2.checked Then channels = channels Or &H2 If chkalarm3.checked Then channels = channels Or &H4 If chkalarm4.checked Then channels = channels Or &H8 If MsakoTranceiver1.Alarm(channels) <> MT_RESULT.MT_SUCCESS Then MessageBox.Show("Fail Alarm()") C#.NET の場合 int channels = 0; if (chkalarm1.checked) channels = 0x ; if (chkalarm2.checked) channels = 0x ; if (chkalarm3.checked) channels = 0x ; if (chkalarm4.checked) channels = 0x ; if (MsakoTranceiver1.Alarm(channels)!= MT_RESULT.MT_SUCCESS) MessageBox.Show("Fail Alarm()"); 15

16 イベント番号一覧を取得するバージョン番号の一覧を取得するためには MsakoTranceiver の GetEventList メソッドを使うこのメソッドは引数で与えた整数を要素とするリスト System.Collections.Generic.List にイベント番号の一覧を返す Dim list As New List(Of Integer) If MsakoTranceiver1. GetEventList(list) <> MT_RESULT.MT_SUCCESS Then MessageBox.Show("Failed GetEventList()") C#.NET の場合 List<int> list = new List<int>(); if (MsakoTranceiver1.GetEventList(ref list)!= MT_RESULT.MT_SUCCESS) MessageBox.Show("Fail GetEventList()"); 16

17 イベント情報を取得する Msako が保持している特定の 1 つのイベントの情報を取得するためには MsakoTranceiver の GetEventData メソッドを使う次の例はイベント番号 31 の延べ時間をテキストボックスに表示する例である Dim data As MM_EVENT_PROFILE = New MM_EVENT_PROFILE() If MsakoTranceiver1.GetEventData(31, data) = MT_RESULT.MT_SUCCESS Then textduration.text = data.duration.tostring() Else MessageBox.Show("Failed GetEventData()") C#.NET の場合 MM_EVENT_PROFILE data = new MM_EVENT_PROFILE(); if (MsakoTranceiver1. GetEventData(31, ref data) == MT_RESULT.MT_SUCCESS) { textduration.text = data.duration.tostring(); } else { MessageBox.Show("Fail GetEventData()"); } 17

18 イベント画像を取得する Msako が保持している特定の1つのイベントの画像を取得するためには MsakoTranceiver の GetEventImage メソッドを使うこのメソッドは引数で与えた System.Drawing.Bitmap に引数で指定したイベント番号の画像を返す次の例はイベント番号 15の画像を取得する例である Dim bmp As Bitmap = Nothing If MsakoTranceiver1.GetEventImage(15, bmp, 200) <> MT_RESULT.MT_SUCCESS Then MessageBox.Show("Failed GetEventImage()") C#.NET の場合 Bitmap bmp = null; if (MsakoTranceiver1.GetEventImage(15, ref bmp, 200)!= MT_RESULT.MT_SUCCESS) { MessageBox.Show("Fail GetEventImage()"); } 18

サンプルプログラムを実行する MsakoAPI のサンプルプログラムにはソースとそれにもとづいて作成された実行プログラムが含まれているこのサンプルプログラムは MsakoAPI を使って独自のプログラムを作成するにあたり素早く MsakoAPI の使用法を理解するのに役立つだろうここではこのサンプルプログラムを起動して操作するする手順を説明するなおこのサンプルプログラムは

19 サンプルプログラムを実行する MsakoAPI のサンプルプログラムにはソースとそれにもとづいて作成された実行プログラムが含まれているこのサンプルプログラムは MsakoAPI を使って独自のプログラムを作成するにあたり素早く MsakoAPI の使用法を理解するのに役立つだろうここではこのサンプルプログラムを起動して操作するする手順を説明するなおこのサンプルプログラムは Microsoft Visual Studio 2010 Professional にて作成されている (1) サンプルプログラムを起動する前に Msako 本体を起動しておく (2) Msako の詳細設定タブにあるメッセージに関する設定を次のように設定する (3) 続いてサンプルプロフラムを起動するサンプルプログラムには C# 版と Visual Basic 版があるが機能は全く同じである C# 版 MsakoAppCS_*.*\bin\Release\MsakoAppCS.exe Visual Basic 版 MsakoAppVB_*.*\bin\Release\MsakoAppVB.exe 19

(4) 次のようなサンプルプログラムの画面が表示される (5) サンプルプログラムの画面にある [Discover] ボタンを押すこれによって現在起動されている Msako と接続される Msako が複数のカメラを使用している場合 MsakoAPI は任意のカメラと接続できるがこのサンプルプログラムでは最初に発見したカメラと接続するようになっている (6) [Get Name]

20 (4) 次のようなサンプルプログラムの画面が表示される (5) サンプルプログラムの画面にある [Discover] ボタンを押すこれによって現在起動されている Msako と接続される Msako が複数のカメラを使用している場合 MsakoAPI は任意のカメラと接続できるがこのサンプルプログラムでは最初に発見したカメラと接続するようになっている (6) [Get Name] ボタンを押すと接続されたカメラの名前が表示されるまた同様に [Get Size] は画像の大きさ [Get Status] は現在の状態が表示される (7) [Get Param] および [Set Param] は設定値の取得変更を行うことができる (4) の例は感度を 85% に設定している (8) [Listen] ボタンを押すと例えばイベントが開始した (WM_MSAKO_EVENT_START) とか動体を検知した (WM_MSAKO_MOTION_DETECTED) といった MsakoAPI のイベントが受信可能になる (9) [Start] ボタンを押すと Msako の監視が開始する反対に [Stop] ボタンで監視を停止する (10) [Alarm] ボタンはその右側にあるチェックボックスで設定された外部トリガー信号を Msako に送出するこれによって Msako のイベント一覧には外部トリガーのイベントが表示される (11) [Snapshot] ボタンを押すと現在の画像が表示される (12) 動体を検知すると Cx Cy 欄にターゲットの重心位置 Spot 欄にターゲットのスポット領域の番号が表示される (13) 動体検知のイベントが終了するとイベントの画像が表示され画面の一番下にイベントの経過時間とレベル値 (db) が表示される 20

プロセス間通信

プロセス間通信プロセス間通信 (SendMessage) プロセス間通信とは同一コンピューター上で起動して居るアプリケーション間でデータを受け渡し度い事は時々有る Framework にはリモート処理と謂う方法でデータの受け渡しを行なう方法が有る此処では此の方法では無く従来の方法の API を使用したプロセス間通信を紹介する此の方法は送信側は API の SendMessage で送り