rotem 0.1.0

a simple python library used to draw text-based 2d grid game map and informations

About Rotom

rotom is a simple tui library used to draw tilemap and some informations on terminal.

Fast Usage

import rotom
tilemap = rotom.Tilemap(5, 5)
tilemap.set_char(0, 0, '@')
print(tilemap)

and you will get something like below:

@ · · · · 
· · · · · 
· · · · · 
· · · · · 
· · · · · 

you can set color, background color, bold and underline to style the char like this:

tilemap = Tilemap(10, 10)
tilemap.set_char(0, 0, '@', color="#942c4b", bold=True, underline=True)
print(tilemap)

you will get something like this (the result in markdown file should be the same because this only work in terminal):

@ · · · ·
· · · · ·
· · · · ·
· · · · ·
· · · · ·

and you can add a border for it

tilemap = Tilemap(5, 5)
print(add_border(tilemap()))

you will get something like this:

+-----------+
| · · · · · |
| · · · · · |
| · · · · · |
| · · · · · |
| · · · · · |
+-----------+

except the game map, rotom provide tool to render informations.

tilemap = Tilemap(8, 8)
tilemap.set_char(5, 5, '@')

infos = InfoBoard()
infos.set_info("title", "content")

result = horizontal_combine(tilemap(), infos(), sep='   ')
print(result)

this would output:

· · · · · · · ·   +--------------------------------+
· · · · · · · ·   | title: content                 |
· · · · · · · ·   +--------------------------------+
· · · · · · · ·   
· · · · · · · ·   
· · · · · @ · ·   
· · · · · · · ·   
· · · · · · · ·   

I use horizontal_combine to combine two string, but also can be combined as vertical.

result = vertical_combine(tilemap(), infos(), sep='/')
print(result)

· · · · · · · ·
· · · · · · · ·
· · · · · · · ·
· · · · · · · ·
· · · · · · · ·
· · · · · @ · ·
· · · · · · · ·
· · · · · · · ·
//////////////////////////////////
+--------------------------------+
| title: content                 |
+--------------------------------+