Unigraf UFG-10 series Programming Manual

UFG-10 Family

Frame Grabbers

Easy

Programming

Guide

Windows

Introduction

Copyright

This manual, Copyright © 2014 Unigraf Oy. All rights reserved
Reproduction of this manual in whole or in part without written permission of

Unigraf Oy is prohibited.

Notice

The information given in this manual is verified in the correctness on the date of issue. The authors
reserve the rights to make any changes to this product and to revise the information about the products
contained in this manual without an obligation to notify any persons about such revisions or changes.

Edition

UFG-10 Easy Programming Guide, Rev 1.1.0.129.8
Document identifier:
Date: 02 October 2014

Trademarks

Unigraf and UFG are trademarks of Unigraf Oy.
Windows® 8, Windows® 7 and Windows® XP are trademarks of

Microsoft Inc.
All other trademarks are properties of their respective owners.

Company information

Unigraf Oy
Piispantilankuja 4

FI-02240 ESPOO
Finland

[e-mail]

http://www.unigraf.fi

Introduction

Table of Contents

1. Introduction ............................................................................................................................................... 4

Overview ................................................................................................................................................ 4

Setting DLL File .................................................................................................................................... 4

2. Initialize Device APIs ............................................................................................................................... 4

3. Uninitialize Device APIs ........................................................................................................................... 4

4. Start Channel Record APIs ........................................................................................................................ 5

5. Stop Channel Record APIs ........................................................................................................................ 5

6. Start Share Record APIs ............................................................................................................................ 5

7. Set Share Record Data APIs ................................................................................................ ...................... 5

8. Stop Share Record APIs ............................................................................................................................ 6

9. Start Broadcast APIs ................................................................................................................................. 8

10. Set Broadcast Data APIs ............................................................................................................................ 8

11. Stop Broadcast APIs .................................................................................................................................. 8

12. Broadcast with Multi-Threading ................................................................................................................ 9

13. Custom Property for UFG-10 .................................................................................................................. 11

Introduction

1. INTRODUCTION

Overview

This document will provide step-by-step quidance of the use of basic UFG-10 QCAP SDK functions
needed to control and capture video using the UFG-10 models without on-board hardware compression
in Windows operating system. Please refer to UFG-10 MC Easy Programming Guide for use of the
UFG-10 MC model with hardware compression and UFG-10 Linux Software Programming Guide for
the use of the non compression models in Linux operating system.

Setting DLL File

VC
X86

QCAP.DLL, AMESDK.DLL

X64

QCAP.X64.DLL, AMESDK.X64.DLL

Note Please make sure that QCAP.DLL and AMESDK.DLL are included in the same directory with

executable (*.exe) file.

2. INITIALIZE DEVICE APIS

QCAP_SET_SYSTEM_CONFIGURATION( … ); QCAP_CREATE( "SA7160 PCI", 0, … );

QCAP_REGISTER_FORMAT_CHANGED_CALLBACK( pDevice, on_format_changed_callback, … );

QCAP_REGISTER_NO_SIGNAL_DETECTED_CALLBACK( m_pDevice, on_no_signal_detected_callback,);

QCAP_REGISTER_SIGNAL_REMOVED_CALLBACK( m_pDevice, on_no_signal_removed_callback, … );

QCAP_REGISTER_VIDEO_PREVIEW_CALLBACK( m_pDevice, on_video_preview_callback, … );

QCAP_REGISTER_AUDIO_PREVIEW_CALLBACK( m_pDevice, on_audio_preview_callback, … );

QCAP_SET_VIDEO_DEINTERLACE_TYPE( m_pDevice, QCAP_SOFTWARE_DEINTERLACE_TYPE_BLENDING );

QCAP_SET_VIDEO_DEINTERLACE( m_pDevice, TRUE );

QCAP_SET_VIDEO_INPUT( m_pDevice, QCAP_INPUT_TYPE_AUTO );

QCAP_SET_AUDIO_INPUT( m_pDevice, QCAP_INPUT_TYPE_EMBEDDED_AUDIO );

QCAP_SET_AUDIO_VOLUME( m_pDevice, 100 );

QCAP_RUN( m_pDevice );

3. UNINITIALIZE DEVICE APIS

QCAP_STOP( m_pDevice );

QCAP_DESTROY( m_pDevice );