VGA Flag Language - Revision history

Foone at 05:12, 17 July 2024

2024-07-17T05:12:10Z

← Older revision		Revision as of 05:12, 17 July 2024
Line 173:		Line 173:
	\|-		\|-
	\|Lines		\|Lines
	\|A line-type enum, a list of points, and a color		\|A line-type enum, a base point, a list of points, and a color
	\|A series of (connected?) lines, Regular or Thick		\|A series of (connected?) lines, Regular or Thick
	\|Lines Thick, [(25,0), (0,25)], $white		\|Lines Thick, (0,0), [(25,0), (0,25)], $white
	\|-		\|-
	\|Image		\|Image

Foone: meta-include is now a filename

2024-07-13T05:17:11Z

meta-include is now a filename

← Older revision		Revision as of 05:17, 13 July 2024
Line 184:		Line 184:

	=== meta-include ===		=== meta-include ===
	<nowiki>#</nowiki>include is a meta-command which looks up another flag and inserts it at the current position, as if all the commands from that flag had been copy-pasted into this one. It takes a string to look up the flag by ~~name~~.		<nowiki>#</nowiki>include is a meta-command which looks up another flag and inserts it at the current position, as if all the commands from that flag had been copy-pasted into this one. It takes a string to look up the flag by filename. Paths aren't supported: it's only a filename

	Example:		Example:
	#include "~~rainbow7~~"		#include "seven-stripe-rainbow.flag"

Foone at 04:02, 15 January 2024

2024-01-15T04:02:43Z

← Older revision		Revision as of 04:02, 15 January 2024
Line 15:		Line 15:
	}		}

	~~Triangle~~ (0,0), (240,240), (0,480), $black		Polygon Filled, (0,0), [(0,0), (240,240), (0,480)], $black

	=== Rendering context ===		=== Rendering context ===
Line 160:		Line 160:
	\|A rectangle defined by the upper-left and bottom-right points		\|A rectangle defined by the upper-left and bottom-right points
	\|Rectangle (0,50), (200,60), $white		\|Rectangle (0,50), (200,60), $white
	\|-
	~~\|Triangle~~
	~~\|3 Points & a color~~
	~~\|A triangle~~
	~~\|Triangle (0,0), (50,0), (0,50), $white~~
	\|-
	~~\|Quad~~
	~~\|4 Points & a color~~
	~~\|A 4-sided polygon~~
	~~\|Quad (0,0), (50, 0), (50,50), (0, 50), $white~~
	\|-		\|-
	\|Ellipse		\|Ellipse
Line 177:		Line 167:
	\|-		\|-
	\|Polygon		\|Polygon
	\|A polygon-type enum, list of points, and color		\|A polygon-type enum, a base point, a list of points, and color
	\|A polygon, either filled, outlined, or with thick outlines		\|A polygon, either filled, outlined, or with thick outlines.
	\|Polygon Filled,[(232,292),(319,135),(319,169),(260,274)],$white		(The polygon is shifted by the base point before rendering)
			\|Polygon Filled,(0,0), [(232,292),(319,135),(319,169),(260,274)],$white
	\|-		\|-
	\|Lines		\|Lines
Line 185:		Line 176:
	\|A series of (connected?) lines, Regular or Thick		\|A series of (connected?) lines, Regular or Thick
	\|Lines Thick, [(25,0), (0,25)], $white		\|Lines Thick, [(25,0), (0,25)], $white
	\|-
	~~\|Star~~
	~~\|A star-type enum, a point, and a color~~
	~~\|A star, in one of three sizes: Small, Medium, Large~~
	~~\|Star Big, (50,50), $white~~
	\|-		\|-
	\|Image		\|Image

Foone: /* Metadata */

2023-12-30T02:22:10Z

Metadata

Show changes

Foone: Created page with "The VGA Flag Language is a DSL for defining pride flags, to be used in VGAPride. === Example flag script: === $names=["demisexual"] $description="The Demisexual pride flag..."

2023-12-30T02:06:57Z

Created page with "The VGA Flag Language is a DSL for defining pride flags, to be used in VGAPride. === Example flag script: === $names=["demisexual"] $description="The Demisexual pride flag..."

New page

The VGA Flag Language is a DSL for defining pride flags, to be used in VGAPride.

=== Example flag script: ===
$names=["demisexual"]
$description="The Demisexual pride flag"
// Unknown creator. Maybe research further?
$textcolor=$black

vertical{
RGB(255,255,255)
RGB(255,255,255)
RGB(110, 0,112)
RGB(210,210,210)
RGB(210,210,210)
}

Triangle (0,0), (240,240), (0,480), $black

=== Rendering context ===
Scripts generate a 640x480 image which uses a max of 16 colors.

The only pre-defined color is 0, which is black. The other 15 colors will be allocated as they are used, and the compiler will throw an error if too many colors are used.

The coordinate system is 0-639 horizontally, 0-479 vertically, starting in the top-left.

=== Overall structure ===
The main elements of a script are '''comments''', '''variable declarations''', '''structures''', and '''commands'''.

'''Comments''' can start anywhere on a line and begin with // and continue to a newline.

'''Variable declarations''' take the form $variable_name = SOMEVALUE (see Value Types below)

'''Structures''' are curly-brace delimited blocks which automatically generate rectangle commands based on colors. See Structures below.

'''Commands''' are functions which draw different shapes into the image. See Command List below.

=== Value Types ===
There are six value types used for variables:
{| class="wikitable"
|+
!Name
!Examples
!Description
|-
|Integers
|4
-5

+15
|Whole signed numbers, 16-bits. Used for text sizing and ellipse width/height.
|-
|Colors
|RGB(10,20,30)
<nowiki>#</nowiki>FF00FF
|A given color. Technically 6-bits-per-channel, but we're pretending they're not
|-
|Enumerations
|Filled
Medium

Outline
|Used for special values in commands
|-
|Strings
|"foobar"
'bazqux'
|A text string used for metadata
|-
|Points
|(10,25)
(-50, 500)
|A point is a geometric location made of two integers.
|-
|Lists
|["hello"]
[(25,0), (50,0)]
|A list is a static array of values. Only used for Points and Strings.
|}

=== Metadata ===
Some variable definitions are interpreted by VGAPride. These special definitions are: