Skip to content

eipporko/Cube

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

"Buy Me A Coffee"

Cube

Test it and you could see an awesome colored cube in your screen. Using an incredible 3D technology which will allow you to navigate around the cube!.

it's Epic!

Controls

  • Mouse: Move camera
  • Scroll: Zoom
  • Up/Down: Change splat's radii
  • A: Automatic Variable Splat Radius / User Uniform Splat radius
  • C: RGB/NONE
  • F: Activate/Deactivate FXAA
  • L: Switch between differents set of lights (Only on Perspective Correct mode).
  • M: Switch between models (CUBE | SPHERE | Opened Models)
  • O: Open .PCD or .PLY files
  • P: Change between Flat, Gouraud, Phong & Deferred Shading(Only on Perspective Correct mode).
  • Q: Recompile the actual shader.
  • R: Reset camera position
  • S: Switch between shaders (Sized-Fixed | Corrected by Depth | Affinely Projected Sprites | Perspective Correct)
  • Esc: Exit

What do you need to build your own Cube

In order to build Cube, you need to have:

  • gcc & g++ or Clang compiling and linking C, C++ (if clang, need at least v5.0, Xcode 5.0.1 on OS X)
  • OpenGL 4 support.
  • cmake 2.8 or later.
  • git 1.8.3.4 or later.
  • GLFW Library 3.0.3 or later.
  • GLEW Library 1.10.0 or later.
  • GLM Library 0.9.6 or later.
  • PCL Library 1.3 or later.

(Earlier versions might work OK, but are not tested.)

Mac Os X - Mavericks or earlier

Mac Os users should install the following components:

  • Apple's Xcode Developer Tools (version 5.0.1 or later)

  • Apple's Command Line Developer Tools are found at the Apple Developer site, or they can be installed from within Xcode.

  • Homebrew. Once Homebrew is installed, run brew update to update brew repositories. Then run brew install glew and brew install glm for install the dependencies.

  • To compile and install GLFW libs, you can clone the official repository and follow the guide in the GLFW documentation.

    git clone https://github.com/glfw/glfw.git
    cd glfw
    cmake . -DGLFW_BUILD_UNIVERSAL=ON
    make
    sudo make install
    
  • To compile and install PCL libs, you can clone the official repository and follow the guide. Make sure you have installed Boost, Eigen, FLANN and Visualization ToolKit (VTK) dependencies.

    brew tap homebrew/science
    brew install boost
    brew install eigen
    brew install flann
    brew install vtk 
    brew install qt
    
    git clone https://github.com/PointCloudLibrary/pcl.git
    cd pcl
    mkdir build
    cd build
    cmake ..
    make
    sudo make install
    

Ubuntu 14.04 LTS

Ubuntu users should install the following components:

  • It's possible to install GLEW from Ubuntu repositories.

    sudo apt-get update && sudo apt-get upgrade
    sudo apt-get install libglew-dev
    
  • To compile and install GLM lib, you can clone the official repository.

    git clone https://github.com/g-truc/glm.git
    mkdir build
    cd build
    cmake ..
    make
    sudo make install
    
  • To compile and install GLFW libs, you can clone the official repository and follow the guide in the GLFW documentation. Make sure you have installed xorg-dev and libgl1-mesa-dev packages.

    sudo apt-get install xorg-dev
    sudo apt-get install libgl1-mesa-dev
    
    git clone https://github.com/glfw/glfw.git
    cd glfw
    cmake . -BUILD_SHARED_LIBS = ON
    make
    sudo make install
    

    NVIDIA GRAPHIC CARDS: Remember overwrote the symbolic link in '/usr/lib/x86_64-linux-gnu/libGL.so' with the nvidia openGL library before build GLFW libs. ( Delete the old symbolic link before do this ).

  • To compile and install PCL libs, you can clone the official repository. Make sure you have installed Boost, Eigen, FLANN and Visualization ToolKit (VTK) dependencies.

    sudo apt-get install libeigen3-dev
    sudo apt-get install libflann-dev
    sudo apt-get install libboost-all-dev
    sudo apt-get install libvtk5.8-qt4 libvtk5.8 libvtk5-dev
    
    git clone https://github.com/PointCloudLibrary/pcl.git
    mkdir build
    cd build
    cmake ..
    make
    sudo make install
    

How to build

For Linux/Unix/OSX/Mingw/Cygwin the build is straight forward:

git clone https://github.com/eipporko/Cube.git
cd Cube
cmake .
make

Alternatively, you can create an out-of-source build directory and run cmake from there. The advantage to this approach is that the temporary files created by CMake won't clutter the Cube source directory, and also makes it possible to have multiple independent build targets by creating multiple build directories. In adirectory alongside the Cube use:

git clone --recursive https://github.com/eipporko/Cube.git
cd Cube
mkdir build
cd build
cmake ..
make

If you have a multi-processor/core system then you can use make -j to tell the build system to multiple cores.

Platform-Specific Build Notes

Mac Os X

If you want to create Xcode project files, you only have to run cmake . -G Xcode. This approach is highly recommended to do it from an out-of-source build directory. - explained in 'How to build' step

Analysis Tools

When cube is in debug mode, at the end of each session saves information in a log file. For analysis purposes Cube bring tools for make easier to understand the log, building graphs which compares the different rendering times achieved.

Dependencies

Ubuntu 14.04 LTS

sudo apt-get install python-setuptools
sudo apt-get install python-scitools

git clone git://github.com/pudo/dataset.git
cd dataset/
sudo python setup.py install

How to work with

$ python cubeGraphGen.py

CUBE GRAPH GENERATOR

USAGE: cubeGraphGen.py [options] logFile

OPTIONS:
    -h        Display available options
    --help    Display available options
    -v        Run in verbose mode
May the Force be with you :)

About

Test using OpenGL, GLFW, GLEW, GLM and PCL

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •