New: TextureSourceDecorator

[Nicolas Gramlich]

Hello Community,

today I added the so called TextureSourceDecorators.

In the example below actually a implementation of the a abstract class TextureSourceDecorators called OutlineTextureSourceDecorator i used. What this class does it to draw a 1px colored line to the edge of the Texture right before it is sent to the GPU.
Without OutlineTextureSourceDecorator:

No OutlineTextureSourceDecorator.

no_outlinetexturesourcedecorator.png (114.65 KiB) Viewed 1150 times

With OutlineTextureSourceDecorator

With OutlineTextureSourceDecorator.

with_outlinetexturesourcedecorator.png (134.25 KiB) Viewed 1150 times

While I think this is primarily useful for debugging purposes as you can influence the appearance of Textures through code.

I can also think of some useful things to do with it, like add some color-highlight to a sprite. For example think of a RTS (Real-Time-Strategdy) game where the tanks have a little team-color-indicator or so. So you wouldn't have to put tank-sprites in all possible team-colors into your project.


Code-wise this is very simple. Where you had sth like this before:

Syntax: [ Download ] [ Hide ]

Syntax: [ Download ] [ Show ]

Using java Syntax Highlighting

1. this.mBoxFaceTextureRegion = TextureRegionFactory.createFromAsset(this.mTexture, this, "gfx/face_box.png", 0, 0);

Parsed in 0.030 seconds, using GeSHi 1.0.8.4

You'd now do this:

Syntax: [ Download ] [ Hide ]

Syntax: [ Download ] [ Show ]

Using java Syntax Highlighting

1. this.mBoxFaceTextureRegion = TextureRegionFactory.createFromSource(this.mTexture, new OutlineTextureSourceDecorator(new AssetTextureSource(this, "gfx/face_box.png"), Color.RED), 0, 0);

Parsed in 0.030 seconds, using GeSHi 1.0.8.4

Changeset: http://code.google.com/p/andengine/sour ... 78bf768aee

Best Regards,
Nicolas

[manoelramon]

Hi Nicolas,

Just a dumb question...If I create a Shape based on an Rectangle, when I insert on scene the rectangle is filled. Is possible to create a shape rectangle but painting only the boarders (no fill) ?

I know we can draw borders using Canvas, but I am not sure regarding rectangles shapes.

Regards,
Ramon

[Nicolas Gramlich]

Hi Ramon,

yes, the easiest way to do this is to wrap an OutlineTextureSourceDecorator around an EmptyTextureSourceDecorator.

Best Regards,
Nicolas