--- loncom/homework/randomlylabel.pm 2004/03/16 23:08:23 1.19
+++ loncom/homework/randomlylabel.pm 2005/04/07 06:56:22 1.26
@@ -2,7 +2,7 @@
# The LearningOnline Network with CAPA
# randomlabel.png: composite together text and images into 1 image
#
-# $Id: randomlylabel.pm,v 1.19 2004/03/16 23:08:23 albertel Exp $
+# $Id: randomlylabel.pm,v 1.26 2005/04/07 06:56:22 albertel Exp $
#
# Copyright Michigan State University Board of Trustees
#
@@ -26,7 +26,175 @@
#
# http://www.lon-capa.org/
#
-###
+
+=pod
+
+=head1 Syntax of randomlylabel commands
+
+Required items are: (one of BGIMG or SIZE) and OBJCOUNT
+
+=over 4
+
+=item BGIMG
+
+/home/... file
+/res/ ... URL
+or href (href must contain http://...)
+Expected to be HTTP escaped
+
+=item SIZE
+
+width:height
+
+Creates a blank canvas of size width,height.
+
+=item BGCOLOR
+
+either I<transparent> or a color hexstring
+
+Sets the background color, if SIZE is used to create a new canvas,
+I<trasparent> makes the background transparent.
+
+=item OBJCOUNT
+
+a number
+
+=item OBJTYPE
+
+a colon seperated list of types, supported types are
+
+ B<LINE> B<RECTANGLE> B<POLYGON> B<ARC> B<FILL> B<IMAGE> B<LABEL>
+
+=item OBJI<num>
+
+arguments for this OBJ
+
+some common arguments are
+
+=over 4
+
+=item x y thickness
+
+are pixel values
+
+=item color
+
+a hexstring, without with out a leading # or x)
+
+=item filled
+
+boolean, (1 or 0)
+
+=back
+
+The argumants for the possible object types are
+
+=over 4
+
+=item LINE
+
+x1:y1:x2:y2:color:thickness
+
+=item RECTANGLE
+
+x1:y1:x2:y2:color:thickness:filled
+
+=item ARC
+
+x:y:width:height:start:end:color:thickness:filled
+
+=over 4
+
+=item start, end
+
+start and ends of the arc (in degrees)
+
+=back
+
+=item FILL
+
+x:y:color
+
+=item IMAGE
+
+x:y:file:transparent:srcX:srcY:destW:destH:srcW:srcH
+
+=over 4
+
+=item srcX,srcY,srcW,srcH
+
+the start and extant of the region in file to copy to x,y with width/height
+ destW destH
+
+=back
+
+=item LABEL
+
+x:y:text:font:color:direction
+
+=over 4
+
+=item text
+
+HTTP escaped string of the text to place on the image
+
+=item font
+
+one of B<tiny>, B<small>, B<medium>, B<large>, B<giant>, or an
+installed TTF font and point size
+
+=item direction
+
+either B<horizontal> or B<vertical>
+
+=back
+
+=item POLYGON
+
+color:width:open:filled
+
+=over 4
+
+=item open
+
+boolean, (1 or 0)
+
+=back
+
+=back
+
+
+=item OBJEXTRAI<num>
+
+extra arguments for object I<num>
+
+The possible values for this for the different object types are
+
+=over 4
+
+=item POLYGON
+
+a list of coords in the form
+
+ (x,y)-(x,y)-(x,y)
+
+(there can be arbitrarily many of these)
+
+=back
+
+=back
+
+=head1 Example
+
+ BGIMG=file
+ OBJTYPE=LINE:LINE:LINE:LINE
+ OBJCOUNT=4
+ OBJ0=xmin:ymin:xmax:ymax:FFFFFF:3
+ OBJ1=xmin:ymax:xmax:ymin:FFFFFF:3
+ OBJ2=xmin:ymin:xmax:ymax:FF0000:1
+ OBJ3=xmin:ymax:xmax:ymin:FF0000:1
+
+=cut
package Apache::randomlylabel;
@@ -37,6 +205,7 @@ use Apache::loncommon();
use GD;
use GD::Polyline();
use LWP::UserAgent();
+use Apache::lonnet;
sub get_image {
my ($imgsrc,$set_trans)=@_;
@@ -54,6 +223,7 @@ sub get_image {
if ($response->content_type !~ m-/(png|jpg|jpeg)$-i) {
my $conv_image = Image::Magick->new;
my $current_figure = $conv_image->Read('filename'=>$file);
+ $conv_image->Set('type'=>'TrueColor');
$conv_image->Set('magick'=>'png');
my @blobs=$conv_image->ImageToBlob();
undef $conv_image;
@@ -66,6 +236,7 @@ sub get_image {
} elsif ($imgsrc !~ /\.(png|jpg|jpeg)$/i) {
my $conv_image = Image::Magick->new;
my $current_figure = $conv_image->Read('filename'=>$imgsrc);
+ $conv_image->Set('type'=>'TrueColor');
$conv_image->Set('magick'=>'png');
my @blobs=$conv_image->ImageToBlob();
undef $conv_image;
@@ -84,6 +255,7 @@ sub get_image {
sub get_color_from_hexstring {
my ($image,$color)=@_;
if (!$color) { $color='000000'; }
+ $color=~s/^[x\#]//;
my (undef,$red,undef,$green,undef,$blue)=split(/(..)/,$color);
$red=hex($red);$green=hex($green);$blue=hex($blue);
my $imcolor;
@@ -99,8 +271,13 @@ sub handler {
$r->send_http_header;
my (undef,$id) = split(/=/,$ENV{'QUERY_STRING'});
my $image;
- if (defined($ENV{"cgi.$id.BGIMG"})) {
- my $bgimg=&Apache::lonnet::unescape($ENV{"cgi.$id.BGIMG"});
+ my $prefix="cgi.$id.";
+ if ($ENV{'QUERY_STRING'}=~/OBJCOUNT\=/) {
+ &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'});
+ $prefix='form.';
+ }
+ if (defined($env{$prefix."BGIMG"})) {
+ my $bgimg=&Apache::lonnet::unescape($env{$prefix."BGIMG"});
#&Apache::lonnet::logthis("BGIMG is ".$bgimg);
$image=&get_image($bgimg,0);
if (! defined($image)) {
@@ -108,10 +285,10 @@ sub handler {
$id.'-'.$bgimg);
return OK;
}
- } elsif (defined($ENV{"cgi.$id.SIZE"})) {
- my ($width,$height)=split(':',$ENV{"cgi.$id.SIZE"});
+ } elsif (defined($env{$prefix."SIZE"})) {
+ my ($width,$height)=split(':',$env{$prefix."SIZE"});
$image = new GD::Image($width,$height,1);
- my ($bgcolor)=split(':',$ENV{"cgi.$id.BGCOLOR"});
+ my ($bgcolor)=split(':',$env{$prefix."BGCOLOR"});
if ($bgcolor ne 'transparent') {
$bgcolor=&get_color_from_hexstring($image,$bgcolor);
# $image->rectangle(0,0,$width,$height,$bgcolor);
@@ -126,20 +303,20 @@ sub handler {
return OK;
}
#binmode(STDOUT);
- my @objtypes=split(':',$ENV{"cgi.$id.OBJTYPE"});
- foreach(my $i=0;$i<$ENV{"cgi.$id.OBJCOUNT"};$i++) {
+ my @objtypes=split(':',$env{$prefix."OBJTYPE"});
+ foreach(my $i=0;$i<$env{$prefix."OBJCOUNT"};$i++) {
my $type=shift(@objtypes);
if ($type eq 'LINE') {
my ($x1,$y1,$x2,$y2,$color,$thickness)=
- split(':',$ENV{"cgi.$id.OBJ$i"});
+ split(':',$env{$prefix."OBJ$i"});
my $imcolor=&get_color_from_hexstring($image,$color);
if (!defined($thickness)) { $thickness=1; }
$image->setThickness($thickness);
- $image->setAntiAliased($imcolor);
- $image->line($x1,$y1,$x2,$y2,gdAntiAliased);
+# $image->setAntiAliased($imcolor);
+ $image->line($x1,$y1,$x2,$y2,$imcolor);
} elsif ($type eq 'RECTANGLE') {
my ($x1,$y1,$x2,$y2,$color,$thickness,$filled)=
- split(':',$ENV{"cgi.$id.OBJ$i"});
+ split(':',$env{$prefix."OBJ$i"});
if ($x1 > $x2) { my $temp=$x1;$x1=$x2;$x2=$temp; }
if ($y1 > $y2) { my $temp=$y1;$y1=$y2;$y2=$temp; }
my $imcolor=&get_color_from_hexstring($image,$color);
@@ -152,11 +329,12 @@ sub handler {
$image->rectangle($x1,$y1,$x2,$y2,$imcolor);
}
} elsif ($type eq 'POLYGON') {
- my ($color,$width,$open)=split(':',$ENV{"cgi.$id.OBJ$i"});
+ my ($color,$width,$open,$filled)=split(':',$env{$prefix."OBJ$i"});
my $imcolor=&get_color_from_hexstring($image,$color);
- my $polygon = (($open) ? (new GD::Polyline) : (new GD::Polygon));
+ my $polygon = (($open && lc ($open ne 'no')) ?
+ (new GD::Polyline) : (new GD::Polygon));
my $added=0;
- foreach my $coord (split('-',$ENV{"cgi.$id.OBJEXTRA$i"})) {
+ foreach my $coord (split('-',$env{$prefix."OBJEXTRA$i"})) {
my ($x,$y)=($coord=~m/\(([0-9]+),([0-9]+)\)/);
$polygon->addPt($x,$y);
$added++;
@@ -164,15 +342,17 @@ sub handler {
$image->setThickness($width);
if ($added) {
- if ($open) {
+ if ($open && lc($open) ne 'no') {
$image->polydraw($polygon,$imcolor);
+ } elsif ($filled && lc($filled) ne 'no') {
+ $image->filledPolygon($polygon,$imcolor);
} else {
$image->polygon($polygon,$imcolor);
}
}
} elsif ($type eq 'ARC') {
my ($x,$y,$width,$height,$start,$end,$color,$thickness,$filled)=
- split(':',$ENV{"cgi.$id.OBJ$i"});
+ split(':',$env{$prefix."OBJ$i"});
if (!$color) { $color='000000'; }
my $imcolor=&get_color_from_hexstring($image,$color);
if (!defined($thickness)) { $thickness=1; }
@@ -185,12 +365,13 @@ sub handler {
$image->arc($x,$y,$width,$height,$start,$end,$imcolor);
}
} elsif ($type eq 'FILL') {
- my ($x,$y,$color)=split(':',$ENV{"cgi.$id.OBJ$i"});
+ my ($x,$y,$color)=split(':',$env{$prefix."OBJ$i"});
if (!$color) { $color='000000'; }
my $imcolor=&get_color_from_hexstring($image,$color);
$image->fill($x,$y,$imcolor);
} elsif ($type eq 'IMAGE') {
- my ($x,$y,$file,$transparent)=split(':',$ENV{"cgi.$id.OBJ$i"});
+ my ($x,$y,$file,$transparent,$srcX,$srcY,$destW,$destH,$srcW,
+ $srcH)=split(':',$env{$prefix."OBJ$i"});
$file=&Apache::lonnet::unescape($file);
if (!defined($transparent)) { $transparent=1; }
my $subimage=&get_image($file,$transparent);
@@ -199,10 +380,15 @@ sub handler {
$file);
next;
}
- $image->copy($subimage,$x,$y,0,0,$subimage->getBounds());
+ if (!defined($srcW) or !$srcW) {$srcW=($subimage->getBounds())[0];}
+ if (!defined($srcH) or !$srcH) {$srcH=($subimage->getBounds())[1];}
+ if (!defined($destW) or !$destW) { $destW=$srcW; }
+ if (!defined($destH) or !$destH) { $destH=$srcH; }
+ $image->copyResized($subimage,$x,$y,$srcX,$srcY,$destW,$destH,
+ $srcW,$srcH);
} elsif ($type eq 'LABEL') {
my ($x,$y,$text,$font,$color,$direction)=
- split(':',$ENV{"cgi.$id.OBJ$i"});
+ split(':',$env{$prefix."OBJ$i"});
$text=&Apache::lonnet::unescape($text);
my $imcolor=&get_color_from_hexstring($image,$color);
my $type='normal';
@@ -219,7 +405,7 @@ sub handler {
} elsif ($font eq 'large') {
$height=GD::Font->Large->height;
$fontref=GD::gdLargeFont;
- } elsif ($font eq 'giant' || !defined($font)) {
+ } elsif ($font eq 'giant' || !$font) {
$height=GD::Font->Giant->height;
$fontref=GD::gdGiantFont;
} else {