initial upload

Author: Marc Boucek

.clang-format

@@ -0,0 +1,72 @@
+AccessModifierOffset: -4
+AlignAfterOpenBracket: Align
+AlignConsecutiveAssignments: true
+AlignConsecutiveDeclarations: true
+AlignEscapedNewlinesLeft: true
+AlignOperands: true
+AlignTrailingComments: true
+AllowAllParametersOfDeclarationOnNextLine: true
+AllowShortBlocksOnASingleLine: false
+AllowShortFunctionsOnASingleLine: None
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakBeforeMultilineStrings: false
+AlwaysBreakTemplateDeclarations: true
+BinPackArguments: false
+BinPackParameters: false
+BraceWrapping:
+  AfterClass:      true
+  AfterControlStatement: true
+  AfterEnum:       true
+  AfterFunction:   true
+  AfterNamespace:  true
+  AfterObjCDeclaration: true
+  AfterStruct:     true
+  AfterUnion:      true
+  BeforeCatch:     true
+  BeforeElse:      true
+  IndentBraces:    false
+BreakBeforeBinaryOperators: NonAssignment
+BreakBeforeBraces: Custom
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializersBeforeComma: true
+ColumnLimit: 120
+CommentPragmas: '^!'
+ConstructorInitializerAllOnOneLineOrOnePerLine: false
+ConstructorInitializerIndentWidth: 0
+ContinuationIndentWidth: 4
+Cpp11BracedListStyle: true
+DerivePointerAlignment: false
+DisableFormat: false
+ExperimentalAutoDetectBinPacking: false
+ForEachMacros: [ foreach, BOOST_FOREACH ]
+IndentCaseLabels: true
+IndentFunctionDeclarationAfterType: false
+IndentWidth: 4
+IndentWrappedFunctionNames: false
+KeepEmptyLinesAtTheStartOfBlocks: true
+Language: Cpp
+MaxEmptyLinesToKeep: 2
+NamespaceIndentation: None
+ObjCSpaceAfterProperty: false
+ObjCSpaceBeforeProtocolList: true
+PenaltyBreakBeforeFirstCallParameter: 19
+PenaltyBreakComment: 300
+PenaltyBreakFirstLessLess: 120
+PenaltyBreakString: 1000
+PenaltyExcessCharacter: 100
+PenaltyReturnTypeOnItsOwnLine: 600
+PointerAlignment: Left
+SpaceAfterCStyleCast: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeParens: ControlStatements
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 1
+SpacesInAngles:  false
+SpacesInContainerLiterals: true
+SpacesInCStyleCastParentheses: false
+SpacesInParentheses: true
+SpacesInSquareBrackets: false
+Standard: Cpp11
+TabWidth: 4
+UseTab: Never

.gitattributes

@@ -0,0 +1 @@
+* text=auto

.gitignore

@@ -0,0 +1,37 @@
+# build products --------------------------------
+
+build/
+
+# cmake convention ------------------------------
+
+/build*
+
+# generated by python ---------------------------
+
+*.pyc
+
+# generated by XCode ----------------------------
+
+xcuserdata/
+project.xcworkspace/
+*.pbxuser
+
+# generated by Mac OS X -------------------------
+
+.DS_Store
+
+# generated by Visual Studio --------------------
+
+*.bak
+*.ncb
+*.opensdf
+*.opt
+*.sdf
+*.suo
+*.user
+.vscode
+
+
+# temporary files -------------------------------
+
+*~

CMakeLists.txt

@@ -0,0 +1,52 @@
+cmake_minimum_required(VERSION 3.4)
+
+if( TARGET ni-media )
+  return()
+endif()
+
+project( ni-media )
+
+option( NIMEDIA_ENABLE_DEPRECATION_WARNINGS   "Enable ni-media deprecation warnings"  ON )
+if( CMAKE_PROJECT_NAME STREQUAL "ni-media" )
+  option( NIMEDIA_TESTS "Build ni-media Tests" ON )
+else()
+  option( NIMEDIA_TESTS "Build ni-media Tests" OFF )
+endif()
+
+
+if(WIN32 AND CMAKE_CL_64)
+set(WIN64 1)
+elseif (CMAKE_SYSTEM_NAME MATCHES "Linux")
+set(LINUX 1)
+endif()
+
+list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmake)
+
+include(ni_add_src_file)
+include(ni_add_src_group)
+include(ni_add_gtest)
+
+
+if( NIMEDIA_TESTS )
+  enable_testing()
+  find_package(GTest REQUIRED)
+endif()
+
+add_subdirectory( pcm )
+add_subdirectory( audiostream )
+
+# for backwards compatibility:
+add_library( ni-media INTERFACE )
+target_link_libraries( ni-media INTERFACE audiostream pcm )
+if( NOT NIMEDIA_ENABLE_DEPRECATION_WARNINGS )
+  target_compile_definitions( ni-media INTERFACE NI_MEDIA_NO_DEPRECATION_WARNINGS )
+endif()
+
+
+foreach( target audiostream audiostream_test pcm pcm_test )
+  if( TARGET ${target} )
+    set_property( TARGET ${target} PROPERTY FOLDER ni-media )
+    set_property( TARGET ${target} PROPERTY CXX_STANDARD 14)
+  endif()
+endforeach()
+

README.md

@@ -0,0 +1,36 @@
+# NI MEDIA
+
+NI Media is a library for reading from / writing to audio streams developed at [Native Instruments](https://www.native-instruments.com).
+
+The goal is to have a modern C++ library for dealing with audio streams in an idiomatic C++ style.
+
+Modern:
+- a clear separation of concerns (modular instead of fat classes)
+- support for ranges and iterators
+
+Idiomatic:
+- based on std.streams.
+- integrates well with STL algorithms and boost
+
+
+The following example demonstrates how to stream an entire audio file into a vector:
+
+```cpp
+#include <ni/media/audio/ifstream.h>
+#include <vector>
+
+int main()
+{
+    auto stream = audio::ifstream("hello.wav");
+    auto samples = std::vector<float>(stream.info().num_samples());
+    stream >> samples;
+    // use samples
+}
+```
+
+
+Currently the library consists of the following components:
+
+ - [audiostream](audiostream/README.md):  the main library for reading from / writing to audio streams.
+ - [pcm](pcm/README.md): a small library to convert [pcm](https://en.wikipedia.org/wiki/Pulse-code_modulation)
+   data from / to [arithmetic](http://en.cppreference.com/w/cpp/language/types) types.