path: root/audio/out/ao_coreaudio_chmap.c

/*
 * This file is part of mpv.
 *
 * mpv is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * mpv 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 Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with mpv.  If not, see <http://www.gnu.org/licenses/>.
 */

#include <Availability.h>

#include "common/common.h"

#include "ao_coreaudio_utils.h"

#include "ao_coreaudio_chmap.h"
#include <CoreAudioTypes/CoreAudioTypes.h>

static const int speaker_map[][2] = {
    { kAudioChannelLabel_Left,                 MP_SPEAKER_ID_FL   },
    { kAudioChannelLabel_Right,                MP_SPEAKER_ID_FR   },
    { kAudioChannelLabel_Center,               MP_SPEAKER_ID_FC   },
    { kAudioChannelLabel_LFEScreen,            MP_SPEAKER_ID_LFE  },
    { kAudioChannelLabel_LeftSurround,         MP_SPEAKER_ID_BL   },
    { kAudioChannelLabel_RightSurround,        MP_SPEAKER_ID_BR   },
    { kAudioChannelLabel_LeftCenter,           MP_SPEAKER_ID_FLC  },
    { kAudioChannelLabel_RightCenter,          MP_SPEAKER_ID_FRC  },
    { kAudioChannelLabel_CenterSurround,       MP_SPEAKER_ID_BC   },
    { kAudioChannelLabel_LeftSurroundDirect,   MP_SPEAKER_ID_SL   },
    { kAudioChannelLabel_RightSurroundDirect,  MP_SPEAKER_ID_SR   },
    { kAudioChannelLabel_TopCenterSurround,    MP_SPEAKER_ID_TC   },
    { kAudioChannelLabel_VerticalHeightLeft,   MP_SPEAKER_ID_TFL  },
    { kAudioChannelLabel_VerticalHeightCenter, MP_SPEAKER_ID_TFC  },
    { kAudioChannelLabel_VerticalHeightRight,  MP_SPEAKER_ID_TFR  },
    { kAudioChannelLabel_TopBackLeft,          MP_SPEAKER_ID_TBL  },
    { kAudioChannelLabel_TopBackCenter,        MP_SPEAKER_ID_TBC  },
    { kAudioChannelLabel_TopBackRight,         MP_SPEAKER_ID_TBR  },

    // unofficial extensions
    { kAudioChannelLabel_RearSurroundLeft,     MP_SPEAKER_ID_SDL  },
    { kAudioChannelLabel_RearSurroundRight,    MP_SPEAKER_ID_SDR  },
    { kAudioChannelLabel_LeftWide,             MP_SPEAKER_ID_WL   },
    { kAudioChannelLabel_RightWide,            MP_SPEAKER_ID_WR   },
    { kAudioChannelLabel_LFE2,                 MP_SPEAKER_ID_LFE2 },
#if __MAC_OS_X_VERSION_MAX_ALLOWED >= 130000
    { kAudioChannelLabel_LeftTopSurround,      MP_SPEAKER_ID_TSL  },
    { kAudioChannelLabel_RightTopSurround,     MP_SPEAKER_ID_TSR  },
    { kAudioChannelLabel_CenterBottom,         MP_SPEAKER_ID_BFC  },
    { kAudioChannelLabel_LeftBottom,           MP_SPEAKER_ID_BFL  },
    { kAudioChannelLabel_RightBottom,          MP_SPEAKER_ID_BFR  },
#endif

    { kAudioChannelLabel_HeadphonesLeft,       MP_SPEAKER_ID_DL   },
    { kAudioChannelLabel_HeadphonesRight,      MP_SPEAKER_ID_DR   },

    { kAudioChannelLabel_Unknown,              MP_SPEAKER_ID_NA   },

    { 0,                                       -1                 },
};

