Web browsers tend to cache images. This is a browser problem, not an AspImage problem. The only solutions we know of are the following:

1. Add a question mark and randomly generated number after the image file name, like:

   <IMG SRC="/Images/MyASPImageFile.jpg?12837192">

    

2. Set Response.Expires = "0"
3. Use the Response.BinaryWrite as demo'd in the binwtext.asp sample script included with AspImage. Write an HTML wrapper that calls the ASP file as an image source tag as
   
   <img src="/myapp/myimage.asp">
   This method works for most browsers (it fails with some IE / Netscape versions). The only other solution is to...
4. Create random filenames and then erase the images created during the Session_OnEnd event. This method works for all browsers.
5. Add a meta tag to your ASP file <meta http-equiv="pragma" content="no-cache">. This will not work in ASP files that use the BinaryWrite call.

Please do not write asking for help with this problem. We cannot do any more than point out the problems associated with these browsers and suggest workarounds. If you need further assistance please contact the browser manufacturer to find out where you can get support for their product. If you want to complain about the problem please contact the browser manufacturer and ask them why their caching algorithms are flawed. ;-)

The standard color constants are:

1. vbBlack
2. vbRed
3. vbGreen
4. vbYellow
5. vbBlue
6. vbMagenta
7. vbCyan
8. vbWhite

You can, of course, add your own constants to your scripting code. For example:
  vbGrayText = &80000011

Something like this will do the trick:

Sub ResizeX (intXSize)
  Dim intYSize
  intYSize = (intXSize / Image.MaxX) * Image.MaxY
  Image.ResizeR intXSize, intYSize
end sub

I'm calling SaveImage but nothing is getting written out. What's wrong?

or

I am getting "Cannot create file"

There are a few possible reasons for this:

1. The path you specified is invalid. Fix the path and retry.
2. The user context the component is operating under (either the anonymous IIS user or another account that has been authenticated) does not have write privileges to the directory you specified. Go into file manager, right click on the directory, select properties, select the security tab and then permissions. Make sure that any users which will use the component have privileges to write to the directory.
3. The file you are trying to write to is open in another process.

You can check the Error property for O/S result codes that identify problems after an attempted save.

This is only possible under Win2K. NT4 does not support this. To add Type1 fonts using AddFont seperate the PFM and PFB filenames with the "|" character. Do not put spaces anywhere in the font path string. AddFont will return a TRUE value if the font was successfully added. The AspImage Error property will return Win32 O/S result codes if an error occurs. 

Reasons for failure to add the font include:

1. The path specified is invalid
2. Lack of security for the authenticated user/anonymous user to read the font file

bolResAddFont = Image.AddFont _
("D:\WinNT\Fonts\COO_____.PFM|D:\WinNT\Fonts\COO_____.PFB")

if bolResAddFont then
  Image.FontName = "Courier-Oblique"
else
  Response.Write "Failed to add font. O/S Error was: " & Image.Error
end if

That's because pixel 0,0's color was set already to a particular color (usually black) and you resized the image. Pixel 0,0's color was not reset. If you want to have pixel 0,0 set to another color then after you resize you can:

1. Set pixel 0,0 to a specific color using SetPixel
2. Use FillRect to fill the entire image with another color
3. Use FloodFill to fill an area including 0,0 with another color

HTML colors are easily converted to RGB values using the VBScript RGB function.

For example the HTML color #E2BBF3 can be converted to RGB as follows

Image.GradientStartColor = vbWhite
Image.GradientEndColor = RGB(&hE2, &hBB, &hF3)

Response.Write 
"Image Height = " & Image.MaxY & " - Image Width = " & Image.MaxX

Set 

Image.BrushStyle = 1 ' set brush style to "clear" rather than 0 which is "solid".

AspImage uses the Win32 O/S calls to antialias text. The following notes are provided by Microsoft MSDN: 

"Windows NT 4.0 and later (Win2K): Font is always antialiased if the font supports it and the size of the font is not too small or too large.

"Windows 95 and later: In addition to the comments for Windows NT, the display must greater than 8-bit color, it must be a single plane device, it cannot be a palette display, and it cannot be in a multiple display monitor setup."

