Log In  
Log In  

Cart [#34530#] | Code | 2016-12-30 | License: CC4-BY-NC-SA | Embed

**UPDATE v0.21: click n' drag support, analog keyboard control, smaller template, and LOTS of bugfixes

A vector graphics authoring tool for your Pico8 demos, fonts, adventure games, etc. Draw an image, then save it as a highly compressed string which can be shared with other PiCAD users, or else displayed in your own cartridges without using any space in the spritesheet by including the PiCAD API.

To use your PiCAD images in your own cartridges, start with this template API (click Show to see):

Cart [#34531#] | Code | 2016-12-30 | License: CC4-BY-NC-SA | Embed

-save/load images as compressed strings (saved to picad_string.p8l)
-save to a spritesheet (saved to picad_export.p8)
-paint with a variety of brushes, including pattern/gradient fill, bezier curves, and copy/clone screen rectangles
-unlimited undo
-mouse & keyboard support

ENTER: open save/load menu
x: show/hide UI
tab: undo
q: show/hide guides
s/f: scroll color
e/d: scroll brush

To load strings into PiCAD, hit ENTER, select "Load..." and paste (Ctrl-V/Apple-V) the string into the Pico8 window. This must be done in the actual Pico8 console as the web player does not support reading from the clipboard.

Tech info: Rather than raw pixel data, PiCAD images are composed of a series of encoded draw operations—like an assembly language for images—which allows them to be stored as highly compressed strings. The format is inspired by the Sierra AGI "PICTURE" specification. Thanks to @dw817 for fast floodfill code.

(PiCAD is a lot more useful when used inside the actual Pico8 console rather than on the web player, which does not support save/load.)

Export CLS Cmds: PiCAD strings generally begin with a "clear screen" opcode. That opcode is omitted from string exports when this setting is OFF. ON by default.
Continue Lines: When ON, lines and bezier curves can be continued relative to the previous operation, which will produce more efficient strings. OFF by default.
Autosave: When ON, saves your work to a string in picad_autosave.p8l after every new brush. OFF by default.
Click n' Drag: Turn ON if you're more comfortable with clicking and dragging to place brushes (rather than clicking and releasing for each operation). OFF by default.
Analog Keyboard: Simulates an analog joypad when using the keyboard instead of the mouse, which should make using PiCAD more pleasant on the PocketCHIP. ON by default.

P#33832 2016-12-21 05:00 ( Edited 2016-12-30 19:25)

:: Offler

This is really cool!

Is there a quicker way to see the current size than to open the About dialogue?

Could you briefly describe the format? Are all the lines and curves separate? Wouldn't it make sense to somehow continue where the last line ended, like other vector formats like SVG?

P#33835 2016-12-21 06:17 ( Edited 2016-12-21 11:17)

@Offler -- thx! if you go into Settings and toggle "Continue Lines" to ON, the lines and curves will continue where the last one ended as you suggest. This setting is OFF by default, which was probably dumb of me.

No faster way to see the current image size at the moment -- I'll think about a good way to display that info quickly.

This is the current PiCAD spec:

A PiCAD string consists of a hexadecimal string made up of a series of opcodes and their arguments, with no spaces between them. An argument is either a half-byte (one character, range 0-f) or a byte (two characters, range 00-ff).

As of 0.2, there are 14 opcodes (of a possible 16):

  • 0 CLS: clear screen. args: one half-byte COLOR
  • 1 STAMP: pattern stamp. args: two bytes X and Y, one half-byte COLOR, and one half-byte PATTERN index
  • 2 FLOOD: pattern flood fill. args: two bytes X and Y, one half-byte COLOR, and one half-byte PATTERN index
  • 3 LINE: line. args: four bytes X0,Y0,X1,Y1, and one half-byte COLOR
  • 4 RECT: rectangle. args: four bytes X0,Y0,X1,Y1, and one half-byte COLOR
  • 5 RECTFILL: filled rectangle. args: four bytes X0,Y0,X1,Y1, and one half-byte COLOR
  • 6 CIRC: circle. args: two bytes X and Y, one byte RADIUS, and one half-byte COLOR
  • 7 CIRCFILL: filled circle. args: two bytes X and Y, one byte RADIUS, and one half-byte COLOR
  • 8 BEZIER: bezier curve. args: four bytes X0,Y0,X1,Y1, two bytes CX,CY, and one half-byte COLOR
  • 9 COPY: copies a rectangular screen fragment to memory. args: four bytes X,Y,W,H (all values must be even)
  • a CLONE: pastes a previously copied fragment to screen from memory. args: two bytes X and Y (must be even)
  • b GRADFILL: gradient flood fill. args: four bytes X0,Y0,X1,Y1 and one half-byte COLOR
  • c unused
  • d unused
  • e LINEADDL: line relative to end of previous line. args: two bytes X1 and Y1
  • f BEZIERADDL: curve relative to end of previous curve. args: two bytes X1, Y1 and two bytes CX, CY



clears the screen with color 1, then draws a filled rectangle from (48,40) to (93,76) using color 6

P#33837 2016-12-21 06:50 ( Edited 2016-12-22 23:30)

this is amazingly cool, great work. inspires me to think of what other 'tools' could be written with a similar idea

P#33856 2016-12-21 10:56 ( Edited 2016-12-21 15:56)

holy cow! thank you so much! i have been working on some vector drawing tools myself, and now there's this... so cool. I'm excited to study this code, it looks really great so far.

P#33887 2016-12-21 20:04 ( Edited 2016-12-22 01:04)

This is very cool. :D
Reminds be of the editor that came with the Graphics Adventure Creator (GAC) program back on my C64!
I've been looking for alternative ways for creating graphics for an adventure-style game and this could be the solution.
Thank you! :)

P#33900 2016-12-22 02:41 ( Edited 2016-12-22 07:41)

that's amazing!!

P#33908 2016-12-22 04:17 ( Edited 2016-12-22 09:17)

Hi Musurca,

This is wonderful!

Are you planning on making a lightweight "library" version of the engine that folks could copy/paste into their carts without the UX stuff?

A couple of other notes:
--In place of the "continue lines" option--could there just be a polygon / polycurve tool?
--Any chance this could be a cubic spline instead of the quadratic spline? I guess I am just more used to how Illustrator handles curves, but the cubic handles have always made more sense to me.

--I find that I want to click and drag to draw lines as opposed to clicking point by point. I know this adds complexity because then you need a rubber band / updating screen model, but it seems like it would be more intuitive.
--An indication of how many bytes the drawing is would definitely be helpful. Even better would be an indication of how many characters / compressed bytes it would take up. This way you could budget screens for an adventure game more easily.

Keep up the good work!

P#33984 2016-12-22 15:40 ( Edited 2016-12-22 20:40)

@electricgryphon — thanks! to answer your questions:

—I did make a library/template to display vector images inside your own carts, available in Splore and also here (click Show):

Cart [#33992#] | Code | 2016-12-22 | License: CC4-BY-NC-SA | Embed

(It's not as "lightweight" as I'd like yet—haven't had a chance to really pare down the token count.)

—Good idea re: the polygon/polycurve tool. At this point I've completely run out of room in my UI so I have to rethink how to fit everything on the screen.
—I DID consider going cubic instead of quadratic, but opted for the latter to save space—one control point/two bytes vs. two points/four bytes. Cubic would be great though-- I'm running out of opcodes but will think about how to support them.
—Click to add points vs. click-and-drag: made this decision purely based on personal preference, but yes, I should also support click-and-drag via the settings menu.
—If you go into the ABOUT... menu, you can find a running byte/character count for the current drawing. As Offler pointed out, it should be easier to pull this up, but that'll have to wait until I redesign the UI.

Thanks to everyone else for your comments—glad you're liking it. Just pushed out version 0.2, which includes a gradient fill brush.

(FYI: the gradient fill is a lot slower than I would like, but I can't figure out how to speed it up without running out of memory in worst-case scenarios. Anyone have a better gradient floodfill routine?)

P#34010 2016-12-22 23:29 ( Edited 2017-01-08 00:39)

The gradient fill is a sweet addition.

For some reason the menu stopped working for me when pressing enter, but I was at least able to screen-capture my creation.

P#34061 2016-12-23 20:11 ( Edited 2016-12-24 01:11)

So majestic. Can we work out a licensing agreement? I'd like to have this on the shelves by Christmas 1986.

(But that is incredible. Did you have autosave on? The string might still be saved.)

P#34068 2016-12-23 22:45 ( Edited 2017-09-30 21:04)

[Please log in to post a comment]

About | Contact | Updates | Terms of Use
Follow Lexaloffle:        
Generated 2019-04-22 14:32 | 0.071s | 4194k | Q:65