Message.this

gstreamer Message Message

Creates a new redirect message and adds a new entry to it. Redirect messages are posted when an element detects that the actual data has to be retrieved from a different location. This is useful if such a redirection cannot be handled inside a source element, for example when HTTP 302/303 redirects return a non-HTTP URL.

The redirect message can hold multiple entries. The first one is added when the redirect message is created, with the given location, tag_list, entry_struct arguments. Use Message.addRedirectEntry to add more entries.

Each entry has a location, a tag list, and a structure. All of these are optional. The tag list and structure are useful for additional metadata, such as bitrate statistics for the given location.

By default, message recipients should treat entries in the order they are stored. The recipient should therefore try entry [0|0] first, and if this entry is not acceptable or working, try entry [1|1] etc. Senders must make sure that they add entries in this order. However, recipients are free to ignore the order and pick an entry that is "best" for them. One example would be a recipient that scans the entries for the one with the highest bitrate tag.

The specified location string is copied. However, ownership over the tag list and structure are transferred to the message.

  1. this(GstMessage* gstMessage, bool ownedRef)
  2. this(ObjectGst src, Structure structure)
  3. this(ObjectGst src, GstClockTime runningTime)
  4. this(ObjectGst src, int percent)
  5. this(ObjectGst src, Clock clock)
  6. this(ObjectGst src, Clock clock, bool ready)
  7. this(GstMessageType type, ObjectGst src, Structure structure)
  8. this(ObjectGst src, Device device, Device changedDevice)
  9. this(ObjectGst src, Context context)
  10. this(ObjectGst src, string contextType)
  11. this(ObjectGst src, GstProgressType type, string code, string text)
  12. this(ObjectGst src, string propertyName, Value val)
  13. this(ObjectGst src, bool live, ulong runningTime, ulong streamTime, ulong timestamp, ulong duration)
  14. this(ObjectGst src, string location, TagList tagList, Structure entryStruct)
    class Message
  15. this(ObjectGst src, GstState state)
  16. this(ObjectGst src, GstState oldstate, GstState newstate, GstState pending)
  17. this(ObjectGst src, GstFormat format, ulong amount, double rate, bool flush, bool intermediate, ulong duration, bool eos)
  18. this(ObjectGst src, bool active, GstFormat format, ulong amount, double rate, bool flush, bool intermediate)
  19. this(ObjectGst src)
  20. this(ObjectGst src, GstStreamStatusType type, Element owner)
  21. this(ObjectGst src, GstStructureChangeType type, Element owner, bool busy)
  22. this(ObjectGst src, TagList tagList)
  23. this(ObjectGst src, Toc toc, bool updated)

Parameters

src ObjectGst

The GstObject whose property changed (may or may not be a gstreamer.Element)

location string

location string for the new entry

tagList TagList

tag list for the new entry

entryStruct Structure

structure for the new entry

Return Value

a newly allocated gstreamer.Message

Throws

ConstructionException GTK+ fails to create the object.

Meta

Since

1.10

gstreamer Message Message constructorsfunctionsstatic functionsvariables
Page generated by adrdox