My personal version of RBLuaInterpreter class is supporting all node’s of LevelSVG  and can be directly attached to objects in xml. So no programming is needed at all. Now to the concepts behind, but before that please read Robert’s Blog where to downloaf Lua itself and how its integrated in your project. The C++ class written by him end’s with the standard mechanism how to call Lua and back to C, so that’s exactly the same here in my class. The “trick” is to add some scripting extensions where I can pass LevelSVG BodyNode objects to Lua and call then method’s out of Lua which change behavior in the calling object or other GameNode child objects.

In the example attached, it’s done with the help of a tag id, so it’s also easy to request an object from GameNode object and call them back.

Below is a sample Lua script, which give’s you an idea how it looks like in my game. Of course, Lua allow’s also a more OO approach, but for us it was not important to use the language in it’s best but to have a full scriptable engine. But some of the nice Lua feature’s like returning multiple parameters from a function are implemented of course.

So feel free to download the attached project, use the class and let me know what you’ve done based on that. Happy (game) coding!

Example Screenshot of LuaTest

--
-- Game object scripts are called with events
--
-- init: When level is created and before it starts
-- exit: When game object is released
-- contactbegin: When contact with other game object begins
-- contactend: When contact with other game object ends
-- bullettouches: When game object is touched by bullet
-- herotouches: When game object is touched by hero
--
-- show balks (id 1,2) and hide balk (id 3,4)
--
print("BEGIN level1-13-showbalks.lua");
objectId = arg[1];
event = arg[2];
--
if (event == "bullettouches") then
balk1 = level.getObject(1);
object.setHidden(balk1, 0);
balk2 = level.getObject(2);
object.setHidden(balk2, 0);
balk3 = level.getObject(3);
object.setHidden(balk3, 1);
balk4 = level.getObject(4);
object.setHidden(balk4, 1);
end
--
print("END level1-13-showbalks.lua");


Copyright (c) 2010 MyCompanyName. All rights reserved.

erzeugt. Bis zur Version 3.2 war eine einfache Änderung dieses Firmennamens nicht möglich. In Version 3.2 von XCode findet sich nun aber endlich eine Funktion, um dies direkt aus der IDE heraus zu änden. Interessant ist, dass man das pro Proekt ändern kann, was insbesondere ein nützliches Fetaure ist, wenn im Kundenauftrag arbeitet. Um das zu bewerkstelligen, einfach mit der rechten Maustaste den Projekteintrag selektieren, Get Info drücken und dann den Firmennamen unter General Settings wechseln.

Wichtig ist natürlich, dass sich auf dem Mac auf dem die nachfolgenden Commands ausgeführt werden, auch wirklich ein Backup befindet…

1. Zip file downloaden und im Home Verzeichnis entpacken
2. Terminal App öffnen
3. Setzen der Dateiattribute: chmod u=x createdb
4. Ausfuhren der Datei mit: ./createdb
5. Fertig!

Anmerkung: Je nach SDK kann es jetzt noch sein, dass man im Finder die Datei /Users/admin/Library/Application Support/iPhone Simulator/User/Library/AddressBook/AddressBook.sqlitedb auch noch in die anderen Verzeichnisse (also z.B. /Users/admin/Library/Application Support/iPhone Simulator/3.1.3/Library/AddressBook/AddressBook.sqlitedb) kopieren muss, was aber wieder im Finder geschehen kann.

Btw.: Das Script habe ich übrigens nicht ganz selber geschrieben, sondern vor einiger Zeit mal irgendwo gefunden und angepasst. Wenn ich den Link wieder finde füge ich ihn noch an.

Nutzen als Werbeplatform

