Sensoray 2246 Manual de usuario

2246Software Development KitVersion 1.7.6 Sensoray 20137313 SW Tech Center Dr.Tigard, OR 97223Phone 503.684.8005 • Fax [email protected]

s2246param.inis2246param.ini in the windows directory (%WINDIR%) contains the codec specifications for decoding MPEG streams.The [General] section con

mid2246 Data Structure Documentationimage_raw_t Struct Reference#include <mid2246func.h>Public Attributes• BYTE * f0• int size0• BYTE * f1• int

MIDSRAYSTATUS Struct Reference#include <mid2246func.h>Public Attributes• ULONG iFilesize• char szFilepath [MAX_PATH]• BOOL bIsRecording• BOOL bI

MIDSRAYSTATUS_UNICODE Struct Reference#include <mid2246func.h>Public Attributes• ULONG iFilesize• WCHAR szFilepath [MAX_PATH]• BOOL bIsRecording

MPEG_CONFIG Struct Reference#include <mid2246const.h>Public Attributes• int mpeg• int bitrate• int vbr• int max_vbr_bitrate• int framerateDetail

overlay_text_t Struct Reference#include <mid2246func.h>Public Attributes• char text [256]• char fontfile [256]• int fontsize• int txtcolor• int

File Documentationmid2246const.h File ReferenceClasses• struct MPEG_CONFIGDefines• #define MAX_DEVICES 30• #define MAX_TEXTSIZE 256Error constantsDe

• #define MID2246_SNAP_ERR_DVBUF -7• #define MID2246_SNAP_ERR_DVGRAB -8• #define MID2246_SNAP_ERR_USERERR -9Frame rate Constants. Note: for PAL, on

Revision moniker for SDK backward capabilityDefines• #define MID2246_BOARD_A 1• #define MID2246_BOARD_H 2• #define MID2246_BOARD_K 3Enumerations• e

Define Documentation#define MAX_DEVICES 30#define MAX_TEXTSIZE 256#define MID2246_SUCCESS 0#define MID2246_ERR_NONE 0#define MID2246_ERR_UNSPECIFI

Table of ContentsTable of Contents

#define MID2246_LEVEL_SATURATION_CR 4#define MID2246_LEVEL_SATURATION_CB 8#define MID2246_FILE_JPEG 1#define MID2246_FILE_BMP 2#define MID2246_FIL

Enumerator: MID2246_SOURCE_COMPOSITE_0 MID2246_SOURCE_COMPOSITE_1 MID2246_SOURCE_SVIDEO_0 MID2246_SOURCE_SVIDEO_1 MID2246_SOURCE_DV MID2246_SOURC

enum MID2246_DVIRESDVI output resolution These correspond to the [RESx] lines in \windows\dviparam.ini where x is called out by the MID2246_DVIRES_xxx

MID2246_RC_RECTIME MID2246_RC_MANUALSTOP MID2246_RC_RECCLIPSIZE MID2246_RC_RECCLIPSIZEANDSTOP 23

mid2246func.h File Reference#include "windows.h"#include "mid2246const.h"Data Structures• struct MIDSRAYSTATUS• struct MIDSRAYSTAT

• MID2246_API int SN_IsValidVid (MID2246_SOURCE checksource, int board)• MID2246_API int SN_IsValidSdi (MID2246_SOURCE checksource, int board)• MID224

• MID2246_API int SN_SnapshotToFile (char *szFilename, int filetype, int freezetime, int wait, int qual, int CustMergeSize, int board)• MID2246_API in

#define MID2246_MERGEAPI int#define MAX_PATH 260#define MID2246_MAX_TEXT 256Overlay text structure Parameters:text pointer to text fontfile full

MID2246_API int SN_GetVersion (char ** sMid2246Version, char ** sFPGA2246Version, int * pBoardId, int board)Get middleware version number and FPGA ver

Parameters:xpos x position of video ypos y position of video xsize size of video display ysize size of video display left_clip number of pixels at lef

Defines

MID2246_API int SN_SetDvi (MID2246_DVIRES res, BOOL bColorBars, int DviCropLeft, int DviCropTop, int DviCropRight, int DviCropBottom, int board)Set th

