Index: branches/HTM-5.1-dev3-MERL/README-usage.txt =================================================================== --- branches/HTM-5.1-dev3-MERL/README-usage.txt (revision 222) +++ (revision ) @@ -1,147 +1,0 @@ -Software usage example -Contact: Woo-Jin Han, wjhan.han@samsung.com - -1. Installation and compilation - 1.1 Source tree - - Root - |--- bin - |--- build - |--- linux - |--- cfg - |--- cfp - |--- doc - |--- source - |--- App - |--- TAppDecoder - |--- TAppEncoder - |--- Lib - |--- TLibCommon - |--- TLibDecoder - |--- TLibEncoder - |--- TLibVideoIO - - 1.2 Windows using MS Visual Studio - - Workspaces of VC6 and VC2008 are included in Root/build directory - 1.3 Linux - - Makefile is included in Root/build/linux directory - -2. Encoder option - 2.1 Parameters - - TAppEncoder.exe -c config.cfg [options] - - Options - -c configuration file name - -i original YUV input file name - -o decoded YUV output file name - -b bitstream file name - -m dQP file name - -f number of frames to be encoded (default EOS) - -q Qp value, if value is float, QP is switched once during encoding - -g GOP size of temporal structure - -rg GOP size of hierarchical QP assignment - -s max CU size - -h CU depth - -r Number of reference (P) - -rb0 Number of reference (B_L0) - -rb1 Number of reference (B_L1) - -ip intra period in frames, (-1: only first frame) - -ldm recommended low-delay setting (with LDC), (0=slow sequence, 1=fast sequence) - -d max dQp offset for block - -dqr max dQp offset for slice - -t max transform size - -ltd min transform depth - -utd max transform depth - -v additional reference for weighted prediction (w: scale+offset, o: offset) - -tap number of interpolation filter taps (luma) - -tq0 QP offset of temporal layer 0 - -tq1 QP offset of temporal layer 1 - -tq2 QP offset of temporal layer 2 - -tq3 QP offset of temporal layer 3 - -pdx horizontal source padding size - -pdy vertical source padding size - -1/0 : turn on/off - = ALF - adaptive loop filter - IBD - bit-depth increasement - GPB - generalized B instead of P in low-delay mode - HAD - hadamard ME for fractional-pel - SRD - SBAC based RD estimation - RDQ - RDOQ - LDC - low-delay mode - NRF - non-reference frame marking in last layer - BQP - hier-P style QP assignment in low-delay mode - PAD - automatic source padding of multiple of 16 - QBO - skip refers highest quality picture - ASR - adaptive motion search range - 2.2 Config file (example) - - #======== File I/O =============== - InputFile : d:\test\origcfp\RaceHorses_416x240_30.yuv - BitstreamFile : RaceHorses.bin - ReconFile : RaceHorses_enc.yuv - FrameRate : 30 # Frame Rate per second - FrameSkip : 0 # Number of frames to be skipped in input - SourceWidth : 416 # Input frame width - SourceHeight : 240 # Input frame height - FrameToBeEncoded : 9 # Number of frames to be coded - - #======== Coding Structure ======= - IntraPeriod : 32 # Period of I-Frame ( -1 = only first) - GOPSize : 8 # GOP Size (number of B slice = GOPSize-1) - NumOfReference : 1 # Number of reference frames - NumOfReferenceB_L0 : 1 # Number of reference frames for L0 for B-slices - NumOfReferenceB_L1 : 1 # Number of reference frames for L1 for B-slices - QP : 32 # Quantization parameter(0-51) - - #======== New Structure =========== - MaxCUWidth : 128 # Maximum Coding Unit size in width - MaxCUHeight : 128 # Maximum Coding Unit size in Height - MaxPartitionDepth : 5 # Maximum partition depth. ( minimum width = MaxWidth >> (MaxPartitionDepth-1) ) - - #=========== B Slice =================== - HierarchicalCoding : 1 # B hierarchical coding ON/OFF (if OFF, no reference B is used) - - #=========== Entropy Coding ============ - SymbolMode : 1 # CAVLC: 0, SBAC: 1, only 1 supported, CAVLC implementation is not completed - - #=========== Loop/Deblock Filter ======= - LoopFilterDisable : 0 # Disable loop filter in slice header (0=Filter, 1=No Filter) - LoopFilterAlphaC0Offset : 0 # Range: -26 ~ 26 - LoopFilterBetaOffset : 0 # Range: -26 ~ 26 - - #=========== Motion search ============= - FastSearch : 1 # 0:Full search 1:Diamond 2:PMVFAST(not supported) - SearchRange : 128 # (0: Search range is a Full frame) - MaxDeltaQP : 0 # Absolute delta QP (1:default) - - 2.3 Typical example - - Example 1) TAppEncoder.exe -c test.cfg -q 32 -g 8 -f 9 -s 64 -h 4 - (Hier-B) -> QP 32, hierarchical-B GOP 8, 9 frames, 64x64-8x8 CU (~4x4 PU) - - Example 2) TAppEncoder.exe -c test.cfg -q 32 -g 4 -f 9 -s 64 -h 4 -1 LDC - (Hier-P) -> QP 32, hierarchical-P GOP 4, 9 frames, 64x64-8x8 CU (~4x4 PU) - - Example 3) TAppEncoder.exe -c test.cfg -q 32 -g 1 -f 9 -s 64 -h 4 -1 LDC - (IPPP) -> QP 32, hierarchical-P GOP 4, 9 frames, 64x64-8x8 CU (~4x4 PU) - -3. Decoder option - 3.1 Parameters - - TAppDecoder.exe -b test.bin -o test.yuv - . Decode test.bin and make test.yuv as the reconstructed YUV - - TAppDecoder.exe -b test.bin - . Decode test.bin but YUV writing is skipped - -4. Contact point - - =========================================================== - Woo-Jin Han, Principal Engineer - (wjhan.han@samsung.com) - - M/M Platform Lab - - Digital Media & Communications R&D Center - Digital Media & Communications Business - Samsung Electronics Co. Ltd. - - Korea phone) - +82-31-279-8831 (office), +82-10-3329-6393 (cellular) - ===========================================================