Re: [FFmpeg-devel] [RFC] Shaping the AVTextFormat API Surface

["softworkz ." <softworkz-at-hotmail.com@ffmpeg.org>]

> -----Original Message-----
> From: ffmpeg-devel <ffmpeg-devel-bounces@ffmpeg.org> On Behalf Of Stefano
> Sabatini
> Sent: Sonntag, 4. Mai 2025 17:33
> To: FFmpeg development discussions and patches <ffmpeg-devel@ffmpeg.org>
> Subject: Re: [FFmpeg-devel] [RFC] Shaping the AVTextFormat API Surface
> 
> On date Tuesday 2025-04-29 10:30:55 +0200, Nicolas George wrote:
> > Stefano Sabatini (HE12025-04-27):
> > > Elaborating on this. ffprobe/textformat is based on a notion of
> > > hierarchical tree-like data
> >
> 
> > No, this is not true. FFprobe and all its supporting code is based on
> > one level of hierarchy. Just one level, not a real hierarchical
> > structure.
> 
> I don't understand this claim. There is a root, and each section can
> have several subsections, so it is a tree in my view, although we set
> a maximum depth.


It even goes slightly beyond being a simple tree representation. 
With the various section flags it is possible to further define the 
relations between various nodes like 1-to-1 or 1-to-many and the extensions
for graph printing even allow to designate a certain field as a unique
identifier or as a field representing a relation (kind of a "foreign key").

This diagram (created by yet-unsubmitted code) shows the FFprobe schema
as an Entity-Relationship diagram with markers indicating the kind of 
relation:

https://softworkz.github.io/ffmpeg_output_apis/ffprobe_schema.html
(the fields per entity are incomplete)


Same for the graph printing schema:

https://softworkz.github.io/ffmpeg_output_apis/graph_schema.html
(fields are complete, relationship identifiers marked with PK and FK)


Background:
https://github.com/softworkz/ffmpeg_output_apis/wiki/Schema-Self-Printing


Best regards,
sw






_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
https://ffmpeg.org/mailman/listinfo/ffmpeg-devel

To unsubscribe, visit link above, or email
ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".