add new top level examples/ directory with one example for now (example_c_decode_file)
authorJosh Coalson <jcoalson@users.sourceforce.net>
Wed, 12 Sep 2007 02:42:05 +0000 (02:42 +0000)
committerJosh Coalson <jcoalson@users.sourceforce.net>
Wed, 12 Sep 2007 02:42:05 +0000 (02:42 +0000)
14 files changed:
FLAC.dsw
FLAC.sln
Makefile.lite
examples/Makefile.am [new file with mode: 0644]
examples/Makefile.lite [new file with mode: 0644]
examples/README [new file with mode: 0644]
examples/c/Makefile.am [new file with mode: 0644]
examples/c/decode/Makefile.am [new file with mode: 0644]
examples/c/decode/file/Makefile.am [new file with mode: 0644]
examples/c/decode/file/Makefile.lite [new file with mode: 0644]
examples/c/decode/file/example_c_decode_file.dsp [new file with mode: 0644]
examples/c/decode/file/example_c_decode_file.vcproj [new file with mode: 0644]
examples/c/decode/file/main.c [new file with mode: 0644]
examples/examples.dsp [new file with mode: 0644]

index aa3dffa..a3373c9 100644 (file)
--- a/FLAC.dsw
+++ b/FLAC.dsw
@@ -30,6 +30,9 @@ Package=<5>
 Package=<4>\r
 {{{\r
     Begin Project Dependency\r
+    Project_Dep_Name examples\r
+    End Project Dependency\r
+    Begin Project Dependency\r
     Project_Dep_Name flac\r
     End Project Dependency\r
     Begin Project Dependency\r
@@ -117,6 +120,9 @@ Package=<5>
 Package=<4>\r
 {{{\r
     Begin Project Dependency\r
+    Project_Dep_Name examples\r
+    End Project Dependency\r
+    Begin Project Dependency\r
     Project_Dep_Name flac\r
     End Project Dependency\r
     Begin Project Dependency\r
@@ -189,6 +195,36 @@ Package=<4>
 \r
 ###############################################################################\r
 \r
+Project: "examples"=.\examples\examples.dsp - Package Owner=<4>\r
+\r
+Package=<5>\r
+{{{\r
+}}}\r
+\r
+Package=<4>\r
+{{{\r
+    Begin Project Dependency\r
+    Project_Dep_Name example_c_decode_file\r
+    End Project Dependency\r
+}}}\r
+\r
+###############################################################################\r
+\r
+Project: "example_c_decode_file"=.\examples\c\decode\file\example_c_decode_file.dsp - Package Owner=<4>\r
+\r
+Package=<5>\r
+{{{\r
+}}}\r
+\r
+Package=<4>\r
+{{{\r
+    Begin Project Dependency\r
+    Project_Dep_Name libFLAC_static\r
+    End Project Dependency\r
+}}}\r
+\r
+###############################################################################\r
+\r
 Project: "flac"=.\src\flac\flac.dsp - Package Owner=<4>\r
 \r
 Package=<5>\r
index c546950..880b1ad 100644 (file)
--- a/FLAC.sln
+++ b/FLAC.sln
@@ -1,6 +1,11 @@
 \r
 Microsoft Visual Studio Solution File, Format Version 9.00\r
 # Visual C++ Express 2005\r
+Project("{4cefbc7c-c215-11db-8314-0800200c9a66}") = "example_c_decode_file", "example\c\decode\file\example_c_decode_file.vcproj", "{4cefbd00-c215-11db-8314-0800200c9a66}"\r
+       ProjectSection(ProjectDependencies) = postProject\r
+               {4cefbc84-c215-11db-8314-0800200c9a66} = {4cefbc84-c215-11db-8314-0800200c9a66}\r
+       EndProjectSection\r
+EndProject\r
 Project("{4cefbc7c-c215-11db-8314-0800200c9a66}") = "flac", "src\flac\flac.vcproj", "{4cefbc7d-c215-11db-8314-0800200c9a66}"\r
        ProjectSection(ProjectDependencies) = postProject\r
                {4cefbc81-c215-11db-8314-0800200c9a66} = {4cefbc81-c215-11db-8314-0800200c9a66}\r
@@ -220,6 +225,10 @@ Global
                {4cefbc95-c215-11db-8314-0800200c9a66}.Debug|Win32.ActiveCfg = Debug|Win32\r
                {4cefbc95-c215-11db-8314-0800200c9a66}.Debug|Win32.Build.0 = Debug|Win32\r
                {4cefbc95-c215-11db-8314-0800200c9a66}.Release|Win32.ActiveCfg = Release|Win32\r
+               {4cefbd00-c215-11db-8314-0800200c9a66}.Debug|Win32.ActiveCfg = Debug|Win32\r
+               {4cefbd00-c215-11db-8314-0800200c9a66}.Debug|Win32.ActiveCfg = Debug|Win32\r
+               {4cefbd00-c215-11db-8314-0800200c9a66}.Debug|Win32.Build.0 = Debug|Win32\r
+               {4cefbd00-c215-11db-8314-0800200c9a66}.Release|Win32.ActiveCfg = Release|Win32\r
        EndGlobalSection\r
        GlobalSection(SolutionProperties) = preSolution\r
                HideSolutionNode = FALSE\r
index 1db7163..92e5822 100644 (file)
@@ -30,8 +30,8 @@
 
 topdir = .
 
-.PHONY: all doc src libFLAC libFLAC++ share plugin_common plugin_xmms flac metaflac test_grabbag test_libFLAC test_libFLAC++ test_seeking test_streams
-all: doc src
+.PHONY: all doc src examples libFLAC libFLAC++ share plugin_common plugin_xmms flac metaflac test_grabbag test_libFLAC test_libFLAC++ test_seeking test_streams
+all: doc src examples
 
 DEFAULT_CONFIG = release
 
@@ -46,57 +46,61 @@ valgrind: all
 release : all
 
 doc:
-       (cd $@ ; $(MAKE) -f Makefile.lite)
+       (cd $@ && $(MAKE) -f Makefile.lite)
 
 src:
-       (cd $@ ; $(MAKE) -f Makefile.lite $(CONFIG))
+       (cd $@ && $(MAKE) -f Makefile.lite $(CONFIG))
+
+examples: src
+       (cd $@ && $(MAKE) -f Makefile.lite $(CONFIG))
 
 libFLAC:
-       (cd src/$@ ; $(MAKE) -f Makefile.lite $(CONFIG))
+       (cd src/$@ && $(MAKE) -f Makefile.lite $(CONFIG))
 
 libFLAC++: libFLAC
-       (cd src/$@ ; $(MAKE) -f Makefile.lite $(CONFIG))
+       (cd src/$@ && $(MAKE) -f Makefile.lite $(CONFIG))
 
 share: libFLAC
-       (cd src/$@ ; $(MAKE) -f Makefile.lite $(CONFIG))
+       (cd src/$@ && $(MAKE) -f Makefile.lite $(CONFIG))
 
 flac: libFLAC share
-       (cd src/$@ ; $(MAKE) -f Makefile.lite $(CONFIG))
+       (cd src/$@ && $(MAKE) -f Makefile.lite $(CONFIG))
 
 metaflac: libFLAC share
-       (cd src/$@ ; $(MAKE) -f Makefile.lite $(CONFIG))
+       (cd src/$@ && $(MAKE) -f Makefile.lite $(CONFIG))
 
 plugin_common: libFLAC
-       (cd src/$@ ; $(MAKE) -f Makefile.lite $(CONFIG))
+       (cd src/$@ && $(MAKE) -f Makefile.lite $(CONFIG))
 
 plugin_xmms: libFLAC plugin_common
-       (cd src/$@ ; $(MAKE) -f Makefile.lite $(CONFIG))
+       (cd src/$@ && $(MAKE) -f Makefile.lite $(CONFIG))
 
 test_seeking: libFLAC
-       (cd src/$@ ; $(MAKE) -f Makefile.lite $(CONFIG))
+       (cd src/$@ && $(MAKE) -f Makefile.lite $(CONFIG))
 
 test_streams: libFLAC
-       (cd src/$@ ; $(MAKE) -f Makefile.lite $(CONFIG))
+       (cd src/$@ && $(MAKE) -f Makefile.lite $(CONFIG))
 
 test_grabbag: share
-       (cd src/$@ ; $(MAKE) -f Makefile.lite $(CONFIG))
+       (cd src/$@ && $(MAKE) -f Makefile.lite $(CONFIG))
 
 test_libFLAC: libFLAC
-       (cd src/$@ ; $(MAKE) -f Makefile.lite $(CONFIG))
+       (cd src/$@ && $(MAKE) -f Makefile.lite $(CONFIG))
 
 test_libFLAC++: libFLAC libFLAC++
-       (cd src/$@ ; $(MAKE) -f Makefile.lite $(CONFIG))
+       (cd src/$@ && $(MAKE) -f Makefile.lite $(CONFIG))
 
 test: debug
-       (cd test ; $(MAKE) -f Makefile.lite debug)
+       (cd test && $(MAKE) -f Makefile.lite debug)
 
 testv: valgrind
-       (cd test ; $(MAKE) -f Makefile.lite valgrind)
+       (cd test && $(MAKE) -f Makefile.lite valgrind)
 
 testr: release
-       (cd test ; $(MAKE) -f Makefile.lite release)
+       (cd test && $(MAKE) -f Makefile.lite release)
 
 clean:
-       -(cd doc ; $(MAKE) -f Makefile.lite clean)
-       -(cd src ; $(MAKE) -f Makefile.lite clean)
-       -(cd test ; $(MAKE) -f Makefile.lite clean)
+       -(cd doc && $(MAKE) -f Makefile.lite clean)
+       -(cd src && $(MAKE) -f Makefile.lite clean)
+       -(cd examples && $(MAKE) -f Makefile.lite clean)
+       -(cd test && $(MAKE) -f Makefile.lite clean)
diff --git a/examples/Makefile.am b/examples/Makefile.am
new file mode 100644 (file)
index 0000000..64a49f3
--- /dev/null
@@ -0,0 +1,27 @@
+#  FLAC - Free Lossless Audio Codec
+#  Copyright (C) 2001,2002,2003,2004,2005,2006,2007  Josh Coalson
+#
+#  This file is part the FLAC project.  FLAC is comprised of several
+#  components distributed under difference licenses.  The codec libraries
+#  are distributed under Xiph.Org's BSD-like license (see the file
+#  COPYING.Xiph in this distribution).  All other programs, libraries, and
+#  plugins are distributed under the GPL (see COPYING.GPL).  The documentation
+#  is distributed under the Gnu FDL (see COPYING.FDL).  Each file in the
+#  FLAC distribution contains at the top the terms under which it may be
+#  distributed.
+#
+#  Since this particular file is relevant to all components of FLAC,
+#  it may be distributed under the Xiph.Org license, which is the least
+#  restrictive of those mentioned above.  See the file COPYING.Xiph in this
+#  distribution.
+
+if FLaC__WITH_CPPLIBS
+CPPLIBS_DIRS = cpp
+endif
+
+SUBDIRS = c $(CPPLIBS_DIRS)
+
+EXTRA_DIST = \
+       examples.dsp \
+       Makefile.lite \
+       README
diff --git a/examples/Makefile.lite b/examples/Makefile.lite
new file mode 100644 (file)
index 0000000..721c349
--- /dev/null
@@ -0,0 +1,37 @@
+#  FLAC - Free Lossless Audio Codec
+#  Copyright (C) 2001,2002,2003,2004,2005,2006,2007  Josh Coalson
+#
+#  This file is part the FLAC project.  FLAC is comprised of several
+#  components distributed under difference licenses.  The codec libraries
+#  are distributed under Xiph.Org's BSD-like license (see the file
+#  COPYING.Xiph in this distribution).  All other programs, libraries, and
+#  plugins are distributed under the GPL (see COPYING.GPL).  The documentation
+#  is distributed under the Gnu FDL (see COPYING.FDL).  Each file in the
+#  FLAC distribution contains at the top the terms under which it may be
+#  distributed.
+#
+#  Since this particular file is relevant to all components of FLAC,
+#  it may be distributed under the Xiph.Org license, which is the least
+#  restrictive of those mentioned above.  See the file COPYING.Xiph in this
+#  distribution.
+
+.PHONY: all example_c_decode_file
+all: example_c_decode_file
+
+DEFAULT_CONFIG = release
+
+CONFIG = $(DEFAULT_CONFIG)
+
+debug   : CONFIG = debug
+valgrind: CONFIG = valgrind
+release : CONFIG = release
+
+debug   : all
+valgrind: all
+release : all
+
+example_c_decode_file:
+       (cd c/decode/file && $(MAKE) -f Makefile.lite $(CONFIG))
+
+clean:
+       -(cd c/decode/file && $(MAKE) -f Makefile.lite clean)
diff --git a/examples/README b/examples/README
new file mode 100644 (file)
index 0000000..2f30e64
--- /dev/null
@@ -0,0 +1,9 @@
+Here are several small example programs that use the libraries in different
+ways.
+
+The "c" directory has programs that are all in C and use libFLAC.
+
+The "cpp" directory has analogous programs that are all in C++ and use libFLAC++. 
+
+The programs are:
+c/decode/file/ - example_c_decode_file - Simple FLAC file decoder using libFLAC
diff --git a/examples/c/Makefile.am b/examples/c/Makefile.am
new file mode 100644 (file)
index 0000000..e657f9e
--- /dev/null
@@ -0,0 +1,18 @@
+#  FLAC - Free Lossless Audio Codec
+#  Copyright (C) 2001,2002,2003,2004,2005,2006,2007  Josh Coalson
+#
+#  This file is part the FLAC project.  FLAC is comprised of several
+#  components distributed under difference licenses.  The codec libraries
+#  are distributed under Xiph.Org's BSD-like license (see the file
+#  COPYING.Xiph in this distribution).  All other programs, libraries, and
+#  plugins are distributed under the GPL (see COPYING.GPL).  The documentation
+#  is distributed under the Gnu FDL (see COPYING.FDL).  Each file in the
+#  FLAC distribution contains at the top the terms under which it may be
+#  distributed.
+#
+#  Since this particular file is relevant to all components of FLAC,
+#  it may be distributed under the Xiph.Org license, which is the least
+#  restrictive of those mentioned above.  See the file COPYING.Xiph in this
+#  distribution.
+
+SUBDIRS = decode
diff --git a/examples/c/decode/Makefile.am b/examples/c/decode/Makefile.am
new file mode 100644 (file)
index 0000000..35bb987
--- /dev/null
@@ -0,0 +1,18 @@
+#  FLAC - Free Lossless Audio Codec
+#  Copyright (C) 2001,2002,2003,2004,2005,2006,2007  Josh Coalson
+#
+#  This file is part the FLAC project.  FLAC is comprised of several
+#  components distributed under difference licenses.  The codec libraries
+#  are distributed under Xiph.Org's BSD-like license (see the file
+#  COPYING.Xiph in this distribution).  All other programs, libraries, and
+#  plugins are distributed under the GPL (see COPYING.GPL).  The documentation
+#  is distributed under the Gnu FDL (see COPYING.FDL).  Each file in the
+#  FLAC distribution contains at the top the terms under which it may be
+#  distributed.
+#
+#  Since this particular file is relevant to all components of FLAC,
+#  it may be distributed under the Xiph.Org license, which is the least
+#  restrictive of those mentioned above.  See the file COPYING.Xiph in this
+#  distribution.
+
+SUBDIRS = file
diff --git a/examples/c/decode/file/Makefile.am b/examples/c/decode/file/Makefile.am
new file mode 100644 (file)
index 0000000..a7d692d
--- /dev/null
@@ -0,0 +1,30 @@
+#  example_c_decode_file - Simple FLAC file decoder using libFLAC
+#  Copyright (C) 2007  Josh Coalson
+# 
+#  This program is free software; you can redistribute it and/or
+#  modify it under the terms of the GNU General Public License
+#  as published by the Free Software Foundation; either version 2
+#  of the License, or (at your option) any later version.
+# 
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU General Public License for more details.
+# 
+#  You should have received a copy of the GNU General Public License
+#  along with this program; if not, write to the Free Software
+#  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+
+EXTRA_DIST = \
+       Makefile.lite \
+       example_c_decode_file.dsp \
+       example_c_decode_file.vcproj \
+
+INCLUDES = -I$(top_srcdir)/src/libFLAC/include
+
+noinst_PROGRAMS = example_c_decode_file
+example_c_decode_file_LDADD = \
+       @OGG_LIBS@ \
+       @MINGW_WINSOCK_LIBS@ \
+       -lm
+example_c_decode_file_SOURCES = main.c
diff --git a/examples/c/decode/file/Makefile.lite b/examples/c/decode/file/Makefile.lite
new file mode 100644 (file)
index 0000000..111b262
--- /dev/null
@@ -0,0 +1,39 @@
+#  example_c_decode_file - Simple FLAC file decoder using libFLAC
+#  Copyright (C) 2007  Josh Coalson
+#
+#  This program is free software; you can redistribute it and/or
+#  modify it under the terms of the GNU General Public License
+#  as published by the Free Software Foundation; either version 2
+#  of the License, or (at your option) any later version.
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU General Public License for more details.
+#
+#  You should have received a copy of the GNU General Public License
+#  along with this program; if not, write to the Free Software
+#  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+
+#
+# GNU makefile
+#
+
+topdir = ../../../..
+libdir = $(topdir)/obj/$(BUILD)/lib
+
+PROGRAM_NAME = example_c_decode_file
+
+INCLUDES = -I../libFLAC/include -I$(topdir)/include
+
+ifeq ($(DARWIN_BUILD),yes)
+EXPLICIT_LIBS = $(libdir)/libFLAC.a $(OGG_LIB_DIR)/libogg.a -lm
+else
+LIBS = -lFLAC -L$(OGG_LIB_DIR) -logg -lm
+endif
+
+SRCS_C = main.c
+
+include $(topdir)/build/exe.mk
+
+# DO NOT DELETE THIS LINE -- make depend depends on it.
diff --git a/examples/c/decode/file/example_c_decode_file.dsp b/examples/c/decode/file/example_c_decode_file.dsp
new file mode 100644 (file)
index 0000000..fe0a7d2
--- /dev/null
@@ -0,0 +1,100 @@
+# Microsoft Developer Studio Project File - Name="example_c_decode_file" - Package Owner=<4>\r
+# Microsoft Developer Studio Generated Build File, Format Version 6.00\r
+# ** DO NOT EDIT **\r
+\r
+# TARGTYPE "Win32 (x86) Console Application" 0x0103\r
+\r
+CFG=example_c_decode_file - Win32 Debug\r
+!MESSAGE This is not a valid makefile. To build this project using NMAKE,\r
+!MESSAGE use the Export Makefile command and run\r
+!MESSAGE \r
+!MESSAGE NMAKE /f "example_c_decode_file.mak".\r
+!MESSAGE \r
+!MESSAGE You can specify a configuration when running NMAKE\r
+!MESSAGE by defining the macro CFG on the command line. For example:\r
+!MESSAGE \r
+!MESSAGE NMAKE /f "example_c_decode_file.mak" CFG="example_c_decode_file - Win32 Debug"\r
+!MESSAGE \r
+!MESSAGE Possible choices for configuration are:\r
+!MESSAGE \r
+!MESSAGE "example_c_decode_file - Win32 Release" (based on "Win32 (x86) Console Application")\r
+!MESSAGE "example_c_decode_file - Win32 Debug" (based on "Win32 (x86) Console Application")\r
+!MESSAGE \r
+\r
+# Begin Project\r
+# PROP AllowPerConfigDependencies 0\r
+# PROP Scc_ProjName ""\r
+# PROP Scc_LocalPath ""\r
+CPP=cl.exe\r
+RSC=rc.exe\r
+\r
+!IF  "$(CFG)" == "example_c_decode_file - Win32 Release"\r
+\r
+# PROP BASE Use_MFC 0\r
+# PROP BASE Use_Debug_Libraries 0\r
+# PROP BASE Output_Dir "Release"\r
+# PROP BASE Intermediate_Dir "Release"\r
+# PROP BASE Target_Dir ""\r
+# PROP Use_MFC 0\r
+# PROP Use_Debug_Libraries 0\r
+# PROP Output_Dir "..\..\..\..\obj\release\bin"\r
+# PROP Intermediate_Dir "Release"\r
+# PROP Ignore_Export_Lib 0\r
+# PROP Target_Dir ""\r
+# ADD BASE CPP /nologo /W3 /GX /O2 /D "WIN32" /D "NDEBUG" /D "_CONSOLE" /D "_MBCS" /Yu"stdafx.h" /FD /c\r
+# ADD CPP /nologo /MD /W3 /GX /O2 /I "..\..\..\..\include" /D "NDEBUG" /D "FLAC__NO_DLL" /D "WIN32" /D "_CONSOLE" /D "_MBCS" /FD /c\r
+# SUBTRACT CPP /YX /Yc /Yu\r
+# ADD BASE RSC /l 0x409 /d "NDEBUG"\r
+# ADD RSC /l 0x409 /d "NDEBUG"\r
+BSC32=bscmake.exe\r
+# ADD BASE BSC32 /nologo\r
+# ADD BSC32 /nologo\r
+LINK32=link.exe\r
+# ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /subsystem:console /machine:I386\r
+# ADD LINK32 ..\..\..\..\obj\release\lib\libFLAC_static.lib ..\..\..\..\obj\release\lib\ogg_static.lib /nologo /subsystem:console /machine:I386\r
+\r
+!ELSEIF  "$(CFG)" == "example_c_decode_file - Win32 Debug"\r
+\r
+# PROP BASE Use_MFC 0\r
+# PROP BASE Use_Debug_Libraries 1\r
+# PROP BASE Output_Dir "Debug"\r
+# PROP BASE Intermediate_Dir "Debug"\r
+# PROP BASE Target_Dir ""\r
+# PROP Use_MFC 0\r
+# PROP Use_Debug_Libraries 1\r
+# PROP Output_Dir "..\..\..\..\obj\debug\bin"\r
+# PROP Intermediate_Dir "Debug"\r
+# PROP Ignore_Export_Lib 0\r
+# PROP Target_Dir ""\r
+# ADD BASE CPP /nologo /W3 /Gm /GX /ZI /Od /D "WIN32" /D "_DEBUG" /D "_CONSOLE" /D "_MBCS" /Yu"stdafx.h" /FD /GZ /c\r
+# ADD CPP /nologo /MDd /W3 /Gm /GX /ZI /Od /I "..\..\..\..\include" /D "_DEBUG" /D "DEBUG" /D "FLAC__NO_DLL" /D "WIN32" /D "_CONSOLE" /D "_MBCS" /FD /GZ /c\r
+# SUBTRACT CPP /YX /Yc /Yu\r
+# ADD BASE RSC /l 0x409 /d "_DEBUG"\r
+# ADD RSC /l 0x409 /d "_DEBUG"\r
+BSC32=bscmake.exe\r
+# ADD BASE BSC32 /nologo\r
+# ADD BSC32 /nologo\r
+LINK32=link.exe\r
+# ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /subsystem:console /debug /machine:I386 /pdbtype:sept\r
+# ADD LINK32 ..\..\..\..\obj\debug\lib\libFLAC_static.lib ..\..\..\..\obj\release\lib\ogg_static.lib /nologo /subsystem:console /debug /machine:I386 /pdbtype:sept\r
+\r
+!ENDIF \r
+\r
+# Begin Target\r
+\r
+# Name "example_c_decode_file - Win32 Release"\r
+# Name "example_c_decode_file - Win32 Debug"\r
+# Begin Group "Source Files"\r
+\r
+# PROP Default_Filter "cpp;c;cxx;rc;def;r;odl;idl;hpj;bat"\r
+# Begin Source File\r
+\r
+SOURCE=.\main.c\r
+# End Source File\r
+# End Group\r
+# Begin Group "Header Files"\r
+\r
+# PROP Default_Filter "h;hpp;hxx;hm;inl"\r
+# End Group\r
+# End Target\r
+# End Project\r
diff --git a/examples/c/decode/file/example_c_decode_file.vcproj b/examples/c/decode/file/example_c_decode_file.vcproj
new file mode 100644 (file)
index 0000000..ec40ece
--- /dev/null
@@ -0,0 +1,204 @@
+<?xml version="1.0" encoding="Windows-1252"?>\r
+<VisualStudioProject\r
+       ProjectType="Visual C++"\r
+       Version="8.00"\r
+       Name="example_c_decode_file"\r
+       ProjectGUID="{4cefbd00-c215-11db-8314-0800200c9a66}"\r
+       RootNamespace="example_c_decode_file"\r
+       Keyword="Win32Proj"\r
+       >\r
+       <Platforms>\r
+               <Platform\r
+                       Name="Win32"\r
+               />\r
+       </Platforms>\r
+       <ToolFiles>\r
+       </ToolFiles>\r
+       <Configurations>\r
+               <Configuration\r
+                       Name="Debug|Win32"\r
+                       OutputDirectory="..\..\..\..\obj\debug\bin"\r
+                       IntermediateDirectory="Debug"\r
+                       ConfigurationType="1"\r
+                       >\r
+                       <Tool\r
+                               Name="VCPreBuildEventTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCCustomBuildTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCXMLDataGeneratorTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCWebServiceProxyGeneratorTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCMIDLTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCCLCompilerTool"\r
+                               Optimization="0"\r
+                               AdditionalIncludeDirectories="..\..\..\..\include"\r
+                               PreprocessorDefinitions="WIN32;_DEBUG;_CONSOLE;FLAC__NO_DLL;DEBUG"\r
+                               MinimalRebuild="true"\r
+                               BasicRuntimeChecks="3"\r
+                               RuntimeLibrary="1"\r
+                               UsePrecompiledHeader="0"\r
+                               WarningLevel="3"\r
+                               Detect64BitPortabilityProblems="true"\r
+                               DebugInformationFormat="4"\r
+                               CompileAs="0"\r
+                               DisableSpecificWarnings="4267;4996"\r
+                       />\r
+                       <Tool\r
+                               Name="VCManagedResourceCompilerTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCResourceCompilerTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCPreLinkEventTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCLinkerTool"\r
+                               AdditionalDependencies="..\..\..\..\obj\release\lib\ogg_static.lib"\r
+                               LinkIncremental="2"\r
+                               IgnoreDefaultLibraryNames="uuid.lib"\r
+                               GenerateDebugInformation="true"\r
+                               SubSystem="1"\r
+                               TargetMachine="1"\r
+                       />\r
+                       <Tool\r
+                               Name="VCALinkTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCManifestTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCXDCMakeTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCBscMakeTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCFxCopTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCAppVerifierTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCWebDeploymentTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCPostBuildEventTool"\r
+                       />\r
+               </Configuration>\r
+               <Configuration\r
+                       Name="Release|Win32"\r
+                       OutputDirectory="..\..\..\..\obj\release\bin"\r
+                       IntermediateDirectory="Release"\r
+                       ConfigurationType="1"\r
+                       >\r
+                       <Tool\r
+                               Name="VCPreBuildEventTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCCustomBuildTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCXMLDataGeneratorTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCWebServiceProxyGeneratorTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCMIDLTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCCLCompilerTool"\r
+                               EnableIntrinsicFunctions="true"\r
+                               FavorSizeOrSpeed="1"\r
+                               OmitFramePointers="true"\r
+                               WholeProgramOptimization="true"\r
+                               AdditionalIncludeDirectories="..\..\..\..\include"\r
+                               PreprocessorDefinitions="WIN32;NDEBUG;_CONSOLE;FLAC__NO_DLL"\r
+                               RuntimeLibrary="0"\r
+                               BufferSecurityCheck="false"\r
+                               UsePrecompiledHeader="0"\r
+                               WarningLevel="3"\r
+                               Detect64BitPortabilityProblems="true"\r
+                               DebugInformationFormat="3"\r
+                               CompileAs="0"\r
+                               DisableSpecificWarnings="4267;4996"\r
+                       />\r
+                       <Tool\r
+                               Name="VCManagedResourceCompilerTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCResourceCompilerTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCPreLinkEventTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCLinkerTool"\r
+                               AdditionalDependencies="..\..\..\..\obj\release\lib\ogg_static.lib"\r
+                               LinkIncremental="1"\r
+                               IgnoreDefaultLibraryNames="uuid.lib"\r
+                               GenerateDebugInformation="true"\r
+                               SubSystem="1"\r
+                               OptimizeReferences="2"\r
+                               EnableCOMDATFolding="2"\r
+                               LinkTimeCodeGeneration="1"\r
+                               TargetMachine="1"\r
+                       />\r
+                       <Tool\r
+                               Name="VCALinkTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCManifestTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCXDCMakeTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCBscMakeTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCFxCopTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCAppVerifierTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCWebDeploymentTool"\r
+                       />\r
+                       <Tool\r
+                               Name="VCPostBuildEventTool"\r
+                       />\r
+               </Configuration>\r
+       </Configurations>\r
+       <References>\r
+       </References>\r
+       <Files>\r
+               <Filter\r
+                       Name="Header Files"\r
+                       Filter="h;hpp;hxx;hm;inl;inc;xsd"\r
+                       UniqueIdentifier="{39992580-89DB-4b41-8E8B-625F9E28BEBF}"\r
+                       >\r
+               </Filter>\r
+               <Filter\r
+                       Name="Source Files"\r
+                       Filter="cpp;c;cc;cxx;def;odl;idl;hpj;bat;asm;asmx"\r
+                       UniqueIdentifier="{4FC727F1-C7A5-1376-A061-2AF2D742A2F0}"\r
+                       >\r
+                       <File\r
+                               RelativePath=".\main.c"\r
+                               >\r
+                       </File>\r
+               </Filter>\r
+       </Files>\r
+       <Globals>\r
+       </Globals>\r
+</VisualStudioProject>\r
diff --git a/examples/c/decode/file/main.c b/examples/c/decode/file/main.c
new file mode 100644 (file)
index 0000000..82d56c3
--- /dev/null
@@ -0,0 +1,186 @@
+/* example_c_decode_file - Simple FLAC file decoder using libFLAC
+ * Copyright (C) 2007  Josh Coalson
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ */
+
+/*
+ * This example shows how to use libFLAC to decode a FLAC file to a WAVE
+ * file.  It only supports 16-bit stereo files.
+ */
+
+#if HAVE_CONFIG_H
+#  include <config.h>
+#endif
+
+#include <stdio.h>
+#include <stdlib.h>
+#include "FLAC/stream_decoder.h"
+
+static FLAC__StreamDecoderWriteStatus write_callback(const FLAC__StreamDecoder *decoder, const FLAC__Frame *frame, const FLAC__int32 * const buffer[], void *client_data);
+static void metadata_callback(const FLAC__StreamDecoder *decoder, const FLAC__StreamMetadata *metadata, void *client_data);
+static void error_callback(const FLAC__StreamDecoder *decoder, FLAC__StreamDecoderErrorStatus status, void *client_data);
+
+FLAC__uint64 total_samples = 0;
+unsigned sample_rate = 0;
+unsigned channels = 0;
+unsigned bps = 0;
+
+static FLAC__bool write_little_endian_uint16(FILE *f, FLAC__uint16 x)
+{
+       return
+               fputc(x, f) != EOF &&
+               fputc(x >> 8, f) != EOF
+       ;
+}
+
+static FLAC__bool write_little_endian_int16(FILE *f, FLAC__int16 x)
+{
+       return write_little_endian_uint16(f, (FLAC__uint16)x);
+}
+
+static FLAC__bool write_little_endian_uint32(FILE *f, FLAC__uint32 x)
+{
+       return
+               fputc(x, f) != EOF &&
+               fputc(x >> 8, f) != EOF &&
+               fputc(x >> 16, f) != EOF &&
+               fputc(x >> 24, f) != EOF
+       ;
+}
+
+int main(int argc, char *argv[])
+{
+       FLAC__bool ok = true;
+       FLAC__StreamDecoder *decoder = 0;
+       FLAC__StreamDecoderInitStatus init_status;
+       FILE *fout;
+
+       if(argc != 3) {
+               fprintf(stderr, "usage: %s infile.flac outfile.wav\n", argv[0]);
+               return 1;
+       }
+
+       if((decoder = FLAC__stream_decoder_new()) == NULL) {
+               fprintf(stderr, "ERROR: allocation decoder\n");
+               return 1;
+       }
+
+       if((fout = fopen(argv[2], "wb")) == NULL) {
+               fprintf(stderr, "ERROR: opening %s for output\n", argv[2]);
+               return 1;
+       }
+
+       (void)FLAC__stream_decoder_set_md5_checking(decoder, true);
+
+       init_status = FLAC__stream_decoder_init_file(decoder, argv[1], write_callback, metadata_callback, error_callback, /*client_data=*/fout);
+       if(init_status != FLAC__STREAM_DECODER_INIT_STATUS_OK) {
+               fprintf(stderr, "ERROR: initializing decoder: %s\n", FLAC__StreamDecoderInitStatusString[init_status]);
+               ok = false;
+       }
+
+       if(ok) {
+               ok = FLAC__stream_decoder_process_until_end_of_stream(decoder);
+               fprintf(stderr, "decoding: %s\n", ok? "succeeded" : "FAILED");
+               fprintf(stderr, "   state: %s\n", FLAC__StreamDecoderStateString[FLAC__stream_decoder_get_state(decoder)]);
+       }
+
+       FLAC__stream_decoder_delete(decoder);
+       fclose(fout);
+
+       return 0;
+}
+
+FLAC__StreamDecoderWriteStatus write_callback(const FLAC__StreamDecoder *decoder, const FLAC__Frame *frame, const FLAC__int32 * const buffer[], void *client_data)
+{
+       FILE *f = (FILE*)client_data;
+       const FLAC__uint32 total_size = (FLAC__uint32)(total_samples * channels * (bps/8));
+       size_t i;
+
+       (void)decoder;
+
+       if(total_samples == 0) {
+               fprintf(stderr, "ERROR: this example only works for FLAC files that have a total_samples count in STREAMINFO\n");
+               return FLAC__STREAM_DECODER_WRITE_STATUS_ABORT;
+       }
+       if(channels != 2 || bps != 16) {
+               fprintf(stderr, "ERROR: this example only supports 16bit stereo streams\n");
+               return FLAC__STREAM_DECODER_WRITE_STATUS_ABORT;
+       }
+
+       /* write WAVE header before we write the first frame */
+       if(frame->header.number.sample_number == 0) {
+               if(
+                       fwrite("RIFF", 1, 4, f) < 4 ||
+                       !write_little_endian_uint32(f, total_size + 36) ||
+                       fwrite("WAVEfmt ", 1, 8, f) < 8 ||
+                       !write_little_endian_uint32(f, 16) ||
+                       !write_little_endian_uint16(f, 1) ||
+                       !write_little_endian_uint16(f, channels) ||
+                       !write_little_endian_uint32(f, sample_rate) ||
+                       !write_little_endian_uint32(f, sample_rate * channels * (bps/8)) ||
+                       !write_little_endian_uint16(f, channels * (bps/8)) || /* block align */
+                       !write_little_endian_uint16(f, bps) ||
+                       fwrite("data", 1, 4, f) < 4 ||
+                       !write_little_endian_uint32(f, total_size)
+               ) {
+                       fprintf(stderr, "ERROR: write error\n");
+                       return FLAC__STREAM_DECODER_WRITE_STATUS_ABORT;
+               }
+       }
+
+       /* write decoded PCM samples */
+       for(i = 0; i < frame->header.blocksize; i++) {
+               if(
+                       !write_little_endian_int16(f, buffer[0][i]) ||  /* left channel */
+                       !write_little_endian_int16(f, buffer[1][i])     /* right channel */
+               ) {
+                       fprintf(stderr, "ERROR: write error\n");
+                       return FLAC__STREAM_DECODER_WRITE_STATUS_ABORT;
+               }
+       }
+
+       return FLAC__STREAM_DECODER_WRITE_STATUS_CONTINUE;
+}
+
+void metadata_callback(const FLAC__StreamDecoder *decoder, const FLAC__StreamMetadata *metadata, void *client_data)
+{
+       (void)decoder, (void)client_data;
+
+       /* print some stats */
+       if(metadata->type == FLAC__METADATA_TYPE_STREAMINFO) {
+               /* save for later */
+               total_samples = metadata->data.stream_info.total_samples;
+               sample_rate = metadata->data.stream_info.sample_rate;
+               channels = metadata->data.stream_info.channels;
+               bps = metadata->data.stream_info.bits_per_sample;
+
+               fprintf(stderr, "sample rate    : %u Hz\n", sample_rate);
+               fprintf(stderr, "channels       : %u\n", channels);
+               fprintf(stderr, "bits per sample: %u\n", bps);
+#ifdef _MSC_VER
+               fprintf(stderr, "total samples  : %I64u\n", total_samples);
+#else
+               fprintf(stderr, "total samples  : %llu\n", total_samples);
+#endif
+       }
+}
+
+void error_callback(const FLAC__StreamDecoder *decoder, FLAC__StreamDecoderErrorStatus status, void *client_data)
+{
+       (void)decoder, (void)client_data;
+
+       fprintf(stderr, "Got error callback: %s\n", FLAC__StreamDecoderErrorStatusString[status]);
+}
diff --git a/examples/examples.dsp b/examples/examples.dsp
new file mode 100644 (file)
index 0000000..a608a67
--- /dev/null
@@ -0,0 +1,67 @@
+# Microsoft Developer Studio Project File - Name="examples" - Package Owner=<4>\r
+# Microsoft Developer Studio Generated Build File, Format Version 6.00\r
+# ** DO NOT EDIT **\r
+\r
+# TARGTYPE "Win32 (x86) Generic Project" 0x010a\r
+\r
+CFG=examples - Win32 Debug\r
+!MESSAGE This is not a valid makefile. To build this project using NMAKE,\r
+!MESSAGE use the Export Makefile command and run\r
+!MESSAGE \r
+!MESSAGE NMAKE /f "examples.mak".\r
+!MESSAGE \r
+!MESSAGE You can specify a configuration when running NMAKE\r
+!MESSAGE by defining the macro CFG on the command line. For example:\r
+!MESSAGE \r
+!MESSAGE NMAKE /f "examples.mak" CFG="examples - Win32 Debug"\r
+!MESSAGE \r
+!MESSAGE Possible choices for configuration are:\r
+!MESSAGE \r
+!MESSAGE "examples - Win32 Release" (based on "Win32 (x86) Generic Project")\r
+!MESSAGE "examples - Win32 Debug" (based on "Win32 (x86) Generic Project")\r
+!MESSAGE \r
+\r
+# Begin Project\r
+# PROP AllowPerConfigDependencies 0\r
+# PROP Scc_ProjName "all"\r
+# PROP Scc_LocalPath "."\r
+MTL=midl.exe\r
+\r
+!IF  "$(CFG)" == "examples - Win32 Release"\r
+\r
+# PROP BASE Use_MFC 0\r
+# PROP BASE Use_Debug_Libraries 0\r
+# PROP BASE Output_Dir "Release"\r
+# PROP BASE Intermediate_Dir "Release"\r
+# PROP BASE Target_Dir ""\r
+# PROP Use_MFC 0\r
+# PROP Use_Debug_Libraries 0\r
+# PROP Output_Dir "..\obj\release"\r
+# PROP Intermediate_Dir "..\obj\release"\r
+# PROP Target_Dir ""\r
+\r
+!ELSEIF  "$(CFG)" == "examples - Win32 Debug"\r
+\r
+# PROP BASE Use_MFC 0\r
+# PROP BASE Use_Debug_Libraries 1\r
+# PROP BASE Output_Dir "Debug"\r
+# PROP BASE Intermediate_Dir "Debug"\r
+# PROP BASE Target_Dir ""\r
+# PROP Use_MFC 0\r
+# PROP Use_Debug_Libraries 1\r
+# PROP Output_Dir "..\obj\debug"\r
+# PROP Intermediate_Dir "..\obj\debug"\r
+# PROP Target_Dir ""\r
+\r
+!ENDIF \r
+\r
+# Begin Target\r
+\r
+# Name "examples - Win32 Release"\r
+# Name "examples - Win32 Debug"\r
+# Begin Source File\r
+\r
+SOURCE=.\README\r
+# End Source File\r
+# End Target\r
+# End Project\r