Scripts Extending the Power of imgtools

TOP | Up | Download | Pheedbak | Tree | Topic | A-Z | Search | Hot | New

 GO  TO        GO TO Description (below in this document)
 Script
autoexp    - automatically expand the contrast of an image;
bwto2      - use a B/W to interpolate between two colors;
chromablur - blur the chroma of an image;
epstogif   - convert an eps file to gif format;
filmgrain  - add noise to an image;
flip3      - triple an image by flipping it in x;
fromjpg    - convert a jpg file to .sgi format;
gifspace   - make a transparent spacer image;
gleam      - add a gleam to an image;
handcolor  - make a hand-colored wood cut;
hipass     - use blur factor extrapolation value to sharpen a picture;
hsvquant   - quantize an image in hue, saturation and value;
intense    - uses hipass to increase hi and low frequencies;
linezoom   - resize an image of B/W line art;
makespec   - make an image that is a spectrum of color;
maxsat     - maximize the saturation of an image;
mkgauss    - make a gaussian image;
noiseblur  - blur an image and then add noise to it;
nowhite    - remove white from an image;
pixelvis   - make an image look like pixel vision video;
rgmerge    - merge two images for red-green display;
showhsv    - make a B/W image that shows the hue, saturation or value;
softfocus  - apply soft focus and noise to an image;
splitalpha - separate an rgba image into an rgb and an alpha image;
stripalpha - remove the alpha channel from an RGB image;
tobands    - make an RGB image into 3 separate .bw images;

The easiest way to "hook these up"/make these work is to put them in your own ~/bin directory and, either A.) copy the specific programs you'll need from imgtools (and possibly pstools/fromeps) into there as well, or B.) add the .../src/haeberli/imgtools directory to your $PATH or $path environment variable.

autoexp in.rgb out.rgb

        employs:  imgtools/imgexp
                  imgtools/perhist

bwto2 in.bw out.rgb r0 g0 b0 r1 g1 b1

        employs:  imgtools/imgexp
	          imgtools/perhist

This is a way of creating a duotoned image by specifying the "end-points" of the range you want to interpolate between with the {{r0,g0,b0},{r1,g1,b1}} pair.

chromablur in.rgb out.rgb blurpix

        employs:  imgtools/noblack
                  imgtools/tobw
                  imgtools/blur
                  imgtools/setlum

blurpix is used by blur and is treated as a floating point number. However integer values also work.

epstogif in.eps out.gif

        employs:  pstools/fromeps
                  imgtools/trans128
                  imgtools/unframe
                  imgtools/togif

filmgrain in.rgb out.rgb mag

        employs:  imgtools/tobw
                  imgtools/randimg
                  imgtools/addnoise
                  imgtools/setlum

mag = 0.2 -- not much grain
mag = 0.8 -- lotta grain

flip3 in.rgb out.rgb

        employs:  imgtools/iflip
                  imgtools/assemble

From left-to-right, out.rgb will consist of in.rgb, in.rgb flipped about the y axis, and a second copy of in.rgb.

fromjpg in.jpg out.rgb

        employs:  imgtools/tosgi

fromjpg is easier to use than the djpeg converter prog in the ../jpeg/ {de}compression software dir.

gifspace out.gif xpix ypix

        employs:  imgtools/conimg
                  imgtools/togif

If one wanted to make a spacer 14 pixels long in x, one could do something akin to:
gifspace x10.gif 10 1

and, if one wanted to make a spacer 23 pixels high in y, one could do something akin to:

gifspace y23.gif 1 23

gleam in.rgb out.rgb blur

        employs:  imgtools/tobw
                  imgtools/imgexp
                  imgtools/blur
                  imgtools/add

From the looks of it, a range of [5...25] is probably a good "starting point" for the value to assign to blur.

handcolor in.rgb out.rgb blurpix

        employs:  imgtools/noblack
                  imgtools/oneband
                  imgtools/max
                  imgtools/imgexp
                  imgtools/halftone
                  imgtools/blur
                  imgtools/mult

