swad_test_visibility.c

// swad_test_visibility.c: visibility of test prints

/*
    SWAD (Shared Workspace At a Distance),
    is a web platform developed at the University of Granada (Spain),
    and used to support university teaching.

    This file is part of SWAD core.
    Copyright (C) 1999-2025 Antonio Cañas Vargas

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU Affero General Public License as
    published by the Free Software Foundation, either version 3 of the
    License, or (at your option) any later version.

    This program 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 Affero General Public License for more details.

    You should have received a copy of the GNU Affero General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/
/*****************************************************************************/
/*********************************** Headers *********************************/
/*****************************************************************************/

#define _GNU_SOURCE 		// For asprintf
#include <stdio.h>		// For asprintf
#include <stdlib.h>		// For malloc, free

#include "swad_error.h"
#include "swad_global.h"
#include "swad_hidden_visible.h"
#include "swad_HTML.h"
#include "swad_parameter.h"
#include "swad_test_visibility.h"

/*****************************************************************************/
/******************************* Show visibility *****************************/
/*****************************************************************************/

void TstVis_ShowVisibilityIcons (unsigned SelectedVisibility,
                                 HidVis_HiddenOrVisible_t HiddenOrVisible)
  {
   extern const char *Txt_TST_STR_VISIBILITY[TstVis_NUM_ITEMS_VISIBILITY];
   extern const char *Txt_TST_HIDDEN_VISIBLE[HidVis_NUM_HIDDEN_VISIBLE];
   static const char *Icons[TstVis_NUM_ITEMS_VISIBILITY] =
     {
      [TstVis_VISIBLE_QST_ANS_TXT   ] = "file-alt.svg",
      [TstVis_VISIBLE_FEEDBACK_TXT  ] = "file-signature.svg",
      [TstVis_VISIBLE_CORRECT_ANSWER] = "spell-check.svg",
      [TstVis_VISIBLE_EACH_QST_SCORE] = "tasks.svg",
      [TstVis_VISIBLE_TOTAL_SCORE   ] = "check-circle-regular.svg",
     };
   static Ico_Color_t Color[HidVis_NUM_HIDDEN_VISIBLE] =
     {
      [HidVis_HIDDEN ] = Ico_RED,
      [HidVis_VISIBLE] = Ico_GREEN,
     };
   static void (*Ico_PutIcon[HidVis_NUM_HIDDEN_VISIBLE]) (const char *Icon,
							  Ico_Color_t Color,
							  const char *Title) =
     {
      [HidVis_HIDDEN ] = Ico_PutIconOff,
      [HidVis_VISIBLE] = Ico_PutIconOn,
     };
   TstVis_Visibility_t Visibility;
   HidVis_HiddenOrVisible_t ItemHiddenOrVisible;
   char *Title;

   for (Visibility  = (TstVis_Visibility_t) 0;
	Visibility <= (TstVis_Visibility_t) (TstVis_NUM_ITEMS_VISIBILITY - 1);
	Visibility++)
     {
      ItemHiddenOrVisible = (SelectedVisibility & (1 << Visibility)) ? HidVis_VISIBLE :
								       HidVis_HIDDEN;
      if (asprintf (&Title,"%s: %s",
		    Txt_TST_STR_VISIBILITY[Visibility],
		    Txt_TST_HIDDEN_VISIBLE[ItemHiddenOrVisible]) < 0)
	 Err_NotEnoughMemoryExit ();
      Ico_PutIcon[HiddenOrVisible] (Icons[Visibility],Color[ItemHiddenOrVisible],Title);
      free (Title);
     }
  }

/*****************************************************************************/
/************* Put checkboxes in form to select exam visibility **************/
/*****************************************************************************/

