Overview 4

What's new in this version 4

Features 4

Download 5

License 5

Limitations of the evaluation version 5

Filter install/Uninstall 6

A. installing the filter with the self installer (DatasteadRTSPFilterInstall.exe) (simplest and fastest) 6

* to install the package automatically from the command line: 6

* to uninstall the package automatically from the command line: 6

* to install the package manually: 6

* to uninstall the package manually: 6

B. installing the filter manually 6

Demo projects 8

Using the filter through the TVideoGrabber SDK 8

Building the DirectShow graph 8

Microsoft DirectShow SDK (C++) 8

C# with DirectShow .NET 8

ONVIF: RTSP streams 9

RTSP stream of the first Onvif media profile (default) 9

RTSP stream selected by the index of the Onvif media profile 9

RTSP stream selected by the name of the Onvif media profile 9

RTSP, RTMP, HTTP, TCP, UDP, MSSH and other protocols 9

Configuring the filter through the URL 9

ONVIF: JPEG snapshot 10

Backtimed recording (pre-roll recording) 11

Quick start from the TVideoGrabber SDK 11

Preview or an ONVIF camera: 11

Recording of an ONVIF camera, without preview (saves CPU): 11

Preview or an RTSP URL: 12

Preview + audio rendering: 12

Preview + MP4 recording (video only): 12

Preview + audio rendering + MP4 audio/video recording: 12

Generating a new file name on the fly: 12

Pausing/resuming the recording: 13

Quick start from GraphEdit.exe 13

Auto reconnection 13

Auto reconnection disabled 13

Auto reconnection enabled 14

About RTSP transport, HTTP and latency 14

RTSP TRANSPORT MODE 14

HTTP URLs in JPEG, MJPEG or MXPEG mode 15

LOW DELAY 15

LATENCY 16

FILTER CONFIGURATION 16

A. setting the parameters programmatically 16

B. specifying the settings as parameters at the end of the URL 16

DirectShow configuration 17

Overview 17

Building and starting the DirectShow graph synchronously (the function blocks until the connection completes): 17

Building and starting the DirectShow graph asynchronously without blocking the main thread: 17

Filter CLSID 18

Passing settings to the filter 19

Filter configuration through IFileSourceFilter 20

Filter configuration through IDatasteadRtspSourceConfig 21

Overview 21

Usage 21

Remarks 22

a) the parameter identifier name reminds the the corresponding Get.../Set... function to invoke 22

b) string returned by GetStr() 22

Actions that can be applied once the graph is running 22

Generating a new recording file on the fly 22

Pausing the URL 23

Resuming the URL 23

Examples of processings applied to the video stream 24

Vertical flipping 24

Horizontal flipping 24

Video rotation 24

Hue / saturation 24

Negative video 25

Draw a box or a grid 25

Unsharp 25

Combining several processings 25

URL re-streaming 27

Text Overlays 28

Brightness / Hue / Saturation 29

Parameter identifiers 30

TROUBLESHOOTING 38

Sometimes the image jumps or some artifact appear in the middle of the image 38

When starting the preview the video appears very pixelated, or the bottom of the frame seems blurred 38

The video freezes periodically 38

The MP4 recorded file is truncated 39

The RTSP URL fails to connect 39

The filter fails to connect to the VMR9 (Video Mixing Renderer 9) 39

FAQ 40

LICENSING 40

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

INSTALL 40

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? 40

LIMITATIONS OF THE EVALUATION VERSION 40

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

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. 41

FILTER USAGE 41

How to get the minimum latency 41

How can reduce the CPU load? 41

How can I minimize the latency? 41

How can I specify the RTSP transport mode? 41

Does the filter support UDP transport streams? 42

Can I decode only key frames? 42

SPECIFIC STREAMING DEVICES 42

Can I capture the video from an Ardrone? 42

Is the HD HomeRun supported? 42

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

43