AminetAminet
Search:
84039 packages online
About
Recent
Browse
Search
Upload
Setup
Services

util/misc/xfrmaster.zip

Mirror:Random
Showing:m68k-amigaosppc-amigaosppc-morphosi386-arosi386-amithlonppc-warpupppc-powerupgeneric
No screenshot available
Short:eXternal Format Rippers master library
Author:Andreas Szabo
Uploader:silva psi5 com
Type:util/misc
Version:4.5
Replaces:xfrmaster.lha
Requires:any amiga or amiga emulator
Architecture:
Date:2016-05-17
Download:http://aminet.net/util/misc/xfrmaster.zip - View contents
Readme:http://aminet.net/util/misc/xfrmaster.readme
Downloads:489

	PURPOSE AND FEATURES

There have been many rippers on amiga with various functions. If you
wanted to write your own ripper because of implementing a function that
the others had not, you needed to rewrite all those formats out there.
Now is the times when ultimate redemption has come to you programmers
of the rippers. XFR is a standard amiga library that supports external
clients similar to eagleplayer rippers, and, XFR can be utilised from
any program easily through a standard interface. Some details:

	- 100% written in 68000 assembler
	- object based interface
	- external clients use taglists
	- check or scan files
	- scan memory
	- read tracks from a disk
	- special deep scan mode
	- scan hook function
	- abort and continue
	- extract samples from modules
	- convert format to more common
	- fix/patch embedded replayers
	- developer material and guide


	ARCHIVE CONTENTS

	xfrmaster.library		the library itself
	xfr/				clients
	xfrlibinfo			shell and wb tools,
	xfrlist				see usage below
	xfrscan				 .. ..
	xfremove			 .. ..
	xfr-usage.txt			quick start info
	X-Systems.TXT			about similar libs
	XFRGenie			Delitracker XFR Genie
	EagleXFR			XFR Eagleplayer Engine
	xfr_developer.guide		developer autodoc
	#?.asm				example sources*
	xfr.i				assembler include file
	xfr_lib.i			.. (lvo offsets)
	xfrmaster_pragmas_#?.h		for different compilers
	xfrmaster_stubs.a		what are these for?
	xfrmaster_lib.fd		fd file

	* may undergo changes from rel to rel, i do try to
	  release some good sources without further notice


	VERSION AND UPDATES, HOMEPAGE

There are no known bugs. Details on missing features are documented
in the guide or commented in the includes. The c header files are
experimental and incomplete. I do not understand c and you may help me.

You may check for updates at http://www.psi5.com/~silva/afilter/. A
list of clients is also maintained there and with some may be links
to recent client updates or to their authors webpages.

The supplied tools do support some of the features of
xfrmaster.library, though there is more available for developers.

If you like this library and/or tools, please leave me a note per email.
Write to: silva at psi5.com


	LEAGALITY

This software is freeware. You may not have to pay for it. You may send
money or something usefull to silva at psi5.com.

I take no response for anything concerning XFR. You may not distribute
it or the archive nor partial but may spread the word and hand out the
homepage address. You may use and modify the supplied sourcecodes for
your own purposes without remaking and redistributing annother version
or clone of XFR or one of the supplied clients or tools under my name. 


	INSTALLATION

1. You copy the contents of libs/ from this archive to libs:.
2. You copy the xfr tools where you want them. I recommend C: but
   you may use some of them via icon also, so maybe sys:tools/
   or else place in a WB-drawer is the place.
3. put the genie or engine in the appropriate directory,
   DeliGenies for Delitracker or Engines for Eagleplayer, both
   just one dir under the main dir where the player main program is
4. You copy the developer files where you want them.


	USAGE

A help text for the Delitracker XFR Genie can be found when selecting
the Genie from the Delitracker Genie list, pressing config and then
in its menu the help key while the menu is open (menuhelp). Closing
the progress window does stop the scan and then the genie does show
what XFR has been found until that.

The tools are very self explaining and can be started from shell or
workbench. You can also select their icons together with other
files or directorys to process. In the shell the "?" argument prints
out some info for xfrlibinfo, -scan and -list. At xfrlibinfo you do
not need to use -> " <-. The xfremove does not have any parameters.
It frees the library and all clients from memory when idle (so you
do not need to reboot after changing the client files, just type
xfremove and load again whichever XFR-prog youd like).

