libopenmpt  0.2.5602
cross-platform C++ and C library to decode tracked music files
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
libopenmpt.h File Reference
#include "libopenmpt_config.h"
#include <stddef.h>
#include <stdint.h>

Go to the source code of this file.

Classes

struct  openmpt_stream_callbacks
 Stream callbacks. More...
struct  openmpt_module_initial_ctl

Macros

#define OPENMPT_STRING_LIBRARY_VERSION   "library_version"
#define OPENMPT_STRING_LIBRARY_FEATURES   "library_features"
#define OPENMPT_STRING_CORE_VERSION   "core_version"
#define OPENMPT_STRING_BUILD   "build"
#define OPENMPT_STRING_CREDITS   "credits"
#define OPENMPT_STRING_CONTACT   "contact"
#define OPENMPT_STRING_LICENSE   "license"
#define OPENMPT_STREAM_SEEK_SET   0
#define OPENMPT_STREAM_SEEK_CUR   1
#define OPENMPT_STREAM_SEEK_END   2
#define OPENMPT_MODULE_RENDER_MASTERGAIN_MILLIBEL   1
 Master Gain.
#define OPENMPT_MODULE_RENDER_STEREOSEPARATION_PERCENT   2
 Stereo Separation.
#define OPENMPT_MODULE_RENDER_INTERPOLATIONFILTER_LENGTH   3
 Interpolation Filter.
#define OPENMPT_MODULE_RENDER_VOLUMERAMPING_STRENGTH   4
 Volume Ramping Strength.
#define OPENMPT_MODULE_COMMAND_NOTE   0
 Parameter index to use with openmpt_module_get_pattern_row_channel_command, openmpt_module_format_pattern_row_channel_command and openmpt_module_highlight_pattern_row_channel_command.
#define OPENMPT_MODULE_COMMAND_INSTRUMENT   1
#define OPENMPT_MODULE_COMMAND_VOLUMEEFFECT   2
#define OPENMPT_MODULE_COMMAND_EFFECT   3
#define OPENMPT_MODULE_COMMAND_VOLUME   4
#define OPENMPT_MODULE_COMMAND_PARAMETER   5

Typedefs

typedef size_t(* openmpt_stream_read_func )(void *stream, void *dst, size_t bytes)
 Read bytes from stream.
typedef int(* openmpt_stream_seek_func )(void *stream, int64_t offset, int whence)
 Seek stream position.
typedef int64_t(* openmpt_stream_tell_func )(void *stream)
 Tell stream position.
typedef struct
openmpt_stream_callbacks 
openmpt_stream_callbacks
 Stream callbacks.
typedef void(* openmpt_log_func )(const char *message, void *user)
 Logging function.
typedef struct openmpt_module openmpt_module
 Opaque type representing a libopenmpt module.
typedef struct
openmpt_module_initial_ctl 
openmpt_module_initial_ctl

Functions

uint32_t openmpt_get_library_version (void)
 Get the libopenmpt version number.
uint32_t openmpt_get_core_version (void)
 Get the core version number.
void openmpt_free_string (const char *str)
 Free a string returned by libopenmpt.
const char * openmpt_get_string (const char *key)
 Get library related metadata.
const char * openmpt_get_supported_extensions (void)
 Get a list of supported file extensions.
int openmpt_is_extension_supported (const char *extension)
 Query whether a file extension is supported.
void openmpt_log_func_default (const char *message, void *user)
 Default logging function.
void openmpt_log_func_silent (const char *message, void *user)
 Silent logging function.
double openmpt_could_open_propability (openmpt_stream_callbacks stream_callbacks, void *stream, double effort, openmpt_log_func logfunc, void *user)
 Roughly scan the input stream to find out whether libopenmpt might be able to open it.
openmpt_moduleopenmpt_module_create (openmpt_stream_callbacks stream_callbacks, void *stream, openmpt_log_func logfunc, void *user, const openmpt_module_initial_ctl *ctls)
 Construct an openmpt_module.
openmpt_moduleopenmpt_module_create_from_memory (const void *filedata, size_t filesize, openmpt_log_func logfunc, void *user, const openmpt_module_initial_ctl *ctls)
 Construct an openmpt_module.
void openmpt_module_destroy (openmpt_module *mod)
 Unload a previously created openmpt_module from memory.
int openmpt_module_select_subsong (openmpt_module *mod, int32_t subsong)
 Select a subsong from a multi-song module.
int openmpt_module_set_repeat_count (openmpt_module *mod, int32_t repeat_count)
 Set Repeat Count.
int32_t openmpt_module_get_repeat_count (openmpt_module *mod)
 Get Repeat Count.
double openmpt_module_get_duration_seconds (openmpt_module *mod)
 approximate song duration
double openmpt_module_set_position_seconds (openmpt_module *mod, double seconds)
 Set approximate current song position.
double openmpt_module_get_position_seconds (openmpt_module *mod)
 Get current song position.
double openmpt_module_set_position_order_row (openmpt_module *mod, int32_t order, int32_t row)
 Set approximate current song position.
int openmpt_module_get_render_param (openmpt_module *mod, int param, int32_t *value)
 Get render parameter.
int openmpt_module_set_render_param (openmpt_module *mod, int param, int32_t value)
 Set render parameter.
const char * openmpt_module_get_metadata_keys (openmpt_module *mod)
 Get the list of supported metadata item keys.
const char * openmpt_module_get_metadata (openmpt_module *mod, const char *key)
 Get a metadata item value.
int32_t openmpt_module_get_current_speed (openmpt_module *mod)
 Get the current speed.
int32_t openmpt_module_get_current_tempo (openmpt_module *mod)
 Get the current tempo.