static const AudioChannelLayoutTag std_layouts[] = {
    (100U<<16) | 1, // kAudioChannelLayoutTag_Mono
    (101U<<16) | 2, // kAudioChannelLayoutTag_Stereo
    (102U<<16) | 2, // kAudioChannelLayoutTag_StereoHeadphones
    (103U<<16) | 2, // kAudioChannelLayoutTag_MatrixStereo
    (104U<<16) | 2, // kAudioChannelLayoutTag_MidSide
    (105U<<16) | 2, // kAudioChannelLayoutTag_XY
    (106U<<16) | 2, // kAudioChannelLayoutTag_Binaural
    (107U<<16) | 4, // kAudioChannelLayoutTag_Ambisonic_B_Format
    (108U<<16) | 4, // kAudioChannelLayoutTag_Quadraphonic
    (109U<<16) | 5, // kAudioChannelLayoutTag_Pentagonal
    (110U<<16) | 6, // kAudioChannelLayoutTag_Hexagonal
    (111U<<16) | 8, // kAudioChannelLayoutTag_Octagonal
    (112U<<16) | 8, // kAudioChannelLayoutTag_Cube
    (113U<<16) | 3, // kAudioChannelLayoutTag_MPEG_3_0_A
    (114U<<16) | 3, // kAudioChannelLayoutTag_MPEG_3_0_B
    (115U<<16) | 4, // kAudioChannelLayoutTag_MPEG_4_0_A
    (116U<<16) | 4, // kAudioChannelLayoutTag_MPEG_4_0_B
    (117U<<16) | 5, // kAudioChannelLayoutTag_MPEG_5_0_A
    (118U<<16) | 5, // kAudioChannelLayoutTag_MPEG_5_0_B
    (119U<<16) | 5, // kAudioChannelLayoutTag_MPEG_5_0_C
    (120U<<16) | 5, // kAudioChannelLayoutTag_MPEG_5_0_D
    (121U<<16) | 6, // kAudioChannelLayoutTag_MPEG_5_1_A
    (122U<<16) | 6, // kAudioChannelLayoutTag_MPEG_5_1_B
    (123U<<16) | 6, // kAudioChannelLayoutTag_MPEG_5_1_C
    (124U<<16) | 6, // kAudioChannelLayoutTag_MPEG_5_1_D
    (125U<<16) | 7, // kAudioChannelLayoutTag_MPEG_6_1_A
    (126U<<16) | 8, // kAudioChannelLayoutTag_MPEG_7_1_A
    (127U<<16) | 8, // kAudioChannelLayoutTag_MPEG_7_1_B
    (128U<<16) | 8, // kAudioChannelLayoutTag_MPEG_7_1_C
    (129U<<16) | 8, // kAudioChannelLayoutTag_Emagic_Default_7_1
    (130U<<16) | 8, // kAudioChannelLayoutTag_SMPTE_DTV
    (131U<<16) | 3, // kAudioChannelLayoutTag_ITU_2_1
    (132U<<16) | 4, // kAudioChannelLayoutTag_ITU_2_2
    (133U<<16) | 3, // kAudioChannelLayoutTag_DVD_4
    (134U<<16) | 4, // kAudioChannelLayoutTag_DVD_5
    (135U<<16) | 5, // kAudioChannelLayoutTag_DVD_6
    (136U<<16) | 4, // kAudioChannelLayoutTag_DVD_10
    (137U<<16) | 5, // kAudioChannelLayoutTag_DVD_11
    (138U<<16) | 5, // kAudioChannelLayoutTag_DVD_18
    (139U<<16) | 6, // kAudioChannelLayoutTag_AudioUnit_6_0
    (140U<<16) | 7, // kAudioChannelLayoutTag_AudioUnit_7_0
    (148U<<16) | 7, // kAudioChannelLayoutTag_AudioUnit_7_0_Front
    (141U<<16) | 6, // kAudioChannelLayoutTag_AAC_6_0
    (142U<<16) | 7, // kAudioChannelLayoutTag_AAC_6_1
    (143U<<16) | 7, // kAudioChannelLayoutTag_AAC_7_0
    (183U<<16) | 8, // kAudioChannelLayoutTag_AAC_7_1_B
    (184U<<16) | 8, // kAudioChannelLayoutTag_AAC_7_1_C
    (144U<<16) | 8, // kAudioChannelLayoutTag_AAC_Octagonal
    (145U<<16) | 16, // kAudioChannelLayoutTag_TMH_10_2_std
    (146U<<16) | 21, // kAudioChannelLayoutTag_TMH_10_2_full
    (149U<<16) | 2, // kAudioChannelLayoutTag_AC3_1_0_1
    (150U<<16) | 3, // kAudioChannelLayoutTag_AC3_3_0
    (151U<<16) | 4, // kAudioChannelLayoutTag_AC3_3_1
    (152U<<16) | 4, // kAudioChannelLayoutTag_AC3_3_0_1
    (153U<<16) | 4, // kAudioChannelLayoutTag_AC3_2_1_1
    (154U<<16) | 5, // kAudioChannelLayoutTag_AC3_3_1_1
    (155U<<16) | 6, // kAudioChannelLayoutTag_EAC_6_0_A
    (156U<<16) | 7, // kAudioChannelLayoutTag_EAC_7_0_A
    (157U<<16) | 7, // kAudioChannelLayoutTag_EAC3_6_1_A
    (158U<<16) | 7, // kAudioChannelLayoutTag_EAC3_6_1_B
    (159U<<16) | 7, // kAudioChannelLayoutTag_EAC3_6_1_C
    (160U<<16) | 8, // kAudioChannelLayoutTag_EAC3_7_1_A
    (161U<<16) | 8, // kAudioChannelLayoutTag_EAC3_7_1_B
    (162U<<16) | 8, // kAudioChannelLayoutTag_EAC3_7_1_C
    (163U<<16) | 8, // kAudioChannelLayoutTag_EAC3_7_1_D
    (164U<<16) | 8, // kAudioChannelLayoutTag_EAC3_7_1_E
    (165U<<16) | 8, // kAudioChannelLayoutTag_EAC3_7_1_F
    (166U<<16) | 8, // kAudioChannelLayoutTag_EAC3_7_1_G
    (167U<<16) | 8, // kAudioChannelLayoutTag_EAC3_7_1_H
    (168U<<16) | 4, // kAudioChannelLayoutTag_DTS_3_1
    (169U<<16) | 5, // kAudioChannelLayoutTag_DTS_4_1
    (170U<<16) | 6, // kAudioChannelLayoutTag_DTS_6_0_A
    (171U<<16) | 6, // kAudioChannelLayoutTag_DTS_6_0_B
    (172U<<16) | 6, // kAudioChannelLayoutTag_DTS_6_0_C
    (173U<<16) | 7, // kAudioChannelLayoutTag_DTS_6_1_A
    (174U<<16) | 7, // kAudioChannelLayoutTag_DTS_6_1_B
    (175U<<16) | 7, // kAudioChannelLayoutTag_DTS_6_1_C
    (176U<<16) | 7, // kAudioChannelLayoutTag_DTS_7_0
    (177U<<16) | 8, // kAudioChannelLayoutTag_DTS_7_1
    (178U<<16) | 8, // kAudioChannelLayoutTag_DTS_8_0_A
    (179U<<16) | 8, // kAudioChannelLayoutTag_DTS_8_0_B
    (180U<<16) | 9, // kAudioChannelLayoutTag_DTS_8_1_A
    (181U<<16) | 9, // kAudioChannelLayoutTag_DTS_8_1_B
    (182U<<16) | 7, // kAudioChannelLayoutTag_DTS_6_1_D
    (185U<<16) | 4, // kAudioChannelLayoutTag_WAVE_4_0_B
    (186U<<16) | 5, // kAudioChannelLayoutTag_WAVE_5_0_B
    (187U<<16) | 6, // kAudioChannelLayoutTag_WAVE_5_1_B
    (188U<<16) | 7, // kAudioChannelLayoutTag_WAVE_6_1
    (189U<<16) | 8, // kAudioChannelLayoutTag_WAVE_7_1
    (194U<<16) | 8, // kAudioChannelLayoutTag_Atmos_5_1_2
    (195U<<16) | 10, // kAudioChannelLayoutTag_Atmos_5_1_4
    (196U<<16) | 10, // kAudioChannelLayoutTag_Atmos_7_1_2
    (192U<<16) | 12, // kAudioChannelLayoutTag_Atmos_7_1_4
    (193U<<16) | 16, // kAudioChannelLayoutTag_Atmos_9_1_6
    (197U<<16) | 4, // kAudioChannelLayoutTag_Logic_4_0_C
    (198U<<16) | 6, // kAudioChannelLayoutTag_Logic_6_0_B
    (199U<<16) | 7, // kAudioChannelLayoutTag_Logic_6_1_B
    (200U<<16) | 7, // kAudioChannelLayoutTag_Logic_6_1_D
    (201U<<16) | 8, // kAudioChannelLayoutTag_Logic_7_1_B
    (202U<<16) | 12, // kAudioChannelLayoutTag_Logic_Atmos_7_1_4_B
    (203U<<16) | 14, // kAudioChannelLayoutTag_Logic_Atmos_7_1_6
    (204U<<16) | 24, // kAudioChannelLayoutTag_CICP_13
    (205U<<16) | 8, // kAudioChannelLayoutTag_CICP_14
    (206U<<16) | 12, // kAudioChannelLayoutTag_CICP_15
    (207U<<16) | 10, // kAudioChannelLayoutTag_CICP_16
    (208U<<16) | 12, // kAudioChannelLayoutTag_CICP_17
    (209U<<16) | 14, // kAudioChannelLayoutTag_CICP_18
    (210U<<16) | 12, // kAudioChannelLayoutTag_CICP_19
    (211U<<16) | 14, // kAudioChannelLayoutTag_CICP_20
    kAudioChannelLayoutTag_Unknown
};

