libtorio.stream_writer.rst 1.88 KB
Newer Older
moto's avatar
moto committed
1
2
3
4
.. warning::
   TorchAudio's C++ API is prototype feature.
   API/ABI backward compatibility is not guaranteed.

moto's avatar
moto committed
5
6
7

.. note::
   The top-level namespace has been changed from ``torchaudio`` to ``torio``.
moto-meta's avatar
moto-meta committed
8
   ``StreamWriter`` has been renamed to ``StreamingMediaEncoder``.
moto's avatar
moto committed
9
10


moto-meta's avatar
moto-meta committed
11
12
torio::io::StreamingMediaEncoder
================================
moto's avatar
moto committed
13

moto-meta's avatar
moto-meta committed
14
15
``StreamingMediaEncoder`` is the implementation used by Python equivalent and provides similar interface.
When working with custom I/O, such as in-memory data, ``StreamingMediaEncoderCustomIO`` class can be used.
16
17

Both classes have the same methods defined, so their usages are the same.
moto's avatar
moto committed
18
19
20
21

Constructors
------------

moto-meta's avatar
moto-meta committed
22
23
StreamingMediaEncoder
^^^^^^^^^^^^^^^^^^^^^
24

moto-meta's avatar
moto-meta committed
25
.. doxygenclass:: torio::io::StreamingMediaEncoder
26

27
.. doxygenfunction:: torio::io::StreamingMediaEncoder::StreamingMediaEncoder(const std::string &dst, const std::optional<std::string> &format = {})
moto's avatar
moto committed
28

moto-meta's avatar
moto-meta committed
29
30
StreamingMediaEncoderCustomIO
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
31

moto-meta's avatar
moto-meta committed
32
.. doxygenclass:: torio::io::StreamingMediaEncoderCustomIO
33

moto-meta's avatar
moto-meta committed
34
.. doxygenfunction:: torio::io::StreamingMediaEncoderCustomIO::StreamingMediaEncoderCustomIO
35

moto's avatar
moto committed
36
37
38
39
40
41
Config methods
--------------

add_audio_stream
^^^^^^^^^^^^^^^^

moto-meta's avatar
moto-meta committed
42
.. doxygenfunction:: torio::io::StreamingMediaEncoder::add_audio_stream
moto's avatar
moto committed
43
44
45
46

add_video_stream
^^^^^^^^^^^^^^^^

moto-meta's avatar
moto-meta committed
47
.. doxygenfunction:: torio::io::StreamingMediaEncoder::add_video_stream
moto's avatar
moto committed
48
49
50
51

set_metadata
^^^^^^^^^^^^

moto-meta's avatar
moto-meta committed
52
.. doxygenfunction:: torio::io::StreamingMediaEncoder::set_metadata
moto's avatar
moto committed
53
54
55
56
57
58
59

Write methods
-------------

open
^^^^

moto-meta's avatar
moto-meta committed
60
.. doxygenfunction:: torio::io::StreamingMediaEncoder::open
moto's avatar
moto committed
61
62
63
64

close
^^^^^

moto-meta's avatar
moto-meta committed
65
.. doxygenfunction:: torio::io::StreamingMediaEncoder::close
moto's avatar
moto committed
66
67
68
69

write_audio_chunk
^^^^^^^^^^^^^^^^^

moto-meta's avatar
moto-meta committed
70
.. doxygenfunction:: torio::io::StreamingMediaEncoder::write_audio_chunk
moto's avatar
moto committed
71
72
73
74

write_video_chunk
^^^^^^^^^^^^^^^^^

moto-meta's avatar
moto-meta committed
75
.. doxygenfunction:: torio::io::StreamingMediaEncoder::write_video_chunk
moto's avatar
moto committed
76
77
78
79

flush
^^^^^

moto-meta's avatar
moto-meta committed
80
.. doxygenfunction:: torio::io::StreamingMediaEncoder::flush