Omegaplex

Omegaplex, created by poiuy_qwert is a variant of the esoteric programming language Gammaplex created by Lode Vandevenne. It is definitely not as advanced as Lode Vandevenne's update to Gammaplex, Deltaplex, but is still an improvement in the opinion of the author. All the printable ASCII characters are used for commands.

Terminology

This just explains some things you will need to know if you are going to understand Omegaplex.

Stack

A 2-Dimensional floating point array(Stack[1024][1024]) which stores all the data in the program. Every entry is initialized to 0.

StackPointer

Which stack the program is currently using. Initialized to 1.

CurX, CurY

The X and Y positions in the program of the current command. Both initialized to 1.

Direction

The direction the program flow is headed: 1 = right, 2 = down, 3 = left, 4 = up. Initialized to 1 (right).

DecimalNumber, StringNumber

Dictates the behavior of the decimal and string systems explained below. Both initialized to 0.

Resolution

The screen resolution. Initialized to 255x255.

GraphicPointer

An array of intergers(GraphicPointer[6]) that point to stacks to be used in graphics, explained more below. Initialized to: 1 = 1, 2 = 2, ... 6 = 6.

String

Every number on the stack between until a number less than 0 or greater than 255 is considered an ASCII value to make a string.

FileByte

The current byte being pointed to in the file.

Pop

Takes the item off the top of the current stack, letting it be used for something or discarded.

Push

Puts a number on the top of the stack.

Get

Like pop, except that the item stays on the stack (a pop-then-push, or "peek").

Programs

Programs are text files having any extension (*.opx is the extension the author uses). The program starts in the top left corner of the text file (at 1,1), executes the command there, then moves into the direction specified by Direction onto the next command. Every line in the file should be of the exact same length in characters. If the program flow goes off the side of the file it will wrap around to the other side. For example:

 \
\\
\Z

The program starts at the top left then:

1. Does nothing ( ), then
2. Moves to the right, then turns (\), then
3. Moves down, then turns (\), then
4. Wraps to other end, then turns (\), then
5. Goes down then, then turns (\), then
6. Moves right, then the program ends (Z).

It can be modeled as such:

─┐
┐└
└─

Commands

This is a list of all the commands:

CMD	ASCII	Description
>	62	Increase StackPointer.
<	60	Decrease StackPointer.
s	115	Pop a value, then set StackPointer to it.
S	83	Push StackPointer.
?	63	Pop a value, if it's zero, skip the next command.
/	47	Change Direction as if bouncing off a 45° mirror (1 becomes 4, 2 becomes 3, 3 becomes 2, 4 becomes 1).
\	92	Change Direction as if bouncing off a 45° mirror (1 becomes 2, 2 becomes 1, 3 becomes 4, 4 becomes 3).
{	123	Change Direction to 1 (right).
}	125	Change Direction to 3 (left).
g	103	Pop x, then y, then go to (x,y) and start executing from that command.
G	71	Pop x, then y, then go to (x,y) and push CurX, CurY, and Direction.
B	66	Pop x, y, and z, then go to (x,y) and change Direction to z.
	32	Do nothing(NOP).