int ca_label_to_mp_speaker_id(AudioChannelLabel label)
{
    for (int i = 0; speaker_map[i][1] >= 0; i++)
        if (speaker_map[i][0] == label)
            return speaker_map[i][1];
    return -1;
}

AudioChannelLabel mp_speaker_id_to_ca_label(int speaker_id)
{
    for (int i = 0; speaker_map[i][1] >= 0; i++)
        if (speaker_map[i][1] == speaker_id)
            return speaker_map[i][0];
    return -1; // kAudioChannelLabel_Unknown
}

#if HAVE_COREAUDIO
void ca_log_layout(struct ao *ao, int l, AudioChannelLayout *layout)
{
    if (!mp_msg_test(ao->log, l))
        return;

    AudioChannelLayoutTag tag = layout->mChannelLayoutTag;
    mp_msg(ao->log, l, "audio channel layout: tag: <%u>", tag);

    if (tag == kAudioChannelLayoutTag_UseChannelDescriptions) {
        AudioChannelDescription *descs = layout->mChannelDescriptions;
        mp_msg(ao->log, l, ", descriptions <%u>\n",
                           (unsigned) layout->mNumberChannelDescriptions);

        for (int i = 0; i < layout->mNumberChannelDescriptions; i++) {
            AudioChannelDescription d = descs[i];
            mp_msg(ao->log, l, " - description %d: label <%u, %u>,  flags: <%u>",
                i,
                (unsigned) d.mChannelLabel,
                (unsigned) ca_label_to_mp_speaker_id(d.mChannelLabel),
                (unsigned) d.mChannelFlags);
            if (d.mChannelFlags != kAudioChannelFlags_AllOff) {
                mp_msg(ao->log, l, ", coords: <%f, %f, %f>\n",
                    d.mCoordinates[0],
                    d.mCoordinates[1],
                    d.mCoordinates[2]);
            } else {
                mp_msg(ao->log, l, "\n");
            }
        }
    } else if (tag == kAudioChannelLayoutTag_UseChannelBitmap) {
        mp_msg(ao->log, l, ", bitmap <%u>\n", layout->mChannelBitmap);
    } else {
        mp_msg(ao->log, l, "\n");
    }
}

