1: # The LearningOnline Network with CAPA
2: # randomlabel.png: composite together text and images into 1 image
3: #
4: # $Id: randomlylabel.pm,v 1.36 2024/04/05 04:05:08 raeburn Exp $
5: #
6: # Copyright Michigan State University Board of Trustees
7: #
8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
9: #
10: # LON-CAPA is free software; you can redistribute it and/or modify
11: # it under the terms of the GNU General Public License as published by
12: # the Free Software Foundation; either version 2 of the License, or
13: # (at your option) any later version.
14: #
15: # LON-CAPA is distributed in the hope that it will be useful,
16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18: # GNU General Public License for more details.
19: #
20: # You should have received a copy of the GNU General Public License
21: # along with LON-CAPA; if not, write to the Free Software
22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23: #
24: # /home/httpd/html/adm/gpl.txt
25: #
26: # http://www.lon-capa.org/
27: #
28:
29: =pod
30:
31: =head1 Syntax of randomlylabel commands
32:
33: Required items are: (one of BGIMG or SIZE) and OBJCOUNT
34:
35: =over 4
36:
37: =item BGIMG
38:
39: /home/... file
40: /res/ ... URL
41: or href (href must contain http://...)
42: Expected to be HTTP escaped
43:
44: =item SIZE
45:
46: width:height
47:
48: Creates a blank canvas of size width,height.
49:
50: =item BGCOLOR
51:
52: either I<transparent> or a color hexstring
53:
54: Sets the background color, if SIZE is used to create a new canvas,
55: I<trasparent> makes the background transparent.
56:
57: =item OBJCOUNT
58:
59: a number
60:
61: =item OBJTYPE
62:
63: a colon seperated list of types, supported types are
64:
65: B<LINE> B<RECTANGLE> B<POLYGON> B<ARC> B<FILL> B<IMAGE> B<LABEL>
66:
67: =item OBJI<num>
68:
69: arguments for this OBJ
70:
71: some common arguments are
72:
73: =over 4
74:
75: =item x y thickness
76:
77: are pixel values
78:
79: =item color
80:
81: a hexstring, without with out a leading # or x)
82:
83: =item filled
84:
85: boolean, (1 or 0)
86:
87: =back
88:
89: The argumants for the possible object types are
90:
91: =over 4
92:
93: =item LINE
94:
95: x1:y1:x2:y2:color:thickness
96:
97: =item RECTANGLE
98:
99: x1:y1:x2:y2:color:thickness:filled
100:
101: =item ARC
102:
103: x:y:width:height:start:end:color:thickness:filled
104:
105: =over 4
106:
107: =item start, end
108:
109: start and ends of the arc (in degrees)
110:
111: =back
112:
113: =item FILL
114:
115: x:y:color
116:
117: =item IMAGE
118:
119: x:y:file:transparent:srcX:srcY:destW:destH:srcW:srcH
120:
121: =over 4
122:
123: =item srcX,srcY,srcW,srcH
124:
125: the start and extant of the region in file to copy to x,y with width/height
126: destW destH
127:
128: =back
129:
130: =item LABEL
131:
132: x:y:text:font:color:direction:rotation
133:
134: =over 4
135:
136: =item text
137:
138: HTTP escaped string of the text to place on the image
139:
140: =item font
141:
142: one of B<tiny>, B<small>, B<medium>, B<large>, B<giant>, or an
143: installed TTF font and point size
144:
145: =item direction
146:
147: either B<horizontal> or B<vertical>
148:
149: =item rotation
150:
151: number of degrees to rotate the text, relative to the horizontal.
152: only used if font attribute is set to a freetype font (e.g., helvetica 12),
153: and in that case, if set to a valid value, overrides value set for direction.
154:
155: =back
156:
157: =item POLYGON
158:
159: color:width:open:filled
160:
161: =over 4
162:
163: =item open
164:
165: boolean, (1 or 0)
166:
167: =back
168:
169: =back
170:
171:
172: =item OBJEXTRAI<num>
173:
174: extra arguments for object I<num>
175:
176: The possible values for this for the different object types are
177:
178: =over 4
179:
180: =item POLYGON
181:
182: a list of coords in the form
183:
184: (x,y)-(x,y)-(x,y)
185:
186: (there can be arbitrarily many of these)
187:
188: =back
189:
190: =back
191:
192: =head1 Example
193:
194: BGIMG=file
195: OBJTYPE=LINE:LINE:LINE:LINE
196: OBJCOUNT=4
197: OBJ0=xmin:ymin:xmax:ymax:FFFFFF:3
198: OBJ1=xmin:ymax:xmax:ymin:FFFFFF:3
199: OBJ2=xmin:ymin:xmax:ymax:FF0000:1
200: OBJ3=xmin:ymax:xmax:ymin:FF0000:1
201:
202: =cut
203:
204: package Apache::randomlylabel;
205:
206: use strict;
207: use Image::Magick;
208: use Apache::Constants qw(:common);
209: use Apache::loncommon();
210: use Math::Trig();
211: use GD;
212: use GD::Polyline();
213: use Apache::lonnet;
214: use lib '/home/httpd/lib/perl/';
215: use LONCAPA;
216: use LONCAPA::LWPReq;
217:
218: #
219: # Note: Math::Trig is included in the standard perl package for many distros.
220: #
221: # For distros which use rpm the following command will show whether Trig.pm is
222: # included in the system perl: rpm -q --provides perl |grep Math::Trig
223: #
224: # For distros which use deb the following command will show whether Trig.pm is
225: # included in the system perl: dpkg -S perl |grep Math\/Trig\.pm
226: #
227:
228: sub get_image {
229: my ($imgsrc,$set_trans)=@_;
230: my $image;
231: if ($imgsrc !~ m|^(/home/)|) {
232: if ($imgsrc !~ /^https?\:/) {
233: $imgsrc=&Apache::lonnet::absolute_url($ENV{'HTTP_HOST'}).$imgsrc;
234: }
235: my $request=new HTTP::Request('GET',"$imgsrc");
236: $request->header(Cookie => $ENV{'HTTP_COOKIE'});
237: my $file="/tmp/imagetmp".$$;
238: my $lonhost = $Apache::lonnet::perlvar{'lonHostID'};
239: my $response=&LONCAPA::LWPReq::makerequest($lonhost,$request,$file,'','','',1);
240: if ($response->is_success) {
241: if ($response->content_type !~ m-/(png|jpg|jpeg)$-i) {
242: my $conv_image = Image::Magick->new;
243: my $current_figure = $conv_image->Read('filename'=>$file);
244: $conv_image->Set('type'=>'TrueColor');
245: $conv_image->Set('magick'=>'png');
246: my @blobs=$conv_image->ImageToBlob();
247: undef $conv_image;
248: $image = GD::Image->new($blobs[0]);
249: } else {
250: GD::Image->trueColor(1);
251: $image = GD::Image->new($file);
252: }
253: }
254: } elsif ($imgsrc !~ /\.(png|jpg|jpeg)$/i) {
255: my $conv_image = Image::Magick->new;
256: my $current_figure = $conv_image->Read('filename'=>$imgsrc);
257: $conv_image->Set('type'=>'TrueColor');
258: $conv_image->Set('magick'=>'png');
259: my @blobs=$conv_image->ImageToBlob();
260: undef $conv_image;
261: $image = GD::Image->new($blobs[0]);
262: } else {
263: $image = GD::Image->trueColor(1);
264: $image = GD::Image->new($imgsrc);
265: }
266: if ($set_trans && defined($image)) {
267: my $white=$image->colorExact(255,255,255);
268: if ($white != -1) { $image->transparent($white); }
269: }
270: return $image;
271: }
272:
273: sub get_color_from_hexstring {
274: my ($image,$color)=@_;
275: if (!$color) { $color='000000'; }
276: $color=~s/^[x\#]//;
277: my (undef,$red,undef,$green,undef,$blue)=split(/(..)/,$color);
278: $red=hex($red);$green=hex($green);$blue=hex($blue);
279: my $imcolor;
280: if (!($imcolor = $image->colorResolve($red,$green,$blue))) {
281: $imcolor = $image->colorClosestHWB($red,$green,$blue);
282: }
283: return $imcolor;
284: }
285:
286: sub add_click {
287: my ($image) = @_;
288:
289: my $length=6;
290: my $bgcolor=&get_color_from_hexstring($image,'FFFFFF');
291: my $fgcolor=&get_color_from_hexstring($image,'009999');
292:
293: my ($x,$y) = split(':',$env{'form.clickdata'});
294:
295: $image->setThickness(3);
296: $image->line($x-$length,$y, $x+$length,$y, $bgcolor);
297: $image->line($x, $y-$length,$x, $y+$length,$bgcolor);
298: $image->setThickness(1);
299: $image->line($x-$length,$y, $x+$length,$y, $fgcolor);
300: $image->line($x, $y-$length,$x, $y+$length,$fgcolor);
301: }
302:
303: sub handler {
304: my $r = shift;
305:
306: &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'});
307:
308: my $prefix;
309: if ($ENV{'QUERY_STRING'}=~/OBJCOUNT\=/) {
310: $prefix='form.';
311: } else {
312: $prefix="cgi.$env{'form.token'}.";
313: }
314: my $epsfile;
315: if (defined($env{$prefix."EPSFILE"})) {
316: my $user = $env{'user.name'}.'_'.$env{'user.domain'};
317: if ($env{$prefix."EPSFILE"} =~ /^\Q$user\E_\d+_\d+_\d+_drawimage\.eps$/) {
318: $epsfile = $Apache::lonnet::perlvar{'lonPrtDir'}.'/'.$env{$prefix."EPSFILE"};
319: } else {
320: &Apache::lonnet::logthis('Unable to create eps file for image object for -'.
321: $env{'form.token'}.'- for '.$user.' as EPSFILE has '.
322: 'unexpected value');
323: return OK;
324: }
325: }
326: unless ($epsfile) {
327: $r->content_type('image/png');
328: $r->send_http_header;
329: }
330:
331: my $image;
332: if (defined($env{$prefix."BGIMG"})) {
333: my $bgimg=&unescape($env{$prefix."BGIMG"});
334: #&Apache::lonnet::logthis("BGIMG is ".$bgimg);
335: $image=&get_image($bgimg,0);
336: if (! defined($image)) {
337: &Apache::lonnet::logthis('Unable to create image object for -'.
338: $env{'form.token'}.'-'.$bgimg);
339: return OK;
340: }
341: } elsif (defined($env{$prefix."SIZE"})) {
342: my ($width,$height)=split(':',$env{$prefix."SIZE"});
343: $image = new GD::Image($width,$height,1);
344: my ($bgcolor)=split(':',$env{$prefix."BGCOLOR"});
345: if ($bgcolor ne 'transparent') {
346: $bgcolor=&get_color_from_hexstring($image,$bgcolor);
347: # $image->rectangle(0,0,$width,$height,$bgcolor);
348: $image->fill(0,0,$bgcolor);
349: } else {
350: $bgcolor=&get_color_from_hexstring($image,'FFFFFF');
351: $image->fill(0,0,$bgcolor);
352: $image->transparent($bgcolor);
353: }
354: } else {
355: &Apache::lonnet::logthis('Unable to create image object, no info '.$prefix);
356: return OK;
357: }
358: #binmode(STDOUT);
359: my @objtypes=split(':',$env{$prefix."OBJTYPE"});
360: foreach(my $i=0;$i<$env{$prefix."OBJCOUNT"};$i++) {
361: my $type=shift(@objtypes);
362: if ($type eq 'LINE') {
363: my ($x1,$y1,$x2,$y2,$color,$thickness)=
364: split(':',$env{$prefix."OBJ$i"});
365: my $imcolor=&get_color_from_hexstring($image,$color);
366: if (!defined($thickness)) { $thickness=1; }
367: $image->setThickness($thickness);
368: # $image->setAntiAliased($imcolor);
369: $image->line($x1,$y1,$x2,$y2,$imcolor);
370: } elsif ($type eq 'RECTANGLE') {
371: my ($x1,$y1,$x2,$y2,$color,$thickness,$filled)=
372: split(':',$env{$prefix."OBJ$i"});
373: if ($x1 > $x2) { my $temp=$x1;$x1=$x2;$x2=$temp; }
374: if ($y1 > $y2) { my $temp=$y1;$y1=$y2;$y2=$temp; }
375: my $imcolor=&get_color_from_hexstring($image,$color);
376: if (!defined($thickness)) { $thickness=1; }
377: $image->setThickness($thickness);
378: # $image->setAntiAliased($imcolor);
379: if ($filled) {
380: $image->filledRectangle($x1,$y1,$x2,$y2,$imcolor);
381: } else {
382: $image->rectangle($x1,$y1,$x2,$y2,$imcolor);
383: }
384: } elsif ($type eq 'POLYGON') {
385: my ($color,$width,$open,$filled)=split(':',$env{$prefix."OBJ$i"});
386: my $imcolor=&get_color_from_hexstring($image,$color);
387: my $polygon = (($open && lc ($open ne 'no')) ?
388: (new GD::Polyline) : (new GD::Polygon));
389: my $added=0;
390: foreach my $coord (split('-',$env{$prefix."OBJEXTRA$i"})) {
391: my ($x,$y)=($coord=~m/\(([0-9]+),([0-9]+)\)/);
392: $polygon->addPt($x,$y);
393: $added++;
394: }
395:
396: $image->setThickness($width);
397: if ($added) {
398: if ($open && lc($open) ne 'no') {
399: $image->polydraw($polygon,$imcolor);
400: } elsif ($filled && lc($filled) ne 'no') {
401: $image->filledPolygon($polygon,$imcolor);
402: } else {
403: $image->polygon($polygon,$imcolor);
404: }
405: }
406: } elsif ($type eq 'ARC') {
407: my ($x,$y,$width,$height,$start,$end,$color,$thickness,$filled)=
408: split(':',$env{$prefix."OBJ$i"});
409: if (!$color) { $color='000000'; }
410: my $imcolor=&get_color_from_hexstring($image,$color);
411: if (!defined($thickness)) { $thickness=1; }
412: $image->setThickness($thickness);
413: # $image->setAntiAliased($imcolor);
414: if ($filled) {
415: $image->filledArc($x,$y,$width,$height,$start,$end,
416: $imcolor);
417: } else {
418: $image->arc($x,$y,$width,$height,$start,$end,$imcolor);
419: }
420: } elsif ($type eq 'FILL') {
421: my ($x,$y,$color)=split(':',$env{$prefix."OBJ$i"});
422: if (!$color) { $color='000000'; }
423: my $imcolor=&get_color_from_hexstring($image,$color);
424: $image->fill($x,$y,$imcolor);
425: } elsif ($type eq 'IMAGE') {
426: my ($x,$y,$file,$transparent,$srcX,$srcY,$destW,$destH,$srcW,
427: $srcH)=split(':',$env{$prefix."OBJ$i"});
428: $file=&unescape($file);
429: if (!defined($transparent)) { $transparent=1; }
430: my $subimage=&get_image($file,$transparent);
431: if (!defined($subimage)) {
432: &Apache::lonnet::logthis('Unable to create image object for '.
433: $file);
434: next;
435: }
436: if (!defined($srcW) or !$srcW) {$srcW=($subimage->getBounds())[0];}
437: if (!defined($srcH) or !$srcH) {$srcH=($subimage->getBounds())[1];}
438: if (!defined($destW) or !$destW) { $destW=$srcW; }
439: if (!defined($destH) or !$destH) { $destH=$srcH; }
440: $image->copyResized($subimage,$x,$y,$srcX,$srcY,$destW,$destH,
441: $srcW,$srcH);
442: } elsif ($type eq 'LABEL') {
443: my ($x,$y,$text,$font,$color,$direction,$rotation)=
444: split(':',$env{$prefix."OBJ$i"});
445: $text=&unescape($text);
446: my $imcolor=&get_color_from_hexstring($image,$color);
447: my $type='normal';
448: my ($height,$fontref);
449: if ($font eq 'tiny') {
450: $height=GD::Font->Tiny->height;
451: $fontref=GD::gdTinyFont;
452: } elsif ($font eq 'small') {
453: $height=GD::Font->Small->height;
454: $fontref=GD::gdSmallFont;
455: } elsif ($font eq 'medium') {
456: $height=GD::Font->MediumBold->height;
457: $fontref=GD::gdMediumBoldFont;
458: } elsif ($font eq 'large') {
459: $height=GD::Font->Large->height;
460: $fontref=GD::gdLargeFont;
461: } elsif ($font eq 'giant' || !$font) {
462: $height=GD::Font->Giant->height;
463: $fontref=GD::gdGiantFont;
464: } elsif ($image->useFontConfig(1)) {
465: $type='ttf';
466: }
467: if ($type eq 'normal' && $direction eq 'vertical') {
468: $image->stringUp($fontref,$x,$y-$height,$text,$imcolor);
469: } elsif ($type eq 'normal') {
470: $image->string($fontref,$x,$y-$height,$text,$imcolor);
471: } elsif ($type eq 'ttf') {
472: my ($fontname,$ptsize)=split(/\s+/,$font);
473: my $angle = 0;
474: if ($rotation =~ /^(\-|\+|)\d+(|\.\d*)$/) {
475: $angle = Math::Trig::deg2rad($rotation);
476: } elsif ($direction eq 'vertical') {
477: $angle = Math::Trig::deg2rad(90);
478: } elsif ($direction eq 'horizontal') {
479: $angle = 0;
480: }
481: $image->stringFT($imcolor,$fontname,$ptsize,$angle,$x,$y,$text);
482: }
483: } else {
484: &Apache::lonnet::logthis("randomlylabel unable to handle object of type $type");
485: }
486: }
487: if (exists($env{'form.clickdata'})) { &add_click($image); }
488: $image->setThickness(1);
489: if ($epsfile) {
490: if (open(my $pipe, "| convert png:- $epsfile")) {
491: print $pipe $image->png;
492: close($pipe);
493: } else {
494: &Apache::lonnet::logthis("randomlylabel unable to open pipe to convert png to eps");
495: }
496: } else {
497: $r->print($image->png);
498: }
499: return OK;
500: }
501:
502: 1;
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>