alieron / quill Goto Github PK

An imitation of the minecraft rendering engine to serve as an integrated editor and previewer for texturepacks, created by reverse engineering the minecraft rendering engine and its use of .json files to store block models.

License: MIT License

CMake 0.05% C 13.43% Objective-C 0.21% C++ 86.31% GLSL 0.01%

opengl renderer

quill's Introduction

quill

Texture pack renderer

Progress

Rendering scheme

  v5 ----------- v4
  /|            /|      Axis orientation    North orientation
 / |           / |
v6 --------- v7  |      y
|  |         |   |      |                       
|  v2 -------|-- v3     +--- x                 /
| /          |  /      /                      /
|/           | /      z                     North
v1 --------- v0


Triangle primitives must be drawn in a anticlockwise order when looking from the outside

(0,0) v1 --------- v0 (1,0)
      |          / |
      |        /   |
      |      /     |
      |    /       |						^
      |  /         |						|
(0,1) v2 --------- v3 (1,1)				Texture Up

JSON Order:
	down
	up
	north
	south
	west
	east

Vertex draw order: 
	0, 1, 2,    0, 2, 3,	// Down -Y
	4, 5, 6, 	4, 6, 7,	// Up +Y
	5, 4, 3, 	5, 3, 2,	// North -Z
	7, 6, 1, 	7, 1, 0,	// South +Z
	6, 5, 2, 	6, 2, 1,	// West -X
	4, 7, 0, 	4, 0, 3		// East +X

VBO and EBO

mVertices[120] = {
			// Down -Y
			 0.5f, -0.5f,  0.5f, 1.0f, 0.0f,    // 0
			-0.5f, -0.5f,  0.5f, 0.0f, 0.0f,    // 1
			-0.5f, -0.5f, -0.5f, 0.0f, 1.0f,    // 2
			 0.5f, -0.5f, -0.5f, 1.0f, 1.0f,    // 3
			// Up +Y
			 0.5f,  0.5f, -0.5f, 1.0f, 0.0f,    // 4
			-0.5f,  0.5f, -0.5f, 0.0f, 0.0f,    // 5
			-0.5f,  0.5f,  0.5f, 0.0f, 1.0f,    // 6
			 0.5f,  0.5f,  0.5f, 1.0f, 1.0f,    // 7
			// North -Z
			-0.5f,  0.5f, -0.5f, 1.0f, 0.0f,    // 5
			 0.5f,  0.5f, -0.5f, 0.0f, 0.0f,    // 4
			 0.5f, -0.5f, -0.5f, 0.0f, 1.0f,    // 3
			-0.5f, -0.5f, -0.5f, 1.0f, 1.0f,    // 2
			// South +Z
			 0.5f,  0.5f,  0.5f, 1.0f, 0.0f,    // 7
			-0.5f,  0.5f,  0.5f, 0.0f, 0.0f,    // 6
			-0.5f, -0.5f,  0.5f, 0.0f, 1.0f,    // 1
			 0.5f, -0.5f,  0.5f, 1.0f, 1.0f,    // 0
			// West -X
			-0.5f,  0.5f,  0.5f, 1.0f, 0.0f,    // 6
			-0.5f,  0.5f, -0.5f, 0.0f, 0.0f,    // 5
			-0.5f, -0.5f, -0.5f, 0.0f, 1.0f,    // 2
			-0.5f, -0.5f,  0.5f, 1.0f, 1.0f,    // 1
			// East +X
			 0.5f,  0.5f, -0.5f, 1.0f, 0.0f,    // 4
			 0.5f,  0.5f,  0.5f, 0.0f, 0.0f,    // 7
			 0.5f, -0.5f,  0.5f, 0.0f, 1.0f,    // 0
			 0.5f, -0.5f, -0.5f, 1.0f, 1.0f,    // 3
		}
		
mIndices[36] = {
			0, 1, 2,    	0, 2, 3,	// Down -Y
			4, 5, 6, 		4, 6, 7,	// Up +Y
			8, 9, 10, 		8, 10, 11,	// North -Z
			12, 13, 14, 	12, 14, 15,	// South +Z
			16, 17, 18, 	16, 18, 19,	// West -X
			20, 21, 22, 	20, 22, 23	// East +X
		};

Good references:

https://github.com/jayanam/jgl_demos/tree/master - 3D scene renderer with property panel
https://github.com/Sarath18/Minecraft-Block-Viewer/tree/master - Minecraft block viewer
https://github.com/Toofifty/mc-modelr/blob/master/js/model.js - JSON parsing functions

Gui elements:

General:

Texture pack importer
Default texture pack for parents that aren't included with the user texture pack
JSON parser
Renderer
Parent model / texture inheritance

Eventual: