Table of Contents

NAME

rwmhencode, rwmhdecode - encode/decode image sequence using the RWMH algorithm

SYNOPSIS

rwmhencode [-fp] [-hp] [-qp] [-ep] [-f1 filter1] [-f2 filter2] [-f3 filter3] [-w wavelet] [-b boundary] [-nl num_levels] [-mv mvfile] [-rmv] [-bs blocksize] [-sf startframe] [-ef endframe] [-q] rate sequence bitstream

rwmhdecode [-fp] [-hp] [-qp] [-ep] [-f1 filter1] [-f2 filter2] [-f3 filter3] [-w wavelet] [-b boundary] [-mv mvfile] [-q] bitstream sequence

DESCRIPTION

-fp
Full-pixel accuracy.
-hp
Half-pixel accuracy.
-qp
Quarter-pixel accuracy.
-ep
Eighth-pixel accuracy.
-f1 filter1
String. Filename of filter to use for going from full-pixel to half-pixel accuracy.
-f2 filter2
String. Filename of filter to use for going from half-pixel to quarter-pixel accuracy.
-f3 filter3
String. Filename of filter to use for going from quarter-pixel to eighth-pixel accuracy.
-w wavelet
String. Name of the wavelet file (FBK or LFT for mat); default = "CohenDaubechiesFeauveau.9-7.lft".
-b boundary
String. Type of boundary extension; default = "symmetric".
-nl num_levels
Integer. Number of levels of wavelet-transform decomposition; default value is 3.
-mv mvfile
String. Name of file to which to read or write motion vectors. Filename should contain a printf(3) -style numerical descriptor which will be filled in with the current frame number.
-rmw
Read motion vectors from specified file.
-bs blocksize
Integer. Block size to use in full-search block matching; default value is 8.
-sf startframe
Integer. Frame at which to start encoding. Default is first available frame.
-ef endframe
Integer. Frame at which to end encoding. Default is last available frame.
-q
Be quiet---do not print any frame statistics to stdout; default is verbose output.

DESCRIPTION

rwmhencode encodes an image sequence, sequence, using the redundant-wavelet-multihypothesis (RWMH) algorithm by Cui et al.

Option -w specifies the wavelet, while option -b specifies the boundary extension, for the RDWTs used by the algorithm.

The desired bitrate of the output bitstream is specified by rate, which is expressed in bits per pixel of the original image sequence.

rwmhdecode performs the corresponding decoding using the RWMH algorithm, decoding the bitstream made by rwmhencode and producing a reconstructed image sequence, sequence. For sane results, wavelet and boundary should be the same as they were for rwmhencode.

For both encoding and decoding, sequence should indicate a collection of grayscale images of the same size stored as separate, numbered files; the filename indicated by sequence must contain one printf(3) -style numerical descriptor which will then be filled in the current frame number (e.g., football.%03d.pgm will become football.000.pgm, football.001.pgm, etc.; see QccPackIMG(3) ).

Both rwmhencode and rwmhdecode normally print to stdout a small amount of information after each frame is coded/decoded. If the -q (quiet) option is given, all printed output is suppressed.

rwmhencode and rwmhdecode call QccVIDrwmhEncode(3) and QccVIDrwmhDecode(3) , respectively, to perform RWMH encoding and decoding. Refer to the man pages of these functions for more information.

If the -mv option is specified to rwmhencode, motion vectors are written to mvfile via QccVIDMotionVectorsWriteFile(3) , unless -rmw is also specified, in which case, the motion-estimation process of rwmhencode is circumvented, and the motion vectors are read from mvfile via QccVIDMotionVectorsReadFile(3) . For rwmhdecode, if mvfile is specified, motion vectors are read from the file rather than from the encoded bitstream via QccVIDMotionVectorsReadFile(3) . mvfile should have a printf(3) -style numerical descriptor which will be filled in with the current frame number before reading or writing motion vectors.

SEE ALSO

QccVIDrwmhEncode(3) , QccVIDrwmhDecode(3) , QccWAVWaveletRedundantDWT2D(3) , QccWAVWaveletRedundantDWT2D(3) , QccVIDMotionVectorsReadFile(3) , QccVIDMotionVectorsWriteFile(3) , QccPackVID(3) , QccPackSPIHT(3) , QccPackWAV(3) , QccPackIMG(3) , QccPack(3)

S. Cui, Y. Wang, and J. E. Fowler, "Motion Compensation Via Redundant-Wavelet Multihypothesis," IEEE Transactions on Image Processing, submitted March 2004.

S. Cui, Y. Wang, and J. E. Fowler, "Multihypothesis Motion Compensation in the Redundant Wavelet Domain," in Proceedings of the International Conference on Image Processing, Barcelona, Spain, September 2003, vol. 2, pp. 53-56.

AUTHOR

Written by Joe Boettcher <jbb15@msstate.edu> based on the originally developed algorithm and code by Suxia Cui.

Copyright (C) 1997-2021 James E. Fowler


Table of Contents



Get QccPack at SourceForge.net. Fast, secure and Free Open Source software downloads