/**
 * jt_utils.js - "JavaScript Toolkit" utility functions
 *
 * Copyright (c) 2005-2007 Joseph Oster, wingo.com
 */

/* GENERIC FUNCTIONS */
String.prototype.trim = function () {
 return this.replace(/^\s+/g, '').replace(/\s+$/g, '');
 }

function jt_strEmpty(st) {
 // return 'true' unless 'st' is a non-null string
 if (typeof st == 'string') return (st.trim() == '');
 else return true;
 }

function $(divName) {
 return document.getElementById(divName);
 }

function jt_ShowHideElm(elm, showIt) {
 if (elm) elm.style.visibility = (showIt) ? "visible" : "hidden";
 }

function jt_ShowNoneElm(elm, showIt, showStyle) {
 if (!showStyle) showStyle = "";
 if (elm) elm.style.display = (showIt) ? showStyle : "none";
 }

function jt_ShowHide(divName, showIt) {
 jt_ShowHideElm(document.getElementById(divName), showIt);
 }

function jt_ShowNone(divName, showIt, showStyle) {
 jt_ShowNoneElm(document.getElementById(divName), showIt, showStyle);
 }


/********** BEGIN: screen handling **********/
function jt_valPx(pixels) {
 return pixels + "px";
 }

function jt_moveTo(obj, x, y) {
 obj.style.left = jt_valPx(x);
 obj.style.top = jt_valPx(y);
 }

function jt_Point(x, y) {
 // returns a "Point" object with '.x' and '.y' properties
 this.x = x;
 this.y = y;
 }

function jt_getOffsetXY(obj, findID, point) {
 // 'findID' and 'point' are optional
 // returns 'jt_Point' object with '.x' and '.y' offsets of 'obj' relative to page
 // or relative to 'findID' if 'findID' is used and found as a parent
 if (point) { // re-use when valid; good practice when dragging
 point.x = obj.offsetLeft;
 point.y = obj.offsetTop;
 }
 else point = new jt_Point(obj.offsetLeft, obj.offsetTop);
 var parent = obj.offsetParent;
 while (parent != null) {
 if (findID && (parent.id == findID)) break;
 point.x += parent.offsetLeft;
 point.y += parent.offsetTop;
 parent = parent.offsetParent;
 }
 return point;
 }

function jt_getOffsetX(obj) {
 // returns 'x' coordinate of 'obj'
 var xPos = obj.offsetLeft;
 var parent = obj.offsetParent;
 while (parent != null) {
 xPos += parent.offsetLeft;
 parent = parent.offsetParent;
 }
 return xPos;
 }

function jt_getOffsetY(obj) {
 // returns 'y' coordinate of 'obj'
 var yPos = obj.offsetTop;
 var parent = obj.offsetParent;
 while (parent != null) {
 yPos += parent.offsetTop;
 parent = parent.offsetParent;
 }
 return yPos;
 }

function jt_currStyle(divToRead) {
 // return current (derived) CSS style object
 var cs = divToRead.style;
 if (window.getComputedStyle) cs = window.getComputedStyle(divToRead,null);
 else if (divToRead.currentStyle) cs = divToRead.currentStyle;
 return cs;
 }

function jt_width(divToRead) {
 var wide = jt_currStyle(divToRead).width;
 return (wide = 'auto') ? divToRead.offsetWidth : parseInt(wide);
 }

function jt_height(divToRead) {
 var high = jt_currStyle(divToRead).height;
 return (high = 'auto') ? divToRead.offsetHeight : parseInt(high);
 }

function jt_winW() {
 return window.innerWidth ? window.innerWidth : document.body.offsetWidth;
 }

function jt_winH() {
 return window.innerHeight ? window.innerHeight : document.body.offsetHeight;
 }

function jt_scrollTop() {
 if (window.pageYOffset) return window.pageYOffset;
 else if (document.documentElement && (document.documentElement.scrollTop > 0)) return document.documentElement.scrollTop;
 else return document.body.scrollTop;
 }
/********** END: screen handling **********/


/********** BEGIN: Event handling **********/
function jt_AddListener(obj, evType, fn) {
 if (obj.addEventListener) {
 obj.addEventListener(evType, fn, false);
 return true;
 }
 else if (obj.attachEvent) return obj.attachEvent('on' + evType, fn);
 else return false;
 }

