Query-Controlled Web HMI Display

When connecting to the Web HMI, you can optionally append URL query parameters to the vision system or sensor's web address to control the appearance of the display and to suppress the credentials dialog.

  • HTTP Web Address Syntax: http://IPAddress:HttpPort/?Query&Query[&Query...]
  • HTTPS Web Address Syntax: https://IPAddress:HttpsPort/?Query&Query[&Query...]
Note: Any change to the URL query parameters results in a new request to the Web HMI server and refreshes the connection to the page.
Query Type Queries Example URLs

Credentials: Automatically log on to the vision system and suppress the credentials dialog.

Note: If the default admin user name does not have a password assigned, the credentials queries are ignored, you are automatically logged on as the admin user and the Logoff button is not displayed.

 user=[username]&pw=[password]
  • http://192.168.0.1:8087/?user=admin&pw=cognex
  • https://192.168.0.1:8443/?user=admin&pw=cognex

Image Only: Image-only display.

 page=Image
  • http://192.168.0.1:8087/?page=Image&user=admin&pw=cognex
  • https://192.168.0.1:8443/?page=Image&user=admin&pw=cognex

Image and Graphics Only: Image-only display and overlay graphics.

 page=ImageAndGraphics
  • http://192.168.0.1:8087/?page=ImageAndGraphics&user=admin&pw=cognex
  • https://192.168.0.1:8443/?page=ImageAndGraphics&user=admin&pw=cognex

Zoom: Increase or decrease the magnification of the image. Supported levels are: 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1, 1.25, 1.5, 1.75, 2, 2.25, 2.5, 2.75, 3, 3.5, 4, 4.5, 5, 5.5, 6, 8, 16 and 32.

Note: Zoom values take precedence over Fit or Fill if both are used.

 zoom=[zoom level]
  • http://192.168.0.1:8087/?page=Image&zoom=1.5&user=admin&pw=cognex
  • https://192.168.0.1:8443/?page=Image&zoom=1.5&user=admin&pw=cognex

Fit: Fit the image to the display. The image's original aspect ratio is maintained; some empty (grey) space may exist around the image.

 fit=true
  • http://192.168.0.1:8087/?page=Image&fit=true&user=admin&pw=cognex
  • https://192.168.0.1:8443/?page=Image&fit=true&user=admin&pw=cognex

Fill: Fill the entire display with the image.

Note: Fill takes precedence over Fit if both are used.

 fill=true
  • http://192.168.0.1:8087/?page=Image&fill=true&user=admin&pw=cognex
  • https://192.168.0.1:8443/?page=Image&fill=true&user=admin&pw=cognex

Rotate: Rotate the image.

  • 0 = no rotation
  • 90 = rotated clockwise 90°
  • 180 = rotated clockwise 180°
  • 270 = rotated clockwise 270°

rotate=[angle]
  • http://192.168.0.1:8087/?page=Image&rotate=180&user=admin&pw=cognex
  • https://192.168.0.1:8443/?page=Image&rotate=180&user=admin&pw=cognex

Pan: Specify the x and y values of the image offset.

Note: Pan takes precedence over panX and panY if both are used.

 pan=[x,y]
  • http://192.168.0.1:8087/?page=Image&pan=200,300&user=admin&pw=cognex
  • https://192.168.0.1:8443/?page=Image&pan=200,300&user=admin&pw=cognex

PanX: Specifies the x value of the offset. The current y value is maintained.

 panX=[x]
  • http://192.168.0.1:8087/?page=Image&panX=200&user=admin&pw=cognex
  • https://192.168.0.1:8443/?page=Image&panX=200&user=admin&pw=cognex

PanY: Specifies the y value of the offset. The current x value is maintained.

 panY=[y]
  • http://192.168.0.1:8087/?page=Image&panY=300&user=admin&pw=cognex
  • https://192.168.0.1:8443/?page=Image&panY=300&user=admin&pw=cognex

View Controls: Displays the Image Toolbar. For more information, see Image Toolbar.

 viewControls=true
  • http://192.168.0.1:8087/?page=Image&viewControls=true&user=admin&pw=cognex
  • https://192.168.0.1:8443/?page=Image&viewControls=true&user=admin&pw=cognex