Customer suggested workaround: "When you need correctly antialiased text in a font-size below the critical antialias-level, just multiply the needed font/imagesize by -say- 3 (I used this factor and it works fine) Let AspImage make your image in the normal way, but before you save the image use ResizeR to scale the image down by 3. This makes perfectly antialiased text in smaller fontsizes. I thought I'd let you know, because this workaround can extend the usability of your product.The extra step of resizing the image may be a problem for some users, but I think most users will appreciate it when this workaround will be added to the documentation." (MvH)

The AntiAliasText allows you to create anti-aliased text on the image. By default AntiAliasText is false.

Example:

Image.AntiAliasText = True

AutoClear is true by default. Once an image is saved the current image is cleared. By setting AutoClear to false you can retain the existing image after a save to continue working with it.

Example:

Image.AutoClear = false

AutoSize determines whether or not an image should be clipped when a draw request that falls outside of the images current coordinates occurs. If AutoSize is true then the image will be enlarged to handle the request. If AutoSize is false then the draw request will be clipped to fit within the current image.

Example:

Image.AutoSize = False

Integer value specifies the background color for NEW image manipulations. It does not magically set the "background" to the specified color.

Example:

Image.BackgroundColor = vbWhite
Image.ClearImage 'now clear the image to white.

True/false value determines if font is bold or not.

Example:

Image.Bold = True

The BrushColor property determines the color of the brush. (available in version >= 1.8)

Image.BrushColor = VbRed

The BrushStyle property determines the pattern painted by the brush.

Get or set the DPI value for JPG and BMP files. (available in version >= 2.27)

Image.DPI = 96

The Error property is used to report any errors that may have occurred during various method calls.

Example:

Response.Write "Error: " & Chart.Error

If the component is an eval or beta version the expires property will return the date that the component quits functioning.

Example:

Response.Write "Component Expires: " & Image.Expires

The FileName property specifies the physical path where a file will be saved using the SaveImage method.

Example:

Image.FileName = "d:\inetpub\wwwroot\images\abc.jpg"

The integer FontColor specifies the color of the font.

Example:

Image.FontColor = vbRed

The string FontName specifies the name of the font.

Example:

Image.FontName = "MS Sans Serif"

The integer FontSize specifies the size of the font.

Example:

Image.FontSize = 12

ImageFormat determines what graphics for the image will be saved to. The default value is JPG. Valid values are

• JPG = 1
• BMP = 2
• PNG = 3
• WBMP = 4 (version >= 2.20)
• GIF = 5
• TGA = 6 (version >= 2.26)
• PCX = 7 (version >= 2.26)

Example:

Image.ImageFormat = 5
Image.FileName = "c:\inetpub\wwwroot\images\logo.gif"
Image.SaveImage

True/false value determines if font is italic or not.

Example:

Image.Italic = True

If the ImageFormat is set to JPEG then the JPEGQuality property specifies the quality of the JPEG image to be saved. Valid values are 1-100.

Example:

Image.JPEGQuality = 95

The MaxX property determines the X size of the image.

Example:

Image.MaxX = 100

The MaxY property determines the Y size of the image.

Example:

Image.MaxY = 100

The PadSize property allows you to automatically placed horizontal and vertical padding around text.

Example:

Image.PadSize = 5

Color determines the color used to draw lines on the canvas.

Example:

Image.PenColor = &h80000011

Style determines the style in which the pen draws lines.

Width specifies the maximum width of the pen in pixels.

Example:

Image.PenWidth = 2

Determines the bit depth of saved images (JPG and PNG are always 24bit). In memory manipulation of images typically occurs in 24bit mode and by default images are 24 bits. (available in version >= 2.25)

ProgressiveJPEGEncoding determines whether an image can be progressively displayed when it is decompressed. ProgressiveJPEGEncoding is off by default.

Example:

ProgressiveJPEGEncoding = true

True/false value determines if font is strikeout or not.

Example:

Image.Strikeout = False

Sets the text alignment for calls to TextOut. The default value is 0 (left).

Image.TextAlign = 6

The TextAngle property determines the angle the text written with TextOut is written at. By default TextAngle is 0.

Example:

Image.TextAngle = 90

Sets the text color used for 3d text.

Example:

Image.ThreeDColor = &h80000011

