Method

ClapperReactablequeue_insert_sync

since: 0.10

Declaration [src]

void
clapper_reactable_queue_insert_sync (
  ClapperReactable* reactable,
  ClapperMediaItem* item,
  ClapperMediaItem* after_item
)

Description [src]

A convenience function that within application main thread synchronously inserts an item to the playback queue position after after_item of the player that reactable belongs to.

This function uses after_item instead of position index in order to ensure desired position does not change during thread switching.

Reactable enhancers should only modify the queue from the application main thread, switching thread either themselves or using this convenience function that does so.

Note that this function will do no operation if called when there is no player set yet (e.g. inside enhancer construction) or if enhancer outlived the parent instance somehow. Both cases are considered to be implementation bug.

Available since: 0.10

Parameters

item

Type: ClapperMediaItem

A ClapperMediaItem.

The data is owned by the caller of the method.
after_item

Type: ClapperMediaItem

A ClapperMediaItem after which to insert or NULL to prepend.

The data is owned by the caller of the method.