function jt_fixE(ev) {
 var e = ev ? ev : window.event;
 return e;
 }
/********** END: Event handling **********/


/********** BEGIN: FORM handling **********/
function jt_setRadio(radioFld, val) {
 // set 'radioFld' button with value == val and return 'true' (if not disabled!)
 for (var i=0; i<radioFld.length; i++)
 if (radioFld[i].value == val)
 if (!radioFld[i].disabled) {
 radioFld[i].checked = true;
 return true;
 }
 return false;
 }

function jt_getRadio(radioFld) {
 // return value of selected 'radioFld' button
 var st = "";
 for (var i=0; i<radioFld.length; i++)
 if (radioFld[i].checked) {
 st = radioFld[i].value;
 break;
 }
 return st;
 }

function foSelected(pulldown) {
 // return value of selected item
 var st = "";
 for (var i=0; i<pulldown.options.length; i++)
 if (pulldown.options[i].selected) {
 if (pulldown.options[i].value) st = pulldown.options[i].value
 else st = pulldown.options[i].text;
 break;
 }
 return st;
 }

function foPosInList(pulldown, val) {
 // return position of 'val' in pulldown menu, -1 if not found
 if (val != "")
 for (var i=0; i<pulldown.options.length; i++) {
 var opVal = pulldown.options[i].value;
 if (opVal == "") opVal = pulldown.options[i].text;
 if (opVal == val) {
 return i;
 break;
 }
 }
 return -1;
 }

function foSetSelectVal(pulldown, val) {
 // set "SELECTED" for item in pulldown menu with 'value==val'
 var p = foPosInList(pulldown,val);
 if (p != -1) pulldown.options.selectedIndex = p;
 }

function jt_formStr(aForm) {
 var qSt = '';
 for (var i=0; i<aForm.elements.length; i++) {
 if ((aForm.elements[i].type == 'radio') || (aForm.elements[i].type == 'checkbox')) {
 if (aForm.elements[i].checked) qSt += '&' + aForm.elements[i].name + '=' + aForm.elements[i].value || 'checked';
 }
 else if (aForm.elements[i].type.indexOf('select') != -1) {
 for (var j=0; j<aForm.elements[i].options.length; j++) {
 if (aForm.elements[i].options[j].selected) qSt += '&' + aForm.elements[i].name + '=' + encodeURIComponent((aForm.elements[i].options[j].value) ? aForm.elements[i].options[j].value : aForm.elements[i].options[j].text);
 }
 }
 else if (!jt_strEmpty(aForm.elements[i].value)) qSt += '&' + aForm.elements[i].name + '=' + encodeURIComponent(aForm.elements[i].value);
 }
 return qSt;
 }
/********** END: FORM handling **********/


function jt_parseQuery(queryString) {
 // converts name/value pairs in 'queryString' to JS object
 var qObj = new Object();
 var stQuery = (queryString) ? queryString : location.search; // use 'location.search' if 'queryString' is null
 if (stQuery.indexOf("?") == 0) stQuery = stQuery.substring(1);
 if (stQuery) {
 var nvPairs = stQuery.split("&");
 for (var i=0; i < nvPairs.length; i++) {
 var posEq = nvPairs[i].indexOf("=");
 if (posEq != -1) {
 var nam = nvPairs[i].substring(0,posEq);
 if (nam.indexOf('.') == -1) qObj[nam] = nvPairs[i].substring(posEq+1);
 }
 }
 }
 return qObj;
 }

