Sparrow Wiki - extensions

Alignable-objects

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:15:37+00:00

Alignable-objects Usage To get the same result as seen in the screenshot, just replace the code in the “initWithWidth...” section of the AppScaffold project with the following: // Make a light gray background self.color = SP_COLOR(130, 130, 130); // Create a red large box ... SPSprite *parentBox = [SPSprite sprite]; [self addChild:parentBox]; SPImage *image = [SPImage imageWithContentsOfFile:@"parent-box.png"]; [parentBox addChild:image]; // ... and add it to the background [se…

BEParallaxSprite

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:15:34+00:00

BEParallaxSprite My Wiki Page Usage sky = [BEParallaxSprite parallexSpriteWithTexture:[SPTexture textureWithContentsOfFile:@"sky.png"] speed:0.5 direction:BE_PARALLAX_DIRECTION_LEFT]; [self addChild:sky]; Changelog * 2011/01/23: First public version

BEScreen

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:15:33+00:00

BEScreen Usage BEScreen makes it easy to set and rotate between orientations automatically. It supports all iOS devices and also sends events upon rotation. Adding to your stage: mScreen = [BEScreen screenWithOrientation:BEScreenOrientationPortrait rotates:YES allowAllOrientations:YES]; [self addChild:mScreen]; [mScreen addEventListener:@selector(orientationChanged:) atObject:self forType:BE_SCREEN_EVENT_ORIENTATIONCHANGED];

BEDisplayDebugger

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:15:31+00:00

BEDisplayDebugger My Wiki Page Usage BEDisplayDebugger places bounds boxes around visible objects to assist in finding placement issues. For example, this would show you if a sprite was preventing your button from getting triggered. To use, just add this code to your stage. The levels value lets you decide how deep the class iterates into the display tree. Level 1 is a direct descendant of the stage.

BELinkHelper

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:15:29+00:00

BELinkHelper My Wiki Page Usage 1. Add the files to your project. 2. In BELinkHelper.h, change APP_ID and DEVELOPER_NAME. 3. Where you need to use, #import “BELinkHelper.h” // Show a list of all your apps [BELinkHelper showAllApps]; // Show the reviews page for your app [BELinkHelper showAppReviews]; // Show a specific app's listing, replace the ID [BELinkHelper showAppWithID:@"349733798"];

Creating an Extension for Sparrow

Anonymous (anonymous@undisclosed.example.com) — 2013-06-02T11:24:45+00:00

Creating an Extension for Sparrow First of all: Thanks for creating an extension for Sparrow! As you might know, one of Sparrow's top priorities is to stay as lightweight and minimal as possible. At the same time, we don't want users to reinvent the wheel all the time

ESprite

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:15:23+00:00

ESprite Usage The Sparrow Enhanced Sprite aims at making and managing sprites easier. Quick and dirty to make a sprite you can just do: ESprite* sprite = [[ESprite alloc]initWithESpriteFile:@"sprite.xml" AndInitialAnimation:@"startingAnimation"]; [self addChild:sprite];

GamePlayViewController

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:15:21+00:00

GamePlayViewController Usage The GamePlayViewConroller is a view controller for SPView. It is a subclass of UIViewController so it can be used on a navigation stack or as a model view controller. GamePlayViewController responds to the application moving to/from the background, and listens for a

SXGauge

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:13:23+00:00

SXGauge Usage [A sample gauge in its various stages.] This Sparrow extension class displays a texture, trimmed to its left side, depending on a ratio. This can be used to create a progress bar or a rest-time display. You control the gauge by changing its ratio property to a value between 0 and 1.

JTLine

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:15:14+00:00

JTLine Description JTLine is a Sparrow 2.x compatible, SHLine-isomorphic implementation of a simple line. Example Taken from SHLine. //initialize a line with a length of 100 pixels and thickness of 5 pixels JTLine *line = [SHLine lineWithLength:100 andThickness:5]; //set the start color to red line.startColor = 0xff0000; //set the end color to blue line.endColor = 0x0000ff; //set the start opacity to 75% line.startAlpha = 0.75f; //set the end opacity to 25% line.endAlpha = 0.25f; //se…

