1Ace::Graphics::Glyph(3)User Contributed Perl DocumentatioAnce::Graphics::Glyph(3)
2
3
4
6 Ace::Graphics::Glyph - Base class for Ace::Graphics::Glyph objects
7
9 See Ace::Graphics::Panel.
10
12 Ace::Graphics::Glyph is the base class for all glyph objects. Each
13 glyph is a wrapper around an Ace::Sequence::Feature object, knows how
14 to render itself on an Ace::Graphics::Panel, and has a variety of
15 configuration variables.
16
17 End developers will not ordinarily work directly with
18 Ace::Graphics::Glyph, but may want to subclass it for customized
19 displays.
20
22 This section describes the class and object methods for
23 Ace::Graphics::Glyph.
24
25 CONSTRUCTORS
26 Ace::Graphics::Glyph objects are constructed automatically by an
27 Ace::Graphics::GlyphFactory, and are not usually created by end-
28 developer code.
29
30 $glyph =
31 Ace::Graphics::Glyph->new(-feature=>$feature,-factory=>$factory)
32 Given a sequence feature, creates an Ace::Graphics::Glyph object to
33 display it. The -feature argument points to the
34 Ace::Sequence::Feature object to display. -factory indicates an
35 Ace::Graphics::GlyphFactory object from which the glyph will fetch
36 all its run-time configuration information.
37
38 A standard set of options are recognized. See OPTIONS.
39
40 OBJECT METHODS
41 Once a glyph is created, it responds to a large number of methods. In
42 this section, these methods are grouped into related categories.
43
44 Retrieving glyph context:
45
46 $factory = $glyph->factory
47 Get the Ace::Graphics::GlyphFactory associated with this object.
48 This cannot be changed once it is set.
49
50 $feature = $glyph->feature
51 Get the sequence feature associated with this object. This cannot
52 be changed once it is set.
53
54 Retrieving glyph options:
55
56 $fgcolor = $glyph->fgcolor
57 $bgcolor = $glyph->bgcolor
58 $fontcolor = $glyph->fontcolor
59 $fillcolor = $glyph->fillcolor
60 These methods return the configured foreground, background, font
61 and fill colors for the glyph in the form of a GD::Image color
62 index.
63
64 $width = $glyph->width
65 Return the maximum width allowed for the glyph. Most glyphs will
66 be smaller than this.
67
68 $font = $glyph->font
69 Return the font for the glyph.
70
71 $option = $glyph->option($option)
72 Return the value of the indicated option.
73
74 $index = $glyph->color($color)
75 Given a symbolic or #RRGGBB-form color name, returns its GD index.
76
77 Retrieving information about the sequence:
78
79 $start = $glyph->start
80 $end = $glyph->end
81 These methods return the start and end of the glyph in base pair
82 units.
83
84 $offset = $glyph->offset
85 Returns the offset of the segment (the base pair at the far left of
86 the image).
87
88 $length = $glyph->length
89 Returns the length of the sequence segment.
90
91 Retrieving formatting information:
92
93 $top = $glyph->top
94 $left = $glyph->left
95 $bottom = $glyph->bottom
96 $right = $glyph->right
97 These methods return the top, left, bottom and right of the glyph
98 in pixel coordinates.
99
100 $height = $glyph->height
101 Returns the height of the glyph. This may be somewhat larger or
102 smaller than the height suggested by the GlyphFactory, depending on
103 the type of the glyph.
104
105 $scale = $glyph->scale
106 Get the scale for the glyph in pixels/bp.
107
108 $height = $glyph->labelheight
109 Return the height of the label, if any.
110
111 $label = $glyph->label
112 Return a human-readable label for the glyph.
113
114 These methods are called by Ace::Graphics::Track during the layout
115 process:
116
117 $glyph->move($dx,$dy)
118 Move the glyph in pixel coordinates by the indicated delta-x and
119 delta-y values.
120
121 ($x1,$y1,$x2,$y2) = $glyph->box
122 Return the current position of the glyph.
123
124 These methods are intended to be overridden in subclasses:
125
126 $glyph->calculate_height
127 Calculate the height of the glyph.
128
129 $glyph->calculate_left
130 Calculate the left side of the glyph.
131
132 $glyph->calculate_right
133 Calculate the right side of the glyph.
134
135 $glyph->draw($gd,$left,$top)
136 Optionally offset the glyph by the indicated amount and draw it
137 onto the GD::Image object.
138
139 $glyph->draw_label($gd,$left,$top)
140 Draw the label for the glyph onto the provided GD::Image object,
141 optionally offsetting by the amounts indicated in $left and $right.
142
143 These methods are useful utility routines:
144
145 $pixels = $glyph->map_pt($bases);
146 Map the indicated base position, given in base pair units, into
147 pixels, using the current scale and glyph position.
148
149 $glyph->filled_box($gd,$x1,$y1,$x2,$y2)
150 Draw a filled rectangle with the appropriate foreground and fill
151 colors, and pen width onto the GD::Image object given by $gd, using
152 the provided rectangle coordinates.
153
154 $glyph->filled_oval($gd,$x1,$y1,$x2,$y2)
155 As above, but draws an oval inscribed on the rectangle.
156
157 OPTIONS
158 The following options are standard among all Glyphs. See individual
159 glyph pages for more options.
160
161 Option Description Default
162 ------ ----------- -------
163
164 -fgcolor Foreground color black
165
166 -outlinecolor black
167 Synonym for -fgcolor
168
169 -bgcolor Background color white
170
171 -fillcolor Interior color of filled turquoise
172 images
173
174 -linewidth Width of lines drawn by 1
175 glyph
176
177 -height Height of glyph 10
178
179 -font Glyph font gdSmallFont
180
181 -label Whether to draw a label false
182
183 You may pass an anonymous subroutine to -label, in which case the
184 subroutine will be invoked with the feature as its single argument.
185 The subroutine must return a string to render as the label.
186
188 By convention, subclasses are all lower-case. Begin each subclass with
189 a preamble like this one:
190
191 package Ace::Graphics::Glyph::crossbox;
192
193 use strict;
194 use vars '@ISA';
195 @ISA = 'Ace::Graphics::Glyph';
196
197 Then override the methods you need to. Typically, just the draw()
198 method will need to be overridden. However, if you need additional
199 room in the glyph, you may override calculate_height(),
200 calculate_left() and calculate_right(). Do not directly override
201 height(), left() and right(), as their purpose is to cache the values
202 returned by their calculating cousins in order to avoid time-consuming
203 recalculation.
204
205 A simple draw() method looks like this:
206
207 sub draw {
208 my $self = shift;
209 $self->SUPER::draw(@_);
210 my $gd = shift;
211
212 # and draw a cross through the box
213 my ($x1,$y1,$x2,$y2) = $self->calculate_boundaries(@_);
214 my $fg = $self->fgcolor;
215 $gd->line($x1,$y1,$x2,$y2,$fg);
216 $gd->line($x1,$y2,$x2,$y1,$fg);
217 }
218
219 This subclass draws a simple box with two lines criss-crossed through
220 it. We first call our inherited draw() method to generate the filled
221 box and label. We then call calculate_boundaries() to return the
222 coordinates of the glyph, disregarding any extra space taken by labels.
223 We call fgcolor() to return the desired foreground color, and then call
224 $gd->line() twice to generate the criss-cross.
225
226 For more complex draw() methods, see Ace::Graphics::Glyph::transcript
227 and Ace::Graphics::Glyph::segments.
228
230 Please report them.
231
233 Ace::Sequence, Ace::Sequence::Feature, Ace::Graphics::Panel,
234 Ace::Graphics::Track, Ace::Graphics::Glyph::anchored_arrow,
235 Ace::Graphics::Glyph::arrow, Ace::Graphics::Glyph::box,
236 Ace::Graphics::Glyph::primers, Ace::Graphics::Glyph::segments,
237 Ace::Graphics::Glyph::toomany, Ace::Graphics::Glyph::transcript,
238
240 Lincoln Stein <lstein@cshl.org>.
241
242 Copyright (c) 2001 Cold Spring Harbor Laboratory
243
244 This library is free software; you can redistribute it and/or modify it
245 under the same terms as Perl itself. See DISCLAIMER.txt for
246 disclaimers of warranty.
247
248
249
250perl v5.36.0 2022-07-22 Ace::Graphics::Glyph(3)