/*
 * This file is part of Nokia HEIF library
 *
 * Copyright (c) 2015-2025 Nokia Corporation and/or its subsidiary(-ies). All rights reserved.
 *
 * Contact: heif@nokia.com
 *
 * This software, including documentation, is protected by copyright controlled by Nokia Corporation and/ or its subsidiaries. All rights are reserved.
 * Copying, including reproducing, storing, adapting or translating, any or all of this material requires the prior written consent of Nokia.
 *
 *
 */

package com.nokia.heif;

/**
 * A sample which contains AAC encoded data
 */
public final class AACSample extends AudioSample
{
    /**
     * Creates a new AACSample to the given HEIF instance
     * Also creates a corresponding AACDecoderConfig object with the given decoder config
     *
     * @param heif The parent HEIF instance for the new object
     * @param decoderConfig Byte array containing the decoder config
     * @param data Byte array containing the sample data as an encoded AAC frame
     * @param duration The duration of the sample in timescale units
     * @throws Exception
     */
    public AACSample(HEIF heif, byte[] decoderConfig, byte[] data, long duration)
            throws Exception
    {
        this(heif);
        try
        {
            DecoderConfig decConfig = new AACDecoderConfig(heif, decoderConfig);

            setDecoderConfig(decConfig);
            setSampleData(data);
            setDuration(duration);
        }
        catch (Exception ex)
        {
            destroy();
            throw ex;
        }
    }

    /**
     * Creates a new AACSample to the given HEIF instance
     *
     * @param heif The parent HEIF instance for the new object
     * @param config Decoder config for the sample
     * @param data Byte array containing the sample data as an encoded AAC frame
     * @param duration The duration of the sample in timescale units
     * @throws Exception
     */
    public AACSample(HEIF heif, AACDecoderConfig config, byte[] data, long duration)
            throws Exception
    {
        this(heif);
        try
        {
            setDecoderConfig(config);
            setSampleData(data);
            setDuration(duration);
        }
        catch (Exception ex)
        {
            destroy();
            throw ex;
        }
    }

    /**
     * Private constructor
     *
     * @param heif The parent HEIF instance for the new object
     * @throws Exception
     */
    private AACSample(HEIF heif)
            throws Exception
    {
        super(heif);
        mNativeHandle = createContextNative(heif);
    }

    /**
     * Protected constructor, used to create an object from the native side
     * @param heif         The parent HEIF instance for the new object
     * @param nativeHandle A handle to the corresponding C++ object
     */
    protected AACSample(HEIF heif, long nativeHandle)
    {
        super(heif, nativeHandle);
    }

    /**
     * Returns the decoder config of the sample
     * @return AACDecoderConfig
     * @throws Exception
     */
    public AACDecoderConfig getDecoderConfig()
            throws Exception
    {
        return (AACDecoderConfig) super.getDecoderConfig();
    }

    @Override
    protected boolean checkDecoderConfigType(DecoderConfig config)
    {
        return config instanceof AACDecoderConfig;
    }

    private native long createContextNative(HEIF heif);
}