ywu40 / mpeg-pcc-tmc2

Video codec based point cloud compression (V-PCC) test model

Video Point Cloud Compression - VPCC - mpeg-pcc-tmc2 test model candidate software

Building

Bash scripts can be use to build mpeg-pcc-tmc2 project:

• build.sh: build solutions.
• clear.sh: clear solututions.

OSX

• mkdir build
• cd build
• cmake .. -G Xcode
• open the generated xcode project and build it

Linux

• mkdir build
• cd build
• cmake ..
• make

Windows

• md build
• cd build
• cmake .. -G "Visual Studio 15 2017 Win64"
• open the generated visual studio solution and build it

External dependencies

The external dependencies must be download and build:

• HM-16.20+SCM-8.8 (apply pcc_me-ext_for_HM-16.20+SCM-8.8.patch on it stored in \dependencies\hm-modification ).

  svn checkout https://hevc.hhi.fraunhofer.de/svn/svn_HEVCSoftware/tags/HM-16.20+SCM-8.8/ external/HM-16.20+SCM-8.8-3DMC;
  cd external/HM-16.20+SCM-8.8-3DMC svn patch ../../tmc2_r7.0/dependencies/hm-modification/pcc_me-ext_for_HM-16.20+SCM-8.8.patch

• HDRTools

  git clone -b 0.17-dev https://gitlab.com/standards/HDRTools.git

• pcc_distortion

  git clone http://mpegx.int-evry.fr/software/MPEG/PCC/mpeg-pcc-dmetric.git

Running

Configuration files are provided in the cfg directory to aid configuring the encoder. The general pattern of usage is illustrated below, where multiple configuration files control different aspects of the test conditions.

NB: parameters set in one configuration file override the same parameter in earlier files. ie. order matters.

Further help text describing option usage is available using "./bin/PccAppEncoder --help" or "./bin/PccAppDecoder --help".

PccAppEncoder

./bin/PccAppEncoder \
	--configurationFolder=cfg/ \
	--config=cfg/common/ctc-common.cfg \
	--config=cfg/condition/ctc-all-intra.cfg \
	--config=cfg/sequence/longdress_vox10.cfg \
	--config=cfg/rate/ctc-r3.cfg \
	--uncompressedDataFolder=~/mpeg_datasets/CfP/datasets/Dynamic_Objects/People/ \
	--frameCount=1 \
	--videoEncoderPath=../external/HM-16.16/bin/TAppEncoderStatic \
	--colorSpaceConversionPath=../external/HDRTools/bin/HDRConvert \
	--reconstructedDataPath=S26C03R03_rec_%04d.ply \
	--compressedStreamPath=S26C03R03.bin 

PccAppDecoder

./bin/PccAppDecoder \
	--compressedStreamPath=S26C03R03.bin \
	--videoDecoderPath=../external/HM-16.16/bin/TAppDecoderStatic \
	--colorSpaceConversionPath=../external/HDRTools/bin/HDRConvert \ 
	--inverseColorSpaceConversionConfig=cfg/hdrconvert/yuv420torgb444.cfg \
	--reconstructedDataPath=S26C03R03_dec_%04d.ply 

Scripts

More examples of running could be found in ./test/runme_linux.sh.

These examples can be start based on your system with the following scripts:

• ./test/runme_linux.sh
• ./test/runme_windows.bat
• ./test/runme_osx.sh

The V3C common test condition (CTC) command lines could be found in ./test/ctc_command_line.sh.

Contact

Don't hesitate to contact me for any information:

• Julien Ricard - MPEG-3DG-VPCC software coordinator ([email protected]).