Package for writing and formatting texts and images in Pygame
Project description
Glorious Markup Language
The Glorious Markup Language is a programming language designed for Pygame Surfaces, originally written for a personal project called 'Glorious City'. Its syntax is similar to html and xml. For that reason, it is simple to write and read. The file extension is *.gml for standard. It was designed to implement surfaces that consist of images and text together (also in one line) what is not possible in pure pygame.
Installation
You can install GML from PyPI:
pip install glorious-markup-language
GML is supported on Python 3.5 or higher and Pygame 2.0 or higher. Additionally, you need four font files named "normal.ttf", "italic.ttf", "bold.ttf" and "bold-italic.ttf" in a subfolder of your project to display texts.
Implementation
from GML.gml import PARSER
parser = PARSER(max_width=500, font_path="fonts")
code_lines, width, height = parser.init(data, images)
surface = parser.parse(code_lines, images, background, width, height)
The GML-Parser is implemented in a module called TEXT.
The 'txt'-Parameter is the GML-Code as string. 'images' is a dictionary with all image names given in 'src' attributes of img-tags as keys and their corresponding 'pygame.Surface' object. 'background' is a surface that is used to render the code. 'font_path' is the path to the required fonts, named 'italic.ttf', 'bold.ttf', 'bold-italic.ttf' and 'normal.ttf'.
The init-method returns a list of code-lines that can be parsed. That list can be split (like in the example below) and modified.
NOTE: Parsing bigger files can last more than 50 Milliseconds. To avoid lower framerate, it is recommended to use threads.
Features
Example with multiple code elements
Code:
<h3><style color="blue"/>Welcome to GML!</h3>
<p><style color="black" size="20"/>
This is a small example to show the most important features of GML:
</p>
<li><style color="black" size="20"/>
- Images <img src="power"/>
between text
</li>
<li><style color="black" size="20"/>
- Text with automatic line-breaks if it gets to long for a surface
</li>
<li>
<style color="green" size="20"/>- Colored text
</li>
<li><style marked="orange" size="20"/>
- Marked text
</li>
<p><style color="black" size="20" display="underline" type="italic"/>
Text in different styles
</p>
<p><style color="black" size="20" align="center"/>Text-align</p>
<p><style color="black" size="15"/></p>
<p><style color="black" size="40" display="underline" align="center" type="bold-italic"/>
...and more!
</p>
<p><style color="black" size="15"/></p>
Programming GML
GML can parse seven different tag names. Five of them are line-tags, which mean tags that display a line, and two style-tags that can change the style of a given line. The five line-tags are:
-
h3
: Tag for headlines, with the biggest size (usually 30 pixels) -
h2
: Tag for headlines with the second biggest size (usually 25 pixels) -
h1
: Tag for the smallest headline, usually 20 pixels. -
p
: Tag for a simple line -
li
: Tag for an enumeration
The advantage of headlines is that they are automatically underlined. Of course, all tags can be modified with style-tags, which are:
-
<img>
: Tag representing an image -
<style>
: Tag containing explicit style attributes for the given line
NOTE: Style-tags are written inside of line-tags.
The Style-Tag can have several attributes:
-
color : Sets the color of a line. This can either be a name (e.g. “whiteâ€) or an RGB-Value (e.g. (0,1,2)).
NOTE: The RGB-Values have to be written without any spaces; else a Syntax Error is raised.
Example: <style color="white"/>
-
type : Sets the displayed text to italic, normal, bold or bold-italic.
Example: <style type="bold"/>
-
align : Sets align of the displayed text to left, right or center.
Example: <style align="center"/>
-
size : Sets the size of the displayed text in pixels.
Example: <style size="50"/>
-
antialias : Sets the antialiasing property of the text (Rarely used).
Example: <style antialias="True"/>
-
display : Displays the text either 'underline' or 'standard'.
Example: <style display="underline"/>
-
marked : Marks the text with the specified color.
Example: <style marked="(0,0,0)"/>
Example:
Example with multiple code elements
Code:
<p><style size="40" color="black" align="center"/>City Center</p>
<p><style size="30" color="black" align="center"/>Description</p>
<p><style size="20" color="black"/>
This is the center of the city.
</p>
<p><style size="20" color="black"/>
+1 <img src="science"/> Science and
<img src="culture"/> Culture. Condition for all other
buildings in the city. Can only be build by a
<img src="settler"/>Settler. Increases population
limit by 20 <img src="people"/> Inhabitants.
+1 <img src="faith"/> Faith for each adjacent
mountain. +1 <img src="science"/> Science and
<img src="culture"/> Culture for every age since
antiquity. +10 <img src="economy"/> Coins
with Goetz the Niggard as leader. Can produce simple
units. +1 <img src="power"/> power per turn.
</p>
<p><style size="10" color="black"/></p>
<p><style size="30" color="black" align="center"/>Traits</p>
<p><style size="5" color="black"/></p>
<p><style size="20" color="black"/>+1 <img src="culture"/> Culture</p>
<p><style size="5" color="black"/></p>
<p><style size="20" color="black"/>+1 <img src="science"/> Science</p>
<p><style size="5" color="black"/></p>
<p><style size="20" color="black"/>+1 <img src="power"/> Power</p>
<p><style size="5" color="black"/></p>
<p><style size="20" color="black"/>+20 <img src="people"/> limit for Inhabitants</p>
<p><style size="5" color="black"/></p>
<p><style size="25" color="black"/>Adjacency Bonus</p>
<p><style size="5" color="black"/></p>
<p><style size="20" color="black"/>+1 <img src="faith"/> Faith for each adjacent mountain</p>
<p><style size="5" color="black"/></p>
<p><style size="25" color="black"/>Time Bonus</p>
<p><style size="5" color="black"/></p>
<p><style size="20" color="black"/>+1 <img src="science"/>
Science for every age since antiquity
</p>
<p><style size="5" color="black"/></p>
<p><style size="20" color="black"/>+1 <img src="culture"/>
Culture for every age since antiquity
</p>
<p><style size="5" color="black"/></p>`
Requirements
- Python 3.5 or higher
- Pygame 2.0.0 or higher
Release Notes
1.0.6
Initial release of GML
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
Built Distribution
Hashes for glorious-markup-language-1.0.6.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | eb6292e53e1cc3b93ef8e6ebe2f51001d99b8356c58ee848b5a39ceefa50bc9b |
|
MD5 | 826d12aa99c5b2fc1a20402baf6ce68a |
|
BLAKE2b-256 | fec327a817ee85ee348af8b893652fc0c7598266a1040ed5df9a442e910487e3 |
Hashes for glorious_markup_language-1.0.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3d78fea81a6a4b77a613951e1dda09359cb4c04512df1139de3614321abc62c4 |
|
MD5 | d6079a9273d787677c8f5d33ae3a8e09 |
|
BLAKE2b-256 | 55af5ffd342fb643318acc64fde2905df57018878135922a1172f52d2dec688e |