/**
* jCarouselBlaze - enhancement to jCarouselBlaze plugin
* 
* Copyright (c) 2009 Geoff R G Williams (jcarouselblaze@primalblaze.com)
* Dual licensed under the MIT and GPL licenses:
* http://www.opensource.org/licenses/mit-license.php
* http://www.gnu.org/licenses/gpl.html
*
* Version: 1.0
*/

/**
* jCarouselBlaze - jQuery plugin to navigate images/any content in a carousel style widget.
* @requires jQuery v1.2 or above
*
* http://gmarwaha.com/jquery/jCarouselBlaze/
*
* Copyright (c) 2007 Ganeshji Marwaha (gmarwaha.com)
* Dual licensed under the MIT and GPL licenses:
* http://www.opensource.org/licenses/mit-license.php
* http://www.gnu.org/licenses/gpl.html
*
* Version: 1.0.1
* Note: Requires jquery 1.2 or above from version 1.0.1
*/

/**
* Creates a carousel-style navigation widget for images/any-content from a simple HTML markup.
*
* The HTML markup that is used to build the carousel can be as simple as...
*
*  <div class="carousel">
*      <ul>
*          <li><img src="image/1.jpg" alt="1"></li>
*          <li><img src="image/2.jpg" alt="2"></li>
*          <li><img src="image/3.jpg" alt="3"></li>
*      </ul>
*  </div>
*
* As you can see, this snippet is nothing but a simple div containing an unordered list of images.
* You don't need any special "class" attribute, or a special "css" file for this plugin.
* I am using a class attribute just for the sake of explanation here.
*
* To navigate the elements of the carousel, you need some kind of navigation buttons.
* For example, you will need a "previous" button to go backward, and a "next" button to go forward.
* This need not be part of the carousel "div" itself. It can be any element in your page.
* Lets assume that the following elements in your document can be used as next, and prev buttons...
*
* <button class="prev">&lt;&lt;</button>
* <button class="next">&gt;&gt;</button>
*
* Now, all you need to do is call the carousel component on the div element that represents it, and pass in the
* navigation buttons as options.
*
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev"
* });
*
* That's it, you would have now converted your raw div, into a magnificient carousel.
*
* There are quite a few other options that you can use to customize it though.
* Each will be explained with an example below.
*
* @param an options object - You can specify all the options shown below as an options object param.
*
* @option btnPrev, btnNext : string - no defaults
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev"
* });
* @desc Creates a basic carousel. Clicking "btnPrev" navigates backwards and "btnNext" navigates forward.
*
* @option btnGo - array - no defaults
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev",
*      btnGo: [".0", ".1", ".2"]
* });
* @desc If you don't want next and previous buttons for navigation, instead you prefer custom navigation based on
* the item number within the carousel, you can use this option. Just supply an array of selectors for each element
* in the carousel. The index of the array represents the index of the element. What i mean is, if the
* first element in the array is ".0", it means that when the element represented by ".0" is clicked, the carousel
* will slide to the first element and so on and so forth. This feature is very powerful. For example, i made a tabbed
* interface out of it by making my navigation elements styled like tabs in css. As the carousel is capable of holding
* any content, not just images, you can have a very simple tabbed navigation in minutes without using any other plugin.
* The best part is that, the tab will "slide" based on the provided effect. :-)
*
* @option mouseWheel : boolean - default is false
* @example
* $(".carousel").jCarouselBlaze({
*      mouseWheel: true
* });
* @desc The carousel can also be navigated using the mouse wheel interface of a scroll mouse instead of using buttons.
* To get this feature working, you have to do 2 things. First, you have to include the mouse-wheel plugin from brandon.
* Second, you will have to set the option "mouseWheel" to true. That's it, now you will be able to navigate your carousel
* using the mouse wheel. Using buttons and mouseWheel or not mutually exclusive. You can still have buttons for navigation
* as well. They complement each other. To use both together, just supply the options required for both as shown below.
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev",
*      mouseWheel: true
* });
*
* @option mouseHold : int - default is null
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev",
*      mouseHold: 200
* });
* @desc If not null, specifies that the repeatedclick (http://plugins.jquery.com/project/repeatedclick) plugin should be
*	engaged to ensure that the previous and next button action repeats every [mouseHold] milliseconds while the button is held down.
*
* @option auto : number - default is null, meaning autoscroll is disabled by default
* @example
* $(".carousel").jCarouselBlaze({
*      auto: 800,
*      speed: 500
* });
* @desc You can make your carousel auto-navigate itself by specfying a millisecond value in this option.
* The value you specify is the amount of time between 2 slides. The default is null, and that disables auto scrolling.
* Specify this value and magically your carousel will start auto scrolling.
*
* @option clickSelect : boolean - default is false
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev",
*      clickSelect: true
* });
* @desc If true, indicates that clicking an item in the list should scroll it to the primary position in the carousel.
*
* @option speed : number - 200 is default
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev",
*      speed: 800
* });
* @desc Specifying a speed will slow-down or speed-up the sliding speed of your carousel. Try it out with
* different speeds like 800, 600, 1500 etc. Providing 0, will remove the slide effect.
*
* @option easing : string - no easing effects by default.
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev",
*      easing: "bounceout"
* });
* @desc You can specify any easing effect. Note: You need easing plugin for that. Once specified,
* the carousel will slide based on the provided easing effect.
*
* @option vertical : boolean - default is false
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev",
*      vertical: true
* });
* @desc Determines the direction of the carousel. true, means the carousel will display vertically. The next and
* prev buttons will slide the items vertically as well. The default is false, which means that the carousel will
* display horizontally. The next and prev items will slide the items from left-right in this case.
*
* @option circular : boolean - default is true
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev",
*      circular: false
* });
* @desc Setting it to true enables circular navigation. This means, if you click "next" after you reach the last
* element, you will automatically slide to the first element and vice versa. If you set circular to false, then
* if you click on the "next" button after you reach the last element, you will stay in the last element itself
* and similarly for "previous" button and first element.
*
* @option visible : number - default is 3
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev",
*      visible: 4
* });
* @desc This specifies the number of items visible at all times within the carousel. The default is 3.
* You are even free to experiment with real numbers. Eg: "3.5" will have 3 items fully visible and the
* last item half visible. This gives you the effect of showing the user that there are more images to the right.
*
* @option size : number - default is null, meaning exact sizing is not used
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev",
*			 size: 48
* });
* @desc This specifies the width (horizontal) or height (vertical) of the carousel in pixels. The default is null meaning
* that the value of the "visible" property (default 3) is used to calculate the size required to display [visible] items.
* Specifying an exact size is recommended when using precise pixel layouts.
*
* @option align : string - default is "left" (horizontal) or "top" (vertical)
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev",
*			 align: "middle"
* });
* @desc Specifies how the items in the carousel should be aligned. Only has an effect where "size" is specified or "number"
* is not a whole number. "left", "middle" or "right" for horizontal layouts, "top", "middle" or "bottom" for vertical layouts.
* Also initializes the item with the index specified by the "start" option to this position.
*
* @option start : number - default is 0
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev",
*      start: 2
* });
* @desc You can specify from which item the carousel should start. Remember, the first item in the carousel
* has a start of 0, and so on.
*
* @option scrool : number - default is 1
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev",
*      scroll: 2
* });
* @desc The number of items that should scroll/slide when you click the next/prev navigation buttons. By
* default, only one item is scrolled, but you may set it to any number. Eg: setting it to "2" will scroll
* 2 items when you click the next or previous buttons.
*
* @option selectedItemClass : string - default is null
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev",
*      selectedItemClass: "selected"
* });
* @desc Css Class which should be applied to the primary selection in the carousel. Depending on the [align]
* setting, this list item will either be at the left/top, middle, or right/bottom of the carousel.
*
* @option beforeStart, afterEnd : function - callbacks
* @example
* $(".carousel").jCarouselBlaze({
*      btnNext: ".next",
*      btnPrev: ".prev",
*      beforeStart: function(a) {
*          alert("Before animation starts:" + a);
*      },
*      afterEnd: function(a) {
*          alert("After animation ends:" + a);
*      }
* });
* @desc If you wanted to do some logic in your page before the slide starts and after the slide ends, you can
* register these 2 callbacks. The functions will be passed an argument that represents an array of elements that
* are visible at the time of callback.
*
*
* @cat Plugins/Image Gallery
* @author Ganeshji Marwaha/ganeshread@gmail.com
*/

