Add text to an existing or new image. PHP >= 7.0
$text1 = Text::from('Text One')->color(231, 81, 0);
$text2 = Text::from('Text Two')->color(130, 146, 145)->position(260, 35);
$text3 = (new Text('Text Three'))->set(150, 0, [0, 0, 252], '', 10, 1, 1, [50, 205, 50]);
$text = Text::from('Text!')
->position(170, 150)
->font(20, __DIR__ . '/sweet purple.otf')
->shadow(2, 2, [255])
->color(255,255, 0)
->rotate(20);Writing to existing image
{
header("Content-Type: image/png");
echo (new TextToImage(__DIR__ . '/default.png'))->addTexts($text1, $text2, $text3, $text)->render();
}
// Or save to a file
(new TextToImage(__DIR__ . '/default.png'))->addTexts($text1, $text2, $text3, $text)->render(__DIR__ . '/tmp.png')Writing to a new image:
{
header("Content-Type: image/png");
echo (new TextToImage())->setDimension(350, 350)->setBackgroundColor(0, 0, 0)->addTexts($text1, $text2, $text3, $text)->render();
}
// Or save to a file
(new TextToImage())->setDimension(350, 350)->setBackgroundColor(0, 0, 0)->addTexts($text1, $text2, $text3, $text)->render(__DIR__ . '/tmp.png');Writing with background layer:
$text = Text::from('Text example')->position(10, 25);
$bg_layer = BackgroundLayer::create()->color(0,0,0, 85)->position(0,0,null, 40);
$text_to_image = new TextToImage(__DIR__ . '/default.png');
$text_to_image->addTexts($text)->addBackgroundLayer($bg_layer)->render(__DIR__ . '/tmp.png');Example function:
/**
* Print text on image with background layer. Supports multiline.
* @param $path string Image path
* @param $text string Text that splitted with "\r\n" will be wrapped on next line.
* @param $text_position string 'top' - text will be on the top of image, 'bottom' - on the bottom
* @return bool
*/
public static function setText($path, $text, $text_position = 'top')
{
$bg_layer_y2 = 0;
$bg_layer_y_increment = 29;
$text_font_size = 14;
$font_path = 'arial.ttf'; //path to your font
$pos_x = 10;
$pos_y_increment = 25;
$pos_y = 0;
$bg_layer_x = 0;
$bg_layer_y = 0;
$text_image = new TextToImage($path);
$max_length = number_format(0.075 * $text_image->getWidth()); // 75 letter / 1000px
if ($text_position == 'bottom') {
$pos_y = $text_image->getHeight() + $pos_y_increment / 1.5;
$bg_layer_y = $text_image->getHeight();
$bg_layer_y2 = null;
}
$text_array_tmp = explode("\r\n", $text);
$text_array = [];
foreach ($text_array_tmp as $tmp_value) { //generating array of rows based on the letters count
while (mb_strlen($tmp_value) > $max_length) {
$offset = mb_strpos($tmp_value, ' ', $max_length);
if ($offset === false) {
break;
}
$sub_text = mb_substr($tmp_value, 0, $offset);
$text_array[] = $sub_text;
$tmp_value = mb_substr($tmp_value, $offset);
}
$text_array[] = $tmp_value;
}
unset($text_array_tmp);
if ($text_position == 'bottom') {
$text_array = array_reverse($text_array);
}
foreach ($text_array as $value) { //printing text
if ($text_position == 'bottom') {
$pos_y -= $pos_y_increment;
$bg_layer_y -= $bg_layer_y_increment;
} else {
$pos_y += $pos_y_increment;
$bg_layer_y2 += $bg_layer_y_increment;
}
$txt1 = Text::from($value)->position($pos_x, $pos_y)->font( $text_font_size, $font_path, true);
$text_image->addTexts($txt1);
}
$bg_layer = BackgroundLayer::create()->color(0, 0, 0, 85)->position($bg_layer_x, $bg_layer_y, null, $bg_layer_y2); //printing bg layer
$text_image->addBackgroundLayer($bg_layer);
$text_image->render($path);
}TextToImage::__construct(string $from = '')
Description: Creates TextToImage instance.
| Params | Description |
|---|---|
| from | The image text will be added to. If not specified a blank image 200x200 will be created |
TextToImage::setDimension(int $width, int $height): TextToImage
Description: Set background image dimension. Note: This is not evaluated if $from argument is passed to the constructor
| Params | Description |
|---|---|
| width | The width of the background image. |
| height | The height of the background image. |
TextToImage::setBackgroundColor(int $r = 255, int $g = 255, int $b = 255, int $a = 255): TextToImage
Description: Set the background color of created background image. Note: This is not evaluated if $from argument is passed to the constructor.
| Params | Description |
|---|---|
| r | Value of red component. |
| g | Value of green component. |
| b | Value of blue component. |
| a | A value between 0 and 255. 255 indicates completely opaque while 0 indicates completely transparent. |
TextToImage::addTexts(Text $text, Text ...$texts): TextToImage
Description: Adds text to specified or generated background image.
| Params | Description |
|---|---|
| text | Text to add to image |
| texts | Further Text to add to image |
Multiple text can all be added at once or over steps.
$hello = Text::from('Hello');
$world = Text::from('World')->position(0, 15);
$foo = Text::from('Foo')->position(0, 30);
$bar = Text::from('Bar')->position(0, 45);
$foobar = Text::from('Foobar')->position(0, 60)->color(255, 0, 0);
$text_image = new TextToImage();
$text_image->addTexts($hello, $world, $foo);
$text_image->addTexts($bar);
echo $text_image->setBackgroundColor(0, 0, 0)->addTexts($foobar)->render();TextToImage::render(string $save_as = null, string $ext = null): string
Description: Renders modified image to a file or return contents.
| Params | Description |
|---|---|
| save_as | If specified, image content will be saved at the provided path.. |
| ext | Image processor. possible values: jpg, jpeg, png or gif. |
Text::__construct(string $from = '') or Text::__from(string $text): Text
Description: Creates Text instance.
| Params | Description |
|---|---|
| text | The text that will be written on image. |
Text::position(int $x, int $y = 0): Text
Description: Sets the position of specified text on image.
| Params | Description |
|---|---|
| x | The X position. |
| y | The Y position. |
Text::font(int $size, string $path = null): Text
Description: Sets the font/size of specified text.
| Params | Description |
|---|---|
| size | The font size of text. |
| path | The path to font file. |
Text::color(int $r = 255, int $g = 255, int $b = 255, int $a = 255): Text
Description: Sets the color of specified text.
| Params | Description |
|---|---|
| r | Value of red component. |
| g | Value of green component. |
| b | Value of blue component. |
| a | A value between 0 and 255. 255 indicates completely opaque while 0 indicates completely transparent. |
Text::shadow(int $position_x = null, int $position_y = null, array $color = []): Text
Description: Adds shadow to specified text.
| Params | Description |
|---|---|
| position_x | The shadow's X position. |
| position_y | The shadow's Y position. |
| color | Array [r(red), g(green), b(blue), a(alpha)] See color method. |
Text::from('FooBar')->shadow(1, 1, [0, 0, 255]);
// Create Text with half the max opacity
Text::from('FooBar')->shadow(1, 1, [0, 0, 255, 255 / 2]);Text::rotate(float $degrees): Text
Description: Rotates specified text to a specific angle.
| Params | Description |
|---|---|
| degrees | The angle in degrees. |
Text::update(Closure $closure): Text
Description: Runtime text update.
| Params | Description |
|---|---|
| degrees | The function to call before render. If specified, this closure will be called with three arguments TextToImage, Text and GdFont |
$text = Text::from('FooBar')->shadow(1, 1, [0, 0, 255]);
$text->update(function (TextToImage $text_to_image, Text $text, $image) {
// Basic centering of text.
$text->position(intval($text_to_image->getHeight() / 2), intval($text_to_image->getWidth() / 2));
});