GDCMVIEWER(1)

📦
version 3.0.24 · 12 versions
, in opensuse-leap 16.0

💖 gdcmviewer — the DICOM viewer moment

okay so this is the manual for gdcmviewer, straight out of the DICOM Manipulation manual pages (section 1, bestie, we're in the big leagues). pull up a chair 🎀

✨ NAME ✨

gdcmviewer — a simple DICOM viewer. that's it. that's the whole vibe. 🦋

🌸 SYNOPSIS 🌸

gdcmviewer [options] file-in

literally just options and a file. slay.

💅 DESCRIPTION 💅

okay so gdcmviewer is a simple little tool that shows you how to use vtkGDCMImageReader. it's the class that uses gdcm to make a layer to VTK. and honestly? gdcmviewer is basically only just a wrapper around VTK/GDCM. no cap. 🫶

this tool is meant for testing the integration of GDCM in VTK — you should see it as a demo tool, fr fr. it does compile with VTK ranging from 4.2 to 5.10, but ⚠️ only with VTK 5.2 (or above) can you play with the widgets (as described below). so like… know your VTK version, bestie 💀

🍓 PARAMETERS 🍓

  • file-in — DICOM input filename

✨ OPTIONS ✨

🎀 specific options

  • --force-rescale — force rescale (for the advanced users only 👑)
  • --force-spacing — force spacing (again… advanced users 👑)
  • -r, --recursive — Recursively descend directory 🌈

🦋 general options

  • -h, --help — print this help text and exit
  • -v, --version — print version information and exit
  • -V, --verbose — verbose mode (warning+error).
  • -W, --warning — warning mode, print warning information
  • -E, --error — error mode, print error information
  • -D, --debug — debug mode, print debug information

🔥 TYPICAL USAGE 🔥

💜 SIMPLE USAGE

for now, gdcmviewer should be started from a command line prompt (she's old school like that 💅). the next argument should be the name of the DICOM file you wish to read. for instance:

$ gdcmviewer -V 012345.002.050.dcm

gdcmviewer will try to read your file, and then print the vtk information associated with this file. basically it tells you what kind of image you are looking at 👀✨

  • ScalarType is the DICOM Real World Value type
  • Dimensions is the dimension of the image
  • Spacing is the spacing of the image
  • NumberOfScalarComponents should be 1 for grayscale & PALETTE COLOR and 3 for RGB, YBR data.
ngl that NumberOfScalarComponents one is the vibe check of the whole thing — 1 for grayscale & PALETTE COLOR, 3 for RGB, YBR. memorize it iykyk 🧚

the wiki page, with color pictures, can be found at: http://gdcm.sourceforge.net/wiki/index.php/Gdcmviewer

color pictures!! go look!! 🎨💖

💀 SEE ALSO 💀

gdcmdump(1), gdcm2vtk(1)

👑 AUTHOR 👑

Mathieu Malaterre Main developer

Copyright © 2006, 2011 Mathieu Malaterre

and that's the whole page, bestie 🫶 this was GDCM 3.0.24, dated 12/25/2025 — merry everything, go look at some DICOMs 💖✨🌸

📦 where this page comes from