(category) LIST of posts

Dynamisk textField

TextField

//A
	import flash.text.TextField; 
//B
	var ttt:TextField=new TextField();
//D
	function makeTextField() {
		ttt.wordWrap=true;
		ttt.mouseWheelEnabled=true;
		/*
		ttt.border=true;
		ttt.borderColor=0xFF0000;
		ttt.background=true;
		ttt.backgroundColor=0xFF00FF;
		*/
		ttt.x=10;
		ttt.y=10;
		ttt.width=335;
		ttt.height=325;
		addChild(ttt);
	}
//C/D 
//Placeres i scriptet hvor der er behov for det:
//Alene i constructoren eller i anden relevant funktion-sammenhæng
	makeTextField();
	ttt.text="En eller anden text";
	// Kan også sættes til at være html
	ttt.htmlText="En lille tekst med taggen <b>b</b> og <i>i</i>";

Mange tilgængelige properties for textField – marker ordet textField i codevindue og tryk F1, for at se Adobes reference. Det samme gælder for textFormat nedenfor.

TextFormat

Yderligere formatering i tekstboksen kan styres med textFormat:

//A
	import flash.text.TextFormat;
//B
	var tfFormat = new TextFormat();
//D
	function formatTextField() {
		tfFormat.color="0x0000FF";
		tfFormat.size=40;	
		tfFormat.leftMargin =20;
		tfFormat.rightMargin =20;
	}
//C/D // i relevant sammenhæng
// fx. i begyndelsen af makeTextField
	formatTextField();
	ttt.defaultTextFormat=tfFormat;

UIScrollBar

Det ER muligt at generere en scrollbar dynamisk, men den skal være i Library først! Træk en scrolbar-component ind på scenen og lav evt. om på grafikdelene, for derefter at SLETTE DEN IGEN. Så vil den være i Library og være tilgængelig for actionScript.

//A
        import fl.controls.*;
//B
        var VScroller:UIScrollBar = new UIScrollBar();
//D
	function makeScroller() {
            VScroller.direction = ScrollBarDirection.VERTICAL;
            VScroller.scrollTarget = ttt;
            VScroller.height= ttt.height;
            VScroller.move(ttt.x + ttt.width, ttt.y);
            addChild(VScroller);
        }
//C/D // i relevant sammenhæng
// fx. efter makeTextField();
	makeScroller();
// Hvergang teksten er blevet ændret
// fx. i forbindelse med ny load
	VScroller.update();

Eksempler spil

Eksplorative spil

cartelle.nl: Egentlig mest legetøj
questfortherest
3wish.com
amanitadesign
99rooms

Samling i kategorier

kylemawer index

Nuttede

orisinal

Actionscript sproget

friendsofed: sample fra “The Essential Guide to Flash CS4 with ActionScript”

Lynda.com Se kapitel 2 og 3 på listen med gratis videoer

Variables, Data types, Classes, Properties, Methods fra RC
loops fra republicofcode
if-conditions fra RC
branching fra tutsplus

arrays i 3 dele fra flashmagazine123

as3-101-variables
as3-101-arrays
as3-101-functions

Class A B C

Dette er en skabelon til en class. Actioncript-filen hedder: ABC.as.

Bemærk fil-navnet, class-navnet og constructor-navnet – som altid skal være ens.

A- B- C- D- er betegnelsen for niveauer, jeg vil referere til for at tydeliggøre strukturen i actionscript og for at gøre det nemt at implementere funktionalitet – (fx. fra andre poster i snippet-kategorien).

package {
    // ::: A ::: // flAAsh clAAsses importeres
    import flash.display.MovieClip;
 
    public class ABC extends MovieClip {       
        // ::: B ::: // variaBBler og oBBjekter BBliver BBrugbare i kommende funktioner
 
        public function ABC() {
        // ::: C ::: // CConstruCCtor - Indledende handlinger
 
        }
        // ::: D ::: // DDiverse funktioner DDu laver DDem
 
    }
}

Emner:
Linke til flash fil, movieclip, instanciering
Samme struktur på en framescript – forskelle – fordele / ulemper
OOP. Genbrug, uden copy-paste. Inheritance, Encapsulation & Polymorphism
Public, Private, Protected, Internal: Access Modifiers

XML loader

Hvad er XML?

Extensible Markup Language. En tekst-fil med extensionen: “.xml”, hvor repetitivt data og indhold kan lagres i en struktureret form, der anvender tags og atributter, som i xhtml.
Xml-filer agerer som lette databaser og som “feeds” i form af RSS-indhold. (Really Simple Syndication).

Hvorfor XML?

XML er let at redigere og ligger gerne ekstern i forhold til en flash-fil. Det bruges ofte til at lagre oplysninger som filnavne og stier på den type filer, der kan loades ind i actionscript (swf, jpg, gif, png, mp3, flv..). XML er foruden playlister af forskellig art, brugt til menusystemer.

Eksempel

