27.06.2018, 12:07
samp-bitmapper
For generating in-game coordinates from a bitmap.
See this thread for the primary reason that this plugin exists. It’s best used with MapAndreas or ColAndreas and a texture map so you can automatically place items in the game world in areas.
Create a bitmap image of the map then paint specific colours over it. Then, load the bitmap and specify which colours you want to cache with OpenBitmapCache. You can then get random points in the image of specific cached colours with GetRandomCachedRGB.
If you want to map larger or smaller bitmaps to areas of the map, use this library to create a virtual canvas to perform the scaling.
For example, this:
Generates this:
See the thread linked above for more examples.
Installation
Simply install to your project:
Or, if you prefer GitHub:
Include in your code and begin using the library:
Usage
Functions
OpenBitmap(const filename[], &Bitmap:handle);
Opens the given file as a bitmap image and stores thefile handle in handle. Returns 0 on success or an error code.
OpenBitmapCache(const filename[], &Bitmap:handle, const colours[], len = sizeof colours);
Opens the given file and caches all pixels that match the colours listed in colours. Returns 0 on success or an error code.
CloseBitmap(Bitmap:handle);
Closes the specified file handle. Returns 0 on success, 1 if the handle is invalid.
GetRGB(Bitmap:handle, x, y, &r, &g, &b);
Looks up the red, green and blue values stored in the specified X and Y coordinates and stores them in the result parameters r, b and g.
GetRandomCachedRGB(Bitmap:handle, colour, &x, &y);
Provides coordinates and RGB information from a random pixel in the bitmap that contains the specified colour.
Testing
You can compile the plugin and test it in a Docker container all with one command:
This will:
(thanks to maddinat0r for the Docker images!)
For generating in-game coordinates from a bitmap.
See this thread for the primary reason that this plugin exists. It’s best used with MapAndreas or ColAndreas and a texture map so you can automatically place items in the game world in areas.
Create a bitmap image of the map then paint specific colours over it. Then, load the bitmap and specify which colours you want to cache with OpenBitmapCache. You can then get random points in the image of specific cached colours with GetRandomCachedRGB.
If you want to map larger or smaller bitmaps to areas of the map, use this library to create a virtual canvas to perform the scaling.
For example, this:
Generates this:
See the thread linked above for more examples.
Installation
Simply install to your project:
Код:
sampctl package install Southclaws/samp-bitmapper
Include in your code and begin using the library:
Код:
#include <bitmapper>
Functions
OpenBitmap(const filename[], &Bitmap:handle);
Opens the given file as a bitmap image and stores thefile handle in handle. Returns 0 on success or an error code.
OpenBitmapCache(const filename[], &Bitmap:handle, const colours[], len = sizeof colours);
Opens the given file and caches all pixels that match the colours listed in colours. Returns 0 on success or an error code.
CloseBitmap(Bitmap:handle);
Closes the specified file handle. Returns 0 on success, 1 if the handle is invalid.
GetRGB(Bitmap:handle, x, y, &r, &g, &b);
Looks up the red, green and blue values stored in the specified X and Y coordinates and stores them in the result parameters r, b and g.
GetRandomCachedRGB(Bitmap:handle, colour, &x, &y);
Provides coordinates and RGB information from a random pixel in the bitmap that contains the specified colour.
Testing
You can compile the plugin and test it in a Docker container all with one command:
Код:
make build-e2e
- build the plugin inside a Debian docker image
- build the Pawn package in test/ with sampctl
- run the server in test/ as a container, also with sampctl
Код:
make build-debian
