Error getting tags :
error 404Error getting tags :
error 404 imageSource | revDocs | RunRev
Welcome Guest (Log in)
Product Edition
Version
imageSource
Basics
Expander triangle
Type
Property
Syntax

set the imageSource of character to {imageID |imageName |imageURL |empty}

Introduced
1.1
Changed
3.5
Environment
Desktop, Web and Server
Platform Support
MacOS,Mac OS X,Windows,Linux
Security
None required
Summary
Specifies an image to be displayed in place of the specified character in a field.
Examples

set the imageSource of char 1 of line 2 of field "This" to 2533
set the imageSource of char thisChar of field 1 to "Arrow"
set the imageSource of last char of me to "binfile:My Image"

Additional Comments
Expander triangle

Use the imageSource property to display a picture or icon inside a text field.

Value:

The imageSource of a character is either empty or an image specifier.

An imageID is the ID of an image to display instead of the character. Revolution looks for the specified image first in the current stack, then in other open stacks.

An imageName is the short name of an image to display instead of the character.

Revolution looks for the specified image (if an ID or name is given) in the following order:

1) The stack of the object's behavior (if applicable)

2) The stack of the owner of the object's behavior (if applicable)

...

n) The stack of the object's stack's behavior (if applicable)

A) The object's stack

B) The object's stack's mainstack (if a substack)

C) The object's stack's mainstacks substacks

D) The list of open stacks, in order they were loaded

An imageURL is any valid URL that specifies an image in a format Revolution can display.

By default, the imageSource for all characters is empty.

Comments:

Setting the imageSource of a character hides the character.

Setting the imageSource of a character to empty removes the image and allows the character to appear instead.

If the image is noticeably taller than the text in the field, it may appear cut off if the field's fixedLineHeight property is set to true. To correct this problem, set the field's fixedLineHeight to false.

Important! Don't use the URLkeyword when specifying an imageURL. The imageSource of a character is a file location (or image ID or name), not the image data itself. If you use the URL keyword, the imageSource property is set to the contents of the URL, not the URL itself, and this is usually not what's wanted.

Changes to Revolution:

The order in which Revolution searches for imageSource IDs was changed in version 3.5. Previously, the current stack was searched first, followed by the list of open stacks.

User Comments
Expander triangle
User thumbnail
(hidden)
StarStarStarStarStar
Jan 21, 2009
If you put one field into another, any images in the source field, will not appear in the destination field (the imagesource values aren't copied across). One way to copy imagesource derived images (and other attributes of the source field, such as background colour etc.) is to set the htmltext of the destination field to that of the source field.
User thumbnail
Jacqueline Landman Gay
StarStarStarStarStar
Jan 7, 2010
If an imagesource is retrieved from an external file, Rev caches the image in memory. If the image file content changes (for example, if it is edited in a graphics program outside of Rev, or if a script replaces its content but keeps the file name the same) the change will not be reflected in any field that is using it as an imagesource. To force Rev to update the imagesource from the original file, set the imagesource to a non-existant file (or even just a space) and then immediately reset it to the original file name again. For example, this will force Rev to reload the same image if its content has changed:


set the imagesource of char 1 of fld 1 to space -- replace the original imagesource with nonvalid data
set the imagesource of char 1 of fld 1 to "binfile:myImageFile.jpg" -- reloads the original image from disk