OSDN Git Service

44821ab79520210c966a43f9dc2783c69df21176
[lamexp/LameXP.git] / doc / FAQ.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <html>
3 <head>
4 <title>LameXP - Frequently Asked Questions (FAQ)</title>
5 <meta http-equiv="content-type" content="text/html; charset=UTF-8">
6 <style type="text/css">
7 <!--
8 body { font-family:Consolas, "Lucida Console", Monospace; font-size:10pt; }
9 a { text-decoration:none; color:#0000EE; transition:color 0.5s ease; -moz-transition:background-color 0.5s ease; -o-transition:background-color 0.5s ease; -webkit-transition:background-color 0.5s ease; }
10 a:hover { background-color: #CCCCCC; }
11 a:active { color: #551A8B; }
12 a:visited { color: #0000EE; }
13 .code { background-color: #EAEAEA; }
14 .diff_del { color: #660000; background-color: #FF6666; }
15 .diff_add { color: #006600; background-color: #66FF66; }
16 -->
17 </style>
18 </head>
19 <body>
20 <h3>LameXP - Frequently Asked Questions (FAQ)</h3><br>
21
22 <a name="127191f3"></a><b>Table of contents:</b><br>
23 <ul>
24 <li><a href="#6a0b023d">What is LameXP ???</a>
25 <li><a href="#be0a8459">What platforms does LameXP run on?</a>
26 <li><a href="#29065b86">What output formats (encoders) does LameXP support?</a>
27 <li><a href="#4e398a46">What input formats (decoders) does LameXP support?</a>
28 <li><a href="#96205e91">My anti-virus program raises an alarm when I try to download, install or launch LameXP. Why is that?</a>
29 <li><a href="#fd53d98a">Who created LameXP?</a>
30 <li><a href="#de1c5e44">What license is LameXP released under?</a>
31 <li><a href="#303e5fa7">Do I have to pay for LameXP? / How can I donate to the authors of LameXP?</a>
32 <li><a href="#e75ad4ac">Why is the thing called "LameXP" although it does so much more?</a>
33 <li><a href="#054010d9">MP3, AAC/MP4, Vorbis, FLAC or Opus - What is the best audio format?</a>
34 <li><a href="#411d1257">What is the difference between the CBR, VBR and ABR rate control modes?</a>
35 <li><a href="#71a113b0">How do I enable AAC/MP4/M4A output (encoding) in LameXP?</a>
36 <li><a href="#126abc5a">Is there a way to output ".m4a" or ".aac" files with LameXP?</a>
37 <li><a href="#ebf016ab">How do I enable WMA input (decoding) in LameXP?</a>
38 <li><a href="#9fd53558">How can I use LameXP as a "portable" application?</a>
39 <li><a href="#3d6684e9">Is there a way to use custom tools (binaries) with LameXP instead of the "built-in" ones?</a>
40 <li><a href="#df406578">The LameXP startup (splash screen) takes very long on my system. What can I do?</a>
41 <li><a href="#a923d407">Why is there a time limit (expiration) in my version of LameXP?</a>
42 <li><a href="#900a2a6c">Is there a way to hide/show the LameXP console ("DOS Box") window?</a>
43 <li><a href="#9b0a5c32">Why does application 'xyz' not open the Wave files created by LameXP?</a>
44 <li><a href="#89cbd3d0">Why does LameXP run (only) N instances/threads in parallel on my computer?</a>
45 <li><a href="#454e51dd">Why does LameXP try to connect to the web-server at 'xyz.com' secretly?</a>
46 <li><a href="#12d077d5">How can I force LameXP to create ID3 version 2 (ID3v2) tags?</a>
47 <li><a href="#d83ab3c6">Why does LameXP use LAME v3.99 rather than v3.98?</a><br>
48 <li><a href="#4213adbc">Can LameXP be used to convert/extract tracks from an Audio CD?</a>
49 <li><a href="#434f2578">Why is the maximum normalization level limited to -0.5 dB?</a>
50 <li><a href="#9f8ff13a">What do the different 'Equalization' modes do?</a>
51 <li><a href="#c6d9dfed">Why does my encoded file come out slightly longer than the original?</a>
52 <li><a href="#ed4d30ed">Why is the Hibernation option disabled (greyed out) on my system?</a>
53 <li><a href="#54150e92">Why do random files fail with "Not Found!" or "Failed!" status?</a>
54 <li><a href="#3e999f02">Why is "Convert this file with LameXP" missing from the Explorer context menu somtimes?</a>
55 <li><a href="#e7c9ae2b">Why do I get the error 'Executable doesn't support Windows compatibility mode' on startup?</a>
56 <li><a href="#328b0a18">Why do I get the error 'Executable requires Windows XP or later' on startup?</a>
57 <li><a href="#3ffe490e">Why do I get the error 'The procedure entry point De/EncodePointer could not be located' on startup?</a>
58 <li><a href="#01922741">Why do I get the error 'LameXP.exe is not a valid Win32 application' on startup?</a>
59 <li><a href="#491aaad9">Why do I get the error 'A device attached to the system is not functioning' on startup?</a>
60 <li><a href="#a0fd5ae8">Why do I get the error 'File &acute;tool_foobar.exe&acute; could not be locked!' on startup?</a>
61 <li><a href="#f35cfa24">How can I translate LameXP to my language or improve an existing translation?</a>
62 <li><a href="#8dba381f">Where can I download the latest version of LameXP?</a>
63 <li><a href="#9c2e273d">Where can I submit bug reports or feature requests?</a>
64 <li><a href="#e5694e3e">What programming language is LameXP written in?</a><br>
65 <li><a href="#982cf1c0">Where can I find the LameXP source code?</a>
66 <li><a href="#a0c1e92b">What are the prerequisites to build LameXP from the sources?</a>
67 <li><a href="#87f001c0">How do I compile latest Qt as 'static' libraries?</a></ul>
68
69 <br><br>
70
71 <a name="6a0b023d"></a><b>What is LameXP ???</b><br>
72 <br>
73 LameXP is a graphical user-interface (front-end) for various of audio encoders: It allows you convert your<br>
74 audio files from one audio format to another one in the most simple way. Despite its name, LameXP is NOT only<br>
75 a front-end for the LAME encoder, but supports a wide range of output formats, including MP3, Ogg Vorbis,<br>
76 AAC/MP4, FLAC, AC-3 and Wave Audio. The number of supported input formats is even bigger! Furthermore LameXP<br>
77 does NOT only run on Windows XP, but also on Windows Vista, Windows 7 and many other operating systems.<br>
78 <br>
79 As all the encoders and decoders used by LameXP are already "built-in" (with one exception), you do NOT need<br>
80 to install any additional software, such as "Codecs", "Filters" or "Plug-ins", on your computer. Everything<br>
81 works "out of the box"! You can even use LameXP as a "portable" application, e.g. run it from your USB stick.<br>
82 Moreover LameXP was designed for batch processing. This means that you can convert a huge number of audio<br>
83 files, e.g. a complete album or even your entire music collection, in a single step. And, as LameXP is able<br>
84 to process several audio files in parallel, it takes full advantage of modern multi-core processors! However<br>
85 LameXP is NOT only optimized for speed, it also provides excellent sound quality by using the most<br>
86 sophisticated encoders available and by giving the user unrestricted control over all encoding parameters.<br>
87 <br>
88 In addition to that, LameXP provides full support for metadata, including cover art. So when converting your<br>
89 audio files, LameXP will retain existing meta tags. But there also is an easy-to-use editor for adding or<br>
90 modifying metadata. LameXP supports Unicode for both, meta tags and filenames, so there won't be any problems<br>
91 with "foreign" characters. And, thanks to our translators, the user-interface of LameXP is available in<br>
92 multiple languages. Last but not least, LameXP supports a number of post-processing filters, including sample<br>
93 rate conversion, normalization (gain), tone adjustment and downmixing of multi-channel sources.<br><br>
94
95 <br><br>
96
97 <a name="be0a8459"></a><b>What platforms does LameXP run on?</b><br>
98 <br>
99 LameXP is currently being developed on the following platforms:<br><ul>
100 <li>Microsoft Windows 7 (32-Bit and 64-Bit editions) with <a href="http://www.microsoft.com/en-us/download/details.aspx?id=5842" target="_blank">Service Pack 1</a>
101 <li>Microsoft Windows XP with <a href="http://www.microsoft.com/en-us/download/details.aspx?id=24" target="_blank">Service Pack 3</a></ul>
102 <br>
103 The following platforms should work too, but aren't tested extensively:<br><ul>
104 <li>Microsoft Windows 8 (32-Bit and 64-Bit editions)
105 <li>Microsoft Windows Vista (32-Bit and 64-Bit editions) with <a href="http://www.microsoft.com/en-us/download/details.aspx?id=15278" target="_blank">Service Pack 2</a>
106 <li>Microsoft Windows XP x64 Edition with <a href="http://www.microsoft.com/download/en/details.aspx?id=17791" target="_blank">Service Pack 2</a>
107 <li>Microsoft Windows Server 2008 with <a href="http://technet.microsoft.com/en-us/windows/dd262148" target="_blank">Service Pack 2</a>
108 <li>Microsoft Windows Server 2008 R2 with <a href="http://technet.microsoft.com/en-us/windows/gg635126" target="_blank">Service Pack 1</a>
109 <li>GNU/Linux (e.g. Ubuntu 12.04) using <a href="http://www.winehq.org/" target="_blank">Wine</a> v1.4+, native Linux version planned</ul>
110 <br>
111 The following "legacy" platforms are NOT supported any longer:<br><ul>
112 <li>Microsoft Windows 2000
113 <li>Microsoft Windows NT 4.0
114 <li>Microsoft Windows Millennium Edition (*)
115 <li>Microsoft Windows 98 (*)
116 <li>Microsoft Windows 95</ul>
117 <br>
118 (*) Some people claim that LameXP can run on Windows 98 SE or Millennium Edition with the help of <a href="http://sourceforge.net/projects/kernelex/" target="_blank">KernelEx</a>.<br><br>
119
120 <br><br>
121
122 <a name="29065b86"></a><b>What output formats (encoders) does LameXP support?</b><br>
123 <br>
124 Currently the following output formats are supported by LameXP:<br><ul>
125 <li>MPEG Audio-Layer III (MP3), using the <a href="http://lamexp.sourceforge.net/" target="_blank">LAME</a> encoder [built-in]
126 <li>Ogg Vorbis, using the <a href="http://www.xiph.org/vorbis/" target="_blank">OggEnc2/libvorbis</a> encoder with <a href="http://www.geocities.jp/aoyoume/aotuv/" target="_blank">aoTuV</a> [built-in]
127 <li>Advanced Audio Coding (AAC), using <a href="http://www.audiocoding.com/nero_aacenc.html" target="_blank">Nero AAC</a> encoder [separate download!]
128 <li>ATSC A/52 (aka "AC-3"), using the <a href="http://aften.sourceforge.net/" target="_blank">Aften</a> encoder [built-in]
129 <li>DCA, using the <a href="https://gitorious.org/dtsenc" target="_blank">DCA Enc</a> encoder (still experimental) [built-in]
130 <li>Free Lossless Audio Codec (<a href="http://flac.sourceforge.net/" target="_blank">FLAC</a>) [built-in]
131 <li>Opus Audio Codec, using the <a href="http://www.opus-codec.org/" target="_blank">Opus-Tools</a> by Xiph.org/Mozilla [built-in]
132 <li>Uncompressed PCM / Waveform Audio File (WAV/RIFF)</ul>
133
134 <br><br>
135
136 <a name="4e398a46"></a><b>What input formats (decoders) does LameXP support?</b><br>
137 <br>
138 Currently the following input formats are supported by LameXP:<br><ul>
139 <li>AC-3 (ATSC A/52), using Valib decoder [built-in]
140 <li>Advanced Audio Coding (AAC), using FAAD decoder [built-in]
141 <li>Apple Lossless (ALAC)
142 <li>Apple/SGI AIFF
143 <li>Avisynth, audio only [requires Avisynth 2.5.x to be installed]
144 <li>Digital Theater System, using Valib decoder [built-in]
145 <li>Free Lossless Audio Codec (FLAC)
146 <li>Microsoft ADPCM
147 <li>Monkey's Audio (APE)
148 <li>MPEG Audio-Layer I (MP1), using mpg123 decoder [built-in]
149 <li>MPEG Audio-Layer II (MP2), using mpg123 decoder [built-in]
150 <li>MPEG Audio-Layer III (MP3), using mpg123 decoder [built-in]
151 <li>Musepack
152 <li>Opus Audio Codec
153 <li>Shorten
154 <li>Speex
155 <li>Sun/NeXT Au
156 <li>The True Audio (TTA)
157 <li>Uncompressed PCM / Waveform Audio File (WAV/RIFF)
158 <li>WavPack Hybrid Lossless Audio
159 <li>Windows Media Audio (WMA), using wma2wav [built-in]</ul>
160
161 <br><br>
162
163 <a name="96205e91"></a><b>My anti-virus program raises an alarm when I try to download, install or launch LameXP. Why is that?</b><br>
164 <br>
165 Occasionally your anti-virus program may mistakenly(!) detect malware ("virus", "trojan horse", "worm", etc.)<br>
166 in LameXP. This is called a "false positive" and the file is actually innocent/clean. It's an error in your<br>
167 specific anti-virus software. So in case you encounter such problems, please use <a href="http://www.virustotal.com/" target="_blank">http://www.virustotal.com/</a>,<br>
168 <a href="http://www.virscan.org/" target="_blank">http://www.virscan.org/</a> or a similar online-service to check the file in question with multiple(!) anti-virus<br>
169 engines. Especially take care with heuristic scan results like "suspicious", "generic" or "packed". Such<br>
170 results are NOT confirmed malware detections - they are speculative and almost always can be ignored safely!<br>
171 <br>
172 Apparently anti-virus programs tend to suspect installers or uninstallers created with <a href="http://nsis.sourceforge.net/" target="_blank">NSIS</a>. Furthermore some<br>
173 anti-virus programs blindly suspect ALL "packed" executables of being malware. Obviously that is a stupid<br>
174 generalization, because "EXE packers" are commonly used by legitimate software (inlcuding a large number of<br>
175 OpenSource tools), so please ignore these nasty warnings! Last but not least: Always keep in mind that LameXP<br>
176 is free software. If you don't trust the pre-compiled LameXP binaries that we provide, simply download the<br>
177 <a href="#982cf1c0">source codes</a>, search the code for "malicious" functions (you won't find any ^^) and <a href="#a0c1e92b">compile</a> LameXP yourself!<br>
178 <br>
179 Another important fact to consider is that for the creator of LameXP, it is impossible to know WHY a specific<br>
180 anti-virus program is failing on our software. That's because anti-virus programs usually are proprietary<br>
181 ClosedSource applications, so we cannot know what's going on "behind the scenes". Consequently any attempt to<br>
182 guess what "aspect" of LameXP the anti-virus software is misinterpreting as malware would be pure speculation<br>
183 and might even change with the next anti-virus update. Only the developer of the anti-virus program can fix<br>
184 bugs inside the anti-virus program. So please report these bugs to the developer of your anti-virus program!<br>
185 <br>
186 Finally, be aware that we are NOT liable for any files (downloads), except for those that are directly linked<br>
187 on the official LameXP web-site or on one of the <a href="#8dba381f">official mirros</a>. Other web-sites may be redistributing our<br>
188 software, but we are NOT affiliated with or funded by any of these web-sites. So while the license of LameXP<br>
189 allows redistribution, there is absolutely NO guarantee that binaries offered by third parties are genuine!<br>
190 <br>
191 Conclusion:<ul>
192 <li>IN CASE YOU HAVE A CONFIRMED INFECTION, RE-DOWNLOAD THE FILE FROM ONE OF THE *OFFICIAL* MIRRORS!
193 <li>DO NOT SEND US VIRUS REPORTS, UNLESS YOU HAVE VERIFIED THE INFECTION WITH MULTIPLE ANTI-VIRUS ENGINES!
194 <li>PLEASE REPORT "FALSE POSITIVES" TO THE DEVELOPER OF YOUR ANTI-VIRUS SOFTWARE. WE CANNOT FIX THEM!
195 <li>THERE ARE PLENTY OF ANTI-VIRUS PROGRAMS TO CHOOSE FROM. YOU DON'T NEED TO STICK WITH A NEUROTIC ONE!</ul>
196
197 <br><br>
198
199 <a name="fd53d98a"></a><b>Who created LameXP?</b><br>
200 <br>
201 LameXP was written from the scratch by <a href="mailto:mulder2-nospam&#64;gmx.de">LoRd_MuldeR &lt;MuldeR2&#64;GMX.de&gt;</a>. However it has to be noted that LameXP<br>
202 uses a number of third-party tools, which have been created by the individual authors. Moreover various<br>
203 people have contributed LameXP translations. Please see the "About" dialog for details! Also please do NOT<br>
204 send e-mail to LoRd_MuldeR directly, if the problem or suggestion can be discussed in the <a href="#9c2e273d">support</a> forums!<br>
205 <br>
206 More OpenSource projects by LoRd_MuldeR at <a href="http://muldersoft.com/" target="_blank">http://muldersoft.com/</a> and <a href="http://mulder.googlecode.com/" target="_blank">http://mulder.googlecode.com/</a>.<br><br>
207
208 <br><br>
209
210 <a name="de1c5e44"></a><b>What license is LameXP released under?</b><br>
211 <br>
212 LameXP is free software. You can redistribute it and/or modify it under the terms of the GNU General Public<br>
213 License (GPL) as published by the Free Software Foundation; either version 2 of the License, or (at your<br>
214 option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY<br>
215 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.<br>
216 <br>
217 The licenses for most software and other practical works are designed to take away your freedom to share and<br>
218 change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share<br>
219 and change all versions of a program &#45; to make sure it remains free software for all its users.<br>
220 <br>
221 Please see the <a href="http://www.gnu.org/licenses/gpl-2.0.html" target="_blank">GNU General Public License</a> for more details!<br><br>
222
223 <br><br>
224
225 <a name="303e5fa7"></a><b>Do I have to pay for LameXP? / How can I donate to the authors of LameXP?</b><br>
226 <br>
227 LameXP is <a href="http://en.wikipedia.org/wiki/Free_software" target="_blank">free software</a>, so you may use it for free and for any purpose. Moreover the authors of LameXP<br>
228 currently do NOT accept any donations. Therefore you should NOT pay or donate any money in order to obtain<br>
229 LameXP! However it was brought to our attention that some dubious third-party web-sites offer "payed"<br>
230 downloads of LameXP and/or include Adware into the LameXP download. We do NOT cooperate with any of these<br>
231 sites. So if you pay for the LameXP download, the authors of LameXP will not get a single cent! Instead you<br>
232 should save your money and download LameXP from the official mirrors (<a href="#8dba381f">see below</a>), which is 100% free.<br>
233 <br>
234 If you want to support the development of LameXP, you can do so by contributing translations or code :-)<br><br>
235
236 <br><br>
237
238 <a name="e75ad4ac"></a><b>Why is the thing called "LameXP" although it does so much more?</b><br>
239 <br>
240 LameXP was created as a (very simple!) GUI front-end to the LAME MP3 encoder, back in 2004. That version did<br>
241 NOT support any encoders except for LAME, it did NOT support any input formats other than Wave Audio files,<br>
242 it did NOT support any audio filters, it did NOT support multi-threading, it did NOT support Unicode file<br>
243 names and it did NOT handle meta data at all. Because the program really was nothing but (yet another) LAME<br>
244 front-end for Windows and because at that time Windows XP was the operating system of choice - for many<br>
245 people it still is nowadays - I decided to call the program "LameXP" (aka "LAME for Windows XP"). Since then<br>
246 more and more features have been added to LameXP. The program even went through two complete re-writes. Thus<br>
247 the name "LameXP" may not be the most meaningful one, especially because the program supports a huge number<br>
248 of encoders and decoders now, but I'm obviosuly lacking the creativity to come up with a better name. Also I<br>
249 think we already have enough doubious "super-duper everything to everything converter" programs out there...<br>
250 <br>
251 So to make a long story short: The name has historical reasons and probably isn't going to change ;-)<br><br>
252
253 <br><br>
254
255 <a name="054010d9"></a><b>MP3, AAC/MP4, Vorbis, FLAC or Opus - What is the best audio format?</b><br>
256 <br>
257 This question can NOT be answered in general. The best audio format is the format that works best for you!<br>
258 <br>
259 Having said that, let's have a look at the output formats supported by LameXP: MPEG-1 Audio Layer III, better<br>
260 known as "MP3", was released in 1993 and probably still is the most widely used and most widely supported<br>
261 compressed audio format. So if compatibility is your concern, MP3 is a good choice. Also MP3 can retain very<br>
262 good quality - at higher bitrates. However MP3 does not support multi-channel audio and it does not perform<br>
263 well at lower bitrates. MP3 also is pretty restrictive with the sampling rates and bitrates that it supports.<br>
264 <br>
265 Advanced Audio Coding, often abbreviated as "AAC", was introduced as part of the MPEG-2 standard (1997) and<br>
266 has been adopted by the MPEG-4 standard later (1999). AAC is often considered to be the "successor" of MP3.<br>
267 Compared to MP3, AAC adds support for multi-channel audio, it support more sampling rates as well as more<br>
268 flexible bitrates. Two variants of AAC are commonly used: Low-Complexity (LC) and High-Efficiency (HE). While<br>
269 LC-AAC is intended for medium to high bitrates, LC-AAC works best at low bitrates. At low bitrates, HE-AAC<br>
270 clearly outperforms MP3 - at higher bitrates the differences aren't that clear. AAC streams are usually, but<br>
271 not necessarily, encapsulated in an MP4 (MPEG-4 Part 14) container. That's why AAC audio files almost always<br>
272 have an ".mp4" file extension. Still the audio format is AAC - MP4 is only the container! Be aware that some<br>
273 applications create audio-only MP4 files with a non-standard (wrong) ".m4a" file extension. AAC is widely<br>
274 supported too nowadays (especially in "mobile" devices), though not all players fully support the HE variant.<br>
275 <br>
276 Vorbis, often called "Ogg Vorbis", is a free audio format, developed by the Xiph foundation and released in<br>
277 2000. In contrast to MP3/AAC, Vorbis is 100% patent-free. Vorbis streams are usually, but not necessarily,<br>
278 encapsulated in an Ogg container (developed by Xiph too) and thus Vorbis files almost always have an ".ogg"<br>
279 file extension. Vorbis is known to outperform MP3 at the same bitrate, although the differences are less<br>
280 apparent at high bitrates. Furthermore HE-AAC has been known to outperform Vorbis at lower bitrates, though<br>
281 there now is a tuned Vorbis encoder ("aoTuV") which further improves the quality of Vorbis - especially at<br>
282 the lower bitrates. Hardware support for Ogg Vorbis is worse than for MP3/AAC, but it's constantly improving.<br>
283 <br>
284 Free Lossless Audio Codec, better known as "FLAC", is a lossless audio format. This means that in contrast to<br>
285 MP3, AAC and Vorbis, with the FLAC compression there is absolutely no loss in quality. This made FLAC famous<br>
286 among "audiophile" people. However the lossless nature of FLAC comes at a big disadvantage: The compression<br>
287 ratio of FLAC files isn't anywhere near the "lossy" audio formats. Or in other words: FLAC files are huge!<br>
288 They are not as big as uncompressed Wave files, but usually the size cannot be reduced to less than 75%. Just<br>
289 like Ogg Vorbis, hardware support for FLAC files is worse than for MP3/AAC, but it's constantly improving.<br>
290 <br>
291 Opus is a new audio format which, at this time (Aug 2012), is still under active development. It is being<br>
292 developed by engineers from Xiph, Mozilla and Skype/Microsoft. Opus has been accepted as an upcoming Internet<br>
293 standard by the IETF recently. The Opus format is designed to work for low-latency speech encoding (VoIP) as<br>
294 well as for high-quality music encoding. Opus is sometimes referred to as the "successor" of both, Vorbis and<br>
295 Speex (the latter is Xiph's current speech codec). Currently, Opus reaches the quality of 128 kbps MP3 at an<br>
296 bitrate of 80 kbps. As the development is still in progress, significant improvements are to be expected.<br>
297 <!--
298 there are a few things to consider. First of all: All output formats supported by LameXP,<br>
299 except for FLAC and PCM/Wave, use a lossy(!) kind of compression. That applies to MP3 and AAC as well as<br>
300 Vorbis. Consequently with these formats a certain quality loss is unavoidable when re-encoding/converting, no<br>
301 matter what. This is called "generation loss". Nonetheless all three formats (MP3, AAC and Vorbis) are able<br>
302 to retain an EXCELLENT audio quality, given that the chosen bitrate (quality level) is sufficient/reasonable.<br>
303 <br>
304 Secondly, the audio quality does not depend on the audio format and the chosen bitrate only. It also depends<br>
305 greatly on the encoder software that is being used. LameXP uses the LAME MP3 encoder, probably the most<br>
306 sophisticated MP3 encoder out there, the Nero AAC encoder, one of the best AAC encoders available, and the<br>
307 aoTuV Vorbis encoder, an improved/tuned version of the reference Vorbis encoder. Consequently LameXP provides<br>
308 you with state-of-the-art encoders, which ensures maximum encoding quality for ALL supported output formats.<br>
309 <br>
310 Another thing to consider is hardware support, i.e. support on stand-alone and portable players. The MP3<br>
311 format still has the best support on hardware players, but support for AAC/MP4 has become widespread too -<br>
312 especially on portable devices. Hardware support for Vorbis is more limited, but growing. So if portability<br>
313 is a priority, then MP3 is a good choice. However the MP3 format does NOT support multi-channel audio, which<br>
314 means that you will have to use AAC or Vorbis for multi-channel files. Last but not least, if you prefer a<br>
315 truly "open" and patent-free audio format, then Vorbis will be the format of your choice!<br>
316 -->
317 <br>
318 <br>
319 Another resource you might find interesting are Sebastian's Public Listening Tests:<br><ul>
320 <li><a href="http://listening-tests.hydrogenaudio.org/sebastian/mp3-128-1/results.htm" target="_blank">MP3 listening test @ 128 kbps, includes MP3 encoders (like LAME) only</a>
321 <li><a href="http://listening-tests.hydrogenaudio.org/sebastian/mf-128-1/results.htm" target="_blank">Multiformat listening test @ 128 kbps, includes LAME MP3, Vorbis AoTuV and others</a>
322 <li><a href="http://listening-tests.hydrogenaudio.org/sebastian/mf-64-1/results.htm" target="_blank">Multiformat listening test @ 64 kbps, includes Vorbis AoTuV, Nero AAC and others</a>
323 </ul>
324 (However be aware that some of the results from these listening tests are not up-to-date anymore)<br><br>
325
326 <br><br>
327
328 <a name="411d1257"></a><b>What is the difference between the CBR, VBR and ABR rate control modes?</b><br>
329 <br>
330 CBR means "constant bitrate" and, as the name implies, CBR mode allocates the bits at a constant rate. This<br>
331 means that each part of the audio will get the same amount of bits, regardless of its content. Obviously this<br>
332 will waste bits in parts of the audio that are "easy" to compress. At the same time the quality of parts of<br>
333 the audio that are "hard" to compress will be degraded. Consequently using CBR mode is NOT a very good idea,<br>
334 unless you really have to enforce a 100% constant bitrate (this is almost NEVER the case). However CBR mode<br>
335 has the advantage that the final size of the compressed file is perfectly predictable. The resulting file<br>
336 size is defined simply as "duration &times; fixed_bitrate". Note: The file size *is* predictable with ABR mode too!<br>
337 <br>
338 VBR means "variable bitrate" and, in contrast to CBR mode, VBR mode allows the bitrate to vary/fluctuate.<br>
339 Thus the VBR mode enables the encoder to adapt the bitrate with respect to the content of the audio. Parts of<br>
340 the audio that are "easy" to compress will get a lower bitrate in order to avoid wasting bits there. At the<br>
341 same time, parts of the audio that are "hard" to compress will get a higher bitrate in order to avoid quality<br>
342 degradation. Or in other words: VBR mode "moves" the bits to the locations where they are actually needed!<br>
343 Therefore the VBR mode achieves a much better compression efficiency than the CBR mode. This means with VBR<br>
344 mode you can get a better quality at the same file size - or the same quality at a smaller file size. One<br>
345 disadvantage of the VBR mode, however, is that the final size of the compressed file can NOT be predicted.<br>
346 The resulting file size now is defined as "duration &times; average_bitrate", but the average bitrate is NOT<br>
347 known beforehand. That's because the average bitrate for a specific VBR quality level can vary greatly,<br>
348 depending solely on the complexity of the individual audio. With VBR mode the encoder uses as many bits as<br>
349 required to achieve the desired level of quality. That clearly makes VBR the preferred encoding mode.<br>
350 <br>
351 ABR means "average bitrate". You can think of ABR mode as a compromise between the CBR and VBR mode. With ABR<br>
352 mode the bitrate is allowed to vary/fluctuate, similar to VBR mode. However the ABR mode doesn't work with a<br>
353 predefined/fixed quality level, as VBR mode does. Instead in ABR mode the encoder will continuously re-adjust<br>
354 the quality level in order to hit the target average(!) bitrate. You can also think of ABR mode as a mode<br>
355 that pre-allocates the bits in a CBR-like fashion and then redistributes the bits within a local neighborhood<br>
356 as needed. Thus the ABR mode combines advantages of CBR mode (predictability) and VBR mode (higher quality).<br>
357 The final size of the encoded file is still defined as "duration &times; average_bitrate", but with ABR mode the<br>
358 average bitrate *is* known beforehand. So if you need to hit a specific file size, ABR mode is the solution.<br>
359 Using ABR mode is to be preferred over CBR mode. Nonetheless VBR mode usually provides the best experience.<br>
360 <br>
361 <br>
362 Hint: The Nero AAC encoder supports a variant of the ABR mode, the so-called "2-Pass" mode. That mode scans<br>
363 through the entire file once (first pass) before the actual encoding is performed (second pass). This way the<br>
364 encoder is able to distribute the bits over the entire file and still hit the desired target average bitrate.<br>
365 It should be obvious that the advantages of the "2-Pass" mode come at the cost of increased encoding time.<br>
366 <br>
367 Hint: A common mistake done by people comparing rate control modes is choosing a bitrate that is too high. Of<br>
368 course only files of an identical (average) bitrate can be compared by quality. But if that bitrate is chosen<br>
369 too high, you won't be able to draw any conclusions from the test. That's because at a certain bitrate even<br>
370 the CBR mode will retain excellent quality. In that situation VBR mode or ABR mode can't give an even better<br>
371 quality for obvious reasons. But drawing the conclusion that there is no difference between CBR mode and the<br>
372 VBR/ABR modes would be very wrong! The differences will become significant when using a reasonable bitrate.<br>
373 Another mistake is starting with a low-quality source file and concluding that all modes perform equally bad.<br>
374 <br>
375 <br>
376 SUMMARY ON RATE CONTROL MODES:<br><ul>
377 <li>Need to hit a specific fixed file size and still want to retain a decent quality? &rArr; ABR mode
378 <li>Want to retain a certain level of quality and hitting an exact file size is not needed? &rArr; VBR mode
379 <li>Avoid CBR mode by all means, unless there are "external" restrictions that force you to use it!</ul>
380
381 <br><br>
382
383 <a name="71a113b0"></a><b>How do I enable AAC/MP4/M4A output (encoding) in LameXP?</b><br>
384 <br>
385 LameXP uses the Nero AAC Encoder for creating AAC/MP4/M4A files. The Nero AAC Encoder is available as a free<br>
386 download. However the license doesn't allow redistribution! Therefore we can NOT ship the Nero encoder along<br>
387 with LameXP. Instead you will have to obtain the Nero encoder as a separate download from the official "Nero<br>
388 Digital" web-site. Currently you'll find the latest Nero AAC Encoder version at this location:<br><ul>
389 <li><a href="http://www.nero.com/deu/downloads-nerodigital-nero-aac-codec.php" target="_blank">http://www.nero.com/deu/downloads-nerodigital-nero-aac-codec.php</a>
390 <li><a href="http://ftp6.nero.com/tools/" target="_blank">http://ftp6.nero.com/tools/</a></ul>
391 <br>
392 After you have downloaded the Nero AAC Encoder as a ZIP file, you must "install" the encoder binaries, so<br>
393 LameXP can use them. Simply unzip the files 'neroAacEnc.exe', 'neroAacDec.exe' as well as 'neroAacTag.exe' to<br>
394 the same directory where your LameXP executable ('LameXP.exe') is located. For unzipping the ZIP file you can<br>
395 use any suitable archiver, such as <a href="http://rarlabs.com/download.htm" target="_blank">WinRAR</a> or <a href="http://sevenzip.sourceforge.net/" target="_blank">7-Zip</a>. Once the required Nero encoder binaries are located in<br>
396 the LameXP directory, the AAC encoding option should be "enabled" on the next startup of LameXP.<br>
397 <br>
398 <br>
399 QAAC Encoder<br>
400 <br>
401 Optionally LameXP supports the QAAC encoder, i.e. the AAC encoder used by QuickTime and iTunes. Just like the<br>
402 Nero AAC encoder, the QAAC encoder can NOT be redistributed along with LameXP. Thus if you want to use the<br>
403 QAAC encoder, then you have to install QuickTime v7.7.1 (or newer). Alternatively iTunes v10.5 (or newer) can<br>
404 be installed. Both, QuickTime and iTunes, can be <a href="http://www.apple.com/quicktime/download/" target="_blank">downloaded for free</a> from the official Apple web-site.<br>
405 <br>
406 In order to enable the QAAC Encoder support you will also need the 'QAAC Encoder Add-in' for LameXP:<br><ul>
407 <li><a href="http://www.mediafire.com/file/o5is7bqporboa7b/LameXP.qaac-addin.2012-08-05.zip" target="_blank">http://www.mediafire.com/file/o5is7bqporboa7b/LameXP.qaac-addin.2012-08-05.zip</a>
408 <li><a href="http://mulder.brhack.net/public/add-in/LameXP.qaac-addin.2012-08-05.zip" target="_blank">http://mulder.brhack.net/public/add-in/LameXP.qaac-addin.2012-08-05.zip</a></ul>
409 <br>
410 Please follow the install instructions that are included with the 'QAAC Encoder Add-in' download package!<br>
411 Note that you do NOT need to install this Add-in, if you only want to use the Nero AAC Encoder.<br>
412 <br>
413 <br>
414 FHG AAC Encoder<br>
415 <br>
416 Optionally LameXP also supports the FHG AAC Encoder now. Just like the Nero encoder, the FHG encoder can NOT<br>
417 be redistributed along with LameXP. However the FHG AAC Encoder is included with Winamp v5.62, which is<br>
418 available as a free download (you don't need to buy the "Pro" version!) from the official Winamp web-site at:<br><ul>
419 <li><a href="http://www.winamp.com/media-player/" target="_blank">http://www.winamp.com/media-player/</a>
420 <li><a href="http://download.nullsoft.com/winamp/client/winamp5623_full_emusic-7plus_all.exe" target="_blank">http://download.nullsoft.com/winamp/client/winamp5623_full_emusic-7plus_all.exe</a></ul>
421 <br>
422 In order to enable the FHG AAC Encoder support you will also need the 'FHG AAC Encoder Add-in' for LameXP:<br><ul>
423 <li><a href="http://www.mediafire.com/file/ni7w4323pqub9x3/LameXP.fhgaacenc-addin.2012-08-06.zip" target="_blank">http://www.mediafire.com/file/ni7w4323pqub9x3/LameXP.fhgaacenc-addin.2012-08-06.zip</a>
424 <li><a href="http://mulder.brhack.net/public/add-in/LameXP.fhgaacenc-addin.2012-08-06.zip" target="_blank">http://mulder.brhack.net/public/add-in/LameXP.fhgaacenc-addin.2012-08-06.zip</a></ul>
425 <br>
426 Please follow the install instructions that are included with the 'FHG AAC Encoder Add-in' download package!<br>
427 Note that you do NOT need to install this Add-in, if you only want to use the Nero AAC Encoder.<br><br>
428
429 <br><br>
430
431 <a name="126abc5a"></a><b>Is there a way to output ".m4a" or ".aac" files with LameXP?</b><br>
432 <br>
433 LameXP uses the Nero AAC Encoder for AAC encoding. And the Nero encoder always puts the AAC streams into an<br>
434 MP4 (MPEG-4 Part 14) container - in almost any case that is exactly what you want/need! The one and only<br>
435 "correct" file extension for MP4 files is '.mp4'. However sometimes the "incorrect" file extension '.m4a' is<br>
436 used to indicate "audio-only" MP4 files. Even worse: There are some buggy (hardware) players that will<br>
437 recognize MP4 audio file only with the "incorrect" .m4a extension, but NOT with the "correct" .mp4 extension.<br>
438 Of course LameXP will save your MP4 files with the "correct" .mp4 extension. But if you need your MP4 files<br>
439 with an .m4a extension for some reason, you can simply rename(!) these files. Renaming isn't more or less<br>
440 "incorrect" than saving the files as .m4a directly. After all, an MP4 file remains an MP4 file.<br>
441 <br>
442 Warning: While renaming .mp4 files to .m4a (or vice versa) is safe, because both file extensions refer to MP4<br>
443 files, you must NOT rename any .mp4/.m4a files to .aac (or the other way around). That's because the '.aac'<br>
444 extension is used with "raw" AAC streams (ADTS format), i.e. AAC streams that are explicitly NOT stored in an<br>
445 MP4 container! Unfortunately the Nero AAC encoder has NO option to output "raw" AAC streams. And usually you<br>
446 don't need such streams. Still, if you really need to extract the "raw" AAC stream (.aac) from an MP4 file,<br>
447 you can simply use <a href="http://www.videohelp.com/tools/mp4box" target="_blank">MP4Box</a> for that purpose. Please note that <a href="http://yamb.unite-video.com/">YAMB</a> is a great MP4Box GUI created by Kurtnoise.<br><br>
448
449 <br><br>
450
451 <a name="ebf016ab"></a><b>How do I enable WMA input (decoding) in LameXP?</b><br>
452 <br>
453 LameXP now uses its "built-in" WMA decoder, thanks to 'wma2wav'. However it has to be noted that the WMA<br>
454 decoder relies on the Windows Media Format Runtime. All supported versions of Microsoft Windows should have<br>
455 the Windows Media Format Runtime installed as part of the Windows Media Player. But Wine does not! In case<br>
456 you encounter problems with the WMA decoder, try installing the <a href="http://anonym.to/http://www.citizeninsomniac.com/WMV/wmfdist11.exe" target="_blank">Windows Media Format Runtime</a> manually. This<br>
457 should also work under Wine. The 'N' or 'KN' editions of Windows 7 need the <a href="http://www.microsoft.com/download/en/details.aspx?id=16546" target="_blank">Windows Media Feature Pack</a>.<br><br>
458
459 <br><br>
460
461 <a name="9fd53558"></a><b>How can I use LameXP as a "portable" application?</b><br>
462 <br>
463 LameXP always is "portable", in the sense that the application works out of the box: LameXP does NOT require<br>
464 any additional software, such as codecs, encoders, decoders or runtime libraries, and it will NOT install<br>
465 anything of that kind on your local computer! All the third-party tools used by LameXP are already built-in.<br>
466 There currently are two notable exceptions: The Nero AAC encoder and the WMA decoder cannot be redistributed<br>
467 along with LameXP for legal reasons. Therefore these tools have to be obtained as separate downloads.<br>
468 <br>
469 Having said that, LameXP stores its configuration file in the <a href="http://msdn.microsoft.com/en-us/library/dd378457(v=vs.85).aspx#FOLDERID_LocalAppData" target="_blank">%LOCALAPPDATA%</a> folder on the local computer.<br>
470 That's because on a modern multi-user operating this is the only "correct" folder to store user-specific<br>
471 configuration files. Also it's one of the few folders where an application is guaranteed to get write-access,<br>
472 even when the application was launched by a "normal" (non-admin) user and did not request elevated rights.<br>
473 Storing the configuration file in the "install" folder is antiquated and highly error-prone.<br>
474 <br>
475 Still some users may want to store the configuration file in the same folder as the LameXP executable file,<br>
476 e.g. when launching LameXP directly from their USB stick on different computers. For this purpose LameXP now<br>
477 offers a "true" portable mode. You can enable that mode simply by renaming the LameXP executable file to<br>
478 "LameXP-Portable.exe". But be aware: When running LameXP in the "portable" mode, the user(!) must ensure that<br>
479 write-access is granted to the directory where the LameXP executable is located.<br><br>
480
481 <br><br>
482
483 <a name="3d6684e9"></a><b>Is there a way to use custom tools (binaries) with LameXP instead of the "built-in" ones?</b><br>
484 <br>
485 LameXP uses a number third-party tools. All of these tools are already "built-in" (with a few exceptions) and<br>
486 thus it is NOT required to provide separate binaries. Usually it will NOT be necessary to replace any of<br>
487 the "built-in" tools with a custom (user-provided) binary. If, however, you need to replace/update/downgrade<br>
488 one of the binaries for a good reason, the recommended method is re-building LameXP from the sources. If you<br>
489 don't know how to build LameXP from the sources, then you probably shouldn't be trying to replace the binary.<br>
490 <br>
491 Having said that, there now is a more convenient method for using a custom tool version (binary) instead of<br>
492 the "built-in" one. This method works WITHOUT re-building LameXP. However note that the following is intended<br>
493 for testing and debugging purposes only! Also note that LameXP was specifically designed to work with the<br>
494 "built-in" versions of the tools. It may not work properly or may not work at all with custom tool versions!<br>
495 <br>
496 In order to replace a "built-in" binary, simply put the user-provided binary to the following location:
497 <blockquote>&lt;install_folder&gt;\tools\&lt;build_number&gt;\&lt;tool_name&gt;.exe</blockquote>
498 If, for example, you want to replace 'lame.exe' in Build #666 of LameXP, you would put it to the this path:
499 <blockquote>C:\Path to your LameXP install folder\tools\666\lame.exe</blockquote>
500 (It is intended that the '&lt;build_number&gt;' part of the path has to be adjusted with every update of LameXP)<br><br>
501
502 <br><br>
503
504 <a name="df406578"></a><b>The LameXP startup (splash screen) takes very long on my system. What can I do?</b><br>
505 <br>
506 Starting up LameXP shouldn't take longer than approximately 10 seconds. However it was brought to our<br>
507 attention that badly optimized anti-virus software can slow down the startup procedure a lot! On our test<br>
508 system (Windows 7 running on an Intel Core2 Q6600 with 4 GB of RAM) starting up LameXP takes about 3 seconds<br>
509 without an anti-virus software and about 6 seconds with the "real-time protection" of Microsoft Security<br>
510 Essentials enabled. With other anti-virus software the startup was delayed up to 20 seconds and more!<br>
511 <br>
512 So if you think that LameXP is starting up too slow on your system, you should temporarily(!) disable or<br>
513 uninstall your current anti-virus program and try again. Usually it should be sufficient to disable only the<br>
514 "real-time protection", "file system protection" or "guard" feature of your anti-virus software. If it turns<br>
515 out that the startup is significantly(!) faster WITHOUT the anti-virus software, please report the problem to<br>
516 the developer of the anti-virus software. And, if they don't fix the problem, switch to a better product!<br><br>
517
518 <br><br>
519
520 <a name="a923d407"></a><b>Why is there a time limit (expiration) in my version of LameXP?</b><br>
521 <br>
522 LameXP is free software, released under the GPL. This means that you may use LameXP for free and without any<br>
523 restrictions. More specifically, there is NO time limit (expiration) in any "Release" versions of LameXP!<br>
524 Nonetheless, the "Beta" (pre-release) versions of LameXP will expire 30 days after build date. That's because<br>
525 these "Beta" versions are intended for testing and evaluation only. They are NOT intended for productive use.<br>
526 After the 30 days have expired, you will have to update your "Beta" version of LameXP to the latest version.<br>
527 Usually there will be frequent updates for "Beta" versions though. So, most of the time, a new update will be<br>
528 available even before the previous build has expired. We highly recommend to install all updates as soon as<br>
529 possible instead of waiting for the expiration. If you are NOT willing to update LameXP regularly, stick with<br>
530 the "Release" version. The "Release" versions of LameXP are updated less frequently and they won't expire.<br>
531 <br>
532 Note: We are well aware that the expiration mechanism implemented in LameXP can be circumvented quite easily,<br>
533 if you really want to. But implementing a "better" mechanism is pointless for an OpenSource software ;-)<br><br>
534
535 <br><br>
536
537 <a name="900a2a6c"></a><b>Is there a way to hide/show the LameXP console ("DOS Box") window?</b><br>
538 <br>
539 It is common for many people to run an alleged "DOS" program inside Windows, using a so-called "DOS Box".<br>
540 Everything works fine. But when you try to run such a program in DOS, you get an ugly message "This program<br>
541 cannot be run in DOS mode". What's wrong? Well, the affected program is NOT a "DOS" one. It is a Windows<br>
542 Console program. "DOS" is NOT a synonym of Console. And "Windows" is NOT a synonym of GUI (Graphical User<br>
543 Interface). Both, DOS and Windows programs, can be either Console or GUI. Actually Windows programs can be<br>
544 Console *and* GUI at the same time, i.e. a Windows GUI program can have a Console attached.<br>
545 <br>
546 LameXP is a GUI program for Windows. However it can have a "Debug" console attached. The purpose of this<br>
547 console is providing users an insight into what's happening behind the scenes. While the console is mainly<br>
548 intended for developers, it may be helpful for "regular" users too. Nonetheless you usually will NOT need the<br>
549 console, unless something is going wrong. Therefore the LameXP console is disabled by default in all<br>
550 "release" builds. You can enable the console by passing the "--console" command-line parameter, if required.<br>
551 At the same time the console is enabled by default in all "beta" (pre-release) builds of LameXP. You can<br>
552 still disable the console by passing the "--no-console" command-line parameter, if you don't like it.<br>
553 <br>
554 WARNING: Any attempt to close the LameXP console window will kill the application immediately !!!<br><br>
555
556 <br><br>
557
558 <a name="9b0a5c32"></a><b>Why does application 'xyz' not open the Wave files created by LameXP?</b><br>
559 <br>
560 Some of the decoders used in LameXP will insert an additional 'JUNK' chunk into the Wave/RIFF file, right<br>
561 before the 'fmt' chunk ("Wave header"). There are technical reasons why this 'JUNK' chunk (placeholder) might<br>
562 be needed at the beginning of the file. The 'JUNK' type is a standard RIFF type and, by definition of the<br>
563 RIFF file format specification, any reading application must ignore/skip all 'JUNK' chunks it may encounter!<br>
564 Evidently most reading applications do so and thus will correctly open the Wave file. Unfortunately it was<br>
565 brought to our attention that there are a few broken(!) applications, which reject Wave/RIFF files with an<br>
566 additional 'JUNK' chunk in front of the 'fmt' chunk. It seems that these applications make false assumptions<br>
567 and expect the 'fmt' chunk to be located at a fixed position, rather than parsing the RIFF structure.<br>
568 <br>
569 While it is evident that applications, which reject the Wave/RIFF file because of the extra 'JUNK' chunk, are<br>
570 broken with respect to the RIFF specification and should be fixed by the respective author, there is an easy<br>
571 workaround: Re-saving the Wave/RIFF file with <a href="http://sox.sourceforge.net/" target="_blank">SoX</a> creates a file that even the broken applications seem to<br>
572 accept, as SoX apparently doesn't insert any 'JUNK' chunks (although it would be free to do so!) Re-saving<br>
573 your Wave file with SoX does NOT change the actual content at all, as long as no additional filters are used.<br>
574 <br>
575 You can use a command-line like this:<br>
576 <blockquote><font class="code">sox.exe "c:\some path\input.wav" "c:\some path\output.wav"</font></blockquote>
577
578 <br><br>
579
580 <a name="89cbd3d0"></a><b>Why does LameXP run (only) N instances/threads in parallel on my computer?</b><br>
581 <br>
582 LameXP is able to run multiple instances of the encoder or decoder in parallel. This is done in order to<br>
583 maximize the CPU utilization on modern "multi-core" processors, which will significantly speed up the overall<br>
584 encoding process. However be aware that LameXP uses file-based parallelization. This means that the maximum<br>
585 number of instances that can run in parallel is limited by the number of files that are processed. If, for<br>
586 example, you convert only a single file, then NO parallelization will be possible. If, instead, you convert<br>
587 multiple files at once, then LameXP can run as many instances in parallel as files are being converted.<br>
588 <br>
589 Within the aforementioned limitations, LameXP will selected the number of parallel instances based on the<br>
590 number of available processors (CPU cores) on the individual system. However LameXP will NOT use a one-to-one<br>
591 mapping! Instead a custom-made 'cubic spline' function is used to map the number of CPU cores to the maximum<br>
592 number of instances. This function has the following properties: On systems with at most four CPU cores, the<br>
593 maximum number of parallel instances will be identical to the number of CPU cores. On systems with eight CPU<br>
594 cores, the maximum number of parallel instances is six. On systems with 16 cores, the maximum number of<br>
595 parallel instances is eight. On systems with 32 cores, the maximum number of parallel instances is eleven.<br>
596 And on systems with 64 cores, the maximum number of parallel instances is 16. 16 is the upper limit.<br>
597 <br>
598 <a href="http://img853.imageshack.us/img853/1428/corestoinstancesbig.png" target="_blank"><img src="http://img853.imageshack.us/img853/1428/corestoinstancesbig.th.png" border="0" alt="thumb"></a><br>
599 <br>
600 You may wonder why LameXP doesn't always create one instance for each CPU core. In theory, the more instances<br>
601 we run in parallel, the more CPU cores can be utilized - until all CPU cores are busy and the overall CPU<br>
602 usage approaches 100%. In reality, however, there are some "shared" resources on each computer. And, the more<br>
603 instances we run in parallel, the more processes will be competing for these shared resources! Specifically,<br>
604 the amount of main memory (RAM) is limited. Creating a huge number of instances in parallel can easily use up<br>
605 all RAM, which will then cause the operating system to make heavy use of the page file. This can result in<br>
606 HDD thrashing and hence may significantly hurt the overall performance! But even in case there is enough RAM<br>
607 available on the system, each encoder or decoder instance needs to access the HDD quite frequently, e.g. for<br>
608 reading from the input file and for writing to the output file. Thus running too many instances will generate<br>
609 more I/O operations than the HDD can handle, which will result in an I/O bottleneck. In this situation the<br>
610 processes will spend more and more time waiting for I/O operations to finish - rather then doing useful work.<br>
611 <br>
612 In other words: There will always be some point at which creating even more instances will actually slow down<br>
613 the overall process! On systems with many CPU cores, this point might be reached BEFORE all cores are busy.<br>
614 Even on the Quadcore computer, which is used to develop/test LameXP and which runs "only" four instances in<br>
615 parallel, we sporadically notice significant drops of the CPU usage, obviously caused by HDD overstressing.<br>
616 If, however, you think that LameXP's choice of the number of parallel instances is too conservative, you may<br>
617 overwrite the number of parallel instances on the "Advanced Options" tab - the upper limit is 16 for now.<br>
618 Finally, note that LameXP only controls the number of instances that will run in parallel, but it does NOT<br>
619 control how many threads an individual instance will create! Some encoders use "built-in" multi-threading and<br>
620 thus a single encoder instance may create several threads - LameXP has no control over that.<br><br>
621
622 <br><br>
623
624 <a name="454e51dd"></a><b>Why does LameXP try to connect to the web-server at 'xyz.com' secretly?</b><br>
625 <br>
626 LameXP does NOT connect to any web-server secretly! Of course the 'Auto Update' feature of LameXP unavoidably<br>
627 has to connect to one of our update servers. However in no event LameXP will search for updates without your<br>
628 agreement. Also LameXP will NOT send any personal information to the update server. It won't even send your<br>
629 program version to the server. Instead the latest version number will be downloaded from the server first and<br>
630 will then be compared to your current version number on the local computer. Moreover all information obtained<br>
631 from the update server are protected with a digital signature (GnuPG) in order to prevent spoofing attacks.<br>
632 <br>
633 Note: As LameXP is a non-profit project, we cannot afford a huge server infrastructure. Therefore the update<br>
634 server may be overstrained or unavailable once in a while. As we need to be able to distinguish the case in<br>
635 which our server is failing from the case in which your local internet connection has a problem, LameXP will<br>
636 run a short connectivity test on your local system first. For this purpose LameXP contains a list of 64 known<br>
637 hosts, taken (mostly) from the well-known Alexa 'top 500 sites on the web' listing. LameXP will assume that<br>
638 your internet connection is working properly if a certain minimum number (currently four) of the known hosts<br>
639 is reachable. That's also the reason why you may notice LameXP is trying to connect to a "random" web-site.<br><br>
640
641 <br><br>
642
643 <a name="12d077d5"></a><b>How can I force LameXP to create ID3 version 2 (ID3v2) tags?</b><br>
644 <br>
645 The LAME encoder automatically chooses the proper ID3 tag version. By default it will create a version 1 tag,<br>
646 if possible. Only if the information cannot be embedded into a version 1 tag (ID3v1), e.g. because the string<br>
647 is too long or the string contains Unicode characters, a version 2 tag (ID3v2) will be added. This behavior<br>
648 is advisable, because devices that support ID3v2 tags should also be able to read ID3v1 tags - but this<br>
649 doesn't apply the other way around! Moreover embedding an ID3v1 and an ID3v2 tag at the same time, although<br>
650 the information would have fit into a single ID3v1 tag, means an unnecessary redundancy!<br>
651 <br>
652 If, however, you need to enforce the creation of an ID3v2 tag for some reason, you can use the "--add-id3v2"<br>
653 parameter for that purpose. Simply add the parameter to the "Custom Encoder Parameters" for LAME.<br>
654 <br>
655 That's what the LAME help says about ID3 tags:<br>
656 <blockquote>A version 2 tag will NOT be added unless one of the input fields<br>
657 won't fit in a version 1 tag (e.g. the title string is longer than 30<br>
658 characters), or the '--add-id3v2' or '--id3v2-only' options are used,<br>
659 or output is redirected to stdout.</blockquote>
660
661 <br><br>
662
663 <a name="d83ab3c6"></a><b>Why does LameXP use LAME v3.99 rather than v3.98?</b><br>
664 <br>
665 LAME v3.99 contains the latest improvements and bugfixes of the LAME mp3 encoder, but it's less tested than<br>
666 the older 3.98 release series. The most important reason why LAME v3.99 is used in LameXP v4.xx is because<br>
667 LameXP v4.xx focuses on proper Unicode support, but LAME v3.98 did NOT support Unicode filenames or Unicode<br>
668 meta tags (through the CLI front-end, on the Windows platform). However LAME v3.99 finally does!<br>
669 <br>
670 So far we have not encountered any noteworthy problems with LAME v3.99. If, however, you encounter a problem<br>
671 with LAME v3.99, please report your finding to the <a href="http://lame.sourceforge.net/contact.php" target="_blank">LAME development team</a>. Do NOT submit any LAME-specific bug<br>
672 reports to the LameXP developers, as we generally cannot analyze/fix problems specific to the LAME encoder.<br>
673 <br>
674 [UPDATE] LAME v3.99 Final was release on 2011-10-15, so that is the official "stable" version now! [/UPDATE]<br><br>
675
676 <br><br>
677
678 <a name="4213adbc"></a><b>Can LameXP be used to convert/extract tracks from an Audio CD?</b><br>
679 <br>
680 LameXP can be used to convert audio files that have been extracted from an Audio CD, but it can NOT extract<br>
681 or read the audio tracks from the Audio CD directly (yet). Consequently you will have to extract ("rip") the<br>
682 audio tracks first, before you can convert them with LameXP. We recommend using the <a href="http://www.exactaudiocopy.de/" target="_blank">Exact Audio Copy</a> software<br>
683 for that purpose. When ripping tracks from an Audio CD you should always save the tracks as uncompressed Wave<br>
684 files or as lossless FLAC files! This will avoid a quality loss during the extraction/ripping process.<br>
685 <br>
686 Warning: The Windows operating system will show CDA files (such as "Track01.cda") on an Audio CD. These are<br>
687 dummy/fake files! Actually an Audio CD does NOT contain a file system and thus there are NO files. There only<br>
688 are audio tracks on an Audio CD. These audio tracks can be extracted as files (e.g. Wave Audio files) using a<br>
689 ripping software and then the extracted files can be converted. At the same time any attempt to copy/convert<br>
690 the '.cda' files directly is destined to fail (as the '.cda' files do NOT actually contain any audio data).<br><br>
691
692 <br><br>
693
694 <a name="434f2578"></a><b>Why is the maximum normalization level limited to -0.5 dB?</b><br>
695 <br>
696 When an analogue [audio] signal is converted to the digital domain, the signal is sampled at a fixed rate<br>
697 (e.g. 44100 samples per second) and each "sample" value is stored with a fixed number of bits (e.g. 16 or 24<br>
698 bits per sample). Consequently [uncompressed] digital audio is represented as a sequence of binary sample<br>
699 values. The range of possible sample values is determined by the word size ("bits per sample"). For example<br>
700 with a word size of 16 bit, the minimum value is &minus;32768 and the maximum value is 32767 - assuming the values<br>
701 are signed. The range of the sample values corresponds to the voltage range of the electrical input signal.<br>
702 The maximum digital sample value (i.e. 32767 at 16-Bit) often is referred to as 0dBFS (0dB "full scale").<br>
703 <br>
704 Performing a Normalization in the digital domain seems straightforward: We simply multiply all sample values<br>
705 with the same factor. And we choose this factor in such a way that the highest sample value(s) in the track<br>
706 will become exactly 0dBFS after the normalization has been performed. However one needs to be aware that when<br>
707 playing back the digital audio track, it needs to be converted back to an analogue signal. The D/A converter<br>
708 will convert each sample from its binary representation to the corresponding voltage. Then a "reconstruction"<br>
709 filter will be applied in order to recover a continuous signal from these individual voltages. And for the<br>
710 reconstructed analogue signal it is possible to have voltages that are higher than the highest digital sample<br>
711 in the audio track! This is illustrated in the following image (samples are represented as tiny squares):<br>
712 <br>
713 <a target="_blank" href="http://img3.imageshack.us/img3/9153/sine0dbfs.png"><img src="http://img3.imageshack.us/img3/9153/sine0dbfs.th.png" border="0" alt="thumb"></a><br>
714 <br>
715 Consequently normalizing the sample values to 0dBFS is NOT a very good idea, as this may very well result in<br>
716 a reconstructed analogue signal which exceeds(!) 0dBFS. And, as the analogue parts of the playback equipment<br>
717 generally are NOT prepared for +0dBFS voltages, this may cause problems, such as annoying distortions!<br>
718 <br>
719 The help document of a well-known audio editing software contains the following advice:<br>
720 <blockquote>If you're planning to put normalized audio on CD, you might want to normalize the waveforms to<br>
721 no more than 96% [-0.36 dB] as some audio compact disc players have problems accurately reproducing<br>
722 bits that have been processed to 100% (maximum) amplitude [0dBFS].</blockquote>
723 For details please refer to the following article:<br><ul>
724 <li><a href="http://www.audioholics.com/education/audio-formats-technology/issues-with-0dbfs-levels-on-digital-audio-playback-systems" target="_blank">http://www.audioholics.com/...issues-with-0dbfs-levels-on-digital-audio-playback-systems</a></ul>
725
726 <br><br>
727
728 <a name="9f8ff13a"></a><b>What do the different 'Equalization' modes do?</b><br>
729 <br>
730 The "equalization" modes control how the normalization filter will deal with multi-channel input files, i.e.<br>
731 everything that is not Mono. The "Peak Level" mode will normalize each channel according to its highest peak<br>
732 (maximum sample value). This means that channels with a lower maximum sample value will be amplified stronger<br>
733 than channels with a higher maximum sample value. Still all samples in a channel will be amplified by the<br>
734 same factor, so dynamic range compression is NOT done. The "RMS Level" mode works similar to the previous<br>
735 mode, but the channels are amplified according to their peak RMS level (maximum energy), instead of their<br>
736 maximum sample value. This may be used to correct stereo imbalance caused by an imperfect record turntable<br>
737 cartridge. Last but not least, the "None" mode will not euqalize the channels at all, i.e. all channles will<br>
738 by amplified by the same factor. In the last mode, the highest peak of all(!) channels is used as threshold.<br><br>
739
740 <br><br>
741
742 <a name="c6d9dfed"></a><b>Why does my encoded file come out slightly longer than the original?</b><br>
743 <br>
744 Because of the way most (lossy) audio compressors work, a number of "silent" samples have to be prepended to<br>
745 the first input sample. Also a number of silent samples may be appended to the last input sample. Obviously<br>
746 these additional "padding" samples will make the encoded file longer than the original input. If the decoder<br>
747 does not compensate for the padding samples that have been added by the encoder, the padding samples at the<br>
748 beginning of the encoded file will cause a certain delay/shift, compared to the (uncompressed) original file.<br>
749 Another effect is that there will be a "gap" between the files, when playing multiple files in sequence.<br>
750 <br>
751 It has to be noted that the padding is an inherent property of the audio compressor that can not be avoided.<br>
752 But, as mentioned before, the padding samples can be removed by the decoder. In that case, the decoded output<br>
753 will have the exactly same length (in samples) as the original file. However this can only be done, if the<br>
754 decoder is able to determine the exact number of padding samples that had been added. While the Vorbis audio<br>
755 format stores the number of padding samples in the stream and thus any compliant decoder will remove them,<br>
756 the MP3 and AAC audio formats do NOT define an "official" way to store the the number of padding samples!<br>
757 <br>
758 Nonetheless, the LAME MP3 encoder, which is used by LameXP, uses its own "non-standard" way to indicate the<br>
759 exact number of padding samples. This is done by adding a so-called "LAME header" to the MP3 file. Hence MP3<br>
760 decoders, which recognize the LAME header, will be able to remove the padding samples. This feature often is<br>
761 referred to as "gapless" decoding/playback. The 'mpg123' decoder, which is used by LameXP, does support the<br>
762 gapless decoding. This means that if you encode MP3 files with LameXP/LAME, then gapless decoding will be<br>
763 possible. And if you decode these files with LameXP/mpg123 again, they will come out at the original length.<br>
764 <br>
765 Still you have to be aware that NOT all MP3 decoders support the LAME header. So if you encode MP3 files with<br>
766 LameXP and then decode them with an arbitrary MP3 decoder, they may come out at a "wrong" length. And there<br>
767 is absoloutely nothing that LameXP could do about that! Furthermore, if you decode a MP3 file in LameXP that<br>
768 has been created with some MP3 decoder which did not add a LAME header, then it is impossible to remove the<br>
769 padding samples. That's because in this situation there is NO way to know the number of padding samples!<br>
770 <br>
771 Some more info on this topic can be found here:<br><ul>
772 <li><a href="http://en.wikipedia.org/wiki/Gapless_playback" target="_blank">http://en.wikipedia.org/wiki/Gapless_playback</a>
773 <li><a href="http://lame.sourceforge.net/tech-FAQ.txt" target="_blank">http://lame.sourceforge.net/tech-FAQ.txt</a>
774 <li><a href="http://cas.web.cern.ch/cas/Denmark-2010/Caspers/Tektronix%20%20primer%20on%20overlapping%20FFT%20signals%202009%20CAS2010.pdf" target="_blank">Understanding FFT Overlap Processing
775 Fundamental</a></ul>
776 <br><br>
777
778 <a name="ed4d30ed"></a><b>Why is the Hibernation option disabled (greyed out) on my system?</b><br>
779 <br>
780 In order to use "Hibernation", your system must support the S4 power saving mode (aka "Suspend-to-Disk") and<br>
781 the hibernation file ("hiberfil.sys") must be enabled. If these conditions are not met, then the Hibernation<br>
782 option will be disabled in LameXP, for obvious reasons. Note that on older versions of Windows you can enable<br>
783 or disable the hibernation file in the "Power Options" dialog of the Control Panel (see <a href="http://tothepc.com/img/2010/05/xp-hibernate-disable.png" target="_blank">here</a>). On Windows 7<br>
784 and probably also on Vista, you have to do this from the Windows command interpreter. First open an elevated<br>
785 command prompt by typing "cmd" in the Startmenu (not "Run" dialog!) and when "cmd.exe" appears as suggestion,<br>
786 then right-click on "cmd.exe" and choose "Run as administartor". After that you should see an "Administrator"<br>
787 command prompt window. Here you can type "powercfg -h on" (without the quotation marks!) and press Enter to<br>
788 enable the hibernation file. You can disable the hibernation file again by typing "powercfg -h off".<br>
789 <br>
790 Note: The size of "hiberfil.sys" is equal to your RAM size and it always is located on the system partition!<br><br>
791
792 <br><br>
793
794 <a name="54150e92"></a><b>Why do random files fail with "Not Found!" or "Failed!" status?</b><br>
795 <br>
796 If a file fails to convert with "Not Found!" or "Failed!" status, this usually has a reason! In that case you<br>
797 can double-click on the failed item in order to view the log. The log will give detailed information about<br>
798 the problem that has occured. In very rare cases, however, the following behavior has been observed by users:<br>
799 When converting multiple files, some of the failes seem to fail at random. When the same files are converted<br>
800 again later, some of the files that failed before will now succeed while some of the files that succeeded<br>
801 before will now fail. This behavior has been tracked down to faultily "anti-virus" software! So in case you<br>
802 encounter the described behavior and if you use some anti-virus software with "real-time scanner" or "guard"<br>
803 functionality, then try to uninstall (or at least disable) the anti-virus software. If that resolves the<br>
804 problem, then you know for sure that the anti-virus software was the cause of the problem. As the developers<br>
805 of LameXP can NOT fix or workaround problems induced by faultily "anti-virus" software, please report such<br>
806 problems to the developer (or support team) of your anti-virus software! Or switch to a better a/v product...<br><br>
807
808 <br><br>
809
810 <a name="3e999f02"></a><b>Why is "Convert this file with LameXP" missing from the Explorer context menu somtimes?</b><br>
811 <br>
812 The entry "Convert this file with LameXP" will be available from the Windows Explorer context menu for all<br>
813 files supported by LameXP, if (and only if) the LameXP Shell-Integration is enbaleld. You can enable or<br>
814 disable the LameXP Shell-Integration at any time from the "Tools &gt; Configuration" menu within LameXP at any<br>
815 time. However be aware that this option will NOT be available, if LameXP is running in portable mode. Also be<br>
816 aware that if you select multiple files in Explorer, the LameXP context menu entry will only appear, if ALL<br>
817 files in your selection are supported by LameXP. Last but not least, Windows will NOT show the LameXP context<br>
818 menu entry, if more than 15 files are selected. That is a limitation of Windows Explorer! It is "by design".<br>
819 <br>
820 See also:<br>
821 <a href="http://support.microsoft.com/kb/2022295/" target="_blank">Context menus are shortened when more than 15 files are selected</a><br><br>
822
823 <br><br>
824
825 <a name="e7c9ae2b"></a><b>Why do I get the error 'Executable doesn't support Windows compatibility mode' on startup?</b><br>
826 <br>
827 LameXP was designed to run on all supported platforms natively (except for Linux/Wine). If you see this error<br>
828 message, that's probably because your system is configured to run LameXP in 'compatibility mode', i.e. your<br>
829 system will pretend an older OS version than is actually running. In Windows Explorer you can disable(!) the<br>
830 compatibility mode by right-clicking on the 'LameXP.exe' file, choosing 'Properties' from the context menu,<br>
831 switching to the 'Compatibility' tab and un-checking the 'Run this program in compatibility mode' option.<br><br>
832
833 <br><br>
834
835 <a name="328b0a18"></a><b>Why do I get the error 'Executable requires Windows 2000 or later' on startup?</b><br>
836 <a name="3ffe490e"></a><b>Why do I get the error 'The procedure entry point &lt;Something&gt; could not be located' on startup?</b><br>
837 <a name="01922741"></a><b>Why do I get the error 'LameXP.exe is not a valid Win32 application' on startup?</b><br>
838 <br>
839 You are trying to run LameXP on a platform that is NOT supported, such as Windows 95, Windows 98, Windows<br>
840 Millennium Edition, Windows NT 4.0. There is nothing you can do about that, except for updating to a less<br>
841 antiquated OS. Running an outdated and unsupported OS is a severe security risk anyway!<br>
842 <br>
843 Note: This error can also occur, if your system has been configured to run LameXP in <a href="#e7c9ae2b">compatibility mode</a>.<br><br>
844
845 <br><br>
846
847 <a name="491aaad9"></a><b>Why do I get the error 'A device attached to the system is not functioning' on startup?</b><br>
848 <br>
849 This error message from the Windows operating system is somewhat misleading. It often appears together with<br>
850 a second error message and it means that Windows was unable to load/execute the program file. There are<br>
851 various reasons why this error might occur, but usually it indicates that you are trying to run LameXP or the<br>
852 LameXP setup/update program on a platform that is NOT supported, such as Windows 95, Windows 98, Windows<br>
853 Millennium Edition, Windows NT 4.0. There is nothing you can do about that, except for updating to a less<br>
854 antiquated OS. Running an outdated and unsupported OS is a severe security risk anyway!<br><br>
855
856 <br><br>
857
858 <a name="a0fd5ae8"></a><b>Why do I get the error 'File &acute;tool_foobar.exe&acute; could not be locked!' on startup?</b><br>
859 <br>
860 This error indicates that LameXP was unable to open/read a required file - one that it just has extracted<br>
861 itself. Generally this should never happen, but we have reports that some bogus "anti-vrius" software might<br>
862 trigger this kind of errors. Of course there is nothing we can do on our side, if the error is induced by<br>
863 proprietary third-party software (such as faulty "anti-virus" software). So please try to temporarily(!)<br>
864 uninstall/disable your anti-virus software. If the problem goes away, you can be sure it was caused by the<br>
865 anti-virus software. In that case report the bug to the support team of your anti-virus software as soon as<br>
866 possible. Or, if they don't fix the bug (in due time), switch to a better anti-virus product!<br>
867 <br>
868 See also:<br>
869 <a href="#96205e91">My anti-virus program raises an alarm when I try to download, install or launch LameXP. Why is that?</a><br><br>
870
871 <br><br>
872
873 <a name="f35cfa24"></a><b>How can I translate LameXP to my language or improve an existing translation?</b><br>
874 <br>
875 Please see the guide for translators at:<br><ul>
876 <li><a href="http://lamexp.sourceforge.net/doc/Translate.html" target="_blank">http://lamexp.sourceforge.net/doc/Translate.html</a></ul>
877
878 <br><br>
879
880 <a name="8dba381f"></a><b>Where can I download the latest version of LameXP?</b><br>
881 <br>
882 The latest "official" release of LameXP can be found on the following mirrors:<br><ul>
883 <li><a href="https://github.com/lordmulder/LameXP/downloads" target="_blank">https://github.com/lordmulder/LameXP/downloads</a>
884 <li><a href="https://bitbucket.org/lord_mulder/lamexp/downloads" target="_blank">https://bitbucket.org/lord_mulder/lamexp/downloads</a>
885 <li><a href="http://sourceforge.net/projects/lamexp/files/" target="_blank">http://sourceforge.net/projects/lamexp/files/</a>
886 <li><a href="http://code.google.com/p/mulder/downloads/list" target="_blank">http://code.google.com/p/mulder/downloads/list</a></ul>
887
888 <br><br>
889
890 <a name="9c2e273d"></a><b>Where can I submit bug reports or feature requests?</b><br>
891 <br>
892 The preferred place to report bugs or request new features is the LameXP thread at Doom9's Forum:<br><ul>
893 <li><a href="http://forum.doom9.org/showthread.php?t=157726" target="_blank">http://forum.doom9.org/showthread.php?t=157726</a> (English)
894 <li><a href="http://forum.gleitz.info/showthread.php?t=37956" target="_blank">http://forum.gleitz.info/showthread.php?t=37956</a> (German)</ul>
895 <br>
896 Please do NOT send me E-Mail unless you really have to! I receive a LOT of E-Mail and your mail can get lost!<br><br>
897
898 <br><br>
899
900 <a name="e5694e3e"></a><b>What programming language is LameXP written in?</b><br>
901 <br>
902 While LameXP v3.xx and all earlier versions were written in Delphi/Pascal, starting with version 4.xx the<br>
903 software has been re-written in the C++ programming language. LameXP v4.xx is based on the Qt cross-platform<br>
904 application framework and offers full Unicode support. For the time being LameXP is Windows-only.<br><br>
905
906 <br><br>
907
908 <a name="982cf1c0"></a><b>Where can I find the LameXP source code?</b><br>
909 <br>
910 LameXP is developed using the <a href="http://en.wikipedia.org/wiki/Git_(software)" target="_blank">Git</a> revision control system. You can access one of the public mirrors:<br><ul>
911 <li><font class="code">git clone https://github.com/lordmulder/LameXP.git lamexp-src</font> (<a href="https://github.com/lordmulder/LameXP" target="_blank">Browse</a>)
912 <li><font class="code">git clone https://bitbucket.org/lord_mulder/lamexp.git lamexp-src</font> (<a href="https://bitbucket.org/lord_mulder/lamexp/src" target="_blank">Browse</a>)
913 <li><font class="code">git clone http://git.code.sf.net/p/lamexp/code lamexp-src</font> (<a href="http://sourceforge.net/p/lamexp/code/" target="_blank">Browse</a>)
914 <li><font class="code">git clone https://git.gitorious.org/lamexp/lamexp.git lamexp-src</font> (<a href="http://gitorious.org/lamexp/lamexp/trees/master" target="_blank">Browse</a>)</ul>
915 <br>
916 In case you are new to Git or want to extend your knowledge, have a look at the <a href="http://git-scm.com/book/en" target="_blank">Pro Git</a> book by Scott Chacon!<br>
917 For Windows users, we highly recommend using <a href="http://msysgit.github.com/" target="_blank">MSYS Git</a> in conjunction with the superb <a href="http://tortoisegit.googlecode.com/" target="_blank">Tortoise Git</a> front-end.<br><br>
918
919 <br><br>
920
921 <a name="a0c1e92b"></a><b>What are the prerequisites to build LameXP from the sources?</b><br>
922 <br>
923 LameXP is currently being developed using the following build environment:<br><ul>
924 <li><a href="http://www.microsoft.com/visualstudio/eng/downloads#d-2012-express" target="_blank">Visual Studio 2012</a> with <a href="http://www.microsoft.com/en-us/download/details.aspx?id=34818" target="_blank">Update-1</a>, running on Windows 7 with Service Pack 1
925 <li><a href="http://qt-project.org/downloads#qt-lib" target="_blank">Qt libraries 4.8.3</a> for Windows
926 <li>Windows Platform SDK v7.1A, included with the Update-1 of Visual Studio 2012
927 <li>The minimum supported *build* platform is Windows 7 (x86 and x64)</ul>
928 <br>
929 Also note the following hints:<br><ul>
930 <li>Run <font class="code">qtvars.bat</font> (or <font class="code">qtenv2.bat</font>) before launching Visual Studio in order to set up the Qt environment
931 <li>Visual Studio 2012 solution/project files are now provided too, but make sure you installed "Update 1"
932 <li>Visual Studio 2008 solution/project files are still provided for people still targeting Windows 2000
933 <li>In order to make "fully static" builds of LameXP, you'll need <a href="http://sourceforge.net/projects/lamexp/files/Miscellaneous/Qt%20Libraries/" target="_blank">Qt as 'static' libraries</a> (see below!)
934 <li>The Windows Platform SDK v6.0A should work as well, but there may be a few limitations
935 <li>Support for the GNU Toolchain (GCC/MinGW + MSYS/Make) is planned for a future version of LameXP</ul>
936 <br>
937 In order to use the LameXP deployment scripts you need the following tools:<br><ul>
938 <li>Visual Studio 2012 (Express for Windows Desktop) with Update-1 <b>+</b> Desktop Qt v4.8.x (MSVC 2010)
939 <li><a href="http://www.7-zip.org/" target="_blank">7-Zip</a> - file archiver with a high compression ratio
940 <li><a href="http://nsis.sourceforge.net/" target="_blank">NSIS</a> - Nullsoft Scriptable Install System (<a href="http://www.scratchpaper.com/" target="_blank">Unicode version</a> recommended!)<ul>
941 <li><a href="http://nsis.sourceforge.net/StdUtils_plug-in" target="_blank">StdUtils plug-in</a>
942 <li><a href="http://nsis.sourceforge.net/LockedList_plug-in" target="_blank">LockedList plug-in</a>
943 <li><a href="http://nsis.sourceforge.net/Inetc_plug-in" target="_blank">Inetc plug-in</a>
944 <li><a href="http://forums.winamp.com/showthread.php?t=329990" target="_blank">Aero plug-in</a></ul>
945 <li><a href="http://upx.sourceforge.net/" target="_blank">UPX</a> - the Ultimate Packer for eXecutables
946 <li><a href="http://www.matcode.com/mpress.htm" target="_blank">MPRESS</a> - high-performance executable packer for PE32/PE32+
947 <li style="margin-bottom:0.48em"><a href="ftp://ftp.gnupg.org/gcrypt/binary/" target="_blank">GnuPG</a> - the GNU Privacy Guard v1.4.x
948 <li>NOTE: Copy <font class="code">buildenv.template.txt</font> to <font class="code">buildenv.txt</font> and edit the paths as needed!</ul>
949
950 <br><br>
951
952 <a name="87f001c0"></a><b>How do I compile latest Qt as 'static' libraries?</b><br>
953 <br>
954 In order to make "fully static" builds of LameXP, i.e. builds that don't depend pn any DLL's except for the<br>
955 obligatory operating system DLL's, you'll need to compile Qt as 'static' libraries. The following simple<br>
956 instructions should make it easy to build Qt from the sources and as "static" libraries:<br><ul>
957 <li>Make sure Visual Studio 2010 with Service Pack 1 or Visual Studio 2012 with Update 1 are installed
958 <li>Make sure <a href="http://strawberryperl.com/" target="_blank">Strawberry</a> Perl for Windows and <a href="http://www.activestate.com/activepython/downloads" target="_blank">Python</a> 2.7 are installed
959 <li><a href="http://qt-project.org/downloads" target="_blank">Download</a> and <a href="http://www.rarlabs.com/" target="_blank">extract</a> the Qt 4.8.x source code package (e.g. to <font class="code">C:\QtSources\4.8.x</font>)
960 <li>Edit the file <font class="code">mkspecs\win32-msvc2010\qmake.conf</font> from your Qt Sources directory as follows:<ul>
961 <li style="margin-bottom:0.33em">Old: <font class="diff_del">QMAKE_CFLAGS_RELEASE = -O2 -MD</font><br>New: <font class="diff_add">QMAKE_CFLAGS_RELEASE = -O2 -MT &lt;more optimization flags here&gt;</font>
962 <li>Old: <font class="diff_del">QMAKE_CFLAGS_RELEASE_WITH_DEBUGINFO += -O2 -MD -Zi</font><br>New: <font class="diff_add">QMAKE_CFLAGS_RELEASE_WITH_DEBUGINFO += -O2 -MT -Zi &lt;more optimization flags here&gt;</font></ul>
963 <li>Open a new command window (cmd.exe) - use this very same console for all upcoming steps!
964 <li>Add Strawberry Perl to your PATH (e.g. <font class="code">set PATH=C:\strawberry\perl\bin;%PATH%</font>)
965 <li>Add Python 2.7 to your PATH (e.g. <font class="code">set PATH=C:\python27;%PATH%</font>)
966 <li>Run <font class="code">vcvarsall.bat x86</font> form your Visual C++ install directory - within the same console!
967 <li>Change the current directory to the Qt Sources path (e.g. <font class="code">C:\QtSources\4.8.x</font>)
968 <li>Run <font class="code">configure.exe -release -static -ltcg -qt-zlib -qt-libpng -qt-libjpeg -qt-libtiff -qt-libmng</font><ul>
969 <li>Hint: For Visual Studio 2012 you currently need to add <font class="code">-platform win32-msvc2010</font> too</ul>
970 <li>Now the makefiles should have been generated, so simply enter <font class="code">nmake /B</font> and be patient - voilĂ !
971 <li>The build process is going to take good amount of time. Once done, make sure you got all needed libs
972 <li>Libraries you'll need to build LameXP as a "static" binary include the following:<ul>
973 <li>lib\qtmain.lib
974 <li>lib\QtCore.lib
975 <li>lib\QtGui.lib
976 <li>lib\QtSvg.lib
977 <li>lib\QtXml.lib
978 <li>plugins\imageformats\qico.lib
979 <li>plugins\imageformats\qsvg.lib
980 <li>plugins\imageformats\qtga.lib</ul>
981 <li>Put all the static <font class="code">*.lib</font> files into the 'LameXP\etc\Prerequisites\qt4_static\lib' directory
982 <li>ImageFormat plugins go to 'LameXP\etc\Prerequisites\qt4_static\plugins\imageformats'
983 <li style="margin-bottom:0.48em">Congratulations, you should now be prepared to build the <font class="code">Release_Static</font> configuration of LameXP :-)
984 <li>NOTE: Static libraries only work with the same compiler (version) they were built with!</ul>
985 <br><br>
986
987 eof</body></html>