Vision Tools Supported for Editing in the WebHMI

Cognex Designer currently supports editing 10 VisionPro vision tools through the WebHMI while the project is in Test Mode or deployed. The supported tools are listed below along with the current editing limitations.

Vision Tool Support Type Notes
CogBlobTool Full
  • During runtime, you can modify the Search region of the tool, if it is set to a Circle, Polygon, Rectangle or RectangleAffine shape. Assign the Tasks.Task.TaskName.CogBlobToolName.Region address to the EditGraphic click command of a WebPage Control (such as a Button) to do so.
  • You cannot modify the Search region if it is set to an Ellipse, CircularAnnulusSection or EllipticalAnnulusSection shape. Also, you cannot modify the region if it is set to cover the entire image with the Use Entire Image setting.
Note:

When editing the Search region through the WebHMI, make sure that the entirety of the region shape is located within the image, so that you can save your changes.

  • If part of the region shape is out of the image's bounds on the top or the left side of the image (as shown below), the Accept button in the Display element will not work.

     

  • If the region shape is completely out of the image's bounds on the bottom or the right side of the image, Cognex Designer shows a "Region is outside the image" error when clicking the Accept button in the Display element.

     

If part of the region shape is out of the image's bounds on the bottom or the right side of the image, the Accept button in the Display element works properly and you can save your changes.

 

CogCaliperTool Full
  • During runtime, you can modify the Search region of the tool, if it is set to a RectangleAffine shape. Assign the Tasks.Task.TaskName.CogCaliperToolName.Region address to the EditGraphic click command of a WebPage Control (such as a Button) to do so.
  • You cannot modify the Search region if it is set to cover the entire image with the Use Entire Image setting.
Note:

When editing the Search region through the WebHMI, make sure that the entirety of the region shape is located within the image, so that you can save your changes.

  • If part of the region shape is out of the image's bounds on the top or the left side of the image (as shown below), the Accept button in the Display element will not work.

     

  • If the region shape is completely out of the image's bounds on the bottom or the right side of the image, Cognex Designer shows a "Region is outside the image" error when clicking the Accept button in the Display element.

     

If part of the region shape is out of the image's bounds on the bottom or the right side of the image, the Accept button in the Display element works properly and you can save your changes.

 

CogIDTool Full
  • During runtime, you can modify the Search region of the tool, if it is set to a Circle, Polygon, Rectangle or RectangleAffine shape. Assign the Tasks.Task.TaskName.CogIDToolName.Region address to the EditGraphic click command of a WebPage Control (such as a Button) to do so.
  • You cannot modify the Search region if it is set to an Ellipse, CircularAnnulusSection, or EllipticalAnnulusSection. Also, you cannot modify the region if it is set to cover the entire image with the Use Entire Image setting.
CogPMAlignTool Full
  • During runtime, you can modify the Train and Search regions of the tool, if they are set to a Circle, Polygon, Rectangle or RectangleAffine shape.
  • You cannot modify these regions if they are set to an Ellipse, CircularAnnulusSection or EllipticalAnnulusSection shape. Also, you cannot modify the regions if they are set to cover the entire image with the Use Entire Image setting.
CogPMRedLineTool Full
  • During runtime, you can modify the Train and Search regions of the tool, if they are set to a Circle, Polygon, Rectangle or RectangleAffine shape.
  • You cannot modify these regions if they are set to an Ellipse, CircularAnnulusSection or EllipticalAnnulusSection shape. Also, you cannot modify the regions if they are set to cover the entire image with the Use Entire Image setting.
CogSearchMaxTool Full
  • During runtime, you can modify the Train and Search regions of the tool, if they are set to a Circle, Polygon, Rectangle or RectangleAffine shape.
  • You cannot modify these regions if they are set to an Ellipse, CircularAnnulusSection or EllipticalAnnulusSection shape. Also, you cannot modify the regions if they are set to cover the entire image with the Use Entire Image setting.
CogLineMaxTool Partial
  • During runtime, you can modify the Search region of the tool, if it is set to a Circle, Polygon, Rectangle or RectangleAffine shape. Assign the Tasks.Task.TaskName.CogLineMaxToolName.Region address to the EditGraphic click command of a WebPage Control (such as a Button) to do so.
  • You cannot modify the Search region if it is set to an Ellipse, CircularAnnulusSection or EllipticalAnnulusSection shape. Also, you cannot modify the region if it is set to cover the entire image with the Use Entire Image setting.
  • You cannot modify the Expected Line Normal property during runtime.

     

CogOCRMaxTool Partial
  • During runtime, you can modify the Search region of the tool, if it is set to a RectangleAffine shape. Assign the Tasks.Task.TaskName.CogOCRMaxToolName.Region address to the EditGraphic click command of a WebPage Control (such as a Button) to do so.
  • You cannot modify the Search region if it is set to cover the entire image with the Use Entire Image setting.
  • You cannot modify the Tune Data of the tool during runtime.

     

CogOCVMaxTool Partial
  • During runtime, you can modify the Search region of the tool, if it is set to a region shape (such as RectangleAffine). Assign the Tasks.Task.TaskName.CogOCVMaxToolName.Region address to the EditGraphic click command of a WebPage Control (such as a Button) to do so.
  • You cannot modify the Search region if it is set to cover the entire image with the Use Entire Image setting.
  • You cannot modify the Pattern Tune Region property during runtime.

     

CogPatInspectTool Partial
  • During runtime, you can modify the Train region of the tool, if it is set to a Circle, Polygon, Rectangle or RectangleAffine shape. Assign the Tasks.Task.TaskName.CogPatInspectToolName.Pattern.TrainRegion address to the EditGraphic click command of a WebPage Control (such as a Button) to do so.
  • You cannot modify these regions if they are set to an Ellipse, CircularAnnulusSection or EllipticalAnnulusSection shape. Also, you cannot modify the regions if they are set to cover the entire image with the Use Entire Image setting.
Note:

If you set a new Train region in the WebHMI and click Accept on the Display control, Cognex Designer performs a single Train operation on the current image (corresponding to the Train New Pattern setting of the tool). You must manually set up separate WebPage Controls (e.g. Buttons) with the applicable button click command addresses if you want to use the rest of the training operations (that is, the Statistically Train Current Pattern, End Statistical Training or Untrain Pattern options).