void TstVis_PutVisibilityCheckboxes (unsigned SelectedVisibility)
  {
   extern const char *Txt_TST_STR_VISIBILITY[TstVis_NUM_ITEMS_VISIBILITY];
   static const char *Icons[TstVis_NUM_ITEMS_VISIBILITY] =
     {
      [TstVis_VISIBLE_QST_ANS_TXT   ] = "file-alt.svg",
      [TstVis_VISIBLE_FEEDBACK_TXT  ] = "file-signature.svg",
      [TstVis_VISIBLE_CORRECT_ANSWER] = "spell-check.svg",
      [TstVis_VISIBLE_EACH_QST_SCORE] = "tasks.svg",
      [TstVis_VISIBLE_TOTAL_SCORE   ] = "check-circle-regular.svg",
     };
   TstVis_Visibility_t Visibility;

   /***** Write list of checkboxes for visibility *****/
   for (Visibility  = (TstVis_Visibility_t) 0;
	Visibility <= (TstVis_Visibility_t) (TstVis_NUM_ITEMS_VISIBILITY - 1);
	Visibility++)
     {
      /* Begin label */
      HTM_LABEL_Begin ("class=\"DAT_%s\"",The_GetSuffix ());

         /* Checkbox with icon and text */
	 HTM_INPUT_CHECKBOX ("Visibility",
			     (SelectedVisibility & (1 << Visibility)) ? HTM_CHECKED :
									HTM_NO_ATTR,
			     "value=\"%u\"",(unsigned) Visibility);
	 Ico_PutIconOn (Icons[Visibility],Ico_BLACK,
	                Txt_TST_STR_VISIBILITY[Visibility]);
	 HTM_Txt (Txt_TST_STR_VISIBILITY[Visibility]);

      /* End label */
      HTM_LABEL_End ();
      HTM_BR ();
     }
  }

/*****************************************************************************/
/************************** Get visibility from form *************************/
/*****************************************************************************/

unsigned TstVis_GetVisibilityFromForm (void)
  {
   size_t MaxSizeListVisibilitySelected;
   char *StrVisibilitySelected;
   const char *Ptr;
   char UnsignedStr[Cns_MAX_DIGITS_UINT + 1];
   unsigned UnsignedNum;
   TstVis_Visibility_t VisibilityItem;
   unsigned Visibility = 0;	// Nothing selected

   /***** Allocate memory for list of attendance events selected *****/
   MaxSizeListVisibilitySelected = TstVis_NUM_ITEMS_VISIBILITY * (Cns_MAX_DIGITS_UINT + 1);
   if ((StrVisibilitySelected = malloc (MaxSizeListVisibilitySelected + 1)) == NULL)
      Err_NotEnoughMemoryExit ();

   /***** Get parameter multiple with list of visibility items selected *****/
   Par_GetParMultiToText ("Visibility",StrVisibilitySelected,MaxSizeListVisibilitySelected);

   /***** Set which attendance events will be shown as selected (checkboxes on) *****/
   if (StrVisibilitySelected[0])	// There are events selected
      for (Ptr = StrVisibilitySelected;
	   *Ptr;
	  )
	{
	 /* Get next visibility item selected */
	 Par_GetNextStrUntilSeparParMult (&Ptr,UnsignedStr,Cns_MAX_DIGITS_UINT);
         if (sscanf (UnsignedStr,"%u",&UnsignedNum) == 1)
            if (UnsignedNum < TstVis_NUM_ITEMS_VISIBILITY)
              {
               VisibilityItem = (TstVis_Visibility_t) UnsignedNum;
               Visibility |= (1 << VisibilityItem);
              }
	}

   return Visibility;
  }

/*****************************************************************************/
/************************** Get visibility from string *************************/
/*****************************************************************************/

unsigned TstVis_GetVisibilityFromStr (const char *Str)
  {
   unsigned UnsignedNum;
   unsigned Visibility = TstVis_MIN_VISIBILITY;	// In nothing is read, return minimum visibility

   /***** Get visibility from string *****/
   if (Str)
      if (Str[0])
         if (sscanf (Str,"%u",&UnsignedNum) == 1)
            Visibility = UnsignedNum & TstVis_MAX_VISIBILITY;

   return Visibility;
  }

/*****************************************************************************/
/***************************** Get visibility items **************************/
/*****************************************************************************/

bool TstVis_IsVisibleQstAndAnsTxt (unsigned Visibility)
  {
   return (Visibility & (1 << TstVis_VISIBLE_QST_ANS_TXT)) != 0;
  }

bool TstVis_IsVisibleFeedbackTxt (unsigned Visibility)
  {
   return (Visibility & (1 << TstVis_VISIBLE_FEEDBACK_TXT)) != 0;
  }

bool TstVis_IsVisibleCorrectAns (unsigned Visibility)
  {
   return (Visibility & (1 << TstVis_VISIBLE_CORRECT_ANSWER)) != 0;
  }

bool TstVis_IsVisibleEachQstScore (unsigned Visibility)
  {
   return (Visibility & (1 << TstVis_VISIBLE_EACH_QST_SCORE)) != 0;
  }

bool TstVis_IsVisibleTotalScore (unsigned Visibility)
  {
   return (Visibility & (1 << TstVis_VISIBLE_TOTAL_SCORE)) != 0;
  }