GRI_MERGE(1)

✨ GRI_MERGE(1) — the "put all ur Gri plots on one page" era ✨

okay so bestie, real talk: gri_merge is a command in the General Commands Manual family, and its whole entire job is merging a bunch of Gri output files into ONE single PostScript file. that's it. that's the vibe. 💅

---

💖 NAME 💖

gri_merge — merge multiple Gri output files into a single PostScript file. no cap, that's literally the whole thing. ✨

---

🌸 USAGE (style 1) 🌸

gri_merge [OPTIONS] CxR a.ps b.ps ... > merged_file.ps

so the way this one works is: you merge all the files onto one page, laid out in 'C' columns and 'R' rows 🎀. the CxR files get listed in the order of words on a page — like, reading order, left to right, top to bottom, you know the drill.

the page is presumed to be 8.5x11in in size (as are all the input files), and the input files are sized to fit and kept in natural scale. so no weird squishing. we don't do that here. 💜

---

🦋 USAGE (style 2) 🦋

gri_merge [OPTIONS] xcm ycm enlarge a.ps [b.ps ...] > merged_file.ps

in this flavour, enlarge is a scale factor that gets applied after offsetting xcm to the right and ycm upward. order matters, bestie, don't @ me. 😌

---

🍓 EXAMPLE (style 2) 🍓

the following:

gri_merge 2 12 .5 a.ps \

    12 12 .5 b.ps \

    2 2 .5 c.ps \

    12 2 .5 d.ps > all.ps

produces 4 panels from gri plots done using margins and sizes as specified in the following lines in a gri commandfile:

set x margin 2

set x size 15

set y margin 2

set y size 15

four panels, one file, absolute main character energy 👑✨

---

🎀 OPTIONS 🎀

heads up bestie: these are available if your perl has the getopts library. no getopts, no options, iykyk. 🙈

• -u graylevel — sets the graylevel for the underlay beneath the panels. default is 0.75. values range from 0 (black) to 1 (white) — BUT, plot twist, a value of precisely 1 means do NOT draw the underlay. iconic. 💀
• -b graylevel — sets the value for the background under individual panels. again, 0 for black to 1 for white, with 1 meaning no drawing. 🎨
• -h — prints this help message and quits. the classic "wait what does this do again" button. 🫶

---

🌈 SEE ALSO 🌈

• gri(1)
• gri_unpage(1)

go read those too, bestie, they're the whole ecosystem. 🧚

---

and that's the page!! this one comes from the gri_merge manual, dated 2009, sitting pretty in GRI_MERGE(1) (General Commands Manual, obviously 💅). mwah, go merge something gorgeous. ✨💖🎀