Installation guide

CFFORWARD has a single attribute, page, which specifies the URI of the target page. Paths
that start with “/” start at the document root directory of the web application or web
server; paths that don’t start with “/” are relative to the current CFML document:
<CFFORWARD PAGE=”/nextpage.cfm”>
<CFFORWARD PAGE=”nextpage.jsp”>
Like CFLOCATION, processing of the current page is terminated as soon as the CFFORWARD
tag is executed.
4.5.6 CFIMAGE
CFIMAGE is a tag introduced by BlueDragon that allows you to modify an existing GIF or
JPEG image file to produce a new image file that is resized and/or has a text label added
to the image. Variables returned by this tag provide information about the new image file.
The following table lists the
CFIMAGE tag attributes.
Attribute Description
srcFile Required. The file name of the source image file that is to be modified. Can be either a full
physical path or a relative path (see the
URIDirectory attribute).
destFile Required if ACTION=EDIT, Optional if ACTION=INFO. The file name of the new image file to
be created by the CFIMAGE tag. Can be either a full physical path or a relative path (see the
URIDirectory attribute).
action Optional. The action to be taken by the CFIMAGE tag. The value INFO populates the
CFIMAGE variables with information about the image file specified by the
srcFile attrib-
ute without modifying the image. The value of EDIT creates a new image file by resizing
and/or adding a text label to the source image file. Defaults to EDIT.
type Optional. The image file type, either GIF or JPEG. If this attribute is not specified, the
CFIMAGE tag attempts to determine the image type based on the file name extension.
width Optional. The width of the new image, can be specified either in pixels or as a percentage of
the source image width. Defaults to “100%”.
height Optional. The height of the new image, can be specified either in pixels or as a percentage of
the source image height. Defaults to “100%”.
fontSize Optional. An integer value that specified the font size of the text label to be added to the
image. Defaults to 12.
fontColor
Optional. Specifies the font color of the text label to be added to the image. Accepts any
value that is valid for use in the FONT tag. Defaults to “black”.
text Optional. The text label to add to the image.
position Optional. The position of the text label to add to the image; valid valued are “north” and
“south”. Defaults to “south”.
nameConflict
Optional. Indicates the behavior of the CFIMAGE tag when the file specified by
destFile
already exists. Valid values are ERROR, which generates a runtime error; SKIP, which
causes the CFIMAGE tag to do nothing without generating an error; OVERWRITE, to over-
write the existing image; and, MAKEUNIQUE, which causes CFIMAGE to create a new
unique file name for the new image file. Defaults to ERROR.
URIDirectory
Optional. If YES, relative paths specified in
srcFile and destFile are calculated from
the web server document root directory. If NO, relative paths are calculated as relative to the
current file. Defaults to NO.
BlueDragon 6.1 CFML Compatibility and Reference Guide 26