|
JACK-AUDIO-CONNECTION-KIT
|
Topics | |
| Managing and determining latency | |
| int jack_connect | ( | jack_client_t * | , |
| const char * | source_port, | ||
| const char * | destination_port ) |
Establish a connection between two ports.
When a connection exists, data written to the source port will be available to be read at the destination port.
References jack_connect(), and JACK_OPTIONAL_WEAK_EXPORT.
Referenced by jack_connect().
| int jack_disconnect | ( | jack_client_t * | , |
| const char * | source_port, | ||
| const char * | destination_port ) |
Remove a connection between two ports.
References jack_disconnect(), and JACK_OPTIONAL_WEAK_EXPORT.
Referenced by jack_disconnect().
| int jack_port_connected | ( | const jack_port_t * | port | ) |
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_connected().
Referenced by jack_port_connected().
| int jack_port_connected_to | ( | const jack_port_t * | port, |
| const char * | port_name ) |
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_connected_to().
Referenced by jack_port_connected_to().
| int jack_port_disconnect | ( | jack_client_t * | , |
| jack_port_t * | ) |
Perform the same function as jack_disconnect() using port handles rather than names. This avoids the name lookup inherent in the name-based version.
Clients connecting their own ports are likely to use this function, while generic connection clients (e.g. patchbays) would use jack_disconnect().
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_disconnect().
Referenced by jack_port_disconnect().
| int jack_port_ensure_monitor | ( | jack_port_t * | port, |
| int | onoff ) |
If JackPortCanMonitor is set for a port, this function turns on input monitoring if it was off, and turns it off if only one request has been made to turn it on. Otherwise it does nothing.
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_ensure_monitor().
Referenced by jack_port_ensure_monitor().
| int jack_port_flags | ( | const jack_port_t * | port | ) |
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_flags().
Referenced by jack_port_flags().
| int jack_port_get_aliases | ( | const jack_port_t * | port, |
| char *const | aliases[2] ) |
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_get_aliases().
Referenced by jack_port_get_aliases().
| const char ** jack_port_get_all_connections | ( | const jack_client_t * | client, |
| const jack_port_t * | port ) |
The caller is responsible for calling jack_free(3) on any non-NULL returned value.
This differs from jack_port_get_connections() in two important respects:
1) You may not call this function from code that is
executed in response to a JACK event. For example,
you cannot use it in a GraphReordered handler.
2) You need not be the owner of the port to get information
about its connections.
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_get_all_connections().
Referenced by jack_port_get_all_connections().
| void * jack_port_get_buffer | ( | jack_port_t * | , |
| jack_nframes_t | ) |
This returns a pointer to the memory area associated with the specified port. For an output port, it will be a memory area that can be written to; for an input port, it will be an area containing the data from the port's connection(s), or zero-filled. if there are multiple inbound connections, the data will be mixed appropriately.
Do not cache the returned address across process() callbacks. Port buffers have to be retrieved in each callback for proper functionning.
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_get_buffer().
Referenced by jack_port_get_buffer().
| const char ** jack_port_get_connections | ( | const jack_port_t * | port | ) |
The caller is responsible for calling jack_free(3) on any non-NULL returned value.
| port | locally owned jack_port_t pointer. |
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_get_connections().
Referenced by jack_port_get_connections().
| int jack_port_is_mine | ( | const jack_client_t * | , |
| const jack_port_t * | port ) |
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_is_mine().
Referenced by jack_port_is_mine().
| int jack_port_monitoring_input | ( | jack_port_t * | port | ) |
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_monitoring_input().
Referenced by jack_port_monitoring_input().
| const char * jack_port_name | ( | const jack_port_t * | port | ) |
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_name().
Referenced by jack_port_name().
| int jack_port_name_size | ( | void | ) |
A port's full name contains the owning client name concatenated with a colon (:) followed by its short name and a NULL character.
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_name_size().
Referenced by jack_port_name_size().
| jack_port_t * jack_port_register | ( | jack_client_t * | client, |
| const char * | port_name, | ||
| const char * | port_type, | ||
| unsigned long | flags, | ||
| unsigned long | buffer_size ) |
Create a new port for the client. This is an object used for moving data of any type in or out of the client. Ports may be connected in various ways.
Each port has a short name. The port's full name contains the name of the client concatenated with a colon (:) followed by its short name. The jack_port_name_size() is the maximum length of this full name. Exceeding that will cause the port registration to fail and return NULL.
The port_name must be unique among all ports owned by this client. If the name is not unique, the registration will fail.
All ports have a type, which may be any non-NULL and non-zero length string, passed as an argument. Some port types are built into the JACK API, like JACK_DEFAULT_AUDIO_TYPE or JACK_DEFAULT_MIDI_TYPE
| client | pointer to JACK client structure. |
| port_name | non-empty short name for the new port (not including the leading "client_name:"). Must be unique. |
| port_type | port type name. If longer than jack_port_type_size(), only that many characters are significant. |
| flags | JackPortFlags bit mask. |
| buffer_size | must be non-zero if this is not a built-in port_type. Otherwise, it is ignored. |
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_register().
Referenced by jack_port_register().
| int jack_port_rename | ( | jack_client_t * | client, |
| jack_port_t * | port, | ||
| const char * | port_name ) |
Modify a port's short name. May NOT be called from a callback handling a server event.
If the resulting full name (including the "client_name:" prefix) is longer than jack_port_name_size(), it will be truncated.
This differs from jack_port_set_name() by triggering PortRename notifications to clients that have registered a port rename handler.
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_rename().
Referenced by jack_port_rename().
| int jack_port_request_monitor | ( | jack_port_t * | port, |
| int | onoff ) |
If JackPortCanMonitor is set for this port, turn input monitoring on or off. Otherwise, do nothing.
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_request_monitor().
Referenced by jack_port_request_monitor().
| int jack_port_request_monitor_by_name | ( | jack_client_t * | client, |
| const char * | port_name, | ||
| int | onoff ) |
If JackPortCanMonitor is set for this port_name, turn input monitoring on or off. Otherwise, do nothing.
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_request_monitor_by_name().
Referenced by jack_port_request_monitor_by_name().
| int jack_port_set_alias | ( | jack_port_t * | port, |
| const char * | alias ) |
Set alias as an alias for port. May be called at any time. If the alias is longer than jack_port_name_size(), it will be truncated.
After a successful call, and until JACK exits or jack_port_unset_alias() is called, may be used as a alternate name for the port.
Ports can have up to two aliases - if both are already set, this function will return an error.
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_set_alias().
Referenced by jack_port_set_alias().
| int jack_port_set_name | ( | jack_port_t * | port, |
| const char * | port_name ) |
Modify a port's short name. May be called at any time. If the resulting full name (including the "client_name:" prefix) is longer than jack_port_name_size(), it will be truncated.
References jack_port_set_name().
Referenced by jack_port_set_name().
| const char * jack_port_short_name | ( | const jack_port_t * | port | ) |
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_short_name().
Referenced by jack_port_short_name().
| int jack_port_tie | ( | jack_port_t * | src, |
| jack_port_t * | dst ) |
References jack_port_tie().
Referenced by jack_port_tie().
| const char * jack_port_type | ( | const jack_port_t * | port | ) |
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_type().
Referenced by jack_port_type().
| size_t jack_port_type_get_buffer_size | ( | jack_client_t * | client, |
| const char * | port_type ) |
References jack_port_type_get_buffer_size().
Referenced by jack_port_type_get_buffer_size().
| int jack_port_type_size | ( | void | ) |
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_type_size().
Referenced by jack_port_type_size().
| int jack_port_unregister | ( | jack_client_t * | , |
| jack_port_t * | ) |
Remove the port from the client, disconnecting any existing connections.
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_unregister().
Referenced by jack_port_unregister().
| int jack_port_unset_alias | ( | jack_port_t * | port, |
| const char * | alias ) |
Remove alias as an alias for port. May be called at any time.
After a successful call, alias can no longer be used as a alternate name for the port.
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_unset_alias().
Referenced by jack_port_unset_alias().
| int jack_port_untie | ( | jack_port_t * | port | ) |
References jack_port_untie().
Referenced by jack_port_untie().
| jack_uuid_t jack_port_uuid | ( | const jack_port_t * | port | ) |
References JACK_OPTIONAL_WEAK_EXPORT, and jack_port_uuid().
Referenced by jack_port_uuid().