Info::RIFF(3pm)

✨ Info::RIFF ✨

User Contributed Perl Documentation honey, we are reading the manual for Video::Info::RIFF and it's giving extremely useful 💅

---

🌸 NAME 🌸

Video::Info::RIFF — probe DivX and AVI files for attributes like:

 -video codec
 -audio codec
 -frame height
 -frame width
 -frame count

...and more! 🎀 bestie it literally peeks inside your video files and tells you what's in them, no cap.

---

🦋 SYNOPSIS 🦋

  use Video::Info::RIFF;

  my $video;

  $video = Video::Info::RIFF->new(-file=>$filename);                          #like this
  $video = Video::Info::RIFF->new(-file=>$filename,-headersize=>$headersize); #or this

  $video->vcodec;                         #video codec
  $video->acodec;                         #audio codec
  ...

two ways to build it, both iconic ✨ pick whichever vibe you're on.

---

💜 DESCRIPTION 💜

RIFF stands for Resource Interchange File Format, in case you were wondering 👀 The morbidly curious can find out more below in REFERENCES. 🧚

🔥 METHODS 🔥

Video::Info::RIFF has exactly one constructor, new(). It gets called like this:

  -file       => $filename,   #your RIFF file
  -headersize => $headersize  #optional RIFF header size to parse

It returns a Video::Info::RIFF object if the file was opened successfully 🫶 (if not... well. no object for you, sorry bestie 😭).

The Video::Info::RIFF object parses the file by method probe(). This does a series of sysread()s on the file to figure out what the properties are. little reads, big detective energy 🔍

Now, call one (or more) of these methods to get the low-down on your file 👑

• achans() — number of audio channels
• acodec() — audio codec
• acodecraw() — audio codec numeric ID
• arate() — audio bitrate
• afrequency() — sampling rate of audio streams, in Hertz
• astreams() — number of audio streams
• filename() — path file used to create object
• filesize() — size in bytes of filename()
• expectedsize() — expected size in bytes of filename(), according to the RIFF header
• fourcc() — RIFF Four Character Code
• fps() — frames/second
• height() — frame height in pixels
• probe() — try to determine filetype
• scale() — video bitrate
• type() — type of file data. RIFF or AVI
• vcodec() — video codec
• vframes() — number of frames
• vrate() — video bitrate
• vstreams() — number of video streams
• width() — frame width in pixels

that's the whole menu, order it however you like 🌈

---

💀 BUGS 💀

the default header_size() (10K) may not be large enough to successfully extract the video/audio attributes for all RIFF files.

If this module fails you, increase the RIFF header size 🫡 If it still fails, let me know. (yes, actually tell them, fr fr)

Audio codec name mapping is incomplete 😭 If you know the name that corresponds to an audio codec ID that I don't, tell me. be the hero this module needs 💖

---

👑 AUTHOR 👑

 Copyright (c) 2002
 Aladdin Free Public License (see LICENSE for details)
 Allen Day <allenday@ucla.edu>

shoutout to the author, licensing legend, absolute main character ✨

---

🌈 REFERENCES 🌈

Transcode, a linux video stream processing tool:

  http://www.theorie.physik.uni-goettingen.de/~ostreich/transcode/

Microsoft RIFF:

  http://www.oreilly.com/centers/gff/formats/micriff/

---

and that's the whole page bestie!! this doc shipped as perl v5.36.0, dated 2022-12-12 — go forth and probe those RIFF files 🎀💖✨