Logo BBO

Documentation de Handviewer

Introduction

Le programme Handviewer, développé par Bridge Base Online, peut être utilisé pour créer différents types de bridge présentations sur des pages Web. Tout site Web est invité à utiliser ce programme pour toute utilisation non commerciale. Nous pensons que ce programme fonctionne bien, mais votre kilométrage peut varier. Nous ne garantissons rien.

Vous ne pouvez pas utiliser ce programme à des fins commerciales sans l'autorisation écrite de Bridge Base en ligne.

Vous n'êtes pas autorisé à modifier ce programme ou à en placer des copies sur votre propre serveur.

Le programme Handviewer peut être exécuté dans n'importe quel navigateur prenant en charge Javascript (et sur lequel Javascript a été activé). Cela inclut les navigateurs installés sur, par exemple, les téléphones mobiles iPhone et G1 (ainsi que tout navigateur moderne sur n'importe quel ordinateur moderne, bien sûr.)

Quelle sorte de bridge les présentations peuvent-elles afficher le Handviewer?

  • Mains simples
  • Paires de mains pour 2 directions (Nord + Sud, Est + Ouest, Ouest + Nord, etc.)
  • Diagrammes d'enchères
  • Mains simples (ou paires de mains) avec schémas d'enchères
  • Les quatre mains
  • A "bridge movie »(les 4 mains dans lesquelles les cartes peuvent être jouées)

Intégration du programme Handviewer dans une page Web

Pour la plupart des objectifs de publication Web, il sera judicieux d'intégrer l'application Handviewer dans une page Web. Le moyen le plus simple de le faire est d'utiliser une iframe. Le code HTML pour cela devrait ressembler à quelque chose comme ceci: qui produira quelque chose comme ceci:

Les éditeurs Web peuvent spécifier la quantité d'espace qu'une instance donnée du Handviewer occupera en définissant la hauteur et la largeur de l'iframe (respectivement 350 pixels et 200 pixels dans l'exemple ci-dessus). Le programme Handviewer se redimensionnera de manière à tenir dans l'espace que vous lui fournissez.

Les pages Web individuelles peuvent contenir plusieurs iframes, chacun utilisant une instance du programme Handviewer.

Appel du programme Handviewer

Le programme Handviewer réside à cette URL:

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

Pour que le Handviewer affiche quelque chose d'utile, vous devez lui transmettre au moins un paramètre. Les paramètres spécifiques que vous utilisez détermineront lequel des 6 types de présentations énumérés ci-dessus sera affiché.

Les paramètres sont spécifiés en ajoutant un caractère de point d'interrogation (?) À la fin de l'URL ci-dessus, suivi d'une liste de noms et de valeurs de paramètres sous cette forme:

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

Les combinaisons de valeurs de paramètres multiples doivent être séparées par une esperluette (&).

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

L'ordre dans lequel plusieurs paramètres sont spécifiés n'a pas d'importance. Si plusieurs instances du même paramètre sont spécifiées, la première de ces instances sera utilisée et les instances suivantes seront ignorées.

Paramètres de spécification des mains

Pour afficher une seule main, une paire de mains ou les 4 mains à l'aide du programme Handviewer, utilisez une combinaison des n, s, eet w paramètres pour spécifier les mains des joueurs du Nord, du Sud, de l'Est et / ou de l'Ouest. Voici quelques exemples:

Quelques notes sur la spécification des mains:

  • le n, s, e, w les paramètres (comme la plupart des autres) ne sont pas sensibles à la casse
  • utilisez T (ou t) pour spécifier un 10
  • vous pouvez utiliser X (ou x) pour inclure les x dans les diagrammes de la main (mais pas en conjonction avec le p paramètre décrit ci-dessous)
  • si vous spécifiez 3 mains de 13 cartes, le Handviewer remplira la 4ème main pour vous (tant qu'il n'y a pas de x)
  • le Handviewer ne vous permettra pas de spécifier une main de plus de 13 cartes ou de donner la même carte à 2 joueurs différents
  • le Handviewer vous permet de spécifier des mains avec moins de 13 cartes (utile pour les positions finales ou les combinaisons de couleurs)

Paramètres pour spécifier les noms des joueurs

La nn, sn, enet wn Les paramètres sont utilisés pour spécifier respectivement les noms Nord, Sud, Est et Ouest. Par exemple:

