File: types.h

package info (click to toggle)
liblsl 1.16.2b1-1
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 1,724 kB
  • sloc: cpp: 12,515; ansic: 666; python: 28; sh: 25; makefile: 18
file content (60 lines) | stat: -rw-r--r-- 2,328 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
#ifndef LSL_TYPES
#define LSL_TYPES

/**
 * @class lsl_streaminfo
 * Handle to a stream info object.
 *
 * Stores the declaration of a data stream.
 * Represents the following information:
 *
 *  - stream data format (number of channels, channel format)
 *  - core information (stream name, content type, sampling rate)
 *  - optional meta-data about the stream content (channel labels, measurement units, etc.)
 *
 * Whenever a program wants to provide a new stream on the lab network it will typically first
 * create an lsl_streaminfo to describe its properties and then construct an #lsl_outlet with it to
 * create the stream on the network. Other parties who discover/resolve the outlet on the network
 * can query the stream info; it is also written to disk when recording the stream (playing a
 * similar role as a file header).
 */
typedef struct lsl_streaminfo_struct_ *lsl_streaminfo;

/**
 * @class lsl_outlet
 * A stream outlet handle.
 * Outlets are used to make streaming data (and the meta-data) available on the lab network.
 */
typedef struct lsl_outlet_struct_ *lsl_outlet;

/**
 * @class lsl_inlet
 * A stream inlet handle.
 * Inlets are used to receive streaming data (and meta-data) from the lab network.
 */
typedef struct lsl_inlet_struct_ *lsl_inlet;

/**
 * @class lsl_xml_ptr
 * A lightweight XML element tree handle; models the description of a streaminfo object.
 * XML elements behave like advanced pointers into memory that is owned by some respective
 * streaminfo.
 * Has a name and can have multiple named children or have text content as value;
 * attributes are omitted.
 * @note The interface is modeled after a subset of pugixml's node type and is compatible with it.
 * Type-casts between pugi::xml_node_struct* and #lsl_xml_ptr are permitted (in both directions)
 * since the types are binary compatible.
 * @sa [pugixml documentation](https://pugixml.org/docs/manual.html#access).
 */
typedef struct lsl_xml_ptr_struct_ *lsl_xml_ptr;

/**
 * @class lsl_continuous_resolver
 *
 * Handle to a convenience object that resolves streams continuously in the background throughout
 * its lifetime and which can be queried at any time for the set of streams that are currently
 * visible on the network.
 */
typedef struct lsl_continuous_resolver_ *lsl_continuous_resolver;

#endif // LSL_TYPES