View DICOM user guide
This guide describes every function of the viewer, in the order you will usually need them. The names of buttons are written exactly as they appear in the viewer.
1. Opening files
Click Open files… in the top bar, or drag files from a folder and drop them anywhere in the window. You can open one file or many at once.
- DICOM – uncompressed files, RLE Lossless and JPEG Baseline/Extended, greyscale and colour, single images, series and multi-frame files. Files without the .dcm extension are recognised too.
- Ordinary images – JPEG, PNG, WebP, GIF, BMP, TIFF (including 16-bit and multi-page) and PGM/PPM.
- NIfTI volumes – .nii and .nii.gz; every slice becomes one image.
The opened files are listed in the Files / slices panel on the left. Click a file name to show it. Clear all removes everything that is loaded. If a file cannot be shown, the viewer says why – for example, DICOM files compressed with JPEG 2000 or JPEG Lossless are not supported yet.
2. Zoom, pan and moving between images
- Zoom – turn the mouse wheel over the image, or use the − and + buttons. The current zoom is shown between them.
- Pan – hold the left mouse button and drag the image.
- Reset view – fits the image back into the window. A double-click on the image does the same.
- 1:1 – shows the image at its real pixel size.
- Series and multi-frame files – use the slider under the image or the left and right arrow keys to move between slices or frames.
⧉ Compare shows another opened image next to the current one. Zoom and pan move both pictures together, and ⇄ Swap exchanges them.
Click the other picture to work with it – the active one has a coloured frame and both stay in their places. Dragging and the mouse wheel over the other picture move it; with Link zoom and pan switched off each picture keeps its own zoom and pan. Every file keeps its own brightness and contrast. ▦ Overview (key O) shows all opened pictures as large previews: a click opens one, ★ marks the best ones (shown in the file list and kept in saved measurements), ⧉ compares a picture with the current one.
3. Brightness, contrast and colours
X-ray images contain far more shades than a screen can show at once. The two sliders choose which part of that range you see.
- Brightness (C) – the centre of the displayed range (window centre).
- Contrast (W) – the width of the displayed range (window width). A narrow window gives high contrast.
- Auto – sets both values from the real range of values in the image.
- Default – returns to the values stored in the file.
- Invert – switches between a negative and a positive image.
- Colours – shows the image in false colours: Greyscale, Hot metal, Rainbow or Bone (bluish). Colours can make small differences in density easier to see.
The sliders work for greyscale images. They are switched off for DICOM files stored as JPEG, where the browser decodes the picture itself.
Window preset offers bone, soft tissue and lungs: for CT the usual values in Hounsfield units, for X-ray pictures a part of the picture’s own range.
4. Mirroring, rotating and straightening
- ↔ Mirror – mirrors the image left to right.
- ↕ Flip – flips the image top to bottom.
- ⟳ Rotate 90° – turns the image by a quarter turn; click again for 180° and 270°.
- ∡ exact angle – the button with the angle value opens a small panel where you set the rotation in degrees. Straighten by two points lets you click two points of a line that should be horizontal, and the viewer rotates the image for you. Reset to 0° returns to no rotation.
The orientation is remembered separately for every opened file. Note that changing the orientation removes measurements, notes and the crop on that image, because their positions would no longer fit. Set the orientation first and measure afterwards.
5. Measuring: distance, angle, circle, ellipse, point
Choose a tool in the toolbar and follow the instruction shown above the image. Esc cancels a measurement in progress.
- 📏 Distance – click the two ends. The length is shown.
- ∠ Angle – three clicks: the end of the first arm, the vertex and the end of the second arm.
- ○ Circle – click the centre, then click again to set the radius. You get the radius, diameter, circumference and area.
- ⬭ Ellipse – click two opposite corners of the box around the ellipse. You get the semi-axes, circumference and area.
- • Point – places a numbered point and shows its position.
Every measurement is listed in the Measurements panel on the left. Click a row to select the measurement; Delete or the Delete key removes it, and Delete all removes all of them.
Lengths are in millimetres when the file states the physical size of a pixel (DICOM Pixel Spacing, NIfTI voxel size). Otherwise – typically for JPG or PNG pictures – they are in pixels and the viewer tells you so. Remember that an X-ray is a projection: sizes on the image are slightly magnified compared with the real object.
Further tools in the toolbar:
- ∢ Angle between lines – two separate lines, four clicks. Shows the angle between them (0–90°), for example the Cobb angle.
- ➗ Ratio – two distances A and B. Shows both and their ratio A/B.
- ⬠ Area – click around any area and finish by clicking the first point, by a double click or with Enter. Shows the area and perimeter.
- ⊥ Distance from line – a reference line and a point. Shows the perpendicular distance and draws a parallel through the point.
- ⚖ Calibrate – draw a line along an object of known size (a calibration ball, a ruler) and enter its real length. All lengths are then in millimetres – useful for JPG or PNG pictures and files without a pixel size.
For a circle, an ellipse or an area the panel also shows the mean, range and standard deviation of the pixel values inside (in Hounsfield units for CT). Mark two measurements of the same kind with ⇄ to see their difference, also in %. The 📈 button of a distance shows the profile of the pixel values along it. The value of the pixel under the pointer is shown in the bottom left corner of the picture, and a magnifier helps to place points precisely; both can be switched off in Settings.
◯ Circle by 3 points draws a circle through three points of an outline. ✛ Axis takes two points of a symmetric pair and draws the line through them across the picture, with its perpendicular through the middle, and shows the tilt. A selected measurement can be given a name, which appears in the picture, the PDF and the CSV. When a measurement of the same kind is repeated, the panel shows how many there are, their mean and standard deviation. With Snap points to the nearest edge (in Settings) a point placed on an outline jumps to the nearest clear edge; the magnifier marks the spot with a cyan ring. The Magnifier panel on the left switches the magnifier on or off and sets its zoom; Shift + mouse wheel changes the zoom while measuring.
↶ Undo and ↷ Redo in the toolbar (or Ctrl+Z and Ctrl+Y) take back and repeat changes to measurements, notes, orientation and crop – even a rotation that removed your measurements. Redo is possible until you change something new.
6. Labels, colours and line thickness
- Moving a label – the value drawn next to a measurement can be dragged to another place when it covers something important. A thin line keeps it connected to its measurement.
- Show labels in the image – untick this box in the side panel (or in Settings) to hide all labels in the image. The values stay in the list on the left.
- Colour and Thickness – select a measurement in the list and change its colour and line thickness. New measurements use the style you chose last. The Norberg angle has its own colour and thickness in its panel.
7. Norberg angle
The Norberg angle is used in veterinary radiology to describe how well the femoral head sits in the hip socket. Start with 📐 Norberg angle and follow the six steps shown above the image:
- Click the edge of the first femoral head.
- Move the mouse and click to place its centre – the circle should follow the outline of the head.
- Click the edge of the second femoral head.
- Click to place its centre.
- Click the craniolateral (outer upper) rim of the acetabulum on the first side.
- Click the same rim on the other side.
The angle of each hip appears in the Norberg angle panel and in the image. Afterwards you can grab any circle by its centre to move it or by its edge to resize it, and move the rim points; the angles are recalculated at once. Undo and Redo step back and forward, New measurement starts again. While measuring you can still zoom and pan.
The result is indicative. An official hip dysplasia assessment is always made by an authorised veterinarian or evaluation panel.
Under each angle the panel also shows the Femoral head coverage – the share of the femoral head’s width lying medial to the rim point you placed – and the difference between the left and the right side.
🩻 Assessment on the toolbar opens a panel with guided measurements. Each one takes you step by step through the line above the picture; the result appears in the Measurements panel, the PDF and the CSV, and the points can be dragged afterwards. The steps are also read aloud in the language of the site (🔊 in the instruction bar or Settings turns it off); it needs a voice for that language on the device. In Settings you can set the reading speed and pick the voice, and ▶ tries it.
📋 Screening forms – HD, ED, shoulder OCD, patellar luxation, spondylosis, LTV and CAACV (anomalies of the caudal vertebrae). You fill in the results; they are kept with the picture and go into the PDF and the CSV.
- Hips – Distraction index (PennHIP), Femoral head coverage (DAR), CE angle (Wiberg).
- Elbows and knees – Tibial plateau angle (TPA), Patellar position (Insall-Salvati), aLDFA (distal femur), mMPTA (proximal tibia).
- Further guided measurements: Acetabular index (Hilgenreiner), Neck-shaft angle (inclination), Patellar ligament angle (PTA, TTA), Mechanical axis (HKA angle), Caudal vena cava / aorta (CVC/Ao), Pulmonary artery / vein (A/V), Vertebral wedging (Ha/Hp), Canal / body ratio (Torg-Pavlov), Hoof-pastern axis, Palmar angle of the coffin bone.
- The search field at the top of the panel finds measurements and protocols by any word of their name or description.
- Thorax and heart – Vertebral heart score (VHS), Left atrial size (VLAS), Tracheal ratio (TD/TI), Cardiothoracic ratio. VHS and VLAS are given in vertebrae: you mark T4 and T8 and the lengths are laid along the spine.
- Spine and hooves – Cobb angle (spine), Hoof: rotation, founder distance, sole depth.
- Protocols – a series of measurements run in one go; each result gets the name of its step.
The forms are filled in by you – the app does not derive any grade. In the PDF window, Report template limits the report to one area.
8. Text notes
Click 📝 Add text and then click in the image where the note should be. Type the text and confirm with Enter or Done. A note can be dragged to another place, edited by clicking it, or removed with Delete.
📋 From metadata fills the note with details stored in the DICOM file – for example the animal name, breed, owner or examination date. You choose which items to insert.
9. Crop, full screen and print
- ✂ Crop – drag a rectangle over the part you want to keep. The view, print and export are limited to it. ✂ Remove crop shows the whole image again.
- ⤢ Full screen – hides everything except the image and the toolbar. Esc returns.
- 🖨 Print – prints the image as displayed, including measurements and notes. In the print dialog you can also save it as a PDF.
10. Export and sharing
⬇ Export image saves what you see – the image with your brightness settings, measurements and notes.
- JPG – a small file for e-mail and the web. The automatic setting aims at about 150 KB; you can also pick the quality yourself.
- PNG – lossless, best when the picture will be edited further.
- WebP – smaller than JPG at the same quality.
- TIFF – lossless, for print and publications.
- 📋 Copy – puts the picture on the clipboard so you can paste it into an e-mail or a document.
- Add a strip with the file name and measured values – adds or leaves out the strip under the picture.
📄 Export to PDF creates a text report with the patient details and measured values, without the image. 🔗 Share copies the link to the viewer – only the link, never your images.
Before the report is created, a small window lets you add Include all DICOM metadata – a table of every tag in the file. It may contain personal data.
The PDF window also has fields for your own assessment (grade, findings, assessed by), which are printed in the report – the app itself never derives an assessment from the measurements. Under Save / load you can use 💾 Save measurements to keep everything in a small file on your computer and 📂 Load measurements to bring it back later; the file is matched to the same images, even when you open it together with them. 📊 Export to CSV creates a table of all values for Excel.
Include the image with measurements in the PDF window adds the picture with your measurements to the report.
11. DICOM metadata
The DICOM metadata panel lists every tag stored in the file: patient, examination, device and image details. It is hidden by default so that personal data is not visible on the screen by accident; show opens it.
12. Settings
The ⚙ button in the top bar opens Settings. Your choices are remembered in your browser for the next visit.
- Appearance – dark or light mode.
- Toolbar with icons only (no labels) – a compact toolbar. The name of each button appears when you point at it.
- Text size – makes all text in the viewer larger – menus, panels, buttons and dialogs.
- Icon size – makes the icons on the toolbar buttons larger, up to twice the normal size. Useful on touch screens and high-resolution monitors.
- Show labels in the image – shows or hides the values drawn in the image.
- Show tips in the side panel – shows or hides the panel with tips.
- 🧰 Customize toolbar… – choose which toolbar buttons you see and in what order; keyboard shortcuts keep working for hidden ones.
- Language by browser – when your browser uses another language than the page, the viewer offers to switch (default), switches by itself on the main address, or does nothing.
- 📲 Add to desktop – installs the viewer as an app with its own icon. After the first visit it also works without an internet connection.
The language is changed with the menu in the top bar. The Tip panel on the left shows one tip at a time; clicking a tip starts the function it describes.
13. Tablet, phone and keyboard
- Touch – drag with one finger to pan, pinch with two fingers to zoom, tap to place points.
- ← → – previous and next slice or frame.
- + − – zoom in and out; 0 fits the image into the window, 1 shows it at 100%.
- R – rotate by 90° clockwise; Shift+R anticlockwise.
- H – mirror left to right; V – flip top to bottom.
- I – invert; F – full screen.
- Esc – cancels the current tool, closes a dialog or leaves full screen.
- Delete – removes the selected measurement.
- Ctrl+Z / Ctrl+Y – undo / redo the last change.
- N D A C E P L T – Norberg angle, distance, angle, circle, ellipse, point, angle between lines, text note.
- Enter – confirms a text note; Shift+Enter starts a new line in it.
14. Professional tools
- Filter – sharpening, local contrast (CLAHE) and smoothing; only the display changes, measurements and the statistics of an area use the original data.
- My presets – save the current brightness and contrast under a name in the window preset list.
- ⚪ Calibration ball – three clicks on the outline of a ball of known diameter set the scale, including the magnification of the image.
- ✂ Osteotomy – outline the fragment, then turn it around the pivot and move it (drag the handles or type the values); a TPA measured on the plateau inside the fragment is recalculated.
- 🔩 Implant template – a generic plate, screw, acetabular cup or saw blade in true size; its size can be changed afterwards in the Measurements panel.
- Positioning: pelvic symmetry, Positioning: thorax rotation – positioning checks: are the obturator foramina equally wide, is the sternum over the spine?
- 📈 Trend – the same measurement on images of one patient from different dates, as a table and a chart.
- 📚 Library – keep opened studies with their measurements in this browser and open them again from a list. The library can be protected with a password: the studies are then encrypted (AES-256), it locks after inactivity and can also be unlocked with a fingerprint, face or Windows Hello. A forgotten password cannot be recovered.
- 🏥 Report header…, ✎ Edit phrases… – the clinic’s name, address, logo and a box for the signature at the top and end of the PDF report; in the PDF dialog, phrases with values such as {vhs} or {norbergL} fill in the findings.
- 🩻 Export DICOM with measurements, 🕶 Anonymised DICOM, 📦 Package (.zip) – the image with measurements as a new DICOM image for the PACS; an anonymised copy of the original file; all opened files with their measurements in one .zip, which View DICOM opens as it was.
- 🧩 Join images – two images joined by a point visible on both, e.g. a whole limb.
- 🖥 Second window, 🎓 Presentation – the image on a second monitor; presentation on the whole screen with a laser pointer; 🎓 next to a measurement starts a quiz that compares a new measurement with it.
- ⌨ Keyboard shortcuts… – your own keys for the tools. On a tablet a quick two-finger tap takes back the last point or change; so does the side button of a pen.
15. Privacy
Everything happens in your browser. Files are not uploaded to any server and are not stored; when you close the page they are gone. Details are in the privacy policy.
View DICOM is an auxiliary tool, not a medical device – see the terms of use. Questions are welcome at info@viewdicom.com.