<html>
    <head>
      <base href="https://bugs.freedesktop.org/" />
    </head>
    <body><table border="1" cellspacing="0" cellpadding="8">
        <tr>
          <th>Priority</th>
          <td>medium
          </td>
        </tr>

        <tr>
          <th>Bug ID</th>
          <td><a class="bz_bug_link 
          bz_status_NEW "
   title="NEW --- - PA_CHANNEL_MAP_DEFAULT is nearly useless"
   href="https://bugs.freedesktop.org/show_bug.cgi?id=56084">56084</a>
          </td>
        </tr>

        <tr>
          <th>CC</th>
          <td>lennart@poettering.net
          </td>
        </tr>

        <tr>
          <th>Assignee</th>
          <td>pulseaudio-bugs@lists.freedesktop.org
          </td>
        </tr>

        <tr>
          <th>Summary</th>
          <td>PA_CHANNEL_MAP_DEFAULT is nearly useless
          </td>
        </tr>

        <tr>
          <th>QA Contact</th>
          <td>pulseaudio-bugs@lists.freedesktop.org
          </td>
        </tr>

        <tr>
          <th>Severity</th>
          <td>normal
          </td>
        </tr>

        <tr>
          <th>Classification</th>
          <td>Unclassified
          </td>
        </tr>

        <tr>
          <th>OS</th>
          <td>All
          </td>
        </tr>

        <tr>
          <th>Reporter</th>
          <td>tanuk@iki.fi
          </td>
        </tr>

        <tr>
          <th>Hardware</th>
          <td>Other
          </td>
        </tr>

        <tr>
          <th>Status</th>
          <td>NEW
          </td>
        </tr>

        <tr>
          <th>Version</th>
          <td>unspecified
          </td>
        </tr>

        <tr>
          <th>Component</th>
          <td>clients
          </td>
        </tr>

        <tr>
          <th>Product</th>
          <td>PulseAudio
          </td>
        </tr></table>
      <p>
        <div>
        <pre>The usefulness of the whole pa_channel_map_def enum is questionable. It's only
used with pa_channel_map_init_auto(), and that function is prone to cause bugs,
because client programmers like to use it instead of initializing the channel
map properly. pa_channel_map_init_auto() is very rarely the right choice. But
this bug is not about that. This bug is about the PA_CHANNEL_MAP_DEFAULT
definition. The only use that I can think for that definition is when only the
number of channels is known, and pulseaudio should guess what the channel map
is. Currently it's defined as PA_CHANNEL_MAP_AIFF, which is not very suitable
for being the default: it only contains definitions for up to 6 channels, and
even the 6-channel definition is not a 5.1 mapping (no lfe channel). The
default mapping should be our best guess for what is the most common channel
map for a given number of channels.

Also, pa_channel_map_def (or pa_channel_map_init_auto()) should be documented
better. The documentation should clearly say when it's appropriate to auto-init
the channel map and when it should be initialized manually.</pre>
        </div>
      </p>
      <hr>
      <span>You are receiving this mail because:</span>
      
      <ul>
          <li>You are the QA Contact for the bug.</li>
          <li>You are the assignee for the bug.</li>
      </ul>
    </body>
</html>