The scanning, listing and libinfo text output can be canceled with
CTRL+C.

There is a general XFR difference in scanning and listing file and
data recognition, so some data can be ripped out of files, but not
properly listed as a stand alone files. Hope for future improvements
or re/write a client yourself. And last but not least XFR is rather
a ripper than a file/ or datatype recognition tool.

I recommend to deactive the player genie if you only want to listen to
music. You would do yourself a great favor.

Advanced options for xfrscan are (see "xfrscan ?" for beginner):

TO <directory>			save files, default is verbose only
EXCLUDE <filenamepattern>	do not scan these files, e.g. #?.info
DISK <drivenumber>		select floppy drive 0 to 3 to read a
				whole disk for input to scan it; please
				do not use this (use xad) to load disk
				that are amiga dos formated or do contain
				an os filesystem directory. such may
				produce very false results, though for
				bootgirl bootblock pictures its ok--)
CHIP				scan the entire local chipmem area 
FAST				scan the fastmem area(s)
RAM or MEMORY			scan all chip and fast ram area(s)
				(you may also use CHIP and FAST combined)
DEEP				scan in deep mode
HYBRID				scan in normal and deep mode combined
ODD				scan odd addresses, e.g. you have
				cut a decrunched demo in a texteditor
				at a byte offset (needs 68020+ CPU or
				emulation of such)
PCSTYLENAMES			per default names are f.e. mod.amegas,
				with this opt. the will be amegas.mod
COMPACT				no blank lines in text output
OVERWRITE			default is adding numbers to filenames
				that exist when saving

Please write me if you find the overwrite option usefull. I doubt.
Write to: silva at psi5.com


	DEVELOPEMENT

You may use the supplied example sources, change them or make your
own to write a program that utilises xfr. If you make a client (much
more simple than a program, you do not need to worry about allmost
anything), consider the very informative guidelines that are written
and illustrated on the homepage. A client should match them to be
included into the xfr distribution.

Send it to me along with its sources. We can decide and you can get a
link on the homepage to support it yourself, offer updates, etc.

My eMail adress is silva at psi5.com.


	CREDITS AND EARLY HISTORY

I learned by trying object based developement and then through xfd and
xad by Dirk Stöcker, Georg Hörmann, but rather by analysing dozens of
formats and replays. In the beginning, that has been annother dozen of
years beyond, through heavy and dirty ripping. Later through many years
of allmost useless developement and planning. Armin Sander was the guy
at the M&T support hotline and he encouraged me to take over his job
there. After (or before) this he has given me and my schoolfriend some
improved assembler and reassembler to work with. So the work continued
in a new environment.

The eXternal Format Rippers are mainly made from my earlier projects
Universal Ripper and Amiga Filterium.

For most of the eXternal Formats that are supported now by XFR I
referred to other ripper sources. Certain authors and providers of
informations are listed on the homepage and can be retrieved with the
supplied xfrlibinfo program from the clients directly. Sometimes the
shell command "version" can do this also.

If you want to make a good program consider to implement xad, xfd and
xvs from aminet.net. They do you all a great work as e.g. unpacking
allmost all homecomputer and pc archives, decrunching amiga intros and
checking amiga software for viruses.

===============================================================
DISCLAIMER
===============================================================

Copyright (c) 2015 Andreas G. Szabo

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or
sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.

--
eXternal Format Rippers

pps: Zak McKracken for President


Contents of util/misc/xfrmaster.zip
Archive:  /home/aminet/aminet_root/doc//util/misc/xfrmaster.zip
 Length   Method    Size  Cmpr    Date    Time   CRC-32   Name
