+ hello new world +
+another blog post! finally.
+ +diff --git a/404.html b/404.html new file mode 100644 index 0000000..f8414f0 --- /dev/null +++ b/404.html @@ -0,0 +1,3 @@ + +
+
hey! i'm sam, i go by "soulware" in most corners of the web (that i can get the username), and "qsa" in still other parts. here are some things about me
+i love computer science. it's really fun to solve problems and understand the tech we use daily inside and out. i've been especially interested in compilers and type theory lately. i'm also a big fan of reverse engineering and decompilation projects
+i really like playing, analyzing, and making games. some of them are on itch.io and github. i also love speedrunning but so far i've been more of a spectator. i have one submitted run on speedrun.com and have completed the game DUET as fast as possible on iOS. i've also dabbled in speedrunning both "Seedling" and "The End is Nigh".
+i also like listening to music a lot. my last.fm is here. at the moment i'm enjoying digital hardcore, breakcore, general dnb stuff, "ethereal" music, and various rap genres. some of my favorite artists right now are Machine Girl, miya lowe/evaboy, Sudan Archives, pink siifu, Grouper, Death Grips, Bladee (generally drain gang), Lauren Bousfield, and The Garden.
+wow! here's an image of albums made in the 2020s that i really like:
+ +here's some websites where i consume media! i use backloggd to journal games i play. that site is mainly ripped from letterboxd which is what i use to track movies and (some) tv shows.
+last updated 9 Dec 2022
+ +2021-04-01
+first blog post to get this site started.
+ +I set this site up with zola, which is a pretty nice static site generator.
+ +2022-12-09
+another blog post! finally.
+ +along with this post comes a general overhaul of the site's content as i move it towards something i appreciate on a personal level. after looking at a lot of really cool personal sites i decided it would be no fun if my own website was just a bland reflection of who i am.
+i'm still trying to figure out how to fracture myself across this wonderful internet. at the moment i'm planning to use this as a kind of "devlog", both as motivation for myself to complete things (by documenting what i do) and to share information with the rest of the world. i might at some point soon add a tagging system. my plan is to post media analysis stuff to a tumblr which i am also setting up but i might as well just post it here too, if i can...
+will also be documenting my projects here soon, in their very own little tab on the side. need to get a handle on which ones are good enough, as well as start and finish a few, since they are quite scattered at the moment.
+i also have some WIP blogposts. i'll probably be putting up my minecraft server setup guide. there's plenty of information on this i'm sure, but it really should be easy to get something up running and sustainable, and you can do it all from the CLI! this guide is as much for myself as for anyone else, but after trying to follow it i've noticed it's a bit lacking..
+planning to have some other cool stuff to show off or talk about by the end of this year so stay tuned. :-)
+ ++ studying computer science and mathematics at Northeastern University +
+ + + +another blog post! finally.
+ +first blog post to get this site started.
+ ++ Put in a value for D to compute its Super Magic Box: + +
++ + | +
+ + | +
+ + | +
+ + | +
+ + | +
+ + | +
+ + | +
+ The fundamental unit in + + is + , with norm +
++ A factorization of is given + by + +
+ + diff --git a/processed_images/ss1.6293e3bf5ed1ed6b.png b/processed_images/ss1.6293e3bf5ed1ed6b.png new file mode 100644 index 0000000..4d1b707 Binary files /dev/null and b/processed_images/ss1.6293e3bf5ed1ed6b.png differ diff --git a/processed_images/ss2.e15c7e64d75dfe0f.png b/processed_images/ss2.e15c7e64d75dfe0f.png new file mode 100644 index 0000000..cecf36a Binary files /dev/null and b/processed_images/ss2.e15c7e64d75dfe0f.png differ diff --git a/processed_images/ss3.363f9777023a044f.png b/processed_images/ss3.363f9777023a044f.png new file mode 100644 index 0000000..53772dc Binary files /dev/null and b/processed_images/ss3.363f9777023a044f.png differ diff --git a/processed_images/topsters2020-2022.c512c423d7967f87.png b/processed_images/topsters2020-2022.c512c423d7967f87.png new file mode 100644 index 0000000..48863f8 Binary files /dev/null and b/processed_images/topsters2020-2022.c512c423d7967f87.png differ diff --git a/resume/index.html b/resume/index.html new file mode 100644 index 0000000..5759ea3 --- /dev/null +++ b/resume/index.html @@ -0,0 +1,57 @@ + + + + + + ++
currently working on this. if you need my resume feel free to contact me.
+ +
+ Souleng is a component-based game engine which allows for the creation of games
+ entirely in Python, utilizing the modern pybind11
fork
+ pybind11k
+ to allow users to derive their own custom Components in Python and effortlessly interface with
+ the C++ side of things.
+
+ You can build the engine on Linux with build.sh
, provided in the
+ engine
directory.
+
+ You can run the engine with run.sh
, which will automatically set the
+ LD_LIBRARY_PATH
to be the lib/
directory. You can also set this
+ variable yourself and run the binary directly. The expected format is
+
+ $ ./run.sh <scene>
+
+
+ where the scene is either
+ $ ./run.sh games/mario
would load and run the scene in the file
+ games/mario.py
+ .scenes
extension. This file should contain the
+ relative path from itself to any number of Python files, specified as in the above bullet
+ points. For example, the file mario.scenes
with content
+
+
+ ui/mario_menu
+ mario
+ ui/game_over
+
+
+ would load the scenes in ui/mario_menu.py
, mario
, and
+ ui/game_over
, and would start running the scene in ui/mario_menu.py
+ + To create a scene in Python, at minimum the following functions must be present in the script: +
+scene_startup
scene_shutdown
scene_input
scene_update
scene_render
Custom components can be created as follows:
+ +
+ import souleng as sw
+ class Foo(sw.ScriptComponent):
+ def __init__():
+ super().__init__()
+ ...
+
+ def input():
+ ... # handle input here
+
+ def update(dt: float):
+ ...
+
+ def render():
+ ...
+
+
+ + Custom functions can be written as well, but these functions must be overridden for the + component to run code every frame, as the C++ engine will only call these functions. +
+ ++ Three additional submodules exist, to allow the user to interface with different systems in the + game engine: +
+ +input
- allows the user to query the input manager for keys pressed and mouse
+ clicks
+ get_key(key: str)
- returns an object for the key
showing if
+ it's been pressed
, held
, or released
this frame
+ get_mouse_click()
- returns an object with mouse click data from the current
+ frame
+ pressed
- True
if the mouse button was
+ first pressed this frame
+ held
- True
if the mouse button was held
+ down this frame
+ released
- True
if the mouse button was
+ released this frame
+ clicks
- number of times the mouse was clicked this
+ frame
+ pos
- vector with x and y for the current mouse position
+ button
- the mouse button pressed this frame
+ get_mouse_motion()
- returns an object with mouse motion data from the
+ current frame
+ motion
- vector with x and y for the amount the mouse
+ moved in each direction since the last time it was polled
+ pos
- vector with x and y for the current mouse position
+ render
- allows the user to call rendering methods necessary to run a scene,
+ interfacing with SDL
+ set_render_draw_color(r: int, g: int, b: int, a: int)
- sets the background
+ color. equivalent to SDL_SetRenderDrawColor
+ render_clear()
- clears the rendering target. equivalent to
+ SDL_RenderClear
+ render_present()
- presents rendered data to the screen. equivalent to
+ SDL_RenderPresent
+ director
- allows the user to change scenes
+ change_scene(name: str)
- changes the current scene to the one specified by
+ name
+
+ The full list of available Python methods can be found in engine/src/bindings.cpp
.
+
+ My main inspiration for making Souleng was the video for the Eternal engine, linked as a good + sample game engine in the final project repository. In their video demonstration, they showed + games using Python components such that most of the game could just be scripted in Python. + However, these components were a bit ad-hoc: they required the module and class name of the + Python module to link properly. I wanted to improve on this idea, to create a seamless + integration between the scripting side of the game engine and the actual components. +
+ +
+ In order to do this, I looked more closely at how Pybind worked, and tried to understand exactly
+ why it was not possible to inherit from components in Python, and then use them in C++. I ran
+ into the issue of this not being possible when adapting Space Invaders for this new engine, but
+ researching it shows that this would only happen if Python no longer held any references to the
+ object being passed to C++. It would "slice" components, so that any Python specific logic was
+ lost. A more modern fork of pybind11
addressed this issue, so I opted to use that
+ library and included it in my game engine.
+
+ Ultimately, my game engine accomplished what it set out to do, and I'm happy with that component + of it. The game development process in Python has as much power as it did in C++, but all of the + parts of the engine which require high performance can still run in C++, including the game loop + itself. This engine also adds some smaller features onto the previous iteration, including + support for spritesheets (swapping textures), loading multiple scenes, and much more + comprehensive input handling (handling all keys, and mouse clicks/motion). +
+ +
+ There was still a lot I wish I could've accomplished for this project, as much of it was spent
+ understanding the internals of pybind rather than focusing on more user-friendly features.
+ Scenes in the game engine can be layed out in scene_startup
in Python, but there is
+ no GUI editor to accomplish this. Additionally, I would've liked to had this GUI editor parse
+ the AST for any Python scenes, to detect any custom components and allow users to add them
+ through the editor, as with a game engine like Unity. I would also add some more builtin
+ components, for things like sound and animation- sound would be something that C++ is needed
+ for, but even something like animation could be implemented from Python, which would be a good
+ showcase of the potential of this scripting feature. I would give more thought to the memory
+ model used for the game engine, possibly using a memory arena to manage lifetimes rather than
+ shared pointers, to allow for more granular control over the lifetimes of game objects. Finally,
+ I would like to evaluate the way I was using singleton data structures- they felt necessary at
+ times, but there might've been room for some other construct (maybe even just static classes,
+ since they need to live for the lifetime of the program).
+
+ +
+
2027-07-25
+there's something wrong with you. it's built into your skeleton, you suspect. you drink and look at yourself in the mirror on a tuesday night. just the same as your parents
+you leave the bathroom and find the hallway as dark as you left it, but less populated. everybody's left, the chatter has ceased. it's not like you were a part of it anyways. your apartment is often lively, and at one point the cast of familiar faces provided a relief from the ins and outs of your life. but slowly it just became part of the latter and the only real escape was getting to be alone.
+you search around the apartment for a hand to hold. maybe your girlfriend is still here, and you can take salvation there. you heard her laugh while your eyes glared scarlet into themselves, but she did say she had to go home. it's not unusual for her to make a sudden exit, and you know she doesn't like it when you get like this, all drunk, all messy. She has strict principles, that's what you like about her, and also what you hate about her, that she gets so easily frustrated. You sometimes wish that you had a different relationship, like the ones of your friends, who seem to drink and do drugs together with an elegance and an underlying care that doesn't need to be surfaced as often as she does so. But you also consider that maybe all of those relationships have guidelines and troubles too, and you've just not seen them aired out in public. Maybe everyone really does have problems with each other
+Your friend roxie is asleep on the couch. she was watching an anime. this will do, you guess. you stumble into the kitchen first, taking the Brita filter out of the fridge. the crust on it stares back at you and its red light blinks with a violence. REPLACE, it demands, but you and your roommates haven't for months. nothing here is clean. the floor of the kitchen appears to be, but just underneath the lip of the floor cabinets are untold crumbs and their consumers, flitting around in search of a meal. you haven't seen any rodents yet, at least, so you don't worry too much. you wash a glass from the sink and pour it full of chilled, (un)filtered water. This is mainly so the next part doesn't make you puke
+You return to the couch and empty out some small crystals onto the mirror on the living room table. this is exegenamine, an NMDA receptor antagonist, which has been making the rounds amongst your friends recently. it's got the dissociation which everyone wants nowadays, and of course, music sounds great. Exegenamine (hereon, exg) also, however, behaved in an oddly uniform way. it would provide a "narrative evaluation", so to speak. any "visions" or "discoveries" on exg would only manifest as direct commentaries on its user's self-narrative - their understanding of who they were, and how they came to be, and etc. Notably, it did not change this understanding- this was an exercise left to the reader, so to speak. you and your friends appreciated this - dabbling with acid and shrooms some years back was certainly fun, but there was only so much you could really get from them, you felt, and the collective understanding of these drugs- socially and scientifically- made subsequent uses feel less effective. Exg was under study regarding how it could deliver the same effects to every user, a textual self-criticism, but this was somewhat impeded by all the Schedule II red tape. It was also not very available, as its synthesis was known only to whomever kept putting it on the market. Bad exg existed of course, but it wasn't much different from ketamine - if you did enough, you'd realize it wasn't what you wanted. Fortunately, you knew someone who worked at the university's bio lab studying exegenamine, and he'd taken it upon himself to acquire a large batch for "research purposes".
+you cut up the crystals with an old gift card- reserved explicitly for cutting up drugs, since you didn't want the residue all over your credit card. you took a few lines, each spaced out by a few minutes, and leaned back on the couch to catch up on whatever roxie was watching.
+an episode had gone by since you began watching. Oh, you recognized the protagonist - this was Cyber Heaven9, but you'd never seen it. you just knew that it was generally acclaimed on the internet, that people would always take profile pictures of the main android, Exe, or otherwise Emp3, her sometimes sidekick/love interest (depending on who you asked). This episode Exe was climbing up a large cylindrical shaft, filled with computer terminals. It was a largely introspective episode, and as Exe continued her climb and questioned her place, you began yours, since the scanlines of the terminals began to dance in front of you as the exg kicked in.
+it was time for a reflective episode, you had figured, thinking about the recommendations that julian had given you. you'd talked to him about the mirror thing before, how you'd stare into it and hate what you saw, and that actually prompted him to recommend you exg. you'd been trying to figure out the angle for it, since you didn't really know how freely he gave it out, being a research assistant and all- you should have figured the guy loved to have people try it. Anyways, talking with him at that house party, shoved into the corner of a couch with bodies all around you, you'd spoken to him honestly, and he'd understood. The same thing had happened to him. He'd hurt someone in the past, he said, and after that, looking in the mirror, it just made him see a violent, hideous man, a junkie, an addict, a zombie. This was exactly it. But exg had helped him, in a way the other research chemicals hadn't really. Since he had to come back to that moment in the mirror, and exg laid it all out for him. You appreciated that he didn't explain what he learned, though. talking with people who did drugs could sometimes ruin the whole thing. he'd said to take 5 lines to start, as it wasn't readily bioavailable through insufflation. he'd handed you the gram before leaving the party, and you wished you'd gotten his number.
+you laid back and watched the chasm fade behind Exe, the critical process becoming clearer and clearer.
+ ++ +
+ +
+ +
+ +