mp3gen

If you design EF2 SP levels that have NPCs reading custom dialogs, then you likely used Lipsync (it comes with the GDK) to generate VLP file...

Download

Uploading...
Do not refresh or leave this page!

File Description

If you design EF2 SP levels that have NPCs reading custom dialogs, then you likely used Lipsync (it comes with the GDK) to generate VLP files. Indeed, those ones allow the NPCs to move their mouth in accordance with the acoustic level of the corresponding dialog file. But this tool has limitations: - it works exclusively with WAV files - it cannot process more than one file at a time (no batch process) Otherwise, if you want NPCs to only display the text of their dialogs because you don't have sound files for them, then you need silent sound files so the text can remain displayed on the screen the time that lasts these silences. But generating them requires a sound editor and probably several manipulations afterwards. I did mp3gen to address all of these problems. This version is a major update to the previous one. In addition to fixing many trouble and bringing new features, it now has a GUI to handle the batch process.

Note: Just to re-iterate an important point, this file is for mod makers who are working with talking character/npc models, not for normal gamers. Definitely read the readme for specifics on using the program.

Read More

Download 'mp3gen11bfinalwithgui.zip' (461KB)

Readme
//---------------------------------------------------
/**
 ** mp3gen 1.1b / Star Trek Elite Force II Utility
 ** >>> Documentation <<<
 ** Copyright © 2003-2004 Yannick &quot;Bluehair&quot; Léon
 **
 ** $File:	./mp3gen.txt$
 ** $Designer:	Bluehair$
 ** $Date (US):	10-14-2k3$
 ** $Revision:	04-04-2k4$
 **
 **/
//---------------------------------------------------


[---- OVERVIEW ----]

If you design EF2 SP levels that have NPCs reading custom dialogs, then you
likely used Lipsync (it comes with the GDK) to generate VLP files. Indeed,
those ones allow the NPCs to move their mouth in accordance with the acoustic
level of the corresponding dialog file.

But this tool has limitations:
	- it works exclusively with WAV files
	- it cannot process more than one file at a time (no batch process)

Otherwise, if you want NPCs to only display the text of their dialogs because
you don't have sound files for them, then you need silent sound files so the
text can remain displayed on the screen the time that lasts these silences. But
generating them requires a sound editor and probably several manipulations
afterwards.

I did mp3gen to address all of these problems.


[---- CHANGES ----]

Here is the list of the most important of them:

Fixes:
- Some generated MP3s had &quot;click&quot; sounds/were slightly cut at their end
- VLP files sometimes got mistakenly deleted after being generated, resulting
  in a error message
- Some generated MP3s played in &quot;turbo&quot; mode
- Some encoding using the VBR technique caused a LAME error ending in the
  crash of the program
- 11.025kHz WAV files could not be encoded
- My encoding rules were way far too tight; I had misunderstood the LAME API
  documentation: henceforth, you will have a greater control on the quality
  since those ill-fated rules are gone granting you a greater choice of bit
  rates; here the list of them that you can use:

	- For MPEG-1 (sampling frequencies of 32, 44.1 and 48 kHz):
	|-> 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320 kbps

	- For MPEG-2 and MPEG-2.5 (sampling frequencies of 8, 11.025, 12, 16, 22.05 and 24 kHz):
	|-> 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160 kbps

  mp3gen will reprocess your value if necessary, so don't get stunned by those
  numbers ;) Just remember that the medium value for MPEG-1 is 128kps and
  for MPEG-2/MPEG-2.5 80kbps, which corresponds to a good CD quality

Enhancements:
- No list file to deal with anymore for the batch process
- Destination directory can now be as deep as you want: mp3gen will create
  them as per need
- Program's usage reviewed and help panel simplified
- You will be notified of any failed conversions at the end of a batch process
  through the &quot;Final Stats&quot; message box and a text file will be generated
  in the destination directory listing the name of the files that didn't pass
  the process + reasons about the failure