int32_t openmpt_module_get_current_order (openmpt_module *mod)
 Get the current order.
int32_t openmpt_module_get_current_pattern (openmpt_module *mod)
 Get the current pattern.
int32_t openmpt_module_get_current_row (openmpt_module *mod)
 Get the current row.
int32_t openmpt_module_get_current_playing_channels (openmpt_module *mod)
 Get the current amount of playing channels.
float openmpt_module_get_current_channel_vu_mono (openmpt_module *mod, int32_t channel)
 Get an approximate indication of the channel volume.
float openmpt_module_get_current_channel_vu_left (openmpt_module *mod, int32_t channel)
 Get an approximate indication of the channel volume on the front-left speaker.
float openmpt_module_get_current_channel_vu_right (openmpt_module *mod, int32_t channel)
 Get an approximate indication of the channel volume on the front-right speaker.
float openmpt_module_get_current_channel_vu_rear_left (openmpt_module *mod, int32_t channel)
 Get an approximate indication of the channel volume on the rear-left speaker.
float openmpt_module_get_current_channel_vu_rear_right (openmpt_module *mod, int32_t channel)
 Get an approximate indication of the channel volume on the rear-right speaker.
int32_t openmpt_module_get_num_subsongs (openmpt_module *mod)
 Get the number of subsongs.
int32_t openmpt_module_get_num_channels (openmpt_module *mod)
 Get the number of pattern channels.
int32_t openmpt_module_get_num_orders (openmpt_module *mod)
 Get the number of orders.
int32_t openmpt_module_get_num_patterns (openmpt_module *mod)
 Get the number of patterns.
int32_t openmpt_module_get_num_instruments (openmpt_module *mod)
 Get the number of instruments.
int32_t openmpt_module_get_num_samples (openmpt_module *mod)
 Get the number of samples.
const char * openmpt_module_get_subsong_name (openmpt_module *mod, int32_t index)
 Get a subsong name.
const char * openmpt_module_get_channel_name (openmpt_module *mod, int32_t index)
 Get a channel name.
const char * openmpt_module_get_order_name (openmpt_module *mod, int32_t index)
 Get a order name.
const char * openmpt_module_get_pattern_name (openmpt_module *mod, int32_t index)
 Get a pattern name.
const char * openmpt_module_get_instrument_name (openmpt_module *mod, int32_t index)
 Get a instrument name.
const char * openmpt_module_get_sample_name (openmpt_module *mod, int32_t index)
 Get a sample name.
int32_t openmpt_module_get_order_pattern (openmpt_module *mod, int32_t order)
 Get pattern at order position.
int32_t openmpt_module_get_pattern_num_rows (openmpt_module *mod, int32_t pattern)
 Get the number of rows in a pattern.
uint8_t openmpt_module_get_pattern_row_channel_command (openmpt_module *mod, int32_t pattern, int32_t row, int32_t channel, int command)
 Get raw pattern content.
const char * openmpt_module_format_pattern_row_channel_command (openmpt_module *mod, int32_t pattern, int32_t row, int32_t channel, int command)
 Get formatted (human-readable) pattern content.
const char * openmpt_module_highlight_pattern_row_channel_command (openmpt_module *mod, int32_t pattern, int32_t row, int32_t channel, int command)
 Get highlighting information for formatted pattern content.
const char * openmpt_module_format_pattern_row_channel (openmpt_module *mod, int32_t pattern, int32_t row, int32_t channel, size_t width, int pad)
 Get formatted (human-readable) pattern content.
const char * openmpt_module_highlight_pattern_row_channel (openmpt_module *mod, int32_t pattern, int32_t row, int32_t channel, size_t width, int pad)
 Get highlighting information for formatted pattern content.
const char * openmpt_module_get_ctls (openmpt_module *mod)
 Retrieve supported ctl keys.
const char * openmpt_module_ctl_get (openmpt_module *mod, const char *ctl)
 Get current ctl value.
int openmpt_module_ctl_set (openmpt_module *mod, const char *ctl, const char *value)
 Set ctl value.
size_t openmpt_module_read_mono (openmpt_module *mod, int32_t samplerate, size_t count, int16_t *mono)
 Render audio data.
size_t openmpt_module_read_stereo (openmpt_module *mod, int32_t samplerate, size_t count, int16_t *left, int16_t *right)
 Render audio data.
size_t openmpt_module_read_quad (openmpt_module *mod, int32_t samplerate, size_t count, int16_t *left, int16_t *right, int16_t *rear_left, int16_t *rear_right)
 Render audio data.
size_t openmpt_module_read_float_mono (openmpt_module *mod, int32_t samplerate, size_t count, float *mono)
 Render audio data.
size_t openmpt_module_read_float_stereo (openmpt_module *mod, int32_t samplerate, size_t count, float *left, float *right)
 Render audio data.
size_t openmpt_module_read_float_quad (openmpt_module *mod, int32_t samplerate, size_t count, float *left, float *right, float *rear_left, float *rear_right)
 Render audio data.
size_t openmpt_module_read_interleaved_stereo (openmpt_module *mod, int32_t samplerate, size_t count, int16_t *interleaved_stereo)
 Render audio data.
size_t openmpt_module_read_interleaved_quad (openmpt_module *mod, int32_t samplerate, size_t count, int16_t *interleaved_quad)
 Render audio data.
size_t openmpt_module_read_interleaved_float_stereo (openmpt_module *mod, int32_t samplerate, size_t count, float *interleaved_stereo)
 Render audio data.
size_t openmpt_module_read_interleaved_float_quad (openmpt_module *mod, int32_t samplerate, size_t count, float *interleaved_quad)
 Render audio data.