PHP Conference Nagoya 2025

Imagick::annotateImage

(PECL imagick 2, PECL imagick 3)

Imagick::annotateImageCria anotação em uma imagem com texto

Descrição

public Imagick::annotateImage(
    ImagickDraw $draw_settings,
    float $x,
    float $y,
    float $angle,
    string $text
): bool

Cria anotação em imagem com texto.

Parâmetros

draw_settings

O objeto ImagickDraw que contém configurações para desenhar o texto

x

Deslocamento horizontal em pixels à esquerda do texto

y

Deslocamento vertical em pixels até a linha de base do texto

angle

O ângulo em que o texto deve ser escrito

text

A string a ser desenhada

Valor Retornado

Retorna true em caso de sucesso.

Exemplos

Exemplo #1 Usando Imagick::annotateImage():

Anotando texto em uma imagem vazia

<?php
/* Cria alguns objetos */
$image = new Imagick();
$draw = new ImagickDraw();
$pixel = new ImagickPixel( 'gray' );

/* Nova imagem */
$image->newImage(800, 75, $pixel);

/* Texto preto */
$draw->setFillColor('black');

/* Propriedades da fonte */
$draw->setFont('Bookman-DemiItalic');
$draw->setFontSize( 30 );

/* Cria texto */
$image->annotateImage($draw, 10, 45, 0, 'The quick brown fox jumps over the lazy dog');

/* Dá um formato à imagem */
$image->setImageFormat('png');

/* Mostra a imagem com cabeçalho */
header('Content-type: image/png');
echo
$image;

?>

Veja Também

adicione uma nota

Notas Enviadas por Usuários (em inglês) 4 notes

up
9
alan at ridersite dot org
17 years ago
If ImagickDraw::setGravity ( int $gravity ) has been set, e,g; with $gravity= imagick::GRAVITY_CENTER.

Then, the x and y values offset the text from where the gravity setting would have placed it.

If the example included: $draw->setGravity (Imagick::GRAVITY_CENTER);
$image->annotateImage($draw, 10, 45, 0, 'The quick brown fox jumps over the lazy dog');

The text would be rendered to the right 10px and down 45px from the center.

Gravity constants are very useful as they can save having to calculate the placement of variable text strings and font sizes.
up
3
www dot query at gmail dot com
13 years ago
$image->annotateImage($draw, 10, 45, 0, 'The quick brown fox');

If the third parameter, the 'Y' value, is 0, the text will be invisible because the text is printed ABOVE the image - not on the image.

The solution is to start, depending on your chosen font size, with a Y value of about 40 and experiment.

[Also:]

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.

<?php
$picin
= new Imagick($pic1);
$picin->scaleimage(800,0);
$height = $picin->getimageheight();

$draw = new ImagickDraw();
$draw->setFillColor('#ffff00');
$draw->setFont('Eurostile');
$draw->setFontSize(21);
$draw->setTextUnderColor('#ff000088');
$picin->annotateImage($draw,40,$height-10,0,"Hallo");

$picin->writeimage($pic6);
?>

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

$pic1 and $pic6 were previously defined as directory/file strings.
up
1
yakuza88 at op dot pl
8 years ago
Does not work with CMYK color values and images. Only RGB.
up
0
tuxedobob
11 months ago
Note that $angle is in DEGREES and rotates CLOCKWISE. Negative numbers are allowed.
To Top