zimjs 18.1.9 → 18.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zimjs",
-  "version": "18.1.9",
+  "version": "18.2.1",
   "type": "module",
   "main": "./src/zim.js",
   "types": "./ts-src/typings/zim",

package/src/zim.js

@@ -55919,7 +55919,9 @@ hitTestPoint
 zim DisplayObject method
 
 DESCRIPTION
-See if shape of obj is hitting the global point x and y on the stage.
+Tests if shape of obj is hitting the global point x and y on the stage.
+
+NOTE: https://zimjs.com/tips.html#HITTEST for tips on Hit Tests
 
 EXAMPLE
 const circle = new Circle().loc(100,100).drag();
@@ -55970,7 +55972,9 @@ hitTestReg
 zim DisplayObject method
 
 DESCRIPTION
-See if the shape shape of an object is hitting the registration point of object (other).
+Tests if the shape shape of an object is hitting the registration point of object (other).
+
+NOTE: https://zimjs.com/tips.html#HITTEST for tips on Hit Tests
 
 EXAMPLE
 const circle = new Circle(50, red).center().drag();
@@ -56020,6 +56024,8 @@ The rectangle is based on the position, registration and bounds of object (other
 num is how many points on the edge of the rectangle we test - default is 0.
 The four corners are always tested as well as the very middle of the rectangle.
 
+NOTE: https://zimjs.com/tips.html#HITTEST for tips on Hit Tests
+
 EXAMPLE
 const circle = new Circle(50, red).center().drag();
 const rect = new Rectangle(100, 100, blue).loc(100,100);
@@ -56115,7 +56121,9 @@ zim DisplayObject method
 DESCRIPTION
 Uses an equation to see if the bounds of a rectangular object is hitting a point x, y.
 This is faster than hitTests on shapes - so will have the speed of hitTestBounds, hitTestCircles and hitTestGrid.
-A margin parameter is provided to tweak the hitTest
+A margin parameter is provided to tweak the hitTest.
+
+NOTE: https://zimjs.com/tips.html#HITTEST for tips on Hit Tests
 
 EXAMPLE
 const rect = new Rectangle(50, 50, red).center().drag();
@@ -56158,9 +56166,11 @@ zim DisplayObject method
 DESCRIPTION
 See if the shape of an object is hitting points on a circle of another object.
 The circle is based on the position, registration and bounds of object (other).
-num is how many points around the circle we test - default is 8
+num is how many points around the circle we test - default is 8.
 Also checks center of circle hitting.
 
+NOTE: https://zimjs.com/tips.html#HITTEST for tips on Hit Tests
+
 EXAMPLE
 var circle = new Circle(50, red).center().drag();
 var triangle = new Triangle(100, 100, 100, blue).loc(100,100);
@@ -56241,9 +56251,11 @@ DO NOT use with a rotated rectangle object - for that use hitTestRect() or hitTe
 This is faster than hitTests on shapes - so will have the speed of hitTestBounds, hitTestCircles and hitTestGrid.
 The circle is based on a the object radius if there is one
 and if no radius then the average of the width and height divided by two.
-A margin parameter is provided to tweak the hitTest
-The rect is based on the bounds of the second object projected globally as a rectangle
-If the second object bounds are rotated, the global bounds will be bigger to keep parallel to the axes
+A margin parameter is provided to tweak the hitTest.
+The rect is based on the bounds of the second object projected globally as a rectangle.
+If the second object bounds are rotated, the global bounds will be bigger to keep parallel to the axes.
+
+NOTE: https://zimjs.com/tips.html#HITTEST for tips on Hit Tests
 
 EXAMPLE
 const ball = new Circle(50, red).center().drag();
@@ -56306,7 +56318,9 @@ Uses an equation to see if a circlular object is hitting a point x, y.
 This is faster than hitTests on shapes - so will have the speed of hitTestBounds, hitTestCircles and hitTestGrid.
 The circle is based on a the object radius if there is one
 and if no radius then the average of the width and height divided by two.
-A margin parameter is provided to tweak the hitTest
+A margin parameter is provided to tweak the hitTest.
+
+NOTE: https://zimjs.com/tips.html#HITTEST for tips on Hit Tests
 
 EXAMPLE
 const ball = new Circle(50, red).center().drag();
@@ -56358,7 +56372,9 @@ Uses an equation to see if two circles are intersecting.
 This is faster than hitTests on shapes - so will have the speed of hitTestBounds and hitTestGrid.
 The circles are based on the bounds of the two objects - it does not matter on which object the method is placed.
 If the bounds are not square then half the average length of the sides is used as the radius.
-A margin parameter is provided to tweak the hitTest
+A margin parameter is provided to tweak the hitTest.
+
+NOTE: https://zimjs.com/tips.html#HITTEST for tips on Hit Tests
 
 EXAMPLE
 const ball = new Circle(50, red).center().drag();
@@ -56415,6 +56431,8 @@ See if obj.getBounds() is hitting other.getBounds().
 Margin can be adjusted to tweak the hitTest.
 Pass in a boundsShape shape if you want a demonstration of where the bounds are.
 
+NOTE: https://zimjs.com/tips.html#HITTEST for tips on Hit Tests
+
 EXAMPLE
 const circle = new Circle(50, red).center().drag();
 const rect = new Rectangle(100, 100, blue).loc(100,100);
@@ -56472,9 +56490,12 @@ zim DisplayObject method
 
 DESCRIPTION
 See if the shape of an object is hitting points on a path of a Squiggle or Blob.
-num is how many points between each point on the path we test - default is 2
+num is how many points between each point on the path we test - default is 2.
+
 SEE: https://zimjs.com/hittestpath.html
 
+NOTE: https://zimjs.com/tips.html#HITTEST for tips on Hit Tests
+
 EXAMPLE
 const path = new Blob().center();
 const circle = new Circle(50, purple).pos(100,100).drag();
@@ -56557,6 +56578,8 @@ Converts an x and y point to an index in a grid.
 If you have a grid of rectangles, for instance, use this to find out which rectangle is beneath the cursor.
 This technique will work faster than any of the other hit tests.
 
+NOTE: https://zimjs.com/tips.html#HITTEST for tips on Hit Tests
+
 EXAMPLE
 const tile = new Tile(new Rectangle(100,100),5,4,10,10).center();
 const circle = new Circle(10,green).pos(10,10).drag();
@@ -56989,6 +57012,7 @@ props - the object literal holding properties and values to animate
 		then this will be the last of the series to run
 		Note: color cannot be animated in a series - rather animate in a call function to accomplish a series of color changes
 		Note: a sequence cannot be seriesed and a series cannot be sequenced
+		Note: series with dot properties (like rotation.x for threejs) could have problems with from and set
 time - |ZIM VEE| (default 1) the time for the tween in seconds (also see ZIM TIME constant)
 	see also the rate parameter and property to dynamically change the time the animation takes (its speed)
 ease - |ZIM VEE| (default "quadInOut") the equation type for easing ("bounceOut", "elasticIn", "backInOut", "linear", etc)
@@ -57090,7 +57114,6 @@ protect - (default false) protects animation from being interrupted before finis
 override - (default true) subesequent tweens of any type on object cancel all earlier tweens on object
 	set to false to allow multiple tweens of same object
 from - |ZIM VEE| (default false) set to true to animate from obj properties to the current properties set on target
-	note that from is not supported with dot properties such as "rotation.x" with threejs (a difficult bug)
 set - |ZIM VEE| (default null) an object of properties to set on the target to start (but after the wait time)
 id - (default null) set to String to use with pauseAnimate(state, id) and stopAnimate(id) - thanks Sean Berwick for typo catch
 	series animate gets only one overall id - so no id per animation object
@@ -57364,7 +57387,7 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 
 		// handle setting value with dot property format
 		// (target, "rotation.x", 200) for instance
-		function setValue(what, prop, val) {			
+		function setValue(what, prop, val) {	
 			if (prop.substr(0,1) == ".") {
 				var dots = prop.split(".");
 				var lastdot = what;
@@ -57403,8 +57426,7 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 		// PREPARE ZIK RANDOM VALUES PASSED IN AS ARRAY OR RAND OBJECT {min, max, integer, negative}
 		var extraTypes = ["extra", "zoom", "speed", "layer", "fade"];
 		var extraLookup = {zoom:target.type=="Pen"?"size":"scale", speed:"percentSpeed", layer:"layer", fade:"alpha"};
-
-		
+	
 		if (target instanceof Array) {
 			if (sequenceReverse) target.reverse();
 			
@@ -57705,7 +57727,7 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 				}
 
 				if (o.from) {
-					var firstFrom = froms.at(o.target);
+					var firstFrom = froms.at(o.target);					
 					if (firstFrom) {
 						if (o.set) {
 							// all properties from obj go to set
@@ -58161,11 +58183,12 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 				target.zimLastObj[i] = rewind?target.zimTweenOriginals[i]:obj[i];
 			}
 		}
-
+		
 		function relativeSetAdjust() {
 			var newStart;
 			for (i in set) {
 				if (typeof set[i] == "string" && i != "transform") {
+					
 					if (i.substring && i.substring(0,1)==".") {
 						if (set[i].substr(0,1)=="+"||set[i].substr(0,1)=="-") continue; 
 					} else {
@@ -58353,14 +58376,13 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 			delete obj.path;
 			obj.pathRatio = 1; // this is what we are animating to
 		}
-
-		// !!!!! fix for dot values
-
+		
 		// PREPARE START VALUES - now that pathRatio is set
 		// moved to prepareRelative
 		// if (from) obj = getFroms(target, obj, set, true);
 		var startObj = {} // for later getStart()
 		function getFroms(target, obj, set, update) {
+			
 			fromCheck = true;
 			// animating based on pathRatio - but API is percentComplete
 			// with from set, this causes problems - so add pathRatio equal to percentComplete to set
@@ -58373,9 +58395,17 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 				if (set && !zot(set[i])) {
 					newObj[i] = set[i];
 				} else {
-					newObj[i] = target[i];
+					if (i.match(/\./)) { // handle dot props like threejs - patched ZIM 018
+						var bunch = i.split(/\./g);
+						newObj[i] = target[bunch[1]][bunch[2]];
+					} else {
+						newObj[i] = target[i];
+					}
 				}
-				if (update) target[i] = obj[i];
+				if (update) {
+					if (i.match(/\./)) target[bunch[1]][bunch[2]] = obj[i];
+					else target[i] = obj[i];
+				}				
 			}
 			return newObj;
 		}
@@ -59090,9 +59120,9 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 			if (!startTest)	{
 				obj2 = getStart();				
 				startTest = true;				
-			} 
-			
-			if (target.set && !from) target.set(set);	
+			} 			
+			checkSets();
+			// if (target.set && !from) target.set(set);	
 			tween = target.zimTweens[id] =  target.zimTween = createjs.Tween.get(target, cjsProps)
 				.call(doStartCall)				
 				.to(obj, t, finalEase)				
@@ -59147,7 +59177,9 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 			}
 		}
 		function tween2(lastTween) {
-			if (target.set && !from) {target.set(set);}
+			
+			checkSets();
+			// if (target.set && !from) {target.set(set);}
 			tween = target.zimTweens[id] =  target.zimTween = createjs.Tween.get(target, cjsProps)
 				.call(doStartCall)
 				.to(obj, t, finalEase)				
@@ -59242,6 +59274,26 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 			}			
 		}
 
+		function checkSets() {
+			if (!from) {
+				if (set) {
+					if (target.set) {
+						target.set(set);
+					} else {
+						if (target)
+						for (i in set) {
+							if (i.match(/\./)) { // handle dot props like threejs - patched ZIM 018
+								var bunch = i.split(/\./g);
+								target[bunch[0]][bunch[1]] = set[i];
+							} else {
+								target[i] = set[i];
+							}	
+						}
+					}					
+				}
+			}
+		}
+
 		function transferIds(lastTween, tween) {
 			tween.zimIdSet = lastTween.zimIdSet; // know we need this one - not sure about the rest 10.4.0
 			tween.zimObj = lastTween.zimObj;
@@ -74075,7 +74127,7 @@ dispatches a "swipestop" event when swipeup has happened and value has stopped c
 	//-69.5
 
 /*--
-zim.MotionController = function(target, type, speed, axis, boundary, map, diagonal, damp, flip, orient, constant, firstPerson, turnSpeed, moveThreshold, stickThreshold, container, localBoundary, mouseMoveOutside, mousedownIncludes, minPercentSpeed, maxPercentSpeed, dampKeyup, rotate, mouseOutside, tileObj, penDown, offTime)
+zim.MotionController = function(target, type, speed, axis, boundary, map, diagonal, damp, flip, orient, constant, firstPerson, turnSpeed, moveThreshold, stickThreshold, container, localBoundary, mouseMoveOutside, mousedownIncludes, minPercentSpeed, maxPercentSpeed, dampKeyup, rotate, mouseOutside, tileObj, penDown, offTime, startAngle)
 
 MotionController
 zim class - extends a createjs EventDispatcher
@@ -74269,7 +74321,7 @@ METHODS
 pause(state, time) - state defaults to true and pauses the motionController (sets speed to 0)
 	set state to false to unpause the motionController (sets speed to speed before pausing)
 	set the time (default 0) to the seconds to take while slowing the motionController to 0 speed (also see ZIM TIME constant)
-immediate(x, y) - set the damping immediately to this value to avoid damping to value - returns object for chaining
+immediate(x, y, rotation) - set the damping immediately to this value to avoid damping to value - returns object for chaining
 convert(x, y) - for manual mode, pass in x and y and damping and rotation will be calculated
 dispose() - remove listeners and Ticker, Swiper and GamePad, where applicable
 
@@ -74313,8 +74365,8 @@ dispatches a "mousedown" event if type is "mousedown" or "pressmove"
 dispatches a "pressing" event if type is "pressmove" - note, this dispatches even if not moving
 dispatches a "moving" event if target is moving and "startmoving" and "stopmoving" events
 --*///+69.7
-	zim.MotionController = function(target, type, speed, axis, boundary, map, diagonal, damp, flip, orient, constant, firstPerson, turnSpeed, moveThreshold, stickThreshold, container, localBoundary, mouseMoveOutside, mousedownIncludes, minPercentSpeed, maxPercentSpeed, dampKeyup, rotate, mouseOutside, tileObj, penDown, offTime) {
-		var sig = "target, type, speed, axis, boundary, map, diagonal, damp, flip, orient, constant, firstPerson, turnSpeed, moveThreshold, stickThreshold, container, localBoundary, mouseMoveOutside, mousedownIncludes, minPercentSpeed, maxPercentSpeed, dampKeyup, rotate, mouseOutside, tileObj, penDown, offTime";
+	zim.MotionController = function(target, type, speed, axis, boundary, map, diagonal, damp, flip, orient, constant, firstPerson, turnSpeed, moveThreshold, stickThreshold, container, localBoundary, mouseMoveOutside, mousedownIncludes, minPercentSpeed, maxPercentSpeed, dampKeyup, rotate, mouseOutside, tileObj, penDown, offTime, startAngle) {
+		var sig = "target, type, speed, axis, boundary, map, diagonal, damp, flip, orient, constant, firstPerson, turnSpeed, moveThreshold, stickThreshold, container, localBoundary, mouseMoveOutside, mousedownIncludes, minPercentSpeed, maxPercentSpeed, dampKeyup, rotate, mouseOutside, tileObj, penDown, offTime, startAngle";
 		var duo; if (duo = zob(zim.MotionController, arguments, sig, this)) return duo;
 		z_d("69.7");
 
@@ -74431,6 +74483,7 @@ dispatches a "moving" event if target is moving and "startmoving" and "stopmovin
 		if (container && container.backing) this.mousedownIncludes.push(container.backing);
 		// this.mousedownExcludes = mousedownExcludes;
 		if (zot(dampKeyup)) dampKeyup = .3;
+		if (zot(startAngle)) startAngle = 0;
 
 		if (boundary && boundary.type!="Blob") {	
 			target.x = zim.constrain(target.x, boundary.x, boundary.x+boundary.width);
@@ -74824,6 +74877,7 @@ dispatches a "moving" event if target is moving and "startmoving" and "stopmovin
 			speedY = trig.speedY;
 
 			if (!rotate) return;
+
 			if (!zot(trig.angle)) that.rotation = trig.angle+target.zimMCStartAngle;
 			if (zot(that.rotation)) {
 				that.rotation = that.target.rotation;
@@ -74845,6 +74899,7 @@ dispatches a "moving" event if target is moving and "startmoving" and "stopmovin
 			that.dampR.immediate(oldR); // required otherwise damping equation has mind of its own
 			that.target.rotation = oldR; // make sure to set this again as we may have changed oldR for proper rotational direction when damped
 			that.rotation = newR;
+
 		}
 		function normalizeAngle(a) {
 			return (a % 360 + 360) % 360;
@@ -74906,7 +74961,7 @@ dispatches a "moving" event if target is moving and "startmoving" and "stopmovin
 
 		function makeKeyInterval() {
 
-			that.keyInterval = interval(time, function() {		
+			that.keyInterval = interval(time, function() {	
 				if (down && down[0]==0&&down[1]==0&&down[2]==0&down[3]==0) {
 					that.keyInterval.clear();
 					that.keyInterval = null;
@@ -74982,7 +75037,7 @@ dispatches a "moving" event if target is moving and "startmoving" and "stopmovin
 		var mainTicker = zim.Ticker.add(function() {
 			if (tileObj) return;
 			if (target.draggingCheck) return;
-			if (type == "manual") calculate();
+			if (type == "manual" && !dPad) calculate();
 			if (that.boundary && that.boundary.type!="Blob") {				
 				that.x = zim.constrain(that.x, that.boundary.x, that.boundary.x+that.boundary.width);
 				that.y = zim.constrain(that.y, that.boundary.y, that.boundary.y+that.boundary.height);				
@@ -86847,7 +86902,7 @@ loadAssets(assets, path, progress, xhr, time, loadTimeout, outputAudioSprite, cr
 				note: this means the Bitmap will be interactive everywhere - not just in opaque areas
 				note: loading images this way will not count as progress (bytes loaded ratio) in the progress event but do count for fileloaded and complete events
 		asset can be a ZIM multi-asset object {assets:[], path:"dir/", loadTimeout:1, maxNum:num, noCORSonImage:true}
-			where the array can hold multiple files that will have the provided properties applied 
+			where the array can hold multiple files that will have the provided properties applied 			
 			this is handy for loading assets from multiple directories (added in ZIM Cat 02 - thanks Netanela for the prompting)
 			eg.
 			[
@@ -86892,6 +86947,8 @@ loadAssets(assets, path, progress, xhr, time, loadTimeout, outputAudioSprite, cr
 				    ]
 				}}
 			See also previewAudioSprite() method in the META section of docs.
+			DO NOT put an audioSprite in a multi-assets object if there is another path defined - we hope to fix for ZIM 019
+				Instead, make the path for the audioSprite be the main path and put the other path in the multi-assets object
 	path - pass in an optional path String that gets prepended to the asset
 		when accessing the asset with the asset() method you do NOT include the path
 		assets with an absolute URL (http[s]://etc.) will ignore path
@@ -88002,6 +88059,7 @@ zim.Frame = function(scaling, width, height, color, outerColor, ready, assets, p
 		// 018 TRYING TO FIX CREATEJS ERROR IF SOUND LOADED AGAIN - BUT BREAKS LAZY LOAD
 		// var emptyAssets = false;
 
+
 		for (i=0; i<assets.length; i++) {			
 			a = assets[i];	
 			// if (zim.assets[a]) {
@@ -88033,7 +88091,13 @@ zim.Frame = function(scaling, width, height, color, outerColor, ready, assets, p
 						fonts.push(aj);
 					} else if (zim.assetIDs[aj]) {
 						assetMulti.push({id:a.path+aj, src:a.path+aj, path:null, loadTimeout:a.loadTimeout, maxNum:a.maxNum, noCORSonImage:a.noCORSonImage});
-					} else {				
+					} else if (aj.audioSprite) {	
+						// ZIM 018 attempted patch for audioSprite not working in multi-assets object
+						// tried passing path but it substitutes it somewhere with the default path - boo
+						// so tried what was used with assetIDs above and it still does it.
+						// assetMulti.push({id:a.path+aj.src, src:a.path+aj.src, path:null, audioSprite:aj.audioSprite, data:aj.data, loadTimeout:a.loadTimeout, maxNum:a.maxNum, noCORSonImage:a.noCORSonImage});
+						assetMulti.push({id:aj.src, src:aj.src, path:aj.path, audioSprite:aj.audioSprite, data:aj.data, loadTimeout:a.loadTimeout, maxNum:a.maxNum, noCORSonImage:a.noCORSonImage});
+					} else {
 						assetMulti.push({id:aj, src:aj, path:a.path, loadTimeout:a.loadTimeout, maxNum:a.maxNum, noCORSonImage:a.noCORSonImage});
 					}
 				}
@@ -88067,7 +88131,7 @@ zim.Frame = function(scaling, width, height, color, outerColor, ready, assets, p
 						replacement.push({id:r[0], startTime:Math.round(r[1]*1000), duration:Math.round((r[2]-r[1])*1000)});
 					}
 					delete(obj.audioSprite); // the ZIM data
-					obj.data = {audioSprite:replacement}; // the CreateJS data
+					obj.data = {audioSprite:replacement}; // the CreateJS data					
 					manifest.push(obj);
 				} else if (a.data && a.data.audioSprite) { // CreateJS AudioSprite
 					obj = zim.copy(a);
@@ -88091,13 +88155,13 @@ zim.Frame = function(scaling, width, height, color, outerColor, ready, assets, p
 							found = url.match(/(.*?)([^/])\/[^/]/);								
 							url = found[1]+found[2];
 							a.src = url+a.path+a.src;
-						} else {
-							var pname = WW.location.pathname;
+						} else {							
+							var pname = WW.location.pathname;							
 							url = WW.location.href;
 							var fileOnly = url.split(pname)[0] + pname;
 							found = fileOnly.match(/(.*)\//);
 							a.path = a.path.replace(/^\.\//,"");
-							var goBack = a.path.match(/\.\.\//g);
+							var goBack = a.path.match(/\.\.\//g);s
 							var pref = found[1];
 							if (goBack) {
 								for (z_i=0; z_i<goBack.length; z_i++) {
@@ -88136,7 +88200,7 @@ zim.Frame = function(scaling, width, height, color, outerColor, ready, assets, p
 							queue.loadAssetsCount--;
 							if (queue.loadAssetsCount == 0) endAssetLoad();
 						}
-					} else {		
+					} else {	
 						zim.assetIDs[a.id] = a.src;
 						var mn = a.maxNum;
 						if (zot(mn)) mn = maxNum;
@@ -88171,7 +88235,7 @@ zim.Frame = function(scaling, width, height, color, outerColor, ready, assets, p
 			if (soundCheck && firstSoundCheck) {
 				// dynamically make audio tag with sound to overcome some Apple devices not playing sounds
 				var audioTag = document.createElement("audio");
-				audioTag.setAttribute("src", ((!zot(path) && !a.match(/^http:\/\/|https:\/\//i))?path:"")+a);
+				audioTag.setAttribute("src", ((!zot(path) && !a.match(/^http:\/\/|https:\/\/|file:\/\//i))?path:"")+a);
 				document.body.appendChild(audioTag);
 				firstSoundCheck = false;
 			}
@@ -91065,33 +91129,38 @@ Note: there are more features to the Web Speech API - see the HTML docs
 			
 			var SpeechRecognition = WW.SpeechRecognition || WW.webkitSpeechRecognition;
 			var SpeechGrammarList = WW.SpeechGrammarList || WW.webkitSpeechGrammarList;
+			
+			var recognition;
+			var SpeechRecognitionEvent = WW.SpeechRecognitionEvent || WW.webkitSpeechRecognitionEvent;    
 			// this is causing an error on firefox even though they use this in their examples 
 			// and we have all the speech about:config setting set to true
-			var SpeechRecognitionEvent = WW.SpeechRecognitionEvent || WW.webkitSpeechRecognitionEvent;    
-			var recognition = this.recognition = new SpeechRecognition();
-			recognition.continuous = false;
-			recognition.lang = this.language = "en-US";
-			recognition.interimResults = true;
-			recognition.maxAlternatives = 1;
-
-			recognition.addEventListener("result", function(e) {
-				var ev = new createjs.Event("result");
-				ev.words = e.results[0][0].transcript;
-				ev.confidence = e.results[0][0].confidence;
-				that.dispatchEvent(ev);
-			});
-			recognition.addEventListener("speechend", function(e) {
-				recognition.stop();
-				that.dispatchEvent(e);
-			});
-			recognition.addEventListener("error", function(e) {
-				that.dispatchEvent(e);
-			});		
+			// so test for existence
+			if (typeof SpeechRecognition != "undefined") {
+				recognition = this.recognition = new SpeechRecognition();
+				recognition.continuous = false;
+				recognition.lang = this.language = "en-US";
+				recognition.interimResults = true;
+				recognition.maxAlternatives = 1;
+
+				recognition.addEventListener("result", function(e) {
+					var ev = new createjs.Event("result");
+					ev.words = e.results[0][0].transcript;
+					ev.confidence = e.results[0][0].confidence;
+					that.dispatchEvent(ev);
+				});
+				recognition.addEventListener("speechend", function(e) {
+					recognition.stop();
+					that.dispatchEvent(e);
+				});
+				recognition.addEventListener("error", function(e) {
+					that.dispatchEvent(e);
+				});		
+			}
 			
 		}
 
 		this.listen = function(interim, language) {
-			if (M=="ios") {zogy("not supported on iOS Web"); return this;}
+			if (M=="ios" || !recognition) {zogy("Speech recognition not supported - search how to activate"); return this;}
 			if (zot(interim)) interim = true;	
 			recognition.interimResults = this.interim = interim;		
 			if (zot(language)) recognition.lang = this.language;			
@@ -91113,7 +91182,10 @@ Note: there are more features to the Web Speech API - see the HTML docs
 			var sig = "text, voice, volume, lang, rate, pitch";
 			var duo; if (duo = zob(this.talk, arguments, sig)) return duo;
 
-			if (typeof speechSynthesis == "undefined") return;
+			if (typeof speechSynthesis == "undefined") {
+				zogy("Speech synthesis not supported - search how to activate");
+				return;
+			}
 			// https://wicg.github.io/speech-api
 			if (zot(text)) return;
 			var utter = new SpeechSynthesisUtterance();
@@ -91140,13 +91212,13 @@ Note: there are more features to the Web Speech API - see the HTML docs
 		}
 
 		this.stopTalking = function() {
-			if (speechSynthesis) speechSynthesis.cancel();
+			if (typeof speechSynthesis != "undefined") speechSynthesis.cancel();
 		}
 		this.pauseTalking = function() {
-			if (speechSynthesis) speechSynthesis.pause();
+			if (typeof speechSynthesis != "undefined") speechSynthesis.pause();
 		}
 		this.resumeTalking = function() {
-			if (speechSynthesis) speechSynthesis.resume();
+			if (typeof speechSynthesis != "undefined") speechSynthesis.resume();
 		}
 
 		this.getVoices = function() {   
@@ -95917,6 +95989,10 @@ https://zimjs.com/015/textureactive_raw.html
 ZIM in VR
 https://zimjs.com/015/vr.html - use triggers (drag), sticks (motion) and b and y buttons (teleport)  
 
+ZIM Central
+Use ZIM in Frame scaling:FULL and ZIM Central() to match ZIM scaling with three.js fullscreen scaling
+https://zimjs.com/three/central.html
+
 Z-Dog is a quick alternative for three.js - here are a couple examples
 https://codepen.io/zimjs/pen/joXxGJ
 https://codepen.io/zimjs/pen/rgEEXy
@@ -95964,6 +96040,32 @@ const dial = new Dial({min:0, max:360, step:0, continuous:true}).pos(70,0,LEFT,C
 });
 END EXAMPLE
 
+EXAMPLE
+// use ZIM Central() to make a threejs-like full scale but centered experience
+new Frame({ready, color:yellow}); // use FULL mode (default)
+function ready() {
+    const three = new Three({
+        width:W, 
+        height:H, 
+        cameraPosition:new THREE.Vector3(-200,200,300),
+        colorManagement:true,
+        interactive:false,
+        full:true, // add full screen three.js
+        lay:OVER // or UNDER - see https://zimjs.com/three/central.html
+    });
+    const geometry = new THREE.BoxGeometry(100,100,100); 
+    const material = new THREE.MeshNormalMaterial();
+    const mesh = new THREE.Mesh(geometry, material);           
+    three.scene.add(mesh); 
+
+    const central = new Central().center();
+
+    new Slider({currentValue:5})
+        .pos(0,200,CENTER,CENTER,central)
+        .wire(mesh.rotation, "y");
+}
+END EXAMPLE
+
 PARAMETERS
 ** supports DUO - parameters or single object with properties below
 width - (default ZIM Frame width) the width to make the three.js canvas