TAPClean Fron End User Manual
Contents
1. 14 eni 9 T u E E 14 aes TERT 15 Toe Tabs arca clt act cad escetoerteadimitiss ind tende s dcinde E AS R ENEO 16 Riese M 16 AS TT A E A RD 16 IDOL dE EB iones psess unc Pencrvaituc ae UD EIcI SI NT IMEEI II CERE ITI CUM DSI bose I DNE CP NA IPPN EE 16 Save GUI E E RIE 18 EAC O O TTE 18 AA NS TOO TOT 19 BIA EEN O TANIE E S A ESA E T A E EE dawn tome te a wade EE E E 20 Convert screen COQdes eeessseseseenenee nennen hene rune ruens dnas ann nn nnn 20 by OPER 22 Salta ed ME AC aaa css sanc uuEs nde niente ERR NER SUSEROU EUNLEREUENROSERDUMI NEUE ERSE NEA 22 Auto comment asm COCE ccccecececeeeecececeecececeaeececuaeeeenenseaeeaeeaeeaeuaeeaeeneaaeanees 23 TAPClean Front End User Manual sje MRMTT 24 BIS WIR FOCI N CR acce saved mt P ETEPS ITI o EEn EUR OU CR TUER RES DEOR aM 24 e NEUEN 26 TO POOR TOIT Tm 26 BAS OM TCI ITI T T 27 CBM Pie PRS ANN oni coni varpedan uaa UE ENTE YRVITRX FORE IU FIURPEPES Fon TOFU FU IM KrHRK FU FX VEI EMEN IE 29 LESBIAN 31 SLAIN Ea e PANETE E E EE E E T E EE E 32 Redirect console command output to log window een 32 TAPClean Front End User Manual Installation TAPClean FE doesn t include an installer under OSes other than Windows For manual installation the contents of2. As with the interactive report a right mouse click over each file brings up a contextual menu used to jump to the beginning of the selected file in the graphical tape analysis tool The tool is capable of identifying the start of a CBM boot file and to mark it as a split point via the Analyze button Users can either manually mark split points in the first instance or use the results of the analysis as a starting point as suggested by the image below 29 Analysis completed X The autamatic analysis has completed and split points have been marked if appropriate You might now want to review them before proceeding with a split The details of the split are available in the System Log tab as per image below 2 TAPClean Front End User Manual Tools System Log Report le scanners 3 gt Uptions fo Prg Files Results of the split a Filename BAR Start 20 End 240838 Block len 240819 Filename CAM Start 240839 End 366690 Block len 125852 Filename OVE Start 366691 End 651444 Block len 284754 Filename SIT Start 651445 End 871671 Block len 220227 Filename SMA Start S771672 End 964367 Block len 92696 Filename SPA Start 964368 End 1124260 Block len 159893 Filename JET Start 1124261 End 1480583 Block len 356333 Filename PHA Start 1480594 End 1592645 Block len 112052 Filename INT Start 1592646 End 1710658 Block len
3. atlantis Atlantis a 1 audiogenic Audiogenic E 1 biturbo Biturbo 2 7l 4 hloan Rlaanlnarl DK L a Exclude all scanners but CBM ROM docb4 el select All A select Mone The list shown above is entirely read upon startup from the file scanners txt that s located in the folder from where TAPClean FE is executed i e the current working directory The only exception is about the CBM ROM one which built in and does not require inclusion in scanners txt Using the copy in the current working folder means that the application can be forced to read in and use a different subset of scanners e g a stripped down list of the available ones based on the current working directory Symbolic links can be created to obtain this result as well This list can be controlled directly by checking in or out any subset of the scanners excluding the built in CBM ROM one as shown in the example below where the TAPClean Front End User Manual Accolade EA Loader has been excluded 10 cB4 CBM ROM loader 1 108DEDA5 108DE0A5 accolade Accolade EA Loader aces Ace of Aces aliensy Alien Syndrome The reason for which a subset of scanners may require being excluded during the analysis is that they may trigger false recognitions File type mismatch is often the reason beyond an incomplete recognition or recognition with errors in TAPClean It should be noted that the order in which the scanners are used in TAPClean is relevant If an ar
4. 83079 164 15611 UNRECOGNIZED Select All Sena le Index 160 Pulses Bus Data pulses S3000 Kile lD FIRST Type descriptor Ch4 ROM TAPE DATA datatcheckbyte Use sane file to overwrite faulty file chain C7 Attempt a reconstruction of the damaged areafs only Tape Editor Tape Split CBM File Repair Tape Analysis As with the interactive report a right mouse click over each file of the faulty chain brings up a contextual menu used to jump to the beginning of the selected file in the graphical tape analysis tool 30 TAPClean Front End User Manual Tape Analysis A graphical tape analysis tool is provided in order to inspect tape image contents The pulse trace can be arranged vertically or horizontally Tools gt System Log 2 Report le Scanners Options fo Prg Files Layout S vertical E C horizontal Tape Editar Tape split CBM File Repair Tape Analysis A right mouse click over the trace brings up a contextual menu that can be used to take a Snapshot of the current view as per image below gj Save snapshot 31 TAPClean Front End User Manual System Log This is the last tabbed window available in the main window It tracks commands used to invoke TAPClean Tools System Log 4 Uptions fo Prg Files Report lt Scanners TAPClean Front End environment options TAPHOME D NC pd games Options loaded fr
5. FF1 prg PLA TAY 017 FEQO FFFF prg PLA 019 BB O SBFF prg ESI 020 5000 57 FF pra LEY 47 STA A5 T 032 DO ADO S3FFI LB prg STA Dni 035 73900 4046 TX prg CLC ADC AA O50 S00 GACC AF prg STA AA 041 7900 8400 AV prg MN j 044 USU0 0855 MU prg s LLL gt 047 BCOD BD75 PO rg Exclude CBM file header changes apply on reload O50 BEDO S2FD U1 pra Auto comment asm code changes apply on reload Fo The above list is populated after a Test Clean Filename 004 0390 0578 LABYRINTH prg The above example shows just a few of the interesting features available in DASM automatic labelling for branch points subroutines absolute jumps and tables generation of a cross reference for conditional branches subroutine calls and jumps Exclude CBM file header This option is particularly useful when disassembling a CBM header file that contains part of a turbo loader code When enabled DASM doesn t attempt to disassemble the file information at the start of the CBM header 22 TAPClean Front End User Manual 2 BASIC Hex view AS 033C cassette I O Buffer Header T0332 byte 01 49 00 F9 KCC 4c 41 42 959 52 T 34cC byte 20 620 20 20 20 PHA LOA 0C0s LOY 11 STY 0C0E EOR 02 LSR L SE ROR 45 LOA A9 BCC 4 BLS B0381 j u m 1 m is n Exclude CGM file header changes apply on relo
6. Overall Result FAIL Header test PASS 51g GE Ver GE 51z 0K Recognition test FAIL 731698 of 731913 bytes accounted for 99 Checksum test PASS 4 of 4 checksummed files OK Read test PASS 0 Errors Optimization test FAIL 0 of 619 files OK Plain File types Interactive An interactive report is also available when analysing or cleaning a tape image The tab Interactive at the bottom of the Report page is used to switch between the two different reports The interactive report provides a summary table generated by parsing the TAPClean report and a tape layout bar that shows which areas of the tape image have been recognized green recognized but with read errors and or failing checkbyte test yellow not recognized red and actually selected within the table blue 16 TAPClean Front End User Manual Report C3 Scanners Options lc Pry Files Tools J System Log 83 0356 4 PAUSE 84 0 10658 CB4 ROM TAPE DATA CEDU CEFD BCDFSESA Ok 85 0 5439 C64 ROM TAPE DATA CEDU CEFD BCDF3EBA OK 86 095 1 UNRECOGNIZED 87 03 4 PAUSE 88 1 4352 UNRECOGNIZED ag 0 4 PAUSE ES 0 4 PAUSE RSK 311789 CE4 ROMTAPE HEADER 033 3FB CC453219 Ok 92 U 55 4183 Cb4 RONETAPE HEADER 033C 3FB CCAS3218 Ok g3 099 1 UNRECOGNIZED 34 U fo 4 PAUSE 35 0 BBD Cb4 ROM TAPE DATA
7. 118013 Filename INF Start 1710659 End 1825870 Block len 115212 Filename GHO Start 1825871 End 2129796 Block len 303926 Filename SUB Start 2129797 End 2224891 Block len 95095 Filename ROC Start 2224892 End 2683146 Block len 458255 Filename PLA Start 2683147 End 2891793 Block len 208647 Filename BLA Start 2891794 End 3108207 Block len 216414 Filename DYN Start 3108208 End 331549 Block len 207290 Filename BOY Start 3315498 End 3591985 Block len 276488 Filename DER Start 3581986 End 3784633 Block len 192648 Filename SPA Start 3784634 End 396228 Block len 177654 Filename UNI Start 3962288 End 4118960 Block len 156673 Filename RAT Start 4118961 End 4289746 Block len 170786 Filename TAN Start 4289747 End 4488318 Block len 198572 Filename PAR Start 4488519 End 4669764 Block len 181446 lt l m nj amp Redirect console command output to log window 28 TAPClean Front End User Manual CBM File Repair An automatic CBM file repair tool is available to repair one of the two copies of a CBM file should one be faulty and the other one healthy In order to check whether the above scenario occurs for a TAP file the Analyze button can be used as shown below Tools System Log 2 Repor C scanners gt Options toj Prg Files Index 161 E Chal H OM TAD DATA File ID HEPEA
8. S FFI prg 259 OUUU SF 96 pry 350 A000 c9S50 prg 4 3 1800 4309 org 594 CADO CCF O prg BOS 08FC 17F0 prg 54a KUUU E 2201 prg a a gt The above list is populated after a Test Clean Filename 014 0001 0664 prg It should be noted that the set of CBM special characters is not rendered each of them is substituted with a dot This substitution looks fair enough considering that the BASIC listing is not produced to be automatically re tokenized by a BASIC interpreter either a native or a cross platform one Displaying foreign PRG files TAPClean FE is also capable of displaying the contents of PRG files that were not produced by TAPClean The Hex viewer DASM and the BASIC viewer allow doing so by means of a right mouse click on their text area When doing so a contextual menu pops up as per image below 24 TAPClean Front End User Manual A Load foreign PRG file IE Select All Input Methods p Insert Unicode Control Character The first option brings up a file selection dialog to select the PRG file to process 25 TAPClean Front End User Manual Tools Tape Editor At present the TAP file editor can be used to remove blocks from a TAP file which is particularly useful when an optimized tape contains small unrecognized areas that are not necessary This tool saves users from editing TAP files in a hex editor which has the added burden of having to fix the data size inside
9. the TAP file header 2 Report le Scanners gt Options Pra Files Tools System Log 2 Exclude Unrecognized n 3 811 CREATURES T E 1 UNRECOGNIZED B PAUSE 7 FALSE o 1 UNRECOGNIZED G 4 PAUSE 10 173079 CREATURES 11 1 UNRECOGNIZED PAUSE 42 UNRECOGNIZED 4 4 L O 2 D L U U D L E 14 4 PAUSE L 15 1 UNRECOGNIZED E 16 4 PAUSE 17 foes CREATURES L 2 18 1 UNRECOGNIZED Include All Files 1a A PANSE Tape Editor Tape split CRM File Repair Tape Analysis As with the interactive report a right mouse click over each file brings up a contextual menu used to jump to the beginning of the selected file in the graphical tape analysis tool 26 Tape Split An automated TAP file splitting tool is available to e g split compilations into single TAP files as per image below 2 Report e3 scanners 2 gt Options fo Prg Files LO c Cc Mm e t2 kh 10 Tape Editor Tape Split UNRECOGNIZED PAUSE Cb4 ROM TAPE HEADER Cb4 ROM TAPE HEADER PAUSE UNRECOGNIZED PAUSE Cb4 ROM TAPE DATA Cb4 ROM TAPE DATA PAUSE UNRECOGNIZED PAUSE Cb4 ROM TAPE HEADER Cb4 ROM TAPE HEADER PAUSE TAPClean Front End User Manual Tools h System Log W E man L ss ptt LI BAR LI BAR T E E L L E L CAN L CAN A Clear all IRIESEE P OGRI ZAM CBM File Repair Tape Analysis
10. 003 033C 03FB MAGICLAND DIZZY prg s000 OO O00 8A OO 4 01 FO 01 FO l FO l FO O1 FO l 004 U33C O3F Bj MAGICLAND DIZZY prg BOLO FO OF 70 l C OF CF l CF l cC l CF 01 C7 l O07 D29F D3BF prg 8020 CF 01 C7 01 CF 01 CF 01 CF O1 CF 01 CF 01 C7 D1 8030 44 02 BF 02 SF 02 SF 02 SF 02 SF 02 SF 02 ES 02 OWS OZ3F USBF prg S040 ES 02 5C 03 5C 03 5C 03 04 O4 7E 04 7E 04 7E 04 013 0801 0804 prg 8050 7E 04 7E 04 7E 04 93 04 93 O4 FB O4 4C OS AE Db 8060 2D 06 2D 06 20 O6 2D 06 E4 D amp 7C OF EB OF 93 O08 019 amp Gcn zF5b prg 8070 31 09 C5 09 42 DA OO OB AD OB AO OB AO OB AD OB S080 AQ OB 2F OC 88 OC 24 OD 24 OD 24 OD 37 OD 1C DE 122 UFAU 2E FA prg S090 BF OE 7E OF 19 10 08 11 BA 11 1A 12 B4 12 5F 13 217 4ABO 57FF prg SOA0 C6 13 75 14 24 15 F3 15 63 16 AB 16 30 17 82 17 OBO 61 18 61 18 3B 19 3B 19 3B 13 BF 13 BF 13 BF 13 amp c BF 19 BF 19 BF 13 BF 13 BF 139 BF 139 61 1A 28 16 360 ADDD CS80 prg 8000 B8 1B BS 1B BS 1B BS 1B BS 1B BS 1B BS 1B BS 1B 80E0 6E 1C 11 1D 11 1D 11 1D F 1D OA 1E OA 1E OA 1E 4 3 1800 4309 org SOFO DA 1E DA 1E DA 1E OA 1E OA 1E GA 1E OA 1E 34 1E 8100 AQ 68 44 BA AD 8 20 20 AS B4 28 52 BS AF AS 44 aad CADO CCFD pra 23110 D3 Be AS 21 3E AS 46 AS 4E AS Se AS 30 dC CD AE 605 OSFC 17 FO prg S120 68 60 24 43 A2 BO 42 02 AA BO Al 32 BO 3A BO 42 8130 BO 44 BD 52 BO SA BO 20 38 C8 A4 38 60 28 38 AD b45 FUDO F 220 pry 8140 48 46 CB
11. 2 Cb4 RON TAPE DATA B15 VISILOAD T1 Plain Interactive File types 18 Prg Files TAPClean Front End User Manual If PRG file generation is enabled the PRG files generated by TAPClean upon analyzing or cleaning a tape image will be available for content inspection here An example is given in the image below 2 Report C3 scanners aio Options Prg Files 003 033C 03FB MAGICLAND DIZZY prg 004 033C 03FB MAGICLAND DIZZY prg 007 D28F D3BF prg 008 D28F D3BF prg 013 0801 08CA prg 019 5C00 7F56 prg 122 DFAD 2F7 A pra 217 4ABD 57FF prg 258 S000 9F96 pra 350 ADDD CS80 prg 473 1800 43C9 prg 594 CADD CCFD prg BD5 O8FC 17F0 prg B48 FODD F220 prg The above list is populated after a Test Clean Tools System Log Hex Iew DASI 2 BASIC Convert screen codes changes apply on reload Filename After selecting a PRG file with a single left mouse click a right mouse click over the list of PRG files brings up a contextual menu as per image below View as Hex Vlew in UA hd sz View as BASIC listing 19 TAPClean Front End User Manual Hex View The Hex viewer comes handy when it is required to have a quick look at the contents of a file 2 Report C3 Scanners gt Options 27 Prg Files Tools System Log Filename Hex View DASM BASIC
12. 26 40 CC 20 28 C9 Ad 28 60 28 28 zC 28 4 n Convert screen codes changes apply on reload Filename 258 GOD D SrE as prg The above list is populated after a Test Clean Convert screen codes This option is useful when looking for strings within a file The text to be shown on screen in capital letters in a CBM computer does not use printable ASCII values Therefore it is not easy to spot this kind of text in a hex viewer The conversion forces some of the screen codes to become printable ASCII characters An example of the use of this feature is given by the following comparison 20 TAPClean Front End User Manual Without conversion With conversion Hex view DASM gt BASIC Hex View DASM BASIC n n B0 04 s5 07 90 EA C3 FF FO OF 29 D C P D G 5 5 E E FF FE FF FE FF FE FF FE FF FE FF B tt n mnm J 3 13 14 05 oO 20 14 08 12 05 Of 20 5 Y5TEM THREE 7 7 0112 05 20 10 12 Of 13 OS DE 14 SOFTWARE PRESENT E E 2E 2E ZE 7E ZE 2E 2E 2E 2E ZE 2E 5 5 2 i 5 E 20 OC 01 13 14 20 OF 09 DE Of 01 THE LAST HINJA E E E ZE 2E ZE 2E 2E 4 OS 13 039 OF DEZ TOG Z 2 19 20 OO OL 12 DB 20 03 D1 OC OS NED BY MARK CALE E E 2E ZE 2E 13 14 DF 12 19 OF OF OJ STOUR rBOA J 9 20 14 09 D 20 OF Of 13 14 2E 2E RD BY TIM BEST E E 2E 10 12 OF OF 12 01 OD DD OS 04 PROGRAMMED OF 08 DE 20 14 17 09 04 O4 19 2bE BY
13. 4 This would result in a checksum error condition in TAPClean that is concerned to check data integrity by actually verifying files against their checkbytes where available With Cyberload F3 a wrong checkbyte value of 04 should not be considered as an indicator of file corruption Therefore if this option is enabled then a wrong checksum value of 04 in Cyberload F3 files doesn t trigger a checksum error in TAPClean Raise cleaning tolerance If this option is enabled then the upper limit of the tolerance used to discriminate pulses during the cleaning process can grow far past the read tolerance value Add a trailing silence at the end of the file after cleaning If this option is enabled then a 5 second trailing silence is added at the end of the file after cleaning 11 TAPClean Front End User Manual Create PRG files If this option is enabled then file data is extracted to PRG files PRG files can then be inspected by means of other tools embedded in TAPClean FE and grouped in the tabbed area named Prg Files Connect neighboring PRG s into a single file If this option is enabled then a block of data that spans across multiple adjacent files is joined into a single PRG file Extract Visiload loader patching files If this option is enabled then Visiload loader patching files are decoded and their CRC value used to calculate the overall CRC of the data within the tape image Also PRG files are created out of them if PRG cre
14. I2CE 0303 ES553088E Plain Interactive File types Clicking inside the tape layout bar highlights the relevant row in the summary table The result of checkbyte tests to check the data integrity of those files that use some sort of content check and read tests to check the integrity of the encoding itself are available at the bottom of the report page The status images will be red if these tests fail green otherwise For TAP files only a right mouse click over each file brings up a contextual menu as per image below E Show in graphical tape analysis tool The Show in graphical tape analysis tool option is used to jump to the beginning of the selected file in the graphical tape analysis tool If the attached TAP file has not yet been parsed within the analysis tool then the user is prompted for confirmation as per image below Tape not parsed yet Would you like to parse it now Please be aware that this might take a moment or two depending on the size of the tape 17 TAPClean Front End User Manual Save summary The summary table can be exported to a HTML file by means of the provided button File types This additional tab offers a view of the file types occurring in the tape image as per image below Tools system Log J Report le scanners zo Options co Prg Files Type descriptor 24 UNRECOGNIZED 15 PAUSE 2 Cb4 RON TAPE HEADER
15. JOHN TWIDDY ZE 2E OF 12 01 10 08 0 OF 13 20 GRAPHICS oF n amp 20 12 03 OC OS 19 2bE 2E 2E BY HUGH RILEY OO 15 13 09 n3 20 OF 15 20 02 DE MUSIC BY BE OF 09s 13 08 20 26 20 01 OE 14 O8 N DAGLISH ANTH 05 05 13 2E 20 20 270 20 20 20 20 ONY LEES 20 20 20 20 20 20 20 20 20 20 20 i 20 20 20 20 20 20 270 20 20 20 20 i Convert screen codes changes apply on reload Convert screen codes changes apply on reload Filename D4 US00 00C4 prg Filename D4 US00 00C4 prg Comparative images to demonstrate the use of the screen code conversion 21 TAPClean Front End User Manual DASM DASM is a hassle free 6510 disassembler that does not require massive configuration or knowledge to be used The purpose of having a disassembler in TAPClean FE is to be able to quickly look at the ASM code used by commercial loaders and small files However it is not intended to be the ultimate disassembler for the 65 family of processors In fact it is meant to produce an ASM listing that may be quickly read and re assembled 2 Report le Scanners 3o Options soo Prg Files Tools System Log Filename Hex View DASM Az BASIC 003 D33C O3FB LABYRINTH prg BEQ 6 B LOA a3 02 ENE B 37A 007 D801 0880 pry ee a 008 0601 0860 prg B0370 LOA 7F STA LAS 011 EBDO ESFF prg a meee 015 EF LD F
16. SER can be fixed using its FIRST copy at index 160 Index 4355 Cb4 ROM TAPE DATA File ID FIRST Benair All can be fixed using its REPEAT copy at index 237 Repair Faulty CBM region count 2 Can be fixed 2 W t Region breakdown autaopopulated only review if you know what youre doing Tape Editor Tape split CBM File Repair Tape Analysis After the analysis has been carried out and optionally a review the Repair All button will repair those CBM files that can be fixed x Operation finished Check file repaired cassette 50 side 2 peepo 1 tap Advanced users can review the details of each faulty file and its healthy copy by expanding the Region breakdown control as per below 29 TAPClean Front End User Manual 2 Report le Scanners gt Options co Prg Files Index 161 CB BPOhld TAPE DATA File ID REPEAT ERARRRRRRRRARERAREERRRSERRSERARRRERRERRAR can be fixed using its FIRST copy at index 160 Index 235 Cb4 ROM TAPE DATA File ID FIRST can be fixed using its REPEAT copy at index 237 Repair Faulty CBM region count 2 Can be fixed 2 a Tools System Log Region breakdown autopopulated only review if you know what youre doing Currently showing faulty region Previous 1 of 2 Next Fix this region Faulty file chain File lD Type descriptor 161 64722 REPEAT Cb4 ROM TAPE DATA 152 1 UNRECOGNIZED 163 4 PAUSE Data
17. TAPClean Front End User Manual Introduction TAPClean Front End FE henceforth is a graphical environment for analyzing and handling the contents of tape images in TAP and DC2N DMP format It relies on the engine provided by TAPClean a console application derived from Final TAP console version whose source code is distributed under the terms of the GPL license TAPClean Front End is not just a front end program as its name suggests It incorporates unique features not found in TAPClean such as Interactive report of the tape contents with graphical breakdown Hex monitor Disassembler and CBM BASIC untokenizer for PRG files TAP editor TAP splitting tool TAP repair tool for CBM files Graphical TAP DMP analysis tool Please note that TAPClean FE is not distributed under the terms of the GPL license yet it is freeware TAPClean FE is C 2006 2012 Luigi Di Fraia All Rights Reserved This manual is C 2008 2012 Luigi Di Fraia No parts of it can be quoted without the author s written permission Final TAP is C 2001 2006 Stewart Wilson Subchrist Software Document ID Id index html v 1 38 2012 10 21 18 14 48 luigidifraia Exp TAPClean Front End User Manual Table of Contents wider evi RT E E A A AEE E AE AE A AE EA EE EEA EEE SE S 1 EEEa AA A E O 4 Ee cUn TOP NG A EE ee E E E E E E EU EAE 5 He JOOIDSE e E EE EEE A ERN DE IUE 6 OE e A 6 miS E ae ae amneieavwegiean gmemneuaenaasnan dieaemenmaaw suai deoresaeseusees
18. ad Auto comment asm code changes apply on reload Filename 004 D33C 03FB LABYRINTH prg As the above image shows clearly the CBM header area used for file type start end addresses and filename from 033C to 0350 is not disassembled at all when this option is enabled Auto comment asm code If this option is enabled then the source code is commented automatically Comments are available for VIC II registers at D000 DO2E VIC II mirror registers at D040 D3FF SID registers at D400 D41C SID mirror registers at D420 D7FF CIA 1 registers at DCO0 DCOF CIA 2 registers at DD00 DDOF Kernal Jump Table at FF81 FFF3 6510 Hardware Vectors at FFFA FFFF 23 TAPClean Front End User Manual BASIC The BASIC viewer is a fully CBM BASIC V2 compatible untokenizer that can be used to have a quick look at BASIC programs However it is not intended to be the ultimate BASIC untokenizer Report le Scanners S Options so Prg Files Tools System Log 003 033C 03FB MAGICLAND DIZZY prg O04 D33C 03FB MAGICLAND DIZZY prg 5L IFA UTHENF KE52 8 P U EkEB56 8 PUKE5T 250 PHEE5BS5 250 CLE 20 ASAtLIIFA 2 THENSYS32576 O07 D29F D3BF prg 22 IFA 3THENSyS4000 24 IFA LOTHEN4O DUS 029F U3BF prg 25 F RL2SITOA READA NEXTL 30 LOADA 8 1 40 SY56144 O19 ScU0 r F56 prg 100 DATA SCREEN TEXTCODE SPRITES ROOMOATA ROOMGRAPH CODE 122 DFAD 2F 7 A prg 217 AABU
19. ation is enabled Those Visiload patching files are used by the Visiload loader to modify its own code during the loading process They usually contain a few ASM instructions of no interest to the end user Make batch scan include subfolders If this option is enabled then the batch scan is performed recursively on subfolders Batch scan sorts report by CBM CRC values If this option is enabled then the batch scan report is sorted by CBM CRC values This feature has proven to be really useful to identify games that use the same file format In that case there s a good chance that the contents of the first CBM Data file are the same thus producing the same CRC value In fact it is common with commercial software on tape that the first CBM Data file contains the loader used to load the remainder of the files at a higher speed That s why these are often referred to as turbo loaders Make audio recorder use sine waves If this option is enabled then sine waves are used instead of square ones by the audio converter to sample the resulting audio file More on the audio converter later on Move files to their original folder after clean If this option is enabled then each cleaned file is moved to the folder where the source file is It should be noted that this option is not handed over to TAPClean but provided by TAPClean FE itself Also this option is only meaningful for releases of TAPClean older than 0 25 12 TAPClean Front End Us
20. can subfolders recursively if configured in the options see later It should be noted that up to version 0 24 the batch analysis was only available for TAP files in TAPClean Batch analysis of DC2N DMP files was introduced in version 0 25 As with Open Batch initially refers to the folder as specified by TAPHOME if defined Prior to discussing the function of the other toolbar buttons it is convenient to have a look at the various options that can be configured to perform a tape image analysis TAPClean Front End User Manual The Tabbed area part 1 This area comprises a number of tabs two of which are used to show the analysis report and the execution log These will be discussed in detail later on when we ll look at the analysis controls Scanners This tab contains a list of the file formats that are searched for and checked for integrity where possible within the opened tape image The component in TAPClean that looks for each format is referred to as scanner hence the reference here Repor e scanners Tools gt System Log z gt Options fo Prg Files fa jg 10 cB4 CBM ROM loader i 1 108DE04S 1080E0AS E 1 accolade Accolade EA Loader E 1 aces Ace of Aces U allensy Alien Syndrome altersw Alternative Software z 1 alterdk Alternative SW DK WA alterwg Alternative World Games E 0 amactian American Action S 1 anirog Anirog E 1 ashdave Ash Dave 7 ar Action Replay
21. ea of the tape image file has been acknowledged to use a certain format by mistake then under normal circumstances that area cannot be acknowledged again while looking for another file format Finally the order in which the scanners are used in TAPClean is not as shown in the above list The order is hardcoded in TAPClean and has been engineered based on experience In case of large tape images where the file formats in use are already known it may be worth selecting just those file formats to speed up the analysis process and avoid misrecognition as well The Select None button comes handy in those circumstances where users want to check out all of the scanners because just a few ones need to be selected Similarly the Select All button would check back in all of the scanners for usage An additional mechanism for scanner selection is based on their frequency of occurrence in commercial tapes Normalized frequency values have been selected based on field expertise Only those scanners whose frequency of occurrence is greater than or equal to the selected Frequency threshold are activated The Exclude all scanners but CBM ROM doc64 checkbox is used to override the settings for what concerns checked in and checked out scanners If this option is enabled then the only active file format searched for during the analysis is the CBM ROM one It is often convenient to activate this option where it s known that the only file format used
22. ecsan 6 f BOB Fe eje sa circ L RTT OO Tm 7 TTT tonsaaeeeeaneaeenace EE EEEE EEEE E 7 Suec TT TIR 10 Redd e r Te TTE 10 Allow detected files to OVErl ap ccccccccseseuseecceaeaucuseueceeavaueuseueueuavaueueeneueuavaveuevases 10 Only scan for the loader whose signature is found in CBM files 11 EOF markers are mandatory for CBM fil S ccccccseseusesecceavaueuseueeuvaveueuevavenenenvasas 11 Ignore Cyberload F3 bad checksum of ud eee 11 omg Car Soler E Lacs vrsentae EEEE Up MU NIB PIVMER VUES 11 Add a trailing silence at the end of the file after cleaning eee 11 Create CB TORINESE 12 Connect neighboring PRG s into a single file eee 12 Extract Visiload loader patching files eeeeennnmmm mmn 12 Make batch scan include subfolders eeeeeernnm Hmm 12 Batch scan sorts report by CBM CRC Values sees eee eee eenn 12 Make audio recorder use sine waves eeeeeenn mmm mener nnn nnns 12 Move files to their original folder after CllAN ccscscsscseeesecseceseeeeeeseeseeueeeseeeneeseanes 12 BEA 6 eI CODOS TOEHEIO o conus end cau OTI IIORIDERUR EXER ERI QUA UE RDUISULURUNC RD EB RD ERU I 13 Additional parameters eese nennen nemen nane ne nan n nn 13 PERCU NOTE 13 Te Te vdd INTO TETUER 14 j a 14 BE
23. er Manual TAPClean console location This is the folder where TAPClean is expected to be found It defaults to the folder from where TAPClean FE has been executed This also means that different versions of TAPClean can be used in conjunction with TAPClean FE simply by starting TAPClean FE from a different location or using this option to pick up the version of TAPClean the user wishes to work with Under normal operations it is advised to keep TAPClean and TAPClean FE in the same folder along with scanners txt It should also be noted that if TAPClean is not found then TAPClean FE will not complain Additional parameters This is a group of additional parameters silently passed to TAPClean The dropdown button provides a list of valid built in parameters As example VIC20 tapes can be analyzed by passing the 20 parameter to TAPClean Buttons The Defaults button is provided to restore default values The Fonts button allows selection of the fonts used in text areas of the application Finally the Save button saves current option values to the system folder for local application data falling back to the application folder if not possible 13 TAPClean Front End User Manual The Toolbar part 2 This paragraph covers the details of tape image analysis cleanup and conversion Test This button is used to perform the analysis of the tape image that has been previously opened Despite of the fact TAPClean can analyze m
24. iginal folder after cleaning them use with TAPClean 0 24 or older TAPClean console location 3tapcleanfe v Additional parameters v Read tolerance This is the value of the read tolerance used when pulses in a tape image are checked against the optimal values expected for each known format The default value of 10 should be sufficient for the main part of the tape images unless of course the quality of the tape image is not very good which would produce read errors during the analysis In the latter case the user may try to increase this value It is advised to check the quality of the tape dumping process if the default value doesn t apply to any of the tape images that have been made during the process Allow detected files to overlap This option should only be used when in the analysis report more on this later GAPs i e unrecognized areas appear where it is expected to find data files In fact what may happen is that due to a failure either at the medium level or with the tape dumping process a silence appears within a data file In TAPClean the position of silence points is identified in the very beginning of the analysis process Since files cannot overlap with other files or silence points that have already been recognized the original 10 TAPClean Front End User Manual data file in which the silence appears does not get recognized at all The user can allow detected files and silence points to overlap It s
25. in a tape is the CBM ROM one Also it may be useful to activate this option to make a quick scan of the selected tape image and let TAPClean guess which formats are expected to be therein This attempt is done by checking the CBM ROM files usually part of the boot sequence for known portions of code that uniquely identify a file format also referred to as signatures A right mouse click over the list of scanners brings up a contextual menu as per image below TAPClean Front End User Manual oF Manually add a scanner sj Save current list The first available option is Manually add a scanner which adds a row to the list of known scanners in edit mode 4 usgald U S Gold 3 virgin Virgin 4 wisi Visiload 3 wild Wildload At this point the user can enter the loader id lt loaderid gt passed as argument to TAPClean which is automatically prepended by do no to include exclude the new scanner when it is checked in out The frequency of occurrence along with a description can be provided for the new scanner as well The reason for which a new scanner can be defined is that support for that scanner may be added in TAPClean but not yet listed in TAPClean FE until the next update of the latter which comes with an up to date version of scanners txt In fact the latter is intended to be part of TAPClean at some point of its development Similarly the details of an existing scanner can be changed by clicking on the values fo
26. n the raw image properly Convert This button is used to convert the opened file into either TAP version 0 or 1 A drop down menu is used to select the output format as per image below BITE B SB Hm A amp le Open Batch Test Clean Convert Record 14 TAPClean Front End User Manual Record This button is used to convert the opened file into an audio file using either the AU or WAV format A drop down menu is used to select the output format as per image below S S amp amp e Open Batch Test Clean Convert Record E The use of those audio files is recording them to either a tape directly or to a CD and then possibly to tape to play them back on a real computer for which the contents are intended 15 TAPClean Front End User Manual The Tabbed area part 2 Back on this topic to illustrate the use of the Report Prg Files and System Log areas Report Plain This area shows the report generated by TAPClean upon analyzing or cleaning a tape image The report will look like the one provided below Tools system Log Report le Scanners zo Options fo Prg Files GENERAL INFO AND TEST RESULTS TAP Mame diMc d games sDizzy tap TAP 51ze 731933 bytes 714 kB TAP Version 1 Recognized 99 Data Files 619 Pauses 13 Gaps 2d Magic CRC32 D13D81C8 TAP Time 6 16 79 Boot abl e YES 1 part name MAGICLAND DIZZY Loader ID V1s1load T1
27. om C Documents and Settings Admnistrators Application Data ytapcleanfe user 1ni1 C iVPragram Files ytapcleanfe rel 20110921 gtk 2 16 xppro ytapclean doprg prgunite t D c TAPClean wO 2r pre 4 C 2006 11 TC Team Bu1ld Sep 20 2011 by ldf Based on Final TAP 2 76 Console Cj 2001 2006 Subchrist Software Read tolerance 10 Computer type C64 PAL 885248 Hz Loaded Dizzy tap Testing Scanning Pauses C64 ROM tape Loader ID Wisiload T1 isiload E gt Redirect console command output to log window It should be noted that this area is editable the user can add comments and remove content It may be handy to copy and save the contents of this area after the analysis of tape images Redirect console command output to log window If this option is enabled then the output from the TAPClean console program is redirected to the log window 32
28. ore than one tape image when executed thus preserving some information between each analysis it s not actually possible to do so by means of TAPClean FE The analysis refers to just one tape image in turn When the analysis is finished the tabbed areas Report Prg Files and System Log are updated with information about the analysis Clean This button is used to perform the analysis and cleaning of the tape image that has been previously opened Despite of the fact TAPClean can analyze and clean more than one tape image when executed thus preserving some information between each analysis it s not actually possible to do so by means of TAPClean FE Just one tape image in turn can be processed When the cleaning process is finished the tabbed areas Report Prg Files and System Log are updated with the relevant information Please note that the purpose of cleaning a tape image is not to save disk space Yes a cleaned file improves compression ratio but that s not the point Tape images are cleaned to restore their quality and remove noise The cleaning process often changes the total load time of a program because of the fact the image is completely remastered using average timings that are not recalculated on a per tape basis It is strongly advised to keep the raw tape image somewhere safe for future comparison Besides if it is proven that the cleaning process is buggy and gets fixed the user will later on be able to clea
29. r that scanner 3 turbo Turbotape 250 1 turr Turrican J S Gold 3 virgin virgin 4 wisi Visiload Finally it should be noted that the list of Known scanners can be alphabetically ordered by clicking on the attribute Loader Name This may come handy when renaming an existing scanner or adding a new scanner to the list When satisfied with the list of scanners the user can save it by using the context menu option Save current list The list gets created overwritten without confirmation in the folder from where TAPClean FE has been executed TAPClean Front End User Manual Options This tab contains the configurable options that are handed over to TAPClean to affect the type of analysis done and the results produced J Report e Scanners gi Options l Prg Files Tools system Log TAPClean specific Defaults Read tolerance 707007 a lt l Pat Allow detected files to overlap Debug mode Shaws Only scan for the loader whose signature is found in CBM files Faster scan EOF markers are mandatory for CBM files Ignore Cyberlaad F3 bad checksums of 04 Raise cleaning tolerance Add a trailing silence at the end of the file after cleaning Create PRG files Connect neighbouring PRG s inta a single file Extract Visiload loader patching files Make batch scan include subfolders Batch scan sorts report by CBM CRC values Make audio recorder use sine waves Move files to their or
30. revious wersion Added graphical tape analysis tool 25 Jun 2011 Changes since previous wersion Faster generation of listing in the Hex Viewer Files with problems are yellow inside the tape layout bar of the interactive report Added Tools tab for grouping tools like TAP file splitter 1 Feb 2011 Changes since previous wersion T aana Fe vos Ma LAP DMP file ar folder attached for operation or batch scan TAPClean Front End User Manual The Toolbar part 1 The toolbar area comprises 6 buttons 4 of which are initially disabled tom m E 3 s is bees sees Leer ae Y Open Batch Test Clean Convert Record nd Open This button is used to select a TAP or DC2N dump file to work with Upon selecting a file all of the toolbar buttons are enabled to start working with that file ARR RRR RRR RRR RRR B Bre e 9 Open Batch Test Clean Convert Record When no file has been selected yet the status bar looks as per image below No TAP DMP file ar folder attached for operation or batch scan x If a file is then selected the status bar keeps track of the filename Attached file Dizzy tap 00000000 By default when TAPClean FE is executed it looks for the environment variable TAPHOME If found the Open command initially refers to the folder as specified by TAPHOME Batch This button is used to perform a batch analysis of all of the tapes contained in a folder The analysis can s
31. the distribution archive need to be extracted in a location of the file system where the user has write permission In order to maximize user experience and ease of use TAPClean and TAPClean FE are distributed together in binary form for Windows 32 Debian Linux and Solaris 10 sparc x86 TAPClean FE requires the GTK 2 10 runtime installed Alternatively users can download the archive with the relevant runtime libraries bundled together For more information about GTK please consult the GTK Project homepage TAPClean Front End User Manual Executing TAPClean FE Upon starting TAPClean FE the main window is displayed ioj xi File Help um buch s Fai ER 3 g 4 Open Batch Test Clean Convert Record j Report F ED Fra Files C ccannars 2o Options Tools System Log TAPC ean Front End C1 2006 2012 Luigi D1 Fraia 26 Ape 2012 Changes since previous version Official inclusion of the CBM file repair tool Scanners can now be selected on a frequency basis Dd Feb 2012 Changes since previous wersion Beta testing version of the CBM file repair tool 29 Oct 2011 Changes since prewious wersion Officially added preview of the CBM file repair tool 21 Sep 2011 Changes since previous version Summary table of the interactive report can be saved to HTML Option to decode VWisiloader patching files can be set also when PRGs are not created 13 Aug 2011 Changes since p
32. usually a question of unexpected silence points within other files and not file overlap in the sense the word overlap could suggest The results may get messy in case of misrecognition when allowing file overlap one area of the tape image can be recognized to use more than one format thus resulting in unexisting data files It is for this reason that a tape image cannot be cleaned while file overlap is enabled Only scan for the loader whose signature is found in CBM files If this option is enabled then the set of running scanners is reduced to the one including its variants whose signature is found in the CBM files at the beginning of the tape image Of course if this option is enabled and a known signature is found in the CBM files then the analysis process may be a lot faster The drawback occurs when the tape image also contains additional files using a format that is not the one whose signature has been found these files will not be recognized thus producing GAPs EOF markers are mandatory for CBM files Even if uncommon some CBM files lack the end of file markers What happens is that those files will not get recognized during the analysis Disabling this option will improve the detection percentage of CBM files that lack those markers for they will be acknowledged during the analysis Ignore Cyberload F3 bad checksum of 04 It has been discovered that sometimes Cyberload F3 files come with a wrong checkbyte whose value is 0
Download Pdf Manuals
Related Search