SXMaskedSprite

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:15:12+00:00

SXMaskedSprite Overview The Sparrow Extension class “SXMaskedSprite” provides pixel level masking for any Sparrow display object. Use the class as a replacement for a normal Sprite. It contains a public property called “mask” that can be set to any display object. As each frame progresses, custom blend modes will apply the mask's alpha channel to the contents of the sprite. Both animated and static display objects are supported.

SHAlphaTexture

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:15:10+00:00

SHAlphaTexture Description This extension enables the use of these 5 classes: * SHAlphaButton * SHAlphaImage * SHAlphaTexture * SHAlphaSubTexture (abstract) * SHGLAlphaTexture (abstract) The purpose of this extension is to allow Sparrow to be aware of when a touch inside a button or image contains a valid alpha value.

SPTextField with Input

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:15:08+00:00

SPTextField with Input My Wiki Page Usage You will need to add the files to your Sparrow source. SPTextField *inputField = [[SPTextField alloc] initWithWidth:300 height:220 text:@"This text is editable.\ninputField.inputEnabled = YES;\ninputField.returnKeyType = UIReturnKeyDone;" fontName:@"Helvetica" fontSize:12 color:0x000000]; inputField.inputEnabled = YES; inputField.returnKeyType = UIReturnKeyDone; [self addChild:inputField]; [inputField release]; [inputField addEventListener:@sel…

Extensions

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:15:06+00:00

Extensions Sparrow is lucky to be supported by many great people and talented programmers. Many of those have already created numerous add-on classes you can use in your game. This page lists all extensions that are available, giving you a simple means to browse through them and cherry-pick those you can use in your game. If you want to create and share your own extension, visit this page to find out how to do it:

SXCompiledTileMap

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:15:04+00:00

SXCompiledTileMap Usage You create a tilemap with CSV data and an image strip, then use the camera to scroll. NSString *mapPath = [[NSBundle mainBundle] pathForResource:@"small_map" ofType:@"csv"]; NSString *csvData = [[NSString alloc] initWithContentsOfFile:mapPath encoding:NSUTF8StringEncoding error:nil]; SXCompiledTileMap *tm = [[SXCompiledTileMap alloc] initWithViewportSize:CGSizeMake(320, 480) C…

SXFPSMeter

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:15:02+00:00

SXFPSMeter Usage A quick and dirty FPS meter for sparrow so you don't have to rely on NSLog. SXFPSMeter *meter = [[SXFPSMeter alloc] initWithText:@""]; [self addChild:meter]; “” Changelog * 2011/04/11 22:20: First public version Source Code

SXJoypad

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:15:00+00:00

SXJoypad Usage This is a simple joypad implementation for sparrow to be able to just pop on the stage and move things around. You can use directional input, the angle from the center, or a projection that is based on the width of the image. If your image is not centered, you can offset centerPoint to make input closer to what you want.

SXPointSpriteGroup

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:14:58+00:00

SXPointSpriteGroup Usage Subclass the class and override the update method to mess with particles: - (void)update:(SPEnterFrameEvent*)event{ for(int i=0; ix += i * .1; ps->y += i * .1; } [super update:event]; }

SXSlider

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:14:56+00:00

SXSlider Usage - (id)initWithWidth:(float)width height:(float)height { self = [super initWithWidth:width height:height]; slider = [[SXSlider alloc] init]; slider.min = -20; slider.max = 100; [self addChild:slider]; [slider addEventListener:@selector(onValueChange:) atObject:self forType:SX_SLIDER_EVENT_UPDATED]; return self; } - (void)onValueChange:(SPEvent*)event{ NSLog(@"slider val: %f", slider.value); }

SXSwitch

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:14:54+00:00

SXSwitch Usage - (id)initWithWidth:(float)width height:(float)height { self = [super initWithWidth:width height:height]; sxSwitch = [[SXSwitch alloc] init]; [sxSwitch addEventListener:@selector(onValueChange:) atObject:self forType:SX_SWITCH_EVENT_CHANGED]; [self addChild:sxSwitch]; return self; } - (void)onValueChange:(SPEvent*)event{ NSLog(@"slider val: %@", (sxSwitch.on)?@"true":@"false"); }

SXBezierCurve

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:14:52+00:00

SXBezierCurve Usage This is a simple, dynamic and customisable curved line based on Bezier curves. For informations about the meaning and the usage of the control points check Sample: self.curve = [[SXBezierCurve alloc]initWithStartPoint:[SPPoint pointWithX:0 y:0] endPoint:[SPPoint pointWithX:0 y:100] controlPoint1:[SPPoint pointWithX:100 y:…

SXCroppedImage

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:14:50+00:00

SXCroppedImage Usage Use it like you would an SPImage, except you may specify a cropRect, which will allow you to crop/show a certain area of the image: SPTexture *texture = [SPTexture textureWithContentsOfFile:@"Image.png"]; SXCroppedImage *img = [[[SXCroppedImage alloc] initWithTexture:texture] autorelease]; img.cropRect = CGRectMake(230, 240, 90, 48); [self addChild:img];

SXFlump

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:14:48+00:00

SXFlump Usage //grab stage and juggler SPStage *stage = Sparrow.stage; SPJuggler *juggler = Sparrow.juggler; //grab SXFlumpLibrary Singleton SXFlumpLibrary *library = [SXFlumpLibrary instance]; //load export or exports [library loadFlumpExports:[NSArray arrayWithObjects:@"test3.xml", nil]]; //grab movie from export SXFlumpMovie *movie = [library getFlumpMovie:@"test3.xml" :@"myMovie"]; //Then just like a SPMovieClip add to juggler [juggler addObject:movie]; [stage addChild:movie]; [movie …

SXMotionTween

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:14:46+00:00

SXMotionTween Usage This class is similar to SPTween, making it easy to move any object around a Bezier path. The adjustAngle property makes SXMotionTween to change object's rotation to the path's tangent automatically. Public Classes * SXMotionTween

SXParticleSystem

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:14:43+00:00

SXParticleSystem Overview This class provides an easy way to display particle systems. Particle Systems can be used to create special effects like explosions, smoke, snow, fire, etc. The system is controlled by a configuration file in the format that is created by

SXPhysics

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:14:40+00:00

SXPhysics Usage The project on bitbucket contains the extension files in “Classes” folder. You can import those files in your project and use them as long as you have sparrow 2.x and box2d 2.0.x libraries in your project. In the example project I used

SXRadialBlurFilter

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:14:38+00:00

SXRadialBlurFilter Usage Altering the parameters will dinamically affect the result. Usage example: SXRadialBlurFilter *filter = [SXRadialBlurFilter blurFilter]; filter.blurCenterPosition = [SPPoint pointWithX:center.x y:center.y]; filter.distance = 1; filter.strength = 2; displayObject.filter = filter;

SXSimpleClippedImage

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:14:36+00:00

SXSimpleClippedImage Usage To use, just create it instead of an SPImage and then set the area of the image you want to clip: waterfall = [SXSimpleClippedImage imageWithTexture:waterfallTexture]; // Or you can use imageWithContentsOfFile:(NSString *) [waterfall setClipX:0 Y:0 Width:16 Height:16]; [container addChild:waterfall];

Tiledbox

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:14:34+00:00

Tiledbox Usage TiledBox is an interface between Tiled, Box2D, and Sparrow. It is capable of rendering graphics and Box2D world based on a TMX file. TiledBox is pretty young right now. A lot of box2d functions are not yet support. The design of it is being based around a platform game.

TMX Tile Maps

Anonymous (anonymous@undisclosed.example.com) — 2015-09-14T09:14:31+00:00

TMX Tile Maps Disclaimer Hi everyone, First and foremost thank you for checking out my first sparrow extension! I wanted to inform you all that this project has been a learning experience. This is my first time working in objective-c, Sparrow, and Tiled. My code may not be the best implementation at points and there are some known issues that I am working on getting through. Please help me make this a great extension and help make me a better engineer by providing feedback and constructive…