In-Sight® SDK 5.7.3 リリースノート

© Copyright 1999-2019 Cognex Corporation. All rights reserved.

Revision: 5.7.3.5, 06/18/2019

概要

本書は、Microsoft® Windows® 用の In-Sight ソフトウェア開発キット (SDK) について説明します。本書は次のトピックから構成されます。

CvsInSightDisplay コントロールの詳細については、In-Sight ディスプレイコントロールのリリースノートを参照してください。

In-Sight SDK について

In-Sight SDK は、ネットワーク上の In-Sight ビジョンシステムとやり取りするカスタムアプリケーションを開発するためのプラットフォームを提供します。 In-Sight SDK では、In-Sight ディスプレイコントロールをフォームに載せただけの単純なものから、ジョブのロード、画像の保存、複数の I/O チャネルによる通信を行う強力なアプリケーションまで、さまざまなレベルのアプリケーションを開発することができます。

最新のリリースノートやドキュメンテーション (各国語版も含む) は、In-Sight オンラインサポートセンターでダウンロードできます。

注: In-Sight SDK は、In-Sight Micro 1020、In-Sight 2000 シリーズおよび In-Sight 7020、7010、7230、7430 および 7432 ではサポートされていません。

システム要件

この節では、In-Sight SDK のシステム要件について説明します。

PC ハードウェア最小および推奨要件

注:

最小要件 推奨要件
1.8GHz 動作の Intel® Celeron® 1000M プロセッサ (または同等品) 2.7GHz 動作の Intel® Core™ i7 プロセッサ (または同等品)
2GB の RAM 空き容量 4GB の RAM 空き容量
4GB のハードディスク空き容量 8GB のハードディスク空き容量
24 ビットカラーで解像度 1024✕768 の表示が可能なビデオカード。画面の DPI 設定は 96 DPI に設定します。 32 ビットカラーで解像度 1920✕1080 の表示が可能なビデオカード。画面の DPI 設定は 96 DPI に設定します。
In-Sight ビジョンシステムに接続するためのイーサネットネットワークインタフェースカード (100Mbps 以上) In-Sight ビジョンシステムに接続するためのギガビット・イーサネットネットワークインタフェースカード

オペレーティングシステム要件

In-Sight ソフトウェアは、次のオペレーティングシステムで動作することを確認しています。

In-Sight SDK はそのほかのオペレーティングシステムでも動作することがありますが、前述の要件を満たさないシステムはサポート対象外です。

言語サポート

サポートしているファームウェアバージョン

In-Sight 5.7.3 ソフトウェアには、次のファームウェアバージョンが含まれています。

以前のファームウェアを搭載している In-Sight ビジョンシステムは正常に動作することもありますが、 サポートされていない機能があり、また十分にテストが行われていません。 最適なパフォーマンスを得るには、In-Sight Explorer ソフトウェアおよびファームウェアは、最新バージョンを使用してください。 モデル一覧およびサポートされているファームウェアバージョンについては、英語版 In-Sight Explorer オンラインヘルプの「Firmware Versions」 (ファームウェアバージョンのトピック) をご参照ください。英語版 In-Sight Explorer オンラインヘルプのデフォルトロケーションは、C:\Program Files (x86)\Cognex\In-Sight\In-Sight Explorer 5.x.x\Documentation\Help\Help_ISE_EN.chm です。

In-Sight ファームウェア 5.7.3

In-Sight ファームウェア 4.10.5 PR1

注:

Microsoft .NET Framework 4.5

In-Sight ソフトウェアには、Microsoft .NET Framework 4.5 が必要です。 システムに検出されない場合、自動的にインストールされます。

注: In-Sight SDK を、Microsoft .NET Framework 3.5 を無効にしたシステムにインストールを試みているときに、Windows Update が処理中の場合、エラーメッセージが表示されることがあります: Error installing Microsoft .NET Framework; Error code 0x800f081f このエラーが発生した場合、Windows Update が完了するのを待って (再起動が必要です)、In-Sight SDK をインストールしてください。

サポートしている開発環境

注:

ToolBuilder サポート

In-Sight SDK を使用して、カスタムの EasyBuilder ツールを作成することができます (詳細についてはToolBuilder Programmer リファレンスガイドをご参照ください)。 EasyBuilder ツールで作成されたすべての ToolBuilder は、In-Sight Explorer アプリケーション内の次のディレクトリに保存してください: C:\Program Files (x86)\Cognex\In-Sight\In-Sight Explorer 5.x.x\AddIns。 EasyBuilder ツールで ToolBuilder を作成する場合、ツールの DLL は In-Sight Explorer 5.x.x\AddIns ディレクトリに保存する必要があります。 以前に作成した ToolBuilder DLL ファイルを、AddIns ディレクトリにコピー & ペーストしてください。

インストール

In-Sight SDK をインストールするユーザには、フル管理者権限が必要です。

注: 異なるバージョンの In-Sight ディスプレイコントロールまたは In-Sight SDK で開発された COM/ActiveX アプリケーションは、このバージョンとは互換性がなく、正しく動作しません。 カスタムアプリケーションをこのバージョンに合わせて再コンパイルするか、元のバージョンを再インストールしてください。 (CR# 5084)

サンプルプロジェクト

In-Sight SDK のサンプルプロジェクトは、次のフォルダにインストールされます: C:\Users\Public\Documents\Cognex\In-Sight\In-Sight Sample Projects 5.x.x。 [スタート] メニューから、サンプルフォルダのショートカットにアクセスすることができます。

既知の問題

注: Cognex テクニカルサポートを介して報告された既知の問題を追跡しやすくするために、該当する場合に番号が付与されています。 Cognex In-Sight ディスプレイコントロール (CvsInSightDisplay) の既知の問題に関する説明については、In-Sight ディスプレイコントロールのリリースノートをご覧ください。
問題番号 問題
82151

In-Sight SDK が、ローカル PC からビジョンシステムに CvsInSightDisplay.InSight.File.LoadJobFileLocally () 関数を使用して、ジョブをロードするのに失敗してしまいます。

回避策: ローカル PC からビジョンシステムにジョブをロードする際には、次の手順に従ってください。

  1. CvsInSightDisplay.InSight.File.SendFileToInSight () を使用して、ジョブを PC からビジョンシステムに送信します。
  2. CvsInSightDisplay.InSight.File.LoadJobFile () を使用して、ジョブをビジョンシステムにロードします。
31753

更新を必要とする In-Sight SDK アイテム (CvsInSightDisplay など) は、表示されているときのみ更新をリクエストします。非表示のとき、または最小化されているときはリクエストされません。

回避策: このシナリオで更新が必要な場合、In-Sight ビジョンシステムから新しい結果を取得するときに、CvsInSight.AcceptUpdate() や CvsInSightDisplay.AcceptUpdate() への呼び出しを追加してください。 CvsInSight.ResultsChanged イベントにハンドラーを添付することを推奨します。結果処理後、CvsInSight.AcceptUpdate を呼び出してください。
11930 SetExpression メソッドを呼び出す前に、ビジョンシステムがオフラインであることを確認することを推奨します。