# The LearningOnline Network with CAPA # random labelling tool # # $Id: randomlabel.pm,v 1.72 2005/04/18 21:41:51 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; my %args; my $cgi_id; 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); 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); } 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') { $bgimg=&Apache::imageresponse::clean_up_image($bgimg); $args{"cgi.$cgi_id.BGIMG"}=&Apache::lonnet::escape($bgimg); } elsif ($target eq 'tex') { $result.=&make_eps_image($bgimg,$parstack,$safeeval,-2); } } return $result; } my $scale_factor; # image scale factor. sub make_eps_image { my ($bgimg,$parstack,$safeeval,$depth)=@_; my ($path,$file) = &Apache::londefdef::get_eps_image($bgimg); ($height_param,$width_param)= &Apache::londefdef::image_size($bgimg,0.3,$parstack,$safeeval, $depth,1); 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'); $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); 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 = '