[Stuff] Kleine Preloader-Klasse für die Faulen (AS2)

[hellslawyer]

Mahlzeit,

da ich auch zu den Leuten gehöre, die faul sind und sich das ewige Getüddel mit den Preloadern gerne sparen würden, habe ich für den Krempel mal eine kleine Klasse gebaut, mit der man den Krams mit drei Zeilen Code erledigen kann. Das ganze in AS2, da ich derzeit leider noch nicht so oft mit AS3 spielen darf ...

Klasse und Beispiel findet Ihr im Anhang. Hier mal ein Beispielaufruf aus einer FLA:

//---
/*
* ##################################################
* @author  Reinhart Redel - sickworks.com - (c)2009
* @version Preloader V1
* ##################################################
*/
//---
 
import com.sickworks.utils.Preloader;
 
var pnt:Object = {x:800, y:0};
loaderstuff.globalToLocal(pnt)
loaderstuff._visible = false;
 
var pl1:Preloader = new Preloader("gecko_big.png", pr1, loadinit);
pl1.addTransforms([loaderstuff.loader_circle, {keepProps: false, _xscale: 25, _yscale: 25, _rotation: 1440}], loaderstuff.prtext1, " %");
pl1.addTransforms([loaderstuff.loader_ymover, {_x: pnt.x - loaderstuff.loader_ymover._width / 2, _y: pnt.y + loaderstuff.loader_ymover._height / 2, keepProps: true}]);
pl1.addTransforms([loaderstuff.loader_width, {_xscale: 100}]);
pl1.showBytesLoaded(loaderstuff.prtext2, " bytes loaded");
pl1.showBytesTotal(loaderstuff.prtext3, " KB total ", true);
pl1.showBytesLoadedTotal(loaderstuff.prtext4, " KB of ", " KB loaded", true);
pl1.showPercent(loaderstuff.prtext5, " % loaded");
 
 
function loadinit(mc:MovieClip):Void
{
    mc._xscale = mc._yscale = 50;
    loaderstuff._visible = false;
}
startloading.onRelease = function():Void
{
    loaderstuff._visible = true;
    pl1.start();
} 

Die Parameter:
Konstruktor:

public function Preloader(clipToLoad:String, target:MovieClip, callback:Function)

- clipToLoad: die URL des zu ladenden swfs oder Bild
- target: der MC in den der Krempel geladen werden soll
- callback: die Funktion, die aufgerufen werden soll, wenn alles komplett geladen ist

Transform-Parameter (es soll sich ja auch was bewegen ):

public function addTransforms(clipsToTransform:Array, pctTextField:TextField, textToAdd:String):Void

- clipsToTransform: ein Array, das die MCs enthält, die verändert werden sollen und natürlich deren Parameter. Aufbau ist wie folgt:
[MC_der_verändert_wird, {Object mit den Properties (_x, _y, ...)}, MC, Object, MC, Object, ...] (immer schön abwechselnd)
Wichtig:
Für das TransformObject gibt es eine spezielle Property namens "keepProps". Wenn man diese auf true setzt, werden die ursprünglichen Eigenschaften des MCs beibehalten und als Ausgangspunkt für die Transformation benutzt. Wird die Eigenschaft nicht oder auf false gesetzt, werden alle Properties, die im TransformObject stehen zu Beginn des Ladevorgangs auf 0 gesetzt!
- pctTextField (optional): das Textfeld, in dem die geladenen Prozent angezeigt werden sollen
- textToAdd (optional, wenn pctTextField gesetzt ist): Text der hinter der Prozentzahl angezeigt werden soll

Zusätzliche Methoden:
Bereits geladene Bytes anzeigen:

public function showBytesLoaded(targetTextField:TextField, textToAdd:String, useKB:Boolean):Void

- targetTextField: das Textfeld in dem die geladenen Bytes angezeigt werden sollen
- textToAdd: Text, der hinter den geladenen Bytes angezeigt werden soll
- useKB: auf true gestellt, werden nur volle KiloByte angezeigt

Gesamtgröße des zu ladenden MCs anzeigen:

public function showBytesTotal(targetTextField:TextField, textToAdd:String, useKB:Boolean):Void

- Parameter genau wie bei showBytesLoaded

Geladene Bytes und Gesamtgröße anzeigen:

public function showBytesLoadedTotal(targetTextField:TextField, textToAddAfterLoaded:String, textToAddAfterTotal:String, useKB:Boolean):Void

- targetTextField: das Textfeld in dem die geladenen Bytes angezeigt werden sollen
- textToAddAfterLoaded: Text der hinter den geladenen Bytes angezeigt werden soll
- textToAddAfterTotal: Text der hinter der Gesamtgröße angezeigt werden soll
- useKB: auf true gestellt, werden nur volle KiloByte angezeigt

Geladene Prozent anzeigen:

public function showPercent(targetTextField:TextField, textToAdd:String):Void

(Sofern man nicht bereits bei den Transformparametern ein Textfeld angegeben hat, oder die Prozente in ein weiteres Textfeld schieben möchte)
- targetTextField: das Textfeld in dem die Prozente angezeigt werden sollen
- textToAdd: Text, der hinter den Prozenten angezeigt werden soll

Und last but not least natürlich die Funktion zum starten des Ladevorgangs:

public function start():Void

Beispiel:

meine_preloaderinstanz.start();

Eine Demo und die ausführliche Dokumentation findet Ihr hier:
http://www.sickworks.com/tools/preloaderclass.html

Bugs und Sonderwünsche bitte einfach hier melden

[hellslawyer]

Huch, die einfachste Möglichkeit hatte ich ja gar nicht genannt.
Preloader mit 5 Zeilen Code.
Features: Prozentanzeige + Ladebalken (beliebig erweiterbar)

//---
/*
* ##################################################
* @author  Reinhart Redel - sickworks.com - (c)2009
* @version Preloader V1
* ##################################################
*/
//---
 
import com.sickworks.utils.Preloader;
 
var pl1:Preloader = new Preloader("gecko_big.png", pr1, loadinit);
pl1.addTransforms([loaderbar_mc, {keepProps: false, _xscale: 100}], loadertextfield, " % loaded");
pl1.start();
 
function loadinit(mc:MovieClip):Void {trace("I damn loaded your stuff!")};