atisplit(1)

📦 version 0.0.5, in debian trixie, ubuntu questing

✨ NAME ✨

atisplit — a lil conversion utility from the GATOS package 🎀 (yes bestie, it's giving "one job, does it well")

🌸 SYNOPSIS 🌸

atisplit

That's it. No flags, no args, no drama. She just goes 💅

🦋 DESCRIPTION 🦋

Okay so, atisplit is a tiny utility that takes a gatos capture file — you know the one, gatos.yuv — and converts it into a whole series of yuv frames. And those frames? They're literally made to be fed into the mpeg_encode program. Iconic pipeline behavior, no cap. 🔥

You can get mpeg_encode over on metalab at http://www.metalab.unc.edu/.

⚠️ Now listen up because this part is lowkey important: mpeg_encode uses yuv files that only have a quarter of the cb and cr fields. Which means the output files carry less information than the input file did. Concretely: the total size of the output files should end up just a touch below 3/4 of the size of the input file. That's not a bug, that's just the math, bestie. 📉

💖 USAGE 💖

Here's the whole ritual, step by step:

  1. Start the "TV in a Window" application:
./xatitv &

and capture whatever your heart desires. Then:

atisplit

and atisplit furiously prints out frames. FURIOUSLY. She's not chill about it. 😤✨

  1. You must edit the default.lparam file (peep the next section, it's all there).
  2. And then:
mpeg_encode default.lparam

and boom — that produces your output.mpg MPEG file. Slay. 🎬

👑 MPEG_ENCODE CONFIGURATION FILE 👑

Here's a sample default.lparam file you can copy the vibe of:

#
# use this as a guideline for any parameters you
# don't really understand or don't care about.
#

PATTERN         IBBPBBPBBPBBPBB
OUTPUT          output.mpg

BASE_FILE_FORMAT        YUV
GOP_SIZE                10
SLICES_PER_FRAME        1

PIXEL                   HALF
RANGE                   10
PSEARCH_ALG             LOGARITHMIC
BSEARCH_ALG             CROSS2
IQSCALE                 8
PQSCALE                 10
BQSCALE                 25

REFERENCE_FRAME         ORIGINAL

#
# you really need to understand the following
#
YUV_SIZE                320x240
INPUT_CONVERT           *

INPUT_DIR               ./

INPUT
tv*.yuv                 [000001-000100]
END_INPUT
🫶 Real talk: the block up top is just a guideline for the parameters you don't really understand or don't care about. The block at the bottom — the one that says you really need to understand it — yeah. You really need to understand it. 😭

🎀 FILES 🎀

  • default.lparam
  • output.mpg

🌈 SEE ALSO 🌈

gatos, gatos-conf, atitv, atitogif, atitojpg, atitoppm, xatitv, yuvsum, scanpci.

(Go read those too, bestie, it's a whole ecosystem 💜)

⭐ AUTHORS ⭐

Atisplit was written and copyrighted by Steaphan Greene, Øyvind Aabling, Octavian Purdila, Vladimir Dergachev, Christian Lupien, and Daniel Caujolle-Bert. A whole squad. Legends only. 👑

And that's the tea! 🍓 This page came to you from the <b>GATOS Manual</b>, dated <b>20 Dec 1999</b> — yeah she's vintage, she's an elder, she's still serving 💅 — filed under atisplit(1). Mwah, go make some MPEGs. ✨🎀

📦 where this page comes from