Si vous ne spécifiez pas le nom d'un joueur donné dont la main a été spécifiée, la direction de ce joueur est affichée à la place.

Paramètres de spécification du revendeur, de la vulnérabilité et du numéro de carte

La d paramètre spécifie le revendeur. Il prend des valeurs de n, s, e ou w. Si vous ne spécifiez pas de revendeur, le Handviewer supposera que North est le revendeur.

La v paramètre spécifie la vulnérabilité. Il prend les valeurs de n, e, b et - (pour Nord-Sud vul, Est-Ouest vul, à la fois vul et aucun vul respectivement). Si vous ne spécifiez pas la vulnérabilité, le Handviewer supposera que personne n'est vulnérable.

La b paramètre spécifie le numéro de carte (qui est supposé être un entier positif). Le Handviewer n'effectue aucune vérification pour s'assurer que le numéro de carte est cohérent avec le revendeur ou la vulnérabilité selon la progression standard des numéros de carte.

Voici un exemple de ces trois paramètres en cours d'utilisation:

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

Cela définira le concessionnaire sur l'Est, la vulnérabilité sur Nord-Sud et le numéro de carte sur 2.

Paramètre de spécification de l'enchère

Spécifiez l'enchère à l'aide du a paramètre. La valeur de ce paramètre consiste en chaque appel de l'enchère concaténé en une seule chaîne ne contenant ni espaces ni tirets. Par exemple:

Quelques notes sur la spécification des appels dans l'enchère:

  • utilisez N, pas NT, pour les offres notrump
  • utiliser D ou X pour double
  • utiliser R pour redoubler

Parfois, il est nécessaire de créer une présentation dans laquelle le contrat ou le joueur en tête et la couleur d'atout sont spécifiés, mais il n'est pas approprié d'afficher une enchère. Cela peut être accompli en définissant le premier caractère du a paramètre à un signe moins (-) et en utilisant les quelques caractères suivants comme suit:

  • Pour définir le contrat, utilisez les trois caractères suivants pour spécifier le niveau, la combinaison d'atout et le déclarant. Par exemple: a = -4se définit le contrat à 4 piques par Est.
  • Pour les diagrammes de fin de course, utilisez les deux caractères suivants pour spécifier le joueur en tête et la combinaison d'atout. Par exemple: a = -sc mettra le Sud en tête avec des clubs comme atout.

Vous pouvez ajouter des explications à des appels spécifiques dans l'enchère en incluant une explication appropriée entre parenthèses - «(» et «)», immédiatement après l'apparition de l'appel en question. Par exemple:

L'enchère 1SA dans le diagramme d'enchères sera mise en évidence. Si l'utilisateur clique sur un appel en surbrillance, l'explication de cet appel sera affichée. Dans ce cas, l'explication est: 15-17. Une fois qu'une explication est affichée, l'utilisateur peut la supprimer de l'écran en cliquant à nouveau sur l'appel en question.

Si la a paramètre est inclus mais aucun des n, s, eou w les paramètres sont inclus, alors seule l'enchère sera affichée.

Si la a paramètre est inclus et au moins un des n, s, eet w les paramètres sont également inclus, la vente aux enchères et la ou les mains spécifiées seront affichées.

Paramètre de spécification de la séquence de lecture

La séquence de lecture est spécifiée à l'aide du p paramètre. La valeur de ce paramètre doit être constituée d'une série de cartes. Chaque carte se compose de 2 personnages. Le premier caractère est la couleur de la carte (S, H, D ou C) et le deuxième caractère est le rang de la carte (2, 3, 4, 5, 6, 7, 8, 9, T, J, Q, K ou A). Par exemple:

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

