1 .\" RCSid "$Id: fieldcomb.1,v 1.4 2008/11/10 19:08:17 greg Exp $"

     2 .TH FIELDCOMB 1 9/6/2005 RADIANCE

     3 .SH NAME

     4 fieldcomb - combine two or more field frames for video animation

     5 .SH SYNOPSIS

     6 .B fieldcomb

     7 [

     8 .B "-e|-o"

     9 ][

    10 .B \-r

    11 ]

    12 [

    13 .B "-f combined.hdr"

    14 ]

    15 .B "field0.hdr field1.hdr .."

    16 .SH DESCRIPTION

    17 .I Fieldcomb

    18 combines two or more field frames into half as many final video frames

    19 for field-based animations.

    20 Normally, the even scanlines in the output are given over to the first,

    21 third, fifth, etc. pictures given on the input, and the odd scanlines are

    22 given over to the second, fourth, sixth, etc. pictures on the input.

    23 This behavior corresponds to the

    24 .I \-e

    25 option, which is set by default.

    26 To reverse this ordering, the

    27 .I \-o

    28 option must be specified.

    29 .PP

    30 Normally,

    31 .I fieldcomb

    32 will name output frames by dividing the numbers on the input field

    33 file names by 2, inserting a 'C' right before the number, adding

    34 leading zeroes to make it always four digits.

    35 For example, the command:

    36 .IP "" .2i

    37 fieldcomb anim12.hdr anim13.hdr anim14.hdr anim15.hdr

    38 .PP

    39 will produce two output pictures:

    40 .IP "" .2i

    41 animC0006.hdr & animC0007.hdr

    42 .PP

    43 If an odd number of input files is given on the command line, the last file

    44 is held over and used as the first file in the next invocation of

    45 .I fieldcomb

    46 in the same directory.

    47 In this way, the program works well with the "TRANSFER" facility of

    48 .I ranimate(1),

    49 which does not guarantee an even number of frames will be passed every time.

    50 .PP

    51 If only two input files are given, the

    52 .I \-f

    53 option may be used to specify a different output name of the user's choosing.

    54 .PP

    55 If the

    56 .I \-r

    57 option is specified, then the input files will be removed once they have

    58 been combined.

    59 .SH AUTHOR

    60 Greg Ward

    61 .SH ACKNOWLEDGEMENT

    62 Work on this program was sponsored by Iebele Abel.

    63 .SH "SEE ALSO"

    64 getinfo(1), pcomb(1), pfilt(1), phisto(1), ran2tiff(1), ranimate(1), rpict(1)