source: Dev/branches/rest-dojo-ui/client/dojox/charting/plot2d/Columns.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"], 
        function(lang, arr, declare, Base, dc, df, dfr, du, fx){

        var purgeGroup = dfr.lambda("item.purgeGroup()");
/*=====
var Base = dojox.charting.plot2d.Base;
=====*/

        return declare("dojox.charting.plot2d.Columns", Base, {
                //      summary:
                //              The plot object representing a column chart (vertical bars).
                defaultParams: {
                        hAxis: "x",             // use a horizontal axis named "x"
                        vAxis: "y",             // use a vertical axis named "y"
                        gap:    0,              // gap between columns in pixels
                        animate: null,  // animate bars into place
                        enableCache: false
                },
                optionalParams: {
                        minBarSize:     1,      // minimal column width in pixels
                        maxBarSize:     1,      // maximal column width in pixels
                        // theme component
                        stroke:         {},
                        outline:        {},
                        shadow:         {},
                        fill:           {},
                        font:           "",
                        fontColor:      ""
                },

                constructor: function(chart, kwArgs){
                        //      summary:
                        //              The constructor for a columns chart.
                        //      chart: dojox.charting.Chart
                        //              The chart this plot belongs to.
                        //      kwArgs: dojox.charting.plot2d.__BarCtorArgs?
                        //              An optional keyword arguments object to help define the plot.
                        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;
                },

                getSeriesStats: function(){
                        //      summary:
                        //              Calculate the min/max on all attached series in both directions.
                        //      returns: Object
                        //              {hmin, hmax, vmin, vmax} min/max in both directions.
                        var stats = dc.collectSimpleStats(this.series);
                        stats.hmin -= 0.5;
                        stats.hmax += 0.5;
                        return stats;
                },
                
                createRect: function(run, creator, params){
                        var rect;
                        if(this.opt.enableCache && run._rectFreePool.length > 0){
                                rect = run._rectFreePool.pop();
                                rect.setShape(params);
                                // was cleared, add it back
                                creator.add(rect);
                        }else{
                                rect = creator.createRect(params);
                        }
                        if(this.opt.enableCache){
                                run._rectUsePool.push(rect);
                        }
                        return rect;
                },

                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.Columns
                        //              A reference to this plot for functional chaining.
                        if(this.zoom && !this.isDataDirty()){
                                return this.performZoom(dim, offsets);
                        }
                        var t = this.getSeriesStats();
                        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, f, gap, width,
                                ht = this._hScaler.scaler.getTransformerFromModel(this._hScaler),
                                vt = this._vScaler.scaler.getTransformerFromModel(this._vScaler),
                                baseline = Math.max(0, this._vScaler.bounds.lower),
                                baselineHeight = vt(baseline),
                                min = Math.max(0, Math.floor(this._hScaler.bounds.from - 1)), max = Math.ceil(this._hScaler.bounds.to),
                                events = this.events();
                        f = dc.calculateBarSize(this._hScaler.bounds.scale, this.opt);
                        gap = f.gap;
                        width = f.size;
                        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(this.opt.enableCache){
                                        run._rectFreePool = (run._rectFreePool?run._rectFreePool:[]).concat(run._rectUsePool?run._rectUsePool:[]);
                                        run._rectUsePool = [];
                                }
                                var theme = t.next("column", [this.opt, run]), s = run.group,
                                        eventSeries = new Array(run.data.length);
                                var l = Math.min(run.data.length, max);
                                for(var j = min; j < l; ++j){
                                        var value = run.data[j];
                                        if(value !== null){
                                                var v = typeof value == "number" ? value : value.y,
                                                        vv = vt(v),
                                                        height = vv - baselineHeight,
                                                        h = Math.abs(height),
                                                        finalTheme = typeof value != "number" ?
                                                                t.addMixin(theme, "column", value, true) :
                                                                t.post(theme, "column");
                                                if(width >= 1 && h >= 0){
                                                        var rect = {
                                                                x: offsets.l + ht(j + 0.5) + gap,
                                                                y: dim.height - offsets.b - (v > baseline ? vv : baselineHeight),
                                                                width: width, height: h
                                                        };
                                                        var specialFill = this._plotFill(finalTheme.series.fill, dim, offsets);
                                                        specialFill = this._shapeFill(specialFill, rect);
                                                        var shape = this.createRect(run, s, rect).setFill(specialFill).setStroke(finalTheme.series.stroke);
                                                        run.dyn.fill   = shape.getFill();
                                                        run.dyn.stroke = shape.getStroke();
                                                        if(events){
                                                                var o = {
                                                                        element: "column",
                                                                        index:   j,
                                                                        run:     run,
                                                                        shape:   shape,
                                                                        x:       j + 0.5,
                                                                        y:       v
                                                                };
                                                                this._connectEvents(o);
                                                                eventSeries[j] = o;
                                                        }
                                                        if(this.animate){
                                                                this._animateColumn(shape, dim.height - offsets.b - baselineHeight, h);
                                                        }
                                                }
                                        }
                                }
                                this._eventSeries[run.name] = eventSeries;
                                run.dirty = false;
                        }
                        this.dirty = false;
                        return this;    //      dojox.charting.plot2d.Columns
                },
                _animateColumn: function(shape, voffset, vsize){
                        fx.animateTransform(lang.delegate({
                                shape: shape,
                                duration: 1200,
                                transform: [
                                        {name: "translate", start: [0, voffset - (voffset/vsize)], end: [0, 0]},
                                        {name: "scale", start: [1, 1/vsize], end: [1, 1]},
                                        {name: "original"}
                                ]
                        }, this.animate)).play();
                }
        });
});