Ashes

KO | EN

gitlite — search

#hacktoberfest #llm #go #android #rust #deep-learning #nodejs #windows #awesome #kubernetes #awesome-list #security #mcp #open-source

(★ 345)

WebGL2.0 3D Engine - Global Illumination - RayTracing

File Explorer

Download Latest Version (.zip)

- - main.css
- - HDR_textures
- - background.fs.glsl
  - basic.fs.glsl
  - basic.vs.glsl
  - brdf.fs.glsl
  - brdf.vs.glsl
  - glsl.d.ts
  - line.fs.glsl
  - line.vs.glsl
  - ray.fs.glsl
  - ray.vs.glsl
  - ray_comb.fs.glsl
  - ray_comb.vs.glsl
  - stylize.fs.glsl
  - stylize.vs.glsl
  - stylize2.fs.glsl
  - stylize2.vs.glsl
  - test.fs.glsl
  - test.vs.glsl
  - vignetting.fs.glsl
  - vignetting.vs.glsl
- - basic.fs.glsl
  - basic.vs.glsl
  - brdf.fs.glsl
  - brdf.vs.glsl
  - glsl.d.ts
  - README.md
  - stylize.fs.glsl
  - stylize.vs.glsl
  - test.fs.glsl
  - test.vs.glsl
  - vignetting.fs.glsl
  - vignetting.vs.glsl
- - checker.png
  - floor.png
  - grid.jpg
- - aabb.ts
- - orbitControl.ts
- - component.ts
  - entityMgr.ts
  - system.ts
- - bloom.ts
  - linear_blur.ts
  - vignetting.ts
- - material.ts
- - boxMesh.ts
  - mesh.ts
  - quadMesh.ts
- - bvh.ts
  - kdtree.ts
  - octree.ts
- - screen.ts
- animation.ts
- ashes.ts
- asset.ts
- camera.ts
- example.ts
- filter.ts
- glsl.ts
- gltfScene.ts
- math.ts
- meshRenderer.ts
- shader.ts
- skin.ts
- texture.ts
- transform.ts
.gitignore
.gitmodules
.npmignore
.travis.yml
bvh.html
demo.html
gltfsamples
index.html
LICENSE
package.json
README.md
rollup.config.js
tsconfig.json
yarn.lock

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![image](https://user-images.githubusercontent.com/7625588/101237212-04e26780-372b-11eb-81ee-c45f34aa3031.png)

[![Build Status](https://travis-ci.org/but0n/Ashes.svg?branch=master)](https://travis-ci.org/but0n/Ashes)
[![](https://badgen.net/bundlephobia/minzip/ashes3d)](https://bundlephobia.com/result?p=ashes3d)
[![](https://data.jsdelivr.com/v1/package/npm/ashes3d/badge)](https://www.jsdelivr.com/package/npm/ashes3d)

## [Dynamic GI](https://but0n.github.io/webgl-gi/)
![](https://user-images.githubusercontent.com/7625588/199723977-931991c0-88ca-479c-9c7a-abe6c2af3ab3.jpg)
![](https://user-images.githubusercontent.com/7625588/199723996-919da83c-5898-45b7-b6e6-74aefd062201.jpg)

## [Ray Tracing demo](https://but0n.github.io/Ashes/bvh.html)
![](https://user-images.githubusercontent.com/7625588/121191833-b0719d80-c8af-11eb-97c4-9eac6f8e3e8e.png)

- Press `k` to toggle render mode
 - Press `q` and `e` to adjust aperture (depth of field)
 - Press `a` and `d` to focal length
 - Press `[` andd `]` to adjust exposure

## [glTF Example](https://but0n.github.io/Ashes/demo.html)
![](https://user-images.githubusercontent.com/7625588/87917315-231b3400-cab8-11ea-9742-afe57859490d.png)

![](https://user-images.githubusercontent.com/7625588/78468675-6f3aa680-775d-11ea-99e0-195d446d6798.png)
![](https://user-images.githubusercontent.com/7625588/67295473-c0d9d680-f519-11e9-96b8-72422af0a547.png)

# Examples
 - [glTF test](https://cx20.github.io/gltf-test/?engines=Ashes)
 - [Examples](https://cx20.github.io/jsdo.it-archives/tag/ashes/)
 - [Examples](https://jsfiddle.net/user/cx20/fiddles/)

# Features
![ezgif-4-e4c6f3cb3183](https://user-images.githubusercontent.com/7625588/58366099-db266e80-7eff-11e9-9d24-396a98895d7c.gif)

- Entity–component–system (ECS) architectural
 - glTF support
 - Physically based rendering (PBR)
 - Post effects (WIP)
 - Skeleton animation
 - Keyframe animation
 - HDR

# Getting Started

- via CDN
```html
<script src="https://cdn.jsdelivr.net/npm/ashes3d/build/ashes.main.js"></script>
```
- via npm
```
npm i ashes3d
```

# Usage

[Try it](https://codepen.io/but0n/pen/daERdd)

```js

let { Asset, EntityMgr, Camera, vec3, quat, Screen, OrbitControl, MeshRenderer, Filter, Shader, Material, QuadMesh } = Ashes;

let CDN = 'https://but0n.github.io/Ashes/'
Material.SHADER_PATH = CDN + Material.SHADER_PATH;

// DamagedHelmet
let gltf = CDN + 'gltfsamples/DamagedHelmet.glb';

async function main() {

let screen = new Screen('#screen');

screen.bgColor = [0.2,0.2,0.2,1];

let skybox = await Asset.loadCubemap(CDN + 'res/envmap/GoldenGateBridge2/');

let scene = EntityMgr.create('root - (Click each bar which has yellow border to toggle visible)');

// Camera
    let mainCamera = EntityMgr.create('camera');
    let cam = mainCamera.addComponent(new Camera(screen.width / screen.height));

// Set default position
    let cameraTrans = mainCamera.components.Transform;
    vec3.set(cameraTrans.translate, 0, 10, 10);

// Add it to scene
    scene.appendChild(mainCamera);

// Attach controler
    mainCamera.addComponent(new OrbitControl(screen, mainCamera));

document.querySelector('body').appendChild(scene);

// Load a gltf model
    let gltfroot = await Asset.loadGLTF(gltf, screen, skybox);
    scene.appendChild(gltfroot);

}

main();

```

## Create a quad with texture

```js
    // Create an entity
    let quad = scene.appendChild(EntityMgr.create('quad'));

// Load a material
    let quadMat = await Asset.LoadMaterial('stylize'); // PBR material

// Load a texture
    let floor = await Asset.loadTexture(CDN + 'res/textures/floor.png', { minFilter: screen.gl.NEAREST_MIPMAP_NEAREST });
    floor.flipY = true;

// Attach texture to material we created
    Material.setTexture(quadMat, 'baseColorTexture', floor);
    quadMat.shader.macros['HAS_BASECOLOR_MAP'] = '';

// Create a renderer component
    let quadMR = new MeshRenderer(screen, new QuadMesh(), quadMat);

// Attach renderer to entity
    quad.addComponent(quadMR);

// Set local translate [x, y, z]
    quad.components.Transform.translate[1] = -1;

// Set euler angle x, y, z
    quat.fromEuler(quad.components.Transform.quaternion, -90, 0, 0);

// The original size of quad is 2x2
    vec3.scale(quad.components.Transform.scale, quad.components.Transform.scale, 9);

```

# Deployment

```sh
git clone --recursive https://github.com/but0n/Ashes.git
cd Ashes

# if you don't have yarn installed
npm install -g yarn

yarn

yarn dev
```

Ashes

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Ashes

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README