CogVerificationDatabase.AddImages Method (String[], Boolean, CogVerificationSimpleResultConstants, String)

CogVerificationDatabase AddImages Method ( String , Boolean, CogVerificationSimpleResultConstants, String)

Cognex VisionPro 9.8 SR1

Adds all the images in the specified array to this verification database. If any image in the specified array cannot be loaded, this method stops and throws an exception.

Namespace: Cognex.VisionPro.Inspection
Assembly: Cognex.VisionPro.Inspection (in Cognex.VisionPro.Inspection.dll) Version: 75.0.0.0 (75.0.0.0)

Syntax

C++

Copy to Clipboard Print

public string[] AddImages(
	string[] images,
	bool referenceImages,
	CogVerificationSimpleResultConstants defaultSimpleResult,
	string defaultGrade
)

public string[] AddImages(
	string[] images,
	bool referenceImages,
	CogVerificationSimpleResultConstants defaultSimpleResult,
	string defaultGrade
)

Public Function AddImages ( 
	images As String(),
	referenceImages As Boolean,
	defaultSimpleResult As CogVerificationSimpleResultConstants,
	defaultGrade As String
) As String()

Public Function AddImages ( 
	images As String(),
	referenceImages As Boolean,
	defaultSimpleResult As CogVerificationSimpleResultConstants,
	defaultGrade As String
) As String()

public:
array<String^>^ AddImages(
	array<String^>^ images, 
	bool referenceImages, 
	CogVerificationSimpleResultConstants defaultSimpleResult, 
	String^ defaultGrade
)

public:
array<String^>^ AddImages(
	array<String^>^ images, 
	bool referenceImages, 
	CogVerificationSimpleResultConstants defaultSimpleResult, 
	String^ defaultGrade
)

Parameters

images: Type: System String
An array that holds the full path to the images to be added.

referenceImages: Type: System Boolean
Set this to true if the images should be referenced by their full path. Set this to false if the images should be embedded (copied) into the database.

defaultSimpleResult: Type: Cognex.VisionPro.Inspection CogVerificationSimpleResultConstants
The default simple result for all the added images

defaultGrade: Type: System String
The default advanced grade for all the added images. If NULL then verificationData.Params.ExpectedOutputs.Grade.Value will not be set

Return Value

Type: String
An array of all the images that were added to the database.

Exceptions

Exception	Condition
InvalidOperationException	Thrown if not currently connected.
ArgumentNullException	Thrown if images is null.
ArgumentNullException	Thrown if images is zero length.

Examples

Copy to Clipboard Print

Imports Cognex.VisionPro
Imports Cognex.VisionPro.Database
Imports Cognex.VisionPro.Inspection

Private Sub Init()
        Dim mInputDatabase As New CogVerificationDatabase(New CogDatabaseDirectory("C:\SampleDatabase"))
        mInputDatabase.Connect()

        ' Create an array which contains the full path for the images
        Dim images As String() = New String() {"C:\Images\sample1.bmp", "C:\Images\sample2.bmp"}

        ' Add image to the database with no grade
        mInputDatabase.AddImage(images, True, CogVerificationSimpleResultConstants.Accept, "Excellent")

        mInputDatabase.Disconnect()
End Sub

Imports Cognex.VisionPro
Imports Cognex.VisionPro.Database
Imports Cognex.VisionPro.Inspection

Private Sub Init()
        Dim mInputDatabase As New CogVerificationDatabase(New CogDatabaseDirectory("C:\SampleDatabase"))
        mInputDatabase.Connect()

        ' Create an array which contains the full path for the images
        Dim images As String() = New String() {"C:\Images\sample1.bmp", "C:\Images\sample2.bmp"}

        ' Add image to the database with no grade
        mInputDatabase.AddImage(images, True, CogVerificationSimpleResultConstants.Accept, "Excellent")

        mInputDatabase.Disconnect()
End Sub

C++

Copy to Clipboard Print

using Cognex.VisionPro;
using Cognex.VisionPro.Database;
using Cognex.VisionPro.Inspection;

private Init()
{
    CogVerificationDatabase mInputDatabase = new CogVerificationDatabase(new CogDatabaseDirectory(@"C:\SampleDatabase"));
    mInputDatabase.Connect();

    // Create an array which contains the full path for the images 
    string[] images = new string[]{@"C:\Images\sample1.bmp",@"C:\Images\sample2.bmp"};

    // Add image to the database with no grade
    mInputDatabase.AddImage(images,true,CogVerificationSimpleResultConstants.Accept,"Excellent");

    mInputDatabase.Disconnect();
}

using Cognex.VisionPro;
using Cognex.VisionPro.Database;
using Cognex.VisionPro.Inspection;

private Init()
{
    CogVerificationDatabase mInputDatabase = new CogVerificationDatabase(new CogDatabaseDirectory(@"C:\SampleDatabase"));
    mInputDatabase.Connect();

    // Create an array which contains the full path for the images 
    string[] images = new string[]{@"C:\Images\sample1.bmp",@"C:\Images\sample2.bmp"};

    // Add image to the database with no grade
    mInputDatabase.AddImage(images,true,CogVerificationSimpleResultConstants.Accept,"Excellent");

    mInputDatabase.Disconnect();
}