PHP 8.1.0 RC 4 available for testing


(PECL imagick 2, PECL imagick 3)

ImagickDraw::setTextUnderColorSpecifies the color of a background rectangle


public ImagickDraw::setTextUnderColor(ImagickPixel $under_color): bool

This function is currently not documented; only its argument list is available.

Specifies the color of a background rectangle to place under text annotations.



the under color

Return Values

No value is returned.


Example #1 ImagickDraw::setTextUnderColor() example

function setTextUnderColor($strokeColor$fillColor$backgroundColor$textUnderColor) {
$draw = new \ImagickDraw();

$draw->annotation(5075"Lorem Ipsum!");
$draw->annotation(50175"Lorem Ipsum!");

$imagick = new \Imagick();


header("Content-Type: image/png");


add a note add a note

User Contributed Notes 1 note

www dot query at gmail dot com
10 years ago
When wishing to print some text on a photograph and make that text sufficiently contrasting to the background image, use a 4 byte code for colour and transparency.

It is the same 4 byte code using by the parameter '-undercolor' in ImageMagick's command lime instruction 'convert'.

The first 3 bytes are the RGB colour code and the fourth byte is the transparency byte.


= new ImagickDraw();


The example code produces yellow text on a semi-transparent red background.
To Top