resize-gd

changeset 6:e020f26c2c6a

added manpage
author meillo@marmaro.de
date Sat, 14 Jun 2008 12:19:35 +0200
parents 8e2804fe30bc
children c0045d8d3ce2
files resize-gd.1
diffstat 1 files changed, 67 insertions(+), 0 deletions(-) [+]
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/resize-gd.1	Sat Jun 14 12:19:35 2008 +0200
     1.3 @@ -0,0 +1,67 @@
     1.4 +.TH RESIZE\-GD 1 "resize-gd\-0.1" "2008\-06\-14" "resize-gd"
     1.5 +
     1.6 +.SH NAME
     1.7 +resize-gd \- resizes images using the gd library
     1.8 +
     1.9 +.SH SYNOPSIS
    1.10 +.B resize-gd <size> PICTURES
    1.11 +
    1.12 +.B resize-gd <width>x<height> PICTURES
    1.13 +
    1.14 +.SH DESCRIPTION
    1.15 +The program resizes given images to a specific size. The files are modified, so copy the files before if you want to keep the original pictures!
    1.16 +.PP
    1.17 +If <size> is given, aspect ratio of the images is preserved and only shrinking is done. Smaller images remain unmodified.
    1.18 +.PP
    1.19 +If <width>x<height> ist given, the images are resized to match that dimensions. The images probably get stretched and enlarged.
    1.20 +.PP
    1.21 +Only JPEG and PNG files are supported. The filetype is detected by the filename suffix which has to be either `.jpg' or `.png' (in lowercase letters).
    1.22 +Unsupported files get skipped.
    1.23 +.PP
    1.24 +This program is meant to be a small(er) alternative to the
    1.25 +.BR mogrify -resize
    1.26 +command of ImageMagick. Mainly because ImageMagick has lots of dependencies, while the GD-Library has less.
    1.27 +
    1.28 +.SH OPTIONS
    1.29 +.TP
    1.30 +.B \-\-help
    1.31 +Show summary of options.
    1.32 +.TP
    1.33 +.B \-\-version
    1.34 +Show program name and version.
    1.35 +
    1.36 +.SH EXAMPLES
    1.37 +Create some thumbnails, preserving aspect ratio:
    1.38 +.IP
    1.39 +mkdir thumbs
    1.40 +
    1.41 +cp *.jpg *.png thumbs
    1.42 +
    1.43 +resize-gd 150 thumbs/*
    1.44 +
    1.45 +.PP
    1.46 +Make some pictures squared:
    1.47 +.IP
    1.48 +cp -r somepics/ somepics-squared
    1.49 +
    1.50 +resize-gd 400x400 somepics-squared/*
    1.51 +
    1.52 +.SH EXIT CODE
    1.53 +.TP
    1.54 +.B 1
    1.55 +Any other error
    1.56 +.TP
    1.57 +.B 2
    1.58 +The size (parameter 1) had no valid format. It has to be either <size> or <width>x<height>.
    1.59 +
    1.60 +.SH BUGS
    1.61 +Please report any bug you find to the author.
    1.62 +
    1.63 +.SH SEE ALSO
    1.64 +.BR mogrify (1),
    1.65 +.BR ImageMagick (1).
    1.66 +
    1.67 +.SH AUTHOR
    1.68 +resize-gd and this man page were written by markus schnalke <meillo@marmaro.de>
    1.69 +.PP
    1.70 +Website: http://prog.marmaro.de/resize-gd