LAME 3.xx
               LAME Ain't an MP3 Encoder
                  http://lame.sf.net
	                  May 2011

Originally developed by Mike Cheng (www.uq.net.au/~zzmcheng) and was
latter developed by Mark Taylor (www.mp3dev.org). Currently maintained
by The LAME Project.

This code is distributed under the GNU LIBRARY GENERAL PUBLIC LICENSE
(LGPL, see www.gnu.org), version 2.

As LAME may contain software for which some companies may claim software
patents, if you are in a location where software patents are recognized, it is
suggested that you seek legal advice before deploying and/or redistributing
LAME.

In particular, it is suggested to visit

    http://www.mp3licensing.com/

if it applies to your jurisdiction.

============================================================================

see the file "INSTALL" for installation (compiling) instructions.
see the file "USAGE" for the most up-to-date guide to the command line options.
see the file "LICENSE" for details on how to use LAME in non-GPL programs.
see the file "HACKING" if you are interested in working on LAME
see the file "API" for details of the LAME encoding library API

There is HTML documentation and a man page in the doc directory.

============================================================================

LAME uses the MPGLIB decoding engine, from the mpg123 package, written
by: Michael Hipp (www.mpg123.de) MPGLIB is released under the GPL.

Copyrights (c) 1999-2011 by The LAME Project
Copyrights (c) 1999,2000,2001 by Mark Taylor
Copyrights (c) 1998 by Michael Cheng
Copyrights (c) 1995,1996,1997 by Michael Hipp: mpglib

As well as additional copyrights as documented in the source code.

[
    {
        "Name":"lame",
        "License":"LGPL",
        "License File":"LICENSE",
        "Version Number":"3.100",
        "Owner":"yangpeng43@huawei.com",
        "Upstream URL":"https://github.com/lameproject/lame.git",
        "Description":"LAME is a high quality MPEG Audio Layer III (MP3) encoder licensed under the LGPL."
    }
]

       Installation notes on MP3X (the LAME frame analyzer) for WIN32

===========================================================================
Document History:
===========================================================================

Initial version by Albert Faber, March 30, 2000

Update by Albert Faber (Sept 07 2000), changed instructions
to compile with latest glib/gtk libraries.

Update by Albert Faber (Sept 07 2000), changed instructions
to compile with latest glib/gtk libraries.

Update by Albert Faber (Oct 20 2000), small adaptions to be conform
the new lame directory structure.

Update by Gabriel Bouvigne (Jan 07 2004), changes to be conform to the
VC6 worspace structure.

Update by Gabriel Bouvigne (Nov 11 2006), changes to be conform to the
VC8 worspace structure. Tested with gtk+-dev-1.3.0-20030115 and glib-dev-2.12.4


===========================================================================
How to compile the MP3 frame analyzer (MP3x):
===========================================================================

You first need to get hold of the latest GTK and GLIB include files and lib
files. You can download them freely from the WINGTK project WEB site.
(see http://www.gtk.org, and click on the WINGTK link.)

Download: glib-dev-VERSION.zip, gtk+-dev-VERSION.zip and extralibs-dev-VERSION.zip
where VERSION indicates the release data, so it will look something like 20000805

unzip all three zip files in a WinGTK subdirectory, which is created from the lame
analyzer directory (for example, D:\CVS\lame\WinGtk)

You will end up with the following directory tree
  D:\CVS\lame\analyzer\WinGtk\src\glib
  D:\CVS\lame\analyzer\WinGtk\src\gtk+\glib
  D:\CVS\lame\analyzer\WinGtk\src\gtk+

Set Mp3x as your current active project, recompile everything, and you're done.

===========================================================================
How to run and use the MP3 Frame analyzer
===========================================================================

To run MP3x.exe, you need the GTK DLL files: Either instal them on your system,
or put them in the same directory mp3x.exe resides.


Example:
mp3x.exe myfile

myfile can be a mp3 file, or a wav file.


                                === End of Document ===

# LAME

LAME是LGPL协议授权的高质量MP3编码器。LAME于1998年发布，此后进行了多次改进，引入了新的心理声学模型，被公认为一款出色的MP3编码器，在业界应用广泛。

[LAME官网地址](https://lame.sourceforge.io)为[https://lame.sourceforge.io](https://lame.sourceforge.io)，您可以通过访问它获取更多关于LAME项目的信息。

OpenHarmony引入第三方开源软件LAME主要用于对数字音频进行MP3编码。LAME最近更新发布的版本为3.100，这也是OpenHarmony引入的版本。

## 主要目录结构

```
doc              #文档
include          #包含头文件
libmp3lame       #MP3编码主要源代码
test             #测试代码
Dll              #Windows dll接口
vc_solution      #vs解决方案
Makefile         #编译描述文件
INSTALL          #安装（编译）指导
API              #接口说明
COPYING          #版权声明
LICENSE          #许可证说明
README.md        #软件说明
```

## OpenHarmony如何集成LAME

LAME位于OpenHarmony的thirdparty目录下，使用OpenHarmony中依赖部件的方式进行编译，得到单独的动态链接库。OpenHarmony通过链接到这个库，实现相关功能。

1. 主干代码下载
   ```
   repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-verify
   repo sync -c
   repo forall -c 'git lfs pull'
   ```
2. 在使用的模块进行依赖
   ```
   deps = [ "//third_party/lame:lame" ]
   ```
3. 预处理
   ```
   ./build/prebuilts_download.sh
   ```
4. 编译
   ```
   ./build.sh --product-name rk3568 --ccache
   ```
编译得到的动态链接库所在路径：`out/rk3568/thirdparty/lame/liblame.z.so`。

## 许可证

本项目遵从[LICENSE](https://gitee.com/openharmony-sig/third_party_lame/blob/master/LICENSE)和[COPYING](https://gitee.com/openharmony-sig/third_party_lame/blob/master/COPYING)中所描述的许可证。

## 特别注意

根据LAME项目[LICENSE](https://gitee.com/openharmony-sig/third_party_lame/blob/master/LICENSE)的要求，如果后续对LAME有修改，**必须**将修改反馈至LAME项目。