source: Dev/branches/rest-dojo-ui/client/dojox/charting/plot2d/Scatter.js @ 256

define(["dojo/_base/lang", "dojo/_base/array", "dojo/_base/declare", "./Base", "./common", 
        "dojox/lang/functional", "dojox/lang/functional/reversed", "dojox/lang/utils", "dojox/gfx/fx", "dojox/gfx/gradutils"],
        function(lang, arr, declare, Base, dc, df, dfr, du, fx, gradutils){
/*=====
var Base = dojox.charting.plot2d.Base;
=====*/
        var purgeGroup = dfr.lambda("item.purgeGroup()");

        return declare("dojox.charting.plot2d.Scatter", Base, {
                //      summary:
                //              A plot object representing a typical scatter chart.
                defaultParams: {
                        hAxis: "x",             // use a horizontal axis named "x"
                        vAxis: "y",             // use a vertical axis named "y"
                        shadows: null,  // draw shadows
                        animate: null   // animate chart to place
                },
                optionalParams: {
                        // theme component
                        markerStroke:           {},
                        markerOutline:          {},
                        markerShadow:           {},
                        markerFill:                     {},
                        markerFont:                     "",
                        markerFontColor:        ""
                },

                constructor: function(chart, kwArgs){
                        //      summary:
                        //              Create the scatter plot.
                        //      chart: dojox.charting.Chart
                        //              The chart this plot belongs to.
                        //      kwArgs: dojox.charting.plot2d.__DefaultCtorArgs?
                        //              An optional keyword arguments object to help define this plot's parameters.
                        this.opt = lang.clone(this.defaultParams);
            du.updateWithObject(this.opt, kwArgs);
            du.updateWithPattern(this.opt, kwArgs, this.optionalParams);
                        this.series = [];
                        this.hAxis = this.opt.hAxis;
                        this.vAxis = this.opt.vAxis;
                        this.animate = this.opt.animate;
                },

                render: function(dim, offsets){
                        //      summary:
                        //              Run the calculations for any axes for this plot.
                        //      dim: Object
                        //              An object in the form of { width, height }
                        //      offsets: Object
                        //              An object of the form { l, r, t, b}.
                        //      returns: dojox.charting.plot2d.Scatter
                        //              A reference to this plot for functional chaining.
                        if(this.zoom && !this.isDataDirty()){
                                return this.performZoom(dim, offsets);
                        }
                        this.resetEvents();
                        this.dirty = this.isDirty();
                        if(this.dirty){
                                arr.forEach(this.series, purgeGroup);
                                this._eventSeries = {};
                                this.cleanGroup();
                                var s = this.group;
                                df.forEachRev(this.series, function(item){ item.cleanGroup(s); });
                        }
                        var t = this.chart.theme, events = this.events();
                        for(var i = this.series.length - 1; i >= 0; --i){
                                var run = this.series[i];
                                if(!this.dirty && !run.dirty){
                                        t.skip();
                                        this._reconnectEvents(run.name);
                                        continue;
                                }
                                run.cleanGroup();
                                if(!run.data.length){
                                        run.dirty = false;
                                        t.skip();
                                        continue;
                                }

                                var theme = t.next("marker", [this.opt, run]), s = run.group, lpoly,
                                        ht = this._hScaler.scaler.getTransformerFromModel(this._hScaler),
                                        vt = this._vScaler.scaler.getTransformerFromModel(this._vScaler);
                                if(typeof run.data[0] == "number"){
                                        lpoly = arr.map(run.data, function(v, i){
                                                return {
                                                        x: ht(i + 1) + offsets.l,
                                                        y: dim.height - offsets.b - vt(v)
                                                };
                                        }, this);
                                }else{
                                        lpoly = arr.map(run.data, function(v, i){
                                                return {
                                                        x: ht(v.x) + offsets.l,
                                                        y: dim.height - offsets.b - vt(v.y)
                                                };
                                        }, this);
                                }

                                var shadowMarkers  = new Array(lpoly.length),
                                        frontMarkers   = new Array(lpoly.length),
                                        outlineMarkers = new Array(lpoly.length);

                                arr.forEach(lpoly, function(c, i){
                                        var finalTheme = typeof run.data[i] == "number" ?
                                                        t.post(theme, "marker") :
                                                        t.addMixin(theme, "marker", run.data[i], true),
                                                path = "M" + c.x + " " + c.y + " " + finalTheme.symbol;
                                        if(finalTheme.marker.shadow){
                                                shadowMarkers[i] = s.createPath("M" + (c.x + finalTheme.marker.shadow.dx) + " " +
                                                        (c.y + finalTheme.marker.shadow.dy) + " " + finalTheme.symbol).
                                                        setStroke(finalTheme.marker.shadow).setFill(finalTheme.marker.shadow.color);
                                                if(this.animate){
                                                        this._animateScatter(shadowMarkers[i], dim.height - offsets.b);
                                                }
                                        }
                                        if(finalTheme.marker.outline){
                                                var outline = dc.makeStroke(finalTheme.marker.outline);
                                                outline.width = 2 * outline.width + finalTheme.marker.stroke.width;
                                                outlineMarkers[i] = s.createPath(path).setStroke(outline);
                                                if(this.animate){
                                                        this._animateScatter(outlineMarkers[i], dim.height - offsets.b);
                                                }
                                        }
                                        var stroke = dc.makeStroke(finalTheme.marker.stroke),
                                                fill = this._plotFill(finalTheme.marker.fill, dim, offsets);
                                        if(fill && (fill.type === "linear" || fill.type == "radial")){
                                                var color = gradutils.getColor(fill, {x: c.x, y: c.y});
                                                if(stroke){
                                                        stroke.color = color;
                                                }
                                                frontMarkers[i] = s.createPath(path).setStroke(stroke).setFill(color);
                                        }else{
                                                frontMarkers[i] = s.createPath(path).setStroke(stroke).setFill(fill);
                                        }
                                        if(this.animate){
                                                this._animateScatter(frontMarkers[i], dim.height - offsets.b);
                                        }
                                }, this);
                                if(frontMarkers.length){
                                        run.dyn.stroke = frontMarkers[frontMarkers.length - 1].getStroke();
                                        run.dyn.fill   = frontMarkers[frontMarkers.length - 1].getFill();
                                }

                                if(events){
                                        var eventSeries = new Array(frontMarkers.length);
                                        arr.forEach(frontMarkers, function(s, i){
                                                var o = {
                                                        element: "marker",
                                                        index:   i,
                                                        run:     run,
                                                        shape:   s,
                                                        outline: outlineMarkers && outlineMarkers[i] || null,
                                                        shadow:  shadowMarkers && shadowMarkers[i] || null,
                                                        cx:      lpoly[i].x,
                                                        cy:      lpoly[i].y
                                                };
                                                if(typeof run.data[0] == "number"){
                                                        o.x = i + 1;
                                                        o.y = run.data[i];
                                                }else{
                                                        o.x = run.data[i].x;
                                                        o.y = run.data[i].y;
                                                }
                                                this._connectEvents(o);
                                                eventSeries[i] = o;
                                        }, this);
                                        this._eventSeries[run.name] = eventSeries;
                                }else{
                                        delete this._eventSeries[run.name];
                                }
                                run.dirty = false;
                        }
                        this.dirty = false;
                        return this;    //      dojox.charting.plot2d.Scatter
                },
                _animateScatter: function(shape, offset){
                        fx.animateTransform(lang.delegate({
                                shape: shape,
                                duration: 1200,
                                transform: [
                                        {name: "translate", start: [0, offset], end: [0, 0]},
                                        {name: "scale", start: [0, 0], end: [1, 1]},
                                        {name: "original"}
                                ]
                        }, this.animate)).play();
                }
        });
});