param.h
Go to the documentation of this file.
/* Simple Plugin API
*
* Copyright © 2018 Wim Taymans
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice (including the next
* paragraph) shall be included in all copies or substantial portions of the
* Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
* DEALINGS IN THE SOFTWARE.
*/
#ifndef SPA_PARAM_H
#define SPA_PARAM_H
#ifdef __cplusplus
extern "C" {
#endif
#include <spa/utils/defs.h>
enum spa_param_type {
SPA_PARAM_Invalid,
SPA_PARAM_PropInfo,
SPA_PARAM_Props,
SPA_PARAM_EnumFormat,
SPA_PARAM_Format,
SPA_PARAM_Buffers,
SPA_PARAM_Meta,
SPA_PARAM_IO,
SPA_PARAM_EnumProfile,
SPA_PARAM_Profile,
SPA_PARAM_EnumPortConfig,
SPA_PARAM_PortConfig,
SPA_PARAM_EnumRoute,
SPA_PARAM_Route,
SPA_PARAM_Control,
SPA_PARAM_Latency,
SPA_PARAM_ProcessLatency,
};
struct spa_param_info {
uint32_t id;
#define SPA_PARAM_INFO_SERIAL (1<<0)
#define SPA_PARAM_INFO_READ (1<<1)
#define SPA_PARAM_INFO_WRITE (1<<2)
#define SPA_PARAM_INFO_READWRITE (SPA_PARAM_INFO_WRITE|SPA_PARAM_INFO_READ)
uint32_t flags;
uint32_t user;
uint32_t padding[5];
};
#define SPA_PARAM_INFO(id,flags) (struct spa_param_info){ (id), (flags) }
enum spa_param_buffers {
SPA_PARAM_BUFFERS_START,
SPA_PARAM_BUFFERS_buffers,
SPA_PARAM_BUFFERS_blocks,
SPA_PARAM_BUFFERS_size,
SPA_PARAM_BUFFERS_stride,
SPA_PARAM_BUFFERS_align,
SPA_PARAM_BUFFERS_dataType,
};
enum spa_param_meta {
SPA_PARAM_META_START,
SPA_PARAM_META_type,
SPA_PARAM_META_size,
};
enum spa_param_io {
SPA_PARAM_IO_START,
SPA_PARAM_IO_id,
SPA_PARAM_IO_size,
};
enum spa_param_availability {
SPA_PARAM_AVAILABILITY_unknown,
SPA_PARAM_AVAILABILITY_no,
SPA_PARAM_AVAILABILITY_yes,
};
enum spa_param_profile {
SPA_PARAM_PROFILE_START,
SPA_PARAM_PROFILE_index,
SPA_PARAM_PROFILE_name,
SPA_PARAM_PROFILE_description,
SPA_PARAM_PROFILE_priority,
SPA_PARAM_PROFILE_available,
SPA_PARAM_PROFILE_info,
SPA_PARAM_PROFILE_classes,
SPA_PARAM_PROFILE_save,
};
enum spa_param_port_config_mode {
SPA_PARAM_PORT_CONFIG_MODE_none,
SPA_PARAM_PORT_CONFIG_MODE_passthrough,
SPA_PARAM_PORT_CONFIG_MODE_convert,
SPA_PARAM_PORT_CONFIG_MODE_dsp,
};
enum spa_param_port_config {
SPA_PARAM_PORT_CONFIG_START,
SPA_PARAM_PORT_CONFIG_direction,
SPA_PARAM_PORT_CONFIG_mode,
SPA_PARAM_PORT_CONFIG_monitor,
SPA_PARAM_PORT_CONFIG_control,
SPA_PARAM_PORT_CONFIG_format,
};
enum spa_param_route {
SPA_PARAM_ROUTE_START,
SPA_PARAM_ROUTE_index,
SPA_PARAM_ROUTE_direction,
SPA_PARAM_ROUTE_device,
SPA_PARAM_ROUTE_name,
SPA_PARAM_ROUTE_description,
SPA_PARAM_ROUTE_priority,
SPA_PARAM_ROUTE_available,
SPA_PARAM_ROUTE_info,
SPA_PARAM_ROUTE_profiles,
SPA_PARAM_ROUTE_props,
SPA_PARAM_ROUTE_devices,
SPA_PARAM_ROUTE_profile,
SPA_PARAM_ROUTE_save,
};
enum spa_param_latency {
SPA_PARAM_LATENCY_START,
SPA_PARAM_LATENCY_direction,
SPA_PARAM_LATENCY_minQuantum,
SPA_PARAM_LATENCY_maxQuantum,
SPA_PARAM_LATENCY_minRate,
SPA_PARAM_LATENCY_maxRate,
SPA_PARAM_LATENCY_minNs,
SPA_PARAM_LATENCY_maxNs,
};
enum spa_param_process_latency {
SPA_PARAM_PROCESS_LATENCY_START,
SPA_PARAM_PROCESS_LATENCY_quantum,
SPA_PARAM_PROCESS_LATENCY_rate,
SPA_PARAM_PROCESS_LATENCY_ns,
};
enum spa_param_bitorder {
SPA_PARAM_BITORDER_unknown,
SPA_PARAM_BITORDER_msb,
SPA_PARAM_BITORDER_lsb,
};
#ifdef __cplusplus
} /* extern "C" */
#endif
#endif /* SPA_PARAM_H */
defs.h
spa/utils/defs.h
spa_param_meta
spa_param_meta
properties for SPA_TYPE_OBJECT_ParamMeta
Definition: param.h:102
spa_param_bitorder
spa_param_bitorder
Definition: param.h:208
spa_param_port_config_mode
spa_param_port_config_mode
Definition: param.h:146
spa_param_type
spa_param_type
different parameter types that can be queried
Definition: param.h:49
spa_param_process_latency
spa_param_process_latency
properties for SPA_TYPE_OBJECT_ParamProcessLatency
Definition: param.h:201
spa_param_port_config
spa_param_port_config
properties for SPA_TYPE_OBJECT_ParamPortConfig
Definition: param.h:156
spa_param_latency
spa_param_latency
properties for SPA_TYPE_OBJECT_ParamLatency
Definition: param.h:189
spa_param_route
spa_param_route
properties for SPA_TYPE_OBJECT_ParamRoute
Definition: param.h:166
spa_param_io
spa_param_io
properties for SPA_TYPE_OBJECT_ParamIO
Definition: param.h:109
spa_param_profile
spa_param_profile
properties for SPA_TYPE_OBJECT_ParamProfile
Definition: param.h:122
spa_param_availability
spa_param_availability
Definition: param.h:115
spa_param_buffers
spa_param_buffers
properties for SPA_TYPE_OBJECT_ParamBuffers
Definition: param.h:91
SPA_PARAM_META_START
@ SPA_PARAM_META_START
Definition: param.h:103
SPA_PARAM_META_size
@ SPA_PARAM_META_size
the expected maximum size the meta (Int)
Definition: param.h:105
SPA_PARAM_META_type
@ SPA_PARAM_META_type
the metadata, one of enum spa_meta_type (Id enum spa_meta_type)
Definition: param.h:104
SPA_PARAM_BITORDER_unknown
@ SPA_PARAM_BITORDER_unknown
unknown bitorder
Definition: param.h:209
SPA_PARAM_BITORDER_msb
@ SPA_PARAM_BITORDER_msb
most significant bit
Definition: param.h:210
SPA_PARAM_BITORDER_lsb
@ SPA_PARAM_BITORDER_lsb
least significant bit
Definition: param.h:211
SPA_PARAM_PORT_CONFIG_MODE_convert
@ SPA_PARAM_PORT_CONFIG_MODE_convert
convert configuration
Definition: param.h:149
SPA_PARAM_PORT_CONFIG_MODE_none
@ SPA_PARAM_PORT_CONFIG_MODE_none
no configuration
Definition: param.h:147
SPA_PARAM_PORT_CONFIG_MODE_dsp
@ SPA_PARAM_PORT_CONFIG_MODE_dsp
dsp configuration, depending on the external format.
Definition: param.h:150
SPA_PARAM_PORT_CONFIG_MODE_passthrough
@ SPA_PARAM_PORT_CONFIG_MODE_passthrough
passthrough configuration
Definition: param.h:148
SPA_PARAM_Route
@ SPA_PARAM_Route
routing configuration as SPA_TYPE_OBJECT_ParamRoute
Definition: param.h:63
SPA_PARAM_Format
@ SPA_PARAM_Format
configured format as SPA_TYPE_OBJECT_Format
Definition: param.h:54
SPA_PARAM_EnumRoute
@ SPA_PARAM_EnumRoute
routing enumeration as SPA_TYPE_OBJECT_ParamRoute
Definition: param.h:62
SPA_PARAM_Meta
@ SPA_PARAM_Meta
allowed metadata for buffers as SPA_TYPE_OBJECT_ParamMeta
Definition: param.h:56
SPA_PARAM_IO
@ SPA_PARAM_IO
configurable IO areas as SPA_TYPE_OBJECT_ParamIO
Definition: param.h:57
SPA_PARAM_EnumProfile
@ SPA_PARAM_EnumProfile
profile enumeration as SPA_TYPE_OBJECT_ParamProfile
Definition: param.h:58
SPA_PARAM_EnumPortConfig
@ SPA_PARAM_EnumPortConfig
port configuration enumeration as SPA_TYPE_OBJECT_ParamPortConfig
Definition: param.h:60
SPA_PARAM_EnumFormat
@ SPA_PARAM_EnumFormat
available formats as SPA_TYPE_OBJECT_Format
Definition: param.h:53
SPA_PARAM_Profile
@ SPA_PARAM_Profile
profile configuration as SPA_TYPE_OBJECT_ParamProfile
Definition: param.h:59
SPA_PARAM_Latency
@ SPA_PARAM_Latency
latency reporting, a SPA_TYPE_OBJECT_ParamLatency
Definition: param.h:65
SPA_PARAM_PortConfig
@ SPA_PARAM_PortConfig
port configuration as SPA_TYPE_OBJECT_ParamPortConfig
Definition: param.h:61
SPA_PARAM_Control
@ SPA_PARAM_Control
Control parameter, a SPA_TYPE_Sequence.
Definition: param.h:64
SPA_PARAM_Props
@ SPA_PARAM_Props
properties as SPA_TYPE_OBJECT_Props
Definition: param.h:52
SPA_PARAM_PropInfo
@ SPA_PARAM_PropInfo
property information as SPA_TYPE_OBJECT_PropInfo
Definition: param.h:51
SPA_PARAM_Buffers
@ SPA_PARAM_Buffers
buffer configurations as SPA_TYPE_OBJECT_ParamBuffers
Definition: param.h:55
SPA_PARAM_ProcessLatency
@ SPA_PARAM_ProcessLatency
processing latency, a SPA_TYPE_OBJECT_ParamProcessLatency
Definition: param.h:66
SPA_PARAM_Invalid
@ SPA_PARAM_Invalid
invalid
Definition: param.h:50
SPA_PARAM_PROCESS_LATENCY_rate
@ SPA_PARAM_PROCESS_LATENCY_rate
latency (Int) relative to rate
Definition: param.h:204
SPA_PARAM_PROCESS_LATENCY_START
@ SPA_PARAM_PROCESS_LATENCY_START
Definition: param.h:202
SPA_PARAM_PROCESS_LATENCY_ns
@ SPA_PARAM_PROCESS_LATENCY_ns
latency (Long) in nanoseconds
Definition: param.h:205
SPA_PARAM_PROCESS_LATENCY_quantum
@ SPA_PARAM_PROCESS_LATENCY_quantum
latency relative to quantum (Float)
Definition: param.h:203
SPA_PARAM_PORT_CONFIG_mode
@ SPA_PARAM_PORT_CONFIG_mode
(Id enum spa_param_port_config_mode) mode
Definition: param.h:159
SPA_PARAM_PORT_CONFIG_format
@ SPA_PARAM_PORT_CONFIG_format
(Object) format filter
Definition: param.h:162
SPA_PARAM_PORT_CONFIG_monitor
@ SPA_PARAM_PORT_CONFIG_monitor
(Bool) enable monitor output ports on input ports
Definition: param.h:160
SPA_PARAM_PORT_CONFIG_control
@ SPA_PARAM_PORT_CONFIG_control
(Bool) enable control ports
Definition: param.h:161
SPA_PARAM_PORT_CONFIG_direction
@ SPA_PARAM_PORT_CONFIG_direction
direction, input/output (Id enum spa_direction)
Definition: param.h:158
SPA_PARAM_PORT_CONFIG_START
@ SPA_PARAM_PORT_CONFIG_START
Definition: param.h:157
SPA_PARAM_LATENCY_maxNs
@ SPA_PARAM_LATENCY_maxNs
max latency (Long) in nanoseconds
Definition: param.h:197
SPA_PARAM_LATENCY_minRate
@ SPA_PARAM_LATENCY_minRate
min latency (Int) relative to rate
Definition: param.h:194
SPA_PARAM_LATENCY_minQuantum
@ SPA_PARAM_LATENCY_minQuantum
min latency relative to quantum (Float)
Definition: param.h:192
SPA_PARAM_LATENCY_START
@ SPA_PARAM_LATENCY_START
Definition: param.h:190
SPA_PARAM_LATENCY_maxRate
@ SPA_PARAM_LATENCY_maxRate
max latency (Int) relative to rate
Definition: param.h:195
SPA_PARAM_LATENCY_maxQuantum
@ SPA_PARAM_LATENCY_maxQuantum
max latency relative to quantum (Float)
Definition: param.h:193
SPA_PARAM_LATENCY_direction
@ SPA_PARAM_LATENCY_direction
direction, input/output (Id enum spa_direction)
Definition: param.h:191
SPA_PARAM_LATENCY_minNs
@ SPA_PARAM_LATENCY_minNs
min latency (Long) in nanoseconds
Definition: param.h:196
SPA_PARAM_ROUTE_START
@ SPA_PARAM_ROUTE_START
Definition: param.h:167
SPA_PARAM_ROUTE_save
@ SPA_PARAM_ROUTE_save
If route should be saved (Bool)
Definition: param.h:184
SPA_PARAM_ROUTE_name
@ SPA_PARAM_ROUTE_name
name of the routing destination (String)
Definition: param.h:171
SPA_PARAM_ROUTE_available
@ SPA_PARAM_ROUTE_available
availability of the destination (Id enum spa_param_availability)
Definition: param.h:174
SPA_PARAM_ROUTE_props
@ SPA_PARAM_ROUTE_props
properties SPA_TYPE_OBJECT_Props
Definition: param.h:181
SPA_PARAM_ROUTE_device
@ SPA_PARAM_ROUTE_device
device id (Int)
Definition: param.h:170
SPA_PARAM_ROUTE_priority
@ SPA_PARAM_ROUTE_priority
priority of the destination (Int)
Definition: param.h:173
SPA_PARAM_ROUTE_index
@ SPA_PARAM_ROUTE_index
index of the routing destination (Int)
Definition: param.h:168
SPA_PARAM_ROUTE_direction
@ SPA_PARAM_ROUTE_direction
direction, input/output (Id enum spa_direction)
Definition: param.h:169
SPA_PARAM_ROUTE_profiles
@ SPA_PARAM_ROUTE_profiles
associated profile indexes (Array of Int)
Definition: param.h:180
SPA_PARAM_ROUTE_profile
@ SPA_PARAM_ROUTE_profile
profile id (Int)
Definition: param.h:183
SPA_PARAM_ROUTE_devices
@ SPA_PARAM_ROUTE_devices
associated device indexes (Array of Int)
Definition: param.h:182
SPA_PARAM_ROUTE_description
@ SPA_PARAM_ROUTE_description
description of the destination (String)
Definition: param.h:172
SPA_PARAM_ROUTE_info
@ SPA_PARAM_ROUTE_info
info (Struct( Int : n_items, (String : key, String : value)*))
Definition: param.h:176
SPA_PARAM_IO_id
@ SPA_PARAM_IO_id
type ID, uniquely identifies the io area (Id enum spa_io_type)
Definition: param.h:111
SPA_PARAM_IO_START
@ SPA_PARAM_IO_START
Definition: param.h:110
SPA_PARAM_IO_size
@ SPA_PARAM_IO_size
size of the io area (Int)
Definition: param.h:112
SPA_PARAM_PROFILE_description
@ SPA_PARAM_PROFILE_description
profile description (String)
Definition: param.h:126
SPA_PARAM_PROFILE_save
@ SPA_PARAM_PROFILE_save
If profile should be saved (Bool)
Definition: param.h:143
SPA_PARAM_PROFILE_priority
@ SPA_PARAM_PROFILE_priority
profile priority (Int)
Definition: param.h:127
SPA_PARAM_PROFILE_info
@ SPA_PARAM_PROFILE_info
info (Struct( Int : n_items, (String : key, String : value)*))
Definition: param.h:130
SPA_PARAM_PROFILE_START
@ SPA_PARAM_PROFILE_START
Definition: param.h:123
SPA_PARAM_PROFILE_classes
@ SPA_PARAM_PROFILE_classes
node classes provided by this profile (Struct( Int : number of items following Struct( String : class...
Definition: param.h:134
SPA_PARAM_PROFILE_available
@ SPA_PARAM_PROFILE_available
availability of the profile (Id enum spa_param_availability)
Definition: param.h:128
SPA_PARAM_PROFILE_name
@ SPA_PARAM_PROFILE_name
profile name (String)
Definition: param.h:125
SPA_PARAM_PROFILE_index
@ SPA_PARAM_PROFILE_index
profile index (Int)
Definition: param.h:124
SPA_PARAM_AVAILABILITY_unknown
@ SPA_PARAM_AVAILABILITY_unknown
unknown availability
Definition: param.h:116
SPA_PARAM_AVAILABILITY_yes
@ SPA_PARAM_AVAILABILITY_yes
available
Definition: param.h:118
SPA_PARAM_AVAILABILITY_no
@ SPA_PARAM_AVAILABILITY_no
not available
Definition: param.h:117
SPA_PARAM_BUFFERS_dataType
@ SPA_PARAM_BUFFERS_dataType
possible memory types (Int, mask of enum spa_data_type)
Definition: param.h:98
SPA_PARAM_BUFFERS_size
@ SPA_PARAM_BUFFERS_size
size of a data block memory (Int)
Definition: param.h:95
SPA_PARAM_BUFFERS_START
@ SPA_PARAM_BUFFERS_START
Definition: param.h:92
SPA_PARAM_BUFFERS_stride
@ SPA_PARAM_BUFFERS_stride
stride of data block memory (Int)
Definition: param.h:96
SPA_PARAM_BUFFERS_align
@ SPA_PARAM_BUFFERS_align
alignment of data block memory (Int)
Definition: param.h:97
SPA_PARAM_BUFFERS_blocks
@ SPA_PARAM_BUFFERS_blocks
number of data blocks per buffer (Int)
Definition: param.h:94
SPA_PARAM_BUFFERS_buffers
@ SPA_PARAM_BUFFERS_buffers
number of buffers (Int)
Definition: param.h:93
spa_param_info
information about a parameter
Definition: param.h:70
spa_param_info::flags
uint32_t flags
Definition: param.h:81
spa_param_info::user
uint32_t user
private user field.
Definition: param.h:82
spa_param_info::id
uint32_t id
enum spa_param_type
Definition: param.h:71
spa_param_info::padding
uint32_t padding[5]
Definition: param.h:84