ff-hjoin.1

.Dd 2024-05-03
.Dt FF-HJOIN 1
.Os farbfeld-utils
.Sh NAME
.Nm ff-hjoin
.Nd farbfeld program that joins multiple pictures together horizontally
.Sh SYNOPSIS
.Nm
<image.ff> <?image.ff?> ... <?image.ff?>
.Sh DESCRIPTION
.Nm
reads multiple
.Xr farbfeld 5
images, joins them together horizontally in one image and writes the result to stdout.
.Pp
If the pictures do not all have the same height, the resulting height will be
the largest input height and the pictures will be aligned at the bottom.
.Pp
This program does not read from standard in.
.Pp
In case of an error
.Nm
writes a diagnostic message to stderr.
.Sh EXIT STATUS
.Bl -tag -width Ds
.It 0
Image processed successfully.
.It 1
An error occurred.
.El
.Sh OPTIONS
The arguments are the pictures to be joined; the first picture is on the left.
.Sh EXAMPLES
$
.Nm
image1.ff image2.ff image3.ff > images-joined-horizontally.ff
.Sh SEE ALSO
.Xr ff-vjoin 1 ,
.Xr farbfeld 5 ,
.Xr farbfeld-utils 7