Merge pull request #83 from mitchmindtree/master

Improved debug formatting for flags, added stream format support check to examples.

Author: mitchmindtree

Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 
 name = "portaudio"
-version = "0.4.7"
+version = "0.4.8"
 authors = ["Jeremy Letang <[email protected]>",
            "Mitchell Nordine <[email protected]>"]
 description = "PortAudio bindings for Rust."

examples/blocking.rs

@@ -71,6 +71,11 @@ fn main() {
         suggested_latency : output_info.default_low_output_latency
     };
 
+    // Check that the stream format is supported.
+    if let Err(err) = pa::is_format_supported(&input_stream_params, &output_stream_params, SAMPLE_RATE) {
+        panic!("The given stream format is unsupported: {:?}", err.description());
+    }
+
     let mut stream : pa::Stream<f32, f32> = pa::Stream::new();
 
     match stream.open(Some(&input_stream_params),

examples/non_blocking.rs

@@ -69,6 +69,11 @@ fn main() {
         suggested_latency : output_info.default_low_output_latency
     };
 
+    // Check that the stream format is supported.
+    if let Err(err) = pa::is_format_supported(&input_stream_params, &output_stream_params, SAMPLE_RATE) {
+        panic!("The given stream format is unsupported: {:?}", err.description());
+    }
+
     // Construct a stream with input and output sample types of f32.
     let mut stream : pa::Stream<f32, f32> = pa::Stream::new();
 

src/pa/types.rs

@@ -106,6 +106,20 @@ pub mod stream_flags {
             const PA_PLATFORM_SPECIFIC_FLAGS =                    ffi::PA_PLATFORM_SPECIFIC_FLAGS,
         }
     }
+
+    impl ::std::fmt::Debug for StreamFlags {
+        fn fmt(&self, f: &mut ::std::fmt::Formatter) -> ::std::fmt::Result {
+            write!(f, "{:?}", match self.bits() {
+                ffi::PA_NO_FLAG                                    => "NO_FLAG",
+                ffi::PA_CLIP_OFF                                   => "CLIP_OFF",
+                ffi::PA_DITHER_OFF                                 => "DITHER_OFF",
+                ffi::PA_NEVER_DROP_INPUT                           => "NEVER_DROP_INPUT",
+                ffi::PA_PRIME_OUTPUT_BUFFERS_USING_STREAM_CALLBACK => "PRIME_OUTPUT_BUFFERS_USING_STREAM_CALLBACK",
+                ffi::PA_PLATFORM_SPECIFIC_FLAGS                    => "PLATFORM_SPECIFIC_FLAGS",
+                _                                                  => "<Unknown StreamFlags>",
+            })
+        }
+    }
 }
 
 /// Describes stream availability and the number for frames available for reading/writing if there
@@ -156,6 +170,19 @@ pub mod stream_callback_flags {
             const PRIMING_OUTPUT   = ffi::PRIMING_OUTPUT,
         }
     }
+
+    impl ::std::fmt::Debug for StreamCallbackFlags {
+        fn fmt(&self, f: &mut ::std::fmt::Formatter) -> ::std::fmt::Result {
+            write!(f, "{:?}", match self.bits() {
+                ffi::INPUT_UNDERFLOW  => "INPUT_UNDERFLOW",
+                ffi::INPUT_OVERFLOW   => "INPUT_OVERFLOW",
+                ffi::OUTPUT_UNDERFLOW => "OUTPUT_UNDERFLOW",
+                ffi::OUTPUT_OVERFLOW  => "OUTPUT_OVERFLOW",
+                ffi::PRIMING_OUTPUT   => "PRIMING_INPUT",
+                _                     => "<Unknown StreamCallbackFlags>",
+            })
+        }
+    }
 }
 
 /// User defined callback function.