Determines the color used for transparencies when saving a GIF, or PNG image. (PNG require version >= 2.26). Setting TransparentColor automatically sets the Transparent property to true (starting with version 2.31).

Example:

Image.TransparentColor = vbWhite

Determines whether the TextOut method writes text to the image in transparent mode or not. By default this property is true.

Example:

Image.TransparentText = true

True/false value determines if font is underlined or not.

Example:

Image.Underline = False

Gets the internal component version number.

Example:

Response.Write "Component Version: " & Image.Version

The X property indicates the current X (horizontal) position of the cursor on the image.

Example:

Image.X = 10

The Y property indicates the current Y (vertical) position of the cursor on the image.

Example:

Image.Y = 10

Adds an animation control block to the GIF animation sequence. intDelay is miliseconds to delay till the next image. (available in version >= 1.8)

Image.AddAnimationControl intDelay, false, 0

Adds a new font resource dynamically to the internal system font tables. After calling AddFont you can use the new font name in the FontName property. AddFont should only be called once per font in an application. strFontFileName may be either a .FON font resource file, a .FNT raw bitmap font file, a .TTF raw TrueType file, or a .FOT TrueType resource file. (available in version >= 2.04)

if Image.AddFont ("e:\sites\pub\fonts\custom.ttf") then ...

Adds the current image to the GIF animation. StartAnimation must be called before calling AddImageToAnimation. See SaveAnimation. (available in version >= 1.8)

Image.AddImageToAnimation

Adds a new image to the canvas using the intX and intY coordinates. intTransparent in the image strFilename is treated as transparent. intTransparentColor is the exact color to make transparent. "Similar" colors are not replaced.

Image.AddImageTransparent "d:\apps\gr3\im.jpg", 5, 12, vbWhite

The AngleArc function draws a line segment and an arc. The line segment is drawn from the current position to the beginning of the arc. The arc is drawn along the perimeter of a circle with the given radius and center. The length of the arc is defined by the given start and sweep angles. (available in version >= 1.8)

Image.AngleArc 50, 60, 60, 50, 90

Blurs image intTimes (available in version >= 2.0)

Example:

Image.Blur 2

Makes the existing image appear brighter.

Example:

Image.BrightenImage 30

Modifies the image contrast. intDegree should be -100 to 100. (available in version >= 2.0)

Example:

Image.Contrast 15

Creates a button like border around the image for intBorder pixels. If bolSoft is true the button border is softened.

Example:

Image.CreateButton 10, true

Darkens the image to the intDegree

Example:

Image.DarkenImage 30

Loads strFileName (full path to a BMP, or JPG file) and then merges with the existing image. The higher intPercent is to 100 the more predominant strFileName will be seen over the existing image. intPercent should be inbetween 1-99. (available in version >= 1.8) 

If you have problems loading an image with LoadImage, DoMerge won't work either. This function uses the same load function. So if you are not able to successfully do a merge, try loading the image first with LoadImage. If that doesn't work then use the FAQ section of this document to determine why LoadImage cannot successfully load the image. Once that works then try DoMerge. 

Example:

DoMerge "c:\webs\shared\images\logo.jpg", 20

The FillPath function closes any open figures in the current path and fills the path's interior by using the current brush and polygon-filling mode. (available in version >= 1.8).

Dim aRgnPts(5,1)

aRgnPts(0,0) = 182
aRgnPts(0,1) = 34
aRgnPts(1,0) = 210
aRgnPts(1,1) = 72
aRgnPts(2,0) = 212
aRgnPts(2,1) = 112
aRgnPts(3,0) = 146
aRgnPts(3,1) = 112
aRgnPts(4,0) = 146
aRgnPts(4,1) = 76

Image.BrushStyle = 6
Image.BrushColor = vbRed
Image.BeginPath
Image.Polygon aRgnPts
Image.EndPath
Image.FillPath

Creates a "FishEye" effect from the current loaded image.  (version 2.21 or higher)

Image.FishEye 1

Flips the image

Valid values for intDirection are:

• 1 : Horizontal
• 2 : Vertical

Use FloodFill to fill a possibly non-rectangular region of the image. The boundaries of the region to be filled are determined by moving outward from the point (X,Y) until a color boundary involving the Color parameter is encountered. Floodfill uses the BackgroundColor and BrushStyle properties.

Legal values for intFillStyle are:

