| FishSoundComment | A comment |
| FishSoundFormat | Info about a particular sound format |
| FishSoundInfo | Info about a particular encoder/decoder instance |
1.5.8
libfishsound-1.0.0/doc/libfishsound/html/classes.html 0000644 0001750 0001750 00000003623 11332273474 017661 0000000 0000000
1.5.8
libfishsound-1.0.0/doc/libfishsound/html/comments_8h.html 0000644 0001750 0001750 00000065147 11332273474 020461 0000000 0000000
#include <fishsound/fishsound.h>
Go to the source code of this file.
Data Structures | |
| struct | FishSoundComment |
| A comment. More... | |
Functions | |
| const char * | fish_sound_comment_get_vendor (FishSound *fsound) |
| Retrieve the vendor string. | |
| const FishSoundComment * | fish_sound_comment_first (FishSound *fsound) |
| Retrieve the first comment. | |
| const FishSoundComment * | fish_sound_comment_next (FishSound *fsound, const FishSoundComment *comment) |
| Retrieve the next comment. | |
| const FishSoundComment * | fish_sound_comment_first_byname (FishSound *fsound, char *name) |
| Retrieve the first comment with a given name. | |
| const FishSoundComment * | fish_sound_comment_next_byname (FishSound *fsound, const FishSoundComment *comment) |
| Retrieve the next comment following and with the same name as a given comment. | |
| int | fish_sound_comment_add (FishSound *fsound, FishSoundComment *comment) |
| Add a comment. | |
| int | fish_sound_comment_add_byname (FishSound *fsound, const char *name, const char *value) |
| Add a comment by name and value. | |
| int | fish_sound_comment_remove (FishSound *fsound, FishSoundComment *comment) |
| Remove a comment. | |
| int | fish_sound_comment_remove_byname (FishSound *fsound, char *name) |
| Remove all comments with a given name. | |
Vorbis and Speex bitstreams use a comment format called "Vorbiscomment", defined here. Many standard comment names (such as TITLE, COPYRIGHT and GENRE) are defined in that document.
The following general features of Vorbiscomment are relevant to this API:
Each comment block contains one Vendor string, which can be retrieved with fish_sound_comment_get_vendor(). When encoding, this string is effectively fixed by the codec libraries; it cannot be set by the application.
The rest of a comment block consists of name = value pairs, with the following restrictions:
| int fish_sound_comment_add | ( | FishSound * | fsound, | |
| FishSoundComment * | comment | |||
| ) |
Add a comment.
| fsound | A FishSound* handle (created with mode FISH_SOUND_ENCODE) | |
| comment | The comment to add |
| 0 | Success | |
| FISH_SOUND_ERR_BAD | fsound is not a valid FishSound* handle | |
| FISH_SOUND_ERR_INVALID | Operation not suitable for this FishSound |
| int fish_sound_comment_add_byname | ( | FishSound * | fsound, | |
| const char * | name, | |||
| const char * | value | |||
| ) |
Add a comment by name and value.
| fsound | A FishSound* handle (created with mode FISH_SOUND_ENCODE) | |
| name | The name of the comment to add | |
| value | The contents of the comment to add |
| 0 | Success | |
| FISH_SOUND_ERR_BAD | fsound is not a valid FishSound* handle | |
| FISH_SOUND_ERR_INVALID | Operation not suitable for this FishSound |
| const FishSoundComment* fish_sound_comment_first | ( | FishSound * | fsound | ) |
Retrieve the first comment.
| fsound | A FishSound* handle |
| const FishSoundComment* fish_sound_comment_first_byname | ( | FishSound * | fsound, | |
| char * | name | |||
| ) |
Retrieve the first comment with a given name.
| fsound | A FishSound* handle | |
| name | the name of the comment to retrieve. |
| NULL | no match was found. |
| const char* fish_sound_comment_get_vendor | ( | FishSound * | fsound | ) |
Retrieve the vendor string.
| fsound | A FishSound* handle |
| NULL | No vendor string is associated with fsound, or fsound is NULL. |
| const FishSoundComment* fish_sound_comment_next | ( | FishSound * | fsound, | |
| const FishSoundComment * | comment | |||
| ) |
Retrieve the next comment.
| fsound | A FishSound* handle | |
| comment | The previous comment. |
| const FishSoundComment* fish_sound_comment_next_byname | ( | FishSound * | fsound, | |
| const FishSoundComment * | comment | |||
| ) |
Retrieve the next comment following and with the same name as a given comment.
| fsound | A FishSound* handle | |
| comment | A comment |
| NULL | no further comments with the same name exist for this FishSound* object. |
| int fish_sound_comment_remove | ( | FishSound * | fsound, | |
| FishSoundComment * | comment | |||
| ) |
Remove a comment.
| fsound | A FishSound* handle (created with FISH_SOUND_ENCODE) | |
| comment | The comment to remove. |
| 1 | Success: comment removed | |
| 0 | No-op: comment not found, nothing to remove | |
| FISH_SOUND_ERR_BAD | fsound is not a valid FishSound* handle | |
| FISH_SOUND_ERR_INVALID | Operation not suitable for this FishSound |
| int fish_sound_comment_remove_byname | ( | FishSound * | fsound, | |
| char * | name | |||
| ) |
Remove all comments with a given name.
| fsound | A FishSound* handle (created with FISH_SOUND_ENCODE) | |
| name | The name of the comments to remove |
| >= 0 | The number of comments removed | |
| FISH_SOUND_ERR_BAD | fsound is not a valid FishSound* handle | |
| FISH_SOUND_ERR_INVALID | Operation not suitable for this FishSound |
1.5.8
libfishsound-1.0.0/doc/libfishsound/html/comments_8h-source.html 0000644 0001750 0001750 00000026426 11332273474 021754 0000000 0000000
1.5.8
libfishsound-1.0.0/doc/libfishsound/html/constants_8h.html 0000644 0001750 0001750 00000046760 11332273474 020650 0000000 0000000
Go to the source code of this file.
| enum _FishSoundCodecID |
| enum _FishSoundCommand |
Command codes.
| FISH_SOUND_COMMAND_NOP | No operation. |
| FISH_SOUND_GET_INFO | Retrieve the FishSoundInfo. |
| FISH_SOUND_GET_INTERLEAVE | Query if multichannel audio should be interpreted as interleaved. |
| FISH_SOUND_SET_INTERLEAVE | Set to 1 to interleave, 0 to non-interleave. |
| enum _FishSoundError |
Error values.
| FISH_SOUND_OK | No error. |
| FISH_SOUND_ERR_GENERIC | generic error |
| FISH_SOUND_ERR_BAD | Not a valid FishSound* handle. |
| FISH_SOUND_ERR_INVALID | The requested operation is not suitable for this FishSound* handle. |
| FISH_SOUND_ERR_OUT_OF_MEMORY | Out of memory. |
| FISH_SOUND_ERR_DISABLED | Functionality disabled at build time. |
| FISH_SOUND_ERR_SHORT_IDENTIFY | Too few bytes passed to fish_sound_identify(). |
| FISH_SOUND_ERR_COMMENT_INVALID | Comment violates VorbisComment restrictions. |
| enum _FishSoundMode |
| enum _FishSoundStopCtl |
1.5.8
libfishsound-1.0.0/doc/libfishsound/html/constants_8h-source.html 0000644 0001750 0001750 00000035223 11332273474 022136 0000000 0000000
1.5.8
libfishsound-1.0.0/doc/libfishsound/html/decode_8h.html 0000644 0001750 0001750 00000041534 11332273474 020051 0000000 0000000
Go to the source code of this file.
Typedefs | |
| typedef int(* | FishSoundDecoded_Float )(FishSound *fsound, float *pcm[], long frames, void *user_data) |
| Signature of a callback for libfishsound to call when it has decoded PCM audio data, and you want this provided as non-interleaved floats. | |
| typedef int(* | FishSoundDecoded_FloatIlv )(FishSound *fsound, float **pcm, long frames, void *user_data) |
| Signature of a callback for libfishsound to call when it has decoded PCM audio data, and you want this provided as interleaved floats. | |
Functions | |
| int | fish_sound_set_decoded_float (FishSound *fsound, FishSoundDecoded_Float decoded, void *user_data) |
| Set the callback for libfishsound to call when it has a block of decoded PCM audio ready, and you want this provided as non-interleaved floats. | |
| int | fish_sound_set_decoded_float_ilv (FishSound *fsound, FishSoundDecoded_FloatIlv decoded, void *user_data) |
| Set the callback for libfishsound to call when it has a block of decoded PCM audio ready, and you want this provided as interleaved floats. | |
| long | fish_sound_decode (FishSound *fsound, unsigned char *buf, long bytes) |
| Decode a block of compressed data. | |
| typedef int(* FishSoundDecoded_Float)(FishSound *fsound, float *pcm[], long frames, void *user_data) |
Signature of a callback for libfishsound to call when it has decoded PCM audio data, and you want this provided as non-interleaved floats.
| fsound | The FishSound* handle | |
| pcm | The decoded audio | |
| frames | The count of frames decoded | |
| user_data | Arbitrary user data |
| FISH_SOUND_CONTINUE | Continue decoding | |
| FISH_SOUND_STOP_OK | Stop decoding immediately and return control to the fish_sound_decode() caller | |
| FISH_SOUND_STOP_ERR | Stop decoding immediately, purge buffered data, and return control to the fish_sound_decode() caller |
| typedef int(* FishSoundDecoded_FloatIlv)(FishSound *fsound, float **pcm, long frames, void *user_data) |
Signature of a callback for libfishsound to call when it has decoded PCM audio data, and you want this provided as interleaved floats.
| fsound | The FishSound* handle | |
| pcm | The decoded audio | |
| frames | The count of frames decoded | |
| user_data | Arbitrary user data |
| FISH_SOUND_CONTINUE | Continue decoding | |
| FISH_SOUND_STOP_OK | Stop decoding immediately and return control to the fish_sound_decode() caller | |
| FISH_SOUND_STOP_ERR | Stop decoding immediately, purge buffered data, and return control to the fish_sound_decode() caller |
| long fish_sound_decode | ( | FishSound * | fsound, | |
| unsigned char * | buf, | |||
| long | bytes | |||
| ) |
Decode a block of compressed data.
No internal buffering is done, so a complete compressed audio packet must be passed each time.
| fsound | A FishSound* handle (created with mode FISH_SOUND_DECODE) | |
| buf | A buffer containing a compressed audio packet | |
| bytes | A count of bytes to decode (i.e. the length of buf) |
| FISH_SOUND_ERR_STOP_OK | Decoding was stopped by a FishSoundDecode* callback returning FISH_SOUND_STOP_OK before any input bytes were consumed. This will occur when PCM is decoded from previously buffered input, and stopping is immediately requested. | |
| FISH_SOUND_ERR_STOP_ERR | Decoding was stopped by a FishSoundDecode* callback returning FISH_SOUND_STOP_ERR before any input bytes were consumed. This will occur when PCM is decoded from previously buffered input, and stopping is immediately requested. | |
| FISH_SOUND_ERR_BAD | Not a valid FishSound* handle | |
| FISH_SOUND_ERR_OUT_OF_MEMORY | Out of memory |
| int fish_sound_set_decoded_float | ( | FishSound * | fsound, | |
| FishSoundDecoded_Float | decoded, | |||
| void * | user_data | |||
| ) |
Set the callback for libfishsound to call when it has a block of decoded PCM audio ready, and you want this provided as non-interleaved floats.
| fsound | A FishSound* handle (created with mode FISH_SOUND_DECODE) | |
| decoded | The callback to call | |
| user_data | Arbitrary user data to pass to the callback |
| 0 | Success | |
| FISH_SOUND_ERR_BAD | Not a valid FishSound* handle | |
| FISH_SOUND_ERR_OUT_OF_MEMORY | Out of memory |
| int fish_sound_set_decoded_float_ilv | ( | FishSound * | fsound, | |
| FishSoundDecoded_FloatIlv | decoded, | |||
| void * | user_data | |||
| ) |
Set the callback for libfishsound to call when it has a block of decoded PCM audio ready, and you want this provided as interleaved floats.
| fsound | A FishSound* handle (created with mode FISH_SOUND_DECODE) | |
| decoded | The callback to call | |
| user_data | Arbitrary user data to pass to the callback |
| 0 | Success | |
| FISH_SOUND_ERR_BAD | Not a valid FishSound* handle | |
| FISH_SOUND_ERR_OUT_OF_MEMORY | Out of memory |
1.5.8
libfishsound-1.0.0/doc/libfishsound/html/decode_8h-source.html 0000644 0001750 0001750 00000022106 11332273474 021341 0000000 0000000
1.5.8
libfishsound-1.0.0/doc/libfishsound/html/deprecated_8h.html 0000644 0001750 0001750 00000027662 11332273474 020734 0000000 0000000
Go to the source code of this file.
Typedefs | |
| typedef FishSoundDecoded_Float | FishSoundDecoded |
| DEPRECATED TYPE. | |
Functions | |
| int | fish_sound_set_decoded_callback (FishSound *fsound, FishSoundDecoded decoded, void *user_data) |
| DEPRECATED FUNCTION. | |
| int | fish_sound_set_interleave (FishSound *fsound, int interleave) |
| DEPRECATED FUNCTION. | |
| long | fish_sound_encode (FishSound *fsound, float **pcm, long frames) |
| DEPRECATED FUNCTION. | |
DEPRECATED TYPE.
Signature of a callback for libfishsound to call when it has decoded PCM audio data, and you want this provided as floats using the current interleave method as set by fish_sound_set_interleave().
| long fish_sound_encode | ( | FishSound * | fsound, | |
| float ** | pcm, | |||
| long | frames | |||
| ) |
DEPRECATED FUNCTION.
Encode a block of audio
| fsound | A FishSound* handle (created with mode FISH_SOUND_ENCODE) | |
| pcm | The audio data to encode | |
| frames | A count of frames to encode |
| int fish_sound_set_decoded_callback | ( | FishSound * | fsound, | |
| FishSoundDecoded | decoded, | |||
| void * | user_data | |||
| ) |
DEPRECATED FUNCTION.
Set the callback for libfishsound to call when it has a block of decoded PCM audio ready, and you want this provided as floats using the current interleave method as set by fish_sound_set_interleave(). This function, and fish_sound_set_interleave(), have been superceded by the typesafe fish_sound_set_decoded_TYPE() callbacks, such as fish_sound_set_decoded_float() or fish_sound_set_decoded_float_ilv().
| fsound | A FishSound* handle (created with mode FISH_SOUND_DECODE) | |
| decoded | The callback to call | |
| user_data | Arbitrary user data to pass to the callback |
| int fish_sound_set_interleave | ( | FishSound * | fsound, | |
| int | interleave | |||
| ) |
DEPRECATED FUNCTION.
Set the PCM format used by a FishSound object. The default value is non-interleaved. Prior to libfishsound 0.7.0, you would (optionally) specify whether you wanted to receive interleaved or per-channel PCM data using fish_sound_set_interleave(), the default being per-channel (non-interleaved) PCM. Whether or not your decoded callback expects interleaved or non-interleaved data is now implied by the particular fish_sound_set_decoded_TYPE() method you use to set it, such as fish_sound_set_decoded_float() or fish_sound_set_decoded_float_ilv().
| fsound | A FishSound* handle | |
| interleave | Whether to use interleaved PCM or not. Valid values are 0 for non-interleaved, and 1 for interleaved. |
| 0 | Success | |
| -1 | Invalid fsound |
1.5.8
libfishsound-1.0.0/doc/libfishsound/html/deprecated_8h-source.html 0000644 0001750 0001750 00000016767 11332273474 022236 0000000 0000000
1.5.8
libfishsound-1.0.0/doc/libfishsound/html/doxygen.css 0000644 0001750 0001750 00000013105 11332273473 017520 0000000 0000000 body, table, div, p, dl {
font-family: Lucida Grande, Verdana, Geneva, Arial, sans-serif;
font-size: 12px;
}
/* @group Heading Levels */
h1 {
text-align: center;
font-size: 150%;
}
h2 {
font-size: 120%;
}
h3 {
font-size: 100%;
}
/* @end */
caption {
font-weight: bold;
}
div.qindex, div.navtab{
background-color: #e8eef2;
border: 1px solid #84b0c7;
text-align: center;
margin: 2px;
padding: 2px;
}
div.qindex, div.navpath {
width: 100%;
line-height: 140%;
}
div.navtab {
margin-right: 15px;
}
/* @group Link Styling */
a {
color: #153788;
font-weight: normal;
text-decoration: none;
}
.contents a:visited {
color: #1b77c5;
}
a:hover {
text-decoration: underline;
}
a.qindex {
font-weight: bold;
}
a.qindexHL {
font-weight: bold;
background-color: #6666cc;
color: #ffffff;
border: 1px double #9295C2;
}
.contents a.qindexHL:visited {
color: #ffffff;
}
a.el {
font-weight: bold;
}
a.elRef {
}
a.code {
}
a.codeRef {
}
/* @end */
dl.el {
margin-left: -1cm;
}
.fragment {
font-family: monospace, fixed;
font-size: 105%;
}
pre.fragment {
border: 1px solid #CCCCCC;
background-color: #f5f5f5;
padding: 4px 6px;
margin: 4px 8px 4px 2px;
}
div.ah {
background-color: black;
font-weight: bold;
color: #ffffff;
margin-bottom: 3px;
margin-top: 3px
}
div.groupHeader {
margin-left: 16px;
margin-top: 12px;
margin-bottom: 6px;
font-weight: bold;
}
div.groupText {
margin-left: 16px;
font-style: italic;
}
body {
background: white;
color: black;
margin-right: 20px;
margin-left: 20px;
}
td.indexkey {
background-color: #e8eef2;
font-weight: bold;
border: 1px solid #CCCCCC;
margin: 2px 0px 2px 0;
padding: 2px 10px;
}
td.indexvalue {
background-color: #e8eef2;
border: 1px solid #CCCCCC;
padding: 2px 10px;
margin: 2px 0px;
}
tr.memlist {
background-color: #f0f0f0;
}
p.formulaDsp {
text-align: center;
}
img.formulaDsp {
}
img.formulaInl {
vertical-align: middle;
}
/* @group Code Colorization */
span.keyword {
color: #008000
}
span.keywordtype {
color: #604020
}
span.keywordflow {
color: #e08000
}
span.comment {
color: #800000
}
span.preprocessor {
color: #806020
}
span.stringliteral {
color: #002080
}
span.charliteral {
color: #008080
}
span.vhdldigit {
color: #ff00ff
}
span.vhdlchar {
color: #000000
}
span.vhdlkeyword {
color: #700070
}
span.vhdllogic {
color: #ff0000
}
/* @end */
.search {
color: #003399;
font-weight: bold;
}
form.search {
margin-bottom: 0px;
margin-top: 0px;
}
input.search {
font-size: 75%;
color: #000080;
font-weight: normal;
background-color: #e8eef2;
}
td.tiny {
font-size: 75%;
}
.dirtab {
padding: 4px;
border-collapse: collapse;
border: 1px solid #84b0c7;
}
th.dirtab {
background: #e8eef2;
font-weight: bold;
}
hr {
height: 0;
border: none;
border-top: 1px solid #666;
}
/* @group Member Descriptions */
.mdescLeft, .mdescRight,
.memItemLeft, .memItemRight,
.memTemplItemLeft, .memTemplItemRight, .memTemplParams {
background-color: #FAFAFA;
border: none;
margin: 4px;
padding: 1px 0 0 8px;
}
.mdescLeft, .mdescRight {
padding: 0px 8px 4px 8px;
color: #555;
}
.memItemLeft, .memItemRight, .memTemplParams {
border-top: 1px solid #ccc;
}
.memTemplParams {
color: #606060;
}
/* @end */
/* @group Member Details */
/* Styles for detailed member documentation */
.memtemplate {
font-size: 80%;
color: #606060;
font-weight: normal;
margin-left: 3px;
}
.memnav {
background-color: #e8eef2;
border: 1px solid #84b0c7;
text-align: center;
margin: 2px;
margin-right: 15px;
padding: 2px;
}
.memitem {
padding: 0;
}
.memname {
white-space: nowrap;
font-weight: bold;
}
.memproto, .memdoc {
border: 1px solid #84b0c7;
}
.memproto {
padding: 0;
background-color: #d5e1e8;
font-weight: bold;
-webkit-border-top-left-radius: 8px;
-webkit-border-top-right-radius: 8px;
-moz-border-radius-topleft: 8px;
-moz-border-radius-topright: 8px;
}
.memdoc {
padding: 2px 5px;
background-color: #eef3f5;
border-top-width: 0;
-webkit-border-bottom-left-radius: 8px;
-webkit-border-bottom-right-radius: 8px;
-moz-border-radius-bottomleft: 8px;
-moz-border-radius-bottomright: 8px;
}
.paramkey {
text-align: right;
}
.paramtype {
white-space: nowrap;
}
.paramname {
color: #602020;
white-space: nowrap;
}
.paramname em {
font-style: normal;
}
/* @end */
/* @group Directory (tree) */
/* for the tree view */
.ftvtree {
font-family: sans-serif;
margin: 0.5em;
}
/* these are for tree view when used as main index */
.directory {
font-size: 9pt;
font-weight: bold;
}
.directory h3 {
margin: 0px;
margin-top: 1em;
font-size: 11pt;
}
/*
The following two styles can be used to replace the root node title
with an image of your choice. Simply uncomment the next two styles,
specify the name of your image and be sure to set 'height' to the
proper pixel height of your image.
*/
/*
.directory h3.swap {
height: 61px;
background-repeat: no-repeat;
background-image: url("yourimage.gif");
}
.directory h3.swap span {
display: none;
}
*/
.directory > h3 {
margin-top: 0;
}
.directory p {
margin: 0px;
white-space: nowrap;
}
.directory div {
display: none;
margin: 0px;
}
.directory img {
vertical-align: -30%;
}
/* these are for tree view when not used as main index */
.directory-alt {
font-size: 100%;
font-weight: bold;
}
.directory-alt h3 {
margin: 0px;
margin-top: 1em;
font-size: 11pt;
}
.directory-alt > h3 {
margin-top: 0;
}
.directory-alt p {
margin: 0px;
white-space: nowrap;
}
.directory-alt div {
display: none;
margin: 0px;
}
.directory-alt img {
vertical-align: -30%;
}
/* @end */
address {
font-style: normal;
color: #333;
}
libfishsound-1.0.0/doc/libfishsound/html/doxygen.png 0000644 0001750 0001750 00000002401 11332273473 017511 0000000 0000000 ‰PNG
IHDR d - ok>Â gAMA ÖØÔOX2 tEXtSoftware Adobe ImageReadyqÉe<