zimjs 18.1.5 → 18.1.7

package/package.json

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

package/src/zim.js

@@ -39458,7 +39458,7 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 						that.dispatchEvent("change");
 						if ((!zim.OPTIMIZE&&(zns||!WW.OPTIMIZE)) && that.stage) that.stage.update();
 					});
-				} else {
+				} else {					
 					button.zimTabEvent = button.on((!zns?WW.ACTIONEVENT=="mousedown":zim.ACTIONEVENT=="mousedown")?"mousedown":"click", function(e) {
 						change(e.currentTarget.znum);
 						that.dispatchEvent("change");
@@ -74072,7 +74072,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)
+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)
 
 MotionController
 zim class - extends a createjs EventDispatcher
@@ -74240,7 +74240,9 @@ tileObj - (default null) an object to direct the target to move on a theoretical
 					[1,1,0,1,1], 
 					[0,1,1,1,0]
 				]
-			note: this will override the cols and rows values			
+			note: this will override the cols and rows values		
+penDown - (default null) set to true with Pen to make MotionControler draw the Pen on mousedown so a dot can be drawn 
+	otherwise the dot is drawn on mouseup if the pen has not moved more than 2 pixels
 
 METHODS
 pause(state, time) - state defaults to true and pauses the motionController (sets speed to 0)
