cube-side-array v0.1.1
cube-side-array
Convenient cube side array expansion for texture faces
Usage:
var expandName = require('cube-side-array');
var array = expandName(name);
Returns a 6-element array, each element corresponding to a cube face. The name
parameter is intended to be user-specified; several formats are recognized:
- scalar: the same value is repeated for all sides
- 1-element array: same as scalar
- 2-element array: top/bottom, sides
- 3-element array: top, bottom, sides
- 4-element array: top, bottom, front/back, left/right
- 5-element array: top, bottom, front, back, left/right
- object with keys top, bottom, front, back, left, right
For example, 'dirt'
or ['dirt']
will return ['dirt', 'dirt', 'dirt', 'dirt', 'dirt', 'dirt']
,
saving you from having to tediously retype dirt over and over. Or ['grass_top', 'dirt', 'grass_side']
,
specifying grass_top
for the top face, dirt
for the bottom face, and grass_side
for everything else.
See test.js
for more examples.
Inspired by @shama's voxel-texture _expandName
Custom Order
The second argument can optionally be a 6-character string representing the side order requested for the return value. Examples:
- RTFLBK - used by voxel-mesher, ao-mesher
- KFTBLR - used by voxel-texture-shader, voxel-texture
- FKTBRL - used in this Mozilla WebGL cube demo
Default order if omitted is 'RTFLBK' (right, top, front, left, bottom, back)
License
MIT