Die schwindende Wirkung von konventionellen Werbeformen verlangt nach neuen Wegen, über die Menschen effizient erreicht werden können. Werben mit Spielen ist einer dieser Wege. Games erhalten als Freizeitbeschäftigung in dreierlei Hinsicht Bedeutung für die Werbeindustrie: Aufgrund der demografischen Verbreitung, der aufmerksamkeitsstarken Wirkung und des intensiven Involvements des Spielers in die Handlung. Hinzu kommt eine hohe Aufmerksamkeit: Wer spielt, richtet seinen Fokus ausschliesslich auf die Spielhandlung. Dabei treffen Videospiele sogar den wichtigsten Werbeträger, das Fernsehen, an seiner empfindlichsten Stelle: Berufstätige spielen überwiegend zur Entspannung nach Feierabend, zur so genannten „Primetime“. Genau dann, wenn sie eigentlich für die Werbebotschaften erreichbar sein sollten. Wenn man diese Aufmerksamkeitzurückgewinnen will, kommt man also nicht umhin, mit den Werbe-Botschaften auch in Spielen und deren Umfeld präsent zu sein. Werben lässt sich dabei auf zwei unterschiedliche Weisen:

Als Teil des Gameplay

Wenn Marke oder Produkt zum Teil der Spielhandlung werden, ist das Involvement des Spielers am grössten. Die Wahrnehmung ist garantiert, der Spieler setzt sich intensiv mit der Marke auseinander und wird die im Spiel erlebten Emotionen mit der Marke in Verbindung bringen. Diese Werbeform ist nicht nur die effektivste, sie ist sicher auch die aufwendigste.

Teil der Spieleszenerie

Die Werbung, die Marke oder das Produkt tauchen im Szenario des Games auf, zum Beispiel als Bandenwerbung in einem Sportspiel. Oder aber als Getränkeautomat, Geschäftsfiliale oder einfach als Teil einer Kulisse. Spannend ist diese Werbeform vor allem, wenn sie dynamisch ins Spiel eingefügt wird und nicht statisch im Spiel integriert sein muss. So können Banden oder Billboards tagesaktuell und sogar mit regionalem Bezug platziert werden. Auf dem iPhone sind beide Arten problemlos möglich. Durch die perfekte Symbiose von grossem Display, guten Multimediainhalten und einfachem Onlinezugriff ist das iPhone schnell zum inbegriff des mobilen Spielens geworden, mit rasant wachsender Tendenz.

Spielegenres, Umsetzung und Kosten

Die bevorzugten Genres auf dem iPhone sind Fun-, und Geschicklichkeitsspiele, was durch den Typ des Freizeitspielers und des mobilen Nutzerverhaltens auch logisch erscheint. Hinzu kommen zwei wesentliuche Faktoren:

• Ein schneller Einstieg: Es muss sofort erkennbar sein, um was es geht.
• Kurze Nutzungszeiten: Die durchschnittliche Spielezeit beträgt gerade einmal 5 Minuten. Unterschieden wird grundsätzlich zwischen 2D und 3D Spielen. Aus technischer Sicht ist auf dem iPhone prinzipiell beides möglich, es hat sich aber gezeigt, dass obige Bedingungen am Besten auf 2D Spiele zutreffen. Hinzu kommt, dass professionelle 3D Spiele und insbesondere die Erstellung der Assets problemlos fünfstellige Beträge erreichen können. Budgets die zumeist noch nicht zur Verfügung stehen im Bereich der mobilen Spiele. 2D Spiele haben zudem einen ganz speziellen Reiz und gehen auch besser mit den visuellen Einschräkungen und Limitation des Displays um. Hinzu kommt, dass sich viele der Spieler an Spiele aus der eigenen Kinder- und Jugendzeit erinnert fühlen. Wer kennt nicht Pac-Man, Donkey Kong, Super Mario und wie sie alle heissen…

Denken auch Sie daran, ein iPhone Game zu realisieren? Dann lassen Sie uns darüber sprechen!

• Man benutzt den Cover Flow View aus den Private Frameworks von Apple (Keine gute Idee, wenn man die App später auch erfolgreich in den AppStore bringen möchte)
• Man benutzt Core Animation und Layers
• Man verwendet OpenGL

Auf die erste Möglichkeit gehe ich aus verständlichen Gründen nicht weiter ein. Die zweite Variante mit Core Animation kam in einem meiner recht frühen Projekte zum Einsatz (Den Beispielcode erläutere ich nacholgend) und hat sich gut bewährt. Variante 3 setze ich aktuell in den Projekten ein, kann als Library gekauft werden und ist zudem im Video zu sehen.

