threepp (Work in progress)
Cross-platform C++17 port of the popular Javascript 3D library three.js r129.
Current state of the project
Most of the core library has been ported, including basic rendering capabilities, however much remains to be done..
What works?
- Box, Sphere, Plane, Cylindrical and Tube geometries
- 2D Textures
- Transparency
- OrbitControls
- AmbientLight, DirectionalLight, PointLight
- Most materials
- RenderTarget
- Raycasting against Mesh
But, but why?
This is mostly a personal exercise. Don't expect much support, although contributions are welcome.
How to build
In order to successfully build threepp, you'll need conan in order to handle dependencies.
pip install conan
With conan installed, invoke run_conan_install.sh. This will fetch all necessary third party libraries as listed in conanfile.txt.
note that this command is hardcoded to use the default CLion build folders (cmake-build-<target>)
You can now build the project as a regular CMake project using e.g., the command line.
Implementation notes
In general, you'll find that math classes are value types, while threepp expect smart pointers for other types. For convenience, geometries, materials etc. has a static ::create function that returns a std::shared_ptr. There should never be a need to handle memory explicitly using threepp. Yay!
Example
#include "threepp/threepp.hpp"
using namespace threepp;
int main() {
Canvas canvas;
auto scene = Scene::create();
auto camera = PerspectiveCamera::create(75, canvas.getAspect(), 0.1f, 100);
camera->position.z = 5;
GLRenderer renderer(canvas);
renderer.checkShaderErrors = true;
renderer.setSize(canvas.getSize());
OrbitControls controls{camera, canvas};
auto light = AmbientLight::create(Color(0xffffff).multiplyScalar(0.75f));
scene->add(light);
auto group = Group::create();
{
const auto boxGeometry = BoxGeometry::create();
const auto boxMaterial = MeshPhongMaterial::create();
boxMaterial->color.setHex(0xff0000);
auto box = Mesh::create(boxGeometry, boxMaterial);
box->position.setX(-1);
group->add(box);
}
{
const auto boxGeometry = BoxGeometry::create();
const auto boxMaterial = MeshPhongMaterial::create();
boxMaterial->color.setHex(0x00ff00);
auto box = Mesh::create(boxGeometry, boxMaterial);
box->position.setX(1);
group->add(box);
}
scene->add(group);
const auto planeGeometry = PlaneGeometry::create(5, 5);
const auto planeMaterial = MeshLambertMaterial::create();
planeMaterial->color.setHex(Color::gray);
planeMaterial->side = DoubleSide;
auto plane = Mesh::create(planeGeometry, planeMaterial);
plane->position.setY(-1);
plane->rotateX(math::degToRad(90));
scene->add(plane);
canvas.onWindowResize([&](WindowSize size) {
camera->aspect = size.getAspect();
camera->updateProjectionMatrix();
renderer.setSize(size);
});
group->rotation.setOrder(Euler::YZX);
canvas.animate([&](float dt) {
group->rotation.y += 0.5f * dt;
renderer.render(scene, camera);
});
}
324 Jan 4, 2023
98 Dec 9, 2022
12 Sep 27, 2022
1 Jun 24, 2022
4 May 14, 2022
983 Dec 26, 2022
5.2k Jan 6, 2023
1.7k Dec 30, 2022
31 Dec 10, 2022
31 Jul 11, 2022
105 Dec 11, 2022
56 Dec 1, 2022
1.7k Jan 4, 2023
404 Dec 25, 2022
92 Jan 3, 2023
47 Nov 9, 2022
14 Aug 20, 2022
155 Dec 20, 2022
1.5k Dec 31, 2022
32 Nov 29, 2022
4 Nov 29, 2022
108 Dec 31, 2022
44 Dec 11, 2022
297 Dec 26, 2022
4 Nov 14, 2022
4 Dec 14, 2021
32 Dec 21, 2022
19 Sep 5, 2022