de.humatic.dsj.src
Class MJPGNetworkSource

java.lang.Object
  de.humatic.dsj.src.Source
      de.humatic.dsj.src.NetworkSource
          de.humatic.dsj.src.MJPGNetworkSource

public class MJPGNetworkSource
extends NetworkSource

MJPGNetworkSource reads streams from IP Cameras operating with MotionJPG Compression.

Field Summary

static int

JPG_QUALITY Source parameter

Fields inherited from class de.humatic.dsj.src.NetworkSource

BUFFER_OVERFLOW, CONNECTION_TIMEOUT, FASTSTART, H264_FASTSTART, H264_FORCE_INLINE_SPS, H264_OMMIT_SPS, H264_PASS_INLINE_SPS, IDLE_TIMEOUT, KF_NOTIFY, LIVE_SRC, MAX_BUFFER_TIME, MAX_DURATION, MAX_FRAME_TIME, NO_USER_PROMPT, READ_USER_DATA, RECEIVE_TIMEOUT, RTCP_RECEIVE_ERROR, SEEK_FAILURE, SOCKET_ERROR, STARVING, UDP_UNCONNECTED

Fields inherited from class de.humatic.dsj.src.Source

ASYNC, AUTO_GC, DIRECT, ES, FILTER_SETUP_ERROR, FLV, HTTP, HTTP_AUDIO, JAS, MJPG, MKV, MP4, PSNET, PULL, PUSH, RAW, RTMP, RTP, RTSP, SHOUTCAST, SS_CLOSED, SS_CONNECT, SS_CONNECTED, SS_DONE, SS_EOS, SS_FORMAT_READ, SS_RUNNING, SS_SEEKING, SS_SETUP, SS_STREAMS_READ, SS_TCP_ROLLOVER, TIMEOUT, TSFILE, TSNET, UNKNOWN

Constructor Summary

MJPGNetworkSource(java.lang.String path, java.beans.PropertyChangeListener listener)
Anonymously connects to the stream at the given address.

MJPGNetworkSource(java.lang.String path, java.lang.String userName, java.lang.String password, int flags, java.beans.PropertyChangeListener listener)
Connects to the stream at the given address using the supplied authorization.

MJPGNetworkSource(java.lang.String path, java.lang.String userName, java.lang.String password, java.beans.PropertyChangeListener listener)
Connects to the stream at the given address using the supplied authorization.

Method Summary

void	closeSource(boolean terminate) Closes down the source.
DSGraph	createGraph(int graphFlags) Creates a DSGraph object with CompressedJavaSource filters that are fed from this source.
DSGraph	createGraph(int graphFlags, DSFilterInfo videoDecoder, DSFilterInfo audioDecoder) Creates a DSGraph object with CompressedJavaSource filters, fed from this source and the given video and audio decoders.
DSMediaType[]	getMediaTypes() Returns the media types created by this source.
int	queryParameter_int(int parameter)
static void	setExpectedJPGQuality(int q) Sets a static variable denoting the compression grade of jpeg images to be expected.

Methods inherited from class de.humatic.dsj.src.NetworkSource

configurePasswordDialog, getDefaultInterfaceAddress, getPasswordDialogOptions, getServerInfo, getTimeConstraint, setConnectionTimeout, setHTTPConnector, setNetworkInterface, setSocketFactory, setTimeConstraint, setUserAgent

Methods inherited from class de.humatic.dsj.src.Source

addSourceFilter, asyncRead, canSeek, createSourceFilter_async, createSourceFilter, getAvailable, getBuffered, getGraph, getID, getMaxTimeLoaded, getMinBufferTime, getNumChannels, getOffsetTime, getPath, getSourceDuration, getSourceFilter, getSourceFilters, getSourceFlags, getSourceTime, getTransport, getType, isLive, notifyChannelFailure, read, sendEvent, setOffsetTime, setSourceRate, setSourceTime, streamSeek, syncRead

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

JPG_QUALITY

public static final int JPG_QUALITY

Source parameter

See Also:

Constant Field Values

Constructor Detail

MJPGNetworkSource

public MJPGNetworkSource(java.lang.String path,
                         java.beans.PropertyChangeListener listener)
                  throws java.lang.Exception

Anonymously connects to the stream at the given address. Credentials can be given with the url, either as a query string (rtsp://...?username=xyz&password=abc) or in VLC style (http://username:password@IP:port...).

Throws:

java.lang.Exception

MJPGNetworkSource

public MJPGNetworkSource(java.lang.String path,
                         java.lang.String userName,
                         java.lang.String password,
                         java.beans.PropertyChangeListener listener)
                  throws java.lang.Exception

Connects to the stream at the given address using the supplied authorization. Credentials may also be given with the url, either as a query string (rtsp://...?username=xyz&password=abc) or in VLC style (http://username:password@IP:port...).

Throws:

java.lang.Exception

MJPGNetworkSource

public MJPGNetworkSource(java.lang.String path,
                         java.lang.String userName,
                         java.lang.String password,
                         int flags,
                         java.beans.PropertyChangeListener listener)
                  throws java.lang.Exception

Connects to the stream at the given address using the supplied authorization. Credentials may also be given with the url, either as a query string (rtsp://...?username=xyz&password=abc) or in VLC style (http://username:password@IP:port...). Valid fields for the flags parameter include:
NetworkSource.READ_USER_DATA - request notification on user data in jpeg comments through PropertyChangeEvents of type DSFiltergraph.SOURCE_USER_DATA. Data will be passed as byte[][] in the oldValue field.
NetworkSource.NO_USER_PROMPT - throw an exception rather then bringing up password dialogs on protected streams.

Throws:

java.lang.Exception

Method Detail

closeSource

public void closeSource(boolean terminate)

Description copied from class: Source

Closes down the source. When %terminate is true, all socket and stream resources etc. will also be freed. This method is called internally when disposing off the graph that was using this source and is not normally used by application code.

Overrides:

closeSource in class Source

createGraph

public DSGraph createGraph(int graphFlags)

Description copied from class: Source

Creates a DSGraph object with CompressedJavaSource filters that are fed from this source.

Overrides:

createGraph in class Source

createGraph

public DSGraph createGraph(int graphFlags,
                           DSFilterInfo videoDecoder,
                           DSFilterInfo audioDecoder)

Description copied from class: Source

Creates a DSGraph object with CompressedJavaSource filters, fed from this source and the given video and audio decoders. This is for special use cases where you know exactly what media formats to expect. Any decoder you do not want to specify may be null or DSFilterInfo.doNotRender(). Failure to put a given decoder into the graph will be announced via GRAPH_ERROR events and dsj will try to automatically pick an alternative (no exception will be thrown!).

Overrides:

createGraph in class Source

getMediaTypes

public DSMediaType[] getMediaTypes()

Description copied from class: Source

Returns the media types created by this source. Depending on the time of calling, this method needs to be taken with care as during format negotiation mediatype information may not yet or only be partially available.

Overrides:

getMediaTypes in class Source

setExpectedJPGQuality

public static void setExpectedJPGQuality(int q)

Sets a static variable denoting the compression grade of jpeg images to be expected. This affects the memory allocated by all instances of this class constructed after the parameter has been changed. Default is 100%. Note that this has no effect on decoding quality, it merely governs memory allocation and may be used to reduce RAM usage.

queryParameter_int

public int queryParameter_int(int parameter)

Overrides:

queryParameter_int in class Source