VIPSEDIT(1) General Commands Manual VIPSEDIT(1)

# [NAME](#NAME)

vipsedit - edit header of a vips image file

# [SYNOPSIS](#SYNOPSIS)

**vipsedit \[OPTION...] vipsfile**

# [DESCRIPTION](#DESCRIPTION)

**vipsedit** alters a VIPS image file's header. This is useful for setting the resolution, for example.

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

Be very careful when changing Xsize, Ysize, BandFmt or Bands. vipsedit does no checking!

# [EXAMPLES](#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)](/man/os/libvips/vipsheader.1),** edit it, and reattach with **[vipsedit(1)](/man/os/libvips/vipsedit.1).**

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

# [RETURN VALUE](#RETURN_VALUE)

returns 0 on success and non-zero on error.

# [SEE ALSO](#SEE_ALSO)

[vipsheader(1)](/man/os/libvips/vipsheader.1)

# [COPYRIGHT](#COPYRIGHT)

K. Martinez 1993

30 June 1993

---

Document: vipsedit(1) from libvips 8.18.7-r3 (Chainguard OS)
Source: https://github.com/libvips/libvips