static AudioChannelLayout *ca_layout_to_custom_layout(struct ao *ao,
                                                      void *talloc_ctx,
                                                      AudioChannelLayout *l)
{
    AudioChannelLayoutTag tag = l->mChannelLayoutTag;
    AudioChannelLayout *r;
    OSStatus err;

    if (tag == kAudioChannelLayoutTag_UseChannelDescriptions)
        return l;

    if (tag == kAudioChannelLayoutTag_UseChannelBitmap) {
        uint32_t psize;
        err = AudioFormatGetPropertyInfo(
            kAudioFormatProperty_ChannelLayoutForBitmap,
            sizeof(uint32_t), &l->mChannelBitmap, &psize);
        CHECK_CA_ERROR("failed to convert channel bitmap to descriptions (info)");
        r = talloc_size(talloc_ctx, psize);
        err = AudioFormatGetProperty(
            kAudioFormatProperty_ChannelLayoutForBitmap,
            sizeof(uint32_t), &l->mChannelBitmap, &psize, r);
        CHECK_CA_ERROR("failed to convert channel bitmap to descriptions (get)");
    } else {
        uint32_t psize;
        err = AudioFormatGetPropertyInfo(
            kAudioFormatProperty_ChannelLayoutForTag,
            sizeof(AudioChannelLayoutTag), &l->mChannelLayoutTag, &psize);
        r = talloc_size(talloc_ctx, psize);
        CHECK_CA_ERROR("failed to convert channel tag to descriptions (info)");
        err = AudioFormatGetProperty(
            kAudioFormatProperty_ChannelLayoutForTag,
            sizeof(AudioChannelLayoutTag), &l->mChannelLayoutTag, &psize, r);
        CHECK_CA_ERROR("failed to convert channel tag to descriptions (get)");
    }

    if (ao) {
        MP_VERBOSE(ao, "converted input channel layout:\n");
        ca_log_layout(ao, MSGL_V, l);
    }

    return r;
coreaudio_error:
    return NULL;
}

