fenix/exhale
1
0
Fork 0
mirror of https://gitlab.com/ecodis/exhale.git synced 2025-03-10 16:20:09 +01:00
Code Issues Packages Projects Releases Wiki Activity

editorial changes

Browse Source
This commit is contained in:
Christian R. Helmrich 2020-01-03 00:00:28 +01:00
parent 93f669d676
commit 630a1b0db7
3 changed files with 35 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
README.md
View File

@ -3,13 +3,13 @@ exhale
exhale, which is an acronym for "Ecodis eXtended High-efficiency And
Low-complexity Encoder", is a lightweight library and application to
encode uncompressed WAVE-format audio files into MPEG-4 format files
encode uncompressed WAVE-format audio files into MPEG-4-format files
complying with the ISO/IEC 23003-3 (MPEG-D) Unified Speech and Audio
Coding (USAC, also known as Extended High-Efficiency AAC) standard.
exhale currently makes use of all frequency-domain (FD) coding tools
in the scalefactor based MDCT processing path, except for predictive
joint stereo, which is already being worked on. It objective is high
joint stereo, which is still being integrated. Its objective is high
quality mono, stereo, and multichannel coding at medium and high bit
rates, so the parametric USAC coding tools (ACELP, TCX, Enhanced SBR
and MPEG Surround with Unified Stereo coding) won't be integrated.
@ -28,10 +28,10 @@ License
exhale is being made available under an open-source license which is
similar to the 3-clause BSD license but modified to address specific
lar aspects dictated by the nature and output of this application.
aspects dictated by the nature and the output of this application.
The license text and release notes for the current version 1.0.0 can
be found in the "include" subdirectory of the exhale distribution.
be found in the `include` subdirectory of the exhale distribution.
Compilation
@ -54,7 +54,7 @@ to build a release-mode executable with the default (usually 64-bit)
configuration. A 32-bit debug-mode executable can be built by typing
`
make debug BUILD32=1
make BUILD32=1 debug
`
### Microsoft Windows (Visual Studio 2012 and later):
@ -64,6 +64,11 @@ Studio. Once it's loaded, rightclick on `exhaleApp` in the "Solution
Explorer" window on the right-hand side, then select `Set as StartUp
Project`. Now simply press `F7` to build the solution in debug mode.
To change the debugging command, rightclick again on `exhaleApp` and
select `Properties`. In the newly opened window click on `Debugging`
under "Configuration Properties" on the left-hand side. Then you can
edit the "Command Arguments" entry on the right-hand side as needed.
For fastest encoding speed, please select `Release` and `x64` before
building the solution. This will create a release-mode 64-bit binary.
@ -90,4 +95,25 @@ the input file is two-channel stereo) and in xHE-AAC audio format.
### Third-party stdin (foobar2000):
will follow soon
After downloading from www.foobar2000.org and starting the software,
load your desired input WAVE files into the playlist. Mark all files
to be converted, rightclick on one of them and select `Convert` ->
`Quick convert`. In the newly opened window click on `Add New`, then
select `Custom` under "Encoder" and enter the following information:
- *Encoder file:* exhaleApp.exe (possibly including path to it)
- *Extension:* m4a
- *Parameters:* # %d (where number is the bit-rate mode, 1...9)
- *Format is:* lossy
- *Highest BPS mode supported:* 24 (or 32, doesn't matter much)
- *Encoder name:* exhale
- *Bitrate (kbps):* (depends on bit-rate mode, see Usage above)
- *Settings:* default CVBR
Development
-----------
If you're interested in contributing to exhale, please contact one of
the developers. Merge requests with fixes and/or speedups are highly
appreciated.

2
include/License.htm
View File

@ -1,4 +1,4 @@
<!-- www.ecodis.de/exhale/license.htm - created by Christian R. Helmrich - Copyright (c) 2018-2019 Christian Helmrich -->
<!-- www.ecodis.de/exhale/license.htm - created by Christian R. Helmrich - Copyright (c) 2018-2020 Christian R. Helmrich, project ecodis. All rights reserved. -->
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>

4
include/Release.htm
View File

@ -1,4 +1,4 @@
<!-- www.ecodis.de/exhale/release.htm - created by Christian R. Helmrich - Copyright (c) 2018-2019 Christian Helmrich -->
<!-- www.ecodis.de/exhale/release.htm - created by Christian R. Helmrich - Copyright (c) 2018-2020 Christian R. Helmrich, project ecodis. All rights reserved. -->
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
@ -25,7 +25,7 @@
<td valign="top">
<h1><br><span class="pink">exhale</span> - <span class="pink">e</span>codis e<span class="pink">x</span>tended <span class="pink">h</span>igh-efficiency <span class="pink">a</span>nd <span class="pink">l</span>ow-complexity <span class="pink">e</span>ncoder<br><span class="gray"><sup><br>Software Release Notes, Version History, Known Issues, Upcoming Feature Roadmap</sup></span><br><br></h1>
<h3>&nbsp; &nbsp;The version of this distribution of the &laquo;exhale&raquo; software release is <b>1.0.0</b> (official pub&shy;lic release candidate) from January 2020. Please check <a href="http://www.ecodis.de">www.ecodis.de</a> regularly for new versions of this software. A summary of each version up to this release, a list of known issues with this release, and a roadmap of additional functionality are provided below.</h3>
<h3>&nbsp; &nbsp;The version of this distribution of the &laquo;exhale&raquo; software release is <b>1.0.0</b> (official pub&shy;lic major release) from January 2020. Please check <a href="http://www.ecodis.de">www.ecodis.de</a> regularly for new versions of this software. A summary of each version up to this release, a list of known issues with this release, and a roadmap of additional functionality are provided below.</h3>
<h3><br><b>Chronological Version History</b></h3>
<h3>&nbsp; &nbsp;Version <b>1.0.0 <span class="gray">&nbsp;Jan. 2020, this release</span></b></h3>
<ul>