source: mainline/uspace/lib/trackmod/types/trackmod.h@ 7e69e0e

/*
 * Copyright (c) 2014 Jiri Svoboda
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * - Redistributions of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in the
 *   documentation and/or other materials provided with the distribution.
 * - The name of the author may not be used to endorse or promote products
 *   derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

/** @addtogroup trackmod
 * @{
 */
/**
 * @file Tracker module handling library types.
 */

#ifndef TYPES_TRACKMOD_H
#define TYPES_TRACKMOD_H

#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>

/** Sample */
typedef struct {
        /** Length in frames */
        size_t length;
        /** Sample data */
        int8_t *data;
        /** Loop start position in frames */
        size_t loop_start;
        /** Loop length in frames or 0 - no looping */
        size_t loop_len;
        /** Default volume (0..63) */
        uint8_t def_vol;
} trackmod_sample_t;

/** Pattern */
typedef struct {
        /** Number of rows */
        size_t rows;
        /** Number of channels */
        size_t channels;
        /** Pattern data */
        uint32_t *data;
} trackmod_pattern_t;

/** Module. */
typedef struct {
        /** Number of channels */
        size_t channels;
        /** Number of samples */
        size_t samples;
        /** Samples */
        trackmod_sample_t *sample;
        /** Number of patterns */
        size_t patterns;
        /** Patterns */
        trackmod_pattern_t *pattern;
        /** Order list length */
        size_t ord_list_len;
        /** Order list */
        size_t *ord_list;
} trackmod_module_t;

/** Channel playback */
typedef struct {
        trackmod_sample_t *sample;
        /** Value of sample before current position */
        int8_t lsmp;
        /** Sample position (in frames) */
        size_t smp_pos;
        /** Sample position (clock ticks within frame) */
        size_t smp_clk;
        /** Period */
        unsigned period;
        /** Volume */
        uint8_t volume;
} trackmod_chan_t;

/** Module playback. */
typedef struct {
        /** Module */
        trackmod_module_t *module;
        /** Sampling frequency */
        unsigned smp_freq;
        /** Frame size (bytes per sample * channels) */
        size_t frame_size;

        /** Current position, order list index */
        size_t ord_idx;
        /** Current position, row within pattern */
        size_t row;
        /** Current position, tick within row */
        unsigned tick;
        /** Current position, sample within tick */
        unsigned smp;

        /** Channel playback state */
        trackmod_chan_t *chan;

        /** BPM (beats per minute) */
        unsigned bpm;
        /** TPR (ticks per row) */
        unsigned tpr;

        /** If true, break from pattern at end of current row */
        bool pat_break;
        /** If @c pat_break is true, row number where to jump in next pattern */
        size_t pat_break_row;
        /** Debug mode, print messages to stdout. */
        bool debug;
} trackmod_modplay_t;

/** Pattern cell (decoded) */
typedef struct {
        /** Sample period */
        unsigned period;
        /** Sample number */
        unsigned sample;
        /** Effect */
        unsigned effect;
} trackmod_cell_t;

#endif

/** @}
 */