Jack2 1.9.6
|
Functions | |
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) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_unregister (jack_client_t *, jack_port_t *) JACK_OPTIONAL_WEAK_EXPORT |
void * | jack_port_get_buffer (jack_port_t *, jack_nframes_t) JACK_OPTIONAL_WEAK_EXPORT |
const char * | jack_port_name (const jack_port_t *port) JACK_OPTIONAL_WEAK_EXPORT |
const char * | jack_port_short_name (const jack_port_t *port) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_flags (const jack_port_t *port) JACK_OPTIONAL_WEAK_EXPORT |
const char * | jack_port_type (const jack_port_t *port) JACK_OPTIONAL_WEAK_EXPORT |
jack_port_type_id_t | jack_port_type_id (const jack_port_t *port) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_is_mine (const jack_client_t *, const jack_port_t *port) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_connected (const jack_port_t *port) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_connected_to (const jack_port_t *port, const char *port_name) JACK_OPTIONAL_WEAK_EXPORT |
const char ** | jack_port_get_connections (const jack_port_t *port) JACK_OPTIONAL_WEAK_EXPORT |
const char ** | jack_port_get_all_connections (const jack_client_t *client, const jack_port_t *port) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_tie (jack_port_t *src, jack_port_t *dst) JACK_OPTIONAL_WEAK_DEPRECATED_EXPORT |
int | jack_port_untie (jack_port_t *port) JACK_OPTIONAL_WEAK_DEPRECATED_EXPORT |
jack_nframes_t | jack_port_get_latency (jack_port_t *port) JACK_OPTIONAL_WEAK_EXPORT |
jack_nframes_t | jack_port_get_total_latency (jack_client_t *, jack_port_t *port) JACK_OPTIONAL_WEAK_EXPORT |
void | jack_port_set_latency (jack_port_t *, jack_nframes_t) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_recompute_total_latency (jack_client_t *, jack_port_t *port) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_recompute_total_latencies (jack_client_t *) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_set_name (jack_port_t *port, const char *port_name) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_set_alias (jack_port_t *port, const char *alias) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_unset_alias (jack_port_t *port, const char *alias) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_get_aliases (const jack_port_t *port, char *const aliases[2]) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_request_monitor (jack_port_t *port, int onoff) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_request_monitor_by_name (jack_client_t *client, const char *port_name, int onoff) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_ensure_monitor (jack_port_t *port, int onoff) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_monitoring_input (jack_port_t *port) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_connect (jack_client_t *, const char *source_port, const char *destination_port) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_disconnect (jack_client_t *, const char *source_port, const char *destination_port) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_disconnect (jack_client_t *, jack_port_t *) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_name_size (void) JACK_OPTIONAL_WEAK_EXPORT |
int | jack_port_type_size (void) JACK_OPTIONAL_WEAK_EXPORT |
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.
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, currently only JACK_DEFAULT_AUDIO_TYPE.
client | pointer to JACK client structure. |
port_name | non-empty short name for the new port (not including the leading "client_name:"). |
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. |
Definition at line 1034 of file JackAPI.cpp.
int jack_port_unregister | ( | jack_client_t * | , |
jack_port_t * | |||
) |
Remove the port from the client, disconnecting any existing connections.
Definition at line 1051 of file JackAPI.cpp.
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.
FOR OUTPUT PORTS ONLY : DEPRECATED in Jack 2.0 !! --------------------------------------------------- You may cache the value returned, but only between calls to your "blocksize" callback. For this reason alone, you should either never cache the return value or ensure you have a "blocksize" callback and be sure to invalidate the cached address from there.
Caching output ports is DEPRECATED in Jack 2.0, due to some new optimization (like "pipelining"). Port buffers have to be retrieved in each callback for proper functionning.
Definition at line 315 of file JackAPI.cpp.
const char* jack_port_name | ( | const jack_port_t * | port | ) |
Definition at line 331 of file JackAPI.cpp.
const char* jack_port_short_name | ( | const jack_port_t * | port | ) |
Definition at line 347 of file JackAPI.cpp.
int jack_port_flags | ( | const jack_port_t * | port | ) |
Definition at line 363 of file JackAPI.cpp.
const char* jack_port_type | ( | const jack_port_t * | port | ) |
Definition at line 379 of file JackAPI.cpp.
jack_port_type_id_t jack_port_type_id | ( | const jack_port_t * | port | ) |
Definition at line 395 of file JackAPI.cpp.
int jack_port_is_mine | ( | const jack_client_t * | , |
const jack_port_t * | port | ||
) |
Definition at line 1070 of file JackAPI.cpp.
int jack_port_connected | ( | const jack_port_t * | port | ) |
Definition at line 411 of file JackAPI.cpp.
int jack_port_connected_to | ( | const jack_port_t * | port, |
const char * | port_name | ||
) |
Definition at line 428 of file JackAPI.cpp.
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. |
Definition at line 1089 of file JackAPI.cpp.
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.
Definition at line 1107 of file JackAPI.cpp.
int jack_port_tie | ( | jack_port_t * | src, |
jack_port_t * | dst | ||
) |
Definition at line 454 of file JackAPI.cpp.
int jack_port_untie | ( | jack_port_t * | port | ) |
Definition at line 480 of file JackAPI.cpp.
jack_nframes_t jack_port_get_latency | ( | jack_port_t * | port | ) |
Definition at line 496 of file JackAPI.cpp.
jack_nframes_t jack_port_get_total_latency | ( | jack_client_t * | , |
jack_port_t * | port | ||
) |
The maximum of the sum of the latencies in every connection path that can be drawn between the port and other ports with the JackPortIsTerminal flag set.
Definition at line 1130 of file JackAPI.cpp.
void jack_port_set_latency | ( | jack_port_t * | , |
jack_nframes_t | |||
) |
The port latency is zero by default. Clients that control physical hardware with non-zero latency should call this to set the latency to its correct value. Note that the value should include any systemic latency present "outside" the physical hardware controlled by the client. For example, for a client controlling a digital audio interface connected to an external digital converter, the latency setting should include both buffering by the audio interface *and* the converter.
Definition at line 513 of file JackAPI.cpp.
int jack_recompute_total_latency | ( | jack_client_t * | , |
jack_port_t * | port | ||
) |
Request a complete recomputation of a port's total latency. This can be called by a client that has just changed the internal latency of its port using jack_port_set_latency and wants to ensure that all signal pathways in the graph are updated with respect to the values that will be returned by jack_port_get_total_latency.
Definition at line 529 of file JackAPI.cpp.
int jack_recompute_total_latencies | ( | jack_client_t * | ) |
Request a complete recomputation of all port latencies. This can be called by a client that has just changed the internal latency of its port using jack_port_set_latency and wants to ensure that all signal pathways in the graph are updated with respect to the values that will be returned by jack_port_get_total_latency. It allows a client to change multiple port latencies without triggering a recompute for each change.
Definition at line 551 of file JackAPI.cpp.
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.
Definition at line 572 of file JackAPI.cpp.
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.
Definition at line 598 of file JackAPI.cpp.
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.
Definition at line 617 of file JackAPI.cpp.
int jack_port_get_aliases | ( | const jack_port_t * | port, |
char *const | aliases[2] | ||
) |
Get any aliases known for .
Definition at line 636 of file JackAPI.cpp.
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.
Definition at line 652 of file JackAPI.cpp.
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.
Definition at line 668 of file JackAPI.cpp.
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.
Definition at line 691 of file JackAPI.cpp.
int jack_port_monitoring_input | ( | jack_port_t * | port | ) |
Definition at line 707 of file JackAPI.cpp.
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.
Definition at line 1158 of file JackAPI.cpp.
int jack_disconnect | ( | jack_client_t * | , |
const char * | source_port, | ||
const char * | destination_port | ||
) |
Remove a connection between two ports.
Definition at line 1175 of file JackAPI.cpp.
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().
Definition at line 1192 of file JackAPI.cpp.
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.
Definition at line 1432 of file JackAPI.cpp.
int jack_port_type_size | ( | void | ) |
Definition at line 1437 of file JackAPI.cpp.