# The LearningOnline Network with CAPA # random labelling tool # # $Id: randomlabel.pm,v 1.75 2005/05/24 10:10:16 foxr Exp $ # # Copyright Michigan State University Board of Trustees # # This file is part of the LearningOnline Network with CAPA (LON-CAPA). # # LON-CAPA is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # LON-CAPA is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with LON-CAPA; if not, write to the Free Software # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA # # /home/httpd/html/adm/gpl.txt # # http://www.lon-capa.org/ # # SYNTAX: # # # # # # # # # # # # # # # # # # # =========================================== # side effect: # location (123,456): $GroupOne[0] = 2 # images give out indexes # (321,654): $GroupOne[1] = 1 # (213,546): $GroupOne[2] = 0 # location (12,45) : $GroupTwo[0] = "TEXT-3" # (32,65) : $GroupTwo[1] = "TEXT-1" # (21,54) : $GroupTwo[2] = "TEXT-2" # =========================================== package Apache::randomlabel; use Apache::lonnet; use strict; use Apache::edit; use Apache::File(); use Apache::Constants qw(:common :http); use Image::Magick; use Apache::lonplot; my %args; my $cgi_id; my $scale_factor; # image scale factor. my $label_xscale; # Label scale factor (needed for gnuplot). my $label_yscale; BEGIN { &Apache::lonxml::register('Apache::randomlabel',('randomlabel','labelgroup','location','label','bgimg')); } sub check_int { # utility function to do error checking on a integer. my ($num,$default) = @_; $default = 100 if (! defined($default)); $num =~ s/\s+//g; # We dont need no stinkin white space! # If it is a real, just grab the integer part. ($num,undef) = split (/\./,$num) if ($num =~ /\./); # set to default if what we have left doesn't match anything... $num = $default unless ($num =~/^\d+$/); return $num; } my ($height_param,$width_param); sub start_randomlabel { my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_; my $result=''; push (@Apache::lonxml::namespace,'randomlabel'); ($height_param,$width_param)=(0,0); $label_xscale = 1.0; # Assume image size not overridden. $label_yscale = 1.0; my $bgimg= &Apache::lonxml::get_param('bgimg',$parstack,$safeeval); if ( defined($bgimg) && $bgimg !~ /^http:/ ) { $bgimg=&Apache::lonnet::filelocation($Apache::lonxml::pwd[-1],$bgimg); if (&Apache::lonnet::repcopy($bgimg) ne 'ok') { $bgimg='/home/httpd/html/adm/lonKaputt/lonlogo_broken.gif'; } } $Apache::randomlabel::obj_cnt=0; if ($target eq 'web') { $cgi_id=&Apache::loncommon::get_cgi_id(); %args=(); $args{"cgi.$cgi_id.BGIMG"}=&Apache::lonnet::escape($bgimg); $height_param = &Apache::lonxml::get_param('height',$parstack, $safeeval); $width_param = &Apache::lonxml::get_param('width', $parstack, $safeeval); } elsif ($target eq 'tex' && defined($bgimg)) { $result.=&make_eps_image($bgimg,$parstack,$safeeval); } elsif ($target eq 'edit') { $result.=&Apache::edit::tag_start($target,$token); $Apache::edit::bgimgsrc= &Apache::lonxml::get_param('bgimg',$parstack,$safeeval); $Apache::edit::bgimgsrccurdepth=$Apache::lonxml::curdepth; $result.=&Apache::edit::text_arg('Image:','bgimg',$token,75).' '; $result.=&Apache::edit::browse('bgimg').' '; $result.=&Apache::edit::search('bgimg').'
'. &Apache::edit::text_arg('Width(pixel):' ,'width' ,$token,6). &Apache::edit::text_arg('Height(pixel):','height' ,$token,6). &Apache::edit::text_arg('TeXWidth(mm):' ,'texwidth',$token,6). &Apache::edit::end_row().&Apache::edit::start_spanning_row(); } elsif ($target eq 'modified') { my $constructtag=&Apache::edit::get_new_args($token,$parstack, $safeeval,'bgimg','width', 'height','texwidth'); if ($constructtag) { $result = &Apache::edit::rebuild_tag($token); $result.=&Apache::edit::handle_insert(); } } return $result; } sub end_randomlabel { my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_; my $result=''; my $count; pop @Apache::lonxml::namespace; if ($target eq 'web') { $count = $Apache::randomlabel::obj_cnt; if( $count != 0) { $args{"cgi.$cgi_id.OBJCOUNT"}=$count; } $result.='
'."\n"; &Apache::lonnet::appenv(%args); } elsif ($target eq 'tex') { $result='\end{picture}\\\\'; $result.= ' \vskip -'.$height_param.' mm } \\\\ '; } elsif ($target eq 'edit') { $result.=&Apache::edit::end_table; } return $result; } sub start_bgimg { my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_; my $result=''; if ($target eq 'web' || $target eq 'tex' || $target eq 'analyze') { &Apache::lonxml::startredirection(); } return $result; } sub end_bgimg { my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_; my $result=''; if ($target eq 'web' || $target eq 'tex' || $target eq 'analyze') { my $bgimg=&Apache::lonxml::endredirection(); if ($target eq 'web') { # Try to determine if this is a gnu plot image in which # case it's size overrides the web size. # If it's a gnuplot the uncleaned image will have # the text "dynamically generated plot" # and "cgi-bin/plot.gif?" if ( ($bgimg =~ /dynamically generated plot/) && ($bgimg =~ /cgi-bin\/plot.gif\?/) ) { &Apache::lonxml::debug("Gnuplot image!"); my $plot_x = $Apache::lonplot::plot{'width'}; my $plot_y = $Apache::lonplot::plot{'height'}; &Apache::lonxml::debug(" H = $plot_y W = $plot_x"); &Apache::lonxml::debug("PH = $height_param, PW = $width_param"); $label_xscale = $plot_x/$width_param; $label_yscale = $plot_y/$height_param; } &Apache::lonxml::debug("Image: $bgimg"); $bgimg=&Apache::imageresponse::clean_up_image($bgimg); &Apache::lonxml::debug("Cleaned image: $bgimg"); $args{"cgi.$cgi_id.BGIMG"}=&Apache::lonnet::escape($bgimg); } elsif ($target eq 'tex') { # Some bg images can create latex for us... e.g. gnuplot. # If it looks like we have some latex use that, # otherwise, assume this is a resource name that must # be converted into the latex to create an eps insertion. # my $src = $bgimg; $src =~ s/\s+$//s; $src =~ s/^\s+//s; if ($src =~ /^\\graphicspath/) { $height_param = $Apache::lonplot::plot{'height'}; my $initial_width= $Apache::lonplot::plot{'width'}; $width_param = $Apache::lonplot::plot{'texwidth'}; $scale_factor = $width_param / $initial_width; $height_param = $height_param*$scale_factor; &Apache::lonxml::debug("height $height_param"); &Apache::lonxml::debug("Width $width_param"); my $dirty_width = $width_param + 5; $result .= '\parbox{'.$dirty_width.'mm}{'; $result .= $src."\n"; $result .= '\setlength{\unitlength}{1mm}'."\n"; $result .= '\begin{picture}('."$height_param,$width_param)"; $result .= "(0,-$height_param)"; $result .= "\n"; } else { $result.=&make_eps_image($bgimg,$parstack,$safeeval,-2); } } } return $result; } sub make_eps_image { my ($bgimg,$parstack,$safeeval,$depth)=@_; &Apache::lonxml::debug("image prior to get_eps_image: $bgimg"); my ($path,$file) = &Apache::londefdef::get_eps_image($bgimg); &Apache::lonxml::debug("image after: $bgimg"); ($height_param,$width_param)= &Apache::londefdef::image_size($bgimg,0.3,$parstack,$safeeval, $depth,1); &Apache::lonxml::debug("Image size: $height_param x $width_param"); my $dirtywidth=$width_param+5; my $result ="\n".'\vspace*{2mm}\noindent'."\n". '\parbox{'.$dirtywidth. ' mm}{ \noindent \epsfxsize='.$width_param. ' mm \epsffile{'.$path.$file. '}\setlength{\unitlength}{1mm}'."\n".' \begin{picture}('. $width_param.','.$height_param.')(0,-'.$height_param.')'."\n"; my $magick = Image::Magick->new; $magick->Read($bgimg); my $initial_width = $magick->Get('width'); &Apache::lonxml::debug("ImageMagick thinks width is; $initial_width"); $scale_factor = $width_param / $initial_width; return $result; } sub start_labelgroup { my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_; my $result=''; my $name = &Apache::lonxml::get_param('name',$parstack,$safeeval); my $type = &Apache::lonxml::get_param('type',$parstack,$safeeval); $type =~tr/A-Z/a-z/; if ($target ne 'modified' && ($name =~ /\W/ || $name =~ /^[0-9]/)) { &Apache::lonxml::error("Only _ a-z A-Z and 0-9 are allowed in the name to a labelgroup, and the first character can not be a number.
"); } if ($target eq 'web' || $target eq 'tex' || $target eq 'grade' || $target eq 'answer' || $target eq 'analyze') { $Apache::randomlabel::groupname=$name; $Apache::randomlabel::type=$type; @Apache::randomlabel::xcoord = (); @Apache::randomlabel::ycoord = (); @Apache::randomlabel::value = (); @Apache::randomlabel::label_arr = (); @Apache::randomlabel::description = (); } elsif ($target eq 'edit') { $result.=&Apache::edit::tag_start($target,$token); $result.=&Apache::edit::text_arg('Name:','name',$token). &Apache::edit::select_arg('Type:','type',['text','image'],$token); if (!defined($token->[2]{'TeXsize'})) { $token->[2]{'TeXsize'}='\normalsize'; } $result.=&Apache::edit::select_arg('TeX font size:','TeXsize', ['\tiny','\scriptsize', '\footnotesize','\small', '\normalsize','\large','\Large', '\LARGE','\huge','\Huge'], $token); $result.=&Apache::edit::end_row().&Apache::edit::start_spanning_row(); } elsif ($target eq 'modified') { my $constructtag=&Apache::edit::get_new_args($token,$parstack, $safeeval,'name','type', 'TeXsize'); if ($constructtag) { $result = &Apache::edit::rebuild_tag($token); $result.=&Apache::edit::handle_insert(); } } return $result; } # # Utility sub to compute the width of a label. # sub get_label_width { my $label = shift; &Apache::lonxml::debug("image label = $label"); if (-e $label) { &Apache::lonxml::debug("$label exists"); } else { &Apache::lonxml::debug("$label does not exist"); } my $magick = Image::Magick->new; $magick->Read($label); my $pixel_width = $magick->Get('width'); return $pixel_width * $scale_factor; } sub add_vars { my ($name,$order,$label,$labelorder,$value,$image,$safeeval) = @_; if (!defined($name) || $name eq '') { return; } my $code = '${'.$name."}{'".($order+1)."'}='".$label."';"; my $out=Apache::run::run($code,$safeeval); if ($value) { $code = '${'.$name."}{'value_".($order+1)."'}='".$value."';"; $out=Apache::run::run($code,$safeeval); $code = '${'.$name."}{'labelvalue_".($labelorder+1)."'}='".$value."';"; $out=Apache::run::run($code,$safeeval); } if ($image) { my $code = '${'.$name."}{'image_".($order+1)."'}='".$image."';"; my $out=Apache::run::run($code,$safeeval); } $code = '${'.$name."}{'numlocations'}='".($order+1)."';"; $out=Apache::run::run($code,$safeeval); } # begin to assign labels to locations sub end_labelgroup { my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_; my $gname = $Apache::randomlabel::groupname; my $type = $Apache::randomlabel::type; my $result=''; if ($target eq 'web' || $target eq 'answer' || $target eq 'grade' || $target eq 'analyze') { my @idx_arr = (0 .. $#Apache::randomlabel::label_arr); &Apache::structuretags::shuffle(\@idx_arr); for(0 .. $#Apache::randomlabel::label_arr) { my $str; my $label = "$Apache::randomlabel::label_arr[ $idx_arr[$_] ]"; my $x = $Apache::randomlabel::xcoord[$_]; my $y = $Apache::randomlabel::ycoord[$_]; my $value = $Apache::randomlabel::value[$_]; my $i=$Apache::randomlabel::obj_cnt++; if( $type eq 'text') { &add_vars($gname,$_,$label,$idx_arr[$_],$value,'',$safeeval); $str = join(':',$x,$y,&Apache::lonnet::escape($label)); $args{"cgi.$cgi_id.OBJTYPE"}.='LABEL:'; } elsif ( $type eq 'image') { &add_vars($gname,$_, $Apache::randomlabel::description[$idx_arr[$_]], $idx_arr[$_],$value,$label,$safeeval); $str = join(':',$x,$y,&Apache::lonnet::escape($label)); $args{"cgi.$cgi_id.OBJTYPE"}.='IMAGE:'; } else { &Apache::lonxml::error('Unknown type of label :'.$type.':'); } if ($target eq 'web') { $args{"cgi.$cgi_id.OBJ$i"} =$str; } } } elsif ($target eq 'tex') { my $WX1=0; # Web x-coord. of upper left corner (ULC) my $WY1=0; # Web y-coord. of (ULC) my $wwidth=&Apache::lonxml::get_param('width',$parstack,$safeeval,-2); my $wheight=&Apache::lonxml::get_param('height',$parstack,$safeeval,-2); my $TeXsize=&Apache::lonxml::get_param('TeXsize',$parstack,$safeeval); if (!defined($TeXsize)) { $TeXsize='\\normalsize'; } my @idx_arr = (0 .. $#Apache::randomlabel::label_arr); &Apache::structuretags::shuffle(\@idx_arr); &Apache::lonxml::debug("Array is:".$#Apache::randomlabel::label_arr.":"); for(my $i=0;$i <= $#Apache::randomlabel::label_arr; $i++) { my $label = "$Apache::randomlabel::label_arr[ $idx_arr[$i] ]"; my $x = $Apache::randomlabel::xcoord[$i]; # FIXME the 3.5 here is the 'height' of the letter in TeX my $y = $Apache::randomlabel::ycoord[$i]-3.5; my $value = $Apache::randomlabel::value[$i]; #x latex coordinate my $tcX=($x)*($width_param/$wwidth); #y latex coordinate # my $ratio=($wwidth > 0 ? $wheight/$wwidth : 1 ); my $tcY=$height_param-$y*($height_param/$wheight); $tcX=sprintf('%.2f',$tcX); $tcY=sprintf('%.2f',$tcY); $result .= '\put('.$tcX.','.$tcY.'){'; if( $type eq 'text') { $result.= $TeXsize.' \bf '.$label."}\n"; &add_vars($gname,$i,$label,$idx_arr[$i],$value,'',$safeeval); } elsif ( $type eq 'image') { my ($path,$file) = &Apache::londefdef::get_eps_image($label); my $image_name = $path.$file; my $label_width = get_label_width($label); $result .= '\includegraphics[width='.$label_width.'mm]{' .$image_name."}}\n"; &add_vars($gname,$i, $Apache::randomlabel::description[$idx_arr[$i]], $idx_arr[$i],$value,$label,$safeeval); } else { &Apache::lonxml::error('Unknown type of label :'.$type.':'); } } } elsif ($target eq 'edit') { $result.=&Apache::edit::end_table; } return $result; } # sub start_location { my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_; my $x= &check_int(&Apache::lonxml::get_param('x',$parstack,$safeeval),50); my $y= &check_int(&Apache::lonxml::get_param('y',$parstack,$safeeval),50); &Apache::lonxml::debug("x = $x y = $y"); $x = $x*$label_xscale; $y = $y*$label_yscale; &Apache::lonxml::debug(" H = $height_param W = $width_param"); &Apache::lonxml::debug(" XS = $label_xscale YS = $label_yscale"); &Apache::lonxml::debug(" X = $x Y = $y"); my $value= &Apache::lonxml::get_param('value',$parstack,$safeeval); my $result=''; push(@Apache::randomlabel::xcoord,$x); push(@Apache::randomlabel::ycoord,$y); push(@Apache::randomlabel::value,$value); if ($target eq 'edit') { $result.=&Apache::edit::tag_start($target,$token); $result.=&Apache::edit::text_arg('X:','x',$token,4). &Apache::edit::text_arg('Y:','y',$token,4). &Apache::edit::entercoords('x','y','attribute','width','height').'   '. &Apache::edit::text_arg('Value:','value',$token). &Apache::edit::end_row(); $result.=&Apache::edit::end_table; } elsif ($target eq 'modified') { my $constructtag=&Apache::edit::get_new_args($token,$parstack, $safeeval,'x','y','value'); if ($constructtag) { $result = &Apache::edit::rebuild_tag($token); $result.=&Apache::edit::handle_insert(); } } return $result; } sub end_location { my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_; my @result; if ($target eq 'edit') { @result=('','no') } return @result; } # sub start_label { my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_; my $result=''; my $type = &Apache::lonxml::get_param('type',$parstack,$safeeval,-2); if ($target eq 'web' || $target eq 'tex' || $target eq 'grade' || $target eq 'answer' || $target eq 'analyze') { &Apache::lonxml::startredirection; } elsif ($target eq 'edit') { $result.=&Apache::edit::tag_start($target,$token,"$type Label"); my $text=&Apache::lonxml::get_all_text("/label",$parser); if ($type eq 'image') { $result.=&Apache::edit::end_row(). &Apache::edit::start_spanning_row(); $result.=&Apache::edit::text_arg('Description:','description', $token); } if ($type eq 'text') { $result.="Label Text:"; } if ($type eq 'image') { $result.="Path to image: "; } $result.=&Apache::edit::editline('',$text,'',50). &Apache::edit::end_table(); } elsif ($target eq 'modified') { $result = '