Skip to main content
Skip table of contents

Graphics Inspection

Graphics Inspection

๐Ÿ“Œ API Reference: https://verify-automation.globalvision.co/reference/creategraphicsjob

This feature automatically compares two image files to detect visual differences, ensuring artwork or packaging designs remain consistent and error-free.

Inspection Features (API Input)

You can leverage any of the features below to prepare your inspection:

Feature

API Parameter Example

Graphics Custom Profile Sensitivity

  • Defaults to: Low

  • Determines how sensitive the algorithm should be to decide if there is a difference. It accepts a string or a unique ID (UUID) for a custom profile.

CODE
{
      "profile": {
        "sensitivity": "Low"
      }

Document ID (required)

  • For both Master and Sample objects

  • Leverage this parameter to inform the ID of the file you want to inspect.

NONE
{
  "documentId": "your_doc_ID"
}

Layers Visibility

  • For both Master and Sample objects

  • By default, all layers are visible.

  • Configures which layers in a document are visible during the inspection process. This is especially relevant for files that contain multiple or complex layers, such as PDF or design files.

CODE
"layersVisibility": [
        {
          "name": "layer1",
          "visible": false
        },
        {
          "name": "layer2",
          "visible": false
        }
      ]

Separations to Hide

  • For both Master and Sample objects

  • Lists the names of separations (inks) to hide during inspection. Use this to exclude specific color channels from the inspection process.

  • This is useful for focusing on certain inks (e.g., black) or removing distracting elements from the inspection.

CODE
      "separationsToHide": [
        "separation1",
        "separation2"
      ]

Shape to Selected Layer

  • For both Master and Sample objects

  • Defines an object for cropping the inspection region based on a selected layer's shape.

  • All visible layers within this area will be included in the inspection, allowing you to focus the analysis on specific zones of interest.

CODE
"shapeTo": {
    "selectedLayerName": "layer1"
      }

Shape to Selected Separation

  • For both Master and Sample objects

  • Specifies the name of a separation (ink) whose shape is used to crop the inspection region.

  • All visible content within the area covered by this separation will be inspected.

CODE
"shapeTo": {
    "selectedSeparationName": "separation1"
      }

PDF Box Type

  • For both Master and Sample objects

  • Sets the PDF box used to crop the document for inspection.

  • Options are: CropBox, MediaBox, BleedBox, TrimBox, and ArtBox.

  • Choosing the appropriate box helps focus the inspection on the desired content area and can improve accuracy by excluding irrelevant margins or marks.

CODE
"pdfBoxType": "CropBox"

Report Type

  • Defaults to: Default

  • Determines the format and content of the PDF inspection report.

  • Options:

    • default: Includes summary, thumbnails, and annotated report.

    • summaryAnnotated: Includes only the summary and annotated report (no thumbnails).

CODE
"reportType": "default"

Annotated Report Source

  • Defaults to: Sample

  • Source of the annotated report, valid options are master or sample.

  • Will be used only if reportType is summaryAnnotated.

CODE
{
      "annotatedReportSource": "sample",
      "reportType": "default"
    }

Inspection Results (API Output)

The official output of this API endpoint will be the Job ID. Use this ID to access all the inspection details described below.

Inspection Result

API Output Example

Report URL

  • Link to the generated PDF inspection report.

  • The content of this report is determined by the reportType parameter.

CODE
"reportUrl": "https://verify-automation-api.globalvision.co/files/automation-report?fileKey=PDF_File_Key"

XFDF Reports

  • Links to XFDF annotation files for both master and sample documents (if available), which can be used for further integration with PDF viewers or automated review systems.

CODE
"xfdfReports": {
                "master": https://verify-automation-api.globalvision.co/files/automation-report?fileKey=XFDF_File_key,
                "sample": "https://verify-automation-api.globalvision.co/files/automation-report?fileKey=XFDF_File_key"
                {

Graphics Differences

Individual Differences

Every difference found by the graphics inspection will be shown with the following info:

  • Indexes (Index, matchIndex, diffIndex) to individually identify each difference

  • Difference Coordinates

    • location -> boundingBox contains the coordinates of where to find the difference in each file, Master and Sample

    • pageNumber shows the page where the difference was found on both the Master and Sample files

NONE
{
    "index": 0,
    "master": {
        "location": {
           "boundingBox": {
                  "bottom": 24.48,
                  "left": 110.88,
                  "right": 129.84,
                  "top": 18.48
                   },
     "pageNumber": 1
                   }
                },
      "matchIndex": 0,
      "sample": {
         "location": {
             "boundingBox": {
                  "bottom": 24.48,
                  "left": 110.88,
                  "right": 129.84,
                  "top": 18.48
                   },
      "pageNumber": 1
                    }
                  },
      "diffIndex": 1
}

Graphics Inspection Summary

Match Details

  • confidence shows the confidence level in 0 โ†’ 1 scale

  • confidenceLevel translates the confidence to a High, Medium, Low scale

  • masterLocation, sampleLocation, and pageNumber show the coordinates of the overall graphics match on both the master and sample files

NONE
"matchDetails": [
     {
        "confidence": 0.9941202998161316,
        "confidenceLevel": "High",
           "masterLocation": {
               "boundingBox": {
                  "bottom": 792,
                  "left": 0,
                  "right": 612,
                  "top": 0
                  },
        "pageNumber": 1
            },
           "sampleLocation": {
               "boundingBox": {
                  "bottom": 792,
                  "left": 0,
                  "right": 612,
                  "top": 0
                  },
        "pageNumber": 1
           }
        }
    ]

Graphics Inspection Summary

Inspection Details

  • graphicsDifferencesAmount shows the number of differences found by the graphics inspection

  • graphicsFilesNotComparable informs if the inspection was successful or not:

    • false means that the inspection found a graphics match and ran successfully

    • true means that the algorithm wasnโ€™t able to match the master and sample files to run the inspection. When this happens, the PDF report will show โ€œNo Differences Foundโ€

NONE
"graphicsDifferencesAmount": 12,
"graphicsFilesNotComparable": false
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.