CogBlobResults Class

Cognex VisionPro

Class which provides access to all of the results of a blob analysis. Includes access to filtered and unfiltered collections of CogBlobResult objects. Also provides access to intermediate and result images of the blob analysis.

Inheritance Hierarchy

System Object
  System MarshalByRefObject
    Cognex.VisionPro.Implementation CogObjectBase
      Cognex.VisionPro.Implementation CogSerializableObjectBase
        Cognex.VisionPro.Blob CogBlobResults

Namespace: Cognex.VisionPro.Blob
Assembly: Cognex.VisionPro.Blob (in Cognex.VisionPro.Blob.dll) Version: 65.1.0.0

Syntax

C++

Copy to Clipboard Print

[SerializableAttribute]
public class CogBlobResults : CogSerializableObjectBase, 
	IDisposable, ICloneable, ICogRecordConstructor

[SerializableAttribute]
public class CogBlobResults : CogSerializableObjectBase, 
	IDisposable, ICloneable, ICogRecordConstructor

<SerializableAttribute>
Public Class CogBlobResults 
	Inherits CogSerializableObjectBase 
	Implements IDisposable, ICloneable, ICogRecordConstructor

<SerializableAttribute>
Public Class CogBlobResults 
	Inherits CogSerializableObjectBase 
	Implements IDisposable, ICloneable, ICogRecordConstructor

[SerializableAttribute]
public ref class CogBlobResults : public CogSerializableObjectBase, 
	IDisposable, ICloneable, ICogRecordConstructor

[SerializableAttribute]
public ref class CogBlobResults : public CogSerializableObjectBase, 
	IDisposable, ICloneable, ICogRecordConstructor

The CogBlobResults type exposes the following members.

Constructors

	Name	Description
	CogBlobResults	For Cognex internal use only.
	CogBlobResults(CogBlobResults)	Constructs a new instance of this class as a deep copy of the given instance.
	CogBlobResults(SerializationInfo, StreamingContext)	Serialization constructor for CogBlobResults object.

Top

Methods

	Name	Description
	Clone	Create a duplicate of this CogBlobResults object.
	ConstructAnnotation	Constructs the record's Annotation. For Cognex Internal use only.
	ConstructContent	Constructs the record's Content. For Cognex Internal use only.
	ConstructSubRecords	Constructs the record's SubRecords. For Cognex Internal use only.
	Copy	Returns a copy of the constructor object. For Cognex Internal use only.
	CreateBlobImage	Create an image of the blobs & holes in this collection. Blobs & holes are painted for maximum viewable contrast.
	CreateBlobImage(Boolean, Boolean, Int32)	Create an image of the blobs & holes in this collection. Blobs & holes will be painted using their segmentation values in an image pre-filled with Background. If Viewable, Background is ignored, blobs & holes are painted for maximum viewable contrast.
	CreateObjRef	Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
	CreateSegmentedImage	Gets the specified segmented image. The image will be stretched for maximum viewing contrast.
	CreateSegmentedImage(CogBlobSegmentedImageConstants, Boolean)	Gets the specified segmented image. The image will be stretched for maximum viewing contrast if stretchIt is true, otherwise, the image will contain the actual segmented image data.
	Dispose	Destruct this CogBlobResults.
	Dispose(Boolean)
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Finalize this CogBlobResults. (Overrides Object Finalize .)
	GetAttributes	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogObjectBase.)
	GetBlobByID	Given a blob ID, return its blob result.
	GetBlobIDs	Gets an array of integer blob IDs. Note that this method does not force the creation of indvidual blob results.
	GetBlobMeasure	Gets an individual measure for a single blob result. Note that this method does not force the creation of any individual blob results.
	GetBlobMeasures	Gets an array of blob measures for the specified measure and the specified IDs. Note that this method does not force the creation of any individual blob results.
	GetBlobs	Gets all of the blobs from the blob analysis after filtering and sorting have been applied.
	GetBlobs(Boolean)	Gets all of the blobs from the blob analysis. The Filtered argument indicates to get the blobs after filtering and sorting have been applied, or blobs without any filtering and sorting applied.
	GetChildren	Get either a filtered or unfiltered collection of children of the blob specified by ID. The filtered blobs will also be sorted if sorting was enabled.
	GetClassName	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogObjectBase.)
	GetComponentName	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogObjectBase.)
	GetConverter	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogObjectBase.)
	GetDefaultEvent	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogObjectBase.)
	GetDefaultProperty	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogObjectBase.)
	GetEditor	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogObjectBase.)
	GetEvents	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogObjectBase.)
	GetEvents( Attribute )	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogObjectBase.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetLifetimeService	Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	GetObjectData	Implements the GetObjectData method of the ISerializable interface. (Inherited from CogSerializableObjectBase.)
	GetParent	Get the parent of the blob specified by ID. Returns Nothing for top level blobs which do not have parents.
	GetProperties	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogObjectBase.)
	GetProperties( Attribute )	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogObjectBase.)
	GetPropertyOwner	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogObjectBase.)
	GetSiblings	Get either a filtered or unfiltered collection of the siblings of the blob specified by ID. The filtered blobs will also be sorted if sorting was enabled.
	GetTopLevelBlobs	Gets all of the top level blobs, which are the blobs that do not have an enclosing parent blob. The Filtered argument indicates to get the blobs after filtering and sorting have been applied, or blobs without any filtering and sorting applied.
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	InitializeLifetimeService	Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	MemberwiseClone(Boolean)	Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
	ToString	Returns a String that represents the current Object. (Inherited from Object.)

