1 /**
  2  * Hilo
  3  * Copyright 2015 alibaba.com
  4  * Licensed under the MIT License
  5  */
  6 
  7 /**
  8  * @class 渲染器抽象基类。
  9  * @param {Object} properties 创建对象的属性参数。可包含此类所有可写属性。
 10  * @module hilo/renderer/Renderer
 11  * @requires hilo/core/Hilo
 12  * @requires hilo/core/Class
 13  * @property {Object} canvas 渲染器对应的画布。它可能是一个普通的DOM元素,比如div,也可以是一个canvas画布元素。只读属性。
 14  * @property {Object} stage 渲染器对应的舞台。只读属性。
 15  * @property {String} renderType 渲染方式。只读属性。
 16  */
 17 var Renderer = Class.create(/** @lends Renderer.prototype */{
 18     constructor: function(properties){
 19         properties = properties || {};
 20         Hilo.copy(this, properties, true);
 21     },
 22 
 23     renderType:null,
 24     canvas: null,
 25     stage: null,
 26 
 27     /**
 28      * 为开始绘制可视对象做准备。需要子类来实现。
 29      * @param {View} target 要绘制的可视对象。
 30      */
 31     startDraw: function(target){ },
 32 
 33     /**
 34      * 绘制可视对象。需要子类来实现。
 35      * @param {View} target 要绘制的可视对象。
 36      */
 37     draw: function(target){ },
 38 
 39     /**
 40      * 结束绘制可视对象后的后续处理方法。需要子类来实现。
 41      * @param {View} target 要绘制的可视对象。
 42      */
 43     endDraw: function(target){ },
 44 
 45     /**
 46      * 对可视对象进行变换。需要子类来实现。
 47      */
 48     transform: function(){ },
 49 
 50     /**
 51      * 隐藏可视对象。需要子类来实现。
 52      */
 53     hide: function(){ },
 54 
 55     /**
 56      * 从画布中删除可视对象。注意:不是从stage中删除对象。需要子类来实现。
 57      * @param {View} target 要删除的可视对象。
 58      */
 59     remove: function(target){ },
 60 
 61     /**
 62      * 清除画布指定区域。需要子类来实现。
 63      * @param {Number} x 指定区域的x轴坐标。
 64      * @param {Number} y 指定区域的y轴坐标。
 65      * @param {Number} width 指定区域的宽度。
 66      * @param {Number} height 指定区域的高度。
 67      */
 68     clear: function(x, y, width, height){ },
 69 
 70     /**
 71      * 改变渲染器的画布大小。
 72      * @param {Number} width 指定渲染画布新的宽度。
 73      * @param {Number} height 指定渲染画布新的高度。
 74      */
 75     resize: function(width, height){ }
 76 
 77 });