Parameters:param is the parameter to change ( MID2246_LEVEL_CONTRAST, MID2246_LEVEL_BRIGHTNESS, MID2246_LEVEL_SATURATION, MID2246_LEVEL_HUE) value is

MID2246_API int SN_IsValidVid (MID2246_SOURCE checksource, int board)Check to see if there are any valid Composite or S-Video inputs. Note: This funct

Parameters:board ID if multiple boards installed. Returns:TRUE(1) if video locked else FALSE(0) MID2246_API int SN_GetVidStatusNoBIST (int board)GetVi

Parameters:board ID if multiple boards installed. Returns:0 on success MID2246_API int SN_StopStream (int board = 0)Stops video/audio stream and stops

breakonrecsize flag indicating whether to, 1=end recording when filesize reaches size, or 0=continue recording to new file. board ID if multiple board

MID2246_API int SN_PauseRecord (int board = 0)Pause recording. Parameters:board ID if multiple boards installed. Returns:HRESULT = S_OK on success MID

MID2246_API int SN_GetRecordVideoStream (BOOL * bRecVid, int board = 0)Gets the video recording settingParameters:bRecVid pointer to record video sett

MID2246_API int SN_SetRenderVideo (BOOL bDisplayVideo, int board = 0)SetRenderVideo allows one to turn off the video window but still stream the video

Function Documentation - Playback functionsMID2246_API int SN_PlaybackVideo (char * filename_plus_path, int board = 0)Plays back the specified video c

#define MID2246_REGION_MPEG 2 ...

In addition, the call back function must call IMediaEventEx->FreeEventParams(...) each time it accesses the event via IMediaEventEx->GetEvent(..

Returns:0 on success MID2246_API int SN_DisplaySnapshotW (LPWSTR filename, int time, int board = 0)Unicode version of SN_DisplaySnapshot() Displays th

Function Documentation - Image capture functionsMID2246_API int SN_SetMergeMethod (MID2246_FIELDALG merge_method, mergefunc_t * custom_alg, int board)

Returns:number of bytes read (image size) or MID2246_SNAP_ERR_UNSPECIFIED -1 MID2246_SNAP_ERR_BUFSIZE -2 'Size' of buffer provided is too sm

MID2246_SNAP_ERR_CRITSEC -5 Aquisition's critical section already locked, and user doesn't want to wait for it. MID2246_SNAP_ERR_PARTBUF -6

regionmask -- region mask (MID2246_REGION_MONITOR, MID2246_REGION_MPEG, MID2246_REGION_STILL) board ID if multiple boards installed. Returns:0 on succ

MID2246_API int SN_OverlayQuad (int WinIndex, char * imageFile, int x1, int y1, int x2, int y2, int x3, int y3, int x4, int y4, int regionmask, int bo

Ypos -- start y position Value -- pointer to text or image file path board ID if multiple boards installed. Returns:0 on success MID2246_API int SN_Ov

Returns:0 on success MID2246_API int SN_ClearOverlay (int board)Clear all overlays Parameters:board ID if multiple boards installed. Returns:0 on succ

Parameters:states pointer to an integer that receives the value in the register driving the outputs. board ID if multiple boards installed. Returns:Sa

MID2246_API int SN_GetFrameSync (int * sync, int board) ...

Sample codeSee 2246demo codeSetting Custom Merge Method for interlace reconstructionFirst set the merge method:SN_SetMergeMethod( MID2246_FIELDALG_CUS

MID2246_API int SN_SetMergeMethod (MID2246_FIELDALG merge_method, mergefunc_t * custom_alg, int board)

Software Installation RequirementsMinimum processor: Pentium III 600 MHz. A Pentium IV 2 GHz or faster is recommended.Operating system: Windows 2000,

Building an application with the 2246SDKFiles included with the SDKThe following files are distributed with the 2246SDK:Drivers directory:2246 drivers

libplaylist_plugin.dlllibps_plugin.dlllibstream_out_duplicate_plugin.dlllibstream_out_es_plugin.dlllibstream_out_gather_plugin.dlllibstream_out_standa