VIPSEDIT(1)

✨ VIPSEDIT ✨

okay bestie, so vipsedit is a General Commands Manual girlie and she's here to help you mess with the header of a vips image file πŸ’…


🌸 NAME 🌸

vipsedit β€” edit header of a vips image file πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

vipsedit [OPTION...] vipsfile

πŸ’– DESCRIPTION πŸ’–

so like, vipsedit alters a VIPS image file's header. it's giving "i just need to change one little thing" energy ✨ β€” super useful for setting the resolution, for example. no cap.

The options are:

  • -x, --xsize=N β€” set Xsize to N πŸ’«
  • -y, --ysize=N β€” set Ysize to N πŸ’«
  • -b, --bands=N β€” set Bands to N πŸ’«
  • -f, --format=F β€” set BandFmt to F (eg. uchar) πŸ’«
  • -i, --interpretation=I β€” set Interpretation to I (eg. xyz) πŸ’«
  • -c, --coding=C β€” set Coding to C (eg. labq) πŸ’«
  • -X, --xres=R β€” set Xres to R pixels/mm πŸ’«
  • -Y, --yres=R β€” set Yres to R pixels/mm πŸ’«
  • -u, --xoffset=N β€” set Xoffset to N πŸ’«
  • -v, --yoffset=N β€” set Yoffset to N πŸ’«
  • -e, --setext β€” replace extension block with stdin πŸ’«
🚨 OKAY BESTIE LISTEN UP 🚨 be very careful when changing Xsize, Ysize, BandFmt or Bands. vipsedit does no checking! like... none. zero. she is not your bodyguard, she is your accomplice πŸ’€

πŸŽ€ EXAMPLES πŸŽ€

To set the Xsize to 512 and Bands to 6:

vipsedit --xsize=512 --bands=6 fred.v

or

vipsedit -x 512 -b 6 fred.v

Extract the XML metadata from an image with vipsheader(1), edit it, and reattach with vipsedit(1).

vipsheader -f getext fred.v | sed s/banana/pineapple/ | vipsedit -e fred.v

like... banana ➑️ pineapple?? that's the pipeline of the century fr fr πŸ“βœ¨


🌈 RETURN VALUE 🌈

returns 0 on success and non-zero on error. simple as that, periodt πŸ’…


πŸ‘‘ SEE ALSO πŸ‘‘


K. Martinez 1993


okay that's the whole vibe, bestie β€” go forth and edit those headers responsibly 🫢

this iconic little page comes to you from the General Commands Manual, dated 30 June 1993 (yes, she's vintage, she's a classic, she ate and left no crumbs 🌸), and this whole manual page is the VIPSEDIT(1) moment βœ¨πŸ’–πŸ§š