Cela définit une séquence de jeu dans laquelle le valet de pique est le premier chef de file et le reste du premier tour consiste (dans l'ordre) de la reine, du roi et de l'as de pique. L'as de carreau est conduit au deuxième tour. La main suivante écarte le 2 des clubs et les joueurs restants emboîtent le pas avec le 4 de carreau et le 3 de carreau.

Ajout d'annotations à la séquence d'enchères et de lecture

Le programme Handviewer prend en charge la fonctionnalité d'affichage des annotations associées à des endroits particuliers dans la séquence d'enchères et de lecture dans la zone située sous le diagramme de l'offre. Des annotations peuvent être insérées aux endroits appropriés du a et p paramètres en les mettant entre accolades - «{» et «}».

Par exemple, si le a paramètre a cette valeur:

a = {C'est un très intéressant bridge deal!} 1sp3ndr {je n'aurais pas redoublé} ppp

L'annotation «C'est un très intéressant bridge traiter!" apparaîtra au premier lancement du Handviewer. Lorsque l'utilisateur clique sur le bouton «Suivant», l'enchère avancera jusqu'au point à l'annotation suivante (après le redouble) et l'annotation associée, «je n'aurais pas redoublé», sera alors affichée.

De même, si le p paramètre a cette valeur:

p = sj {Excellente avance!} sqsksa {Tous les hauts piques sont partis} dac2d4d3

L'annotation "Excellent lead d'ouverture!" apparaîtra après que Jack est pique soit conduit au premier pli. L'annotation «Tous les hauts piques sont partis» apparaîtra à la fin du premier tour.

Quelques remarques supplémentaires sur les annotations:

  • Si le premier caractère d'une annotation est un signe plus (+), quelle que soit l'annotation actuellement affichée, elle sera augmentée du reste de l'annotation en question.
  • Pour effacer la zone d'annotation, utilisez: {}
  • Les symboles de pique, de cœur, de losange et de club peuvent être inclus dans une annotation avec! S,! H,! D et! C.
  • Les annotations peuvent contenir des balises HTML.

Autres paramètres liés à la présentation

La c Le paramètre peut être utilisé pour spécifier le nombre de levées revendiquées. Si ce paramètre est inclus avec, par exemple, une valeur de 10, un message «10 Tricks Claimed» s'affichera à la fin de la séquence de lecture.

La k Le paramètre (for kibitz), lorsqu'il est utilisé, indique au Handviewer de n'afficher qu'une seule des 4 mains (plus le mannequin après que l'ouverture de l'avance est faite). le k Le paramètre peut prendre des valeurs de n, s, e ou w pour spécifier respectivement le nord, le sud, l'est ou l'ouest du kibitzing. Les 4 mains seront affichées soit si les 52 cartes sont jouées ou lorsque la réclamation est faite avant que les 52 cartes aient été jouées.

Affichage d'un bridge film défini à l'aide de la langue des fichiers .lin

Le programme Handviewer comprend un sous-ensemble du langage utilisé dans les fichiers .lin. Très probablement, ce sous-ensemble augmentera avec le temps. Pour l'instant, seules les commandes .lin utilisées dans le bridge fichiers vidéo produits par le Bridge Le programme client Windows de base en ligne (BBO) est pris en charge. Le Handviewer peut être invité à afficher un bridge film représenté par une chaîne de commandes .lin utilisant le lin paramètre. Par exemple:

Affichage d'un bridge film via une référence au site Web / myhands

Les films de bridge les offres qui ont été jouées récemment sur BBO sont accessibles via www.bridgebase.com/myhands. Chaque bridge movie dans la base de données / myhands contient un identifiant unique. Le programme Handviewer peut être invité à afficher un bridge movie from / myhands en lui passant l'identifiant du film en question en utilisant le ma main paramètre. Par exemple:

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

Chargement d'un fichier .lin externe via un paramètre

Le programme Handviewer peut être utilisé pour afficher un simple fichier .lin (par exemple, le type de fichier que vous obtenez lorsque vous cliquez sur le bouton Enregistrer dans la fenêtre Film dans Bridge Base en ligne). Pour obtenir cet effet, il est nécessaire de créer un fichier XML qui agit comme un «wrapper» pour le fichier .lin. Par exemple:

<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>

Enregistrez ce fichier sur votre serveur avec l'extension de fichier xml (par exemple, vous pouvez nommer le fichier hand1.xml), puis appelez Handviewer à l'aide du linurl paramètre avec une valeur de l'URL appropriée. Par exemple:

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

Si la linurl Le paramètre est présent tous les autres paramètres seront ignorés.

Liste de tous les paramètres:

une vente aux enchères b numéro de tableau c nombre de levées revendiquées d revendeur e main de l'est en nom de l'est k kibitz lin nom p lecture séquence s sud sn nom sud v vulnérabilité w ouest wn nom ouest

Pour des commentaires, des rapports de bogues, d'autres problèmes, contactez-nous à support@bridgebase.com