CONVERT.DOC

(20 KB) Pobierz
                  Convert, (c) 1994 Jesus Villena, Spain
                   Universidad Politecnica de Valencia
                         Facultad de Informatica

                     INTERNET:  usufi4@finf.upv.es

                              Version 1.4B


COPYRIGHT

This program is Freeware and may be distributed without any permission of
their author. Their development has been carried out by and for the INTERNET
collective. Collaborates in their improvement and amplification!!!

This software is provided as-is. Author makes no warranties on this program.
You use this software at your own risk.


INTRODUCTION

Convert is a MSDOS tool which serves in order to interchange samples between
several formats of sound.  The translation between the several formats offers
the advantage of maintaining the majority of the present information in the
original file if this is possible, i.e. name, loop points, significant
number of bits, number of channels, etc.


MOTIVATION

Convert surged like a domestic project destined to the obtaining of high
quality instruments for the Gravis Ultrasound card starting with files
from professional samplers (Ensoniq EPS, Roland [S] 50, Yamaha TX16W...)
The source code was designed so that out easy their amplification to more
formats. In fact, soon the formats of the most well-known modules were added
(MOD, MTM, FAR, S3M...). A little later they were added the MIDI standard
formats (SDS and SDX) and other formats offered by several manufacturers
(AIFF, IFF, SMP...).

At the same time that was added more available formats for the input files,
these same formats, if it was possible, they were available also like
output, so that virtually, any input format would be converted in any
output format.


FEATURES

        - Great quantity of input and output formats:  seeing list.

        - Automatic recognition of the input format:  it is not necessary
        specify the type of the input file, Convert detects it automatically.

        - Possibility of converting in one pass great quantity of files and
        carry them to some target directory:  They are accepted wildcards
        in order to specify the input files, and a output directory which
        will be filled with the resulting files.

        - Ease of use: their utilization is clearly intuitive in order to avoid
        remember difficult combinations of input parameters (for example,if you
        want to use the samples that there is in a file ". PAT" in order to
        utilize them in a module ". MOD", simply specifies -MOD as switch and
        Convert translate each one of the waveforms to the format ". SAM"
        readable for all the mod-editors, without specifying if it is SIGNED or
        UNSIGNED...)

        - The program may work with input files of until 16 bits and
        2 channels (Stereo), doing the necessary conversion of these values for
        generating the output format (this is,a WAV file of 16 bits Stereo will
        be converted in 8 bits Mono upon converting it to VOC, for example).

        - High probability of success: This program has converted with success
        98% of files I have (others conversion programs generated many errors).
        Especially I have all GKH and AIFF files on ftp.reed.edu (now on
        oak.oakland.edu) and it has converted all very well (except some files
        that was corrupted originally).

        - Varios Keyboard Disk Images have been added: Directly supports the
        disk image formats GKH and Giebler Enterprises (both are the most
        common in the internet) for VFX-SD, SD-1, TS-10 (DD y HD), VFX-SD, EPS
        (normal, 16 and 16+), and ASR keyboards and racks units. Convert
        doesn't need, as a difference to other programs, external programs for
        converting these disk images.

       - It Comes in this version with some useful utilities: SND2WAV and JOIN
        SND2WAV converts files that can't carry out Convert (files without
        header) and JOIN links pieces which form a unique sample disk for
        Kurzweil and Ensonig formats.

        - LoopPoints and WaveSample Length shows samples, nor bytes, similary
        to other packages. Sizes are still in bytes.

NEW!!	- Full support for the SoundBlaster AWE32 format. Now, you can read
	and write SBK files (Vienna compatibles) with many features. Try it.

NEW!!   - Stereo support for SBK files, using multiyering capabilities of
	the SoundBlaster AWE32.

NEW!!	- Bidirectional to Forward looping conversion, useful in formats
	without bidirectional capabilities.

NEW!!   - Three pro formats have been added as output: Yamaha TX16W, Yamaha
	SY-85/SY-99 and Ensoniq Instrument file. The files generated with
	this option haven't been tested. Please test it and tell me.


FORMAT IDENTIFICATION

