;\n\t\t\tdestPoint = new Point();\n\t\t\tsourceRect = new Rectangle();\n\t\t\t\n\t\t\tcurrentPeak = 0;\n\t\t\tlastPeak = 0;\n\t\t\t\n\t\t\ttimer = new Timer(45);\n\t\t\ttimer.addEventListener(TimerEvent.TIMER, peaksHandler);\n\t\t\treset();\n\t\t\t\n\t\t\tadd(back);\n\t\t\tadd(front);\n\t\t}\n\t\t\n\t\tpublic function useBitmap(image:Class):void\n\t\t{\n\t\t\tmeter = Bitmap(new image).bitmapData.clone();\n\t\t\tclone();\n\t\t}\n\t\t\n\t\tpublic function useDraw():void\n\t\t{\n\t\t\tmeter.dispose();\n\t\t\tmeter = null;\n\t\t\tdrawDisplay();\n\t\t}\n\t\t\n\t\tprotected function reset():void\n\t\t{\n\t\t\ttimer.reset();\n\t\t\tlevels.length = m_columns;\n\t\t\tfor (var i:int = 0; i < m_columns; ++i)\n\t\t\t\tlevels[i] = 0;\n\t\t\t\n\t\t\tbackground.alpha = m_backgroundAlpha;\n\t\t\tbackground.rotation = 0;\n\t\t\tbackground.x = 0;\n\t\t\tbackground.y = 0;\n\t\t\tforeground.rotation = 0;\n\t\t\tforeground.x = 0;\n\t\t\tforeground.y = 0;\n\t\t\tif (meter)\n\t\t\t\tclone();\n\t\t\telse\n\t\t\t\tdrawDisplay();\n\t\t}\n\t\t\n\t\tpublic function set x(x:int):void\n\t\t{\n\t\t\tback.x = x;\n\t\t\tfront.x = x;\n\t\t}\n\t\t\n\t\tpublic function get x():int\n\t\t{\n\t\t\treturn front.x;\n\t\t}\n\t\t\n\t\tpublic function set y(y:int):void\n\t\t{\n\t\t\tback.y = y;\n\t\t\tfront.y = y;\n\t\t}\n\t\t\n\t\tpublic function get y():int\n\t\t{\n\t\t\treturn front.y;\n\t\t}\n\t\t\n\t\tprotected function start():void\n\t\t{\n\t\t\tif (!soundEx)\n\t\t\t\treturn;\n\t\t\ttimer.reset();\n\t\t\ttimer.start();\n\t\t}\n\t\t\n\t\tprotected function clone():void\n\t\t{\n\t\t\tsectionWidth = meter.width + m_columnSpacing;\n\t\t\tsectionHeight = m_rowSize + m_rowSpacing;\n\t\t\trealHeight = meter.height + m_rowSpacing;\n\t\t\t\n\t\t\tvar h:int = meter.height, i:int, w:int = m_columns * sectionWidth - m_columnSpacing;\n\t\t\t\n\t\t\toutput = new BitmapData(w, h, true, 0);\n\t\t\tbuffer = output.clone();\n\t\t\toutput.lock();\n\t\t\tdestPoint.x = 0;\n\t\t\t\n\t\t\tfor (i = 0; i < m_columns; ++i)\n\t\t\t{\n\t\t\t\toutput.copyPixels(meter, meter.rect, destPoint);\n\t\t\t\tdestPoint.x += sectionWidth;\n\t\t\t}\n\t\t\t\n\t\t\tm_rows = realHeight / sectionHeight;\n\t\t\t\n\t\t\tif (m_rowSpacing > 0)\n\t\t\t{\n\t\t\t\tsourceRect.width = w;\n\t\t\t\tsourceRect.height = m_rowSpacing;\n\t\t\t\tsourceRect.y = h - sectionHeight;\n\t\t\t\t\n\t\t\t\tfor (i = 0; i < m_rows; ++i)\n\t\t\t\t{\n\t\t\t\t\toutput.fillRect(sourceRect, 0);\n\t\t\t\t\tsourceRect.y -= sectionHeight;\n\t\t\t\t}\n\t\t\t}\n\t\t\t\n\t\t\toutput.unlock();\n\t\t\tdestPoint.x = 0;\n\t\t\tsourceRect.width = m_columnSize = meter.width;\n\t\t\t\n\t\t\tinput = buffer.clone();\n\t\t\tinput.threshold(output, output.rect, destPoint, \"==\", 0xff000000, 0x00ffffff, 0xffffffff, true);\n\t\t\toutput.fillRect(output.rect, 0);\n\t\t\t\n\t\t\tbackground.bitmapData = input;\n\t\t\t\n\t\t\tforeground.bitmapData = output;\n\t\t\t\n\t\t\tif (m_direction != UP)\n\t\t\t\tdirection = m_direction;\n\t\t}\n\t\t\n\t\tpublic function get width():int\n\t\t{\n\t\t\treturn output.width;\n\t\t}\n\t\t\n\t\tpublic function get height():int\n\t\t{\n\t\t\treturn output.height;\n\t\t}\n\t\t\n\t\tprotected function drawDisplay():void\n\t\t{\n\t\t\tsectionWidth = m_columnSize + m_columnSpacing;\n\t\t\tsectionHeight = m_rowSize + m_rowSpacing;\n\t\t\trealHeight = m_rows * sectionHeight;\n\t\t\t\n\t\t\tvar h:int = realHeight - m_rowSpacing, i:int, matrix:Matrix, p:int = m_rowSize, w:int = m_columns * sectionWidth - m_columnSpacing;\n\t\t\t\n\t\t\tif (m_colors.length < 2)\n\t\t\t{\n\t\t\t\tcanvas.graphics.beginFill(m_colors[0], m_alphas[0]);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tmatrix = new Matrix();\n\t\t\t\tmatrix.createGradientBox(w, h, Math.PI * 0.5, 0, 0);\n\t\t\t\tcanvas.graphics.beginGradientFill(GradientType.LINEAR, m_colors, m_alphas, m_ratios, matrix, SpreadMethod.PAD, InterpolationMethod.LINEAR_RGB);\n\t\t\t}\n\t\t\tcanvas.graphics.drawRect(0, 0, w, h);\n\t\t\tcanvas.graphics.endFill();\n\t\t\t\n\t\t\tfor (i = 0; i < m_rows; ++i)\n\t\t\t{\n\t\t\t\tcanvas.graphics.beginFill(0, 1);\n\t\t\t\tcanvas.graphics.drawRect(0, p, w, m_rowSpacing);\n\t\t\t\tcanvas.graphics.endFill();\n\t\t\t\tp += sectionHeight;\n\t\t\t}\n\t\t\tp = m_columnSize;\n\t\t\t\n\t\t\tfor (i = 1; i < m_columns; ++i)\n\t\t\t{\n\t\t\t\tcanvas.graphics.beginFill(0, 1);\n\t\t\t\tcanvas.graphics.drawRect(p, 0, m_columnSpacing, h);\n\t\t\t\tcanvas.graphics.endFill();\n\t\t\t\tp += sectionWidth;\n\t\t\t}\n\t\t\toutput = new BitmapData(w, h, true, 0);\n\t\t\tbuffer = output.clone();\n\t\t\toutput.draw(canvas);\n\t\t\tcanvas.graphics.clear();\n\t\t\t\n\t\t\tinput = buffer.clone();\n\t\t\tinput.threshold(output, output.rect, destPoint, \"==\", 0xff000000, 0x00ffffff, 0xffffffff, true);\n\t\t\toutput.fillRect(output.rect, 0);\n\t\t\t\n\t\t\tbackground.bitmapData = input;\n\t\t\t\n\t\t\tforeground.bitmapData = output;\n\t\t\t\n\t\t\tsourceRect.width = m_columnSize;\n\t\t\t\n\t\t\tif (m_direction != UP)\n\t\t\t\tdirection = m_direction;\n\t\t}\n\t\t\n\t\tprotected function startHandler(e:Event):void\n\t\t{\n\t\t\tm_soundEx.removeEventListener(SoundEx.SOUND_START, startHandler);\n\t\t\tm_soundEx.addEventListener(SoundEx.SOUND_STOP, stopHandler);\n\t\t\tm_soundEx.addEventListener(Event.SOUND_COMPLETE, stopHandler);\n\t\t\ttimer.removeEventListener(TimerEvent.TIMER_COMPLETE, completeHandler);\n\t\t\ttimer.repeatCount = 0;\n\t\t\tstart();\n\t\t}\n\t\t\n\t\tprotected function stopHandler(e:Event):void\n\t\t{\n\t\t\tvar i:int, t:Number = 0.0;\n\t\t\t\n\t\t\tfor (i = 0; i < m_columns; ++i)\n\t\t\t\tif (levels[i] > t)\n\t\t\t\t\tt = levels[i];\n\t\t\t\n\t\t\tm_soundEx.removeEventListener(Event.SOUND_COMPLETE, stopHandler);\n\t\t\tm_soundEx.removeEventListener(SoundEx.SOUND_STOP, stopHandler);\n\t\t\tm_soundEx.addEventListener(SoundEx.SOUND_START, startHandler);\n\t\t\t\n\t\t\ttimer.reset();\n\t\t\ttimer.repeatCount = int(t / m_decay) + 1;\n\t\t\ttimer.addEventListener(TimerEvent.TIMER_COMPLETE, completeHandler);\n\t\t\ttimer.start();\n\t\t}\n\t\t\n\t\tprotected function completeHandler(e:Event):void\n\t\t{\n\t\t\tif (backgroundBeat)\n\t\t\t\tbackground.alpha = m_backgroundAlpha;\n\t\t\ttimer.reset();\n\t\t\ttimer.removeEventListener(TimerEvent.TIMER_COMPLETE, completeHandler);\n\t\t}\n\t\t\n\t\tprotected function meterHandler(e:TimerEvent):void\n\t\t{\n\t\t\tvar h:int, i:int;\n\t\t\tspectrum = m_soundEx.getStereoAdd(m_columns);\n\t\t\tbuffer.fillRect(buffer.rect, 0);\n\t\t\tsourceRect.x = 0;\n\t\t\t\n\t\t\tfor (i = 0; i < m_columns; ++i)\n\t\t\t{\n\t\t\t\th = int(spectrum[i] * m_rows) * sectionHeight;\n\t\t\t\tsourceRect.height = h;\n\t\t\t\tsourceRect.y = realHeight - h;\n\t\t\t\tbuffer.fillRect(sourceRect, 0xff000000);\n\t\t\t\tsourceRect.x += sectionWidth;\n\t\t\t}\n\t\t\toutput.copyPixels(input, input.rect, destPoint, buffer);\n\t\t\tif (backgroundBeat)\n\t\t\t\tbackground.alpha = m_soundEx.peak;\n\t\t\te.updateAfterEvent();\n\t\t}\n\t\t\n\t\tprotected function decayHandler(e:TimerEvent):void\n\t\t{\n\t\t\tvar a:Number, h:int, i:int;\n\t\t\tspectrum = m_soundEx.getStereoSampling(m_columns);\n\t\t\toutput.lock();\n\t\t\tsourceRect.x = 0;\n\t\t\tbuffer.fillRect(buffer.rect, m_decayAlpha);\n\t\t\toutput.copyPixels(output, output.rect, destPoint, buffer);\n\t\t\tbuffer.fillRect(buffer.rect, 0);\n\t\t\t\n\t\t\tfor (i = 0; i < m_columns; ++i)\n\t\t\t{\n\t\t\t\ta = spectrum[i];\n\t\t\t\tif (a > levels[i])\n\t\t\t\t\tlevels[i] = a;\n\t\t\t\th = int(levels[i] * m_rows) * sectionHeight;\n\t\t\t\tsourceRect.height = h;\n\t\t\t\tsourceRect.y = realHeight - h;\n\t\t\t\tbuffer.fillRect(sourceRect, m_peaksAlpha);\n\t\t\t\tsourceRect.x += sectionWidth;\n\t\t\t\tlevels[i] -= m_decay;\n\t\t\t}\n\t\t\toutput.copyPixels(input, input.rect, destPoint, buffer, null, true);\n\t\t\toutput.unlock();\n\t\t\tif (backgroundBeat)\n\t\t\t\tbackground.alpha = m_soundEx.peak;\n\t\t\te.updateAfterEvent();\n\t\t}\n\t\t\n\t\tprotected function peaksHandler(e:TimerEvent):void\n\t\t{\n\t\t\tvar a:Number, h:int, i:int;\n\t\t\tspectrum = m_soundEx.getStereoAdd(m_columns);\n\t\t\tbuffer.fillRect(buffer.rect, 0);\n\t\t\tsourceRect.x = 0;\n\t\t\t\n\t\t\tfor (i = 0; i < m_columns; ++i)\n\t\t\t{\n\t\t\t\ta = spectrum[i];\n\t\t\t\th = int(a * m_rows) * sectionHeight;\n\t\t\t\tsourceRect.height = h;\n\t\t\t\tsourceRect.y = realHeight - h;\n\t\t\t\tbuffer.fillRect(sourceRect, 0xff000000);\n\t\t\t\t\n\t\t\t\tif (a > levels[i])\n\t\t\t\t{\n\t\t\t\t\tlevels[i] = a;\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\th = int(levels[i] * m_rows) * sectionHeight;\n\t\t\t\t\tsourceRect.y = realHeight - h;\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\tsourceRect.height = m_rowSize;\n\t\t\t\tbuffer.fillRect(sourceRect, m_peaksAlpha);\n\t\t\t\tsourceRect.x += sectionWidth;\n\t\t\t\tlevels[i] -= m_decay;\n\t\t\t}\n\t\t\t\n\t\t\toutput.copyPixels(input, input.rect, destPoint, buffer);\n\t\t\t\n\t\t\tif (backgroundBeat)\n\t\t\t{\n\t\t\t\tbackground.alpha = m_soundEx.peak;\n\t\t\t}\n\t\t\t\n\t\t\tcurrentPeak = getTimer();\n\t\t\t\t\n\t\t\te.updateAfterEvent();\n\t\t}\n\t\t\n\t\toverride public function update():void\n\t\t{\n\t\t\t//\tAvoids doing this every single frame, rather only when the meter has peaked\n\t\t\tif (currentPeak > lastPeak)\n\t\t\t{\n\t\t\t\tlastPeak = currentPeak;\n\t\t\t\t\n\t\t\t\tif (foreground)\n\t\t\t\t{\n\t\t\t\t\tfront.pixels = foreground.bitmapData;\n\t\t\t\t\tfront.alpha = foreground.alpha;\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\tif (background)\n\t\t\t\t{\n\t\t\t\t\tback.pixels = background.bitmapData;\n\t\t\t\t\tback.alpha = background.alpha;\n\t\t\t\t}\n\t\t\t}\n\t\t\t\n\t\t\tsuper.update();\n\t\t}\n\t\t\n\t\tpublic function get soundEx():SoundEx\n\t\t{\n\t\t\treturn m_soundEx;\n\t\t}\n\t\t\n\t\tpublic function set soundEx(value:SoundEx):void\n\t\t{\n\t\t\tif (m_soundEx)\n\t\t\t\tm_soundEx.removeEventListener(SoundEx.SOUND_START, startHandler);\n\t\t\tm_soundEx = value;\n\t\t\tvalue.addEventListener(SoundEx.SOUND_START, startHandler);\n\t\t}\n\t\t\n\t\tpublic function get direction():String\n\t\t{\n\t\t\treturn m_direction;\n\t\t}\n\t\t\n\t\tpublic function set direction(value:String):void\n\t\t{\n\t\t\tif (value == m_direction || !FlxFlectrum[value.toUpperCase()])\n\t\t\t\treturn;\n\t\t\t\n\t\t\tswitch (value)\n\t\t\t{\n\t\t\t\tcase UP: \n\t\t\t\t\tfront.angle = 0;\n\t\t\t\t\tbreak;\n\t\t\t\tcase LEFT: \n\t\t\t\t\tfront.angle = 270;\n\t\t\t\t\tbreak;\n\t\t\t\tcase DOWN: \n\t\t\t\t\tfront.angle = 180;\n\t\t\t\t\tbreak;\n\t\t\t\tcase RIGHT: \n\t\t\t\t\tfront.angle = 90;\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t\t\n\t\t\tback.angle = front.angle;\n\t\t\tm_direction = value;\n\t\t}\n\t\t\n\t\tpublic function get mode():String\n\t\t{\n\t\t\treturn m_mode;\n\t\t}\n\t\t\n\t\tpublic function set mode(value:String):void\n\t\t{\n\t\t\tif (value == m_mode || !FlxFlectrum[value.toUpperCase()])\n\t\t\t\treturn;\n\t\t\ttimer.removeEventListener(TimerEvent.TIMER, this[m_mode + \"Handler\"]);\n\t\t\ttimer.addEventListener(TimerEvent.TIMER, this[value + \"Handler\"]);\n\t\t\tm_mode = value;\n\t\t}\n\t\t\n\t\tpublic function get delay():int\n\t\t{\n\t\t\treturn timer.delay;\n\t\t}\n\t\t\n\t\tpublic function set delay(value:int):void\n\t\t{\n\t\t\ttimer.delay = value;\n\t\t}\n\t\t\n\t\tpublic function get columns():int\n\t\t{\n\t\t\treturn m_columns;\n\t\t}\n\t\t\n\t\tpublic function set columns(value:int):void\n\t\t{\n\t\t\tif (value == m_columns)\n\t\t\t\treturn;\n\t\t\tif (value < 2)\n\t\t\t\tvalue = 2;\n\t\t\telse if (value > 256)\n\t\t\t\tvalue = 256;\n\t\t\tm_columns = value;\n\t\t\treset();\n\t\t}\n\t\t\n\t\tpublic function get columnSize():int\n\t\t{\n\t\t\treturn m_columnSize;\n\t\t}\n\t\t\n\t\tpublic function set columnSize(value:int):void\n\t\t{\n\t\t\tif (value == m_columnSize)\n\t\t\t\treturn;\n\t\t\tif (value < 1)\n\t\t\t\tvalue = 1;\n\t\t\tm_columnSize = value;\n\t\t\treset();\n\t\t}\n\t\t\n\t\tpublic function get columnSpacing():int\n\t\t{\n\t\t\treturn m_columnSpacing;\n\t\t}\n\t\t\n\t\tpublic function set columnSpacing(value:int):void\n\t\t{\n\t\t\tif (value == m_columnSpacing)\n\t\t\t\treturn;\n\t\t\tm_columnSpacing = value;\n\t\t\treset();\n\t\t}\n\t\t\n\t\tpublic function get rows():int\n\t\t{\n\t\t\treturn m_rows;\n\t\t}\n\t\t\n\t\tpublic function set rows(value:int):void\n\t\t{\n\t\t\tif (value == m_rows)\n\t\t\t\treturn;\n\t\t\tif (value < 3)\n\t\t\t\tvalue = 3;\n\t\t\tm_rows = value;\n\t\t\treset();\n\t\t}\n\t\t\n\t\tpublic function get rowSize():int\n\t\t{\n\t\t\treturn m_rowSize;\n\t\t}\n\t\t\n\t\tpublic function set rowSize(value:int):void\n\t\t{\n\t\t\tif (value == m_rowSize)\n\t\t\t\treturn;\n\t\t\tif (value < 1)\n\t\t\t\tvalue = 1;\n\t\t\tm_rowSize = value;\n\t\t\treset();\n\t\t}\n\t\t\n\t\tpublic function get rowSpacing():int\n\t\t{\n\t\t\treturn m_rowSpacing;\n\t\t}\n\t\t\n\t\tpublic function set rowSpacing(value:int):void\n\t\t{\n\t\t\tif (value == m_rowSpacing)\n\t\t\t\treturn;\n\t\t\tm_rowSpacing = value;\n\t\t\treset();\n\t\t}\n\t\t\n\t\tpublic function get showBackground():Boolean\n\t\t{\n\t\t\treturn m_showBackground;\n\t\t}\n\t\t\n\t\tpublic function set showBackground(value:Boolean):void\n\t\t{\n\t\t\tif (value)\n\t\t\t{\n\t\t\t\tback.visible = true;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tback.visible = false;\n\t\t\t}\n\t\t\t\n\t\t\tif (value == m_showBackground)\n\t\t\t\treturn;\n\t\t\tm_showBackground = value;\n\t\t\treset();\n\t\t}\n\t\t\n\t\tpublic function get backgroundAlpha():Number\n\t\t{\n\t\t\treturn m_backgroundAlpha;\n\t\t}\n\t\t\n\t\tpublic function set backgroundAlpha(value:Number):void\n\t\t{\n\t\t\tbackground.alpha = m_backgroundAlpha = value;\n\t\t}\n\t\t\n\t\tpublic function get decay():Number\n\t\t{\n\t\t\treturn m_decay;\n\t\t}\n\t\t\n\t\tpublic function set decay(value:Number):void\n\t\t{\n\t\t\tif (value < 0)\n\t\t\t\tvalue = 0;\n\t\t\telse if (value > 1)\n\t\t\t\tvalue = 1;\n\t\t\tm_decay = value;\n\t\t}\n\t\t\n\t\tpublic function get decayAlpha():Number\n\t\t{\n\t\t\treturn m_decayAlpha / 255;\n\t\t}\n\t\t\n\t\tpublic function set decayAlpha(value:Number):void\n\t\t{\n\t\t\tif (value < 0)\n\t\t\t\tvalue = 0;\n\t\t\telse if (value > 1)\n\t\t\t\tvalue = 1;\n\t\t\tm_decayAlpha = int(value * 255) << 24;\n\t\t}\n\t\t\n\t\tpublic function get peaksAlpha():Number\n\t\t{\n\t\t\treturn m_peaksAlpha / 255;\n\t\t}\n\t\t\n\t\tpublic function set peaksAlpha(value:Number):void\n\t\t{\n\t\t\tif (value < 0)\n\t\t\t\tvalue = 0;\n\t\t\telse if (value > 1)\n\t\t\t\tvalue = 1;\n\t\t\tm_peaksAlpha = int(value * 255) << 24;\n\t\t}\n\t}\n}"
},
{
"path": "src/org/flixel/plugin/photonstorm/FlxFlod.as",
"content": "/**\n * FlxFlod\n * -- Part of the Flixel Power Tools set\n * \n * v1.3 Added full FlxFlectrum support\n * v1.2 Updated for the Flixel 2.5 Plugin system\n * \n * @version 1.3 - July 29th 2011\n * @link http://www.photonstorm.com\n * @author Richard Davey / Photon Storm\n*/\n\npackage org.flixel.plugin.photonstorm \n{\n\timport neoart.flectrum.Flectrum;\n\timport neoart.flectrum.SoundEx;\n\timport org.flixel.*;\n\timport neoart.flod.*;\n\t\n\timport flash.utils.ByteArray;\n\timport flash.media.SoundTransform;\n\t\n\t/**\n\t * FlxFlod adds support for the Flod AS3 Replay library by Christian Corti.
\n\t * Flod is an incredibly powerful library allowing you to play tracker music from the Amiga / ST / PC (SoundTracker, ProTracker, etc)
\n\t * More information about Flod can be found here: http://www.photonstorm.com/flod
\n\t * \n\t * This class works without modifying flixel, however the mute/volume/pause/resume commands won't be hooked into flixel.
\n\t * You can either use a patched version of Flixel which is provided in this repository:
\n\t * flash-game-dev-tips\\Flixel Versions\\Flixel v2.43 Patch 1.0\n\t *
\n\t * Or you can patch FlxG manually by doing the following:
\n\t * \n\t * 1) Add import com.photonstorm.flixel.FlxFlod; at the top of FlxG.as:
\n\t * 2) Find the function static public function set mute(Mute:Boolean):void and add this line at the end of it: FlxFlod.mute = Mute;
\n\t * 3) Find the function static public function set volume(Volume:Number):void and add this line at the end of it: FlxFlod.volume = Volume;
\n\t * 4) Find the function static protected function pauseSounds():void and add this line at the end of it: FlxFlod.pause();
\n\t * 5) Find the function static protected function playSounds():void and add this line at the end of it: FlxFlod.resume();
\n\t * \n\t * Flixel will now be patched so that any music playing via FlxFlod responds to the global flixel mute, volume and pause controls\n\t */\n\t\n\tpublic class FlxFlod\n\t{\n\t\tprivate static var processor:ModProcessor;\n\t\tprivate static var modStream:ByteArray;\n\t\tprivate static var soundform:SoundTransform = new SoundTransform();\n\t\t\n\t\tprivate static var fadeTimer:FlxDelay;\n\t\t\n\t\tprivate static var callbackHooksCreated:Boolean = false;\n\t\t\n\t\tprivate static var sound:SoundEx = new SoundEx;\n\t\tpublic static var flectrum:FlxFlectrum;\n\t\t\n\t\t/**\n\t\t * Starts playback of a tracker module\n\t\t * \n\t\t * @param\ttoon\tThe music to play\n\t\t * \n\t\t * @return\tBoolean\ttrue if playback started successfully, false if not\n\t\t */\n\t\tpublic static function playMod(toon:Class):Boolean\n\t\t{\n\t\t\tstopMod();\n\t\t\t\n\t\t\tmodStream = new toon() as ByteArray;\n\t\t\t\n\t\t\tprocessor = new ModProcessor();\n\t\t\t\n\t\t\tif (processor.load(modStream))\n\t\t\t{\n\t\t\t\tprocessor.loopSong = true;\n\t\t\t\tprocessor.stereo = 0;\n\t\t\t\tprocessor.play(sound);\n\t\t\t\t\n\t\t\t\tif (processor.soundChannel)\n\t\t\t\t{\n\t\t\t\t\tsoundform.volume = FlxG.volume;\n\t\t\t\t\tprocessor.soundChannel.soundTransform = soundform;\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\tif (callbackHooksCreated == false)\n\t\t\t\t{\n\t\t\t\t\tFlxG.volumeHandler = updateVolume;\n\t\t\t\t\tcallbackHooksCreated = true;\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\treturn true;\n\t\t\t\t\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates a Flectrum (VU Meter / Spectrum Analyser)\n\t\t * \n\t\t * @param\tx\t\t\t\tThe x position of the flectrum in game world coordinates\n\t\t * @param\ty\t\t\t\tThe y position of the flectrum in game world coordinates\n\t\t * @param\tmeter\t\t\tA graphic to use for the meter (bar) of the flectrum. Default null uses a solid fill rectangle.\n\t\t * @param\tshowBackground\tDisplay an alpha background behind the meters\n\t\t * @param\tbackgroundBeat\tMakes the alpha background pulsate in time to the music\n\t\t * @param\tcolumns\t\t\tThe number of columns in the flectrum\n\t\t * @param\tcolumnSize\t\tThe width of each column in pixels - if you use your own meter graphic this value is ignored\n\t\t * @param\tcolumnSpacing\tThe spacing in pixels between each column (meter) of the flectrum\n\t\t * @param\trows\t\t\tThe number of rows in the flectrum\n\t\t * @param\trowSize\t\t\tThe height of each row. Overall flectrum height is rowSize + rowSpacing * rows - if you use your own meter graphic this value is ignored\n\t\t * @param\trowSpacing\t\tThe spacing in pixels between each row of the flectrum - if you use your own meter graphic this value is ignored\n\t\t * \n\t\t * @return\tThe FlxFlectrum instance for further modification. Also available via FlxFlod.flectrum\n\t\t */\n\t\tpublic static function createFlectrum(x:int, y:int, meter:Class = null, showBackground:Boolean = false, backgroundBeat:Boolean = false, columns:int = 15, columnSize:int = 10, columnSpacing:int = 0, rows:int = 32, rowSize:int = 3, rowSpacing:int = 0):FlxFlectrum\n\t\t{\n\t\t\tflectrum = new FlxFlectrum();\n\t\t\t\n\t\t\tflectrum.init(x, y, sound, columns, columnSize, columnSpacing, rows, rowSize, rowSpacing);\n\t\t\t\n\t\t\tif (meter)\n\t\t\t{\n\t\t\t\tflectrum.useBitmap(meter);\n\t\t\t}\n\t\t\t\n\t\t\tflectrum.showBackground = showBackground;\n\t\t\tflectrum.backgroundBeat = backgroundBeat;\n\t\t\t\n\t\t\treturn flectrum;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Pauses playback of this module, if started\n\t\t */\n\t\tpublic static function pause():void\n\t\t{\n\t\t\tif (processor)\n\t\t\t{\n\t\t\t\tprocessor.pause();\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Resumes playback of this module if paused\n\t\t */\n\t\tpublic static function resume():void\n\t\t{\n\t\t\tif (processor)\n\t\t\t{\n\t\t\t\tprocessor.resume();\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Stops playback of this module, if started\n\t\t */\n\t\tpublic static function stopMod():void\n\t\t{\n\t\t\tif (processor)\n\t\t\t{\n\t\t\t\tprocessor.stop();\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Toggles playback mute\n\t\t */\n\t\tpublic static function set mute(Mute:Boolean):void\n\t\t{\n\t\t\tif (processor)\n\t\t\t{\n\t\t\t\tif (Mute)\n\t\t\t\t{\n\t\t\t\t\tif (processor.soundChannel)\n\t\t\t\t\t{\n\t\t\t\t\t\tsoundform.volume = 0;\n\t\t\t\t\t\tprocessor.soundChannel.soundTransform = soundform;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\tif (processor.soundChannel)\n\t\t\t\t\t{\n\t\t\t\t\t\tsoundform.volume = FlxG.volume;\n\t\t\t\t\t\tprocessor.soundChannel.soundTransform = soundform;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Called by FlxG when the volume is adjusted in-game\n\t\t * \n\t\t * @param\tVolume\n\t\t */\n\t\tpublic static function updateVolume(Volume:Number):void\n\t\t{\n\t\t\tvolume = Volume;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Sets the playback volume directly (usually controlled by FlxG.volume)\n\t\t */\n\t\tpublic static function set volume(Volume:Number):void\n\t\t{\n\t\t\tif (processor)\n\t\t\t{\n\t\t\t\tif (processor.soundChannel)\n\t\t\t\t{\n\t\t\t\t\tsoundform.volume = Volume;\n\t\t\t\t\tprocessor.soundChannel.soundTransform = soundform;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Is a tune already playing?\n\t\t */\n\t\tpublic static function get isPlaying():Boolean\n\t\t{\n\t\t\tif (processor)\n\t\t\t{\n\t\t\t\treturn processor.isPlaying;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Is a tune paused?\n\t\t */\n\t\tpublic static function get isPaused():Boolean\n\t\t{\n\t\t\tif (processor)\n\t\t\t{\n\t\t\t\treturn processor.isPaused;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\t\t\n\t}\n\n}"
},
{
"path": "src/org/flixel/plugin/photonstorm/FlxGradient.as",
"content": "/**\n * FlxGradient\n * -- Part of the Flixel Power Tools set\n * \n * v1.6 Fixed bug where gradients with chunk sizes > 1 would ignore alpha values\n * v1.5 Alpha values used in the gradient map\n * v1.4 Updated for the Flixel 2.5 Plugin system\n * \n * @version 1.6 - May 9th 2011\n * @link http://www.photonstorm.com\n * @author Richard Davey / Photon Storm\n * @see Requires FlxMath\n*/\n\npackage org.flixel.plugin.photonstorm \n{\n\timport flash.geom.Point;\n\timport flash.geom.Rectangle;\n\timport org.flixel.*;\n\t\n\timport flash.display.Bitmap;\n\timport flash.geom.Matrix;\n\timport flash.display.BitmapData;\n\timport flash.display.Shape;\n\timport flash.display.GradientType; \n\timport flash.display.SpreadMethod;\n\timport flash.display.InterpolationMethod;\n\t\n\t/**\n\t * Adds a set of color gradient creation / rendering functions\n\t */\n\tpublic class FlxGradient\n\t{\n\t\t\n\t\tpublic function FlxGradient() \n\t\t{\n\t\t}\n\t\t\n\t\tpublic static function createGradientMatrix(width:int, height:int, colors:Array, chunkSize:int = 1, rotation:int = 90):Object\n\t\t{\n\t\t\tvar gradientMatrix:Matrix = new Matrix();\n\t\t\t\n\t\t\t//\tRotation (in radians) that the gradient is rotated\n\t\t\tvar rot:Number = FlxMath.asRadians(rotation);\n\t\t\t\n\t\t\t//\tLast 2 values = horizontal and vertical shift (in pixels)\n\t\t\tif (chunkSize == 1)\n\t\t\t{\n\t\t\t\tgradientMatrix.createGradientBox(width, height, rot, 0, 0);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tgradientMatrix.createGradientBox(width, height / chunkSize, rot, 0, 0);\n\t\t\t}\n\t\t\t\n\t\t\t//\tCreate the alpha and ratio arrays\n\t\t\t\n\t\t\tvar alpha:Array = new Array();\n\t\t\t\n\t\t\tfor (var ai:int = 0; ai < colors.length; ai++)\n\t\t\t{\n\t\t\t\talpha.push(FlxColor.getAlphaFloat(colors[ai]));\n\t\t\t}\n\t\t\t\n\t\t\tvar ratio:Array = new Array();\n\t\t\t\n\t\t\tif (colors.length == 2)\n\t\t\t{\n\t\t\t\tratio[0] = 0;\n\t\t\t\tratio[1] = 255;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t//\tSpread value\n\t\t\t\tvar spread:int = 255 / (colors.length - 1);\n\t\t\t\t\n\t\t\t\tratio.push(0);\n\t\t\t\t\n\t\t\t\tfor (var ri:int = 1; ri < colors.length - 1; ri++)\n\t\t\t\t{\n\t\t\t\t\tratio.push(ri * spread);\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\tratio.push(255);\n\t\t\t}\n\t\t\t\n\t\t\treturn { matrix: gradientMatrix, alpha: alpha, ratio: ratio };\n\t\t}\n\t\t\n\t\tpublic static function createGradientArray(width:int, height:int, colors:Array, chunkSize:int = 1, rotation:int = 90, interpolate:Boolean = true):Array\n\t\t{\n\t\t\tvar data:BitmapData = createGradientBitmapData(width, height, colors, chunkSize, rotation, interpolate);\n\t\t\t\n\t\t\tvar result:Array = new Array();\n\t\t\t\n\t\t\tfor (var y:int = 0; y < data.height; y++)\n\t\t\t{\n\t\t\t\tresult.push(data.getPixel32(0, y));\n\t\t\t}\n\t\t\t\n\t\t\treturn result;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates an FlxSprite of the given width/height with a colour gradient flowing through it.\n\t\t * \n\t\t * @param\twidth\t\tThe width of the FlxSprite (and therefore gradient)\n\t\t * @param\theight\t\tThe height of the FlxSprite (and therefore gradient)\n\t\t * @param\tcolors\t\tAn array of colour values for the gradient to cycle through\n\t\t * @param\tchunkSize\tIf you want a more old-skool looking chunky gradient, increase this value!\n\t\t * @param\trotation\tAngle of the gradient in degrees. 90 = top to bottom, 180 = left to right. Any angle is valid\n\t\t * @param\tinterpolate\tInterpolate the colours? True uses RGB interpolation, false uses linear RGB\n\t\t * \n\t\t * @return\tAn FlxSprite containing your gradient (if valid parameters given!)\n\t\t */\n\t\tpublic static function createGradientFlxSprite(width:int, height:int, colors:Array, chunkSize:int = 1, rotation:int = 90, interpolate:Boolean = true):FlxSprite\n\t\t{\n\t\t\tvar data:BitmapData = createGradientBitmapData(width, height, colors, chunkSize, rotation, interpolate);\n\t\t\t\n\t\t\tvar dest:FlxSprite = new FlxSprite().makeGraphic(width, height);\n\t\t\t\n\t\t\tdest.pixels = data;\n\t\t\t\n\t\t\treturn dest;\n\t\t}\n\t\t\n\t\tpublic static function createGradientBitmapData(width:int, height:int, colors:Array, chunkSize:int = 1, rotation:int = 90, interpolate:Boolean = true):BitmapData\n\t\t{\n\t\t\t//\tSanity checks\n\t\t\tif (width < 1)\n\t\t\t{\n\t\t\t\twidth = 1;\n\t\t\t}\n\t\t\t\n\t\t\tif (height < 1)\n\t\t\t{\n\t\t\t\theight = 1;\n\t\t\t}\n\t\t\t\n\t\t\tvar gradient:Object = createGradientMatrix(width, height, colors, chunkSize, rotation);\n\t\t\t\n\t\t\tvar s:Shape = new Shape();\n\t\t\t\n\t\t\tif (interpolate)\n\t\t\t{\n\t\t\t\ts.graphics.beginGradientFill(GradientType.LINEAR, colors, gradient.alpha, gradient.ratio, gradient.matrix, SpreadMethod.PAD, InterpolationMethod.RGB, 0);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\ts.graphics.beginGradientFill(GradientType.LINEAR, colors, gradient.alpha, gradient.ratio, gradient.matrix, SpreadMethod.PAD, InterpolationMethod.LINEAR_RGB, 0);\n\t\t\t}\n\t\t\t\n\t\t\tif (chunkSize == 1)\n\t\t\t{\n\t\t\t\ts.graphics.drawRect(0, 0, width, height);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\ts.graphics.drawRect(0, 0, width, height / chunkSize);\n\t\t\t}\n\n\t\t\tvar data:BitmapData = new BitmapData(width, height, true, 0x0);\n\t\t\t\n\t\t\tif (chunkSize == 1)\n\t\t\t{\n\t\t\t\tdata.draw(s);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tvar tempBitmap:Bitmap = new Bitmap(new BitmapData(width, height / chunkSize, true, 0x0));\n\t\t\t\ttempBitmap.bitmapData.draw(s);\n\t\t\t\ttempBitmap.scaleY = chunkSize;\n\t\t\t\t\n\t\t\t\tvar sM:Matrix = new Matrix();\n\t\t\t\tsM.scale(tempBitmap.scaleX, tempBitmap.scaleY);\n\t\t\t\t\n\t\t\t\tdata.draw(tempBitmap, sM);\n\t\t\t}\n\t\t\t\n\t\t\treturn data;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates a new gradient and overlays that on-top of the given FlxSprite at the destX/destY coordinates (default 0,0)
\n\t\t * Use low alpha values in the colours to have the gradient overlay and not destroy the image below\n\t\t * \n\t\t * @param\tdest\t\tThe FlxSprite to overlay the gradient onto\n\t\t * @param\twidth\t\tThe width of the FlxSprite (and therefore gradient)\n\t\t * @param\theight\t\tThe height of the FlxSprite (and therefore gradient)\n\t\t * @param\tcolors\t\tAn array of colour values for the gradient to cycle through\n\t\t * @param\tdestX\t\tThe X offset the gradient is drawn at (default 0)\n\t\t * @param\tdestY\t\tThe Y offset the gradient is drawn at (default 0)\n\t\t * @param\tchunkSize\tIf you want a more old-skool looking chunky gradient, increase this value!\n\t\t * @param\trotation\tAngle of the gradient in degrees. 90 = top to bottom, 180 = left to right. Any angle is valid\n\t\t * @param\tinterpolate\tInterpolate the colours? True uses RGB interpolation, false uses linear RGB\n\t\t * @return\tThe composited FlxSprite (for chaining, if you need)\n\t\t */\n\t\tpublic static function overlayGradientOnFlxSprite(dest:FlxSprite, width:int, height:int, colors:Array, destX:int = 0, destY:int = 0, chunkSize:int = 1, rotation:int = 90, interpolate:Boolean = true):FlxSprite\n\t\t{\n\t\t\tif (width > dest.width)\n\t\t\t{\n\t\t\t\twidth = dest.width;\n\t\t\t}\n\t\t\t\n\t\t\tif (height > dest.height)\n\t\t\t{\n\t\t\t\theight = dest.height;\n\t\t\t}\n\t\t\t\n\t\t\tvar source:FlxSprite = createGradientFlxSprite(width, height, colors, chunkSize, rotation, interpolate);\n\t\t\t\n\t\t\tdest.stamp(source, destX, destY);\n\t\t\t\n\t\t\treturn dest;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates a new gradient and overlays that on-top of the given BitmapData at the destX/destY coordinates (default 0,0)
\n\t\t * Use low alpha values in the colours to have the gradient overlay and not destroy the image below\n\t\t * \n\t\t * @param\tdest\t\tThe BitmapData to overlay the gradient onto\n\t\t * @param\twidth\t\tThe width of the FlxSprite (and therefore gradient)\n\t\t * @param\theight\t\tThe height of the FlxSprite (and therefore gradient)\n\t\t * @param\tcolors\t\tAn array of colour values for the gradient to cycle through\n\t\t * @param\tdestX\t\tThe X offset the gradient is drawn at (default 0)\n\t\t * @param\tdestY\t\tThe Y offset the gradient is drawn at (default 0)\n\t\t * @param\tchunkSize\tIf you want a more old-skool looking chunky gradient, increase this value!\n\t\t * @param\trotation\tAngle of the gradient in degrees. 90 = top to bottom, 180 = left to right. Any angle is valid\n\t\t * @param\tinterpolate\tInterpolate the colours? True uses RGB interpolation, false uses linear RGB\n\t\t * @return\tThe composited BitmapData\n\t\t */\n\t\tpublic static function overlayGradientOnBitmapData(dest:BitmapData, width:int, height:int, colors:Array, destX:int = 0, destY:int = 0, chunkSize:int = 1, rotation:int = 90, interpolate:Boolean = true):BitmapData\n\t\t{\n\t\t\tif (width > dest.width)\n\t\t\t{\n\t\t\t\twidth = dest.width;\n\t\t\t}\n\t\t\t\n\t\t\tif (height > dest.height)\n\t\t\t{\n\t\t\t\theight = dest.height;\n\t\t\t}\n\t\t\t\n\t\t\tvar source:BitmapData = createGradientBitmapData(width, height, colors, chunkSize, rotation, interpolate);\n\t\t\t\n\t\t\tdest.copyPixels(source, new Rectangle(0, 0, source.width, source.height), new Point(destX, destY), null, null, true);\n\t\t\t\n\t\t\treturn dest;\n\t\t}\n\t\t\n\t}\n\n}"
},
{
"path": "src/org/flixel/plugin/photonstorm/FlxGridOverlay.as",
"content": "/**\n * FlxGridOverlay\n * -- Part of the Flixel Power Tools set\n * \n * v1.1 Updated for the Flixel 2.5 Plugin system\n * \n * @version 1.1 - April 23rd 2011\n * @link http://www.photonstorm.com\n * @author Richard Davey / Photon Storm\n*/\n\npackage org.flixel.plugin.photonstorm \n{\n\timport flash.display.BitmapData;\n\timport flash.geom.Point;\n\timport flash.geom.Rectangle;\n\timport org.flixel.*;\n\t\n\tpublic class FlxGridOverlay \n\t{\n\t\tpublic function FlxGridOverlay() \n\t\t{\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates an FlxSprite of the given width and height filled with a checkerboard pattern.
\n\t\t * Each grid cell is the specified width and height, and alternates between two colors.
\n\t\t * If alternate is true each row of the pattern will be offset, for a proper checkerboard style. If false each row will be the same colour, creating a striped-pattern effect.
\n\t\t * So to create an 8x8 grid you'd call create(8,8)\n\t\t * \n\t\t * @param\tcellWidth\t\tThe grid cell width\n\t\t * @param\tcellHeight\t\tThe grid cell height\n\t\t * @param\twidth\t\t\tThe width of the FlxSprite. If -1 it will be the size of the game (FlxG.width)\n\t\t * @param\theight\t\t\tThe height of the FlxSprite. If -1 it will be the size of the game (FlxG.height)\n\t\t * @param\taddLegend\t\tTODO\n\t\t * @param\talternate\t\tShould the pattern alternate on each new row? Default true = checkerboard effect. False = vertical stripes\n\t\t * @param\tcolor1\t\t\tThe first fill colour in 0xAARRGGBB format\n\t\t * @param\tcolor2\t\t\tThe second fill colour in 0xAARRGGBB format\n\t\t * \n\t\t * @return\tFlxSprite of given width/height\n\t\t */\n\t\tpublic static function create(cellWidth:int, cellHeight:int, width:int = -1, height:int = -1, addLegend:Boolean = false, alternate:Boolean = true, color1:uint = 0xffe7e6e6, color2:uint = 0xffd9d5d5):FlxSprite\n\t\t{\n\t\t\tif (width == -1)\n\t\t\t{\n\t\t\t\twidth = FlxG.width;\n\t\t\t}\n\t\t\t\n\t\t\tif (height == -1)\n\t\t\t{\n\t\t\t\theight = FlxG.height;\n\t\t\t}\n\t\t\t\n\t\t\tif (width < cellWidth || height < cellHeight)\n\t\t\t{\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\t\n\t\t\tvar grid:BitmapData = createGrid(cellWidth, cellHeight, width, height, alternate, color1, color2);\n\t\t\t\n\t\t\tvar output:FlxSprite = new FlxSprite().makeGraphic(width, height);\n\t\t\t\n\t\t\toutput.pixels = grid;\n\t\t\toutput.dirty = true;\n\t\t\t\n\t\t\treturn output;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates a checkerboard pattern of the given width/height and overlays it onto the given FlxSprite.
\n\t\t * Each grid cell is the specified width and height, and alternates between two colors.
\n\t\t * If alternate is true each row of the pattern will be offset, for a proper checkerboard style. If false each row will be the same colour, creating a striped-pattern effect.
\n\t\t * So to create an 8x8 grid you'd call create(8,8,\n\t\t * \n\t\t * @param\tsource\t\t\tThe FlxSprite you wish to draw the grid on-top of. This updates its pixels value, not just the current frame (don't use animated sprites!)\n\t\t * @param\tcellWidth\t\tThe grid cell width\n\t\t * @param\tcellHeight\t\tThe grid cell height\n\t\t * @param\twidth\t\t\tThe width of the FlxSprite. If -1 it will be the size of the game (FlxG.width)\n\t\t * @param\theight\t\t\tThe height of the FlxSprite. If -1 it will be the size of the game (FlxG.height)\n\t\t * @param\taddLegend\t\tTODO\n\t\t * @param\talternate\t\tShould the pattern alternate on each new row? Default true = checkerboard effect. False = vertical stripes\n\t\t * @param\tcolor1\t\t\tThe first fill colour in 0xAARRGGBB format\n\t\t * @param\tcolor2\t\t\tThe second fill colour in 0xAARRGGBB format\n\t\t * \n\t\t * @return\tThe modified source FlxSprite\n\t\t */\n\t\tpublic static function overlay(source:FlxSprite, cellWidth:int, cellHeight:int, width:int = -1, height:int = -1, addLegend:Boolean = false, alternate:Boolean = true, color1:uint = 0x88e7e6e6, color2:uint = 0x88d9d5d5):FlxSprite\n\t\t{\n\t\t\tif (width == -1)\n\t\t\t{\n\t\t\t\twidth = FlxG.width;\n\t\t\t}\n\t\t\t\n\t\t\tif (height == -1)\n\t\t\t{\n\t\t\t\theight = FlxG.height;\n\t\t\t}\n\t\t\t\n\t\t\tif (width < cellWidth || height < cellHeight)\n\t\t\t{\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\t\n\t\t\tvar grid:BitmapData = createGrid(cellWidth, cellHeight, width, height, alternate, color1, color2);\n\t\t\t\n\t\t\tvar pixels:BitmapData = source.pixels;\n\t\t\t\n\t\t\tpixels.copyPixels(grid, new Rectangle(0, 0, width, height), new Point(0, 0), null, null, true);\n\t\t\t\n\t\t\tsource.pixels = pixels;\n\t\t\t\n\t\t\treturn source;\n\t\t}\n\t\t\n\t\tpublic static function addLegend(source:FlxSprite, cellWidth:int, cellHeight:int, xAxis:Boolean = true, yAxis:Boolean = true):FlxSprite\n\t\t{\n\t\t\tif (cellWidth > source.width)\n\t\t\t{\n\t\t\t\tthrow Error(\"cellWidth larger than FlxSprites width\");\n\t\t\t\treturn source;\n\t\t\t}\n\t\t\t\n\t\t\tif (cellHeight > source.height)\n\t\t\t{\n\t\t\t\tthrow Error(\"cellHeight larger than FlxSprites height\");\n\t\t\t\treturn source;\n\t\t\t}\n\t\t\t\n\t\t\tif (source.width < cellWidth || source.height < cellHeight)\n\t\t\t{\n\t\t\t\tthrow Error(\"source FlxSprite width or height smaller than requested cell width or height\");\n\t\t\t\treturn source;\n\t\t\t}\n\t\t\t\n\t\t\t//\tValid cell width/height and source to work on\n\t\t\t\n\t\t\treturn source;\n\t\t\t\n\t\t}\n\t\t\n\t\tpublic static function createGrid(cellWidth:int, cellHeight:int, width:int, height:int, alternate:Boolean, color1:uint, color2:uint):BitmapData\n\t\t{\n\t\t\t//\tHow many cells can we fit into the width/height? (round it UP if not even, then trim back)\n\t\t\t\n\t\t\tvar rowColor:uint = color1;\n\t\t\tvar lastColor:uint = color1;\n\t\t\tvar grid:BitmapData = new BitmapData(width, height, true);\n\t\t\t\n\t\t\t//\tIf there aren't an even number of cells in a row then we need to swap the lastColor value\n\t\t\t\n\t\t\tfor (var y:int = 0; y <= height; y += cellHeight)\n\t\t\t{\n\t\t\t\tif (y > 0 && lastColor == rowColor && alternate)\n\t\t\t\t{\n\t\t\t\t\t(lastColor == color1) ? lastColor = color2 : lastColor = color1;\n\t\t\t\t}\n\t\t\t\telse if (y > 0 && lastColor != rowColor && alternate == false)\n\t\t\t\t{\n\t\t\t\t\t(lastColor == color2) ? lastColor = color1 : lastColor = color2;\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\tfor (var x:int = 0; x <= width; x += cellWidth)\n\t\t\t\t{\n\t\t\t\t\tif (x == 0)\n\t\t\t\t\t{\n\t\t\t\t\t\trowColor = lastColor;\n\t\t\t\t\t}\n\t\t\t\t\t\n\t\t\t\t\tgrid.fillRect(new Rectangle(x, y, cellWidth, cellHeight), lastColor);\n\t\t\t\t\t\n\t\t\t\t\tif (lastColor == color1)\n\t\t\t\t\t{\n\t\t\t\t\t\tlastColor = color2;\n\t\t\t\t\t}\n\t\t\t\t\telse\n\t\t\t\t\t{\n\t\t\t\t\t\tlastColor = color1;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn grid;\n\t\t}\n\t\t\n\t\t\n\t}\n\n}"
},
{
"path": "src/org/flixel/plugin/photonstorm/FlxLinkedGroup.as",
"content": "package org.flixel.plugin.photonstorm \n{\n\timport org.flixel.FlxGroup;\n\timport org.flixel.FlxSprite;\n\timport flash.utils.getTimer;\n\n\tpublic class FlxLinkedGroup extends FlxGroup\n\t{\n\t\t//private var queue\n\t\t\n\t\t\n\t\tpublic function FlxLinkedGroup(MaxSize:uint = 0)\n\t\t{\n\t\t\tsuper(MaxSize);\n\t\t}\n\t\t\n\t\tpublic function addX(newX:int):void\n\t\t{\n\t\t\tfor each (var s:FlxSprite in members)\n\t\t\t{\n\t\t\t\ts.x += newX;\n\t\t\t}\n\t\t}\n\t\t\n\t\tpublic function angle(newX:int):void\n\t\t{\n\t\t\tfor each (var s:FlxSprite in members)\n\t\t\t{\n\t\t\t\ts.angle += newX;\n\t\t\t}\n\t\t}\n\t\t\n\t}\n\n}"
},
{
"path": "src/org/flixel/plugin/photonstorm/FlxMath.as",
"content": "/**\n * FlxMath\n * -- Part of the Flixel Power Tools set\n * \n * v1.7 Added mouseInFlxRect\n * v1.6 Added wrapAngle, angleLimit and more documentation\n * v1.5 Added pointInCoordinates, pointInFlxRect and pointInRectangle\n * v1.4 Updated for the Flixel 2.5 Plugin system\n * \n * @version 1.7 - June 28th 2011\n * @link http://www.photonstorm.com\n * @author Richard Davey / Photon Storm\n*/\n\npackage org.flixel.plugin.photonstorm \n{\n\timport flash.geom.Rectangle;\n\t\n\timport org.flixel.*;\n\t\n\t/**\n\t * Adds a set of fast Math functions and extends a few commonly used ones\n\t */\n\tpublic class FlxMath\n\t{\n\t\tpublic static var getrandmax:int = int.MAX_VALUE;\n\t\tprivate static var mr:uint = 0;\n\t\tprivate static var cosTable:Array = new Array;\n\t\tprivate static var sinTable:Array = new Array;\n\t\t\n\t\tprivate static var coefficient1:Number = Math.PI / 4;\n\t\tprivate static const RADTODEG:Number = 180 / Math.PI;\n\t\tprivate static const DEGTORAD:Number = Math.PI / 180;\n\t\t\n\t\tpublic function FlxMath() \n\t\t{\n\t\t}\n\t\t\n\t\t/**\n\t\t * Returns true if the given x/y coordinate is within the given rectangular block\n\t\t * \n\t\t * @param\tpointX\t\tThe X value to test\n\t\t * @param\tpointY\t\tThe Y value to test\n\t\t * @param\trectX\t\tThe X value of the region to test within\n\t\t * @param\trectY\t\tThe Y value of the region to test within\n\t\t * @param\trectWidth\tThe width of the region to test within\n\t\t * @param\trectHeight\tThe height of the region to test within\n\t\t * \n\t\t * @return\ttrue if pointX/pointY is within the region, otherwise false\n\t\t */\n\t\tpublic static function pointInCoordinates(pointX:int, pointY:int, rectX:int, rectY:int, rectWidth:int, rectHeight:int):Boolean\n\t\t{\n\t\t\tif (pointX >= rectX && pointX <= (rectX + rectWidth))\n\t\t\t{\n\t\t\t\tif (pointY >= rectY && pointY <= (rectY + rectHeight))\n\t\t\t\t{\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t}\n\t\t\t\n\t\t\treturn false;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Returns true if the given x/y coordinate is within the given rectangular block\n\t\t * \n\t\t * @param\tpointX\t\tThe X value to test\n\t\t * @param\tpointY\t\tThe Y value to test\n\t\t * @param\trect\t\tThe FlxRect to test within\n\t\t * @return\ttrue if pointX/pointY is within the FlxRect, otherwise false\n\t\t */\n\t\tpublic static function pointInFlxRect(pointX:int, pointY:int, rect:FlxRect):Boolean\n\t\t{\n\t\t\tif (pointX >= rect.x && pointX <= rect.right && pointY >= rect.y && pointY <= rect.bottom)\n\t\t\t{\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\t\n\t\t\treturn false;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Returns true if the mouse world x/y coordinate are within the given rectangular block\n\t\t * \n\t\t * @param\tuseWorldCoords\tIf true the world x/y coordinates of the mouse will be used, otherwise screen x/y\n\t\t * @param\trect\t\t\tThe FlxRect to test within. If this is null for any reason this function always returns true.\n\t\t * \n\t\t * @return\ttrue if mouse is within the FlxRect, otherwise false\n\t\t */\n\t\tpublic static function mouseInFlxRect(useWorldCoords:Boolean, rect:FlxRect):Boolean\n\t\t{\n\t\t\tif (rect == null)\n\t\t\t{\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\t\n\t\t\tif (useWorldCoords)\n\t\t\t{\n\t\t\t\treturn pointInFlxRect(FlxG.mouse.x, FlxG.mouse.y, rect);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\treturn pointInFlxRect(FlxG.mouse.screenX, FlxG.mouse.screenY, rect);\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Returns true if the given x/y coordinate is within the Rectangle\n\t\t * \n\t\t * @param\tpointX\t\tThe X value to test\n\t\t * @param\tpointY\t\tThe Y value to test\n\t\t * @param\trect\t\tThe Rectangle to test within\n\t\t * @return\ttrue if pointX/pointY is within the Rectangle, otherwise false\n\t\t */\n\t\tpublic static function pointInRectangle(pointX:int, pointY:int, rect:Rectangle):Boolean\n\t\t{\n\t\t\tif (pointX >= rect.x && pointX <= rect.right && pointY >= rect.y && pointY <= rect.bottom)\n\t\t\t{\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\t\n\t\t\treturn false;\n\t\t}\n\t\t\n\t\t/**\n\t\t * A faster (but much less accurate) version of Math.atan2(). For close range / loose comparisons this works very well, \n\t\t * but avoid for long-distance or high accuracy simulations.\n\t\t * Based on: http://blog.gamingyourway.com/PermaLink,guid,78341247-3344-4a7a-acb2-c742742edbb1.aspx\n\t\t * \n\t\t * Computes and returns the angle of the point y/x in radians, when measured counterclockwise from a circle's x axis \n\t\t * (where 0,0 represents the center of the circle). The return value is between positive pi and negative pi. \n\t\t * Note that the first parameter to atan2 is always the y coordinate.\n\t\t *
\n\t\t * @param y The y coordinate of the point\n\t\t * @param x The x coordinate of the point\n\t\t * @return The angle of the point x/y in radians\n\t\t */\n\t\tpublic static function atan2(y:Number, x:Number):Number\n\t\t{\n\t\t\tvar absY:Number = y;\n\t\t\tvar coefficient2:Number = 3 * coefficient1;\n\t\t\tvar r:Number;\n\t\t\tvar angle:Number;\n\t\t\t\n\t\t\tif (absY < 0)\n\t\t\t{\n\t\t\t\tabsY = -absY;\n\t\t\t}\n\n\t\t\tif (x >= 0)\n\t\t\t{\n\t\t\t\tr = (x - absY) / (x + absY);\n\t\t\t\tangle = coefficient1 - coefficient1 * r;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tr = (x + absY) / (absY - x);\n\t\t\t\tangle = coefficient2 - coefficient1 * r;\n\t\t\t}\n \n\t\t\treturn y < 0 ? -angle : angle;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Generate a sine and cosine table simultaneously and extremely quickly. Based on research by Franky of scene.at\n\t\t * \n\t\t * The parameters allow you to specify the length, amplitude and frequency of the wave. Once you have called this function\n\t\t * you should get the results via getSinTable() and getCosTable(). This generator is fast enough to be used in real-time.\n\t\t *
\n\t\t * @param length \t\tThe length of the wave\n\t\t * @param sinAmplitude \tThe amplitude to apply to the sine table (default 1.0) if you need values between say -+ 125 then give 125 as the value\n\t\t * @param cosAmplitude \tThe amplitude to apply to the cosine table (default 1.0) if you need values between say -+ 125 then give 125 as the value\n\t\t * @param frequency \tThe frequency of the sine and cosine table data\n\t\t * @return\tReturns the sine table\n\t\t * @see getSinTable\n\t\t * @see getCosTable\n\t\t */\n\t\tpublic static function sinCosGenerator(length:uint, sinAmplitude:Number = 1.0, cosAmplitude:Number = 1.0, frequency:Number = 1.0):Array\n\t\t{\n\t\t\tvar sin:Number = sinAmplitude;\n\t\t\tvar cos:Number = cosAmplitude;\n\t\t\tvar frq:Number = frequency * Math.PI / length;\n\t\t\t\n\t\t\tcosTable = new Array();\n\t\t\tsinTable = new Array();\n\t\t\t\n\t\t\tfor (var c:uint = 0; c < length; c++)\n\t\t\t{\n\t\t\t\tcos -= sin * frq;\n\t\t\t\tsin += cos * frq;\n\t\t\t\t\n\t\t\t\tcosTable[c] = cos;\n\t\t\t\tsinTable[c] = sin;\n\t\t\t}\n\t\t\t\n\t\t\treturn sinTable;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Returns the sine table generated by sinCosGenerator(), or an empty array object if not yet populated\n\t\t * @return Array of sine wave data\n\t\t * @see sinCosGenerator\n\t\t */\n\t\tpublic static function getSinTable():Array\n\t\t{\n\t\t\treturn sinTable;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Returns the cosine table generated by sinCosGenerator(), or an empty array object if not yet populated\n\t\t * @return Array of cosine wave data\n\t\t * @see sinCosGenerator\n\t\t */\n\t\tpublic static function getCosTable():Array\n\t\t{\n\t\t\treturn cosTable;\n\t\t}\n\t\t\n\t\t/**\n\t\t * A faster version of Math.sqrt\n\t\t * \n\t\t * Computes and returns the square root of the specified number.\n\t\t *
\n\t\t * @link http://osflash.org/as3_speed_optimizations#as3_speed_tests\n\t\t * @param val A number greater than or equal to 0\n\t\t * @return If the parameter val is greater than or equal to zero, a number; otherwise NaN (not a number).\n\t\t */\n\t\tpublic static function sqrt(val:Number):Number\n\t\t{\n\t\t\tif (isNaN(val))\n\t\t\t{\n\t\t\t\treturn NaN;\n\t\t\t}\n\t\t\t\n\t\t\tvar thresh:Number = 0.002;\n\t\t\tvar b:Number = val * 0.25;\n\t\t\tvar a:Number;\n\t\t\tvar c:Number;\n\t\t\t\n\t\t\tif (val == 0)\n\t\t\t{\n\t\t\t\treturn 0;\n\t\t\t}\n\t\t\t\n\t\t\tdo {\n\t\t\t\tc = val / b;\n\t\t\t\tb = (b + c) * 0.5;\n\t\t\t\ta = b - c;\n\t\t\t\tif (a < 0) a = -a;\n\t\t\t}\n\t\t\twhile (a > thresh);\n\t\t\t\n\t\t\treturn b;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Generates a small random number between 0 and 65535 very quickly\n\t\t * \n\t\t * Generates a small random number between 0 and 65535 using an extremely fast cyclical generator, \n\t\t * with an even spread of numbers. After the 65536th call to this function the value resets.\n\t\t *
\n\t\t * @return A pseudo random value between 0 and 65536 inclusive.\n\t\t */\n\t\tpublic static function miniRand():int\n\t\t{\n\t\t\tvar result:uint = mr;\n\t\t\t\n\t\t\tresult++;\n\t\t\tresult *= 75;\n\t\t\tresult %= 65537;\n\t\t\tresult--;\n\t\t\t\n\t\t\tmr++;\n\t\t\t\n\t\t\tif (mr == 65536)\n\t\t\t{\n\t\t\t\tmr = 0;\n\t\t\t}\n\t\t\t\n\t\t\treturn result;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Generate a random integer\n\t\t * \n\t\t * If called without the optional min, max arguments rand() returns a peudo-random integer between 0 and getrandmax().\n\t\t * If you want a random number between 5 and 15, for example, (inclusive) use rand(5, 15)\n\t\t * Parameter order is insignificant, the return will always be between the lowest and highest value.\n\t\t *
\n\t\t * @param min The lowest value to return (default: 0)\n\t\t * @param max The highest value to return (default: getrandmax)\n\t\t * @param excludes An Array of integers that will NOT be returned (default: null)\n\t\t * @return A pseudo-random value between min (or 0) and max (or getrandmax, inclusive)\n\t\t */\n\t\tpublic static function rand(min:Number = NaN, max:Number = NaN, excludes:Array = null):int\n\t\t{\n\t\t\tif (isNaN(min))\n\t\t\t{\n\t\t\t\tmin = 0;\n\t\t\t}\n\t\t\t\n\t\t\tif (isNaN(max))\n\t\t\t{\n\t\t\t\tmax = getrandmax;\n\t\t\t}\n\t\t\t\n\t\t\tif (min == max)\n\t\t\t{\n\t\t\t\treturn min;\n\t\t\t}\n\t\t\t\n\t\t\tif (excludes != null)\n\t\t\t{\n\t\t\t\t//\tSort the exclusion array\n\t\t\t\texcludes.sort(Array.NUMERIC);\n\t\t\t\t\n\t\t\t\tvar result:int;\n\t\t\t\t\n\t\t\t\tdo {\n\t\t\t\t\tif (min < max)\n\t\t\t\t\t{\n\t\t\t\t\t\tresult = min + Math.floor(Math.random() * (max + 1 - min)); // Math.floor and adding 1 makes this inclusive\n\t\t\t\t\t}\n\t\t\t\t\telse\n\t\t\t\t\t{\n\t\t\t\t\t\tresult = max + Math.floor(Math.random() * (min + 1 - max));\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\twhile (excludes.indexOf(result) >= 0);\n\t\t\t\t\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t//\tReverse check\n\t\t\t\tif (min < max)\n\t\t\t\t{\n\t\t\t\t\treturn min + Math.floor(Math.random() * (max + 1 - min));\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\treturn max + Math.floor(Math.random() * (min + 1 - max));\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Generate a random float (number)\n\t\t * \n\t\t * If called without the optional min, max arguments rand() returns a peudo-random float between 0 and getrandmax().\n\t\t * If you want a random number between 5 and 15, for example, (inclusive) use rand(5, 15)\n\t\t * Parameter order is insignificant, the return will always be between the lowest and highest value.\n\t\t *
\n\t\t * @param min The lowest value to return (default: 0)\n\t\t * @param max The highest value to return (default: getrandmax)\n\t\t * @return A pseudo random value between min (or 0) and max (or getrandmax, inclusive)\n\t\t */\n\t\tpublic static function randFloat(min:Number = NaN, max:Number = NaN):Number\n\t\t{\n\t\t\tif (isNaN(min))\n\t\t\t{\n\t\t\t\tmin = 0;\n\t\t\t}\n\t\t\t\n\t\t\tif (isNaN(max))\n\t\t\t{\n\t\t\t\tmax = getrandmax;\n\t\t\t}\n\t\t\t\n\t\t\tif (min == max)\n\t\t\t{\n\t\t\t\treturn min;\n\t\t\t}\n\t\t\telse if (min < max)\n\t\t\t{\n\t\t\t\treturn min + (Math.random() * (max - min + 1));\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\treturn max + (Math.random() * (min - max + 1));\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Generate a random boolean result based on the chance value\n\t\t * \n\t\t * Returns true or false based on the chance value (default 50%). For example if you wanted a player to have a 30% chance\n\t\t * of getting a bonus, call chanceRoll(30) - true means the chance passed, false means it failed.\n\t\t *
\n\t\t * @param chance The chance of receiving the value. Should be given as a uint between 0 and 100 (effectively 0% to 100%)\n\t\t * @return true if the roll passed, or false\n\t\t */\n\t\tpublic static function chanceRoll(chance:uint = 50):Boolean\n\t\t{\n\t\t\tif (chance <= 0)\n\t\t\t{\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\telse if (chance >= 100)\n\t\t\t{\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tif (Math.random() * 100 >= chance)\n\t\t\t\t{\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Adds the given amount to the value, but never lets the value go over the specified maximum\n\t\t * \n\t\t * @param value The value to add the amount to\n\t\t * @param amount The amount to add to the value\n\t\t * @param max The maximum the value is allowed to be\n\t\t * @return The new value\n\t\t */\n\t\tpublic static function maxAdd(value:int, amount:int, max:int):int\n\t\t{\n\t\t\tvalue += amount;\n\t\t\t\n\t\t\tif (value > max)\n\t\t\t{\n\t\t\t\tvalue = max;\n\t\t\t}\n\t\t\t\n\t\t\treturn value;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Adds value to amount and ensures that the result always stays between 0 and max, by wrapping the value around.\n\t\t * Values must be positive integers, and are passed through Math.abs
\n\t\t * \n\t\t * @param value The value to add the amount to\n\t\t * @param amount The amount to add to the value\n\t\t * @param max The maximum the value is allowed to be\n\t\t * @return The wrapped value\n\t\t */\n\t\tpublic static function wrapValue(value:int, amount:int, max:int):int\n\t\t{\n\t\t\tvar diff:int;\n\n\t\t\tvalue = Math.abs(value);\n\t\t\tamount = Math.abs(amount);\n\t\t\tmax = Math.abs(max);\n\t\t\t\n\t\t\tdiff = (value + amount) % max;\n\t\t\t\n\t\t\treturn diff;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Finds the length of the given vector\n\t\t * \n\t\t * @param\tdx\n\t\t * @param\tdy\n\t\t * \n\t\t * @return\n\t\t */\n public static function vectorLength(dx:Number, dy:Number):Number\n {\n return Math.sqrt(dx * dx + dy * dy);\n }\n\t\t\n\t\t/**\n\t\t * Finds the dot product value of two vectors\n\t\t * \n\t\t * @param\tax\t\tVector X\n\t\t * @param\tay\t\tVector Y\n\t\t * @param\tbx\t\tVector X\n\t\t * @param\tby\t\tVector Y\n\t\t * \n\t\t * @return\tDot product\n\t\t */\n public static function dotProduct(ax:Number, ay:Number, bx:Number, by:Number):Number\n {\n return ax * bx + ay * by;\n }\n \n\t\t/**\n\t\t * Randomly returns either a 1 or -1\n\t\t * \n\t\t * @return\t1 or -1\n\t\t */\n public static function randomSign():Number\n {\n return (Math.random() > 0.5) ? 1 : -1;\n }\n\t\t\n\t\t/**\n\t\t * Returns true if the number given is odd.\n\t\t * \n\t\t * @param\tn\tThe number to check\n\t\t * \n\t\t * @return\tTrue if the given number is odd. False if the given number is even.\n\t\t */\n\t\tpublic static function isOdd(n:Number):Boolean\n\t\t{\n\t\t\tif (n & 1)\n\t\t\t{\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Returns true if the number given is even.\n\t\t * \n\t\t * @param\tn\tThe number to check\n\t\t * \n\t\t * @return\tTrue if the given number is even. False if the given number is odd.\n\t\t */\n\t\tpublic static function isEven(n:Number):Boolean\n\t\t{\n\t\t\tif (n & 1)\n\t\t\t{\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Keeps an angle value between -180 and +180
\n\t\t * Should be called whenever the angle is updated on the FlxSprite to stop it from going insane.\n\t\t * \n\t\t * @param\tangle\tThe angle value to check\n\t\t * \n\t\t * @return\tThe new angle value, returns the same as the input angle if it was within bounds\n\t\t */\n\t\tpublic static function wrapAngle(angle:Number):int\n\t\t{\n\t\t\tvar result:int = int(angle);\n\t\t\t\n\t\t\tif (angle > 180)\n\t\t\t{\n\t\t\t\tresult = -180;\n\t\t\t}\n\t\t\telse if (angle < -180)\n\t\t\t{\n\t\t\t\tresult = 180;\n\t\t\t}\n\t\t\t\n\t\t\treturn result;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Keeps an angle value between the given min and max values\n\t\t * \n\t\t * @param\tangle\tThe angle value to check. Must be between -180 and +180\n\t\t * @param\tmin\t\tThe minimum angle that is allowed (must be -180 or greater)\n\t\t * @param\tmax\t\tThe maximum angle that is allowed (must be 180 or less)\n\t\t * \n\t\t * @return\tThe new angle value, returns the same as the input angle if it was within bounds\n\t\t */\n\t\tpublic static function angleLimit(angle:int, min:int, max:int):int\n\t\t{\n\t\t\tvar result:int = angle;\n\t\t\t\n\t\t\tif (angle > max)\n\t\t\t{\n\t\t\t\tresult = max;\n\t\t\t}\n\t\t\telse if (angle < min)\n\t\t\t{\n\t\t\t\tresult = min;\n\t\t\t}\n\t\t\t\n\t\t\treturn result;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Converts a Radian value into a Degree\n\t\t * \n\t\t * Converts the radians value into degrees and returns\n\t\t *
\n\t\t * @param radians The value in radians\n\t\t * @return Number Degrees\n\t\t */\n\t\tpublic static function asDegrees(radians:Number):Number\n\t\t{\n\t\t\treturn radians * RADTODEG;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Converts a Degrees value into a Radian\n\t\t * \n\t\t * Converts the degrees value into radians and returns\n\t\t *
\n\t\t * @param degrees The value in degrees\n\t\t * @return Number Radians\n\t\t */\n\t\tpublic static function asRadians(degrees:Number):Number\n\t\t{\n\t\t\treturn degrees * DEGTORAD;\n\t\t}\n\t\t\n\t}\n\n}"
},
{
"path": "src/org/flixel/plugin/photonstorm/FlxMouseControl.as",
"content": "/**\n * FlxMouseControl\n * -- Part of the Flixel Power Tools set\n * \n * v1.2 Added Mouse Zone, Mouse Speed and refactored addToStack process\n * v1.1 Moved to a native plugin\n * v1.0 First release\n * \n * @version 1.2 - July 28th 2011\n * @link http://www.photonstorm.com\n * @author Richard Davey / Photon Storm\n*/\n\npackage org.flixel.plugin.photonstorm \n{\n\timport org.flixel.*;\n\t\n\tpublic class FlxMouseControl extends FlxBasic\n\t{\n\t\t/**\n\t\t * Use with sort() to sort in ascending order.\n\t\t */\n\t\tpublic static const ASCENDING:int = -1;\n\t\t\n\t\t/**\n\t\t * Use with sort() to sort in descending order.\n\t\t */\n\t\tpublic static const DESCENDING:int = 1;\n\t\t\n\t\t/**\n\t\t * The value that the FlxExtendedSprites are sorted by before deciding which is \"on-top\" for click select\n\t\t */\n\t\tpublic static var sortIndex:String = \"y\";\n\t\t\n\t\t/**\n\t\t * The sorting order. If the sortIndex is \"y\" and the order is ASCENDING then a sprite with a Y value of 200 would be \"on-top\" of one with a Y value of 100.\n\t\t */\n\t\tpublic static var sortOrder:int = ASCENDING;\n\t\t\n\t\t/**\n\t\t * Is the mouse currently dragging a sprite? If you have just clicked but NOT yet moved the mouse then this might return false.\n\t\t */\n\t\tpublic static var isDragging:Boolean = false;\n\t\t\n\t\t/**\n\t\t * The FlxExtendedSprite that is currently being dragged, if any.\n\t\t */\n\t\tpublic static var dragTarget:FlxExtendedSprite;\n\t\t\n\t\t/**\n\t\t * The FlxExtendedSprite that currently has the mouse button pressed on it\n\t\t */\n\t\tpublic static var clickTarget:FlxExtendedSprite;\n\t\tprivate static var clickStack:Array = new Array;\n\t\tprivate static var clickCoords:FlxPoint;\n\t\tprivate static var hasClickTarget:Boolean = false;\n\t\t\n\t\tprivate static var oldX:int;\n\t\tprivate static var oldY:int;\n\t\t\n\t\t/**\n\t\t * The speed the mouse is moving on the X axis in pixels per frame\n\t\t */\n\t\tpublic static var speedX:int;\n\t\t\n\t\t/**\n\t\t * The speed the mouse is moving on the Y axis in pixels per frame\n\t\t */\n\t\tpublic static var speedY:int;\n\t\t\n\t\t/**\n\t\t * The mouse can be set to only be active within a specific FlxRect region of the game world.\n\t\t * If outside this FlxRect no clicks, drags or throws will be processed.\n\t\t * If the mouse leaves this region while still dragging then the sprite is automatically dropped and its release handler is called.\n\t\t * Set the FlxRect to null to disable the zone.\n\t\t */\n\t\tpublic static var mouseZone:FlxRect;\n\t\t\n\t\t/**\n\t\t * Instead of using a mouseZone (which is calculated in world coordinates) you can limit the mouse to the FlxG.camera.deadzone area instead.\n\t\t * If set to true the mouse will use the camera deadzone. If false (or the deadzone is null) no check will take place.\n\t\t * Note that this takes priority over the mouseZone above. If the mouseZone and deadzone are set, the deadzone is used.\n\t\t */\n\t\tpublic static var linkToDeadZone:Boolean = false;\n\t\t\n\t\tpublic function FlxMouseControl() \n\t\t{\n\t\t}\n\t\t\n\t\t/**\n\t\t * Adds the given FlxExtendedSprite to the stack of potential sprites that were clicked, the stack is then sorted and the final sprite is selected from that\n\t\t * \n\t\t * @param\titem\tThe FlxExtendedSprite that was clicked by the mouse\n\t\t */\n\t\tpublic static function addToStack(item:FlxExtendedSprite):void\n\t\t{\n\t\t\tif (mouseZone is FlxRect)\n\t\t\t{\n\t\t\t\tif (FlxMath.pointInFlxRect(FlxG.mouse.x, FlxG.mouse.y, mouseZone) == true)\n\t\t\t\t{\n\t\t\t\t\tclickStack.push(item);\n\t\t\t\t}\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tclickStack.push(item);\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Main Update Loop - checks mouse status and updates FlxExtendedSprites accordingly\n\t\t */\n\t\toverride public function update():void\n\t\t{\n\t\t\t//\tUpdate mouse speed\n\t\t\tspeedX = FlxG.mouse.screenX - oldX;\n\t\t\tspeedY = FlxG.mouse.screenY - oldY;\n\t\t\t\n\t\t\toldX = FlxG.mouse.screenX;\n\t\t\toldY = FlxG.mouse.screenY;\n\t\t\t\n\t\t\t//\tIs the mouse currently pressed down on a target?\n\t\t\tif (hasClickTarget)\n\t\t\t{\n\t\t\t\tif (FlxG.mouse.pressed())\n\t\t\t\t{\n\t\t\t\t\t//\tHas the mouse moved? If so then we're candidate for a drag\n\t\t\t\t\tif (isDragging == false && clickTarget.draggable && (clickCoords.x != FlxG.mouse.x || clickCoords.y != FlxG.mouse.y))\n\t\t\t\t\t{\n\t\t\t\t\t\t//\tDrag on\n\t\t\t\t\t\tisDragging = true;\n\t\t\t\t\t\t\n\t\t\t\t\t\tdragTarget = clickTarget;\n\t\t\t\t\t\t\n\t\t\t\t\t\tdragTarget.startDrag();\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\treleaseMouse();\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\tif (linkToDeadZone)\n\t\t\t\t{\n\t\t\t\t\tif (FlxMath.mouseInFlxRect(false, FlxG.camera.deadzone) == false)\n\t\t\t\t\t{\n\t\t\t\t\t\treleaseMouse();\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\telse if (FlxMath.mouseInFlxRect(true, mouseZone) == false)\n\t\t\t\t{\n\t\t\t\t\t//\tIs a mouse zone enabled? In which case check if we're still in it\n\t\t\t\t\treleaseMouse();\n\t\t\t\t}\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t//\tNo target, but is the mouse down?\n\t\t\t\t\n\t\t\t\tif (FlxG.mouse.justPressed())\n\t\t\t\t{\n\t\t\t\t\tclickStack.length = 0;\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\t//\tIf you are wondering how the brand new array can have anything in it by now, it's because FlxExtendedSprite\n\t\t\t\t//\tadds itself to the clickStack\n\t\t\t\t\n\t\t\t\tif (FlxG.mouse.pressed() && clickStack.length > 0)\n\t\t\t\t{\n\t\t\t\t\tassignClickedSprite();\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Internal function used to release the click / drag targets and reset the mouse state\n\t\t */\n\t\tprivate function releaseMouse():void\n\t\t{\n\t\t\t//\tMouse is no longer down, so tell the click target it's free - this will also stop dragging if happening\n\t\t\tclickTarget.mouseReleasedHandler();\n\t\t\t\n\t\t\thasClickTarget = false;\n\t\t\tclickTarget = null;\n\t\t\t\n\t\t\tisDragging = false;\n\t\t\tdragTarget = null;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Once the clickStack is created this sorts it and then picks the sprite with the highest priority (based on sortIndex and sortOrder)\n\t\t */\n\t\tprivate function assignClickedSprite():void\n\t\t{\n\t\t\t//\tIf there is more than one potential target then sort them\n\t\t\tif (clickStack.length > 1)\n\t\t\t{\n\t\t\t\tclickStack.sort(sortHandler);\n\t\t\t}\n\t\t\t\n\t\t\tclickTarget = clickStack.pop();\n\t\t\t\n\t\t\tclickCoords = clickTarget.point;\n\t\t\t\n\t\t\thasClickTarget = true;\n\t\t\t\n\t\t\tclickTarget.mousePressedHandler();\n\t\t\t\n\t\t\tclickStack.length = 0;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Helper function for the sort process.\n\t\t * \n\t\t * @param \titem1\tThe first object being sorted.\n\t\t * @param\titem2\tThe second object being sorted.\n\t\t * \n\t\t * @return\tAn integer value: -1 (item1 before item2), 0 (same), or 1 (item1 after item2)\n\t\t */\n\t\tprivate function sortHandler(item1:FlxExtendedSprite, item2:FlxExtendedSprite):int\n\t\t{\n\t\t\tif (item1[sortIndex] < item2[sortIndex])\n\t\t\t{\n\t\t\t\treturn sortOrder;\n\t\t\t}\n\t\t\telse if (item1[sortIndex] > item2[sortIndex])\n\t\t\t{\n\t\t\t\treturn -sortOrder;\n\t\t\t}\n\t\t\t\n\t\t\treturn 0;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Removes all references to any click / drag targets and resets this class\n\t\t */\n\t\tpublic static function clear():void\n\t\t{\n\t\t\thasClickTarget = false;\n\t\t\t\n\t\t\tif (clickTarget)\n\t\t\t{\n\t\t\t\tclickTarget.mouseReleasedHandler();\n\t\t\t}\n\t\t\t\n\t\t\tclickTarget = null;\n\t\t\t\n\t\t\tisDragging = false;\n\t\t\t\n\t\t\tif (dragTarget)\n\t\t\t{\n\t\t\t\tdragTarget.stopDrag();\n\t\t\t}\n\t\t\t\n\t\t\tspeedX = 0;\n\t\t\tspeedY = 0;\n\t\t\tdragTarget = null;\n\t\t\tmouseZone = null;\n\t\t\tlinkToDeadZone = false;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Runs when this plugin is destroyed\n\t\t */\n\t\toverride public function destroy():void\n\t\t{\n\t\t\tclear();\n\t\t}\n\t\t\n\t}\n\n}"
},
{
"path": "src/org/flixel/plugin/photonstorm/FlxPowerTools.as",
"content": "/**\n * Flixel Power Tools\n * \n * Version information and constants the other classes in this package can reference\n * \n * @version 1.9\n * @link http://www.photonstorm.com\n * @author Richard Davey / Photon Storm\n*/\n\npackage org.flixel.plugin.photonstorm \n{\n\tpublic class FlxPowerTools \n\t{\n\t\tpublic static const LIBRARY_NAME:String = \"flixel power tools\";\n\t\tpublic static const LIBRARY_MAJOR_VERSION:int = 1;\n\t\tpublic static const LIBRARY_MINOR_VERSION:int = 9;\n\t\t\n\t\tpublic function FlxPowerTools() \n\t\t{\n\t\t}\n\t\t\n\t}\n\n}"
},
{
"path": "src/org/flixel/plugin/photonstorm/FlxScreenGrab.as",
"content": "/**\n * FlxScreenGrab\n * -- Part of the Flixel Power Tools set\n * \n * v1.0 Updated for the Flixel 2.5 Plugin system\n * \n * @version 1.0 - April 28th 2011\n * @link http://www.photonstorm.com\n * @author Richard Davey / Photon Storm\n*/\n\npackage org.flixel.plugin.photonstorm \n{\n\timport org.flixel.*;\n\timport flash.geom.Rectangle;\n\timport flash.display.Bitmap;\n\timport flash.display.BitmapData;\n\timport flash.geom.Matrix;\n\timport flash.net.FileReference;\n\timport flash.utils.ByteArray;\n\timport flash.utils.getTimer;\n\t\n\t/**\n\t * Captures a screen grab of the game and stores it locally, optionally saving as a PNG.\n\t */\n\tpublic class FlxScreenGrab extends FlxBasic\n\t{\n\t\tpublic static var screenshot:Bitmap;\n\t\tprivate static var hotkey:String = \"\";\n\t\tprivate static var autoSave:Boolean = false;\n\t\tprivate static var autoHideMouse:Boolean = false;\n\t\tprivate static var region:Rectangle;\n\t\t\n\t\tpublic function FlxScreenGrab() \n\t\t{\n\t\t}\n\t\t\n\t\t/**\n\t\t * Defines the region of the screen that should be captured. If you need it to be a fixed location then use this.
\n\t\t * If you want to grab the whole SWF size, you don't need to set this as that is the default.
\n\t\t * Remember that if your game is running in a zoom mode > 1 you need to account for this here.\n\t\t * \n\t\t * @param\tx\t\tThe x coordinate (in Flash display space, not Flixel game world)\n\t\t * @param\ty\t\tThe y coordinate (in Flash display space, not Flixel game world)\n\t\t * @param\twidth\tThe width of the grab region\n\t\t * @param\theight\tThe height of the grab region\n\t\t */\n\t\tpublic static function defineCaptureRegion(x:int, y:int, width:int, height:int):void\n\t\t{\n\t\t\tregion = new Rectangle(x, y, width, height);\n\t\t}\n\t\t\n\t\t/**\n\t\t * Clears a previously defined capture region\n\t\t */\n\t\tpublic static function clearCaptureRegion():void\n\t\t{\n\t\t\tregion = null;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Specify which key will capture a screen shot. Use the String value of the key in the same way FlxG.keys does (so \"F1\" for example)
\n\t\t * Optionally save the image to a file immediately. This uses the file systems \"Save as\" dialog window and pauses your game during the process.
\n\t\t * \n\t\t * @param\tkey\t\t\tString The key you press to capture the screen (i.e. \"F1\", \"SPACE\", etc - see system.input.Keyboard.as source for reference)\n\t\t * @param\tsaveToFile\tBoolean If set to true it will immediately encodes the grab to a PNG and open a \"Save As\" dialog window when the hotkey is pressed\n\t\t * @param\thideMouse\tBoolean If set to true the mouse will be hidden before capture and displayed afterwards when the hotkey is pressed\n\t\t */\n\t\tpublic static function defineHotKey(key:String, saveToFile:Boolean = false, hideMouse:Boolean = false):void\n\t\t{\n\t\t\thotkey = key;\n\t\t\tautoSave = saveToFile;\n\t\t\tautoHideMouse = hideMouse;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Clears a previously defined hotkey\n\t\t */\n\t\tpublic static function clearHotKey():void\n\t\t{\n\t\t\thotkey = \"\";\n\t\t\tautoSave = false;\n\t\t\tautoHideMouse = false;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Takes a screen grab immediately of the given region or a previously defined region\n\t\t * \n\t\t * @param\tcaptureRegion\tA Rectangle area to capture. This over-rides that set by \"defineCaptureRegion\". If neither are set the full SWF size is used.\n\t\t * @param\tsaveToFile\tBoolean If set to true it will immediately encode the grab to a PNG and open a \"Save As\" dialog window\n\t\t * @param\thideMouse\tBoolean If set to true the mouse will be hidden before capture and displayed again afterwards\n\t\t * @return\tBitmap\t\tThe screen grab as a Flash Bitmap image\n\t\t */\n\t\tpublic static function grab(captureRegion:Rectangle = null, saveToFile:Boolean = false, hideMouse:Boolean = false):Bitmap\n\t\t{\n\t\t\tvar bounds:Rectangle;\n\t\t\t\n\t\t\tif (captureRegion)\n\t\t\t{\n\t\t\t\tbounds = new Rectangle(captureRegion.x, captureRegion.y, captureRegion.width, captureRegion.height);\n\t\t\t}\n\t\t\telse if (region)\n\t\t\t{\n\t\t\t\tbounds = new Rectangle(region.x, region.y, region.width, region.height);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tbounds = new Rectangle(0, 0, FlxG.stage.stageWidth, FlxG.stage.stageHeight);\n\t\t\t}\n\t\t\t\n\t\t\tvar theBitmap:Bitmap = new Bitmap(new BitmapData(bounds.width, bounds.height, true, 0x0));\n\t\t\t\n\t\t\tvar m:Matrix = new Matrix(1, 0, 0, 1, -bounds.x, -bounds.y);\n\t\t\t\n\t\t\tif (autoHideMouse || hideMouse)\n\t\t\t{\n\t\t\t\tFlxG.mouse.hide();\n\t\t\t}\n\t\t\t\n\t\t\ttheBitmap.bitmapData.draw(FlxG.stage, m);\n\t\t\t\n\t\t\tif (autoHideMouse || hideMouse)\n\t\t\t{\n\t\t\t\tFlxG.mouse.show();\n\t\t\t}\n\t\t\t\n\t\t\tscreenshot = theBitmap;\n\t\t\t\n\t\t\tif (saveToFile || autoSave)\n\t\t\t{\n\t\t\t\tsave();\n\t\t\t}\n\t\t\t\n\t\t\treturn theBitmap;\n\t\t}\n\t\t\n\t\tprivate static function save(filename:String = \"\"):void\n\t\t{\n\t\t\tif (screenshot.bitmapData == null)\n\t\t\t{\n\t\t\t\treturn;\n\t\t\t}\n\t\t\t\n\t\t\tvar png:ByteArray = PNGEncoder.encode(screenshot.bitmapData);\n\t\t\t\n\t\t\tvar file:FileReference = new FileReference();\n\t\t\t\n\t\t\tif (filename == \"\")\n\t\t\t{\n\t\t\t\tfilename = \"grab\" + getTimer().toString() + \".png\";\n\t\t\t}\n\t\t\telse if (filename.substr( -4) != \".png\")\n\t\t\t{\n\t\t\t\tfilename = filename.concat(\".png\");\n\t\t\t}\n\t\t\t\n\t\t\tfile.save(png, filename);\n\t\t}\n\t\t\n\t\toverride public function update():void\n\t\t{\n\t\t\tif (hotkey != \"\")\n\t\t\t{\n\t\t\t\tif (FlxG.keys.justReleased(hotkey))\n\t\t\t\t{\n\t\t\t\t\ttrace(\"key pressed\");\n\t\t\t\t\tgrab();\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t\n\t\toverride public function destroy():void\n\t\t{\n\t\t\tclearCaptureRegion();\n\t\t\tclearHotKey();\n\t\t}\n\t\t\n\t}\n\n}"
},
{
"path": "src/org/flixel/plugin/photonstorm/FlxScrollZone.as",
"content": "/**\n * FlxScrollZone\n * -- Part of the Flixel Power Tools set\n * \n * v1.4 Added \"clearRegion\" support for when you use Sprites with transparency and renamed parameter to onlyScrollOnscreen\n * v1.3 Swapped plugin update for draw, now smoother / faster in some fps cases\n * v1.2 Updated for the Flixel 2.5 Plugin system\n * \n * @version 1.4 - May 16th 2011\n * @link http://www.photonstorm.com\n * @author Richard Davey / Photon Storm. My thanks to Ralph Hauwert for help with this.\n*/\n\npackage org.flixel.plugin.photonstorm \n{\n\timport flash.display.BitmapData;\n\timport flash.display.Sprite;\n\timport flash.geom.Matrix;\n\timport flash.geom.Point;\n\timport flash.geom.Rectangle;\n\timport flash.utils.Dictionary;\n\timport org.flixel.*;\n\t\n\t/**\n\t * FlxScrollZone allows you to scroll the content of an FlxSprites bitmapData in any direction you like.\n\t */\n\tpublic class FlxScrollZone extends FlxBasic\n\t{\n\t\tprivate static var members:Dictionary = new Dictionary(true);\n\t\tprivate static var zeroPoint:Point = new Point;\n\t\t\n\t\tpublic function FlxScrollZone() \n\t\t{\n\t\t}\n\t\t\n\t\t/**\n\t\t * Add an FlxSprite to the Scroll Manager, setting up one scrolling region.
\n\t\t * To add extra scrolling regions on the same sprite use addZone()\n\t\t * \n\t\t * @param\tsource\t\t\t\tThe FlxSprite to apply the scroll to\n\t\t * @param\tregion\t\t\t\tThe region, specified as a Rectangle, of the FlxSprite that you wish to scroll\n\t\t * @param\tdistanceX\t\t\tThe distance in pixels you want to scroll on the X axis. Negative values scroll left. Positive scroll right. Floats allowed (0.5 would scroll at half speed)\n\t\t * @param\tdistanceY\t\t\tThe distance in pixels you want to scroll on the Y axis. Negative values scroll up. Positive scroll down. Floats allowed (0.5 would scroll at half speed)\n\t\t * @param\tonlyScrollOnscreen\tOnly update this FlxSprite if visible onScreen (default true) Saves performance by not scrolling offscreen sprites, but this isn't always desirable\n\t\t * @param\tclearRegion\t\t\tSet to true if you want to clear the scrolling area of the FlxSprite with a 100% transparent fill before applying the scroll texture (default false)\n\t\t * @see\t\tcreateZone\n\t\t */\n\t\tpublic static function add(source:FlxSprite, region:Rectangle, distanceX:Number, distanceY:Number, onlyScrollOnscreen:Boolean = true, clearRegion:Boolean = false):void\n\t\t{\n\t\t\tif (members[source])\n\t\t\t{\n\t\t\t\tthrow Error(\"FlxSprite already exists in FlxScrollZone, use addZone to add a new scrolling region to an already added FlxSprite\");\n\t\t\t}\n\t\t\t\n\t\t\tvar data:Object = new Object();\n\t\t\t\n\t\t\tdata.source = source;\n\t\t\tdata.scrolling = true;\n\t\t\tdata.onlyScrollOnscreen = onlyScrollOnscreen;\n\t\t\tdata.zones = new Array;\n\t\t\t\n\t\t\tmembers[source] = data;\n\t\t\t\n\t\t\tcreateZone(source, region, distanceX, distanceY, clearRegion);\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates a new scrolling region to an FlxSprite already in the Scroll Manager (see add())
\n\t\t * \n\t\t * @param\tsource\t\t\t\tThe FlxSprite to apply the scroll to\n\t\t * @param\tregion\t\t\t\tThe region, specified as a Rectangle, of the FlxSprite that you wish to scroll\n\t\t * @param\tdistanceX\t\t\tThe distance in pixels you want to scroll on the X axis. Negative values scroll left. Positive scroll right. Floats allowed (0.5 would scroll at half speed)\n\t\t * @param\tdistanceY\t\t\tThe distance in pixels you want to scroll on the Y axis. Negative values scroll up. Positive scroll down. Floats allowed (0.5 would scroll at half speed)\n\t\t * @param\tclearRegion\t\t\tSet to true if you want to fill the scroll region of the FlxSprite with a 100% transparent fill before scrolling it (default false)\n\t\t */\n\t\tpublic static function createZone(source:FlxSprite, region:Rectangle, distanceX:Number, distanceY:Number, clearRegion:Boolean = false):void\n\t\t{\n\t\t\tvar texture:BitmapData = new BitmapData(region.width, region.height, true, 0x00000000);\n\t\t\ttexture.copyPixels(source.framePixels, region, zeroPoint, null, null, true);\n\t\t\t\n\t\t\tvar data:Object = new Object();\n\t\t\t\n\t\t\tdata.buffer = new Sprite;\n\t\t\tdata.texture = texture;\n\t\t\tdata.region = region;\n\t\t\tdata.clearRegion = clearRegion;\n\t\t\tdata.distanceX = distanceX;\n\t\t\tdata.distanceY = distanceY;\n\t\t\tdata.scrollMatrix = new Matrix();\n\t\t\tdata.drawMatrix = new Matrix(1, 0, 0, 1, region.x, region.y);\n\t\t\t\n\t\t\tmembers[source].zones.push(data);\n\t\t}\n\t\t\n\t\t/**\n\t\t * Sets the draw Matrix for the given FlxSprite scroll zone
\n\t\t * Warning: Modify this at your own risk!\n\t\t * \n\t\t * @param\tsource\t\tThe FlxSprite to set the draw matrix on\n\t\t * @param\tmatrix\t\tThe Matrix to use during the scroll update draw \n\t\t * @param\tzone\t\tIf the FlxSprite has more than 1 scrolling zone, use this to target which zone to apply the update to (default 0)\n\t\t * @return\tMatrix\t\tThe draw matrix used in the scroll update\n\t\t */\n\t\tpublic static function updateDrawMatrix(source:FlxSprite, matrix:Matrix, zone:int = 0):void\n\t\t{\n\t\t\tmembers[source].zones[zone].drawMatrix = matrix;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Returns the draw Matrix for the given FlxSprite scroll zone\n\t\t * \n\t\t * @param\tsource\t\tThe FlxSprite to get the draw matrix from\n\t\t * @param\tzone\t\tIf the FlxSprite has more than 1 scrolling zone, use this to target which zone to apply the update to (default 0)\n\t\t * @return\tMatrix\t\tThe draw matrix used in the scroll update\n\t\t */\n\t\tpublic static function getDrawMatrix(source:FlxSprite, zone:int = 0):Matrix\n\t\t{\n\t\t\treturn members[source].zones[zone].drawMatrix;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Removes an FlxSprite and all of its scrolling zones. Note that it doesn't restore the sprite bitmapData.\n\t\t * \n\t\t * @param\tsource\tThe FlxSprite to remove all scrolling zones for.\n\t\t * @return\tBoolean\ttrue if the FlxSprite was removed, otherwise false.\n\t\t */\n\t\tpublic static function remove(source:FlxSprite):Boolean\n\t\t{\n\t\t\tif (members[source])\n\t\t\t{\n\t\t\t\tdelete members[source];\n\t\t\t\t\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\t\n\t\t\treturn false;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Removes all FlxSprites, and all of their scrolling zones.
\n\t\t * This is called automatically if the plugin is ever destroyed.\n\t\t */\n\t\tpublic static function clear():void\n\t\t{\n\t\t\tfor each (var obj:Object in members)\n\t\t\t{\n\t\t\t\tdelete members[obj.source];\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Update the distance in pixels to scroll on the X axis.\n\t\t * \n\t\t * @param\tsource\t\tThe FlxSprite to apply the scroll to\n\t\t * @param\tdistanceX\tThe distance in pixels you want to scroll on the X axis. Negative values scroll left. Positive scroll right. Floats allowed (0.5 would scroll at half speed)\n\t\t * @param\tzone\t\tIf the FlxSprite has more than 1 scrolling zone, use this to target which zone to apply the update to (default 0)\n\t\t */\n\t\tpublic static function updateX(source:FlxSprite, distanceX:Number, zone:int = 0):void\n\t\t{\n\t\t\tmembers[source].zones[zone].distanceX = distanceX;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Update the distance in pixels to scroll on the X axis.\n\t\t * \n\t\t * @param\tsource\t\tThe FlxSprite to apply the scroll to\n\t\t * @param\tdistanceY\tThe distance in pixels you want to scroll on the Y axis. Negative values scroll up. Positive scroll down. Floats allowed (0.5 would scroll at half speed)\n\t\t * @param\tzone\t\tIf the FlxSprite has more than 1 scrolling zone, use this to target which zone to apply the update to (default 0)\n\t\t */\n\t\tpublic static function updateY(source:FlxSprite, distanceY:Number, zone:int = 0):void\n\t\t{\n\t\t\tmembers[source].zones[zone].distanceY = distanceY;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Starts scrolling on the given FlxSprite. If no FlxSprite is given it starts scrolling on all FlxSprites currently added.
\n\t\t * Scrolling is enabled by default, but this can be used to re-start it if you have stopped it via stopScrolling.
\n\t\t * \n\t\t * @param\tsource\tThe FlxSprite to start scrolling on. If left as null it will start scrolling on all sprites.\n\t\t */\n\t\tpublic static function startScrolling(source:FlxSprite = null):void\n\t\t{\n\t\t\tif (source)\n\t\t\t{\n\t\t\t\tmembers[source].scrolling = true;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tfor each (var obj:Object in members)\n\t\t\t\t{\n\t\t\t\t\tobj.scrolling = true;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Stops scrolling on the given FlxSprite. If no FlxSprite is given it stops scrolling on all FlxSprites currently added.
\n\t\t * Scrolling is enabled by default, but this can be used to stop it.
\n\t\t * \n\t\t * @param\tsource\tThe FlxSprite to stop scrolling on. If left as null it will stop scrolling on all sprites.\n\t\t */\n\t\tpublic static function stopScrolling(source:FlxSprite = null):void\n\t\t{\n\t\t\tif (source)\n\t\t\t{\n\t\t\t\tmembers[source].scrolling = false;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tfor each (var obj:Object in members)\n\t\t\t\t{\n\t\t\t\t\tobj.scrolling = false;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t\n\t\toverride public function draw():void\n\t\t{\n\t\t\tfor each (var obj:Object in members)\n\t\t\t{\n\t\t\t\tif ((obj.onlyScrollOnscreen == true && obj.source.onScreen()) && obj.scrolling == true && obj.source.exists)\n\t\t\t\t{\n\t\t\t\t\tscroll(obj);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t\n\t\tprivate function scroll(data:Object):void\n\t\t{\n\t\t\t//\tLoop through the scroll zones defined in this object\n\t\t\tfor each (var zone:Object in data.zones)\n\t\t\t{\n\t\t\t\tzone.scrollMatrix.tx += zone.distanceX;\n\t\t\t\tzone.scrollMatrix.ty += zone.distanceY;\n\t\t\t\t\n\t\t\t\tzone.buffer.graphics.clear();\n\t\t\t\tzone.buffer.graphics.beginBitmapFill(zone.texture, zone.scrollMatrix, true, false);\n\t\t\t\tzone.buffer.graphics.drawRect(0, 0, zone.region.width, zone.region.height);\n\t\t\t\tzone.buffer.graphics.endFill();\n\t\t\t\t\n\t\t\t\tif (zone.clearRegion)\n\t\t\t\t{\n\t\t\t\t\tdata.source.pixels.fillRect(zone.region, 0x0);\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\tdata.source.pixels.draw(zone.buffer, zone.drawMatrix);\n\t\t\t}\n\t\t\t\n\t\t\tdata.source.dirty = true;\n\t\t}\n\t\t\n\t\toverride public function destroy():void\n\t\t{\n\t\t\tclear();\n\t\t}\n\t\t\n\t}\n\n}"
},
{
"path": "src/org/flixel/plugin/photonstorm/FlxScrollingText.as",
"content": "/**\n * FlxScrollingText\n * -- Part of the Flixel Power Tools set\n * \n * v1.0 First version released\n * \n * @version 1.0 - May 5th 2011\n * @link http://www.photonstorm.com\n * @author Richard Davey / Photon Storm\n*/\n\npackage org.flixel.plugin.photonstorm \n{\n\timport flash.display.BitmapData;\n\timport flash.geom.Point;\n\timport flash.geom.Rectangle;\n\timport flash.utils.Dictionary;\n\timport flash.utils.getTimer;\n\t\n\timport org.flixel.*;\n\t\n\t/**\n\t * FlxScrollingText takes an FlxBitmapFont object and creates a horizontally scrolling FlxSprite from it\n\t */\n\tpublic class FlxScrollingText extends FlxBasic\n\t{\n\t\tprivate static var members:Dictionary = new Dictionary(true);\n\t\tprivate static var zeroPoint:Point = new Point;\n\t\n\t\tpublic function FlxScrollingText() \n\t\t{\n\t\t}\n\t\t\n\t\t/**\n\t\t * Adds an FlxBitmapFont to the Scrolling Text Manager and returns an FlxSprite which contains the text scroller in it.
\n\t\t * The FlxSprite will automatically update itself via this plugin, but can be treated as a normal FlxSprite in all other regards
\n\t\t * re: positioning, collision, rotation, etc.\n\t\t * \n\t\t * @param\tbitmapFont\t\t\tA pre-prepared FlxBitmapFont object (see the Test Suite examples for details on how this works)\n\t\t * @param\tregion\t\t\t\tA Rectangle that defines the size of the scrolling FlxSprite. The sprite will be placed at region.x/y and be region.width/height in size.\n\t\t * @param\tpixels\t\t\t\tThe number of pixels to scroll per step. For a smooth (but slow) scroll use low values. Keep the value proportional to the font width, so if the font width is 16 use a value like 1, 2, 4 or 8.\n\t\t * @param\tsteps\t\t\t\tHow many steps should pass before the text is next scrolled? Default 0 means every step we scroll. Higher values slow things down.\n\t\t * @param\ttext\t\t\t\tThe default text for your scrolling message. Can be changed in real-time via the addText method.\n\t\t * @param\tonlyScrollOnscreen\tOnly update the text scroller when this FlxSprite is visible on-screen? Default true.\n\t\t * @param\tloopOnWrap\t\t\tWhen the scroller reaches the end of the given \"text\" should it wrap to the start? Default true. If false it will clear the screen then set itself to not update.\n\t\t * \n\t\t * @return\tAn FlxSprite of size region.width/height, positioned at region.x/y, that auto-updates its contents while this plugin runs\n\t\t */\n\t\tpublic static function add(bitmapFont:FlxBitmapFont, region:Rectangle, pixels:uint = 1, steps:uint = 0, text:String = \"FLIXEL ROCKS!\", onlyScrollOnscreen:Boolean = true, loopOnWrap:Boolean = true):FlxSprite\n\t\t{\n\t\t\tvar data:Object = new Object;\n\t\t\t\n\t\t\t//\tSanity checks\n\t\t\tif (pixels > bitmapFont.characterWidth)\n\t\t\t{\n\t\t\t\tpixels = bitmapFont.characterWidth;\n\t\t\t}\n\t\t\t\n\t\t\tif (pixels == 0)\n\t\t\t{\n\t\t\t\tpixels = 1;\n\t\t\t}\n\t\t\t\n\t\t\tif (text == \"\")\n\t\t\t{\n\t\t\t\ttext = \" \";\n\t\t\t}\n\t\t\t\n\t\t\tdata.bitmapFont = bitmapFont;\n\t\t\tdata.bitmapChar = FlxBitmapFont(data.bitmapFont).getCharacterAsBitmapData(text.charAt(0));\n\t\t\tdata.charWidth = bitmapFont.characterWidth;\n\t\t\tdata.charHeight = bitmapFont.characterHeight;\n\t\t\tdata.shiftRect = new Rectangle(pixels, 0, region.width - pixels, region.height);\n\t\t\tdata.bufferRect = new Rectangle(0, 0, region.width, region.height);\n\t\t\tdata.slice = new Rectangle(0, 0, pixels, data.charHeight);\n\t\t\tdata.endPoint = new Point(region.width - pixels, 0);\n\t\t\tdata.x = 0;\n\t\t\t\n\t\t\tdata.sprite = new FlxSprite(region.x, region.y).makeGraphic(region.width, region.height, 0x0, true);\n\t\t\tdata.buffer = new BitmapData(region.width, region.height, true, 0x0);\n\t\t\t\n\t\t\tdata.region = region;\n\t\t\tdata.step = steps;\n\t\t\tdata.maxStep = steps;\n\t\t\tdata.pixels = pixels;\n\t\t\tdata.clearCount = 0;\n\t\t\tdata.clearDistance = region.width - pixels;\n\t\t\t\n\t\t\tdata.text = text;\n\t\t\tdata.currentChar = 0;\n\t\t\tdata.maxChar = text.length;\n\t\t\t\n\t\t\tdata.wrap = loopOnWrap;\n\t\t\tdata.complete = false;\n\t\t\tdata.scrolling = true;\n\t\t\tdata.onScreenScroller = onlyScrollOnscreen;\n\t\t\t\n\t\t\tscroll(data);\n\t\t\t\n\t\t\tmembers[data.sprite] = data;\n\t\t\t\n\t\t\treturn data.sprite;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Adds or replaces the text in the given Text Scroller.
\n\t\t * Can be called while the scroller is still active.\n\t\t * \n\t\t * @param\tsource\t\tThe FlxSprite Text Scroller you wish to update (must have been added to FlxScrollingText via a call to add()\n\t\t * @param\ttext\t\tThe text to add or update to the Scroller\n\t\t * @param\toverwrite\tIf true the given text will fully replace the previous scroller text. If false it will be appended to the end (default)\n\t\t */\n\t\tpublic static function addText(source:FlxSprite, text:String, overwrite:Boolean = false):void\n\t\t{\n\t\t\tif (overwrite)\n\t\t\t{\n\t\t\t\tmembers[source].text = text;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tmembers[source].text = String(members[source].text).concat(text);\n\t\t\t}\n\t\t\t\t\n\t\t\tmembers[source].maxChar = members[source].text.length;\n\t\t}\n\t\t\n\t\toverride public function draw():void\n\t\t{\n\t\t\tfor each (var obj:Object in members)\n\t\t\t{\n\t\t\t\tif (obj && (obj.onScreenScroller == true && obj.sprite.onScreen()) && obj.scrolling == true && obj.sprite.exists)\n\t\t\t\t{\n\t\t\t\t\tscroll(obj);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t\n\t\tprivate static function scroll(data:Object):void\n\t\t{\n\t\t\t//\tHave we reached enough steps?\n\t\t\t\n\t\t\tif (data.maxStep > 0 && (data.step < data.maxStep))\n\t\t\t{\n\t\t\t\tdata.step++;\n\t\t\t\t\n\t\t\t\treturn;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t//\tIt's time to render, so reset the step counter and lets go\n\t\t\t\tdata.step = 0;\n\t\t\t}\n\t\t\t\n\t\t\t//\tCLS\n\t\t\tdata.buffer.fillRect(data.bufferRect, 0x0);\n\t\t\t\n\t\t\t//\tShift the current contents of the buffer along by \"speed\" pixels\n\t\t\tdata.buffer.copyPixels(data.sprite.pixels, data.shiftRect, zeroPoint, null, null, true);\n\t\t\t\n\t\t\t//\tCopy the side of the character\n\t\t\tif (data.complete == false)\n\t\t\t{\n\t\t\t\tdata.buffer.copyPixels(data.bitmapChar, data.slice, data.endPoint, null, null, true);\n\t\t\t\t\n\t\t\t\t//\tUpdate\n\t\t\t\tdata.x += data.pixels;\n\t\t\t\t\n\t\t\t\tif (data.x >= data.charWidth)\n\t\t\t\t{\n\t\t\t\t\t//\tGet the next character\n\t\t\t\t\tdata.currentChar++;\n\t\t\t\t\t\n\t\t\t\t\tif (data.currentChar > data.maxChar)\n\t\t\t\t\t{\n\t\t\t\t\t\t//\tAt the end of the text\n\t\t\t\t\t\tif (data.wrap)\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tdata.currentChar = 0;\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tdata.complete = true;\n\t\t\t\t\t\t\tdata.clearCount = 0;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\t\n\t\t\t\t\tif (data.complete == false)\n\t\t\t\t\t{\n\t\t\t\t\t\tdata.bitmapChar = FlxBitmapFont(data.bitmapFont).getCharacterAsBitmapData(String(data.text).charAt(data.currentChar));\n\t\t\t\t\t\tdata.x = 0;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\tif (data.complete == false)\n\t\t\t\t{\n\t\t\t\t\tdata.slice.x = data.x;\n\t\t\t\t}\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tdata.clearCount += data.pixels;\n\t\t\t\t\n\t\t\t\t//\tIt's all over now\n\t\t\t\tif (data.clearCount >= data.clearDistance)\n\t\t\t\t{\n\t\t\t\t\t//\tNo point updating something that has since left the screen\n\t\t\t\t\tdata.scrolling = false;\n\t\t\t\t}\n\t\t\t}\n\t\t\t\n\t\t\tdata.sprite.pixels = data.buffer.clone();\n\t\t\tdata.sprite.dirty = true;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Removes all FlxSprites
\n\t\t * This is called automatically if the plugin is destroyed, but should be called manually by you if you change States
\n\t\t * as all the FlxSprites will be destroyed by Flixel otherwise\n\t\t */\n\t\tpublic static function clear():void\n\t\t{\n\t\t\tfor each (var obj:Object in members)\n\t\t\t{\n\t\t\t\tdelete members[obj.sprite];\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Starts scrolling on the given FlxSprite. If no FlxSprite is given it starts scrolling on all FlxSprites currently added.
\n\t\t * Scrolling is enabled by default, but this can be used to re-start it if you have stopped it via stopScrolling.
\n\t\t * \n\t\t * @param\tsource\tThe FlxSprite to start scrolling on. If left as null it will start scrolling on all sprites.\n\t\t */\n\t\tpublic static function startScrolling(source:FlxSprite = null):void\n\t\t{\n\t\t\tif (source)\n\t\t\t{\n\t\t\t\tmembers[source].scrolling = true;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tfor each (var obj:Object in members)\n\t\t\t\t{\n\t\t\t\t\tobj.scrolling = true;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Stops scrolling on the given FlxSprite. If no FlxSprite is given it stops scrolling on all FlxSprites currently added.
\n\t\t * Scrolling is enabled by default, but this can be used to stop it.
\n\t\t * \n\t\t * @param\tsource\tThe FlxSprite to stop scrolling on. If left as null it will stop scrolling on all sprites.\n\t\t */\n\t\tpublic static function stopScrolling(source:FlxSprite = null):void\n\t\t{\n\t\t\tif (source)\n\t\t\t{\n\t\t\t\tmembers[source].scrolling = false;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tfor each (var obj:Object in members)\n\t\t\t\t{\n\t\t\t\t\tobj.scrolling = false;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Checks to see if the given FlxSprite is a Scrolling Text, and is actively scrolling or not
\n\t\t * Note: If the text is set to only scroll when on-screen, but if off-screen when this is called, it will still return true.\n\t\t * \n\t\t * @param\tsource\tThe FlxSprite to check for scrolling on.\n\t\t * @return\tBoolean true is the FlxSprite was found and is scrolling, otherwise false\n\t\t */\n\t\tpublic static function isScrolling(source:FlxSprite):Boolean\n\t\t{\n\t\t\tif (members[source])\n\t\t\t{\n\t\t\t\treturn members[source].scrolling;\n\t\t\t}\n\t\t\t\n\t\t\treturn false;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Removes an FlxSprite from the Text Scroller. Note that it doesn't restore the sprite bitmapData.\n\t\t * \n\t\t * @param\tsource\tThe FlxSprite to remove scrolling for.\n\t\t * @return\tBoolean\ttrue if the FlxSprite was removed, otherwise false.\n\t\t */\n\t\tpublic static function remove(source:FlxSprite):Boolean\n\t\t{\n\t\t\tif (members[source])\n\t\t\t{\n\t\t\t\tdelete members[source];\n\t\t\t\t\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\t\n\t\t\treturn false;\n\t\t}\n\t\t\n\t\toverride public function destroy():void\n\t\t{\n\t\t\tclear();\n\t\t}\n\t\t\n\t}\n\n}"
},
{
"path": "src/org/flixel/plugin/photonstorm/FlxSpecialFX.as",
"content": "/**\n * FlxSpecialFX\n * -- Part of the Flixel Power Tools set\n * \n * v1.6 Added WowCopperFX\n * v1.5 Added RevealFX\n * v1.4 Added BlurFX and CenterSlideFX\n * v1.3 Renamed DropDown to FloodFill\n * v1.2 Added GlitchFX and StarfieldFX\n * v1.1 Added SineWaveFX\n * v1.0 First release of the new FlxSpecialFX system\n * \n * @version 1.6 - September 19th 2011\n * @link http://www.photonstorm.com\n * @author Richard Davey / Photon Storm\n*/\n\npackage org.flixel.plugin.photonstorm \n{\n\timport flash.utils.Dictionary;\n\timport org.flixel.*;\n\timport org.flixel.plugin.photonstorm.FX.BlurFX;\n\timport org.flixel.plugin.photonstorm.FX.CenterSlideFX;\n\timport org.flixel.plugin.photonstorm.FX.FloodFillFX;\n\timport org.flixel.plugin.photonstorm.FX.GlitchFX;\n\timport org.flixel.plugin.photonstorm.FX.PlasmaFX;\n\timport org.flixel.plugin.photonstorm.FX.RainbowLineFX;\n\timport org.flixel.plugin.photonstorm.FX.RevealFX;\n\timport org.flixel.plugin.photonstorm.FX.SineWaveFX;\n\timport org.flixel.plugin.photonstorm.FX.StarfieldFX;\n\timport org.flixel.plugin.photonstorm.FX.WowCopperFX;\n\t\n\t/**\n\t * FlxSpecialFX is a single point of access to all of the FX Plugins available in the Flixel Power Tools\n\t */\n\tpublic class FlxSpecialFX extends FlxBasic\n\t{\n\t\tprivate static var members:Dictionary = new Dictionary(true);\n\t\t\n\t\tpublic function FlxSpecialFX() \n\t\t{\n\t\t}\n\t\t\n\t\t//\tTHE SPECIAL FX PLUGINS AVAILABLE\n\t\t\n\t\t/**\n\t\t * Creates a Plama field Effect\n\t\t * \n\t\t * @return\tPlasmaFX\n\t\t */\n\t\tpublic static function plasma():PlasmaFX\n\t\t{\n\t\t\tvar temp:PlasmaFX = new PlasmaFX;\n\t\t\t\n\t\t\tmembers[temp] = temp;\n\t\t\t\n\t\t\treturn members[temp];\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates a Rainbow Line Effect\n\t\t * \n\t\t * @return\tRainbowLineFX\n\t\t */\n\t\tpublic static function rainbowLine():RainbowLineFX\n\t\t{\n\t\t\tvar temp:RainbowLineFX = new RainbowLineFX;\n\t\t\t\n\t\t\tmembers[temp] = temp;\n\t\t\t\n\t\t\treturn members[temp];\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates a Flood Fill Effect\n\t\t * \n\t\t * @return\tFloodFillFX\n\t\t */\n\t\tpublic static function floodFill():FloodFillFX\n\t\t{\n\t\t\tvar temp:FloodFillFX = new FloodFillFX;\n\t\t\t\n\t\t\tmembers[temp] = temp;\n\t\t\t\n\t\t\treturn members[temp];\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates a Sine Wave Down Effect\n\t\t * \n\t\t * @return\tSineWaveFX\n\t\t */\n\t\tpublic static function sineWave():SineWaveFX\n\t\t{\n\t\t\tvar temp:SineWaveFX = new SineWaveFX;\n\t\t\t\n\t\t\tmembers[temp] = temp;\n\t\t\t\n\t\t\treturn members[temp];\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates a Glitch Effect\n\t\t * \n\t\t * @return\tGlitchFX\n\t\t */\n\t\tpublic static function glitch():GlitchFX\n\t\t{\n\t\t\tvar temp:GlitchFX = new GlitchFX;\n\t\t\t\n\t\t\tmembers[temp] = temp;\n\t\t\t\n\t\t\treturn members[temp];\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates a 2D or 3D Starfield Effect\n\t\t * \n\t\t * @return\tStarfieldFX\n\t\t */\n\t\tpublic static function starfield():StarfieldFX\n\t\t{\n\t\t\tvar temp:StarfieldFX = new StarfieldFX;\n\t\t\t\n\t\t\tmembers[temp] = temp;\n\t\t\t\n\t\t\treturn members[temp];\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates a Blur Effect\n\t\t * \n\t\t * @return\tBlurFX\n\t\t */\n\t\tpublic static function blur():BlurFX\n\t\t{\n\t\t\tvar temp:BlurFX = new BlurFX;\n\t\t\t\n\t\t\tmembers[temp] = temp;\n\t\t\t\n\t\t\treturn members[temp];\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates a Center Slide Effect\n\t\t * \n\t\t * @return\tCenterSlideFX\n\t\t */\n\t\tpublic static function centerSlide():CenterSlideFX\n\t\t{\n\t\t\tvar temp:CenterSlideFX = new CenterSlideFX\n\t\t\t\n\t\t\tmembers[temp] = temp;\n\t\t\t\n\t\t\treturn members[temp];\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates a Reveal Effect\n\t\t * \n\t\t * @return\tRevealFX\n\t\t */\n\t\tpublic static function reveal():RevealFX\n\t\t{\n\t\t\tvar temp:RevealFX = new RevealFX\n\t\t\t\n\t\t\tmembers[temp] = temp;\n\t\t\t\n\t\t\treturn members[temp];\n\t\t}\n\t\t\n\t\t/**\n\t\t * Creates a WOW Copper Effect\n\t\t * \n\t\t * @return\tWowCopperFX\n\t\t */\n\t\tpublic static function wowCopper():WowCopperFX\n\t\t{\n\t\t\tvar temp:WowCopperFX = new WowCopperFX\n\t\t\t\n\t\t\tmembers[temp] = temp;\n\t\t\t\n\t\t\treturn members[temp];\n\t\t}\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t//\tGLOBAL FUNCTIONS\n\t\t\n\t\t/**\n\t\t * Starts the given FX Plugin running\n\t\t * \n\t\t * @param\tsource\tA reference to the FX Plugin you wish to run. If null it will start all currently added FX Plugins\n\t\t */\n\t\tpublic static function startFX(source:Class = null):void\n\t\t{\n\t\t\tif (source)\n\t\t\t{\n\t\t\t\tmembers[source].active = true;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tfor each (var obj:Object in members)\n\t\t\t\t{\n\t\t\t\t\tobj.active = true;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Stops the given FX Plugin running\n\t\t * \n\t\t * @param\tsource\tA reference to the FX Plugin you wish to stop. If null it will stop all currently added FX Plugins\n\t\t */\n\t\tpublic static function stopFX(source:Class = null):void\n\t\t{\n\t\t\tif (source)\n\t\t\t{\n\t\t\t\tmembers[source].active = false;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tfor each (var obj:Object in members)\n\t\t\t\t{\n\t\t\t\t\tobj.active = false;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Returns the active state of the given FX Plugin running\n\t\t * \n\t\t * @param\tsource\tA reference to the FX Plugin you wish to run. If null it will start all currently added FX Plugins\n\t\t * @return\tBoolean\ttrue if the FX Plugin is active, false if not\n\t\t */\n\t\tpublic static function isActive(source:Class):Boolean\n\t\t{\n\t\t\tif (members[source])\n\t\t\t{\n\t\t\t\treturn members[source].active;\n\t\t\t}\n\t\t\t\n\t\t\treturn false;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Called automatically by Flixels Plugin handler\n\t\t */\n\t\toverride public function draw():void\n\t\t{\n\t\t\tif (FlxG.paused)\n\t\t\t{\n\t\t\t\treturn;\n\t\t\t}\n\t\t\t\n\t\t\tfor each (var obj:Object in members)\n\t\t\t{\n\t\t\t\tif (obj.active)\n\t\t\t\t{\n\t\t\t\t\tobj.draw();\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Removes a FX Plugin from the Special FX Handler\n\t\t * \n\t\t * @param\tsource\tThe FX Plugin to remove\n\t\t * @return\tBoolean\ttrue if the plugin was removed, otherwise false.\n\t\t */\n\t\tpublic static function remove(source:Object):Boolean\n\t\t{\n\t\t\tif (members[source])\n\t\t\t{\n\t\t\t\tmembers[source].destroy();\n\t\t\t\t\n\t\t\t\tdelete members[source];\n\t\t\t\t\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\t\n\t\t\treturn false;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Removes all FX Plugins
\n\t\t * This is called automatically if the plugin is destroyed, but should be called manually by you if you change States\n\t\t */\n\t\tpublic static function clear():void\n\t\t{\n\t\t\tfor each (var obj:Object in members)\n\t\t\t{\n\t\t\t\tremove(obj);\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Destroys all FX Plugins currently added and then destroys this instance of the FlxSpecialFX Plugin\n\t\t */\n\t\toverride public function destroy():void\n\t\t{\n\t\t\tclear();\n\t\t}\n\t\t\n\t\t\n\t}\n\n}"
},
{
"path": "src/org/flixel/plugin/photonstorm/FlxVelocity.as",
"content": "/**\n * FlxVelocity\n * -- Part of the Flixel Power Tools set\n * \n * v1.6 New method: velocityFromFacing\n * v1.5 New methods: velocityFromAngle, accelerateTowardsObject, accelerateTowardsMouse, accelerateTowardsPoint\n * v1.4 New methods: moveTowardsPoint, distanceToPoint, angleBetweenPoint\n * v1.3 Updated for the Flixel 2.5 Plugin system\n * \n * @version 1.6 - August 15th 2011\n * @link http://www.photonstorm.com\n * @author Richard Davey / Photon Storm\n * @see Depends on FlxMath\n*/\n\npackage org.flixel.plugin.photonstorm \n{\n\timport flash.accessibility.Accessibility;\n\timport org.flixel.*;\n\t\n\tpublic class FlxVelocity \n\t{\n\t\t\n\t\tpublic function FlxVelocity() \n\t\t{\n\t\t}\n\t\t\n\t\t/**\n\t\t * Sets the source FlxSprite x/y velocity so it will move directly towards the destination FlxSprite at the speed given (in pixels per second)
\n\t\t * If you specify a maxTime then it will adjust the speed (over-writing what you set) so it arrives at the destination in that number of seconds.
\n\t\t * Timings are approximate due to the way Flash timers work, and irrespective of SWF frame rate. Allow for a variance of +- 50ms.
\n\t\t * The source object doesn't stop moving automatically should it ever reach the destination coordinates.
\n\t\t * If you need the object to accelerate, see accelerateTowardsObject() instead\n\t\t * Note: Doesn't take into account acceleration, maxVelocity or drag (if you set drag or acceleration too high this object may not move at all)\n\t\t * \n\t\t * @param\tsource\t\tThe FlxSprite on which the velocity will be set\n\t\t * @param\tdest\t\tThe FlxSprite where the source object will move to\n\t\t * @param\tspeed\t\tThe speed it will move, in pixels per second (default is 60 pixels/sec)\n\t\t * @param\tmaxTime\t\tTime given in milliseconds (1000 = 1 sec). If set the speed is adjusted so the source will arrive at destination in the given number of ms\n\t\t */\n\t\tpublic static function moveTowardsObject(source:FlxSprite, dest:FlxSprite, speed:int = 60, maxTime:int = 0):void\n\t\t{\n\t\t\tvar a:Number = angleBetween(source, dest);\n\t\t\t\n\t\t\tif (maxTime > 0)\n\t\t\t{\n\t\t\t\tvar d:int = distanceBetween(source, dest);\n\t\t\t\t\n\t\t\t\t//\tWe know how many pixels we need to move, but how fast?\n\t\t\t\tspeed = d / (maxTime / 1000);\n\t\t\t}\n\t\t\t\n\t\t\tsource.velocity.x = Math.cos(a) * speed;\n\t\t\tsource.velocity.y = Math.sin(a) * speed;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Sets the x/y acceleration on the source FlxSprite so it will move towards the destination FlxSprite at the speed given (in pixels per second)
\n\t\t * You must give a maximum speed value, beyond which the FlxSprite won't go any faster.
\n\t\t * If you don't need acceleration look at moveTowardsObject() instead.\n\t\t * \n\t\t * @param\tsource\t\t\tThe FlxSprite on which the acceleration will be set\n\t\t * @param\tdest\t\t\tThe FlxSprite where the source object will move towards\n\t\t * @param\tspeed\t\t\tThe speed it will accelerate in pixels per second\n\t\t * @param\txSpeedMax\t\tThe maximum speed in pixels per second in which the sprite can move horizontally\n\t\t * @param\tySpeedMax\t\tThe maximum speed in pixels per second in which the sprite can move vertically\n\t\t */\n\t\tpublic static function accelerateTowardsObject(source:FlxSprite, dest:FlxSprite, speed:int, xSpeedMax:uint, ySpeedMax:uint):void\n\t\t{\n\t\t\tvar a:Number = angleBetween(source, dest);\n\t\t\t\n\t\t\tsource.velocity.x = 0;\n\t\t\tsource.velocity.y = 0;\n\t\t\t\n\t\t\tsource.acceleration.x = int(Math.cos(a) * speed);\n\t\t\tsource.acceleration.y = int(Math.sin(a) * speed);\n\t\t\t\n\t\t\tsource.maxVelocity.x = xSpeedMax;\n\t\t\tsource.maxVelocity.y = ySpeedMax;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Move the given FlxSprite towards the mouse pointer coordinates at a steady velocity\n\t\t * If you specify a maxTime then it will adjust the speed (over-writing what you set) so it arrives at the destination in that number of seconds.
\n\t\t * Timings are approximate due to the way Flash timers work, and irrespective of SWF frame rate. Allow for a variance of +- 50ms.
\n\t\t * The source object doesn't stop moving automatically should it ever reach the destination coordinates.
\n\t\t * \n\t\t * @param\tsource\t\tThe FlxSprite to move\n\t\t * @param\tspeed\t\tThe speed it will move, in pixels per second (default is 60 pixels/sec)\n\t\t * @param\tmaxTime\t\tTime given in milliseconds (1000 = 1 sec). If set the speed is adjusted so the source will arrive at destination in the given number of ms\n\t\t */\n\t\tpublic static function moveTowardsMouse(source:FlxSprite, speed:int = 60, maxTime:int = 0):void\n\t\t{\n\t\t\tvar a:Number = angleBetweenMouse(source);\n\t\t\t\n\t\t\tif (maxTime > 0)\n\t\t\t{\n\t\t\t\tvar d:int = distanceToMouse(source);\n\t\t\t\t\n\t\t\t\t//\tWe know how many pixels we need to move, but how fast?\n\t\t\t\tspeed = d / (maxTime / 1000);\n\t\t\t}\n\t\t\t\n\t\t\tsource.velocity.x = Math.cos(a) * speed;\n\t\t\tsource.velocity.y = Math.sin(a) * speed;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Sets the x/y acceleration on the source FlxSprite so it will move towards the mouse coordinates at the speed given (in pixels per second)
\n\t\t * You must give a maximum speed value, beyond which the FlxSprite won't go any faster.
\n\t\t * If you don't need acceleration look at moveTowardsMouse() instead.\n\t\t * \n\t\t * @param\tsource\t\t\tThe FlxSprite on which the acceleration will be set\n\t\t * @param\tspeed\t\t\tThe speed it will accelerate in pixels per second\n\t\t * @param\txSpeedMax\t\tThe maximum speed in pixels per second in which the sprite can move horizontally\n\t\t * @param\tySpeedMax\t\tThe maximum speed in pixels per second in which the sprite can move vertically\n\t\t */\n\t\tpublic static function accelerateTowardsMouse(source:FlxSprite, speed:int, xSpeedMax:uint, ySpeedMax:uint):void\n\t\t{\n\t\t\tvar a:Number = angleBetweenMouse(source);\n\t\t\t\n\t\t\tsource.velocity.x = 0;\n\t\t\tsource.velocity.y = 0;\n\t\t\t\n\t\t\tsource.acceleration.x = int(Math.cos(a) * speed);\n\t\t\tsource.acceleration.y = int(Math.sin(a) * speed);\n\t\t\t\n\t\t\tsource.maxVelocity.x = xSpeedMax;\n\t\t\tsource.maxVelocity.y = ySpeedMax;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Sets the x/y velocity on the source FlxSprite so it will move towards the target coordinates at the speed given (in pixels per second)
\n\t\t * If you specify a maxTime then it will adjust the speed (over-writing what you set) so it arrives at the destination in that number of seconds.
\n\t\t * Timings are approximate due to the way Flash timers work, and irrespective of SWF frame rate. Allow for a variance of +- 50ms.
\n\t\t * The source object doesn't stop moving automatically should it ever reach the destination coordinates.
\n\t\t * \n\t\t * @param\tsource\t\tThe FlxSprite to move\n\t\t * @param\ttarget\t\tThe FlxPoint coordinates to move the source FlxSprite towards\n\t\t * @param\tspeed\t\tThe speed it will move, in pixels per second (default is 60 pixels/sec)\n\t\t * @param\tmaxTime\t\tTime given in milliseconds (1000 = 1 sec). If set the speed is adjusted so the source will arrive at destination in the given number of ms\n\t\t */\n\t\tpublic static function moveTowardsPoint(source:FlxSprite, target:FlxPoint, speed:int = 60, maxTime:int = 0):void\n\t\t{\n\t\t\tvar a:Number = angleBetweenPoint(source, target);\n\t\t\t\n\t\t\tif (maxTime > 0)\n\t\t\t{\n\t\t\t\tvar d:int = distanceToPoint(source, target);\n\t\t\t\t\n\t\t\t\t//\tWe know how many pixels we need to move, but how fast?\n\t\t\t\tspeed = d / (maxTime / 1000);\n\t\t\t}\n\t\t\t\n\t\t\tsource.velocity.x = Math.cos(a) * speed;\n\t\t\tsource.velocity.y = Math.sin(a) * speed;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Sets the x/y acceleration on the source FlxSprite so it will move towards the target coordinates at the speed given (in pixels per second)
\n\t\t * You must give a maximum speed value, beyond which the FlxSprite won't go any faster.
\n\t\t * If you don't need acceleration look at moveTowardsPoint() instead.\n\t\t * \n\t\t * @param\tsource\t\t\tThe FlxSprite on which the acceleration will be set\n\t\t * @param\ttarget\t\t\tThe FlxPoint coordinates to move the source FlxSprite towards\n\t\t * @param\tspeed\t\t\tThe speed it will accelerate in pixels per second\n\t\t * @param\txSpeedMax\t\tThe maximum speed in pixels per second in which the sprite can move horizontally\n\t\t * @param\tySpeedMax\t\tThe maximum speed in pixels per second in which the sprite can move vertically\n\t\t */\n\t\tpublic static function accelerateTowardsPoint(source:FlxSprite, target:FlxPoint, speed:int, xSpeedMax:uint, ySpeedMax:uint):void\n\t\t{\n\t\t\tvar a:Number = angleBetweenPoint(source, target);\n\t\t\t\n\t\t\tsource.velocity.x = 0;\n\t\t\tsource.velocity.y = 0;\n\t\t\t\n\t\t\tsource.acceleration.x = int(Math.cos(a) * speed);\n\t\t\tsource.acceleration.y = int(Math.sin(a) * speed);\n\t\t\t\n\t\t\tsource.maxVelocity.x = xSpeedMax;\n\t\t\tsource.maxVelocity.y = ySpeedMax;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Find the distance (in pixels, rounded) between two FlxSprites, taking their origin into account\n\t\t * \n\t\t * @param\ta\tThe first FlxSprite\n\t\t * @param\tb\tThe second FlxSprite\n\t\t * @return\tint\tDistance (in pixels)\n\t\t */\n\t\tpublic static function distanceBetween(a:FlxSprite, b:FlxSprite):int\n\t\t{\n\t\t\tvar dx:Number = (a.x + a.origin.x) - (b.x + b.origin.x);\n\t\t\tvar dy:Number = (a.y + a.origin.y) - (b.y + b.origin.y);\n\t\t\t\n\t\t\treturn int(FlxMath.vectorLength(dx, dy));\n\t\t}\n\t\t\n\t\t/**\n\t\t * Find the distance (in pixels, rounded) from an FlxSprite to the given FlxPoint, taking the source origin into account\n\t\t * \n\t\t * @param\ta\t\tThe first FlxSprite\n\t\t * @param\ttarget\tThe FlxPoint\n\t\t * @return\tint\t\tDistance (in pixels)\n\t\t */\n\t\tpublic static function distanceToPoint(a:FlxSprite, target:FlxPoint):int\n\t\t{\n\t\t\tvar dx:Number = (a.x + a.origin.x) - (target.x);\n\t\t\tvar dy:Number = (a.y + a.origin.y) - (target.y);\n\t\t\t\n\t\t\treturn int(FlxMath.vectorLength(dx, dy));\n\t\t}\n\t\t\n\t\t/**\n\t\t * Find the distance (in pixels, rounded) from the object x/y and the mouse x/y\n\t\t * \n\t\t * @param\ta\tThe FlxSprite to test against\n\t\t * @return\tint\tThe distance between the given sprite and the mouse coordinates\n\t\t */\n\t\tpublic static function distanceToMouse(a:FlxSprite):int\n\t\t{\n\t\t\tvar dx:Number = (a.x + a.origin.x) - FlxG.mouse.screenX;\n\t\t\tvar dy:Number = (a.y + a.origin.y) - FlxG.mouse.screenY;\n\t\t\t\n\t\t\treturn int(FlxMath.vectorLength(dx, dy));\n\t\t}\n\t\t\n\t\t/**\n\t\t * Find the angle (in radians) between an FlxSprite and an FlxPoint. The source sprite takes its x/y and origin into account.\n\t\t * The angle is calculated in clockwise positive direction (down = 90 degrees positive, right = 0 degrees positive, up = 90 degrees negative)\n\t\t * \n\t\t * @param\ta\t\t\tThe FlxSprite to test from\n\t\t * @param\ttarget\t\tThe FlxPoint to angle the FlxSprite towards\n\t\t * @param\tasDegrees\tIf you need the value in degrees instead of radians, set to true\n\t\t * \n\t\t * @return\tNumber The angle (in radians unless asDegrees is true)\n\t\t */\n\t\tpublic static function angleBetweenPoint(a:FlxSprite, target:FlxPoint, asDegrees:Boolean = false):Number\n {\n\t\t\tvar dx:Number = (target.x) - (a.x + a.origin.x);\n\t\t\tvar dy:Number = (target.y) - (a.y + a.origin.y);\n\t\t\t\n\t\t\tif (asDegrees)\n\t\t\t{\n\t\t\t\treturn FlxMath.asDegrees(Math.atan2(dy, dx));\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\treturn Math.atan2(dy, dx);\n\t\t\t}\n }\n\t\t\n\t\t/**\n\t\t * Find the angle (in radians) between the two FlxSprite, taking their x/y and origin into account.\n\t\t * The angle is calculated in clockwise positive direction (down = 90 degrees positive, right = 0 degrees positive, up = 90 degrees negative)\n\t\t * \n\t\t * @param\ta\t\t\tThe FlxSprite to test from\n\t\t * @param\tb\t\t\tThe FlxSprite to test to\n\t\t * @param\tasDegrees\tIf you need the value in degrees instead of radians, set to true\n\t\t * \n\t\t * @return\tNumber The angle (in radians unless asDegrees is true)\n\t\t */\n\t\tpublic static function angleBetween(a:FlxSprite, b:FlxSprite, asDegrees:Boolean = false):Number\n {\n\t\t\tvar dx:Number = (b.x + b.origin.x) - (a.x + a.origin.x);\n\t\t\tvar dy:Number = (b.y + b.origin.y) - (a.y + a.origin.y);\n\t\t\t\n\t\t\tif (asDegrees)\n\t\t\t{\n\t\t\t\treturn FlxMath.asDegrees(Math.atan2(dy, dx));\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\treturn Math.atan2(dy, dx);\n\t\t\t}\n }\n\t\t\n\t\t/**\n\t\t * Given the angle and speed calculate the velocity and return it as an FlxPoint\n\t\t * \n\t\t * @param\tangle\tThe angle (in degrees) calculated in clockwise positive direction (down = 90 degrees positive, right = 0 degrees positive, up = 90 degrees negative)\n\t\t * @param\tspeed\tThe speed it will move, in pixels per second sq\n\t\t * \n\t\t * @return\tAn FlxPoint where FlxPoint.x contains the velocity x value and FlxPoint.y contains the velocity y value\n\t\t */\n\t\tpublic static function velocityFromAngle(angle:int, speed:int):FlxPoint\n\t\t{\n\t\t\tvar a:Number = FlxMath.asRadians(angle);\n\t\t\t\n\t\t\tvar result:FlxPoint = new FlxPoint;\n\t\t\t\n\t\t\tresult.x = int(Math.cos(a) * speed);\n\t\t\tresult.y = int(Math.sin(a) * speed);\n\t\t\t\n\t\t\treturn result;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Given the FlxSprite and speed calculate the velocity and return it as an FlxPoint based on the direction the sprite is facing\n\t\t * \n\t\t * @param\tparent\tThe FlxSprite to get the facing value from\n\t\t * @param\tspeed\tThe speed it will move, in pixels per second sq\n\t\t * \n\t\t * @return\tAn FlxPoint where FlxPoint.x contains the velocity x value and FlxPoint.y contains the velocity y value\n\t\t */\n\t\tpublic static function velocityFromFacing(parent:FlxSprite, speed:int):FlxPoint\n\t\t{\n\t\t\tvar a:Number;\n\t\t\t\n\t\t\tif (parent.facing == FlxObject.LEFT)\n\t\t\t{\n\t\t\t\ta = FlxMath.asRadians(180);\n\t\t\t}\n\t\t\telse if (parent.facing == FlxObject.RIGHT)\n\t\t\t{\n\t\t\t\ta = FlxMath.asRadians(0);\n\t\t\t}\n\t\t\telse if (parent.facing == FlxObject.UP)\n\t\t\t{\n\t\t\t\ta = FlxMath.asRadians( -90);\n\t\t\t}\n\t\t\telse if (parent.facing == FlxObject.DOWN)\n\t\t\t{\n\t\t\t\ta = FlxMath.asRadians(90);\n\t\t\t}\n\t\t\t\n\t\t\tvar result:FlxPoint = new FlxPoint;\n\t\t\t\n\t\t\tresult.x = int(Math.cos(a) * speed);\n\t\t\tresult.y = int(Math.sin(a) * speed);\n\t\t\t\n\t\t\treturn result;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Find the angle (in radians) between an FlxSprite and the mouse, taking their x/y and origin into account.\n\t\t * The angle is calculated in clockwise positive direction (down = 90 degrees positive, right = 0 degrees positive, up = 90 degrees negative)\n\t\t * \n\t\t * @param\ta\t\t\tThe FlxObject to test from\n\t\t * @param\tasDegrees\tIf you need the value in degrees instead of radians, set to true\n\t\t * \n\t\t * @return\tNumber The angle (in radians unless asDegrees is true)\n\t\t */\n\t\tpublic static function angleBetweenMouse(a:FlxSprite, asDegrees:Boolean = false):Number\n\t\t{\n\t\t\t//\tIn order to get the angle between the object and mouse, we need the objects screen coordinates (rather than world coordinates)\n\t\t\tvar p:FlxPoint = a.getScreenXY();\n\t\t\t\n\t\t\tvar dx:Number = FlxG.mouse.screenX - p.x;\n\t\t\tvar dy:Number = FlxG.mouse.screenY - p.y;\n\t\t\t\n\t\t\tif (asDegrees)\n\t\t\t{\n\t\t\t\treturn FlxMath.asDegrees(Math.atan2(dy, dx));\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\treturn Math.atan2(dy, dx);\n\t\t\t}\n\t\t}\n \n\t\t\n\t\t\n\t}\n\n}"
},
{
"path": "src/org/flixel/plugin/photonstorm/FlxWeapon.as",
"content": "/**\n * FlxWeapon\n * -- Part of the Flixel Power Tools set\n * \n * v1.3 Added bullet elasticity and bulletsFired counter\n * v1.2 Added useParentDirection boolean\n * v1.1 Added pre-fire, fire and post-fire callbacks and sound support, rnd factors, boolean returns and currentBullet\n * v1.0 First release\n * \n * @version 1.3 - October 9th 2011\n * @link http://www.photonstorm.com\n * @author Richard Davey / Photon Storm\n*/\n\npackage org.flixel.plugin.photonstorm \n{\n\timport org.flixel.*;\n\timport flash.utils.getTimer;\n\timport org.flixel.plugin.photonstorm.BaseTypes.Bullet;\n\timport org.flixel.plugin.photonstorm.FlxVelocity;\n\t\n\t/**\n\t * TODO\n\t * ----\n\t * \n\t * Angled bullets\n\t * Baked Rotation support for angled bullets\n\t * Bullet death styles (particle effects)\n\t * Bullet trails - blur FX style and Missile Command \"draw lines\" style? (could be another FX plugin)\n\t * Homing Missiles\n\t * Bullet uses random sprite from sprite sheet (for rainbow style bullets), or cycles through them in sequence?\n\t * Some Weapon base classes like shotgun, lazer, etc?\n\t */\n\t\n\tpublic class FlxWeapon \n\t{\n\t\t/**\n\t\t * Internal name for this weapon (i.e. \"pulse rifle\")\n\t\t */\n\t\tpublic var name:String;\n\t\t\n\t\t/**\n\t\t * The FlxGroup into which all the bullets for this weapon are drawn. This should be added to your display and collision checked against it.\n\t\t */\n\t\tpublic var group:FlxGroup;\n\t\t\n\t\t//\tBullet values\n\t\tpublic var bounds:FlxRect;\n\t\t\n\t\tprivate var bulletSpeed:uint;\n\t\tprivate var rotateToAngle:Boolean;\n\t\t\n\t\t//\tWhen firing from a fixed position (i.e. Missile Command)\n\t\tprivate var fireFromPosition:Boolean;\n\t\tprivate var fireX:int;\n\t\tprivate var fireY:int;\n\t\t\n\t\tprivate var lastFired:uint = 0;\n\t\tprivate var nextFire:uint = 0;\n\t\tprivate var fireRate:uint = 0;\n\t\t\n\t\t//\tWhen firing from a parent sprites position (i.e. Space Invaders)\n\t\tprivate var fireFromParent:Boolean;\n\t\tprivate var parent:*;\n\t\tprivate var parentXVariable:String;\n\t\tprivate var parentYVariable:String;\n\t\tprivate var positionOffset:FlxPoint;\n\t\tprivate var directionFromParent:Boolean;\n\t\tprivate var angleFromParent:Boolean;\n\t\t\n\t\tprivate var velocity:FlxPoint;\n\t\t\n\t\tpublic var multiShot:uint = 0;\n\t\t\n\t\tpublic var bulletLifeSpan:uint = 0;\n\t\tpublic var bulletElasticity:Number = 0;\n\t\t\n\t\tpublic var rndFactorAngle:uint = 0;\n\t\tpublic var rndFactorLifeSpan:uint = 0;\n\t\tpublic var rndFactorSpeed:uint = 0;\n\t\tpublic var rndFactorPosition:FlxPoint = new FlxPoint;\n\t\t\n\t\t/**\n\t\t * A reference to the Bullet that was fired\n\t\t */\n\t\tpublic var currentBullet:Bullet;\n\t\t\n\t\t//\tCallbacks\n\t\tpublic var onPreFireCallback:Function;\n\t\tpublic var onFireCallback:Function;\n\t\tpublic var onPostFireCallback:Function;\n\t\t\n\t\t//\tSounds\n\t\tpublic var onPreFireSound:FlxSound;\n\t\tpublic var onFireSound:FlxSound;\n\t\tpublic var onPostFireSound:FlxSound;\n\t\t\n\t\t//\tQuick firing direction angle constants\n\t\tpublic static const BULLET_UP:int = -90;\n\t\tpublic static const BULLET_DOWN:int = 90;\n\t\tpublic static const BULLET_LEFT:int = 180;\n\t\tpublic static const BULLET_RIGHT:int = 0;\n\t\tpublic static const BULLET_NORTH_EAST:int = -45;\n\t\tpublic static const BULLET_NORTH_WEST:int = -135;\n\t\tpublic static const BULLET_SOUTH_EAST:int = 45;\n\t\tpublic static const BULLET_SOUTH_WEST:int = 135;\n\t\t\n\t\t/**\n\t\t * Keeps a tally of how many bullets have been fired by this weapon\n\t\t */\n\t\tpublic var bulletsFired:uint = 0;\n\t\t\n\t\t//\tTODO :)\n\t\tprivate var currentMagazine:uint;\n\t\t//private var currentBullet:uint;\n\t\tprivate var magazineCount:uint;\n\t\tprivate var bulletsPerMagazine:uint;\n\t\tprivate var magazineSwapDelay:uint;\n\t\tprivate var magazineSwapCallback:Function;\n\t\tprivate var magazineSwapSound:FlxSound;\n\t\t\n\t\tprivate static const FIRE:uint = 0;\n\t\tprivate static const FIRE_AT_MOUSE:uint = 1;\n\t\tprivate static const FIRE_AT_POSITION:uint = 2;\n\t\tprivate static const FIRE_AT_TARGET:uint = 3;\n\t\tprivate static const FIRE_FROM_ANGLE:uint = 4;\n\t\tprivate static const FIRE_FROM_PARENT_ANGLE:uint = 5;\n\t\t\n\t\t/**\n\t\t * Creates the FlxWeapon class which will fire your bullets.
\n\t\t * You should call one of the makeBullet functions to visually create the bullets.
\n\t\t * Then either use setDirection with fire() or one of the fireAt functions to launch them.\n\t\t * \n\t\t * @param\tname\t\tThe name of your weapon (i.e. \"lazer\" or \"shotgun\"). For your internal reference really, but could be displayed in-game.\n\t\t * @param\tparentRef\tIf this weapon belongs to a parent sprite, specify it here (bullets will fire from the sprites x/y vars as defined below).\n\t\t * @param\txVariable\tThe x axis variable of the parent to use when firing. Typically \"x\", but could be \"screenX\" or any public getter that exposes the x coordinate.\n\t\t * @param\tyVariable\tThe y axis variable of the parent to use when firing. Typically \"y\", but could be \"screenY\" or any public getter that exposes the y coordinate.\n\t\t */\n\t\tpublic function FlxWeapon(name:String, parentRef:* = null, xVariable:String = \"x\", yVariable:String = \"y\")\n\t\t{\n\t\t\tthis.name = name;\n\t\t\t\n\t\t\tbounds = new FlxRect(0, 0, FlxG.width, FlxG.height);\n\t\t\t\n\t\t\tpositionOffset = new FlxPoint;\n\t\t\t\n\t\t\tvelocity = new FlxPoint;\n\t\t\t\n\t\t\tif (parentRef)\n\t\t\t{\n\t\t\t\tsetParent(parentRef, xVariable, yVariable);\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Makes a pixel bullet sprite (rather than an image). You can set the width/height and color of the bullet.\n\t\t * \n\t\t * @param\tquantity\tHow many bullets do you need to make? This value should be high enough to cover all bullets you need on-screen *at once* plus probably a few extra spare!\n\t\t * @param\twidth\t\tThe width (in pixels) of the bullets\n\t\t * @param\theight\t\tThe height (in pixels) of the bullets\n\t\t * @param\tcolor\t\tThe color of the bullets. Must be given in 0xAARRGGBB format\n\t\t * @param\toffsetX\t\tWhen the bullet is fired if you need to offset it on the x axis, for example to line it up with the \"nose\" of a space ship, set the amount here (positive or negative)\n\t\t * @param\toffsetY\t\tWhen the bullet is fired if you need to offset it on the y axis, for example to line it up with the \"nose\" of a space ship, set the amount here (positive or negative)\n\t\t */\n\t\tpublic function makePixelBullet(quantity:uint, width:int = 2, height:int = 2, color:uint = 0xffffffff, offsetX:int = 0, offsetY:int = 0):void\n\t\t{\n\t\t\tgroup = new FlxGroup(quantity);\n\t\t\t\n\t\t\tfor (var b:uint = 0; b < quantity; b++)\n\t\t\t{\n\t\t\t\tvar tempBullet:Bullet = new Bullet(this, b);\n\t\t\t\t\n\t\t\t\ttempBullet.makeGraphic(width, height, color);\n\t\t\t\t\n\t\t\t\tgroup.add(tempBullet);\n\t\t\t}\n\t\t\t\n\t\t\tpositionOffset.x = offsetX;\n\t\t\tpositionOffset.y = offsetY;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Makes a bullet sprite from the given image. It will use the width/height of the image.\n\t\t * \n\t\t * @param\tquantity\t\tHow many bullets do you need to make? This value should be high enough to cover all bullets you need on-screen *at once* plus probably a few extra spare!\n\t\t * @param\timage\t\t\tThe image used to create the bullet from\n\t\t * @param\toffsetX\t\t\tWhen the bullet is fired if you need to offset it on the x axis, for example to line it up with the \"nose\" of a space ship, set the amount here (positive or negative)\n\t\t * @param\toffsetY\t\t\tWhen the bullet is fired if you need to offset it on the y axis, for example to line it up with the \"nose\" of a space ship, set the amount here (positive or negative)\n\t\t * @param\tautoRotate\t\tWhen true the bullet sprite will rotate to match the angle of the parent sprite. Call fireFromParentAngle or fromFromAngle to fire it using an angle as the velocity.\n\t\t * @param\tframe\t\t\tIf the image has a single row of square animation frames on it, you can specify which of the frames you want to use here. Default is -1, or \"use whole graphic\"\n\t\t * @param\trotations\t\tThe number of rotation frames the final sprite should have. For small sprites this can be quite a large number (360 even) without any problems.\n\t\t * @param\tantiAliasing\tWhether to use high quality rotations when creating the graphic. Default is false.\n\t\t * @param\tautoBuffer\t\tWhether to automatically increase the image size to accomodate rotated corners. Default is false. Will create frames that are 150% larger on each axis than the original frame or graphic.\n\t\t */\n\t\tpublic function makeImageBullet(quantity:uint, image:Class, offsetX:int = 0, offsetY:int = 0, autoRotate:Boolean = false, rotations:uint = 16, frame:int = -1, antiAliasing:Boolean = false, autoBuffer:Boolean = false):void\n\t\t{\n\t\t\tgroup = new FlxGroup(quantity);\n\t\t\t\n\t\t\trotateToAngle = autoRotate;\n\t\t\t\n\t\t\tfor (var b:uint = 0; b < quantity; b++)\n\t\t\t{\n\t\t\t\tvar tempBullet:Bullet = new Bullet(this, b);\n\t\t\t\t\n\t\t\t\tif (autoRotate)\n\t\t\t\t{\n\t\t\t\t\ttempBullet.loadRotatedGraphic(image, rotations, frame, antiAliasing, autoBuffer);\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\ttempBullet.loadGraphic(image);\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\tgroup.add(tempBullet);\n\t\t\t}\n\t\t\t\n\t\t\tpositionOffset.x = offsetX;\n\t\t\tpositionOffset.y = offsetY;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Makes an animated bullet from the image and frame data given.\n\t\t * \n\t\t * @param\tquantity\t\tHow many bullets do you need to make? This value should be high enough to cover all bullets you need on-screen *at once* plus probably a few extra spare!\n\t\t * @param\timageSequence\tThe image used to created the animated bullet from\n\t\t * @param\tframeWidth\t\tThe width of each frame in the animation\n\t\t * @param\tframeHeight\t\tThe height of each frame in the animation\n\t\t * @param\tframes\t\t\tAn array of numbers indicating what frames to play in what order (e.g. 1, 2, 3)\n\t\t * @param\tframeRate\t\tThe speed in frames per second that the animation should play at (e.g. 40 fps)\n\t\t * @param\tlooped\t\t\tWhether or not the animation is looped or just plays once\n\t\t * @param\toffsetX\t\t\tWhen the bullet is fired if you need to offset it on the x axis, for example to line it up with the \"nose\" of a space ship, set the amount here (positive or negative)\n\t\t * @param\toffsetY\t\t\tWhen the bullet is fired if you need to offset it on the y axis, for example to line it up with the \"nose\" of a space ship, set the amount here (positive or negative)\n\t\t */\n\t\tpublic function makeAnimatedBullet(quantity:uint, imageSequence:Class, frameWidth:uint, frameHeight:uint, frames:Array, frameRate:uint, looped:Boolean, offsetX:int = 0, offsetY:int = 0):void\n\t\t{\n\t\t\tgroup = new FlxGroup(quantity);\n\t\t\t\n\t\t\tfor (var b:uint = 0; b < quantity; b++)\n\t\t\t{\n\t\t\t\tvar tempBullet:Bullet = new Bullet(this, b);\n\t\t\t\t\n\t\t\t\ttempBullet.loadGraphic(imageSequence, true, false, frameWidth, frameHeight);\n\t\t\t\t\n\t\t\t\ttempBullet.addAnimation(\"fire\", frames, frameRate, looped);\n\t\t\t\t\n\t\t\t\tgroup.add(tempBullet);\n\t\t\t}\n\t\t\t\n\t\t\tpositionOffset.x = offsetX;\n\t\t\tpositionOffset.y = offsetY;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Internal function that handles the actual firing of the bullets\n\t\t * \n\t\t * @param\tmethod\n\t\t * @param\tx\n\t\t * @param\ty\n\t\t * @param\ttarget\n\t\t * @return\ttrue if a bullet was fired or false if one wasn't available. The bullet last fired is stored in FlxWeapon.prevBullet\n\t\t */\n\t\tprivate function runFire(method:uint, x:int = 0, y:int = 0, target:FlxSprite = null, angle:int = 0):Boolean\n\t\t{\n\t\t\tif (fireRate > 0 && (getTimer() < nextFire))\n\t\t\t{\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\t\n\t\t\tcurrentBullet = getFreeBullet();\n\t\t\t\n\t\t\tif (currentBullet == null)\n\t\t\t{\n\t\t\t\treturn false;\n\t\t\t}\n\n\t\t\tif (onPreFireCallback is Function)\n\t\t\t{\n\t\t\t\tonPreFireCallback.apply();\n\t\t\t}\n\t\t\t\n\t\t\tif (onPreFireSound)\n\t\t\t{\n\t\t\t\tonPreFireSound.play();\n\t\t\t}\n\t\t\t\n\t\t\t//\tClear any velocity that may have been previously set from the pool\n\t\t\tcurrentBullet.velocity.x = 0;\n\t\t\tcurrentBullet.velocity.y = 0;\n\t\t\t\n\t\t\tlastFired = getTimer();\n\t\t\tnextFire = getTimer() + fireRate;\n\t\t\t\n\t\t\tvar launchX:int = positionOffset.x;\n\t\t\tvar launchY:int = positionOffset.y;\n\t\t\t\n\t\t\tif (fireFromParent)\n\t\t\t{\n\t\t\t\tlaunchX += parent[parentXVariable];\n\t\t\t\tlaunchY += parent[parentYVariable];\n\t\t\t}\n\t\t\telse if (fireFromPosition)\n\t\t\t{\n\t\t\t\tlaunchX += fireX;\n\t\t\t\tlaunchY += fireY;\n\t\t\t}\n\t\t\t\n\t\t\tif (directionFromParent)\n\t\t\t{\n\t\t\t\tvelocity = FlxVelocity.velocityFromFacing(parent, bulletSpeed);\n\t\t\t}\n\t\t\t\n\t\t\t//\tFaster (less CPU) to use this small if-else ladder than a switch statement\n\t\t\tif (method == FIRE)\n\t\t\t{\n\t\t\t\tcurrentBullet.fire(launchX, launchY, velocity.x, velocity.y);\n\t\t\t}\n\t\t\telse if (method == FIRE_AT_MOUSE)\n\t\t\t{\n\t\t\t\tcurrentBullet.fireAtMouse(launchX, launchY, bulletSpeed);\n\t\t\t}\n\t\t\telse if (method == FIRE_AT_POSITION)\n\t\t\t{\n\t\t\t\tcurrentBullet.fireAtPosition(launchX, launchY, x, y, bulletSpeed);\n\t\t\t}\n\t\t\telse if (method == FIRE_AT_TARGET)\n\t\t\t{\n\t\t\t\tcurrentBullet.fireAtTarget(launchX, launchY, target, bulletSpeed);\n\t\t\t}\n\t\t\telse if (method == FIRE_FROM_ANGLE)\n\t\t\t{\n\t\t\t\tcurrentBullet.fireFromAngle(launchX, launchY, angle, bulletSpeed);\n\t\t\t}\n\t\t\telse if (method == FIRE_FROM_PARENT_ANGLE)\n\t\t\t{\n\t\t\t\tcurrentBullet.fireFromAngle(launchX, launchY, parent.angle, bulletSpeed);\n\t\t\t}\n\t\t\t\n\t\t\tif (onPostFireCallback is Function)\n\t\t\t{\n\t\t\t\tonPostFireCallback.apply();\n\t\t\t}\n\t\t\t\n\t\t\tif (onPostFireSound)\n\t\t\t{\n\t\t\t\tonPostFireSound.play();\n\t\t\t}\n\t\t\t\n\t\t\tbulletsFired++;\n\t\t\t\n\t\t\treturn true;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Fires a bullet (if one is available). The bullet will be given the velocity defined in setBulletDirection and fired at the rate set in setFireRate.\n\t\t * \n\t\t * @return\ttrue if a bullet was fired or false if one wasn't available. A reference to the bullet fired is stored in FlxWeapon.currentBullet.\n\t\t */\n\t\tpublic function fire():Boolean\n\t\t{\n\t\t\treturn runFire(FIRE);\n\t\t}\n\t\t\n\t\t/**\n\t\t * Fires a bullet (if one is available) at the mouse coordinates, using the speed set in setBulletSpeed and the rate set in setFireRate.\n\t\t * \n\t\t * @return\ttrue if a bullet was fired or false if one wasn't available. A reference to the bullet fired is stored in FlxWeapon.currentBullet.\n\t\t */\n\t\tpublic function fireAtMouse():Boolean\n\t\t{\n\t\t\treturn runFire(FIRE_AT_MOUSE);\n\t\t}\n\t\t\n\t\t/**\n\t\t * Fires a bullet (if one is available) at the given x/y coordinates, using the speed set in setBulletSpeed and the rate set in setFireRate.\n\t\t * \n\t\t * @param\tx\tThe x coordinate (in game world pixels) to fire at\n\t\t * @param\ty\tThe y coordinate (in game world pixels) to fire at\n\t\t * @return\ttrue if a bullet was fired or false if one wasn't available. A reference to the bullet fired is stored in FlxWeapon.currentBullet.\n\t\t */\n\t\tpublic function fireAtPosition(x:int, y:int):Boolean\n\t\t{\n\t\t\treturn runFire(FIRE_AT_POSITION, x, y);\n\t\t}\n\t\t\n\t\t/**\n\t\t * Fires a bullet (if one is available) at the given targets x/y coordinates, using the speed set in setBulletSpeed and the rate set in setFireRate.\n\t\t * \n\t\t * @param\ttarget\tThe FlxSprite you wish to fire the bullet at\n\t\t * @return\ttrue if a bullet was fired or false if one wasn't available. A reference to the bullet fired is stored in FlxWeapon.currentBullet.\n\t\t */\n\t\tpublic function fireAtTarget(target:FlxSprite):Boolean\n\t\t{\n\t\t\treturn runFire(FIRE_AT_TARGET, 0, 0, target);\n\t\t}\n\t\t\n\t\t/**\n\t\t * Fires a bullet (if one is available) based on the given angle\n\t\t * \n\t\t * @param\tangle\tThe angle (in degrees) calculated in clockwise positive direction (down = 90 degrees positive, right = 0 degrees positive, up = 90 degrees negative)\n\t\t * @return\ttrue if a bullet was fired or false if one wasn't available. A reference to the bullet fired is stored in FlxWeapon.currentBullet.\n\t\t */\n\t\tpublic function fireFromAngle(angle:int):Boolean\n\t\t{\n\t\t\treturn runFire(FIRE_FROM_ANGLE, 0, 0, null, angle);\n\t\t}\n\t\t\n\t\t/**\n\t\t * Fires a bullet (if one is available) based on the angle of the Weapons parent\n\t\t * \n\t\t * @return\ttrue if a bullet was fired or false if one wasn't available. A reference to the bullet fired is stored in FlxWeapon.currentBullet.\n\t\t */\n\t\tpublic function fireFromParentAngle():Boolean\n\t\t{\n\t\t\treturn runFire(FIRE_FROM_PARENT_ANGLE);\n\t\t}\n\t\t\n\t\t/**\n\t\t * Causes the Weapon to fire from the parents x/y value, as seen in Space Invaders and most shoot-em-ups.\n\t\t * \n\t\t * @param\tparentRef\t\tIf this weapon belongs to a parent sprite, specify it here (bullets will fire from the sprites x/y vars as defined below).\n\t\t * @param\txVariable\t\tThe x axis variable of the parent to use when firing. Typically \"x\", but could be \"screenX\" or any public getter that exposes the x coordinate.\n\t\t * @param\tyVariable\t\tThe y axis variable of the parent to use when firing. Typically \"y\", but could be \"screenY\" or any public getter that exposes the y coordinate.\n\t\t * @param\toffsetX\t\t\tWhen the bullet is fired if you need to offset it on the x axis, for example to line it up with the \"nose\" of a space ship, set the amount here (positive or negative)\n\t\t * @param\toffsetY\t\t\tWhen the bullet is fired if you need to offset it on the y axis, for example to line it up with the \"nose\" of a space ship, set the amount here (positive or negative)\n\t\t * @param\tuseDirection\tWhen fired the bullet direction is based on parent sprites facing value (up/down/left/right)\n\t\t */\n\t\tpublic function setParent(parentRef:*, xVariable:String, yVariable:String, offsetX:int = 0, offsetY:int = 0, useDirection:Boolean = false):void\n\t\t{\n\t\t\tif (parentRef)\n\t\t\t{\n\t\t\t\tfireFromParent = true;\n\t\t\t\t\n\t\t\t\tparent = parentRef;\n\t\t\t\t\n\t\t\t\tparentXVariable = xVariable;\n\t\t\t\tparentYVariable = yVariable;\n\t\t\t\n\t\t\t\tpositionOffset.x = offsetX;\n\t\t\t\tpositionOffset.y = offsetY;\n\t\t\t\t\n\t\t\t\tdirectionFromParent = useDirection;\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * Causes the Weapon to fire from a fixed x/y position on the screen, like in the game Missile Command.
\n\t\t * If set this over-rides a call to setParent (which causes the Weapon to fire from the parents x/y position)\n\t\t * \n\t\t * @param\tx\tThe x coordinate (in game world pixels) to fire from\n\t\t * @param\ty\tThe y coordinate (in game world pixels) to fire from\n\t\t * @param\toffsetX\t\tWhen the bullet is fired if you need to offset it on the x axis, for example to line it up with the \"nose\" of a space ship, set the amount here (positive or negative)\n\t\t * @param\toffsetY\t\tWhen the bullet is fired if you need to offset it on the y axis, for example to line it up with the \"nose\" of a space ship, set the amount here (positive or negative)\n\t\t */\n\t\tpublic function setFiringPosition(x:int, y:int, offsetX:int = 0, offsetY:int = 0):void\n\t\t{\n\t\t\tfireFromPosition = true;\n\t\t\tfireX = x;\n\t\t\tfireY = y;\n\t\t\t\n\t\t\tpositionOffset.x = offsetX;\n\t\t\tpositionOffset.y = offsetY;\n\t\t}\n\t\t\n\t\t/**\n\t\t * The speed in pixels/sec (sq) that the bullet travels at when fired via fireAtMouse, fireAtPosition or fireAtTarget.\n\t\t * You can update this value in real-time, should you need to speed-up or slow-down your bullets (i.e. collecting a power-up)\n\t\t * \n\t\t * @param\tspeed\t\tThe speed it will move, in pixels per second (sq)\n\t\t */\n\t\tpublic function setBulletSpeed(speed:uint):void\n\t\t{\n\t\t\tbulletSpeed = speed;\n\t\t}\n\t\t\n\t\t/**\n\t\t * The speed in pixels/sec (sq) that the bullet travels at when fired via fireAtMouse, fireAtPosition or fireAtTarget.\n\t\t * \n\t\t * @return\tThe speed the bullet moves at, in pixels per second (sq)\n\t\t */\n\t\tpublic function getBulletSpeed():uint\n\t\t{\n\t\t\treturn bulletSpeed;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Sets the firing rate of the Weapon. By default there is no rate, as it can be controlled by FlxControl.setFireButton.\n\t\t * However if you are firing using the mouse you may wish to set a firing rate.\n\t\t * \n\t\t * @param\trate\tThe delay in milliseconds (ms) between which each bullet is fired, set to zero to clear\n\t\t */\n\t\tpublic function setFireRate(rate:uint):void\n\t\t{\n\t\t\tfireRate = rate;\n\t\t}\n\t\t\n\t\t/**\n\t\t * When a bullet goes outside of this bounds it will be automatically killed, freeing it up for firing again.\n\t\t * TODO - Needs testing with a scrolling map (when not using single screen display)\n\t\t * \n\t\t * @param\tbounds\tAn FlxRect area. Inside this area the bullet should be considered alive, once outside it will be killed.\n\t\t */\n\t\tpublic function setBulletBounds(bounds:FlxRect):void\n\t\t{\n\t\t\tthis.bounds = bounds;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Set the direction the bullet will travel when fired.\n\t\t * You can use one of the consts such as BULLET_UP, BULLET_DOWN or BULLET_NORTH_EAST to set the angle easily.\n\t\t * Speed should be given in pixels/sec (sq) and is the speed at which the bullet travels when fired.\n\t\t * \n\t\t * @param\tangle\t\tThe angle of the bullet. In clockwise positive direction: Right = 0, Down = 90, Left = 180, Up = -90. You can use one of the consts such as BULLET_UP, etc\n\t\t * @param\tspeed\t\tThe speed it will move, in pixels per second (sq)\n\t\t */\n\t\tpublic function setBulletDirection(angle:int, speed:uint):void\n\t\t{\n\t\t\tvelocity = FlxVelocity.velocityFromAngle(angle, speed);\n\t\t}\n\t\t\n\t\t/**\n\t\t * Sets gravity on all currently created bullets
\n\t\t * This will update ALL bullets, even those currently \"in flight\", so be careful about when you call this!\n\t\t * \n\t\t * @param\txForce\tA positive value applies gravity dragging the bullet to the right. A negative value drags the bullet to the left. Zero disables horizontal gravity.\n\t\t * @param\tyforce\tA positive value applies gravity dragging the bullet down. A negative value drags the bullet up. Zero disables vertical gravity.\n\t\t */\n\t\tpublic function setBulletGravity(xForce:int, yForce:int):void\n\t\t{\n\t\t\tgroup.setAll(\"xGravity\", xForce);\n\t\t\tgroup.setAll(\"yGravity\", yForce);\n\t\t}\n\t\t\n\t\t/**\n\t\t * If you'd like your bullets to accelerate to their top speed rather than be launched already at it, then set the acceleration value here.\n\t\t * If you've previously set the acceleration then setting it to zero will cancel the effect.\n\t\t * This will update ALL bullets, even those currently \"in flight\", so be careful about when you call this!\n\t\t * \n\t\t * @param\txAcceleration\t\tAcceleration speed in pixels per second to apply to the sprites horizontal movement, set to zero to cancel. Negative values move left, positive move right.\n\t\t * @param\tyAcceleration\t\tAcceleration speed in pixels per second to apply to the sprites vertical movement, set to zero to cancel. Negative values move up, positive move down.\n\t\t * @param\txSpeedMax\t\t\tThe maximum speed in pixels per second in which the sprite can move horizontally\n\t\t * @param\tySpeedMax\t\t\tThe maximum speed in pixels per second in which the sprite can move vertically\n\t\t */\n\t\tpublic function setBulletAcceleration(xAcceleration:int, yAcceleration:int, xSpeedMax:int, ySpeedMax:int):void\n\t\t{\n\t\t\tif (xAcceleration == 0 && yAcceleration == 0)\n\t\t\t{\n\t\t\t\tgroup.setAll(\"accelerates\", false);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tgroup.setAll(\"accelerates\", true);\n\t\t\t\tgroup.setAll(\"xAcceleration\", xAcceleration);\n\t\t\t\tgroup.setAll(\"yAcceleration\", yAcceleration);\n\t\t\t\tgroup.setAll(\"maxVelocityX\", xSpeedMax);\n\t\t\t\tgroup.setAll(\"maxVelocityY\", ySpeedMax);\n\t\t\t}\n\t\t}\n\t\t\n\t\t/**\n\t\t * When the bullet is fired from a parent (or fixed position) it will do so from their x/y coordinate.
\n\t\t * Often you need to align a bullet with the sprite, i.e. to make it look like it came out of the \"nose\" of a space ship.
\n\t\t * Use this offset x/y value to achieve that effect.\n\t\t * \n\t\t * @param\toffsetX\t\tThe x coordinate offset to add to the launch location (positive or negative)\n\t\t * @param\toffsetY\t\tThe y coordinate offset to add to the launch location (positive or negative)\n\t\t */\n\t\tpublic function setBulletOffset(offsetX:int, offsetY:int):void\n\t\t{\n\t\t\tpositionOffset.x = offsetX;\n\t\t\tpositionOffset.y = offsetY;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Give the bullet a random factor to its angle, speed, position or lifespan when fired. Can create a nice \"scatter gun\" effect.\n\t\t * \n\t\t * @param\trandomAngle\t\tThe +- value applied to the angle when fired. For example 20 means the bullet can fire up to 20 degrees under or over its angle when fired.\n\t\t * @param\trandomSpeed\t\tThe +- value applied to the bullet speed when fired. For example 10 means the bullet speed varies by +- 10px/sec\n\t\t * @param\trandomPosition\tThe +- values applied to the x/y coordinates the bullet is fired from.\n\t\t * @param\trandomLifeSpan\tThe +- values applied to the life span of the bullet.\n\t\t */\n\t\tpublic function setBulletRandomFactor(randomAngle:uint = 0, randomSpeed:uint = 0, randomPosition:FlxPoint = null, randomLifeSpan:uint = 0):void\n\t\t{\n\t\t\trndFactorAngle = randomAngle;\n\t\t\trndFactorSpeed = randomSpeed;\n\t\t\t\n\t\t\tif (randomPosition != null)\n\t\t\t{\n\t\t\t\trndFactorPosition = randomPosition;\n\t\t\t}\n\t\t\t\n\t\t\trndFactorLifeSpan = randomLifeSpan;\n\t\t}\n\t\t\n\t\t/**\n\t\t * If the bullet should have a fixed life span use this function to set it.\n\t\t * The bullet will be killed once it passes this lifespan (if still alive and in bounds)\n\t\t * \n\t\t * @param\tlifespan\tThe lifespan of the bullet in ms, calculated when the bullet is fired. Set to zero to disable bullet lifespan.\n\t\t */\n\t\tpublic function setBulletLifeSpan(lifespan:int):void\n\t\t{\n\t\t\tbulletLifeSpan = lifespan;\n\t\t}\n\t\t\n\t\t/**\n\t\t * The elasticity of the fired bullet controls how much it rebounds off collision surfaces.\n\t\t * \n\t\t * @param\telasticity\tThe elasticity of the bullet between 0 and 1 (0 being no rebound, 1 being 100% force rebound). Set to zero to disable.\n\t\t */\n\t\tpublic function setBulletElasticity(elasticity:Number):void\n\t\t{\n\t\t\tbulletElasticity = elasticity;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Internal function that returns the next available bullet from the pool (if any)\n\t\t * \n\t\t * @return\tA bullet\n\t\t */\n\t\tprivate function getFreeBullet():Bullet\n\t\t{\n\t\t\tvar result:Bullet = null;\n\t\t\t\n\t\t\tif (group == null || group.length == 0)\n\t\t\t{\n\t\t\t\tthrow new Error(\"Weapon.as cannot fire a bullet until one has been created via a call to makePixelBullet or makeImageBullet\");\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\t\n\t\t\tfor each (var bullet:Bullet in group.members)\n\t\t\t{\n\t\t\t\tif (bullet.exists == false)\n\t\t\t\t{\n\t\t\t\t\tresult = bullet;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t\t\n\t\t\treturn result;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Sets a pre-fire callback function and sound. These are played immediately before the bullet is fired.\n\t\t * \n\t\t * @param\tcallback\tThe function to call\n\t\t * @param\tsound\t\tAn FlxSound to play\n\t\t */\n\t\tpublic function setPreFireCallback(callback:Function = null, sound:FlxSound = null):void\n\t\t{\n\t\t\tonPreFireCallback = callback;\n\t\t\tonPreFireSound = sound;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Sets a fire callback function and sound. These are played immediately as the bullet is fired.\n\t\t * \n\t\t * @param\tcallback\tThe function to call\n\t\t * @param\tsound\t\tAn FlxSound to play\n\t\t */\n\t\tpublic function setFireCallback(callback:Function = null, sound:FlxSound = null):void\n\t\t{\n\t\t\tonFireCallback = callback;\n\t\t\tonFireSound = sound;\n\t\t}\n\t\t\n\t\t/**\n\t\t * Sets a post-fire callback function and sound. These are played immediately after the bullet is fired.\n\t\t * \n\t\t * @param\tcallback\tThe function to call\n\t\t * @param\tsound\t\tAn FlxSound to play\n\t\t */\n\t\tpublic function setPostFireCallback(callback:Function = null, sound:FlxSound = null):void\n\t\t{\n\t\t\tonPostFireCallback = callback;\n\t\t\tonPostFireSound = sound;\n\t\t}\n\t\t\n\t\t// TODO\n\t\tpublic function TODOcreateBulletPattern(pattern:Array):void\n\t\t{\n\t\t\t//\tLaunches this many bullets\n\t\t}\n\t\t\n\t\t\n\t\tpublic function update():void\n\t\t{\n\t\t\t// ???\n\t\t}\n\t\t\n\t}\n\n}"
},
{
"path": "src/org/flixel/plugin/photonstorm/PNGEncoder.as",
"content": "/*\n Copyright (c) 2008, Adobe Systems Incorporated\n All rights reserved.\n\n Redistribution and use in source and binary forms, with or without \n modification, are permitted provided that the following conditions are\n met:\n\n * Redistributions of source code must retain the above copyright notice, \n this list of conditions and the following disclaimer.\n \n * Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the \n documentation and/or other materials provided with the distribution.\n \n * Neither the name of Adobe Systems Incorporated nor the names of its \n contributors may be used to endorse or promote products derived from \n this software without specific prior written permission.\n\n THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS\n IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,\n THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR\n PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR \n CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,\n EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,\n PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR\n PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF\n LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\n NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\n SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n*/\npackage org.flixel.plugin.photonstorm\n{\n\timport flash.geom.*;\n\timport flash.display.Bitmap;\n\timport flash.display.BitmapData;\n\timport flash.utils.ByteArray;\n\n\t/**\n\t * Class that converts BitmapData into a valid PNG\n\t */\t\n\tpublic class PNGEncoder\n\t{\n\t\t/**\n\t\t * Created a PNG image from the specified BitmapData\n\t\t *\n\t\t * @param image The BitmapData that will be converted into the PNG format.\n\t\t * @return a ByteArray representing the PNG encoded image data.\n\t\t * @langversion ActionScript 3.0\n\t\t * @playerversion Flash 9.0\n\t\t * @tiptext\n\t\t */\t\t\t\n\t public static function encode(img:BitmapData):ByteArray {\n\t // Create output byte array\n\t var png:ByteArray = new ByteArray();\n\t // Write PNG signature\n\t png.writeUnsignedInt(0x89504e47);\n\t png.writeUnsignedInt(0x0D0A1A0A);\n\t // Build IHDR chunk\n\t var IHDR:ByteArray = new ByteArray();\n\t IHDR.writeInt(img.width);\n\t IHDR.writeInt(img.height);\n\t IHDR.writeUnsignedInt(0x08060000); // 32bit RGBA\n\t IHDR.writeByte(0);\n\t writeChunk(png,0x49484452,IHDR);\n\t // Build IDAT chunk\n\t var IDAT:ByteArray= new ByteArray();\n\t for(var i:int=0;i < img.height;i++) {\n\t // no filter\n\t IDAT.writeByte(0);\n\t var p:uint;\n\t var j:int;\n\t if ( !img.transparent ) {\n\t for(j=0;j < img.width;j++) {\n\t p = img.getPixel(j,i);\n\t IDAT.writeUnsignedInt(\n\t uint(((p&0xFFFFFF) << 8)|0xFF));\n\t }\n\t } else {\n\t for(j=0;j < img.width;j++) {\n\t p = img.getPixel32(j,i);\n\t IDAT.writeUnsignedInt(\n\t uint(((p&0xFFFFFF) << 8)|\n\t (p>>>24)));\n\t }\n\t }\n\t }\n\t IDAT.compress();\n\t writeChunk(png,0x49444154,IDAT);\n\t // Build IEND chunk\n\t writeChunk(png,0x49454E44,null);\n\t // return PNG\n\t return png;\n\t }\n\t\n\t private static var crcTable:Array;\n\t private static var crcTableComputed:Boolean = false;\n\t\n\t private static function writeChunk(png:ByteArray, \n\t type:uint, data:ByteArray):void {\n\t if (!crcTableComputed) {\n\t crcTableComputed = true;\n\t crcTable = [];\n\t var c:uint;\n\t for (var n:uint = 0; n < 256; n++) {\n\t c = n;\n\t for (var k:uint = 0; k < 8; k++) {\n\t if (c & 1) {\n\t c = uint(uint(0xedb88320) ^ \n\t uint(c >>> 1));\n\t } else {\n\t c = uint(c >>> 1);\n\t }\n\t }\n\t crcTable[n] = c;\n\t }\n\t }\n\t var len:uint = 0;\n\t if (data != null) {\n\t len = data.length;\n\t }\n\t png.writeUnsignedInt(len);\n\t var p:uint = png.position;\n\t png.writeUnsignedInt(type);\n\t if ( data != null ) {\n\t png.writeBytes(data);\n\t }\n\t var e:uint = png.position;\n\t png.position = p;\n\t c = 0xffffffff;\n\t for (var i:int = 0; i < (e-p); i++) {\n\t c = uint(crcTable[\n\t (c ^ png.readUnsignedByte()) & \n\t uint(0xff)] ^ uint(c >>> 8));\n\t }\n\t c = uint(c^uint(0xffffffff));\n\t png.position = e;\n\t png.writeUnsignedInt(c);\n\t }\n\t}\n}"
}
]