Stand alone client for uploading cam captured images

Developer: Kurt Brauchli <kurt.brauchli(at)>

The stand alone client shown above is available as either a python script (for all platforms) or an all-in-one executable package for Windows®.

To test the camera capture function please download the HXP client's Windows® version from here:

Please take note that this client currently only uses the TWAIN driver so you can only test the camera capture on Windows® platforms. If you use Linux or another platform, you can still use the drag-&-drop feature of the client. Please click here for drag-&-drop.

How to use the client to capture an image with TWAIN driven camera and upload it?

  • Download the HXP client for Windows from here:
  • Extract the zipped files to a directory
  • Make sure your camera is ready (e.g. connect your webcam to USB)
  • Start the ImageGrab_HXP.exe
  • On the menu, choose "Mode" and select " Encounter".
  • On the menu, choose "Acquire" => "TWAIN connect". A window pops up listing the available TWAIN drivers installed in your system.
  • Choose the proper TWAIN camera or device.
  • Enter an encounter number in the "encounter No." input (e.g. 2004000001)
  • Click "Connect". When prompted enter username = "hxp", password = "hxp"
  • When the encounter is found, the patient's name and date of birth will be displayed on the "Patient data" block.
  • On the menu, choose "Acquire" => "TWAIN acquire". You camera client should start.
  • On your camera client, take a snapshot (e.g. "Snapshot").
  • On your camera client, transfer the snapshot to the HXP client by either clicking a "Transfer" or "Export" button (differs depending on the actual camera brand).
  • The upload progress will be shown on the "Drop images here:" block
  • After a successfull upload, an "OK" will be shown on that block.

Where do the images go?

What encounter numbers are available from that HIS?


    If you enter a number which is not available in the remote server, the client will still display "connected" but the upload will fail. This is due to the fact that the client does not do error-checking yet.

What is the URL of the HXP server that receives the images?

How can I verify the uploaded images?

  • Go to the remote HIS at .
  • From the left menu, choose "Login". Login with username = "demo" and password = "demo".
  • From the left menu, choose "Admission".
  • Click on the "Search" middle tab just above the blue horizontal border.
  • Enter the encounter number that you used during the upload (e.g 2004500000) and click "search" button.
  • The admission data will be displayed.
  • On the right menu, locate the "Charts folder" link beside that tiny green "folder" icon.
  • Click the "Charts folder" link and a window pops up showing a rough simulation of a charts folder.
  • On the simulated folder, locate the "Photos" button and click it.
  • The thumbnails will be shown. Click on a thumbnail to display the larger version.

    By the way, you can also enter comments, diagnoses, remarks for each image on this module.

    Clicking the "Help" button everywhere can also help.

I found the "Mode" => "Person" on the client's menu. Can I upload an image for a patient and what numbers are needed?

    You need to enter the PID (person/patient identifier). Current available PIDs are:

    10000000 - up to - 10000008

Whats the difference between Mode=>encounter and Mode=>person ?

    Mode=> encounter
    • You need to supply the encounter number.
    • You can upload more than one image for a single encounter number.
    • The image you upload is collected and grouped to the supplied encounter number.

    Mode=> person (or patient)

    • You need to supply the PID.
    • The image you upload is assumed to be the photo ID of the person (passport format)
    • The remote server can currently only store a single image for a person. So every new upload will overwrite the previous photo. However, this is only particular to the remote server. Other applications can choose to archive the previous photo before saving the newly uploaded one.

How many procedure calls are being used in this client and which ones?

    Only 2 for each mode. (4 in total)

  • Person.Infostring
  • Person.Image.Add
  • Encounter.Infostring
  • EMR.Image.Add

I see Care2x everywhere in the demos. Is HXP a subpart of Care2x ?

    No. HXP is a project of its own. You see care2x here because the current demos were created by the care2x group. It should change when other projects (e.g. iPath, OIO, Freemed, and co.) start running their own HXP demos. These demo pages will be revised once other demos become available.

Can I also drag and drop images?

Credits to Kurt Brauchli for developing this client.

©2004 HXP All rights reserved