libopenmpt
0.2.8190-autotools
cross-platform C++ and C library to decode tracked music files
|
Modules | |
Pattern cell indices | |
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. | |
Classes | |
struct | openmpt_stream_callbacks |
Stream callbacks. More... | |
struct | openmpt_module_initial_ctl |
Macros | |
#define | OPENMPT_STRING_LIBRARY_VERSION LIBOPENMPT_DEPRECATED_STRING( "library_version" ) |
#define | OPENMPT_STRING_LIBRARY_FEATURES LIBOPENMPT_DEPRECATED_STRING( "library_features" ) |
#define | OPENMPT_STRING_CORE_VERSION LIBOPENMPT_DEPRECATED_STRING( "core_version" ) |
#define | OPENMPT_STRING_BUILD LIBOPENMPT_DEPRECATED_STRING( "build" ) |
#define | OPENMPT_STRING_CREDITS LIBOPENMPT_DEPRECATED_STRING( "credits" ) |
#define | OPENMPT_STRING_CONTACT LIBOPENMPT_DEPRECATED_STRING( "contact" ) |
#define | OPENMPT_STRING_LICENSE LIBOPENMPT_DEPRECATED_STRING( "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. More... | |
#define | OPENMPT_MODULE_RENDER_STEREOSEPARATION_PERCENT 2 |
Stereo Separation. More... | |
#define | OPENMPT_MODULE_RENDER_INTERPOLATIONFILTER_LENGTH 3 |
Interpolation Filter. More... | |
#define | OPENMPT_MODULE_RENDER_VOLUMERAMPING_STRENGTH 4 |
Volume Ramping Strength. More... | |
Typedefs | |
typedef size_t(* | openmpt_stream_read_func) (void *stream, void *dst, size_t bytes) |
Read bytes from stream. More... | |
typedef int(* | openmpt_stream_seek_func) (void *stream, int64_t offset, int whence) |
Seek stream position. More... | |
typedef int64_t(* | openmpt_stream_tell_func) (void *stream) |
Tell stream position. More... | |
typedef struct openmpt_stream_callbacks | openmpt_stream_callbacks |
Stream callbacks. More... | |
typedef void(* | openmpt_log_func) (const char *message, void *user) |
Logging function. More... | |
typedef struct openmpt_module | openmpt_module |
Opaque type representing a libopenmpt module. More... | |
typedef struct openmpt_module_initial_ctl | openmpt_module_initial_ctl |
Functions | |
uint32_t | openmpt_get_library_version (void) |
Get the libopenmpt version number. More... | |
uint32_t | openmpt_get_core_version (void) |
Get the core version number. More... | |
void | openmpt_free_string (const char *str) |
Free a string returned by libopenmpt. More... | |
const char * | openmpt_get_string (const char *key) |
Get library related metadata. More... | |
const char * | openmpt_get_supported_extensions (void) |
Get a list of supported file extensions. More... | |
int | openmpt_is_extension_supported (const char *extension) |
Query whether a file extension is supported. More... | |
void | openmpt_log_func_default (const char *message, void *user) |
Default logging function. More... | |
void | openmpt_log_func_silent (const char *message, void *user) |
Silent logging function. More... | |
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. More... | |
openmpt_module * | openmpt_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. More... | |
openmpt_module * | openmpt_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. More... | |
void | openmpt_module_destroy (openmpt_module *mod) |
Unload a previously created openmpt_module from memory. More... | |
int | openmpt_module_select_subsong (openmpt_module *mod, int32_t subsong) |
Select a sub-song from a multi-song module. More... | |
int | openmpt_module_set_repeat_count (openmpt_module *mod, int32_t repeat_count) |
Set Repeat Count. More... | |
int32_t | openmpt_module_get_repeat_count (openmpt_module *mod) |
Get Repeat Count. More... | |
double | openmpt_module_get_duration_seconds (openmpt_module *mod) |
approximate song duration More... | |
double | openmpt_module_set_position_seconds (openmpt_module *mod, double seconds) |
Set approximate current song position. More... | |
double | openmpt_module_get_position_seconds (openmpt_module *mod) |
Get current song position. More... | |
double | openmpt_module_set_position_order_row (openmpt_module *mod, int32_t order, int32_t row) |
Set approximate current song position. More... | |
int | openmpt_module_get_render_param (openmpt_module *mod, int param, int32_t *value) |
Get render parameter. More... | |
int | openmpt_module_set_render_param (openmpt_module *mod, int param, int32_t value) |
Set render parameter. More... | |
const char * | openmpt_module_get_metadata_keys (openmpt_module *mod) |
Get the list of supported metadata item keys. More... | |
const char * | openmpt_module_get_metadata (openmpt_module *mod, const char *key) |
Get a metadata item value. More... | |
int32_t | openmpt_module_get_current_speed (openmpt_module *mod) |
Get the current speed. More... | |
int32_t | openmpt_module_get_current_tempo (openmpt_module *mod) |
Get the current tempo. More... | |
int32_t | openmpt_module_get_current_order (openmpt_module *mod) |
Get the current order. More... | |
int32_t | openmpt_module_get_current_pattern (openmpt_module *mod) |
Get the current pattern. More... | |
int32_t | openmpt_module_get_current_row (openmpt_module *mod) |
Get the current row. More... | |
int32_t | openmpt_module_get_current_playing_channels (openmpt_module *mod) |
Get the current amount of playing channels. More... | |
float | openmpt_module_get_current_channel_vu_mono (openmpt_module *mod, int32_t channel) |
Get an approximate indication of the channel volume. More... | |
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. More... | |
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. More... | |
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. More... | |
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. More... | |
int32_t | openmpt_module_get_num_subsongs (openmpt_module *mod) |
Get the number of sub-songs. More... | |
int32_t | openmpt_module_get_num_channels (openmpt_module *mod) |
Get the number of pattern channels. More... | |
int32_t | openmpt_module_get_num_orders (openmpt_module *mod) |
Get the number of orders. More... | |
int32_t | openmpt_module_get_num_patterns (openmpt_module *mod) |
Get the number of patterns. More... | |
int32_t | openmpt_module_get_num_instruments (openmpt_module *mod) |
Get the number of instruments. More... | |
int32_t | openmpt_module_get_num_samples (openmpt_module *mod) |
Get the number of samples. More... | |
const char * | openmpt_module_get_subsong_name (openmpt_module *mod, int32_t index) |
Get a sub-song name. More... | |
const char * | openmpt_module_get_channel_name (openmpt_module *mod, int32_t index) |
Get a channel name. More... | |
const char * | openmpt_module_get_order_name (openmpt_module *mod, int32_t index) |
Get an order name. More... | |
const char * | openmpt_module_get_pattern_name (openmpt_module *mod, int32_t index) |
Get a pattern name. More... | |
const char * | openmpt_module_get_instrument_name (openmpt_module *mod, int32_t index) |
Get an instrument name. More... | |
const char * | openmpt_module_get_sample_name (openmpt_module *mod, int32_t index) |
Get a sample name. More... | |
int32_t | openmpt_module_get_order_pattern (openmpt_module *mod, int32_t order) |
Get pattern at order position. More... | |
int32_t | openmpt_module_get_pattern_num_rows (openmpt_module *mod, int32_t pattern) |
Get the number of rows in a pattern. More... | |
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. More... | |
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. More... | |
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. More... | |
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. More... | |
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. More... | |
const char * | openmpt_module_get_ctls (openmpt_module *mod) |
Retrieve supported ctl keys. More... | |
const char * | openmpt_module_ctl_get (openmpt_module *mod, const char *ctl) |
Get current ctl value. More... | |
int | openmpt_module_ctl_set (openmpt_module *mod, const char *ctl, const char *value) |
Set ctl value. More... | |
size_t | openmpt_module_read_mono (openmpt_module *mod, int32_t samplerate, size_t count, int16_t *mono) |
Render audio data. More... | |
size_t | openmpt_module_read_stereo (openmpt_module *mod, int32_t samplerate, size_t count, int16_t *left, int16_t *right) |
Render audio data. More... | |
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. More... | |
size_t | openmpt_module_read_float_mono (openmpt_module *mod, int32_t samplerate, size_t count, float *mono) |
Render audio data. More... | |
size_t | openmpt_module_read_float_stereo (openmpt_module *mod, int32_t samplerate, size_t count, float *left, float *right) |
Render audio data. More... | |
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. More... | |
size_t | openmpt_module_read_interleaved_stereo (openmpt_module *mod, int32_t samplerate, size_t count, int16_t *interleaved_stereo) |
Render audio data. More... | |
size_t | openmpt_module_read_interleaved_quad (openmpt_module *mod, int32_t samplerate, size_t count, int16_t *interleaved_quad) |
Render audio data. More... | |
size_t | openmpt_module_read_interleaved_float_stereo (openmpt_module *mod, int32_t samplerate, size_t count, float *interleaved_stereo) |
Render audio data. More... | |
size_t | openmpt_module_read_interleaved_float_quad (openmpt_module *mod, int32_t samplerate, size_t count, float *interleaved_quad) |
Render audio data. More... | |
#define OPENMPT_MODULE_RENDER_INTERPOLATIONFILTER_LENGTH 3 |
Interpolation Filter.
The related value represents the interpolation filter length used by the libopenmpt mixer.
The default value is 0, which indicates a recommended default value.
The supported value range is [0,inf). Values greater than the implementation limit are clamped to the maximum supported value.
Currently supported values:
#define OPENMPT_MODULE_RENDER_MASTERGAIN_MILLIBEL 1 |
Master Gain.
The related value represents a relative gain in milliBel.
The default value is 0.
The supported value range is unlimited.
#define OPENMPT_MODULE_RENDER_STEREOSEPARATION_PERCENT 2 |
Stereo Separation.
The related value represents the stereo separation generated by the libopenmpt mixer in percent.
The default value is 100.
The supported value range is [0,200].
#define OPENMPT_MODULE_RENDER_VOLUMERAMPING_STRENGTH 4 |
Volume Ramping Strength.
The related value represents the amount of volume ramping done by the libopenmpt mixer.
The default value is -1, which indicates a recommended default value.
The meaningful value range is [-1..10].
A value of 0 completely disables volume ramping. This might cause clicks in sound output.
Higher values imply slower/softer volume ramps.
#define OPENMPT_STREAM_SEEK_CUR 1 |
Seek to the given offset relative to the current position in the file.
#define OPENMPT_STREAM_SEEK_END 2 |
Seek to the given offset relative to the end of the file.
#define OPENMPT_STREAM_SEEK_SET 0 |
Seek to the given offset relative to the beginning of the file.
#define OPENMPT_STRING_BUILD LIBOPENMPT_DEPRECATED_STRING( "build" ) |
Return information about the current build (e.g. the build date or compiler used) from openmpt_get_string().
directly.
#define OPENMPT_STRING_CONTACT LIBOPENMPT_DEPRECATED_STRING( "contact" ) |
Return contact information about libopenmpt from openmpt_get_string().
directly.
#define OPENMPT_STRING_CORE_VERSION LIBOPENMPT_DEPRECATED_STRING( "core_version" ) |
Return a verbose OpenMPT core version string from openmpt_get_string().
directly.
#define OPENMPT_STRING_CREDITS LIBOPENMPT_DEPRECATED_STRING( "credits" ) |
#define OPENMPT_STRING_LIBRARY_FEATURES LIBOPENMPT_DEPRECATED_STRING( "library_features" ) |
Return a verbose library features string from openmpt_get_string().
directly.
#define OPENMPT_STRING_LIBRARY_VERSION LIBOPENMPT_DEPRECATED_STRING( "library_version" ) |
Return a verbose library version string from openmpt_get_string().
directly.
#define OPENMPT_STRING_LICENSE LIBOPENMPT_DEPRECATED_STRING( "license" ) |
typedef void(* openmpt_log_func) (const char *message, void *user) |
Logging function.
message | UTF-8 encoded log message. |
user | User context that was passed to openmpt_module_create(), openmpt_module_create_from_memory() or openmpt_could_open_propability(). |
typedef struct openmpt_module openmpt_module |
Opaque type representing a libopenmpt module.
typedef struct openmpt_module_initial_ctl openmpt_module_initial_ctl |
typedef struct openmpt_stream_callbacks openmpt_stream_callbacks |
Stream callbacks.
Stream callbacks used by libopenmpt for stream operations.
typedef size_t(* openmpt_stream_read_func) (void *stream, void *dst, size_t bytes) |
Read bytes from stream.
Read bytes data from stream to dst.
stream | Stream to read data from |
dst | Target where to copy data. |
bytes | Number of bytes to read. |
0 | End of stream or error. |
typedef int(* openmpt_stream_seek_func) (void *stream, int64_t offset, int whence) |
Seek stream position.
Seek to stream position offset at whence.
stream | Stream to operate on. |
offset | Offset to seek to. |
whence | OPENMPT_STREAM_SEEK_SET, OPENMPT_STREAM_SEEK_CUR, OPENMPT_STREAM_SEEK_END. See C89 documentation. |
0 | Success. |
-1 | Failure. Position does not get updated. |
typedef int64_t(* openmpt_stream_tell_func) (void *stream) |
Tell stream position.
Tell position of stream.
stream | Stream to operate on. |
-1 | Failure. |
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.
stream_callbacks | Input stream callback operations. |
stream | Input stream to scan. |
effort | Effort to make when validating stream. Effort 0.0 does not even look at stream at all and effort 1.0 completely loads the file from stream. A lower effort requires less data to be loaded but only gives a rough estimate answer. Use an effort of 0.25 to only verify the header data of the module file. |
logfunc | Logging function where warning and errors are written. |
user | Logging function user context. |
void openmpt_free_string | ( | const char * | str | ) |
Free a string returned by libopenmpt.
Frees any string that got returned by libopenmpt.
uint32_t openmpt_get_core_version | ( | void | ) |
Get the core version number.
Return the OpenMPT core version number.
uint32_t openmpt_get_library_version | ( | void | ) |
Get the libopenmpt version number.
Returns the libopenmpt version number.
const char* openmpt_get_string | ( | const char * | key | ) |
Get library related metadata.
key | Key to query. Possible keys are:
|
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.
extension | file extension to query without a leading dot. The case is ignored. |
void openmpt_log_func_default | ( | const char * | message, |
void * | user | ||
) |
Default logging function.
Default logging function that logs anything to stderr.
void openmpt_log_func_silent | ( | const char * | message, |
void * | user | ||
) |
Silent logging function.
Silent logging function that throws any log message away.
openmpt_module* openmpt_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.
stream_callbacks | Input stream callback operations. |
stream | Input stream to load the module from. |
logfunc | Logging function where warning and errors are written. The logging function may be called throughout the lifetime of openmpt_module. |
user | User-defined data associated with this module. This value will be passed to the logging callback function (logfunc) |
ctls | A map of initial ctl values, see openmpt_module_get_ctls. |
openmpt_module* openmpt_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.
filedata | Data to load the module from. |
filesize | Amount of data available. |
logfunc | Logging function where warning and errors are written. The logging function may be called throughout the lifetime of openmpt_module. |
user | User-defined data associated with this module. This value will be passed to the logging callback function (logfunc) |
ctls | A map of initial ctl values, see openmpt_module_get_ctls. |
const char* openmpt_module_ctl_get | ( | openmpt_module * | mod, |
const char * | ctl | ||
) |
Get current ctl value.
mod | The module handle to work on. |
ctl | The ctl key whose value should be retrieved. |
int openmpt_module_ctl_set | ( | openmpt_module * | mod, |
const char * | ctl, | ||
const char * | value | ||
) |
Set ctl value.
mod | The module handle to work on. |
ctl | The ctl key whose value should be set. |
value | The value that should be set. |
void openmpt_module_destroy | ( | openmpt_module * | mod | ) |
Unload a previously created openmpt_module from memory.
mod | The module to unload. |
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.
mod | The module handle to work on. |
pattern | The pattern whose data should be retrieved. |
row | The row from which the data should be retrieved. |
channel | The channel from which the data should be retrieved. |
width | The maximum number of characters the string should contain. 0 means no limit. |
pad | If true, the string will be resized to the exact length provided in the width parameter. |
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.
mod | The module handle to work on. |
pattern | The pattern whose data should be retrieved. |
row | The row from which the data should be retrieved. |
channel | The channel from which the data should be retrieved. |
command | The cell index at which the data should be retrieved. |
const char* openmpt_module_get_channel_name | ( | openmpt_module * | mod, |
int32_t | index | ||
) |
Get a channel name.
mod | The module handle to work on. |
index | The channel whose name should be retrieved |
const char* openmpt_module_get_ctls | ( | openmpt_module * | mod | ) |
Retrieve supported ctl keys.
mod | The module handle to work on. |
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.
mod | The module handle to work on. |
channel | The channel whose volume should be retrieved. |
float openmpt_module_get_current_channel_vu_mono | ( | openmpt_module * | mod, |
int32_t | channel | ||
) |
Get an approximate indication of the channel volume.
mod | The module handle to work on. |
channel | The channel whose volume should be retrieved. |
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.
mod | The module handle to work on. |
channel | The channel whose volume should be retrieved. |
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.
mod | The module handle to work on. |
channel | The channel whose volume should be retrieved. |
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.
mod | The module handle to work on. |
channel | The channel whose volume should be retrieved. |
int32_t openmpt_module_get_current_order | ( | openmpt_module * | mod | ) |
Get the current order.
mod | The module handle to work on. |
int32_t openmpt_module_get_current_pattern | ( | openmpt_module * | mod | ) |
Get the current pattern.
mod | The module handle to work on. |
int32_t openmpt_module_get_current_playing_channels | ( | openmpt_module * | mod | ) |
Get the current amount of playing channels.
mod | The module handle to work on. |
int32_t openmpt_module_get_current_row | ( | openmpt_module * | mod | ) |
Get the current row.
mod | The module handle to work on. |
int32_t openmpt_module_get_current_speed | ( | openmpt_module * | mod | ) |
Get the current speed.
mod | The module handle to work on. |
int32_t openmpt_module_get_current_tempo | ( | openmpt_module * | mod | ) |
Get the current tempo.
mod | The module handle to work on. |
double openmpt_module_get_duration_seconds | ( | openmpt_module * | mod | ) |
approximate song duration
mod | The module handle to work on. |
const char* openmpt_module_get_instrument_name | ( | openmpt_module * | mod, |
int32_t | index | ||
) |
Get an instrument name.
mod | The module handle to work on. |
index | The instrument whose name should be retrieved |
const char* openmpt_module_get_metadata | ( | openmpt_module * | mod, |
const char * | key | ||
) |
Get a metadata item value.
mod | The module handle to work on. |
key | Metadata item key to query. Use openmpt_module_get_metadata_keys to check for available keys. Possible keys are:
|
const char* openmpt_module_get_metadata_keys | ( | openmpt_module * | mod | ) |
Get the list of supported metadata item keys.
mod | The module handle to work on. |
int32_t openmpt_module_get_num_channels | ( | openmpt_module * | mod | ) |
Get the number of pattern channels.
mod | The module handle to work on. |
int32_t openmpt_module_get_num_instruments | ( | openmpt_module * | mod | ) |
Get the number of instruments.
mod | The module handle to work on. |
int32_t openmpt_module_get_num_orders | ( | openmpt_module * | mod | ) |
Get the number of orders.
mod | The module handle to work on. |
int32_t openmpt_module_get_num_patterns | ( | openmpt_module * | mod | ) |
Get the number of patterns.
mod | The module handle to work on. |
int32_t openmpt_module_get_num_samples | ( | openmpt_module * | mod | ) |
Get the number of samples.
mod | The module handle to work on. |
int32_t openmpt_module_get_num_subsongs | ( | openmpt_module * | mod | ) |
Get the number of sub-songs.
mod | The module handle to work on. |
const char* openmpt_module_get_order_name | ( | openmpt_module * | mod, |
int32_t | index | ||
) |
Get an order name.
mod | The module handle to work on. |
index | The order whose name should be retrieved |
int32_t openmpt_module_get_order_pattern | ( | openmpt_module * | mod, |
int32_t | order | ||
) |
Get pattern at order position.
mod | The module handle to work on. |
order | The order item whose pattern index should be retrieved. |
const char* openmpt_module_get_pattern_name | ( | openmpt_module * | mod, |
int32_t | index | ||
) |
Get a pattern name.
mod | The module handle to work on. |
index | The pattern whose name should be retrieved |
int32_t openmpt_module_get_pattern_num_rows | ( | openmpt_module * | mod, |
int32_t | pattern | ||
) |
Get the number of rows in a pattern.
mod | The module handle to work on. |
pattern | The pattern whose row count should be retrieved. |
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.
mod | The module handle to work on. |
pattern | The pattern whose data should be retrieved. |
row | The row from which the data should be retrieved. |
channel | The channel from which the data should be retrieved. |
command | The cell index at which the data should be retrieved. See openmpt_module_command_index |
double openmpt_module_get_position_seconds | ( | openmpt_module * | mod | ) |
Get current song position.
mod | The module handle to work on. |
int openmpt_module_get_render_param | ( | openmpt_module * | mod, |
int | param, | ||
int32_t * | value | ||
) |
Get render parameter.
mod | The module handle to work on. |
param | Parameter to query. See openmpt_module_render_param. |
value | Pointer to the variable that receives the current value of the parameter. |
int32_t openmpt_module_get_repeat_count | ( | openmpt_module * | mod | ) |
Get Repeat Count.
mod | The module handle to work on. |
const char* openmpt_module_get_sample_name | ( | openmpt_module * | mod, |
int32_t | index | ||
) |
Get a sample name.
mod | The module handle to work on. |
index | The sample whose name should be retrieved |
const char* openmpt_module_get_subsong_name | ( | openmpt_module * | mod, |
int32_t | index | ||
) |
Get a sub-song name.
mod | The module handle to work on. |
index | The sub-song whose name should be retrieved |
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.
mod | The module handle to work on. |
pattern | The pattern whose data should be retrieved. |
row | The row from which the data should be retrieved. |
channel | The channel from which the data should be retrieved. |
width | The maximum number of characters the string should contain. 0 means no limit. |
pad | If true, the string will be resized to the exact length provided in the width parameter. |
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.
mod | The module handle to work on. |
pattern | The pattern whose data should be retrieved. |
row | The row from which the data should be retrieved. |
channel | The channel from which the data should be retrieved. |
command | The cell index at which the data should be retrieved. See openmpt_module_command_index |
size_t openmpt_module_read_float_mono | ( | openmpt_module * | mod, |
int32_t | samplerate, | ||
size_t | count, | ||
float * | mono | ||
) |
Render audio data.
mod | The module handle to work on. |
samplerate | Sample rate to render output. Should be in [8000,192000], but this is not enforced. |
count | Number of audio frames to render per channel. |
mono | Pointer to a buffer of at least count elements that receives the mono/center output. |
0 | The end of song has been reached. |
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.
mod | The module handle to work on. |
samplerate | Sample rate to render output. Should be in [8000,192000], but this is not enforced. |
count | Number of audio frames to render per channel. |
left | Pointer to a buffer of at least count elements that receives the left output. |
right | Pointer to a buffer of at least count elements that receives the right output. |
rear_left | Pointer to a buffer of at least count elements that receives the rear left output. |
rear_right | Pointer to a buffer of at least count elements that receives the rear right output. |
0 | The end of song has been reached. |
size_t openmpt_module_read_float_stereo | ( | openmpt_module * | mod, |
int32_t | samplerate, | ||
size_t | count, | ||
float * | left, | ||
float * | right | ||
) |
Render audio data.
mod | The module handle to work on. |
samplerate | Sample rate to render output. Should be in [8000,192000], but this is not enforced. |
count | Number of audio frames to render per channel. |
left | Pointer to a buffer of at least count elements that receives the left output. |
right | Pointer to a buffer of at least count elements that receives the right output. |
0 | The end of song has been reached. |
size_t openmpt_module_read_interleaved_float_quad | ( | openmpt_module * | mod, |
int32_t | samplerate, | ||
size_t | count, | ||
float * | interleaved_quad | ||
) |
Render audio data.
mod | The module handle to work on. |
samplerate | Sample rate to render output. Should be in [8000,192000], but this is not enforced. |
count | Number of audio frames to render per channel. |
interleaved_quad | Pointer to a buffer of at least count*4 elements that receives the interleaved suad surround output in the order (L,R,RL,RR). |
0 | The end of song has been reached. |
size_t openmpt_module_read_interleaved_float_stereo | ( | openmpt_module * | mod, |
int32_t | samplerate, | ||
size_t | count, | ||
float * | interleaved_stereo | ||
) |
Render audio data.
mod | The module handle to work on. |
samplerate | Sample rate to render output. Should be in [8000,192000], but this is not enforced. |
count | Number of audio frames to render per channel. |
interleaved_stereo | Pointer to a buffer of at least count*2 elements that receives the interleaved stereo output in the order (L,R). |
0 | The end of song has been reached. |
size_t openmpt_module_read_interleaved_quad | ( | openmpt_module * | mod, |
int32_t | samplerate, | ||
size_t | count, | ||
int16_t * | interleaved_quad | ||
) |
Render audio data.
mod | The module handle to work on. |
samplerate | Sample rate to render output. Should be in [8000,192000], but this is not enforced. |
count | Number of audio frames to render per channel. |
interleaved_quad | Pointer to a buffer of at least count*4 elements that receives the interleaved suad surround output in the order (L,R,RL,RR). |
0 | The end of song has been reached. |
size_t openmpt_module_read_interleaved_stereo | ( | openmpt_module * | mod, |
int32_t | samplerate, | ||
size_t | count, | ||
int16_t * | interleaved_stereo | ||
) |
Render audio data.
mod | The module handle to work on. |
samplerate | Sample rate to render output. Should be in [8000,192000], but this is not enforced. |
count | Number of audio frames to render per channel. |
interleaved_stereo | Pointer to a buffer of at least count*2 elements that receives the interleaved stereo output in the order (L,R). |
0 | The end of song has been reached. |
size_t openmpt_module_read_mono | ( | openmpt_module * | mod, |
int32_t | samplerate, | ||
size_t | count, | ||
int16_t * | mono | ||
) |
Render audio data.
mod | The module handle to work on. |
samplerate | Sample rate to render output. Should be in [8000,192000], but this is not enforced. |
count | Number of audio frames to render per channel. |
mono | Pointer to a buffer of at least count elements that receives the mono/center output. |
0 | The end of song has been reached. |
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.
mod | The module handle to work on. |
samplerate | Sample rate to render output. Should be in [8000,192000], but this is not enforced. |
count | Number of audio frames to render per channel. |
left | Pointer to a buffer of at least count elements that receives the left output. |
right | Pointer to a buffer of at least count elements that receives the right output. |
rear_left | Pointer to a buffer of at least count elements that receives the rear left output. |
rear_right | Pointer to a buffer of at least count elements that receives the rear right output. |
0 | The end of song has been reached. |
size_t openmpt_module_read_stereo | ( | openmpt_module * | mod, |
int32_t | samplerate, | ||
size_t | count, | ||
int16_t * | left, | ||
int16_t * | right | ||
) |
Render audio data.
mod | The module handle to work on. |
samplerate | Sample rate to render output. Should be in [8000,192000], but this is not enforced. |
count | Number of audio frames to render per channel. |
left | Pointer to a buffer of at least count elements that receives the left output. |
right | Pointer to a buffer of at least count elements that receives the right output. |
0 | The end of song has been reached. |
int openmpt_module_select_subsong | ( | openmpt_module * | mod, |
int32_t | subsong | ||
) |
Select a sub-song from a multi-song module.
mod | The module handle to work on. |
subsong | Index of the sub-song. -1 plays all sub-songs consecutively. |
double openmpt_module_set_position_order_row | ( | openmpt_module * | mod, |
int32_t | order, | ||
int32_t | row | ||
) |
Set approximate current song position.
If order or row are out of range, to position is not modified and the current position is returned.
mod | The module handle to work on. |
order | Pattern order number to seek to. |
row | Pattern row number to seek to. |
double openmpt_module_set_position_seconds | ( | openmpt_module * | mod, |
double | seconds | ||
) |
Set approximate current song position.
mod | The module handle to work on. |
seconds | Seconds to seek to. If seconds is out of range, the position gets set to song start or end respectively. |
int openmpt_module_set_render_param | ( | openmpt_module * | mod, |
int | param, | ||
int32_t | value | ||
) |
Set render parameter.
mod | The module handle to work on. |
param | Parameter to set. See openmpt_module_render_param. |
value | The value to set param to. |
int openmpt_module_set_repeat_count | ( | openmpt_module * | mod, |
int32_t | repeat_count | ||
) |
Set Repeat Count.
mod | The module handle to work on. |
repeat_count | Repeat Count
|