zimjs 18.0.8 → 18.1.0

package/package.json

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

package/src/zim.js

@@ -2239,7 +2239,7 @@ function myFunction(data){
 // in the php file we would use the following to return JSON:
 <?php
 header('Content-type: text/javascript');
-$data = [test=>"wow", score=>[1,2,3]];
+$data = ["test"=>"wow", "score"=>[1,2,3]];
 echo "async.myFunction(".JSON_encode($data).")";
 ?>
 
@@ -11354,7 +11354,7 @@ it will still scale when using the corners.  This can be turned off by setting s
 
 Properties for the slice lines are available and can be set and animated as can the scalesWidth and scalesHeight.
 
-SEE: https://zimjs.com/slices for the ZIM Slices tool and example of SlicedBitmap
+SEE: https://zimjs.com/slicer for the ZIM Slices tool and example of SlicedBitmap
 
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
 
@@ -11804,6 +11804,8 @@ but we found the framerate could not be kept
 with other animations or Ticker events running.
 So we recommend using the ZIM Sprite run() method.
 
+NOTE: when applying an effect to a Sprite, put the sprite in a Container and apply the effect on the container
+
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
 
 EXAMPLE
@@ -22641,13 +22643,12 @@ zim class - extends a zim.Container which extends a createjs.Container
 
 DESCRIPTION
 Makes a label - wraps the createjs Text object.
-Can use with Button, CheckBox, RadioButtons and Pane.
-Text seems to come in different sizes so we do our best.
-Have tended to find that left and alphabetic are most consistent across browsers.
-Custom fonts loaded through css can be used as well.
+Can also use with Button, CheckBox, RadioButtons, Pane, etc.
+System fonts, Google fonts and custom fonts can be used.
+
+NOTE: can wrap text at given width using labelWidth (or lineWidth) parameter.
 
-NOTE: can wrap text at given width using lineWidth (or labelWidth) parameter.
-To dynamically change the width without changing the font size use the labelWidth property.
+NOTE: can make text fit to dimensions by setting both labelWidth and labelHeight parameters.
 
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
 
@@ -22665,6 +22666,16 @@ new Label({
 }).loc(100,100).tap(()=>{zog("tapping");});
 END EXAMPLE
 
+EXAMPLE 
+// using the Google Font gf_ short cut for "Joti+One"
+// and also a custom font (Reuben) that would be in the assets folder
+new Frame(FIT, 1024, 768, ready ["gf_Joti+One", "Reuben.otf"], "assets/");
+function ready() {
+	new Label("Hello", 100, "Joti One").loc(100,100);
+	new Label("Greets", 50, "Reuben").center();
+}
+END EXAMPLE
+
 EXAMPLE
 // with text that wraps at labelWidth
 // can also set this as a property later to dynamically change width of text 
@@ -22675,6 +22686,17 @@ new Label({
 }).center();
 END EXAMPLE
 
+EXAMPLE
+// with text that fits into labelWidth and labelHeight
+// will change font size.
+new Label({
+	text:"Fit this text into the width and height",
+	labelWidth:300,
+	labelHeight:150,
+	align:CENTER
+}).center().outline();
+END EXAMPLE
+
 EXAMPLE
 STYLE = {font:"courier"};
 new Label("Hi Courier").center(); // will be courier not arial
@@ -27546,6 +27568,7 @@ Adds a window for alerts, etc.
 You need to call the pane.show() to show the pane and pane.hide() to hide it.
 You do not need to add it to the stage - it adds itself centered.
 You can change the x and y (the origin and registration point are in the middle).
+Content is added to the pane with the content parameter or the add() method.
 
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
 
@@ -28157,7 +28180,8 @@ zim class - extends a zim.Container which extends a createjs.Container
 
 DESCRIPTION
 A simple panel with titleBar and optional arrow for more panels.
-Panel can be set draggable and can have a collapse button and a close button
+Panel can be set draggable and can have a collapse button and a close button.
+Content is added to the panel with the content parameter or the add() method.
 See: https://zimjs.com/explore/panel.html
 
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
@@ -28694,6 +28718,8 @@ zim class - extends a zim.Container which extends a createjs.Container
 
 DESCRIPTION
 Adds a window for content that can be swiped and scrolled.
+Content is added to the Window with the content parameter or the add() method.
+
 NOTE: if zim namespace zns = true then this overwrites a JS Window - so the JS Window is stored as document.Window
 
 NOTE: set the enable property to false if animating the position of the whole Window
@@ -48724,7 +48750,6 @@ shadowColor - (default null) the shadow color (css color) of a drop shadow
 shadowBlur - (default null) pixels of how blurred the shadow is if the shadow is set - eg. 10
 dashed - (default true) set to false to turn off the dashed for the border
 id - (default null) a string id for the HTML textarea tag for CSS styling, etc.
-placeholder - (default null) a string that is used for the HTML textarea tag placeholder parameter
 readOnly - (default false) set to true to make TextArea read only (still selectable)
 spellCheck - (default true) set to false to turn Browser spell check off
 password - (default false) set to true to turn the field into a password field - single line only (uses input field type=password and not TextArea)
@@ -55506,6 +55531,8 @@ Keep the quality at 1 for animating filters at a decent framerate.
 Consider pre-processing images if effects do not have to be dynamic.
 
 NOTE: when applying effects to rtl fonts make sure the DIR = "rtl" is set.
+
+NOTE: when applying an effect to a Sprite, put the sprite in a Container and apply the effect on the container
 	
 EXAMPLE
 // create a Label with a GlowEffect that shows through to the image below
@@ -56591,7 +56618,7 @@ RETURNS an index Number (or undefined) | col | row | an Array of [index, col, ro
 // SUBSECTION ANIMATE, WIGGLE, LOOP
 
 /*--
-obj.animate = function(props, time, ease, call, params, wait, waitedCall, waitedParams, loop, loopCount, loopWait, loopCall, loopParams, loopWaitCall, loopWaitParams, loopPick, rewind, rewindWait, rewindCall, rewindParams, rewindWaitCall, rewindWaitParams, rewindTime, rewindEase, startCall, startParams, animateCall, animateParams, sequence, sequenceCall, sequenceParams, sequenceReverse, sequenceRatio, ticker, cjsProps, css, protect, override, from, set, id, events, sequenceTarget, dynamic, drag, clamp, startPaused, clean, obj, seriesWait, sequenceWait, rate, pauseOnBlur, easeAmount, easeFrequency, timeUnit, timeCheck, noAnimateCall, pathDamp)
+obj.animate = function(props, time, ease, call, params, wait, waitedCall, waitedParams, loop, loopCount, loopWait, loopCall, loopParams, loopWaitCall, loopWaitParams, loopPick, rewind, rewindWait, rewindCall, rewindParams, rewindWaitCall, rewindWaitParams, rewindTime, rewindEase, startCall, startParams, animateCall, animateParams, sequence, sequenceCall, sequenceParams, sequenceReverse, sequenceRatio, ticker, cjsProps, css, protect, override, from, set, id, events, sequenceTarget, dynamic, drag, clamp, startPaused, clean, obj, seriesWait, sequenceWait, rate, pauseOnBlur, easeAmount, easeFrequency, timeUnit, timeCheck, noAnimateCall, pathDamp, rewindPick)
 
 animate
 zim DisplayObject method
@@ -56807,6 +56834,18 @@ const line = new Squiggle().center();
 new Circle(10, red).addTo().animate({path:line}, 1);
 END EXAMPLE
 
+EXAMPLE
+// animate across colors
+const colors = series("#f0f","#0f0","#00f","#f00","#ff0").mix();
+new Rectangle(W,H,colors)
+	.addTo()
+	.animate({
+		props:{color:colors},
+		loopPick:true,
+		rewindPick:true
+	});
+END EXAMPLE
+
 PARAMETERS
 ** supports DUO - parameters or single object with properties below
 ** supports VEE - parameters marked with ZIM VEE mean a zim Pick() object or Pick Literal can be passed
@@ -56954,6 +56993,7 @@ call - (default null) the function to call when the animation is done
 params - (default target) a single parameter for the call function (eg. use object literal or array)
 wait - |ZIM VEE| (default 0) seconds to wait before doing animation
 	can be negative for series to start animation before previous animation ends
+	also see the waiting property
 waitedCall - (default null) calls function after wait is done if there is a wait
 waitedParams - (default target) parameters to send waitedCall function
 loop - (default false) set to true to loop animation
@@ -56976,7 +57016,6 @@ rewindEase - (default null) overwrite the ease for the rewind direction
 	so setting rewindEase:"bounceOut" will bounce back at the start of the animation
 	note - setting ease:"bounceOut" will bounce at the end of the animation
 	this allows for a normal start with a bounce and then a normal start at rewind and a bounce
-
 startCall - (default null) calls function at the start of actual animation and after any wait (and waitedCall)
 	this is basically the same as the waitedCall but will also be called at the start of animation when there is no waitedCall
 startParams - (default target) parameters to send startCall function
@@ -57098,6 +57137,12 @@ timeUnit - (default TIME) override the TIME setting to "seconds" / "s" or "milli
 timeCheck - (default true) set to false to not have animate() warn of potentially wrong time units - see also TIMECHECK
 noAnimateCall - (default true) set to false to not call the callback function if ANIMATE is set to false
 pathDamp - (default .15) damping for drag along path
+rewindPick - (default false) set to true to pick from props as it rewinds
+	this will be moved to the other rewind parameters in ZIM 019 
+	also see loopPick - using both loopPick and rewindPick will act like a series
+	where if the property has a series it will animate one after the other 
+	do not use if the property is just a regular value as it will appear to stop the animation.
+	Can use a series, results of a function, min max or array for random picks
 
 PROPERTIES - zim.animate() adds the following properties to any object it animates:
 	animating - read-only - true when animating (including when waiting) 
@@ -57168,8 +57213,8 @@ EVENTS - zim animate() will add an "animation" event to the target IF the events
 
 RETURNS the target for chaining (or null if no target is provided and run on zim with series)
 --*///+45
-	zim.animate = function(target, props, time, ease, call, params, wait, waitedCall, waitedParams, loop, loopCount, loopWait, loopCall, loopParams, loopWaitCall, loopWaitParams, loopPick, rewind, rewindWait, rewindCall, rewindParams, rewindWaitCall, rewindWaitParams, rewindTime, rewindEase, startCall, startParams, animateCall, animateParams, sequence, sequenceCall, sequenceParams, sequenceReverse, sequenceRatio, ticker, cjsProps, css, protect, override, from, set, id, events, sequenceTarget, dynamic, drag, clamp, startPaused, clean, obj, seriesWait, sequenceWait, rate, pauseOnBlur, easeAmount, easeFrequency, timeUnit, timeCheck, noAnimateCall, pathDamp) {
-		var sig = "target, props, time, ease, call, params, wait, waitedCall, waitedParams, loop, loopCount, loopWait, loopCall, loopParams, loopWaitCall, loopWaitParams, loopPick, rewind, rewindWait, rewindCall, rewindParams, rewindWaitCall, rewindWaitParams, rewindTime, rewindEase, startCall, startParams, animateCall, animateParams, sequence, sequenceCall, sequenceParams, sequenceReverse, sequenceRatio, ticker, cjsProps, css, protect, override, from, set, id, events, sequenceTarget, dynamic, drag, clamp, startPaused, clean, obj, seriesWait, sequenceWait, rate, pauseOnBlur, easeAmount, easeFrequency, timeUnit, timeCheck, noAnimateCall, pathDamp";
+	zim.animate = function(target, props, time, ease, call, params, wait, waitedCall, waitedParams, loop, loopCount, loopWait, loopCall, loopParams, loopWaitCall, loopWaitParams, loopPick, rewind, rewindWait, rewindCall, rewindParams, rewindWaitCall, rewindWaitParams, rewindTime, rewindEase, startCall, startParams, animateCall, animateParams, sequence, sequenceCall, sequenceParams, sequenceReverse, sequenceRatio, ticker, cjsProps, css, protect, override, from, set, id, events, sequenceTarget, dynamic, drag, clamp, startPaused, clean, obj, seriesWait, sequenceWait, rate, pauseOnBlur, easeAmount, easeFrequency, timeUnit, timeCheck, noAnimateCall, pathDamp, rewindPick) {
+		var sig = "target, props, time, ease, call, params, wait, waitedCall, waitedParams, loop, loopCount, loopWait, loopCall, loopParams, loopWaitCall, loopWaitParams, loopPick, rewind, rewindWait, rewindCall, rewindParams, rewindWaitCall, rewindWaitParams, rewindTime, rewindEase, startCall, startParams, animateCall, animateParams, sequence, sequenceCall, sequenceParams, sequenceReverse, sequenceRatio, ticker, cjsProps, css, protect, override, from, set, id, events, sequenceTarget, dynamic, drag, clamp, startPaused, clean, obj, seriesWait, sequenceWait, rate, pauseOnBlur, easeAmount, easeFrequency, timeUnit, timeCheck, noAnimateCall, pathDamp, rewindPick";
 
 		if (target && (target.props || target.obj)) {
 			var duo; if (duo = zob(zim.animate, arguments, sig)) return duo;
@@ -57190,8 +57235,8 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 		// last param is noWarning - sent internal as false by wiggle for instance
 		var timeType = getTIME(null, timeUnit, null, null, zot(timeCheck)?false:!timeCheck);
 
-		if (loopCount || loopCall || loopWait) loop = true;
-		if (rewindTime || rewindCall || rewindTime || rewindEase || rewindWait) rewind = true;
+		if (loopCall || loopWait || loopPick || loopCount) loop = true;
+		if (rewindCall || rewindWait || rewindPick || rewindTime || rewindEase) rewind = true;
 
 		var i, prop, currentCount;
 		var startArguments = arguments;
@@ -57341,7 +57386,6 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 			sequenceTarget.animating = true;
 		}
 		function sequenceDone() {
-			sequenceTarget.animating = false;
 			if (call) call(params||sequenceTarget);
 		}
 
@@ -57389,7 +57433,7 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 				if (i==0 && sequence!=0) seqTime = timeType=="s"?.02:20; // patched in 10.7.0 and 10.7.1
 								
 				// zim.animate(tar, tar.zimObj, time, ease, (i==target.length-1?call:null), (i==target.length-1?params:null)
-				zim.animate(tar, tar.zimObj, time, ease, (i==target.length-1?sequenceDone:null), null, wait, waitedCall, waitedParams, null, null, null, null, null, null, null, loopPick, null, null, null, null, null, null, rewindTime, rewindEase, startCall, startParams, animateCall, animateParams, null, sequenceCall, sequenceParams, null, null, ticker, zim.copy(cjsProps), css, protect, override, null, set, id, events, sequenceTarget, dynamic, drag, clamp, startPaused, clean, obj, seriesWait, seqTime, rrr, pauseOnBlur, easeAmount, easeFrequency, timeUnit, timeCheck, noAnimateCall, pathDamp); // do not send from!
+				zim.animate(tar, tar.zimObj, time, ease, (i==target.length-1?sequenceDone:null), null, wait, waitedCall, waitedParams, null, null, null, null, null, null, null, loopPick, null, null, null, null, null, null, rewindTime, rewindEase, startCall, startParams, animateCall, animateParams, null, sequenceCall, sequenceParams, null, null, ticker, zim.copy(cjsProps), css, protect, override, null, set, id, events, sequenceTarget, dynamic, drag, clamp, startPaused, clean, obj, seriesWait, seqTime, rrr, pauseOnBlur, easeAmount, easeFrequency, timeUnit, timeCheck, noAnimateCall, pathDamp, rewindPick); // do not send from!
 	
 			}
 			return sequenceTarget;
@@ -57737,7 +57781,7 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 			}
 		}
 
-		props, time, ease, call, params, wait, waitedCall, waitedParams, loop, loopCount, loopWait, loopCall, loopParams, loopWaitCall, loopWaitParams, loopPick, rewind, rewindWait, rewindCall, rewindParams, rewindWaitCall, rewindWaitParams, rewindTime, rewindEase, startCall, startParams, animateCall, animateParams, sequence, sequenceCall, sequenceParams, sequenceReverse, sequenceRatio, ticker, cjsProps, css, protect, override, from, set, id, events, sequenceTarget, dynamic, drag, clamp, startPaused, clean, obj, seriesWait, sequenceWait, rate, pauseOnBlur, easeAmount, easeFrequency, timeUnit, timeCheck, noAnimateCall, pathDamp
+		// props, time, ease, call, params, wait, waitedCall, waitedParams, loop, loopCount, loopWait, loopCall, loopParams, loopWaitCall, loopWaitParams, loopPick, rewind, rewindWait, rewindCall, rewindParams, rewindWaitCall, rewindWaitParams, rewindTime, rewindEase, startCall, startParams, animateCall, animateParams, sequence, sequenceCall, sequenceParams, sequenceReverse, sequenceRatio, ticker, cjsProps, css, protect, override, from, set, id, events, sequenceTarget, dynamic, drag, clamp, startPaused, clean, obj, seriesWait, sequenceWait, rate, pauseOnBlur, easeAmount, easeFrequency, timeUnit, timeCheck, noAnimateCall, pathDamp, rewindPick
 
 
 		// -----------------------------
@@ -57747,7 +57791,6 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 		if (!target.tweenStates) target.tweenStates = {all:true};	
 
 		var fromCheck = false;
-
 									
 		// Handle notes
 		if (obj.note) {
@@ -58691,7 +58734,7 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 			sequenceWait:sequenceWait
 		}
 
-		function doLoopCall() {
+		function doLoopCall() {			
 			if (wait3>0) target.waiting = false;
 			if (!cjsProps.loop) return; // added Cat 03 - was being called even if not looping
 			if (sequenceCall && typeof sequenceCall == 'function') {				
@@ -58718,12 +58761,24 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 					adjustedScale = zim.Pick.choose(savedPicks.scale, null, target);
 				}
 
+			
+
 				if (!from) {
+
 					if (tween.step && tween.step.prev && tween.step.prev.props) {
 						for (var i in tween.step.prev.props) {
 							if (extraTypes.indexOf(i) >= 0) continue; // skip for extras
 							var p = zim.Pick.choose(savedPicks[i], null, target);
 
+							// handle color at loop - ZIM 018
+							if (i=="colorRange") i = "color"
+							var p = zim.Pick.choose(savedPicks[i], null, target);
+							if (i=="color") i = "colorRange";
+							if (target.setColorRange && i=="colorRange") {
+								target.setColorRange(target.color, p);
+								continue;
+							}
+
 							// also handle relative
 							if (typeof p == "string" && i != "transform") {
 								if (p.substr(0,1) != "+" && p.substr(0,1) != "-") {
@@ -58738,7 +58793,7 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 
 							// ZIM ZIM 02 patch to make non-rewind work with loopPick
 							// the difference seems to be using tween.step.prev for rewind and tween.step for non-rewind
-							// we had tween.step.prev for both since the beggining - we must not have tested on a non-rewind
+							// we had tween.step.prev for both since the begining - we must not have tested on a non-rewind
 							if (rewind) {
 								if (!zot(savedPicks[i])) tween.step.prev.props[i] = p;
 								if (i=="scaleX" && !zot(adjustedScale)) tween.step.prev.props.scaleX = adjustedScale;
@@ -58793,7 +58848,7 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 			params6 = cjsProps.startParams;
 			delete cjsProps.startParams;
 		}
-		function doStartCall(tween) {
+		function doStartCall(tween) {				
 			if (tween.startCalled) return;
 			tween.startCalled = true;
 			if (call6 && typeof call6 == 'function') {(call6)(params6||target);}
@@ -58935,11 +58990,65 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 
 		// REWIND TWEENS
 		
-		function doRewindCall() {
+		function doRewindCall() {	
+			// ADDED in ZIM 018
+
+			if (!from && rewindPick) {
+
+				var adjustedScale;
+				if (!zot(savedPicks.scale)) {
+					adjustedScale = zim.Pick.choose(savedPicks.scale, null, target);
+				}
+
+				if (tween.step && tween.step.props) {
+					for (var i in tween.step.props) {
+						if (extraTypes.indexOf(i) >= 0) continue; // skip for extras
+
+						// handle color at rewind - ZIM 018
+						if (i=="colorRange") i = "color"
+						var p = zim.Pick.choose(savedPicks[i], null, target);
+						if (i=="color") i = "colorRange";
+						if (target.setColorRange && i=="colorRange") {
+							target.setColorRange(p, target.color);
+							continue;
+						}
+
+						// also handle relative
+						if (typeof p == "string" && i != "transform") {
+							if (p.substr(0,1) != "+" && p.substr(0,1) != "-") {
+								var newStart;
+								if (target.zimLastObj && !zot(target.zimLastObj[i])) newStart = target.zimLastObj[i];
+								else newStart = target[i];
+								p = newStart + Number(p.replace(/\s/g,""));
+							}
+						}
+						// end handle relative
+						
+						// target.zimLastObj[i] = rewind?target.zimTweenOriginals[i]:p;
+						target.zimLastObj[i] = p;
+								
+						if (!zot(savedPicks[i])) {
+							tween.step.props[i] = p; // sets the rewind property
+							tween._stepHead.props[i] = p; // sets the start of a loop to end of rewind
+						}
+						if (i=="scaleX" && !zot(adjustedScale)) {
+							tween.step.props.scaleX = adjustedScale;
+							tween._stepHead.props.scaleX = adjustedScale;
+						}
+						if (i=="scaleY" && !zot(adjustedScale)) {
+							tween.step.props.scaleY = adjustedScale;
+							tween._stepHead.props.scaleY = adjustedScale;
+						}
+						
+					}
+				}
+			}		
+			// END ADDED in ZIM 018				
+			
 			if (wait2>0) target.waiting = false;
 			if (call2 && typeof call2 == 'function') {(call2)(params2);}
 		}
-		function doRewindWaitCall() {
+		function doRewindWaitCall() {				
 			if (wait2>0) target.waiting = true;
 			if (call5 && typeof call5 == 'function') {(call5)(params5);}
 		}
@@ -58963,23 +59072,28 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 		}
 		
 		var startTest = false;
-		var obj2;
+		var obj2;	
+
 		function tween1(lastTween) {	
 			if (!startTest)	{
-				obj2 = getStart();	
-				startTest = true;
-			}		
-			if (target.set && !from) target.set(set);				
+				obj2 = getStart();				
+				startTest = true;				
+			} 
+			
+			if (target.set && !from) target.set(set);	
 			tween = target.zimTweens[id] =  target.zimTween = createjs.Tween.get(target, cjsProps)
-				.call(doStartCall)	
+				.call(doStartCall)				
 				.to(obj, t, finalEase)				
 				.call(doRewindWaitCall)
 				.wait(wait2, true)
 				.call(doRewindCall)
-				.to(obj2, t2, finalEase2)
+				// this is hard coded... need to inject a different obj2 into createjs tween
+				// and activate the code in doStartCall that makes loop start at end of new rewind
+				.to(obj2, t2, finalEase2) 
 				.call(doneAnimating)
 				.wait(wait3, true)
 				.call(doLoopCall);
+				
 			tween.timeScale = target.futureRate;
 			if (lastTween) transferIds(lastTween, tween);
 			setZimTweenProps();
@@ -59416,20 +59530,20 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 				return;
 			}
 			if (cjsProps.loop) {
-				if (count > 0) {
+				if (count > 0) {					
 					if (currentCount < count) {
 						if (wait3>0) target.waiting = true;
 						doLoopWaitCall();
 						currentCount++;
 						return;
 					} else {
-						if (rewind) {
+						if (rewind) {							
 							if (target.set) target.set(startObj);							
 						} else {							
 							if (target.set) target.set(obj);
 						}
 					}
-				} else {									
+				} else {							
 					if (wait3>0) target.waiting = true;
 					doLoopWaitCall();
 					return;
@@ -62390,7 +62504,7 @@ zim global variable
 
 DESCRIPTION
 
-WARNING - currently, this does not work - see seedRandom() in CODE module.
+WARNING - currently, this does not work - instead, see seedRandom() in CODE module.
 
 If set, the ZIM rand() function will be seeded with its value.
 This means that rand() will repeat in order its random results.
@@ -62438,7 +62552,7 @@ zim global variable
 
 DESCRIPTION
 
-WARNING - currently, this does not work - see seedRandom() in CODE module.
+WARNING - currently, this does not work - instead, see seedRandom() in CODE module.
 but there is no equivilant to SEEDRANDOMCOUNT yet - we are working on it.
 
 The current order number used for rand() if SEEDRAND is set or the rand() seedRand parameter is set
@@ -70157,11 +70271,11 @@ color2 - (default null) a second color which would form a zim.GradientColor() as
 angle - (default 90) the angle for the gradient if there is a gradient
 borderColor - (default null) the stroke color
 borderWidth - (default 1 if stroke is set) the size of the stroke in pixels
-corner - (default 0) the round of corner
-   can also be an array of [topLeft, topRight, bottomRight, bottomLeft]
-   inside this array can be arrays of [horizontal, vertical] which skews each corner
-   can also be a combination array of values and skew arrays
-   [topLeft, [horizontal, vertical], bottomRight, [horizontal, vertical]]
+corner - (default 10) the round of corner
+	can also be an array of [topLeft, topRight, bottomRight, bottomLeft]
+	inside this array can be arrays of [horizontal, vertical] which skews each corner
+	can also be a combination array of values and skew arrays
+	[topLeft, [horizontal, vertical], bottomRight, [horizontal, vertical]]
 interactive - (default true) set to false to not be interactive 
 	interactive will use raycasting in the TextureActives object 
 	to provide x and y to CreateJS which is then used by ZIM
@@ -70175,8 +70289,8 @@ pattern - (default null) a DisplayObject that will be added to the TextureActive
 scalePattern - (default "fill") scale the pattern so it fills the window (formerly "bigger" or "outside")
 	set to false for no scaling or:
 	FIT or "fit" fits inside the TextureActive keeping proportion (formerly "smallest")
-   	FILL or "fill" fills the TextureActive keeping proportion (formerly "biggest" or "outside")
-   	FULL or "full" keeps both x and y scales - may stretch object (formerly "both")
+	FILL or "fill" fills the TextureActive keeping proportion (formerly "biggest" or "outside")
+	FULL or "full" keeps both x and y scales - may stretch object (formerly "both")
 style - (default true) set to false to ignore styles set with the STYLE - will receive original parameter defaults
 group - (default null) set to String (or comma delimited String) so STYLE can set default styles to the group(s) (like a CSS class)
 inherit - (default null) used internally but can receive an {} of styles directly
@@ -75276,29 +75390,31 @@ SEE: https://zimjs.com/portal/
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
 
 EXAMPLE
-F.loadAssets(["researchbuilding.jpg", "jungle.jpg"]);
+F.loadAssets(["ai_future03.jpg", "ai_alienplanet01.jpg"], "https://zimjs.org/assets/");
 F.on("complete", ()=>{
+
 	const lands = new Container(W, H).addTo();
-	const jungle = new Pic("jungle.jpg")
+	const planet = new Pic("ai_alienplanet01.jpg")
 		.scaleTo(lands)
 		.center(lands);
-	const researchBuilding = new Pic("researchbuilding.jpg")
+	const future = new Pic("ai_future03.jpg")
 		.scaleTo(lands)
 		.center(lands);
+		
 	const portalObject = new Circle(118, faint, pink, 16, true)
-		.addTo(stage)
-		.pos(580, 470)
+		.center()
+		.mov(0,90)
 		.animate({obj:{rotation:"360"}, time:70, ease:"linear", loop:true});
+
 	const portal = new Portal(portalObject, lands);
-	portal.on("enter", function() {
+	portal.on("enter", ()=>{
 		// play a sound here!
 	});
 
 	// use enabled to turn on and off portal
-	timeout(1, ()=>{portal.enabled = false; portalObject.pauseAnimate(true);});
-	timeout(5, ()=>{portal.enabled = true; portalObject.pauseAnimate(false);});
+	// timeout(1, ()=>{portal.enabled = false; portalObject.pauseAnimate(true);});
+	// timeout(5, ()=>{portal.enabled = true; portalObject.pauseAnimate(false);});
 
-	S.update();
 }); // assets loaded
 END EXAMPLE
 
@@ -76488,6 +76604,8 @@ to make accessing filters easy - but apps will slow down if they are over-used.
 Keep the quality at 1 for animating filters at a decent framerate.
 Consider pre-processing images if effects do not have to be dynamic.
 
+NOTE: when applying an effect to a Sprite, put the sprite in a Container and apply the effect on the container
+
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
 
 EXAMPLE
@@ -76611,6 +76729,8 @@ to make accessing filters easy - but apps will slow down if they are over-used.
 Keep the quality at 1 for animating filters at a decent framerate.
 Consider pre-processing images if effects do not have to be dynamic.
 
+NOTE: when applying an effect to a Sprite, put the sprite in a Container and apply the effect on the container
+
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
 
 EXAMPLE
@@ -76857,6 +76977,8 @@ to make accessing filters easy - but apps will slow down if they are over-used.
 Keep the quality at 1 for animating filters at a decent framerate.
 Consider pre-processing images if effects do not have to be dynamic.
 
+NOTE: when applying an effect to a Sprite, put the sprite in a Container and apply the effect on the container
+
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
 
 EXAMPLE
@@ -77161,6 +77283,8 @@ to make accessing filters easy - but apps will slow down if they are over-used.
 Keep the quality at 1 for animating filters at a decent framerate.
 Consider pre-processing images if effects do not have to be dynamic.
 
+NOTE: when applying an effect to a Sprite, put the sprite in a Container and apply the effect on the container
+
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
 
 EXAMPLE
@@ -77351,6 +77475,8 @@ to make accessing filters easy - but apps will slow down if they are over-used.
 Keep the quality at 1 for animating filters at a decent framerate.
 Consider pre-processing images if effects do not have to be dynamic.
 
+NOTE: when applying an effect to a Sprite, put the sprite in a Container and apply the effect on the container
+
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
 
 EXAMPLE
@@ -77483,6 +77609,8 @@ to make accessing filters easy - but apps will slow down if they are over-used.
 Keep the quality at 1 for animating filters at a decent framerate.
 Consider pre-processing images if effects do not have to be dynamic.
 
+NOTE: when applying an effect to a Sprite, put the sprite in a Container and apply the effect on the container
+
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
 
 EXAMPLE
@@ -77665,6 +77793,8 @@ to make accessing filters easy - but apps will slow down if they are over-used.
 Keep the quality at 1 for animating filters at a decent framerate.
 Consider pre-processing images if effects do not have to be dynamic.
 
+NOTE: when applying an effect to a Sprite, put the sprite in a Container and apply the effect on the container
+
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
 
 EXAMPLE
@@ -80746,7 +80876,7 @@ layers - (default TOP) where to place the current particle being emitted - value
 animation - |ZIM VEE| (default null) a zim animate config object to apply to the particle
 	This is the whole zim DUO object to pass to animate - including a props parameter that holds the animation object
 	To pass in two or more animations on the same particle then use {noPick:[{animation1}, {animation2}, {etc.}]}
-random - (default null) an object holding properties to animate, each property holding a ZIM VEE Value object for Pick.choose() to pick from per particle
+random - (default null) an object holding properties to set, each property holding a ZIM VEE Value object for Pick.choose() to pick from per particle
 	eg: {color:[red, white, green], scale:{min:1, max:2}} // scale is a convienence property for both scaleX and scaleY
 horizontal - (default false) start the particles across the emitter's width at the top of the emitter (unless vertical is set to true)
 vertical - (default false) start the particles across the emitter's height at the left of the emitter (unless horizontal is set to true)
@@ -89929,36 +90059,36 @@ END EXAMPLE
 EXAMPLE 
 // getting a preview 
 const video = new Vid("video.mp4")
-    .scaleTo()
-    .center()
-    .vis(false);    
+	.scaleTo()
+	.center()
+	.vis(false);    
 
 new Pane("WELCOME").show(init);
 
 function init() {  
-    video.play().pause().vis(true);
+	video.play().pause().vis(true);
 	// note, to play after this use video.pause(false); // not video.play()
-    Ticker.always();
+	Ticker.always();
 }
 END EXAMPLE 
 
 EXAMPLE 
 // getting a keyed out preview 
 const video = new Vid("video.mp4")
-    .scaleTo()
-    .center()
-    .vis(false);    
+	.scaleTo()
+	.center()
+	.vis(false);    
 
 new Pane("WELCOME").show(init);
 
 function init() {  
-    video
-        .keyOut("#01b03f", .25) // key out the green
-        .play();            
-    timeout(.05, ()=>{
-        video.pause().vis(true);
-    });       
-    Ticker.always();
+	video
+		.keyOut("#01b03f", .25) // key out the green
+		.play();
+	timeout(.05, ()=>{
+		video.pause().vis(true);
+	});
+	Ticker.always();
 }
 END EXAMPLE 
 
@@ -90141,9 +90271,9 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
                     var replacement = that.keyObj.replacement;
                     that.ticker = zim.Ticker.add(function(){
                         bitmap.keyOut(color, tolerance, replacement);
-                    });
+                    }, that.stage);
                 } else {
-                    that.ticker = zim.Ticker.add(function(){});
+                    that.ticker = zim.Ticker.add(function(){}, that.stage);
                 }
             }         
             return that;   
@@ -91079,7 +91209,7 @@ function init(yes) {
 END EXAMPLE
 
 EXAMPLE
-// for shaking motion - ALSO see the PermissionAsk example above for iOS
+// for shaking motion - ALSO see the PermissionAsk example above
 // and replace "deviceorientation" with "devicemotion" 
 // and replace e.rotation.x, etc. with e.acceleration.x etc.
 // also set Frame sensors parameter to true
@@ -92349,7 +92479,7 @@ function zimify(obj, a, b, c, d, list) {
 		hitTestGrid:function(width, height, cols, rows, x, y, offsetX, offsetY, spacingX, spacingY, local, type) {
 			return zim.hitTestGrid(this, width, height, cols, rows, x, y, offsetX, offsetY, spacingX, spacingY, local, type);
 		},
-		animate:function(props, time, ease, call, params, wait, waitedCall, waitedParams, loop, loopCount, loopWait, loopCall, loopParams, loopWaitCall, loopWaitParams, loopPick, rewind, rewindWait, rewindCall, rewindParams, rewindWaitCall, rewindWaitParams, rewindTime, rewindEase, startCall, startParams, animateCall, animateParams, sequence, sequenceCall, sequenceParams, sequenceReverse, sequenceRatio, ticker, cjsProps, css, protect, override, from, set, id, events, sequenceTarget, dynamic, drag, clamp, startPaused, clean, obj, seriesWait, sequenceWait, rate, pauseOnBlur, easeAmount, easeFrequency, timeUnit, timeCheck, noAnimateCall, pathDamp) {
+		animate:function(props, time, ease, call, params, wait, waitedCall, waitedParams, loop, loopCount, loopWait, loopCall, loopParams, loopWaitCall, loopWaitParams, loopPick, rewind, rewindWait, rewindCall, rewindParams, rewindWaitCall, rewindWaitParams, rewindTime, rewindEase, startCall, startParams, animateCall, animateParams, sequence, sequenceCall, sequenceParams, sequenceReverse, sequenceRatio, ticker, cjsProps, css, protect, override, from, set, id, events, sequenceTarget, dynamic, drag, clamp, startPaused, clean, obj, seriesWait, sequenceWait, rate, pauseOnBlur, easeAmount, easeFrequency, timeUnit, timeCheck, noAnimateCall, pathDamp, rewindPick) {
 			if (props && (props.props || props.obj) && isDUO(arguments)) {
 				// run this if duo but only if props object has a props or obj object
 				// can you believe that sentence makes sense
@@ -92358,7 +92488,7 @@ function zimify(obj, a, b, c, d, list) {
 				// it can only be a configuration object if there is a props or obj property
 				arguments[0].target = this; return zim.animate(arguments[0]);
 			}
-			else {return zim.animate(this, props, time, ease, call, params, wait, waitedCall, waitedParams, loop, loopCount, loopWait, loopCall, loopParams, loopWaitCall, loopWaitParams, loopPick, rewind, rewindWait, rewindCall, rewindParams, rewindWaitCall, rewindWaitParams, rewindTime, rewindEase, startCall, startParams, animateCall, animateParams, sequence, sequenceCall, sequenceParams, sequenceReverse, sequenceRatio, ticker, cjsProps, css, protect, override, from, set, id, events, sequenceTarget, dynamic, drag, clamp, startPaused, clean, obj, seriesWait, sequenceWait, rate, pauseOnBlur, easeAmount, easeFrequency, timeUnit, timeCheck, noAnimateCall, pathDamp);}
+			else {return zim.animate(this, props, time, ease, call, params, wait, waitedCall, waitedParams, loop, loopCount, loopWait, loopCall, loopParams, loopWaitCall, loopWaitParams, loopPick, rewind, rewindWait, rewindCall, rewindParams, rewindWaitCall, rewindWaitParams, rewindTime, rewindEase, startCall, startParams, animateCall, animateParams, sequence, sequenceCall, sequenceParams, sequenceReverse, sequenceRatio, ticker, cjsProps, css, protect, override, from, set, id, events, sequenceTarget, dynamic, drag, clamp, startPaused, clean, obj, seriesWait, sequenceWait, rate, pauseOnBlur, easeAmount, easeFrequency, timeUnit, timeCheck, noAnimateCall, pathDamp, rewindPick);}
 		},
 		pauseAnimate:function(){return this;},
 		stopAnimate:function(){return this;},
@@ -92742,39 +92872,63 @@ EXAMPLE
 	const data = {size:10, season:"summer"};
 	// addWires returns the object data - which will now have the wired method
 	// now, when the slider or tabs change the data object will be updated
-	// note: we want the slider to be set to the object's start value so set the setSource to "target"
+	// note: we want the slider to be set to the object's start value so set the setSource to true
 	// note: we want the text of the tabs not the default index so need to provide input property
-	addWires(data).wired(slider, "size", null, "target").wired({source:tabs, prop:"season", input:"text"});
+	addWires(data).wired(slider, "size", null, true).wired({source:tabs, prop:"season", input:"text"});
+	S.on("stagemouseup", ()=>{zog(data);});
 END EXAMPLE
 
 PARAMETERS
 obj - the object to receive the wire and wired methods
 
-RETURNS - obj for chainging
+RETURNS - obj for chaining
 --*///+83.365
 zim.addWires = function(obj) {
-	if (isDUO(arguments)) {arguments[0].obj = this; return zim.addWires(arguments[0]);}
+	// if (isDUO(arguments)) {arguments[0].obj = this; return zim.addWires(arguments[0]);}
 	z_d("83.365");
 	obj.wire = function() {
+		if (isDUO(arguments)) {arguments[0].obj = this; return zim.wire(arguments[0]);}
 		Array.prototype.unshift.call(arguments, obj);
 		zim.wire.apply(null, arguments);
 		return obj;
 	};
 	obj.noWire = function() {
+		if (isDUO(arguments)) {arguments[0].obj = this; return zim.noWire(arguments[0]);}
 		Array.prototype.unshift.call(arguments, obj);
 		zim.noWire.apply(null, arguments);
 		return obj;
 	};
 	obj.wired = function() {
+		if (isDUO(arguments)) {arguments[0].obj = this; return zim.wired(arguments[0]);}
 		Array.prototype.unshift.call(arguments, obj);
 		zim.wired.apply(null, arguments);
 		return obj;
 	};
 	obj.noWired = function() {
+		if (isDUO(arguments)) {arguments[0].obj = this; return zim.noWired(arguments[0]);}
 		Array.prototype.unshift.call(arguments, obj);
 		zim.noWired.apply(null, arguments);
 		return obj;
 	};
+
+
+	// wire:function(target, prop, twoWay, setSource, filter, call, input) {
+	// 		if (isDUO(arguments)) {arguments[0].obj = this; return zim.wire(arguments[0]);}
+	// 		else {return zim.wire(this, target, prop, twoWay, setSource, filter, call, input);}
+	// 	},
+	// 	noWire:function(target, prop, input) {
+	// 		if (isDUO(arguments)) {arguments[0].obj = this; return zim.noWire(arguments[0]);}
+	// 		else {return zim.noWire(this, target, prop, input);}
+	// 	},
+	// 	wired:function(source, prop, twoWay, setSource, filter, call, input) {	
+	// 		if (isDUO(arguments)) {arguments[0].obj = this; return zim.wired(arguments[0]);}
+	// 		else {return zim.wired(this, source, prop, twoWay, setSource, filter, call, input);}
+	// 	},
+	// 	noWired:function(source, prop, input) {
+	// 		if (isDUO(arguments)) {arguments[0].obj = this; return zim.noWired(arguments[0]);}
+	// 		else {return zim.noWired(this, source, prop, input);}
+	// 	},
+
 	return obj;
 };//-83.365
 
@@ -96488,7 +96642,7 @@ const ask = new CamAsk().show(yes => {
 END EXAMPLE
 
 EXAMPLE 
-// use ML5 at https://unpkg.com/ml5@1/dist/ml5.min.js for hand tracking
+// use ML5 at https://unpkg.com/ml5@1.2.1/dist/ml5.min.js for hand tracking
 // on a Mac, the canvas must be interacted with first
 // so would recommend always using CamAsk first:
 const ask = new CamAsk().show(yes=>{
@@ -97168,6 +97322,17 @@ NOTE: make the CamAlpha in the ready event of the Cam() or CamMotion()
 
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
 
+EXAMPLE
+// on a Mac, the canvas must be interacted with first 
+// so would recommend always using CamAsk first:
+const ask = new CamAsk().show(yes=>{	
+	if (yes) {
+		const cam = new Cam(W,H).alp(.3).center();		 
+		new CamAlpha(cam).pos(50,50,LEFT,BOTTOM);
+	}
+}); // end CamAsk show() - see CamAsk() docs for error checking example
+END EXAMPLE
+
 EXAMPLE
 // on a Mac, the canvas must be interacted with first 
 // so would recommend always using CamAsk first:
@@ -97507,6 +97672,8 @@ resize
 rotate2
 save
 mark
+pic
+chart
 
 Pizzazz Icons example:
 https://zimjs.com/bits/view/icons.html
@@ -97522,8 +97689,8 @@ const icon = makeIcon("home", white, 2).pos(40,40,RIGHT);
 var info = new Button({
 	width:50,
 	height:50,
-	color:blue, // or "red", "#666" etc.
-	rollColor:pink,
+	backgroundColor:blue, // or "red", "#666" etc.
+	rollBackgroundColor:pink,
 	corner:0,
 	label:"",
 	icon:makeIcon("info", "white")
@@ -97654,7 +97821,7 @@ where various Blob and Squiggle shapes can be selected from a menu
 or custom Blob And Squiggle shapes can be made.
 The code for the shapes can be copied into your app 
 as the Blob or Squiggle points parameter.
-Please contact us at https:forum.zimjs.com
+Please contact us at https://forum.zimjs.com
 and we can perhaps add your Blob or Squiggle in the menu!
 
 Note that PIZZAZZ 04 was created during ZIM NIO (version 9)