2.4 Drawing Functions

► |  | GUI: Racket Graphics Toolkit

1 | Overview
2 | Reference
3 | Configuration
4 | Dynamic Loading
| Bibliography
| Index

▼ | 2 | Reference

2.1 | Windowing Classes
2.2 | Windowing Functions
2.3 | Drawing Classes
2.4 | Drawing Functions
2.5 | Editor Classes
2.6 | Editor Functions
2.7 | WXME Decoding

► | 2.4 | Drawing Functions

2.4.1 | Global Graphics
2.4.2 | Post Script
2.4.3 | Drawing Object Lists
2.4.4 | Fonts

On this page:

2.4.1`` Global Graphics
flush-display
get-display-depth
get-display-left-top-inset
get-display-size
is-color-display?
register-collecting-blit
unregister-collecting-blit
2.4.2`` Post Script
current-ps-afm-file-paths
current-ps-cmap-file-paths
current-ps-setup
2.4.3`` Drawing Object Lists
the-brush-list
the-color-database
the-font-list
the-font-name-directory
the-pen-list
2.4.4`` Fonts
get-face-list
get-family-builtin-face
menu-control-font
normal-control-font
small-control-font
tiny-control-font
view-control-font

top← prev up next →

#### 2.4`` Drawing Functions

2.4.1 Global Graphics
2.4.2 PostScript
2.4.3 Drawing Object Lists
2.4.4 Fonts

##### 2.4.1`` Global Graphics

( flush-display) → void?

Under X and Mac OS X, flushes pending display messages such that the user’s display reflects the actual state of the windows. Under Windows, the procedure has no effect.

( get-display-depth) → exact-nonnegative-integer?

Returns the depth of the main display (a value of 1 denotes a monochrome display).

( get-display-left-top-inset [avoid-bars?])

→

exact-nonnegative-integer?
exact-nonnegative-integer?

avoid-bars? : bool = #f

When the optional argument is #f (the default), this function returns the offset of the main screen’s origin from the top-left of the physical screen. Under X and Windows, the result is always 0 and 0; under Mac OS X, the result is 0 and the height of the menu bar.

When the optional argument is true, this function returns the amount space at the left and top of the main screen that is occupied by the task bar (Windows) or menu bar and dock (Mac OS X). Under X, the result is always 0 and 0.

( get-display-size [full-screen?])

→

exact-nonnegative-integer?
exact-nonnegative-integer?

full-screen? : bool = #f

Gets the physical size of the display in pixels. Under Windows, this size does not include the task bar by default. Under Mac OS X, this size does not include the menu bar or dock area by default.

Under Windows and Mac OS X, if the optional argument is true, then the task bar, menu bar, and dock area are included in the result.

Returns the screen’s width and height.

( is-color-display?) → boolean?

Returns #t if the main display has color, #f otherwise.

( register-collecting-blit |  | canvas |  |  |  |
|  | x |  |  |  |
|  | y |  |  |  |
|  | w |  |  |  |
|  | h |  |  |  |
|  | on |  |  |  |
|  | off |  |  |  |
| [ | on-x |  |  |  |
|  | on-y |  |  |  |
|  | off-x |  |  |  |
|  | off-y]) |  | → |  | void?

canvas : ( is-a?/c canvas%)
x : real?
y : real?
w : ( and/c real? ( not/c negative?))
h : ( and/c real? ( not/c negative?))
on : ( is-a?/c bitmap%)
off : ( is-a?/c bitmap%)
on-x : real? = 0
on-y : real? = 0
off-x : real? = 0
off-y : real? = 0

Registers a blit to occur when garbage collection starts or ends.

When garbage collection starts, ( send ( send canvas get-dc) draw-bitmap-section on on-x on-y x y w h) is called. When garbage collection ends, ( send ( send canvas get-dc) draw-bitmap-section off off-x off-y x y w h) is called. If canvas’s device context has a scale, the scale may or may not be temporarily disabled during the bitmap drawing.

The canvas is registered weakly, so it will be automatically unregistered if the canvas becomes invisible and inaccessible. Multiple registrations can be installed for the same canvas.

See also unregister-collecting-blit.

( unregister-collecting-blit canvas) → void?
canvas : ( is-a?/c canvas%)

Unregisters a blit request installed with See also register-collecting-blit.

Unregisters all blits for canvas.

##### 2.4.2`` PostScript

( current-ps-afm-file-paths) → ( listof path?)
( current-ps-afm-file-paths paths) → void?
paths : ( listof path?)

A parameter determines the list of paths that is used to find AFM files. See PostScript Fonts for more information.

( current-ps-cmap-file-paths) → ( listof path?)
( current-ps-cmap-file-paths paths) → void?
paths : ( listof path?)

A parameter that determines the list of paths that is used to find CMap files. See PostScript Fonts for more information.

( current-ps-setup) → ( is-a?/c ps-setup%)
( current-ps-setup pss) → void?
pss : ( is-a?/c ps-setup%)

A parameter that determines the current PostScript configuration settings. See post-script-dc% and printer-dc%.

##### 2.4.3`` Drawing Object Lists

the-brush-list : ( is-a?/c brush-list%)

See brush-list%.

the-color-database : ( is-a?/c color-database<%>)

See color-database<%>.

the-font-list : ( is-a?/c font-list%)

See font-list%.

the-font-name-directory : ( is-a?/c font-name-directory<%>)

See font-name-directory<%>.

the-pen-list : ( is-a?/c pen-list%)

See pen-list%.

##### 2.4.4`` Fonts

( get-face-list [family]) → ( listof string?)
family : ( one-of/c 'mono 'all) = 'all

Returns a list of font face names available on the current system. If 'mono is provided as the argument, then only faces that are known to correspond to monospace fonts are included in the list.

( get-family-builtin-face family) → string?

family

:

( one-of/c 'default 'decorative 'roman 'script
'swiss 'modern 'symbol 'system)

Returns the built-in default face mapping for a particular font family. The built-in default can be overridden via preferences, as described in Font Configuration.

See font% for information about family.

menu-control-font : ( is-a?/c font%)

This font is the default for popup-menu% objects.

Under Mac OS X, this font is slightly larger than normal-control-font. Under Windows and X, it is the same size as normal-control-font.

normal-control-font : ( is-a?/c font%)

This font is the default for most controls, except list-box% and group-box-panel% objects.

small-control-font : ( is-a?/c font%)

This font is the default for group-box-panel% objects, and it is a suitable for controls in a floating window and other contexts that need smaller controls.

Under Windows, this font is the same size as normal-control-font, since the Windows control font is already relatively small. Under X and Mac OS X, this font is slightly smaller than normal-control-font.

tiny-control-font : ( is-a?/c font%)

This font is for tiny controls, and it is smaller than small-control-font on all platforms.

view-control-font : ( is-a?/c font%)

This font is the default for list-box% objects (but not list box labels, which use normal-control-font).

Under Mac OS X, this font is slightly smaller than normal-control-font, and slightly larger than small-control-font. Under Windows and X, it is the same size as normal-control-font.

top← prev up next →