CF_PictureFrame

DESCRIPTION

can be used to create an artistic looking frame around any picture or text area. The picture can be any size: the tag will adust the frame to completely and precisely englobe the picture.

CF_PictureFrame does not modify or generate a new picture. Instead, it uses an image of the frame divided into small parts, some of them being repeated or extended to make the final frame fit exactly around the picture.

More than 60 different styles are available, most of them are taken from real frame pictures. Every style can be displayed with or without a shadow effect.

Between the frame and the image, any number of liners (fillets) can be specified in a list -- although a number between 1 and 3 is more reasonable --. Using liners, one can design many different frames from the same style.

NOTE

For any problem or suggestion, please contact the author of the tag.

INSTALLATION

In order to use this Custom Tag, just store the files found in templates.zip

pictureFrame\pictureFrame.cfm
pictureFrame\pictureLiner.cfm
pictureFrame\getFrameMetrics.cfm
pictureFrame\FrameRepeatH.cfm
pictureFrame\FrameRepeatV.cfm

in the special Custom Tags directory in your ColdFusion server. This directory is generally named \Cfusion\CustomTags. You may also store the file in a directory defined as a path for custom tags in the ColdFusion Administrator (CF 5.0+) or in the same directory as the calling template.

The first file is the main tag, the others are sub tags called by the first.

Then, you have to store the imagelets used by the tag and found in imagelets.zip somewhere inside the HTTP domain in your server, ie. PictureFrame\... or images\pictureFrame\...

Most Important:

All imagelets must be stored in the genuine subdirectories; no one should be renamed, and no one should be added. These subdirectory names are actually the different styles you can use.

If you do not see the examples below correctly, your tag is not installed properly.
Go to http://customtags/internetique.ca/CustomTags.cfm to read this document on line.

SYNTAX

<CF_PictureFrame STYLE = "" WIDTH = "" HEIGHT = "" LINER = "" ANNEXDIR = "" SCALEFACTOR = "" SHADOW = "" ALIGN = "" VALIGN = "" > ... any text or image here ... </CF_PictureFrame>

Example

<CF_PictureFrame STYLE="BaroqueMahogany" WIDTH="396" HEIGHT="330" LINER="LinenBeige,RopeGold"> <IMG SRC="Trees.jpg" WIDTH="396" HEIGHT="330" BORDER="0" ALT=""> </CF_PictureFrame>

TAG	ATTRIBUTE	CONTENT	REQUIRED	DEFAULT
<CF_PictureFrame	STYLE=	Style of the frame to be used. See all avilable style in the frameBuilder	No
	WIDTH=	Width of the inside of frame. If the frame is to be generated outside an image, this width should be the same as the image width. If the frame will contain a text area, this is the width of this area.	Yes
	HEIGHT=	Height of the inside of frame. Same note as above.	Yes
	LINER=	List of liner styles to add between the image and the frame. Any number of liners can be given, although the result will be in consequence... one, two or three is more likely to give nice results. Test it with the frameBuilder. NOte that the styles names for the frames and for liners are generally not the same.	No
	ANNEXDIR=	Path where the subdirestories containing the images used by the tag are on the HTTP server. The path is relative to the page calling the tag. If for example the page is in www.myDomaine.com/museum/louvre/joconde.cfm and the style images directories are under www.myDomaine.com/frames then the ANNEXDIR attribute should contain "../frames/"	No
	SCALEFACTOR=	A percentage amount the imagelets used to build the frame will be scaled to. With values higher than 100 the quality of images will decrease. 150 seems to be a reasonable maximum. With higher values, the frame will not fit in the page anyway. For smaller images, scale factors like 75, or 50 can be used. Note that the scale factor applies only to the frame, not to the liners inside the frame, nor the image inside the liners.	No	100
	SHADOW="Yes"\|"No"	Use this attribute to add a shadow effect. Note: with no shadow effect, only gif files are used, width transparent background. The frame will look better on a pale than on a dark background. with a shadow effect, JPEG images are used on the right and bottom edges of the frame. This shadow has been produced on a white background and only white bakground should be used under the frame in that case.	No	"No"
	ALIGN="left"\|"center"\|"right"	This can be used with frames intended to contain only text. The frame is then equivalent to a TD block in a table, and the text will be aligned left horizontally and middle vertically by default.	No	left
	VALIGN="top"\|"middle"\|"bottom"	See "ALIGN" above.	No	middle

NOTES

1. The frame style is not a mandatory attribute, but at least one liner should be specified. When only liners are used, the shadow attribute and the scale factor have no effet. Using only one liner, very small and simple frames can be defined, like this one.

2. More elaborated frames can also be designed using a larger number of liners, like this one.