The higher the value of blurpix -- say in a range of [40...80] -- the more color and thinner the black diagonal lines will be included; the lower the value of blurpix -- say in a range of [0.2...10] -- the less range of color will be included and the thicker the black diagonal lines.

highpass in.rgb out.rgb extrapoval blurpix

        employs:  imgtools/blur
                  imgtools/blend

Try -0.7 for extrapoval (that blend uses); blurpix seems to be able to go all over the place (e.g. [0.2...120]. See intense for an example of a specific set of parameters being used.

hsvquant in.rgb out.rgb hlevels slevels vlevels

        employs:  imgtools/tohsv
                  imgtools/oneband
                  imgtools/quant
                  imgtools/cglue
                  imgtools/fromhsv

hlevels, slevels, and vlevels are all integer values in the range of [0...255]. Try values of {2 40 40} for a "twist of red" or {2 12 10} to introduce more quantization.

intense in.rgb out.rgb

        employs:  hipass

linezoom in.bw out.bw xscale yscale

        employs:  imgtools/izoom
                  imgtools/imgexp

linezoom takes the black-and-white input image and performs a mitchell cubic filter kernel zoom, and then confines the range of pixel values to [127..128] with imgexp. If you don't want to change the size of the image, use "1.0 1.0" for "xscale yscale"; smaller values will shrink out.bw, while larger values will increase its size ("2.0 1.0" will double the size of the image in x).

makespec out.rgb xsize ysize

        employs:  imgtools/greyscale
                  imgtools/conimg
                  imgtools/invert
                  imgtools/cglue
                  imgtools/fromhsv

makespace will create a "rainbow spectrum" in out.rgb with the x/y size in pixels you provide. The spectrum generated range across the y direction with constant values across the x direction. The same range of spectrum is generated for whatever length of y given so
makespec tallspec.rgb 30 80

creates a "tall" bar where the spectrum is "squished" between 0 and 29

while

makespec widespec.rgb 80 40

creates a "wide" bar where the spectrum is "spread out" between 0 and 79.

maxsat in.rgb out.rgb

        employs:  nowhite
                  imgtools/noblack
                  imgtools/tobw
                  imgtools/setlum

maxsat saturates the given in.rgb input image to a reasonable maximum without going overboard.

mkgauss out.bw xsize ysize

        employs:  imgtools/greyscale
                  imgtools/mult

mkgauss generates out.bw with the specifed xsize ysize image dimensions.
mkgauss gauss.bw 100 50

produces the following:

noiseblur in.rgb out.rgb noisemag blurpix

        employs:  imgtools/blur
                  imgtools/randimg
                  imgtools/addnoise

Examples of this take an izoom'd down copy of ../image/peppers.rgb and apply variations of noisemag blurpix pairs:

                        

original           1 40            .5 40            .2 20

nowhite in.rgb out.rgb

        employs:  imgtools/invert
                  imgtools/noblack
                  imgtools/invert

pixelvis in.rgb out.bw

        employs:  imgtools/cutimg
                  imgtools/tobw
                  imgtools/hipass3
                  imgtools/randimg
                  imgtools/addnoise
                  imgtools/izoom
                  imgtools/conimg
                  imgtools/convolve
                  imgtools/over

rgmerge left.rgb right.rgb stereo.rgb

        employs:  imgtools/tobw
                  imgtools/cglue

showhsv in.rgb out.bw

        employs:  imgtools/tohsv
                  imgtools/oneband
                  imgtools/assemble

Taking a zoom'd down version of ../images/sunflower.rgb,

showhsv outputs this trio-in-one:

softfocus in.rgb out.rgb noisemag blurpix

        employs:  imgtools/blur
                  imgtools/randimg
                  imgtools/addnoise
                  imgtools/blend

splitalpha in.rgba out.rgb out.alpha

        employs:  imgtools/oneband
                  imgtools/cglue

stripalpha in.rgba out.rgb

        employs:  imgtools/oneband
                  imgtools/cglue

tobands in.rgb r.bw g.bw b.bw

        employs:  imgtools/oneband