Da das Core Animation Framework auf dem iPhone nicht ganz so mächtig wie unter MacOSX ist, muss man auf Filter verzichten, trotzdem sind schöne Ergebnisse zu erzielen. Doch nun zum Code.

#import
#import 

@protocol RBCoverFlowDelegate
- (int)numberOfItems;
- (UIImage*)coverImageForIndex:(int)index;
- (UIImage*)placeholderImage;
- (void)coverHasChangedToIndex:(int)index;
- (void)clickOnCoverWithIndex:(int)index;
@end

@interface RBCoverFlowView : UIView {
	CGPoint _startTouchPosition;
	float _centerPosition;
	float _sidePosition;
	CATransform3D _leftTransform;
	CATransform3D _rightTransform;

	CALayer* _contentLayer;

	id _delegate;
	int _itemCount;

	CGImageRef _placeholderImageRef;
	UIImage* _placeholderImage;
	CGImageRef _maskedPlaceholderImageRef;

	CGSize _imageSize;
	CGFloat _imageScaleX;
	CGFloat _imageScaleY;

	float _rowScaleFactor;
}

// Start the cover flow
- (void)start:(id)delegate;

@end

Der Cover Flow besteht zunächst aus einem “Hauptview”, der von UIView abgeleitet ist und in dem die Covers dargestellt werden. Dieser ist zudem für das Verarbeiten der Touches und der gesamten Animation zuständig.

Die Covers selber bestehen aus einzelnen Layern, bzw. genau drei Layern pro Cover. Der Layer mit dem Bild selber, ein Layer, der die Spiegelung (Reflection) darstellt und ein Rahmen-Layer, der das ganze Cover umschliesst.

- (CALayer *)addCoverLayer:(int)index {
	CALayer* containerLayer = [CALayer layer];
	containerLayer.name = [NSString stringWithFormat:@"%d", index];
	containerLayer.frame = CGRectMake(0.0f, 0.0f, [[self maxAvalibleImageWidth] floatValue], 1.5f * [[self maxAvalibleImageHeight] floatValue]);
	containerLayer.contentsGravity = kCAGravityResize;

	CALayer* holderLayer = [CALayer layer];
	holderLayer.name = [NSString stringWithFormat:@"Holder_%d", index];
	holderLayer.frame = CGRectMake(0.0f, 0.0f, [[self maxAvalibleImageWidth] floatValue], 1.5 * [[self maxAvalibleImageHeight] floatValue]);
	holderLayer.contentsGravity = kCAGravityResize;

	CALayer* imageLayer = [CALayer layer];
	imageLayer.name = [NSString stringWithFormat:@"Image_%d", index];
	imageLayer.contents = (id)_placeholderImageRef;
	imageLayer.frame = [self imageRect:(CGImageRef)imageLayer.contents];
	imageLayer.contentsGravity = kCAGravityResizeAspectFill;
	imageLayer.masksToBounds = YES;

	CALayer* reflectionLayer = [CALayer layer];
	reflectionLayer.name = [NSString stringWithFormat:@"Reflection_%d", index];
	reflectionLayer.contents = (id)_maskedPlaceholderImageRef;
	CGRect frame = [self imageRect:(CGImageRef)reflectionLayer.contents];
	frame.origin.y = imageLayer.frame.size.height + 2;
	reflectionLayer.frame = frame;
	reflectionLayer.contentsGravity = kCAGravityResize;
	reflectionLayer.masksToBounds = YES;
	reflectionLayer.transform = CATransform3DMakeScale(1.0f, -1.0f, 1.0f);
	reflectionLayer.opacity = 0.6;

	[containerLayer setValue:imageLayer forKey:kImageLayerKey];
	[containerLayer setValue:reflectionLayer forKey:kImageReflectionKey];
	[containerLayer setValue:holderLayer forKey:kImageHolderKey];

	[holderLayer addSublayer:imageLayer];
	[holderLayer addSublayer:reflectionLayer];
	[containerLayer addSublayer:holderLayer];

	return containerLayer;
}

