home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / FM-EXT20.ZIP / FM-EXT20.DOC < prev    next >
Text File  |  1995-09-20  |  13KB  |  316 lines
  1.                      ╓┬┬───────────────────────────┬┬╖
  2.                      ║∙│ Fast Module Extractor 2.0 │∙║
  3.                      ╙┴┴───────────────────────────┴┴╜
  4.  
  5.       Fast Module Extractor is a program that extracts digital music 
  6.       modules and graphics out of demo's, intro's, etc.
  7.       This program is freeware and may be freely copied. So spread this!
  8.  
  9.     ┌ Fast Module Extractor offers you: ┐
  10.     └───────────────────────────────────┘
  11.       ■ supports wildcards at the commandline
  12.       ■ supports the following module formats:
  13.            * 669 ComposD and UNIS669 Modules (669)
  14.            * 0..32 Channel Fast/TakeTracker Modules (MOD)
  15.            * FastTracker 2.0 Extended Modules 
  16.            * ScreamTracker 2.x Modules (STM) ...buggy...
  17.            * ScreamTracker 3.0 Modules (S3M)
  18.            * MultiTracker Modules (MTM)
  19.            * AMF (DMP Only Modules)°
  20.            * Farandole Composer Modules (FAR)°
  21.            * UltraTracker Modules (ULT)°
  22.            * DigiTrakker Modules (MDL)
  23.            * PolyTracker v2.03 Modules (PTM)
  24.            * Delusion Modules (DMF)°
  25.            * SB Studio II (PAC)
  26.            * MIDI Files (MID)
  27.       ■ supports the following graphics formats:
  28.            * LBM format
  29.            * BMP format
  30.            * FLI format (AutoDesk Animator 320x200)
  31.            * FLC format (AutoDesk Animator Pro SVGA)
  32.       ■ SPEED! It is faster than any other module extractor I know
  33.       ■ detection of the following graphics formats
  34.            * GIF format
  35.            * JPG format
  36.       ■ Extraction of Windows Wave files
  37.       ■ Partial copy mode
  38.       ■ Custom header searching
  39.  
  40.       ° size of this formats is not calculated
  41.     
  42.     ┌ Usage: ┐
  43.     └────────┘
  44.       FM-EXT <filename> <options> 
  45.       
  46.       You can use only one option at once! 
  47.       options:  X                 Enables extended searching
  48.                 #<begin> <end>    Enables partial copy mode
  49.                                   (No wildcards supported in this mode)
  50.                 !<ABCD> <offset>  Enables custom header searching
  51.                                   (wildcards enabled)
  52.  
  53.       The first parameter 'filename' can contain path AND wildcards.
  54.       To scan the current directory enter this:
  55.       
  56.       FM-EXT *.*
  57.  
  58.     ┌ Extended support: ┐
  59.     └───────────────────┘
  60.       The option 'X' turns on and off extended support. This means
  61.       that with support on the program also searches for BMPs, 669s,
  62.       FLI, FLC.
  63.       No second parameter means support off (this is the default).
  64.  
  65.     ┌ Partial copy mode: ┐
  66.     └────────────────────┘
  67.       The partial copy mode is started when de second parameter begins
  68.       with '#' this must be followed by a number, indicating the
  69.       beginning position of the part that must be copied. This
  70.       number can be decimal but also hexadecimal! A hexadecimal number
  71.       requires a '$' and than the number (e.g. #$FF).
  72.       The third parameter gives the ending position. The '#' sign
  73.       isn't needed for this parameter.
  74.       So if you want to copy from position $FF to 40030 you enter this:
  75.       
  76.       FM-EXT filename #$FF 40030 or
  77.       FM-EXT filename #255 $9C5E or
  78.       FM-EXT filename #255 40030
  79.       
  80.       If you want to copy from a specific position to the end of file 
  81.       you can enter:
  82.       
  83.       FM-EXT filename #500 end
  84.                                
  85.     ┌ Custom header searching: ┐
  86.     └──────────────────────────┘
  87.       The program will search for 1..80 chars behind the ! sign.
  88.       You are notified if the header is found. You can then choose to
  89.       save the file. The save-routine uses the optional offset parameter
  90.       to seek -BACK-. For hexadecimal input, the first character must be
  91.       $ sign (e.g. $F5).
  92.       So when searching at 'MZ' (beginning of an .EXE-file) you enter:
  93.       
  94.       FM-EXT filename !MZ
  95.       FM-EXT filename !MZ 15    (seeks 15 bytes back before saving)
  96.       FM-EXT filename !MZ $F    (seeks 15 bytes back before saving)
  97.       
  98.     ┌ Blinking dot: ┐
  99.     └───────────────┘
  100.       Sometimes the program waits and there is blinking red dot on
  101.       the screen. This means that you must press a key to continue.
  102.       
  103.     ┌ Stop scanning: ┐
  104.     └────────────────┘
  105.       If you press [Esc] the program returns to the operating system.
  106.       
  107.     ┌ Time measurement: ┐
  108.     └───────────────────┘
  109.       The time measurement works only when scanning through a file.
  110.       So it doesn't count the pauses caused by waiting for user input.
  111.       The kb/s meter gives a value for the scanning speed, it is not affected
  112.       by pauses.
  113.       
  114.       
  115.           ───────────────════════  !Warning!  ════════──────────────
  116.       
  117.       The author of this program is not responsible for any damage to your
  118.       demo's or other files.
  119.       
  120.     ┌ Frequently asked questions: ┐
  121.     └─────────────────────────────┘
  122.       Q: Sometimes I see that the program found a soundfile, it asks
  123.          to save it, but it doesn't save it?
  124.       A: The program checks the size of the soundfile. If this size is
  125.          negative or greater than the filesize it aborts the saving process.
  126.  
  127.       Q: The program says that it has found a GIF/JPG header but it
  128.          won't save the picture.
  129.       A: Currently, the program can only detect this graphics format
  130.          and not save it.
  131.       
  132.       Q: The program has saved an AMF file of 100k but when playing it
  133.          with DMP its memory usage is only 60k.
  134.       A: When the program detects an AMF file it will save the information
  135.          from the header to the end of the demofile. Because I don't know
  136.          exactly how the AMF format is build up.
  137.       
  138.       Q: Why do you also spread the source of this program?
  139.       A: Well, I am a bit idealistic... Everyone should spread their
  140.          sources, because a novice programmer can learn from them. 
  141.          This will encourage the programmers to produce even better
  142.          programs. 
  143.          There are lot of people that have the capabilities to program,
  144.          let's say nice demo-effects, but they don't know how. It's great
  145.          that you then could use another ones sources!
  146.          Please...don't recompile this and spread it like it was yours!
  147.                             !! DON'T BE A LAMER !!
  148.  
  149.     ┌ Hints: ┐
  150.     └────────┘
  151.       1. Use Fast Module Extractor on your existing module collection.
  152.          Sometimes this will save diskspace because other module extractors
  153.          don't calculate the length out of the module (FM-EXT does!) but 
  154.          copy until the end of the file is reached.
  155.       2. DON'T spread the extracted files but use them for personal
  156.          purposes only.
  157.       3. First extract the demo or intro by using UNPACK or X-OPEN.
  158.          
  159.     ┌ Recognized Headers: ┐
  160.     └─────────────────────┘
  161.       ┌────┬────┬────┬────┬────┬────┬────┬────┬────┐
  162.       │M.K.│M!K!│FLT4│FLT8│OCTA│xCHN│xxCH│DDMF│PACG│
  163.       ├────┼────┼────┼────┼────┼────┼────┼────┼────┤
  164.       │SCRM│eam!│2STM│ePro│MThd│GIF8│JFIF│DMDL│    │
  165.       ├────┼────┼────┼────┼────┼────┼────┼────┼────┤
  166.       │FORM│WAVE│FAR■│Exte│ MTM│  BM│  if│PTMF│    │
  167.       └────┴────┴────┴────┴────┴────┴────┴────┴────┘
  168.  
  169.     ┌ History of Fast Module Extractor: ┐
  170.     └───────────────────────────────────┘
  171.  
  172.       Version 1.0:
  173.       First public release.
  174.  
  175.       Version 1.1:
  176.       * Wildcard support added.
  177.       * 669 support added.
  178.       
  179.       Version 1.2:
  180.       * Fixed a bug in the detection of modules.
  181.       * Fixed a bug in the calculation part (OOPS... the program read
  182.         30 instead of 31 samples).
  183.       * Added 6 and 8 channel FastTracker module support.
  184.  
  185.       Version 1.3:
  186.       * Added ScreamTracker 3.0 support
  187.  
  188.       Version 1.4:
  189.       * Added switch for 669 support
  190.       * Speeded up last-bytes save
  191.  
  192.       Version 1.5:
  193.       * Added MTM support
  194.       * Added GIF and LBM detection
  195.       * Added 16 and 32 Channel Fast/TakeTracker support
  196.       * Easier commandline usage!
  197.       * Better interface
  198.       
  199.       Version 1.6:
  200.       * Completely rearranged source code
  201.       * Optimized code for speed, result: about 5 times faster!
  202.       * Some cosmetic changes
  203.       * Added LBM support
  204.       * Added AMF support
  205.       * Added BMP support
  206.       * Added STM detection
  207.       
  208.       Version 1.7
  209.       * Fixed the problems with ReadOnly files
  210.         Actually the ReadOnly attribute is first removed and then replaced
  211.       * Commented the source a little bit
  212.       * Better structured code now
  213.       * Less keypresses are required!
  214.       * Made an exitprocedure/scanning interrupt
  215.       * Changed the Fast/TakeTracker searching. Now search for all number
  216.         of channels (0..32 Channels are possible)
  217.       * Added FAR support
  218.       * Added STM extraction
  219.       * Added JPG detection
  220.       * Added MidiFile detection.
  221.       * Partial Copy mode added, with support for Hex and Decimal numbers
  222.  
  223.       Version 1.7a
  224.       * Fixed an error in the MTM detection (Thanks PoZoR!)
  225.       
  226.       Version 1.8
  227.       * Fixed the bug that causes runtime-error 100 in wildcard mode
  228.       * Fixed a bug in the 669 calculation
  229.       * Compiled with a new bugfixed/optimized TURBO.TPL 
  230.         (C) 1994 Norbert Ruffa (BPL70N15.ZIP)
  231.       * Added ULT support
  232.       * Speeded up scanning of small (<31kb) files
  233.       * Added time and kb/sec calculation (On my computer I get 300 kb/s!)
  234.       * Decreased false alerts by checking out the title for garbage
  235.       * Added MIDI File extraction
  236.       * Included the unit FMANAGE.PAS (C) Eyal Doron
  237.         The program now warns you for overwriting files and
  238.         you can enter only valid filenames
  239.  
  240.       Version 1.9
  241.       * Changed the colorscheme to the 'houze style' of TWC
  242.       * Installed a funny font! (And found a HUGE bug in TP7/TURBO.TPL)
  243.       * Added Easy Font Changer
  244.         A program I wrote to do easy font viewing. It will not be
  245.         supported, but maybe it's usefull for someone.
  246.         Also added 4 fonts to test the program (You can ask me for more)
  247.       * Removed the corrupted module extraction, because 99% of that
  248.         corrupted modules aren't playable
  249.       * Solved problems with MIDI Files
  250.       * Corrected .LBM calculation
  251.       * Added leading zero's for time calculation
  252.       * Fixed a AMF detection bug
  253.       * Added new STM header (SWavePro)
  254.       * Added Custom Header Search
  255.       * Added Windows Wave file detection
  256.       * Reduced number of global variables and done some code enhancements
  257.       * Removed interrupting key
  258.       * Added detection of EXE-Compressors
  259.       * All text is now written directly to the video-memory! (ASM)
  260.         Displaying is now 75% faster!
  261.       * Added cool soft-scrolling end!
  262.       * Finally... faster saving
  263.       * Added assembly code that replaces some CRT unit routines
  264.       * Added AutoDesk .FLC .FLI support 
  265.         (Now you can see who create fake real-time animations!)
  266.       * Rewritten the Search-Engine in assembly, searching is now even faster
  267.  
  268.       Version 1.9Ω
  269.       * I don't want to release this version as 2.0...so it's 1.9Ω
  270.       * Removed titlechecking, because some correct files fail on that check 
  271.         Sorry...Increased false alerts...
  272.       * Fixed MAJOR bug in the Search-Engine
  273.       * Added Custom Font Option
  274.  
  275.       Version 2.0
  276.       * Removed Custom Font Option...for ease of use, only the EXE is needed,
  277.         and for smaller executable...Font is now compressed within the EXE
  278.       * Rearranged the code, it's now even more structured!
  279.       * Now uses the EnhancedDOS Unit (C)1994 by Andrew Eigus
  280.       * Compiled with a new bugfixed/optimized TURBO.TPL 
  281.         (C) 1994 Norbert Ruffa (BPL70N16.ZIP)
  282.       * Removed FMANAGE.* (Functions are included in the Enhanced DOS unit)
  283.       * Dramatically decreased the number of false alerts, filesize checking
  284.         now before the 'saving'. Sorry...scanning a little bit slower.
  285.       * Added XM support
  286.       * Added WAVE calculation and extraction
  287.       * Added 'JN'-header for UNIS669 modules
  288.       * Added DMF support
  289.       * Added MDL support
  290.       * Added PTM support
  291.       * Added PAC support (SB Studio II)
  292.       * Added 'interactive commandline'! 
  293.         (Thanks for that idea, Cubic Player guys)
  294.       * Added a semi-professional-looking input-routine
  295.       * Added automagicaly filenaming for extracted files
  296.       * Added Custom-Save-function, including a <offset> parameter
  297.       * Made size-checking more stable
  298.       * Removed detection of EXE-compressors
  299.       * Included MEMDUMP utility
  300.  
  301.  
  302.       How to contact the author:
  303.  
  304.       Write a message to:
  305.       
  306.       Johan Prins at The Sound Zone     [+31-(0)35-OFFLINE]
  307.       Johan Prins at BaD NeWS           [+31-(0)35-837350]
  308.       Johan Prins at Da Big Busy Bored  [+31-(0)71-213747]
  309.  
  310.       E-Mail: jprins@dmrt.nl (preferred)
  311.  
  312.       Please send me info on 
  313.       * Unsupported module/graphics formats!
  314.         So I can support that formats too!
  315.       * Suggestions to enhance the program
  316.