> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/knowledge-hub/configuration-client/licensable-features/visitor-management/using-visitor-management/pre-registration-and-receptionist-functions/the-find-visit-screen/capturing-images-to-store-against-a-visitor.md).

# Capturing images to store against a visitor

### Introduction

Multiple images can be captured and stored against a visitor, and the type of device to be used for capturing images can be configured. The options available are:

* to capture an image of the Visitor via a supported digital camera or a web cam;
* to capture an image of the Visitor’s business card from a supported document scanner;
* to capture an image of the Visitor’s supporting documentation (e.g. letter of recommendation, Passport, National ID card, etc.) from a supported document scanner.

  **Note:** Up to A4 size will be supported.

### Procedure

Perform the following procedure to configure an image PDF using a specific image capture device:

1. Click the **Visitor Name** hyper-link located on either the Visit, Find Visit or Home screens.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-b11ece125b10daf60aa4228577f4ba1b83bf2ed6%2Fvm_hyperlink.jpg?alt=media)
2. The visitor's details are displayed in the Visitor window.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-aa3ef45e307c3db42e6ba0dc9a786e60fb1c2e73%2Fvm_visitorscreen_multipleimagepdfs.png?alt=media)

   **Note:** The size of this window will automatically resize depending on the number and size of image PDFs configured up to a maximum, based on the size of the workstation monitor, (or the primary monitor if a workstation has multiple monitors), on which the user is looking at this window. A scroll bar appears if all the image PDFs cannot be seen on the resized screen.
3. If required for an image PDF, configure the image capture device settings by clicking the **Configure** button.

   The Capture Device configuration dialog displays.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-f6d4bac434cfd00d8be181af8e55a237711c7978%2Fvm_imagepdfconfiguration_checkbox.png?alt=media)

   **Note:** The options for "When image is too large" and the "Rotate image 90 degrees clockwise on capture" checkbox only appear when the **DirectShow** API is selected.
4. Configure the settings as appropriate:

   <table><thead><tr><th width="157">Field</th><th>Description</th></tr></thead><tbody><tr><td>API</td><td><p>The options available from the drop-down are:</p><ul><li>DirectShow (Legacy)</li><li>DirectShow</li><li>TWAIN</li><li>Cardscan (<strong>Note:</strong> This option will not be available if your site has installed/upgraded with NPSA=1 in the licence file.)</li></ul><p>(Default = DirectShow)</p></td></tr><tr><td>Device</td><td><p>This drop-down populates with relevant devices associated with the API selected.</p><p>The default "Any Device" option may use an imaging device not currently connected to the workstation.</p></td></tr><tr><td>Displayed Name</td><td><p>This is an optional string that can be displayed as a Tool Tip when the mouse pointer hovers over the <strong>Capture</strong> button on the Visitor window.</p><p>This can be useful as an indication of which imaging device to use.</p><p>(Maximum = 200 characters)</p></td></tr><tr><td>Device Timeout</td><td><p>This option is useful for allowing sufficient time to get an image from some slower devices, (e.g. the timeout value may need to be set to 6 seconds for the iBall Document Scanner).</p><p>(Default = 3 seconds. Range = 1 - 30)</p></td></tr><tr><td>Capture image when scanning business card</td><td>If you check this box for any of your configured images, then when a ‘Scan Business Card’ is done (via the Visitor window), it will update each of those image PDFs with the scanned image of this card.</td></tr></tbody></table>
5. Click the **OK** button.

   The Capture Device configuration dialog closes.
6. Click the **Capture** button.

   The type of imaging device associated with the Image PDF determines what window will display, as follows:

   <table><thead><tr><th width="120">If a...</th><th width="156">and the API is...</th><th>then a...</th></tr></thead><tbody><tr><td rowspan="2">digital camera or web cam,</td><td>DirectShow (Legacy)</td><td><strong>Camera</strong> Viewer displays.<br><img src="https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-018f178757458affcdc75cc3755d73ee1c057daf%2Fvm_camerascreen_directshowlegacy.png?alt=media" alt=""><br>Click the <strong>Capture</strong> button.<br>The Camera Viewer closes, and the captured image appears on the Visitor screen, cropped to fit the image PDF.</td></tr><tr><td>DirectShow</td><td><p><strong>Camera</strong> Viewer displays.<br><img src="https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-4918c4bcefbfc6019fc8d597b4489117c2f287d3%2Fvm_camerascreen_directshow.png?alt=media" alt=""><br>This screen gives you the opportunity to adjust the image before capturing it, as follows:</p><ul><li>Clicking <strong>Rotate Left</strong> <img src="https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-cfddc412316e4592d042a4d1007f82d8eaaa1c7c%2Fvm_camerascreen_rotateleft.png?alt=media" alt=""> turns the image 90 degrees anti-clockwise.</li><li>Clicking <strong>Rotate Right</strong> <img src="https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-bd7b9d8c0e56f6be78cb45970df4d5fe3ffd4b65%2Fvm_camerascreen_rotateright.png?alt=media" alt=""> turns the image 90 degrees clockwise.</li><li><strong>Crop to fit</strong> <img src="https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-013f19ce5ab72d2353d9ecea5c968bd94daa693c%2Fvm_camerascreen_croptofit.png?alt=media" alt=""> (which changes to <strong>Shrink to fit</strong> <img src="https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-8d7ca0cb87d485c88ae02e0c2826d24558a16de1%2Fvm_camerascreen_shrinktofit.png?alt=media" alt=""> when clicked), allows the image to either be cropped or shrunk to fit.</li></ul><p>Make adjustments (if required), and click the <strong>Capture</strong> button.</p><p>The Camera Viewer closes, and the captured image appears on the Visitor screen.</p></td></tr><tr><td>TWAIN or Cardscan scanner,</td><td></td><td><p><strong>Scanner Properties</strong> dialog displays, with a <strong>Scan</strong> button on it.</p><p><strong>Note:</strong> The user interface will be device specific.</p><p>Click the <strong>Scan</strong> button.</p><p>The Scanner Properties dialog closes, and the captured image appears on the Visitor screen. Images captured by these devices always resize to fit the image PDF.</p></td></tr></tbody></table>

   **Notes:**

   * Images captured will always maintain their aspect ratio.
   * If an image is a mandatory field you will get an error if you try to click **OK** without capturing the image, but you may need to scroll along to find the required image, which will be highlighted in yellow.
7. Click the **OK** button to save the visitor.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.security.gallagher.com/knowledge-hub/configuration-client/licensable-features/visitor-management/using-visitor-management/pre-registration-and-receptionist-functions/the-find-visit-screen/capturing-images-to-store-against-a-visitor.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
