Tutorial #5 – FreeFrame/FFGL Sending Configuration

In order to enable sending video from a FreeFrame or FFGL enabled application, we will need to define where we want the plugins to send it.

Requirements

It is expected that you will be comfortable downloading and installing applications, as well as downloading ZIP archives and copying files into your Windows system directories.

You will need to:

Running

As you have seen, there are many options involved in defining how and where the video should be sent.  By using the fugVidStreamTool we can group these options together into numbered configurations that can then be quickly accessed inside your FreeFrame/FFGL plugin host.

In this tutorial we will demonstrate how to set up and save two configurations, one for local sending, and the other for a networked machine.

Setting up a local stream

1. Run fugVidStreamTool on the computer where you want to send video from.

2. Set the following sender settings:

  • Config Entry: 0 (we’re creating configuration number zero)
  • Protocol: Local (Memory)
  • Channel: 0
  • Width: 0
  • Height: 0
  • Depth: 24-bit
  • FPS: 15 (doesn’t get saved)
  • Compression Type: None
  • Compression Level: Any (not used in this configuration)

3. Enable the local receiver with the following settings:

  • Protocol: Local (Memory)
  • Channel: 0

4. Click on the Send button

5. If you see the video being sent to the receiver we know the configuration is working

6. Turn off sending by clicking on the Send button again

7. Click on the Save button to set the configuration

Setting up a network stream

1. Now set the following sender settings:

  • Config Entry: 1 (we’re creating configuration number one)
  • Protocol: Remote (TCP)
  • Address: the IP address of the destination receiver
  • Channel: 0
  • Width: 0
  • Height: 0
  • Depth: 24-bit
  • FPS: 15 (doesn’t get saved)
  • Compression Type: JPEG
  • Compression Level: About 50%

2. Run fugVidStreamTool on the destination computer

3. Enable the local receiver with the following settings:

  • Protocol: Remote (TCP)
  • Channel: 0

4. On the source computer, click on the Send button

5. If you see the video being sent to the receiver we know the configuration is working

6. Turn off sending by clicking on the Send button again

7. Click on the Save button to set the configuration

Switching between configurations

Once the configurations have been saved, changing the “Config Entry” number on the source computer will load that configuration, where it can be edited and changes saved again.

FreeFrame/FFGL Video Sending

1. Install the FreeFrame/FFGL Video Sending plugin(s) to your source computer

2. Run your FreeFrame/FFGL host application and add the fugVidSnd2(GL) effect to your composition

3. In the plugin options, select the configuration (0 for local, 1 for network)

4. In the plugin options, enable sending