--- name: "paul" section: "1x" platform: "linux" package: "paul" version: "0.0.5-2" release: "Debian 2.1 (Slink)" platforms: ["linux"] url: "https://new.carta.tech/paul/1x" --- # paul(1x) yet another image viewer ## NAME paul - yet another image viewer ## SYNOPSIS **paul** \[options\] \[image files\] ## DESCRIPTION **paul** = \_P\_rogram zur \_A\_uswertung und \_U\_mwandlung von \_L\_aserbildern (for non German speakers: Program to evaluate and convert laser images). The background is that I take some pictures of crystals using a highspeed filmcamera which works with laser light. **PAUL IS ALPHA SOFTWARE!** You should expect errors. ### Short description Yet another image viewer. ### Longer description Special designed for **sequences** of **monochrome** images.\ Works best with gray-scaled images, but can handle any 24-Bit images, off course.\ *Remark: Gray scaled images are* **displayed** *green! It has technical reasons to use the other colors internally. Don't* *be afraid that your output will be green. It's normal monochrom image.* ### GTK user interface The user interface work in progress, some features of paul are only available via command line (See section OPTIONS).\ All loaded image files are presented in an file list window.\ Pressing the **left mouse button** on a file name selects this file and displays it in a showing window.\ To leave the last displayed file marked press the **right mouse button.**\ To mark all loaded files press the **middle mouse button.**\ There is a new concept called "operating image". An image can be selected as operating image, by holding the **\-key** while pressing the **left button** on a filename. The filename is displayed in the "operating image" region of the filelist and the image is displayed in a separate window. Pressing the left mouse button on the operating image brings it back to the file list. This enables resorting of files and is subject of further development.\ If there are more than one images selected, the *Animate* button is enabled. If these images are different in size, you have to adjust the *Animation time* parameter in the *parameter menu* to a value greater than 0.4s. ### Things which may be of special interest - **Moving images** If there are more than one image loaded they can be moved to match each other. The display method can be adjusted in the parameter menu.\ **Keys in the display window while moving** Arrow-Keys, accelerated by \, \ and \\ 0 goes back to the unmoved images\ To end the moving press the *Accept all moved images* in the file selection window. The images will be cut to have the same size. - **Cutting images** This can be found in the *This image* section of the menu. Try the behaviour of all mouse buttons and the controls. May be you like precise cutting. - **Deleting borders** Try this in any operating section of the menu. ## OPTIONS - **-a\<\[\*c\]\[+b\]\>** enh\_A\_nce contrast (\*c) and brightness (+b) - **-b\[file\]** write \_B\_rightnesses of all images into textfile. - **-c\** \_C\_ut image of width w and height h at pixel (x,y) or - **-c\** \_C\_ut area inbetween (a,b) and (c,d) - **-d\[e\]** \_D\_ifference image (suppress "noise" up to e).\ If e\>0 then all equal pixels are marked white which is useful for printing. - **-e\[ai\]\** search for \_E\_xtrema of brightness of size a\*b\ \-ea = only m\_A\_xima; -ei = only m\_I\_nima - **-f\[hvmM\]\[i\]** median \_F\_ilter of order i (default: horizontal order 3) - **-g\\[e\]** make color images \_G\_ray - **-h** store \_H\_istogram in textfile - **-i\[a\]** print \_I\_nformation about images (if *a* is given print Gamma curve too) - **-j\[H\]\** insert file at (a,b). If *H* is given create a HTML file or append to HTML file if it exists to display a map with clickable icons.\ This might be an interesting feature for HTML editors and has nothing to do with the general functionality of **paul.** I just needed this feature and hope that some others will use it successfully. - **-m\[cdf\]** \_M\_ove images according to the first in image list.\ There are three types: \_Color, \_D\_ifference and \_F\_lash. paul tries to find good matching images automatically at first. - **-n** \_N\_egativ of image - **-o\[PNG/TIFF\]** \_O\_utput of processed images in PNG or TIFF format (default PNG) - **-p\[hv\]** mirror \_h\_orizontal or \_v\_ertikal - **-q** \_Q\_uiet: no graphic display (useful for batch jobs) - **-r\[n\]\[+s\]\[-e\]** Delete (black) bo\_R\_der / selectiion of real image information; n means delete only left and right but not top and bottom border - **default:** threshold for "black" \[s\] = 20\ allowed error for one pixel \[e\] = 50 - **-s** delete (white) \_S\_canner border - **-t\** ro\_T\_ate d degrees clockwise (d = 90, 180, 270) - **-w\[s\]** animate images with s seconds delay (default s=0). - **-z\[i\]** shrink i levels (1 level means = half the width and half the height) - **-F** calculate fast fourier transform of image - **-H** print \_H\_elp screen ## CAVEATS To say it once more: **paul** is alpha software. Don't expect whist and marvels. Be happy if it is useful. ## BUGS FFT has to be implemented correctly. The FFT menu item makes FFT transform and back transform so you will get the same image (hopefully) you started with. Please report any bugs, comments or enhancements to *\.* ## RESTRICTIONS Can't handle transparent images correctly and will possibly never do because it isn't inteded to do that kind of stuff (it was left to gain a small amount of more speed. ## AUTHOR Andreas Tille \\ http://www.physik.uni-halle.de/~e2od5 - Address at home: Gartenstraße 8\ D-38855 Wernigerode\ GERMANY - Address at university: Martin-Luther-Universität Halle/Wittenberg\ Fachbereich Physik\ Experimentalphysik II\ Friedeman-Bach-Platz 6\ D-06108 Halle / Saale\ GERMANY ## HISTORY **Paul** was developed at first to work at the command line. That is the reason why some options are not available in the menus. If this work is done the versioning sheme changes to 0.x.