@@ -74290,8 +74292,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) {
-		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";
+	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) {
+		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";
 		var duo; if (duo = zob(zim.MotionController, arguments, sig, this)) return duo;
 		z_d("69.7");
 
@@ -74613,11 +74615,19 @@ dispatches a "moving" event if target is moving and "startmoving" and "stopmovin
 					target.write = true;
 					target.paper.noMouse(); // no need to drag others while drawing
 					target.zimDragCheck = true;
+					if (penDown) {
+						target.x+=2
+						target.write = false;
+						timeout(0, function() {
+							target.write = true;
+							if (target.stage) target.stage.update();
+						});		
+					}			
 				}
 			});
 			mouseEvent3 = stage.on("stagemouseup", function(){
 				if (target.type == "Pen") {
-					if (target.zpenX==Math.round(target.x) && target.zpenY==Math.round(target.y)) target.x+=2
+					if (!penDown && target.zpenX <= target.x+2 && target.zpenX >= target.x-2 && target.zpenY <= target.y+2  && target.zpenY >= target.y-2) target.x+=2
 					target.write = false;
 					target.paper.mouse();
 					target.zimDragCheck = false;
@@ -80761,6 +80771,11 @@ If you have moved, scaled or rotated the Emitter or its container,
 then you will want to use var point = myEmitter.localToGlobal(particle.x, particle.y)
 and get point.x and point.y to find the location of the particle relative to the stage coordinates
 
+NOTE: the Emitter sets the stage snapToPixelEnabled to true if cache is true 
+As of ZIM 018, when the emitter is done it sets it to false (default for ZIM Stage).
+We do not know when its value is set ss the property is a CreateJS property - unless we override 
+but for now, if snapToPixelEnabled is desired to be true, set it to true after using the emitter. 
+
 PARTICLES CONTAINER
 By default, the Emitter will make a Container and place it beneath itself when added to the stage.
 by separating the particles from the emitter, it allows the emitter to be moved without all the particles moving
@@ -81067,7 +81082,6 @@ zim.Emitter = function(obj, width, height, interval, num, life, fade, shrink, wa
 	var stage;
 	zim.added(that, addedToStage);
 	function addedToStage(s) {
-
 		that.emitterPaused = null; // will set back using that.startEmitterPaused
 
 		that.on("added", function () {
@@ -81491,6 +81505,7 @@ zim.Emitter = function(obj, width, height, interval, num, life, fade, shrink, wa
 		if (p.trace?p.getChildAt(0).endSpurt:p.endSpurt) {
 			sendEvent("spurtfizzed", p);
 			that.spurting = false;
+			if (cache) stage.snapToPixelEnabled = false;
 		}
 		if (that.pool) {
 			if (p.pooled == "end") {
@@ -81552,12 +81567,14 @@ zim.Emitter = function(obj, width, height, interval, num, life, fade, shrink, wa
 		// that.removeFrom();
 		if (that.parent) that.parent.removeChild(that);
 		that.particles.removeFrom();
+		if (cache) stage.snapToPixelEnabled = false;
 	};
 
 	this.spurting = false;
 	this.spurt = function(num, time, restart) {
 		var sig = "num, time, restart";
 		var duo; if (duo = zob(that.spurt, arguments, sig)) return duo;
+		if (cache) stage.snapToPixelEnabled = true;
 		if (!zot(time)) {
 			zim.timeout(zim.Pick.choose(time), function() {
 				lastSpurt(that.currentParticle);
@@ -81605,6 +81622,7 @@ zim.Emitter = function(obj, width, height, interval, num, life, fade, shrink, wa
 			}
 			that.zimInterval.pause();
 			that.emitterPaused = true;
+			if (cache) stage.snapToPixelEnabled = false;
 		} else { // unpausing
 			if (!that.emitterPaused) return that;
 			if (restart) {
@@ -81625,6 +81643,7 @@ zim.Emitter = function(obj, width, height, interval, num, life, fade, shrink, wa
 			}
 			if (that.zimInterval) that.zimInterval.pause(false, immediate);
 			that.emitterPaused = false;
+			if (cache) stage.snapToPixelEnabled = true;
 		}
 		return that;
 	};
@@ -81654,6 +81673,7 @@ zim.Emitter = function(obj, width, height, interval, num, life, fade, shrink, wa
 
 	
 	this.dispose = function() {
+		if (cache) stage.snapToPixelEnabled = true;
 		if (that.zimInterval) that.zimInterval.clear();
 		if (emitterTicker) {
 			zim.Ticker.remove(emitterTicker);
@@ -89817,6 +89837,11 @@ play(volume, loop, loopCount, pan, offset, delay, interrupt) - play the sound
 		"early" - interrupt only the previously playing sound that has progressed the least
 		"late" - interrupt only the previously playing sound that has progressed the most
 		** thank you CreateJS and SoundJS for providing these options
+destroy() - remove sound references and dispose 
+	normal dispose() on an Aud() will just dispose the specific sound
+	leaving the original audio reference so that more Aud objects can be made from the loaded audio 
+	destroy() will remove references to the original HTML audio so HTML will garbage collect it
+	Note: there is a single audio file made (for an app with sound) to help Apple play sounds that will be left in memory
 	
 ABSTRACT SOUND INSTANCE
 The return result of the play() makes a CreateJS AbstractSoundInstance
@@ -89974,6 +89999,26 @@ loop - dispatched when the sound loops (but not at end of last loop - that is co
             }
 			return that.soundInstance;
         }
+
+		this.destroy = function() {
+			if (this.file) {
+				this.src = this.item = null;
+				var frame;
+				if (this.stage && this.stage.frame) frame = this.stage.frame;
+				else frame = WW.zdf;
+				if (frame && frame.assets) {					
+					if (frame.assets[this.file]) {
+						if (frame.assets[this.file].dispose) frame.assets[this.file].dispose();
+						delete frame.assets[this.file];
+					}
+				}
+				if (zim.assets[this.file]) {
+					if (zim.assets[this.file].dispose) zim.assets[this.file].dispose();
+					delete zim.assets[this.file];
+				}
+			}	
+			this.dispose();	
+		}
         
         that.dispose = function() {
             if (that.sound) {

package/ts-src/typings/zim/index.d.ts

@@ -3561,8 +3561,8 @@ declare namespace zim {
 		enabled: boolean
 	}
 	export class MotionController extends createjs.EventDispatcher {
-		constructor(config_or_target?: DisplayObject, type?: string, speed?: number, axis?: string, boundary?: Boundary | createjs.Rectangle | { x: number, y: number, width: number, height: number }, map?: [number | number[]], diagonal?: boolean, damp?: number, flip?: string, orient?: boolean, constant?: boolean, firstPerson?: boolean, turnSpeed?: number, moveThreshold?: number, stickThreshold?: number, container?: Stage | StageGL | Container, localBounds?: boolean, mouseMoveOutside?: boolean, mousedownIncludes?: DisplayObject[], minPercentSpeed?: number, maxPercentSpeed?: number, dampKeyup?: number, rotate?: boolean, mouseOutside?: boolean)
-		constructor(config: { target?: DisplayObject, type?: string, speed?: number, axis?: string, boundary?: Boundary | createjs.Rectangle | { x: number, y: number, width: number, height: number }, map?: [number | number[]], diagonal?: boolean, damp?: number, flip?: string, orient?: boolean, constant?: boolean, firstPerson?: boolean, turnSpeed?: number, moveThreshold?: number, stickThreshold?: number, container?: Stage | StageGL | Container, localBounds?: boolean, mouseMoveOutside?: boolean, mousedownIncludes?: DisplayObject[], minPercentSpeed?: number, maxPercentSpeed?: number, dampKeyup?: number, rotate?: boolean, mouseOutside?: boolean })
+		constructor(config_or_target?: DisplayObject, type?: string, speed?: number, axis?: string, boundary?: Boundary | createjs.Rectangle | { x: number, y: number, width: number, height: number }, map?: [number | number[]], diagonal?: boolean, damp?: number, flip?: string, orient?: boolean, constant?: boolean, firstPerson?: boolean, turnSpeed?: number, moveThreshold?: number, stickThreshold?: number, container?: Stage | StageGL | Container, localBounds?: boolean, mouseMoveOutside?: boolean, mousedownIncludes?: DisplayObject[], minPercentSpeed?: number, maxPercentSpeed?: number, dampKeyup?: number, rotate?: boolean, mouseOutside?: boolean, penDown?: boolean)
+		constructor(config: { target?: DisplayObject, type?: string, speed?: number, axis?: string, boundary?: Boundary | createjs.Rectangle | { x: number, y: number, width: number, height: number }, map?: [number | number[]], diagonal?: boolean, damp?: number, flip?: string, orient?: boolean, constant?: boolean, firstPerson?: boolean, turnSpeed?: number, moveThreshold?: number, stickThreshold?: number, container?: Stage | StageGL | Container, localBounds?: boolean, mouseMoveOutside?: boolean, mousedownIncludes?: DisplayObject[], minPercentSpeed?: number, maxPercentSpeed?: number, dampKeyup?: number, rotate?: boolean, mouseOutside?: boolean, penDown?: boolean })
 		immediate(x: number, y: number): void
 		convert(x: number, y: number): void
 		pause(state?: boolean, time?: number): this
@@ -3931,7 +3931,8 @@ declare namespace zim {
 		constructor(config_or_file?: string, volume?: number, loop?: number, loopCount?: number, pan?: number, offset?: number, delay?: number, interrupt?: string, maxNum?: number, style?: boolean, group?: string, inherit?: {})
 		constructor(config: { file?: string, volume?: number, loop?: number, loopCount?: number, pan?: number, offset?: number, delay?: number, interrupt?: string, maxNum?: number, style?: boolean, group?: string, inherit?: {} })
 		play(volume?: number, loop?: number, loopCount?: number, pan?: number, offset?: number, delay?: number, interrupt?: string): createjs.AbstractSoundInstance
-		readonly file: string
+		destroy() : void
+        readonly file: string
 		readonly src: string
 		readonly item: {}
 	}