| |
| documentation:file_formats:media:container:stream [2022/11/07 14:49] – created trapexit | documentation:file_formats:media:container:stream [Unknown date] (current) – external edit (Unknown date) 127.0.0.1 |
|---|
| | The "stream" file is a generic container that can hold any number of chunk types. The [[https://github.com/trapexit/3do-devkit/tree/master/examples/3dosdk/Toolkit 1.5/Streaming/2p1|DataStream library]] is a pretty open and generic library to allow arbitrary data types to be streamed via a consistent framework. Each type have a "subscriber" that handles the data chunks. |
| | |
| | ===== Subscribers ===== |
| | |
| | * [[https://github.com/trapexit/3do-devkit/tree/master/examples/3dosdk/Toolkit 1.5/Streaming/2p1/DataStream/Subscribers/ControlSubscriber|ControlSubscriber]] |
| | * [[https://github.com/trapexit/3do-devkit/tree/master/examples/3dosdk/Toolkit 1.5/Streaming/2p1/DataStream/Subscribers/CPakSubscriber|CPakSubscriber]] |
| | * [[https://github.com/trapexit/3do-devkit/tree/master/examples/3dosdk/Toolkit 1.5/Streaming/2p1/DataStream/Subscribers/CPakSubscriberS|CPakSubscriberS]] |
| | * [[https://github.com/trapexit/3do-devkit/tree/master/examples/3dosdk/Toolkit 1.5/Streaming/2p1/DataStream/Subscribers/JoinSubscriber|JoinSubscriber]] |
| | * [[https://github.com/trapexit/3do-devkit/tree/master/examples/3dosdk/Toolkit 1.5/Streaming/2p1/DataStream/Subscribers/ProtoSubscriber|ProtoSubscriber]] |
| | * [[https://github.com/trapexit/3do-devkit/tree/master/examples/3dosdk/Toolkit 1.5/Streaming/2p1/DataStream/Subscribers/SAnimSubscriber|SAnimSubscriber]] |
| | * [[https://github.com/trapexit/3do-devkit/tree/master/examples/3dosdk/Toolkit 1.5/Streaming/2p1/DataStream/Subscribers/SAudioSubscriber|SAudioSubscriber]] |
| | |
| | ===== Header ===== |
| | |
| | From [[https://github.com/trapexit/3do-devkit/blob/master/examples/3dosdk/Toolkit 1.5/Streaming/2p1/DataStream/DSStreamHeader.h|DSStreamHeader.h]] and [[https://github.com/trapexit/3do-devkit/blob/master/examples/3dosdk/Toolkit 1.5/Streaming/2p1/DataStream/SubsChunkCommon.h|SubChunkCommon.h]] |
| | <code> |
| | |
| | #define DS_HDR_MAX_PRELOADINST 16 |
| | #define DS_HDR_MAX_SUBSCRIBER 16 |
| | |
| | /* |
| | Upto and including subChunkType are part of the SUBS_CHUNK_COMMON macro |
| | and the SubsChunkData struct. There is a macro (RELATIVE_BRANCHING) |
| | which if set will have 'short chunkFlags' and 'short channel' variables. |
| | If unset it has 'long channel'. |
| | */ |
| | long chunkType; /* chunk type */ |
| | long chunkSize; /* chunk size including header */ |
| | long time; /* position in stream time */ |
| | short chunkFlags; /* reserved for flags */ |
| | short channel; /* logical channel number */ |
| | long subChunkType; /* data sub-type */ |
| | |
| | long headerVersion; /* version of header data */ |
| | long streamBlockSize; /* size of stream buffers in this stream */ |
| | long streamBuffers; /* suggested number of stream buffers to use */ |
| | long streamerDeltaPri; /* delta priority for streamer thread */ |
| | long dataAcqDeltaPri; /* delta priority for data acquisition thread */ |
| | long numSubsMsgs; /* number of subscriber messages to allocate */ |
| | long audioClockChan; /* logical channel number of audio clock channel */ |
| | long enableAudioChan; /* mask of audio channels to enable */ |
| | long preloadInstList[DS_HDR_MAX_PRELOADINST]; /* NULL terminated preloaded instrument list */ |
| | DSHeaderSubs subscriberList[DS_HDR_MAX_SUBSCRIBER]; /* NULL terminated list of subscriber tags */ |
| | |
| | </code> |
| | |
| |
