Welcome to NICT GVD

-------------------------------------------------------------------------------
1. Dev/Test Environment

    Windows
    -------------------------------
    Windows 8.1 64bit
    Visual Studio 2013 ( =VS12, 64bit Compile )
    OpenCV 2.4.9 64bit
    -------------------------------
    Windows 7 64bit
    GVD.sln.VS10 and GVDxxx.vcxproj.VS10 is for Visual Studio 2010 (=VS10)
    OpenCV 2.4.5 64bit ( or 32bit )
    Please remove ".VS10" from these ".sln / .vcxproj" filename.

    Linux (Sorry, Not tested)
    -------------------------------
    Ubuntu 12.04 LTS 32bit with VMware Player 5.0.1 on Windows 7 64bit
    gcc 4.6
    OpenCV 2.4.3 ( or 2.4.x ) 32bit


-------------------------------------------------------------------------------
2. Add the following libraries/Tools.

    OpenCV 2.4.x  ( for GVDEncD / GVDEncR / GVDDec )
        http://opencv.org/downloads.html

    OpenMP 2 ( for GVDEncR / GVDDec )
        inc VS12/11/10 standard.


-------------------------------------------------------------------------------
3. Make ATM with GVD

    ATM can only work with mvc+D mode. It does not work in 3davc mode.
    Please rebuild the solution (Windows), make makefile (Linux).

    How to make, ATM. ( Windows / Linux )
        Sourcu code defined.h files (All include directory's All defined.h files),
        Replace value at "#define GVD 0" line, 0 to 1.


    How to make GVD ( Windows )
        Rebuild GVD/windows/GVD.sln .

    How to make GVD ( Linux )
        Go to GVD/linux directory, and just make.


-------------------------------------------------------------------------------
4. ATM/E0105 + GVD operation sequence

    Encode phase ( in QPxx directory )
        1) GVDEncD          Make Quater size Global Depth D3.yuv with Dummy Depth file.
        2) lencod           Depth to encode and recon.
        3) GVDEncR          Make Stacked Residual file R3.yuv . ( use recon Depth )
        4) lencod           Main view with stacked residual, global depth to encode.

    Decode phase ( cd QPxx/dec )
        5) ldecod           Decode main view and stacked residual, and quarter size global depth.
        6) GVDDec           Make Multi Views ( with camera parameters )


-------------------------------------------------------------------------------
5. Run ATM + GVD

    Command: ( Windows .bat only )
        all.bat
            -> call GVD.bat with QP26
            -> call GVD.bat with QP31
            -> call GVD.bat with QP36
            -> call GVD.bat with QP41

        GVD.bat -> call ATM131GVD.bat
            Each ATM131GVD.bat works to section 4 "ATM + GVD operation sequence".


-------------------------------------------------------------------------------
6. Deployment plan for ATM + GVD TEST ENVIRONMENT

    ATM131GVD.bat style:

        testxxxx/ ( Dancer / Fly / Street / Hall2 / Newspaper / Balloons / Kendo )
            All.bat
            ATM131GVD.bat
            EncD3.cfg
            EncR3.cfg
            ( Dec3.cfg )

        configs/
            ATM 13.1 standard "configs" with mvc+d_GVD directory

        configs/mvc+d_GVD
            encoder_texture.cfg
            encoder_depth.cfg
            GVD_depth_xxxx.cfg
            GVD_dummyD_xxxx.cfg
            GVD_texture_xxxx.cfg

        configs/cam_param
            xxxx.txt

        GVDbin/
            (from ATM bin) lencod_R64.exe / ldecod_R64.exe (rename to lxxcodGVD_R64.exe)
            (from GVD bin) GVDEncD.exe / GVDEncR.exe / GVDDec.exe
            (from OpenCV) DLL's

        Data/
            (from ORIGINAL DATA) *.yuv / *.cfg ( camera parameter file for ATM )

    And please setup Microsoft Visual Studio 2013(VS12) Runtime.
        vcredist_x64.exe


-------------------------------------------------------------------------------

GVD for ATM13.1

Oct14,2014 Toyoaki Ohgochi, NICT Senoh team at Tokyo, Japan.
