Search the Community
Showing results for tags 'toolkit'.
-
In the 80's I wrote many tools to manage binary files, in order analyze them (see the XEX file structure), join them (insert a splash screen), remove portions from them (remove a slash screen), split them, reallocate them (load in another address), squeeze them (extracts runs of zeros to reduce file size), refill (removes headings and puts heart bytes, usefull for Mac65 assembies), change the loading sequence of the chunks, remove headers and get just a block of data (or picture to edit), etc. Those mini tools were all written in Atari BASIC and a set of USR routines to perform "fast I/O" (the same as BGET and BPUT from TBXL). During the recent years, I've been writing some simple scripts to perform some of those things directly from my PC, just to manage XEX file quickly in the same way I did before, but without having to setup an ATR and loading my tools in an emulator. Some days ago, I decided to merge all those tools in a single one, and XEX Filter toolkit was born. "xex-filter.pl" is a small script written in perl language, and runs on any machine with the perl interpreter installed (no special modules are required). It might be a linux box (perl is native there), Windows (with Strawberry Perl or ActivePerl) or Mac. It don't have a GUI, it just works in the command line, and there are many options to combine and apply one or more actions to a file or set of them and get a new one. Running it without parameters shows the following help: xex-filter version 1.5 (2020-01-11) Copyright (c) 2020 by Victor Parada <https://www.vitoco.cl/atari/> Usage: xex-filter.pl [-option ...] [--] FILE1.XEX [FILE2.XEX ...] Options: -c c1,c2-c3,... Chunks list to select in process -s a1,a2-a3,... List of addresses where to split chunks -e a1,a2-a3,... List of memory addresses for data extraction -a a1,a2-a3,... New address list to assign to output chunks -z max Max number of bytes to fill between chunks -r Removes zeros if there are more than 4 in a row -d Writes data without address pointers or header -b Reads input as a single chunk of data at address $0000 -f Fix corrupt files by filling or discarding data -m Makes a memory map with the selected chunks -o NEW.XEX Output file (mandatory for -c -s -e -a -z -r -d and -m) Addresses between 0 and 65535 or in $hhhh format. Use "-" for a range. The most simple usage is just giving it a path to an XEX file, and it will display the file structure. For example, running without parameters over Alley Cat (downloaded from Atarimania) it gives the following report: C:\Atari\XEX-Filter>xex-filter.pl "Alley Cat.xex" Analyzing "Alley Cat.xex"... -: 65535 [$FFFF] (binhead) 1: 708-712 [$02C4-$02C8] (5) PROG/DATA -: 65535 [$FFFF] (binhead) 2: 48724-48920 [$BE54-$BF18] (197) PROG/DATA 3: 48925-48930 [$BF1D-$BF22] (6) PROG/DATA 4: 48938-48967 [$BF2A-$BF47] (30) PROG/DATA 5: 48974-49151 [$BF4E-$BFFF] (178) PROG/DATA 6: 560-561 [$0230-$0231] (2) -> 48724 [$BE54] 7: 708-712 [$02C4-$02C8] (5) PROG/DATA 8: 1024-1097 [$0400-$0449] (74) PROG/DATA 9: 736-737 [$02E0-$02E1] (2) -> 1024 [$0400] 10: 7936-9048 [$1F00-$2358] (1113) PROG/DATA 11: 9053-9056 [$235D-$2360] (4) PROG/DATA 12: 9061-9064 [$2365-$2368] (4) PROG/DATA 13: 9069-9159 [$236D-$23C7] (91) PROG/DATA ... (deleted) 46: 22122-22534 [$566A-$5806] (413) PROG/DATA 47: 22539-24320 [$580B-$5F00] (1782) PROG/DATA 48: 24320-24408 [$5F00-$5F58] (89) PROG/DATA 49: 24416-24471 [$5F60-$5F97] (56) PROG/DATA ... (deleted) 151: 40319-40320 [$9D7F-$9D80] (2) -> 1 [$0001] 152: 40327-40328 [$9D87-$9D88] (2) -> 60 [$003C] 153: 40337-40349 [$9D91-$9D9D] (13) PROG/DATA 154: 40512-40513 [$9E40-$9E41] (2) -> 255 [$00FF] 155: 40526-40530 [$9E4E-$9E52] (5) PROG/DATA Clearly it was squeezed (zeros were removed), so we can restore them adding up to 128 zero bytes between chunks: C:\Atari\XEX-Filter>xex-filter.pl -o ALLEYCAT.XEX -z 128 "Alley Cat.xex" Analyzing "Alley Cat.xex"... ... (same info than before removed) Writing "ALLEYCAT.XEX"... -: 65535 [$FFFF] (binhead) 1: 708-712 [$02C4-$02C8] (5) 2: 48724-49151 [$BE54-$BFFF] (428) 3: 560-561 [$0230-$0231] (2) 4: 708-712 [$02C4-$02C8] (5) 5: 1024-1097 [$0400-$0449] (74) 6: 736-737 [$02E0-$02E1] (2) 7: 7936-24320 [$1F00-$5F00] (16385) 8: 24320-40349 [$5F00-$9D9D] (16030) 9: 40512-40530 [$9E40-$9E52] (19) 32988 bytes written Adding more than 128 bytes would also fill OS data between the splash display list pointers at address 560 and the color registers at 708-712, but some more zeros were required to fill the gap between address 40349 ($9D9D) and 40512 ($9E40), that can be also added with this tool if the splash screen is removed before and added again after the fill, with thi commands (output info omitted): C:\Atari\XEX-Filter>xex-filter.pl -o ALLEYCAT-splash.XEX -c 1-6 ALLEYCAT.XEX ... C:\Atari\XEX-Filter>xex-filter.pl -o ALLEYCAT-game.XEX -c 7-9 ALLEYCAT.XEX ... C:\Atari\XEX-Filter>xex-filter.pl -o ALLEYCAT-game-filled.XEX -z 1000 ALLEYCAT-game.XEX ... C:\Atari\XEX-Filter>xex-filter.pl -o ALLEYCAT-new.XEX ALLEYCAT-splash.XEX ALLEYCAT-game-filled.XEX ... What it is strange is that there are 2 chunks that overlaps at memory address 24320 ($5F00), and it could also be analyzed with this tool by splitting the file at that byte and running it to display the resulting XEX structure: C:\Atari\XEX-Filter>xex-filter.pl -o ALLEYCAT-split.XEX -s $5F00-$5F00 ALLEYCAT-new.XEX ... C:\Atari\XEX-Filter>xex-filter.pl ALLEYCAT-split.XEX Analyzing "ALLEYCAT-split.XEX"... -: 65535 [$FFFF] (binhead) 1: 708-712 [$02C4-$02C8] (5) PROG/DATA 2: 48724-49151 [$BE54-$BFFF] (428) PROG/DATA 3: 560-561 [$0230-$0231] (2) -> 48724 [$BE54] 4: 708-712 [$02C4-$02C8] (5) PROG/DATA 5: 1024-1097 [$0400-$0449] (74) PROG/DATA 6: 736-737 [$02E0-$02E1] (2) -> 1024 [$0400] 7: 7936-24319 [$1F00-$5EFF] (16384) PROG/DATA 8: 24320-24320 [$5F00-$5F00] (1) $00 "00000000" 9: 24320-24320 [$5F00-$5F00] (1) $10 "00010000" 10: 24321-40530 [$5F01-$9E52] (16210) PROG/DATA Hum!!! Looking at chunks number 8 and 9, we can see two different values for the same memory location. A bug from the packager? As it normally loads sequentially, we can remove the first one at chunk 8 and merge chuncks 7, 9 and 10, and also move the startup routine and RUNAD pointer to the end of the file, all this steps in one command: C:\Atari\XEX-Filter>xex-filter.pl -o ALLEYCAT-final.XEX -z 0 -c 1-4,7,9-10,5-6 ALLEYCAT-split.XEX Analyzing "ALLEYCAT-split.XEX"... -: 65535 [$FFFF] (binhead) 1: 708-712 [$02C4-$02C8] (5) PROG/DATA 2: 48724-49151 [$BE54-$BFFF] (428) PROG/DATA 3: 560-561 [$0230-$0231] (2) -> 48724 [$BE54] 4: 708-712 [$02C4-$02C8] (5) PROG/DATA 5: 1024-1097 [$0400-$0449] (74) PROG/DATA 6: 736-737 [$02E0-$02E1] (2) -> 1024 [$0400] 7: 7936-24319 [$1F00-$5EFF] (16384) PROG/DATA 8: 24320-24320 [$5F00-$5F00] (1) $00 "00000000" 9: 24320-24320 [$5F00-$5F00] (1) $10 "00010000" 10: 24321-40530 [$5F01-$9E52] (16210) PROG/DATA Writing "ALLEYCAT-final.XEX"... -: 65535 [$FFFF] (binhead) 1: 708-712 [$02C4-$02C8] (5) 2: 48724-49151 [$BE54-$BFFF] (428) 3: 560-561 [$0230-$0231] (2) 4: 708-712 [$02C4-$02C8] (5) 5: 7936-40530 [$1F00-$9E52] (32595) 6: 1024-1097 [$0400-$0449] (74) 7: 736-737 [$02E0-$02E1] (2) 33141 bytes written There are many more tricks that could be done with this tool, and I've attached it here to share it with the community. Depending on the machine where this script will run, it might be needed to change the first line to any of the following lines: #!/usr/bin/perl #!/bin/perl #!/usr/local/bin/perl #!/usr/sbin/perl Bug reports, feature suggestions and any kind of comments are welcome! Have fun! ++vitoco xex-filter.pl
- 28 replies
-
- 21
-
Hi together, Kyan Pascal is the best Pascal for Atari ever. We have achieved much progress in restoring the complete developer environment, please see the actual list below. We are still searching for the Toolkit I and II manuals. So, if there is anyone out there in the galaxy, please help us. It is the same with the six million dollar man: Ladies and Gentlemen, we have the capability to rebuild him (here Kyan Pascal), to make Pascal for Atari stronger, faster and better… So, Atari first of the 8 bits… Thank you all so much in advance. P. S. If there is someone in the possession of these manuals, you can send them to me, I OCR them and send you back the manuals. All postage goes to my bill. Already in the can: KIX for the Apple II-Owner's Manual.pdf Kyan Pascal PLUS for the Apple II-Users Manual.pdf Toolkit I.pdf Toolkit II.pdf Toolkit III.pdf and software Toolkit IV.pdf Toolkit V.pdf Update Kyan.pdf Disk Magic.atr Disk Wizard II.atr DOS 2.5 MD.atr Eddy.atr Kyan Pascal (Norwegen).atr Kyan Pascal Kopie.atr Kyan Pascal-original defekt.atr Kyan Pascal.atr Kyan Pascal(defektes_atr)_fix.atr Kyan_Pascal_DOS_2.5_MD_(restored).atr Sherlock V.2.atr Toolkit III.atr Bobs Sector Editor.xex Boot Utility Pack 1.3.xex SHERLOCK V.2.xex DOS 2.0 Modification for special purposes.rtf Kyan Pascal v2.0.rtf Bildschirmfoto 2016-06-18 um 22.41.26.jpg Bildschirmfoto 2016-06-18 um 22.44.14.jpg Bildschirmfoto 2016-06-19 um 21.09.19.jpg Defektes ATR.jpg DIR.jpg editor_1.jpg editor_2.jpg File_A2_OUT_2.jpg File_A2_OUT.jpg Sektor 3B6.jpg Sektor 3C9.jpg Sektor 3CA DUMP.jpg Sektor 373.jpg Apple kyanpas.HDV Apple II stuff Barcardi Kyan_Pascal_Manual_page_01.jpg Kyan_Pascal_Manual_page_02.jpg Kyan_Pascal_Manual_page_03.jpg Kyan_Pascal_Manual_page_04.jpg Kyan_Pascal_Manual_page_05.jpg Kyan_Pascal_Manual_page_06.jpg Kyan_Pascal_Manual_page_07.jpg Kyan_Pascal_Manual_page_08.jpg Kyan_Pascal_Manual_page_09.jpg Holmes Archiv Kyan Pascal 1.1.atr Kyan Pascal A.atr Kyan Pascal B.atr Kyan Pascal - Advanced Graphics Toolkit kyan_toolkit_iii_d7_2.jpg kyan_toolkit_iii_d7.jpg Kyan_Pascal_2.02_(1986) Kyan_Pascal_2.02_(1986)_side_1.atr Kyan_Pascal_2.02_(1986)_side_2.atr Kyan Pascal v2.0.rtf Kyan Pascal Disk 2.02.jpg Kyan_Pascal_2.02.jpg Re- Kyan Pascal-comp.sys.app.textClipping example.tif PASCAL-V2-Cover-Clear.tif Kyan_Pascal_2.02_(1986).zip KYANDSK Neuer Ordner 14 Kyan Pascal(defektes_atr)_fix.atr Toolkit 1-System Utilities Toolkit 2-Mouse Text Toolkit 3-Advanced Graphics Toolkit 4-Turtle Graphics Toolkit 5-Mouse Graphics Toolkit 6-Code Optimizer Toolkit 7-Font Utilities KIX.txt ReadMeKix.txt 2. Kyan Pascal--- -Product.textClipping KYAN PASCAL ADVANC
-
Does anyone here happen to have either the 3.5 inch disk that came with the 1581 and or 1581 toolkit? I picked up a working drive for a song ($5 at goodwill!) but the only disks that they had were blanks. help?