49 lines
2.3 KiB
Factor
49 lines
2.3 KiB
Factor
! (c)2010 Joe Groff bsd license
|
|
USING: audio.engine destructors help.markup help.syntax
|
|
io.files kernel math strings ;
|
|
IN: audio.vorbis
|
|
|
|
HELP: <vorbis-stream>
|
|
{ $values
|
|
{ "stream" "a binary input stream" } { "buffer-size" integer }
|
|
{ "vorbis-stream" vorbis-stream }
|
|
}
|
|
{ $description "Constructs " { $link vorbis-stream } " over the contents of " { $snippet "stream" } ". When used as an audio generator, the Vorbis stream will supply data to the audio engine in " { $snippet "buffer-size" } " byte blocks. If the Vorbis stream is created successfully, it will take ownership of " { $snippet "stream" } ", disposing it when " { $link dispose } " is called on the " { $snippet "vorbis-stream" } "." } ;
|
|
|
|
HELP: no-vorbis-in-ogg
|
|
{ $description { $link <vorbis-stream> } " throws this error when the Ogg stream it reads contains no Vorbis channel." } ;
|
|
|
|
HELP: ogg-error
|
|
{ $values
|
|
{ "code" integer }
|
|
}
|
|
{ $description { $link <vorbis-stream> } " throws this error when the Ogg library raises an error while trying to parse the stream." } ;
|
|
|
|
HELP: read-vorbis-stream
|
|
{ $values
|
|
{ "filename" string } { "buffer-size" integer }
|
|
{ "vorbis-stream" vorbis-stream }
|
|
}
|
|
{ $description "Opens a binary " { $link <file-reader> } " for the file named " { $snippet "filename" } ", and construct a " { $link vorbis-stream } " over the file contents using " { $link <vorbis-stream> } "." } ;
|
|
|
|
{ read-vorbis-stream <vorbis-stream> } related-words
|
|
|
|
HELP: vorbis-error
|
|
{ $values
|
|
{ "code" integer }
|
|
}
|
|
{ $description { $link <vorbis-stream> } " throws this error when the Vorbis library raises an error while trying to parse the stream." } ;
|
|
|
|
HELP: vorbis-stream
|
|
{ $class-description "Objects of this class maintain the stream and decoder state for the Ogg Vorbis decoder. " { $snippet "vorbis-stream" } " implements the " { $link "audio.engine-generators" } ", so it can be used as the generator for a " { $link streaming-audio-clip } ". Use " { $link <vorbis-stream> } " or " { $link read-vorbis-stream } " to construct a Vorbis stream." } ;
|
|
|
|
ARTICLE: "audio.vorbis" "Ogg Vorbis audio streaming"
|
|
"The " { $vocab-link "audio.vorbis" } " vocabulary provides Ogg Vorbis decoding and streaming for " { $vocab-link "audio.engine" } "."
|
|
{ $subsections
|
|
vorbis-stream
|
|
read-vorbis-stream
|
|
<vorbis-stream>
|
|
} ;
|
|
|
|
ABOUT: "audio.vorbis"
|