/*
 * Copyright (C) 2011 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

namespace android {

/**************************************************************************
 * Important note: the functions below are helper functions for the
 *   implementation of the XAVideoDecoderCapabilitiesItf interface on
 *   Android. They are ONLY exposing the "hardware" video decoders
 *   as dynamically discovered on the platform. A hardware video decoder
 *   is defined as one where video decoding takes advantage of a hardware-
 *   specific feature of the platform, such as DSP or particular GPU.
 *   "Software" decoders, such as the ones available as default implementations
 *   in the Android tree, as not exposed here, but are rather listed in
 *   the CDD.
 */

/*
 * Initializes the list of supported video codecs, with their associated profiles and levels
 * Return
 *     false if it failed to list the available codecs, true otherwise
 */
extern bool android_videoCodec_expose();

/*
 * Frees all resources associated with the listing and query of the available video codecs
 */
extern void android_videoCodec_deinit();

/*
 * Returns the number of video codecs supported on the platform.
 * Returns 0 if android_videoCodec_expose() hasn't been called before (and returned true)
 */
extern XAuint32 android_videoCodec_getNbDecoders();

/*
 * Retrieve the supported decoder IDs
 * Pre-condition
 *    nbDecoders <= number of decoders
 *    pDecoderIds != NULL
 *    android_videoCodec_expose() has been called before (and returned true)
 */
extern void android_videoCodec_getDecoderIds(XAuint32 nbDecoders, XAuint32 *pDecoderIds);

/*
 * Retrieves the number of profile / level combinations for a given codec
 * Pre-condition
 *    pNb != NULL
 *    android_videoCodec_expose() has been called before (and returned true)
 * Return
 *    SL_RESULT_SUCCESS if the number of combinations was successfully retrieved and at least
 *                         one profile/level is supported (*pNb > 0)
 *    SL_RESULT_PARAMETER_INVALID otherwise
 */
extern SLresult android_videoCodec_getProfileLevelCombinationNb(XAuint32 decoderId, XAuint32 *pNb);

/*
 * Retrieves the profile / level at index plIndex in the list of profile / level combinations
 *    supported by the given codec
 * Pre-condition
 *    pDescr != NULL
 *    android_videoCodec_expose() has been called before (and returned true)
 * Post-condition
 *    pDescr->codecId == decoderId
 * Return
 *    SL_RESULT_SUCCESS if the profile/level was successfully retrieved
 *    SL_RESULT_PARAMETER_INVALID otherwise: invalid codec or invalid profile/level index
 */
extern SLresult android_videoCodec_getProfileLevelCombination(XAuint32 decoderId,
        XAuint32 plIndex, XAVideoCodecDescriptor *pDescr);

}; // namespace android