1 | /* |
1 | /* |
2 | CrossFire, A Multiplayer game for X-windows |
2 | * This file is part of Crossfire TRT, the Multiplayer Online Role Playing Game. |
3 | |
3 | * |
|
|
4 | * Copyright (©) 2005,2006,2007 Marc Alexander Lehmann / Robin Redeker / the Crossfire TRT team |
4 | Copyright (C) 2002 Mark Wedel & Crossfire Development Team |
5 | * Copyright (©) 2002,2007 Mark Wedel & Crossfire Development Team |
5 | Copyright (C) 1992 Frank Tore Johansen |
6 | * Copyright (©) 1992,2007 Frank Tore Johansen |
6 | |
7 | * |
7 | This program is free software; you can redistribute it and/or modify |
8 | * Crossfire TRT is free software; you can redistribute it and/or modify it |
8 | it under the terms of the GNU General Public License as published by |
9 | * under the terms of the GNU General Public License as published by the Free |
9 | the Free Software Foundation; either version 2 of the License, or |
10 | * Software Foundation; either version 2 of the License, or (at your option) |
10 | (at your option) any later version. |
11 | * any later version. |
11 | |
12 | * |
12 | This program is distributed in the hope that it will be useful, |
13 | * This program is distributed in the hope that it will be useful, but |
13 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
14 | * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY |
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
15 | * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
15 | GNU General Public License for more details. |
16 | * for more details. |
16 | |
17 | * |
17 | You should have received a copy of the GNU General Public License |
18 | * You should have received a copy of the GNU General Public License along |
18 | along with this program; if not, write to the Free Software |
19 | * with Crossfire TRT; if not, write to the Free Software Foundation, Inc. 51 |
19 | Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. |
20 | * Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
20 | |
21 | * |
21 | The authors can be reached via e-mail at crossfire-devel@real-time.com |
22 | * The authors can be reached via e-mail to <crossfire@schmorp.de> |
22 | */ |
23 | */ |
23 | |
|
|
24 | |
24 | |
25 | /* This file contains code relevant to the BOOKS hack -- designed |
25 | /* This file contains code relevant to the BOOKS hack -- designed |
26 | * to allow randomly occuring messages in non-magical texts. |
26 | * to allow randomly occuring messages in non-magical texts. |
27 | */ |
27 | */ |
28 | |
28 | |
… | |
… | |
110 | * pointers to all (hostile) monster objects */ |
110 | * pointers to all (hostile) monster objects */ |
111 | |
111 | |
112 | static int nrofmon = 0, need_to_write_bookarchive = 0; |
112 | static int nrofmon = 0, need_to_write_bookarchive = 0; |
113 | |
113 | |
114 | |
114 | |
115 | /* this is needed to keep track of status of initialization |
115 | /* this is needed to keep track of status of initialisation |
116 | * of the message file */ |
116 | * of the message file */ |
117 | static int nrofmsg = 0; |
117 | static int nrofmsg = 0; |
118 | |
118 | |
119 | /* first_msg is the started of the linked list of messages as read from |
119 | /* first_msg is the started of the linked list of messages as read from |
120 | * the messages file |
120 | * the messages file |
… | |
… | |
187 | {"Shield", SHIELD}, |
187 | {"Shield", SHIELD}, |
188 | {"Bracers", BRACERS}, |
188 | {"Bracers", BRACERS}, |
189 | {"Boots", BOOTS}, |
189 | {"Boots", BOOTS}, |
190 | {"Cloak", CLOAK}, |
190 | {"Cloak", CLOAK}, |
191 | {"Gloves", GLOVES}, |
191 | {"Gloves", GLOVES}, |
192 | {"Gridle", GIRDLE}, |
192 | {"Girdle", GIRDLE}, |
193 | {"Ring", RING}, |
193 | {"Ring", RING}, |
194 | {"Horn", HORN}, |
194 | {"Horn", HORN}, |
195 | {"Missile Weapon", BOW}, |
195 | {"Missile Weapon", BOW}, |
196 | {"Missile", ARROW}, |
196 | {"Missile", ARROW}, |
197 | {"Hand Weapon", WEAPON}, |
197 | {"Hand Weapon", WEAPON}, |
… | |
… | |
636 | |
636 | |
637 | } |
637 | } |
638 | |
638 | |
639 | /***************************************************************************** |
639 | /***************************************************************************** |
640 | * |
640 | * |
641 | * Start of initialization related functions. |
641 | * Start of initialisation related functions. |
642 | * |
642 | * |
643 | ****************************************************************************/ |
643 | ****************************************************************************/ |
644 | |
644 | |
645 | /* init_msgfile() - if not called before, initialize the info list |
|
|
646 | * reads the messages file into the list pointed to by first_msg |
|
|
647 | */ |
|
|
648 | |
|
|
649 | static void |
|
|
650 | init_msgfile (void) |
|
|
651 | { |
|
|
652 | FILE *fp; |
|
|
653 | char buf[MAX_BUF], msgbuf[HUGE_BUF], fname[MAX_BUF], *cp; |
|
|
654 | int comp; |
|
|
655 | static int did_init_msgfile; |
|
|
656 | |
|
|
657 | if (did_init_msgfile) |
|
|
658 | return; |
|
|
659 | did_init_msgfile = 1; |
|
|
660 | |
|
|
661 | sprintf (fname, "%s/messages", settings.datadir); |
|
|
662 | LOG (llevDebug, "Reading messages from %s...", fname); |
|
|
663 | |
|
|
664 | if ((fp = open_and_uncompress (fname, 0, &comp)) != NULL) |
|
|
665 | { |
|
|
666 | linked_char *tmp = NULL; |
|
|
667 | |
|
|
668 | while (fgets (buf, MAX_BUF, fp) != NULL) |
|
|
669 | { |
|
|
670 | if (*buf == '#') |
|
|
671 | continue; |
|
|
672 | if ((cp = strchr (buf, '\n')) != NULL) |
|
|
673 | *cp = '\0'; |
|
|
674 | cp = buf; |
|
|
675 | while (*cp == ' ') /* Skip blanks */ |
|
|
676 | cp++; |
|
|
677 | if (!strncmp (cp, "ENDMSG", 6)) |
|
|
678 | { |
|
|
679 | if (strlen (msgbuf) > BOOK_BUF) |
|
|
680 | { |
|
|
681 | LOG (llevDebug, "Warning: this string exceeded max book buf size:"); |
|
|
682 | LOG (llevDebug, " %s", msgbuf); |
|
|
683 | } |
|
|
684 | tmp->name = msgbuf; |
|
|
685 | tmp->next = first_msg; |
|
|
686 | first_msg = tmp; |
|
|
687 | nrofmsg++; |
|
|
688 | continue; |
|
|
689 | } |
|
|
690 | else if (!strncmp (cp, "MSG", 3)) |
|
|
691 | { |
|
|
692 | tmp = new linked_char; |
|
|
693 | |
|
|
694 | strcpy (msgbuf, " "); /* reset msgbuf for new message */ |
|
|
695 | continue; |
|
|
696 | } |
|
|
697 | else if (!buf_overflow (msgbuf, cp, HUGE_BUF - 1)) |
|
|
698 | { |
|
|
699 | strcat (msgbuf, cp); |
|
|
700 | strcat (msgbuf, "\n"); |
|
|
701 | } |
|
|
702 | } |
|
|
703 | close_and_delete (fp, comp); |
|
|
704 | } |
|
|
705 | |
|
|
706 | #ifdef BOOK_MSG_DEBUG |
|
|
707 | LOG (llevDebug, "\ninit_info_listfile() got %d messages.\n", nrofmsg); |
|
|
708 | #endif |
|
|
709 | LOG (llevDebug, "done.\n"); |
|
|
710 | } |
|
|
711 | |
|
|
712 | |
|
|
713 | /* init_book_archive() - if not called before, initialize the info list |
645 | /* init_book_archive() - if not called before, initialise the info list |
714 | * This reads in the bookarch file into memory. bookarch is the file |
646 | * This reads in the bookarch file into memory. bookarch is the file |
715 | * created and updated across multiple runs of the program. |
647 | * created and updated across multiple runs of the program. |
716 | */ |
648 | */ |
717 | |
|
|
718 | static void |
649 | static void |
719 | init_book_archive (void) |
650 | init_book_archive (void) |
720 | { |
651 | { |
721 | FILE *fp; |
652 | FILE *fp; |
722 | int comp, nroftitle = 0; |
653 | int comp, nroftitle = 0; |
… | |
… | |
788 | book->next = bl->first_book; |
719 | book->next = bl->first_book; |
789 | bl->first_book = book; |
720 | bl->first_book = book; |
790 | bl->number++; |
721 | bl->number++; |
791 | } |
722 | } |
792 | } |
723 | } |
793 | LOG (llevDebug, " book archives(used/avail): "); |
724 | LOG (llevDebug, "book archives(used/avail): \n"); |
794 | for (bl = booklist, i = 0; bl != NULL && i < sizeof (max_titles) / sizeof (*max_titles); bl = bl->next, i++) |
725 | for (bl = booklist, i = 0; bl != NULL && i < sizeof (max_titles) / sizeof (*max_titles); bl = bl->next, i++) |
795 | { |
726 | { |
796 | LOG (llevDebug, "(%d/%d)", bl->number, max_titles[i]); |
727 | LOG (llevDebug, " (%d/%d)\n", bl->number, max_titles[i]); |
797 | } |
728 | } |
798 | LOG (llevDebug, "\n"); |
|
|
799 | close_and_delete (fp, comp); |
729 | close_and_delete (fp, comp); |
800 | } |
730 | } |
801 | |
731 | |
802 | #ifdef BOOK_MSG_DEBUG |
732 | #ifdef BOOK_MSG_DEBUG |
803 | LOG (llevDebug, "\n init_book_archive() got %d titles.\n", nroftitle); |
733 | LOG (llevDebug, "init_book_archive() got %d titles.\n", nroftitle); |
804 | #endif |
734 | #endif |
805 | LOG (llevDebug, " done.\n"); |
735 | LOG (llevDebug, " done.\n"); |
806 | } |
736 | } |
807 | |
737 | |
808 | /* init_mon_info() - creates the linked list of pointers to |
738 | /* init_mon_info() - creates the linked list of pointers to |
… | |
… | |
815 | archetype *at; |
745 | archetype *at; |
816 | static int did_init_mon_info = 0; |
746 | static int did_init_mon_info = 0; |
817 | |
747 | |
818 | if (did_init_mon_info) |
748 | if (did_init_mon_info) |
819 | return; |
749 | return; |
|
|
750 | |
820 | did_init_mon_info = 1; |
751 | did_init_mon_info = 1; |
821 | |
752 | |
822 | |
753 | |
823 | for (at = first_archetype; at != NULL; at = at->next) |
754 | for (at = first_archetype; at != NULL; at = at->next) |
824 | { |
755 | { |
825 | if (QUERY_FLAG (&at->clone, FLAG_MONSTER) && (!QUERY_FLAG (&at->clone, FLAG_CHANGING) || QUERY_FLAG (&at->clone, FLAG_UNAGGRESSIVE))) |
756 | if (QUERY_FLAG (&at->clone, FLAG_MONSTER) && (!QUERY_FLAG (&at->clone, FLAG_CHANGING) || QUERY_FLAG (&at->clone, FLAG_UNAGGRESSIVE))) |
826 | { |
757 | { |
827 | objectlink *mon = (objectlink *) malloc (sizeof (objectlink)); |
758 | objectlink *mon = new objectlink; |
828 | |
759 | |
829 | mon->ob = &at->clone; |
760 | mon->ob = &at->clone; |
830 | mon->id = nrofmon; |
|
|
831 | mon->next = first_mon_info; |
761 | mon->next = first_mon_info; |
832 | first_mon_info = mon; |
762 | first_mon_info = mon; |
833 | nrofmon++; |
763 | nrofmon++; |
834 | } |
764 | } |
835 | } |
765 | } |
|
|
766 | |
836 | LOG (llevDebug, "init_mon_info() got %d monsters\n", nrofmon); |
767 | LOG (llevDebug, "init_mon_info() got %d monsters\n", nrofmon); |
837 | } |
768 | } |
838 | |
769 | |
839 | |
|
|
840 | /* init_readable() - initialize linked lists utilized by |
770 | /* init_readable() - initialise linked lists utilized by |
841 | * message functions in tailor_readable_ob() |
771 | * message functions in tailor_readable_ob() |
842 | * |
772 | * |
843 | * This is the function called by the main routine to initialize |
773 | * This is the function called by the main routine to initialise |
844 | * all the readable information. |
774 | * all the readable information. |
845 | */ |
775 | */ |
846 | |
|
|
847 | void |
776 | void |
848 | init_readable (void) |
777 | init_readable (void) |
849 | { |
778 | { |
850 | static int did_this; |
779 | static int did_this; |
851 | |
780 | |
852 | if (did_this) |
781 | if (did_this) |
853 | return; |
782 | return; |
|
|
783 | |
854 | did_this = 1; |
784 | did_this = 1; |
855 | |
785 | |
856 | LOG (llevDebug, "Initializing reading data..."); |
786 | LOG (llevDebug, "Initialising reading data...\n"); |
857 | init_msgfile (); |
|
|
858 | init_book_archive (); |
787 | init_book_archive (); |
859 | init_mon_info (); |
788 | init_mon_info (); |
860 | LOG (llevDebug, " Done\n"); |
789 | LOG (llevDebug, " Done\n"); |
861 | |
|
|
862 | } |
790 | } |
863 | |
791 | |
864 | /***************************************************************************** |
792 | /***************************************************************************** |
865 | * |
793 | * |
866 | * This is the start of the administrative functions when creating |
794 | * This is the start of the administrative functions when creating |
867 | * new books (ie, updating title and the like) |
795 | * new books (ie, updating title and the like) |
868 | * |
796 | * |
869 | *****************************************************************************/ |
797 | *****************************************************************************/ |
870 | |
798 | |
871 | |
|
|
872 | /* find_title() - Search the titlelist (based on msgtype) to see if |
799 | /* find_title() - Search the titlelist (based on msgtype) to see if |
873 | * book matches something already there. IF so, return that title. |
800 | * book matches something already there. IF so, return that title. |
874 | */ |
801 | */ |
875 | |
|
|
876 | static title * |
802 | static title * |
877 | find_title (const object *book, int msgtype) |
803 | find_title (const object *book, int msgtype) |
878 | { |
804 | { |
879 | title *t = NULL; |
805 | title *t = NULL; |
880 | titlelist *tl = get_titlelist (msgtype); |
806 | titlelist *tl = get_titlelist (msgtype); |
… | |
… | |
917 | if (book->type != BOOK) |
843 | if (book->type != BOOK) |
918 | return; |
844 | return; |
919 | |
845 | |
920 | switch (msgtype) |
846 | switch (msgtype) |
921 | { |
847 | { |
922 | case 1: /*monster */ |
848 | case 1: /*monster */ |
923 | nbr = sizeof (mon_book_name) / sizeof (char *); |
849 | nbr = sizeof (mon_book_name) / sizeof (char *); |
924 | strcpy (name, mon_book_name[RANDOM () % nbr]); |
850 | assign (name, mon_book_name[rndm (nbr)]); |
925 | break; |
851 | break; |
926 | case 2: /*artifact */ |
852 | case 2: /*artifact */ |
927 | nbr = sizeof (art_book_name) / sizeof (char *); |
853 | nbr = sizeof (art_book_name) / sizeof (char *); |
928 | strcpy (name, art_book_name[RANDOM () % nbr]); |
854 | assign (name, art_book_name[rndm (nbr)]); |
929 | break; |
855 | break; |
930 | case 3: /*spellpath */ |
856 | case 3: /*spellpath */ |
931 | nbr = sizeof (path_book_name) / sizeof (char *); |
857 | nbr = sizeof (path_book_name) / sizeof (char *); |
932 | strcpy (name, path_book_name[RANDOM () % nbr]); |
858 | assign (name, path_book_name[rndm (nbr)]); |
933 | break; |
859 | break; |
934 | case 4: /*alchemy */ |
860 | case 4: /*alchemy */ |
935 | nbr = sizeof (formula_book_name) / sizeof (char *); |
861 | nbr = sizeof (formula_book_name) / sizeof (char *); |
936 | strcpy (name, formula_book_name[RANDOM () % nbr]); |
862 | assign (name, formula_book_name[rndm (nbr)]); |
937 | break; |
863 | break; |
938 | case 5: /*gods */ |
864 | case 5: /*gods */ |
939 | nbr = sizeof (gods_book_name) / sizeof (char *); |
865 | nbr = sizeof (gods_book_name) / sizeof (char *); |
940 | strcpy (name, gods_book_name[RANDOM () % nbr]); |
866 | assign (name, gods_book_name[rndm (nbr)]); |
941 | break; |
867 | break; |
942 | case 6: /*msg file */ |
868 | case 6: /*msg file */ |
943 | default: |
869 | default: |
944 | if (book->weight > 2000) |
870 | if (book->weight > 2000) |
945 | { /* based on weight */ |
871 | { /* based on weight */ |
946 | nbr = sizeof (heavy_book_name) / sizeof (char *); |
872 | nbr = sizeof (heavy_book_name) / sizeof (char *); |
947 | strcpy (name, heavy_book_name[RANDOM () % nbr]); |
873 | assign (name, heavy_book_name[rndm (nbr)]); |
948 | } |
874 | } |
949 | else if (book->weight < 2001) |
875 | else if (book->weight < 2001) |
950 | { |
876 | { |
951 | nbr = sizeof (light_book_name) / sizeof (char *); |
877 | nbr = sizeof (light_book_name) / sizeof (char *); |
952 | strcpy (name, light_book_name[RANDOM () % nbr]); |
878 | assign (name, light_book_name[rndm (nbr)]); |
953 | } |
879 | } |
954 | break; |
880 | break; |
955 | } |
881 | } |
956 | |
882 | |
957 | book->name = name; |
883 | book->name = name; |
958 | } |
884 | } |
959 | |
885 | |
… | |
… | |
971 | if (msgtype < 0 || strlen (op->msg) < 5) |
897 | if (msgtype < 0 || strlen (op->msg) < 5) |
972 | return; |
898 | return; |
973 | |
899 | |
974 | switch (msgtype) |
900 | switch (msgtype) |
975 | { |
901 | { |
976 | case 1: /* monster */ |
902 | case 1: /* monster */ |
977 | nbr = sizeof (mon_author) / sizeof (char *); |
903 | nbr = sizeof (mon_author) / sizeof (char *); |
978 | strcpy (name, mon_author[RANDOM () % nbr]); |
904 | assign (name, mon_author[rndm (nbr)]); |
979 | break; |
905 | break; |
980 | case 2: /* artifacts */ |
906 | case 2: /* artifacts */ |
981 | nbr = sizeof (art_author) / sizeof (char *); |
907 | nbr = sizeof (art_author) / sizeof (char *); |
982 | strcpy (name, art_author[RANDOM () % nbr]); |
908 | assign (name, art_author[rndm (nbr)]); |
983 | break; |
909 | break; |
984 | case 3: /* spellpath */ |
910 | case 3: /* spellpath */ |
985 | nbr = sizeof (path_author) / sizeof (char *); |
911 | nbr = sizeof (path_author) / sizeof (char *); |
986 | strcpy (name, path_author[RANDOM () % nbr]); |
912 | assign (name, path_author[rndm (nbr)]); |
987 | break; |
913 | break; |
988 | case 4: /* alchemy */ |
914 | case 4: /* alchemy */ |
989 | nbr = sizeof (formula_author) / sizeof (char *); |
915 | nbr = sizeof (formula_author) / sizeof (char *); |
990 | strcpy (name, formula_author[RANDOM () % nbr]); |
916 | assign (name, formula_author[rndm (nbr)]); |
991 | break; |
917 | break; |
992 | case 5: /* gods */ |
918 | case 5: /* gods */ |
993 | nbr = sizeof (gods_author) / sizeof (char *); |
919 | nbr = sizeof (gods_author) / sizeof (char *); |
994 | strcpy (name, gods_author[RANDOM () % nbr]); |
920 | assign (name, gods_author[rndm (nbr)]); |
995 | break; |
921 | break; |
996 | case 6: /* msg file */ |
922 | case 6: /* msg file */ |
997 | default: |
923 | default: |
998 | strcpy (name, book_author[RANDOM () % nbr]); |
924 | assign (name, book_author[rndm (nbr)]); |
999 | } |
925 | } |
1000 | |
926 | |
1001 | sprintf (title, "of %s", name); |
927 | sprintf (title, "of %s", name); |
1002 | op->title = title; |
928 | op->title = title; |
1003 | } |
929 | } |
… | |
… | |
1043 | t = get_empty_book (); |
969 | t = get_empty_book (); |
1044 | t->name = book->name; |
970 | t->name = book->name; |
1045 | t->authour = book->title; |
971 | t->authour = book->title; |
1046 | t->size = strlen (book->msg); |
972 | t->size = strlen (book->msg); |
1047 | t->msg_index = strtoint (book->msg); |
973 | t->msg_index = strtoint (book->msg); |
1048 | t->archname = book->arch->name; |
974 | t->archname = book->arch->archname; |
1049 | t->level = book->level; |
975 | t->level = book->level; |
1050 | |
976 | |
1051 | t->next = tl->first_book; |
977 | t->next = tl->first_book; |
1052 | tl->first_book = t; |
978 | tl->first_book = t; |
1053 | tl->number++; |
979 | tl->number++; |
… | |
… | |
1097 | |
1023 | |
1098 | /* alter book properties */ |
1024 | /* alter book properties */ |
1099 | if ((tmpbook = get_archetype (t->archname)) != NULL) |
1025 | if ((tmpbook = get_archetype (t->archname)) != NULL) |
1100 | { |
1026 | { |
1101 | tmpbook->msg = book->msg; |
1027 | tmpbook->msg = book->msg; |
1102 | copy_object (tmpbook, book); |
1028 | tmpbook->copy_to (book); |
1103 | free_object (tmpbook); |
1029 | tmpbook->destroy (); |
1104 | } |
1030 | } |
1105 | |
1031 | |
1106 | book->title = t->authour; |
1032 | book->title = t->authour; |
1107 | book->name = t->name; |
1033 | book->name = t->name; |
1108 | book->level = t->level; |
1034 | book->level = t->level; |
… | |
… | |
1167 | if (RANDOM () % 4) |
1093 | if (RANDOM () % 4) |
1168 | { |
1094 | { |
1169 | /* Lets give the book a description to individualize it some */ |
1095 | /* Lets give the book a description to individualize it some */ |
1170 | char new_name[MAX_BUF]; |
1096 | char new_name[MAX_BUF]; |
1171 | |
1097 | |
1172 | snprintf (new_name, MAX_BUF, "%s %s", book_descrpt[RANDOM () % nbr], old_name); |
1098 | snprintf (new_name, MAX_BUF, "%s %s", book_descrpt[rndm (nbr)], old_name); |
1173 | |
1099 | |
1174 | book->name = new_name; |
1100 | book->name = new_name; |
1175 | } |
1101 | } |
1176 | else |
1102 | else |
1177 | { |
1103 | { |
… | |
… | |
1366 | ****************************************************************************/ |
1292 | ****************************************************************************/ |
1367 | |
1293 | |
1368 | /* artifact_msg() - generate a message detailing the properties |
1294 | /* artifact_msg() - generate a message detailing the properties |
1369 | * of 1-6 artifacts drawn sequentially from the artifact list. |
1295 | * of 1-6 artifacts drawn sequentially from the artifact list. |
1370 | */ |
1296 | */ |
1371 | |
1297 | const char * |
1372 | char * |
|
|
1373 | artifact_msg (int level, int booksize) |
1298 | artifact_msg (int level, int booksize) |
1374 | { |
1299 | { |
1375 | artifactlist *al = NULL; |
1300 | artifactlist *al = NULL; |
1376 | artifact *art; |
1301 | artifact *art; |
1377 | int chance, i, type, index; |
1302 | int chance, i, type, index; |
1378 | int book_entries = level > 5 ? RANDOM () % 3 + RANDOM () % 3 + 2 : RANDOM () % level + 1; |
1303 | int book_entries = level > 5 ? RANDOM () % 3 + RANDOM () % 3 + 2 : RANDOM () % level + 1; |
|
|
1304 | const char *ch; |
1379 | char *ch, name[MAX_BUF], buf[BOOK_BUF], sbuf[MAX_BUF]; |
1305 | char name[MAX_BUF], buf[BOOK_BUF], sbuf[MAX_BUF]; |
1380 | static char retbuf[BOOK_BUF]; |
1306 | static char retbuf[BOOK_BUF]; |
1381 | object *tmp = NULL; |
1307 | object *tmp = NULL; |
1382 | |
1308 | |
1383 | /* values greater than 5 create msg buffers that are too big! */ |
1309 | /* values greater than 5 create msg buffers that are too big! */ |
1384 | if (book_entries > 5) |
1310 | if (book_entries > 5) |
… | |
… | |
1398 | i++; |
1324 | i++; |
1399 | } |
1325 | } |
1400 | while ((al == NULL) && (i < 10)); |
1326 | while ((al == NULL) && (i < 10)); |
1401 | |
1327 | |
1402 | if (i == 10) /* Unable to find a message */ |
1328 | if (i == 10) /* Unable to find a message */ |
1403 | return ("None"); |
1329 | return "None"; |
1404 | |
1330 | |
1405 | /* There is no reason to start on the artifact list at the begining. Lets |
1331 | /* There is no reason to start on the artifact list at the begining. Lets |
1406 | * take our starting position randomly... */ |
1332 | * take our starting position randomly... */ |
1407 | art = al->items; |
1333 | art = al->items; |
1408 | for (i = RANDOM () % level + RANDOM () % 2 + 1; i > 0; i--) |
1334 | for (i = RANDOM () % level + RANDOM () % 2 + 1; i > 0; i--) |
… | |
… | |
1411 | art = al->items; /* hmm, out of stuff, loop back around */ |
1337 | art = al->items; /* hmm, out of stuff, loop back around */ |
1412 | art = art->next; |
1338 | art = art->next; |
1413 | } |
1339 | } |
1414 | |
1340 | |
1415 | /* the base 'generic' name for our artifact */ |
1341 | /* the base 'generic' name for our artifact */ |
1416 | strcpy (name, art_name_array[index].name); |
1342 | assign (name, art_name_array[index].name); |
1417 | |
1343 | |
1418 | /* Ok, lets print out the contents */ |
1344 | /* Ok, lets print out the contents */ |
1419 | sprintf (retbuf, "Herein %s detailed %s...\n", book_entries > 1 ? "are" : "is", book_entries > 1 ? "some artifacts" : "an artifact"); |
1345 | sprintf (retbuf, "Herein %s detailed %s...\n", book_entries > 1 ? "are" : "is", book_entries > 1 ? "some artifacts" : "an artifact"); |
1420 | |
1346 | |
1421 | /* artifact msg attributes loop. Lets keep adding entries to the 'book' |
1347 | /* artifact msg attributes loop. Lets keep adding entries to the 'book' |
… | |
… | |
1465 | * level is kinda high */ |
1391 | * level is kinda high */ |
1466 | if (art->item->msg && (RANDOM () % 4 + 1) < level && !((strlen (art->item->msg) + strlen (buf)) > BOOK_BUF)) |
1392 | if (art->item->msg && (RANDOM () % 4 + 1) < level && !((strlen (art->item->msg) + strlen (buf)) > BOOK_BUF)) |
1467 | strcat (buf, art->item->msg); |
1393 | strcat (buf, art->item->msg); |
1468 | |
1394 | |
1469 | /* properties of the artifact */ |
1395 | /* properties of the artifact */ |
1470 | tmp = get_object (); |
1396 | tmp = object::create (); |
1471 | add_abilities (tmp, art->item); |
1397 | add_abilities (tmp, art->item); |
1472 | tmp->type = type; |
1398 | tmp->type = type; |
1473 | SET_FLAG (tmp, FLAG_IDENTIFIED); |
1399 | SET_FLAG (tmp, FLAG_IDENTIFIED); |
1474 | if ((ch = describe_item (tmp, NULL)) != NULL && strlen (ch) > 1) |
1400 | if ((ch = describe_item (tmp, NULL)) != NULL && strlen (ch) > 1) |
1475 | sprintf (buf, "%s Properties of this artifact include: \n %s \n", buf, ch); |
1401 | sprintf (buf, "%s Properties of this artifact include: \n %s \n", buf, ch); |
1476 | free_object (tmp); |
1402 | tmp->destroy (); |
1477 | /* add the buf if it will fit */ |
1403 | /* add the buf if it will fit */ |
1478 | if (!book_overflow (retbuf, buf, booksize)) |
1404 | if (!book_overflow (retbuf, buf, booksize)) |
1479 | strcat (retbuf, buf); |
1405 | strcat (retbuf, buf); |
1480 | else |
1406 | else |
1481 | break; |
1407 | break; |
… | |
… | |
1525 | * or not), and must be within the valid level range. |
1451 | * or not), and must be within the valid level range. |
1526 | */ |
1452 | */ |
1527 | if (at->clone.type == SPELL && at->clone.path_attuned & pnum && |
1453 | if (at->clone.type == SPELL && at->clone.path_attuned & pnum && |
1528 | ((at->clone.stats.grace && prayers) || (at->clone.stats.sp && !prayers)) && (at->clone.level < (level * 8))) |
1454 | ((at->clone.stats.grace && prayers) || (at->clone.stats.sp && !prayers)) && (at->clone.level < (level * 8))) |
1529 | { |
1455 | { |
1530 | strcpy (tmpbuf, at->clone.name); |
1456 | assign (tmpbuf, at->clone.name); |
1531 | |
1457 | |
1532 | if (book_overflow (retbuf, tmpbuf, booksize)) |
1458 | if (book_overflow (retbuf, tmpbuf, booksize)) |
1533 | break; |
1459 | break; |
1534 | else |
1460 | else |
1535 | { |
1461 | { |
… | |
… | |
1553 | strcat (retbuf, "\n"); |
1479 | strcat (retbuf, "\n"); |
1554 | } |
1480 | } |
1555 | return retbuf; |
1481 | return retbuf; |
1556 | } |
1482 | } |
1557 | |
1483 | |
1558 | |
|
|
1559 | |
|
|
1560 | /* formula_msg() - generate a message detailing the properties |
1484 | /* formula_msg() - generate a message detailing the properties |
1561 | * of a randomly selected alchemical formula. |
1485 | * of a randomly selected alchemical formula. |
1562 | */ |
1486 | */ |
1563 | |
|
|
1564 | void |
1487 | void |
1565 | make_formula_book (object *book, int level) |
1488 | make_formula_book (object *book, int level) |
1566 | { |
1489 | { |
1567 | char retbuf[BOOK_BUF], title[MAX_BUF]; |
1490 | char retbuf[BOOK_BUF], title[MAX_BUF]; |
1568 | recipelist *fl; |
1491 | recipelist *fl; |
… | |
… | |
1670 | |
1593 | |
1671 | book->msg = retbuf; |
1594 | book->msg = retbuf; |
1672 | } |
1595 | } |
1673 | } |
1596 | } |
1674 | |
1597 | |
1675 | |
|
|
1676 | /* msgfile_msg() - generate a message drawn randomly from a |
|
|
1677 | * file in lib/. Level currently has no effect on the message |
|
|
1678 | * which is returned. |
|
|
1679 | */ |
|
|
1680 | |
|
|
1681 | char * |
|
|
1682 | msgfile_msg (int level, int booksize) |
|
|
1683 | { |
|
|
1684 | static char retbuf[BOOK_BUF]; |
|
|
1685 | int i, msgnum; |
|
|
1686 | linked_char *msg = NULL; |
|
|
1687 | |
|
|
1688 | /* get a random message for the 'book' from linked list */ |
|
|
1689 | if (nrofmsg > 1) |
|
|
1690 | { |
|
|
1691 | msg = first_msg; |
|
|
1692 | msgnum = RANDOM () % nrofmsg; |
|
|
1693 | for (i = 0; msg && i < nrofmsg && i != msgnum; i++) |
|
|
1694 | msg = msg->next; |
|
|
1695 | } |
|
|
1696 | |
|
|
1697 | if (msg && !book_overflow (retbuf, msg->name, booksize)) |
|
|
1698 | strcpy (retbuf, msg->name); |
|
|
1699 | else |
|
|
1700 | sprintf (retbuf, "\n <undecipherable text>"); |
|
|
1701 | |
|
|
1702 | #ifdef BOOK_MSG_DEBUG |
|
|
1703 | LOG (llevDebug, "\n info_list_msg() created strng: %d\n", strlen (retbuf)); |
|
|
1704 | LOG (llevDebug, " MADE THIS:\n%s\n", retbuf); |
|
|
1705 | #endif |
|
|
1706 | |
|
|
1707 | return retbuf; |
|
|
1708 | } |
|
|
1709 | |
|
|
1710 | |
|
|
1711 | /* god_info_msg() - generate a message detailing the properties |
1598 | /* god_info_msg() - generate a message detailing the properties |
1712 | * of a random god. Used by the book hack. b.t. |
1599 | * of a random god. Used by the book hack. b.t. |
1713 | */ |
1600 | */ |
1714 | |
|
|
1715 | const char * |
1601 | const char * |
1716 | god_info_msg (int level, int booksize) |
1602 | god_info_msg (int level, int booksize) |
1717 | { |
1603 | { |
1718 | static char retbuf[BOOK_BUF]; |
1604 | static char retbuf[BOOK_BUF]; |
1719 | const char *name = NULL; |
1605 | const char *name = NULL; |
… | |
… | |
1755 | const char *enemy = god->title; |
1641 | const char *enemy = god->title; |
1756 | |
1642 | |
1757 | if (enemy) |
1643 | if (enemy) |
1758 | sprintf (buf, "The gods %s and %s are enemies.\n ---\n", name, enemy); |
1644 | sprintf (buf, "The gods %s and %s are enemies.\n ---\n", name, enemy); |
1759 | } |
1645 | } |
|
|
1646 | |
1760 | if (level == 3 && RANDOM () % 2) |
1647 | if (level == 3 && RANDOM () % 2) |
1761 | { /* enemy race, what the god's holy word effects */ |
1648 | { /* enemy race, what the god's holy word effects */ |
1762 | const char *enemy = god->slaying; |
1649 | const char *enemy = god->slaying; |
1763 | |
1650 | |
1764 | if (enemy && !(god->path_denied & PATH_TURNING)) |
1651 | if (enemy && !(god->path_denied & PATH_TURNING)) |
… | |
… | |
1773 | else |
1660 | else |
1774 | sprintf (tmpbuf, "race of%s", strtoktolin (enemy, ",")); |
1661 | sprintf (tmpbuf, "race of%s", strtoktolin (enemy, ",")); |
1775 | sprintf (buf, "%s%s\n ---\n", buf, tmpbuf); |
1662 | sprintf (buf, "%s%s\n ---\n", buf, tmpbuf); |
1776 | } |
1663 | } |
1777 | } |
1664 | } |
|
|
1665 | |
1778 | if (level == 4 && RANDOM () % 2) |
1666 | if (level == 4 && RANDOM () % 2) |
1779 | { /* Priest of god gets these protect,vulnerable... */ |
1667 | { /* Priest of god gets these protect,vulnerable... */ |
1780 | char tmpbuf[MAX_BUF], *cp; |
1668 | char tmpbuf[MAX_BUF]; |
1781 | |
1669 | |
1782 | cp = describe_resistance (god, 1); |
1670 | if (const char *cp = describe_resistance (god, 1)) |
1783 | |
|
|
1784 | if (*cp) |
|
|
1785 | { /* This god does have protections */ |
1671 | { /* This god does have protections */ |
1786 | sprintf (tmpbuf, "%s has a potent aura which is extended\n", name); |
1672 | sprintf (tmpbuf, "%s has a potent aura which is extended\n", name); |
1787 | strcat (tmpbuf, "faithful priests. The effects of this aura include:\n"); |
1673 | strcat (tmpbuf, "faithful priests. The effects of this aura include:\n"); |
1788 | strcat (tmpbuf, cp); |
1674 | strcat (tmpbuf, cp); |
1789 | strcat (buf, tmpbuf); |
1675 | strcat (buf, tmpbuf); |
1790 | strcat (buf, "\n ---\n"); |
1676 | strcat (buf, "\n ---\n"); |
1791 | } |
1677 | } |
1792 | else |
1678 | else |
1793 | sprintf (buf, " "); |
1679 | sprintf (buf, " "); |
1794 | } |
1680 | } |
|
|
1681 | |
1795 | if (level == 5 && RANDOM () % 2) |
1682 | if (level == 5 && RANDOM () % 2) |
1796 | { /* aligned race, summoning */ |
1683 | { /* aligned race, summoning */ |
1797 | const char *race = god->race; /* aligned race */ |
1684 | const char *race = god->race; /* aligned race */ |
1798 | |
1685 | |
1799 | if (race && !(god->path_denied & PATH_SUMMON)) |
1686 | if (race && !(god->path_denied & PATH_SUMMON)) |
… | |
… | |
1807 | else |
1694 | else |
1808 | sprintf (tmpbuf, "race of%s", strtoktolin (race, ",")); |
1695 | sprintf (tmpbuf, "race of%s", strtoktolin (race, ",")); |
1809 | sprintf (buf, "%s%s\n ---\n", buf, tmpbuf); |
1696 | sprintf (buf, "%s%s\n ---\n", buf, tmpbuf); |
1810 | } |
1697 | } |
1811 | } |
1698 | } |
|
|
1699 | |
1812 | if (level == 6 && RANDOM () % 2) |
1700 | if (level == 6 && RANDOM () % 2) |
1813 | { /* blessing,curse properties of the god */ |
1701 | { /* blessing,curse properties of the god */ |
1814 | char tmpbuf[MAX_BUF], *cp; |
1702 | char tmpbuf[MAX_BUF]; |
1815 | |
1703 | |
1816 | cp = describe_resistance (god, 1); |
1704 | if (const char *cp = describe_resistance (god, 1)) |
1817 | |
|
|
1818 | if (*cp) |
|
|
1819 | { /* This god does have protections */ |
1705 | { /* This god does have protections */ |
1820 | sprintf (tmpbuf, "\nThe priests of %s are known to be able to \n", name); |
1706 | sprintf (tmpbuf, "\nThe priests of %s are known to be able to \n", name); |
1821 | strcat (tmpbuf, "bestow a blessing which makes the recipient\n"); |
1707 | strcat (tmpbuf, "bestow a blessing which makes the recipient\n"); |
1822 | strcat (tmpbuf, cp); |
1708 | strcat (tmpbuf, cp); |
1823 | strcat (buf, tmpbuf); |
1709 | strcat (buf, tmpbuf); |
… | |
… | |
1825 | } |
1711 | } |
1826 | else |
1712 | else |
1827 | sprintf (buf, " "); |
1713 | sprintf (buf, " "); |
1828 | |
1714 | |
1829 | } |
1715 | } |
|
|
1716 | |
1830 | if (level == 8 && RANDOM () % 2) |
1717 | if (level == 8 && RANDOM () % 2) |
1831 | { /* immunity, holy possession */ |
1718 | { /* immunity, holy possession */ |
1832 | int has_effect = 0, tmpvar; |
1719 | int has_effect = 0, tmpvar; |
1833 | char tmpbuf[MAX_BUF]; |
1720 | char tmpbuf[MAX_BUF]; |
1834 | |
1721 | |
… | |
… | |
1843 | { |
1730 | { |
1844 | has_effect = 1; |
1731 | has_effect = 1; |
1845 | sprintf (tmpbuf + strlen (tmpbuf), "Immunity to %s", attacktype_desc[tmpvar]); |
1732 | sprintf (tmpbuf + strlen (tmpbuf), "Immunity to %s", attacktype_desc[tmpvar]); |
1846 | } |
1733 | } |
1847 | } |
1734 | } |
|
|
1735 | |
1848 | if (has_effect) |
1736 | if (has_effect) |
1849 | { |
1737 | { |
1850 | strcat (buf, tmpbuf); |
1738 | strcat (buf, tmpbuf); |
1851 | strcat (buf, "\n ---\n"); |
1739 | strcat (buf, "\n ---\n"); |
1852 | } |
1740 | } |
1853 | else |
1741 | else |
1854 | sprintf (buf, " "); |
1742 | sprintf (buf, " "); |
1855 | } |
1743 | } |
|
|
1744 | |
1856 | if (level == 12 && RANDOM () % 2) |
1745 | if (level == 12 && RANDOM () % 2) |
1857 | { /* spell paths */ |
1746 | { /* spell paths */ |
1858 | int has_effect = 0, tmpvar; |
1747 | int has_effect = 0, tmpvar; |
1859 | char tmpbuf[MAX_BUF]; |
1748 | char tmpbuf[MAX_BUF]; |
1860 | |
1749 | |
1861 | sprintf (tmpbuf, "\n"); |
1750 | sprintf (tmpbuf, "\n"); |
1862 | sprintf (tmpbuf, "It is rarely known fact that the priests of %s\n", name); |
1751 | sprintf (tmpbuf, "It is rarely known fact that the priests of %s\n", name); |
1863 | strcat (tmpbuf, "are mystically transformed. Effects of this include:\n"); |
1752 | strcat (tmpbuf, "are mystically transformed. Effects of this include:\n"); |
|
|
1753 | |
1864 | if ((tmpvar = god->path_attuned)) |
1754 | if ((tmpvar = god->path_attuned)) |
1865 | { |
1755 | { |
1866 | has_effect = 1; |
1756 | has_effect = 1; |
1867 | DESCRIBE_PATH (tmpbuf, tmpvar, "Attuned"); |
1757 | DESCRIBE_PATH (tmpbuf, tmpvar, "Attuned"); |
1868 | } |
1758 | } |
|
|
1759 | |
1869 | if ((tmpvar = god->path_repelled)) |
1760 | if ((tmpvar = god->path_repelled)) |
1870 | { |
1761 | { |
1871 | has_effect = 1; |
1762 | has_effect = 1; |
1872 | DESCRIBE_PATH (tmpbuf, tmpvar, "Repelled"); |
1763 | DESCRIBE_PATH (tmpbuf, tmpvar, "Repelled"); |
1873 | } |
1764 | } |
|
|
1765 | |
1874 | if ((tmpvar = god->path_denied)) |
1766 | if ((tmpvar = god->path_denied)) |
1875 | { |
1767 | { |
1876 | has_effect = 1; |
1768 | has_effect = 1; |
1877 | DESCRIBE_PATH (tmpbuf, tmpvar, "Denied"); |
1769 | DESCRIBE_PATH (tmpbuf, tmpvar, "Denied"); |
1878 | } |
1770 | } |
|
|
1771 | |
1879 | if (has_effect) |
1772 | if (has_effect) |
1880 | { |
1773 | { |
1881 | strcat (buf, tmpbuf); |
1774 | strcat (buf, tmpbuf); |
1882 | strcat (buf, "\n ---\n"); |
1775 | strcat (buf, "\n ---\n"); |
1883 | } |
1776 | } |
… | |
… | |
1891 | */ |
1784 | */ |
1892 | if (book_overflow (retbuf, buf, booksize)) |
1785 | if (book_overflow (retbuf, buf, booksize)) |
1893 | break; |
1786 | break; |
1894 | else if (strlen (buf) > 1) |
1787 | else if (strlen (buf) > 1) |
1895 | strcat (retbuf, buf); |
1788 | strcat (retbuf, buf); |
|
|
1789 | |
1896 | level--; |
1790 | level--; |
1897 | } |
1791 | } |
|
|
1792 | |
1898 | if (strlen (retbuf) == introlen) |
1793 | if (strlen (retbuf) == introlen) |
1899 | { /* we got no information beyond the preamble! */ |
1794 | { /* we got no information beyond the preamble! */ |
1900 | strcat (retbuf, " [Unfortunately the rest of the information is\n"); |
1795 | strcat (retbuf, " [Unfortunately the rest of the information is\n"); |
1901 | strcat (retbuf, " hopelessly garbled!]\n ---\n"); |
1796 | strcat (retbuf, " hopelessly garbled!]\n ---\n"); |
1902 | } |
1797 | } |
… | |
… | |
1921 | * book is the object we are creating into. |
1816 | * book is the object we are creating into. |
1922 | * If msg_type is a positive value, we use that to determine the |
1817 | * If msg_type is a positive value, we use that to determine the |
1923 | * message type - otherwise a random value is used. |
1818 | * message type - otherwise a random value is used. |
1924 | * |
1819 | * |
1925 | */ |
1820 | */ |
1926 | |
|
|
1927 | void |
1821 | void |
1928 | tailor_readable_ob (object *book, int msg_type) |
1822 | tailor_readable_ob (object *book, int msg_type) |
1929 | { |
1823 | { |
1930 | char msgbuf[BOOK_BUF]; |
1824 | char msgbuf[BOOK_BUF]; |
1931 | int level = book->level ? (RANDOM () % book->level) + 1 : 1; |
1825 | int level = book->level ? (RANDOM () % book->level) + 1 : 1; |
… | |
… | |
1954 | */ |
1848 | */ |
1955 | |
1849 | |
1956 | msg_type = msg_type > 0 ? msg_type : (RANDOM () % 6); |
1850 | msg_type = msg_type > 0 ? msg_type : (RANDOM () % 6); |
1957 | switch (msg_type) |
1851 | switch (msg_type) |
1958 | { |
1852 | { |
1959 | case 1: /* monster attrib */ |
1853 | case 1: /* monster attrib */ |
1960 | strcpy (msgbuf, mon_info_msg (level, book_buf_size)); |
1854 | strcpy (msgbuf, mon_info_msg (level, book_buf_size)); |
1961 | break; |
1855 | break; |
1962 | case 2: /* artifact attrib */ |
1856 | case 2: /* artifact attrib */ |
1963 | strcpy (msgbuf, artifact_msg (level, book_buf_size)); |
1857 | strcpy (msgbuf, artifact_msg (level, book_buf_size)); |
1964 | break; |
1858 | break; |
1965 | case 3: /* grouping incantations/prayers by path */ |
1859 | case 3: /* grouping incantations/prayers by path */ |
1966 | strcpy (msgbuf, spellpath_msg (level, book_buf_size)); |
1860 | strcpy (msgbuf, spellpath_msg (level, book_buf_size)); |
1967 | break; |
1861 | break; |
1968 | case 4: /* describe an alchemy formula */ |
1862 | case 4: /* describe an alchemy formula */ |
1969 | make_formula_book (book, level); |
1863 | make_formula_book (book, level); |
1970 | /* make_formula_book already gives title */ |
1864 | /* make_formula_book already gives title */ |
1971 | return; |
1865 | return; |
1972 | break; |
1866 | break; |
1973 | case 5: /* bits of information about a god */ |
1867 | case 5: /* bits of information about a god */ |
1974 | strcpy (msgbuf, god_info_msg (level, book_buf_size)); |
1868 | strcpy (msgbuf, god_info_msg (level, book_buf_size)); |
1975 | break; |
1869 | break; |
1976 | case 0: /* use info list in lib/ */ |
1870 | case 0: /* use info list in lib/ */ |
1977 | default: |
1871 | default: |
1978 | strcpy (msgbuf, msgfile_msg (level, book_buf_size)); |
1872 | cfperl_make_book (book, level); |
1979 | break; |
1873 | return; |
1980 | } |
1874 | } |
1981 | |
1875 | |
1982 | strcat (msgbuf, "\n"); /* safety -- we get ugly map saves/crashes w/o this */ |
1876 | strcat (msgbuf, "\n"); /* safety -- we get ugly map saves/crashes w/o this */ |
|
|
1877 | |
1983 | if (strlen (msgbuf) > 1) |
1878 | if (strlen (msgbuf) > 1) |
1984 | { |
1879 | { |
1985 | book->msg = msgbuf; |
1880 | book->msg = msgbuf; |
1986 | /* lets give the "book" a new name, which may be a compound word */ |
1881 | /* lets give the "book" a new name, which may be a compound word */ |
1987 | change_book (book, msg_type); |
1882 | change_book (book, msg_type); |
… | |
… | |
2016 | delete title1; |
1911 | delete title1; |
2017 | } |
1912 | } |
2018 | |
1913 | |
2019 | delete tlist; |
1914 | delete tlist; |
2020 | } |
1915 | } |
|
|
1916 | |
2021 | for (lmsg = first_msg; lmsg; lmsg = nextmsg) |
1917 | for (lmsg = first_msg; lmsg; lmsg = nextmsg) |
2022 | { |
1918 | { |
2023 | nextmsg = lmsg->next; |
1919 | nextmsg = lmsg->next; |
2024 | delete lmsg; |
1920 | delete lmsg; |
2025 | } |
1921 | } |
|
|
1922 | |
2026 | for (monlink = first_mon_info; monlink; monlink = nextmon) |
1923 | for (monlink = first_mon_info; monlink; monlink = nextmon) |
2027 | { |
1924 | { |
2028 | nextmon = monlink->next; |
1925 | nextmon = monlink->next; |
2029 | free (monlink); |
1926 | delete monlink; |
2030 | } |
1927 | } |
2031 | } |
1928 | } |
2032 | |
1929 | |
2033 | |
1930 | |
2034 | /***************************************************************************** |
1931 | /***************************************************************************** |