BBO-logo

Handviewer documentatie

Introductie

Het Handviewer-programma, ontwikkeld door Bridge Base Online, kan worden gebruikt om verschillende soorten aantrekkelijkheden te creëren bridge presentaties op webpagina's. Elke website is welkom om dit programma te gebruiken voor niet-commercieel gebruik. Wij zijn van mening dat dit programma goed werkt, maar uw aantal kilometers kan variëren. We garanderen niets.

U mag dit programma niet voor commerciële doeleinden gebruiken zonder schriftelijke toestemming van Bridge Basis online.

U heeft geen toestemming om dit programma te wijzigen of kopieën ervan op uw eigen server te plaatsen.

Het Handviewer-programma kan worden uitgevoerd in elke browser die Javascript ondersteunt (en waarop Javascript is ingeschakeld). Dit omvat de browsers die zijn geïnstalleerd op bijvoorbeeld de iPhone en G1 mobiele telefoons (en natuurlijk ook elke moderne browser op elke moderne computer).

Wat voor soort bridge presentaties kan de Handviewer weergeven?

  • Enkele handen
  • Handparen voor 2 richtingen (Noord + Zuid, Oost + West, West + Noord, etc.)
  • Bieddiagrammen
  • Enkele handen (of paar handen) met bieddiagrammen
  • Alle vier de handen
  • A "bridge film '(alle 4 de handen waarin de kaarten kunnen worden gespeeld)

Het Handviewer-programma insluiten in een webpagina

Voor de meeste webpublicatiedoeleinden is het logisch om de Handviewer-applicatie in een webpagina in te sluiten. De eenvoudigste manier om dit te doen, is door een iframe te gebruiken. De HTML om dit te doen zou er ongeveer zo uit moeten zien: wat ongeveer zo zal produceren:

Webuitgevers kunnen de hoeveelheid ruimte specificeren die een bepaald exemplaar van de Handviewer zal innemen door de hoogte en breedte van het iframe in te stellen (respectievelijk 350 pixels en 200 pixels in het bovenstaande voorbeeld). Het Handviewer-programma zal zichzelf verkleinen zodat het past in de ruimte die u ervoor geeft.

Afzonderlijke webpagina's kunnen meerdere iframes bevatten, elk met een instantie van het Handviewer-programma.

Het Handviewer-programma oproepen

Het Handviewer-programma bevindt zich op deze URL:

https://www.bridgebase.com/tools/handviewer.html

Om ervoor te zorgen dat de Handviewer iets nuttigs weergeeft, moet u het ten minste één parameter doorgeven. De specifieke parameters die u gebruikt, bepalen welke van de 6 hierboven genoemde soorten presentaties wordt weergegeven.

Parameters worden gespecificeerd door een vraagteken (?) Toe te voegen aan het einde van de bovenstaande URL, gevolgd door een lijst met parameternamen en waarden in deze vorm:

https://www.bridgebase.com/tools/handviewer.html?parameter=value1

Combinaties van meerdere parameterwaarden moeten worden gescheiden door een en-teken (&).

Bijvoorbeeld: https: // www.bridgebase.com/tools/handviewer.html?parameter1=value1¶meter2=value2

De volgorde waarin meerdere parameters zijn opgegeven, doet er niet toe. Als er meerdere exemplaren van dezelfde parameter zijn opgegeven, wordt het eerste exemplaar gebruikt en worden de volgende exemplaren genegeerd.

Parameters voor het specificeren van handen

Om enkele handen, paar handen of alle vier de handen weer te geven met behulp van het Handviewer-programma, gebruikt u een combinatie van de n, s, e en w parameters om de handen voor de Noord-, Zuid-, Oost- en / of West-spelers te specificeren. Hier zijn enkele voorbeelden:

Enkele opmerkingen over het specificeren van handen:

  • de n, s, e, w parameters (samen met de meeste andere) zijn niet hoofdlettergevoelig
  • gebruik T (of t) om een ​​10 te specificeren
  • je kunt X (of x) gebruiken om x-en in handdiagrammen op te nemen (maar niet in combinatie met de p parameter hieronder beschreven)
  • als je 3 handen van 13 kaarten specificeert, zal de Handviewer de 4e hand voor je invullen (zolang er geen x-en zijn)
  • de Handviewer staat je niet toe om een ​​hand met meer dan 13 kaarten te specificeren of om dezelfde kaart aan 2 verschillende spelers te geven
  • met de Handviewer kun je handen specificeren met minder dan 13 kaarten (handig voor eindposities of kleurcombinaties)

Parameters voor het specificeren van de namen van de spelers

De nn, sn, en en wn parameters worden gebruikt om respectievelijk de namen Noord, Zuid, Oost en West op te geven. Bijvoorbeeld:

Als u geen naam opgeeft voor een bepaalde speler wiens hand is opgegeven, wordt in plaats daarvan de richting van die speler weergegeven.

Parameters voor het specificeren van de dealer, kwetsbaarheid en bordnummer

