/-. ..... /-./ ...... / 2/ ... ... /`./ ... ... - / :/ - - - -: ... ... :- - - - - - ' /`./ ............ ' ' / :/ .............` ' ' /`./ `.. ... ' /"./ ':.:::. ... :::::: ,` .:` :` '// ,'` .: ... :: :: :` :: /`.,.,.,.,.-'.:::` . . ::::. :: :::. ' .'' ;, ,; `::`. .:,. .:: .::.:: :: :: ' :' `:: :: :: :: :: :: :: ::` :: ' ' '' ,:'` .` `.` :::::: :::: ::` `:::. '_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ ' P y r o E d i t 4 . 0 S p r i t e / M a p E d i t o r B y S c o t t G a r r e t t ____________________________________ | : |\ |Table of Contents : 1. About | | | _----_ _----_ : | | ||::--_ \./ _--::| : 2. Installation | | ||::--_``|``_--::| : | | ||::--_``|``_--:;| : 3. Usage | | ||::--_``|``_--::| : | | ||:.---_/ \_---.:| : 4. Troubleshoot | | |__________________:_________________|/ .-------. -:-_About_-:- `-------` The answer to your question is yes. Yes, what you see above you is definantly overkill, indeed, and you're probably thinking, "Sheesh, I had to change fonts on my text editor for that?" Ya think that's overkill, then keep reading. ;-) Oh, and the answer to your second question, that is a book and not what you probably think it is if you think it's anything else. ^_^ PyroEdit is a sprite and tilemap editor powered by xLIB and BASIC. Yeah. I said BASIC. * Ducks * PyroEdit lets you... well... I guess I kind of just gave that away already in the first sentence. So anyway... Have you ever tried drawing a picture or a spritesheet with TIOS' drawing tools? Sucks, doesn't it? You use the pen and it's like, "It's lookin' good, it's lookin' good," and then all of a sudden when you're trying to move over to another point on the screen and you don't hit the Enter key all the way and now you're like, "Aw, crap!" as you frown at the line desecrating your hard work. And making spritesheets in TIOS... oh, man. Good luck if you made a row or column of sprites too big or small. And tilemaps... maybe not as hard, but, yeah, those are another story, too. PyroEdit's job is to swoop in and read your mind and do everything for you, so all you have to do is sit back and chill... aah, that would be sweet; maybe it'll happen one day when people can plug USB cables into their heads or do WiFi, heh, but for now PyroEdit's job is to simply make your graphics-editing process easier with an array of tools such as splicing and moving around parts of a picture and flipping, rotation, fill, and copy, a graphical map editor, and your basic run-of-the-mill tools like the pixel editor, (erasible) pen, line and box drawing, text, etc. On top of all that, PyroEdit has modules you can install to extend it's features even more, and you can easily develop your own, so there's almost no limit to what you can use PyroEdit for. Oh, and did I mention that PyroEdit can do grayscale editing, too? Before you install, I guess it would be only fair for me to warn that PyroEdit is on the large side for a sprite/tilemap editor. The base--editor and all its subroutines--is 9.4k of archive. The suite is only ~11k (I kept the mod manager mod for convenience). If you want any other mods, look in the Extra Mods folder... but I don't think I really needed to tell you that, did I? So, if the program size is okay with you, still be warned that the editor is also broken up into almost 40 different subroutines. The reason it is split up into so many peices is because I wanted to make PyroEdit use as little RAM as possible whiile it is running so everything got split up and PyroEdit copies to RAM only whatever for whatever you're doing and then destroys them after you're done. With that in mind, this app-sized beast can run within as little as four of five kilobytes of RAM, giving you more room to work on big things, particularly tilemaps. I suggest you have at least five kilobytes of RAM to run PyroEdit. You may need more depending on what modules you're going to use. Now, if I haven't scared you off yet, onward to the Installation section. <<¡Nos vamanos!>> .--------------. -:-_Installation_-:- `--------------` Note that if you do not have the xLIB application installed, then you need to install it. You can get it here: http://www.ticalc.org/archives/files/fileinfo/359/35907.html After you send xLIB to your calc, enable it by going to APPS >> xLIB >> Press 1 to install >> Press 3 to exit. This part should be quick and painless. Simply send the group file for either TiLP or TI-Connect to your calc with the respect- ful linking software. If you use another linking program other than those two or you want to send to an emulator, then send the group built for TI-Connect to your calc. If you are using TI- Connect, make sure that you are sending everything to archive. You can also send everything in the subfolder where the group is to the calc if groups don't work for you or you need to replace something. After you've installed everything (and you've got xLIB installed and enabled), then run prgmAPYROEDT. You should see a loading screen and then come to the Main menu. If you've gotten this far, then you can now go onto... .-------. -:-_Usage_-:- `-------` PyroEdit's interface is mostly menu- and cursor-driven, so it'll be pretty easy to use and get used to. 2nd usually confirms something; MODE usually exits out of or aborts something (so if you're wondering how to back out of a menu and there's not a 'Return' item, which there usually never is, just hit MODE to go back). MAIN |- SPRITE - Sprite editor | |- VIEW - Preview the current pic you're editing full-screen. | |- OPEN - Open and/or instantiate a new pic. You always want to | | instantiate a new (blank) picture before editing it or | | else you might get some graphical weirdness when you | | try to edit it. Use the arrow keys when selecting a | | pic. | |- LAYER - When you're editing a grayscale pic, you can change | | the layer to edit here (black [0] or gray [1]). | |- PIXEL - The pixel editor. In the pixel editor, use the arrow | | keys to navigate or [8], [2], [4], and [6] to jump | | in 8px increments; 2nd toggles pixel on or off; Alpha | | changes the layer that's being edited if you're edit- | | ing a grayscale pic. Mode saves and returns to the | | menu. | |- PEN - Like the TIOS' pen tool, but erasible. When you go to | | it, select a point to start drawing at, Alpha to you | | need to change layers if you're editing a grayscale pic, | | 2nd, then start drawing. While drawing, use 2nd to turn | | the pen on and off and Alpha to change toggle draw or | | erase. Mode saves and returns to menu. | |- LINE/BOX - Line and box tool. First choose a point that will | | be where the topleft of the box or line will be | | (use Alpha if you need to change layers), 2nd, | | then choose the type of shape you want. After | | that, drag the shape to where you want it (you can | | still change layers at this point), then 2nd. | | Pressing Mode at any point here will abort. | |- COPY SPRITE - Makes a copy of a selection. First, choose a | | pic to copy from, 2nd, then use the arrow keys | | to navigate or [TRACE] and [VARS] to jump up and | | down in 4px increments, [8], [2], [4], and [6] | | keys to adjust the area to select and [(] and [.] | | to adjust the vertical selection in 4px incre- | | ments. Alpha changes layer. 2nd when you are | | done selecting area and then choose where you | | want to place the copy. Here, you can use the | | 0-3 keys to change the drawing logic used when | | placing the copy, [F] will horiz-flip the copy, | | Alpha will change layers, and 2nd will save and | | return to menu. Mode will abort ay any time. | |- TEXT - Insert text at a specified point. Choose a point to | | place the text at, 2nd, then enter the text you want | | to insert or a space to abort. Enter and select the | | style you want the text to be and 2nd. While select- | | ing style, you can Mode to abort, and while choosing | | a point, you can Alpha to change layer. | |- XLIB GEN - Generates real(1 code to display a selection in a | | program. Use the arrow keys to navigate or [TRACE] | | and [VARS] to jump up and down in 4px increments, | | [8], [2], [4], and [6] keys to adjust the area to | | select and [(] and [.] to adjust the vertical | | selection in 4px increments. Alpha changes layer. | | 2nd when you are done selecting area. | |- COPY PIC - Copies current pic to another pic. Choose the pic | | that the current pic will be copied to. *NOTE*: | | if you're copying a grayscale pic, two pics will | | get copied. The pic you select to copy to will | | be written to as well as the pic after it, so do | | make sure you want to overwrite the pic after the | | one you're copying too, should one exist, if you | | are copying a grayscale image. | |- MOD MANAGER - Mod manager mod. If you want to add a new mod | to PyroEdit, this mod makes it easy (normally | you have to edit a config prgm; this does all | that for you). If you want to add a module, | go to [Add] and enter the last part of the prgm | name of the mod (the part after the two thetas | and P, so it'll either be with E-someting [like | EHELP] or M-something [like MRPL]). To move, | delete or change a mod, select it and the thing | you want to do to it. |- MAP - Map editor | |- EDIT - Edit current tilemap. *Make sure you have CONFIGured | | a new tilemap first.* 2nd places a tile; Alpha pastes | | a tile (hit Alpha at the startpoint, select tile, and | | then select endpoint). | |- FILL - Fill the map with a tile. *Ditto on the make sure you | | config.* Simply select the tile to fill the map with. | |- TILE ID - Gets the tile ID of a tile. This is the number that | | would represent this tile in the map matrix. | |- XLIB GEN - Generate real(2 code to display current tilemap in | | a program. | |- CONFIG - Set up the tilemap and editor. You need to do this | | if you're creating a new map or you imported one from | | another matrix. | |- CLEAR - Clear a map (zero it out). You'll get two chances to | MODE out of this if you don't want to. After you say | yes to the confirmation, select the tile that |- CONFIG - Set up PyroEdit | |- CURSOR - Change cursor speed. Note that not all modules look | | at this setting. "Fast" is default. | |- BOOT - Change boot mode. If you choose "clean," then PyroEdit | | will clean up after each module loads up to save RAM | | and possibly prevent problems. "Dirty" will skip the | | clean-up and wait until everything finishes loading | | then clean-up. This will speed up PyroEdit's start-up, | | but will make boot-up eat more RAM and could cause | | some mods that have init scripts and don't clean-up | | themselves not load properly. "Clean" is default. | |- CONFIRM - Confirm saves. If you turn this off PyroEdit will | | always save and won't ask whether it's okay. | |- !ARC CFG - Archive config. If you turn this on, PyroEdit will | | archive your configuration of it upon exit. | |- CONTRAST - Changes the contrast of the screen. Helps with | | grayscale. | |- !RESET - Resets PyroEdit defaults. |- RELOAD - Restarts PyroEdit. |- Numbers at the bottom - Amount of RAM PyroEdit is using/Amount of RAM free. If you installed any extra modules, see their readmes for how to use them. Speaking of mods, if you want to install any modules, simply send it to your calculator and then add it with the Mod Manager. You can also add, remove, and move around modules manually without the Mod Manager. It's not very hard at all, you might prefer it to the Mod Manager (in which case you can get rid of it), and you might need to know how if a mod is for some reason causing problems that end up keeping you from running any other mods or keep PyroEdit from starting up. First, you unarchive prgmAPYRZCFG and then edit. This is the format for the config (and the lowercase 'e' means the E symbol you get when you hit the EE key *[2nd-Comma]*): "eee and so on. Example: "EMOD1eMMOD2eEMOD3eMMOD4e By "mod shortname," I mean the part in the mod's prgm name after the two thetas and "P," so mod shortnames will always start with either and E or an M depending on whether it's a sprite or a map tool. If you want any modules at all, then place "e in the config. A simpler way to disable modules, however, would be to turn it off in PyroEdit (CONFIG -> BOOT -> NO MODS). .--------------. -:-_Troubleshoot_-:- `--------------` ------------------------------------------------------------------- I get this when I start PyroEdit: INSTALL XLIB 1: QUIT - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Make sure the xLIB application is installed and enabled. ------------------------------------------------------------------- ------------------------------------------------------------------- PyroEdit begins to start up and then I get an UNDEFINED error. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - If this occurs while loading a mod, then PyroEdit is trying to load a mod that doesn't exist. Note the name of the mod it was trying to load and either send it to your calculator or if it is a mod you don't want, remove it manually from prgmAPYRZCFG. Also, if everything's correct in prgmAPYRZCFG, make sure that you installed all of the PyroEdit subroutines if you didn't install from the group files. ------------------------------------------------------------------- ------------------------------------------------------------------- When I move the cursor around in a new, blank pic, trails show up. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - The pic needs to be instantiated. Go to TOOLS -> OPEN -> Select the pic -> INSTANTIATE: YES. ------------------------------------------------------------------- If you find any bugs, or need help with something, drop a line at metalrandomist@googlemail.com or find the Demon/FMR/Insanity/Randomist's Project thread at Omnimaga, UnitedTI, Maxcoderz, Cemetech, RevSoft, or TICALCS. .---------. -:-_Credits_-:- `---------` xLIB Application: Patrick Prendergast Error Handler (ERRH): Benjamin Moody Program to String (PRGM2STR): Calcmaniac STR2PRGM: Brandon Wilson