51 lines
2.0 KiB
Racket
51 lines
2.0 KiB
Racket
#lang scribble/doc
|
|
@(require "common.ss")
|
|
|
|
@defclass/title[pen-list% object% ()]{
|
|
|
|
A @scheme[pen-list%] object maintains a list of @scheme[pen%]
|
|
objects to avoid repeatedly creating pen objects. A @scheme[pen%]
|
|
object in a pen list cannot be mutated.
|
|
|
|
A global pen list @indexed-scheme[the-pen-list] is created automatically.
|
|
|
|
|
|
|
|
|
|
|
|
@defconstructor[()]{
|
|
|
|
Creates an empty pen list.
|
|
|
|
|
|
}
|
|
|
|
@defmethod*[([(find-or-create-pen [color (is-a?/c color%)]
|
|
[width (real-in 0 255)]
|
|
[style (one-of/c 'transparent 'solid 'xor 'hilite
|
|
'dot 'long-dash 'short-dash 'dot-dash
|
|
'xor-dot 'xor-long-dash 'xor-short-dash
|
|
'xor-dot-dash)]
|
|
[cap (one-of/c 'round 'projecting 'butt) 'round]
|
|
[join (one-of/c 'round 'bevel 'miter) 'round])
|
|
(is-a?/c pen%)]
|
|
[(find-or-create-pen [color-name string?]
|
|
[width (real-in 0 255)]
|
|
[style (one-of/c 'transparent 'solid 'xor 'hilite
|
|
'dot 'long-dash 'short-dash 'dot-dash
|
|
'xor-dot 'xor-long-dash 'xor-short-dash
|
|
'xor-dot-dash)]
|
|
[cap (one-of/c 'round 'projecting 'butt) 'round]
|
|
[join (one-of/c 'round 'bevel 'miter) 'round])
|
|
(or/c (is-a?/c pen%) false/c)])]{
|
|
|
|
Finds a pen of the given specification, or creates one and adds it to
|
|
the list. The arguments are the same as for creating a @scheme[pen%]
|
|
instance plus a cap and join style as for @method[pen% set-cap] and
|
|
@method[pen% set-join]. When @scheme[color-name] is provided, however, the return
|
|
value is @scheme[#f] when no color matching @scheme[color-name] can be
|
|
found in @scheme[the-color-database].
|
|
|
|
}}
|
|
|