[ { "table": "opcodes 0x18432", "index": "0x00", "name": "cnul", "operands": "aucun", "effect": "Instruction nulle : un simple RET d'un octet, l'exécution continue à l'octet suivant. Le même handler sert aux opcodes 0x37, 0x8b et esc1[0]. Dans les scripts, « nul » apparaît 53 fois, toujours après « exit » (code mort).", "port_note": "Le port arrêtait toute la VM (état Stopped) au lieu de ne rien faire. À corriger : en faire un no-op." }, { "table": "opcodes 0x18432", "index": "0x01", "name": "cesc1", "operands": "un octet : indice dans la table d'échappement (7 entrées)", "effect": "Lit un octet puis saute via la table d'échappement esc1, sans contrôle de bornes ni test de version.", "port_note": "Même comportement ; seule réserve : esc1[0] est un no-op dans l'original alors que le port y met cnul (voir 0x00)." }, { "table": "opcodes 0x18432", "index": "0x02", "name": "cesc2", "operands": "aucun", "effect": "RET d'un octet, no-op qui ne lit aucun opérande.", "port_note": "Le port lisait un octet supplémentaire et le dispatchait via une table ne contenant que cnul : arrêt de la VM ou erreur fatale PHP, flux désynchronisé d'un octet. À corriger." }, { "table": "opcodes 0x18432", "index": "0x03", "name": "cesc3", "operands": "aucun", "effect": "RET d'un octet, no-op sans opérande.", "port_note": "Le port consommait un octet de plus (table [cnul] seule) : arrêt ou erreur fatale, désynchronisation d'un octet. À corriger." }, { "table": "opcodes 0x18432", "index": "0x04", "name": "cbreakpt", "operands": "aucun", "effect": "Point d'arrêt de debug : no-op, ne fait rien.", "port_note": "" }, { "table": "opcodes 0x18432", "index": "0x05", "name": "cjsr8", "operands": "un octet : décalage signé 8 bits", "effect": "Appel de sous-routine : empile l'adresse de retour (après l'opérande) sur la pile du script (vacc_off diminue de 4), puis saute de l'offset signé.", "port_note": "Le port empile un décalage relatif à pc_org et non une adresse absolue ; cret le rajoute, donc équivalent." }, { "table": "opcodes 0x18432", "index": "0x06", "name": "cjsr16", "operands": "un mot : décalage signé 16 bits", "effect": "Appel de sous-routine : empile l'adresse suivant l'opérande sur la pile du script puis ajoute l'offset signé 16 bits au pointeur d'exécution.", "port_note": "" }, { "table": "opcodes 0x18432", "index": "0x07", "name": "cjsr24", "operands": "3 octets : décalage signé 16 bits, le 3e octet est ignoré", "effect": "Appel de sous-routine avec offset « 24 bits » : seul le mot signé 16 bits est utilisé, le 3e octet est sauté. L'adresse de retour (après les 3 octets) est empilée.", "port_note": "" }, { "table": "opcodes 0x18432", "index": "0x08", "name": "cjmp8", "operands": "un octet : décalage signé 8 bits", "effect": "Saut relatif inconditionnel (depuis la fin de l'opérande).", "port_note": "" }, { "table": "opcodes 0x18432", "index": "0x09", "name": "cjmp16", "operands": "un mot : décalage signé 16 bits", "effect": "Saut relatif inconditionnel de l'offset signé 16 bits.", "port_note": "" }, { "table": "opcodes 0x18432", "index": "0x0a", "name": "cjmp24", "operands": "3 octets : décalage signé 16 bits + 1 octet ignoré", "effect": "Saut relatif ; seul le mot signé 16 bits compte, le 3e octet est ignoré.", "port_note": "" }, { "table": "opcodes 0x18432", "index": "0x0b", "name": "cjsrabs", "operands": "aucun", "effect": "No-op (RET), non utilisé en DOS.", "port_note": "" }, { "table": "opcodes 0x18432", "index": "0x0c", "name": "cjmpabs", "operands": "aucun", "effect": "No-op (RET), non utilisé en DOS.", "port_note": "" }, { "table": "opcodes 0x18432", "index": "0x0d", "name": "cjsrind16", "operands": "aucun", "effect": "No-op (RET), non utilisé en DOS.", "port_note": "" }, { "table": "opcodes 0x18432", "index": "0x0e", "name": "cjsrind24", "operands": "aucun", "effect": "No-op (RET), non utilisé en DOS.", "port_note": "" }, { "table": "opcodes 0x18432", "index": "0x0f", "name": "cjmpind16", "operands": "aucun", "effect": "No-op (RET), non utilisé en DOS.", "port_note": "" }, { "table": "opcodes 0x18432", "index": "0x10", "name": "cjmpind24", "operands": "aucun", "effect": "No-op (RET), non utilisé en DOS.", "port_note": "" }, { "table": "opcodes 0x18432", "index": "0x11", "name": "cret", "operands": "aucun", "effect": "Retour de sous-routine. Si fseq vaut 0 et que vacc_off (s16) >= saversp, quitte la boucle d'exécution comme cstop. Sinon dépile l'adresse de retour, remet à 0 le mot 0x0c s'il égalait le sommet de pile, et incrémente vacc_off de 4.", "port_note": "Le port stocke l'adresse de retour en décalage relatif à pc_org, cohérent avec cjsr ; comportement identique." }, { "table": "opcodes 0x18432", "index": "0x12", "name": "cbz8", "operands": "un octet : décalage signé 8 bits", "effect": "Branchement si zéro : teste la valeur 16 bits de la dernière expression (D7). Si nulle, saute de l'offset s8 ; sinon saute l'opérande.", "port_note": "" }, { "table": "opcodes 0x18432", "index": "0x13", "name": "cbz16", "operands": "un mot : décalage signé 16 bits", "effect": "Branchement si D7 (16 bits) est nul, avec offset s16 ; sinon saute les 2 octets d'opérande.", "port_note": "" }, { "table": "opcodes 0x18432", "index": "0x14", "name": "cbz24", "operands": "3 octets : offset s16 + 1 octet ignoré", "effect": "Branchement si D7 (16 bits) est nul ; offset s16, 3e octet ignoré ; sinon saute les 3 octets.", "port_note": "" }, { "table": "opcodes 0x18432", "index": "0x15", "name": "cbnz8", "operands": "un octet : décalage signé 8 bits", "effect": "Branchement si non zéro : si D7 (16 bits) est différent de 0, saute de l'offset s8 ; sinon saute l'opérande d'un octet.", "port_note": "" }, { "table": "opcodes 0xc6", "index": "0xc6", "name": "cscscale", "operands": "une expression (valeur d'échelle)", "effect": "Si l'identifiant d'écran (vw[0x16]) est non nul : écrit le résultat (DL) à l'octet +0x1c de l'écran, écrit CL (reliquat de l'évaluation, octet bas de D7 précédent) à l'octet d'état +0, puis y positionne le bit 0x80. Le reliquat écrase donc l'état de l'écran (bizarrerie de l'original).", "port_note": "Le port écrit l'échelle en +0x1c mais fait seulement un OR de 0x80 sur l'octet d'état, en conservant les autres bits au lieu de les écraser. À aligner si l'on veut la bizarrerie exacte." }, { "table": "opcodes 0xc7", "index": "0xc7", "name": "creducing", "operands": "deux expressions", "effect": "Range la première expression dans l'octet vram-0x26 et la seconde dans l'octet vram-0x27.", "port_note": "" }, { "table": "opcodes 0xc8", "index": "0xc8", "name": "cscmap", "operands": "une expression (ignorée), un mot, et un second mot si le premier vaut 0", "effect": "Évalue une expression dont le résultat est jeté. Lit un mot ; s'il vaut 0, cx=0 et lit un second mot. Si l'identifiant d'écran est non nul, écrit le mot dans l'écran à +0x42 et cx (entité courante ou 0) à +0x40.", "port_note": "" }, { "table": "opcodes 0xc9", "index": "0xc9", "name": "cscdump", "operands": "aucun", "effect": "No-op (RET).", "port_note": "" }, { "table": "opcodes 0xca", "index": "0xca", "name": "cfindcla", "operands": "une expression : classe recherchée (DL)", "effect": "Parcourt la chaîne d'entités depuis l'indice 0 et retient celles dont l'octet de classe (+0x4c) vaut DL, hors entité courante. Remplit la table des entités trouvées (matent à 0, indices), s'arrête à la première sauf si fallent est non nul, termine par 0xffff, remet fallent à 0 puis exécute crstent (stocke la première trouvée via la table de stockage).", "port_note": "Le port limite la table à 255 entrées ; l'original n'a pas de contrôle. Sans effet pratique." }, { "table": "opcodes 0xcb", "index": "0xcb", "name": "cnearcla", "operands": "une expression (distance), un mot immédiat (classe), puis la cible de stockage", "effect": "Recherche de l'entité la plus proche d'une classe : fview=0, distance mise au carré (mul 16x16 non signé) en valnorme ; même parcours trié que cneartyp mais test sur l'octet de classe +0x4c. Même monde, hors soi, test distance/vue, insertion triée, puis crstent et stockage. Bizarrerie : le mot de classe dans DX est écrasé par l'adresse du tampon, donc la comparaison porte en pratique sur 0x30 (classe 48) quand fallent==0.", "port_note": "Stub dans le port : pour v<60 il ne fait rien et ne lit aucun opérande, le flux du script se désynchronise. À implémenter." }, { "table": "opcodes 0xcc", "index": "0xcc", "name": "cviewcla", "operands": "deux expressions (distance, champ de vue), un mot (classe), puis la cible de stockage", "effect": "Comme cnearcla avec fview=1 : distance au carré en valnorme, deuxième expression dans valchamp, puis même boucle de recherche (test de classe +0x4c avec la même bizarrerie du registre DL), crstent et stockage.", "port_note": "Stub dans le port : ne fait rien et ne lit aucun opérande en v<60, désynchronisation du script. À implémenter." }, { "table": "opcodes 0xcd", "index": "0xcd", "name": "cinstru", "operands": "trois expressions : emplacement (slot), indice de ressource, valeur d'instrument", "effect": "Résout l'adresse de la ressource instrument immédiatement, sans contrôle. Si l'octet à cette adresse vaut 1, 2 ou 6 : slot &= 0x1f, enregistre dans la table des instruments l'adresse+0x10 et la valeur (étendue en signe) pour ce slot.", "port_note": "Le port accepte aussi le type 5, a une branche pour indice négatif (adresse 0, valeur 0), contrôle les bornes dans adresmus, et ne masque pas le slot avec 0x1f (indice >=128 ou <0 provoque une erreur PHP là où l'original boucle sur 32 slots). À corriger." }, { "table": "opcodes 0xce", "index": "0xce", "name": "cminstru", "operands": "trois expressions : slot, indice de ressource, valeur d'instrument", "effect": "Identique à cinstru mais la table de ressources est celle du script principal (main) au lieu du script courant.", "port_note": "Mêmes écarts que cinstru : type 5 accepté, branche d'indice négatif, pas de masque 0x1f, contrôle de bornes dans adresmus." }, { "table": "opcodes 0xcf", "index": "0xcf", "name": "cordspr", "operands": "une expression", "effect": "Range le résultat dans l'octet vram-0x2b (ordre des sprites).", "port_note": "" }, { "table": "opcodes 0xd0", "index": "0xd0", "name": "calign", "operands": "deux expressions", "effect": "Première expression : encode un alignement selon le bit le plus fort de DL (0x10 donne 4, 8 donne 3, 4 donne 2, 2 donne 1, sinon 0), écrit à vram-0x2c. Seconde expression : écrite à vram-0x2d.", "port_note": "" }, { "table": "opcodes 0xd1", "index": "0xd1", "name": "cbackstar", "operands": "six expressions", "effect": "Range les six valeurs dans des mots globaux (seul le premier est relu), mot final à 0. Si l'identifiant d'écran est >= 0 (signé) : octet d'écran +1 &= 0xe7 ; si la première valeur est non nulle, +1 |= 0x18.", "port_note": "Le port teste la sixième valeur au lieu de la première et, si non nulle, appelle en plus rescmode qui écrit numelem du premier sprite de l'écran, ce que l'original ne fait pas. À corriger." }, { "table": "opcodes 0xd2", "index": "0xd2", "name": "cstarring", "operands": "huit expressions", "effect": "Range huit expressions dans des mots globaux consécutifs, sans autre effet ; ces valeurs ne sont jamais relues.", "port_note": "" }, { "table": "opcodes 0xd3", "index": "0xd3", "name": "cengine", "operands": "aucun", "effect": "No-op (RET).", "port_note": "" }, { "table": "opcodes 0xd4", "index": "0xd4", "name": "cautobase", "operands": "aucun", "effect": "No-op (RET).", "port_note": "" }, { "table": "opcodes 0xd5", "index": "0xd5", "name": "cquality", "operands": "une expression (résultat jeté)", "effect": "Évalue une expression et jette le résultat ; aucun effet.", "port_note": "" }, { "table": "opcodes 0xd6", "index": "0xd6", "name": "chsprite", "operands": "quatre expressions", "effect": "La première est rangée dans l'octet vram-0x2f ; les trois suivantes sont évaluées puis jetées.", "port_note": "" }, { "table": "opcodes 0xd7", "index": "0xd7", "name": "cselpalet", "operands": "une expression", "effect": "Écrit la valeur (sans masque) dans le drapeau global « skip » de palette, utilisé une fois par le chargeur de palette : à 0 avec une ressource commençant par 0xfe, la palette est appliquée ; le drapeau est ensuite remis à 0.", "port_note": "" }, { "table": "opcodes 0xd8", "index": "0xd8", "name": "clinepalet", "operands": "deux expressions", "effect": "Évalue deux expressions sans aucun effet en DOS (palette par ligne non gérée).", "port_note": "" }, { "table": "opcodes 0xd9", "index": "0xd9", "name": "cautomode", "operands": "une expression (résultat jeté)", "effect": "Évalue une expression et jette le résultat ; aucun effet.", "port_note": "Le port ne lit l'opérande que pour la version 3DO ; en DOS il ne lit rien, l'opérande reste dans le flux (désynchronisation). Grammar.php ne lui donne pas d'opérande. À corriger." }, { "table": "opcodes 0xda", "index": "0xda", "name": "cautofile", "operands": "une expression de type chaîne", "effect": "Échange les pointeurs des tampons de chaînes (sd7/sd6), sans les restaurer, puis évalue une expression de chaîne. Rien d'autre.", "port_note": "" }, { "table": "opcodes 0xdb", "index": "0xdb", "name": "ccancel", "operands": "aucun", "effect": "Active ferase, puis exécute le handler cerase (opcode 0x4a) : les éléments d'écran de l'entité courante sont rendus à la liste libre et détachés de l'écran immédiatement, au lieu d'être marqués pour un effacement différé ; ferase est ensuite remis à 0.", "port_note": "Stub dans le port : fonction vide (pas de désynchronisation) mais les sprites ne sont pas annulés. À implémenter." }, { "table": "opcodes 0x6e", "index": "0x6e", "name": "cnoise", "operands": "quatre expressions", "effect": "Évalue quatre expressions puis retourne. En DOS v31 aucun son n'est produit et aucune variable n'est écrite.", "port_note": "Le port lit bien les 4 opérandes (pas de désynchronisation) mais lance un canal de bruit (runson), alors que l'original reste silencieux. À corriger." }, { "table": "opcodes 0x6f", "index": "0x6f", "name": "cinitab", "operands": "un mot : offset (signé), un mot : nombre d'octets, puis count-1 octets inline", "effect": "Copie count-1 octets du script (inline) vers vars[offset] et avance le pointeur d'exécution après eux. Avec count=0 la copie déborde (bug de l'original).", "port_note": "Non implémenté (MISSING) en v31 : aucun opérande consommé, le script se désynchronise. À implémenter." }, { "table": "opcodes 0x70", "index": "0x70", "name": "cfopen", "operands": "nom : chaîne inline terminée par NUL puis un mot (mode), ou forme 0xff : expression de chaîne (nom) puis expression (mode)", "effect": "Ouvre un fichier. Mode 0x100 : crée s'il n'existe pas. 0x200 : crée/tronque s'il existe. Sinon ouverture en lecture/écriture. 0x800 : lit 12 octets d'en-tête ; 'PB60' donne typepack=0xa0, longpack big-endian ; 'PW60' donne wordpack=1 ; sinon rembobine à l'offset 0. 0x400 : positionne en fin de fichier. Échec : erreur 1.", "port_note": "Écart réel : sans en-tête PB60/PW60 le port ne rembobine pas ; canyon.dat (mode 2050, non compressé) est lu décalé de 12 octets. Aussi : mode 2 ouvert en lecture seule, 0x200 sur fichier absent crée le fichier au lieu d'une erreur, 0x400 en 'ab'. Seul le rembobinage est à corriger en priorité." }, { "table": "opcodes 0x71", "index": "0x71", "name": "cfclose", "operands": "aucun", "effect": "Ferme le fichier courant ; erreur 0xe en cas d'échec.", "port_note": "" }, { "table": "opcodes 0x72", "index": "0x72", "name": "cfcreat", "operands": "nom inline terminé par NUL, puis un mot (ignoré)", "effect": "Crée ou tronque un fichier vide du nom donné, puis le referme. Erreur 8 en cas d'échec de création.", "port_note": "Non implémenté en v31 (MISSING) : aucun opérande consommé (désynchronisation) et aucun fichier créé. À implémenter." }, { "table": "opcodes 0x73", "index": "0x73", "name": "cfdel", "operands": "nom inline terminé par NUL", "effect": "Supprime le fichier du nom donné. Erreur 9 en cas d'échec. Pas de forme à expression en DOS.", "port_note": "Non implémenté en v31 (MISSING) : aucun opérande consommé (désynchronisation) et rien n'est supprimé. À implémenter." }, { "table": "opcodes 0x74", "index": "0x74", "name": "cfreadv", "operands": "aucun (cible de stockage via la suite de cstore)", "effect": "Lit 2 octets du fichier courant, valeur 16 bits big-endian dans D7, puis continue comme cstore (échange des tampons de chaînes et écriture dans la cible). Erreur 0xd seulement en cas d'erreur de lecture.", "port_note": "Cas limite : sur lecture courte ou fin de fichier, l'original conserve les octets périmés du tampon, le port complète par des zéros." }, { "table": "opcodes", "index": "0x75", "name": "cfwritev", "operands": "une expression (valeur 16 bits)", "effect": "Évalue une expression et écrit le mot 16 bits obtenu, en gros-boutiste (octets D7 inversés), dans le fichier ouvert. Une erreur d'écriture déclenche l'erreur 7.", "port_note": "Le port écrit les mêmes octets mais ne vérifie pas l'erreur d'écriture et ne met pas à jour le tampon partagé (sans effet visible)." }, { "table": "opcodes", "index": "0x76", "name": "cfwritei", "operands": "une chaîne immédiate terminée par NUL, lue dans le script", "effect": "Écrit dans le fichier ouvert la chaîne inline, NUL final compris, puis avance le pointeur de script après la chaîne.", "port_note": "Pour la version 31 le port est un stub (« MISSING ») : aucun opérande consommé (désynchronisation du script) et rien n'est écrit. Correction : étendre la branche v>=60 aux versions >=30 (longueur = strlen+1, écriture, avance du pc)." }, { "table": "opcodes", "index": "0x77", "name": "cfreadb", "operands": "un mot : offset de la cellule (si 0, il est relu et basemain sert de base), puis un dword : longueur", "effect": "Lit dans le fichier ouvert un bloc de la longueur donnée vers la cellule désignée (directe ou table indirecte). Dépaquète si typepack, avec unmixword si wordpack, sinon lecture par blocs de 0xFA00. Si la cellule est de taille 2, les mots sont inversés en place. Une cellule indirecte nulle ou négative provoque l'erreur 0x1a sans lire la longueur.", "port_note": "Chemin d'erreur différent : le port teste le second pointeur au lieu du premier et ne lève aucune erreur. Les données normales ne sont pas affectées. Correction optionnelle : tester [cellule] <= 0 d'abord." }, { "table": "opcodes", "index": "0x78", "name": "cfwriteb", "operands": "un mot : offset de la cellule (même résolution que cfreadb), puis un dword : longueur", "effect": "Écrit dans le fichier ouvert un bloc de la longueur donnée depuis la cellule désignée. Si la cellule est de taille 2, les mots sont inversés avant l'écriture puis restaurés. Une cellule indirecte nulle ou négative donne l'erreur 0x1a, longueur non consommée.", "port_note": "Le port lit toujours la longueur en premier, teste le second pointeur au lieu du premier et ne lève pas d'erreur. Le chemin normal écrit les mêmes octets. Correction optionnelle : tester [cellule] <= 0 avant de lire la longueur." }, { "table": "opcodes", "index": "0x79", "name": "cplot", "operands": "deux expressions (x, y)", "effect": "Évalue deux expressions et ne fait rien d'autre : aucun tracé sur la version DOS v31.", "port_note": "" }, { "table": "opcodes", "index": "0x7a", "name": "cdraw", "operands": "deux expressions (la seconde évaluée avec D7 sauvegardé)", "effect": "Évalue deux expressions sans rien dessiner ni modifier d'état.", "port_note": "" }, { "table": "opcodes", "index": "0x7b", "name": "cbox", "operands": "deux expressions", "effect": "Évalue deux expressions, aucun effet (pas de tracé).", "port_note": "" }, { "table": "opcodes", "index": "0x7c", "name": "cboxf", "operands": "deux expressions", "effect": "Évalue deux expressions, aucun effet (pas de rectangle plein).", "port_note": "" }, { "table": "opcodes", "index": "0x7d", "name": "cink", "operands": "une expression (couleur d'encre)", "effect": "Stocke l'octet bas de la valeur dans une globale d'encre qu'aucun autre code ne lit : écriture sans effet.", "port_note": "" }, { "table": "opcodes", "index": "0x7e", "name": "cpset", "operands": "deux expressions (x, y)", "effect": "Évalue deux expressions, sans effet visible sur la version DOS v31.", "port_note": "" }, { "table": "opcodes", "index": "0x7f", "name": "cpmove", "operands": "deux expressions (dx, dy)", "effect": "Évalue deux expressions, sans effet visible sur la version DOS v31.", "port_note": "" }, { "table": "opcodes", "index": "0x80", "name": "cpmode", "operands": "une expression (mode de tracé)", "effect": "Stocke l'octet bas de la valeur dans une globale que nul autre code ne référence : écriture sans effet.", "port_note": "" }, { "table": "opcodes", "index": "0x81", "name": "cpicture", "operands": "une expression", "effect": "Sur DOS v31, évalue une expression et ne fait rien d'autre.", "port_note": "Le port ne gère que la version 10 ; pour la v31 c'est un stub qui ne consomme aucun opérande (désynchronisation si exécuté). Correction : appeler readexec_opername() pour les autres versions." }, { "table": "opcodes", "index": "0x82", "name": "cxyscroll", "operands": "deux expressions (x, y)", "effect": "Évalue deux expressions, sans autre effet.", "port_note": "" }, { "table": "opcodes", "index": "0x83", "name": "clinking", "operands": "une expression", "effect": "Écrit la valeur (16 bits) dans le champ clinking du script courant (vram - 0x2a).", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "0 (code 0x06)", "name": "slocb", "operands": "un mot : offset signé (16 bits) dans les variables locales", "effect": "Stocke l'octet bas de la valeur (D7) à vram + offset (vb[off] = ...), l'offset pouvant sortir de 0..255.", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "1 (code 0x08)", "name": "slocw", "operands": "un mot : offset signé", "effect": "Stocke le mot 16 bits D7 à vram + offset (vw[off] = ...).", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "2 (code 0x0a)", "name": "slocp", "operands": "un mot : offset signé", "effect": "Copie la chaîne évaluée (tampon sd7 après échange par cstore), terminateur compris, vers vram + offset (vs[off] = ...).", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "3 (code 0x0c)", "name": "sloctp", "operands": "un mot : offset signé de la table de chaînes", "effect": "Cible un élément de table de chaînes (ts[...]) : premier indice = D7, indices suivants dépilés de l'accumulateur de mots, avec contrôle des bornes (erreurs 0x17/0x18) et double indirection des tables à pointeurs (erreur 0x1a si nul). Copie ensuite la chaîne évaluée dans l'élément.", "port_note": "Le port lit l'offset non signé : un offset négatif (>= 0x8000) viserait 64 Ko trop haut, et les contrôles de bornes sont absents. Correction : utiliser s16(script_read16()). Sans effet pour le jeu (aucun usage hors 0..255)." }, { "table": "0x189ae (storenames)", "index": "4 (code 0x0e)", "name": "sloctc", "operands": "un mot : offset signé de la table d'octets", "effect": "Cible un élément de table d'octets (tb[...]) : indice = D7 puis mots dépilés de l'accumulateur. Dépile la valeur à stocker et écrit son octet bas.", "port_note": "Offset lu non signé et contrôles d'erreur absents ; sans effet pour l'unique usage du jeu (offset positif 0x183a). Correction : s16 sur l'offset." }, { "table": "0x189ae (storenames)", "index": "5 (code 0x10)", "name": "slocti", "operands": "un mot : offset signé de la table de mots", "effect": "Cible un élément de table de mots (tw[...]) : premier indice doublé, indices suivants dépilés de l'accumulateur. Dépile la valeur et écrit le mot.", "port_note": "Offset non signé et pas de contrôle de bornes ; le jeu n'utilise que des offsets positifs. Correction : s16 sur l'offset." }, { "table": "0x189ae (storenames)", "index": "6 (code 0x12)", "name": "sdirb", "operands": "un octet : offset non signé (0..255)", "effect": "Stocke l'octet bas de D7 à vram + offset (vb[off] = ...).", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "7 (code 0x14)", "name": "sdirw", "operands": "un octet : offset non signé", "effect": "Stocke le mot 16 bits D7 à vram + offset (vw[off] = ...).", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "8 (code 0x16)", "name": "sdirp", "operands": "un octet : offset non signé", "effect": "Copie la chaîne évaluée vers vram + offset (vs[off] = ...).", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "9 (code 0x18)", "name": "sdirtp", "operands": "un octet : offset non signé de la table de chaînes", "effect": "Stocke la chaîne évaluée dans un élément de table de chaînes (ts[...]) adressé par indice(s) évalué(s). L'original contrôle indices et pointeurs nuls (erreurs 0x17/0x18/0x1a).", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "10 (code 0x1a)", "name": "sdirtc", "operands": "un octet : offset non signé de la table d'octets", "effect": "Dépile la valeur de l'accumulateur et stocke son octet bas dans l'élément tb[...] désigné.", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "11 (code 0x1c)", "name": "sdirti", "operands": "un octet : offset non signé de la table de mots", "effect": "Dépile la valeur de l'accumulateur et stocke le mot dans l'élément tw[...] désigné (indice doublé).", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "12 (code 0x1e)", "name": "smainb", "operands": "un mot : offset signé relatif à basemain (variables du script principal)", "effect": "Stocke l'octet bas de D7 à basemain + offset (mb[off] = ...).", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "13 (code 0x20)", "name": "smainw", "operands": "un mot : offset signé relatif à basemain", "effect": "Stocke le mot 16 bits D7 à basemain + offset (mw[off] = ...).", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "14 (code 0x22)", "name": "smainp", "operands": "un mot : offset signé relatif à basemain", "effect": "Copie la chaîne évaluée vers basemain + offset (ms[off] = ...).", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "15 (code 0x24)", "name": "smaintp", "operands": "un mot : offset signé de la table de chaînes, base = basemain", "effect": "Stocke la chaîne évaluée dans un élément de table de chaînes du script principal (mts[...]), indices pris dans D7 puis l'accumulateur.", "port_note": "Le port lit l'offset non signé : différence uniquement pour les offsets >= 0x8000, que le jeu n'utilise pas. Correction : s16(script_read16())." }, { "table": "0x189ae (storenames)", "index": "16 (code 0x26)", "name": "smaintc", "operands": "un mot : offset signé de la table d'octets, base = basemain", "effect": "Dépile la valeur et stocke son octet bas dans un élément de table d'octets du script principal (mtb[...]).", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "17 (code 0x28)", "name": "smainti", "operands": "un mot : offset signé de la table de mots, base = basemain", "effect": "Dépile la valeur et stocke le mot dans un élément de table de mots du script principal (mtw[...]), indice doublé.", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "18 (code 0x2a)", "name": "shimb", "operands": "deux mots signés : off1 (variable locale contenant un numéro d'entité), off2 (offset dans le script cible)", "effect": "Écrit l'octet bas de D7 dans les variables d'un autre script (hb[var, off] = ...) : le mot signé à vram+off1 indexe la table des entités ; une valeur négative donne l'erreur 0x1f. Si le vram de la cible est <= 0 (script mort ou non démarré), l'écriture est ignorée.", "port_note": "Divergence : le test « vram <= 0 » n'existe que pour la version >= 60 et l'entité est lue non signée. Sur la v31, une cible morte fait écrire l'octet à mem[off2], corrompant la mémoire basse. Correction : toujours ignorer si vram <= 0 et lire l'entité en signé." }, { "table": "0x189ae (storenames)", "index": "19 (code 0x2c)", "name": "shimw", "operands": "deux mots signés : off1 (variable locale contenant un numéro d'entité), off2 (offset dans le script cible)", "effect": "Comme shimb mais écrit un mot 16 bits (hw[var, off] = ...). Entité négative : erreur 0x21. Écriture ignorée si le vram de la cible est <= 0.", "port_note": "Même défaut que shimb : sur la v31, une cible morte fait écrire 2 octets à mem[off2], et l'entité est lue non signée. Correction : return si vram <= 0 pour toutes les versions, s16 sur l'entité." }, { "table": "0x189ae (storenames)", "index": "20 (code 0x2e)", "name": "shimp", "operands": "deux mots signés : off1 (variable locale contenant un numéro d'entité), off2 (offset dans le script cible)", "effect": "Copie la chaîne évaluée dans les variables d'un autre script (hs[var, off] = ...) : cible = vram de l'entité (sans test de nullité), destination = cible + off2, terminateur compris.", "port_note": "Stub dans le port : fonction vide, aucun opérande consommé (désynchronisation si utilisé ; la grammaire le déclare aussi sans opérandes). Non utilisé par le jeu. À implémenter avec ses 4 octets d'opérandes." }, { "table": "0x189ae (storenames)", "index": "21 (code 0x30)", "name": "shimtp", "operands": "deux mots : offset de la table dans le script cible, puis offset de la variable locale contenant le numéro d'entité", "effect": "Stocke la chaîne évaluée dans un élément de table de chaînes d'un autre script (hts[...]) : base = vram de l'entité (sans test de nullité), indices pris dans D7 puis l'accumulateur.", "port_note": "Stub dans le port : aucun opérande consommé, grammaire sans opérandes. Non utilisé par le jeu. À implémenter (opérandes « w w »)." }, { "table": "0x189ae (storenames)", "index": "22 (code 0x32)", "name": "shimtc", "operands": "deux mots : offset de la table dans le script cible, offset de la variable d'entité", "effect": "Dépile la valeur et stocke son octet bas dans un élément de table d'octets d'un autre script (htb[...]), base = vram de l'entité.", "port_note": "Stub dans le port : aucun opérande consommé et la valeur empilée par seval reste sur l'accumulateur. Non utilisé par le jeu. À implémenter comme shimtp avec tabchar." }, { "table": "0x189ae (storenames)", "index": "23 (code 0x34)", "name": "shimti", "operands": "deux mots : offset de la table dans le script cible, offset de la variable d'entité", "effect": "Dépile la valeur et stocke le mot dans un élément de table de mots d'un autre script (htw[...]), indice doublé, base = vram de l'entité.", "port_note": "Stub dans le port : fonction vide. Non utilisé par le jeu. À implémenter avec tabint, dépilement et écriture 16 bits." }, { "table": "0x189ae (storenames)", "index": "24 (code 0x36)", "name": "spile", "operands": "aucun", "effect": "Empile la valeur 16 bits D7 sur l'accumulateur de mots.", "port_note": "" }, { "table": "0x189ae (storenames)", "index": "25 (code 0x38)", "name": "seval", "operands": "une expression terminée par ofin, puis un octet : code de la cible de stockage suivante", "effect": "Remet l'accumulateur à son origine, empile D7, évalue la chaîne d'indices jusqu'à ofin, puis lit le code suivant et saute vers la cible de stockage (stockages de tables ts/tb/tw/mts/mtb/mtw).", "port_note": "Le port ne remet l'accumulateur à zéro que pour la version >= 60 et cstore ne le fait pas non plus : un déséquilibre de l'accumulateur dérive d'un stockage au suivant. Correction : toujours réinitialiser acc à acc_org dans seval et cstore." }, { "table": "0x189ae (storenames)", "index": "26 (code 0x3a)", "name": "ofin", "operands": "aucun", "effect": "Termine la boucle d'évaluation d'une expression. Comme cible de stockage il n'est jamais utilisé : il n'apparaît qu'en fin de chaîne seval.", "port_note": "" }, { "table": "0x18a26 (addnames)", "index": "0 (code 0x06)", "name": "alocb", "operands": "un mot : offset signé dans les variables locales", "effect": "Ajoute l'octet bas de D7 à l'octet vram + offset (vb[off] += ..., retour sur 8 bits). Le drapeau zéro résultant est celui que teste cloop.", "port_note": "" }, { "table": "0x18a26 (addnames)", "index": "1 (code 0x08)", "name": "alocw", "operands": "un mot : offset signé", "effect": "Ajoute le mot 16 bits D7 au mot vram + offset (vw[off] += ...). Le drapeau zéro est testé par cloop.", "port_note": "" }, { "table": "0x18a26 (addnames)", "index": "2 (code 0x0a)", "name": "alocp", "operands": "un mot : offset signé", "effect": "Concatène la chaîne évaluée à la fin de la chaîne située à vram + offset (vs[off] += ...), NUL compris, sans limite de longueur. Le drapeau zéro n'a pas de sens ici.", "port_note": "" }, { "table": "0x18a26 (addnames)", "index": "3 (code 0x0c)", "name": "aloctp", "operands": "un mot : offset signé de la table de chaînes", "effect": "Concatène la chaîne évaluée à un élément de table de chaînes (ts[...] += ...) : indice D7 multiplié par la taille d'élément, dimensions suivantes dépilées, contrôles de bornes (erreurs 0x17/0x18/0x1a).", "port_note": "Le port lit l'offset non signé (différence seulement pour >= 0x8000) et sans contrôle de bornes. Non utilisé par le jeu. Correction : s16(script_read16())." }, { "table": "0x18a26 (addnames)", "index": "4 (code 0x0e)", "name": "aloctc", "operands": "un mot : offset signé de la table d'octets", "effect": "Dépile la valeur et l'ajoute à l'octet de l'élément tb[...] désigné (bornes contrôlées, erreurs fatales 0x17/0x18/0x1a). Positionne le drapeau zéro.", "port_note": "Offset non signé, contrôles absents, et le port ne positionne pas le drapeau zéro (utile seulement pour cloop). Non utilisé par le jeu. Correction : s16 et sr['zero'] après l'addition." }, { "table": "0x18a26 (addnames)", "index": "5 (code 0x10)", "name": "alocti", "operands": "un mot : offset signé de la table de mots", "effect": "Dépile la valeur et l'ajoute au mot de l'élément tw[...] désigné (indice doublé, bornes contrôlées).", "port_note": "Offset non signé, pas de drapeau zéro ni de contrôle de bornes. Non utilisé par le jeu. Correction : s16 et mise à jour de sr['zero']." }, { "table": "0x18a26 (addnames)", "index": "6 (code 0x12)", "name": "adirb", "operands": "un octet : offset non signé (0..255)", "effect": "Ajoute l'octet bas de D7 à l'octet vram + offset (vb[off] += ...). Le drapeau zéro sert à cloop.", "port_note": "" }, { "table": "0x18a26 (addnames)", "index": "7 (code 0x14)", "name": "adirw", "operands": "un octet : offset non signé", "effect": "Ajoute le mot 16 bits D7 au mot vram + offset (vw[off] += ...). Le drapeau zéro sert à cloop.", "port_note": "" }, { "table": "0x18a26 (addnames)", "index": "8 (code 0x16)", "name": "adirp", "operands": "un octet : offset non signé", "effect": "Concatène la chaîne évaluée à la chaîne vram + offset (vs[off] += ...).", "port_note": "" }, { "table": "0x18a26 (addnames)", "index": "9 (code 0x18)", "name": "adirtp", "operands": "un octet : décalage non signé dans vram", "effect": "Lit une cellule chaîne via ce décalage (relatif à vram) puis concatène à cette chaîne la chaîne d'expression courante (oldsd7, buffer 0x16010).", "port_note": "" }, { "table": "0x18a26 (addnames)", "index": "10 (code 0x1a)", "name": "adirtc", "operands": "un octet : décalage dans vram (cellule octet de tableau)", "effect": "Résout la cellule octet (indices pris dans dx et la pile d'expression), dépile une valeur et l'ajoute à l'octet ciblé (add 8 bits).", "port_note": "Le drapeau ZF n'est pas mis à jour par le port (sans effet pour le jeu) ; contrôles de bornes fatals non reproduits." }, { "table": "0x18a26 (addnames)", "index": "11 (code 0x1c)", "name": "adirti", "operands": "un octet : décalage dans vram (cellule mot de tableau)", "effect": "Résout la cellule mot (index*2), dépile une valeur et l'ajoute au mot ciblé (add 16 bits).", "port_note": "ZF non mis à jour et erreurs de bornes non reproduites (sans effet pour le jeu)." }, { "table": "0x18a26 (addnames)", "index": "12 (code 0x1e)", "name": "amainb", "operands": "un mot signé 16 bits : décalage relatif à basemain", "effect": "Ajoute l'octet de D7 à l'octet situé à basemain+décalage (add 8 bits) et positionne ZF, utilisable par un loop.", "port_note": "Le port fait l'addition mais ne met pas à jour sr['zero'] ; un loop sur mb[..] testerait un drapeau périmé (jamais utilisé par le jeu). Correction prévue." }, { "table": "0x18a26 (addnames)", "index": "13 (code 0x20)", "name": "amainw", "operands": "un mot signé 16 bits : décalage relatif à basemain", "effect": "Ajoute D7 (16 bits) au mot situé à basemain+décalage et positionne ZF.", "port_note": "Le port ne met pas à jour sr['zero'] (n'importe que pour un loop sur mw, inutilisé). Correction prévue." }, { "table": "0x18a26 (addnames)", "index": "14 (code 0x22)", "name": "amainp", "operands": "un mot signé 16 bits : décalage relatif à basemain", "effect": "Concatène la chaîne d'expression courante (oldsd7) à la chaîne située à basemain+décalage.", "port_note": "" }, { "table": "0x18a26 (addnames)", "index": "15 (code 0x24)", "name": "amaintp", "operands": "un mot signé 16 bits : décalage du tableau de chaînes dans basemain", "effect": "Résout une cellule de tableau de chaînes (indices en pile, décalage signé) et y concatène la chaîne d'expression courante.", "port_note": "Le port lit le décalage en non signé : différence uniquement pour les décalages >= 0x8000 ; correction prévue (s16)." }, { "table": "0x18a26 (addnames)", "index": "16 (code 0x26)", "name": "amaintc", "operands": "un mot signé 16 bits : décalage du tableau d'octets dans basemain", "effect": "Résout la cellule octet du tableau (décalage signé, bornes vérifiées), dépile une valeur et l'ajoute à cet octet.", "port_note": "Décalage lu en non signé, sans ZF ni erreurs de bornes ; identique pour les décalages du jeu (< 0x8000). Parité stricte prévue." }, { "table": "0x18a26 (addnames)", "index": "17 (code 0x28)", "name": "amainti", "operands": "un mot signé 16 bits : décalage du tableau de mots dans basemain", "effect": "Résout la cellule mot (index*2 en 16 bits, dimensions supplémentaires dépilées et multipliées par les dimensions stockées), dépile une valeur et l'ajoute au mot.", "port_note": "Le port multiplie les dimensions en 32 bits et lit le décalage en non signé ; résultats identiques sauf indices hors bornes ou produits > 64K (l'original lève une erreur fatale ou boucle sur 16 bits)." }, { "table": "0x18a26 (addnames)", "index": "18 (code 0x2a)", "name": "ahimb", "operands": "deux mots signés 16 bits : off1 (variable de vram contenant l'id d'un autre script), off2 (décalage dans la vram de ce script)", "effect": "Retrouve la vram d'un autre script (pointeur via la table atent, erreur 0x1f si id invalide) ; si le pointeur est > 0, ajoute l'octet de D7 à l'octet en [vram+off2], sinon ignore l'ajout (les opérandes sont quand même consommés).", "port_note": "Corps vide dans le port pour la version 31 : aucun opérande lu, donc les 4 octets sont exécutés comme opcodes (désynchronisation du script). La branche v10 lit off2 en non signé sans test pointeur > 0. Implémentation complète en cours." }, { "table": "0x18a26 (addnames)", "index": "19 (code 0x2c)", "name": "ahimw", "operands": "deux mots signés 16 bits : off1 (variable avec l'id du script), off2 (décalage dans sa vram)", "effect": "Comme ahimb mais en 16 bits (erreur 0x21) : ajoute D7 au mot en [vram_autre+off2], seulement si le pointeur de vram est > 0.", "port_note": "Le port lit off1 et off2 en non signé et ne teste pas pointeur > 0 : un emplacement de script vide écrit à l'adresse 0+off2 (corruption mémoire) là où l'original ignore ; off2 négatif devient +0xFFxx. Correction en cours (s16, test > 0, ZF)." }, { "table": "0x18a26 (addnames)", "index": "20 (code 0x2e)", "name": "ahimp", "operands": "deux mots signés 16 bits : off1 (variable avec l'id du script), off2 (décalage dans sa vram)", "effect": "Retrouve la vram de l'autre script, ajoute off2 à son adresse (sans test > 0) et concatène la chaîne d'expression courante à la chaîne ainsi désignée.", "port_note": "Fonction vide dans le port : aucun opérande consommé, désynchronisation du script si elle est atteinte. Implémentation en cours." }, { "table": "0x18a26 (addnames)", "index": "21 (code 0x30)", "name": "ahimtp", "operands": "deux mots signés 16 bits : A (décalage du tableau), B (variable contenant l'id du script)", "effect": "Prend la vram de l'autre script désignée par la variable B, résout la cellule de tableau de chaînes à l'offset A (indices en pile) et y concatène la chaîne d'expression courante.", "port_note": "" }, { "table": "0x18a26 (addnames)", "index": "22 (code 0x32)", "name": "ahimtc", "operands": "deux mots signés 16 bits : A (décalage du tableau d'octets), B (variable contenant l'id du script)", "effect": "Résout une cellule octet dans la vram d'un autre script (indices depuis dx et la pile), dépile une valeur et l'ajoute à cet octet.", "port_note": "Fonction vide dans le port : ni opérandes lus ni dépilement, d'où désynchronisation du script et déséquilibre de la pile. Implémentation en cours." }, { "table": "0x18a26 (addnames)", "index": "23 (code 0x34)", "name": "ahimti", "operands": "deux mots signés 16 bits : A (décalage du tableau de mots), B (variable contenant l'id du script)", "effect": "Comme ahimtc mais sur une cellule mot (index*2) : dépile une valeur et l'ajoute au mot de l'autre script.", "port_note": "Fonction vide dans le port (aucun opérande, aucun dépilement) : désynchronisation. Implémentation en cours." }, { "table": "0x18a26 (addnames)", "index": "24 (code 0x36)", "name": "spile", "operands": "aucun", "effect": "Empile la valeur D7 sur la pile d'expression (partagée avec storename 24). Dans le contexte de cadd, la pile vient d'être réinitialisée, donc la valeur est effectivement écartée à l'instruction suivante.", "port_note": "" }, { "table": "0x18a26 (addnames)", "index": "25 (code 0x38)", "name": "aeval", "operands": "aucun opérande propre ; consomme ensuite le flux d'opernames jusqu'à ofin puis un octet de code d'addname", "effect": "Réinitialise la pile d'expression, empile D7, évalue la suite d'opernames jusqu'à ofin, puis lit un octet et saute à la cible addname suivante.", "port_note": "Pour les versions < 60 le port ne réinitialise pas la pile (acc) avant d'empiler : mêmes opérandes et même résultat si la pile est équilibrée, mais les entrées périmées restent. Correction optionnelle." }, { "table": "0x18a26 (addnames)", "index": "26 (code 0x3a)", "name": "ofin", "operands": "aucun", "effect": "Utilisé comme cible d'addname, il abandonne l'adresse de retour de la boucle principale et sort de l'interpréteur : l'exécution du script s'arrête pour cette trame (dans cloop, sortie sans branchement).", "port_note": "Le port ne fait rien (oeval_loop==0, version<60) : le script continue à l'octet suivant. Inutilisé par le jeu ; correction possible." }, { "table": "opcodes", "index": "0x58", "name": "cpredent", "operands": "aucun (suivi de la cible de stockage)", "effect": "Recule le curseur dans la liste d'entités tablent et place l'entité précédente dans D7 (0xFFFF si au début), puis échange les buffers sd7/oldsd7 et exécute le storename suivant.", "port_note": "" }, { "table": "opcodes", "index": "0x59", "name": "cnearent", "operands": "deux expressions : rayon (valnorme = u16*u16), filtre d'entité (forcé à -1 si fallent)", "effect": "Parcourt la chaîne d'entités du script courant et retient celles dont le filtre correspond, du même groupe, différentes de soi et à portée (calcnear). Sans fallent, garde la plus proche ; avec fallent, ajoute toutes les correspondantes puis trie en ordre croissant de distance (tri à bulles répété, tablent suivi). Stocke ensuite via crstent/csuccent.", "port_note": "trinorme() ne fait qu'une seule passe de tri : avec allentity, la liste n'est que partiellement triée. Écarts mineurs dans calcnear (deltas non enroulés en 16 bits, comparaison non signée) et liste plafonnée à 255 au lieu de ~769. Correction en cours." }, { "table": "opcodes", "index": "0x5a", "name": "cneartyp", "operands": "une expression (rayon), puis un mot 16 bits brut inline : identifiant de type", "effect": "Comme cnearent mais filtre sur l'identifiant de type brut (mot en vram-0x10), même groupe, hors soi, à portée ; mêmes modes plus proche / toutes avec tri complet, puis stockage.", "port_note": "Le port masque les id négatifs (&0xff) et compare en non signé (sans effet : les scripts n'utilisent que 15) ; hérite du tri à une passe et des écarts de calcnear. Correction en cours." }, { "table": "opcodes", "index": "0x5b", "name": "cnearmat", "operands": "deux expressions : rayon, masque de matière (stocké sur un octet)", "effect": "Pour chaque entité du même groupe, applique le test clipmat (la forme doit être valide et distincte de soi, sinon l'entité est ignorée) avec le masque de matière sur les tables de formes (mono ou multi), puis calcnear ; mêmes modes plus proche / toutes.", "port_note": "clipmat inversé : les entités à forme < 0 ou soi-même sont incluses au lieu d'être ignorées ; ordre octet de drapeau/compteur de l'en-tête inversé, offset lu en 32 bits au lieu de 16 signé, test mono/multi inversé. Inutilisé par Robinson's Requiem ; correction en cours." }, { "table": "opcodes", "index": "0x5c", "name": "cviewent", "operands": "trois expressions : rayon, champ de vision (valchamp), filtre d'entité", "effect": "Comme cnearent en mode vue (fview=1) : en plus de la distance, l'entité doit être dans le champ, via le produit scalaire de la direction (octets signés +0x34/38/3c) par le delta, comparé au rayon fois champ.", "port_note": "Hérite du tri à une passe et des écarts de calcnear de cnearent. Correction en cours." }, { "table": "opcodes", "index": "0x5d", "name": "cviewtyp", "operands": "deux expressions (rayon, champ), puis un mot 16 bits brut inline : identifiant de type", "effect": "Version vue de cneartyp : filtre sur l'identifiant de type brut avec test de champ de vision.", "port_note": "Mêmes remarques que cneartyp (&0xff, tri à une passe). Correction en cours." }, { "table": "opcodes", "index": "0x5e", "name": "cviewmat", "operands": "trois expressions : rayon, champ, masque de matière (octet)", "effect": "Version vue de cnearmat : test clipmat/traitmat sur les formes, puis calcnear avec champ de vision.", "port_note": "Partage les défauts de clipmat/traitmat de cnearmat (entités incluses à tort, ordre des octets d'en-tête, offset 32 bits). Correction en cours." }, { "table": "opcodes", "index": "0x5f", "name": "corient", "operands": "une expression (index de vecteur)", "effect": "Prend le vecteur d'orientation d'indice D7 dans la table setvect de l'entité (ou la table standard si absente), index*3, et copie 3 octets dans les composantes de direction (+0x34, +0x38, +0x3c).", "port_note": "" }, { "table": "opcodes", "index": "0x60", "name": "crstent", "operands": "aucun (suivi de la cible de stockage)", "effect": "Remet le curseur de la liste tablent au début puis enchaîne sur csuccent : lit l'entité suivante (curseur avancé si >= 0) et la stocke.", "port_note": "" }, { "table": "opcodes", "index": "0x61", "name": "csend", "operands": "un octet n, puis n+1 expressions, puis une expression d'entité", "effect": "Envoie n+1 valeurs dans la file de messages de l'entité cible (tampon circulaire head/tail). Si l'entité est -1, absente, ou a le bit 0 de l'octet d'état à 1, les valeurs sont évaluées puis jetées. Si la file est pleine, le reste est ignoré ; sinon à la fin le bit 0x80 de l'état est positionné.", "port_note": "" }, { "table": "opcodes", "index": "0x62", "name": "cscanon", "operands": "aucun", "effect": "Active la réception de messages : efface le bit 0 de l'octet d'état de l'entité (&= 0xfe).", "port_note": "" }, { "table": "opcodes", "index": "0x63", "name": "cscanoff", "operands": "aucun", "effect": "Désactive la réception (bit 0 à 1) puis vide la file de messages (scanclr).", "port_note": "" }, { "table": "opcodes", "index": "0x64", "name": "cinteron", "operands": "aucun", "effect": "Efface le bit 1 de l'octet d'état de l'entité (&= 0xfd).", "port_note": "" }, { "table": "opcodes", "index": "0x65", "name": "cinteroff", "operands": "aucun", "effect": "Positionne le bit 1 de l'octet d'état de l'entité (|= 2).", "port_note": "" }, { "table": "opcodes", "index": "0x66", "name": "cscanclr", "operands": "aucun", "effect": "Vide la file de messages (tête = queue) et efface le bit 0x80 de l'état.", "port_note": "" }, { "table": "opcodes", "index": "0x67", "name": "callentity", "operands": "aucun", "effect": "Positionne fallent=1 : la prochaine recherche near/view retiendra toutes les entités correspondantes (liste triée) au lieu de la plus proche.", "port_note": "" }, { "table": "opcodes", "index": "0x68", "name": "cpalette", "operands": "une expression (index de palette ou ressource)", "effect": "Met flagmain à 0. Si l'index est entre -2 et -1, restaure la palette sauvegardée sans fondu. Si l'index est >= 0 et que le saut selpalet n'est pas actif, résout la ressource du script courant ; si son premier octet vaut 0xfe, charge immédiatement la palette (topalette, couleurs 6 bits). Remet toujours le saut selpalet à 0.", "port_note": "" }, { "table": "opcodes", "index": "0x69", "name": "cdefcolor", "operands": "deux expressions", "effect": "Évalue deux expressions puis retourne : aucun effet dans la version DOS de Robinson's Requiem.", "port_note": "" }, { "table": "opcodes", "index": "0x6a", "name": "ctiming", "operands": "une expression", "effect": "Stocke l'octet bas de D7 comme valeur de timing (consommée ailleurs).", "port_note": "" }, { "table": "opcodes", "index": "0x6b", "name": "czap", "operands": "quatre expressions (prior, vol, freq, long), plus une cinquième (dfreq) si long != 0", "effect": "Mémorise les paramètres d'un effet sonore « zap » ; mais le lecteur appelé est un simple RET : la version DOS ne joue aucun son.", "port_note": "Le port lit les mêmes opérandes mais lance ensuite un canal de ton OPL via runson(), produisant un son que l'original ne fait jamais et occupant un canal d'autres effets. Correction : lire les opérandes puis retourner sans jouer." }, { "table": "opcodes", "index": "0x6c", "name": "cexplode", "operands": "quatre expressions (prior, vol, freq, long)", "effect": "Mémorise les paramètres d'une explosion, mais le code de lancement est du code mort : aucun son en DOS.", "port_note": "Le port joue un bruit OPL via runson() alors que l'original est muet. Correction : lire les 4 opérandes et retourner." }, { "table": "opcodes", "index": "0x6d", "name": "cding", "operands": "quatre expressions (prior, vol, freq, long)", "effect": "Calcule les paramètres d'un « ding » (dfreq=0, dvol négatif d'après vol et long) quand long != 0, puis appelle un lecteur qui est un simple RET : silencieux en DOS.", "port_note": "Le port synthétise un ton OPL sur l'écran du logo (avec freq>>1, absent de l'original). Correction : lire les 4 opérandes et retourner sans runson." }, { "table": "opcodes", "index": "0x16", "name": "cbnz16", "operands": "un mot signé 16 bits : décalage de saut (relatif à la fin de l'opérande)", "effect": "Si le résultat 16 bits de la dernière expression (D7) est non nul, saute de ce décalage ; sinon passe les 2 octets d'opérande.", "port_note": "" }, { "table": "opcodes", "index": "0x17", "name": "cbnz24", "operands": "un mot signé 16 bits suivi d'un octet ignoré (3 octets)", "effect": "Si D7 (16 bits) est non nul, saute du décalage signé (relatif à la fin des 3 octets) ; sinon saute les 3 octets.", "port_note": "" }, { "table": "opcodes", "index": "0x18", "name": "cbeq8", "operands": "un octet signé : décalage de saut", "effect": "Si D7 == D6 (16 bits), saute du décalage ; sinon passe l'octet.", "port_note": "" }, { "table": "opcodes", "index": "0x19", "name": "cbeq16", "operands": "un mot signé 16 bits : décalage de saut", "effect": "Si D7 == D6, saute du décalage (relatif à la fin de l'opérande) ; sinon passe 2 octets.", "port_note": "" }, { "table": "opcodes", "index": "0x1a", "name": "cbeq24", "operands": "un mot signé 16 bits plus un octet ignoré", "effect": "Si D7 == D6, saute du décalage 16 bits (relatif à la fin des 3 octets) ; sinon passe 3 octets.", "port_note": "" }, { "table": "opcodes", "index": "0x1b", "name": "cbne8", "operands": "un octet signé : décalage de saut", "effect": "Si D7 != D6, saute du décalage ; sinon passe l'octet.", "port_note": "" }, { "table": "opcodes", "index": "0x1c", "name": "cbne16", "operands": "un mot signé 16 bits : décalage de saut", "effect": "Si D7 != D6, saute du décalage ; sinon passe 2 octets.", "port_note": "" }, { "table": "opcodes", "index": "0x1d", "name": "cbne24", "operands": "un mot signé 16 bits plus un octet ignoré", "effect": "Si D7 != D6, saute du décalage 16 bits (relatif à la fin des 3 octets) ; sinon passe 3 octets.", "port_note": "" }, { "table": "opcodes", "index": "0x1e", "name": "cstore", "operands": "une expression (opername), puis un octet de code storename", "effect": "Si le drapeau de sortie est levé, quitte vers le DOS. Sinon réinitialise la pile d'expression, copie D7 dans D6, évalue l'opername, échange les buffers sd7/oldsd7, lit l'octet de code et saute au storename correspondant.", "port_note": "Le port ne remet pas la pile d'expression (acc) à zéro au début de l'opcode (seulement à chaque trame de script) : un push non équilibré s'accumule. Le drapeau de sortie est géré par la plateforme. Remise à zéro optionnelle prévue." }, { "table": "opcodes", "index": "0x1f", "name": "ceval", "operands": "un opername (flux d'expression), évalué jusqu'à sa fin", "effect": "Après test du drapeau de sortie, réinitialise la pile d'expression, copie D7 dans D6 et évalue l'opername (résultat dans D7).", "port_note": "Le port ne réinitialise pas la pile d'expression au début (voir cstore) ; drapeau de sortie géré par la plateforme." }, { "table": "opcodes", "index": "0x20", "name": "cadd", "operands": "un opername, puis un octet de code addname", "effect": "Après test du drapeau de sortie, réinitialise la pile, copie D7 dans D6, évalue l'opername, échange sd7/oldsd7, lit l'octet et saute à la cible addname (ajout à une variable).", "port_note": "" }, { "table": "opcodes", "index": "0x21", "name": "csub", "operands": "un opérande de stockage (cible addname) puis une expression (valeur)", "effect": "Soustrait : D7 est évalué puis nié sur 16 bits, et le résultat est ajouté à la cible désignée (addname avec échange des tampons). Le cas limite -(-32768) donne le même résultat car les additions sont masquées sur 8/16 bits.", "port_note": "" }, { "table": "opcodes", "index": "0x22", "name": "cmul", "operands": "aucun", "effect": "Handler vide (simple RET) : aucun opérande consommé, aucun effet.", "port_note": "" }, { "table": "opcodes", "index": "0x23", "name": "op_cdiv (cdiv)", "operands": "aucun", "effect": "Handler vide (simple RET) : aucun opérande consommé, aucun effet.", "port_note": "" }, { "table": "opcodes", "index": "0x24", "name": "cvprint", "operands": "une expression (valeur à afficher)", "effect": "Met charmode à 0, évalue D7 et l'affiche en décimal signé (signe '-', 5 chiffres, zéros de tête supprimés, dernier chiffre toujours écrit) via le tampon sd7, caractère par caractère, sur la console texte au curseur BIOS (texte de débogage).", "port_note": "Le texte est converti correctement mais put_char() abandonne les caractères en charmode 0 : rien n'est affiché. À faire éventuellement : dessiner avec une police 8x8 type BIOS à (xlocate*8, ylocate*8)." }, { "table": "opcodes", "index": "0x25", "name": "csprinti", "operands": "une chaîne littérale terminée par 0 dans le script", "effect": "Affiche la chaîne en ligne caractère par caractère, avec charmode remis à 0 avant chaque caractère, sur la console texte au curseur BIOS.", "port_note": "Même comportement d'opérandes ; la sortie est abandonnée comme pour cvprint (charmode 0 non rendu)." }, { "table": "opcodes", "index": "0x26", "name": "csprinta", "operands": "une expression de chaîne (évaluée dans sd7)", "effect": "Met charmode à 0, évalue une chaîne dans le tampon sd7 puis l'affiche jusqu'au 0 sur la console texte au curseur défini par clocate. Utilisé uniquement pour des écrans de debug/triche et l'invite 'PASSWORD:'.", "port_note": "Opérandes synchronisés, mais les textes en charmode 0 sont invisibles dans le port. Option : rendre ce texte avec une police BIOS 8x8 (curseur xlocate/ylocate en cellules de 8 px, CR/LF) dans put_char()." }, { "table": "opcodes", "index": "0x27", "name": "clocate", "operands": "deux expressions : x (colonne), y (ligne)", "effect": "Met charmode à 0 et positionne le curseur texte : xlocate = x, ylocate = y (octets), et fixe le curseur BIOS (int10 ah=2). D7 reçoit x et D6 reçoit y.", "port_note": "" }, { "table": "opcodes", "index": "0x28", "name": "ctab", "operands": "une expression : colonne", "effect": "Met charmode à 0 et fixe la colonne du curseur texte (xlocate = octet bas de D7) en gardant la ligne courante.", "port_note": "" }, { "table": "opcodes", "index": "0x29", "name": "cdim", "operands": "un mot (offset dans vram), un octet compteur, un octet, puis selon le signe du compteur n mots ou n dwords, plus une valeur finale", "effect": "Initialise un tableau dans la zone de variables de l'entité : écrit le compteur et l'octet à l'offset donné, puis n = compteur & 0xf valeurs vers les adresses basses (mots si compteur >= 0, dwords 32 bits si compteur < 0), puis une dernière valeur. En cas positif, la valeur finale lit 4 octets mais seuls les 16 bits bas sont écrits, à offset-4-2n.", "port_note": "Cas positif divergent : le port écrit un dword 32 bits à offset-6-2n (mot haut écrit en offset-4-2n), au lieu d'un mot à offset-4-2n. Correction prévue : décaler l'offset de 2 et utiliser xwrite16 sur la valeur lue sur 32 bits. Le cas négatif est correct." }, { "table": "opcodes", "index": "0x2a", "name": "crandom", "operands": "une expression : graine", "effect": "Évalue D7 (D6 = D7) et stocke ses 16 bits comme graine du générateur aléatoire, 0 compris (aucun cas spécial). orandom calcule ensuite seed = seed*0x7ab7 + 0xf881 sur 16 bits, donc la graine 0 est déterministe (première valeur 0xf881).", "port_note": "Le port remplace une graine 0 par sys_random() (LCG ANSI-C) et ne met pas D6 à jour : la suite des tirages diffère de l'original (le jeu n'appelle que 'random 0'). Correction prévue : graine = D7 & 0xffff, sans remplacement." }, { "table": "opcodes", "index": "0x2b", "name": "cloop8", "operands": "un octet signé : décalage de saut relatif", "effect": "Boucle : mémorise la position, évalue une addname avec D7 = -1 (décrément de la cible), puis si le résultat n'est pas nul saute en arrière du décalage (relatif à l'octet suivant le décalage), sinon continue.", "port_note": "Identique pour les cibles utilisées par le jeu. Différence latente : seuls alocb/alocw/adirb/adirw positionnent le drapeau zero ; les autres addnames le laissent périmé. Correction possible : le positionner dans toutes les addnames numériques." }, { "table": "opcodes", "index": "0x84", "name": "cmouson", "operands": "aucun", "effect": "Active le curseur souris : sans effet si aucun pilote souris ; si le curseur est caché, relit la position, dessine le sprite curseur et le marque affiché (compteur de masquage remis à 0xff). Le descripteur de curseur (desmouse) n'est pas modifié.", "port_note": "Le port active la souris, mais comme cmousoff y efface desmouse, un mouson après un mousoff n'affiche plus de curseur. Rien à changer ici, la correction est dans cmousoff." }, { "table": "opcodes", "index": "0x85", "name": "cmousoff", "operands": "aucun", "effect": "Cache le curseur souris : si une souris existe et que le curseur est affiché, le marque caché et efface son sprite. Le descripteur de curseur (desmouse, fixé seulement par defmouse) est conservé.", "port_note": "Le port efface aussi desmouse (versions < 60), donc le curseur disparaît définitivement après le premier mousoff/film. Correction prévue : ne pas effacer desmouse, basculer seulement enabled et le marquage dirty." }, { "table": "opcodes", "index": "0x86", "name": "cmouse", "operands": "trois opérandes de stockage : x, y, boutons (dans cet ordre)", "effect": "Lit la souris et stocke x, y et l'état des boutons. Sans souris : -1, -1, 0. Sinon position brute + décalage posé par csetmouse, bornée à l'écran, et boutons = bits bruts & 3 (1 gauche, 2 droit, 3 les deux).", "port_note": "Le port ne renvoie jamais 3 (deux boutons), utilisé par souris.als, et ignore le décalage de csetmouse. Correction prévue : boutons = (g?1:0)|(d?2:0) et ajout des décalages persistants avec bornage." }, { "table": "opcodes", "index": "0x87", "name": "cdefmouse", "operands": "une expression : index du descripteur de curseur", "effect": "Met flagmain à 0, résout le descripteur dans la table de sprites du script (erreur si l'index dépasse le nombre d'entrées) et le fixe comme descripteur de curseur (desmouse) ; l'entrée est aussi inscrite dans l'emplacement sprite du curseur de la liste de sprites de la VM. Aucun contrôle du type d'octet du descripteur.", "port_note": "Le port n'accepte le descripteur que si son premier octet vaut 0, 0x10 ou 0x14 et l'ignore silencieusement sinon. Option : retirer ce filtre pour la v31 DOS." }, { "table": "opcodes", "index": "0x88", "name": "csetmouse", "operands": "deux expressions : x, y", "effect": "Si x < 0 remet à zéro le décalage de la souris ; sinon règle un décalage persistant (x - x brut, y - y brut) que cmouse ajoute, de sorte que la position rapportée devient (x, y) puis suit les mouvements réels. Ne déplace jamais la souris matérielle.", "port_note": "Le port lit y dans D6 (au lieu de D7) et écrit directement la position de la souris, aussitôt écrasée par la souris hôte à chaque frame : aucun effet. Correction prévue : x = s16(D7) puis y = s16(D7), avec un système de décalage." }, { "table": "opcodes", "index": "0x89", "name": "cdefvect", "operands": "un octet n, suivi de n+1 vecteurs de 3 octets (sautés)", "effect": "Saute la table de n+1 vecteurs de 3 octets dans le script (n*3+3 octets) ; les vecteurs eux-mêmes sont lus ailleurs par capproach/cescape.", "port_note": "" }, { "table": "opcodes", "index": "0x8a", "name": "csetvect", "operands": "un mot", "effect": "Stocke le mot dans vram-0x20 : offset de la table de vecteurs courante de l'entité (0 = table standard vstandard).", "port_note": "" }, { "table": "opcodes", "index": "0x8b", "name": "cnul (cnul2)", "operands": "aucun", "effect": "No-op : simple RET, la VM passe à l'opcode suivant.", "port_note": "Le port met l'état de la VM à Stopped (arrêt complet) si un script exécute cet opcode. Correction prévue : le mapper sur une fonction vide pour la version 31." }, { "table": "opcodes", "index": "0x8c", "name": "capproach", "operands": "une expression (offset de l'entité cible), puis un opérande de stockage", "effect": "Calcule la différence de coordonnées monde (x, y, z) entre la cible et l'entité, puis parmi les n+1 vecteurs de la table courante choisit celui au produit scalaire (octets signés par mots 16 bits) strictement maximal. Stocke l'indice du meilleur vecteur et ses 3 octets dans les registres de direction. Retourne si l'offset vaut -1.", "port_note": "" }, { "table": "opcodes", "index": "0x8d", "name": "cescape", "operands": "une expression (offset de l'entité cible), puis un opérande de stockage", "effect": "Comme capproach mais retient le produit scalaire strictement minimal (départ 0x7fffffff), comparé sur 32 bits : choisit la direction la plus éloignée de la cible.", "port_note": "Le port tronque le produit scalaire à 16 bits (s16) avant comparaison, donc les produits hors -32768..32767 sont mal comparés. Correction prévue : retirer le s16 comme dans capproach." }, { "table": "opcodes", "index": "0x8e", "name": "cvtstmov", "operands": "une expression (matmask), puis un opérande de stockage", "effect": "Teste un déplacement par vecteur : position testée = coordonnées + s8 des registres de vecteur (0x34/0x38/0x3c), avec xinv, matmask (expression) et forme courante ; lance le test de collision de formes (clipform) puis crstent (réinitialise la liste d'entités et stocke la première entrée dans l'opérande de stockage).", "port_note": "" }, { "table": "opcodes", "index": "0x8f", "name": "cvftstmov", "operands": "deux expressions (matmask, forme), puis un opérande de stockage", "effect": "Comme cvtstmov, mais la forme testée est donnée par la seconde expression au lieu de la forme de l'entité ; clipform puis crstent avec stockage.", "port_note": "" }, { "table": "opcodes", "index": "0x90", "name": "cvmov", "operands": "aucun", "effect": "Déplace l'entité selon son vecteur : ajoute les octets signés des registres 0x34/0x38/0x3c aux mots de coordonnées x, y, z de l'entité (vram+0, +8, +0x10).", "port_note": "" }, { "table": "opcodes", "index": "0x91", "name": "cdefworld", "operands": "un mot (offset dans vram) puis 5 octets de données", "effect": "Copie 5 octets du script vers vram+offset .. vram+offset+4 (7 octets consommés au total) : définition du monde de l'entité.", "port_note": "Le port (v31) lit 6 octets et les écrit tous à la même adresse (bug hérité du C) : le script se désynchronise d'un octet et seul le dernier octet est écrit. Correction prévue : compteur 5, écriture à offset+i ; grammaire 'w r5'." }, { "table": "opcodes", "index": "0x92", "name": "cworld", "operands": "un mot (2 octets)", "effect": "Écrit les deux octets lus à vram-0x22 et vram-0x21 (paramètre de monde de l'entité).", "port_note": "Le port écrit à vram+0xffde/0xffdf (64 Kio plus loin) au lieu de 0x22 octets en arrière ; aucun désalignement du script mais mémoire erronée. Correction prévue : écrire à vram-0x22." }, { "table": "opcodes", "index": "0x93", "name": "cfindmat", "operands": "une expression (matmask), puis un opérande de stockage", "effect": "Parcourt la liste d'entités depuis l'offset 0, en sautant l'entité elle-même et celles sans forme (cforme < 0), et retient celles dont la forme a un matériau & matmask non nul (formes composites : première sous-forme qui correspond). Seul l'octet bas de matmask est mis à jour. Les résultats vont dans tablent, puis crstent et stockage.", "port_note": "Opcode absent du port. Implémentation prévue pour les versions 20 à 59 : matmask = D7 & 0xff, parcours des entités avec le test matériau des formes (comme clipform/formhit)." }, { "table": "opcodes", "index": "0x94", "name": "cfindtyp", "operands": "un mot (identifiant de script), puis un opérande de stockage", "effect": "Parcourt les entités depuis l'offset 0 et retient celles dont l'id de script vaut le mot (comparaison brute 16 bits), hors l'entité elle-même ; s'arrête à la première sauf si fallent est actif. Liste terminée par 0xffff, fallent remis à 0, puis crstent avec stockage.", "port_note": "Différences mineures : le port compare s16(id) à l'id non signé (un id >= 0x8000 ne correspond jamais) et plafonne tabent à 255 entrées. Correction optionnelle : comparer (id & 0xffff)." }, { "table": "opcodes", "index": "0x95", "name": "cmusic", "operands": "une expression (index de musique) puis, selon le type, 5 expressions : volume, tempo, attaque, chute, durée", "effect": "Retrouve la musique dans la table du script (sans contrôle de bornes). Si le type n'est pas 0, 3 ou 4, lit 5 expressions et les ignore. Sinon les stocke brutes (volume, tempo, attaque, chute, durée, sans ajustement) et, si musique et carte son sont actifs, lance le tracker DOS (liste d'ordre de 128 octets, patterns de 1024 octets, volume = volume>>1).", "port_note": "Moteur audio différent (plateforme : mv2/hôte). Piste prévue : envoyer les types 0, 3, 4 au même moteur, stocker attaque/durée/chute sans les +1/+2 et muvol = volume>>1." }, { "table": "opcodes", "index": "0x96", "name": "cdelmusic", "operands": "une expression : durée du fondu", "effect": "Arrête la musique : durée 0 = arrêt immédiat (voix du tracker coupées) ; sinon fondu sortant sur la durée donnée. Sans effet sans carte son ou si aucune musique ne joue.", "port_note": "" }, { "table": "opcodes", "index": "0x97", "name": "ccadence", "operands": "une expression", "effect": "Consomme son opérande puis appelle un RET vide : sans effet dans la version DOS (la cadence n'est pas modifiée).", "port_note": "Le port (v31) change réellement le tempo de la musique en cours (0 devient 1, mutemp = mutempo*6/32). Correction prévue : ne faire que consommer l'opérande." }, { "table": "opcodes", "index": "0x98", "name": "csetvolum", "operands": "une expression : volume", "effect": "Mémorise l'octet bas du volume (pour le prochain cmusic, qui le passera au tracker). N'agit pas sur la musique en cours.", "port_note": "Le port modifie immédiatement le volume de la musique en cours (muvolume, maxvolume, muvol, dattac/dchute). Correction prévue : stocker seulement la valeur pour le prochain cmusic." }, { "table": "opcodes", "index": "0x99", "name": "cxinv", "operands": "aucun", "effect": "Inverse le drapeau xinv de l'entité (bascule du bit à vram-3) : retournement horizontal.", "port_note": "" }, { "table": "opcodes", "index": "0x42", "name": "cstop", "operands": "aucun", "effect": "Termine l'exécution de l'entité pour cette passe : abandonne la boucle d'opcodes et rend la main à l'ordonnanceur, qui sauvegarde le PC (juste après l'opcode) et vacc dans la vram de l'entité.", "port_note": "" }, { "table": "opcodes", "index": "0x43", "name": "cstopret", "operands": "aucun", "effect": "En passe principale (fseq non nul) exécute cret (dépile l'adresse de retour du script, efface le décalage vacc si égal) puis arrête l'entité. Pour un vecteur d'interruption/before/after (fseq = 0), arrête seulement, sans toucher à la pile.", "port_note": "Le port appelle aussi cret() quand fseq = 0, ce qui peut dépiler une adresse ou effacer vram-0xc à tort. Correction prévue : si fseq == 0, cstop() puis retour, pour toutes les versions." }, { "table": "opcodes", "index": "0x44", "name": "cexit", "operands": "aucun", "effect": "Si l'entité courante est l'entité 0, termine le programme (démontage et sortie DOS). Sinon l'entité se tue (killent) : l'entité précédente devient courante et toutes les étapes restantes de l'ordonnanceur pour elle sont sautées, dans n'importe quelle phase, avant de passer à l'entité suivante.", "port_note": "Le planificateur v3 du port ne saute pas updtcoord ni les phases main/after après un 'before' quand l'entité s'est tuée. Correction prévue dans Machine.php : si restart_loop, aller directement à l'entité suivante." }, { "table": "opcodes", "index": "0x45", "name": "cload", "operands": "un mot (id) puis un nom de fichier terminé par 0 ; si id = 0, une expression de chaîne", "effect": "Si id est non nul : charge le programme nommé (si cet id n'est pas déjà chargé ; vérifie l'id du fichier). Si id = 0 : évalue une chaîne, change de répertoire de base, recharge main.io avec id 0 et relance l'ordonnanceur à l'entité 0. Une capture PCX de débogage est prise avant si une touche est tenue.", "port_note": "Le port remplace l'extension du nom par celle de la plateforme pour id non nul, et la branche id = 0 (changement de répertoire, rechargement du script principal, redémarrage à l'entité 0) n'est pas reproduite à l'identique. Option : fixer le chemin de données, recharger main et redémarrer l'ordonnanceur." }, { "table": "opcodes", "index": "0x46", "name": "cdefsc", "operands": "un mot (index de l'écran), un octet, puis 32 octets de descripteur", "effect": "Définit un écran (scène) : active le drapeau 0x40, copie 0x20 octets dans le descripteur, lui attribue un sprite de la bibliothèque (libsprit) et initialise ses coordonnées d'écran (newx masqué à 0xfff0, newy, newd = 0x7fff, depx = (x+largeur)|0xf, depy = y+hauteur). Efface des champs, ajoute l'écran (scadd) et calcule le vectoriel.", "port_note": "Le port ne masque newx & 0xfff0 / depx |= 0xf que pour la version 1.0 ; l'exécutable DOS v3 le fait toujours. Correction prévue dans scdosprite() pour la v31, et dans vectoriel() pour la v3 (écriture de l'octet à m+9)." }, { "table": "opcodes", "index": "0x47", "name": "cscreen", "operands": "un mot", "effect": "Écrit le mot dans vram-0x16 : identifiant d'écran de l'entité, utilisé par les opcodes d'affichage.", "port_note": "" }, { "table": "opcodes", "index": "0x48", "name": "cput", "operands": "une expression : index d'élément", "effect": "Met flagmain à 0, copie xinv, remet à 0 depx/depy/depz et numelem, puis affiche l'élément d'index donné de l'entité (routine de put partagée).", "port_note": "" }, { "table": "opcodes", "index": "0x49", "name": "cputnat", "operands": "cinq expressions : depx, depy, depz, index, numelem", "effect": "Comme cput, mais avec décalages explicites depx, depy, depz et un numéro d'élément numelem (octet) ; routine de put partagée. (Version 1.0 : sans depz.)", "port_note": "" }, { "table": "opcodes", "index": "0x4a", "name": "cerase", "operands": "aucun", "effect": "Cherche la tête des éléments de l'entité (searchtete) et supprime en boucle les éléments dont l'id d'écran est celui de l'entité (killelem), puis ferase = 0.", "port_note": "" }, { "table": "opcodes", "index": "0x4b", "name": "cerasen", "operands": "une expression : numéro d'élément", "effect": "Fixe numelem puis supprime tous les éléments portant ce numéro (searchelem/killelem en boucle), puis ferase = 0.", "port_note": "" }, { "table": "opcodes", "index": "0x4c", "name": "cset", "operands": "trois expressions : x, y, z", "effect": "Écrit les trois valeurs comme mots 16 bits dans les coordonnées monde de l'entité (vram+0, +8, +0x10).", "port_note": "" }, { "table": "opcodes", "index": "0x4d", "name": "cmov", "operands": "trois expressions : dx, dy, dz", "effect": "Ajoute les trois valeurs (16 bits) aux coordonnées monde de l'entité (vram+0, +8, +0x10).", "port_note": "" }, { "table": "opcodes", "index": "0x4e", "name": "copensc", "operands": "un mot : index de l'écran", "effect": "Ouvre l'écran : efface le bit 0x40 et pose le bit 0x80 de son drapeau, recalcule (scbreak, scadd) ; si le bit 1 de l'octet suivant est posé, ouvre aussi la zone (openland).", "port_note": "" }, { "table": "opcodes", "index": "0x4f", "name": "cclosesc", "operands": "un mot : index de l'écran", "effect": "Ferme l'écran : pose le bit 0x40 de son drapeau.", "port_note": "" }, { "table": "opcodes", "index": "0x50", "name": "cerasall", "operands": "aucun", "effect": "Supprime tous les éléments de la liste de l'entité (killelem en boucle depuis la tête vram-0x18), puis ferase = 0.", "port_note": "" }, { "table": "opcodes", "index": "0x51", "name": "cforme", "operands": "une expression", "effect": "Fixe la forme de collision de l'entité : écrit la valeur (mot) à vram-0x1a.", "port_note": "" }, { "table": "opcodes", "index": "0x52", "name": "cdelforme", "operands": "aucun", "effect": "Supprime la forme de l'entité : écrit 0xffff à vram-0x1a (cforme < 0 = pas de forme).", "port_note": "" }, { "table": "opcodes", "index": "0x53", "name": "ctstmov", "operands": "quatre expressions (dx, dy, dz, matmask), puis un opérande de stockage", "effect": "Teste un déplacement : position testée = coordonnées + (dx, dy, dz), avec xinv, matmask et la forme courante. Cherche les entités du même groupe (mot +0x30), avec forme, hors elle-même, dont la forme en collision correspond (une seule sauf fallent) ; liste terminée par 0xffff. Puis crstent réinitialise la liste et stocke la première entrée.", "port_note": "" }, { "table": "opcodes", "index": "0x54", "name": "ctstset", "operands": "4 expressions (wcx, wcy, wcz, matmask) puis 1 cible de stockage (S)", "effect": "Fixe la position absolue de test (wcx, wcy, wcz) et le masque matmask. La forme de test est la forme courante du script (cforme). Lance tstform (clipform) puis réinitialise la liste et stocke la première entité trouvée dans la cible.", "port_note": "Le port ne gère que la version 1.0 ; en v3 le corps est vide, aucun opérande n'est lu et le script se désynchronise. La grammaire déclare aussi 0x54 sans opérandes. Correction en cours : réutiliser le chemin v1.0 pour la v3 et déclarer 'E E E E S'. Non utilisé par Robinson." }, { "table": "opcodes", "index": "0x55", "name": "cftstmov", "operands": "5 expressions (x, y, z relatifs, matmask, forme) puis 1 cible S", "effect": "Teste une forme à une position relative à la position courante du script (wcx, wcy, wcz). Les deux dernières expressions donnent matmask et la forme. Après tstform, la liste est réinitialisée et la première entité trouvée est stockée dans la cible.", "port_note": "" }, { "table": "opcodes", "index": "0x56", "name": "cftstset", "operands": "5 expressions (x, y, z absolus, matmask, forme) puis 1 cible S", "effect": "Comme cftstmov mais avec une position absolue. Après tstform, la première entité trouvée est stockée dans la cible.", "port_note": "" }, { "table": "opcodes", "index": "0x57", "name": "csuccent", "operands": "1 cible de stockage (S)", "effect": "Lit l'entrée courante de la liste tablent. Si elle est >= 0, le pointeur de liste avance d'une entrée. La valeur est stockée dans la cible qui suit.", "port_note": "" }, { "table": "opcodes", "index": "0x9a", "name": "cxinvon", "operands": "aucun", "effect": "Met à 1 l'octet xinv de l'entité courante (miroir horizontal activé).", "port_note": "" }, { "table": "opcodes", "index": "0x9b", "name": "cxinvoff", "operands": "aucun", "effect": "Met à 0 l'octet xinv de l'entité courante (miroir désactivé).", "port_note": "" }, { "table": "opcodes", "index": "0x9c", "name": "clistent", "operands": "1 cible de stockage (S)", "effect": "Parcourt la chaîne des entités à partir de atent, en sautant l'entrée 0. Remplit tablent avec chaque entité, met matent à 0 pour chacune, termine la liste par 0xffff et met fallent à 0. Il fait ensuite l'équivalent de crstent : la première entité est stockée dans la cible. L'original ne vérifie aucune borne.", "port_note": "Le port s'arrête à 255 entrées alors que l'original n'a aucun test. Sans effet pour Robinson, qui n'a jamais autant d'entités." }, { "table": "opcodes", "index": "0x9d", "name": "csound", "operands": "5 expressions : index du son, priorité, volume, nombre de boucles, vitesse (multipliée par 1000 pour la fréquence)", "effect": "Joue un échantillon sur l'une des 4 voix. Si la priorité est négative, il réutilise la voie de même priorité. Sinon il réutilise une voie ACTIVE de même propriétaire (entité du script) et de même priorité, puis la première voie libre, puis la plus basse priorité. Sans voie, les expressions restantes sont lues et ignorées. Le volume est (vol&0xff)>>1. Le compteur de boucles est sur 16 bits : à 0 ou négatif, l'échantillon boucle indéfiniment. Le type de l'échantillon n'est pas vérifié. Les données vont de addr+0xe à addr+[addr+2]-8.", "port_note": "Le port diffère : pour une priorité positive il ne compare pas le propriétaire, donc deux entités de même priorité se coupent mutuellement. Le compteur de boucles est tronqué à 8 bits, donc -1 joue 255 fois puis s'arrête, et 0 joue une seule fois. Seuls les types 1 et 2 sont joués. Une vitesse de 0 prend l'octet d'en-tête, et la fréquence est bornée entre 1 et 20 kHz. La fenêtre de données diffère (addr+0x10). Correction en cours." }, { "table": "opcodes", "index": "0x9e", "name": "cmsound", "operands": "identiques à csound (5 expressions)", "effect": "Comme csound, mais l'échantillon est cherché dans les ressources du script main (flagmain=1). Le propriétaire de la voie reste l'entité du script courant.", "port_note": "Hérite de toutes les différences de csound (propriétaire, boucle sur 8 bits, contrôle du type). Le propriétaire doit rester celui du script courant. Correction en cours." }, { "table": "opcodes", "index": "0x9f", "name": "credon", "operands": "aucun", "effect": "Met à 0 l'octet credon/credoff de l'entité courante.", "port_note": "" }, { "table": "opcodes", "index": "0xa0", "name": "credoff", "operands": "aucun", "effect": "Met l'octet credon/credoff de l'entité courante à 0x80.", "port_note": "" }, { "table": "opcodes", "index": "0xa1", "name": "cdelsound", "operands": "aucun", "effect": "Si le son est activé, remet à zéro l'état des 4 voix d'échantillons, ce qui coupe les effets sonores. La priorité et le propriétaire sont conservés. Les voix de musique et les autres périphériques sonores ne sont pas touchés.", "port_note": "Le port arrête les canaux 0 à 3 (type, curson, pere), y compris les canaux PSG et le canal 3 qui porte la voix du film FLI. Le résultat est identique pour Robinson, sauf un cdelsound pendant un film qui couperait la voix du film. Correction facultative : épargner le canal 3 pendant un film." }, { "table": "opcodes", "index": "0xa2", "name": "cwmov", "operands": "1 expression (index de forme)", "effect": "Calcule le vecteur du centre d'une forme (get_vector) et l'ajoute aux coordonnées du script : ax à wcx, bx à wcy, cx à wcz. Type 0 : moyenne de deux jeux d'octets SIGNÉS (+4/+7, +5/+8, +6/+9). Type 1 : moyenne de mots (+4/+a, +6/+c, +8/+e). Type >= 2 : mots +2, +4, +6. Un type négatif déclenche l'erreur 0x14. ax est inversé si l'octet 0x2e est >= 0x15 et xinv != 0.", "port_note": "Le port, copié du C, lit x=+4, z=+5, y=+6 et ajoute y à wcy et z à wcz : les 2e et 3e composantes sont donc permutées par rapport au DOS. Les octets du type 0 sont lus non signés. Même get_vector pour cwlive. Correction en cours. Non utilisé par Robinson." }, { "table": "opcodes", "index": "0xa3", "name": "cwtstmov", "operands": "2 expressions (index de forme pour le vecteur, matmask) puis 1 cible S", "effect": "Place wcx, wcy, wcz à la position du script plus le vecteur de la forme (get_vector). Lit matmask, prend la forme courante (cforme) comme wforme, puis clipform. La première entité trouvée est stockée dans la cible.", "port_note": "Le port a un corps vide qui ne lit rien : tout usage désynchroniserait le script. La grammaire ne lui donne aucun opérande. Correction en cours : implémenter get_vector et les lectures, grammaire 'E E S'." }, { "table": "opcodes", "index": "0xa4", "name": "cwftstmov", "operands": "3 expressions (index de forme, matmask, forme de test) puis 1 cible S", "effect": "Comme cwtstmov, mais une expression supplémentaire donne la forme testée (wforme) à la place de la forme courante. Puis clipform et stockage de la première entité trouvée.", "port_note": "Le port a un corps vide qui ne consomme rien, et la grammaire est vide. Correction en cours, grammaire 'E E E S'." }, { "table": "opcodes", "index": "0xa5", "name": "ctstform", "operands": "2 expressions (matmask, forme) puis 1 cible S", "effect": "Fixe wcx, wcy, wcz à la position du script, lit matmask et wforme, puis clipform. La première entité trouvée est stockée dans la cible.", "port_note": "" }, { "table": "opcodes", "index": "0xa6", "name": "cxput", "operands": "1 expression (index du sprite)", "effect": "Dessine un sprite du script courant avec le miroir inversé (invert = xinv xor 1). Les décalages depx, depy, depz et numelem sont mis à 0.", "port_note": "" }, { "table": "opcodes", "index": "0xa7", "name": "cxputat", "operands": "5 expressions (depx, depy, depz, index du sprite, numelem)", "effect": "Comme cxput mais avec décalages explicites. numelem est un mot de 16 bits.", "port_note": "Le port lit numelem comme un octet signé 8 bits. Sans effet pour Robinson, qui passe 0 à 5. Correction facultative." }, { "table": "opcodes", "index": "0xa8", "name": "cmput", "operands": "1 expression (index du sprite)", "effect": "Dessine un sprite depuis les ressources du main (flagmain=1), avec invert = xinv. Les décalages et numelem sont à 0.", "port_note": "" }, { "table": "opcodes", "index": "0xa9", "name": "cmputat", "operands": "5 expressions (depx, depy, depz, index du sprite, numelem)", "effect": "Comme cmput avec décalages explicites. numelem est un mot de 16 bits.", "port_note": "Le port lit numelem sur 8 bits signés, comme pour cxputat." }, { "table": "opcodes", "index": "0xaa", "name": "cmxput", "operands": "1 expression (index du sprite)", "effect": "Comme cmput. Un bug de l'original applique le xor sur BX et non sur AL : l'octet invert reste xinv, et il n'y a donc aucune inversion supplémentaire. Décalages et numelem à 0.", "port_note": "Le port calcule invert = (xinv^1)&0xff, donc le sprite est en miroir par rapport au DOS. Correction en cours : utiliser xinv sans xor pour le PC v3. Non utilisé par Robinson." }, { "table": "opcodes", "index": "0xab", "name": "cmxputat", "operands": "5 expressions (depx, depy, depz, index du sprite, numelem)", "effect": "Dessin depuis les ressources du main avec invert = xinv xor 1 et décalages explicites. numelem est un mot de 16 bits.", "port_note": "Le port lit numelem sur 8 bits signés." }, { "table": "opcodes", "index": "0xac", "name": "cmmusic", "operands": "6 expressions : index, volume, tempo, attaque, durée, chute", "effect": "Lance une musique depuis les ressources du main (flagmain=1). Si le type de la ressource n'est pas 0, 3 ou 4, les 5 expressions suivantes sont lues puis ignorées. Sinon volume et tempo sont des octets, attaque, durée et chute des mots bruts transmis au pilote de musique DOS.", "port_note": "Les opérandes sont consommés de la même façon. Le port convertit les valeurs pour ses propres pilotes musicaux (volume décalé, attaque+1), ce n'est pas une copie octet pour octet." }, { "table": "opcodes", "index": "0xad", "name": "cmforme", "operands": "1 expression (forme)", "effect": "Écrit la forme courante (cforme) du script MAIN, pas du script appelant. Le préfixe 'm' désigne le main, comme pour cmput et cmsound.", "port_note": "Le port écrit cforme du script courant, comme cforme (0x51). Correction en cours : écrire dans la vram du main avec masque 0xffff." }, { "table": "opcodes", "index": "0xae", "name": "csettime", "operands": "3 expressions (heures, minutes, secondes)", "effect": "Évalue les 3 expressions puis appelle une routine qui ne fait que retourner : aucun effet sous DOS.", "port_note": "" }, { "table": "opcodes", "index": "0xaf", "name": "cgettime", "operands": "3 cibles de stockage (S S S)", "effect": "Ne lit aucune horloge : l'appel est un simple retour. Les trois cibles reçoivent les valeurs résiduelles des registres (ax=0x00af, cx et bx laissés par le code précédent).", "port_note": "Le port stocke 0, 0, 0. Seules les valeurs indéterminées diffèrent, les 3 cibles sont consommées. Le jeu n'utilise pas cet opcode." }, { "table": "opcodes", "index": "0xb0", "name": "cvinput", "operands": "1 cible de stockage (S)", "effect": "Met charmode à 0 et lit un nombre au clavier. Chaque touche est attendue (appui puis relâchement), les codes avec le bit 7 sont ignorés. Seuls '-' et '0' à '9' sont acceptés. BS efface (écho BS, espace, BS). CR termine. Le tampon est converti en valeur (strtoval) et stocké dans la cible.", "port_note": "" }, { "table": "opcodes", "index": "0xb1", "name": "csinput", "operands": "1 cible de stockage (S)", "effect": "Met charmode à 0 et lit une chaîne au clavier. Les touches de code >= 0x80 (octet signé négatif) ne sont jamais prises. BS ne fait rien si le tampon est vide. CR termine la chaîne par un NUL. La chaîne est stockée dans la cible.", "port_note": "Le port stocke et affiche aussi les touches >= 0x80 (touches accentuées de l'hôte). Correction en cours : les ignorer comme l'original." }, { "table": "opcodes", "index": "0xb2", "name": "casleepfar", "operands": "1 expression (distance)", "effect": "Calcule seuil = val*val (32 bits non signé). Parcourt la liste atent en ignorant les entités dont le bit 2 de [vram-0x24] est levé. La somme des carrés des différences de coordonnées (chacune sur 16 bits, multiplication signée) est comparée au seuil, sans signe. Dedans : si [vram-4]==0, il passe à 1 et envoie le message 0x8001. Dehors : s'il est non nul, il passe à 0 et envoie 0x8000. Le message part avec le numéro d'entité script de l'entité CIBLE ([vram-0xe] de la cible).", "port_note": "Le port envoie le numéro de l'entité APPELANTE (comme le C). Il ne ramène pas les différences à 16 bits avant le carré : le résultat diffère si deux coordonnées sont à plus de 32767 d'écart. Les récepteurs de Robinson (bison.als) ignorent ce cas. Impact faible, correction en cours." }, { "table": "opcodes", "index": "0xb3", "name": "casleepon", "operands": "aucun", "effect": "Efface le bit 2 de l'octet de flags [vram-0x24] de l'entité courante (scan inter activé).", "port_note": "" }, { "table": "opcodes", "index": "0xb4", "name": "casleepoff", "operands": "aucun", "effect": "Met à 1 le bit 2 de l'octet de flags [vram-0x24] de l'entité courante (scan inter désactivé).", "port_note": "" }, { "table": "opcodes", "index": "0xb5", "name": "crunfilm", "operands": "1 expression (batchframes) puis 2 cibles de stockage (S S)", "effect": "Fixe batchframes (nombre d'images du lot), exécute le lecteur de film (runfilm), puis stocke dans l'ordre le numéro de frame du film et son résultat.", "port_note": "" }, { "table": "opcodes", "index": "0xb6", "name": "cvpicprint", "operands": "1 expression", "effect": "Met charmode à 1 et convertit la valeur en texte, mais le putchar en mode 1 retourne aussitôt : rien n'est affiché sous DOS.", "port_note": "" }, { "table": "opcodes", "index": "0xb7", "name": "cspicprint", "operands": "1 expression de chaîne", "effect": "Met charmode à 1, évalue la chaîne dans le tampon 0x16008 et la parcourt avec putchar, qui est sans effet en mode 1 : rien n'est affiché.", "port_note": "" }, { "table": "opcodes", "index": "0xb8", "name": "cvputprint", "operands": "1 expression", "effect": "Met charmode à 2 et imprime la valeur comme entier signé 16 bits (signe, zéros de tête supprimés, dernier chiffre toujours présent) avec putchar pour chaque caractère.", "port_note": "" }, { "table": "opcodes", "index": "0xb9", "name": "csputprint", "operands": "1 expression de chaîne", "effect": "Met charmode à 2 et imprime la chaîne octet par octet jusqu'au NUL avec putchar.", "port_note": "" }, { "table": "opcodes", "index": "0xba", "name": "cfont", "operands": "5 expressions (a, b, c, d, e)", "effect": "Si a >= 0 : foasc=a, fonum=b, folarg=(u8)c, fohaut=(u8)d, fomax=e. Si a == -16 : seul l'octet de COULEUR DU TEXTE vaut (u8)b ; c, d, e sont lus et ignorés, et la police est conservée. Les glyphes non nuls sont alors dessinés dans cette couleur. Si a < 0 et a != -16 : foasc=0xffff, fonum=0, b ignoré, puis folarg=c, fohaut=d, fomax=e.", "port_note": "Le port n'a pas de cas spécial : 'font -16,4,0,0,0' écrase la police (fomax=0) et le curseur ne bouge plus. La ligne de sous-titre en couleur de baratin*.als est invisible, et 'font -16,0,...' (playfilm.als) efface la police. La couleur n'existe pas dans le port. Écarts mineurs : fonum tronqué à 16 bits (test signé impossible), put_char utilise un octet signé donc les caractères >= 0x80 ne sont pas dessinés. Correction en cours." }, { "table": "opcodes", "index": "0xbb", "name": "cpaper", "operands": "1 expression", "effect": "Enregistre l'octet (u8) de la valeur dans une variable que rien d'autre ne lit : sans effet visible.", "port_note": "" }, { "table": "opcodes", "index": "0xbc", "name": "ctoblack", "operands": "1 expression (durée)", "effect": "Fondu de la palette vers le noir. Pour 0 < durée < 63, pas = 63/durée + 1 et compteurs initialisés ; sinon compteur 63 et pas durée/63 (division 8 bits, erreur si le quotient dépasse 255). La palette cible est mise à zéro. Si la machine est lente (benchmark <= 200) ou durée == 0, le fondu est instantané. Puis verrouillage, chase, ftopal=1 et skip=0.", "port_note": "Les valeurs de pas et de compteurs sont les mêmes pour les durées du jeu (10, 20, 30). Le test de machine lente est sans objet : le port se comporte comme un PC rapide. Les durées >= 8064, qui feraient planter l'original, ne sont pas reproduites." }, { "table": "opcodes", "index": "0xbd", "name": "cmovcolor", "operands": "2 expressions", "effect": "Lit deux expressions et ne fait rien d'autre (sans effet en VGA 8 bits).", "port_note": "" }, { "table": "opcodes", "index": "0xbe", "name": "ctopalet", "operands": "2 expressions (index de palette, durée)", "effect": "Fondu vers une palette. Si skip == 0 : un index -1 ou -2 restaure la sauvegarde sav1 ou sav2 en fondu ; un index >= 0 résout la ressource et, si son premier octet vaut 0xfe, lance topalette(durée) (pas = 63/durée+1 sous 63, sinon durée/63+1). Fondu instantané sur machine lente. Puis skip=0.", "port_note": "" }, { "table": "opcodes", "index": "0xbf", "name": "cnumput", "operands": "4 expressions (depx, depy, depz, numelem)", "effect": "Enregistre les décalages depx, depy, depz (mots) et numelem (octet) utilisés par les prochains put.", "port_note": "" }, { "table": "opcodes", "index": "0xc0", "name": "cscheart", "operands": "2 expressions (a, b)", "effect": "Si le mot [vram-0x16] de l'entité est non nul, repère l'écran basemain+id et écrit a en +0x0a et b en +0x0c, puis lève le bit 0x80 de l'état de l'écran. Les 2 opérandes sont toujours lus.", "port_note": "" }, { "table": "opcodes", "index": "0xc1", "name": "cscpos", "operands": "2 expressions (x, y)", "effect": "Si l'écran existe, écrit x en +0x0e et y en +0x10, puis met à jour le sprite de l'écran : +0xc = x&0xfff0, +0xe = y, dword +0x10 = 0x7fff, +0x16 = (x+w)|0xf, +0x18 = y+h. Lève ensuite le bit 0x80 de l'état.", "port_note": "Le port (chemin v<60) enregistre x et y mais n'appelle pas scdosprite(), le sprite garde donc son ancienne position jusqu'au prochain cscsize. Sans effet visible dans Robinson, où scpos est toujours suivi de scsize. Correction en cours." }, { "table": "opcodes", "index": "0xc2", "name": "cscsize", "operands": "2 expressions (largeur, hauteur)", "effect": "Si l'écran existe, écrit w-1 en +0x12 et h-1 en +0x14, met à jour le sprite de l'écran (aligne newx = x&0xfff0 et depx = (x+w)|0xf pour toutes les versions, n'écrit pas numelem) et lève le bit 0x80 de l'état.", "port_note": "scdosprite du port n'aligne que pour la v10 et écrit aussi numelem. Avec les valeurs de Robinson (x=48 ou 0, x+w=207 ou 255), l'alignement ne change rien. Correction en cours." }, { "table": "opcodes", "index": "0xc3", "name": "cschoriz", "operands": "3 expressions (e1, e2, e3), lues seulement si l'id d'écran est non nul", "effect": "Teste d'abord le mot [vram-0x16]. À 0, aucun opérande n'est lu. Sinon écrit les octets +0x20, +0x21, +0x22 de l'écran (vecteur horizontal) et lève le bit 0x80 de l'état.", "port_note": "" }, { "table": "opcodes", "index": "0xc4", "name": "cscvertic", "operands": "3 expressions (v0, v1, v2)", "effect": "Si l'écran existe, écrit les octets +0x23, +0x24, +0x25 (vecteur vertical), puis calcule la normale : produit vectoriel du vecteur horizontal (0x20-0x22) et du vertical, avec multiplications signées 8 bits. Les mots +0x26, +0x27, +0x28 reçoivent h1*v2-v1*h2, h2*v0-v2*h0, h0*v1-v0*h1 (écritures qui se recouvrent). Lève ensuite le bit 0x80 de l'état.", "port_note": "Le port enregistre les 3 octets et l'état mais ne calcule jamais la normale en 0x26-0x29. Correction en cours." }, { "table": "opcodes", "index": "0xc5", "name": "cscreduce", "operands": "3 expressions (a, b, c), la 3e lue seulement si l'écran existe", "effect": "Si l'écran existe, écrit l'octet +0x1d = a, +0x1e = b-1, lit une 3e expression dans +0x1f et lève le bit 0x80 de l'état. Si l'id d'écran est 0, la 3e expression n'est pas lue.", "port_note": "" }, { "table": "opernames", "index": "2b (code 0x56)", "name": "oadd", "operands": "opérande suivant de l'expression (valeur de droite)", "effect": "Addition 16 bits : lit l'opérande suivant dans D7 et fait D7 = gauche + D7, avec repli modulo 16 bits.", "port_note": "" }, { "table": "opernames", "index": "2c (code 0x58)", "name": "osub", "operands": "opérande suivant de l'expression (valeur de droite)", "effect": "Soustraction 16 bits : D7 = gauche - droite (gauche lu avant, droite est l'opérande suivant).", "port_note": "" }, { "table": "opernames", "index": "2d (code 0x5a)", "name": "omod", "operands": "opérande suivant de l'expression (diviseur)", "effect": "Modulo signé 16 bits : D7 = gauche mod droite, le reste a le signe du dividende. Un diviseur nul est remplacé par 1, donc x % 0 vaut 0.", "port_note": "" }, { "table": "opernames", "index": "2e (code 0x5c)", "name": "odiv", "operands": "aucun (opérande gauche dans l'accumulateur, droit en D7)", "effect": "Division entière signée 16 bits (idiv), quotient tronqué vers zéro dans D7. Si le diviseur vaut 0, il est remplacé par 1 : x/0 = x.", "port_note": "Le port ne remplaçait 0 par 1 que pour version>=60 ; pour Robinson (v31) cdiv() renvoyait 0. À corriger : substitution du diviseur 0 par 1 pour toutes les versions DOS v3." }, { "table": "opernames", "index": "2f (code 0x5e)", "name": "omul", "operands": "aucun", "effect": "Multiplication signée 16x16 bits (imul) ; D7 reçoit les 16 bits de poids faible du produit.", "port_note": "" }, { "table": "opernames", "index": "30 (code 0x60)", "name": "oneg", "operands": "aucun", "effect": "Négation arithmétique de D7 (neg). -32768 reste -32768.", "port_note": "" }, { "table": "opernames", "index": "31 (code 0x62)", "name": "oabs", "operands": "aucun", "effect": "Valeur absolue de D7 : le négatif est inversé. -32768 reste -32768.", "port_note": "" }, { "table": "opernames", "index": "32 (code 0x64)", "name": "ornd", "operands": "aucun (borne en D7)", "effect": "Générateur congruentiel 16 bits : graine = graine*0x7ab7 + 0xf881, puis D7 = mot de poids fort de graine*D7 (non signé). Résultat dans [0, D7[. La graine initiale est 0.", "port_note": "" }, { "table": "opernames", "index": "33 (code 0x66)", "name": "osgn", "operands": "aucun", "effect": "Signe de D7 : 0 donne 0, négatif donne -1, positif donne 1.", "port_note": "" }, { "table": "opernames", "index": "34 (code 0x68)", "name": "onot", "operands": "aucun", "effect": "Complément à un de D7 sur 16 bits (not).", "port_note": "" }, { "table": "opernames", "index": "35 (code 0x6a)", "name": "oinkey", "operands": "aucun", "effect": "D7 = code ALIS de la touche actuellement maintenue (octet positionné par l'IRQ clavier via une table de traduction), 0 si aucune. La touche n'est pas consommée.", "port_note": "Fourni par la couche hôte (io_inkey) avec les mêmes codes ALIS ; équivalent." }, { "table": "opernames", "index": "36 (code 0x6c)", "name": "okeyon", "operands": "aucun", "effect": "Ne fait rien (simple ret) : ne lit aucun opérande et laisse D7 inchangé.", "port_note": "" }, { "table": "opernames", "index": "37 (code 0x6e)", "name": "ojoy", "operands": "aucun (numéro de joystick en D7)", "effect": "Lit le joystick analogique : renvoie 0 si D7 != 0 (un seul joystick) ou si aucun n'est détecté. Sinon bits 0/1 = axe Y bas/haut, bits 2/3 = axe X, bit 7 = bouton.", "port_note": "Le port renvoie aussi les flèches, le pad et le clic souris (bit 7) comme joystick, et le joystick 0 pour un numéro non nul, alors que l'original donne 0 sans joystick." }, { "table": "opernames", "index": "38 (code 0x70)", "name": "oprnd", "operands": "aucun (dépile un mot de la pile d'expressions, borne en D7)", "effect": "Variante de ornd : la graine dépilée subit un ror 6 sur 16 bits, puis graine' = graine*0x7ab7 + 0xf881 (non stockée) ; D7 = mot de poids fort de graine'*D7.", "port_note": "La rotation était fausse pour une graine négative (extension de signe sur 32 bits). À corriger en masquant à 16 bits avant la rotation." }, { "table": "opernames", "index": "39 (code 0x72)", "name": "oscan", "operands": "aucun (utilise le tampon circulaire du script)", "effect": "Lit un mot dans une file circulaire : -1 si lecture == écriture ; sinon D7 = mot en lecture, le curseur avance de 2 et reboucle (retranche la taille du champ 0x16 de l'en-tête) ; quand la file est vide, le bit 7 de l'octet d'état est effacé.", "port_note": "" }, { "table": "opernames", "index": "3a (code 0x74)", "name": "oshiftkey", "operands": "aucun", "effect": "D7 = octet d'état des modificateurs clavier : bit0 Shift gauche, bit1 Shift droit, bit2 Ctrl, bit3 Alt.", "port_note": "Le port lit SDL ; l'un ou l'autre Shift positionne les bits 0 et 1 ensemble (choix délibéré) ; 0 en automode." }, { "table": "opernames", "index": "3b (code 0x76)", "name": "ofree", "operands": "aucun (sélecteur en D7)", "effect": "Mémoire/disque libre : 0..4 donnent des tailles de zones mémoire ou la longueur d'une liste ; 'A'..'D' (majuscule ou minuscule) donnent l'espace disque libre (/1000, plafonné à 0x7d00) ; toute autre valeur donne -1.", "port_note": "Le port traite 0x41..0x48 / 0x61..0x68 comme des lecteurs (E..H en trop) et laisse D7 inchangé pour les autres valeurs > 0x40 au lieu de -1. Les valeurs utilisées (0, 1, 4) ne sont pas touchées. À corriger." }, { "table": "opernames", "index": "3c (code 0x78)", "name": "omodel", "operands": "aucun", "effect": "D7 = 2000 + n selon l'octet vidéo du setup : n = 4, 5 ou 6 pour les modes 5, 6, 8, sinon 2000 (donc 2000, 2004, 2005 ou 2006).", "port_note": "Le port renvoie toujours 2000 pour PC v31 ; sans effet sur les seuils testés par les scripts." }, { "table": "opernames", "index": "3d (code 0x7a)", "name": "ogetkey", "operands": "aucun", "effect": "Attend bloquant qu'une touche soit pressée, puis qu'elles soient toutes relâchées ; D7 = code de la touche.", "port_note": "Le port cède la main (redémarrage de l'opcode) jusqu'à une touche et ne attend pas le relâchement ; équivalent sans blocage." }, { "table": "opernames", "index": "3e (code 0x7c)", "name": "oleft", "operands": "une expression chaîne (dépilée), longueur en D7", "effect": "Garde les D7 premiers caractères de la chaîne : écrit un NUL à l'offset D7 & 0xff du tampon chaîne.", "port_note": "" }, { "table": "opernames", "index": "3f (code 0x7e)", "name": "oright", "operands": "une expression chaîne (dépilée), longueur en D7", "effect": "Garde les D7 derniers caractères : dépile la chaîne dans le tampon, calcule src = fin - D7 (borné au début) et recopie jusqu'au NUL au début du tampon.", "port_note": "Le port avait une fonction vide : la chaîne n'était pas dépilée (pile d'expressions désynchronisée) et aucun résultat. Aucun script n'utilise right() ; en cours d'implémentation." }, { "table": "opernames", "index": "40 (code 0x80)", "name": "omid", "operands": "une expression chaîne (dépilée), départ (mot signé dépilé), longueur en D7", "effect": "Sous-chaîne : calcule src = tampon + départ avant de dépiler la chaîne, puis copie en do-while au moins un octet, jusqu'à la longueur ou au NUL, et termine par NUL. Avec une longueur <= 0 il copie quand même un caractère.", "port_note": "Le port utilisait une boucle for : une longueur <= 0 donnait une chaîne vide. À corriger avec un do-while." }, { "table": "opernames", "index": "41 (code 0x82)", "name": "olen", "operands": "aucun (chaîne courante)", "effect": "D7 = longueur (strlen) de la chaîne du tampon courant.", "port_note": "" }, { "table": "opernames", "index": "42 (code 0x84)", "name": "oasc", "operands": "aucun (chaîne courante)", "effect": "D7 = premier octet de la chaîne, étendu à zéro (0..255).", "port_note": "Le port (avant v6) le lisait signé : les lettres accentuées CP850 (>= 0x80) donnaient une valeur négative. À corriger pour le DOS." }, { "table": "opernames", "index": "43 (code 0x86)", "name": "ostr", "operands": "aucun (valeur en D7)", "effect": "Convertit D7 en chaîne décimale dans le tampon : '-' optionnel, jusqu'à 5 chiffres, zéros de tête supprimés, dernier chiffre toujours écrit. -32768 donne '-32768'.", "port_note": "" }, { "table": "opernames", "index": "44 (code 0x88)", "name": "osadd", "operands": "une expression chaîne (opérande droit)", "effect": "Concaténation : échange les tampons, évalue l'opérande droit, l'ajoute à la chaîne gauche, réechange ; le résultat est dans le tampon courant.", "port_note": "" }, { "table": "opernames", "index": "45 (code 0x8a)", "name": "osequal", "operands": "une expression chaîne (opérande droit)", "effect": "Compare gauche et droite octet par octet ; si la gauche se termine la première, elles sont égales (règle du préfixe). D7 = -1 si égal, sinon 0. Les tampons restent échangés.", "port_note": "" }, { "table": "opernames", "index": "46 (code 0x8c)", "name": "osdiff", "operands": "une expression chaîne (opérande droit)", "effect": "Négation de osequal, avec la même règle du préfixe.", "port_note": "" }, { "table": "opernames", "index": "47 (code 0x8e)", "name": "osinfeg", "operands": "une expression chaîne (opérande droit)", "effect": "Inférieur ou égal sur chaînes : à la première différence, compare la différence d'octets en signé (octets >= 0x80 négatifs) ; règle du préfixe. D7 = -1 ou 0.", "port_note": "Le port utilisait strncmp (octets non signés) : l'ordre diffère avec les lettres accentuées. À corriger avec une comparaison sur octets signés." }, { "table": "opernames", "index": "48 (code 0x90)", "name": "ossupeg", "operands": "une expression chaîne (opérande droit)", "effect": "Supérieur ou égal sur chaînes, via la différence d'octets signée (jnl), règle du préfixe. D7 = -1 ou 0.", "port_note": "Même écart signé/non signé que osinfeg ; à corriger." }, { "table": "opernames", "index": "49 (code 0x92)", "name": "osinf", "operands": "une expression chaîne (opérande droit)", "effect": "Strictement inférieur sur chaînes, via la différence d'octets signée (jl), règle du préfixe. D7 = -1 ou 0.", "port_note": "Même écart signé/non signé que osinfeg ; à corriger." }, { "table": "opernames", "index": "4a (code 0x94)", "name": "ossup", "operands": "une expression chaîne (opérande droit)", "effect": "Strictement supérieur sur chaînes, via la différence d'octets signée (jg), règle du préfixe. D7 = -1 ou 0.", "port_note": "Même écart signé/non signé que osinfeg ; à corriger." }, { "table": "opernames", "index": "4b (code 0x96)", "name": "ospushacc", "operands": "aucun", "effect": "Empile la chaîne courante, NUL compris, sur la pile d'expressions.", "port_note": "" }, { "table": "opernames", "index": "4c (code 0x98)", "name": "ospile", "operands": "aucun (chaîne dépilée de la pile d'expressions)", "effect": "Échange les deux tampons chaîne puis dépile la chaîne de la pile dans le second : l'ancienne chaîne courante devient l'opérande gauche (équivalent chaîne de opile).", "port_note": "" }, { "table": "opernames", "index": "4d (code 0x9a)", "name": "oval", "operands": "aucun (chaîne courante)", "effect": "Convertit la chaîne en entier 16 bits : vide donne 0 ; '-' optionnel ; '$' + chiffres hexadécimaux (insensible à la casse) ou chiffres décimaux ; s'arrête au premier caractère invalide ; négation finale.", "port_note": "" }, { "table": "opernames", "index": "4e (code 0x9c)", "name": "oexistf", "operands": "aucun (nom de fichier dans la chaîne courante)", "effect": "Teste l'existence d'un fichier en l'ouvrant : D7 = -1 s'il existe, 0 sinon.", "port_note": "Le port teste le dossier de données ou le stockage des sauvegardes (substitution d'extension) ; équivalent via la couche hôte." }, { "table": "opernames", "index": "4f (code 0x9e)", "name": "ochr", "operands": "aucun (code en D7)", "effect": "Fabrique une chaîne d'un caractère : tampon[0] = D7 (octet bas), tampon[1] = 0.", "port_note": "" }, { "table": "opernames", "index": "50 (code 0xa0)", "name": "ochange", "operands": "aucun (code lecteur en D7)", "effect": "Change ou lit le lecteur courant : '?' renvoie le lecteur courant ; une lettre a-z/A-Z sélectionne le lecteur (A=0). Résultat : 0 si invalide, sinon la LETTRE du lecteur ('A'+n). Sur disque dur, change('?') renvoie 'C' (67) ou plus.", "port_note": "Le port renvoyait toujours 0 : change('?') < 67 était vrai et les scripts prenaient le chemin disquette (messages « insérez une disquette de sauvegarde »). À corriger en émulant un disque dur (lecteur courant C par défaut)." }, { "table": "opernames", "index": "51 (code 0xa2)", "name": "ocountry", "operands": "aucun", "effect": "D7 = code clavier issu du setup : AZERTY = 1, QWERTZ = 2, sinon (QWERTY) 0.", "port_note": "Le port fixe toujours 0 ; optionnel : le dériver du clavier configuré." }, { "table": "opernames", "index": "52 (code 0xa4)", "name": "omip", "operands": "aucun", "effect": "D7 = indice de vitesse CPU : nombre d'itérations d'une boucle entre deux ticks du timer, plafonné à 0x7fff puis divisé par 40.", "port_note": "Le port renvoie la constante 100 : la scène heros choisit toujours le timing machine lente (clock 7) au lieu de clock 4 sur machine rapide (> 700). À ajuster." }, { "table": "opernames", "index": "53 (code 0xa6)", "name": "ojoykey", "operands": "aucun", "effect": "Renvoie toujours 0 (D7 = 0), sans opérande.", "port_note": "Le port (avant v6) renvoyait les bits fire/Ctrl/Alt du joystick. À corriger : renvoyer 0 pour les jeux DOS v3." }, { "table": "opernames", "index": "54 (code 0xa8)", "name": "oconfig", "operands": "aucun", "effect": "D7 = mot de configuration matérielle : bit0 joystick A, bit1 joystick B, bit2 souris, bit6 (0x40) vitesse CD suffisante ; le bit 7 n'est jamais mis. Typique : 0x44, ou 0x45/0x47 avec joysticks.", "port_note": "Le port renvoyait 0x87 (bit 6 absent, bit 7 en trop). Les branches actuelles des scripts donnent le même résultat ; à corriger en 0x44 (+1/+2 selon les pads)." }, { "table": "opernames", "index": "55 (code 0xaa)", "name": "ogettext", "operands": "aucun", "effect": "Absent de la table originale v3 (entrées 85 à 87 nulles ; sauter à cette entrée planterait). Existe seulement dans les jeux ultérieurs.", "port_note": "Le port fournit ogettext pour les jeux ultérieurs ; sans effet pour Robinson." }, { "table": "opernames", "index": "56 (code 0xac)", "name": "oips", "operands": "aucun", "effect": "Absent de la table originale v3 (entrée nulle) ; opérateur des versions v6.", "port_note": "Présent dans le port (v6), jamais atteint par Robinson." }, { "table": "opernames", "index": "57 (code 0xae)", "name": "(inconnu)", "operands": "aucun", "effect": "Dernière entrée nulle de la table originale, avant la table des storenames. Inutilisée.", "port_note": "" }, { "table": "esc1", "index": "0x00", "name": "cnul", "operands": "aucun", "effect": "Simple ret : ne fait rien et ne lit aucun opérande.", "port_note": "Le port y mettait cnul() qui arrête la VM (état Stopped). À corriger par une fermeture sans effet à l'index 0." }, { "table": "esc1", "index": "0x01", "name": "csoundon", "operands": "aucun", "effect": "Positionne l'indicateur son à 1 : autorise le démarrage des effets sonores et leur mixage dans la boucle de tick.", "port_note": "Le port ne gèle que le mixage ; un son lancé pendant que le son est coupé peut jouer au rétablissement. Optionnel : bloquer aussi le démarrage." }, { "table": "esc1", "index": "0x02", "name": "csoundoff", "operands": "aucun", "effect": "Positionne l'indicateur son à 0 : plus de démarrage ni de mixage des effets sonores.", "port_note": "Même écart que csoundon (démarrage d'un canal non bloqué)." }, { "table": "esc1", "index": "0x03", "name": "cmusicon", "operands": "aucun", "effect": "Positionne l'indicateur musique à 1 : autorise le démarrage de la musique et le mixage de ses voix à chaque tick ; une musique coupée reprend.", "port_note": "Le port ne lit l'indicateur qu'au démarrage d'une musique v2 : à corriger en l'appliquant au mixage." }, { "table": "esc1", "index": "0x04", "name": "cmusicoff", "operands": "aucun", "effect": "Positionne l'indicateur musique à 0 : le mixage des voix de musique cesse aussitôt, la musique devient silencieuse (interrupteur « musique » des préférences).", "port_note": "Le port n'empêchait que le démarrage de la prochaine musique : couper la musique restait sans effet. À corriger dans le mixeur." }, { "table": "esc1", "index": "0x05", "name": "cdelfilm", "operands": "aucun", "effect": "Ferme la vidéo (structure film) : arrête le film en cours, libère le tampon de flux et ferme le fichier ouvert, en remettant les champs à zéro.", "port_note": "" }, { "table": "esc1", "index": "0x06", "name": "copenfilm", "operands": "une expression (id/flags), une expression chaîne (nom du fichier), une expression (taille du tampon de flux, x1000, min 0x23a50), une expression (cadence), puis une cible de stockage", "effect": "Ferme d'abord un film déjà ouvert, ouvre le fichier, règle taille de tampon et cadence, associe l'enregistrement d'écran du script courant (basemain + mot de vram_org-0x16), démarre le film et stocke le mot d'état à la cible.", "port_note": "Le port lit les mêmes opérandes mais ne calcule pas l'enregistrement d'écran du script courant à partir de vram_org ; en cours de correction." }, { "table": "opernames", "index": "0x00 (idx 0)", "name": "oimmb", "operands": "un octet : constante immédiate signée", "effect": "Charge l'octet immédiat dans D7 avec extension de signe (-128..127).", "port_note": "" }, { "table": "opernames", "index": "0x02 (idx 1)", "name": "oimmw", "operands": "un mot 16 bits : constante immédiate", "effect": "Charge le mot immédiat signé dans D7.", "port_note": "" }, { "table": "opernames", "index": "0x04 (idx 2)", "name": "oimmp", "operands": "une chaîne inline terminée par zéro", "effect": "Copie la chaîne inline du script, terminateur compris, dans le tampon sd7. D7 n'est pas modifié.", "port_note": "" }, { "table": "opernames", "index": "0x06 (idx 3)", "name": "olocb", "operands": "un mot signé : décalage dans la vram", "effect": "Lit l'octet signé à vram + décalage et l'étend sur 16 bits dans D7.", "port_note": "" }, { "table": "opernames", "index": "0x08 (idx 4)", "name": "olocw", "operands": "un mot signé : décalage dans la vram", "effect": "Lit le mot à vram + décalage (signé) et le place dans D7.", "port_note": "" }, { "table": "opernames", "index": "0x0a (idx 5)", "name": "olocp", "operands": "un mot signé : décalage dans la vram", "effect": "Copie la chaîne située à vram + décalage dans sd7 (strcpy).", "port_note": "" }, { "table": "opernames", "index": "0x0c (idx 6)", "name": "oloctp", "operands": "un mot signé : décalage du tableau de chaînes dans la vram", "effect": "Désigne une cellule de tableau de chaînes (premier indice = D7, autres indices dépéilés de la pile d'expression), puis copie la chaîne dans sd7. Les bornes sont vérifiées (erreurs 0x17, 0x18, 0x1a). La taille d'élément vient de l'octet base-2, y compris pour les tableaux indirects.", "port_note": "Le port lit le décalage en non signé (sans effet : aucun script n'utilise un décalage >= 0x8000). Pour les tableaux indirects il lit la taille d'élément à l'octet base-1 (l'octet d'en-tête) au lieu de base-2, ce qui donne une mauvaise cellule ; il ne vérifie pas les bornes. Correction : utiliser l'octet base-2 dans tabstring." }, { "table": "opernames", "index": "0x0e (idx 7)", "name": "oloctc", "operands": "un mot signé : décalage du tableau d'octets dans la vram", "effect": "Lit une cellule d'un tableau d'octets (premier indice D7, indices supplémentaires dépilés ; foulées 16 bits en direct, dwords et double déréférencement en indirect), étend l'octet signé dans D7. Chaque produit indice*foulée est tronqué à 16 bits ; bornes vérifiées.", "port_note": "Même mise en page et même ordre de dépilement dans le port. Il ne tronque pas les produits à 16 bits et ne vérifie pas les bornes (écarts mineurs)." }, { "table": "opernames", "index": "0x10 (idx 8)", "name": "olocti", "operands": "un mot signé : décalage du tableau de mots dans la vram", "effect": "Lit une cellule d'un tableau de mots (DX*2 calculé sur 16 bits, dimensions supplémentaires comme pour oloctc) et place le mot dans D7.", "port_note": "Le port n'effectue pas les contrôles de bornes (écart mineur)." }, { "table": "opernames", "index": "0x12 (idx 9)", "name": "odirb", "operands": "un octet : décalage dans la vram (non signé)", "effect": "Lit l'octet signé à vram + décalage et l'étend dans D7.", "port_note": "" }, { "table": "opernames", "index": "0x14 (idx 10)", "name": "odirw", "operands": "un octet : décalage dans la vram (non signé)", "effect": "Lit le mot à vram + décalage et le place dans D7.", "port_note": "" }, { "table": "opernames", "index": "0x16 (idx 11)", "name": "odirp", "operands": "un octet : décalage dans la vram (non signé)", "effect": "Copie la chaîne située à vram + décalage dans sd7.", "port_note": "" }, { "table": "opernames", "index": "0x18 (idx 12)", "name": "odirtp", "operands": "un octet : décalage du tableau de chaînes dans la vram (non signé)", "effect": "Désigne une cellule de tableau de chaînes (indice D7 + pile) et copie la chaîne dans sd7, avec vérification des bornes. Entrée très utilisée.", "port_note": "Les opérandes sont identiques, mais tabstring lit la taille d'élément des tableaux indirects à l'octet base-1 au lieu de base-2 : mauvaise cellule pour tout tableau de chaînes indirect. Pas de contrôle de bornes. Correction : xread8($addr) au lieu de xread8($addr+1)." }, { "table": "opernames", "index": "0x1a (idx 13)", "name": "odirtc", "operands": "un octet : décalage du tableau d'octets dans la vram", "effect": "Lit une cellule d'un tableau d'octets (même mécanisme qu'oloctc) et étend l'octet signé dans D7.", "port_note": "" }, { "table": "opernames", "index": "0x1c (idx 14)", "name": "odirti", "operands": "un octet : décalage du tableau de mots dans la vram", "effect": "Lit une cellule d'un tableau de mots (même mécanisme qu'olocti) et place le mot dans D7.", "port_note": "" }, { "table": "opernames", "index": "0x1e (idx 15)", "name": "omainb", "operands": "un mot signé : décalage dans basemain", "effect": "Lit l'octet signé à basemain + décalage et le place dans D7.", "port_note": "" }, { "table": "opernames", "index": "0x20 (idx 16)", "name": "omainw", "operands": "un mot signé : décalage dans basemain", "effect": "Lit le mot à basemain + décalage et le place dans D7.", "port_note": "" }, { "table": "opernames", "index": "0x22 (idx 17)", "name": "omainp", "operands": "un mot signé : décalage dans basemain", "effect": "Copie la chaîne située à basemain + décalage dans sd7.", "port_note": "" }, { "table": "opernames", "index": "0x24 (idx 18)", "name": "omaintp", "operands": "un mot signé : décalage du tableau de chaînes dans basemain", "effect": "Comme oloctp, mais le tableau est dans basemain : cellule de tableau de chaînes (indice D7 + pile), copiée dans sd7.", "port_note": "Même défaut que oloctp : la taille d'élément des tableaux indirects est lue à base-1 au lieu de base-2. Le décalage non signé est sans conséquence. Correction identique (alis.php:1515)." }, { "table": "opernames", "index": "0x26 (idx 19)", "name": "omaintc", "operands": "un mot signé : décalage du tableau d'octets dans basemain", "effect": "Lit une cellule d'un tableau d'octets de basemain (même mécanisme qu'oloctc) et étend l'octet signé dans D7.", "port_note": "" }, { "table": "opernames", "index": "0x28 (idx 20)", "name": "omainti", "operands": "un mot signé : décalage du tableau de mots dans basemain", "effect": "Lit une cellule d'un tableau de mots de basemain (même mécanisme qu'olocti) et place le mot dans D7.", "port_note": "" }, { "table": "opernames", "index": "0x2a (idx 21)", "name": "ohimb", "operands": "deux mots : variable d'entité (décalage dans la vram), puis décalage signé dans la vram de l'autre entité", "effect": "Le premier mot désigne une entrée d'entité (négative : erreur fatale 0x1b) ; on obtient la vram de l'autre entité via atent. Si cette vram est <= 0 (entité morte ou vide), l'opérande s'arrête sans toucher à D7. Sinon D7 = octet signé à vram_autre + décalage.", "port_note": "Dans la branche v3 (version < 60), le port ne teste pas la vram <= 0 : il lit la mémoire basse et met une valeur parasite dans D7. Correction : tester vram <= 0 pour toutes les versions, et garder le décalage signé." }, { "table": "opernames", "index": "0x2c (idx 22)", "name": "ohimw", "operands": "deux mots : variable d'entité, puis décalage signé dans la vram de l'autre entité", "effect": "Comme ohimb mais lit un mot (erreur 0x1d si l'entrée est négative). Si la vram cible est <= 0, D7 reste inchangé.", "port_note": "Dans la branche v3 le port lit le mot même pour une entité morte, sans test vram <= 0. Correction : ajouter ce test pour toutes les versions." }, { "table": "opernames", "index": "0x2e (idx 23)", "name": "ohimp", "operands": "deux mots : variable d'entité, puis décalage signé", "effect": "Retrouve la vram de l'autre entité (sans contrôle de validité) et copie la chaîne à vram_autre + décalage dans sd7.", "port_note": "" }, { "table": "opernames", "index": "0x30 (idx 24)", "name": "ohimtp", "operands": "deux mots : d'abord le décalage du tableau, puis la variable d'entité", "effect": "Retrouve la vram de l'entité cible via la variable d'entité (sans contrôle), puis désigne une cellule de tableau de chaînes dans cette vram (indice D7 + pile) et copie la chaîne dans sd7.", "port_note": "La fonction du port est vide : elle ne lit aucun opérande et le script se désynchroniserait (Grammar.php décode aussi sans opérande). Correction prévue : implémenter la lecture des deux mots (décalage du tableau en premier) et corriger la grammaire. Non utilisée par le jeu." }, { "table": "opernames", "index": "0x32 (idx 25)", "name": "ohimtc", "operands": "deux mots : d'abord le décalage du tableau, puis la variable d'entité", "effect": "Retrouve la vram de l'entité cible, lit une cellule d'un tableau d'octets de cette vram et étend l'octet signé dans D7.", "port_note": "Le port ne l'implémente que pour la version 10 ; en v3 (31) il ne lit aucun opérande et le script se désynchroniserait. Correction : étendre la condition de version et corriger Grammar.php. Non utilisée par le jeu." }, { "table": "opernames", "index": "0x34 (idx 26)", "name": "ohimti", "operands": "deux mots : d'abord le décalage du tableau, puis la variable d'entité", "effect": "Comme ohimtc mais lit une cellule d'un tableau de mots de la vram de l'entité cible et place le mot dans D7.", "port_note": "Le port ne gère que la version 10 ; en v31 il ne lit aucun opérande (désynchronisation). Correction : étendre la branche v10 à v31 et corriger Grammar.php. Non utilisée par le jeu." }, { "table": "opernames", "index": "0x36 (idx 27)", "name": "opile", "operands": "aucun", "effect": "Dépile la valeur de la pile d'expression 16 bits : D7 reçoit l'ancien D6 (CX) et D6 reçoit la valeur dépilée.", "port_note": "" }, { "table": "opernames", "index": "0x38 (idx 28)", "name": "oeval", "operands": "une suite d'opérandes d'expression, terminée par ofin", "effect": "Boucle : évalue les opérandes suivants un par un (sans copier DX dans CX) jusqu'à rencontrer ofin. Les oeval imbriqués fonctionnent grâce à la pile CPU.", "port_note": "Le port utilise un drapeau global Alis::$oeval_loop : un oeval imbriqué terminerait la boucle externe trop tôt. Aucun script du jeu n'en contient (0 imbrication sur 9316 oeval), donc sans effet ici." }, { "table": "opernames", "index": "0x3a (idx 29)", "name": "ofin", "operands": "aucun", "effect": "Termine la boucle d'un oeval. N'apparaît que comme terminateur d'oeval/seval.", "port_note": "" }, { "table": "opernames", "index": "0x3c (idx 30)", "name": "oimml", "operands": "sans objet en v31 (entrée nulle dans la table d'origine)", "effect": "Cette entrée n'existe pas dans la version 31 : la table contient 0 et un saut y planterait. Elle n'est jamais utilisée par le jeu.", "port_note": "Le port fournit la version v6 d'oimml (lit un long de 32 bits). Sans conséquence, puisque le jeu ne l'utilise pas." }, { "table": "opernames", "index": "0x3e (idx 31)", "name": "olocto", "operands": "sans objet en v31 (entrée nulle dans la table d'origine)", "effect": "Entrée absente de la version 31 (valeur 0 dans la table). Jamais utilisée.", "port_note": "Le port fournit la version v6 d'olocto. Sans conséquence." }, { "table": "opernames", "index": "0x40 (idx 32)", "name": "opushacc", "operands": "aucun", "effect": "Empile D7 (mot de 16 bits) sur la pile d'expression. Cette pile est réinitialisée à chaque entrée dans une expression.", "port_note": "Le port empile une cellule de 32 bits sur Alis::$acc, remise à zéro seulement au démarrage d'un script. Les valeurs sont identiques dans une expression ; un push jamais dépilé s'accumulerait, mais aucun script ne le fait." }, { "table": "opernames", "index": "0x42 (idx 33)", "name": "oand", "operands": "un opérande d'expression (opérande droit)", "effect": "Copie D7 dans D6, évalue l'opérande suivant dans D7, puis D7 = D7 & D6 (ET binaire 16 bits).", "port_note": "" }, { "table": "opernames", "index": "0x44 (idx 34)", "name": "oor", "operands": "un opérande d'expression", "effect": "Évalue l'opérande suivant (D6 = ancien D7) puis D7 = D7 | D6.", "port_note": "" }, { "table": "opernames", "index": "0x46 (idx 35)", "name": "oxor", "operands": "un opérande d'expression", "effect": "Évalue l'opérande suivant puis D7 = D7 ^ D6 (OU exclusif).", "port_note": "" }, { "table": "opernames", "index": "0x48 (idx 36)", "name": "oeqv", "operands": "un opérande d'expression", "effect": "Évalue l'opérande suivant puis D7 = NON(D7 XOR D6), sur 16 bits (équivalence logique).", "port_note": "" }, { "table": "opernames", "index": "0x4a (idx 37)", "name": "oegal", "operands": "un opérande d'expression", "effect": "Compare : D7 vaut 0xffff (-1) si les deux valeurs sont égales, 0 sinon.", "port_note": "" }, { "table": "opernames", "index": "0x4c (idx 38)", "name": "odiff", "operands": "un opérande d'expression", "effect": "D7 = -1 si les deux valeurs sont différentes, 0 sinon.", "port_note": "" }, { "table": "opernames", "index": "0x4e (idx 39)", "name": "oinfeg", "operands": "un opérande d'expression", "effect": "D7 = -1 si gauche (D6) <= droite (D7), comparaison signée 16 bits, sinon 0.", "port_note": "" }, { "table": "opernames", "index": "0x50 (idx 40)", "name": "osupeg", "operands": "un opérande d'expression", "effect": "D7 = -1 si gauche (D6) >= droite (D7), comparaison signée 16 bits, sinon 0.", "port_note": "" }, { "table": "opernames", "index": "0x52 (idx 41)", "name": "oinf", "operands": "un opérande d'expression", "effect": "D7 = -1 si gauche (D6) < droite (D7), comparaison signée, sinon 0.", "port_note": "" }, { "table": "opernames", "index": "0x54 (idx 42)", "name": "osup", "operands": "un opérande d'expression", "effect": "D7 = -1 si gauche (D6) > droite (D7), comparaison signée, sinon 0.", "port_note": "" }, { "table": "opcodes", "index": "f2", "name": "cscaset", "operands": "trois expressions (a, b, c)", "effect": "Sur l'écran courant (basemain + identifiant d'écran de la vram) : écrit c en +0x38 et a en +0x34 ; en +0x36 il écrit aussi a en pratique (l'évaluation de c écrase CX par DX, donc b est perdu). Active ensuite le bit « sale » 0x80 de l'octet 0 de l'écran.", "port_note": "Le port est un stub vide : il ne lit aucun opérande, le script se désynchroniserait si l'opcode s'exécutait. Implémentation prévue : lire a, b, c, écrire +0x38=c, +0x36=a, +0x34=a, puis positionner le bit 0x80. Opcode jamais utilisé par le jeu." }, { "table": "opcodes", "index": "f3", "name": "cscamov", "operands": "trois expressions (a, b, c)", "effect": "Sur l'écran courant, ajoute (avec bouclage 16 bits) a au mot +0x34, b au mot +0x36 et c au mot +0x38 : déplacement relatif de la caméra. Active le bit « sale » 0x80 de l'écran.", "port_note": "Le port est un stub vide qui ne lit aucun opérande. Implémentation prévue : trois évaluations, trois additions 16 bits et activation du bit 0x80. Jamais utilisé par le jeu." }, { "table": "opcodes", "index": "f4", "name": "cscfollow", "operands": "huit expressions (e1 à e8)", "effect": "Configure le suivi de caméra sur l'écran courant : mot +0x60 = e1, octet +0x84 = e2, mots +0x86 à +0x8e = e3 à e7, mot +0x90 = e8. Active ensuite le bit « sale » 0x80 de l'octet 0 de l'écran.", "port_note": "Le port écrit les mêmes champs mais n'active jamais le bit 0x80 (contrairement à cscview). Correction : ajouter l'écriture du bit 0x80 en fin de fonction. La subtilité AX/DX sur le 8e opérande est sans effet pour le jeu." }, { "table": "opcodes", "index": "f5", "name": "cscview", "operands": "six expressions", "effect": "Écrit les six valeurs, dans l'ordre, dans les mots +0x64, +0x66, +0x68, +0x6a, +0x6c, +0x6e de l'écran courant (paramètres de vue), puis active le bit « sale » 0x80.", "port_note": "" }, { "table": "opcodes", "index": "f6", "name": "cfilm", "operands": "trois expressions : identifiant de film, ressource, waitclock", "effect": "Démarre un film : la première expression est l'identifiant (stocké), la seconde est résolue vers les données de la ressource elle-même ; addr1 et addr2 pointent à ressource+0x20, le mot bfilm+0x4e est mis à 0, waitclock = troisième expression, et bfilm+0x4a reçoit l'adresse de l'écran. Puis inifilm et enregistrement du nombre de trames (mot bfilm+6). Seul le mot +0x4e est réinitialisé.", "port_note": "Le port utilise adresdes(id)+0x24, or adresdes renvoie l'adresse de l'entrée de table non résolue : le pointeur de film est faux. Il fixe aussi bfilm->basemain à basemain au lieu de l'adresse de l'écran, et réinitialise tous les champs du film. Opcode jamais utilisé par les scripts de Robinson ; correction possible si besoin." }, { "table": "opcodes", "index": "f7", "name": "cwalkmap", "operands": "un décalage de carte (0 = carte main), puis trois expressions (walkhaut, walktete, walkdim)", "effect": "Fait marcher l'entité sur une carte d'altitudes : walkhaut (+0x1aad8, hauteur de marche max), walktete (+0x1aada, tangage / balancement de tête) et walkdim (inutilisé) sont écrits, puis la routine de marche déplace la position selon le vecteur de pas tourné. Elle lance toujours cinq sondes d'altitude anticipées (devant, côtés, 2x) : toute altitude >= 0xff est un mur et bloque le déplacement. Si |walkcz - ocz| > walkhaut, le déplacement est refusé et rien n'est écrit. Résultat stocké : walkcz - walkocz. Pour le flag matériau == 1 avec dword non nul et matmask != 0, landalti ajoute 0xff à l'altitude. Le balancement (walktete > 0) somme 4*(s1-oz) + 2*(s2-oz) + (s4-oz), multiplie la valeur absolue par l'octet haut signé de walktete et compare à son octet bas.", "port_note": "Écarts importants. (1) Les cinq sondes ne sont lancées que si matmask != 0 et avec des vecteurs basés sur la dimension de carte : avec walktete = 0 il n'y a aucune anticipation contre les cellules mur. (2) Sur déplacement refusé, le port appelle landalti et écrit WCZ au lieu de ne rien écrire. (3) Le +0xff d'altitude est ignoré, donc les cellules matériau ne bloquent pas avec walktete = -1. (4) Balancement : l'échantillon 2x est omis et le seuil utilise walkmap3. Correction prévue : vecteurs de pas tournés (cos/sin * décalage) << 7, sondes inconditionnelles, aucune écriture au rejet, +0xff réintroduit. Le balancement n'est pas utilisé par le jeu." }, { "table": "opcodes", "index": "f8", "name": "catstmap", "operands": "un décalage de carte (0 = carte main), puis trois expressions x, y, z", "effect": "Teste une position sur la carte : calcule un vecteur polaire (polarmov avec les angles de l'entité), obtient X = (WCX32 + vx) >> 16 et Y = (WCY32 + vy) >> 16, met matmask à 0, appelle landalti et stocke le mot de la cellule (cellule redirigée en cas de surplomb). Hors limites, stocke le mot bas du vecteur polaire Y.", "port_note": "Le port est conforme, sauf hors limites : il stocke D7 (z) au lieu du mot bas du vecteur Y. Correction facultative." }, { "table": "opcodes", "index": "f9", "name": "cavtstmov", "operands": "aucun opérande de script direct ; une expression (matmask)", "effect": "Teste un déplacement avant de l'appliquer : polarmov avec les vitesses signées (+0x34, +0x38, +0x3c) et les angles de l'entité, positions candidates X, Y, Z (mots hauts de WC32 + vecteur) écrites en 0x16028/2a/2c. matmask = expression, cforme de l'entité, puis clipform et succent avec stockage. Ne positionne pas 0x1602e.", "port_note": "" }, { "table": "opcodes", "index": "fa", "name": "cavmov", "operands": "aucun", "effect": "Avance l'entité : polarmov avec les vitesses signées (+0x34, +0x38, +0x3c) et les angles ; la partie entière du vecteur est ajoutée (16 bits) aux coordonnées WCX, WCY, WCZ. Les fractions ne sont pas modifiées.", "port_note": "" }, { "table": "opcodes", "index": "fb", "name": "caim", "operands": "quatre expressions : x, y, z et tour maximal par appel", "effect": "Oriente l'entité vers un point : polarang donne azimut, élévation et distance. Si la distance est 0, l'azimut reste WCAZ. Quand le tour maximal est < 180, l'écart est borné par rapport à WCAZ avec gestion du bouclage (±360), le résultat étant normalisé à ±359. Stocke S1 = élévation (toujours), S2 = nouvel azimut, S3 = distance.", "port_note": "Le port diffère dans deux cas, jamais atteints car le jeu passe toujours 360 : (a) il écrase l'élévation par WCAZ, donc S1 reçoit l'azimut courant ; (b) la branche « écart > 179 » n'applique pas la borne positive quand écart-360 reste >= 0. Un cas limite de division dans polarang diffère aussi. Correction : variable locale distincte pour WCAZ et borne positive." }, { "table": "opcodes", "index": "fc", "name": "cpointpix", "operands": "deux expressions (x, y)", "effect": "Convertit un point écran (x, y) en coordonnées de scène (cx, cy, cz) via pixtoland, avec le contexte de rendu dérivé de l'entité courante (atent, repli basemain). Sur l'écran : sauvegarde le mot de flags, met le bit 7 si le bit 6 est nul, appelle affiland, puis restaure les flags. Écrit cx, cy, cz, d, n, e dans cet ordre.", "port_note": "Le port ne positionne pas le bit 7 de l'écran avant affiland et ne sauvegarde/restaure pas le mot de flags : une modification faite par affiland persiste. Correction prévue." }, { "table": "opcodes", "index": "fd", "name": "cchartmap", "operands": "un sous-code, puis selon le cas des expressions de position/rayon", "effect": "Opère sur la carte (map) : sous-codes 0/1 remplissent le bitmap avec 0 ou 0xffff puis lisent un offset de carte ; 2 et 3 écrivent le champ -0x3b6 ; 4 écrit -0x3ae ; 5 écrit -0x3b0 ; toute autre valeur efface un rectangle autour de la position courante (centre = mots WCX/WCY du script courant). Le nombre de mots remplis utilise un décalage logique.", "port_note": "Le port prend le centre dans Alis::$wcx/$wcy (globaux du dernier tstmov, possiblement périmés) au lieu des WCX/WCY du script courant, et utilise un décalage arithmétique signé pour le comptage de remplissage. Correction prévue." }, { "table": "opcodes", "index": "fe", "name": "cscsky", "operands": "trois expressions (e1, e2, e3)", "effect": "Configure le ciel d'un écran : +0xa2 = e1, +0xa4 = adresse de l'entrée de table de e2 (respecte flagmain sans l'effacer), +0xa8 = e3 puis recalculé à partir de h6c et de la largeur du sprite (division par 0x168, masque 0xff00), et met le bit 7 de l'écran.", "port_note": "Le port force flagmain à 0, ne tronque pas 4*h6c sur 16 bits et lit la largeur signée au lieu de movzx. Sans effet avec les valeurs du jeu (h6c ~1110..1120)." }, { "table": "opcodes", "index": "ff", "name": "czoom", "operands": "deux expressions", "effect": "Stocke les deux valeurs dans les mots vram-0x36 et vram-0x38 du script courant, dans cet ordre.", "port_note": "" }, { "table": "opcodes", "index": "0x2c", "name": "cloop16", "operands": "un décalage signé 16 bits, puis la cible addname (variable à décrémenter)", "effect": "Boucle compteur : échange sd7/oldsd7, ajoute -1 à la variable cible ; si le résultat est nul, continue après l'instruction, sinon saute au décalage relatif (par rapport à l'octet suivant le décalage).", "port_note": "" }, { "table": "opcodes", "index": "0x2d", "name": "cloop24", "operands": "un décalage sur 3 octets (le 3e est ignoré), puis la cible addname", "effect": "Identique à cloop16 mais le champ de décalage occupe 3 octets ; le saut est relatif à l'octet suivant le champ.", "port_note": "" }, { "table": "opcodes", "index": "0x2e", "name": "cswitch1", "operands": "une expression, un octet n, puis n+1 paires (valeur s16, décalage s16) alignées sur un mot", "effect": "Évalue l'expression et la compare, en signé 16 bits, aux valeurs de la table triée : égalité = saut au décalage de la paire ; valeur inférieure = abandon de la recherche et suite après la table ; sinon entrée suivante. Sans correspondance, le script continue après la table.", "port_note": "" }, { "table": "opcodes", "index": "0x2f", "name": "cswitch2", "operands": "une expression, un octet n, une base s16, puis n+1 décalages s16 alignés sur un mot", "effect": "Switch indexé : D7 = expr + base (16 bits). Si D7 est dans [0, n], saute via la table de décalages à l'indice D7 ; sinon passe la table. D7 conserve la valeur calculée.", "port_note": "" }, { "table": "opcodes", "index": "0x30", "name": "cstart8", "operands": "un décalage signé sur 1 octet", "effect": "Démarre une sous-séquence : empile l'adresse de reprise du script (pile interne via les champs -8/-0xa/-0xc selon fseq) et positionne l'adresse de reprise à la cible, marque l'entité active (octets -4 et -1 à 1, délai -0x3e à 0). Le flux courant n'est pas déplacé en mode fseq=0.", "port_note": "" }, { "table": "opcodes", "index": "0x31", "name": "cstart16", "operands": "un décalage signé 16 bits", "effect": "Comme cstart8 avec un décalage sur 16 bits.", "port_note": "" }, { "table": "opcodes", "index": "0x32", "name": "cstart24", "operands": "un décalage sur 3 octets (le 3e est ignoré)", "effect": "Comme cstart8 avec un champ de 3 octets dont seuls 16 bits sont utilisés.", "port_note": "" }, { "table": "opcodes", "index": "0x33", "name": "cleave", "operands": "aucun", "effect": "Quitte une sous-séquence lancée par cstart : si le champ -0xc est non nul, le remet à 0 et restaure l'adresse de reprise absolue sauvegardée (fseq=0 : champ -8 ; fseq!=0 : ESI), puis ajuste le pointeur de pile. Si -0xc est nul, se comporte comme cret sans toucher à -0xa.", "port_note": "Le port restaure le champ 0x08 avec un offset relatif au lieu d'une adresse absolue (fseq=0), et en mode fseq!=0 modifie vacc_off avant de tester si -0xc est nul. Correction prévue." }, { "table": "opcodes", "index": "0x34", "name": "cprotect", "operands": "une expression", "effect": "Stocke la valeur comme mot dans une variable de protection. Une routine périodique ne réagit que si elle est > 0, appelle une vérification de protection qui est un stub renvoyant 0 : aucun sabotage ne survient jamais.", "port_note": "" }, { "table": "opcodes", "index": "0x35", "name": "casleep", "operands": "une expression (handle d'entité)", "effect": "Si la valeur (16 bits signée) est >= 0 et que l'entrée correspondante de la table des entités est non nulle, met l'octet vram-4 à 0 : l'entité visée est endormie.", "port_note": "" }, { "table": "opcodes", "index": "0x36", "name": "cclock", "operands": "une expression (durée)", "effect": "Écrit la durée dans le mot vram-0x3a et, dans le dword vram-0x3e, l'heure de réveil = timeclock + durée étendue sans signe sur 16 bits.", "port_note": "Le port utilise une durée signée non masquée, ce qui change l'heure de réveil pour une valeur négative ou > 0xffff ; le test de réveil de la boucle principale est aussi non signé alors que l'original compare en signé. Correction prévue." }, { "table": "opcodes", "index": "0x37", "name": "canim", "operands": "aucun", "effect": "Simple retour, sans effet (instruction nulle).", "port_note": "" }, { "table": "opcodes", "index": "0x38", "name": "cscmov", "operands": "trois expressions (x, y, z)", "effect": "Déplacement relatif d'un écran : pour z, y puis x, si la valeur est non nulle, l'ajoute aux mots +0x1a, +0x18, +0x16 de l'écran (basemain + id) et met le bit 7 de son état.", "port_note": "" }, { "table": "opcodes", "index": "0x39", "name": "cscset", "operands": "trois expressions (x, y, z)", "effect": "Positionnement absolu d'un écran : pour z, y, x, si la valeur diffère du mot courant (+0x1a/+0x18/+0x16), la stocke et met le bit 7 de l'état de l'écran.", "port_note": "" }, { "table": "opcodes", "index": "0x3a", "name": "cclipping", "operands": "aucun", "effect": "Met à 0 l'octet d'indicateur de clipping. Dans cette version DOS l'indicateur est inerte : ses lecteurs prennent le même chemin dans les deux cas.", "port_note": "Le port met fswitch à 0, ce qui change réellement son chemin de rendu (dessin direct au lieu du double tampon) jusqu'au prochain cswitching. Visible seulement sur l'écran du mot de passe de debug ; comportement jugé acceptable." }, { "table": "opcodes", "index": "0x3b", "name": "cswitching", "operands": "aucun", "effect": "Simple retour : instruction non implémentée dans cette version DOS (no-op).", "port_note": "Le port met fswitch à 1, car son moteur de rendu en dépend pour afficher quoi que ce soit. Différence volontaire et documentée, propre à la plateforme." }, { "table": "opcodes", "index": "0x3c", "name": "cwlive", "operands": "un index de forme (get_vector), puis le corps de clive", "effect": "Calcule une position d'apparition à partir d'une forme : type 0 = octets signés +4/+5/+6 plus (octets +7/+8/+9) >> 1 ; type 1 = mots +4/+6/+8 plus (mots +0xa/+0xc/+0xe) >> 1 ; type >= 2 = mots +2/+4/+6 ; type négatif = erreur fatale 0x14. Les coordonnées sont niées si l'octet vram-0x2e >= 0x15 et vram-3 non nul, stockées en 0x16028..2c, puis exécute le corps de clive.", "port_note": "Le port lit les octets du type 0 et les deltas du type 1 sans signe, et ignore un type négatif (0,0,0 sans négation) au lieu d'une erreur fatale. Non utilisé par Robinson ; correction prévue." }, { "table": "opcodes", "index": "0x3d", "name": "cunload", "operands": "un mot (id de programme)", "effect": "Décharge un programme : ignore -1 et l'id du script courant ; trouve le programme par id, calcule sa longueur jusqu'au programme suivant (ou finprog), appelle une routine son (qui arrête un canal ou tous les 4 si le bit 7 de la longueur est posé, quand le son est actif), met un indicateur à 1, puis shrinkprog déplace la mémoire et tue les entités du script.", "port_note": "Le port fait shrinkprog et relocalise les samples en lecture (audio_relocate) mais n'imite pas l'arrêt des canaux sonores de la routine d'origine. Fidélité optionnelle." }, { "table": "opcodes", "index": "0x3e", "name": "cwakeup", "operands": "une expression (handle d'entité)", "effect": "Si la valeur est >= 0 et que atent[valeur] est non nul, met l'octet vram-4 à 1 : réveille l'entité.", "port_note": "" }, { "table": "opcodes", "index": "0x3f", "name": "csleep", "operands": "aucun", "effect": "Met l'octet vram-4 à 0 (endort l'entité courante) ; si fseq est non nul, quitte aussitôt la boucle d'opcodes du script.", "port_note": "" }, { "table": "opcodes", "index": "0x40", "name": "clive", "operands": "un mot (id de programme)", "effect": "Crée une entité à partir d'un programme : remet à 0 les coordonnées 0x16028..2c, cherche le programme (introuvable = erreur fatale 0x15 et D7 = -1), lie une nouvelle entité (erreurs fatales si trop d'entités ou vram saturée), copie dwords/mots de position et de contexte du script courant, ajoute wcx/wcy/wcz aux positions, copie -0x16 et -0x22, puis stocke l'index via sd7/oldsd7 et storename.", "port_note": "Le port copie en plus le mot +0x30 (absent de l'original), et sur programme introuvable fait un simple return au lieu de l'erreur fatale puis du stockage de -1. Correction prévue." }, { "table": "opcodes", "index": "0x41", "name": "ckill", "operands": "une expression (handle d'entité)", "effect": "Ignore les valeurs négatives et 0 (l'entité 0, script principal, ne peut pas être tuée). Sinon killent : efface les sprites de l'entité, comprime la vram, décale les pointeurs, libère le slot ; si l'entité tuée est la courante, passe à l'entité suivante.", "port_note": "Pour la version < 60, le port ne rejette que les valeurs négatives : la valeur 0 tue l'entité principale. Correction prévue (tester <= 0)." }, { "table": "opcodes", "index": "0xdc", "name": "ccancall", "operands": "aucun", "effect": "Met ferase à 1 puis exécute cerasall : parcourt la liste des éléments d'écran du script, les détache et les met dans la liste libre, puis remet ferase à 0.", "port_note": "" }, { "table": "opcodes", "index": "0xdd", "name": "ccancen", "operands": "une expression (numéro d'élément, octet bas)", "effect": "Met ferase à 1 puis exécute cerasen : stocke numelem, boucle searchelem/killelem sur l'écran courant jusqu'à ce qu'il n'y ait plus d'élément correspondant, puis ferase = 0.", "port_note": "" }, { "table": "opcodes", "index": "0xde", "name": "cblast", "operands": "une expression (handle d'entité)", "effect": "Met ferase à 1 puis exécute ckill : ignore les valeurs négatives ou nulles (ferase reste alors à 1), sinon tue l'entité (killent efface ses éléments, ferase remis à 0).", "port_note": "Même défaut que ckill : le port ne rejette que les valeurs négatives, donc 0 tue l'entité principale. Correction prévue." }, { "table": "opcodes", "index": "0xdf", "name": "cscback", "operands": "six expressions (sback, backprof, x1, y1, x2, y2)", "effect": "Dans cette version DOS, stocke simplement les six valeurs dans des globales (octet sback, mots backprof, x1, y1, x2, y2) et rend la main. Rien n'est initialisé : la fonction est inutilisée ailleurs dans l'exécutable.", "port_note": "Le port consomme les mêmes six opérandes mais exécute aussi iniback, prépare le backsprite, bascule le bit 2 de l'écran et appelle rangesprite. Jamais utilisé par Robinson ; correction facultative." }, { "table": "opcodes", "index": "0xe0", "name": "cscrolpage", "operands": "quatre expressions (spag, pagdx, pagdy, pagcount)", "effect": "Stocke spag (octet), pagdx, pagdy, pagcount (mots) dans les globales de défilement de page ; si spag != 0, met le bit 0x20 de l'octet 0 de l'écran (basemain + id).", "port_note": "" }, { "table": "opcodes", "index": "0xe1", "name": "cmatent", "operands": "aucun", "effect": "Met dans D7 le mot matent de la dernière entrée de tablent (pointée par ptrent) puis continue comme cstore (échange sd7/oldsd7 et storename).", "port_note": "" }, { "table": "opcodes", "index": "0xe2", "name": "cshrink", "operands": "deux expressions (index de bitmap, second inutilisé)", "effect": "Réduit un bitmap en mémoire : flagmain = 0, résout le bitmap via adresdes ; seuls les formats 0x00/0x02/0x10/0x12 et 0x14/0x16 sont traités (les autres : retour immédiat). Taille = ((w+1)>>1)*(h+1), doublée pour 0x14/0x16 ; retour si h == 0. Relocalise les offsets de ressources situés au-dessus, retranche la taille des champs +6 et +0xc, met w = 0xf et h = 0, puis déplace la mémoire jusqu'à finprog et réduit finprog.", "port_note": "Le port diffère sur le calcul de largeur/taille et traite d'autres formats (0x18/0x1a, 0x1c/0x1e) au lieu de retourner immédiatement. Correction prévue pour DOS." }, { "table": "opcodes", "index": "0xe3", "name": "cdefmap", "operands": "une adresse de variable (mot, 0 = main + mot), puis sept expressions", "effect": "Définit une carte : [m-0x400] = e1 ; e2 stocké octets inversés (-0x3fe = poids fort, -0x3fd = poids faible) ; e3/e4 donnent les bornes (-0x3fa, -0x3f8 += e4-1) ; e5..e7 vont en -0x3f4/-0x3f2/-0x3f0 sans bornage à 1. Calcule ensuite par division (diviseur 32 bits complet si l'octet [m-1] est négatif, sinon 16 bits) les champs -0x3c6/-0x3cc/-0x3c4/-0x3ca, met le mot -0x3b6 du SCRIPT appelant à 0, et déduit les compteurs de bits -0x3c0/-0x3be/-0x3bc.", "port_note": "Le port stocke e2 sans l'inversion d'octets, écrit le champ -0x3b6 par rapport à la carte au lieu du script, borne e5..e7 à 1 minimum et n'utilise pas le diviseur 32 bits complet. Correction prévue." }, { "table": "opcodes", "index": "0xe4", "name": "csetmap", "operands": "une adresse de variable, puis six expressions", "effect": "Positionne la fenêtre de carte : -0x3ee, -0x3ec, -0x3ea, -0x3e8 = e1..e4 ; -0x3d6 = e4-1 et -0x3ee += (e4-1)>>1 ; -0x3e6, -0x3e4 = e5, e6 ; -0x3d4 = e6-1 et -0x3ea += (e6-1)>>1 (décalages 16 bits).", "port_note": "" }, { "table": "opcodes", "index": "0xe5", "name": "cputmap", "operands": "une adresse de variable, puis quatre expressions", "effect": "Place la carte à l'écran : -0x3e2, -0x3e0, -0x3de = e1..e3 ; e4 = numelem (mot) ; reste de (-0x3de) / (-0x3f0) (division 16 bits non signée) en -0x3d2 ; fmuldes = 0 ; searchelem, sinon createlem (état 2). Effectue le put commun, puis cherche à nouveau l'élément et, s'il existe, met +0x1c = 0xff, +0x23 = +0x21 = 0 et depx/depy/depz depuis -0x3ee/-0x3ec/-0x3ea.", "port_note": "Le port utilise le s16 signé comme dividende du modulo : le reste diffère pour une position négative et une largeur non puissance de deux. Robinson passe 0, aucun effet ; correction prévue." }, { "table": "opcodes", "index": "0xe6", "name": "csavepal", "operands": "une expression", "effect": "Pour -2 <= v <= -1 uniquement, copie les 0x180 mots (768 octets) de la palette cible vers la palette de sauvegarde 1 (v = -1) ou 2 (v = -2). Toute autre valeur ne fait rien.", "port_note": "" }, { "table": "opcodes", "index": "0xe7", "name": "csczoom", "operands": "trois expressions (e1, e2, e3)", "effect": "Écrit e1, e2, e3 dans les mots +0x3a, +0x3c, +0x3e de l'écran (basemain + id) puis met le bit 7 de l'octet 0 de l'écran.", "port_note": "Non implémentée dans le port DOS : aucun opérande n'est lu, donc un script qui l'utiliserait désynchroniserait le flux de 3 expressions (la grammaire renvoie ''). Non utilisée par Robinson ; correction prévue." }, { "table": "opcodes", "index": "0xe8", "name": "ctexmap", "operands": "une adresse de variable, puis deux expressions (puis les suivantes selon le type)", "effect": "Configure une texture de carte : la table des entrées est indexée par slot (0x20 octets par entrée). Type 0 : l'entrée est remise à zéro ; type > 0 : résout le bitmap via adresdes (flagmain courant, non effacé), stocke le nombre de bits de la largeur, balaie les lignes opaques (compteur 8 bits par ligne), calcule yorigin et ajuste le masque y avec la table 0,1,3,7,0xf,0x1f,3,0x7f,0xff…0x3fff.", "port_note": "Le port ne partage pas le chemin du type positif pour le type 0 et lit/écrit les champs suivants différemment (+0x10, +0x16, +0x15, +0x1a, +0x1c). Correction prévue." }, { "table": "opcodes", "index": "0xe9", "name": "calloctab", "operands": "une adresse de variable (cellule)", "effect": "Si l'octet [cell-1] est négatif, alloue taille + 0x800 octets (taille = [cell-6-4*(flag&0xf)]), aligne le pointeur de données du handle sur 2 Ko (+4 garde le pointeur brut pour mfree) et met le handle dans [cell]. Ne teste pas si la cellule est déjà non nulle : un second appel fuit l'ancien bloc.", "port_note": "Le port retourne si [cell] est déjà non nul, alloue exactement la taille et n'aligne pas. Aucun effet visible ; seule la consommation mémoire diffère." }, { "table": "opcodes", "index": "0xea", "name": "cfreetab", "operands": "une adresse de variable (cellule)", "effect": "Si l'octet [cell-1] est négatif et [cell] non nul : met [cell] à 0 puis libère le handle (mfree : annule le handle, et récupère la place si le bloc est le plus bas).", "port_note": "" }, { "table": "opcodes", "index": "0xeb", "name": "cscantab", "operands": "aucun", "effect": "Simple retour : aucune opérande, aucun effet.", "port_note": "" }, { "table": "opcodes", "index": "0xec", "name": "cneartab", "operands": "aucun", "effect": "Simple retour : aucune opérande, aucun effet.", "port_note": "" }, { "table": "opcodes", "index": "0xed", "name": "cscsun", "operands": "quatre expressions (e1..e4)", "effect": "Écrit e1..e4 dans les mots +0x7c, +0x7e, +0x80, +0x82 de l'écran (basemain + id) puis met le bit 7 de l'octet 0 de l'écran (paramètres du soleil).", "port_note": "Non implémentée dans le port pour la version < 60 : aucun opérande lu, ce qui désynchroniserait le flux de 4 expressions (grammaire ''). Non utilisée par Robinson ; correction prévue." }, { "table": "opcodes", "index": "0xee", "name": "cdarkpal", "operands": "cinq expressions (R, G, B, première couleur, nombre)", "effect": "Stocke R, G, B, first, count en globales et remplit `count` triplets RGB de dkpalet à partir de `first`, sans bornage ; dkpalet[0..2] = 0 et fdarkpal = 1. Balaie ensuite les 0x2fd mots à partir de dkpalet[3] (les 256 couleurs) et efface fdarkpal seulement si tous valent 0x100.", "port_note": "Le port ne balaie que dkpalet[3..0xb5] (couleurs 1..60) et ne recalcule que si first < 0x100 : après un assombrissement des couleurs 112..127, fdarkpal peut être remis à 0 à tort. Correction prévue (balayage complet)." }, { "table": "opcodes", "index": "0xef", "name": "cscdark", "operands": "trois expressions (e1, e2, e3)", "effect": "Sur l'écran (basemain + id) : +0x98 = e1 ; e2 résolu par adresdes (flagmain courant, non effacé) dans +0x9a ; +0x9e = e3 et basedark = e3 ; +0xa0 = [[+0x9a]+4]+1 ; si +0x9e < 0, +0x9e = +0xa0 >> 1 (basedark suit). Fixe la base du sélecteur de table sombre sur [+0x9a]+8 et met le bit 7 de l'écran.", "port_note": "Le port force flagmain à 0 à l'entrée, donc la ressource provient toujours du script courant, alors que l'original prendrait celle de main après un mput*. Fidélité optionnelle." }, { "table": "opcodes", "index": "0xf0", "name": "caset", "operands": "trois expressions", "effect": "Écrit les trois valeurs (16 bits) dans les mots +0x18, +0x20, +0x28 de la vram du script courant.", "port_note": "" }, { "table": "opcodes", "index": "0xf1", "name": "camov", "operands": "trois expressions", "effect": "Ajoute (16 bits) chacune des trois valeurs aux mots +0x18, +0x20, +0x28 de la vram du script courant.", "port_note": "" } ]