omron — APPENDIX F Serial Commands

Appendix F Serial Commands For TCP Connection: GETIMAGE [-format={jpg|png|tif|raw}] [-quality ={0-100}] [-woi=left,top,right,bottom] [-inspection=n] For UART Connection: GETIMAGE [-format={jpg|png}] [-quality ={0-100}] [-woi=left,top,right,bottom] [-inspection=n] Initiates serial transfer of inspection image. Note: This command always returns the last (most recent) image. -transfer=ymodem uses Ymodem protocol over the serial port. If the -transfer option is omitted completely, the transfer mode is over the TCP and Ethernet port. Important: YModem transfer option is not supported on the HAWK MV-4000. -format={jpg|png|raw|tif} specifies the format of the image.

RAW and TIF are not supported over a UART Connection. If omitted, the image format is JPG . Note: For monochrome cameras, the only formats available are TIF, PNG, and JPG. For color cameras, the only formats available are RAW, and PNG. Note: All image file types return complete file information that can be saved directly to disk except the RAW file type, which requires explicit conversion. -quality= n specifies a JPG compression quality of n less than or equal to 100. The default quality is 80 if not specified. This setting is only supported for the JPG file type. Note: PNG, RAW, and TIF formats provide lossless image compression.

If format is set to PNG, RAW, or TIF, the quality setting does not apply. -woi=left,top,right,bottom specifies a rectangular area of the image to be included in the output image. If omitted, the full image buffer is returned. Note: -woi is only supported for TIF and JPG formats, as shown in the table below. -inspection= n specifies the inspection from which to retrieve an image. The image will be from the first snapshot within that inspection. If not specified, the image will be from the first inspection that contains a snapshot. The following example will retrieve an image from the camera with these settings: Protocol: ymodem; Format: png; Quality: N/A; Inspection: second inspection.

GETIMAGE –transfer=ymodem –format=png –inspection=2 The following example will retrieve an image from the camera with these settings: Protocol: ymodem; Format: jpg (default); Quality: 50; Inspection: first inspection (default). GETIMAGE –transfer=ymodem –quality=50 Important: This command only functions when the camera is ONLINE. F-4 HAWK MV-4000 Smart Camera Guide Color Full Image Color WOI Mono Full Image Mono WOI PNG Y N Y N RAW Y N Y N TIF Y Y Y Y JPG Y Y Y Y