AudioChannelLayout *ca_find_standard_layout(void *talloc_ctx, AudioChannelLayout *l)
{
    if (l->mChannelLayoutTag != kAudioChannelLayoutTag_UseChannelDescriptions)
        return l;

    AudioChannelLayout *s = talloc_size(talloc_ctx, sizeof(AudioChannelLayout));

    for (int i = 0; ; ++i) {
        if ((s->mChannelLayoutTag = std_layouts[i]) == kAudioChannelLayoutTag_Unknown) {
            s = NULL;
            break;
        }

        AudioChannelLayout *r = ca_layout_to_custom_layout(NULL, talloc_ctx, s);

        if (!r)
            goto mismatch;
        if (l->mNumberChannelDescriptions != r->mNumberChannelDescriptions)
            goto mismatch;

        for (int i = 0; i < l->mNumberChannelDescriptions; ++i) {
            AudioChannelDescription *ld = l->mChannelDescriptions + i;
            AudioChannelDescription *rd = r->mChannelDescriptions + i;
            if (ld->mChannelLabel == rd->mChannelLabel)
                continue;
            // XXX: we cannot handle channels with coordinates
            goto mismatch;
        }

        break;

mismatch:;
    }

    return s ? s : l;
}


#define CHMAP(n, ...) &(struct mp_chmap) MP_CONCAT(MP_CHMAP, n) (__VA_ARGS__)