--------  ------  ------- ---- ---------- ----- --------  ----
       0  Stored        0   0% 2016-05-02 12:16 00000000  xfrmaster/
    2419  Defl:N     1297  46% 2009-11-06 21:01 48cfdf55  xfrmaster/xfr-usage.txt
    7137  Defl:N     2967  58% 2009-11-06 21:01 f92ee750  xfrmaster/X-Systems.TXT
    9043  Defl:N     4323  52% 2016-05-02 12:16 a8826fa6  xfrmaster/xfrmaster.readme
       0  Stored        0   0% 2009-11-06 21:01 00000000  xfrmaster/source/
     994  Defl:N      553  44% 2009-11-06 21:01 a24f5948  xfrmaster/source/xfremove.asm
    8260  Defl:N     3007  64% 2009-11-06 21:01 b4ab2b9f  xfrmaster/source/xfrlist.asm
   18203  Defl:N     6294  65% 2009-11-06 21:01 79b2e56b  xfrmaster/source/xfr_eagle.asm
   44387  Defl:N    14880  67% 2009-11-06 21:01 0f62dc24  xfrmaster/source/xfr_developer.guide
   36831  Defl:N    11021  70% 2009-11-06 21:01 72b75704  xfrmaster/source/xfr_genie.asm
    5056  Defl:N     1826  64% 2009-11-06 21:01 70c82f7d  xfrmaster/source/xfrtools_startup.asm
   10460  Defl:N     3015  71% 2009-11-06 21:01 86a9882a  xfrmaster/source/xfrlibinfo.asm
   16082  Defl:N     5357  67% 2009-11-06 21:01 80dc4c19  xfrmaster/source/xfrscan.asm
       0  Stored        0   0% 2009-11-06 21:01 00000000  xfrmaster/include/
    1151  Defl:N      539  53% 2009-11-06 21:01 143c80ba  xfrmaster/include/xfr_lib.i
    3635  Defl:N      796  78% 2009-11-06 21:01 19a63ec7  xfrmaster/include/xfrmaster_stubs.a
    1361  Defl:N      654  52% 2009-11-06 21:01 e6febc08  xfrmaster/include/xfrmaster_lib.fd
    1059  Defl:N      397  63% 2009-11-06 21:01 b779bf44  xfrmaster/include/xfrmaster_pragmas_sas.h
    2907  Defl:N     1143  61% 2009-11-06 21:01 19e6bd23  xfrmaster/include/easy.i
    1226  Defl:N      459  63% 2009-11-06 21:01 00326488  xfrmaster/include/xfrmaster_pragmas_storm.h
   29143  Defl:N    10884  63% 2009-11-06 21:01 bfe684d2  xfrmaster/include/xfr.i
       0  Stored        0   0% 2009-10-16 10:48 00000000  xfrmaster/eagleplayer/
       0  Stored        0   0% 2009-11-06 21:01 00000000  xfrmaster/c/
    2688  Defl:N     1834  32% 2009-11-06 21:01 040c3b65  xfrmaster/c/xfrlibinfo
    3680  Defl:N     2555  31% 2009-11-06 21:01 236831df  xfrmaster/c/xfrscan
    2056  Defl:N     1500  27% 2009-11-06 21:01 eb035d12  xfrmaster/c/xfrlist
    1024  Defl:N      757  26% 2009-11-06 21:01 73478a95  xfrmaster/c/xfremove
       0  Stored        0   0% 2016-05-02 12:08 00000000  xfrmaster/libs/
    7756  Defl:N     5235  33% 2015-11-08 09:22 a774f20c  xfrmaster/libs/xfrmaster.library
       0  Stored        0   0% 2009-10-16 10:48 00000000  xfrmaster/delitracker/
       0  Stored        0   0% 2009-11-06 21:01 00000000  xfrmaster/source/clients/
    1847  Defl:N      912  51% 2009-11-06 21:01 1836b7f8  xfrmaster/source/clients/XFRC_AMComposer1.2.asm
    2049  Defl:N     1041  49% 2009-11-06 21:01 06c3ccae  xfrmaster/source/clients/XFRC_AHX.asm
    1657  Defl:N      848  49% 2009-11-06 21:01 47755d75  xfrmaster/source/clients/XFRC_AON.asm
    1268  Defl:N      677  47% 2009-11-06 21:01 505fe770  xfrmaster/source/clients/XFRC_AProSys.asm
    4007  Defl:N     1420  65% 2009-11-06 21:01 523866bc  xfrmaster/source/clients/XFRC_Hippel.asm
    1268  Defl:N      661  48% 2009-11-06 21:01 b5103c05  xfrmaster/source/clients/XFRC_Actionamics.asm
       0  Stored        0   0% 2009-11-06 21:01 00000000  xfrmaster/eagleplayer/engines/
    2260  Defl:N     1415  37% 2009-11-06 21:01 872889aa  xfrmaster/eagleplayer/engines/EagleXFR
       0  Stored        0   0% 2016-05-02 12:11 00000000  xfrmaster/libs/xfr/
    1092  Defl:N      800  27% 2003-04-07 07:31 d3b82166  xfrmaster/libs/xfr/Whittacker
    2040  Defl:N     1244  39% 2003-04-07 07:31 4cd4cfe4  xfrmaster/libs/xfr/Tracker
     544  Defl:N      387  29% 2003-04-07 07:31 ece95575  xfrmaster/libs/xfr/Synthesis
     752  Defl:N      549  27% 2003-04-19 06:14 019a67de  xfrmaster/libs/xfr/SoundMon
     896  Defl:N      679  24% 2003-04-08 06:11 80364761  xfrmaster/libs/xfr/SoundFX
     624  Defl:N      461  26% 2003-04-07 07:31 e14dd21b  xfrmaster/libs/xfr/SidMonII
     700  Defl:N      504  28% 2003-04-07 07:31 9d445452  xfrmaster/libs/xfr/SidMon
     700  Defl:N      555  21% 2003-04-07 07:31 cc787e15  xfrmaster/libs/xfr/Puma
     388  Defl:N      297  24% 2003-04-07 07:31 2d2edb9f  xfrmaster/libs/xfr/psa
     544  Defl:N      421  23% 2003-04-19 06:14 defc3673  xfrmaster/libs/xfr/Oktalyzer
     552  Defl:N      429  22% 2003-04-07 07:31 8cbd4642  xfrmaster/libs/xfr/Mugician
     496  Defl:N      385  22% 2003-04-07 07:31 00dfead7  xfrmaster/libs/xfr/MajorTom
     464  Defl:N      352  24% 2003-04-07 07:31 ab27acd3  xfrmaster/libs/xfr/ma
     480  Defl:N      386  20% 2003-04-07 07:31 a5a81422  xfrmaster/libs/xfr/lme
    1288  Defl:N      897  30% 2003-04-07 07:31 5700c7ec  xfrmaster/libs/xfr/klaren
     496  Defl:N      378  24% 2014-07-26 15:10 3636e020  xfrmaster/libs/xfr/JamCracker
    1008  Defl:N      641  36% 2003-04-07 07:31 1ed16688  xfrmaster/libs/xfr/Hippel
     948  Defl:N      675  29% 2003-04-07 07:31 9dee4ee9  xfrmaster/libs/xfr/Gremlin
     760  Defl:N      503  34% 2003-04-07 07:31 56010907  xfrmaster/libs/xfr/FutureComposer
     904  Defl:N      720  20% 2003-04-19 06:14 ed98f6e3  xfrmaster/libs/xfr/FredMon
     620  Defl:N      439  29% 2003-04-07 07:31 fb596d20  xfrmaster/libs/xfr/EarAche
     628  Defl:N      457  27% 2003-04-07 07:31 42cdf2d3  xfrmaster/libs/xfr/Digibooster
     468  Defl:N      354  24% 2003-04-07 07:31 5455aabc  xfrmaster/libs/xfr/Detrack
     532  Defl:N      396  26% 2003-04-07 07:31 e4a2b263  xfrmaster/libs/xfr/Delta2
     404  Defl:N      316  22% 2003-04-07 07:31 ee3b847e  xfrmaster/libs/xfr/AProSys
     508  Defl:N      391  23% 2003-04-07 07:31 0c8d3458  xfrmaster/libs/xfr/aon
     552  Defl:N      435  21% 2003-04-19 05:57 767e760c  xfrmaster/libs/xfr/amc
     468  Defl:N      355  24% 2003-04-07 07:31 49790931  xfrmaster/libs/xfr/ahx
     448  Defl:N      336  25% 2003-04-07 07:31 124900fc  xfrmaster/libs/xfr/Actionamics
       0  Stored        0   0% 2009-11-06 21:01 00000000  xfrmaster/delitracker/deligenies/
    6644  Defl:N     3733  44% 2009-11-06 21:01 80a22648  xfrmaster/delitracker/deligenies/XFRGenie
--------          -------  ---                            -------
  257862           106742  59%                            71 files

Aminet © 1992-2023 Urban Müller and the Aminet team. Aminet contact address: <aminetaminet net>