jianjieluo / minecube Goto Github PK

View Code? Open in Web Editor NEW

29.0 10.0 6.0 12.98 MB

A Cool Voxel Editor Based on OpenGL 3.3+ !

License: MIT License

CMake 0.30% C++ 37.04% C 61.47% GLSL 1.19%

opengl voxel voxel-editors computer-graphics

minecube's Introduction

MineCube

A sample voxel editor based on OpenGL 3.3+, inspired by MagicaVoxel.

Support Windows 10 currently.

A final project originally of 5 undergraduate students for the course Computer Graphics, SYSU.

A good OpenGL learning example for the green hand in Computer Graphics, while maybe not the best practice in the related field.

Create any small stuff you like!

More Image Examples

Dependences

OpenGL 3.3+
GLAD

From LearnOpenGL:

Go to the web service, make sure the language is set to C++ and in the API section, select an OpenGL version of at least 3.3 (which is what we'll be using for this repo; higher versions may be fine as well). Also make sure the profile is set to Core and that the Generate a loader option is ticked. Ignore the extensions (for now) and click Generate to produce the resulting library files.

Chinese Version: 打开GLAD的在线服务，将语言(Language)设置为C/C++，在API选项中，选择3.3以上的OpenGL(gl)版本（本仓库中将使用3.3版本，但更新的版本应该也能正常工作）。之后将模式(Profile)设置为Core，并且保证生成加载器(Generate a loader)的选项是选中的。现在可以先（暂时）忽略拓展(Extensions)中的内容。都选择完之后，点击生成(Generate)按钮来生成库文件。

~~GLFW Master 3.2.1~~ GLFW Master branch
GLM 0.9.8.5
imgui v1.60
nlohmann::json v3.1.2 , 只需要下载 json.hpp 的 release 文件。
freetype 2.9.1 , 建议下载 ft291.zip 并解压 , 然后将 freetype-2.9.1 文件夹更名为 freetype 添加至 3rd_party 。

How to Run Demo

1. Download the Binary File in Release

Release List

2. Build from the Source

Create a new directory 3rd_party at root directory.
Download and unzip glad, glfw, glm, imgui dependences following the URL above.
Rename all the dependences' directories without certain version number.
Download nlohmann/json.hpp file from the URL above.
Follow the steps above to add freetype library.

Now your 3rd_party looks like:

3rd_party/
----glad/
----glfw/
----glm/
----imgui/
----nlohmann/json.hpp
----freetype

Use Cmake to generate your project file.

2.1 Windows (Visual Studio 2015 or higher)

Use Cmake-gui to generate the build/ dir.
Open it in Visual Studio, set MineCube as Startup Project.
Compile it and run the program.

You might need to modify the shaders' path in demo.cpp

2.2 Mac OS

Still need to be developed.

2.3 Linux(Ubuntu)

Still need to be developed.

Contributors

More about MineCube

Read wiki for more technical details.

Bugs Report

Feel free to new issues.

minecube's People

Contributors

Stargazers

Watchers

Forkers

bowenwu1 ace-0 heitaoflower lixk28 chinaray summertree

minecube's Issues

Include <windows.h> ?

My output:

Scanning dependencies of target glfw
[ 3%] Building C object 3rd_party/glfw/src/CMakeFiles/glfw.dir/context.c.o
[ 6%] Building C object 3rd_party/glfw/src/CMakeFiles/glfw.dir/init.c.o
[ 10%] Building C object 3rd_party/glfw/src/CMakeFiles/glfw.dir/input.c.o
[ 13%] Building C object 3rd_party/glfw/src/CMakeFiles/glfw.dir/monitor.c.o
[ 17%] Building C object 3rd_party/glfw/src/CMakeFiles/glfw.dir/vulkan.c.o
[ 20%] Building C object 3rd_party/glfw/src/CMakeFiles/glfw.dir/window.c.o
[ 24%] Building C object 3rd_party/glfw/src/CMakeFiles/glfw.dir/cocoa_init.m.o
[ 27%] Building C object 3rd_party/glfw/src/CMakeFiles/glfw.dir/cocoa_joystick.m.o
[ 31%] Building C object 3rd_party/glfw/src/CMakeFiles/glfw.dir/cocoa_monitor.m.o
[ 34%] Building C object 3rd_party/glfw/src/CMakeFiles/glfw.dir/cocoa_window.m.o
[ 37%] Building C object 3rd_party/glfw/src/CMakeFiles/glfw.dir/cocoa_time.c.o
[ 41%] Building C object 3rd_party/glfw/src/CMakeFiles/glfw.dir/posix_thread.c.o
[ 44%] Building C object 3rd_party/glfw/src/CMakeFiles/glfw.dir/nsgl_context.m.o
[ 48%] Building C object 3rd_party/glfw/src/CMakeFiles/glfw.dir/egl_context.c.o
[ 51%] Building C object 3rd_party/glfw/src/CMakeFiles/glfw.dir/osmesa_context.c.o
[ 55%] Linking C static library libglfw3.a
[ 55%] Built target glfw
Scanning dependencies of target MineCube
[ 58%] Building CXX object CMakeFiles/MineCube.dir/src/Camera.cpp.o
[ 62%] Building CXX object CMakeFiles/MineCube.dir/src/CraftManager.cpp.o
[ 65%] Building CXX object CMakeFiles/MineCube.dir/src/Global.cpp.o
[ 68%] Building CXX object CMakeFiles/MineCube.dir/src/Gui.cpp.o
[ 72%] Building CXX object CMakeFiles/MineCube.dir/src/Shader.cpp.o
[ 75%] Building CXX object CMakeFiles/MineCube.dir/src/demo.cpp.o
/Users/wubowen/Documents/MineCube/src/demo.cpp:7:10: fatal error: 'windows.h' file not found
#include <windows.h>
^~~~~~~~~~~
1 error generated.
make[2]: *** [CMakeFiles/MineCube.dir/src/demo.cpp.o] Error 1
make[1]: *** [CMakeFiles/MineCube.dir/all] Error 2
make: *** [all] Error 2

拾取帧率优化

@Ace-0
目前拾取的延时比较严重，需要优化一下算法。

其实关于IMGUI的冲突，我在想是不是可以把相关的代码写在IMGUI的封装里

我的意思是IMGUI其实套住了glfw部分函数，但我们还是可以直接通过调用类似ImGui::IsMouseClicked(i)这样的东西来检测相关的事件，然后检测到这个事件后再执行我们想做的事情。包括鼠标的屏幕位置也是能通过IMGUI获取的。

load 之后会渲染两个相同的方块

Display Text support

@15331335

在展示前提供一个 bonus 的 display text support.

例如，显示一下提醒 “Press 'V' to view your art !”

Shadow 效果并没有体现出来

目前阴影部分并没有体现出来。

关于Mac下无法正常工作的问题

相对路径/绝对路径
显示时，位置会有偏差

Error when make

[ 55%] Built target glfw
[ 58%] Building C object CMakeFiles/MineCube.dir/3rd_party/glad/src/glad.c.o
[ 62%] Linking CXX executable MineCube
clang: error: no such file or directory: 'CMakeFiles/MineCube.dir/3rd_party/glad/src/glad.c.o'
make[2]: *** [MineCube] Error 1
make[1]: *** [CMakeFiles/MineCube.dir/all] Error 2
make: *** [all] Error 2

添加帧缓冲快速改变模型外观的功能

@mgsweet

按照你之前的脑洞，使用帧缓冲来实现各种炫酷效果？

All bonus should be in a class?

@15331335

计图作业里面所有的bonus类应该封装进一个类里面？
应该有它独立的 vao 和 vbo？

这个可以展示后再加上。

CMake on MacOS

My output:
➜ MineCube git:(dev) ✗ cmake .
-- The CXX compiler identification is AppleClang 9.0.0.9000039
-- Check for working CXX compiler: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/c++
-- Check for working CXX compiler: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- The C compiler identification is AppleClang 9.0.0.9000039
-- Check for working C compiler: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/cc
-- Check for working C compiler: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/cc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done
-- Could NOT find Vulkan (missing: VULKAN_LIBRARY VULKAN_INCLUDE_DIR)
-- Using Cocoa for window creation
-- Configuring done
CMake Error: Error required internal CMake variable not set, cmake may not be built correctly.
Missing variable is:
CMAKE_C_COMPILE_OBJECT
-- Generating done
-- Build files have been written to: /Users/wubowen/Documents/MineCube