FAQ

LICENSING

Should I buy one license for each one of my clients?


No, it's a per-developer, royalty-free license. After purchasing the developer license you can distribute the filter along with your end-user application on as many PCs as needed, without having to pay anything else.

INSTALL

In the DatasteadRTSPSource.zip there are two folders, x64 and x86. Which one should I use when?
For example,Windows 7 32 bit, Windows 7 64 bit?

Note:; if the filter is used through our TvideoGrabber SDK, you can just copy the filter binaries (.dll and .ax) in your .EXE's application folder, in this case it is not necessary to register the filter or run the filter installer.



The simpler is to run the DatasteadRTSPFilter_Installer.exe from the command line, it installs automatically the x86 version on 32 bit PCs, and both the x86 and x64 versions on 64 bits PC.

You can install silently from the command line with:

DatasteadRTSPFilter_Licensed_Installer.exe /silent

or

DatasteadRTSPFilter_Licensed_Installer.exe /verysilent


The important point is to determine how the app is compiled: only as x86, or both x86 and x64:

1) if the app is compiled only as x86, or if you set "x86" as target platform in VS.NET, you just need to distribute the x86 filter, it will run without problem on both 32bit and 64bit OS.

2) if the app is compiled for both x86 and x64, or if "Any" is set as target platform in VS.NET, install:
- the x86 filter only on 32 bit PCs
- the x86 filter AND x64 filter only on 64 bit PCs

LIMITATIONS OF THE EVALUATION VERSION

When testing the filter under GraphEdit the graphs stops and reports an error 0x200

The timeout of the evaluation filter has occurred and has stopped the graph .This is a normal behavior of the evaluation version. This limitation is removed with the licensed version.

Our application creates periodically a new graph and re-load the filter, but after some time we can’t add the RTSP filter to the graph.

This is a limitation of the evaluation version of the filter. Once one of the filters used in the application has reached his evaluation timeout, no other new instance of the filter can be instantiated until the application is restarted.

FILTER USAGE

When doing a Ctrl+Alt+Del the video stops

This is a problem of the standard DirectShow renderers.
Render instead the video pin to our Datastead Video Renderer (CLSID C7CC1A23-8B8A-4BFD-A96C-B5E735E055BA), that in included in the filter package, this video renderer is compatible with the lock screen

How to get the minimum latency

1. Add >buffer=0>lowdelay=1 at the end of the RTSP URL, e.g.:

rtsp://192.168.0.25/axis-media/media.amp?videocodec=h264>buffer=0>lowdelay=1

2. Add >buffer=0>lowdelay=1>vidsync=0 at the end of the RTSP URL, e.g.:

rtsp://192.168.0.25/axis-media/media.amp?videocodec=h264>buffer=0>lowdelay=1>vidsync=0

Note: with vidsync=0 the video samples are rendered immediately

How can reduce the CPU load?

If the video display frame rate is not critical, it is possible to decode only the H264 key-frames to minimize the CPU consumption.
To enable the keyframe-only decoding, pass maxframerate=-1 as parameter, e.g.:


rtsp://239.192.1.1:59001>maxframerate=-1

How can I minimize the latency?

Specify a 0 buffering and enable the low delay mode:

- at the end of the RTSP URL

rtsp://192.168.0.25/axis-media/media.amp?videocodec=h264>buffer=0>lowdelay=1

- or programmatically:

DatasteadRtspSourceConfig.SetInt (RTSP_Source_BufferDuration_int, 0)

DatasteadRtspSourceConfig.SetInt (RTSP_Source_LowDelay_int, 1)

Note:

- the low delay mode can cause jerkiness problem with some video sources, in this case keep it disabled.

- if you notice periodical freezings with buffer=0, try slighly higher values, e.g. buffer=50 or buffer=100

How can I specify the RTSP transport mode?

The tranport mode can be specified in 2 ways:

A) At the end of the RTSP URL by adding >rtsp_transport=value as follows, e.g.:

tcp:

rtsp://admin:admin@192.168.0.33>rtsp_transport=tcp

udp:

rtsp://admin:admin@192.168.0.33>rtsp_transport=udp

http:

rtsp://admin:admin@192.168.0.33>rtsp_transport=http

multicast:

rtsp://admin:admin@192.168.0.33>rtsp_transport=udp_multicast



B) programmatically by invoking:

IDatasteadRtspSourceConfig.SetInt (RTSP_Source_RTSPTransport_int, Value).

The possible values are:

0: automatic (default, UDP is tried first)

1: tcp

2: udp

3: http

4: udp_multicast


Does the filter support UDP transport streams?

Yes, simply enter the UDP URL and port, unicast and multicast are supported, e.g.:

udp://localhost:1234

udp://239.255.0.10:10124

Can I decode only key frames?

Yes, to decode only H264 key-frames, pass maxframerate=-1 as parameter, e.g.:

rtsp://239.192.1.1:59001>maxframerate=-1



SPECIFIC STREAMING DEVICES

Can I capture the video from an Ardrone?

Yes, use the following URL, e.g.:

tcp://IPADDRESS:5555

Is the HD HomeRun supported?

Yes, it should work in UDP or RTP with URLs like e.g.:
udp://239.192.1.1:59001

rtp://234.5.6.7:59001

RTSP / HTTP URL to use for a given IP camera or IP streaming source

If you don't know the RTSP or HTTP URL for your IP camera, contact our support at support@datastead.com and specify your license ref# and the exact model of IP camera, we will be assist you to determine the URL syntaxes supported by your camera.

43