A wrapper for the Discord Python Pixels API.
Project description
DPYPX
A simple wrapper around Python Discord Pixels.
Requires Python 3.9+ (3.x where x >= 9).
Requires pillow
and aiohttp
from pip.
Example
import dpypx
# Create a client with your token.
client = dpypx.Client('my-auth-token')
# You can also set a save file to store ratelimit data between reboots.
client = dpypx.Client('my-auth-token', ratelimit_save_file='ratelimits.json')
# Download and save the canvas.
canvas = await client.get_canvas()
canvas.save('canvas.png')
# And access pixels from it.
print(canvas[4, 10])
# Or just fetch specific pixels.
print(await client.get_pixel(4, 10))
# Draw a pixel.
await client.put_pixel(50, 10, 'cyan')
await client.put_pixel(1, 5, dpypx.Colour.BLURPLE)
await client.put_pixel(100, 4, '93FF00')
await client.put_pixel(44, 0, 0xFF0000)
# Close the connection.
await client.close()
Auto-draw
Load an image:
from PIL import Image
im = Image.open('pretty.png')
ad = dpypx.AutoDraw.load_image(client, (5, 40), im, scale=0.1)
await ad.draw()
Or specify each pixel:
ad = dpypx.AutoDraw.load(client, '''0
0
3
2
ff0000
00ff00
0000ff
ff0000
00ff00
0000ff''')
await ad.draw()
Format of the drawing plan:
- Leftmost X coordinate
- Topmost Y coordinate
- Width
- Height
- Each pixel, left-to-right, top-to-bottom.
Auto-draw will avoid colouring already correct pixels, for efficiency.
Logging
To see logs:
import logging
logging.basicConfig(level=logging.INFO)
Too see more logs:
logging.basicConfig(level=logging.DEBUG)
To see fewer logs:
logging.basicConfig(level=logging.WARNING)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
dpypx-0.4.1.tar.gz
(7.3 kB
view hashes)
Built Distribution
dpypx-0.4.1-py3-none-any.whl
(8.5 kB
view hashes)