Sind die Layer erstellt worden, müssen die einzelnen Cover nun entsprechend positioniert werden, damit das Aussehen dem Cover Flow der iPod App entspricht. Dies erreicht man, in dem man jeden einzelnen Layer im Raum positioniert, skaliert und leicht dreht.

- (void)layoutSublayer:(CALayer*)rootLayer number:(int)number {
	int selectedIndex = [[_contentLayer valueForKey:@"selectedIndex"] integerValue];

	rootLayer.frame = CGRectMake(0.0f, 0.0f, [[self maxAvalibleImageWidth] floatValue], 1.5f * [[self maxAvalibleImageHeight] floatValue]);

	CATransform3D layerTransform = CATransform3DIdentity;
	layerTransform.m34 = 1.0f / _sidePosition;

	CALayer* holder = [rootLayer valueForKey:kImageHolderKey];

	CGPoint pos = CGPointMake(CGRectGetMidX(_contentLayer.bounds), CGRectGetMidY(_contentLayer.bounds));

	if (number < selectedIndex) {
		pos.x -= (selectedIndex - number) * _imageSize.width * _rowScaleFactor;
		holder.transform = _leftTransform;
		holder.zPosition = _sidePosition;
		rootLayer.zPosition = _sidePosition - 0.1f * (selectedIndex - number);
		rootLayer.sublayerTransform = layerTransform;
	} else if (number > selectedIndex) {
		pos.x += (number - selectedIndex) * _imageSize.width * _rowScaleFactor;
		holder.transform = _rightTransform;
		holder.zPosition = _sidePosition;
		rootLayer.zPosition = _sidePosition - 0.1f * (number - selectedIndex);
		rootLayer.sublayerTransform = layerTransform;
	} else {
		pos.x = (self.bounds.size.width - _imageSize.width) / 2;
		holder.transform = CATransform3DIdentity;
		holder.zPosition = _centerPosition;
		holder.filters = nil;
		rootLayer.zPosition = _centerPosition;
		rootLayer.sublayerTransform = CATransform3DIdentity;
	}

	rootLayer.position = pos;
}

Die Animation ist in dem Code (Hier sind die kompletten Source Files) bewusst recht einfach gehalten und unterstützt keine sogenannten Heartbeat Animationen, d.h. Animationen die sogleich beginnen, wenn der Finger aufgesetzt wird. Im käuflichen und auf OpenGL basierten Code ist dies selbstverständlich vorhanden und insbesondere das Laden und Aufbauen der Bilder noch stark optimiert. Aber als Einstieg und fürs bessere Verständnis hoffe ich, dass der Beispielcode hier erstmal weiterhilft. Wer mehr darüber erfahren möchte, dem möchte ich nochmals unsere Workshops ans Herz legen, in denen wir wesentlich tiefer in die Materie einsteigen können. Also, viel Spass beim Cover Flow programmieren und nicht vergessen, auf mein Blog zu verlinken wenn Ihr die erste iApp mit Cover Flow in den Appstore bringt

Anfangs basierte dieser Code übrigens auf einem Beispiel Code von Bill Dudney, der damals einen Artikel über die Programmierung eines Cover Flow unter MacOSX veröffenlichte und auch ein sehr gut geschriebenes Buch zum Thema Core Animation geschrieben hat.

Wichtigstes Element: Die Klasse

@interface Person : NSObject {
     // Das sind Instanz Variablen
     int alter;  // ... vom Typ int
     NSString* name;  // ...vom Typ NSString (Klasse)
     NSString* vorname;
}

// Das sind Messages:
// In Objective-C heissen Methoden Messages
- (void)initialisieren;
- (void)setAlter:(int)alter;
- (void)setPerson:(NSString*)name vorname:(NSString*)vorname;
- (int)getJahrgang;

@end

@implementation Person

- (void)setAlter:(int)alter {
    // Mach irgendetwas ...
}

...

@end

Darin unterscheidet sich die Sprache noch nicht wesentlich von vielen Anderen, wie z.B. Java oder C#. Wie in C++ trennt man allerdings Klassen in deren Beschreibung (@interface) und deren Implementierung (@implementation).