Den rå kode for at loade en xml-fil, hvis du har en sådan:

//A
	import flash.net.URLRequest;
	import flash.net.URLLoader;
//B
	var XMLLoader:URLLoader = new URLLoader();
//C/D i relevant sammenhæng
	XMLLoader.load(new URLRequest("adressen_paa_din_xml_fil.xml")); 
	XMLLoader.addEventListener(Event.COMPLETE, onLoadXML);
//D
	function onLoadXML(e:Event):void  {
		var xml:XML = new XML(e.target.data);//xml i en string
		var xmlList:XMLList = new XMLList(xml.children());//emne liste
		trace(xml); //Prøv også: trace(xmlList);
	}

Det er praktisk at trace xml for at få indblik i filens struktur og indhold, hvis den loades fra en internet adresse. Læg mærke til Tagnavne og Atributnavne.
xmlList er nødvendig for at fortolke og få adgang til oplistede emner. Den indeholder nu struktur og data fra xml.

Filtrering af data

Kan sammenlignes med at skrive ’stien’ til det ønskede emne. Forestil dig som 100 årig foran en xml-fil med dine efterkommere:

xmlList.barn.barnebarn.oldebarn; for at nå frem til alle oldebørn.
xmlList.barn.barnebarn.oldebarn[0]; for at få fat i første oldebarn på listen.
xmlList.barn.barnebarn.@foedselsdag; er det samme som:
xmlList.barn.barnebarn.attribute(foedselsdag); for at se børnebørn med atributten: foedselsdag.

RSS Reader

//Paste fx. denne adresse ind i URLLoaderen's URLRequest: 
'http://curlingthebrackets.com/category/flash/feed/'
//og lav denne trace: 
trace(xmlList.item.title);

Galleri med XML

I eksemplet her, er navnene og adresserne på de billeder, som skal bruges i galleriet, listet op i en xml-fil.

Get Adobe Flash player

Opbygning og overblik

xmlgalleri0

Billedmapperne thumbnails og images indeholder samme billeder i henholdsvis lille og fuld størrelse.
Xml-filen: images.xml laves som en ganske almindelig tekstfil og lægges til dette eksempel i en mappe data og refererer til billedernes sti, navne og billedtekst:

<?xml version="1.0" encoding="utf-8"?>
<images>
	<image full="images/image1.jpg" thumb="thumbnails/image1.jpg">Description of image 1.</image>
	<image full="images/image2.jpg" thumb="thumbnails/image2.jpg">Description of image 2.</image>
	<image full="images/image3.jpg" thumb="thumbnails/image3.jpg">Description of image 3.</image>
</images>

Forberedelse (brug af classes)

En flashfil: XMLgallery.fla med et tomt movieclip: gallery
Linkage mellem gallery og en as-fil: gallery.as
Instanciering af gallery-class – ved at trække gallery ind på scenen – ELLER som her dynamisk med et framescript på scenen:

var gallery1:gallery=new gallery();
addChild(gallery1);

Opsæt gallery.as og dens class-constructor i sin package:

package {
	/// :::: A :::: /// Import af flash classes
	import flash.display.MovieClip;
	import flash.events.*;
	public class gallery extends MovieClip {		
		/// :::: B :::: /// Oprettelse af variabler og tilgængeliggørelse af objekt-navne
		public function gallery() {	
			/// :::: C :::: /// Indledende handlinger - "constructor"
		}
		/// :::: D :::: /// Tilknyttede funktioner	
	}
}

NB: Bemærk niveauerne A, B, C, D, som opdeler en class, hvori forskellige dele af et actionscript hører hjemme, og som jeg vil henvise til gennem alle nedenstående 3 trin. Hver funktionalitet involverer actions på flere af niveauerne.
Næste trins kode skal ikke erstatte den forrige, men flettes ind i den eksisterende kode på de anviste niveauer, og således implementeres.

Forberedelse (brug af framescript)

En flashfil: XMLgallery.fla med et actionscript-lag på scenen. På dens første keyframe kan niveau-inddeles med kommentarer:

	/// :::: A :::: /// Import af flash classes
 
	/// :::: B :::: /// Oprettelse af variabler og tilgængeliggørelse af objekt-navne
 
	/// :::: C :::: /// Indledende handlinger - "constructor"
 
	/// :::: D :::: /// Tilknyttede funktioner

Kodneanvisningerne i nedenstående trin bruges og flettes sammen i frameskriptet UDEN ORDET “PUBLIC” FORAN VARIABLER OG FUNKTIONER

Resten af arbejdet foregår med en trinvis scripting af funktionalitet i opsætningen, gennem følgende 3 trin:
1 – Load og fortolk xml-filen
2 – Load og vis alle thumbnails
3 – Load og vis det valgte billede

1 – Load og fortolk xml-filen

//Niveau A
	import flash.net.URLRequest;
	import flash.net.URLLoader;
