═══ 1. Generel hjСlp til Yatzy ═══ Dette program er en computer-udgave af yatzyspillet. For at fЖ en oversigt over spillet og dets muligheder, vСlg da Indholdsfortegnelse i punktet Tilpasning i funktionslinien eller tryk pЖ Ctrl+C. For at fЖ en oversigt over Yatzys spilleregler, vСlg spilleregler. ═══ 1.1. Spillepladen ═══ Hver spiller forsynes med en spilleplade, som dels viser spillerens egne terninger og point, men ogsЖ alle de andre spilleres terninger og point. Spillepladen fremkaldes ved at starte programmet YATZYNET.EXE. NЖr dette program startes, er det vigtigt, at det aktive bibliotek er det, hvori programmet er placeret. Hvis man lСgger opstarten af programmet ind i en gruppe-menu er det ligeledes vigtigt, at man husker at specificere biblioteksnavnet korrekt i indtastningsfeltet "Arbejdsbibliotek". Spillepladen er et vindue, som er indeholder en rСkke undervinduer. Hvert af disse undervinduer viser en deltagende spillers terninger og pointtavle. Disse undervinduer er selvstСndige og kan frit manipuleres, f.eks. minimeres. Bortset fra ens eget vindue kan man dog ikke spille pЖ dem. Man spiller pЖ sit eget undervindue, som standard er placeret til venstre pЖ spillepladen. Spillet foregЖr normalt ved at manipulere terningerne med musen, men det kan ogsЖ foregЖ udelukkende ved hjСlp af tastaturet. Se under tastehjСlp for en beskrivelse af tasternes betydning. Beskrivelsen af hvordan man terningerne vСlges og fravСlges samt af hvordan man kaster, findes i punktet terninger. Samtidig med at man selv spiller, kan de andre spillere ogsЖ spille. Der er altsЖ ikke noget med at det er ens "tur", medmindre spillerne selv bliver enige om det. SЖsnart en spiller foretager sig noget i sit undervindue, afspejles dette pЖ de andre spilleres udgave af undervinduet. Alle kan derfor lЫbende holde sig orienteret om spillets udvikling. Det er ikke nЫdvendigt at alle deltagere starter pЖ samme tid. En spiller kan godt begynde efter at nogle eller alle andre er fСrdige. Spillet er afsluttet nЖr alle deltagere har fЖet placeret et kast i alle pointkategorier. FЫr et nyt spil kan pЖbegyndes, skal server-programmet afsluttes og startes igen. ═══ 1.2. Spil pЖ Вn computer ═══ Spillet er beregnet pЖ at skulle foregЖ med Вn spilleplade pЖ hver deltagers egen computer. Man kan dog godt oprette alle spilleplader pЖ Вn computer, men i dette tilfСlde skal server-programmet udfЫres pЖ denne computer ogsЖ, og ikke som normalt pЖ LAN-serveren. Desuden skal man ikke angive et servernavn i dialogkassen IndsСt spiller. ═══ 1.3. Sprog ═══ Normalt starter programmet i det sprog, som OS/2 har fЖet opgivet for denne maskine. Hvis det pЖgСldende sprog ikke er understЫttet benyttes engelsk. Man kan eksplicit bede om et andet sprog end det normale ved at give sprogkoden som parameter nЖr programmet startes. F.eks. vil nedenstЖende kommando fЖ programmet til at kЫre pЖ engelsk, ogsЖ pЖ en dansk computer: YATZYNET 1 De forskellige landes sprogkoder er normalt lig med deres internationale telefon-retningsnummer. Nedenfor nСvnes nogle eksempler: Land Landekode Belgien 32 Danmark 45 Frankrig 33 Tyskland 49 Italien 39 Holland 31 Norge 47 Spanien 34 Sverige 46 Schweiz 41 BemСrk: Kun engelsk og dansk understЫttes p.t. Hvis nogle vil oversСtte det til andre sprog, sЖ kontakt mig venligst pЖ adressen nСvnt i Credits. ═══ 1.4. BegrСnsninger ═══ Spillet tillader op til ti samtidige spillere at deltage i spillet. Hvis programmet er minimeret mens der indsСttes spillere pЖ andre computere, vil deres vinduer blive placeret under hinanden pЖ spillepladen. ═══ 1.5. Information for programmЫrer ═══ Programmet benytter sig af en lang rСkke af unikke OS/2-muligheder, sЖsom hjemmelavede kontroller (terninger og sСt af terninger), flere threads (i server-programmet), Information Processing Facility (denne hjСlp), Named Pipes (kommunikation mellem spilleplader og server-programmet), Dynamic Link Libraries (til forskellige sprogafhСngige ressourcer), National Language Support, brug af user profiles (til at gemme spiller- og servernavn), Common User Access Multiple Document Interface, fortrydelses-mulighed o.s.v. Det blev kodet ved hjСlp af IBM's Programming Tools and Information version 1.2 og IBM's C/2 version 1.1. Editoren var IBM's Live Parsing Editor. Systemudviklingen foregik pЖ en IBM Portable P70-061 med 4MB intern hukommelse. Operativsystemet var IBM's OS/2 Standard Edition 1.2. BemСrk, at programmet, som er beregnet til et LAN-miljЫ, er udarbejdet pЖ en stand-alone PC uden LAN-faciliteter. Eftersom sЖ mange af facetter af OS/2 er benyttet, er programmet udmСrket til at illustrere de potentialer, som OS/2 besidder. En klar anvendelse af programmet, ved siden af selve spillet, er sЖledes som et skoleeksempel pЖ OS/2's spСndvidde. Hvis der er spЫrgsmЖl eller kommantarer til spillets programmering, send dem da venligst til adressen nСvnt i Credits. ═══ 2. TastehjСlp til Yatzy ═══ NedenstЖende taster kan benyttes under spillet: Tast Funktion Ctrl+I IndsСt spiller Ctrl+O OverfЫr kast Ctrl+U Udgangsstilling Ctrl+T Terninger F10 SСt fokus til funktionslinien Taster til brug for kast og udvСlgelse af terninger: Tast Funktion Mellemrumstangent Skift mellem at terningen med fokus er valgt eller fravalgt Piltasterne Flyt fokus mellem terningerne Enter Kast de terninger som p.t. er valgt. BemСrk, at den terning som har fokus altid vСlges og deltager i kastet ogsЖ selvom den pЖ tidspunktet for kastet er fravalgt Andre taster: Tast Funktion Alt+ Fremkald kategorier i dialogkassen OverfЫr kast Foruden de her nСvnte taster kan en rСkke af OS/2's normale taster benyttes - f.eks. F1 for hjСlp. ═══ 3. HjСlp til menuvalg ═══ I dette punkt findes hjСlpen til de enkelte menuvalg i spillet. ═══ 3.1. Spil ═══ Her vСlges der mellem en rСkke punkter, som styrer gennemfЫrelsen af spillet. Se hjСlpen til de enkelte punkter for en nСrmere beskrivelse af dem. ═══ 3.1.1. IndsСt spiller ═══ Aktiveres dette punkt kan man oprette en spiller ved at angive hans eller hendes navn. Hvis der spilles i et LAN-miljЫ, skal navnet pЖ den maskine hvor server-programmet udfЫres, ligeledes angives. Der kan kun indsСttes Вn spiller pr. spilleplade. NЖr dette er sket grЖtones feltet, sЖ det ikke igen kan vСlges. ═══ 3.1.2. OverfЫr kast ═══ Aktiveres dette punkt, kan man overfЫre sit kast til pointtavlen. Punktet kan ikke benyttes fЫr at terningerne er kastet mindst Вn gang efter start eller overfЫrsel til pointtavlen. ═══ 3.1.3. Fortryd overfЫrsel ═══ I dette punkt kan man fortryde en overfЫrsel af et kast til pointtavlen. Efter at have valgt punktet befinder man sig i samme situation som fЫr overfЫrslen af point fandt sted. Dette indebСrer, at hvis man havde et eller to kast tilbage, kan disse nu udfЫres. BemСrk: Punktet kan kun benyttes, nЖr den umiddelbart foregЖende handling var en overfЫrsel af et kast til pointtavlen. Hvis man f.eks. i mellemtiden har udfЫrt en Udgangsstilling, er fortryd overfЫrsel sat ud af kraft. ═══ 3.1.4. Udgangsstilling ═══ Aktiveres dette punkt fjernes alle udvСlgelser af terninger og de stilles alle til enere. Dette punkt kan kun benyttes umiddelbart efter at et kast er overfЫrt til pointtavlen. ═══ 3.2. Vindue ═══ I dette punkts rullegardin kan der dels vСlges mellem ens egne terninger og de andre spilleres spilleplader. Punktet er medtaget for at gЫre programmet uafhСngigt af en mus. ═══ 3.2.1. Terninger ═══ Aktiveres dette punkt, gives ens egne terninger fokus. Punktet er medtaget for at gЫre programmet uafhСngigt af en mus. ═══ 3.2.2. Programinformation ═══ Aktiveres dette punkt, vises programmets logo. ═══ 4. Dialogkasser ═══ HjСlp til spillets dialogkasser ═══ 4.1. IndsСt spiller ═══ HjСlp til felterne i dialogkassen IndsСt spiller. ═══ 4.1.1. Spillernavn ═══ I dette felt angives spillerens navn. Navnet giver andre spillere mulighed for at identificere de enkelte deltagere i spillet. To eller flere spillere kan godt have samme navn, men det anbefales at sЫrge for unikke navne. Der er plads til max. 39 karakterer i navnet og det huskes fra gang til gang. ═══ 4.1.2. Servernavn ═══ Hvis der skal spilles i et LAN-miljЫ, skal server-programmet vСre startet pЖ LAN-serveren. Denne servers identifikation skal angives i dette felt. Hvis man er i tvivl om hvilke servernavne, der findes, kan man udstede NET VIEW-kommandoen. Yderligere oplysninger kan fЖes hos den lokale netvСrks-administrator eller i manualen OS/2 LAN Server Network Administrators Guide. Navnet kan indeholde op til otte karakterer og det huskes fra gang til gang. ═══ 4.2. OverfЫr kast ═══ I denne dialogkasse angives, hvor man Ыnsker at placere sit kast. Der kan kun vСlges mellem endnu ikke valgte kategorier. Programmet foreslЖr en kategori, men hvis denne Ыnskes byttet med en anden, kan man fremkalde de mulige kategorier pЖ skСrmen. Dette sker enten ved at klikke pЖ den nedadgЖende pil til hЫjre for teksten eller ved at trykke pЖ Alt+pil ned. Dette medfЫrer, at der vises en liste med de mulige kategorier. OverfЫrslen kan evt. fortrydes ved at vСlge Fortryd overfЫrsel. ═══ 5. Server-programmet ═══ Dette program er knudepunktet i kommunikationen mellem de enkelte spilleplader, hvadenten spillet foregЖr pЖ Вn eller flere computere. I det sidstnСvnte tilfСlde, skal programmet udfЫres pЖ serveren i lokalnetvСrket. Server-programmets navn er YASERVER.EXE. Server-programmet skal vСre startet fЫr den fЫrste spiller kan indsСttes. Efter at server-programmet er startet, venter det pЖ den fЫrste indsСttelse. Hvis det ikke inden to minutter har modtaget en indsСttelse, afbryder det sig selv. Efter at den sidste spiller har afsluttet sit spil og lukket sin udgave af spillepladen, afslutter det sig selv. Hvis der er mindst Вn spiller som har en Жben spilleplade tillader server-programmet op til femten minutters inaktivitet fЫr det afbryder sig selv. Server-programmet kan startes fra en vilkЖrlig klient-computer ved hjСlp af NET RUN-kommandoen. Det aktive drev skal vСre det netvСrksdrev, hvorpЖ server-programmet er placeret. For yderligere oplysninger om dette, kontakt den lokale netvСrks-administrator eller kig i manualen OS/2 LAN Server Network Administrators Guide. Server-programmet skriver lЫbende i sit vindue nЖr en spiller indsСttes eller afslutter. Hvis en mere detaljeret information om spillets gang Ыnskes, kan der angives et vilkЖrligt argument til programmet, nЖr det startes. F.eks. vil nedenstЖende kommando give fuld information om de meddelelser der sendes til og fra server-programmet: YASERVER 1 ═══ 6. Spilleregler for Yatzy ═══ Yatzy spilles med fem terninger og den spiller, som har flest point nЖr spillet er afsluttet, har vundet. Spillet foregЖr i femten runder pr. spiller. For hver runde har spilleren indtil tre slag efter eget valg. Mellem slagene kan spilleren fravСlge et vilkЖrligt antal terninger. Efter det fЫrste eller andet slag kan spilleren overfЫre slaget til en pointkategori, men efter det tredje slag, skal det overfЫres. En terning kan godt indgЖ i et senere slag i samme runde selvom den tidligere har vСret fravalgt. Der er femten pointkategorier og hver spillerunde resulterer i, at Вn af dem bliver udfyldt, eventuelt med nul. Der kan kun overfЫres et slag til en given kategori Вn gang. I visse tilfСlde kan den sidste overfЫrsel dog fortrydes, se punktet Fortryd overfЫrsel. Som hovedregel gСlder, at nЖr der overfЫres et slag til en kategori, tСlles det antal Ыjne i slaget, som findes pЖ de terninger der indgЖr i navnet pЖ kategorien. Kun Yatzy er en undtagelse fra dette. De Ыverste seks kategorier benСvnes Enere, Toere, Treere, Firere, Femmere og Seksere. For hver af dem gСlder, at kun de tilsvarende terninger i det slag der overfЫres, tСlles med ved pointtildelingen. Hvis f.eks. et slag med to treere, en firer, en femmer og en sekser overfЫres til kategorien Treere, opnЖs 2 gange 3 lig 6 point. Hvis slaget to treere, en firer og to seksere overfЫres til kategorien Seksere opnЖs 12 point. For disse seks Ыverste kategorier kan der opnЖs en bonus pЖ 50 point, hvis summen af deres point overstiger 62. Dette svarer til, at man har gennemsnitlig tre terninger i hver kategori. Indtil der er overfЫrt en vСrdi til alle de seks Ыverste kategorier holder spillets bonus-linie regnskab med om der er over- eller underskud pЖ dette gennemsnit. NЖr alle disse kategorier er udfyldt, angiver bonuslinien summen af pointene, inclusiv en eventuel bonus. De nСste fire pointkategorier benСvnes Et par, To par, Tre ens og Fire ens. Hvis der overfЫres slag til disse kategorier tildeles der point i overensstemmelse med kategoriens navn. F.eks. vil slaget to firere, en femmer og to seksere overfЫrt til Et par give 2 gange 6 lig 12 point, idet det hЫjeste af de to par vСlges. Det tilsvarende slag vil give 20 point (summen af 2 gange 4 og 2 gange 6), hvis det overfЫres til kategorien To par. BemСrk: Hvis et slag med fire ens overfЫres til To par, vil dette resultere i nul point. De to nСste kategorier er henholdsvis Lille og Stor. Lille giver 15 point, hvis de fem terninger, som overfЫres viser 1, 2, 3, 4 og 5 i vilkЖrlig rСkkefЫlge. Stor giver 20 point, hvis eneren i det fЫrnСvnte slag er byttet ud med en sekser. Kategorien Fuldt hus giver point, hvis slaget, der overfЫres, indeholder to af Вn slags og tre af en anden slags. F.eks. vil et slag, som bestЖr af tre enere og to femmere give summen af 3 gange 1 og 2 gange 5 lig 13 point. BemСrk: Hvis et slag med fem ens overfЫres til Fuldt hus, vil dette resultere i nul point. Den efterfЫlgende kategori benСvnes Chancen, og giver summen af de terninger, som indgЖr i det overfЫrte slag. Hvis f.eks. et slag indeholdende terningerne 1, 2, 3, 4 og 6 overfЫres, vil dette resultere i 16 point. Et slag, som overfЫres til Chancen vil altid give point. Den sidste pointkategori er ogsЖ den som giver navn til spillet nemlig Yatzy. Hvis et slag med fem ens terninger overfЫres til denne kategori gives der 50 point. Dette sker uanset terningernes vСrdi. ═══ 7. LokalnetvСrk ═══ LAN er et akronym for Local Area Network, pЖ dansk lokalnetvСrk. Dette er betegnelsen for en rСkke selvstСndige computere, eller clients, som er forbundet til en central vСrtscomputer, eller server, via hЫjhastighedsforbindelser. Yatzy-spillets server-program (YASERVER.EXE) skal udfЫres pЖ serveren i lokalnetvСrket, og navnet pЖ servermaskinen skal angives, nЖr yatzy-spillets client-program (YATZYNET.EXE) udfЫres pЖ de enkelte computere i lokalnetvСrket. ═══ 8. Terningerne ═══ I yatzy-spillet indgЖr fem terninger. Se punktet spilleregler for en nСrmere beskrivelse af terningernes betydning. Man kan skifte mellem om en terning er valgt eller fravalgt ved at klikke pЖ den med mustast 1 (pegefingerens mustast). NЖr terningen er fravalgt skifter den ikke vСrdi nСste gang man kaster terningerne. En fravalgt terning er markeret med et kryds. Man kan kaste de valgte terninger ved at dobbeltklikke med mustast 1 pЖ en vilkЖrlig terning. BemСrk: Den terning man dobbeltklikker pЖ, vСlges altid og indgЖr derved i kastet. I visse situationer tillader spillet ikke, at man manipulerer med terningerne - f.eks. nЖr man har benyttet alle tre kast. De vil da vСre grЖtonede. I andre situationer - efter at have overfЫrt et kast eller sat til udgangsstilling - er det ikke muligt at fravСlge terninger. Hvis man Ыnsker at benytte tastaturet i stedet for musen til at manipulere terningerne kan dette ogsЖ lade sig gЫre. Se under punktet TastehjСlp. ═══ 9. Credits ═══ Dette program er udarbejdet i perioden oktober til december 1990 af Peder Madsen. Forskellige mennesker har mere eller mindre indirekte bidraget til udarbejdelsen af programmet og fortjener at blive nСvnt: Server-programmet har sit udgangspunkt i en artikel i IBM's blad Personal Systems Developer fra vinteren 1990 med titlen "A Multi-User Server Using Named Pipes". Artiklen er skrevet af Bryan Jackson fra firmaet XcelleNet, Inc., Atlanta, USA. Udviklingen af terningerne er inspireret af en artikel i IBM Systems Journal vol. 29, No. 1, 1990 med titlen "Effective application development for Presentation Manager programs" af Susan Franklin og Tony Peters. Inspiration er ogsЖ hentet fra en DOS-udgave af Yatzy-spillet skrevet af BjЫrn Krogh. Tak til min kone Mette og mine dЫtre Vibe og Helene, som har tilbragt mange aftener alene, mens jeg har arbejdet pЖ programmet. Hvis du benytter spillet, send da venligst mindst 100 kr. til Peder Madsen Dalgas Have 68, st. t.v. 2000 Frederiksberg Gironummer 8 00 06 62 Du vil derved ogsЖ sikre dig mulighed for at fЖ eventuelle nye versioner eller andre programmer, som jeg udarbejder. Send venligst ogsЖ eventuelle kommentarer og fejlrapporter til ovennСvnte adresse. Programmet er frit tilgСngeligt og kan ikke gЫres til genstand for salg, udlejning eller lignende kommercielle transaktioner. Installation af programmet er pЖ eget ansvar og forfatteren pЖtager sig intet ansvar for eventuelle skader pЖ brugerens computer eller data. Copyright (c) 1990 by Peder Madsen. ═══ ═══ Pointtavlen er den hЫjre del af den enkelte spillers vindue. Den holder hele tiden regnskab med spillerens point i de enkelte kategorier. Nederst er der et total-felt, som indeholder summen af spillerens point til enhver tid. I denne total er indregnet eventuelle bonus-point. Linien med bonus-kategorien (nr. syv fra oven) kan befinde sig i to forskellige tilstande: Hvis der er overfЫrt point til de seks Ыverste kategorier, angiver bonuslinien om der gives bonus for disse kategorier. Hvis ikke alle kategorier har modtaget point, angiver bonuslinien den Ыjeblikkelige status. Et negativt tal indebСrer, at hvis bonus skulle afgЫres nu, ville den ikke blive tildelt, mens nul eller et positivt tal angiver, at bonus ville blive tildelt. Se under Spilleregler for en nСrmere forklaring pЖ, under hvilke forhold bonus tildeles.