// Replace each channel in a with b (a->num == b->num)
static void replace_submap(struct mp_chmap *dst, struct mp_chmap *a,
                           struct mp_chmap *b)
{
    struct mp_chmap t = *dst;
    if (!mp_chmap_is_valid(&t) || mp_chmap_diffn(a, &t) != 0)
        return;
    assert(a->num == b->num);
    for (int n = 0; n < t.num; n++) {
        for (int i = 0; i < a->num; i++) {
            if (t.speaker[n] == a->speaker[i]) {
                t.speaker[n] = b->speaker[i];
                break;
            }
        }
    }
    if (mp_chmap_is_valid(&t))
        *dst = t;
}

static bool ca_layout_to_mp_chmap(struct ao *ao, AudioChannelLayout *layout,
                                  struct mp_chmap *chmap)
{
    void *talloc_ctx = talloc_new(NULL);

    MP_VERBOSE(ao, "input channel layout:\n");
    ca_log_layout(ao, MSGL_V, layout);

    AudioChannelLayout *l = ca_layout_to_custom_layout(ao, talloc_ctx, layout);
    if (!l)
        goto coreaudio_error;

    if (l->mNumberChannelDescriptions > MP_NUM_CHANNELS) {
        MP_VERBOSE(ao, "layout has too many descriptions (%u, max: %d)\n",
                   (unsigned) l->mNumberChannelDescriptions, MP_NUM_CHANNELS);
        return false;
    }

    chmap->num = l->mNumberChannelDescriptions;
    for (int n = 0; n < l->mNumberChannelDescriptions; n++) {
        AudioChannelLabel label = l->mChannelDescriptions[n].mChannelLabel;
        int speaker = ca_label_to_mp_speaker_id(label);
        if (speaker < 0) {
            MP_VERBOSE(ao, "channel label=%u unusable to build channel "
                           "bitmap, skipping layout\n", (unsigned) label);
            goto coreaudio_error;
        }
        chmap->speaker[n] = speaker;
    }

    // Remap weird 7.1(rear) layouts correctly.
    replace_submap(chmap, CHMAP(6, FL, FR, BL, BR, SDL, SDR),
                          CHMAP(6, FL, FR, SL, SR, BL,  BR));

    talloc_free(talloc_ctx);
    MP_VERBOSE(ao, "mp chmap: %s\n", mp_chmap_to_str(chmap));
    return mp_chmap_is_valid(chmap) && !mp_chmap_is_unknown(chmap);
coreaudio_error:
    MP_VERBOSE(ao, "converted input channel layout (failed):\n");
    ca_log_layout(ao, MSGL_V, layout);
    talloc_free(talloc_ctx);
    return false;
}

static AudioChannelLayout* ca_query_layout(struct ao *ao,
                                           AudioDeviceID device,
                                           void *talloc_ctx)
{
    OSStatus err;
    uint32_t psize;
    AudioChannelLayout *r = NULL;

    AudioObjectPropertyAddress p_addr = (AudioObjectPropertyAddress) {
        .mSelector = kAudioDevicePropertyPreferredChannelLayout,
        .mScope    = kAudioDevicePropertyScopeOutput,
        .mElement  = kAudioObjectPropertyElementWildcard,
    };

    err = AudioObjectGetPropertyDataSize(device, &p_addr, 0, NULL, &psize);
    CHECK_CA_ERROR("could not get device preferred layout (size)");

    r = talloc_size(talloc_ctx, psize);

    err = AudioObjectGetPropertyData(device, &p_addr, 0, NULL, &psize, r);
    CHECK_CA_ERROR("could not get device preferred layout (get)");

coreaudio_error:
    return r;
}

