Diff for /loncom/homework/radiobuttonresponse.pm between versions 1.97 and 1.153.6.8

version 1.97, 2004/12/23 17:08:22 version 1.153.6.8, 2012/01/30 11:36:55
Line 18 Line 18
 # GNU General Public License for more details.  # GNU General Public License for more details.
 #  #
 # You should have received a copy of the GNU General Public License  # You should have received a copy of the GNU General Public License
 # along with LON-CAPA; if not, write to the Free Software  # along with LON-CAPA; if not, write to the Free Software# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA  
 #  #
 # /home/httpd/html/adm/gpl.txt  # /home/httpd/html/adm/gpl.txt
 #  #
Line 30  package Apache::radiobuttonresponse; Line 29  package Apache::radiobuttonresponse;
 use strict;  use strict;
 use HTML::Entities();  use HTML::Entities();
 use Apache::lonlocal;  use Apache::lonlocal;
   use Apache::lonnet;
   use Apache::response;
   use Apache::caparesponse;
   
   my $default_bubbles_per_line = 10;
   my @alphabet      = ( 'A' .. 'Z' ); # Foil labels.
   
   
   
 BEGIN {  BEGIN {
     &Apache::lonxml::register('Apache::radiobuttonresponse',('radiobuttonresponse'));      &Apache::lonxml::register( 'Apache::radiobuttonresponse',
           ('radiobuttonresponse') );
   }
   
   sub bubble_line_count {
       my ( $numfoils, $bubbles_per_line ) = @_;
       my $bubble_lines;
       $bubble_lines = int( $numfoils / $bubbles_per_line );
       if ( ( $numfoils % $bubbles_per_line ) != 0 ) {
           $bubble_lines++;
       }
       return $bubble_lines;
   
 }  }
   
 sub start_radiobuttonresponse {  sub start_radiobuttonresponse {
     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;      my ( $target, $token, $tagstack, $parstack, $parser, $safeeval, $style ) =
         @_;
     my $result;      my $result;
   
     #when in a radiobutton response use these      #when in a radiobutton response use these
     &Apache::lonxml::register('Apache::radiobuttonresponse',('foilgroup','foil','conceptgroup'));      &Apache::lonxml::register( 'Apache::radiobuttonresponse',
     push (@Apache::lonxml::namespace,'radiobuttonresponse');          ( 'foilgroup', 'foil', 'conceptgroup' ) );
     my $id = &Apache::response::start_response($parstack,$safeeval);      push( @Apache::lonxml::namespace, 'radiobuttonresponse' );
     %Apache::hint::radiobutton=();      my $id = &Apache::response::start_response( $parstack, $safeeval );
   
       %Apache::hint::radiobutton = ();
     undef(%Apache::response::foilnames);      undef(%Apache::response::foilnames);
     if ($target eq 'meta') {      if ( $target eq 'meta' ) {
  $result=&Apache::response::meta_package_write('radiobuttonresponse');          $result = &Apache::response::meta_package_write('radiobuttonresponse');
     } elsif ($target eq 'edit' ) {      }
  $result.=&Apache::edit::start_table($token).      elsif ( $target eq 'edit' ) {
     '<tr><td>'.&Apache::lonxml::description($token).          $result .=
     &Apache::loncommon::help_open_topic('Radio_Response_Problems').              &Apache::edit::start_table($token)
     "</td><td>Delete:".            . '<tr><td>'
     &Apache::edit::deletelist($target,$token)            . &Apache::lonxml::description($token)
     ."</td><td>&nbsp".&Apache::edit::end_row()            . &Apache::loncommon::help_open_topic('Radio_Response_Problems')
     .&Apache::edit::start_spanning_row();            . '</td>'
  $result.=            . '<td><span class="LC_nobreak">'
     &Apache::edit::text_arg('Max Number Of Shown Foils:','max',            . &mt('Delete?') . ' '
     $token,'4').            . &Apache::edit::deletelist( $target, $token )
     &Apache::edit::select_arg('Randomize Foil Order','randomize',            . '</span></td>'
       ['yes','no'],$token).            . '<td>&nbsp;'
       &Apache::edit::end_row().            . &Apache::edit::end_row()
       &Apache::edit::start_spanning_row()."\n";            . &Apache::edit::start_spanning_row();
     } elsif ($target eq 'modified') {          $result .= &Apache::edit::text_arg( 'Max Number Of Shown Foils:',
  my $constructtag=&Apache::edit::get_new_args($token,$parstack,              'max', $token, '4' )
      $safeeval,'max',            . '&nbsp;' x 3
      'randomize');            . &Apache::edit::select_arg( 'Randomize Foil Order:',
  if ($constructtag) { $result = &Apache::edit::rebuild_tag($token); }              'randomize', [ 'yes', 'no' ], $token )
     } elsif ($target eq 'tex') {            . '&nbsp;' x 3
  my $type=&Apache::lonxml::get_param('TeXtype',$parstack,$safeeval,            . &Apache::edit::select_arg(
     undef,0);              'Display Direction:', 'direction',
  if ($type eq '1') {              [ 'vertical', 'horizontal' ], $token
     $result .= ' \renewcommand{\labelenumi}{\arabic{enumi}.}';            )
  } elsif ($type eq 'A') {            . &Apache::edit::end_row()
     $result .= ' \renewcommand{\labelenumi}{\Alph{enumi}.}';            . &Apache::edit::start_spanning_row() . "\n";
  } elsif ($type eq 'a') {      }
     $result .= ' \renewcommand{\labelenumi}{\alph{enumi}.}';      elsif ( $target eq 'modified' ) {
  } elsif ($type eq 'i') {          my $constructtag =
     $result .= ' \renewcommand{\labelenumi}{\roman{enumi}.}';            &Apache::edit::get_new_args( $token, $parstack, $safeeval, 'max',
  } else {              'randomize', 'direction' );
     $result .= ' \renewcommand{\labelenumi}{\Alph{enumi}.}';          if ($constructtag) { $result = &Apache::edit::rebuild_tag($token); }
  }      }
  $result .= '\begin{enumerate}';      elsif ( $target eq 'tex' ) {
     } elsif ($target eq 'analyze') {          my $type =
  my $part_id="$Apache::inputtags::part.$id";            &Apache::lonxml::get_param( 'TeXtype', $parstack, $safeeval, undef,
  push (@{ $Apache::lonhomework::analyze{"parts"} },$part_id);              0 );
           if ( $type eq '1' ) {
               $result .= ' \renewcommand{\labelenumi}{\arabic{enumi}.}';
           }
           elsif ( $type eq 'A' ) {
               $result .= ' \renewcommand{\labelenumi}{\Alph{enumi}.}';
           }
           elsif ( $type eq 'a' ) {
               $result .= ' \renewcommand{\labelenumi}{\alph{enumi}.}';
           }
           elsif ( $type eq 'i' ) {
               $result .= ' \renewcommand{\labelenumi}{\roman{enumi}.}';
           }
           else {
               $result .= ' \renewcommand{\labelenumi}{\Alph{enumi}.}';
           }
   
       }
       elsif ( $target eq 'analyze' ) {
           my $part_id = "$Apache::inputtags::part.$id";
           $Apache::lonhomework::analyze{"$part_id.type"} = 'radiobuttonresponse';
           push( @{ $Apache::lonhomework::analyze{"parts"} }, $part_id );
     }      }
     return $result;      return $result;
 }  }
   
 sub end_radiobuttonresponse {  sub end_radiobuttonresponse {
     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;      my ( $target, $token, $tagstack, $parstack, $parser, $safeeval, $style ) =
         @_;
     my $result;      my $result;
     if ($target eq 'edit') { $result=&Apache::edit::end_table(); }      if ( $target eq 'edit' ) { $result = &Apache::edit::end_table(); }
     if ($target eq 'tex') { $result .= '\end{enumerate}'; }  
     &Apache::response::end_response;      &Apache::response::end_response;
     pop @Apache::lonxml::namespace;      pop @Apache::lonxml::namespace;
     &Apache::lonxml::deregister('Apache::radiobuttonresponse',('foilgroup','foil','conceptgroup'));      &Apache::lonxml::deregister( 'Apache::radiobuttonresponse',
           ( 'foilgroup', 'foil', 'conceptgroup' ) );
     undef(%Apache::response::foilnames);      undef(%Apache::response::foilnames);
     return $result;      return $result;
 }  }
   
 %Apache::response::foilgroup=();  %Apache::response::foilgroup = ();
   
 sub start_foilgroup {  sub start_foilgroup {
     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;      my ( $target, $token, $tagstack, $parstack, $parser, $safeeval, $style ) =
     my $result;        @_;
     %Apache::response::foilgroup=();      %Apache::response::foilgroup               = ();
     $Apache::radiobuttonresponse::conceptgroup=0;      $Apache::radiobuttonresponse::conceptgroup = 0;
     &Apache::response::pushrandomnumber();      &Apache::response::pushrandomnumber( undef, $target );
     if ($target eq 'tex' && $Apache::lonhomework::type eq 'exam') {      return;
  $result.='\item[\textbf{'.$Apache::lonxml::counter.'}.]';  
     }  
     return $result;  
 }  }
   
 sub storesurvey {  sub storesurvey {
     if ( !defined($ENV{'form.submitted'})) { return ''; }      my ($style) = @_;
     my $response = $ENV{'form.HWVAL_'.$Apache::inputtags::response['-1']};      if ( !&Apache::response::submitted() ) { return ''; }
       my $response = $env{ 'form.HWVAL_' . $Apache::inputtags::response['-1'] };
     &Apache::lonxml::debug("Here I am!:$response:");      &Apache::lonxml::debug("Here I am!:$response:");
     if ( $response !~ /[0-9]+/) { return ''; }      if ( $response !~ /[0-9]+/ ) { return ''; }
     my $part = $Apache::inputtags::part;      my $part       = $Apache::inputtags::part;
     my $id = $Apache::inputtags::response['-1'];      my $id         = $Apache::inputtags::response['-1'];
     my @whichfoils=@{ $Apache::response::foilgroup{'names'} };      my @whichfoils = @{ $Apache::response::foilgroup{'names'} };
     my %responsehash;      my %responsehash;
     $responsehash{$whichfoils[$response]}=$response;      $responsehash{ $whichfoils[$response] } = $response;
     my $responsestr=&Apache::lonnet::hash2str(%responsehash);      my $responsestr = &Apache::lonnet::hash2str(%responsehash);
     $Apache::lonhomework::results{"resource.$part.$id.submission"}=      $Apache::lonhomework::results{"resource.$part.$id.submission"} =
  $responsestr;        $responsestr;
     my %previous=&Apache::response::check_for_previous($responsestr,$part,$id);      my %previous =
     my $ad=$Apache::lonhomework::results{"resource.$part.$id.awarddetail"}='SUBMITTED';        &Apache::response::check_for_previous( $responsestr, $part, $id );
     &Apache::response::handle_previous(\%previous,$ad);      my $ad;
   
       if ( $style eq 'anonsurvey' ) {
           $ad = $Apache::lonhomework::results{"resource.$part.$id.awarddetail"} =
             'ANONYMOUS';
       }
       elsif ( $style eq 'anonsurveycred' ) {
           $ad = $Apache::lonhomework::results{"resource.$part.$id.awarddetail"} =
             'ANONYMOUS_CREDIT';
       }
       elsif ( $style eq 'surveycred' ) {
           $ad = $Apache::lonhomework::results{"resource.$part.$id.awarddetail"} =
             'SUBMITTED_CREDIT';
       }
       else {
           $ad = $Apache::lonhomework::results{"resource.$part.$id.awarddetail"} =
             'SUBMITTED';
       }
       &Apache::response::handle_previous( \%previous, $ad );
     &Apache::lonxml::debug("submitted a $response<br />\n");      &Apache::lonxml::debug("submitted a $response<br />\n");
     return '';      return '';
 }  }
   
 sub grade_response {  sub grade_response {
     my ($max,$randomize)=@_;      my ( $answer, $whichfoils, $bubbles_per_line ) = @_;
     #keep the random numbers the same must always call this  
     my ($answer,@whichfoils)=&whichfoils($max,$randomize);      if ( !&Apache::response::submitted() ) { return; }
     if (!defined($ENV{'form.submitted'})) { return; }  
     my $response;      my $response;
     if ($ENV{'form.submitted'} eq 'scantron') {  
  $response=&Apache::response::getresponse();      if ( $env{'form.submitted'} eq 'scantron' ) {
     } else {          $response =
  $response = $ENV{'form.HWVAL_'.$Apache::inputtags::response['-1']};            &Apache::response::getresponse( 1, undef,
               &bubble_line_count( scalar( @{$whichfoils} ), $bubbles_per_line ),
               $bubbles_per_line );
   
     }      }
     if ( $response !~ /[0-9]+/) { return; }      else {
     my $part=$Apache::inputtags::part;          $response = $env{ 'form.HWVAL_' . $Apache::inputtags::response['-1'] };
     my $id = $Apache::inputtags::response['-1'];      }
   
       if ( $response !~ /[0-9]+/ ) { return; }
       my $part = $Apache::inputtags::part;
       my $id   = $Apache::inputtags::response['-1'];
     my %responsehash;      my %responsehash;
     $responsehash{$whichfoils[$response]}=$response;      $responsehash{ $whichfoils->[$response] } = $response;
     my $responsestr=&Apache::lonnet::hash2str(%responsehash);      my $responsestr = &Apache::lonnet::hash2str(%responsehash);
     my %previous=&Apache::response::check_for_previous($responsestr,      my %previous =
        $part,$id);        &Apache::response::check_for_previous( $responsestr, $part, $id );
     $Apache::lonhomework::results{"resource.$part.$id.submission"}=      $Apache::lonhomework::results{"resource.$part.$id.submission"} =
  $responsestr;        $responsestr;
     &Apache::lonxml::debug("submitted a $response<br />\n");      &Apache::lonxml::debug("submitted a $response<br />\n");
     my $ad;      my $ad;
     if ($response == $answer) {  
  $ad='EXACT_ANS';      if ( $response == $answer ) {
     } else {          $ad = 'EXACT_ANS';
  $ad='INCORRECT';      }
       else {
           $ad = 'INCORRECT';
     }      }
     $Apache::lonhomework::results{"resource.$part.$id.awarddetail"}=$ad;      $Apache::lonhomework::results{"resource.$part.$id.awarddetail"} = $ad;
     &Apache::response::handle_previous(\%previous,$ad);      &Apache::response::handle_previous( \%previous, $ad );
 }  }
   
 sub end_foilgroup {  sub end_foilgroup {
     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;      my ( $target, $token, $tagstack, $parstack, $parser, $safeeval, $style ) =
         @_;
   
     my $result;      my $result;
     if ($target eq 'grade' || $target eq 'web' || $target eq 'answer' ||      my $bubble_lines;
  $target eq 'tex' || $target eq 'analyze') {      my $answer_count;
  my $style = $Apache::lonhomework::type;      my $id               = $Apache::inputtags::response['-1'];
  my $direction = &Apache::lonxml::get_param('direction',$parstack,      my $part             = $Apache::inputtags::part;
    $safeeval,'-2');      my $bubbles_per_line = &getbubblesnum( $part, $id );
  if ( $style eq 'survey'  && $target ne 'analyze') {  
     if ($target eq 'web' || $target eq 'tex') {      if (   $target eq 'grade'
  $result=&displayallfoils($direction);          || $target eq 'web'
     } elsif ( $target eq 'answer' ) {          || $target eq 'answer'
  $result=&displayallanswers();          || $target eq 'tex'
     } elsif ( $target eq 'grade' ) {          || $target eq 'analyze' )
  $result=&storesurvey();      {
     }          my $style = $Apache::lonhomework::type;
  } else {          my $direction =
     my $name;            &Apache::lonxml::get_param( 'direction', $parstack, $safeeval, '-2' );
     my $max = &Apache::lonxml::get_param('max',$parstack,$safeeval,          if (
  '-2');              (
     my $randomize = &Apache::lonxml::get_param('randomize',$parstack,                     ( $style eq 'survey' )
        $safeeval,'-2');                  || ( $style eq 'surveycred' )
     if ($target eq 'web' || $target eq 'tex') {                  || ( $style eq 'anonsurvey' )
  $result=&displayfoils($target,$max,$randomize,$direction);                  || ( $style eq 'anonsurveycred' )
     } elsif ($target eq 'answer' ) {              )
  $result=&displayanswers($max,$randomize);              && ( $target ne 'analyze' )
     } elsif ( $target eq 'grade') {            )
  &grade_response($max,$randomize);          {
     }  elsif ( $target eq 'analyze') {              if ( $target eq 'web' || $target eq 'tex' ) {
  my @shown = &whichfoils($max,$randomize);                  $result = &displayallfoils( $direction, $target );
  &Apache::response::analyze_store_foilgroup(\@shown,              }
    ['text','value','location']);              elsif ( $target eq 'answer' ) {
  my $part_id="$Apache::inputtags::part.$Apache::inputtags::response[-1]";                  $result = &displayallanswers();
  push (@{ $Apache::lonhomework::analyze{"$part_id.options"} },              }
       ('true','false'));              elsif ( $target eq 'grade' ) {
     }                  $result = &storesurvey($style);
  }              }
               $answer_count =
                 scalar( @{ $Apache::response::foilgroup{'names'} } );
   
           }
           else {
   
               my $name;
               my $max =
                 &Apache::lonxml::get_param( 'max', $parstack, $safeeval, '-2' );
               my $randomize =
                 &Apache::lonxml::get_param( 'randomize', $parstack, $safeeval,
                   '-2' );
               my ( $answer, @shown ) = &whichfoils( $max, $randomize );
               $answer_count = scalar(@shown);
   
               if ( $target eq 'web' || $target eq 'tex' ) {
                   $result =
                     &displayfoils( $target, $answer, \@shown, $direction,
                       $bubbles_per_line );
               }
               elsif ( $target eq 'answer' ) {
                   $result =
                     &displayanswers( $answer, \@shown, $bubbles_per_line );
               }
               elsif ( $target eq 'grade' ) {
                   &grade_response( $answer, \@shown, $bubbles_per_line );
               }
               elsif ( $target eq 'analyze' ) {
                   my $bubble_lines =
                     &bubble_line_count( $answer_count, $bubbles_per_line );
                   &Apache::response::analyze_store_foilgroup( \@shown,
                       [ 'text', 'value', 'location' ] );
                   my $part_id = "$part.$id";
                   push(
                       @{ $Apache::lonhomework::analyze{"$part_id.options"} },
                       ( 'true', 'false' )
                   );
   
               }
           }
           $Apache::lonxml::post_evaluate = 0;
       }
       if ( $target eq 'web' ) {
           &Apache::response::setup_prior_tries_hash( \&format_prior_answer,
               [ \%Apache::response::foilgroup ] );
     }      }
     &Apache::response::poprandomnumber();      &Apache::response::poprandomnumber();
     &Apache::lonxml::increment_counter();      $bubble_lines = &bubble_line_count( $answer_count, $bubbles_per_line );
       &Apache::lonxml::increment_counter( $bubble_lines, "$part.$id" );
       if ( $target eq 'analyze' ) {
           &Apache::lonhomework::set_bubble_lines();
       }
     return $result;      return $result;
 }  }
   
   sub getbubblesnum {
       my ( $part, $id ) = @_;
       my $bubbles_per_line;
       my $default_numbubbles = $default_bubbles_per_line;
       if (   ( $env{'form.bubbles_per_row'} =~ /^\d+$/ )
           && ( $env{'form.bubbles_per_row'} > 0 ) )
       {
           $default_numbubbles = $env{'form.bubbles_per_row'};
       }
       $bubbles_per_line = &Apache::response::get_response_param( $part . "_$id",
           'numbubbles', $default_numbubbles );
       return $bubbles_per_line;
   }
   
 sub getfoilcounts {  sub getfoilcounts {
     my @names;      my @names;
     my $truecnt=0;      my $truecnt  = 0;
     my $falsecnt=0;      my $falsecnt = 0;
     my $name;      my $name;
     if ( $Apache::response::foilgroup{'names'} ) {      if ( $Apache::response::foilgroup{'names'} ) {
  @names= @{ $Apache::response::foilgroup{'names'} };          @names = @{ $Apache::response::foilgroup{'names'} };
     }      }
     foreach $name (@names) {      foreach $name (@names) {
  if ($Apache::response::foilgroup{$name.'.value'} eq 'true') {          if ( $Apache::response::foilgroup{ $name . '.value' } eq 'true' ) {
     $truecnt++;              $truecnt++;
  } elsif ($Apache::response::foilgroup{$name.'.value'} eq 'false') {          }
     $falsecnt++;          elsif ( $Apache::response::foilgroup{ $name . '.value' } eq 'false' ) {
               $falsecnt++;
           }
       }
       return ( $truecnt, $falsecnt );
   }
   
   sub format_prior_answer {
       my ( $mode, $answer, $other_data ) = @_;
       my $foil_data = $other_data->[0];
       my %response  = &Apache::lonnet::str2hash($answer);
       my ($name)    = keys(%response);
       return
           '<span class="LC_prior_radiobutton">'
         . $foil_data->{ $name . '.text' }
         . '</span>';
   
   }
   
   ## 
   # Return the last survey response.  The logic is slightly different than that of 
   # get_last_responses.  TODO: See if there are chunks of code betweenthis and
   # get_last_reponses that are common and can be factored.
   #
   # @param $part - Problem part under consideration.
   # @param $showanswer - True if answers should be shown.
   # @param $id         - Problem id.
   #
   # @return hash reference.
   # @retval reference to the has indexed by answer selection that 
   #         indicates the most recent answer.
   #
   sub get_last_survey_response {
       my ($part, $showanswer, $id) = @_;
   
       my $newvariation;
       my $lastresponse; # stringified last response.
   
       if (
           (
               (
                   $Apache::lonhomework::history{"resource.$part.type"} eq
                   'randomizetry'
               )
               || ( $Apache::lonhomework::type eq 'randomizetry' )
           )
           && ( $Apache::inputtags::status[-1] eq 'CAN_ANSWER' )
         )
       {
           if ( $env{ 'form.' . $part . '.rndseed' } ne
               $Apache::lonhomework::history{"resource.$part.rndseed"} )
           {
               $newvariation = 1;
           }
       }
       unless (
           (
               (
                   $Apache::lonhomework::history{"resource.$part.type"} eq
                   'anonsurvey'
               )
               || ( $Apache::lonhomework::history{"resource.$part.type"} eq
                   'anonsurveycred' )
           )
           && ( defined( $env{'form.grade_symb'} ) )
           || ( $newvariation && !$showanswer )
         )
       {
           $lastresponse =
             $Apache::lonhomework::history{"resource.$part.$id.submission"};
       }
       my %lastresponse = &Apache::lonnet::str2hash($lastresponse);
      
   
       return \%lastresponse;
   
   }
   ##
   # Removes the names from a foil group that are marked as unused.
   #
   # @param $names - reference to the array of names to filter.
   #
   # @return arrayref
   # @retval reference to the filtered array.
   #
   sub remove_unused {
       my ($names) = @_;
       my @result;
   
       foreach my $name (@{$names}) {
    if ($Apache::response::foilgroup{$name . '.value'} ne 'unused') {
       push(@result, $name);
    }
       }
       return \@result;
   }
   ## 
   # Displays all foils in a survey type problem for HTML rendition.
   # TODO: See if there is any logic in this sub that can be shared
   #      with display_foils_html
   #
   # @param $names        - ref to array of names of the foils to display.
   # @param $part         - Problem part number.
   # @param $showanswer   - If true, show the answers.
   # @param $lastresponse - Ref to the last response hash.
   # @param $direction    - Display direction of the radiobuttons.
   #
   # @return string
   # @retval HTML required to display the resource in a browser.
   #
   sub display_survey_html {
       my ($names, $part, $showanswer, $lastresponse, $direction) = @_;
       my $result;
   
       # Figure out a few fragments of html that depend onthe 
       # orientation of the radiobuttons:
       # closing_html - HTML to emit at the end of the resource.
       # pre_foil     - HTML to emit prior to each foil.
       # post_foil    - HTML to emit following each foil.
       #
       #  The opening HTML is just added to the $result now
       #
       #  Figuring these outin advance compresses the loop over foils into something
       #  pretty simple:
       #
       # NOTE: There's probably a really cool way to do this with style sheets
       #       and picking the selector based on the orientation, if someone wants to puzzle
       #       that out.  In that case, probably the whole thing lives in a <div> and each
       #       foil lives in a <p>
       #
   
       my $closing_html;
       my $pre_foil;
       my $post_foil;
   
       if ($direction eq 'horizontal') {
    $result       .= '<table><tr>';
    $closing_html = '</tr></table>';
    $pre_foil     = '<td>';
    $post_foil    = '</td>';
       } else {
    $pre_foil     = '<br />';
       }
       # Different rendering depending on whether answers are shown:
   
   
       if ($showanswer) {
    foreach my $name (@{$names}) {
   
       $result .= $pre_foil;
       my $foiltext =  $Apache::response::foilgroup{$name . '.text'};
   
       # Bold the prior  response:
   
       if (defined($lastresponse->{$name})) {
    $result .= '<b>' . $foiltext . '</b>';
       } else {
    $result .= $foiltext;
       }
   
       $result .= $post_foil;
    }
       } else {
    my $temp = 0;
    foreach my $name (@{$names}) {
       $result .=  $pre_foil;
   
       $result .= &html_radiobutton(
    $part, $Apache::inputtags::response['-1'], $name, $lastresponse, $temp
        );
   
       $result .= $post_foil;
       $temp++;
          
  }   }
     }      }
     return ($truecnt,$falsecnt);  
       $result .= $closing_html;
       return $result;
   
 }  }
   
 sub displayallfoils {  
     my ($direction)=@_;  ##
   #
   #  Displays all the foils of a problem in a format suitable for
   #   surveys, surveys for credit, anonymous surveys and anonymous surveys for credit.
   #
   #  @param $direction - Display direction of the choices ('horiztonal' or not).
   #  @param $target    - Rendering target.
   #
   #  @return string
   #  @retval Text that renders for the selected target.
   # 
   sub displayallfoils{
       my ( $direction, $target ) = @_;
     my $result;      my $result;
     &Apache::lonxml::debug("survey style display");      &Apache::lonxml::debug("survey style display");
     my @names = @{ $Apache::response::foilgroup{'names'} };      my @names;
     my $temp=0;      if ( $Apache::response::foilgroup{'names'} ) {
     my $id=$Apache::inputtags::response['-1'];          @names = @{ $Apache::response::foilgroup{'names'} };
     my $part=$Apache::inputtags::part;      }
     my $lastresponse=  
  $Apache::lonhomework::history{"resource.$part.$id.submission"};      # Figure out how to bracket the list of foils for
     if ($direction eq 'horizontal') { $result.='<table><tr>'; }      # the TeX target:
     my %lastresponse=&Apache::lonnet::str2hash($lastresponse);      #
     if (&Apache::response::show_answer() ) {  
  foreach my $name (@names) {      my $begin_environment;
     if ($Apache::response::foilgroup{$name.'.value'} ne 'unused') {      my $end_environment;
  if ($direction eq 'horizontal') {      
     $result.="<td>";      if ($target eq 'tex') {
  } else {  
     $result.="<br />";   # Decide how to bracket the list of foils:
  }  
  if (defined($lastresponse{$name})) {  
     $result.='<b>';          if (   $env{'form.pdfFormFields'} eq 'yes'
  }              && $Apache::inputtags::status[-1] eq 'CAN_ANSWER' )
  $result .= $Apache::response::foilgroup{$name.'.text'};          {
  if (defined($lastresponse{$name})) {              $begin_environment = '\begin{itemize}';
     $result.='</b>';      $end_environment   = '\end{itemize}';
           }
           else {
               $begin_environment = '\begin{enumerate}';
       $end_environment   = '\end{enumerate}';
           }
    $result .= $begin_environment;
       }
   
       my $temp = 0;
       my $i    = 0;
       my $id   = $Apache::inputtags::response['-1'];
       my $part = $Apache::inputtags::part;
       my $showanswer;
       my $lastresponse;
       $showanswer = &Apache::response::show_answer();
   
       my $lastresponse = &get_last_survey_response($part, $showanswer, $id);
   
       my $used_names = &remove_unused(\@names);
   
   
       if ($target ne 'tex') {
    $result .= &display_survey_html($used_names, $part, $showanswer, $lastresponse, $direction);
       } else {
   
    if ($showanswer) {
       foreach my $name (@{$used_names}) {
    if ( $Apache::response::foilgroup{ $name . '.value' } ne 'unused' )
    {
       
       $result .= '\item \vskip -2mm ';
       
       if ( defined( $lastresponse->{$name} ) ) {
    $result .= '}';
       }
       $result .= $Apache::response::foilgroup{ $name . '.text' };
  }   }
  if ($direction eq 'horizontal') { $result.="</td>"; }  
     }      }
  }   } else {
     } else {      foreach my $name (@{$used_names}) {
  foreach my $name (@names) {   if ( $Apache::response::foilgroup{ $name . '.value' } ne 'unused' )
     if ($Apache::response::foilgroup{$name.'.value'} ne 'unused') {   {
  if ($direction eq 'horizontal') {      if (   $env{'form.pdfFormFields'} eq 'yes'
     $result.="<td>";     && $Apache::inputtags::status[-1] eq 'CAN_ANSWER' )
  } else {      {
     $result.="<br />";   my $fieldname =
       $env{'request.symb'} 
    . '&part_'
       . $Apache::inputtags::part
       . '&radiobuttonresponse'
       . '&HWVAL_'
       . $Apache::inputtags::response['-1'];
    $result .= '\item[{'
       . &Apache::lonxml::print_pdf_radiobutton(
       $fieldname, $temp )
       . '}]'
       . $Apache::response::foilgroup{ $name . '.text' }
    . "\n";
       }
       else {
    $result .= '\item \vskip -2mm ';
       }
       
       if (   $env{'form.pdfFormFields'} ne 'yes'
      or $Apache::inputtags::status[-1] ne 'CAN_ANSWER' )
       {
    $result .=
       '$\bigcirc$'
       . $Apache::response::foilgroup{ $name . '.text' }
    . '\\\\';    #' stupid emacs
       }
       $i++;
   
       $temp++;
       
       $result .= '\vskip 0 mm ';
  }   }
                 $result .= '<label>';  
  $result.="<input type=\"radio\" name=\"HWVAL_$Apache::inputtags::response['-1']\" value=\"$temp\" ";  
  if (defined($lastresponse{$name})) { $result .= 'checked="on"'; }  
  $result .= '>'.$Apache::response::foilgroup{$name.'.text'}.  
                     '</label>';  
  $temp++;  
  if ($direction eq 'horizontal') { $result.="</td>"; }  
     }      }
  }   }
     }      }
     if ($direction eq 'horizontal') { $result.='</tr></table>'; }  
   
       # Close tex bracketing:
   
       if ($target eq 'tex') {
    $result .= $end_environment;
       }
     return $result;      return $result;
 }  }
   
   
   
 sub whichfoils {  sub whichfoils {
     my ($max,$randomize)=@_;      my ( $max, $randomize ) = @_;
   
     my @truelist;      my @truelist;
     my @falselist;      my @falselist;
     my @whichfalse =();      my @whichfalse = ();
     my ($truecnt,$falsecnt) = &getfoilcounts();      my ( $truecnt, $falsecnt ) = &getfoilcounts();
     my $count=0;      my $count = 0;
   
     # we will add in 1 of the true statements      # we will add in 1 of the true statements
     if (($falsecnt+1)>$max) { $count=$max } else { $count=$falsecnt+1; }      if ( $max > 0 && ( $falsecnt + 1 ) > $max ) { $count = $max }
     my $answer=int(&Math::Random::random_uniform() * ($count));      else { $count = $falsecnt + 1; $max = $count; }
       my $answer = int( &Math::Random::random_uniform() * ($count) );
     &Apache::lonxml::debug("Count is $count, $answer is $answer");      &Apache::lonxml::debug("Count is $count, $answer is $answer");
     my @names;      my @names;
     if ( $Apache::response::foilgroup{'names'} ) {      if ( $Apache::response::foilgroup{'names'} ) {
  @names= @{ $Apache::response::foilgroup{'names'} };          @names = @{ $Apache::response::foilgroup{'names'} };
     }      }
     if (&Apache::response::showallfoils()) {      if ( &Apache::response::showallfoils() ) {
  @whichfalse=@names;          @whichfalse = @names;
     } elsif ($randomize eq 'no') {      }
  &Apache::lonxml::debug("No randomization");      elsif ( $randomize eq 'no' ) {
  my $havetrue=0;          &Apache::lonxml::debug("No randomization");
  foreach my $name (@names) {          my $havetrue = 0;
     if ($Apache::response::foilgroup{$name.'.value'} eq 'true') {          foreach my $name (@names) {
  if (!$havetrue ) {              if ( $Apache::response::foilgroup{ $name . '.value' } eq 'true' ) {
     push(@whichfalse,$name); $havetrue++; $answer=$#whichfalse;                  if ( !$havetrue ) {
  }                      push( @whichfalse, $name );
     } elsif ($Apache::response::foilgroup{$name.'.value'} eq 'false') {                      $havetrue++;
  push (@whichfalse,$name);                      $answer = $#whichfalse;
     } elsif ($Apache::response::foilgroup{$name.'.value'} eq 'unused') {                  }
     } else {              }
  &Apache::lonxml::error(&HTML::Entities::encode("No valid value assigned ($Apache::response::foilgroup{$name.'.value'}) for foil $name in <foilgroup>",'<>&"'));              elsif (
     }                  $Apache::response::foilgroup{ $name . '.value' } eq 'false' )
  }              {
  if (!$havetrue && $Apache::lonhomework::type ne 'survey') {                  push( @whichfalse, $name );
     &Apache::lonxml::error("There are no true statements available.<br />");              }
  }              elsif (
     } else {                  $Apache::response::foilgroup{ $name . '.value' } eq 'unused' )
  my $current=0;              {
  &Apache::lonhomework::showhash(%Apache::response::foilgroup);              }
  my (%top,%bottom);              else {
  #first find out where everyone wants to be                  &Apache::lonxml::error(
  foreach my $name (@names) {                      &HTML::Entities::encode(
     $current++;  "No valid value assigned ($Apache::response::foilgroup{$name.'.value'}) for foil $name in <foilgroup>",
     if ($Apache::response::foilgroup{$name.'.value'} eq 'true') {                          '<>&"'
  push (@truelist,$name);                      )
  if ($Apache::response::foilgroup{$name.'.location'} eq 'top') {                  );
     $top{$name}=$current;              }
  } elsif ($Apache::response::foilgroup{$name.'.location'} eq 'bottom') {          }
     $bottom{$name}=$current;          if (   ( !$havetrue )
  }              && ( $Apache::lonhomework::type ne 'survey' )
     } elsif ($Apache::response::foilgroup{$name.'.value'} eq 'false') {              && ( $Apache::lonhomework::type ne 'surveycred' )
  push (@falselist,$name);              && ( $Apache::lonhomework::type ne 'anonsurvey' )
  if ($Apache::response::foilgroup{$name.'.location'} eq 'top') {              && ( $Apache::lonhomework::type ne 'anonsurveycred' ) )
     $top{$name}=$current;          {
  } elsif ($Apache::response::foilgroup{$name.'.location'} eq 'bottom') {              &Apache::lonxml::error(
     $bottom{$name}=$current;                  &mt('There are no true statements available.') . '<br />' );
  }          }
     } elsif ($Apache::response::foilgroup{$name.'.value'} eq 'unused') {      }
     } else {      else {
  &Apache::lonxml::error(&HTML::Entities::encode("No valid value assigned ($Apache::response::foilgroup{$name.'.value'}) for foil $name in <foilgroup>",'<>&"'));          my $current = 0;
     }          &Apache::lonhomework::showhash(%Apache::response::foilgroup);
           my ( %top, %bottom );
   
           #first find out where everyone wants to be
           foreach my $name (@names) {
               $current++;
               if ( $Apache::response::foilgroup{ $name . '.value' } eq 'true' ) {
                   push( @truelist, $name );
                   if ( $Apache::response::foilgroup{ $name . '.location' } eq
                       'top' )
                   {
                       $top{$name} = $current;
                   }
                   elsif ( $Apache::response::foilgroup{ $name . '.location' } eq
                       'bottom' )
                   {
                       $bottom{$name} = $current;
                   }
               }
               elsif (
                   $Apache::response::foilgroup{ $name . '.value' } eq 'false' )
               {
                   push( @falselist, $name );
                   if ( $Apache::response::foilgroup{ $name . '.location' } eq
                       'top' )
                   {
                       $top{$name} = $current;
                   }
                   elsif ( $Apache::response::foilgroup{ $name . '.location' } eq
                       'bottom' )
                   {
                       $bottom{$name} = $current;
                   }
               }
               elsif (
                   $Apache::response::foilgroup{ $name . '.value' } eq 'unused' )
               {
               }
               else {
                   &Apache::lonxml::error(
                       &HTML::Entities::encode(
   "No valid value assigned ($Apache::response::foilgroup{$name.'.value'}) for foil $name in <foilgroup>",
                           '<>&"'
                       )
                   );
               }
           }
   
           #pick a true statement
           my $notrue = 0;
           if ( scalar(@truelist) == 0 ) { $notrue = 1; }
           my $whichtrue =
             int( &Math::Random::random_uniform() * ( $#truelist + 1 ) );
           &Apache::lonxml::debug(
               "Max is $max, From $#truelist elms, picking $whichtrue");
           my ( @toplist, @bottomlist );
           my $topcount    = 0;
           my $bottomcount = 0;
   
           # assign everyone to either toplist/bottomlist or whichfalse
           # which false is randomized, toplist bottomlist are in order
           while (( ( $#whichfalse + $topcount + $bottomcount ) < $max - 2 )
               && ( $#falselist > -1 ) )
           {
               &Apache::lonxml::debug("Have $#whichfalse max is $max");
               my $afalse =
                 int( &Math::Random::random_uniform() * ( $#falselist + 1 ) );
               &Apache::lonxml::debug("From $#falselist elms, picking $afalse");
               $afalse = splice( @falselist, $afalse, 1 );
               &Apache::lonxml::debug("Picked $afalse");
               &Apache::lonhomework::showhash( ( 'names' => \@names ) );
               &Apache::lonhomework::showhash(%top);
               if ( $top{$afalse} ) {
                   $toplist[ $top{$afalse} ] = $afalse;
                   $topcount++;
               }
               elsif ( $bottom{$afalse} ) {
                   $bottomlist[ $bottom{$afalse} ] = $afalse;
                   $bottomcount++;
               }
               else {
                   push( @whichfalse, $afalse );
               }
           }
           &Apache::lonxml::debug("Answer wants $answer");
           my $truename = $truelist[$whichtrue];
           my $dosplice = 1;
           if (   ($notrue)
               && ( $Apache::lonhomework::type ne 'survey' )
               && ( $Apache::lonhomework::type ne 'surveycred' )
               && ( $Apache::lonhomework::type ne 'anonsurvey' )
               && ( $Apache::lonhomework::type ne 'anonsurveycred' ) )
           {
               $dosplice = 0;
               &Apache::lonxml::error(
                   &mt('There are no true statements available.') . '<br />' );
           }
   
           #insert the true statement, keeping track of where it wants to be
           if (   $Apache::response::foilgroup{ $truename . '.location' } eq 'top'
               && $dosplice )
           {
               $toplist[ $top{$truename} ] = $truename;
               $answer = -1;
               foreach my $top ( reverse(@toplist) ) {
                   if ($top) { $answer++; }
                   if ( $top eq $truename ) { last; }
               }
               $dosplice = 0;
           }
           elsif (
               $Apache::response::foilgroup{ $truename . '.location' } eq 'bottom'
               && $dosplice )
           {
               $bottomlist[ $bottom{$truename} ] = $truename;
               $answer = -1;
               foreach my $bot (@bottomlist) {
                   if ($bot) { $answer++; }
                   if ( $bot eq $truename ) { last; }
               }
               $answer += $topcount + $#whichfalse + 1;
               $dosplice = 0;
           }
           else {
               if ( $topcount > 0 || $bottomcount > 0 ) {
                   my $inc = 1;
                   if (   ( $bottomcount > 0 )
                       && ( $Apache::lonhomework::type ne 'exam' ) )
                   {
                       $inc = 2;
                   }
                   $answer = int(
                       &Math::Random::random_uniform() * ( $#whichfalse + $inc ) )
                     + $topcount;
               }
           }
           &Apache::lonxml::debug("Answer now wants $answer");
   
           #add the top items to the top, bottom items to the bottom
           for ( my $i = 0 ; $i <= $#toplist ; $i++ ) {
               if ( $toplist[$i] ) { unshift( @whichfalse, $toplist[$i] ) }
           }
           for ( my $i = 0 ; $i <= $#bottomlist ; $i++ ) {
               if ( $bottomlist[$i] ) { push( @whichfalse, $bottomlist[$i] ) }
           }
   
           #if the true statement is randomized insert it into the list
           if ($dosplice) {
               splice( @whichfalse, $answer, 0, $truelist[$whichtrue] );
           }
       }
       &Apache::lonxml::debug("Answer is $answer");
       return ( $answer, @whichfalse );
   }
   
   ## 
   #  Return a list  of foil texts given foil names.
   #  
   # @param $whichfoils - Reference to a list of foil names.
   #
   # @return array
   # @retval foil texts
   #
   sub get_foil_texts {
       my ($whichfoils) = @_;
       my @foil_texts;
   
       foreach my $name (@{$whichfoils}) {
    push(@foil_texts, $Apache::response::foilgroup{$name . '.text'});
       }
       return @foil_texts;
   }
   
   ##
   # Generate the HTML for a single html foil.
   # @param $part           - The part for which the response is being generated.
   # @param $fieldname      - The basename of the radiobutton field
   # @param $name           - The foilname.
   # @param $last_responses - Reference to a hash that holds the most recent
   #                          responses.
   # @param $value          - radiobutton value.
   # 
   # @return text
   # @retval The generated html.
   #
   sub html_radiobutton {
       my ($part, $fieldname, $name, $last_responses, $value) = @_;
   
       my $result='<label>';
       
       $result .= '<input type="radio"
                   onchange="javascript:setSubmittedPart(' . "'$part');\""
    . 'name="HWVAL_' . $fieldname . '"'
    . "value='$value'";
   
       if (defined($last_responses->{$name})) {
    $result .= '  checked="checked" ';
       }
       $result .= ' />';
       $result .= $Apache::response::foilgroup{$name . '.text'};
       $result .= '</label>';
   
       return $result;
   
   }
   ##
   # Return a reference to the last response hash. This hash has exactly
   # one or zero entries.  The one entry is keyed by the foil 'name' of
   # the prior response
   #
   # @param $part - Number of the problem part.
   # 
   # @return reference to a hash.
   # @retval see above.
   #
   sub get_last_response {
       my ($part) = @_;
   
       my $id = $Apache::inputtags::response['-1'];
       my ( $lastresponse, $newvariation );
       
       if ((( $Apache::lonhomework::history{"resource.$part.type"} eq  'randomizetry')
    || ( $Apache::lonhomework::type eq 'randomizetry' )
    )
    && ( $Apache::inputtags::status[-1] eq 'CAN_ANSWER' )
    )
       {
   
    if ( $env{ 'form.' . $part . '.rndseed' } ne
        $Apache::lonhomework::history{"resource.$part.rndseed"} )
    {
       $newvariation = 1;
  }   }
  #pick a true statement      }
  my $notrue=0;      unless ($newvariation) {
  if (scalar(@truelist) == 0) { $notrue=1; }   $lastresponse =
  my $whichtrue = int(&Math::Random::random_uniform() * ($#truelist+1));      $Apache::lonhomework::history{"resource.$part.$id.submission"};
  &Apache::lonxml::debug("Max is $max, From $#truelist elms, picking $whichtrue");      }
  my (@toplist, @bottomlist);      my %lastresponse = &Apache::lonnet::str2hash($lastresponse);
  my $topcount=0;  
  my $bottomcount=0;      return \%lastresponse;
  # assign everyone to either toplist/bottomlist or whichfalse  }
  # which false is randomized, toplist bottomlist are in order  
  while ((($#whichfalse+$topcount+$bottomcount) < $max-2) && ($#falselist > -1)) {  ##
     &Apache::lonxml::debug("Have $#whichfalse max is $max");  # Display foils in html rendition.:
     my $afalse=int(&Math::Random::random_uniform() * ($#falselist+1));  #
     &Apache::lonxml::debug("From $#falselist elms, picking $afalse");  # @param $whichfoils - Set of foils to display.
     $afalse=splice(@falselist,$afalse,1);  # @param $target     - Rendition target...there are several html targets.
     &Apache::lonxml::debug("Picked $afalse");  # @param $direction  - 'horizontal' if layout is horizontal.
     &Apache::lonhomework::showhash(('names'=>\@names));  # @param $part       - Part of the problem that's being displayed.
     &Apache::lonhomework::showhash(%top);  # @param $show_answer- True if answers should be shown.
     if ($top{$afalse}) {  #
  $toplist[$top{$afalse}]=$afalse;  # @return string
  $topcount++;  # @retval generated html.
     } elsif ($bottom{$afalse}) {  #
  $bottomlist[$bottom{$afalse}]=$afalse;  sub display_foils_html {
  $bottomcount++;      my ($whichfoils, $target, $direction, $part, $show_answer) = @_;
       my $result;
   
       # if the answers get shown, we need to label each item as correct or
       # incorrect.
   
       if ($show_answer) {
    my $item_pretext     = '<br />'; # html prior to each item
    my $item_posttext    = ''; # html after each item.
    my $finalclose       = ''; # html to close off the whole shebang
   
   
    # Horizontal layout is a table with each foil in a cell
   
    if ($direction eq 'horizontal') {
       $result        = '<table><tr>';
       $item_pretext  = '<td>' . $item_pretext;
       $item_posttext = '</td>';
       $finalclose    = '</tr></table>';
    } 
   
    foreach my $name (@{$whichfoils}) {
   
       # If the item gets further surrounded by tags, this 
       # holds the closures for those tages.
   
       my $item_closetag = '';
   
       $result .= $item_pretext;
   
       # Label each foil as correct or incorrect:
   
       if ($Apache::response::foilgroup{$name . '.value'} eq 'true') {
    $result .= &mt('Correct:') . '<b>';
    $item_closetag .= '</b>';
   
     } else {      } else {
  push (@whichfalse,$afalse);   $result .= &mt('Incorrect');
     }  
  }  
  &Apache::lonxml::debug("Answer wants $answer");  
  my $truename=$truelist[$whichtrue];  
  my $dosplice=1;  
  if ($notrue && $Apache::lonhomework::type ne 'survey') {  
     $dosplice=0;  
     &Apache::lonxml::error("There are no true statements available.<br />");  
  }  
  #insert the true statement, keeping track of where it wants to be  
  if ($Apache::response::foilgroup{$truename.'.location'} eq 'top' && $dosplice) {  
     $toplist[$top{$truename}]=$truename;  
     $answer=-1;  
     foreach my $top (reverse(@toplist)) {  
  if ($top) { $answer++;}  
  if ($top eq $truename) { last; }  
     }      }
     $dosplice=0;  
  } elsif ($Apache::response::foilgroup{$truename.'.location'} eq 'bottom' && $dosplice) {      # Web rendition encloses the 
     $bottomlist[$bottom{$truename}]=$truename;      # item text in a label tag as well:
     $answer=-1;  
     foreach my $bot (@bottomlist) {      if ($target eq 'web') {
  if ($bot) { $answer++;}   $result .= '<label>';
  if ($bot eq $truename) { last; }   $item_closetag = '</label>' . $item_closetag;
     }  
     $answer+=$topcount+$#whichfalse+1;  
     $dosplice=0;  
  } else {  
     if ($topcount>0 || $bottomcount>0) {  
  $answer = int(&Math::Random::random_uniform() * ($#whichfalse+1))  
     + $topcount;  
     }      }
       $result .= $Apache::response::foilgroup{$name . '.text'};
       $result .= $item_closetag;
       $result .= $item_posttext;
       $result .= "\n"; # make the html a bit more readable.
  }   }
  &Apache::lonxml::debug("Answer now wants $answer");  
  #add the top items to the top, bottom items to the bottom   $result .= $finalclose;
  for (my $i=0;$i<=$#toplist;$i++) {  
     if ($toplist[$i]) { unshift(@whichfalse,$toplist[$i]) }      } else {
    $result .= '<br />'; # end line prior to foilgroup:
   
    #  Not showing the answers, we need to generate the HTML appropriate
    #  to allowing the student to respond.
   
    my $item_pretext;
    my $item_posttext;
    my $lastresponse = &get_last_response($part);
   
    if ( $direction eq 'horizontal' ) {
       $item_pretext  = '<td>';
       $item_posttext = '</td>';
    }
    else {
       $item_pretext = '<br/>';
    }
    my $item_no = 0;
    foreach my $name (@{$whichfoils}) {
       $result .= $item_pretext;
       $result .= &html_radiobutton(
    $part, $Apache::inputtags::response[-1],
    $name, $lastresponse, $item_no
    );
       $result .= $item_posttext;
       $item_no++;
    }
   
    if ($direction eq 'horizontal' ) {
               $result .= "</tr></table>";
           } else {
        $result .= "<br />"; 
    }
       }
   
       return $result;
   }
   ##
   #  Display foils in exam mode for latex
   #
   # @param $whichfoils       - Reference to an array that contains the foil names to display
   # @param $bubbles_per_line - Number of bubbles on a line.
   # @param $direction        - Rendering direction 'horizontal' is what we're looking for.
   # @param $vbegin           - Start latex fragment in vertical rendering.
   # @param $vend             - End latex fragmentin vertical rendering.
   #
   # @return string
   # @return the latex rendering of the exam problem.
   #
   #
   sub display_latex_exam {
       my ($whichfoils, $bubbles_per_line, $direction, $vbegin, $vend) = @_;
       my $result;
       my $numlines;
       my $bubble_number = 0;
       my $line          = 0;
       my $i             = 0;
   
   
       if ($direction eq  'horizontal') {
   
    # Marshall the display text for each foil and turn things over to
    # Apache::response::make_horizontal_bubbles:
   
    my @foil_texts = &get_foil_texts($whichfoils);
    $result .= &Apache::caparesponse::make_horizontal_latex_bubbles(
       $whichfoils, \@foil_texts, '$\bigcirc$');
   
   
       } else {
    $result .= $vbegin;
   
    # This section puts out the prefix that tells the user
    # (if necessary) to only choose one bubble in the next n lines
    # for problems with more than one line worth of bubbles in the grid sheet:
   
    my $numitems = scalar( @{$whichfoils} );
    $numlines = int( $numitems / $bubbles_per_line );
    if ( ( $numitems % $bubbles_per_line ) != 0 ) {
       $numlines++;
    }
    if ( $numlines < 1 ) {
       $numlines = 1;
    }
    if ( $numlines > 1 ) {
       my $linetext;
       for ( my $i = 0 ; $i < $numlines ; $i++ ) {
    $linetext .= $Apache::lonxml::counter + $i . ', ';
       }
       $linetext =~ s/,\s$//;
       $result .=
    '\item[\small {\textbf{'
    . $linetext . '}}]'
    . ' {\footnotesize '
    . &mt( '(Bubble once in [_1] lines)', $numlines )
    . '} \hspace*{\fill} \\\\';
    }
    else {
       $result .= '\item[\textbf{' . $Apache::lonxml::counter . '}.]';
    }
   
    # Now output the bubbles themselves:
   
    foreach my $name (@{$whichfoils}) {
       if ( $bubble_number >= $bubbles_per_line ) {
    $line++;
    $i             = 0;
    $bubble_number = 0;
       }
       my $identifier;
       if ( $numlines > 1 ) {
    $identifier = $Apache::lonxml::counter + $line;
       }
       $result .=
    '{\small \textbf{'
    . $identifier
    . $alphabet[$i]
    . '}}$\bigcirc$'
    . $Apache::response::foilgroup{ $name . '.text' }
       . '\\\\';    #' stupid emacs -- it thinks it needs that apostrophe to close the quote
       
       $i++;
       $bubble_number++;
  }   }
  for (my $i=0;$i<=$#bottomlist;$i++) {   $result .= $vend
     if ($bottomlist[$i]) { push(@whichfalse,$bottomlist[$i]) }  
       }
   
       return $result;
       
   }
   
   ##
   #  Display latex when exam mode is not on.
   #
   #  @param $whichfoils - The foils to display
   #  @param $direction  - Display direction ('horizontal' is what matters to us).
   #  @param $vbegin     - Begin the vertical environment being used.
   #  @param  $vend      - End the vertical environment being used.
   #
   #  @return string
   #  @retval - The LaTeX rendering of the resource.'
   #
   sub display_latex {
       my ($whichfoils, $direction, $vbegin, $vend) = @_;
       my $result;
   
       # how we render depends on the direction.
       # Vertical is some kind of list environment determined by vbegin/vend.
       # Horizontal is a table that is generated by 
       # Apache::caparesponse::make_horizontal_latex_bubbles with an empty string
       # for the actual bubble text.
   
       if ($direction eq 'horizontal') {
    my @foil_texts = &get_foil_texts($whichfoils);
    $result .= &Apache::caparesponse::make_horizontal_latex_bubbles(
       $whichfoils, \@foil_texts, '');
       } else {
    $result .= $vbegin;
    foreach my $name (@{$whichfoils}) {
       $result .=  '\vspace*{-2 mm}\item '
    . $Apache::response::foilgroup{ $name . '.text' };
  }   }
  #if the true statement is randomized insert it into the list  
  if ($dosplice) { splice(@whichfalse,$answer,0,$truelist[$whichtrue]); }   $result .= $vend;
     }      }
     &Apache::lonxml::debug("Answer is $answer");      return $result;
     return ($answer,@whichfalse);  
 }  }
   
   
   ##
   #  Render foils for a PDF form. This is a variant of tex rednering that provides
   #  sufficient markup that the final PDF is a form that can be filled in online,
   #  or offline.
   #
   # @param $whichfoils - References an array of foils to display in the order in which
   #                     they should be displayed.
   # @param $direction  - Rendering direction.  'horiztonal' means inputs are laid out
   #                      horizontally otherwise they are stacked vertically.
   #
   # @return string
   # @retval String containing the rendering of the resource.
   #
   sub display_pdf_form {
       my ($whichfoils) = @_;
       my $temp = 0;
       my $result;
   
       foreach my $name ( @{$whichfoils} ) {
   
    my $fieldname =
       $env{'request.symb'} 
    . '&part_'
       . $Apache::inputtags::part
       . '&radiobuttonresponse'
       . '&HWVAL_'
       . $Apache::inputtags::response['-1'];
    $result .= '\item[{'
       . &Apache::lonxml::print_pdf_radiobutton( $fieldname,
         $temp )
       . '}]'
       . $Apache::response::foilgroup{ $name . '.text' }
    . "\n";
   
    $temp++;
       }
   
       return $result;
   }
   
   
   ##
   # Display selected foils:  This is really just a dispatchter to appropriate renderers
   #  
   # @param $target   - Target (e.g. 'tex'...).
   # @param $answer   - True if answers should be shown.
   # @param $whichfoils - Array of foil selectors that indicate which foils shouild be
   #                      rendered, in rendering order.
   # @param $direction- Rendering direction ('horizontal' is the one we look for,
   #                    otherwise foils are rendered one per line vertically.
   # @param $bubbles_per_line - number of exam bubbles per line.
   #
   # @return string
   # @retval The rendered problem.
   
 sub displayfoils {  sub displayfoils {
     my ($target,$max,$randomize,$direction)=@_;      my ( $target, $answer, $whichfoils, $direction, $bubbles_per_line ) = @_;
     my $result;      my $result;
   
     my ($answer,@whichfoils)=&whichfoils($max,$randomize);      my $part   = $Apache::inputtags::part;
     my $part=$Apache::inputtags::part;      my $solved = $Apache::lonhomework::history{"resource.$part.solved"};
     my $solved=$Apache::lonhomework::history{"resource.$part.solved"};  
     if ( ($target ne 'tex') &&      # Show answers html.
  &Apache::response::show_answer() ) {  
  if ($direction eq 'horizontal') {      if ( ( $target ne 'tex' )
     if ($target ne 'tex') {          && &Apache::response::show_answer() )
  $result.='<table><tr>';      {
     }  
  }   $result = &display_foils_html(
  foreach my $name (@whichfoils) {      $whichfoils, $target, $direction, $part,  1);
     if ($direction eq 'horizontal') {  
  if ($target ne 'tex') { $result.='<td>'; }   # other html
     }      }  elsif ($target ne 'tex') {
     if ($target ne 'tex') {      $result = &display_foils_html($whichfoils, $target, $direction, $part,
  $result.="<br />";    0, 0);
     } else {  
  $result.='\item \vskip -2 mm  ';         # LaTeX rendering:
     }  
     if ($Apache::response::foilgroup{$name.'.value'} eq 'true') {   
  if ($target ne 'tex') { $result.='Correct:<b>'; } else { $result.='Correct: \textbf{';}  
     } else {  
  $result.='Incorrect:';  
     }  
     if ($target eq 'web') { $result.="<label>"; }  
     $result.=$Apache::response::foilgroup{$name.'.text'};  
     if ($target eq 'web') { $result.="</label>"; }  
     if ($Apache::response::foilgroup{$name.'.value'} eq 'true') {  
  if ($target ne 'tex') { $result.='</b>';} else {$result.='}';}  
     }  
     if ($direction eq 'horizontal') {  
  if ($target ne 'tex') { $result.='</td>'; }  
     }  
  }  
  if ($direction eq 'horizontal') {  
     if ($target ne 'tex') {  
  $result.='</tr></table>';  
     }  
  }  
     } else {      } else {
  my @alphabet = ('A'..'Z');  
  my $i = 0;          my $i             = 0;
  my $temp=0;            my $bubble_number = 0;
  my $id=$Apache::inputtags::response['-1'];          my $line          = 0;
  my $part=$Apache::inputtags::part;          my $temp          = 0;
  my $lastresponse=$Apache::lonhomework::history{"resource.$part.$id.submission"};          my $id            = $Apache::inputtags::response['-1'];
  my %lastresponse=&Apache::lonnet::str2hash($lastresponse);          my $part          = $Apache::inputtags::part;
  if ($target ne 'tex' && $direction eq 'horizontal') {  
     $result.="<table><tr>";  
  }  
  foreach my $name (@whichfoils) {   my $numlines;
     if ($target ne 'tex') {  
  if ($direction eq 'horizontal') {   # Decide how to bracket the list of foils:
     $result.="<td>";   
  } else {    my $begin_environment;
     $result.="<br />";   my $end_environment;
  }   
     }          if (   $env{'form.pdfFormFields'} eq 'yes'
     if ($target ne 'tex') {               && $Apache::inputtags::status[-1] eq 'CAN_ANSWER' )
                 $result.= '<label>';          {
  $result.="<input type=\"radio\" name=\"HWVAL_$Apache::inputtags::response['-1']\" value=\"$temp\" ";              $begin_environment = '\begin{itemize}';
  if (defined($lastresponse{$name})) { $result .= 'checked="on"'; }      $end_environment   = '\end{itemize}';
  $result .= '>'.$Apache::response::foilgroup{$name.'.text'}."</label>";          }
           else {
               $begin_environment = '\begin{enumerate}';
       $end_environment   = '\end{enumerate}';
           }
   
    # Rendering for latex exams.
   
    if ( ( $Apache::lonhomework::type eq 'exam' ) )
    {
       $result .= &display_latex_exam(
    $whichfoils, $bubbles_per_line, $direction, $begin_environment, 
    $end_environment);
   
       $result .= '\vskip 0mm ';
       
    } else {    
   
       # Different rendering for PDF form than for a
       # 'regular' answer direction is honored in both of those
       #
   
       if ( ($env{'form.pdfFormFields'} eq 'yes')
       && ($Apache::inputtags::status[-1] eq 'CAN_ANSWER'))
       {
    $result .= $begin_environment;
    $result .= &display_pdf_form($whichfoils, $direction);
    $result .= $end_environment;
     } else {      } else {
  if ($Apache::lonhomework::type eq 'exam') {   $result .= &display_latex(
     $result .= '{\small \textbf{'.$alphabet[$i].'}}$\bigcirc$'.$Apache::response::foilgroup{$name.'.text'}.'\\\\';  #' stupid emacs       $whichfoils,  $direction, $begin_environment, $end_environment
     $i++;      );
  } else {  
     $result .= '\vspace*{-2 mm}\item '.$Apache::response::foilgroup{$name.'.text'};  
  }  
     }  
     if ($target ne 'tex' && $direction eq 'horizontal') {  
  $result.="</td>";   
     }      }
     $temp++;      $result .= '\vskip 0 mm '; 
  }         
  if ($target ne 'tex' && $direction eq 'horizontal') {  
     $result.="</tr></table>";  
  }   }
   
   
     }      }
     if ($target ne 'tex') { if ($direction ne 'horizontal') { $result.="<br />";} } else { $result.='\vskip 0 mm '; }  
     return $result;      return $result;
 }  }
   
 sub displayallanswers {  sub displayallanswers {
     my @names = @{ $Apache::response::foilgroup{'names'} };      my @names;
         if ( $Apache::response::foilgroup{'names'} ) {
     my $result=&Apache::response::answer_header('radiobuttonresponse');          @names = @{ $Apache::response::foilgroup{'names'} };
       }
       my $result = &Apache::response::answer_header('radiobuttonresponse');
     foreach my $name (@names) {      foreach my $name (@names) {
  $result.=&Apache::response::answer_part('radiobuttonresponse',          $result .=
  $Apache::response::foilgroup{$name.'.value'});            &Apache::response::answer_part( 'radiobuttonresponse',
               $Apache::response::foilgroup{ $name . '.value' } );
     }      }
     $result.=&Apache::response::answer_footer('radiobuttonresponse');      $result .= &Apache::response::answer_footer('radiobuttonresponse');
     return $result;      return $result;
 }  }
   
 sub displayanswers {  sub displayanswers {
     my ($max,$randomize)=@_;      my ( $answer, $whichopt, $bubbles_per_line ) = @_;
     my ($answer,@whichopt) = &whichfoils($max,$randomize);      my $result;
     my $result=&Apache::response::answer_header('radiobuttonresponse');  
     foreach my $name (@whichopt) {      if ( $Apache::lonhomework::type eq 'exam' ) {
  $result.=&Apache::response::answer_part('radiobuttonresponse',          my $line    = int( $answer / $bubbles_per_line );
  $Apache::response::foilgroup{$name.'.value'})          my $correct = ( 'A' .. 'Z' )[ $answer % $bubbles_per_line ];
  }          $result .=
     $result.=&Apache::response::answer_footer('radiobuttonresponse');            &Apache::response::answer_header( 'radiobuttonresponse', $line );
           $result .=
             &Apache::response::answer_part( 'radiobuttonresponse', $correct );
       }
       else {
           $result .= &Apache::response::answer_header('radiobuttonresponse');
       }
       foreach my $name ( @{$whichopt} ) {
           $result .=
             &Apache::response::answer_part( 'radiobuttonresponse',
               $Apache::response::foilgroup{ $name . '.value' } );
       }
       $result .= &Apache::response::answer_footer('radiobuttonresponse');
     return $result;      return $result;
 }  }
   
 sub start_conceptgroup {  sub start_conceptgroup {
     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;      my ( $target, $token, $tagstack, $parstack, $parser, $safeeval, $style ) =
     $Apache::radiobuttonresponse::conceptgroup=1;        @_;
     %Apache::response::conceptgroup=();      $Apache::radiobuttonresponse::conceptgroup = 1;
     my $result;      %Apache::response::conceptgroup            = ();
     if ($target eq 'edit') {      my $result;
  $result.=&Apache::edit::tag_start($target,$token);      if ( $target eq 'edit' ) {
  $result.=&Apache::edit::text_arg('Concept:','concept',$token,'50').          $result .= &Apache::edit::tag_start( $target, $token );
     &Apache::edit::end_row().&Apache::edit::start_spanning_row();          $result .=
     } elsif ($target eq 'modified') {              &Apache::edit::text_arg( 'Concept:', 'concept', $token, '50' )
  my $constructtag=&Apache::edit::get_new_args($token,$parstack,            . &Apache::edit::end_row()
      $safeeval,'concept');            . &Apache::edit::start_spanning_row();
  if ($constructtag) { $result = &Apache::edit::rebuild_tag($token); }      }
       elsif ( $target eq 'modified' ) {
           my $constructtag =
             &Apache::edit::get_new_args( $token, $parstack, $safeeval,
               'concept' );
           if ($constructtag) { $result = &Apache::edit::rebuild_tag($token); }
     }      }
     return $result;      return $result;
 }  }
   
 sub end_conceptgroup {  sub end_conceptgroup {
     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;      my ( $target, $token, $tagstack, $parstack, $parser, $safeeval, $style ) =
     $Apache::radiobuttonresponse::conceptgroup=0;        @_;
       $Apache::radiobuttonresponse::conceptgroup = 0;
     my $result;      my $result;
     if ($target eq 'web' || $target eq 'grade' || $target eq 'answer'  ||      if (   $target eq 'web'
  $target eq 'tex' || $target eq 'analyze') {          || $target eq 'grade'
  &Apache::response::pick_foil_for_concept($target,          || $target eq 'answer'
  ['value','text','location'],          || $target eq 'tex'
  \%Apache::hint::radiobutton,          || $target eq 'analyze' )
  $parstack,$safeeval);      {
     } elsif ($target eq 'edit') {          &Apache::response::pick_foil_for_concept( $target,
  $result=&Apache::edit::end_table();              [ 'value', 'text', 'location' ],
               \%Apache::hint::radiobutton, $parstack, $safeeval );
       }
       elsif ( $target eq 'edit' ) {
           $result = &Apache::edit::end_table();
     }      }
     return $result;      return $result;
 }  }
   
 sub insert_conceptgroup {  sub insert_conceptgroup {
     my $result="\n\t\t<conceptgroup concept=\"\">".&insert_foil()."\n\t\t</conceptgroup>\n";      my $result =
           "\n\t\t<conceptgroup concept=\"\">"
         . &insert_foil()
         . "\n\t\t</conceptgroup>\n";
     return $result;      return $result;
 }  }
   
 sub start_foil {  sub start_foil {
     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;      my ( $target, $token, $tagstack, $parstack, $parser, $safeeval, $style ) =
     my $result='';        @_;
     if ($target eq 'web' || $target eq 'tex' || $target eq 'analyze') {      my $result = '';
  &Apache::lonxml::startredirection;      if ( $target eq 'web' || $target eq 'tex' || $target eq 'analyze' ) {
  if ($target eq 'analyze') {          &Apache::lonxml::startredirection;
     &Apache::response::check_if_computed($token,$parstack,$safeeval,'value');          if ( $target eq 'analyze' ) {
  }              &Apache::response::check_if_computed( $token, $parstack, $safeeval,
     } elsif ($target eq 'edit') {                  'value' );
  $result=&Apache::edit::tag_start($target,$token);          }
  $result.=&Apache::edit::text_arg('Name:','name',$token);      }
  $result.=&Apache::edit::select_or_text_arg('Correct Option:','value',      elsif ( $target eq 'edit' ) {
    ['unused','true','false'],          $result = &Apache::edit::tag_start( $target, $token );
    $token);          $result .= &Apache::edit::text_arg( 'Name:', 'name', $token );
  my $randomize=&Apache::lonxml::get_param('randomize',$parstack,          $result .= &Apache::edit::select_or_text_arg(
  $safeeval,'-3');              'Correct Option:', 'value',
  if ($randomize ne 'no') {              [ 'unused', 'true', 'false' ], $token
     $result.=&Apache::edit::select_arg('Location:','location',          );
        ['random','top','bottom'],$token);          my $randomize =
  }            &Apache::lonxml::get_param( 'randomize', $parstack, $safeeval, '-3' );
  $result.=&Apache::edit::end_row().&Apache::edit::start_spanning_row();          if ( $randomize ne 'no' ) {
     } elsif ($target eq 'modified') {              $result .=
  my $constructtag=&Apache::edit::get_new_args($token,$parstack,                &Apache::edit::select_arg( 'Location:', 'location',
      $safeeval,'value','name',                  [ 'random', 'top', 'bottom' ], $token );
      'location');          }
  if ($constructtag) { $result = &Apache::edit::rebuild_tag($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, 'value',
               'name', 'location' );
           if ($constructtag) { $result = &Apache::edit::rebuild_tag($token); }
       }
     return $result;      return $result;
 }  }
   
 sub end_foil {  sub end_foil {
     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;      my ( $target, $token, $tagstack, $parstack, $parser, $safeeval, $style ) =
     my $text='';        @_;
     if ($target eq 'web' || $target eq 'tex' || $target eq 'analyze') {      my $text = '';
  $text=&Apache::lonxml::endredirection;      if ( $target eq 'web' || $target eq 'tex' || $target eq 'analyze' ) {
     }          $text = &Apache::lonxml::endredirection;
     if ($target eq 'web' || $target eq 'grade' || $target eq 'answer'      }
  || $target eq 'tex' || $target eq 'analyze') {      if (   $target eq 'web'
  my $value = &Apache::lonxml::get_param('value',$parstack,$safeeval);          || $target eq 'grade'
  if ($value ne 'unused') {          || $target eq 'answer'
     my $name = &Apache::lonxml::get_param('name',$parstack,$safeeval);          || $target eq 'tex'
     if (!$name) { $name=$Apache::lonxml::curdepth; }          || $target eq 'analyze' )
     if (defined($Apache::response::foilnames{$name})) {      {
  &Apache::lonxml::error(&mt("Foil name <b><tt>[_1]</tt></b> appears more than once. Foil names need to be unique.",$name));          my $value = &Apache::lonxml::get_param( 'value', $parstack, $safeeval );
     }          if ( $value ne 'unused' ) {
     $Apache::response::foilnames{$name}++;              my $name =
     my $location =&Apache::lonxml::get_param('location',$parstack,                &Apache::lonxml::get_param( 'name', $parstack, $safeeval );
      $safeeval);              if ( $name eq "" ) {
     if ( $Apache::radiobuttonresponse::conceptgroup                  &Apache::lonxml::warning(
  && !&Apache::response::showallfoils() ) {                      &mt(
  push @{ $Apache::response::conceptgroup{'names'} }, $name;  'Foils without names exist. This can cause problems to malfunction.'
  $Apache::response::conceptgroup{"$name.value"} = $value;                      )
  $Apache::response::conceptgroup{"$name.text"} = $text;                  );
  $Apache::response::conceptgroup{"$name.location"} = $location;                  $name = $Apache::lonxml::curdepth;
     } else {              }
  push @{ $Apache::response::foilgroup{'names'} }, $name;              if ( defined( $Apache::response::foilnames{$name} ) ) {
  $Apache::response::foilgroup{"$name.value"} = $value;                  &Apache::lonxml::error(
  $Apache::response::foilgroup{"$name.text"} = $text;                      &mt(
  $Apache::response::foilgroup{"$name.location"} = $location;  'Foil name [_1] appears more than once. Foil names need to be unique.',
     }                          '<b><tt>' . $name . '</tt></b>'
  }                      )
                   );
               }
               $Apache::response::foilnames{$name}++;
               my $location =
                 &Apache::lonxml::get_param( 'location', $parstack, $safeeval );
               if ( $Apache::radiobuttonresponse::conceptgroup
                   && !&Apache::response::showallfoils() )
               {
                   push @{ $Apache::response::conceptgroup{'names'} }, $name;
                   $Apache::response::conceptgroup{"$name.value"}    = $value;
                   $Apache::response::conceptgroup{"$name.text"}     = $text;
                   $Apache::response::conceptgroup{"$name.location"} = $location;
               }
               else {
                   push @{ $Apache::response::foilgroup{'names'} }, $name;
                   $Apache::response::foilgroup{"$name.value"}    = $value;
                   $Apache::response::foilgroup{"$name.text"}     = $text;
                   $Apache::response::foilgroup{"$name.location"} = $location;
               }
           }
     }      }
     return '';      return '';
 }  }
Line 637  sub insert_foil { Line 1542  sub insert_foil {
 <endouttext />  <endouttext />
 </foil>';  </foil>';
 }  }
   
 1;  1;
 __END__  __END__
   
   
   
   =head1 NAME
   
   Apache::radiobuttonresponse
   
   =head1 SYNOPSIS
   
   Handles multiple-choice style responses.
   
   This is part of the LearningOnline Network with CAPA project
   described at http://www.lon-capa.org.
   
   =head1 SUBROUTINES
   
   =over
   
   =item start_radiobuttonresponse()
   
   =item bubble_line_count()
   
   =item end_radiobuttonresponse()
   
   =item start_foilgroup()
   
   =item storesurvey()
   
   =item grade_response()
   
   =item end_foilgroup()
   
   =item getfoilcounts()
   
   =item format_prior_answer()
   
   =item displayallfoils()
   
   =item &whichfoils($max,$randomize)
   
   Randomizes the list of foils.
   Respects
     - each foils desire to be randomized
     - the existance of Concept groups of foils (select 1 foil from each)
     - and selects a single correct statement from all possilble true statments
     - and limits it to a toal of $max foils
   
   WARNING: this routine uses the random number generator, it should only
   be called once per target, otherwise it can cause randomness changes in
   homework problems.
   
   Arguments
     $max - maximum number of foils to select (including the true one)
            (so a max of 5 is: 1 true, 4 false)
   
     $randomize - whether to randomize the listing of foils, by default
                  will randomize, only if randomize is 'no' will it not
   
   Returns
     $answer - location in the array of the correct answer
     @foils  - array of foil names in to display order
   
   =item displayfoils()
   
   =item displayallanswers()
   
   =item displayanswers()
   
   =item start_conceptgroup()
   
   =item end_conceptgroup()
   
   =item insert_conceptgroup()
   
   =item start_foil()
   
   =item end_foil()
   
   =item insert_foil()
   
   =back
   
   =cut
     

Removed from v.1.97  
changed lines
  Added in v.1.153.6.8


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