User Tools

Site Tools


fr:singlepage

~~ODT~~

BASIC-256 Syntax Reference

Syntaxe du programme

Les programmes sous BASIC-256 sont formés d'une série d'instructions séparées par un retour à la ligne et qui sont exécutées dans l'ordre.

2016/01/01 22:45

Constantes numériques

Les constantes numériques peuvent être n'importe quel(s) caractère(s) numérique(s), précédé ou non d'un signe moins (pour les nombres négatifs) et une éventuelle décimale (pour les nombres à virgule flottante).

Les nombres positifs entiers peuvent aussi être exprimées en binaire (base 2), octal (base 8) et hexadécimal (base 16). Faites précéder les entrées binaires de 0b (0b1110 = 14), octales de 0o (0o177 = 127) et hexadécimales de 0x (0xff = 255).

2016/01/01 22:45

Constantes chaînes de caractères

Les (constantes) chaînes de caractères sont composées de zéro ou plus de caractères entourés de guillemets (“).

2016/01/01 22:45

Variables

Le nom des variables contenant des valeurs numériques doit commencer par une lettre et peut comporter n'importe quel nombre de caractères alpha-numériques. Il est sensible à la casse (on différencie majuscule et minuscule). Il peut être utilisé en alternance de constantes numériques (i.e. on peut passer de l'un à l'autre, les deux se valent).

Le nom des variables contenant des chaînes de caractères suit les mêmes règles que celui des variables numériques, mais doit finir par un symbole dollar ($). Il peut, lui aussi, être utilisé en alternance de constantes.

2016/01/01 22:45

Tableaux

Les tableaux sont affectés à l'aide de la commande DIM ou redimensionnés avec Redim. Ils peuvent contenir des données numériques ou des chaînes de caractères. Pour accéder à un élément donné d'un tableau on utilise les crochets “[ et ]” autour du rang de l'élément voulu (la numérotation partant de zéro). Les tableaux peuvent aussi être dimensionnés et interrogés sur 2 dimensions.
Le taille d'un tableau peut être retournée par une des commandes suivantes : [?] [?,] ou [,?] à la fin du nom du tableau.

Exemple
print myarray[4]

affichera à l'écran le 5eme élément du tableau 'myarray'

2016/01/01 22:44

Tableaux "anonymes"

Un tableau anonyme est une série de valeurs numériques ou de chaînes de caractères, séparées par des virgules, et encadrées par des accolades {}. Un tableau anonyme peut ête utilisé à la place d'une variable d'un tableau ou pour assigner une variable d'un tableau.

Exemple
dim myarray(4)
myarray = {1, 2, 3, 4}

PS : je ne suis pas sûr de la traduction de cette page. C'est ainsi que je l'ai compris, mais sans certitude.

2016/01/01 22:44

Opérateurs

Les opérateurs +, -, *, /, ^, %, et \ sont utilisés pour réaliser respectivement une addition, une soustraction, une multiplication, une division, une puissance, un modulo et une division arrondie à l'entier des opérandes. Les opérandes valides sont des constantes numériques et/ou des varaibles numériques.

L'opérateur = est utilisé à la fois pour assigner une valeur à une varaiable et pour tester l'égalité. L'opérateur + peut être utilisé pour réaliser la concaténation (= mise bout à bout) de n'importe quelle combinaison de chaînes de constantes et de variables.string variables. L'opératuer : peut servir à séparer plusieurs instructions sur une même ligne. L'opérateur ; supprime le retour à la ligne qu'introduirait une commande PRINT. L'opérateur # est un raccourci de la commande Rem et interchangeable avec celle-ci.

Ordre des opérations
NiveauOpérateurCatégorie/Description
1( )Groupement
2^Exposant
3-Moins
4* / \Multiplication et Division
5%Reste entier (Mod)
6+ -Addition, Concaténation et Soustraction
7< ⇐ > >= = <>Comparaison (Numérique et Chaîne)
8NOT“Non” logique
9AND“Et” logique
10OR“Ou” logique
11XOR“Ou exclusif” logique
2016/01/01 22:45

Statements and Functions - Alphabetic

Abs

Format

abs ( expression )

Description

Retourne la valeur absolue d'une expression numérique.

Exemple
print abs(-45)
print abs(6.45)

permet d'afficher

45
6.45
2016/01/01 22:44

Acos

Format

acos ( expression )

Description

Calcule l'arc-cosinus d'expression. Les angles sont exprimés en radians (0 à 2 pi).

Voir Aussi
2016/01/01 22:44

Asc

Format

asc ( expression )

Description

Convertit le premier caractère d'une chaîne en sa valeur ASCII (= un nombre entier).