function jt_safeHTML(st) {
 // encode - same as 'u:htmlencode' tag
 if (st.length == 0) return "";
 st = st.replace(/</gi,"&lt;");
 st = st.replace(/>/gi,"&gt;");
 st = st.replace(/\"/gi,'&quot;');
 st = st.replace(/\'/gi,"&#39;");
 st = st.replace(/\\/gi,"&#92;");
 return st;
 }

function jt_unsafeHTML(st) {
 // decode - opposite of 'u:htmlencode' tag
 if (st.length == 0) return "";
 st = st.replace(/&lt;/gi,"<");
 st = st.replace(/&gt;/gi,">");
 st = st.replace(/&quot;/gi,'"');
 st = st.replace(/&#39;/gi,"'");
 st = st.replace(/&#92;/gi,"\\");
 return st;
 }

function jt_plural(qty, lbl) {
 // returns plural suffix or optional extended format if 'lbl' is present; example: qty=12, lbl="server", return value="12 servers"
 var stPlural = (qty == 1) ? "" : "s";
 if (lbl) stPlural = qty + " " + lbl + stPlural;
 return stPlural;
 }

function jt_alignCorner(elmToMove, elmAnchor, TlTrBlBr, xOffset, yOffset) {
 // aligns 'elmToMove' with 'elmAnchor' based on 2-character 'TlTrBlBr' indicating corner: 'TL' | 'TR' | 'BL' | 'BR'
 xOffset = xOffset ? xOffset : 0; // optional param
 yOffset = yOffset ? yOffset : 0; // optional param
 var anchorXY = jt_getOffsetXY(elmAnchor);
 var xxOffset = (TlTrBlBr.indexOf('R') != -1) ? elmToMove.offsetWidth - elmAnchor.offsetWidth : 0;
 var yyOffset = (TlTrBlBr.indexOf('B') != -1) ? elmToMove.offsetHeight : 0;
 jt_moveTo(elmToMove, anchorXY.x - xxOffset + xOffset, anchorXY.y - yyOffset + yOffset);
 }

function jt_divOnScrn(divOnScrn) {
 var divPos = jt_getOffsetXY(divOnScrn);
 var newX = divPos.x;
 var newY = divPos.y;
 if (divPos.x + divOnScrn.offsetWidth - document.body.scrollLeft > document.body.clientWidth) newX = document.body.scrollLeft + document.body.clientWidth - divOnScrn.offsetWidth;
 if (divPos.x < document.body.scrollLeft) newX = document.body.scrollLeft;
 if (divPos.y + divOnScrn.offsetHeight - document.body.scrollTop > document.body.clientHeight) newY = document.body.scrollTop + document.body.clientHeight - divOnScrn.offsetHeight;
 if (divPos.y < document.body.scrollTop) newY = document.body.scrollTop;
 if ((newX != divPos.x) || (newY != divPos.y)) jt_moveTo(divOnScrn, newX, newY);
 }

function jt_appendRelative(dragDIV, newParentDIV, xOffset, yOffset) {
 var dragPos = jt_getOffsetXY(dragDIV);
 var newParentPos = jt_getOffsetXY(newParentDIV);
 var xPos = dragPos.x - newParentPos.x;
 var yPos = dragPos.y - newParentPos.y;
 jt_moveTo(dragDIV, xPos + (xOffset ? xOffset : 0), yPos + (yOffset ? yOffset : 0));
 newParentDIV.appendChild(dragDIV);
 }

function jt_DelChildren(elm) {
 // remove all child nodes of 'elm' from DOM and delete them
 while (elm.hasChildNodes()) {
 var oldChild = elm.removeChild(elm.childNodes[elm.childNodes.length-1]);
 delete(oldChild);
 }
 }


// from http://www.quirksmode.org/js/detect.html
var BrowserDetect = {
 init: function () {
 this.browser = this.searchString(this.dataBrowser) || "An unknown browser";
 this.version = this.searchVersion(navigator.userAgent) || this.searchVersion(navigator.appVersion) || "an unknown version";
 this.OS = this.searchString(this.dataOS) || "an unknown OS";
 },
 searchString: function (data) {
 for (var i=0;i<data.length;i++) {
 var dataString = data[i].string;
 var dataProp = data[i].prop;
 this.versionSearchString = data[i].versionSearch || data[i].identity;
 if (dataString) {
 if (dataString.indexOf(data[i].subString) != -1) return data[i].identity;
 }
 else if (dataProp) return data[i].identity;
 }
 },
 searchVersion: function (dataString) {
 var index = dataString.indexOf(this.versionSearchString);
 if (index == -1) return;
 return parseFloat(dataString.substring(index+this.versionSearchString.length+1));
 },
 dataBrowser: [
 {string: navigator.vendor, subString: "Apple", identity: "Safari"},
 {prop: window.opera, identity: "Opera"},
 {string: navigator.vendor, subString: "iCab", identity: "iCab"},
 {string: navigator.vendor, subString: "KDE", identity: "Konqueror"},
 {string: navigator.userAgent, subString: "Firefox", identity: "Firefox"},
 {string: navigator.userAgent, subString: "Netscape", identity: "Netscape"}, // for newer Netscapes (6+)
 {string: navigator.userAgent, subString: "MSIE", identity: "Explorer", versionSearch: "MSIE"},
 {string: navigator.userAgent, subString: "Gecko", identity: "Mozilla", versionSearch: "rv"},
 {string: navigator.userAgent, subString: "Mozilla", identity: "Netscape", versionSearch: "Mozilla"} // for older Netscapes (4-)
 ],
 dataOS : [
 {string: navigator.platform, subString: "Win", identity: "Windows"},
 {string: navigator.platform, subString: "Mac", identity: "Mac"},
 {string: navigator.platform, subString: "Linux", identity: "Linux"}
 ]
 };
BrowserDetect.init();

var jt_FixPNG = (BrowserDetect.browser == 'Explorer') && (BrowserDetect.version < 7);

var spImg = new Image(); spImg.src = "/images/sp.gif";

function correctPNG(imgObj) {
 // IE only - must call image loads!
 if (jt_FixPNG) {
 if (typeof imgObj == 'string') imgObj = document.getElementById(imgObj);
 else if (!imgObj) {
 if (this) imgObj = this;
 else {
 var e = jt_fixE(imgObj);
 imgObj = e.target ? e.target : e.srcElement;
 }
 }
 imgObj.onload = null;
 if (imgObj.src.indexOf("sp.gif") == -1) {
 imgObj.style.width = jt_valPx(imgObj.attributes.width.value);
 imgObj.style.height = jt_valPx(imgObj.attributes.height.value);
 imgObj.style.filter = "progid:DXImageTransform.Microsoft.AlphaImageLoader(src='" + imgObj.src + "')";
 imgObj.src = spImg.src;
 }
 }
 }


function jt_boxOverlap(objectA, objectB, mode) {
 // box collision detector; returns area of overlap (if any) in pixels between DOM elements 'objectA' and 'objectB'
 // adapted from http://www.gamedev.net/reference/articles/article754.asp
 // 'mode' is optional - two special modes are offered:
 // mode='X' - test for overlap of X-coordinates only; ignore Y
 // mode='Y' - test for overlap of Y-coordinates only; ignore X
 var xyA = jt_getOffsetXY(objectA);
 var xyB = jt_getOffsetXY(objectB);

 var objAxTL = xyA.x; // AX1 - xTopLeft
 var objAyTL = xyA.y; // AY1 - yTopLeft
 var objAxBR = xyA.x + objectA.offsetWidth; // AX2 - xBottomRight
 var objAyBR = xyA.y + objectA.offsetHeight; // AY2 - yBottomRight

 var objBxTL = xyB.x; // BX1
 var objByTL = xyB.y; // BY1
 var objBxBR = xyB.x + objectB.offsetWidth; // BX2
 var objByBR = xyB.y + objectB.offsetHeight; // BY2
/*
alert("objAxTL=" + objAxTL + " - objAyTL=" + objAyTL + " - objAxBR=" + objAxBR + " - objAyBR=" + objAyBR + "\n" +
 "objBxTL=" + objBxTL + " - objByTL=" + objByTL + " - objBxBR=" + objBxBR + " - objByBR=" + objByBR);

reject the following conditions:
AX2<BX1
AY2<BY1
BX2<AX1
BY2<AY1
*/
 if (mode != 'Y') {
 if (objAxBR < objBxTL) return -1;
 if (objBxBR < objAxTL) return -1;
 }
 if (mode != 'X') {
 if (objAyBR < objByTL) return -1;
 if (objByBR < objAyTL) return -1;
 }
/*
If AX1<BX1 then CX1=BX1 and CX2=AX2, otherwise, CX1=AX1 and CX2=BX2
If AY1<BY1 then CY1=BY1 and CY2=AY2, otherwise, CY1=AY1 and CY2=BY2
*/
 var objCxTL;
 var objCyTL;
 var objCxBR;
 var objCyBR;
 if (objAxTL < objBxTL) {
 objCxTL = objBxTL;
 objCxBR = objAxBR;
 }
 else {
 objCxTL = objAxTL;
 objCxBR = objBxBR;
 }
 if (objAyTL < objByTL) {
 objCyTL = objByTL;
 objCyBR = objAyBR;
 }
 else {
 objCyTL = objAyTL;
 objCyBR = objByBR;
 }
 var olX = objCxBR - objCxTL;
 var olY = objCyBR - objCyTL;
 if (mode == 'X') return olX;
 else if (mode == 'Y') return olY;
 else return olX * olY;
 } // jt_boxOverlap


/********* BEGIN: jt_AnimCalc *********/
function jt_AnimCalc(callFunc, specs) {
 this._callFunc = callFunc;
 this.ranges = {};
 this._specs = {};
 this.setSpecs(jt_AnimCalc.defaultSpecs);
 if (specs) this.setSpecs(specs);
 }

jt_AnimCalc.prototype.setRange = function(name, from, to) {
 this.ranges[name] = {'from':from, 'to':to, 'delta':to - from};
 }

jt_AnimCalc.prototype.flipRange = function() {
 for(var prop in this.ranges) {
 var temp = this.ranges[prop].from;
 this.ranges[prop].from = this.ranges[prop].to;
 this.ranges[prop].to = temp;
 this.ranges[prop].delta = this.ranges[prop].to - this.ranges[prop].from;
 }
 }

jt_AnimCalc.prototype.start = function(callDone) {
 clearInterval(this.timer);
 this._callDone = callDone;
 this._callFunc(this.step = this._frac = 0);
 var _this = this;
 this.timer = setInterval(function() {
 _this.step++;
 _this._frac = (1 - Math.cos(_this.step * _this.piStep)) / 2;
 _this._callFunc(_this.step);
 if (_this.step == _this._specs.numSteps) {
 clearInterval(_this.timer);
 if (_this._callDone) _this._callDone();
 }
 },
 _this.interval);
 }

jt_AnimCalc.prototype.value = function(name) {
 return this.ranges[name].from + Math.round(this._frac * this.ranges[name].delta);
 }

jt_AnimCalc.prototype.setSpecs = function(specs) {
 for(var prop in specs) this._specs[prop] = specs[prop];
 this.interval = Math.round(this._specs.elapsed / this._specs.numSteps);
 this.piStep = Math.PI / this._specs.numSteps;
 }

jt_AnimCalc.defaultSpecs = {'numSteps':10, 'elapsed':333}
/********* END: jt_AnimCalc *********/


/********** BEGIN: trace feature **********/
var traceAreaDIV;
var traceAreaX = 100;
var traceAreaY = 50;
var traceAreaMax = 70;
var traceCount = 0;

function clearTrace() {
 traceAreaDIV.style.color = "#a9a9a9";
 traceAreaDIV.style.textAlign = "left";
 traceAreaDIV.innerHTML = '<a href="javascript:clearTrace()">clear trace</a><br>';
 }

function traceTxt(txt) {
 if (!traceAreaDIV) {
 traceAreaDIV = document.createElement("div");
 traceAreaDIV.style.position = "absolute";
 jt_moveTo(traceAreaDIV, traceAreaX, traceAreaY);
 document.body.appendChild(traceAreaDIV);
 }
 if (traceCount % traceAreaMax == 0) clearTrace();
 traceAreaDIV.innerHTML += txt + "<br>";
 traceCount++;
 }


var qParams = new jt_parseQuery(); // for session ID and trace

function traceMsg(msg) {
 if (qParams.trace == 1) traceTxt(msg);
 }

function traceXML(req, locMsg) {
 if (qParams.traceXML == 1) traceTxt(locMsg + "<br>" + jt_safeHTML(req.responseText).replace(/\n/gi,"<br>"));
 }
/********** END: trace feature **********/

function objToString(anObj, sep) {
 // convert any JS object to string of name:value pairs separated by optional 'sep'
 // NOTE: pass '<br />' for 'sep' to display as HTML
 if (!sep) sep = ' ][ '; // good for 'alert()' msgs
 var st = "";
 for(var prop in anObj) {
 if ((prop.charAt(0) == '$') || (prop == 'domConfig') || ((typeof anObj[prop]) == 'function')) continue;
 if (st != "") st += sep;
 st += prop + ':' + anObj[prop];
 }
 return st;
 }