jpatchline

A patch cord. More...

Collaboration diagram for jpatchline:

Functions
t_max_err	jpatchline_get_startpoint (t_object *l, double *x, double *y)
	Retrieve a patchline's starting point. More...
t_max_err	jpatchline_get_endpoint (t_object *l, double *x, double *y)
	Retrieve a patchline's ending point. More...
long	jpatchline_get_nummidpoints (t_object *l)
	Determine the number of midpoints (segments) in a patchline. More...
t_object *	jpatchline_get_box1 (t_object *l)
	Return the object box from which a patchline originates. More...
long	jpatchline_get_outletnum (t_object *l)
	Return the outlet number of the originating object box from which a patchline begins. More...
t_object *	jpatchline_get_box2 (t_object *l)
	Return the destination object box for a patchline. More...
long	jpatchline_get_inletnum (t_object *l)
	Return the inlet number of the destination object box to which a patchline is connected. More...
t_object *	jpatchline_get_nextline (t_object *b)
	Given a patchline, traverse to the next patchline in the (linked) list. More...
char	jpatchline_get_hidden (t_object *l)
	Determine if a patch line is hidden. More...
t_max_err	jpatchline_set_hidden (t_object *l, char c)
	Set a patchline's visibility. More...
t_max_err	jpatchline_get_color (t_object *l, t_jrgba *prgba)
	Get the color of a patch line. More...
t_max_err	jpatchline_set_color (t_object *l, t_jrgba *prgba)
	Set the color of a patch line. More...

Detailed Description

A patch cord.

Function Documentation

jpatchline_get_box1()

t_object* jpatchline_get_box1

(

t_object *

l

)

Return the object box from which a patchline originates.

Parameters

l	A pointer to the patchline's instance.

Returns

The object box from which the patchline originates.

jpatchline_get_box2()

t_object* jpatchline_get_box2

(

t_object *

l

)

Return the destination object box for a patchline.

Parameters

l	A pointer to the patchline's instance.

Returns

The destination object box for a patchline.

jpatchline_get_color()

t_max_err jpatchline_get_color	(	t_object *	l,
		t_jrgba *	prgba
	)

Get the color of a patch line.

Parameters

l	A patchline instance.
prgba	The address of a valid t_jrgba struct that will be filled with the color values of the patch line.

Returns

An error code.

jpatchline_get_endpoint()

t_max_err jpatchline_get_endpoint	(	t_object *	l,
		double *	x,
		double *	y
	)

Retrieve a patchline's ending point.

Parameters

l	A pointer to the patchline's instance.
x	The address of a variable to hold the x-coordinate of the ending point's position upon return.
y	The address of a variable to hold the y-coordinate of the ending point's position upon return.

Returns

A Max error code.

jpatchline_get_hidden()

char jpatchline_get_hidden

(

t_object *

l

)

Determine if a patch line is hidden.

Parameters

l	A patchline instance.

Returns

Zero if the patchline is visible, non-zero if it is hidden.

jpatchline_get_inletnum()

long jpatchline_get_inletnum

(

t_object *

l

)

Return the inlet number of the destination object box to which a patchline is connected.

Parameters

l	A pointer to the patchline's instance.

Returns

The inlet number.

jpatchline_get_nextline()

t_object* jpatchline_get_nextline

(

t_object *

b

)

Given a patchline, traverse to the next patchline in the (linked) list.

Parameters

b	A patchline instance.

Returns

The next patchline. If the current patchline is at the end (tail) of the list, then NULL is returned.

jpatchline_get_nummidpoints()

long jpatchline_get_nummidpoints

(

t_object *

l

)

Determine the number of midpoints (segments) in a patchline.

Parameters

l	A pointer to the patchline's instance.

Returns

The number of midpoints in the patchline.

jpatchline_get_outletnum()

long jpatchline_get_outletnum

(

t_object *

l

)

Return the outlet number of the originating object box from which a patchline begins.

Parameters

l	A pointer to the patchline's instance.

Returns

The outlet number.

jpatchline_get_startpoint()

t_max_err jpatchline_get_startpoint	(	t_object *	l,
		double *	x,
		double *	y
	)

Retrieve a patchline's starting point.

Parameters

l	A pointer to the patchline's instance.
x	The address of a variable to hold the x-coordinate of the starting point's position upon return.
y	The address of a variable to hold the y-coordinate of the starting point's position upon return.

Returns

A Max error code.

jpatchline_set_color()

t_max_err jpatchline_set_color	(	t_object *	l,
		t_jrgba *	prgba
	)

Set the color of a patch line.

Parameters

l	A patchline instance.
prgba	The address of a valid t_jrgba struct containing the color to use.

Returns

An error code.

jpatchline_set_hidden()

t_max_err jpatchline_set_hidden	(	t_object *	l,
		char	c
	)

Set a patchline's visibility.

Parameters

l	A patchline instance.
c	Pass 0 to make a patchline visible, or non-zero to hide it.

Returns

An error code.