De d parameter specificeert de dealer. Er zijn waarden van n, s, e of w nodig. Als u geen dealer opgeeft, gaat de Handviewer ervan uit dat North de dealer is.

De v parameter specificeert de kwetsbaarheid. Het heeft waarden van n, e, b en - (respectievelijk voor Noord-Zuid vul, Oost-West vul, beide vul en geen vul). Als u de kwetsbaarheid niet specificeert, gaat de Handviewer ervan uit dat niemand kwetsbaar is.

De b parameter specificeert het bordnummer (waarvan wordt aangenomen dat het een positief geheel getal is). De Handviewer voert geen enkele controle uit om er zeker van te zijn dat het bordnummer consistent is met de dealer of de kwetsbaarheid volgens de standaard progressie van bordnummers.

Hier is een voorbeeld van alle drie deze parameters die in gebruik zijn:

https://www.bridgebase.com/tools/handviewer.html?d=e&v=n&b=2

Dit zet de dealer op Oost, de kwetsbaarheid op Noord-Zuid en het bordnummer op 2.

Parameter voor het specificeren van de veiling

Specificeer de veiling met de a parameter. De waarde van deze parameter bestaat uit elke aanroep in de veiling die is samengevoegd tot een enkele tekenreeks zonder spaties of streepjes. Bijvoorbeeld:

Enkele opmerkingen over het specificeren van oproepen in de veiling:

  • gebruik N, niet NT, voor niet-biedingen
  • gebruik D of X voor dubbel
  • gebruik R voor verdubbeling

Soms is het nodig om een ​​presentatie te creëren waarbij ofwel het contract ofwel de speler aan de lijn en de troefkleur wordt gespecificeerd, maar het is niet gepast om een ​​veiling te tonen. Dit kan worden bereikt door het eerste teken van de a parameter naar een minteken (-) en gebruik de volgende paar tekens als volgt:

  • Om het contract vast te stellen, gebruikt u de volgende drie tekens om het niveau, de troefkleur en de leider te specificeren. Bijvoorbeeld: a = -4se stelt het contract in op 4 schoppen bij oost.
  • Gebruik voor eindpositiediagrammen de volgende twee tekens om de speler aan de lijn en de troefkleur te specificeren. Bijvoorbeeld: a = -sc zal zuid op voorsprong zetten met klaveren als troef.

U kunt uitleg toevoegen aan specifieke oproepen in de veiling door een passende uitleg tussen haakjes op te nemen - "(" en ")", onmiddellijk nadat de betreffende oproep verschijnt. Bijvoorbeeld:

Het 1SA-bod in het veilingdiagram wordt gemarkeerd. Als de gebruiker op een gemarkeerd gesprek klikt, wordt de uitleg van dat gesprek weergegeven. In dit geval is de verklaring: 15-17. Zodra een uitleg wordt weergegeven, kan de gebruiker deze van het scherm verwijderen door nogmaals op de betreffende oproep te klikken.

Indien de a parameter is inbegrepen, maar geen van de n, s, eof w parameters zijn opgenomen, dan wordt alleen de veiling getoond.

Indien de a parameter is inbegrepen en ten minste een van de n, s, e en w parameters zijn ook inbegrepen, zowel de veiling als de opgegeven hand (en) worden weergegeven.

Parameter voor het specificeren van de afspeelvolgorde

De afspeelvolgorde wordt gespecificeerd met de p parameter. De waarde van deze parameter moet bestaan ​​uit een reeks kaarten. Elke kaart bestaat uit 2 karakters. Het eerste teken is de reeks van de kaart (S, H, D of C) en het tweede teken is de rangorde van de kaart (2, 3, 4, 5, 6, 7, 8, 9, T, J, Q, K of A). Bijvoorbeeld:

https://www.bridgebase.com/tools/handviewer.html?p=sjsqsksadac2d4d3

Dit definieert een speelvolgorde waarin de schoppenboer de openingsleider is en de rest van de eerste slag bestaat (in volgorde) uit de vrouw, heer en schoppenaas. De ruitenaas wordt naar de tweede slag geleid. De volgende hand legt klaveren 2 weg en de overgebleven spelers volgen het voorbeeld met de ruiten 4 en de ruiten 3.

Annotaties toevoegen aan de bied- en afspeelvolgorde

Het Handviewer-programma ondersteunt functionaliteit voor het weergeven van annotaties die zijn gekoppeld aan bepaalde plaatsen in de bied- en afspeelvolgorde in het gebied onder het dealdiagram. Annotaties kunnen op de juiste plaatsen van het a en p parameters door ze tussen accolades te plaatsen - "{" en "}".

Als de a parameter heeft deze waarde:

a = {Dit is een zeer interessante bridge deal!} 1sp3ndr {ik zou niet hebben verdubbeld} ppp

De annotatie “Dit is een zeer interessante bridge deal! " verschijnt wanneer de Handviewer voor het eerst wordt gestart. Wanneer de gebruiker op de knop "Volgende" klikt, gaat het bieden door naar het punt naar de volgende annotatie (na de herverdubbeling) en wordt de bijbehorende annotatie "Ik zou niet hebben verdubbeld" weergegeven.