(function($) {                                          // Compliant with jquery.noConflict()
	$.fn.jCarouselBlaze = function(o) {
		o = $.extend({
			btnPrev: null,
			btnNext: null,
			btnGo: null,
			mouseWheel: false,
			mouseHold: null,
			auto: null,
			clickSelect: false,

			speed: 200,
			easing: null,

			vertical: false,
			circular: true,
			visible: 3,
			size: null,
			align: "left",
			start: 0,
			scroll: 1,
			pauseOnHover: false,

			selectedItemClass: null,

			beforeStart: null,
			afterEnd: null
		}, o || {});

		return this.each(function() {                           // Returns the element collection. Chainable.

			var running = false, animCss = o.vertical ? "top" : "left", sizeCss = o.vertical ? "height" : "width", adjStart = o.start;
			var div = $(this), ul = $("ul:first", div), tLi = $(">li", ul), tl = tLi.size(), sz = o.size, v = o.visible, al = (o.align == "bottom" || o.align == "right" ? 2 : (o.align == "top" || o.align == "left" ? 0 : 1)), paused = 0;

			var liSize = o.vertical ? height($(">li", ul)) : width($(">li", ul));   // Full li size(incl margin)-Used for animation
			var divSize = (sz != null ? sz : liSize * v);       // size of entire div(total length for just the visible items)

			function vis() {
				return li.slice(curr).slice(0, Math.ceil(v));
			};

			function go(to) {
				if (!running && !paused) {

					if (o.beforeStart)
						o.beforeStart.call(this, vis());

					if (o.circular) {            // If circular we are in first or last, then goto the other end
						if ((to - Math.ceil(ixOff)) <= adjStart - Math.ceil(v) - 1) {           // If first, then goto last
							curr = itemLength - (Math.ceil(v) * 2) + to;
							ul.css(animCss, -((curr + o.scroll - ixOff) * liSize) + "px");
						} else if ((to - Math.ceil(ixOff)) >= itemLength - Math.ceil(v) + 1) { // If last, then goto first
							curr = -(itemLength - (Math.ceil(v) * 2)) + to;
							ul.css(animCss, -((curr - o.scroll - ixOff) * liSize) + "px");
						} else curr = to;
					} else {                    // If non-circular and to points to first or last, we just return.
						if (to < 0 || to > itemLength - Math.ceil(v)) return;
						else curr = to;
					}                           // If neither overrides it, the curr will still be "to" and we can proceed.

					running = true;

					ul.animate(
                    animCss == "left" ? { left: -((curr - ixOff) * liSize)} : { top: -((curr - ixOff) * liSize) }, o.speed, o.easing,
                    function() {
                    	if (o.selectedItemClass) {
                    		li.removeClass(o.selectedItemClass);
                    		li.eq(curr).addClass(o.selectedItemClass);
                    	};
                    	if (o.afterEnd)
                    		o.afterEnd.call(this, vis());
                    	running = false;
                    }
                );
					// Disable buttons when the carousel reaches the last/first, and enable when not
					if (!o.circular) {
						$(o.btnPrev + "," + o.btnNext).removeClass("disabled");
						$((curr - o.scroll < 0 && o.btnPrev)
                        ||
                       (curr + o.scroll > itemLength - Math.ceil(v) && o.btnNext)
                        ||
                       []
                     ).addClass("disabled");
					}

				}
				return false;
			};

			v = divSize / liSize;

			if (!isNaN(v)) {

				var ixOff = (al == 0 ? 0 : (al == 1 ? ((divSize - liSize) / 2) : divSize - liSize)) / liSize;
				//var ixOff = (al == 0 ? 0 : (al == 1 ? ((v - Math.floor(v)) / 2) : v - Math.floor(v)));

				if (o.circular) {
					ul.prepend(tLi.slice(tl - Math.ceil(v)).clone())
              .append(tLi.slice(0, Math.ceil(v)).clone());
					adjStart += Math.ceil(v);
				}

				// Set pause flag
				o.pauseOnHover ? ul.hover(function() { paused = 1 }, function() { paused = 0 }) : "";

				var li = $(">li", ul), itemLength = li.size(), curr = adjStart;
				div.css("visibility", "visible");

				li.css({ overflow: "hidden", 'float': o.vertical ? "none" : "left" });
				ul.css({ margin: "0", padding: "0", position: "relative", "list-style-type": "none", "z-index": "1" });
				div.css({ overflow: "hidden", position: "relative", "z-index": "2", left: "0px" });

				var ulSize = liSize * itemLength;                   // size of full ul(total length, not just for the visible items)

				li.css({ width: li.width(), height: li.height() });
				if (ulSize > 0) {
					ul.css(sizeCss, ulSize + "px").css(animCss, -((curr - ixOff) * liSize) + "px");

					div.css(sizeCss, divSize + "px");                     // Width of the DIV. length of visible images
				};

				go(adjStart);

				if (o.btnPrev) {
					if (o.mouseHold != null && $(o.btnPrev).repeatedclick)
						$(o.btnPrev).repeatedclick(function() {
							return go(curr - o.scroll);
						}, { duration: o.mouseHold });
					else
						$(o.btnPrev).click(function() {
							return go(curr - o.scroll);
						});
				};

				if (o.btnNext) {
					if (o.mouseHold != null && $(o.btnNext).repeatedclick)
						$(o.btnNext).repeatedclick(function() {
							return go(curr + o.scroll);
						}, { duration: o.mouseHold });
					else
						$(o.btnNext).click(function() {
							return go(curr + o.scroll);
						});
				};

				if (o.btnGo)
					$.each(o.btnGo, function(i, val) {
						$(val).click(function() {
							return go(o.circular ? o.visible + i : i);
						});
					});

				if (o.mouseWheel && div.mousewheel)
					div.mousewheel(function(e, d) {
						return d > 0 ? go(curr - o.scroll) : go(curr + o.scroll);
					});

				if (o.auto)
					setInterval(function() {
						go(curr + o.scroll);
					}, o.auto + o.speed);

				if (o.clickSelect)
					li.each(function(i) {
						$(this).click(function() {
							if (o.selectedItemClass) {
								li.removeClass(o.selectedItemClass);
								li.eq(i).addClass(o.selectedItemClass);
							};
							go(i);
						});
					});
			};
		});
	};

	function css(el, prop) {
		return parseInt($.css(el[0], prop)) || 0;
	};
	function width(el) {
		if (!el[0]) return 0;
		return el[0].offsetWidth + css(el, 'marginLeft') + css(el, 'marginRight');
	};
	function height(el) {
		if (!el[0]) return 0;
		return el[0].offsetHeight + css(el, 'marginTop') + css(el, 'marginBottom');
	};

})(jQuery);