Creates a one way gradient beginning with the color intBeginColor and ending in the color specified by intEndColor.

intDirection may be

LoadBlob is designed to allow the loading of binary image data from other AspImage objects (using the .Image property for ovBlob) or from other data sources where binary image data is available via an OLE variant pointer. ovBlob is an OLE variant pointing to raw image data. The raw image data is loaded onto the AspImage canvas.The parameter intType indicates what type of format the binary data is in. Valid intTypes are:

• 1: JPEG
• 2: BMP

Example:

Set Image = Server.CreateObject("AspImage.Image")
Image.LoadImage ("d:\inetpub\wwwroot\images\map.jpg")
Image.FlipImage 2
Image.ImageFormat = 1

Set Image2 = Server.CreateObject("AspImage.Image")
Image2.LoadBlob Image.Image, 1
rem Image2 now has a flipped image of map.jpg

Loads an existing image into the image canvas. You can load JPG, PNG and BMP files.

strFileName must be a local server file, not a file located on a remote server.

LoadImage resets font changes so that changes to the font size, name and characteristics for new text are lost. If you use the LoadImage procedure be sure you make fonts modifications after the call to LoadImage.

Loads an existing image to be used as a textured brush during calls to TextOut and other drawing functions. Not all drawing functions will use the texture so some experimentation may be necessary to get the desired effect. Use ClearTexture to unload the texture when finished.  (available in version >= 2.25)

Note: Textures are not applied properly to rotated (angled) text.

Image.LoadTexture "d:\images\texture\bubbles.bmp"

Creates a mosaic pattern from the current image. intX and intY specify the degree to which the X and Y axis are modified.  (version 2.21 or higher)

Image.Mosaic 5, 1

Draws one or more Bézier curves. Max of 99 points supported in a single call to PolyBezier. (available in version >= 1.8)

Dim RgnPts(3,1)

RgnPts(0,0) = 79
RgnPts(0,1) = 70
RgnPts(1,0) = 64
RgnPts(1,1) = 86
RgnPts(2,0) = 47
RgnPts(2,1) = 88
Image.PolyBezier RgnPts

Polygon draws a series of lines on the canvas connecting the points passed in and closing the shape by drawing a line from the last point to the first point. (available in version >= 1.8)

Dim RgnPts(4,1)

RgnPts(0,0) = 70
RgnPts(0,1) = 76
RgnPts(1,0) = 310
RgnPts(1,1) = 350
RgnPts(2,0) = 200
RgnPts(2,1) = 450
RgnPts(3,0) = 100
RgnPts(3,1) = 300
Image.Polygon RgnPts

Polyline draws a series of lines on the canvas with the current pen. Each of the points are connected. (available in version >= 1.8)

Dim RgnPts(3,1)

RgnPts(0,0) = 79
RgnPts(0,1) = 70
RgnPts(1,0) = 64
RgnPts(1,1) = 86
RgnPts(2,0) = 47
RgnPts(2,1) = 88
Image.PolyLine RgnPts

Adjusts the saturation value for the image. (available in version >= 2.21) 

Image.Saturation 50

Saves the current GIF animation to the file indicated by the FileName property. (available in version >= 1.8)

Image.SaveAnimation

Set the pixel at location intX, intY to intColor. (available in version >= 1.8)

for i = 10 to 50 
Image.SetPixel 5+(rnd*10), i, vbGreen
next

Performs a sharpen function on the image using intValue (available in version >= 2.0)

Image.Sharpen 1

Starts an animation sequence for animated GIFs. bolLoop indicates whether the animation sequence will loop or not. (available in version >= 1.8)

Image.StartAnimation true

Takes an existing image and shades the image with tints of intColor.

Example:

Image.TintImage vbBlue

Creates a "twist" pattern from the current image. intDegree specifies degree to which the image is twisted.  (version 2.21 or higher)

Note: Twist will only modify pixels from 0 ,0 through the minimum X or Y size. To have the full picture twisted X and Y must be equal.

Image.Twist 50

Creates a wave effect using blocks intGraphicSize x intGraphicSize with a wave size of intWaveSize. intGraphicSize should be smaller than your graphic height and width and intWaveSize tops out around a value of 50.  (available in version >= 2.0)

Image.Wave 10 1