static AudioChannelLayout* ca_query_stereo_layout(struct ao *ao,
                                                  AudioDeviceID device,
                                                  void *talloc_ctx)
{
    OSStatus err;
    uint32_t channels[2];
    const int nch = MP_ARRAY_SIZE(channels);
    AudioChannelLayout *r = NULL;

    AudioObjectPropertyAddress p_addr = (AudioObjectPropertyAddress) {
        .mSelector = kAudioDevicePropertyPreferredChannelsForStereo,
        .mScope    = kAudioDevicePropertyScopeOutput,
        .mElement  = kAudioObjectPropertyElementWildcard,
    };

    uint32_t psize = sizeof(channels);
    err = AudioObjectGetPropertyData(device, &p_addr, 0, NULL, &psize, channels);
    CHECK_CA_ERROR("could not get device preferred stereo layout");

    psize = sizeof(AudioChannelLayout) + nch * sizeof(AudioChannelDescription);
    r = talloc_zero_size(talloc_ctx, psize);
    r->mChannelLayoutTag = kAudioChannelLayoutTag_UseChannelDescriptions;
    r->mNumberChannelDescriptions = nch;

    AudioChannelDescription desc = {0};
    desc.mChannelFlags = kAudioChannelFlags_AllOff;

    for(int i = 0; i < nch; i++) {
        desc.mChannelLabel = channels[i];
        r->mChannelDescriptions[i] = desc;
    }

coreaudio_error:
    return r;
}

static void ca_retrieve_layouts(struct ao *ao, struct mp_chmap_sel *s,
                                AudioDeviceID device)
{
    void *ta_ctx = talloc_new(NULL);
    struct mp_chmap chmap;

    AudioChannelLayout *ml = ca_query_layout(ao, device, ta_ctx);
    if (ml && ca_layout_to_mp_chmap(ao, ml, &chmap))
        mp_chmap_sel_add_map(s, &chmap);

    AudioChannelLayout *sl = ca_query_stereo_layout(ao, device, ta_ctx);
    if (sl && ca_layout_to_mp_chmap(ao, sl, &chmap))
        mp_chmap_sel_add_map(s, &chmap);

    talloc_free(ta_ctx);
}

bool ca_init_chmap(struct ao *ao, AudioDeviceID device)
{
    struct mp_chmap_sel chmap_sel = {0};
    ca_retrieve_layouts(ao, &chmap_sel, device);

    if (!chmap_sel.num_chmaps)
        mp_chmap_sel_add_map(&chmap_sel, &(struct mp_chmap)MP_CHMAP_INIT_STEREO);

    mp_chmap_sel_add_map(&chmap_sel, &(struct mp_chmap)MP_CHMAP_INIT_MONO);

    if (!ao_chmap_sel_adjust(ao, &chmap_sel, &ao->channels)) {
        MP_ERR(ao, "could not select a suitable channel map among the "
                   "hardware supported ones. Make sure to configure your "
                   "output device correctly in 'Audio MIDI Setup.app'\n");
        return false;
    }
    return true;
}

void ca_get_active_chmap(struct ao *ao, AudioDeviceID device, int channel_count,
                         struct mp_chmap *out_map)
{
    // Apparently, we have to guess by looking back at the supported layouts,
    // and I haven't found a property that retrieves the actual currently
    // active channel layout.

    struct mp_chmap_sel chmap_sel = {0};
    ca_retrieve_layouts(ao, &chmap_sel, device);

    // Use any exact match.
    for (int n = 0; n < chmap_sel.num_chmaps; n++) {
        if (chmap_sel.chmaps[n].num == channel_count) {
            MP_VERBOSE(ao, "mismatching channels - fallback #%d\n", n);
            *out_map = chmap_sel.chmaps[n];
            return;
        }
    }

    // Fall back to stereo or mono, and fill the rest with silence. (We don't
    // know what the device expects. We could use a larger default layout here,
    // but let's not.)
    mp_chmap_from_channels(out_map, MPMIN(2, channel_count));
    out_map->num = channel_count;
    for (int n = 2; n < out_map->num; n++)
        out_map->speaker[n] = MP_SPEAKER_ID_NA;
    MP_WARN(ao, "mismatching channels - falling back to %s\n",
            mp_chmap_to_str(out_map));
}
#endif