//Niveau B
		public var xmlDoc:String="data/images.xml"; //Adressen på xml-filen
		public var xmlLoader:URLLoader=new URLLoader(); //Opret det relevante URLLoader-objekt
		public var xml:XML; //Navnet på xml-objektet
		public var xmlList:XMLList; //Navnet på den liste, hvori xml.elementerne kommer til at stå
//Niveau C
			// Load xml-filen med adressen
			xmlLoader.load(new URLRequest(xmlDoc));
			// Når xml-filen er færdig-loadet, udføres XMLCOMPLETE funktionen
			xmlLoader.addEventListener(Event.COMPLETE, XMLCOMPLETE);
//Niveau D
		public function XMLCOMPLETE(e:Event):void {
			// Påfyld flash's xml-beholder med xmlLoader-data!
			xml=XML(e.target.data);
			// Oplist elementerne fra xml-filens "rod" i rækkefølge
			xmlList=xml.children();
			// Udfør funktionen LOADTHUMBS
			LOADTHUMBS();
		}

2 – Load og vis alle thumbnails

//Niveau A
	// URLRequest skal kun tilføjes hvis den ikke er importeret på trin 1
	import flash.net.URLRequest;
	import flash.display.Loader;
//Niveau B
		public var thumbLoader:Loader;
//Niveau D
		public function LOADTHUMBS():void {
			var thumbUrl:String;
			// For hvert element i xml-filen dannes en "thumbLoader"
			for (var i:int=0; i<xmlList.length(); i++) {
				//værdien af hver "thumb" attribut overføres til thumbUrl
				thumbUrl=xmlList[i].attribute("thumb");
				thumbLoader=new Loader();
				thumbLoader.load(new URLRequest(thumbUrl));
				//thumbLoader bliver snedigt omdøbt til adressen på det fulde billede
				thumbLoader.name=xmlList[i].attribute("full");
				thumbLoader.x=20;
				// 130=thumb's bredde, 20= passende luft 
				thumbLoader.y=i*130+20;
				addChild(thumbLoader);
				// hver thumbLoader aktiveres til at kunne udføre SHOWFULL
				thumbLoader.addEventListener(MouseEvent.CLICK, SHOWFULL);
			}
		}

3 – Load og vis det valgte billede

//Niveau A
	// URLRequest skal kun importeres hvis den ikke allerede er der
	import flash.net.URLRequest;
	// Loader er allerede importeret i trin 2, skal kun tilføjes hvis den mangler
	import flash.display.Loader;
//Niveau B
		public var fullLoader:Loader;
//Niveau D
		public function SHOWFULL(e:MouseEvent):void {
			// fjern det viste billede, hvis der er et i forvejen
			if (fullLoader) {
				removeChild(fullLoader);
			}
			// Opret en fullLoader til det billede, der skal vises
			fullLoader=new Loader();
			//"e.target.name" er  "thumbLoader.name" fra LOADTHUMBS
			var imgUrl=new URLRequest(e.target.name);
			fullLoader.load(imgUrl);
			fullLoader.x=160;
			fullLoader.y=20;
			addChild(fullLoader);
		}

Ekstra funktionalitet

- En dynamisk tekstboks til at vise billedteksten fra xml-filen
- En Fade-effekt med flash’s indbyggedeTween-class, på selve billederne når de vises.

//Niveau A
	import flash.text.TextField;
	import flash.text.TextFieldAutoSize;
	import fl.transitions.Tween;
	import fl.transitions.easing.*;
//Niveau B
		public var imageText:TextField=new TextField();
		public var fadeTween:Tween;
//Niveau C
			// Sæt tekstboksens bredde
			imageText.autoSize=TextFieldAutoSize.LEFT;
			// Opret den tekstboks, som skal indeholde billedtekst
			addChild(imageText);
			// Kan starte med at vise en instruktion til bruger
			imageText.text=" Klik på en af billederne for at se et stort";
//Niveau D, indenfor SHOWFULL funktionen - nederst 
			// Placer tekstboksen lige over billedkanten
			imageText.x=fullLoader.x;
			imageText.y=fullLoader.y-20;		
			// Find den billedtekst, der hører til 
			for (var j:int=0; j<xmlList.length(); j++) {
				// Samlign thumbLoaders navn med alle xml-listens "full" atributter
				// "e.target.name" er "imageLoader.name" fra LOADTHUMBS
				if (xmlList[j].attribute("full")==e.target.name) {
					// Indholdet fra nummer "j" på xmlList er tekst indpakket i tags			
					// Overfør denne tekst til tekstboksen
					imageText.text=xmlList[j];
					// Igangsæt den importerede Tween class med ønskede indstillinger
					fadeTween=new Tween(fullLoader,"alpha",None.easeNone,0,1,1,true);
				}
			}

Yderlig øvelse og info:

Kapitel 14 i “Learning ActionScript 3.0″ handler specifikt om XML i AS: Strukturen, skrive, læse, slette, loade. Kapitlet afsluttes med en menubar som øvelse.
simple image loader