@rafaelaugusto/jolt 0.1.0-beta.6 → 0.1.0-beta.8

package/dist/zoomable.js

@@ -0,0 +1,249 @@
+import { Application, Image, isIOS } from '@nativescript/core';
+import { stop, toView } from './animate.js';
+import { reducedMotion } from './config.js';
+import { ownImage } from './image-owner.js';
+import { createZoomDriver } from './zoom-native.js';
+/** Makes an Image interactive without per-frame JS. Owns its transforms until disposed. */
+export function zoomable(target, options = {}) {
+    const image = toView(target);
+    if (!(image instanceof Image))
+        throw new TypeError('zoomable() expects a NativeScript Image.');
+    if (!options || typeof options !== 'object')
+        throw new TypeError('Zoom options must be an object.');
+    const viewport = options.viewport
+        ? toView(options.viewport)
+        : image.parent;
+    if (!viewport)
+        throw new TypeError('A zoom viewport is required before the image has a parent.');
+    const scale = options.scale ?? [1, 5];
+    if (!Array.isArray(scale) ||
+        scale.length !== 2 ||
+        !scale.every(Number.isFinite) ||
+        scale[0] < 1 ||
+        scale[1] < scale[0])
+        throw new RangeError('Zoom scale must be [minimum, maximum], with 1 <= minimum <= maximum.');
+    const doubleTap = options.doubleTap ?? 2.5;
+    if (!Number.isFinite(doubleTap) || doubleTap < 1)
+        throw new RangeError('Double-tap zoom must be a finite number >= 1.');
+    if (options.dismiss !== undefined &&
+        options.dismiss !== false &&
+        options.dismiss !== 'vertical')
+        throw new TypeError("Dismiss must be 'vertical' or false.");
+    for (const callback of [options.onDismiss, options.onSettled, options.onError])
+        if (callback !== undefined && typeof callback !== 'function')
+            throw new TypeError('Zoom callbacks must be functions.');
+    const backdrop = options.backdrop ? toView(options.backdrop) : undefined;
+    const chrome = options.chrome ? toView(options.chrome) : undefined;
+    if (backdrop === image ||
+        chrome === image ||
+        backdrop === viewport ||
+        chrome === viewport)
+        throw new TypeError('Dismissal backdrop/chrome must be separate from the image and viewport.');
+    if (image.parent && image.parent !== viewport)
+        throw new TypeError('The zoom viewport must be the image’s direct parent.');
+    if (image.rotate ||
+        image.rotateX ||
+        image.rotateY ||
+        image.scaleX <= 0 ||
+        image.scaleY <= 0)
+        throw new TypeError('Zoom supports positive axis-aligned image transforms; rotate an ancestor instead.');
+    return new Photo(image, viewport, { ...options, doubleTap, scale, backdrop, chrome });
+}
+class Photo {
+    image;
+    viewport;
+    options;
+    failure;
+    suspended = false;
+    driver;
+    stopped = false;
+    queued = false;
+    releaseOwnership = () => { };
+    generation = 0;
+    reduceObserver;
+    latest;
+    constructor(image, viewport, options) {
+        this.image = image;
+        this.viewport = viewport;
+        this.options = options;
+        this.latest = { x: 0, y: 0, scale: options.scale[0], progress: 0, pending: false };
+        this.releaseOwnership = ownImage(image, this.dispose);
+        stop(image, ['x', 'y', 'scaleX', 'scaleY']);
+        for (const view of [image, viewport]) {
+            view.on('loaded', this.schedule);
+            view.on('layoutChanged', this.schedule);
+            view.on('unloaded', this.dispose);
+        }
+        image.on('imageSourceChange', this.sourceChanged);
+        image.on('stretchChange', this.sourceChanged);
+        Application.on(Application.suspendEvent, this.suspend);
+        Application.on(Application.resumeEvent, this.resume);
+        if (isIOS)
+            this.reduceObserver = Application.ios.addNotificationObserver(UIAccessibilityReduceMotionStatusDidChangeNotification, this.preferences);
+        this.schedule();
+    }
+    get ready() {
+        return !!this.driver;
+    }
+    get error() {
+        return this.failure;
+    }
+    get state() {
+        return { ...(this.driver?.state ?? this.latest) };
+    }
+    get nativeController() {
+        return this.driver?.native;
+    }
+    zoomTo(value, focus, animated = true) {
+        if (!Number.isFinite(value) ||
+            value < this.options.scale[0] ||
+            value > this.options.scale[1])
+            throw new RangeError('Zoom must be within the configured scale range.');
+        if (focus && (!Number.isFinite(focus.x) || !Number.isFinite(focus.y)))
+            throw new RangeError('Zoom focus must be finite.');
+        if (this.stopped)
+            return;
+        const size = this.viewport.getActualSize();
+        this.driver?.zoom(value, focus?.x ?? size.width / 2, focus?.y ?? size.height / 2, animated);
+    }
+    reset(animated = true) {
+        this.generation++;
+        this.driver?.reset(animated);
+    }
+    requestDismiss() {
+        this.driver?.requestDismiss();
+    }
+    cancelDismiss() {
+        this.reset(true);
+    }
+    dispose = () => {
+        if (this.stopped)
+            return;
+        this.stopped = true;
+        this.generation++;
+        this.latest = {
+            x: 0,
+            y: 0,
+            scale: this.options.scale[0],
+            progress: 0,
+            pending: false,
+        };
+        this.driver?.stop();
+        this.driver = undefined;
+        this.releaseOwnership();
+        for (const view of [this.image, this.viewport]) {
+            view.off('loaded', this.schedule);
+            view.off('layoutChanged', this.schedule);
+            view.off('unloaded', this.dispose);
+        }
+        this.image.off('imageSourceChange', this.sourceChanged);
+        this.image.off('stretchChange', this.sourceChanged);
+        Application.off(Application.suspendEvent, this.suspend);
+        Application.off(Application.resumeEvent, this.resume);
+        if (this.reduceObserver)
+            Application.ios.removeNotificationObserver(this.reduceObserver, UIAccessibilityReduceMotionStatusDidChangeNotification);
+        this.reduceObserver = undefined;
+    };
+    dismissed = (x, y, scale, velocity, progress) => {
+        if (this.stopped)
+            return;
+        const generation = ++this.generation;
+        const valid = () => !this.stopped && generation === this.generation;
+        const dismissal = {
+            state: { x, y, scale, progress, pending: true },
+            velocity,
+            cancel: () => {
+                if (!valid())
+                    return false;
+                this.cancelDismiss();
+                return true;
+            },
+            complete: () => {
+                if (!valid())
+                    return false;
+                this.dispose();
+                return true;
+            },
+        };
+        if (this.options.onDismiss)
+            this.options.onDismiss(dismissal);
+        else
+            dismissal.cancel();
+    };
+    settled = (x, y, scale) => {
+        if (this.stopped)
+            return;
+        this.generation++;
+        this.latest = { x, y, scale, progress: 0, pending: false };
+        this.options.onSettled?.({ ...this.latest });
+    };
+    sourceChanged = () => {
+        this.generation++;
+        this.driver?.stop();
+        this.driver = undefined;
+        this.schedule();
+    };
+    suspend = () => {
+        this.suspended = true;
+        this.generation++;
+        this.driver?.setActive(false);
+    };
+    resume = () => {
+        this.suspended = false;
+        this.preferences();
+        this.driver?.setActive(true);
+        this.schedule();
+    };
+    preferences = () => this.driver?.setReduced(reducedMotion());
+    schedule = () => {
+        if (this.stopped || this.queued)
+            return;
+        this.queued = true;
+        void Promise.resolve()
+            .then(() => {
+            this.queued = false;
+            if (this.stopped ||
+                this.suspended ||
+                !this.image.isLoaded ||
+                !this.viewport.isLoaded)
+                return;
+            if (this.driver) {
+                this.driver.layout();
+                return;
+            }
+            if (this.image.parent !== this.viewport)
+                throw new TypeError('Zoom viewport must remain the direct image parent.');
+            const size = this.viewport.getActualSize();
+            const imageSize = this.image.getActualSize(), source = this.image.imageSource;
+            if (size.width <= 0 ||
+                size.height <= 0 ||
+                imageSize.width <= 0 ||
+                imageSize.height <= 0 ||
+                !source ||
+                !Number.isFinite(source.width) ||
+                !Number.isFinite(source.height) ||
+                source.width <= 0 ||
+                source.height <= 0)
+                return;
+            if (isIOS && typeof JoltPhotoZoom === 'undefined')
+                throw new Error('Rebuild the native app to install Jolt photo gestures.');
+            this.driver = createZoomDriver(this.image, this.viewport, {
+                minimum: this.options.scale[0],
+                maximum: this.options.scale[1],
+                doubleTap: this.options.doubleTap,
+                dismiss: this.options.dismiss === 'vertical',
+                reduced: reducedMotion(),
+                backdrop: this.options.backdrop,
+                chrome: this.options.chrome,
+            }, this.dismissed, this.settled);
+        })
+            .catch((error) => {
+            if (this.stopped)
+                return;
+            this.failure = error instanceof Error ? error : new Error(String(error));
+            this.dispose();
+            this.options.onError?.(this.failure);
+        });
+    };
+}
+//# sourceMappingURL=zoomable.js.map

