/*   Riassence Framework
 *   Copyright 2006 Riassence Inc.
 *   http://riassence.com/
 *
 *   You should have received a copy of the GNU General Public License along
 *   with this software package. If not, contact licensing@riassence.com
 */

/*** = Description
  ** HImageView is a control unit intended to display images on the screen
  ** through the HTML <IMG> tag. The HImageView class is a container 
  ** to visualize
  ** images loaded via URL. It supports scaling via two class methods, 
  ** scaleToFit and scaleToOriginal. If the image is unable to be loaded, 
  ** a default blank image will be rendered.
  **
  ***/
HImageView = HControl.extend({
  
  controlDefaults: (HControlDefaults.extend({
    scaleToFit: true,
    value: null,
    constructor: function(_ctrl){
      if(this.value===null){
        // default to a blank image
        this.value = _ctrl.getThemeGfxPath() + "/blank.gif";
      }
    }
  })),
  
  _makeScaleToFit: function(_parentId){
    var _value = (this.value!==null)?this.value:(this.options.valueObj?this.options.valueObj.value:this.options.value);
    this.elemId = ELEM.make(_parentId,'img');
    ELEM.setAttr(this.elemId,'src',_value);
    ELEM.setAttr(this.elemId,'alt',this.label);
    ELEM.setAttr(this.elemId,'title',this.label);
  },
  _makeScaleToOriginal: function(_parentId){
    var _value = (this.value!==null)?this.value:(this.options.valueObj?this.options.valueObj.value:this.options.value);
    this.elemId = ELEM.make(_parentId,'div');
    ELEM.setStyle(this.elemId,'background-image','url('+_value+')');
    ELEM.setStyle(this.elemId,'background-position','0px 0px');
    ELEM.setStyle(this.elemId,'background-repeat','no-repeat');
    ELEM.setAttr(this.elemId,'title',this.label);
  },
  _makeElem: function(_parentId){
    if(this.options.scaleToFit){
      this._makeScaleToFit(_parentId);
    }
    else {
      this._makeScaleToOriginal(_parentId);
    }
  },
  
/** = Description
  * Used to refresh HImageView if the this.value is changed.
  * 
  **/
  refreshValue: function(){
    if(this.options.scaleToFit){
      ELEM.setAttr(this.elemId,'src',this.value);
    }
    else{
      ELEM.setStyle(this.elemId,'background-image','url('+this.value+')');
    }
  },
  
/** = Description
  * Refreshesh the label of HImageView.
  *
  **/
  refreshLabel: function(){
    if(this.options.scaleToFit){
      ELEM.setAttr(this.elemId,'alt',this.label);
    }
    ELEM.setAttr(this.elemId,'title',this.label);
  },
  
/** = Description
  * Changes the size of the image element so that it fits in the rectangle of
  * the view.
  *
  **/
  scaleToFit: function() {
    if(!this.options.scaleToFit){
      ELEM.del(this.elemId);
      this._makeScaleToFit(this._getParentElemId());
      this.options.scaleToFit=true;
    }
  },
  
  
/** = Description
  * Resizes the image element to its original dimesions. If the image is larger
  * than the rectangle of this view, clipping will occur.
  *
  **/
  scaleToOriginal: function() {
    if(this.options.scaleToFit){
      ELEM.del(this.elemId);
      this._makeScaleToOriginal(this._getParentElemId());
      this.options.scaleToFit=false;
    }
  }


  
});