summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
...
* doc/ffmpeg: slightly rework introductory examplesStefano Sabatini2023-04-021-7/+15
| | | | | | | | | | | In particular, add a sentence to introduce the example, and add a simpler starting example with no options. Also use different format for input.avi and output.mp4, to convey that the conversion also works on the container format. Address issue: http://trac.ffmpeg.org/ticket/8730
* doc/filters/find_rect: extend documentationStefano Sabatini2023-04-021-2/+45
| | | | | | | | | Document metadata entries set by the filter, extend and clarify options, add additional example showing how to extract the generated data. Address issue: http://trac.ffmpeg.org/ticket/8766
* doc/encoders: add an entry for the frame_length option from libfdk-aacJames Almer2023-03-311-0/+5
| | | | | Reviewed-by: Martin Storsjö <martin@martin.st> Signed-off-by: James Almer <jamrial@gmail.com>
* libavformat/tcp: add local_addr/local_port for network optionjackarain2023-03-301-0/+6
| | | | | Signed-off-by: jackarain <jack.wgm@gmail.com> Signed-off-by: Anton Khirnov <anton@khirnov.net>
* doc/filters/paletteuse: mention none dithering valueStefano Sabatini2023-03-291-0/+2
| | | | | Fix issue: http://trac.ffmpeg.org/ticket/9950
* doc/outdevs/sdl: update options documentationStefano Sabatini2023-03-291-4/+4
| | | | | | | Drop mention of missing icon_title option, document window_borderless option. Fix issue: http://trac.ffmpeg.org/ticket/9583
* doc/outdevs/sdl: sort options by nameStefano Sabatini2023-03-291-13/+13
|
* doc/filters/aspect: update documentationStefano Sabatini2023-03-291-13/+5
| | | | | | | | | | Drop mention of unsupported N:M syntax, dropped since 0ed61546c459. Also, drop reference of common expression constants, and fix description of a expression parameter. Fix issue: http://trac.ffmpeg.org/ticket/9974
* doc/filters: mentions that whitespaces are ignored in the filtergraph ↵Stefano Sabatini2023-03-291-0/+17
| | | | | | | | | | specification Also provide example showing how to use this feature to improve filtergraph readability. Address issue: http://trac.ffmpeg.org/ticket/8115
* doc/filters: propose solutions to avoid shell escapingStefano Sabatini2023-03-292-5/+19
| | | | | | | | Reference drawtext textfile option and ffmpeg -filter_complex_script and -filter_script as possible solutions to avoid shell escaping. Address issue: http://trac.ffmpeg.org/ticket/9008
* doc/filters/drawtext: clarify meaning of strftime format stringStefano Sabatini2023-03-291-13/+15
| | | | Also clarify what should be used instead of the strftime expansion mode.
* lavc/libaribcaption.c: add ARIB caption decoder using libaribcaptionTADANO Tokumei2023-03-281-0/+150
| | | | | | | | | | | | | | | | | | | | | | | | | | | | This patch add another ARIB caption decoder using libaribcaption external library. Unlike libaribb24, it supports 3 types of subtitle outputs: * text: plain text * ass: ASS formatted text * bitmap: bitmap image Default subtitle type is ass as same as libaribb24. Advantages compared with libaribb24 on ASS subtitle are: * Subtitle positioning. * Multi-rect subtitle: some captions are displayed at different position at a time. * More stability and reproducibility. To compile with this feature: * libaribcaption external library has to be pre-installed. https://github.com/xqq/libaribcaption * configure with `--enable-libaribcaption` option. `--enable-libaribb24` and `--enable-libaribcaption` options are not exclusive. If both enabled, libaribcaption precedes as order listed in `libavcodec/allcodecs.c`. Signed-off-by: rcombs <rcombs@rcombs.me>
* fftools/ffprobe: print crop_* frame fieldsJames Almer2023-03-261-0/+4
| | | | | Reviewed-by: Stefano Sabatini <stefasab@gmail.com> Signed-off-by: James Almer <jamrial@gmail.com>
* doc/ffmpeg: add vstats format documentationStefano Sabatini2023-03-261-10/+67
| | | | | Address issue: http://trac.ffmpeg.org/ticket/7520
* avfilter/vf_mcdeint: update to new APIMichael Niedermayer2023-03-261-2/+0
| | | | Signed-off-by: Michael Niedermayer <michael@niedermayer.cc>
* lavfi: add a flag for filters able to work with hw_device_ctxAnton Khirnov2023-03-241-0/+3
| | | | | This way the caller can set it just on the filters that can make use of it.
* avutil: add HDR10+ dynamic metadata serialization functionRaphaël Zumer2023-03-211-0/+5
| | | | | | Co-authored-by: Mohammad Izadi <moh.izadi@gmail.com> Signed-off-by: Raphaël Zumer <rzumer@tebako.net> Signed-off-by: James Almer <jamrial@gmail.com>
* doc/developer.texi: add a section on API/ABI compatibilityAnton Khirnov2023-03-201-16/+146
| | | | Document established practices in it.
* doc/developer.texi: document checkasmAnton Khirnov2023-03-201-0/+4
|
* doc/developer.texi: document the use of other languages than CAnton Khirnov2023-03-201-2/+36
|
* lavu/frame: deprecate AVFrame.pkt_{pos,size}Anton Khirnov2023-03-201-18/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | These fields are supposed to store information about the packet the frame was decoded from, specifically the byte offset it was stored at and its size. However, - the fields are highly ad-hoc - there is no strong reason why specifically those (and not any other) packet properties should have a dedicated field in AVFrame; unlike e.g. the timestamps, there is no fundamental link between coded packet offset/size and decoded frames - they only make sense for frames produced by decoding demuxed packets, and even then it is not always the case that the encoded data was stored in the file as a contiguous sequence of bytes (in order for pos to be well-defined) - pkt_pos was added without much explanation, apparently to allow passthrough of this information through lavfi in order to handle byte seeking in ffplay. That is now implemented using arbitrary user data passthrough in AVFrame.opaque_ref. - several filters use pkt_pos as a variable available to user-supplied expressions, but there seems to be no established motivation for using them. - pkt_size was added for use in ffprobe, but that too is now handled without using this field. Additonally, the values of this field produced by libavcodec are flawed, as described in the previous ffprobe conversion commit. In summary - these fields are ill-defined and insufficiently motivated, so deprecate them.
* avfilter/vf_uspp: Support any codecMichael Niedermayer2023-03-181-0/+3
| | | | Signed-off-by: Michael Niedermayer <michael@niedermayer.cc>
* doc/encoders: Add av1 to qsv encoder's summaryWenbin Chen2023-03-171-2/+2
| | | | Signed-off-by: Wenbin Chen <wenbin.chen@intel.com>
* doc/examples/qsv_transcode: Fix a bug when use more than one parameter setWenbin Chen2023-03-171-1/+1
| | | | Signed-off-by: Wenbin Chen <wenbin.chen@intel.com>
* libavcodec/qsvenc: Add dynamic setting support of low_delay_brc to av1_qsvWenbin Chen2023-03-171-1/+1
| | | | Signed-off-by: Wenbin Chen <wenbin.chen@intel.com>
* libavutil/hdr_dynamic_vivid_metadata: fix three spline paramsZhao Zhili2023-03-171-0/+4
| | | | | | There are two group of three_Spline params. Signed-off-by: Zhao Zhili <zhilizhao@tencent.com>
* avfilter/vf_libplacebo: remove deprecated fieldNiklas Haas2023-03-131-3/+0
| | | | | | | | | | This has not been functional since a year ago, including in our current minimum dependency of libplacebo (v4.192.0). It also causes build errors against libplacebo v6, so it needs to be removed from the code. We can keep the option around for now, but it should also be removed soon. Signed-off-by: Niklas Haas <git@haasn.dev> Signed-off-by: James Almer <jamrial@gmail.com>
* doc/examples/mux: rename alloc_picture to alloc_frameStefano Sabatini2023-03-121-12/+12
| | | | The new name is consistent with the updated API.
* doc/filters: update SITI descriptionWerner Robitza2023-03-021-3/+5
| | | | The filter implements the 'legacy' version from a superseded recommendation.
* avcodec/version: bump minor version to accommodate spatial audio detectionMarth642023-03-021-0/+4
| | | | Signed-off-by: Marth64 <marth64@proxyid.net>
* Use https for repository linksMichael Niedermayer2023-03-012-3/+3
| | | | | Reviewed-by: Stefano Sabatini <stefasab@gmail.com> Signed-off-by: Michael Niedermayer <michael@niedermayer.cc>
* doc: Fix building community.html from the new community.texiMartin Storsjö2023-03-011-2/+2
| | | | | | | | | | | In texi source, @ characters need to be escaped. This fixes the following build errors: community.texi:59: unknown command `ffmpeg' community.texi:143: unknown command `ffmpeg' Signed-off-by: Martin Storsjö <martin@martin.st>
* doc: Merge doc/dev_community/* and Code of Conduct into a seperate fileThilo Borgmann2023-03-016-207/+177
| | | | | | Remove doc/dev_communit markup files completely as they are at the wrong place. Create a new community page, merging all of doc/dev_community and subsection Code of Conduct into a common place. The corresponding patch to ffmpeg-web puts the Organisation & Code of Conduct into a seperate community chapter on the FFmpeg website.
* doc/dev_community: add the addresses of the committeesNicolas George2023-03-011-0/+4
| | | | | | | Omitting the .org from the address should be protection enough against spam spiders. Signed-off-by: Nicolas George <george@nsup.org>
* doc/ffmpeg: extend documentation for -dts_delta_threshold and ↵Stefano Sabatini2023-02-281-6/+32
| | | | | | -dts_error_threshold PR: https://patchwork.ffmpeg.org/project/ffmpeg/list/?series=8252
* lavc/avcodec: Add HEVC Screen Content Coding Extensions profileLinjie Fu2023-02-271-0/+3
| | | | | | | | Described in HEVC spec A.3.7. Bump minor version and add APIchanges entry for new added profile. Signed-off-by: Linjie Fu <linjie.justin.fu@gmail.com> Signed-off-by: Fei Wang <fei.w.wang@intel.com>
* doc: improve IMF demuxer documentationPierre-Anthony Lemieux2023-02-211-1/+9
| | | | Signed-off-by: Pierre-Anthony Lemieux <pal@palemieux.com>
* swresample/swresample: add a used channel layout option using the new APIJames Almer2023-02-191-2/+2
| | | | | | Replaces the "used channel count" option, which is now deprecated. Signed-off-by: James Almer <jamrial@gmail.com>
* doc/resampler.texi: add missing swr channel layout optionsJames Almer2023-02-191-12/+2
| | | | Signed-off-by: James Almer <jamrial@gmail.com>
* doc: remove docs for options removed at the bumpMarton Balint2023-02-193-27/+0
| | | | Signed-off-by: Marton Balint <cus@passwd.hu>
* doc/APIchanges: Add 6.0 cut pointMichael Niedermayer2023-02-191-0/+2
| | | | Signed-off-by: Michael Niedermayer <michael@niedermayer.cc>
* doc/APIchange: fill in missing thingsMichael Niedermayer2023-02-191-28/+28
| | | | Signed-off-by: Michael Niedermayer <michael@niedermayer.cc>
* avfilter/vf_libplacebo: add SMPTE ST2094 tone-mappersNiklas Haas2023-02-171-0/+12
| | | | libplacebo gained these exciting new functions upstream.
* avfilter: add QSV variants of the stack filtersHaihao Xiang2023-02-161-0/+88
| | | | | | | | | | | | | | | | | | | Include hstack_qsv, vstack_qsv and xstack_qsv. They may accept input streams with different sizes. Examples: $ ffmpeg -hwaccel qsv -hwaccel_output_format qsv -i input.mp4 \ -filter_complex "[0:v][0:v]hstack_qsv" -f null - $ ffmpeg \ -hwaccel qsv -hwaccel_output_format qsv -i input.mp4 \ -hwaccel qsv -hwaccel_output_format qsv -i input.mp4 \ -hwaccel qsv -hwaccel_output_format qsv -i input.mp4 \ -hwaccel qsv -hwaccel_output_format qsv -i input.mp4 \ -filter_complex "[0:v][1:v][2:v][3:v]xstack_qsv=inputs=4:fill=0x000000:layout=0_0_1920x1080|w0_0_1920x1080|0_h0_1920x1080|w0_h0_1920x1080" \ -f null - Signed-off-by: Haihao Xiang <haihao.xiang@intel.com>
* avformat: deprecate AVFormatContext io_close callbackMarton Balint2023-02-161-0/+4
| | | | | | io_close2 should be used instead. Signed-off-by: Marton Balint <cus@passwd.hu>
* avutil/frame: deprecate AVFrame.coded_picture_number and display_picture_numberMarton Balint2023-02-132-2/+6
| | | | | | | | Their usefulness is questionable, very few decoders set them, and their type should have been int64_t. A replacement field can be added later if a valid use case is found. Signed-off-by: Marton Balint <cus@passwd.hu>
* avcodec: add AVCodecContext.frame_num as 64 bit variant to frame_numberMarton Balint2023-02-132-2/+6
| | | | | | | | | | Frame counters can overflow relatively easily (INT_MAX number of frames is slightly more than 1 year for 60 fps content), so make sure we use 64 bit values for them. Also deprecate the old 32 bit frame_number attribute. Signed-off-by: Marton Balint <cus@passwd.hu>
* fftools/ffmpeg: add special syntax for loading filter options from filesAnton Khirnov2023-02-121-0/+11
| | | | | | | | | | | | | | | | | Many filters accept user-provided data that is cumbersome to provide as text strings - e.g. binary files or very long text. For that reason such filters typically provide a option whose value is the path from which the filter loads the actual data. However, filters doing their own IO internally is a layering violation that the callers may not expect, and is thus best avoided. With the recently introduced graph segment parsing API, loading option values from files can now be handled by the caller. This commit makes use of the new API in ffmpeg CLI. Any option name in the filtergraph syntax can now be prefixed with a slash '/'. This will cause ffmpeg to interpret the value as the path to load the actual value from.
* lavfi: add a new filtergraph parsing APIAnton Khirnov2023-02-121-0/+15
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Callers currently have two ways of adding filters to a graph - they can either - create, initialize, and link them manually - use one of the avfilter_graph_parse*() functions, which take a (typically end-user-written) string, split it into individual filter definitions+options, then create filters, apply options, initialize filters, and finally link them - all based on information from this string. A major problem with the second approach is that it performs many actions as a single atomic unit, leaving the caller no space to intervene in between. Such intervention would be useful e.g. to - modify filter options; - supply hardware device contexts; both of which typically must be done before the filter is initialized. Callers who need such intervention are then forced to invent their own filtergraph parsing, which is clearly suboptimal. This commit aims to address this problem by adding a new modular filtergraph parsing API. It adds a new avfilter_graph_segment_parse() function to parse a string filtergraph description into an intermediate tree-like representation (AVFilterGraphSegment and its children). This intermediate form may then be applied step by step using further new avfilter_graph_segment*() functions, with user intervention possible between each step.
* tools: add general_assembly.plJ. Dekker2023-02-121-0/+3
| | | | | | | | This script generates the current general assembly voters according to the criteria of '20 commits in the last 36 months'. Signed-off-by: J. Dekker <jdek@itanimul.li> Signed-off-by: Anton Khirnov <anton@khirnov.net>
View Lorry Controller Status