Module `Av`Source

This module perform demuxing then decoding for reading and coding then muxing for writing multimedia container formats.

Sourceval container_options : Avutil.Options.t

Format

Sourcemodule Format : sig ... end

Input

val open_input : 
  ?interrupt:(unit -> bool) ->
  ?format:(Avutil.input, _) Avutil.format ->
  ?opts:Avutil.opts ->
  string ->
  Avutil.input Avutil.container

Av.open_input url open the input url (a file name or http URL). After returning, if opts was passed, unused options are left in the hash table. Raise Error if the opening failed.

Sourcetype read = bytes -> int -> int -> int

Sourcetype write = bytes -> int -> int -> int

Sourcetype seek = int -> Unix.seek_command -> int

Source

val open_input_stream : 
  ?format:(Avutil.input, _) Avutil.format ->
  ?opts:Avutil.opts ->
  ?seek:seek ->
  read ->
  Avutil.input Avutil.container

Av.open_input_stream read creates an input stream from the given read callback. Exceptions from the callback are caught and result in a native Avutil.Error `Unknown error.

Source

val get_input_duration : 
  ?format:Avutil.Time_format.t ->
  Avutil.input Avutil.container ->
  Int64.t option

Av.get_input_duration ~format:fmt input return the duration of an input in the fmt time format (in second by default).

Source

val get_input_metadata : 
  Avutil.input Avutil.container ->
  (string * string) list

Return the input tag (key, vlue) list.

Sourceval input_obj : Avutil.input Avutil.container -> Avutil.Options.obj

Return a value of type obj, suited for use with Avutils.Options getters.

Sourcetype ('line, 'media, 'mode) stream

Input/output, audio/video/subtitle, mode stream type

Source

val get_audio_streams : 
  Avutil.input Avutil.container ->
  (int * (Avutil.input, Avutil.audio, 'a) stream * Avutil.audio Avcodec.params)
    list

Return the audio stream list of the input. The result is a list of tuple containing the index of the stream in the container, the stream and the codec of the stream.

Source

val get_video_streams : 
  Avutil.input Avutil.container ->
  (int * (Avutil.input, Avutil.video, 'a) stream * Avutil.video Avcodec.params)
    list

Same as Av.get_audio_streams for the video streams.

Source

val get_subtitle_streams : 
  Avutil.input Avutil.container ->
  (int
   * (Avutil.input, Avutil.subtitle, 'a) stream
   * Avutil.subtitle Avcodec.params)
    list

Same as Av.get_audio_streams for the subtitle streams.

Source

val find_best_audio_stream : 
  Avutil.input Avutil.container ->
  int * (Avutil.input, Avutil.audio, 'a) stream * Avutil.audio Avcodec.params

Return the best audio stream of the input. The result is a tuple containing the index of the stream in the container, the stream and the codec of the stream. Raise Error if no stream could be found.

Source

val find_best_video_stream : 
  Avutil.input Avutil.container ->
  int * (Avutil.input, Avutil.video, 'a) stream * Avutil.video Avcodec.params

Same as Av.find_best_audio_stream for the video streams.

Source

val find_best_subtitle_stream : 
  Avutil.input Avutil.container ->
  int
  * (Avutil.input, Avutil.subtitle, 'a) stream
  * Avutil.subtitle Avcodec.params

Same as Av.find_best_audio_stream for the subtitle streams.

Sourceval get_input : (Avutil.input, _, _) stream -> Avutil.input Avutil.container

Return the input container of the input stream.

Sourceval get_index : (_, _, _) stream -> int

Return the index of the stream.

Sourceval get_codec_params : (_, 'media, _) stream -> 'media Avcodec.params

Av.get_codec stream return the codec of the stream. Raise Error if the codec allocation failed.

Sourceval get_time_base : (_, _, _) stream -> Avutil.rational

Av.get_time_base stream return the time base of the stream.

Sourceval set_time_base : (_, _, _) stream -> Avutil.rational -> unit

Av.set_time_base stream time_base set the stream time base to time_base.

Sourceval get_frame_size : (Avutil.output, Avutil.audio, _) stream -> int

Av.get_frame_size stream return the frame size for the given audio stream.

Sourceval get_pixel_aspect : (_, Avutil.video, _) stream -> Avutil.rational option

Av.get_pixel_aspect stream return the pixel aspect of the stream.

Source

val get_duration : 
  ?format:Avutil.Time_format.t ->
  (Avutil.input, _, _) stream ->
  Int64.t

Same as Av.get_input_duration for the input streams.

Sourceval get_metadata : (Avutil.input, _, _) stream -> (string * string) list

Same as Av.get_input_metadata for the input streams.

Source

val set_decoder : 
  (Avutil.input, 'a, _) stream ->
  ('a, Avcodec.decode) Avcodec.codec ->
  unit

For the use of a specific decoder for the given input stream.

Sourcetype input_result = [

| `Audio_packet of int * Avutil.audio Avcodec.Packet.t
| `Audio_frame of int * Avutil.audio Avutil.frame
| `Video_packet of int * Avutil.video Avcodec.Packet.t
| `Video_frame of int * Avutil.video Avutil.frame
| `Subtitle_packet of int * Avutil.subtitle Avcodec.Packet.t
| `Subtitle_frame of int * Avutil.subtitle Avutil.frame

]

Source

val read_input : 
  ?audio_packet:(Avutil.input, Avutil.audio, [ `Packet ]) stream list ->
  ?audio_frame:(Avutil.input, Avutil.audio, [ `Frame ]) stream list ->
  ?video_packet:(Avutil.input, Avutil.video, [ `Packet ]) stream list ->
  ?video_frame:(Avutil.input, Avutil.video, [ `Frame ]) stream list ->
  ?subtitle_packet:(Avutil.input, Avutil.subtitle, [ `Packet ]) stream list ->
  ?subtitle_frame:(Avutil.input, Avutil.subtitle, [ `Frame ]) stream list ->
  Avutil.input Avutil.container ->
  input_result

Reads the selected streams if any or all streams otherwise. Return the next Audio Video or Subtitle index and packet or frame of the input or Error `Eof if the end of the input is reached. Raise Error if the reading failed.

Only packet and frames from the specified streams are returned.

Sourcetype seek_flag =

| Seek_flag_backward
| Seek_flag_byte
| Seek_flag_any
| Seek_flag_frame

Seek mode.

Source

val seek : 
  ?flags:seek_flag list ->
  ?stream:(Avutil.input, _, _) stream ->
  ?min_ts:Int64.t ->
  ?max_ts:Int64.t ->
  fmt:Avutil.Time_format.t ->
  ts:Int64.t ->
  Avutil.input Avutil.container ->
  unit

Av.seek ?flags ?stream ?min_ts ?max_ts ~fmt ~ts container seek in the container container to position ts. You can pass an optional stream to use for seeking, max_ts and min_ts to force seeking to happen within a given timestamp window and flags to speficy certain property of the seeking operation. Raise Error if the seeking failed.

Output

Source

val open_output : 
  ?interrupt:(unit -> bool) ->
  ?format:(Avutil.output, _) Avutil.format ->
  ?opts:Avutil.opts ->
  string ->
  Avutil.output Avutil.container

Av.open_output ?interrupt ?format ?opts filename open the output file named filename. interrupt is used to interrupt blocking functions, format may contain an optional format, opts may contain any option settable on the stream's internal AVFormat. After returning, if opts was passed, unused options are left in the hash table. Raise Error if the opening failed.

Source

val open_output_stream : 
  ?opts:Avutil.opts ->
  ?seek:seek ->
  write ->
  (Avutil.output, _) Avutil.format ->
  Avutil.output Avutil.container

Av.open_stream callbacks open the output container with the given callbacks. opts may contain any option settable on Ffmpeg avformat. After returning, if opts was passed, unused options are left in the hash table. Raise Error if the opening failed. Exceptions from the callback are caught and result in a native Avutil.Error `Unknown error.

Sourceval output_started : Avutil.output Avutil.container -> bool

Returns true if the output has already started, in which case no new * stream or metadata can be added.

Source

val set_output_metadata : 
  Avutil.output Avutil.container ->
  (string * string) list ->
  unit

Av.set_output_metadata dst tags set the metadata of the dst output with the tags tag list. This must be set before starting writing streams. Raise Error if a writing already taken place or if the setting failed.

Source

val set_metadata : 
  (Avutil.output, _, _) stream ->
  (string * string) list ->
  unit

Same as Av.set_output_metadata for the output streams.

Sourceval get_output : (Avutil.output, _, _) stream -> Avutil.output Avutil.container

Return the output container of the output stream.

Source

val new_stream_copy : 
  params:'mode Avcodec.params ->
  Avutil.output Avutil.container ->
  (Avutil.output, 'mode, [ `Packet ]) stream