Top

Remarks

The blob results interface. This interface provides information about the overall results of blob analysis; use CogBlobResult for information about individual blobs.

Examples

C++

Copy to Clipboard Print

CogBlobResultCollection mBlobResults;

mBlobResults = mCogBlobTool.Results.GetBlobs();

Console.WriteLine("Number of Blobs: {0}", mBlobResults.Count);

// Print information for each blob found 
foreach (CogBlobResult blobResult in mBlobResults)
{
  Console.WriteLine("ID: {0}, CenterX: {1}, CenterY: {2}, Area: {3}",
  blobResult.ID, blobResult.CenterOfMassX, blobResult.CenterOfMassY, blobResult.Area);
}

CogBlobResultCollection mBlobResults;

mBlobResults = mCogBlobTool.Results.GetBlobs();

Console.WriteLine("Number of Blobs: {0}", mBlobResults.Count);

// Print information for each blob found 
foreach (CogBlobResult blobResult in mBlobResults)
{
  Console.WriteLine("ID: {0}, CenterX: {1}, CenterY: {2}, Area: {3}",
  blobResult.ID, blobResult.CenterOfMassX, blobResult.CenterOfMassY, blobResult.Area);
}

Copy to Clipboard Print

Dim myBlobResults As CogBlobResultCollection

myBlobResults = myCogBlobTool.Results.GetBlobs()

Console.WriteLine("Number of Blobs: {0}", myBlobResults.Count)

' Print information for each blob found
For Each blobResult As CogBlobResult In myBlobResults
  Console.WriteLine("ID: {0}, CenterX: {1}, CenterY: {2}, Area: {3}", _
  blobResult.ID, blobResult.CenterOfMassX, blobResult.CenterOfMassY, blobResult.Area)
Next

Dim myBlobResults As CogBlobResultCollection

myBlobResults = myCogBlobTool.Results.GetBlobs()

Console.WriteLine("Number of Blobs: {0}", myBlobResults.Count)

' Print information for each blob found
For Each blobResult As CogBlobResult In myBlobResults
  Console.WriteLine("ID: {0}, CenterX: {1}, CenterY: {2}, Area: {3}", _
  blobResult.ID, blobResult.CenterOfMassX, blobResult.CenterOfMassY, blobResult.Area)
Next