PHP 7.0.6 Released

ImagickDraw::annotation

(PECL imagick 2.0.0)

ImagickDraw::annotationDraws text on the image

Description

bool ImagickDraw::annotation ( float $x , float $y , string $text )
Warning

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

Draws text on the image.

Parameters

x

The x coordinate where text is drawn

y

The y coordinate where text is drawn

text

The text to draw on the image

Return Values

No value is returned.

User Contributed Notes

Anonymous
6 years ago
Here's how to create a header image and write it to file.  This took me a while to figure out.  I hope this helps.

<?php

/* Text to write */
$text = "Hello World!";

/* Create Imagick objects */
$image = new Imagick();
$draw = new ImagickDraw();
$color = new ImagickPixel('#000000');
$background = new ImagickPixel('none'); // Transparent

/* Font properties */
$draw->setFont('Arial');
$draw->setFontSize(50);
$draw->setFillColor($color);
$draw->setStrokeAntialias(true);
$draw->setTextAntialias(true);

/* Get font metrics */
$metrics = $image->queryFontMetrics($draw, $text);

/* Create text */
$draw->annotation(0, $metrics['ascender'], $text);

/* Create image */
$image->newImage($metrics['textWidth'], $metrics['textHeight'], $background);
$image->setImageFormat('png');
$image->drawImage($draw);

/* Save image */
file_put_contents('/path/to/file.png', $image);
?>
use_contact_form at Jonas-Kress dot de
6 years ago
may help someone...

<?php
   
/**
     * Split the given text into rows fitting the given maxWidth
     *
     * @param unknown_type $draw
     * @param unknown_type $text
     * @param unknown_type $maxWidth
     * @return array
     */
   
private function getTextRows($draw, $text, $maxWidth)
    {       
       
$words = explode(" ", $text);
       
       
$lines = array();
       
$i=0;
        while (
$i < count($words))
        {
//as long as there are words

           
$line = "";
            do
            {
//append words to line until the fit in size
               
if($line != ""){
                   
$line .= " ";
                }
               
$line .= $words[$i];
               
               
               
$i++;
                if((
$i) == count($words)){
                    break;
//last word -> break
               
}
               
               
//messure size of line + next word
               
$linePreview = $line." ".$words[$i];
               
$metrics = $this->canvas->queryFontMetrics($draw, $linePreview);
               
//echo $line."($i)".$metrics["textWidth"].":".$maxWidth."<br>";
               
           
}while($metrics["textWidth"] <= $maxWidth);
           
           
//echo "<hr>".$line."<br>";
           
$lines[] = $line;
        }
       
       
//var_export($lines);
       
return $lines;
    }
?>
web at synaptech dot fr
2 years ago
In some cases the (custom) font can be truncated on the side parts, especially the handwritten ones.
To improve the above note from Anonymous on "how to create a header image", I've changed this part of the code:

<?php
/* Create text */
$draw->annotation( $metrics['boundingBox']['y2'], $metrics['ascender'], $text );

/* Create image */
$image->newImage( $metrics['textWidth'] + $metrics['boundingBox']['y2'], $metrics['textHeight'], $background );
?>
Anonymous
6 years ago
You can use this method to break your text so that it'll fit a certain $maxWidth.

<?php
/**
* @param string $text
* @param int $maxWidth
*/
protected function _fitText($text, $maxWidth)
{
   
$im = new Imagick();
   
$im->newImage($this->_width, $this->_height, "none");

   
$lines = explode(PHP_EOL, trim($text));
   
$DEBUG_LOOP = 0;

    for (
$k = 0; $k < count($lines); ++$k) {
        do {
           
$drawText = new ImagickDraw();
           
// set your font settings like size, family, .. here
           
$metrics  = $im->queryFontMetrics($drawText, $lines[$k]);
           
$fits     = $metrics["textWidth"] <= $maxWidth;

            if (
$fits) {
                break;
            }

           
$pos = mb_strrpos($lines[$k], " ");
            if (
$pos === false) {
                throw new
RuntimeException("can not make it fit");
            }
            if (!isset(
$lines[$k + 1])) {
               
$lines[$k + 1] = null;
            }
           
$lines[$k + 1] = trim(mb_substr($lines[$k], $pos + 1) . " " . $lines[$k + 1]);
           
$lines[$k]     = trim(mb_substr($lines[$k], 0, $pos));

            if (++
$DEBUG_LOOP >= 200) {
                throw new
RuntimeException("infinite loop");
            }
        } while (!
$fits);
    }
   
$text     = implode(PHP_EOL, $lines);
   
$drawText = new ImagickDraw();
   
// set your font settings like size, family, .. here again!
   
$metrics  = $im->queryFontMetrics($drawText, $text);
   
$metrics["text"] = $text;
   
assert('$metrics["textWidth"] <= $maxWidth');
    return
$metrics;
}
?>
To Top