asix 7.7

A collection of utilities for Pygame

ASIX

The Asix Graphics Library

Introduction

Asix is a 2d python library build on top pygame engine its fully support pygame methods in its Core and also some methods of asix work with pygame methods are simple but powerfull

Install

Run pip install asix

Core

Core is the main Object of Screen and contains all methods you can use it like :

var = Core(width, height, flags)

its take width of screen and take height of screen and last flags so flags are like special effects we can put on window and rendering flags are borderless makes screen without any border title buttons resizeable makes screen resizeable and coreinf just shows all info about window and optimize is a perfomance enchancer like :

width : 800
height : 600
flags : coreinf
clock : <Clock(fps=0.00)>
font : <pygame.font.Font object at 0x0000017138B2EFA0>
type : <Asix.Core>
version : 7.1

! important to note optimize or optimized flag may not work on all devices and cause proformance issue and only works on (WINDOWS OS)

Opengl Renderer

change the rendering from pygame 2d render to opengl 3d render Required Knowledge of Opengl and Asix 2d Function Dont Work And core have Methods for 3d opengl but methods core.quit, core.flip, core.exit, core.clear works with opengl

if you want to change the renderer you have to change core 2d window to opengl 3d window use function opengl first create a opengl renderer and window like

glwin = opengl((x, y))

then set up core dont put any flags opengl is very faster then pygame itself and dont put any dimension because we going to glwin instead and put opengl renderer using xscreen of core like

from asix import *

glwin = opengl((800, 600))

core = Core(xscreen=glwin)

thats it now you can use any pyopengl function or core 3d methods you putting 3d window in core because core have 3d methods of opengl

Methods

OPerspective

this function set setting of our rendering like

.1 fov means field of view how much you can see like in video games there FOV

.2 near-clip means how much close can object can render like if we go more than 0.1 or custom value object stop rendering

.3 far-clip means how much far object can render like if it go more far then we setted its stop render good for proformance for big games

we can use it like

core.OPerspective(fov=45, near_clip=0.1, far_clip=50.0)

its also have default settings if you dont want to set up it

OTranslatef

This Function moves away objects a little so we can see them everything before this function is at (0, 0, 0) so we cant see them because camera is also at 0,0,0 so its away objects a little so we can see them from camera its takes (x, y, z) like

core.OTranslatef(0.0, 0.0, -5)

its move objects a little back from z-axis

OClear

its clear screen and all things ready to start window its get placed in loop like

while True:
    _.quit('ESCAPE')
    _.OClear()

OPushMatrix

Stack a Matrix so we can draw and transform our object like

core.OPushMatrix()

ORotatef

this function help transform our object like its angle and its (x, y, z) like

core.OPushMatrix()
core.ORotatef(rotate: var or value, 3, 1, 1)

OBegin

This Function tell renderer we about to draw our object like

core.OPushMatrix()
core.ORotatef(rotate, 3, 1, 1)
core.OBegin()

we first stack a matrix transform our object and then begin then we draw our vertices and surfaces like

core.OPushMatrix()
core.ORotatef(rotate, 3, 1, 1)
core.OBegin()

for surface in surfaces:
        x = 0
        for vertex in surface:
            glColor3fv((x, 0, 0))
            glVertex3fv(vertices[vertex])
            x += 0.1

OEnd

this function tells renderer we finished drawing our object like

core.OEnd()

OPopMatrix

this pop our matrix so there will be no matrix stack overflow or cause other objects issues like

core.OPopMatrix()

thats it you then flip it with core.flip(clock=value) and core.exit() and core.clear()

basic example a cube rotating in asix opengl implement i used _ instead of core for less confusing :

from asix import *

glwin = opengl((800, 600))
_ = Core(xscreen=glwin)

_.OPerspective(fov=45, width=800, height=600, close_clip=0.1, far_clip=50.0)
_.OTranslatef(0.0, 0.0, -5)

vertices = [
    (1, -1, -1),
    (1, 1, -1),
    (-1, 1, -1),
    (-1, -1, -1),
    (1, -1, 1),
    (1, 1, 1),
    (-1, -1, 1),
    (-1, 1, 1)
]

surfaces = [
    (0, 1, 2, 3),  
    (3, 2, 7, 6),  
    (1, 5, 6, 2),  
    (4, 5, 1, 0),  
    (4, 0, 3, 7), 
    (4, 7, 6, 5)
]

rotate = 1

while True:
    _.quit('ESCAPE')
    _.OClear()

    _.OPushMatrix()
    _.ORotatef(rotate, 3, 1, 1)
    _.OBegin()

    for surface in surfaces:
        x = 0
        for vertex in surface:
            glColor3fv((x, 0, 0))
            glVertex3fv(vertices[vertex])
            x += 0.1
    
    _.OEnd()
    _.OPopMatrix()

    rotate += 0.1

    _.flip(clock=60)

_.exit()
_.clear()

---

Core Built-in's

R specifier

this can use to create a rect like

rect = R(100, 100, 100, 100)

draw

this function used to draw rects its takes two args one color and rect like

core.draw((r, g, b), rect, ...)

