Blocs#

La documentation de référence de l’API des blocs VEX IQ (2e génération) explique le rôle de chaque bloc VEXcode, comment ses entrées modifient le comportement du robot et comment le bloc peut être utilisé dans un projet.

Utilisez cette référence lorsque vous souhaitez comprendre un bloc avant de l’ajouter à un projet, vérifier les informations qu’il fournit ou comparer des blocs similaires dans une même catégorie.

Les blocs sont utilisés dans les projets VEXcode IQ Blocks. Les projets Python et C++ utilisent quant à eux les sections d’API textuelles.

Comment lire une entrée de bloc#

La plupart des entrées de bloc comprennent les parties suivantes :

Description du bloc - Explique le rôle du bloc et son utilité.
Image du bloc - Montre à quoi ressemble le bloc dans VEXcode IQ.
Paramètres - Liste les entrées du bloc et explique comment chaque entrée affecte le robot ou le projet.
Valeur de retour - Explique ce que rapporte un bloc booléen ou un bloc Reporter.
Exemple - Illustre une façon d’utiliser ce bloc dans un projet.

Types de blocs courants#

Les différentes formes de blocs ont des rôles différents dans un projet.

Type de bloc	Ce que cela signifie
Empiler	Un bloc qui effectue une action. Les blocs empilés se connectent au-dessus et en dessous d’autres blocs dans une pile.
Chapeau	Un bloc qui déclenche une pile de blocs lorsqu’un événement se produit, par exemple au démarrage d’un projet ou lors de la survenue d’un événement.
Booléen	Un bloc qui renvoie Vrai ou Faux. Les blocs booléens sont souvent utilisés à l’intérieur de conditions, telles que les blocs si alors ou attendre jusqu’à.
Journaliste	Un bloc qui renvoie une valeur, comme un nombre ou du texte. Les blocs de rapport sont souvent utilisés à l’intérieur d’autres blocs.
Bloc C	Un bloc qui englobe d’autres blocs et contrôle quand ou comment ils s’exécutent, comme les blocs répétitifs ou les blocs si alors.

Exemple d’entrée de bloc#

moteur de rotation pour#

Le bloc moteur de rotation pour fait tourner un moteur ou un groupe de moteurs sur une distance précise. La rotation est relative à la position actuelle du moteur ou du groupe de moteurs. Le programme attendra la fin de la rotation du moteur ou du groupe de moteurs avant de lancer le bloc suivant dans la pile.

faire tourner [Motor1 v] [avant v] de (90) [degrés v] ▶

Paramètres	Description
moteur	Le moteur ou le groupe de moteurs à faire tourner. Choisissez parmi les moteurs configurés dans la fenêtre Périphériques.
direction	Le sens de rotation du moteur ou du groupe de moteurs. Par défaut, les options sont avant et arrière. Le sens de rotation peut varier selon la configuration du moteur.
distance	Distance de rotation du moteur ou du groupe de moteurs. Les degrés sont exprimés en nombres entiers. Le nombre de tours peut être exprimé en nombres entiers ou décimaux.
unité	L’unité de distance : degrés ou tours.
et n’attendez pas	Sélectionnez la flèche ( ▶ ) pour développer le bloc et dire et n’attendez pas, afin que le bloc suivant dans la pile s’exécute immédiatement.

Exemple

au démarrage
[Spin the motor forward once, then reset.]
faire tourner [Motor1 v] [avant v] de (90) [degrés v] ▶
faire tourner [Motor1 v] [en arrière v] de (90) [degrés v] ▶