The opus audio format handler.
[paraslash.git] / wma.h
diff --git a/wma.h b/wma.h
index 4b31342..f0ba7f6 100644 (file)
--- a/wma.h
+++ b/wma.h
@@ -1,3 +1,5 @@
+/** \file wma.h The asf_header structure and public wma function declarations. */
+
 /**
  * Information contained in an asf audio file header.
  *
@@ -6,21 +8,26 @@
 struct asf_header_info {
        /** The size of the audio file header. */
        int header_len;
+       /** Offset of the audio stream info header. */
        int audio_stream_info_start;
+       /** Number of channels. */
        uint8_t channels;
+       /** One of the 5 possible sample rates. */
        uint16_t sample_rate;
+       /** Size of one data block. */
        uint16_t block_align;
+       /** Bits per second. */
        uint32_t bit_rate;
+       /** Further decoding information (ignored). */
        uint32_t flags1;
+       /** Whether to use exp_vlc, bit reservoir, variable block len. */
        uint16_t flags2;
 };
 
 /* wma_common.c */
-int wma_log2(unsigned int v);
+__a_const int wma_log2(unsigned int v);
 const char *search_pattern(const char *pattern, int pattern_len,
                const char *buf, int buf_size);
-int read_asf_header(char *buf, int loaded, struct asf_header_info *ahi);
-#define M_PI           3.14159265358979323846  /* pi */
+int read_asf_header(const char *buf, int loaded, struct asf_header_info *ahi);
+
 #define WMA_FRAME_SKIP 31
-#define DECLARE_ALIGNED(n,t,v)      t v __attribute__ ((aligned (n)))
-#define DECLARE_ALIGNED_16(t, v) DECLARE_ALIGNED(16, t, v)