When a user replaces the InputVisionData property, the CogSurfaceFXTool will immediately verify that the container has four items, with keys that are suitable as names in a coordinate space tree. Each item must be an ICogImage, or null. We only insist that each image is a CogImage8Grey at runtime. Replacing the InputVisionData container fires a Changed event for that property, and also for the individual image properties if they are different.
At runtime, the CogSurfaceFX operator will check that the InputVisionData property contains exactly four images of type CogImage8Grey. It will assume that the first image in the container was lit from the right, the second image was lit from below, etc. The key strings that are associated with each image will only be used as a space name in the merged coordinate space tree of the output image, if they are used at all.
Assembly: Cognex.VisionPro.SurfaceFX (in Cognex.VisionPro.SurfaceFX.dll) Version: 69.0.0.0
Property Value
Type: CogVisionDataContainer| Event Type | Reason |
|---|---|
| ICogChangedEvent Changed | Fires when the value of this property changes. |
| Exception | Condition |
|---|---|
| ObjectDisposedException | If the object has been disposed. |
| ArgumentNullException | If the value is null. |
| ArgumentException | If the container does not have 4 records. |
| ArgumentException | If any of the 4 keys is an empty space or null. |
| CogSpaceTreeInvalidNameSyntaxException | If any of the 4 keys is not valid coordinate space name. |
| ArgumentException | If any of the non-null values are not an ICogImage. |