* Permission is hereby granted, free of charge, to any person obtaining a copy of * this software and associated documentation files (the "Software"), to deal in the * Software without restriction, including without limitation the rights to use, * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the * Software, and to permit persons to whom the Software is furnished to do so, * subject to the following conditions: * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. * * PHP version 5 * * @category Andrewgjohnson * @package Linebreaks4imagettftext * @author Andrew G. Johnson * @copyright 2018-2022 Andrew G. Johnson * @license https://opensource.org/licenses/mit/ The MIT License * @link https://github.com/andrewgjohnson/linebreaks4imagettftext */ namespace andrewgjohnson; if (!function_exists('andrewgjohnson\\linebreaks4imagettftext')) { /** * Linebreaks4imagettftext is a function to automatically insert line breaks into * your text while using PHP's imagettftext function * * @param float $size

The font size. Depending on your version * of GD, this should be specified as the pixel size (GD1) or point size * (GD2).

* @param float $angle

The angle in degrees, with 0 degrees * being left-to-right reading text. Higher values represent a counter- * clockwise rotation. For example, a value of 90 would result in bottom-to- * top reading text.

* @param string $fontfile

The path to the TrueType font you wish * to use.

Depending on which version of the GD library PHP is using, * when fontfile does not begin with a leading / then .ttf will be appended * to the filename and the library will attempt to search for that filename * along a library-defined font path.

When using versions of the GD * library lower than 2.0.18, a space character, rather than a semicolon, was * used as the 'path separator' for different font files. Unintentional use * of this feature will result in the warning message: Warning: Could not * find/open font. For these affected versions, the only solution is moving * the font to a path which does not contain spaces.

* @param string $text

The text string in UTF-8 encoding.

May include decimal numeric character references (of the form: * €) to access characters in a font beyond position 127. The * hexadecimal format (like ©) is supported.Strings in UTF-8 * encoding can be passed directly.

Named entities, such as ©, * are not supported. Consider using html_entity_decode to decode these named * entities into UTF-8 strings.

If a character is used in the string * which is not supported by the font, a hollow rectangle will replace the * character.

* @param int $maximumWidth

The maximum width (in pixels) a line * should be before adding a line break.

* @param int $lineBreakCharacter

The character(s) to use when adding a * line break (default is PHP_EOL).

* * @return string Returns a string that is nearly identical to $text; the only * difference is the newly added line breaks. */ function linebreaks4imagettftext( $size, $angle, $fontfile, $text, $maximumWidth, $lineBreakCharacter = PHP_EOL ) { // create an array with all the words $words = explode(' ', $text); // process all our words to generate $textWithLineBreaks $textWithLineBreaks = ''; $currentLine = ''; foreach ($words as $position => $word) { // place the first word into $currentLine without any processing (we // always want to include the first word on the first line--obviously) if ($position === 0) { $currentLine = $word; } else { // calculate the text's size if we were to add the word $textDimensions = imagettfbbox( $size, $angle, $fontfile, $currentLine . ' ' . $word ); $textLeft = min($textDimensions[0], $textDimensions[6]); $textRight = max($textDimensions[2], $textDimensions[4]); $textWidth = $textRight - $textLeft; if ($textWidth > $maximumWidth) { // the text is too wide with the added word so we add a line // break then start a new line with only the added word $textWithLineBreaks .= $currentLine; $textWithLineBreaks .= $lineBreakCharacter; $currentLine = $word; } else { // we have space on the current line for the added word so we // add a space then the word $currentLine .= ' '; $currentLine .= $word; } } } // the current line is still unadded to $textWithLineBreaks so we add it $textWithLineBreaks .= $currentLine; // return $text with line breaks added return $textWithLineBreaks; } }