- mp3gen is now powered with the latest version of LAME (v3.95.1, 01/2k4)
- the DOS box only displays meaningful messages
- No message box will pop out during a batch encoding; you can safely do
  something else during this time

Overhauls:
- All the code enjoyed my coding progress :-)

This will be the last version this time. I don't see any significant problem
remaining.


[---- INSTALLATION ----]

Take the files from this archive into the directory where your have Ritual's
Lipsync tool installed: it should be &quot;<Your_EF2_dir>\Utilities\Lipsync&quot;.

The INF file &quot;DosHere.inf&quot; is a &quot;PowerToy&quot; released by Microsoft years ago;
it enables you to open a DOS box into a specific directory by just
right-clicking on it in Windows Explorer and select the new
&quot;Command Prompt Here&quot; command.

Indeed, this PowerToy adds this new entry in Windows Explorer's contextual
menu. Select it and a DOS window will open straight into the corresponding
directory. To install it, just right-click on the INF file and select the
&quot;Install&quot; command from the contextual menu that pops out. This tool helps
running mp3gen more quickly.


[---- USAGE GUIDELINES ----]

---------------------------------------------------------------
Viewing mp3gen built-in help; key in what's next in the DOS box
---------------------------------------------------------------

	mp3gen -h

---------------------------------------------
Generating 40 seconds of silence + a VLP file
---------------------------------------------

	mp3gen -lips 40		or	mp3gen -vlp 40

The MP3 file will be named 40_sec.mp3 and located in mp3gen's directory. It
will be of the same format that Ritual used for their dialog files, i.e.
44.1kHz/16bits/mono/64kbps

To have it generated in an other directory, use this instead:

	mp3gen -vlp 40 &quot;c:\test dir&quot;

------------------------------------------------------
Generating a MP3 file from a single WAV named c:\test dir\pcm.wav + a VLP file
------------------------------------------------------

	mp3gen -wav -vlp &quot;c:\test dir\pcm.wav&quot;

To have the WAV file deleted after the process, use this:

	mp3gen -wav -vlp -rem &quot;c:\test dir\pcm.wav&quot;

NB: mp3gen encodes PCM WAV files i.e. uncompressed. There are files having
the .wav extensions that are already compressed. Encoding such ones would
produce inaudible MP3s so beware.

-------------------------------------------------------
Generating MP3s from all WAV files located in c:\test dir into c:\dest dir\mp3s
+ a VLP file for each of them
-------------------------------------------------------

	mp3gen -batch -vlp &quot;c:\test dir&quot; &quot;c:\dest dir\mp3s&quot;

If you don't specify a destination directory, you would find the MP3s and VLPs
in c:\test dir

------------------------------------------
Playing a sound file named c:\testcase.mp3
------------------------------------------

	mp3gen -play testcase

You don't need to put the extension &quot;.mp3&quot;: mp3gen will look to see if there
is a MP3 file, then a WAV, then a OGG, then a MP2, and then a MP1 matching this
name in c:\. Once a concordance is found, playback will start :)

=============================================
Quick note about these switches: -vbr, -brate
=============================================

You can use them when converting existing WAV files to bias both the quality
and size of the produced MP3s. Depending on the type of the WAVs (MPEG-1 or
MPEG-2/MPEG-2.5), different encoding bitrates can be used: this is why I
supply the image &quot;mp3_bitrate_chart.png&quot;. But if you were to supply a wrong
bitrate, then mp3gen would simply readjust its value to the nearest allowable.

VBR tries to decrease the file size even more while keeping the same quality,
but in practice, there is a hearable loss in quality.


[---- BOTTOM LINE ----]

With the GUI this program has more interest than it had before and the time
elasped since the last release allowed me to make this revision a major one,
more mature. Now I am happy with it and I hope it will serve you too.

See ya!

Bluehair.

//---------------------------------------------------

Read More

Comments on this File

There are no comments yet. Be the first!

Bluehair


50 XP


Registered 21st April 2002

5 Files Uploaded

Share This File
Embed File