#	35	Set DecimalNumber to 0.
;	59	Jump next command.
^	94	Jump next pop commands.
(	40	Push Stack[pop] on current stack.
)	41	Push currecnt stack on Stack[pop].
d	100	Pop and do nothing.
D	68	Pop, pop that many values, then do nothing.
y	121	Pop, then push push.
Y	89	Pop, then get that many times then push them.
[	91	Shift pop items pop times to the left.
]	93	Shift pop items pop times to the right.
+	43	Push pop + pop.
-	45	Push pop - pop.
*	42	Push pup * pup.
:	58	Push pop / pop.
%	37	Push pop % pop.
~	126	Push pop ^ pop.
R	82	Push the square root of pop
M	77	Execute math function pop.
=	61	If pop equals pop push 1, else push 0.
_	95	If pop is smaller than pop push 1, else push 0.
&	38	Push binary and of pop and pop.
|	124	Push binary or of pop and pop.
X	88	Push binary xor of pop and pop.
!	33	If pop is 0, push 1, else push 0.
v	118	Push pop - 1.
V	86	Push pop + 1.
t	116	Push ticks since program start.
T	84	Push ticks since last t or T command.
r	114	Set Resolution to pop x pop.
'	39	Push 255 on the stack.
f	102	Toggle graphic style pop.
F	70	Push graphic style pop.
x	120	Set GraphicPointer pop to pop.
p	112	Draw a pixel.
l	108	Draw a line.
c	99	Draw a circle.
b	98	Draw a box.
h	104	Convert color pop,pop,pop to HSV and push the result.
H	72	Convert HSV pop,pop,pop to color and push the result.
w	119	Push the width of the screen.
W	87	Push the height of the screen.
i	105	Push 0 then input a string at (pop,pop).
I	73	Push 0 then input a string at Stack[pop].
n	110	Input a number at (pop,pop).
N	78	Input a number at Stack[pop].
m	109	Push mouse Y and mouse X coordinates on stack.
u	117	Set debug mode to pop.
U	85	Set debug mode to 0.
q	113	Get ASCII of instruction at (pop,pop) to pop.
Q	81	Get ASCII of instruction at Stack[pop]
e	101	Edit the instruction at (pop,pop) to be ASCII pop.
E	69	Edit the instruction at Stack[pop] to be ASCII pop.
"	34	Read more about this command in the string section.
~	126	Mirror string.
`	96	Duplicate string.
o	111	Pop and output as an integer.
O	79	Pop up to a number <1 or >255 and output all as a string.
k	107	Pop then pop that many numbers and convert them to a string.
K	75	Pop up to a number <48 or >57 put them together as an integer and push it.
@	64	Redraw screen.
C	67	Clear the screen.
0-9	48	Digit commands.
.	46	Decrease DecimalNumber by 1 unless its 0.2.
,	44	Increase DecimalNumber by 1 unless its 2.
j	106	Push a random integer between pop and pop.
J	74	Push a random float between pop and pop.
$	36	Sleep until a button is pressed.
L	76	File opening command. All file commands explained bellow.
a	97	Decrease FileByte.
A	65	Increase FileByte.
P	80	Read the current byte in the file then increase FileByte.
z	122	Write string to file starting at FileByte.
Z	90	End program(Essentially {}).

All characters on the keyboard except 9(horizontal indent, tab), 10(line feed, enter), and 13(carriage return, enter) are commands.
Note: All commands are case sensitive!

Systems

These are some special systems designed to make Omegaplex esier to use.

Files

The Files system is used to interact with *.txt files in the same directory as the program. When you use the L command, if there is no file open it will take the string off the stack and open the file with that name, then push a 1. If there was a file open when the L command was used it closes the file the pushes a 0. When you open a file FileByte gets reset to 1, you can then increase or decrease it with a and A. The P command pushes the characters ASCII at FileByte, then increases FileByte then pushes 1 if its EOF or 0 if not. The z command writes the string on the stack to the file starting at the FileByte, increasing the FileByte every character.

Strings

The Strings system uses StringNumber which is a boolean variable initialized to 0. The " command is used to toggle StringNumber. When StringNumber is 1 every character read from the program is pushed as an ASCII value onto the current stack. If StringNumber is 0 the commads are executed regularily. There are also some commands that can be executed inside a string by prefixing them with a ~. The commands that can be used in a string are:
/\{}; #

There are also special commands for strings, they are also prefixed with ~. They are:
2-9: Execute the next N characters as commands.
~: Push the ASCII of ~.

Decimals

The Decimal system uses DecimalNumber which is anything from 2 to -2 that is initialized to 0 and can be changed with '.' and ','. Every command except the ones below reset the DecimalNumber to 0:
0123456789 .,/\{}

The commands 0-9 do the following:

DecimalNumber	Description(N is the command used)	Example on stack 1.1,2,3 and calling 9.
2	Pop, place N on the front of the number, and push.	91.1,2,3
1	Pop, place N on the end of the number, and push.	19.1,2,3
0	Push N on the stack.	9,1.1,2,3
-1	Pop, place N on the front of the decimal, and push.	1.91,2,3
-2	Pop, place N on the end of the decimal, and push.	1.19,2,3

Math

The M command executes a math function depending on pop. Depending on the function up to the next 2 stack values can be poped as u and v. The functions are:

1. sin(u): sine
2. cos(u): cosine
3. tan(u): tangent
4. sec(u): secant
5. csc(u): cosecant
6. cot(u): cotangent
7. asin(u): inverse sine
8. acos(u): inverse cosine
9. atan(u): inverse tangent
10. asec(u): inverse secant
11. acsc(u): inverse cosecant
12. acot(u): inverse cotangent
13. sinh(u): hyperbolic sine
14. cosh(u): hyperbolic cosine
15. tanh(u): hyperbolic tangent
16. sech(u): hyperbolic secant
17. csch(u): hyperbolic cosecant
18. coth(u): hyperbolic cotangent
19. asinh(u): inverse hyperbolic sine
20. acosh(u): inverse hyperbolic cosine
21. atanh(u): inverse hyperbolic tangent
22. asech(u): inverse hyperbolic secant
23. acsch(u): inverse hyperbolic cosecant
24. acoth(u): inverse hyperbolic cotangent
25. exp(u): exponential: e^u
26. ln(u): natural logarithm (base e)
27. exp(-(u * u)): standard normal distribution
28. sign(u): returns -1, 0 or 1 (the sign of u)
29. atan2(v, u): computes the principal value of the arc tangent of v/u, using the signs of both arguments to determine the quadrant of the return value
30. log_u(v): base u logarithm of v, that is: ln(v)/ln(u)

Graphics

When using the commands p, l, c, and b to draw, you need to have coordinates and colors for them. To make things easier for graphics, you must set the GraphicPointers to a Stack where you will define everything for the graphics. Setting a GraphicPointer is done with the x command. The x command pops a number from the stack to choose which setting to change, and those settings are:

1. Coordinates A (Top value is x, 2nd value is y)
2. Coordinates B (Top value is x, 2nd value is y)
3. Color A (Top value is r, 2nd value is g, 3rd value is b)
4. Color B (Top value is r, 2nd value is g, 3rd value is b)
5. Radius
6. Transparency (1-256, 1 being opaque, 256 being transparent)

There are also graphic styles that can be toggled with the f command. The f command also pops a number from the stack to choose which style to toggle. The styles are:

1. Enable transparency
2. Multiply blending
3. Make underlying pixels negative color (effect visible if transparency or blending is used)
4. Do not draw over pixels with Color B
5. Only draw over pixels with Color B
6. 50% dot pattern
7. Less dots than above
8. Horizontal lines
9. Vertical lines
10. Invert pattern (transparent pixels are now filled ones and vice versa)
11. Horizontal gradient
12. Vertical gradient
13. Text background as Color B (with gradient the background is opposite gradient of text)

4 and 5 together form "draw with (Color A + Color B)/2 over Color B, draw normally over the rest"

Horizontal and vertical gradient together make 45Рgradient. The gradient is from one side of the screen to the other side, and uses Color A and Color B. 4 and 5 are disabled when gradient is enabled.

Dot and stripe patterns mixed form dotted line patterns (the combination of all removed pixels).

Implementation

The author of Omegaplex has asked and was allowed by Lode Vandevenne to use the Gammaplex interpreter source as a base for the Omegaplex interpreter. This means the creation of the interpreter will go fast.

Example Programs

These programs work in theory, but since the language is unimplemented there is no way to know if they do.

Hello World!

Outputs "Hello, World!" to the screen.

"Hello, World!"~OZ

Omegaplex Demo

The Gammaplex demo edited to work in Omegaplex.

"Omegaplex"~>0y'>'yy>\
/        f21xy4xy3xy2/
{t650:2M124*124+t4\   
\C@O`s1+29*29M2:00}   

See Also

• Gammaplex
• Deltaplex