Evenzo, als het p parameter heeft deze waarde:

p = sj {Uitstekende openingsvoorsprong!} sqsksa {Alle hoge schoppen zijn weg} dac2d4d3

De annotatie "Uitstekende openingstip!" verschijnt nadat de boer is schoppen naar de eerste slag is geleid. De annotatie "Alle hoge schoppen zijn weg" verschijnt aan het einde van de eerste slag.

Enkele aanvullende opmerkingen over annotaties:

  • Als het eerste teken van een annotatie een plusteken (+) is, wordt de annotatie die momenteel wordt weergegeven, aangevuld met de rest van de betreffende annotatie.
  • Gebruik om het annotatiegebied te wissen: {}
  • Schoppen-, hart-, ruiten- en clubsymbolen kunnen worden opgenomen in een annotatie met! S,! H,! D en! C.
  • Annotaties kunnen HTML-tags bevatten.

Andere parameters met betrekking tot presentatie

De c parameter kan worden gebruikt om het aantal geclaimde trucs te specificeren. Als deze parameter is opgenomen met bijvoorbeeld een waarde van 10, wordt aan het einde van de afspeelreeks het bericht "10 Tricks Claimed" weergegeven.

De k (voor kibitz) parameter, wanneer gebruikt, instrueert de Handviewer om slechts één van de 4 handen te tonen (plus de dummy nadat de openingsdraad is gemaakt). De k parameter kan de waarden n, s, e of w aannemen om respectievelijk Noord, Zuid, Oost of West te specificeren. Alle 4 de handen worden getoond als alle 52 kaarten zijn uitgespeeld of als er een claim wordt ingediend voordat alle 52 kaarten zijn uitgespeeld.

Weergeven van een bridge film die is gedefinieerd in de taal van .lin-bestanden

Het Handviewer-programma begrijpt een subset van de taal die wordt gebruikt in .lin-bestanden. Hoogstwaarschijnlijk zal deze subset in de loop van de tijd groeien. Voorlopig alleen .lin-opdrachten die worden gebruikt in het bridge filmbestanden geproduceerd door de Bridge Base Online (BBO) Windows-clientprogramma wordt ondersteund. De Handviewer kan worden geïnstrueerd om een bridge movie vertegenwoordigd door een reeks .lin-opdrachten met behulp van de lin parameter. Bijvoorbeeld:

Weergeven van een bridge filmpje via een verwijzing naar de / myhands-website

De films van bridge deals die onlangs op BBO werden gespeeld, zijn toegankelijk via www.bridgebase.com/myhands. Elk bridge movie in de / myhands-database bevat een unieke identificatie. Het Handviewer-programma kan worden geïnstrueerd om een bridge movie van / myhands door het de identifier voor de betreffende film door te geven met behulp van de mijn hand parameter. Bijvoorbeeld:

https://www.bridgebase.com/tools/handviewer.html?myhand=M-103428497-1223755219

Een extern .lin-bestand laden via een parameter

Het Handviewer-programma kan worden gebruikt om een ​​eenvoudig .lin-bestand weer te geven (bijvoorbeeld het type bestand dat u krijgt als u op de knop Opslaan klikt in het filmvenster in Bridge Base Online). Om dit effect te bereiken, is het nodig om een ​​XML-bestand te maken dat fungeert als een "wrapper" voor het .lin-bestand. Bijvoorbeeld:

<lin>
md|1S2389JHTD3JC237KA,S7TH4QKD678TC4569,S456KAH25D25KACJQ,|rh||ah|Board 7|sv|b|mb|p|mb|p|mb|1S|mb|2H|mb|3S|mb|p|mb|4D|mb|p|mb|4S|mb|p|mb|p|mb|p|pg||pc|SQ|pc|S2|pc|S7|pc|SA|pg||pc|SK|pc|H3|pc|S8|pc|ST|pg||pc|CQ|pc|C8|pc|C2|pc|C4|pg||pc|CJ|pc|CT|pc|C3|pc|C5|pg||mc|13|
</lin>

Sla dit bestand op uw server op met de bestandsextensie xml (u kunt het bestand bijvoorbeeld hand1.xml noemen) en roep vervolgens de Handviewer op met de linurl parameter met een waarde van de juiste URL. Bijvoorbeeld:

https://www.bridgebase.com/tools/handviewer.html?linurl=http://www.mywebsite.com/hands/hand1.xml

Indien de linurl parameter is aanwezig, alle andere parameters worden genegeerd.

Lijst met alle parameters:

a veiling b bordnummer c aantal geclaimde trucs d dealer e East hand en East's naam k kibitz lin Inhoud van het werkelijke .lin-bestand om de linurl-URL van het externe .lin-bestand in XML-wrapper weer te geven myhand Identificatie van de deal opgeslagen in myhands n North nn North's naam p afspeelvolgorde s Zuid sn naam Zuid v kwetsbaarheid w West wn naam West

Neem voor opmerkingen, bugrapporten en andere problemen contact met ons op via support@bridgebase.com