/* GStreamer * Copyright (C) <2005> Julien Moutte * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public * License along with this library; if not, write to the * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */ #ifndef __GST_XVIMAGESINK_H__ #define __GST_XVIMAGESINK_H__ #include #ifdef HAVE_XSHM #include #include #include #endif /* HAVE_XSHM */ #include #include #ifdef HAVE_XSHM #include #endif /* HAVE_XSHM */ #include #include #include #include #include G_BEGIN_DECLS #define GST_TYPE_XVIMAGESINK \ (gst_xvimagesink_get_type()) #define GST_XVIMAGESINK(obj) \ (G_TYPE_CHECK_INSTANCE_CAST((obj), GST_TYPE_XVIMAGESINK, GstXvImageSink)) #define GST_XVIMAGESINK_CLASS(klass) \ (G_TYPE_CHECK_CLASS_CAST((klass), GST_TYPE_XVIMAGESINK, GstXvImageSinkClass)) #define GST_IS_XVIMAGESINK(obj) \ (G_TYPE_CHECK_INSTANCE_TYPE((obj), GST_TYPE_XVIMAGESINK)) #define GST_IS_XVIMAGESINK_CLASS(klass) \ (G_TYPE_CHECK_CLASS_TYPE((klass), GST_TYPE_XVIMAGESINK)) typedef struct _GstXContext GstXContext; typedef struct _GstXWindow GstXWindow; typedef struct _GstXvImageFormat GstXvImageFormat; typedef struct _GstXvImageBuffer GstXvImageBuffer; typedef struct _GstXvImageBufferClass GstXvImageBufferClass; typedef struct _GstXvImageSink GstXvImageSink; typedef struct _GstXvImageSinkClass GstXvImageSinkClass; /** * GstXContext: * @disp: the X11 Display of this context * @screen: the default Screen of Display @disp * @screen_num: the Screen number of @screen * @visual: the default Visual of Screen @screen * @root: the root Window of Display @disp * @white: the value of a white pixel on Screen @screen * @black: the value of a black pixel on Screen @screen * @depth: the color depth of Display @disp * @bpp: the number of bits per pixel on Display @disp * @endianness: the endianness of image bytes on Display @disp * @width: the width in pixels of Display @disp * @height: the height in pixels of Display @disp * @widthmm: the width in millimeters of Display @disp * @heightmm: the height in millimeters of Display @disp * @par: the pixel aspect ratio calculated from @width, @widthmm and @height, * @heightmm ratio * @use_xshm: used to known wether of not XShm extension is usable or not even * if the Extension is present * @xv_port_id: the XVideo port ID * @im_format: used to store at least a valid format for XShm calls checks * @formats_list: list of supported image formats on @xv_port_id * @channels_list: list of #GstColorBalanceChannels * @caps: the #GstCaps that Display @disp can accept * * Structure used to store various informations collected/calculated for a * Display. */ struct _GstXContext { Display *disp; Screen *screen; gint screen_num; Visual *visual; Window root; gulong white, black; gint depth; gint bpp; gint endianness; gint width, height; gint widthmm, heightmm; GValue *par; /* calculated pixel aspect ratio */ gboolean use_xshm; XvPortID xv_port_id; guint nb_adaptors; gchar ** adaptors; gint im_format; GList *formats_list; GList *channels_list; GstCaps *caps; /* Optimisation storage for buffer_alloc return */ GstCaps *last_caps; gint last_format; }; /** * GstXWindow: * @win: the Window ID of this X11 window * @width: the width in pixels of Window @win * @height: the height in pixels of Window @win * @internal: used to remember if Window @win was created internally or passed * through the #GstXOverlay interface * @gc: the Graphical Context of Window @win * * Structure used to store informations about a Window. */ struct _GstXWindow { Window win; gint width, height; gboolean internal; GC gc; }; /** * GstXvImageFormat: * @format: the image format * @caps: generated #GstCaps for this image format * * Structure storing image format to #GstCaps association. */ struct _GstXvImageFormat { gint format; GstCaps *caps; }; /** * GstXImageBuffer: * @xvimagesink: a reference to our #GstXvImageSink * @xvimage: the XvImage of this buffer * @width: the width in pixels of XvImage @xvimage * @height: the height in pixels of XvImage @xvimage * @im_format: the image format of XvImage @xvimage * @size: the size in bytes of XvImage @xvimage * * Subclass of #GstBuffer containing additional information about an XvImage. */ struct _GstXvImageBuffer { GstBuffer buffer; /* Reference to the xvimagesink we belong to */ GstXvImageSink *xvimagesink; XvImage *xvimage; #ifdef HAVE_XSHM XShmSegmentInfo SHMInfo; #endif /* HAVE_XSHM */ gint width, height, im_format; size_t size; }; /** * GstXvImageSink: * @display_name: the name of the Display we want to render to * @xcontext: our instance's #GstXContext * @xwindow: the #GstXWindow we are rendering to * @xvimage: internal #GstXvImage used to store incoming buffers and render when * not using the buffer_alloc optimization mechanism * @cur_image: a reference to the last #GstXvImage that was put to @xwindow. It * is used when Expose events are received to redraw the latest video frame * @event_thread: a thread listening for events on @xwindow and handling them * @running: used to inform @event_thread if it should run/shutdown * @fps_n: the framerate fraction numerator * @fps_d: the framerate fraction denominator * @x_lock: used to protect X calls as we are not using the XLib in threaded * mode * @flow_lock: used to protect data flow routines from external calls such as * events from @event_thread or methods from the #GstXOverlay interface * @par: used to override calculated pixel aspect ratio from @xcontext * @pool_lock: used to protect the buffer pool * @image_pool: a list of #GstXvImageBuffer that could be reused at next buffer * allocation call * @synchronous: used to store if XSynchronous should be used or not (for * debugging purpose only) * @keep_aspect: used to remember if reverse negotiation scaling should respect * aspect ratio * @handle_events: used to know if we should handle select XEvents or not * @brightness: used to store the user settings for color balance brightness * @contrast: used to store the user settings for color balance contrast * @hue: used to store the user settings for color balance hue * @saturation: used to store the user settings for color balance saturation * @cb_changed: used to store if the color balance settings where changed * @video_width: the width of incoming video frames in pixels * @video_height: the height of incoming video frames in pixels * * The #GstXvImageSink data structure. */ struct _GstXvImageSink { /* Our element stuff */ GstVideoSink videosink; char *display_name; guint adaptor_no; GstXContext *xcontext; GstXWindow *xwindow; GstXvImageBuffer *xvimage; GstXvImageBuffer *cur_image; GThread *event_thread; gboolean running; gint fps_n; gint fps_d; GMutex *x_lock; GMutex *flow_lock; /* object-set pixel aspect ratio */ GValue *par; GMutex *pool_lock; GSList *image_pool; gboolean synchronous; gboolean double_buffer; gboolean keep_aspect; gboolean draw_border; gboolean handle_events; gboolean handle_expose; gint brightness; gint contrast; gint hue; gint saturation; gboolean cb_changed; guint video_width, video_height; /* size of incoming video; * used as the size for XvImage */ }; struct _GstXvImageSinkClass { GstVideoSinkClass parent_class; }; GType gst_xvimagesink_get_type(void); G_END_DECLS #endif /* __GST_XVIMAGESINK_H__ */