webcodecamjs
v2.0.5
Published
bercode qrode decoder
Downloads
90
Maintainers
atandrastothReadme
WebCodeCamJS & WebCodeCamJQuery
New versions of popular WebCodeCam jQuery plugin
- Very simple usage
- Some option for optimal result
- Quick implementation
- Optimized for all modern browsersAdvantages compared to the previous version:
- Built in camera selector menu creation
- Faster
- Lower CPU and Memory usage
- More configurable- Homepage - Home page, demonstration
Version
2.0.5
- Add parameter tryVertical to options
- Some minor modificationVersion
2.0.1
- Add parameter successTimeout to options
- Add parameter codeRepetition to optionsVersion
2.0.0
- Add UPC-A, UPC-E support, result function return value changed!Version
1.9.1
- Add default cameraindex parameter to buildSelectMenu, optionalVersion
1.9.0
- Add function: decode image from urlVersion
1.8.0
- Add function: decode local imageVersion
1.7.0
- Add jquery version (WebCodeCamJQuery)Version
1.5.0
- Optimized for all modern browsers
- Refactor functionsVersion
1.0.0
- Very simple usage
- Some option for optimal result
- Quick implementationIncluded decoders
barcode decoder (DecoderWorker.js)
qr-decoder (qrcodelib.js)
Required HTML & Javascript example
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Demo</title>
</head>
<body>
<h3>Simple initialization with default settings</h3>
<hr>
<canvas></canvas>
<hr>
<ul></ul>
<script type="text/javascript" src="js/qrcodelib.js"></script>
<script type="text/javascript" src="js/webcodecamjs.js"></script>
<!--
Using jquery version:
<script type="text/javascript" src="js/jquery.js"></script>
<script type="text/javascript" src="js/qrcodelib.js"></script>
<script type="text/javascript" src="js/webcodecamjquery.js"></script>
-->
<script type="text/javascript">
var txt = "innerText" in HTMLElement.prototype ? "innerText" : "textContent";
var arg = {
resultFunction: function(result) {
/*
result.format: code format,
result.code: decoded string,
result.imgData: decoded image data
*/
var aChild = document.createElement('li');
aChild[txt] = result.format + ': ' + result.code;
document.querySelector('body').appendChild(aChild);
}
};
/* ----------------------------------------- Available parameters -----------------------------------------*/
var options = {
DecodeQRCodeRate: 5, // null to disable OR int > 0 !
DecodeBarCodeRate: 5, // null to disable OR int > 0 !
successTimeout: 500, // delay time when decoding is succeed
codeRepetition: true, // accept code repetition true or false
tryVertical: true, // try decoding vertically positioned barcode true or false
frameRate: 15, // 1 - 25
width: 320, // canvas width
height: 240, // canvas height
constraints: { // default constraints
video: {
mandatory: {
maxWidth: 1280,
maxHeight: 720
},
optional: [{
sourceId: true
}]
},
audio: false
},
flipVertical: false, // boolean
flipHorizontal: false, // boolean
zoom: -1, // if zoom = -1, auto zoom for optimal resolution else int
beep: 'audio/beep.mp3', // string, audio file location
decoderWorker: 'js/DecoderWorker.js', // string, DecoderWorker file location
brightness: 0, // int
autoBrightnessValue: false, // functional when value autoBrightnessValue is int
grayScale: false, // boolean
contrast: 0, // int
threshold: 0, // int
sharpness: [], // to On declare matrix, example for sharpness -> [0, -1, 0, -1, 5, -1, 0, -1, 0]
resultFunction: function(resText, lastImageSrc) { //resText as decoded code, lastImageSrc as image source
console.log(resText);
},
cameraSuccess: function(stream) { //callback funtion to camera success
console.log('cameraSuccess');
},
canPlayFunction: function() { //callback funtion to can play
console.log('canPlayFunction');
},
getDevicesError: function(error) { //callback funtion to get Devices error
console.log(error);
},
getUserMediaError: function(error) { //callback funtion to get usermedia error
console.log(error);
},
cameraError: function(error) { //callback funtion to camera error
console.log(error);
}
};
/*------------------------------------ Declarations and initializing ------------------------------------*/
new WebCodeCamJS("canvas").init(arg);
/* OR */
var canvas = document.querySelector('#webcodecam-canvas');
new WebCodeCamJS(canvas).init();
/* OR */
new WebCodeCamJS('#webcodecam-canvas').init();
/*--------------------------------------- Example initializations ---------------------------------------*/
var decoder = new WebCodeCamJS('#webcodecam-canvas');
/* Chrome & Spartan: build select menu, return decoder object
* Firefox: the default camera initializes, return decoder object
*/
decoder.buildSelectMenu('#camera-select', index); //index : default camera index optional
//init with arguments, return decoder object
decoder.init(args);
/*OR with defaults*/
var decoder = new WebCodeCamJS('#webcodecam-canvas').init();
/*OR with arguments*/
var decoder = new WebCodeCamJS('#webcodecam-canvas').init(args);
/*OR with video source selector builder and initialization*/
var decoder = new WebCodeCamJS('#webcodecam-canvas').buildSelectMenu('select').init(args);
/*---------------------------- Example initializations using jquery version ----------------------------*/
var decoder = $("#webcodecam-canvas").WebCodeCamJQuery(args).data().plugin_WebCodeCamJQuery;
/* Chrome & Spartan: build select menu
* Firefox: the default camera initializes, return decoder object
*/
decoder.buildSelectMenu('#camera-select', index); //index : default camera index optional
//simple initialization
decoder.init();
/* ---------------------------------------- Available Functions: ----------------------------------------*/
/* camera stop & delete stream */
decoder.stop();
/* camera play, restore process */
decoder.play();
/* get current image from camera */
decoder.getLastImageSrc();
/* decode local image */
/* if url is defined download image before staring open process */
decoder.decodeLocalImage(url);
/* get optimal zoom */
decoder.getOptimalZoom();
/* Configurable options */
decoder.options['parameter'];
/* Example:
** decoder.options.brightness = 20; - set brightness to 20
** decoder.options.DecodeQRCodeRate = null; - disable qrcode decoder
*/
</script>
</body>
</html>License
MIT
Author: Tóth András
http://atandrastoth.co.uk/
2015-06-10