▼ |  | Mr Lib: Extra GUI Libraries

1 | Aligned Pasteboard
2 | Bitmap Label
3 | Cache-image Snip
4 | Close Icon
5 | GIF and Animated GIF Writing
6 | Graphs
7 | Hierarchical List Control
8 | Include Bitmap
9 | Interactive Value Port
10 | Name Message
11 | Path Dialog
12 | Plot
13 | Switchable Button
14 | Image Core
15 | Matrix Snip
16 | Snip Canvases
17 | Syntax Browser
18 | Te X Table
19 | Terminal Window
20 | Acknowledgments
| Index

On this page:

render-image
image?
un/ cache-image
compute-image-cache
definitely-same-image?
snip-class

top ← prev up next →

### 14`` Image Core

(require mrlib/image-core) | package: gui-lib

This library is the core part of the 2htdp/image library that DrRacket links into the namespace of all languages that it runs. This ensures that minimal support for these images are the same in all languages, specifically including support for printing the images and constructing the core data structures making up an image.

> procedure (render-image image dc dx dy) → void?
> image : image?
> dc : (is-a?/c dc<%>)
> dx : real?
> dy : real?

Draws image in dc at the position (dx,dy).

> procedure (image? v) → boolean?
> v : any/c

Recognizes the images that library handles.

> procedure (un/cache-image image b) → image?
> image : image?
> b : any/c

Returns an image that either caches its drawing in the snip draw method or doesn’t, depending on b.

Not all image? values have special caching capabilities; in those cases, this returns a copy of the value if it is a snip%; otherwise it returns the value itself (if it isn’t a snip%).

> procedure (compute-image-cache image) → void?
> image : image?

When the image has a bitmap-cache (which it does by default, although un/cache-image can disable it), this function fills in the bitmap, doing the work to draw image into the bitmap.

Ordinarily, the image’s bitmap cache is computed the first time the image is actually rendered.

> procedure (definitely-same-image? i1 i2) → boolean?
> i1 : image?
> i2 : image?

Returns #t if i1 and i2 draw identically and #f if they may draw the same or may draw differently.

This test is intended to be cheaper than a full equality comparison. It is also used by the implementation of equal? on images to short-circuit the full check. (The full check draws the two images and then compares the resulting bitmaps.)

> value snip-class : (is-a?/c snip-class%)

The snipclass used by images (which are snip%s) created by this library.

Not all image? values are snip%s, but those that are use this as their snip-class%.

top ← prev up next →