AscChrAscChrAscChrAscChrAscChrAscChr
32SPACE48064@80P96`112p
33!49165A81Q97a113q
3450266B82R98b114r
35#51367C83S99c115s
36$52468D84T100d116t
37%53569E85U101e117u
38&54670F86V102f118v
39'55771G87W103g119w
40(56872H88X104h120x
41)57973I89Y105i121y
42*58:74J90Z106j122z
43+59;75K91[107k123{
44,60<76L92\108l124|
45-61=77M93]109m125}
46.62>78N94^110n126~
47/63?79O95_111o127
Voir Aaussi

Chr

Exemple
print asc("A")
print asc("bleu")

permet d'afficher

65
98
Fonction disponible de la version

0.9.4

2016/01/01 22:44

Asin

Format

asin ( expression )

Description

Calcule l'arc-sinus d'une expression. Les angles sont exprimés en (0 à 2pi).

Voir aussi
2016/01/01 22:44

Atan

Format

atan ( expression )

Description

Calcule l'arc-tangente d'une expression. Les angles sont exprimés en radians (0 à 2pi).

Voir aussi
2016/01/01 22:44

Ceil

Format

ceil ( expression )

Description

Retourne l'entier immédiatement inférieur ou égal à une expression.

Voir aussi
Exemple
print ceil(9.1)
print ceil(-5.4)

fera afficher

10
-5
2016/01/01 22:44

Changedir

Format

changedir expression
changedir ( expression )

Description

Change de répertoire de travail pour le chemin spécifié par l'expression. Pour toutes le OS (y compris Windows) un slash (/) est utilisé pour séparer les répertoires au sein d'un chemin complet.

Voir aussi
Disponible à partir de la version

0.9.6r

2016/01/01 22:44

Chr

Format

chr ( expression )

Description

Converti l'entier expression en le caractère correspondant en code ASCII. Voir la page consacrée à asc pour un tableau de converson des caractères ASCII.

Voir aussi

Asc

Exemple
print chr(66)+chr(111)+chr(111)+chr(33)

affichera

Boo!
Disponible à partir de la version

0.9.4

2016/01/01 22:44

Circle

Format

circle x,y,r

Description

Trace un cercle dont les coordonnées du centre sont x,y et le rayon r. Le cercle étant de la couleur active.

Exemple
color blue
rect 0,0,300,300
color red
circle 100,100,50

dessine
Circle

2016/01/01 22:44

Clickb

Format

clickb
clickb ( )

Description

Retourne quel(s) bouton(s) de la souris l'utilisateur a pressé (quand il est sur la partie graphic output). Retourne 0 si aucun clic n'a été détecté. Si plusieurs boutons ont été pressés la valeur est la somme des valeurs des boutons pressés.

Valeurs retournées
ValeurBouton pressé
0aucun
1gauche
2droit
4du centre
Voir aussi
Exemple
# réinitialise le compte des clics
clickclear
# attend que l'utilisateur clique
print "cliquez avec la souris sur la surface graphics output"
while clickb = 0
  pause .01
endwhile
# Montre où l'utilisatur a cliqué
print "L'utilisateur a cliqué le point de coordonnées (" + clickx + "," + clicky + ")"
Disponible à partir de la version

0.9.4d

2016/01/01 22:44

Clickclear

Format

clickclear
clickclear ( )

Description

Remet ClickB, Clickx et Clicky à zéro afin de pouvoir détecter facilement un clic de la souris.

Voir aussi
Exemple

Voir le programme de la page de Clickb.

Disponible à partir de la version

0.9.4d

2016/01/01 22:44

Clickx

Format

clickx
clickx ( )

Description

Retourne l'abscisse x du pointeur de la souris sur la surface graphic output au dernier clic.

Voir aussi
Exemple

Voir le programme de la page de Clickb.

Disponible à partir de la version

0.9.4d

2016/01/01 22:44

Clicky

Format

clicky
clicky ( )

Description

Retourne l'ordonnée y du pointeur de la souris sur la surface graphic output au dernier clic.

Voir aussi
Exemple

Voir le programme sur la page de Clickb.

Disponible à partir de la version

0.9.4d

2016/01/01 22:44

Clg

Format

clg

Description

Efface la fenêtre d'affichage graphique.

2016/01/01 22:44

Close

Format

close
close ( )
close filenumber
close ( filenumber )

Description

Ferme un fichier ouvert. Si aucun fichier ne correspond à ce numéro, la commande n'a aucun effet. Si aucun numéro de fichier n'est spécifié, le numéro de fichier utilisé sera le zéro.

Voir aussi
2016/01/01 22:44

Cls

Format

cls

Description

Nettoie la fenêtre text output.

2016/01/01 22:44

Color

Format

color colorname
color ( colorname )
color red, blue, green
color ( red, blue, green )
color rgb_value
color ( rgb_value )

Description

Règle la couleur active comme étant la couleur appelée colorname; de composantes rouge, bleue et verte red, blue, green ; ou de valeur RGB rgb_value.

Il y a une couleur spéciale appelée CLEAR, de valeur -1. Si la couleur courante est réglée sur cette valeur, les pixels ou formes dessinés effaceront les pixels sur lesquels ils passeront et les rendront transparents. C'est particulièrement utile pour créer des sprites avec la commande Spriteslice.

Noms des couleurs et leur valeur RGB
Nom de la couleurValeur RGB
black0, 0, 0<hi #000000>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
white255, 255, 255<hi #FFFFFF>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
red255, 0, 0<hi #FF0000>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkred128, 0, 0<hi #800000>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
green0, 255, 0<hi #00FF00>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkgreen0, 128, 0<hi #008000>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
blue0, 0, 255<hi #0000FF>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkblue0, 0, 128<hi #000080>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
cyan0, 255, 255<hi #00FFFF>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkcyan0, 128, 128<hi #008080>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
purple255, 0, 255<hi #FF00FF>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkpurple128, 0, 128<hi #800080>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
yellow255, 255, 0<hi #FFFF00>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkyellow128, 128 ,0<hi #808000>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
orange255, 102, 0<hi #FF6600>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkorange176, 61 ,0<hi #B03D00>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
grey164, 164 ,164<hi #A4A4A4>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkgrey128, 128 ,128<hi #808080>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
clear-1~~SP~~
Voir aussi
Exemple
clg
color rgb(128,128,128)
rect 0,0,graphwidth, graphheight
color red
circle 100,100,50
color 255,160,160
circle 100,100,25

Dessinera un rectangle gris avec dedans un cercle rouge et un centre rose.
Color

Disponible à partir de la version

0.9.5m

2016/01/01 22:44

Cos

Format

cos ( expression )

Description

Calcule le cosinus de l'expression. L'expression doit être exprimé en radians.

Note

La fonction cos ne retourne pas un résultat exact (mais une valur approchée).

Voir aussi
Exemple
clg
color black
# Trace une ligne à travers la fenêtre graphic output
line 0,150,300,150
# point de départ
lastx = 0
lasty = cos(0) * 50 + 150
# puis pas après pas trace la courbe du cosinus
for x = 0 to 300 step 5
   angle = x / 300 * 2 * pi
   y = cos(angle) * 50 + 150
   line lastx, lasty, x, y
   lastx = x
   lasty = y
next x

dessine
Cosine Curve

2016/01/01 22:44

Currentdir

Format

currentdir
currentdir ( )

Description

Retourne le chemin complet du répertoire courant. Pour toutes les OS (y compris Windows) un slash (/) sépare les répertoires du chemin.

SeVoir aussi
Disponible à partir de la version

0.9.6r

2016/01/01 22:44

Day

Format

day
day()

Description

Renvoie le jour du mois actuel (1-31) d'après l'horloge système.

Exemple
print "Aujourd'hui nous sommes le ";
print day() + "/" + (month() + 1) + "/" + year()

affichera par exemple :

Aujourd'hui nous sommes le 1/5/2013
Voir aussi
Première version

0.9.4

2016/01/01 22:44

DBClose

Format

dbclose
dbclose ( )

Description

Ferme le fichier de données SQLite actuellement ouvert.

Exemple

Voir l'exemple de la page de DBOpen.

Voir aussi
Liens externes

De plus amples informations (en anglais) sur les bases de données en général et SQLite en particulier sont disponibles aux adresses suivantes : SQLite Home Page et SQL at Wikipedia.

Disponible à partir de la version

0.9.6y

2016/01/01 22:44

DBCloseSet

Format

dbcloseset
dbcloseset ( )

Description

Ferme une série d'enregistrements ouverte par DBOpenSet.

Exemple

Voir l'exemple d'utilisation sur la page DBOpen .

Voir Aussi
Liens Externes

De plus amples informations (en anglais) sur les bases de données en général et SQLite en particulier, sont disponibles aux adresses suivantes: Page principale de SQLite et Page Wikipedia de SQL.

Disponible à partir de la version

0.9.6y

2016/01/01 22:44

DBExecute

Format

dbexecute SqlStatement
dbexecute ( SqlStatement )

Description

Exécute une commande SQL sur le fichier de base de données SQLite ouvert. Cette commande ne produit pas d'enregistrement.

Exemple

Voir l'exemple de la page de DBOpen.

Voir aussi
Liens externes

De plus amples informations (en anglais) sur les bases de données en général et SQLite en particulier sont disponibles aux adresses suivantes : Page d'accueil de SQLite et SQL sur Wikipedia.

Disponible à partir de la version

0.9.6y

2016/01/01 22:44

DBFloat

Format

dbfloat ( ColumnNumber )

Description

Retourne une valeur décimale (virgule flottante) de la colonne demandée de la ligne active de l'enregistrement ouvert.

Exemple

Voir l'exemple de la page de DBOpen.

Voir aussi
Liens externes

De plus amples informations (en anglais) sur les bases de données en général et SQLite en particulier, sont disponibles aux adresses suivantes : Page d'accueil de SQLite et SQL sur Wikipedia.

Disponible à partir de la version

0.9.6y

2016/01/01 22:44

DBInt

Format

dbint ( ColumnNumber )

Description

Retourne la valeur entière de la colonne demandée de la ligne active de l'enregistrement ouvert.

Exemple

Voir l'exemple de la page de DBOpen.

Voir aussi
Liens externes

De plus amples informations (en anglais) sur les bases de données en général et SQLite en particulier, sont disponibles aux adresses suivantes : Page d'accueil de SQLite et SQL sur Wikipedia.

Disponible à partir de la version

0.9.6y

2016/01/01 22:44

DBOpen

Format

dbopen SQLiteFile
dbopen ( SQLiteFile )

Description

Ouvre un fichier de base de données SQLite. Si le fichier n'existe pas, il est créé.

Exemple
#database foo - crée une base de données, peuple une table, ouvre un enregistrement et lit les données de la table.

# crée un nouveau fichier de base de données ou l'ouvre
dbopen "dbtest.sqlite3"

# efface l'ancienne table "foo" - renvoie une erreur si c'est une nouvelle base de données
onerror errortrap
dbexecute "drop table foo;"
offerror
# crée et peuple
dbexecute "create table foo (id integer, words text, value decimal);"
dbexecute "insert into foo values (1,'un',3.14);"
dbexecute "insert into foo values (2,'deux',6.28);"
dbexecute "insert into foo values (3,'trois',9.43);"

# ouvre une table (série d'enregistrements) résultat de la requête et
# tourne en boucle pour parcourir tous les enregistrements (toutes les lignes de données).
dbopenset "select * from foo order by words;"
while dbrow()
	print dbint(0) + dbstring(1) + dbfloat(2)
end while
dbcloseset

# rassemble tout
dbclose
end

errortrap:
# accepte l'erreur - n'affiche rien - va à la prochaine commande
return

affichera

1un3.14
3trois9.43
2deux6.28
Voir aussi
Lien externes

De plus amples informations (en anglais) sur les bases de données en général et SQLite en particulier, sont disponibles aux adresses suivantes : Page d'accueil de SQLite et SQL sur Wikipedia.

Disponible à partir de la version

0.9.6y

2016/01/01 22:44

DBClose

Format

dbopenset CommandeSQL
dbopenset ( CommandeSQL )

Description

Exécute une commande SQL, créé et ouvre une série d'enregistrements qui peuvent être parcourus par le programme pour utiliser le résultat de la commande SQL (une requête SQL par exemple).

Exemple

Voir l'exemple d'utilisation dans la page DBOpen .

Voir aussi
Liens Externes

De plus amples informations (en anglais) sur les bases de données en général et SQLite en particulier, sont disponibles aux adresses suivantes: Page principale de SQLite et Page Wikipedia de SQL.

Disponible à partir de la version

0.9.6y

2016/01/01 22:44

DBRow

Format

dbrow
dbrow ( )

Description

Cette fonction avance d'un enregistrement dans la série d'enregistrement en cours. Elle retourne vrai (true) si l'enregistrement existe, ou faux (false) si la fin des enregistrements de la série est atteinte.

Exemple

Voir l'exemple d'utilisation dans la page DBOpen.

Voir Aussi
Liens Externes

De plus amples informations (en anglais) sur les bases de données en général et SQLite en particulier, sont disponibles aux adresses suivantes: Page principale de SQLite et Page Wikipedia de SQL.

Disponible à partir le la version

0.9.6y

2016/01/01 22:44

DBString

Format

dbstring ( NuméroDeColonne )

Description

Retourne une chaîne de caractères correspondant à la colonne spécifiée de l'enregistrement en cours de la série d'enregistrement ouverte.

Exemple

Voir l'exemple de la page DBOpen.

Voir Aussi
Liens externes

De plus amples informations (en anglais) sur les bases de données en général et SQLite en particulier, sont disponibles aux adresses suivantes : Page d'accueil de SQLite et SQL sur Wikipedia.

Disponible à partir de la version

0.9.6y

2016/01/01 22:44

Degrees

Format

degrees ( expression )

Description

Retourne la conversion en degrés de l'angle expression donné en radians.

Voir aussi
2016/01/01 22:44

Dim

Format

dim numericvariable ( integer )
dim stringvariable$ ( integer )
dim numericvariable ( rows , columns )
dim stringvariable$ ( rows , columns )

Description

Retourne un nouveau tableau à 1 dimension de longueur integer ou à 2 dimensions qui peut être adressé par row et column. Selon l'assignation de la variable, un tableau numérique ou de chaînes de caractères est créé.
Le premier élément d'un tableau a l'index 0 (zéro). Les index allant ainsi de 0 à {longueur}-1.

Voir aussi
Exemple
dim z(5)
z = {1, 2, 3, 4, 5}
print z[0] + " " + z[4]

affichera

1 5
Exemple 2
dim c$(4)
c$ = {"à", "bulot, "laque", "L'anneau"}
print c$[2] + " " + c$[3] + " ";
print c$[1] + " " + c$[0] + "!"

affichera

L'anneau laque à bulot!
2016/01/01 22:44
 

End

Format

end

Description

Termine l'exécution du programme.

Exemple
print "Début du programme."
end
print "Est-ce que je passe par là?"

Produira le résultat suivant:

Début du programme.
2016/01/01 22:44

Eof

Format

eof
eof()
eof(NuméroFichier)

Description

Retourne un drapeau binaire (vrai/faux) qui signale si la fin du fichier (EOF: End Of File) a été atreinte. Si NuméroFichier n'est pas spécifié alors le numéro zéro (0) sera utilisé par défaut.

Voir Aussi
Disponible à partir de la version

0.9.4

2016/01/01 22:44

Exists

Format

exists ( expression )

Description

Retourne une valeur binaire (vrai/faux) qui indique si le chemin du fichier spécifié dans “expression” existe.

Voir Aussi
Disponible à partir de la version

0.9.4

2016/01/01 22:44

FastGraphics

Format

fastgraphics

Description

Active le mode fastgraphics, jusqu'à ce que le programme soit stoppé. Dans ce mode l'affichage graphique n'est mis à jour que lors de l'appel de la commande REFRESH. Ce mode peut ête utilisé pour augmenter significativement la vitesse d'affichage des graphiques complexes et diminuer (voir annuler) l'effet de clignotement.

Remarque

Lorsque l'on créé des animations il est recommandé de procéder à tout le tracé du graphique dans un sous programme et d'utiliser un seul REFRESH une fois que tout a été tracé dans l'image.

Voir Aussi
2016/01/01 22:44

Float

Format

float ( expression )

Description

Convertie expression (qui peut être une chaîne de caractères ou un entier) en nombre flottant. Si expression ne peut pas être convertie zéro sera retourné.

Voir Aussi

Int

Disponible depuis la version

0.9.4

2016/01/01 22:44

Floor

Format

floor ( expression )

Description

Retourne le plus grand entier inférieur ou égal à expression.

Voir Aussi
2016/01/01 22:44

Font

Format

font nomdefonte, point, epaisseur

Description

Définie la fonte de caractères qui sera utilisée par la commande Text comme étant nomdefonte. La taille sera donnée par point (en 1/72“). epaisseur est un nombre entre 0 et 100 qui définit l'épaisseur de tracé des caractères (Léger=25, Normal=50, épais=75).

Exemple
color grey
rect 0,0,graphwidth,graphheight
color red
font "Times New Roman",18,50
text 10,100,"This is Times New Roman"
color darkgreen
font "Tahoma",28,100
text 10,200,"This is BOLD!"

Donnera le resultat suivant:

Voir Aussi
Disponible depuis la version

0.9.4

2016/01/01 22:44
 

GetColor

Format

getcolor
getcolor()

Description

Retourne la valeur RGB de la couleur de tracé en cours (telle que définie par la commande color). RGB est calculé à l'aide de la formule ((rouge * 256) + vert * 256) + bleurouge, vert, et bleu sont compris entre 0 et 255. Si la couleur de tracé est définie à CLEAR, cette fonction retourne -1.

Voir Aussi
Exemple
color red
print getcolor

Donnera le résultat :

16711680
Disponible à partir de a version

0.9.5m

2016/01/01 22:44

GetSlice

Format

getslice(x, y, largeur, hauteur)

Description

Retourne une chaîne de caractères qui contient la représentation hexadécimale du rectangle définit par le paramètres. La chaîne est formatée comme suit :

TailleDescription
4 octetsLargeur
4 octetsHauteur
6 octets1er pixel (valeur RGB)
6 octets2ème pixel (valeur RGB)
….….
6 octets(largeur*hauteur)ième pixel (valeur RGB)
Voir Aussi
Disponible à partir de la version

0.9.6b

2016/01/01 22:44

Goto

Format

goto label

Description

Poursuit l'exécution du programme à l'étiquette label spécifiée.

Exemple
print "Cette voiture est";
goto skipit
print " rouge avec de rayures";
skipit: #
print " jaune."

Affichera :

Cette voiture est jaune.
Voir Aussi
Notes

Les instruction Goto, Gosub, et “labels” de la version 0.9.9.2, ne peuvent pas être utilisées dans les définitions des Function et Subroutine.

2016/01/01 22:44
 

Graphheight

Format

graphheight
graphheight()

Description

Retournes la hauteur (dimension Y) de la fenêtre d'affichage graphique courante.

Voir Aussi
Disponible à partir de la version

0.9.3

2016/01/01 22:44

Graphsize

Format

graphsize x_expression, y_expression

Description

Change la taille de la fenêtre d'affichage graphique et rafraîchis la fenêtre de l'application BASIC256.

Voir Aussi
Disponible à partir de la version

0.9.3

2016/01/01 22:44

Graphwidth

Format

graphwidth
graphwidth()

Description

Retournes la largeur (dimension X) de la fenêtre d'affichage graphique courante.

Voir Aussi
Disponible à partir de la version

0.9.3

2016/01/01 22:44

Hour

Format

hour
hour()

Description

Renvoie l'heure courante de l'horloge système (0-23).

Exemple
# affiche la date
dim mois$(12)
mois$ = {"janvier", "février", "mars", "avril", "mai", "juin", "juillet", "août", "septembre", "octobre", "novembre", "décembre"}
d = day()
if d=1 then
   ier$="er"
else
   ier$=""
endif
print d + ier$ + " " + mois$[month()] + " " + year()
# affiche l'heure
print  hour() + ":" + right("0" + minute(), 2) + ":" + right("0" + second(), 2)

affichera quelque chose comme ceci :

1er mai 2013
21:47:04
Voir aussi
Première version

0.9.4

2016/01/01 22:44

Instr

Format

instr( string1, string2 )

Description

Vérifie si string2 est inclus dans sting1. Si c'est le cas cette fonction retourne la position du premier caractère de string2 dans string1. Sinon cette fonction retourne zéro (0).

Note

La position commence à l'indice 1.

Exemple
print instr("Bonjour", "jour")

Affichera:

4
2016/01/01 22:44

Int

Format

int ( expression )

Description

Convertie expression (qui peut être un nombre flottant ou une chaîne de caractères) en nombre entier (partie entière). Zéro sera retourné si l'expression ne peut être convertie.

Voir Aussi
2016/01/01 22:44
 

Imgload

Format

imgload x, y, nomfichier
imgload x, y, echelle, nomfichier
imgload x, y, echelle, rotation, nomfichier

Description

Charge une image à partir d'un fichier et l'affiche dans la fenêtre d'affichage graphique.
Les paramètre x et y indiquent ou doit être positionné le centre de l'image dans la fenêtre graphique. Cette façon de faire est différente de toutes les autres fonctionnalités graphiques. L'axe de rotation éventuel sera aussi ce même point central.
Cette fonction est capable de lire la plupart des formats graphiques courant : BMP (Windows Bitmap), GIF (Graphic Interchange Format),JPG/JPEG (Joint Photographic Experts Group), et PNG (Portable Network Graphics).
Imgload met éventuellement à l'échelle l'image avec le paramètre echelle (1 = taille normale). Elle permet aussi d'effectuer une rotation de l'image en passant le paramètre rotation qui est l'angle de rotation en radian dans le sens des aiguilles d'une montre autour du centre de l'image.

Disponible à partir de la version

0.9.6l

2016/01/01 22:44

Input

Format

input expression, variablechainedecaracteres
input expression, variablenumerique
input variablechainedecaracteres
input variablenumerique

Description

Attend que l'utilisateur tape une ligne de texte au clavier dans la fenêtre d'affichage texte de l’environnement. Quand l'utilisateur appui sur Entrée ou Retour, la ligne saisie est stockée dans variablechainedecaracteres ou variablenumerique.
Il est possible d'afficher un texte d'invite en fournissant le paramètre optionnel expression.
Si une variable numérique est spécifiée en paramètre mais que la donnée saisie n'est pas numérique, la variable numérique serra alors initialisée à zéro (0).
Une référence à un élément de tableau peut également être passé en paramètre.

2016/01/01 22:44

Key

Format

key
key()

Description

Retourne un entier correspondant au code de la touche clavier pressée. Cette fonction est non bloquante, si aucune touche n'a été pressée depuis le dernier appel de key elle retourne zéro (0).

Remarque
if key = 47 then print key

ne produira pas l'effet escompté (afficher 47) car appeler key deux fois de suite produira deux résultats différents. Le code suivant est correct:

a = key
if a = 47 then print a
2016/01/01 22:44

LastError

Format

lasterror
lasterror ( )

Description

Retourne le numéro de la dernière erreur d’exécution.

Exemple

Voir l'exemple d'utilisation sur la page Codes d'Erreurs.

Voir Aussi
Disponible à partir de la version

0.9.6z

2016/01/01 22:44

LastErrorExtra

Format

lasterrorextra
lasterrorextra ( )

Description

Retourne les informations supplémentaires spécifiques à propos d'une erreur.

Exemple

Voir l'exemple d'utilisation sur la page Codes d'Erreurs.

Voir Aussi
Disponible à partir de la version

0.9.6z

2016/01/01 22:44

LastErrorLine

Format

lasterrorline
lasterrorline ( )

Description

Retourne le numéro de ligne de programme où l'erreur d'exécution s'est produite.

Exemple

Voir l'exemple d'utilisation dans la page Codes d'Erreurs .

Voir Aussi
Disponible à partir de la version

0.9.6z

2016/01/01 22:44

LastErrorMessage

Format

lasterrormessage
lasterrormessage ( )

Description

Retourne une chaîne de caractère décrivant la dernière erreur d’exécution.

Exemple

Voir l'exemple d'utilisation dans la page Codes d'Erreurs .

Voir Aussi
Disponible à partir de la version

0.9.6z

2016/01/01 22:44

Left

Format

left( string, length)

Description

Retourne une portion de la chaîne de caractères passée en paramètre (string), la portion retournée commence au premier caractère à gauche et comporte length caractères.

Voir Aussi
Exemple
print left("Bonjour", 3)

Affichera

Bon
Disponible depuis la version

0.9.5b

2016/01/01 22:44

Length

Format

length( string )

Description

Retourne la longueur de la chaîne de caractères string passée en paramètre.

Exemple
print length("Bonjour")

Affichera :

7
2016/01/01 22:44

Line

Format

line x0, y0, x1, y1
line(x0, y0, x1, y1)

Description

Trace une ligne reliant les points x0,y0 et x1, y1.

Exemple
color white
rect 0,0,300,300
color black
line 50,50,200,200
line 100,200,200,200
line 100,200,50,50

Affichera
Line

2016/01/01 22:44

Log

Format

log ( expression )

Description

Retourne le logarithme népérien (base e) de l'expression.

Voir Aussi
Disponible depuis la version

0.9.5w

2016/01/01 22:44
 

Lower

Format

lower( string)

Description

Retourne la chaîne de caractère string avec tous les caractères alphabétiques convertis en minuscule.

See Also

Upper

print lower("La Plage Et Le Soleil !")

Affichera :

la plage et le soleil !
Disponible depuis la version

0.9.5e

2016/01/01 22:44

Mid

Format

mid( string, caractere_debut, longueur)

Description

Retourne un morceau de la chaîne de caractères string, la position du début est donné par caractere_debut, et la longueur par longueur ou la fin de la chaîne de caractères.

Voir Aussi
Exemple
print mid("Bonjour", 2, 3)
print mid("Bonjour", 2, 999)

Affichera :

onj
onjour
2016/01/01 22:44

Minute

Format

minute
minute()

Description

Renvoie la minute courante de l'horloge système (0-59).

Exemple
# affiche la date
dim mois$(12)
mois$ = {"janvier", "février", "mars", "avril", "mai", "juin", "juillet", "août", "septembre", "octobre", "novembre", "décembre"}
d = day()
if d=1 then
   ier$="er"
else
   ier$=""
endif
print d + ier$ + " " + mois$[month()] + " " + year()
# affiche l'heure
print  hour() + ":" + right("0" + minute(), 2) + ":" + right("0" + second(), 2)

affichera quelque chose comme ceci :

1er mai 2013
21:47:04
Voir aussi
Première version

0.9.4

2016/01/01 22:44

Month

Format

month
month()

Description

Renvoie le mois en cours de l'horloge système (0-11 : 0=janvier, 1=février, … 11=décembre).

Exemple
cls
dim les_mois$(12)
les_mois$ = {"janvier", "février", "mars", "avril", "mai", "juin", "juillet", "août", "septembre", "octobre", "novembre", "décembre"}
d=day()
if d=1 then
   ier$="er"
else
   ier$=""
endif
print day() + ier$ + " " + les_mois$[month()] + " " + year()

affichera par exemple :

1er mai 2013
Voir aussi
Première version

0.9.4

2016/01/01 22:44

Mouseb

Format

mouseb
mouseb()

Description

Retourne le bouton de la souris actuellement pressé (Si la souris se trouve sur la fenêtre d'affichage graphique). Retourne 0 si aucun click n'a été enregistré. Si plusieurs boutons ont été pressés, la valeur retournée est la somme de tous les boutons pressés.

Valeurs Retournées
ValeurBouton de la souris pressé
0Aucun
1Gauche
2Droit
4Centre
Voir Aussi
Disponible à partir de la version

0.9.4d

2016/01/01 22:44

Mousex

Format

mousex
mousex()

Description

Retourne la position en x actuelle ou bien la dernière position en x connue du pointeur de la souris sur la fenêtre d'affichage graphique.

Voir Aussi
Disponible à partir de la version

0.9.4d

2016/01/01 22:45

Mousey

Format

mousey
mousey()

Description

Retourne la position en y actuelle ou bien la dernière position en y connue du pointeur de la souris sur la fenêtre d'affichage graphique.

Voir Aussi
Disponible à partir de la version

0.9.4d

2016/01/01 22:45

NetClose

Format

netclose
netclose ( )
netclose numero_de_socket
netclose ( numero_de_socket )

Description

Ferme la connexion réseau (socket) spécifée. si numero_de_socket n'est pas spécifié, zéro (0) est utilisé par défaut.

Exemple

Voir la page NetConnect.

Voir Aussi
Disponible à partir de la version

0.9.6.31

2016/01/01 22:45

NetConnect

Format

netconnect server_name, port_number
netconnect ( server_name, port_number )
netconnect socket_number, server_name, port_number
netconnect ( socket_number, server_name, port_number )

Description

Ouvre une connexion (client) réseau sur un serveur. Le paramètre server_name donne l'adresse IP ou le nom d’hôte du serveur, tandis que port_number donne le numéro de port spécifique sur lequel la connexion doit être établie. Si le numéro de socket socket_number n'est pas spécifié, zéro (0) est utilisé par défaut.

Exemple

Ouvrez deux instances de BASIC-256 sur un même ordinateur. Collez le code “serveur” dans une instance et collez le code “client” dans l'autre. Lancez le code “serveur” en premier, puis le “client”. Vous pouvez voir les messages envoyés de l'un à l'autre des deux processus.

Code Serveur
# Récupère un message et répond
print "Attente de connexion"
netlisten 9997
print "j'ai la connexion"
do
   while not netdata
      pause .1
      print ".";
   end while
   n$ = netread
   print n$
   netwrite "J'ai reçu '" + n$ + "'."
until n$ = "fin"
netclose

Affichera

Attente de connexion
j'ai la connexion
.1 Coucou
....2 Coucou
........3 Coucou
..........4 Coucou
.....5 Coucou
.......6 Coucou
....7 Coucou
..........8 Coucou
....9 Coucou
.....10 Coucou
.fin
Code Client
# Attendre un message de l'utilisateur et l'envoyer au serveur
input "entrer un message?", m$
netconnect "127.0.0.1", 9997
for t = 1 to 10
   pause rand
   netwrite t + " " + m$
   print netread
next t
netwrite "fin"
print netread
netclose

Affichera

entrer un message?Coucou
J'ai reçu '1 Coucou'.
J'ai reçu '2 Coucou'.
J'ai reçu '3 Coucou'.
J'ai reçu '4 Coucou'.
J'ai reçu '5 Coucou'.
J'ai reçu '6 Coucou'.
J'ai reçu '7 Coucou'.
J'ai reçu '8 Coucou'.
J'ai reçu '9 Coucou'.
J'ai reçu '10 Coucou'.
J'ai reçu 'end'.
Voir Aussi
Disponible à partir de la version

0.9.6.31

2016/01/01 22:45

NetData

Format

netdata
netdata ( )
netdata socket_number
netdata ( socket_number )

Description

Retourne vrai (1) si il y a une donnée au moins à lire avec la fonction NetRead, retourne faux (0) sinon. Si socket_number n'est pas spécifié zéro (0) est utilisé par défaut.

Exemple

Voir la page NetConnect.

Voir Aussi
Disponible à partir de la version

0.9.6.31

2016/01/01 22:45

NetListen

Format

netlisten port_number
netlisten ( port_number)
netlisten socket_number, port_number
netlisten ( socket_number, port_number)

Description

Écoute le port réseau spécifique port_number dans l'attente d'une connexion réseau (fonctionnement serveur) et ouvre la connexion. Si socket_number n'est pas spécifié, zéro (0) est utilisé par défaut.

Exemple

Voir la page NetConnect.

Voir Aussi
Disponible à partir de la version

0.9.6.31

2016/01/01 22:45

NetRead

Format

netread
netread ( )
netread ( socket_number )

Description

Retourne une chaîne de caractères contenant les données lues depuis une connexion réseau. Cette fonction est bloquante (elle attend qu'une données soit reçue). Si socket_number n'est par fourni, zéro (0) est utilisé par défaut.

Exemple

Voir la page NetConnect.

Voir Aussi
Disponible depuis la version

0.9.6.31

2016/01/01 22:45

NetWrite

Format

netwrite string
netwrite ( string )
netwrite socket_number, string
netwrite ( socket_number, string )

Description

Envoie une chaîne de caractères vers une connexion réseau ouverte. Si socket_number n'est pas fourni, zéro (0) est utilisé par défaut.

Exemple

Voir la page NetConnect.

Voir Aussi
Disponible depuis la version

0.9.6.31

2016/01/01 22:45

Open

Format

open nomfichier
open(nomfichier)
open numerofichier, nomfichier
open(numerofichier, nomfichier)
openb nomfichier
openb(nomfichier)
openb numerofichier, nomfichier
openb(numerofichier, nomfichier)

Description

Ouvre un fichier pour la lecture/écriture. Le nomfichier est spécifié sous forme d'une chaîne de caractères, et peut contenir un chemin d'accès relatif ou absolu. Si aucun numerofichier n'est spécifié le numéro zéro (0) sera utilisé par défaut. Openb ouvre le fichier en mode bianire (“binary safe”). Cet type d'ouverture de fichiers est recommandé pour les fichiers dont on accède à l'aide grâce au fonctions Readbyte et Writebyte.

Remarque

BASIC256 peut ouvrir jusqu'à 8 fichiers en même temps. Les fichiers peuvent être numérotés de 0 à 7. L'ouverture d'un fichier avec le numéro d'un fichier déjà ouvert provoque la fermeture de ce dernier.

Voir Aussi
2016/01/01 22:45

OffError

Format

offerror

Description

Arrête le gestionnaire d'erreur mis en place par “Onerror” et restaure la gestion des erreurs par défaut.

Exemple

Voir l’exemple de la page Codes d'Erreurs.

Voir Aussi
Disponible à partir de la version

0.9.6z

2016/01/01 22:45

OnError

Format

onerror etiquette

Description

Met en place un gestionnaire d'erreur d'exécution personnalisé. Toute erreur d’exécution survenant après l'appel de cette fonction entraînera l'appel de la routine commençant à l'étiquette passée en paramètre. Il est possible de reprendre le déroulement normal du programme à l’instruction qui suit celle qui a provoqué l’erreur grâce à l'instruction Return placée dans le gestionnaire d'erreur.

Exemple

Voir l'exemple de la page Codes d'Erreurs.

Voir Aussi
Disponible à partir de la version

0.9.6z

2016/01/01 22:45

Pause

Format

pause seconds
pause (seconds)

Description

Stoppe l'exécution pendant un certain nombre de secondes. L'argument seconds peut être à virgule, donc il est possible d'avoir une précision inférieure à la seconde.

Exemple
print "Début de l'attente"
pause 0.5
print "Nous avons attendu 1/2 seconde, c'était long ?"
2016/01/01 22:45

Pixel

Format

pixel (x, y )

Description

Retourne la valeur RGB du pixel aux coordonnés x,y . Si le pixel n'a jamais été dessiné depuis le dernier appel à la commande Clg ou si il a été dessiné avec la couleur CLEAR, cette fonction retournera -1.

Voir Aussi

Rgb

Disponible depuis la version

0.9.5m

2016/01/01 22:45

Plot

Format

plot x, y
plot ( x, y )

Description

Attribue la couleur courante au pixel situé aux coordonnés x,y.

2016/01/01 22:45

Poly

Format

poly variable_tableau_numerique
poly {x1, y1, x2, y2, x3, y3 …}

Description

Trace un polygone. Les sommets du polygone sont donnés par des coordonnées x,y stockées à la suite les unes des autres dans un tableau. La taille du tableau divisée par 2 définie le nombre de sommets. Cette fonction peut aussi être appelée avec en paramètre un tableau anonyme ( une suite de coordonnées x,y enfermées entre des accolades {}).

Remarque

Avant la version 0.9.4 il fallait également passer le nombre de sommets en paramètre.

Voir aussi
Exemple
color blue
rect 0,0,300,300
color green
dim tri(6)
tri = {100, 100, 200, 200, 100, 200}
poly tri
color blue
rect 0,0,300,300
color green
poly {100, 100, 200, 200, 100, 200}

Les deux codes ci-dessus produiront le résultat suivant:

2016/01/01 22:45

Print

Format

print expression [ ; ]

Description

Écrit un texte dans la partie affichage de texte de l'environnement puis saute une ligne. Si le point-virgule (;) est utilisé en fin de commande alors aucune ligne n'est sautée.

Voir Aussi
2016/01/01 22:45

PutSlice

Format

putslice x, y, chainedecaracteres$
putslice x, y, chainedecaracteres$, couleurtransparente

Description

Dessine le graphique stocké dans chainedecaracteres$ sur la fenêtre graphique aux coordonnées x, y. Si couleurtransparente est donnée alors tous les pixels de cette couleur dans chainedecaracteres$ ne seront pas dessinés.

Voir Aussi
Disponible depuis la version

0.9.6b

2016/01/01 22:45

Radians

Format

radians ( expression )

Description

Retourne la conversion en radians de l'angle expression donné en degrés.

Voir Aussi
2016/01/01 22:45

Rand

Format

rand
rand()

Description

Retourne un nombre au hasard entre 0 et 1. La distribution des valeurs est uniforme.

Note

Pour faire un nombre au hasard entre d'autre nombres, il faut multiplier ou ajouter des nombres appropriés. Example: Pour generer un nombre entier entre 0 et 10, utiliser: int(rand * 10).

2016/01/01 22:45

Read

Format

read
read()
read(numerofichier)

Description

Lit et retourne un élément depuis un fichier ouvert. Un élément est une chaîne de caractères séparé par un espace, une tabulation ou un caractère de saut de ligne. Si le numerofichier n'est pas spécifié, le numéro zéro (0) sera utilisé par défaut.

Voir Aussi
2016/01/01 22:45

Readline

Format

readline
readline()
readline(numerofichier)

Description

Lit et retourne une ligne entière depuis un fichier ouvert. Si le numerofichier n'est pas spécifié, le numéro zéro (0) sera utilisé par défaut.

Voir Aussi
2016/01/01 22:45

Rect

Format

rect x,y,largeur,hauteur
rect ( x, y, largeur, hauteur )

Description

Dessine un rectangle de dimensions largeur x hauteur pixels en utilisant la couleur en cours. Le sommet en haut à gauche du rectangle sera positionné aux coordonnées x,y.

Example
color white
rect 0,0,300,300
color red
rect 50,50,150,150
color blue
rect 100,100,150,150
color green
rect 10,140,280,20

Affichera :

2016/01/01 22:45

Redim

Format

redim variablenumerique( entier )
redim variablechainedecaracteres$( entier )
redim variablenumerique( lignes , colonnes )
redim variablechainedecaracteres$( lignes , colonnes )

Description

Redimensionne un tableau déjà créé en préservant les données. Si le tableau est agrandit les nouveaux éléments seront initialisés à zéro (0) ou avec une chaîne de caractères vide. Si un tableau est réduit les éléments en trop seront perdus.

Voir Aussi

Dim

Disponible à partir de la version

0.9.5t

2016/01/01 22:45

Refresh

Format

refresh

Description

Met à jour la fenêtre d'affichage graphique pour dessiner toutes les commandes graphiques passées depuis le dernier appel de refresh.
Cette fonction n'est utilisable qu'en mode Fastgraphics.

Voir Aussi
2016/01/01 22:45

Rem

Format

rem commentaire
# commentaire

Description

Ligne de commentaire pour aider à comprendre le code. Une ligne qui commence par rem ou par # est ignorée par BASIC-256.

2016/01/01 22:45

Reset

Format

reset
reset()
reset(numerofichier)

Description

Efface un fichier ouvert. Toutes les données du fichier sont perdues. Si numerofichier n'est pas spécifié, le numéro zéro (0) sera utilisé par défaut.

Voir Aussi
2016/01/01 22:45

Rgb

Format

rgb(red, green, blue )

Description

Retourne la valeur RGB value d'une couleur formée à partir des composantes de red (rouge), green (vert), et blue (bleu). Les valeurs autorisées pour red, green, et blue sont comprises entre 0 et 255 (0 et 255 inclus).

Voir Aussi
Disponible depuis la version

0.9.5m

2016/01/01 22:45
Format

right( string, length)

Description

Retourne length caractères la partie droite de la chaîne de caractères string.

Voir Aussi
Exemple
print right("Bonjour", 4)

Affichera

jour
Disponible depuis la version

0.9.5b

2016/01/01 22:45

Say

Format

say expression
say ( expression )

Description

Utilise le moteur du système de synthèse vocale (TTS - Text to Speech) pour dire l'expression. Dans GNU/Linux, les bibliothèques FLite ou eSpeak sont nécessaires. Dans Windows, la voix SAPI par défaut actuelle sera utilisée.

Nouveau dans la version

0.9.4

2016/01/01 22:45

Second

Format

second
second()

Description

Renvoie la seconde courante de la minute courante de l'horloge système (0-59).

Exemple
# affiche la date
dim mois$(12)
mois$ = {"janvier", "février", "mars", "avril", "mai", "juin", "juillet", "août", "septembre", "octobre", "novembre", "décembre"}
d = day()
if d=1 then
   ier$="er"
else
   ier$=""
endif
print d + ier$ + " " + mois$[month()] + " " + year()
# affiche l'heure
print  hour() + ":" + right("0" + minute(), 2) + ":" + right("0" + second(), 2)

affichera quelque chose comme ceci :

1er mai 2013
21:47:04
Voir aussi
Première version

0.9.4

2016/01/01 22:45

Seek

Format

seek position
seek ( position )
seek numerofichier, position
seek ( numerofichier, position )

Description

Déplace l'emplacement de lecture/écriture dans un fichier ouvert vers la position donnée (qui est un offset en octets depuis le début du fichier). Si numerofichier n'est pas spécifié, zéro (0) est utilisé par défaut.

Voir Aussi
Disponible depuis la version

0.9.4

2016/01/01 22:45

Sin

Format

sin ( expression )

Description

Calcul et retourne le sinus de expression. Expression doit être exprimé en radians.

Note

La fonction sinus ne produit pas un résultat exacte.

Voir Aussi
Exemple
clg
color black
# On trace une ligne d'axe dans la fenêtre d'affichage graphique
line 0,150,300,150
# On commence à x=0
lastx = 0
lasty = sin(0) * 50 + 150
# Ensuite on trace une ligne entre chaque point de la courbe de la fonction
for x = 0 to 300 step 5
   angle = x / 300 * 2 * pi
   y = sin(angle) * 50 + 150
   line lastx, lasty, x, y
   lastx = x
   lasty = y
next x

Donnera le resultat suivant : Sine Curve

2016/01/01 22:45

Size

Format

size
size()
size(numerofichier)

Description

Retourne la longueur en octets d'un fichier ouvert. Si numerofichier n'est pas spécifié, zéro (0) est utilisé par défaut.

Voir Aussi
Disponible depuis la Version

0.9.4

2016/01/01 22:45

Sound

Format

sound fréquence, durée
sound ( fréquence, durée )
sound ( tableau )
sound tableau
sound {fréquence1, durée1, fréquence2, durée2, …}

Description

Joue un son sur le haut parleur de l'ordinateur. La fréquence est donnée en Hz (Hertz) et la durée en millisecondes (il faut 1000 millisecondes pour faire une seconde). Un tableau ou une liste de fréquences et de durées peuvent aussi être passés en paramètre. Cette dernière façon de procéder permet d'éviter les cliquetis entre les fréquences (qui se produit si on passe plusieurs instructions sound à la suite.
Le support du son a été ajouté sous LINUX à partir de la version 0.9.5g. Sous Windows à partir de la version 0.9.5h sound utilise le périphérique de son par défaut.

Voir Aussi
2016/01/01 22:45

Spritecollide

Format

spritecollide ( sprite1, sprite2)

Description

Cette fonction retourne vrai si les deux “sprites” se chevauchent (ou entrent en collision). Spritecollide suppose que les “sprites” sont compris dans un rectangle correspondant à la taille de l'image chargée. Les chevauchements sont calculés en utilisant ces rectangles. Pour les “sprites” de forme ronde ou plus tarabiscotés l'utilisation de cette fonction peut conduire à des sur-détections (les rectangles se chevauchent mais pas les “sprites”).

Voir Aussi
Disponible à partir de la version

0.9.6n

2016/01/01 22:45

Spritedim

Format

spritedim n
spritedim ( n )

Description

Créé n emplacements en mémoire pour les “sprites”. Dans les programmes l’accès aux “sprites” passe par l'utilisation d'un nombre compris entre 0 et n-1.

Voir Aussi
Disponible à partir de la version

0.9.6n

2016/01/01 22:45

Spriteh

Format

spriteh ( numerosprite )

Description

Retourne la hauteur en pixel du “sprite” numerosprite chargé en mémoire.

Voir Aussi
Disponible à partir de la version

0.9.6n

2016/01/01 22:45

Spritehide

Format

spritehide spritenumber
spritehide ( spritenumber )

Description

Cache un “sprite”. Toutes les informations d'image et de position sont conservés.

Voir Aussi
Disponible à partir de la version

0.9.6n

2016/01/01 22:45

Spriteload

Format

spriteload numerosprite, nomfichier
spriteload ( numerosprite, nomfichier )

Description

Charge une image depuis le fichier nomfichier et la stocke dans le “sprite” numerosprite. Le “sprite” est dès lors actif et déplaçable mais il ne s'affichera à l'écran que lors de l'appel à la fonction Spriteshow.
Spriteload est capable de lire la plupart des formats de fichier image: BMP (Windows Bitmap), GIF (Graphic Interchange Format),JPG/JPEG (Joint Photographic Experts Group), and PNG (Portable Network Graphics).

Voir Aussi
Disponible à partir de la version

0.9.6n

2016/01/01 22:45

Spritemove

Format

spritemove numerosprite, dx, dy
spritemove ( numerosprite, dx, dy )

Description

Déplace le “sprite” numerosprite depuis sa position actuelle du nombre spécifié de pixels dx, dy. Le déplacement est limité à l'écran graphique affiché.

Voir Aussi
Disponible depuis la version

0.9.6n

2016/01/01 22:45

Spriteplace

Format

spriteplace numerosprite, x, y
spriteplace ( numerosprite, x, y )

Description

Place le centre du “sprite” numerosprite à la position de coordonnées x, y. Tout comme la fonction Imgload, le positionnement du “sprite” se fait par rapport à son milieu et non pas par son coin supérieure gauche comme la plupart des autres fonctions graphiques.

Voir Aussi
Disponible à partir de la version

0.9.6n

2016/01/01 22:45

Spriteshow

Format

spriteshow spritenumber
spriteshow ( spritenumber )

Description

Show a hidden sprite.

See Also
New To Version

0.9.6n

2016/01/01 22:45

Spriteslice

Format

spriteslice numerosprite, x, y, largeur, hauteur
spriteslice ( numerosprite, x, y, largeur, hauteur )

Description

Créé un sprite à partir d'une région donné de l'affichage graphique définie par le coin supérieur gauche (x, y), sa largeur et sa hauteur. Le “sprite” est dès lors actif et déplaçable mais il ne s'affichera à l'écran que lors de l'appel à la fonction Spriteshow. Il est recommandé d'effacer la fenêtre graphique avec Clg avant de dessiner le “sprite” puis d'utiliser cette fonction. Les zones non dessinées seront transparentes quand le “sprite” sera affiché à l'écran. Les pixels transparents peuvent également être dessinés avec la couleur CLEAR.

Voir Aussi
Disponible à partir de la version

0.9.6o

2016/01/01 22:45

Spritev

Format

spritev ( nulerosprite )

Description

Retourne vraie si le “sprite” est visible.

Voir aussi
Disponible depuis la version

0.9.6o

2016/01/01 22:45

Spritew

Format

spritew ( spritenumber )

Description

Retourne la largeur en pixel du “sprite” numerosprite chargé en mémoire.

Voir Aussi
Disponible à partir de la version

0.9.6n

2016/01/01 22:45

Spritex

Format

spritex ( numerosprite )

Description

Retourne la coordonnée x du centre du “sprite” numerosprite.

Voir Aussi
Disponible à partir de la version

0.9.6n

2016/01/01 22:45

Spritey

Format

spritey ( numerosprite )

Description

Retourne la coordonnée y du centre du “sprite” numerosprite.

Voir Aussi
Disponible à partir de la version

0.9.6n

2016/01/01 22:45

Stamp

Format

stamp x, y, tableau
stamp x, y, {x1, y1, x2, y2, x3, y3 …}
stamp x, y, echelle, tableau
stamp x, y, echelle, {x1, y1, x2, y2, x3, y3 …}
stamp x, y, echelle, rotation, tableau
stamp x, y, echelle, rotation, {x1, y1, x2, y2, x3, y3 …}

Description

Dessine un polygone dons le coin supérieur gauche sera positionné aux coordonnées x, y. Il est possible de définir une echelle de tracé ( 1 = taille normale )ainsi qu'une rotation définie à partir de l'origine dans le sens des aiguilles d'une montre en radian.
Les sommets du polygone sont donnés par des coordonnées x,y stockées à la suite les unes des autres dans un tableau. La taille du tableau divisée par 2 définie le nombre de sommets. Cette fonction peut aussi être appelée avec en paramètre un tableau anonyme ( une suite de coordonnées x,y enfermées entre des accolades {}).

Voir Aussi
Exemple

Les deux codes ci-dessous produiront le même affichage.

clg
color blue
rect 0,0,300,300
color green
dim tri(6)
tri = {0, 0, 100, 100, 0, 100}
# stamp du triangle en 0,0 (taille normale)
stamp 100, 100, tri
# stamp du triangle en 200,100 (taille moitié)
stamp 200, 100, .5, tri
clg
color blue
rect 0,0,300,300
color green
# stamp du triangle en 0,0 (taille normale)
stamp 100, 100, {0, 0, 100, 100, 0, 100}
# stamp du triangle en 200,100 (taille moitié)
stamp 200, 100, .5, {0, 0, 100, 100, 0, 100}

Le réultat sera:

Disponible depuis la version

0.9.4

2016/01/01 22:45

String

Format

string ( expression )

Description

Returns the string representation of a number.

See Also
2016/01/01 22:45

System

Format

system expression
system ( expression )

Description

Exécute une commande système dans une fenêtre de terminal (invite de commande). ATTENTION: Cela peut être une instruction très dangereuse, à n'utiliser que si vous savez exactement ce que vous faites.

Disponible depuis la version

0.9.5h

2016/01/01 22:45

Tan

Format

tan ( expression )

Description

Calcul et retourne la tangente de expression qui doit être donné en radians.

Remarque

La fonction tangente ne produit pas un résultat exacte.

Voir Aussi
Example
clg
color black
# On trace l'axe des x
line 0,150,300,150
# on calcul le premier point
lastx = 0
lasty = tan(0) * 50 + 150
# on trace une ligne entre chaque point de la courbe
for x = 0 to 300 step 5
   angle = x / 300 * 2 * pi
   y = tan(angle) * 50 + 150
   line lastx, lasty, x, y
   lastx = x
   lasty = y
next x

Donnera le résultat suivant:
tan.jpg

2016/01/01 22:45

Text

Format

text x, y, chainedecaracteres
text ( x, y, chainedecaracteres )

Description

Dessine le texte chainedecaracteres dans la fenêtre graphique aux coordonnées x, y en utilisant la couleur courante (définie par Color), et la police de caractère courante (définie par Font).

Example
color grey
rect 0,0,graphwidth,graphheight
color red
font "Times New Roman",18,50
text 10,100,"This is Times New Roman"
color darkgreen
font "Tahoma",28,100
text 10,200,"This is BOLD!"

Affichera:

Voir Aussi
Disponible à partir de la version

0.9.4

2016/01/01 22:45

Upper

Format

upper ( string )

Description

Retourne la chaîne de caractère string avec tous les caractères alphabétiques convertis en majuscule.

See Also
Example
print upper("La Plage Et Le Soleil !")

Affichera :

LA PLAGE ET LE SOLEIL !
New To Version

0.9.5e

2016/01/01 22:45

Volume

Format

volume niveau
volume ( niveau )

Description

Ajuste le volume sonore des notes jouées par la commande Sound. Le volume niveau est une valeur numérique comprise entre 0 et 10. Le volume par défaut est 5.

Voir Aussi
Disponible à partir de la version

0.9.5i

2016/01/01 22:45

WAVplay

Format

wavplay nom_de_fichier
wavplay ( nom_de_fichier )

Description

Joue le fichier audio WAV nom_de_fichier en arrière plan (de façon asynchrone).

Voir Aussi
Disponible à partir de la version

0.9.4

2016/01/01 22:45

WAVstop

Format

wavstop

Description

Arrête la diffusion du fichier audio WAV en cours (joué de façon asynchrone).

Voir Aussi
Disponible à partir de la version

0.9.4

2016/01/01 22:45
 

Write

Format

write chainedecaracteres
write ( chainedecaracteres )
write numerofichier, chainedecaracteres
write ( numerofichier, chainedecaracteres )

Description

Écrit chainedecaracteres à la fin d'un fichier ouvert. Si numerofichier n'est pas spécifié, zéro (0) est utilisé par défaut.

See Also
2016/01/01 22:45

Writeline

Format

writeline chainedecaracteres
writeline ( chainedecaracteres )
writeline numerofichier, chainedecaracteres
writeline ( numerofichier, chainedecaracteres )

Description

Écrit chainedecaracteres plus un saut de ligne à la fin d'un fichier ouvert. Si numerofichier n'est pas spécifié, zéro (0) est utilisé par défaut.

Voir Aussi
Disponible depuis la Version

0.9.4

2016/01/01 22:45

Year

Format

year
year()

Description

Renvoie l'année en cours de l'horloge système sur 4 chiffres.

Exemple
print "la date du jour est le ";
print day() + "/" + (month() + 1) + "/" + year()

affiche

la date du jour est le 1/5/2013
Voir aussi
Première version

0.9.4

2016/01/01 22:45
fr/singlepage.txt · Last modified: 2020/02/28 10:46 (external edit)