com.ellyality.utility.bitmap_drawing
v1.0.0
Published
UnityBitmapDrawing ==================
Downloads
1
Maintainers
Readme
UnityBitmapDrawing
http://prototurtle.com
Bitmap Drawing API extension methods for Unity 3D's Texture2D class.
What is it?
By default, Texture2D only provides the methods SetPixel and GetPixel (and SetPixels and GetPixels). This library extends that functionality with useful basic drawing operations. It outputs pixel perfect and not anti-aliased bitmaps.
texture.DrawLine(new Vector2(0,0), new Vector2(100,200), Color.red);
x = 0, y = 0 is the top left corner
This library uses the convention of having the left top corner of the bitmap be the 0, 0 position. By default, Texture2D uses the bottom left corner convention which can be confusing for bitmap operations.
Extension Methods
C# Extension Methods work in a way that adds methods to a existing class. To start using this, you only need to include the namespace:
using ProtoTurtle.BitmapDrawing;
Your Texture2D instances will then have all the new methods available.
Features
- DrawPixel(position, color) - Draws a pixel but with the top left corner being position (x = 0, y = 0)
- DrawLine(start, end, color) - Draws a line between two points
- DrawCircle(position, radius, color) - Draws a circle
- DrawFilledCircle(position, radius, color) - Draws a circle filled with a color
- DrawRectangle(rectangle, color) - Draws a rectangle or a square
- DrawFilledRectangle(rectangle, color) - Draws a rectangle or a square filled with a color
- FloodFill(position, color) - Starts a flood fill of a certaing at the point
Example
using ProtoTurtle.BitmapDrawing;
// ...
Texture2D texture = new Texture2D(1024, 1024, TextureFormat.RGB24, false, true);
texture.filterMode = FilterMode.Point;
texture.wrapMode = TextureWrapMode.Clamp;
texture.DrawFilledRectangle(new Rect(0, 0, TEXTURE_SIZE, TEXTURE_SIZE), Color.grey);
texture.DrawCircle(100, 100, 20, Color.green);
texture.DrawCircle(80, 150, 5, Color.blue);
texture.DrawCircle(300, 300, 200, Color.black);
texture.FloodFill(100, 100, Color.green);
texture.FloodFill(300, 300, Color.white);
texture.DrawLine(new Vector2(10, 10), new Vector2(400, 200), Color.magenta);
texture.DrawLine(new Vector2(400, 200), new Vector2(100, 200), Color.magenta);
texture.Apply();
Output from this example (cropped the image to fit):
Example project
Here is a ready-to-go Unity project for easy testing.
https://github.com/ProtoTurtle/BitmapDrawingExampleProject