package/dist/zoomable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoomable.js","sourceRoot":"","sources":["../src/zoomable.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rafaelaugusto/jolt",
-  "version": "0.1.0-beta.6",
+  "version": "0.1.0-beta.8",
   "description": "Native animations for NativeScript: presets, springs, keyframes and stagger in one call.",
   "keywords": [
     "nativescript",
@@ -38,6 +38,7 @@
   "files": [
     "dist",
     "src",
+    "platforms/ios",
     "platforms/android/java",
     "platforms/android/include.gradle",
     "platforms/android/proguard-rules.pro"

package/platforms/android/java/org/rafaelaugusto/jolt/ImageEffect.java

@@ -0,0 +1,288 @@
+package org.rafaelaugusto.jolt;
+
+import android.animation.Animator;
+import android.animation.AnimatorListenerAdapter;
+import android.animation.ValueAnimator;
+import android.graphics.*;
+import android.graphics.drawable.*;
+import android.os.Build;
+import android.view.MotionEvent;
+import android.view.View;
+import android.widget.ImageView;
+
+/** Image-only GPU effects. All animation and pointer samples stay in Java. */
+public final class ImageEffect {
+    public interface Listener { void onEnd(boolean completed, float progress); }
+    private static final String SHADER =
+        "uniform shader source; uniform shader destination; uniform float2 size;" +
+        "uniform float2 origin; uniform float2 displacement; uniform float progress;" +
+        "uniform float amplitude; uniform float radius; uniform float seed; uniform float mode;" +
+        "half4 main(float2 p) { float2 uv=p/size; float2 q=p;" +
+        "if(mode<1.5){ float2 v=p-origin; float d=length(v);" +
+        "float edge=clamp(min(min(p.x,size.x-p.x),min(p.y,size.y-p.y))/max(amplitude*2.,1.),0.,1.);" +
+        "if(mode<.5){float wave=d-progress*length(size);" +
+        "float a=sin(wave/max(radius*.12,1.))*exp(-pow(wave/max(radius,1.),2.))*amplitude*sin(progress*3.14159265);" +
+        "q-=v/max(d,1.)*a*edge;}else{q-=displacement*exp(-d*d/max(radius*radius,1.))*edge;}" +
+        "return source.eval(clamp(q,float2(.5),size-float2(.5)));}" +
+        "if(progress<=0.)return source.eval(p); if(progress>=1.)return destination.eval(p);" +
+        "float n=fract(sin(dot(floor(p/3.),float2(12.9898,78.233))+seed)*43758.5453);" +
+        "float a=smoothstep(n-.08,n+.08,progress*1.16-.08);" +
+        "return mix(source.eval(p),destination.eval(p),a);}";
+
+    private final ImageView view;
+    private final Listener listener;
+    private final int mode;
+    private final float amplitude, radius;
+    private final long duration;
+    private final Drawable original;
+    private final Bitmap originalBitmap;
+    private final ImageView.ScaleType originalScale;
+    private final View.OnTouchListener previousTouch;
+    private final boolean originalClickable;
+    private Bitmap source, destination, placeholderBitmap;
+    private RuntimeShader shader;
+    private EffectDrawable drawable;
+    private Drawable placeholder;
+    private ValueAnimator animator;
+    private boolean disposed, paused, suppressEnd, attached;
+    private float progress, goal = 1, x, y, dx, dy;
+    private int pointer = -1;
+    private float startX, startY, rawX, rawY;
+    private long frames, lastFrame, longestFrame;
+    private String failureReason="";
+    private final Path contentClip=new Path();
+
+    public ImageEffect(ImageView view, Bitmap from, Bitmap to, float[] geometry, int mode, float x, float y,
+                       float amplitude, float radius, long duration, float seed,
+                       View.OnTouchListener previousTouch, Listener listener) {
+        this.view=view; this.listener=listener; this.mode=mode;
+        this.amplitude=amplitude; this.radius=radius; this.duration=duration;
+        this.x=x; this.y=y; this.previousTouch=previousTouch;
+        original=view.getDrawable(); originalScale=view.getScaleType();
+        originalBitmap=from;
+        originalClickable=view.isClickable();
+        if(Build.VERSION.SDK_INT<33 || !view.isHardwareAccelerated() || from==null || original==null || original instanceof Animatable) {
+            failureReason="Requires API 33, hardware rendering and a static drawable ("+(original==null?"null":original.getClass().getName())+")";
+            return;
+        }
+        int w=view.getWidth(), h=view.getHeight();
+        if(w<=0 || h<=0 || (long)w*h>4194304L) {failureReason="Image surface exceeds the pixel budget";return;}
+        try {
+            float left=view.getPaddingLeft(),top=view.getPaddingTop(),right=view.getPaddingRight(),bottom=view.getPaddingBottom();
+            float[] radii={
+                Math.max(0,geometry[2]-left),Math.max(0,geometry[2]-top),
+                Math.max(0,geometry[3]-right),Math.max(0,geometry[3]-top),
+                Math.max(0,geometry[4]-right),Math.max(0,geometry[4]-bottom),
+                Math.max(0,geometry[5]-left),Math.max(0,geometry[5]-bottom)
+            };
+            contentClip.addRoundRect(new RectF(left,top,w-right,h-bottom),radii,Path.Direction.CW);
+            source=raster(from,geometry[0],w,h);
+            if(mode==2) {
+                if(to==null) { releaseBitmaps(); return; }
+                destination=raster(to,geometry[1],w,h);
+            }
+            shader=new RuntimeShader(SHADER);
+            shader.setInputShader("source",new BitmapShader(source,Shader.TileMode.CLAMP,Shader.TileMode.CLAMP));
+            shader.setInputShader("destination",new BitmapShader(destination==null?source:destination,Shader.TileMode.CLAMP,Shader.TileMode.CLAMP));
+            shader.setFloatUniform("size",w,h); shader.setFloatUniform("mode",mode);
+            shader.setFloatUniform("amplitude",amplitude); shader.setFloatUniform("radius",radius);
+            shader.setFloatUniform("seed",seed);
+            drawable=new EffectDrawable(w,h);
+            drawable.setBounds(0,0,w,h);
+            update();
+            // NativeScript's ImageView rasterizes custom drawables on a software
+            // canvas. An overlay keeps RuntimeShader on the hardware canvas.
+            view.getOverlay().add(drawable);
+            attached=true;
+            // NativeScript's onDraw clips the canvas to its bitmap's mapped
+            // rectangle, including overlays. A full-content transparent alpha
+            // bitmap keeps that clip open in every stretch/rotation mode.
+            // Clearing the drawable leaves its cached bitmap shader invalid.
+            int pw=Math.max(1,w-view.getPaddingLeft()-view.getPaddingRight());
+            int ph=Math.max(1,h-view.getPaddingTop()-view.getPaddingBottom());
+            float angle=Math.abs(geometry[0]%180);
+            if(angle>45 && angle<135){int swap=pw;pw=ph;ph=swap;}
+            placeholderBitmap=Bitmap.createBitmap(pw,ph,Bitmap.Config.ALPHA_8);
+            view.setImageBitmap(placeholderBitmap);
+            placeholder=view.getDrawable();
+            if(mode==1) {
+                view.setClickable(true);
+                view.setOnTouchListener(this::touch);
+            }
+        } catch (RuntimeException | OutOfMemoryError error) {
+            failureReason=error.toString();
+            if(attached) restore(true);
+            releaseBitmaps(); shader=null; drawable=null;
+        }
+    }
+
+    /** Match NativeScript's bitmap mapping without baking backgrounds/borders
+     * into the texture. The stationary inner corner mask is applied at draw time. */
+    private Bitmap raster(Bitmap bitmap,float rotation,int width,int height) {
+        Bitmap result=Bitmap.createBitmap(width,height,Bitmap.Config.ARGB_8888);
+        Canvas canvas=new Canvas(result);
+        float left=view.getPaddingLeft(),top=view.getPaddingTop();
+        float w=width-left-view.getPaddingRight(),h=height-top-view.getPaddingBottom();
+        float iw=bitmap.getWidth(),ih=bitmap.getHeight();
+        Matrix matrix=new Matrix();matrix.postRotate(rotation,iw/2,ih/2);
+        float angle=Math.abs(rotation%180);
+        if(angle>45 && angle<135){matrix.postTranslate((ih-iw)/2,(iw-ih)/2);float swap=iw;iw=ih;ih=swap;}
+        float sx=w/iw,sy=h/ih;
+        RectF visible=new RectF(left,top,left+w,top+h);
+        if(originalScale==ImageView.ScaleType.FIT_XY) matrix.postScale(sx,sy);
+        else if(originalScale==ImageView.ScaleType.MATRIX) visible.intersect(left,top,left+iw,top+ih);
+        else {
+            float scale=originalScale==ImageView.ScaleType.CENTER?1:originalScale==ImageView.ScaleType.CENTER_CROP?Math.max(sx,sy):Math.min(sx,sy);
+            matrix.postTranslate((w-iw)/2,(h-ih)/2);
+            matrix.postScale(scale,scale,w/2,h/2);
+            visible.intersect(left+(w-iw*scale)/2,top+(h-ih*scale)/2,left+(w+iw*scale)/2,top+(h+ih*scale)/2);
+        }
+        matrix.postTranslate(left,top);
+        BitmapShader pixels=new BitmapShader(bitmap,Shader.TileMode.CLAMP,Shader.TileMode.CLAMP);
+        pixels.setLocalMatrix(matrix);
+        Paint paint=new Paint(Paint.ANTI_ALIAS_FLAG|Paint.FILTER_BITMAP_FLAG);
+        paint.setShader(pixels);paint.setColorFilter(view.getColorFilter());
+        canvas.drawRect(visible,paint);
+        return result;
+    }
+
+    public boolean isSupported() { return drawable!=null && !disposed; }
+    public String getFailureReason() { return failureReason; }
+    public float getProgress() { return progress; }
+    public long getFrames() { return frames; }
+    public long getLongestFrameNanos() { return longestFrame; }
+    public long getTextureBytes() { return source==null?0:(long)source.getAllocationByteCount()+(destination==null?0:destination.getAllocationByteCount())+(placeholderBitmap==null?0:placeholderBitmap.getAllocationByteCount()); }
+    public boolean isPaused() { return paused; }
+
+    public void play(float destinationProgress) {
+        if(disposed || drawable==null || mode==1) return;
+        goal=destinationProgress; paused=false;
+        animate(progress,goal,Math.max(1,(long)(duration*Math.abs(goal-progress))),false);
+    }
+    public void pause() {
+        paused=true;
+        if(animator!=null) animator.pause();
+    }
+    public void resume() {
+        if(disposed) return;
+        paused=false;
+        lastFrame=0;
+        if(animator!=null && animator.isPaused()) animator.resume();
+    }
+    public void seek(float value) {
+        if(disposed || mode==1) return;
+        boolean hold=paused;
+        cancelAnimator(); progress=value; update();
+        if(!hold) play(goal);
+    }
+    public void finish(float endpoint) {
+        if(disposed || mode==1) return;
+        cancelAnimator(); progress=endpoint; update();
+        listener.onEnd(true,progress);
+    }
+    public void stop() {
+        detach(true);
+    }
+    public void stopPreservingImage() {
+        detach(false);
+    }
+    private void detach(boolean restoreImage) {
+        if(disposed) return;
+        disposed=true; cancelAnimator();
+        restore(restoreImage); shader=null; drawable=null; releaseBitmaps();
+    }
+    private void restore(boolean restoreImage) {
+        if(attached && drawable!=null) view.getOverlay().remove(drawable);
+        if(restoreImage && attached && view.getDrawable()==placeholder) {
+            // NativeScript caches mBitmap separately from its drawable. Restoring
+            // only the drawable leaves the placeholder's geometry behind.
+            view.setImageBitmap(originalBitmap);
+        }
+        if(mode==1 && drawable!=null) {
+            view.setOnTouchListener(previousTouch); view.setClickable(originalClickable);
+            if(view.getParent()!=null) view.getParent().requestDisallowInterceptTouchEvent(false);
+        }
+        attached=false;
+    }
+    private void releaseBitmaps() {
+        // Draw commands may still reference them; let Android retire the backing storage safely.
+        source=null; destination=null; placeholderBitmap=null;
+    }
+    private void cancelAnimator() {
+        if(animator==null) return;
+        suppressEnd=true; animator.cancel(); animator=null; suppressEnd=false;
+    }
+    private void animate(float from,float to,long milliseconds,boolean settle) {
+        cancelAnimator();
+        lastFrame=0;
+        final float startDx=dx,startDy=dy;
+        animator=ValueAnimator.ofFloat(from,to);
+        animator.setDuration(milliseconds);
+        animator.setInterpolator(new android.view.animation.LinearInterpolator());
+        animator.addUpdateListener(a->{
+            float value=(float)a.getAnimatedValue();
+            if(settle) {float t=value; float decay=(float)(Math.exp(-8*t)*(1-t)); dx=startDx*decay; dy=startDy*decay;}
+            else progress=value;
+            update();
+        });
+        animator.addListener(new AnimatorListenerAdapter(){
+            @Override public void onAnimationEnd(Animator a){
+                if(suppressEnd || disposed) return;
+                animator=null;
+                if(settle) {dx=dy=0;update();}
+                else listener.onEnd(true,progress);
+            }
+        });
+        animator.start();
+    }
+    private boolean touch(View target,MotionEvent event) {
+        if(disposed || paused) return false;
+        int action=event.getActionMasked();
+        if(action==MotionEvent.ACTION_DOWN) {
+            cancelAnimator(); pointer=event.getPointerId(0);
+            x=startX=event.getX(); y=startY=event.getY(); dx=dy=rawX=rawY=0;
+            update(); return true;
+        }
+        int index=event.findPointerIndex(pointer);
+        if(action==MotionEvent.ACTION_MOVE && index>=0) {
+            float vx=event.getX(index)-startX,vy=event.getY(index)-startY;
+            rawX=vx;rawY=vy;
+            float length=(float)Math.hypot(vx,vy);
+            float factor=length==0?0:(float)(amplitude*Math.tanh(length/Math.max(amplitude,1))/length);
+            dx=vx*factor; dy=vy*factor; update(); return true;
+        }
+        if(action==MotionEvent.ACTION_POINTER_UP && event.getPointerId(event.getActionIndex())==pointer) {
+            int next=event.getActionIndex()==0?1:0;
+            if(next<event.getPointerCount()) {
+                pointer=event.getPointerId(next); startX=event.getX(next)-rawX;startY=event.getY(next)-rawY;
+            }
+        }
+        if(action==MotionEvent.ACTION_UP || action==MotionEvent.ACTION_CANCEL) {
+            pointer=-1; animate(0,1,Math.min(600,duration),true);
+            if(action==MotionEvent.ACTION_UP) view.performClick();
+        }
+        return true;
+    }
+    private void update() {
+        if(shader==null || disposed) return;
+        shader.setFloatUniform("origin",x,y);
+        shader.setFloatUniform("displacement",dx,dy);
+        shader.setFloatUniform("progress",progress);
+        if(drawable!=null) drawable.invalidateSelf();
+    }
+    private final class EffectDrawable extends Drawable {
+        private final Paint paint=new Paint(Paint.ANTI_ALIAS_FLAG);
+        private final int width,height;
+        EffectDrawable(int width,int height) {this.width=width;this.height=height;paint.setShader(shader);}
+        @Override public int getIntrinsicWidth(){return width;}
+        @Override public int getIntrinsicHeight(){return height;}
+        @Override public void draw(Canvas canvas){
+            long now=System.nanoTime(); if(lastFrame!=0 && animator!=null && !paused) longestFrame=Math.max(longestFrame,now-lastFrame);
+            lastFrame=now; frames++;
+            canvas.drawPath(contentClip,paint);
+        }
+        @Override public void setAlpha(int alpha){paint.setAlpha(alpha);invalidateSelf();}
+        @Override public void setColorFilter(ColorFilter filter){paint.setColorFilter(filter);invalidateSelf();}
+        @Override public int getOpacity(){return PixelFormat.TRANSLUCENT;}
+    }
+}