Textimage

Component ID

52349

Component name

Textimage

Component type

module

Maintenance status

Development status

Component security advisory coverage

covered

Downloads

31702

Component created

Component changed

Component body

Textimage adds text to image functionality using GD2 and FreeType, enabling users to create crisp images on the fly for use as theme objects, headings or limitless other possibilities.

Features:

  • Support for TrueType fonts and OpenType fonts.
  • Rotate text at any angle.
  • Automatic text wrapping when using maximum width.
  • Configurable opacity in text color.
  • Support for non-alphanumeric characters.
  • Backgrounds:
    • Define a color or simply have a transparent background.
    • Use a pre-made background image.
    • Chain Textimage effects to achieve a multi-layered image (see image above).
  • Content Type field display formatters:
    • Support Image and Text fields.
    • 7.x-2.0 supports Email module provided fields.
  • 7.x-3.x and 8.x provide tokens to retrieve Textimage URIs/URLs to be used e.g. in metatags or other integrations.

Requirements:

  • For all versions: PHP compiled with GD extension and FreeType support.
  • 7.x-3.x and 8.x: these versions integrate with the Image API, and define/use image effects included in image styles to process text into images. Drupal's core Image module is required.
  • 7.x-3.x: requires Drupal's core Color module, as well as ImageCache Actions and ImageCache Canvas Actions modules.
  • 8.x: requires the image effects included in the Image Effects module.

Usage:

There are 3 main ways to use Textimage.

  1. via Content Type field display formatters.
  2. via the Textimage API and the theme system.
  3. via direct URL generation - Note: This method can only be used by users with a specific permission that has to be granted. This is to prevent Anonymous users from creating random images. If you need dynamically created Textimages, it is strongly advised you use one of the methods above.

Please refer to each release's README.txt for version specific instructions.

Notes:

  • Always check release notes when updating to a new release and follow upgrade instructions if necessary.