VideoInputFrameRequest

From TrillWiki

The videoInputFrameRequest retrieves a single frame from an input stream, in the format requested back at videoInputInitialize.

Compatibility: 3.0 and higher

Contents 1 Syntax 2 Parameters 3 Return Value 4 Remarks

Syntax

plugin_send(MYGUID,"videoInputFrameRequest",video_t *);

Note that all Trillian functions and notifications begin with a lower-case letter, despite the Wiki requirement that all pages start with a capital letter.

Parameters

VideoInputFrameRequest utilitizes the video_t structure.

struct video_t 
{ 
    unsigned int                struct_size; 

    int                         connection_id;
    int                         window_id;

    char                        *medium;
    char                        *name;
    char                        *location;

    char                        *section;

    int                         initiated;
    int                         ask_confirmation;

    /* Video Information
     */

    int                         codec; 

    int                         video_width; 
    int                         video_height; 
    int                         video_depth;
    int                         video_quality;
    int                         video_fps;

    int                         video_data_length; 

    unsigned char               *video_data; 

    ttkCallback                 callback; 
    void                        *data; 
};

medium

The medium this audio stream is being hosted over.

connection_id

The connection with which this is associated.

name

The contact with which this chat is associated.

location

You may set this to 'broadcast' (instead of providing a contact name) in order to deal with things like a webcam broadcast (a'la Yahoo).

window_id

Optionally, the window ID with which this chat is associated. (If provided, you don't need the above things for looking it up.)

video_data

This field will be filled out by Trillian with the raw data of the frame requested.

video_data_length

This field will be filled out by Trillian with the length of the raw data in video_data.

Return Value

This function returns 0 on success, or a negative value on error.

Remarks

This is used primarily for broadcast situations like the Yahoo webcam.