Universeller Zugriff auf Klassen: id
Der Datentyp id ist eine einfache, aber wichtige Erweiterung in Objective-C. Um Klassen unabhägig vom Typ (Bsp. Person) ansprechen zu können, genügt es diese mit id zu deklarieren. Dies wird insbesondere bei der Kommunikation zwischen Interface Builder und Code (Messaging) intensiv genutzt.

id person = [Person new];

Der Aufruf von Klassen: Messages
Ein wenig ungewohnt sieht das Ganze aus, wenn man eine Nachricht (Message) einer Klasse aufrufen möchte. Obige Klasse wird beispielsweise wie folgt angesprochen:

Person* person = [Person new];
[person initialisieren];

und mit Parametern:

Person* person = [Person new];
[person setAlter:35];
[person setPerson:@"Muster" vorname:@"Peter"];

Vereinfachung durch Properties (@property)
Properties gibt es seit Version 2.0 von Objective-C und erweitern Klassen um die Möglichkeit, einfacher auf Instanz Variablen zuzugreifen. Eine Fähigkeit, die es eigentlich in allen modernen objektorientieren Sprachen gibt. Damit kann der Codeumfang stark reduziert werden, da der Compiler selber das mühsame Schreiben der Getter und Setter Methoden übernimmt:

@interface Person : NSObject {
     int alter;
     NSString* name;
     NSString* vorname;
}

@property int alter;
@property (nonatomic, retain) NSString* name;
@property (nonatomic, retain) NSString* vorname;

@end

@implementation Person

@synthesize alter;
@synthesize name;
@synthesize vorname;

Wobei die Vereinfachung genaugenommen erst beim Aufruf zum Tragen kommt, da nun folgendermassen auf die Instanz Variablen des Objekts zugegriffen werden kann:

Person* person = [Person new];
person.alter = 35;
person.name = @"Muster";
person.vorname = @"Peter";
int jahrgang = 2009-person.alter;

Die sieht natürlich vorallem für Entwickler, die von Java oder C# her kommen, sehr viel gewohnter aus und bietet zudem einige Vorteile bei der Speicherverwaltung. Wer sich noch näher mit Properties beschäftigen möchte, der findet auf den Apple Seiten alles Wichtige dazu, auch was es mit dem Keyword @synthesize und den Attributen nonatomic und retain auf sich hat.

There’s one more thing: IBOutlet und IBAction
Die beiden Keywords IBOutlet und IBAction gehören genaugenommen nicht zu Objective-C und dienen dazu, den Code für den Interface Builder zu markieren. So kann dieser erkennen, welche Message durch welches UI Element (Bsp. Button) aufgerufen werden soll (Action Target Prinzip) und welche Instanz Variable mit welchem UI Element (Bsp. Label) verknüpft wird. Die Anwendung ist dabei ganz einfach:

@interface Person : NSObject {
     UILabel* text;
}

// Dieses Textfeld kann in Interface Builder verknüpft werden
@property (nonatomic, retain) IBOutlet UILabel* text;

// Diese Message kann von Interface Builder aufgerufen werden
- (IBAction)aendereText:(id)sender;

@end

So, das soll es nun aber für den Moment auch schon sein, obwohl die Sprache natürlich noch viel mehr zu bieten hat. Für den Einstieg und erste einfache Programme genügt dies aber bereits udn wir werden dies in den kommenden Screencasts auch intensiv nutzen.
Also, nur Mut! Der Einstieg ist ein wenig ungewohnt, aber man findet sich schnell zurecht und Spass macht es sowieso.

Und hier wie gewohnt, der Source Code dazu. Viel Spass beim Auspropieren!

-(IBAction)captureScreen:(id)sender {
	UIGraphicsBeginImageContext(self.view.frame.size);
	[self.view.layer renderInContext:UIGraphicsGetCurrentContext()];
	UIImage* viewImage = UIGraphicsGetImageFromCurrentImageContext();
	UIGraphicsEndImageContext();
	UIImageWriteToSavedPhotosAlbum(viewImage, nil, nil, nil);
}