Documention for: button-image.r
Created by: btiffin
 on: 25-Apr-2007
Last updated by: btiffin on: 28-Apr-2007
Format: text/editable
Downloaded on: 30-Apr-2025

[h1 Usage document for %button-image.r
[contents
[numbering-on
[h2 Introduction to %button-image.r

[p This library script shows how easy it is to use images for VID
face styles (see below for term explanations), in particular, <strong>buttons</strong>.

[h2 Using %button-image.r

[p Using this script is simple.  Just <strong>DO</strong> it.

[asis
>>do %button-image.r
asis]

[p or to execute this right out of the rebol.org library

[asis/style/font-size:75%
>>do http://www.rebol.org/cgi-bin/cgiwrap/rebol/download-a-script.r?script-name=button-image.r
asis]

[h2 What you can learn

[h3 Face Style
[p Face style is a REBOL term that you
may have heard referred to as 'widget' or 'graphical element'.  REBOL
programmers may use just the word face, or just style when talking
about 'window gadgets'. Modifiers are termed 'facets'.

[p Reading the [link http://rebol.com/docs/view-guide.html "REBOL/View Developer's Guide"
will explain the preferred terms used for REBOL graphical programming.

[h3 DO-THRU
[p This sample script, uses <strong>LOAD-THRU</strong>.  This handy extension will
cache a copy of the data on your local system and if it exists in the cache, will not
bother reading the network copy.

[h3 View facets
[p Looking through this script, you'll see how easy it is to place an image on a face.
Just name an image! datatype after the face style and if possible it will be used
as the image on that face.  As with most VID facets, the image! is optional, and
REBOL uses intelligent defaults for the graphical look for all face styles. 

[h2 Credits

[li %button-image.r original author: Unknown
[li Usage document by Brian Tiffin, Library Team Apprentice, [date