34 lines
1.1 KiB
Racket
34 lines
1.1 KiB
Racket
#lang scribble/doc
|
|
@(require "common.ss"
|
|
(for-label mrlib/include-bitmap
|
|
scheme/runtime-path
|
|
scheme/include))
|
|
|
|
@title{Include Bitmap}
|
|
|
|
@defmodule[mrlib/include-bitmap]{The @scheme[include-bitmap] form
|
|
takes a filename containing a bitmap and ``inlines'' the bitmap into
|
|
the program.}
|
|
|
|
Historically, the advantage of inlining the bitmap is that a
|
|
stand-alone executable can be created that contains the bitmap and
|
|
does not refer to the original image file. The
|
|
@scheme[define-runtime-path] form, however, now provides a better
|
|
alternative.
|
|
|
|
@defform*[[(include-bitmap path-spec)
|
|
(include-bitmap path-spec type-expr)]]{
|
|
|
|
|
|
The @scheme[path-spec] is the same as for @scheme[include] form. The
|
|
@scheme[type-expr] should produce @scheme['unknown],
|
|
@scheme['unknown/mask], etc., as for @scheme[bitmap%], and the default
|
|
is @scheme['unknown/mask].}
|
|
|
|
|
|
@defform*[[(include-bitmap/relative-to source path-spec)
|
|
(include-bitmap/relative-to source path-spec [type-expr])]]{
|
|
|
|
Analogous to @scheme[include-at/relative-to], though only a source is
|
|
needed (no context).}
|