|
I've recently rebooted the GFX documentation, and am more or less retiring the single monolithic code project article here in favor of a wiki style format, probably hosted on github.
As I've outlined the project and created the table of contents, it started to dawn on me how utterly wide and deep GFX is, from the drivers all the way down to the pixels you can drill down and down and down. Add to that all of the features, and the scope is huge.
9 markdown documents, 100s of lines each, at least.
Here's the TOC so far (incomplete but pretty much fleshed out) just to give you an idea of this codebase. Wow.
I can't believe I even wrote it, much less in the time I wrote it.
1. [Pixels](./pixels.md)
- 1.1 [Declaring common pixels](./pixels.md#1.1)
- 1.2 [Channels](./pixels.md#1.2)
- 1.3 [Colors](./pixels.md#1.3)
- 1.4 [Color models](./pixels.md#1.4)
- 1.5 [The alpha channel](./pixels.md#1.5)
- 1.6 [Indexed pixels](./pixels.md#1.6)
- 1.7 [Declaring custom pixels](./pixels.md#1.7)
- 1.8 [Converting pixels](./pixels.md#1.8)
- 1.9 [Metadata](./pixels.md#1.9)
2. [Draw targets](./draw_targets.md)
- 2.1 [Sources and destinations](./draw_targets.md#2.1)
- 2.2 [Bitmaps](./draw_targets.md#2.2)
- 2.2.1 [Standard bitmaps](./draw_targets.md#2.2.1)
- 2.2.2 [Const bitmaps](./draw_targets.md#2.2.2)
- 2.2.3 [Large bitmaps](./draw_targets.md#2.2.3)
- 2.3 [Drivers](./draw_targets.md#2.3)
- 2.4 [Viewports](./draw_targets.md#2.4)
- 2.5 [Sprites](./draw_targets.md#2.5)
- 2.6 [Custom](./draw_targets.md#2.6)
- 2.6.1 [Common members](./draw_targets.md#2.6.1)
- 2.6.2 [Capabilities](.draw_targets.md#2.6.2)
- 2.6.3 [Draw source members](./draw_targets.md#2.6.3)
- 2.6.4 [Draw destination members](./draw_targets.md#2.6.4)
- 2.6.5 [Initialization](./draw_targets.md#2.6.5)
3. Images
4. Fonts
- 4.1 Truetype TTF/OTF
- 4.1.1 Layout considerations
- 4.1.2 Storage considerations
- 4.1.3 Performance considerations
- 4.2 Raster FON
- 4.2.1 Performance considerations
- 4.2.2 Storage considerations
5. Drawing
- 5.1 Basic Shapes
- 5.2 Bitmaps and Draw Sources
- 5.3 Text
- 5.4 Images
- 5.5 Sprites
- 5.6 Alpha blending
- 5.6.1 Performance considerations
- 5.6.2 Draw target considerations
6. Positioning
- 6.1 Points
- 6.2 Sizes
- 6.3 Rectangles
- 6.4 Paths
7. Streams
8. Performance
- 8.1 Blting
- 8.2 Copying
- 8.3 Batching
- 8.4 RLE transmission
- 8.5 Asynchronous drawing
9. Tools
- 9.1 Bingen
- 9.2 Fontgen
To err is human. Fortune favors the monsters.
|
|
|
|
|
I don't see turtles listed there anywhere.
|
|
|
|
|
PIEBALDconsult wrote: I don't see turtles listed there anywhere.
Did you look all the way down?
|
|
|
|
|
I think that's covered in the Sprites section.
|
|
|
|
|
I didn't realize she wrote it in Logo. 
|
|
|
|
|
...The doctor comes in to see a bloody mess.
"Doc you gotta help me! I accidentally chopped off all of my fingers using the circular saw!" said the carpenter.
"Well, there is not much I can do except stitching your nubs. I wish you had of brought your fingers in a Zip-Loc bag," the doctor replied.
So the carpenter says "Doc, how was I supposed to bring my fingers to you if I can't pick them up?"
modified 27-Mar-22 13:38pm.
|
|
|
|
|
As I always say in such situations: Ohne Arme keine Kekse.
I have lived with several Zen masters - all of them were cats.
His last invention was an evil Lasagna. It didn't kill anyone, and it actually tasted pretty good.
|
|
|
|
|
What do you mean now?
a.) 'ohne Arme' (arm)
b.) or 'ohne Arme' (poor)
c.) or maybe 'ohne Armee'...
|
|
|
|
|
I'm betting on a, since no arms means you cannot pick up a piece of (scharzwalder) cake.
Bastard Programmer from Hell 
"If you just follow the bacon Eddy, wherever it leads you, then you won't have to think about politics." -- Some Bell.
|
|
|
|
|
I'm aware, I forgot to mark it...
|
|
|
|
|
The cake is a lie.
"I have no idea what I did, but I'm taking full credit for it." - ThisOldTony
"Common sense is so rare these days, it should be classified as a super power" - Random T-shirt
AntiTwitter: @DalekDave is now a follower!
|
|
|
|
|
Schwarzwald don't lie.
Bastard Programmer from Hell
"If you just follow the bacon Eddy, wherever it leads you, then you won't have to think about politics." -- Some Bell.
|
|
|
|
|
Here is an old one:
Man arrives at hospital with a mangled leg. Doctor examines it and tells him: "That leg is in very bad shape. I try my best, but I can't be sure I may have to amputate". Later, when man first awakes from surgery, he asks the doctor about the results. The doctor says, "I have good news and bad news." The man groans then asks "Ok, give me bad news? The doctor says "I cut off the wrong leg." Man groans even more loudly and starts to cry. After he gets composed he asks "So, what is the good news?" The doctor says "the other leg is getting better".
|
|
|
|
|
Sheesh, this documentation revamp for GFX is a chore.
I'm going to build a wiki on github for it (I think? I was just told it was possible the other day) but I'd like to also provide an HTML copy so that it can be browsed offline.
That markdown is simple enough, but there's a directory full of it, and it does contain <a name="myanchor"></a> markers and links to other documents in the directory.
What I'd like to do ultimately is run some kind of script over the directory and a tool would convert each file to static HTML.
As I know web developers haunt this place, surely some of you know of such a tool? I hope?
Thanks in advance!
To err is human. Fortune favors the monsters.
|
|
|
|
|
I use Markdown Monster: The Markdown Editor for Windows. It allows save to HTML, as well as cut and pasting of HTML and Markdown content. HTML is valid Markdown, BTW.
Love your articles. Your state-machines, and IOT stuff reminds me or writing dual printer controllers on Motorola 6801 or 6803s.
Now there are some resource constrained devices.
Matthew
"Time flies like an arrow. Fruit flies like a banana."
|
|
|
|
|
Thank you!
I've coded for 6800s and 6502s before. The 6800s were monitoring aluminum smelting "pot lines", while the 6502 was just what I cut my teeth on as an impressionable child.
To err is human. Fortune favors the monsters.
|
|
|
|
|
Yeah, no. Not here.
That's not doable in a batch file, but how long would it take in C#? Given you're familiar with it?
--edit
Gimme some specs, we could make an article out of it  It's not like I got something better to do.
Bastard Programmer from Hell
"If you just follow the bacon Eddy, wherever it leads you, then you won't have to think about politics." -- Some Bell.
|
|
|
|
|
I thought about. The most difficult part for my document would be the nested lists in the table of contents.
I'm going to try a tool Matthew Dennis suggested first. It looks like it may do what I need.
To err is human. Fortune favors the monsters.
|
|
|
|
|
I'd start by considering rolling my own of course. The main problem I have with off-the-shelf solutions is that they resolve only the easy parts of a larger problem. And no one can solve a problem he doesn't have.
I don't know how I'd handle the nested items you mentioned.
|
|
|
|
|
|
Do you look up lists of five letter words on the internet?
Coming up with six five letter words from the top of my head seems to be my greatest challenge in life yet (well, after the CCC) 
|
|
|
|
|
|
So now you like documentation! 
|
|
|
|
|
Ravi says[^] that Wordle actually has two word lists that he also used in his version. I haven't searched for them, but they must be posted somewhere. What puzzles me is that when I play Ravi's version in hard mode, many words ending in -s or -ed aren't on the list and therefore can't be used as guesses. But when I play hard mode online, those words are acceptable. I assume they do this so that the daily word can be the same in both standard and hard mode.
|
|
|
|
|
In Hard mode, Wordle Anytime[^] only accepts guesses that are in the list of actual Wordle words. In Standard mode, it also accepts words in the secondary list of allowed guesses. In Easy mode, it lets you enter any combination of 5 letters.
/ravi
|
|
|
|
General 
News 
Suggestion 
Question 
Bug 
Answer 
Joke 
Praise 
Rant 
Admin 
Submit an article or tip
