@mitchallen/pen
pen object that returns drawing path information
Installation
You must use npm 2.7.0 or higher because of the scoped package name.
$ npm init
$ npm install @mitchallen/pen --save
Usage
"use strict";
var penFactory = require("@mitchallen/pen");
var pen = penFactory.create({
color: 0xFF0000, // red pen
fill: 0x00FF00, // green fill
width: 2, // pen width
alpha: 0.8 // pen alpha value
});
pen.up()
.goto( { x: 50, y: 50 } ) // MoveTo 50, 50
.down()
.goto( { x: 10, y: 20 } ) // LineTo 10, 20
.goto( { x: 15, y: 30 } ) // LineTo 15, 30
.goto( { x: 45, y: 60 } ) // LineTo 45, 60
.up()
.goto( { x: 30, y: 40 } ) // MoveTo 30, 40
.goto( { x: 10, y: 20 } ) // LineTo 10, 20
var path = pen.path();Methods
penFactory = factory.create(spec)
Factory method that returns a pen object.
It takes one spec parameter can contain optional parameters:
- color - default if missing is 0x000000 - hex RGB color value
- width - default if missing is 1
- alpha - default if missing is 1.0 - valid values between 0.0 and 1.0
The method will return null if create fails, such as with bad parameters. You can call create multiple times to create multiple mazes.
var penFactory = require("@mitchallen/maze-generator");
var pen1 = penFactory.create({
color: 0xFF0000, // red pen
width: 2, // pen width
alpha: 0.8 // pen alpha value
});
var pen2 = penFactory.create( {
color: 0x0000FF, // blue pen
width: 3, // pen width
alpha: 0.6 // pen alpha value
});
if(!pen1 || !pen2) ...
pen.down()
Logical pen down.
pen.down();
pen.up()
Logical pen up.
pen.up();
pen.isDown()
Returns if pen is down.
if( pen.isDown() ) ...
pen.goto( { x: number, y: number } )
Maps path drawing operation. If the pen is up it generates a MoveTo. If the pen is down it generatea a LineTo. If this is the first operation it inserts a MoveTo (0,0).
pen.up()
.goto( { x: 50, y: 50 } ) // MoveTo 50, 50
.down()
.goto( { x: 10, y: 20 } ) // LineTo 10, 20
.goto( { x: 15, y: 30 } ) // LineTo 15, 30
pen.color()
Return RGB value of pen, either default or what was passed to create method.
var color = pen.color();
pen.fill()
Return RGB value of fill color, either default or what was passed to create method.
var fill = pen.fill();
pen.width()
Return width value of pen, either default or what was passed to create method.
var width = pen.width();
pen.alpha()
Return alpha value of pen, either default or what was passed to create method.
var alpha = pen.alpha();
pen.path()
Returns drawing path info in the form of an array. The array contains a series of drawing operation objects. Each operation contains an op, x and y parameter.
var path = pen.path();
Example result:
[ { op: "M", x: 10, y: 20 }, { op: "L", x: 20, y: 30 } ]
pen.viewPort()
Loops through the path values and returns an object containing the following properties:
- xMin - Returns minimum x position visited via goto. Rounded to a whole number.
- yMin - Returns minimum y position visited via goto. Rounded to a whole number.
- xMax - Returns maximum x position visited via goto. Rounded to a whole number.
- yMax - Returns maximum y position visited via goto. Rounded to a whole number.
Example:
var vp = pen.viewPort();
console.log( "xMin: ", vp.xMin );
Testing
To test, go to the root folder and type (sans $):
$ npm test
Repo(s)
Contributing
In lieu of a formal style guide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code.
Version History
Versoin 0.2.6
- README and LICENSE year update
Versoin 0.2.5
- up, down and goto now support chaining
Versoin 0.2.4
- fill can now handle 0x000000
Version 0.2.3
- code cleanup
Version 0.2.2
- package dependency cleanup
Version 0.2.1
- added fill for fill color which defaults to null (aka none)
Version 0.2.0
- min / max methods replaced with viewPort method
Version 0.1.3
- min / max values now rounded and compared to whole numbers
Version 0.1.2
- fixed bug where goto returned null if x or y was zero
Version 0.1.1
- updated description in package.json
Version 0.1.0
- initial release