ENGAUGE-DIGITIZER(1)

✨ ENGAUGE-DIGITIZER(1) ✨

okay so bestie, gather round 💖 this is the General Commands Manual page for engauge-digitizer, and it's gonna change your whole life (or at least your whole "I have a picture of a graph and I need numbers out of it" situation).

---

🎀 NAME 🎀

engauge-digitizer — interactively convert a bitmap graph or map into numbers. that's it, that's the gig. you give it pixels, it gives you digits. iconic behavior honestly 🌈

---

🌸 SYNOPSIS 🌸

engauge [options]

---

💅 DESCRIPTION 💅

This manual page documents briefly the engauge command from the engauge-digitizer package. brief but mighty, fr fr. lowkey it's just the appetizer — the real feast is the HTML user guide, and we'll get to that.

---

🚀 Startup 🚀

okay so this is the "when you launch it" era. main character energy only.

• -import FILE — Automatically import the specified image file at startup. you can also import image files manually using the menu, no pressure. but this one just does it for you, like a good friend 🫶
• -open FILE — Automatically open the specified Engauge Digitizer document file at startup. Document files may also be opened manually using the menu. same deal, different file type ✨
• -help — Display a list of command line options similar to this manpage in an X window and exit. it's giving "this page but pop-up edition" 💀
• -manual DIRECTORY — Look for the HTML user guide in the specified directory. For Debian it is installed in /usr/share/doc/engauge-digitizer/usermanual and should need no configuration. so on Debian you literally do not have to touch this. slay.
• -axes XMIN XMAX YMIN YMAX — Scan the imported file at startup, and locate the X and Y axes. Then digitize axis points assuming the X axis ranges from XMIN to XMAX, and the Y axis ranges from YMIN to YMAX. The X axis is assumed to be near the bottom of the image, and the Y axis is assumed to be on the left side of the image. For speed, no attempt to rotate the image if it is sideways, so the digitized points may require adjustment. This feature should be useful when using Perl or other scripts to digitize many images with known axes ranges. The axis points may also be digitized manually using the Digitize Axis Points mode.

⚠️ heads up bestie: it will not rotate a sideways image. for speed, it just doesn't. so if your scan is tilted you may need to adjust the digitized points yourself. no cap.

• -lazysegments — Postpone scanning for segments that is normally performed during startup, until either the Segments dialog is used, or the Segment Fill button is selected. procrastination as a feature, we love to see it 🙈

---

🛑 Shutdown 🛑

• -export FILE — Automatically export the active document at shutdown. Documents may also be exported manually using the menu. it saves your work on the way out the door, like a considerate queen 👑

---

⚙️ Settings ⚙️

• -reset — Reset all settings to the factory defaults. This option is a fast and easy way to restore all settings to a useful configuration, especially when there are problems with one or more settings. Settings are stored in a text file such as $HOME/.qt/engaugerc.

🔥 if your settings are acting up, this is the "have you tried turning it off and on again" of settings. one flag, factory fresh, we love a clean slate.

---

🐛 Debugging 🐛

for when you gotta peek behind the curtain. purely diagnostic vibes, no user-facing magic here.

• -pixels — Show cursor location in pixel coordinates rather than graph coordinates
• -ctor — Trace constructor calls
• -dtor — Trace destructor calls
• -curvecmb — Trace curve combobox operations
• -measurecmb — Trace measure combobox operations
• -refresh — Trace screen refreshes
• -scanning — Trace image scanning

---

🌿 Environment variables 🌿

• ENGAUGE_BROWSER — To start up the date/time converter from within Engauge Digitizer, this environment variable must be set to the shell command that runs a javascript-capable browser. Examples are 'firefox', 'konqueror', ...

💡 no javascript-capable browser command set, no date/time converter. that's the whole deal, iykyk.

• ENGAUGE_USERMANUAL — If set, this specifies the directory containing the user manual. This option, like the '-manual' command line option, should not be needed on a Debian installation. Debian girlies stay unbothered 💅

---

👀 SEE ALSO 👀

The program is documented quite nicely in the HTML user guide and tutorial, available under /usr/share/doc/engauge-digitzer/usermanual or from Help within the running program.

🦋 yes bestie, go read the guide, it's literally right there in the Help menu.

---

👑 AUTHOR 👑

engauge-digitizer was written by Mark Mitchell <mmdigitizer@earthlink.net>.

This manual page was written by Tobias Stefan Richter <tsr-debian@achos.com> for the Debian project (but may be used by others).

---

and that's the whole page, bestie! 🎀 this came from the General Commands Manual, source/version December 14, 2006, and honestly? still eating. go digitize something gorgeous. periodt. 💖✨🌸🦋💅