image

Owned by Geoff Bowers
Last updated: Jan 09, 2008Version comment
2 min read

Image

Form tools provide a variety of powerful image manipulation options.

Image field types need to be used in conjunction with a string data type. Formtools expects to store the path to the media asset in the database field.

Attribute

Description

Default Value

ftStyle

Inline style attributes.

(blank)

ftDestination

Location of image; relative to the web root.

/images

ftImageWidth

Width to resize image to.

(blank)

ftImageHeight

Height to resize image to.

(blank)

ftThumbnail

Boolean toggle to pad out the image to the required width/height.

false

ftThumbnailBGColor

Is this replaced by ftPadColor?? Background colour for thumbnail padding. Colour name or web hexadecimal colour code.

white

ftPadColor

Background colour for thumbnail padding. Colour name or web hexadecimal colour code with double ## prefix.

white

ftThumbnailBevel

Apply bevel edge to the thumbnail.

false

ftAutoGenerateType

Options for autogenerating the image.

FitInside or Pad

ftCreateFromSourceDefault

Generate image from source image. Requires ftSourceField to be specified.

false

ftSourceField

Image property from which an autogenerated image should be derived.

A nominated content type property.

ftAllowUpload

Boolean to allow an image to be uploaded for this image. Only relevant if the image can be autogenerated.

Default; true.

Combining Image Properties

You can tie image properties together for generating images of specific dimensions from a source image. A typical example is providing a thumbnail image.

Creating a Thumbnnail from a Source Image
<cfproperty name="imgMugshot" type="string" hint="Mugshot." required="false" default="" 
    ftlabel="Mugshot" fttype="image" ftimagewidth="200" ftdestination="/images/myprofile/imgmugshot" />
<cfproperty name="imgMugshotThumb" type="string" hint="Mugshot thumbnail." required="false" default="" 
    ftlabel="Mugshot Thumb" fttype="image" ftimagewidth="80" ftimageheight="80" ftthumbnail="true" 
    ftCreateFromSourceDefault="true" ftSourceField="imgMugshot" ftdestination="/images/myprofile/imgmugshotthumb" />

Setting Default Date Values

Often you want to designate a default date value that is dynamic and based on the current date or some other environment variable. The simplest approach is to set an ftDefault variable and ftdefaulttype set to evaluate.

Dynamically Setting a Default Date Value
<cfproperty 
  ftseq="12" ftfieldset="Publishing Details" ftwizardStep="General Details" 
  name="expiryDate" type="date" hint="The date that a news object is removed from the web site" required="no" default="" 
  ftDefaultType="Evaluate" ftDefault="DateAdd('d', 5, now())" ftType="datetime" 
  ftDateFormatMask="dd mmm yyyy" ftTimeFormatMask="hh:mm tt" ftToggleOffDateTime="true" ftlabel="Expiry Date" />

default corresponds to the default set in the database. Its a data type default.
ftdefault on the other hand is a formtool default. That is, it relates to the UI control.