flu_player_event_new ()

FluPlayerEvent *
flu_player_event_new (FluPlayerEventType type);

Creates a new FluPlayerEvent

flu_player_event_copy ()

FluPlayerEvent *
flu_player_event_copy (const FluPlayerEvent *event);

Copies a FluPlayerEvent

flu_player_event_free ()

void
flu_player_event_free (FluPlayerEvent *event);

Frees the FluPlayerEvent

enum FluPlayerState

Enum values used to describe an FluPlayer state.

enum FluUserOperation

Enum values used to describe different kinds of prohibited user operations. This is mostly used in the case of DVD playback for example when the user is not allowed to skip some scene or for advertising scenarios.

enum FluPlaybackDirection

Enum values used to describe FluPlayer playback direction.

enum FluPlayerEventType

Enum values used to describe different type of events that can be raised by a FluPlayer.

FluPlayerEventAny

typedef struct {
  FluPlayerEventType type;
} FluPlayerEventAny;

Contains the fields which are common to all event structs. Any event pointer can safely be cast to a pointer to a FluPlayerEventAny to access these fields.

FluPlayerEventError

typedef struct {
  FluPlayerEventType type;
  GError *error;
  const gchar *dbg;
} FluPlayerEventError;

Event structure describing an error that occurred in an FluPlayer instance.

FluPlayerEventStreamError

typedef struct {
  FluPlayerEventType type;
  GError *error;
  const gchar *dbg;
  FluStream *stream;
} FluPlayerEventStreamError;

Event structure describing an error that occured in an FluStream instance.

FluPlayerEventBuffering

typedef struct {
  FluPlayerEventType type;
  gint percent;
} FluPlayerEventBuffering;

Event structure providing information about the current buffering state of an FluPlayer instance. When percent is lower than 100, the player is paused and buffering data. When percent reaches 100 again, playback will resume.

FluPlayerEventRequestTexture

typedef struct {
  FluPlayerEventType type;
  guintptr handle;
  FluStream *stream;
  gboolean handle_aspect_ratio;
} FluPlayerEventRequestTexture;

Event structure used by a stream to retrieve information about the target rendering texture. When a video stream is preparing to render the first video frame it will request a destination drawable to the application. Application should set the target texture pointer in handle while handling this event. The video rendering component is sometimes able to handle the drawing of black borders and maintain the original video aspect ratio. In most cases this will work just fine but it is recommended that the application handles this directly to support special cases like forcing a specific aspect ratio, video cropping, etc...

FluPlayerEventStreamChanged

typedef struct {
  FluPlayerEventType type;
  FluStream *stream;
  FluStreamChangedFlags changed_flags;
} FluPlayerEventStreamChanged;

Event structure used to notify applications that a stream 's changed

struct FluPlayerEventStreamInfoUpdated

struct FluPlayerEventStreamInfoUpdated {
  FluPlayerEventType type;
  FluStream *stream;
};

Alias of FluPlayerEventStreamChanged for backwards compatibility

struct FluPlayerEventStreamStateChanged

struct FluPlayerEventStreamStateChanged {
  FluPlayerEventType type;
  FluStream *stream;
};

Event structure used to notify applications that a stream 's state has changed. That means that the stream either became active thanks to data flow (after being requested) or inactive.

FluPlayerEventState

typedef struct {
  FluPlayerEventType type;
  FluPlayerState state;
} FluPlayerEventState;

Event structure used to notify applications that the player's state has changed. The new current state is provided in state or can be queried using flu_player_state_get().

FluPlayerEventUOPChanged

typedef struct {
  FluPlayerEventType type;
  FluUserOperation prohibited_operations;
} FluPlayerEventUOPChanged;

Event structure used to notify applications that the player's UOP (User Operation Prohibition) has changed.

FluPlayerEventRequestRenderMode

typedef struct {
  FluPlayerEventType type;
  FluStream *stream;
  gboolean render;
  gboolean synchronize;
  gboolean notify;
} FluPlayerEventRequestRenderMode;

Event structure used to retrieve information about the target rendering mode for stream . Whenever the stream is about to be decoded, the application can decide to render or not to render a specific stream.

struct FluPlayerEventRequestRenderDevice

struct FluPlayerEventRequestRenderDevice {
  FluPlayerEventType type;
  FluStream *stream;
  GList *devices;
  gint selected;
};

Event structure used to retrieve what device to use to render a stream .

FluPlayerEventRender

typedef struct {
  FluPlayerEventType type;
  FluStream *stream;
  guint64 pts;
  guint64 duration;
} FluPlayerEventRender;

Event structure indicating that a stream is ready to render a sample.

FluPlayerEventMediaInfoUpdated

typedef struct {
  FluPlayerEventType type;
  const FluMediaInfo *info;
  FluSource *source;
} FluPlayerEventMediaInfoUpdated;

Event structure used to notify applications that a player's FluMediaInfo has changed.

FluPlayerEventRequestDRMAgent

typedef struct {
  FluPlayerEventType type;
  guintptr handle;
  gpointer init_data;
  gsize init_data_size;
  gboolean try_inband;
} FluPlayerEventRequestDRMAgent;

Event structure used to retrieve the DRM agent handle used for decrypting

FluPlayerEventSeekSource

typedef struct {
  FluPlayerEventType type;
  FluSource *source;
  guint64 position;
  FluFormat format;
} FluPlayerEventSeekSource;

Event structure used to request a seek on FluSource

FluPlayerEventSourceNeedData

typedef struct {
  FluPlayerEventType type;
  FluSource *source;
  FluPlaybackDirection playback_direction;
  guint8 *data;
  gsize size;
  guint64 pts;
  GFreeFunc free_func;
} FluPlayerEventSourceNeedData;

Event structure used when FluSource request data. This event is used with seekable FluCustomSource.

FluPlayerEventStreamsAvailable

typedef struct {
  FluPlayerEventType type;
  FluStream *stream;
  gboolean added;
} FluPlayerEventStreamsAvailable;

Event structure used when a new stream is add to a FluSource

FluPlayerEvent

The FluPlayerEvent struct contains a union of all of the event structs, and allows access to the data fields in a number of ways.

The event type is always the first field in all of the event structs, and can always be accessed with the following code, no matter what type of event it is: <informalexample> <programlisting> FluPlayerEvent *event; FluPlayerEventType type;

type = event->type; </programlisting> </informalexample>

To access other fields of the event structs, the pointer to the event can be cast to the appropriate event struct pointer, or the union member name can be used. For example if the event type is FLU_PLAYER_EVENT_STATE then the state can be accessed with: <informalexample> <programlisting> FluPlayerEvent *event; FluPlayerState state;

state = ((FluPlayerEventState*)event)->state; </programlisting> </informalexample> or: <informalexample> <programlisting> FluPlayerEvent *event; FluPlayerState state;

state = event->state.x; </programlisting> </informalexample>

stream_info_updated and stream_state_changed are aliases of stream_changed for backwards compatibility