its can accept multiple rects at once like shown up

polygon

this function draw on points like for traingle we need 3 points this function points not flipped like pygame.draw.polygon have unside down points its auto correct them like

points = [(100, 100), (200, 100), (150, 200)]
core.polygon(color, points)

Draws a Triangle

globe

this function used to create circles its have multiple args

def globe(
    x: Any,
    y: Any,
    radius: Any,
    fill_color: Any,
    border_color: Any | None = None,
    border_width: int = 0
) -> None

its takes x-pos and y-pos and radius means size of circles and fill_color means color of circle and border_color means border color of circle and border_width of circle like

core.globe(100, 100, 70, (255, 255, 255), (r, g ,b), 10)

!Note If you dont want border skip border_color and border_width args

blit :

blit used for drawing images in mainloop like :

core.blit(*args)

works like pygame one like a surface and img or just img with x, y

key / K

the key is a function that we can use with K to written very short input management script like

# init it ! Optional
ky = key()

# Use K for Keys and ky for Detection of that key like
if key[K("W")]
  print('pressed W')
  ...

...

or can use without init like key()[K('W')]: ...

text

text function is a basic text renderer like

core.text(size, color, text, x, y, font_type: optional, rotation: require a angle var)

its just print that text in window

---

Core Methods

quit :

quit is a function that automatically quit the window with x close window button but also support any pygame key like

core.quit('esc', ...)

color :

color is a function that sets color of the window like

core.color(r, g, b)

flip :

flip is a function that flips the screen like

core.flip()

exit :

exit is a function that get set at the outside of the loop at end its terminate all window and resources like

core.exit() 

caption

used to set window title like

core.caption(str)

icon

used to set window icon like

core.icon(loaded_img)

Font

this function used to make simple font like :

newfont = core.Font(fontpath=None, size)

if you want custom font .ttf or .otf do like this

# add your font path and create a font object
newfont = core.Font(fontpath="myfont.ttf", size)

# use that font to render text
text = newfont.render("Hello, Asix!", True, color(r, g, b))

# get its rect and Set up the position for the text
text_rect = text.get_rect(center=(400, 300))

# now draw it with core.blit
core.blit(text, text_rect)

thats it

---

Additional Methods

these methods can get called direct without core.

sic :

sic is a sin cos tan calcultion function its structure

def sic(center:int, radius:int, angle:int, typ:str, startmul:int=0, endmul:int=0):
          if typ == 's':
           return center + radius * sin(angle)
          if typ == 'c':
           return center + radius * cos(angle)
          if typ == 't':
           return center + radius * tan(angle)

its can be used for examples :

a circle moving in a circle

from asix import *

_ = Core(600, 600, 'optimize')

angle = 0

while True:
    _.quit('esc')
    _.color(0, 0, 0)

    _.globe(sic(300, 100, angle, 'c'), sic(300, 100, angle, 's'), 70, (255, 255, 255))

    angle += 0.001

    _.flip()

_.exit()

its just calculate the radius x, y of a circle and have arg selector 's' for sin and 'c' for cos and 't' for tan

pie

in asix pie is math pi/pie function

angle += pie / 60

iload

iload loads an image like

img = iload(path)

isize

isize resize a loaded img like

isize(img, width, height)

or can be used with iload mentioned before

img = isize(iload(path), width, height)

DTYPE Local DataClass

its a local DataClass can use it to store, fetch, delete can store any datatype and its key, value nature like

dt = DTYPE()

dt.store(key, value)

dt.fetch(key)

dt.delete(key)

! you can make as many as wanted like

doreamon = DTYPE()

this one is not linked to dt

! Its Optional

---

basic structure

from asix import *

_ = Core(800, 600, 'optimized')

while True:
    _.quit('esc')
    _.color(250, 250, 250)
 

    _.flip()

_.exit()

---

Details

Core Object

self.GLSO = {
                     'width':self.width,
                     'height':self.height,
                     'flags':self.flag,
                     'clock':self.clock, 
                     'font':self.font,
                     'type':"<Asix.Core>", 
                     'version': "7.1"
                     }

GLSO (Global Library System Object) Core have these and you can access them by core.screen and use that to use pygame function directly on the surface on asix

Easter Eggs 🎊

Screenshot

used to get a pic of window

def screenshot(surface: pygame.Surface, filename: str = 'screenshot.png') -> None:

no core. required

---

Asix Release Notes

[v7.6] -2025

Added

• Error Handling Added (CORE)

• Added Support for Math functions [sin, cos, tan] => (sic)

• Added Build-in Circle Drawer (Globe)

• Added Caption and Icon Changer functions (caption / icon)

• Added function to improve Image Handling (iload, isize) {iload loads image, isize resize image}

Changed

• Removed unused Lib Modules (Imports)

• Improved CORE Structure

• Cache JIT Compiler Removed

• Removed Multi-Set ColorList (draw) improved speed, logic

• Removed unused EarlyTesting methods (fscript / mouse_button / mouse_pos / trn {used for Triangle Draw})

Fixed

• Fixed Logic Error Not specified self on (Core.[width, height]) inside error handle