Galacean Engine is a high-performance 3D rendering engine for web applications. It provides a powerful set of tools and APIs for creating interactive 3D graphics, games, and visualizations in web browsers using WebGL technology.

Pros

• High performance and optimized for web-based 3D rendering
• Comprehensive feature set including physics, animation, and particle systems
• Active development and regular updates
• Cross-platform compatibility (works on desktop and mobile browsers)

Cons

• Steeper learning curve compared to some simpler 3D libraries
• Documentation could be more extensive and beginner-friendly
• Limited ecosystem of third-party plugins and extensions
• Performance may vary on older or less powerful devices

Code Examples

Creating a basic scene with a rotating cube:

import { Engine, Scene, Camera, Vector3, MeshRenderer, PrimitiveMesh } from "@galacean/engine";

const engine = await Engine.create();
const scene = engine.sceneManager.activeScene;
const rootEntity = scene.createRootEntity();

const cameraEntity = rootEntity.createChild("Camera");
cameraEntity.addComponent(Camera);
cameraEntity.transform.setPosition(0, 0, 10);

const cubeEntity = rootEntity.createChild("Cube");
const renderer = cubeEntity.addComponent(MeshRenderer);
renderer.mesh = PrimitiveMesh.createCuboid(engine, 1, 1, 1);

engine.run();

function animate() {
  cubeEntity.transform.rotate(new Vector3(0, 1, 0), 0.01);
  requestAnimationFrame(animate);
}
animate();

Adding a point light to the scene:

import { PointLight } from "@galacean/engine";

const lightEntity = rootEntity.createChild("PointLight");
const pointLight = lightEntity.addComponent(PointLight);
pointLight.intensity = 1.5;
lightEntity.transform.setPosition(0, 2, 2);

Implementing basic physics:

import { PhysicsManager, BoxColliderShape, DynamicCollider } from "@galacean/engine";

PhysicsManager.initialize();

const collider = cubeEntity.addComponent(DynamicCollider);
const boxShape = new BoxColliderShape();
boxShape.size.set(1, 1, 1);
collider.addShape(boxShape);

Getting Started

To get started with Galacean Engine, follow these steps:

1. Install the package:

   npm install @galacean/engine
   

2. Import and initialize the engine in your project:

   import { Engine } from "@galacean/engine";
   
   async function init() {
     const engine = await Engine.create();
     const scene = engine.sceneManager.activeScene;
     // Add your scene setup code here
     engine.run();
   }
   
   init();
   

3. Start building your 3D scene by adding entities, components, and implementing your desired functionality using the Galacean Engine APIs.