libsidplayfp-dev 1.8.7-1 / usr / include / sidplayfp / SidTuneInfo.h

/*
 * This file is part of libsidplayfp, a SID player engine.
 *
 *  Copyright 2011-2015 Leandro Nini
 *  Copyright 2007-2010 Antti Lankila
 *  Copyright 2000 Simon White
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program 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 General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 */

#ifndef SIDTUNEINFO_H
#define SIDTUNEINFO_H

#include <stdint.h>

#include "sidplayfp/siddefs.h"

/**
 * This interface is used to get values from SidTune objects.
 *
 * You must read (i.e. activate) sub-song specific information
 * via:
 *        const SidTuneInfo* tuneInfo = SidTune.getInfo();
 *        const SidTuneInfo* tuneInfo = SidTune.getInfo(songNumber);
 */
class SidTuneInfo
{
public:
    typedef enum {
        CLOCK_UNKNOWN,
        CLOCK_PAL,
        CLOCK_NTSC,
        CLOCK_ANY
    } clock_t;

    typedef enum {
        SIDMODEL_UNKNOWN,
        SIDMODEL_6581,
        SIDMODEL_8580,
        SIDMODEL_ANY
    } model_t;

    typedef enum {
        COMPATIBILITY_C64,   ///< File is C64 compatible
        COMPATIBILITY_PSID,  ///< File is PSID specific
        COMPATIBILITY_R64,   ///< File is Real C64 only
        COMPATIBILITY_BASIC  ///< File requires C64 Basic
    } compatibility_t;

public:
    /// Vertical-Blanking-Interrupt
    static const int SPEED_VBI = 0;

    /// CIA 1 Timer A
    static const int SPEED_CIA_1A = 60;

public:
    /**
     * Load Address.
     */
    virtual uint_least16_t loadAddr() const =0;

    /**
     * Init Address.
     */
    virtual uint_least16_t initAddr() const =0;

    /**
     * Play Address.
     */
    virtual uint_least16_t playAddr() const =0;

    /**
     * The number of songs.
     */
    virtual unsigned int songs() const =0;

    /**
     * The default starting song.
     */
    virtual unsigned int startSong() const =0;

    /**
     * The tune that has been initialized.
     */
    virtual unsigned int currentSong() const =0;

    /**
     * @name Base addresses
     * The SID chip base address(es) used by the sidtune.
     */
    //@{
    virtual SID_DEPRECATED uint_least16_t sidChipBase1() const =0;    ///< 0xD400 (normal, 1st SID) \deprecated use #sidChipBase() with i=0
    virtual SID_DEPRECATED uint_least16_t sidChipBase2() const =0;    ///< 0xD??0 (2nd SID) or 0 (no 2nd SID) \deprecated use #sidChipBase() with i=1
    virtual uint_least16_t sidChipBase(unsigned int i) const =0;   ///< \since 1.8
    //@}

    /**
     * Whether sidtune uses two SID chips.
     * \deprecated use #sidChips()
     */
    virtual SID_DEPRECATED bool isStereo() const=0;

    /**
     * Get the number of SID chips required by the tune.
     */
    virtual int sidChips() const =0;

    /**
     * Intended speed.
     */
    virtual int songSpeed() const =0;

    /**
     * First available page for relocation.
     */
    virtual uint_least8_t relocStartPage() const =0;

    /**
     * Number of pages available for relocation.
     */
    virtual uint_least8_t relocPages() const =0;

    /**
     * @name SID model
     * The SID chip model(s) requested by the sidtune.
     */
    //@{
    virtual SID_DEPRECATED model_t sidModel1() const =0;    ///< first SID \deprecated use #sidModel() with i=0
    virtual SID_DEPRECATED model_t sidModel2() const =0;    ///< second SID \deprecated use #sidModel() with i=1
    virtual model_t sidModel(unsigned int i) const =0;   ///< \since 1.8
    //@}

    /**
     * Compatibility requirements.
     */
    virtual compatibility_t compatibility() const =0;

    /**
     * @name Tune infos
     * Song title, credits, ...
     * - 0 = Title
     * - 1 = Author
     * - 2 = Released
     */
    //@{
    virtual unsigned int numberOfInfoStrings() const =0;     ///< the number of available text info lines
    virtual const char* infoString(unsigned int i) const =0; ///< text info from the format headers etc.
    //@}

    /**
     * @name Tune comments
     * MUS comments.
     */
    //@{
    virtual unsigned int numberOfCommentStrings() const =0;     ///< Number of comments
    virtual const char* commentString(unsigned int i) const =0; ///<  Used to stash the MUS comment somewhere.
    //@}

    /**
     * Length of single-file sidtune file.
     */
    virtual uint_least32_t dataFileLen() const =0;

    /**
     * Length of raw C64 data without load address.
     */
    virtual uint_least32_t c64dataLen() const =0;

    /**
     * The tune clock speed.
     */
    virtual clock_t clockSpeed() const =0;

    /**
     * The name of the identified file format.
     */
    virtual const char* formatString() const =0;

    /**
     * Whether load address might be duplicate.
     */
    virtual bool fixLoad() const =0;

    /**
     * Path to sidtune files.
     */
    virtual const char* path() const =0;

    /**
     * A first file: e.g. "foo.sid" or "foo.mus".
     */
    virtual const char* dataFileName() const =0;

    /**
     * A second file: e.g. "foo.str".
     * Returns 0 if none.
     */
    virtual const char* infoFileName() const =0;

protected:
    ~SidTuneInfo() {}
};

#endif  /* SIDTUNEINFO_H */