Source

val new_audio_stream : 
  ?opts:Avutil.opts ->
  ?channels:int ->
  ?channel_layout:Avutil.Channel_layout.t ->
  sample_rate:int ->
  sample_format:Avutil.Sample_format.t ->
  time_base:Avutil.rational ->
  codec:[ `Encoder ] Avcodec.Audio.t ->
  Avutil.output Avutil.container ->
  (Avutil.output, Avutil.audio, [ `Frame ]) stream

Add a new audio stream to the given container. Stream only supports frames and encodes its input.

opts may contain any option settable on the stream's internal AVCodec. After returning, if opts was passed, unused options are left in the hash table.

At least one of channels or channel_layout must be passed.

Frames passed to this stream for encoding must have a PTS set according to the given time_base. 1/sample_rate is usually a good value for the time_base.

Please note that some codec require a fixed frame size, denoted by the absence of the `Variable_frame_size codec capabilities. In this case, the user is expected to pass frames containing exactly Av.get_frame_size stream.

Avfilter can be used to slice frames into frames of fixed size. See Avfilter.Utils.convert_audio for an example.

Raise Error if the opening failed.

Source

val new_video_stream : 
  ?opts:Avutil.opts ->
  ?frame_rate:Avutil.rational ->
  ?hardware_context:Avcodec.Video.hardware_context ->
  pixel_format:Avutil.Pixel_format.t ->
  width:int ->
  height:int ->
  time_base:Avutil.rational ->
  codec:[ `Encoder ] Avcodec.Video.t ->
  Avutil.output Avutil.container ->
  (Avutil.output, Avutil.video, [ `Frame ]) stream

Add a new video stream to the given container. Stream only supports frames and encodes its input.

opts may contain any option settable on the stream's internal AVCodec. After returning, if opts was passed, unused options are left in the hash table.

Frames passed to this stream for encoding must have a PTS set according to the given time_base. 1/frame_rate is usually a good value for the time_base.

hardware_context can be used to pass optional hardware device and frame context to enable hardward encoding on this stream.

Raise Error if the opening failed.

Source

val new_subtitle_stream : 
  ?opts:Avutil.opts ->
  time_base:Avutil.rational ->
  codec:[ `Encoder ] Avcodec.Subtitle.t ->
  Avutil.output Avutil.container ->
  (Avutil.output, Avutil.subtitle, [ `Frame ]) stream

Add a new subtitle stream to the given container. Stream only supports frames and encodes its input.

opts may contain any option settable on the stream's internal AVCodec. After returning, if opts was passed, unused options are left in the hash table.

Raise Error if the opening failed.

Sourceval codec_attr : (_, _, _) stream -> string option

Return a codec attribute suitable for HLS playlists when available.

Sourceval bitrate : (_, _, _) stream -> int option

Return the stream's bitrate when available, suitable for HLS playlists.

Source

val write_packet : 
  (Avutil.output, 'media, [ `Packet ]) stream ->
  Avutil.rational ->
  'media Avcodec.Packet.t ->
  unit

Av.write_packet os time_base pkt write the pkt packet to the os output stream. time_base is the packet's PTS/DTS/duration time base. Raise Error if the writing failed.

Source

val write_frame : 
  (Avutil.output, 'media, [ `Frame ]) stream ->
  'media Avutil.frame ->
  unit

Av.write_frame os frm write the frm frame to the os output stream.

Frame PTS should be set and counted in units of time_base, as passed when creating the stream

Raise Error if the writing failed.

Sourceval was_keyframe : (Avutil.output, _, _) stream -> bool

true if the last processed frame was a video key frame.

Source

val write_audio_frame : 
  Avutil.output Avutil.container ->
  Avutil.audio Avutil.frame ->
  unit

Av.write_audio_frame dst frm write the frm audio frame to the dst output audio container. Raise Error if the output format is not defined or if the output media type is not compatible with the frame or if the writing failed.

Source

val write_video_frame : 
  Avutil.output Avutil.container ->
  Avutil.video Avutil.frame ->
  unit

Same as Av.write_audio_frame for output video container.

Sourceval flush : Avutil.output Avutil.container -> unit

Flush the underlying muxer.

Sourceval close : _ Avutil.container -> unit

Close an input or output container.

Install

Dune Dependency

Authors

Maintainers

Sources

doc/ffmpeg-av/Av/index.html

Module `Av`Source

Format

Input

Output

package ffmpeg-av

Install

Dune Dependency

Authors

Maintainers

Sources

doc/ffmpeg-av/Av/index.html

Module AvSource

Format

Input

Output

Module `Av`Source