mirror of
				https://github.com/ElvishArtisan/rivendell.git
				synced 2025-10-30 17:23:53 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			68 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			68 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
|           Usage Notes for the 'wings_filter' Import Script.
 | |
| 
 | |
| Wings_filter is a script designed to be used to import existing audio
 | |
| and meta-data from an AirForce 'Wings' automation system.  It is
 | |
| invoked as follows:
 | |
| 
 | |
| USAGE
 | |
| 
 | |
| wings_filter -g <default-group> -d <db-file> -A <audio-dir> [-e <audio-ext>]
 | |
| 
 | |
| Where:
 | |
|   <default-group> = The name of the group in which to place carts
 | |
|                     belonging to a source tab in Wings for which there
 | |
|                     is no corresponding Rivendell Group.
 | |
| 
 | |
|         <db-file> = The name of the Wings database file.
 | |
| 
 | |
|       <audio-dir> = The name of the directory containing the Wings ATX
 | |
|                     audio files.
 | |
| 
 | |
|       <audio-ext> = The filetype extension fo the Wings ATX files.  By
 | |
|                     default, this is 'ATX', but can be changed to
 | |
|                     other values here if necessary.
 | |
| 
 | |
| 
 | |
| OVERVIEW
 | |
| In order import audio from an existing Wings system, proceed as
 | |
| follows:
 | |
| 
 | |
| 1) CREATE RIVENDELL GROUPS
 | |
| In RDAdmin->ManageGroups, create a Group to correspond to each Wings
 | |
| Tab value that exists in the library to be imported, and an additional
 | |
| group to catch any Wings entries that may not have a valid Group.
 | |
| When creating these groups, it is essential that a default cart number
 | |
| range be configured for each group that is large enough to accomodate
 | |
| all anticipated imports.
 | |
| 
 | |
| 2) LOCATE THE 'WINGS' DATABASE AND AUDIO FILES
 | |
| These can be mounted from a remote system if needs be.  Read-only
 | |
| access is adequate, as the script does not modify these items in any
 | |
| way.
 | |
| 
 | |
| 3) VERIFY AVAILABLE DISK SPACE
 | |
| Verify that enough disk space is available in the '/var/snd/'
 | |
| directory to accomodate the audio to be imported.  You should have at
 | |
| least the amount of space currently occupied by the Wings ATX files,
 | |
| plus 5 percent additional.  
 | |
| 
 | |
| 4) INVOKE SCRIPT
 | |
| Start up the script, as described in the USAGE section above.  The
 | |
| script will print progress reports as it proceeds, or notify you of
 | |
| error conditions as required.
 | |
| 
 | |
| 5) CLEAN UP
 | |
| If desired, use RDAdmin->ManageGroups to rename the single-letter
 | |
| import groups to more intuitive names.
 | |
| 
 | |
| 
 | |
| NOTE ON AUDIO PROCESSING
 | |
| Wings_filter does not alter or reencode the audio sample data in any
 | |
| way, and thus does *not* incurr any generation or transcoding loss of
 | |
| quality.  At the same time, this means that the incoming audio will be
 | |
| brought into Rivendell *exactly* as it exists in the Wings system,
 | |
| with all parameters (e.g. sample rate, bit rate, level, etc)
 | |
| unaltered.  If you need to alter one or more of these parameters as
 | |
| part of the import process, we suggest you use the RDImport script
 | |
| instead.
 |