jit.qt.broadcast Broadcast video using RTSP (Macintosh only)

The jit.qt.broadcast object is an RTSP server. It takes a 4 char matrix as input, compresses the data and streams it over a network (local or internet) using the RTSP streaming standard.

WINDOWS USERS: This object is currently unsupported.

Matrix Operator: in[1] out[1]
Name IOProc Planelink Typelink Dimlink Plane Dim Type
in n/a n/a n/a n/a n/a n/a n/a
out n/a yes yes yes 4 all char

Attributes:
Name Type Description
acodec symbol The audio codec for streaming (default = qdesign2)
The available codec types are none, raw, big16, little16, float32, float64, 24bit, 32bit, little32, mace3, mace6, cdxa4, cdxa2, ima, ulaw, alaw, adpcm, dviima, dvaudio, qdesign, qdesign2, qualcomm, mp3, vdva, mpeg4.
aenable int Audio enable flag (default = 0)
This flag is only active in mode 2 (Sequence Grabber source mode) and determines whether sound will be streamed, as well as image.
aip symbol Audio IP address (default = variable)
In multicast mode (the default. See unicast, below), this IP address is automatically assigned, and read-only, and refers to the special multicast address client computers access to reach your broadcast.
In unicast mode, this IP address should be set to the IP address of the single client computer.
aport int Audio broadcast port number (default = 8556)
The network port to be used by the audio portion of the broadcast stream.
bitrate int Audio bitrate (default = 16)
16 = 16-bit audio
8 = 8-bit audio
channels int Audio channel selection (default = 2)
1 = mono audio
2 = stereo audio
codec symbol The video codec for streaming (default = h263)
The available codec types are raw, cinepak, graphics, animation, video, componentvideo, jpeg, mjpega, mjpegb, sgi, planarrgb, macpaint, gif, photocd, qdgx, avrjpeg, opendmljpeg, bmp, winraw, vector, qd, h261, h263, dvntsc, dvpal, dvprontsc, dvpropal, flc, targa, png, tiff, componentvideosigned, componentvideounsigned, cmyk, microsoft, sorenson, indeo4, argb64, rgb48, alphagrey32, grey16, mpegyuv420, yuv420, sorensonyuv9 and mpeg4.
dstrect int list[4] The rectangular portion of the streaming image to be drawn to, when an incoming matrix is received. (default = 0 0 (image width) (image height))
The proportions of the rectangle are expressed in the form left top right bottom. All values are relative to the top left corner of the viewing area of the streamed image.
interp int Interpolation flag (default = 0)
ip symbol Video IP address (default = variable)
In multicast mode (the default. See unicast, below), this IP address is automatically assigned, and read-only, and refers to the special multicast address client computers access to reach your broadcast.
In unicast mode, this IP address should be set to the IP address of the single client computer.
kframe int Keyframe rate (default = 50)
If set, the jit.qt.broadcast object will attempt to configure the video compressor to use the specified keyframe rate. Keyframes (temporal compression) are not available to all codecs.
mode int Streaming source mode (default = 0)
0 = matrix input
1 = Hinted Movie input (uses the movie attribute to choose a pre-hinted source movie)
2 = Sequence Grabber input (uses an attached camera as the streaming source)
Modes 1 and 2 permit audio streaming, as well.
movie symbol Source movie for mode 1 (default = "")
If no movie is specified when setting this attribute, a File dialog will be presented. Movies must be hinted, to be used with the jit.qt.broadcast object. See Tutorial 51: Broadcasting for more information.
preview int Matrix preview flag (default = 0)
If set, an incoming matrix will be copied to the object’s output matrix (with srcrect, interp or dstrect transformations) when the jit.qt.broadcast object is streaming. Otherwise, the matrix is simply passed through the object. Only functional in mode 0.
samplerate int Audio sample rate (default = 8000)
48000 = 48kHz
44100 = 44.1kHz
32000 = 32kHz
22050 = 22.050kHz
22254 = 22kHz
16000 = 16kHz
11127 = 11kHz
11025 = 11.025kHz
8000 = 8000 Hz
size int list[2] The dimensions of the broadcast (default = 160 120)
spatialquality int Codec spatial compression quality (default = 2 (normal))
0 = minimum
1 = low
2 = normal
3 = high
4 = maximum
5 = lossless
srcrect int list[4] The rectangular section of the incoming matrix to compress and stream (default = 0 0 (movie width) (movie height))
temporalquality int Codec temporal compression quality (default = 2 (normal))
0 = minimum
1 = low
2 = normal
3 = high
4 = maximum
5 = lossless
ttl int Packet time to live (default = 255)
unicast int Unicast broadcast flag (default = 0)
If set, the jit.qt.broadcast object will broadcast in unicast mode. In this mode, the vip (and aip, if used) refer to a single client computer, which will be able to receive your broadcast. In multicast mode (the default), as many clients as your system’s bandwidth can support will be able to access the stream.
usedstrect int Destination rect flag (default = 0)
When the flag is set, the dstrect attributes are used when compressing an input matrix for streaming.
usesrcrect int Source rect flag (default = 0)
When the flag is set, the srcrect attributes are used when compressing an input matrix for streaming. The proportions of the rectangle are expressed in the form left top right bottom. All values are relative to the top left corner of the viewing area of the incoming matrix.
vcodec symbol The video codec for streaming (default = h263)
Synonym for codec, above.
venable int Video enable flag (default = 1)
This flag is currently ignored.
vip symbol Video IP address (default = variable)
Synonym for ip, above.
vport int Video broadcast port number (default = 8554)
The network port to be used by the video portion of the broadcast stream.

Messages:
pause
Pauses a running broadcast server. No effect if the server is idle.

start
Starts the broadcast server.

stop
Stops the broadcast server.

write { [filename (int)] }
Writes an SDP (session description protocol) file to disk. This file describes the streaming parameters in a form suitable for distribution to clients. Every time a broadcast parameter is modified (vcodec, for instance), a new SDP file must be written, or clients will have trouble connecting to the broadcast stream.
In the absence of a filename argument, a Save dialog will be presented.

Example:

See Also:
jit.net.recv, jit.net.send, jit.broadcast