Annotation of loncom/homework/randomlylabel.pm, revision 1.31

1.1       albertel    1: # The LearningOnline Network with CAPA
                      2: # randomlabel.png: composite together text and images into 1 image
                      3: #
1.31    ! raeburn     4: # $Id: randomlylabel.pm,v 1.30 2007/09/25 23:16:13 albertel Exp $
1.1       albertel    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: #
1.22      albertel   28: 
                     29: =pod
                     30: 
                     31: =head1 Syntax of randomlylabel commands
                     32: 
1.25      www        33: Required items are: (one of BGIMG or SIZE) and OBJCOUNT
1.24      albertel   34: 
1.22      albertel   35: =over 4
                     36: 
                     37: =item BGIMG
                     38: 
1.25      www        39: /home/... file
                     40: /res/ ... URL
                     41: or href (href must contain http://...)
1.22      albertel   42: Expected to be HTTP escaped
                     43: 
1.24      albertel   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: 
1.22      albertel   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
                    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: =back
                    150: 
                    151: =item  POLYGON
                    152: 
                    153: color:width:open:filled
                    154: 
                    155: =over 4 
                    156: 
                    157: =item open
                    158: 
                    159: boolean, (1 or 0)
                    160: 
                    161: =back
                    162: 
                    163: =back
                    164: 
                    165: 
                    166: =item OBJEXTRAI<num>
                    167: 
                    168: extra arguments for object I<num>
                    169: 
                    170: The possible values for this for the different object types are
                    171: 
                    172: =over 4
                    173: 
                    174: =item POLYGON 
                    175: 
                    176: a list of coords in the form
                    177: 
                    178:      (x,y)-(x,y)-(x,y)
                    179: 
                    180: (there can be arbitrarily many of these)
                    181: 
                    182: =back
                    183: 
                    184: =back
                    185: 
                    186: =head1 Example
                    187: 
                    188:  BGIMG=file
                    189:  OBJTYPE=LINE:LINE:LINE:LINE
                    190:  OBJCOUNT=4
                    191:  OBJ0=xmin:ymin:xmax:ymax:FFFFFF:3
                    192:  OBJ1=xmin:ymax:xmax:ymin:FFFFFF:3
                    193:  OBJ2=xmin:ymin:xmax:ymax:FF0000:1
                    194:  OBJ3=xmin:ymax:xmax:ymin:FF0000:1
                    195: 
                    196: =cut
1.1       albertel  197: 
                    198: package Apache::randomlylabel;
                    199: 
                    200: use strict;
                    201: use Image::Magick;
                    202: use Apache::Constants qw(:common);
                    203: use Apache::loncommon();
1.17      albertel  204: use GD;
1.13      albertel  205: use GD::Polyline();
1.15      albertel  206: use LWP::UserAgent();
1.26      albertel  207: use Apache::lonnet;
1.28      www       208: use lib '/home/httpd/lib/perl/';
                    209: use LONCAPA;
                    210:  
1.3       albertel  211: 
                    212: sub get_image {
                    213:     my ($imgsrc,$set_trans)=@_;
                    214:     my $image;
1.15      albertel  215:     if ($imgsrc !~ m|^(/home/)|) {
1.31    ! raeburn   216: 	if ($imgsrc !~ /^https?\:/) {
        !           217: 	    $imgsrc=&Apache::lonnet::absolute_url($ENV{'HTTP_HOST'}).$imgsrc;
1.15      albertel  218: 	}
                    219: 	my $ua=new LWP::UserAgent;
                    220: 	my $request=new HTTP::Request('GET',"$imgsrc");
                    221: 	$request->header(Cookie => $ENV{'HTTP_COOKIE'});
                    222: 	my $file="/tmp/imagetmp".$$;
                    223: 	my $response=$ua->request($request,$file);
                    224: 	if ($response->is_success) {
                    225: 	    if ($response->content_type !~ m-/(png|jpg|jpeg)$-i) {
                    226: 		my $conv_image = Image::Magick->new;
                    227: 		my $current_figure = $conv_image->Read('filename'=>$file);
1.20      albertel  228: 		$conv_image->Set('type'=>'TrueColor');
1.15      albertel  229: 		$conv_image->Set('magick'=>'png');
                    230: 		my @blobs=$conv_image->ImageToBlob();
                    231: 		undef $conv_image;
                    232: 		$image = GD::Image->new($blobs[0]);
                    233: 	    } else {
                    234: 		GD::Image->trueColor(1);
                    235: 		$image = GD::Image->new($file);
                    236: 	    }
                    237: 	}
                    238:     } elsif ($imgsrc !~ /\.(png|jpg|jpeg)$/i) {
1.3       albertel  239: 	my $conv_image = Image::Magick->new;
                    240: 	my $current_figure = $conv_image->Read('filename'=>$imgsrc);
1.20      albertel  241: 	$conv_image->Set('type'=>'TrueColor');
1.3       albertel  242: 	$conv_image->Set('magick'=>'png');
                    243: 	my @blobs=$conv_image->ImageToBlob();
                    244: 	undef $conv_image;
                    245: 	$image = GD::Image->new($blobs[0]);
                    246:     } else {
1.17      albertel  247: 	$image = GD::Image->trueColor(1);
1.3       albertel  248: 	$image = GD::Image->new($imgsrc);
                    249:     }
1.9       albertel  250:     if ($set_trans && defined($image)) {
1.3       albertel  251: 	my $white=$image->colorExact(255,255,255);
                    252: 	if ($white != -1) { $image->transparent($white); }
                    253:     }
                    254:     return $image;
                    255: }
1.1       albertel  256: 
1.16      albertel  257: sub get_color_from_hexstring {
                    258:     my ($image,$color)=@_;
                    259:     if (!$color) { $color='000000'; }
1.23      albertel  260:     $color=~s/^[x\#]//;
1.16      albertel  261:     my (undef,$red,undef,$green,undef,$blue)=split(/(..)/,$color);
                    262:     $red=hex($red);$green=hex($green);$blue=hex($blue);
                    263:     my $imcolor;
                    264:     if (!($imcolor = $image->colorResolve($red,$green,$blue))) {
                    265: 	$imcolor = $image->colorClosestHWB($red,$green,$blue);
                    266:     }
                    267:     return $imcolor;
                    268: }
                    269: 
1.30      albertel  270: sub add_click {
                    271:     my ($image) = @_;
                    272: 
                    273:     my $length=6;
                    274:     my $bgcolor=&get_color_from_hexstring($image,'FFFFFF');
                    275:     my $fgcolor=&get_color_from_hexstring($image,'009999');
                    276: 
                    277:     my ($x,$y) = split(':',$env{'form.clickdata'});
                    278: 
                    279:     $image->setThickness(3);
                    280:     $image->line($x-$length,$y,        $x+$length,$y,        $bgcolor);
                    281:     $image->line($x,        $y-$length,$x,        $y+$length,$bgcolor);
                    282:     $image->setThickness(1);
                    283:     $image->line($x-$length,$y,        $x+$length,$y,        $fgcolor);
                    284:     $image->line($x,        $y-$length,$x,        $y+$length,$fgcolor);
                    285: }
                    286: 
1.1       albertel  287: sub handler {
                    288:     my $r = shift;
                    289:     $r->content_type('image/png');
1.15      albertel  290:     $r->send_http_header;
1.29      albertel  291: 
                    292:     &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'});
                    293: 
                    294:     my $prefix;
1.24      albertel  295:     if ($ENV{'QUERY_STRING'}=~/OBJCOUNT\=/) {
                    296: 	$prefix='form.';
1.29      albertel  297:     } else {
                    298: 	$prefix="cgi.$env{'form.token'}.";
1.24      albertel  299:     }
1.29      albertel  300: 
                    301:     my $image;
1.26      albertel  302:     if (defined($env{$prefix."BGIMG"})) {
1.28      www       303: 	my $bgimg=&unescape($env{$prefix."BGIMG"});
1.18      albertel  304: 	#&Apache::lonnet::logthis("BGIMG is ".$bgimg);
1.17      albertel  305: 	$image=&get_image($bgimg,0);
                    306: 	if (! defined($image)) {
                    307: 	    &Apache::lonnet::logthis('Unable to create image object for -'.
1.29      albertel  308: 				     $env{'form.token'}.'-'.$bgimg);
1.17      albertel  309: 	    return OK;
                    310: 	}
1.26      albertel  311:     } elsif (defined($env{$prefix."SIZE"})) {
                    312: 	my ($width,$height)=split(':',$env{$prefix."SIZE"});
1.16      albertel  313: 	$image = new GD::Image($width,$height,1);
1.26      albertel  314: 	my ($bgcolor)=split(':',$env{$prefix."BGCOLOR"});
1.16      albertel  315: 	if ($bgcolor ne 'transparent') {
                    316: 	    $bgcolor=&get_color_from_hexstring($image,$bgcolor);
                    317: #	$image->rectangle(0,0,$width,$height,$bgcolor);
                    318: 	    $image->fill(0,0,$bgcolor);
                    319: 	} else {
                    320: 	    $bgcolor=&get_color_from_hexstring($image,'FFFFFF');
                    321: 	    $image->fill(0,0,$bgcolor);
                    322: 	    $image->transparent($bgcolor);
                    323: 	}
                    324:     } else {
1.29      albertel  325: 	&Apache::lonnet::logthis('Unable to create image object, no info '.$prefix);
1.16      albertel  326: 	return OK;
1.4       matthew   327:     }
1.1       albertel  328:     #binmode(STDOUT);
1.26      albertel  329:     my @objtypes=split(':',$env{$prefix."OBJTYPE"});
                    330:     foreach(my $i=0;$i<$env{$prefix."OBJCOUNT"};$i++) {
1.16      albertel  331: 	my $type=shift(@objtypes);
                    332: 	if ($type eq 'LINE') {
                    333: 	    my ($x1,$y1,$x2,$y2,$color,$thickness)=
1.26      albertel  334: 		split(':',$env{$prefix."OBJ$i"});
1.16      albertel  335: 	    my $imcolor=&get_color_from_hexstring($image,$color);
                    336: 	    if (!defined($thickness)) { $thickness=1; }
                    337: 	    $image->setThickness($thickness);
1.21      albertel  338: #	    $image->setAntiAliased($imcolor);
                    339: 	    $image->line($x1,$y1,$x2,$y2,$imcolor);
1.16      albertel  340: 	} elsif ($type eq 'RECTANGLE') {
                    341: 	    my ($x1,$y1,$x2,$y2,$color,$thickness,$filled)=
1.26      albertel  342: 		split(':',$env{$prefix."OBJ$i"});
1.16      albertel  343: 	    if ($x1 > $x2) { my $temp=$x1;$x1=$x2;$x2=$temp; }
                    344: 	    if ($y1 > $y2) { my $temp=$y1;$y1=$y2;$y2=$temp; }
                    345: 	    my $imcolor=&get_color_from_hexstring($image,$color);
                    346: 	    if (!defined($thickness)) { $thickness=1; }
                    347: 	    $image->setThickness($thickness);
                    348: #	    $image->setAntiAliased($imcolor);
                    349: 	    if ($filled) {
                    350: 		$image->filledRectangle($x1,$y1,$x2,$y2,$imcolor);
                    351: 	    } else {
                    352: 		$image->rectangle($x1,$y1,$x2,$y2,$imcolor);
                    353: 	    }
                    354: 	} elsif ($type eq 'POLYGON') {
1.26      albertel  355: 	    my ($color,$width,$open,$filled)=split(':',$env{$prefix."OBJ$i"});
1.16      albertel  356: 	    my $imcolor=&get_color_from_hexstring($image,$color);
1.21      albertel  357: 	    my $polygon = (($open && lc ($open ne 'no')) ?
                    358: 			   (new GD::Polyline) : (new GD::Polygon));
1.18      albertel  359: 	    my $added=0;
1.26      albertel  360: 	    foreach my $coord (split('-',$env{$prefix."OBJEXTRA$i"})) {
1.16      albertel  361: 		my ($x,$y)=($coord=~m/\(([0-9]+),([0-9]+)\)/);
                    362: 		$polygon->addPt($x,$y);
1.18      albertel  363: 		$added++;
1.16      albertel  364: 	    }
1.18      albertel  365: 	    
1.16      albertel  366: 	    $image->setThickness($width);
1.18      albertel  367: 	    if ($added) {
1.21      albertel  368: 		if ($open && lc($open) ne 'no') {
1.18      albertel  369: 		    $image->polydraw($polygon,$imcolor);
1.21      albertel  370: 		} elsif ($filled && lc($filled) ne 'no') {
                    371: 		    $image->filledPolygon($polygon,$imcolor);
1.18      albertel  372: 		} else {
                    373: 		    $image->polygon($polygon,$imcolor);
                    374: 		}
1.16      albertel  375: 	    }
                    376: 	} elsif ($type eq 'ARC') {
                    377: 	    my ($x,$y,$width,$height,$start,$end,$color,$thickness,$filled)=
1.26      albertel  378: 		split(':',$env{$prefix."OBJ$i"});
1.16      albertel  379: 	    if (!$color) { $color='000000'; }
                    380: 	    my $imcolor=&get_color_from_hexstring($image,$color);
                    381: 	    if (!defined($thickness)) { $thickness=1; }
                    382: 	    $image->setThickness($thickness);
                    383: #	    $image->setAntiAliased($imcolor);
                    384: 	    if ($filled) {
                    385: 		$image->filledArc($x,$y,$width,$height,$start,$end,
                    386: 				  $imcolor);
                    387: 	    } else {
                    388: 		$image->arc($x,$y,$width,$height,$start,$end,$imcolor);
                    389: 	    }
                    390: 	} elsif ($type eq 'FILL') {
1.26      albertel  391: 	    my ($x,$y,$color)=split(':',$env{$prefix."OBJ$i"});
1.16      albertel  392: 	    if (!$color) { $color='000000'; }
                    393: 	    my $imcolor=&get_color_from_hexstring($image,$color);
                    394: 	    $image->fill($x,$y,$imcolor);
                    395: 	} elsif ($type eq 'IMAGE') {
1.21      albertel  396: 	    my ($x,$y,$file,$transparent,$srcX,$srcY,$destW,$destH,$srcW,
1.26      albertel  397: 		$srcH)=split(':',$env{$prefix."OBJ$i"});
1.28      www       398: 	    $file=&unescape($file);
1.16      albertel  399: 	    if (!defined($transparent)) { $transparent=1; }
                    400: 	    my $subimage=&get_image($file,$transparent);
                    401: 	    if (!defined($subimage)) {
                    402: 		&Apache::lonnet::logthis('Unable to create image object for '.
                    403: 					 $file);
                    404: 		next;
                    405: 	    }
1.21      albertel  406: 	    if (!defined($srcW) or !$srcW) {$srcW=($subimage->getBounds())[0];}
                    407: 	    if (!defined($srcH) or !$srcH) {$srcH=($subimage->getBounds())[1];}
                    408: 	    if (!defined($destW) or !$destW) { $destW=$srcW; }
                    409: 	    if (!defined($destH) or !$destH) { $destH=$srcH; }
                    410: 	    $image->copyResized($subimage,$x,$y,$srcX,$srcY,$destW,$destH,
                    411: 				$srcW,$srcH);
1.16      albertel  412: 	} elsif ($type eq 'LABEL') {
1.19      albertel  413: 	    my ($x,$y,$text,$font,$color,$direction)=
1.26      albertel  414: 		split(':',$env{$prefix."OBJ$i"});
1.28      www       415: 	    $text=&unescape($text);
1.16      albertel  416: 	    my $imcolor=&get_color_from_hexstring($image,$color);
1.19      albertel  417: 	    my $type='normal';
                    418: 	    my ($height,$fontref);
                    419: 	    if ($font eq 'tiny') {
                    420: 		$height=GD::Font->Tiny->height;
                    421: 		$fontref=GD::gdTinyFont;
                    422: 	    } elsif ($font eq 'small') {
                    423: 		$height=GD::Font->Small->height;
                    424: 		$fontref=GD::gdSmallFont;
                    425: 	    } elsif ($font eq 'medium') {
                    426: 		$height=GD::Font->MediumBold->height;
                    427: 		$fontref=GD::gdMediumBoldFont;
                    428: 	    } elsif ($font eq 'large') {
                    429: 		$height=GD::Font->Large->height;
                    430: 		$fontref=GD::gdLargeFont;
1.21      albertel  431: 	    } elsif ($font eq 'giant' || !$font) {
1.19      albertel  432: 		$height=GD::Font->Giant->height;
                    433: 		$fontref=GD::gdGiantFont;
                    434: 	    } else {
                    435: 		$type='ttf';
                    436: 	    }
                    437: 	    if ($type eq 'normal' && $direction eq 'vertical') {
                    438: 		$image->stringUp($fontref,$x,$y-$height,$text,$imcolor);
                    439: 	    } elsif ($type eq 'normal') {
                    440: 		$image->string($fontref,$x,$y-$height,$text,$imcolor);
                    441: 	    } elsif ($type eq 'ttf') {
                    442: 		my ($fontname,$ptsize)=split(/\s+/,$font);
                    443: 		$image->stringFT($imcolor,$fontname,$ptsize,90,$x,$y,$text);
                    444: 	    }
1.18      albertel  445: 	} else {
                    446: 	    &Apache::lonnet::logthis("randomlylabel unable to handle object of type $type");
1.13      albertel  447: 	}
1.10      albertel  448:     }
1.30      albertel  449:     if (exists($env{'form.clickdata'})) { &add_click($image); }
1.10      albertel  450:     $image->setThickness(1);
1.3       albertel  451:     $r->print($image->png);
1.1       albertel  452:     return OK;
                    453: }
                    454: 
                    455: 1;

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>