Update project page

The project page needs an update - it is still mainly describing 7.x-2.x functionalities, and 7.x-3.x and 8.x-3.x are quite different.

Tasks:

1. Update the project description
2. Remove broken links to demo/home project page (see #1843878: Demonstration link dead? and #2468469: Try out a demonstration and Look at screenshots links not working
3. Promote 7.x-3.x to recommended release for Drupal7

--------------------------------------------------------------------------------

CURRENT project page

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.
• Backgrounds:
  • Define a color or simply have a transparent background.
  • Use a pre-made image to integrate directly with your theme.
  • Use another Textimage preset to achieve a multi-layered image (see image above).
• CCK and Views formatter integration:
  • CCK Textfield widget support.
  • Email module widget support.
• Support for non-alphanumeric characters.

Requirements:

• GD2
• FreeType

Usage:

1. via theme_textimage_image():

   Use the theme_textimage_image() function at the theme/module level with the following format:
   theme('textimage_image', 'Preset', 'Text', array('Additional', 'Text'), 'extension', 'alt', 'title')

2. via CCK/Views formatter:

   Select a Textimage preset in a text field display options.

3. via URL:

   Create an image with the URL in following format:
   /[files directory]/textimage/[Preset](/Additional/Text)/[Text].[extension]

   Note: This method can only be used by users with the 'create textimages' permission. 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 detailed above.

Tutorials:

• HOWTO: Textimage presets for Primary Links menu
• HOWTO: Mouseover labels with Textimage.
• HOWTO: Generate rollover buttons with Textimage.

Notes:

• Due to certain changes in the Textimage module, some of your presets may require alterations after updating.
• Always run update.php on your Drupal site after updating Textimage.

--------------------------------------------------------------------------------

TO-BE project page

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.