====== gifmaker ======

/home/uwe/bin/gifmaker

===== Usage Examples =====

USAGE: gifmaker [input_file] ([output_file] [frames_per_second])
     input_file - The input video file to convert (Required)
     output_file - The GIF file to be created (Default=out.gif)
     frames_per_second - The GIF's frame rate. (Default=10)

# Convert input.avi to an animated GIF with the default output file and FPS
> gifmaker input.avi

# Convert input.mpg to a GIF named demo.gif at 5 FPS
> gifmaker input.mpg demo.gif 5

# Convert input.mpg to a GIF named demo.gif at the default (10) FPS
> gifmaker input.mpg demo.gif

==== Advanced Usage ====

Cutting a Clip Out of a Larger Video File

# Create a 3 second clip starting at 1 minute and 35 seconds
> FFMPEG_ARGS="-ss 00:01:35 -t 3" gifmaker input.mp4

# Create a 5 second clip starting 1 hour 10 minute and 7.25 seconds
> FFMPEG_ARGS="-ss 01:10:07.250 -t 5" gifmaker input.mp4

==== Scaling & Resizing ====

# Resize the output GIF to 50% of its current size
> CONVERT_ARGS="-resize 50%" gifmaker input.ogv

# Resize the output GIF to 320x200
> CONVERT_ARGS="-resize 320x200" gifmaker input.ogv

==== Drawing an Overlay ====

# Write the text 'Sample Text' at 10,100 in a 72pt font
> CONVERT_ARGS="-pointsize 72 -draw \"text 10,100 'Sample Text'\"" gifmaker input.avi

# Draw a logo found in logo.png at 300,200 sized to 150x100 onto each frame
> CONVERT_ARGS="-draw \"image over 300,200 150,100 logo.png\"" gifmaker input.avi

==== Cropping an Area from the Video File ====

# Crop a section of 150x150 with an upper left corner at 100x100
> FFMPEG_ARGS="-vf crop=150:150:100:100" gifmaker input.mp4