The formats which Convert works in this version are the following:

	Alias	    Meaning
	-----       -------------------------------------------
        669         669 Tracker Module
        AIFF        Audio Interchange Format File (AIFF)
        AU          Sun/Next Audio File
        DMF         Delusion Digital Music File
        DSF         Delusion Digital Sound File
        DSM         Digital Sound Module
	DSP	    Dynamic Studio Professional Module
        FAR         Farandole Composer Module
        FSM         Farandole Composer WaveSample
        F2R         Farandole Linear Module
        F3R         Farandole Blocked Linear Module
        GKH	    Ensoniq Disk Image (VFX, SD, EPS, ASR, TS)
        IFF         Interchange Format File (IFF)
        INS	    Ensoniq Instrument File
        KRZ         Kurzweil K2000 File
        MED         MED/OctaMED Module
        MOD         Protracker/Fastracker/Startrekker Module
        MTM         MultiTracker Module
        OKT         Oktalizer Module
        PAC         SBStudio II Package or Song
        PAT         Gravis Ultrasound Patch
        PSM         Protracker Studio Module
        RAW         PCM Signed Raw Sound File
        SBK         Emu SoundFont Bank (AWE32 Bank)
        SDK         Roland S-550/S-50/W-30 Disk Image
        SDS         MIDI Sample DUMP Standard File
        SDX         Sample DUMP Exchange File
        SF          IRCAM Sound File"
        SMP         Samplevision File
        SND         PCM Unsigned Raw Sound File
        SOU         SBStudio II Sound File
        STM         Scream Tracker 1 & 2
        S3I	    Digiplayer/ST3 Sample File
        S3M         Scream Tracker v3 Module
	SYW	    Yamaha SY-85/SY-99 Wave File
        TXW         Yamaha TX-16W Wave File
        ULT         UltraTracker Module
        UNI         UNIMOD Module
        UWF         UltraTracker WaveSample
        VOC         Creative Lab's Sound File
        WAV         Microsoft Windows RIFF WAVE
	XI	    Fastracker 2.0 Instrument File
	XM	    Fastracker 2.0 Module


SYNTAX

The form of invoking to this tool is the following:

          CONVERT [[InputPath/@SearchFile] [OutputPath] [OutFmt] [Switches]]

Where:

InputPath is the name of the files to convert.  InputPath consists of a route
and a file name, which accept the usual wilcards of DOS.  Examples of
InputPath would be: \SAMPLES\*.*, ..\SAMPLES\ENSONIQ\*.INS, SAMPLE?.*, etc.

SearchFile is optional to InputPath and is a text file which let you specify
files to convert, one file path in each line. Comments can be included behind
simbol #. Order can be achieved also specifying number=filepath. This order
is supplied mainly to support AWE32 program numbers, although is valid for
the rest of formats. E.g:

     ---File sample.ini---
        # Sample File to obtain the bank sample.bank
        # Use convert @sample.ini -sbk
        0=c:\sounds\bdrum1.wav
        1=c:\insts\snare2.aif
        8=d:\krz\voices.krz
        # This bank will have the sound bdrum1.wav as program 0
        # the sound snare1.aif as program 1
        # and sounds included in voices.krz as programs 8,9,...


OutputPath specifies the destination directory where Convert will place the
files converted.  If this directory don't exist, Convert creates it.

OutFmt is a switch that allows to specify the output format for the files
to convert to.

Switches are -8 and -1 , and serves actually to force 8 bits and mono
conversion.

OutFmt may be one of the following:

OutFmt      Extension     Offered Features (Resume)
------      ---------     --------------------------------------------------
-669        ".snd"         PCM Unsigned Raw, 8 bits, Mono
-AIF        ".aif"         8/16 bits, Mono/Stereo, Rate, Loop
-AU         ".au"          8/16 bits LINEAR, Mono/Stereo, Rate
-DMF, -DSF  ".dsf"         8/16 bits, Mono, Rate, Loop
-DSM	    ".wav"	   8 bits, Mono, Rate, Loop
-FAR, -F2R
-F3R, -FSM  ".fsm"         8/16 bits, Mono, Loop
-GKH, -INS  ".ins"	   16 bits, Mono, Rate, Loop
-IFF        ".iff"         8 bits, Mono/Stereo, Rate
-MOD, -STM
-MED, -OKT  ".sam"         PCM Signed Raw, 8 bits, Mono
-MTM        ".raw"         PCM Unsigned Raw, 8/16 bits, Mono
-PAC, -SOU  ".sou"         8/16 bits, Mono, Loop
-PAT        ".pat"         8/16 bits, Mono, Rate, Loop, Multiple Waveforms
-RAW        ".raw"         PCM Signed Raw, 8/16 bits INTEL, Mono/Stereo
-SBK        ".sbk"         16 bits, Mono, Rate, Loop
-SDS        ".sds"         8/16 bits, Mono, Rate, Loop
-SDX        ".sdx"         8/16 bits, Mono, Rate, Loop
-SF         ".sf"          8/16 bits, Mono/Stereo, Rate
-SMP        ".smp"         16 bits, Mono, Rate, Loop
-SND        ".snd"         PCM Unsigned Raw, 8/16 bits INTEL, Mono/Stereo
-S3M, -S3I  ".smp"         8/16 bits, Mono/Stereo, Rate, Loop
-...
Zgłoś jeśli naruszono regulamin