-
Notifications
You must be signed in to change notification settings - Fork 5
/
developers.html
58 lines (57 loc) · 3.65 KB
/
developers.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
---
layout: default
title: Developers
---
FLAC is an open source project and we are happy to enlist the help of anyone who wants to contribute, or to help with FLAC support in other programs and devices. The preferred method of communication is the <a href="http://lists.xiph.org/mailman/listinfo/flac-dev">developer mailing list</a> (you must subscribe to post).<br />
<br />
FLAC is open to third-party developers who want to add support for FLAC into their programs. All the necessary functionality is contained in the libFLAC libraries which are licensed under <a href="license.html">Xiph.org's BSD license</a>.<br />
<br />
Some pointers to developer documentation and code:<br />
<ul>
<li><a href="license.html">License</a> - The license under which the official tools are distributed.</li>
<li><a href="api/index.html">libFLAC and libFLAC++ APIs</a> - Complete library documentation.</li>
<li><a href="documentation_example_code.html">Example Code</a> - Some simple example programs demonstrating the use of libFLAC and libFLAC++.</li>
<li><a href="format.html">FLAC Format Specification</a> - The formal specification.</li>
<li><a href="ogg_mapping.html">Ogg FLAC Mapping</a> - How FLAC should be embedded in an Ogg container.</li>
<li><a href="https://github.com/ietf-wg-cellar/flac-test-files">FLAC test files</a> - A set of files that can be used to test decoder implementations for completeness.</li>
<li><a href="id.html">ID Registration</a> - Register an ID if you need to write custom metadata.</li>
<li><a href="https://github.com/xiph/flac">Git access</a> - for checking out the source code.</li>
<li><a href="https://github.com/xiph/flac/issues">Github Issues</a> - to submit bug reports and feature requests</li>
<li><a href="https://github.com/xiph/flac/pulls">Github Pull Requests</a> - to contribute patches</li>
</ul>
<h1>Goals</h1>
Since FLAC is an open-source project, it's important to have a set of goals that everyone works to. They may change slightly from time to time but they're a good guideline. Changes should be in line with the goals and should not attempt to embrace any of the anti-goals.<br />
<br />
<b>Goals</b>
<ul>
<li>
FLAC should be and stay an open format with an open-source reference implementation.
</li>
<li>
FLAC should be lossless. This seems obvious but lossy compression seems to creep into every audio codec. This goal also means that <span class="commandname">flac</span> should stay archival quality and be truly lossless for all input. Testing of releases should be thorough.
</li>
<li>
FLAC should yield respectable compression, on par or better than other lossless codecs.
</li>
<li>
FLAC should allow at least realtime decoding on even modest hardware.
</li>
<li>
FLAC should support fast sample-accurate seeking.
</li>
<li>
FLAC should allow gapless playback of consecutive streams. This follows from the lossless goal.
</li>
<li>
The FLAC project owes a lot to the many people who have advanced the audio compression field so freely, and aims also to contribute through the open-source development of new ideas.
</li>
</ul>
<b>Anti-goals</b><br />
<ul>
<li>
Lossy compression. There are already many suitable lossy formats (<a href="http://www.xiph.org/vorbis/">Ogg Vorbis</a>, <a href="http://www.mp3-tech.org/">MP3</a>, etc.).
</li>
<li>
Copy prevention, DRM, etc. There is no intention to add any copy prevention methods. Of course, we can't stop someone from encrypting a FLAC stream in another container (e.g. the way Apple encrypts AAC in MP4 with FairPlay), that is the choice of the user.
</li>
</ul>