---
name: "im_falsecolour"
section: "3"
platform: "linux"
package: "libvips-dev"
version: "7.20.7-1+b3"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/im_falsecolour"
---

# im\_falsecolour(3)

colour a mono image

## NAME

im\_falsecolour - colour a mono image

## SYNOPSIS

**#include \<vips/vips.h\>**

**int im\_falsecolour(in, out)**\
 **IMAGE \*in, \*out;**

## DESCRIPTION

Turns a one-band unsigned char image into a three band unsigned char image. The colour scale is stolen from a PET scan and has red for hot, green for normal and blue for cold.

## RETURN VALUE

0 on success and -1 on error.

## SEE ALSO

[im\_disp2XYZ(3)](/im_disp2XYZ/3.md), etc.

## COPYRIGHT

National Gallery

## AUTHOR

J. Cupitt