Skip to content

Latest commit

 

History

History
181 lines (145 loc) · 3.06 KB

README.md

File metadata and controls

181 lines (145 loc) · 3.06 KB

Zhedra

A polyhedra plugin for the Zdog Pseudo-3D Engine

Install

CDN

Link directly to Zdog JS on ...

<script src="https://cdn.jsdelivr.net/gh/gemgames/[email protected]/zhedra-min.js"></script>

Features

  • New Objects!
  • Tetrahedron (Zdog.Tetra)
  • Cube (Zdog.Cube)
  • Octahedron (Zdog.Octa)
  • Dodecahedron (Zdog.Dodeca)
  • Icosahedron (Zdog.Icosa)
  • Change the color of each face
  • Less than 9Kb minified

Caveats

  • Objects can't have children

Codepen Demos

The Codepen

Hello World Demo

// Initialize Zhedra
Zhedra.init(Zdog);


// Create a Zdog illustration
let illo = new Zdog.Illustration({
  element: '.zdog-canvas'
});

// Create a tetrahedron object
new Zdog.Tetra({
  addTo: illo,
  translate: {},
  rotate: {},
  scale: 80,
  color: "#E62",
  fill: true,
  stroke: 0,
});

// Animation loop
function animate() {
  illo.rotate.x += 0.03;
  illo.updateRenderGraph();
  requestAnimationFrame(animate);
}
animate();

Colors

colors: [
  "#c25",
  "#e62",
  "#ea0",
  "#636"
]

API

Object Properties

Param Details Default
addTo Illustration / Anchor / Group to add to required
translate (Object) Translation {x : 0 , y : 0 , z : 0}
rotate (Object) Rotation {x : 0 , y : 0 , z : 0}
scale (Object / Number) Scale 1
color (String) Color of all faces '#333'
fill (Boolean) Fill param for all faces true
stroke (String) Stroke param for all faces '#333'
frontFace (String) Color of the front face optional
bottomFace (String) Color of the bottom face optional
rightFace (String) Color of the right face optional
leftFace (String) Color of the left face optional
colors (Array containing Strings) Colors of each faces optional

Functions

Functions Params Details
copy(params); params: Object Copy Object (Params above ^)
remove(); none Remove Object

Demos

Zdog.Tetra

// Create a tetrahedron object
new Zdog.Tetra({
  addTo: illo,
  translate: {},
  rotate: {},
  scale: 80,
  color: "#07D",
  fill: true,
  stroke: 0,
});

Zdog.Cube

// Create a cube object
new Zdog.Cube({
  addTo: illo,
  translate: {},
  rotate: {},
  scale: 80,
  color: "#0A2",
  fill: true,
  stroke: 0,
});

Zdog.Octa

// Create a octahedron object
new Zdog.Octa({
  addTo: illo,
  translate: {},
  rotate: {},
  scale: 80,
  color: "#EA0",
  fill: true,
  stroke: 0,
});

Zdog.Dodeca

// Create a dodecahedron object
new Zdog.Dodeca({
  addTo: illo,
  translate: {},
  rotate: {},
  scale: 80,
  color: "#E62",
  fill: true,
  stroke: 0,
});

Zdog.Icosa

// Create a icosahedron object
new Zdog.Icosa({
  addTo: illo,
  translate: {},
  rotate: {},
  scale: 80,
  color: "#C25",
  fill: true,
  stroke: 0,
});

Thank you!

Thank you for reading this! If you have any issues, please feel free to request an issue, or create a pull request