Module Bloc-Notes

Suite au problème de Vinkei sur ce sujet, j'ai concocté un petit module pour insérer une zone de saisie multilignes dans un GUI.


Liste des changements

Spoiler:

 

Version 2.1

• Simplification de la gestion des tableaux dynamiques
  
• Suppression des reliques de la version 1.0 qui proposaient l’auto-complétion sur les boutons

Version 2.0

• "Structuration" des commandes (par la structure BlocNotes)
  
• Prise en charge de plusieurs bloc-notes
  
• Correction de certains bugs d'affichage, notamment lors de défilement
  
• Ajout du défilement horizontal
  
• Possibilité d'accéder et de modifier les défilements horizontaux et verticaux, la position du curseur et la sélection
  
• D'autres choses que j'oublie

Installation

Spoiler:

 

Note pour aller plus vite : l'étape importante est la numéro 3.

1. Importez le module (clic droit sur l'onglet Scripts de l'éditeur puis "Import script...").
   
2. Dans le GUI où vous voulez placer la zone de saisie, créez un nouveau bouton aux dimensions voulues. Le texte de ce bouton correspondra à celui affiché par défaut dans la zone de saisie. Sa police (type + couleur) sera celle utilisée pour afficher le texte de l'éditeur. Son image (si vous en spécifiez une) sera utilisée comme fond du bloc-notes.
   
3. Notez le nom du bouton que vous venez de créé. Supposons ici que ce bouton s'appelle btnBlocNotes. Dans la fonction game_start du Global script, insérez la commande suivante (pensez à remplacer le nom du bouton par celui que vous avez donné) :

   Code:

   BlocNotes.Convert(btnBlocNotes);

4. C'est parti, le joueur pourra taper du texte dans le bloc-notes !

Consultez la description de la commande BlocNotes.Convert pour plus de détails.

Vous pouvez définir un curseur à utiliser lorsque la souris survole la zone de saisie en modifiant le 0 de la sixième ligne du fichier BlocNotes.asc (#define MODE_CURSEUR 0) par le numéro/nom du curseur que vous voulez (2 ou eModeInteract par exemple).

Il n'y a pas de barre de défilement nativement implémentée, mais vous pouvez en créer vous-même en utilisant les propriétés XOffset et YOffset ainsi que Width et Height.

Liste des commandes

Spoiler:

 

• Code:

  static function BlocNotes.Convert(Button* bouton, optional int couleur_fond, optional int fond_curseur, optional defilement)

  Convertit le bouton en bloc-notes.
  Par défaut, si vous n'avez pas associé d'image au bouton, la couleur de fond du bloc-notes est transparente. Vous pouvez passer une couleur de votre choix comme premier paramètre COULEUR_FOND.
  La couleur de fond du texte sélectionné est automatiquement calculée par défaut, mais le résultat n'est pas toujours optimal. Vous pouvez spécifier une couleur personnalisée en passant une valeur pour FOND_CURSEUR (auquel cas vous devrez nécessairement passer une valeur à COULEUR_FOND : passez la valeur COLOR_TRANSPARENT pour laisser transparent).
  Le paramètre DEFILEMENT peut valoir :
  • eBlocN_NotScrollable, auquel cas votre bloc-notes ne pourra défiler ni horizontalement, ni verticalement et ne pourra contenir plus de texte que sa surface ne le permet
    
  • eBlocN_HorizontallyScrollable, auquel cas votre bloc-notes pourra défiler horizontalement seulement et ne pourra contenir plus de ligne que sa hauteur ne le permet
    
  • eBlocN_VerticallyScrollable, auquel cas votre bloc-notes pourra défiler verticalement seulement et affichera les lignes dépassant sa largeur sur plusieurs lignes
    
  • eBlocN_EvenlyScrollable, auquel cas votre bloc-notes pourra défiler aussi bien horizontalement que verticalement
  Cette fonction est statique, vous devez donc l'utiliser en la faisant précéder de BlocNotes.
  

• Code:

  static Button* BlocNotes.ActiveButton

  Retourne/Définit le bouton bloc-notes qui a actuellement le focus (c'est-à-dire sur lequel se trouve le curseur).
  Cette propriété est statique, vous devez donc l'utiliser en la faisant précéder de BlocNotes.
  

• Code:

  Button* BlocNotes.ButtonBloc

  Retourne/Définit le bouton bloc-notes auquel est associée l'instance BlocNotes.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  String BlocNotes.Text

  Retourne/Définit le texte affiché sur le bloc-notes.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  readonly String BlocNotes.Line[]

  Retourne un tableau contenant chaque lignes du bloc-notes.
  Cette propriété est en lecture-seule : vous ne pouvez pas la modifier directement.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  readonly int BlocNotes.RowCount

  Retourne le nombre de lignes que peut afficher le bloc-notes sur sa hauteur.
  Cette propriété est en lecture-seule : vous ne pouvez pas la modifier directement.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  readonly int BlocNotes.LineCount

  Retourne le nombre de lignes que contient actuellement le bloc-notes.
  Cette propriété est en lecture-seule : vous ne pouvez pas la modifier directement.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  readonly int BlocNotes.Height

  Retourne la hauteur occupée par le texte du bloc-notes.
  Cette propriété est en lecture-seule : vous ne pouvez pas la modifier directement.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  readonly int BlocNotes.Width

  Retourne la largeur occupée par le texte du bloc-notes.
  Cette propriété est en lecture-seule : vous ne pouvez pas la modifier directement.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  int BlocNotes.XOffset

  Retourne/Définit le décalage horizontal pour l'affichage du texte. Si vous passez une valeur inadéquate, elle est automatiquement ajustée.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  int BlocNotes.YOffset

  Retourne/Définit le décalage vertical pour l'affichage du texte. Si vous passez une valeur inadéquate, elle est automatiquement ajustée.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  int BlocNotes.Cursor

  Retourne/Définit le caractère sur lequel se trouve actuellement le curseur.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  int BlocNotes.Select

  Retourne/Définit le caractère sur lequel se trouve actuellement la sélection. Du texte est sélectionné dès lors que la valeur de Cursor est différente de celle de Select.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  readonly String BlocNotes.SelectedText

  Retourne le texte actuellement sous sélection.
  Cette propriété est en lecture-seule : vous ne pouvez pas la modifier directement.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  int BlocNotes.GetCharIndex(int ligne, int caractere)

  Retourne la position du CARACTEREième caractère à la LIGNEème ligne dans le texte du bloc-notes.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  int BlocNotes.GetLineOfChar(int index)

  Retourne le numéro de la ligne où est affiché le INDEXième caractère du texte du bloc-notes.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  int BlocNotes.GetPositionInLineOfChar(int index)

  Retourne la position dans la ligne où se trouve le INDEXième caractère du texte du bloc-notes.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  function BlocNotes.SaveInFile(String fichier)

  Sauvegarde le contenu du bloc-notes dans un FICHIER texte.
  ATTENTION :, le contenu de FICHIER sera écrasé.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  function BlocNotes.LoadFile(String fichier)

  Charge le contenu de FICHIER dans le bloc-notes.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.
  

• Code:

  function BlocNotes.Refresh()

  Met à jour l'affichage du bloc-notes.
  Cette propriété n'est pas statique : vous devez l'utiliser sur une variable de type BlocNotes.

Utilisation en jeu

Spoiler:

 

L'utilisation est très semblable à celle d'un bloc-notes traditionnel.
Vous pouvez sélectionner le texte à l'aide de la souris ou en maintenant shift enfoncée tandis que vous déplacez le curseur à l'aide du clavier.
Vous pouvez couper le texte avec Ctrl-X et le copier avec Ctrl-C. En revanche, pour coller le texte vous devrez appuyer sur Ctrl-P (comme Paste) et non Ctrl-V car cette dernière combinaison de touches est nativement utilisée par AGS pour afficher des informations sur le moteur. Pensez à prévenir vos joueurs quelque part pour éviter qu'ils ne coupent leur texte sans pouvoir le coller par la suite.
Le texte défile automatiquement selon la position du curseur.

Limitations actuelles

Spoiler:

 

• Ne fonctionne pas lorsqu'il y a un TextBox d'activé dans un GUI affiché (conflit avec le texte entré).
  
• Peut être assez lent si la surface est grande, contient plusieurs lignes et si la résolution du jeu est supérieure à 640*480.

Le module est actuellement en version bêta. Merci de me rapporter les éventuels (probables) bugs que vous rencontrerez ! N'hésitez pas non plus à apporter des suggestions d'améliorations.

Bravo Kitai !
Les modules proposés par ce forum sont de vrais pépites pour des novices en programmation comme moi. Une vrai valeur ajouté de la communauté AGS.

Le fichier avait un soucis d'encodage des caractères qui empêchait d'importer le module.
J'ai mis le tout à jour : ça devrait désormais fonctionner sans soucis.

Suite à une remarque de Billbis, je me suis penché sur une utilisation des expressions régulières avec le module BlocNotes.

En ont résulté une (presque) véritable refonte de ce module et une petite démo conjointe RegExp/BlocNotes (voir premier message).

Tous les commentaires et retours sont évidemment les bienvenus.

Bonjour Kitai !

Je découvre ce module, car je cherche à implanter un bloc notes pour le joueur (qu'il puisse prendre des notes, et les exporter en PDF genre pour garder des traces de son aventure par exemple).

J'ai vu ton module mais cela me fait douter :

"Peut être assez lent si la surface est grande, contient plusieurs lignes et si la résolution du jeu est supérieure à 640*480."

Mon jeu est en 1920*1080. Cela veut dire que ça va être TRES lent et pas très joli ?

Ou existe-t-il un module plus récent qui tourne mieux ?

Baguettator a écrit:

"Peut être assez lent si la surface est grande, contient plusieurs lignes et si la résolution du jeu est supérieure à 640*480."

Mon jeu est en 1920*1080. Cela veut dire que ça va être TRES lent et pas très joli ?

C'était y'a quelques années, avec des ordis moins puissants et un moteur AGS moins optimisé.

Je te conseille simplement d'essayer et voir comment ça tourne

C'est génial !!! ça marche du tonerre !!

Faut juste faire gaffe et mettre une petite condition pour la fonction onkeypress, car sinon ça fait aussi les effets prévus dans cette fonction...

J'ai pas tout à fait compris pour créer un défilement : je voudrais que ce soit possible de défiler le texte uniquement verticalement (donc comme prévu en standard dans le script). C'est donc la propriété "BlocNotes.YOffset" qui doit être incrémentée ? Genre BlocNotes.YOffset++ ou BlocNotes.YOffset-- ?

EDIT : et pardon, une autre petite question : une possibilité d'extraire ensuite ce que le joueur a écrit dans ce "bloc notes" dans un fichier externe à AGS ? J'ai vu ton module qui extrait un texte AGS en PDF, mais ça me semble compliqué de devoir écrire des balises dans le bloc notes d'AGS... Il existe un moyen plus simple ? (si par exemple le texte du bloc notes est extrait dans un format type "bloc notes" de windows ?).

Baguettator a écrit:

J'ai pas tout à fait compris pour créer un défilement : je voudrais que ce soit possible de défiler le texte uniquement verticalement (donc comme prévu en standard dans le script). C'est donc la propriété "BlocNotes.YOffset" qui doit être incrémentée ? Genre BlocNotes.YOffset++ ou BlocNotes.YOffset-- ?

Oui c'est ça. Je sais plus dans quelle direction ça va, mais essaie et tu verras. Tu mets genre un bouton v qui incrémente YOffset et un bouton ^ qui la décrémente. Tu peux aussi utiliser la molette de la souris je pense, avec la fonction on_mouse_click en testant eMouseWheelNorth/eMouseWheelSouth et en incrémentant/décrémentant YOffset en conséquence.

Baguettator a écrit:

J'ai vu ton module qui extrait un texte AGS en PDF, mais ça me semble compliqué de devoir écrire des balises dans le bloc notes d'AGS...

Bah niveau rendu visuel du texte, ce bloc notes permet simplement d'ajouter des retours à la ligne, il affichera pas du texte en gras ou en italiques, donc c'est pas comme si y'avait un énorme intérêt à en faire un fichier PDF. Mais si vraiment tu le veux, il "suffirait" d'insérer une balise /newline à chaque retour de ligne lorsque tu génères le PDF, et ça devrait donner un truc potable (peut-être... à voir)

Sinon oui, juste un txt c'est bien :

Code:

File *output = File.Open("fichier.txt", eFileWrite);
output.WriteRawLine( monBlocNotes.Text );
output.Close();

Alors par contre, question bête : je n'arrive pas à utiliser XOffset et YOffset. "BlocNotes.YOffset" ne fonctionne pas... Comment on fait pour les incrémenter du coup ?

Baguettator a écrit:

"BlocNotes.YOffset" ne fonctionne pas...

L'attribut YOffset n'est pas static, c'est un attribut d'instance. Si tu regardes mon example, je l'ai appelé sur monBlocNotes, pas sur BlocNotes

Alors, en effet j'ai compris, j'ai créé une instance "blocnotes" en haut de mon global script !

J'ai repris la fonction des boutons de défilement de ton projet de démonstration, mais j'ai un null pointer reference lorsque je clique dessus... J'avoue que si tu peux m'aider un peu pour mettre en place cela, c'est top, car j'ai du mal à tout comprendre, je manipule pas encore très bien les structures...

J'avoue que la documentation est pas claire, j'ai dû ouvrir le projet démo pour comprendre comment ça marche.

En suppostant que tu as appelé ton instance blocnotes (c'est-à-dire tout en minuscules, ce qui la différencie de BlocNotes) et en supposant que ton bouton s'appelle btnBloc, écris blocnotes.ButtonBloc = btnBloc; (juste après Convert) et alors ça devrait suffir à associer ton instance avec le bouton que tu utilises comme bloc-notes.

Ouais, c'est bon, ça marche !!

Pour l'export dans un fichier .txt, je n'arrive pas à le mettre en oeuvre par contre. J'ai créé un bouton, quand je clique dessus ça lance le scripte que tu m'as donné, mais rien ne se passe.

J'ai pourtant créé un fichier dans le dossier du jeu (Compiled/Windows) qui s'appelle "JournalColonie.txt", et le bouton d'export est scripté ainsi :

Code:

       

        File *output = File.Open("JournalColonie.txt", eFileWrite);
        output.WriteRawLine( blocnotes.Text );
        output.Close();

J'ai raté quelque chose ? C'est la première fois que j'utilise ce genre de fonctions "File", "Write" etc...

C'est possible que y'ait des restrictions sur les droits d'écriture. Regarde si tu as un fichier warnings.log dans ton dossier Compiled. Le mien me dit ça :

Citation :

Script : (room:1)[G 358] Attempt to access file 'JournalColonie.txt' denied (cannot write to game installation directory);

Dans mon cas, ça fait que le fichier est placé ailleurs :

Citation :

Path will be remapped to the app data directory: '/home/CHEMINVERSDOSSIERLOCAL/'

Lorsque j'ouvre le fichier à ce nouvel emplacement, il contient bien le texte du bloc notes.

Tu peux essayer d'ajouter $SAVEGAMEDIR$/ ou $APPDATADIR$/ devant JournalColonie.txt comme décrit ici pour voir si ça te permet d'écrire dans un fichier accessible (voir le point IMPORTANT sur la page de documentation). En fait c'est possible que déjà par défaut le fichier où écrit AGS se trouve tout simplement pas dans Compiled/Windows mais plutôt dans un de ces deux dossiers, celui où se trouvent les fichiers de sauvegarde du jeu, ou bien dans un dossier partagé

Hello par ici !

Je me rends compte que je n'avais pas répondu : merci Kitai, j'ai finalement réussi à faire cela effectivement à l'aide des $SAVEGAMEDIR$.

J'en profite pour poser une autre question : dans le bloc notes, il est possible de faire copier/coller.

Mais est-ce que copier un texte du bloc notes permet de le coller en-dehors d'AGS ?

Si non, y a-t-il un moyen de faire cela dans AGS ?

Salut @Baguettator ! Je n'ai pas regardé en détail, mais apparemment, ce plugin permet d'intéragir avec le presse-papier Windows.

Super, merci valoulef ! ça a l'air génial !

Je me demande si cela peut être intégré directement dans le module de Kitai "bloc notes" ? De cette manière, on pourrait faire des copier/coller depuis les blocnotes qui sont directement dans le presse papier windows, de sorte que ça devient compatible avec tout (bloc notes et autres applications windows).

Une idée ?

Alors je n'ai jamais installé un plug-in sur AGS, et je ne connais pas le fonctionnement du module de @Kitai, donc je ne vais pas être la meilleure personne pour t'aider. Par contre, si une commande du plugin permet de stocker du texte dans le presse-papier (ou d'en récupérer) j'imagine qu'il n'y a pas de raison que le module ne puisse s'y adapter.

Je rappelle que les plugins (j'aime aussi le terme désuet "greffons") restreignent la compatibilité du jeu à Windows. Par exemple moi je joue sous Linux (distro Ubuntu) donc je pourrais pas l'utiliser.

L'utilisation a l'air assez simple, donc ça devrait pas être super compliqué d'éditer mon module (qui en l'état n'utilise pas vraiment le presse-papier) pour l'y intégrer

Oui effectivement, je suis conscient que ça ne marchera que pour Windows, mais de toute façon ce n'est pas pour quelque chose d'essentiel. Disons que ça permettra de faire un "raccourci" pour les utilisateurs de Windows, je prévois une solution au cas où.

Je vais regarder un peu ton module, @Kitai , il faut que je trouve la ligne qui contrôle les CtrlC et CtrlP, et en vérifiant si le joueur est bien sûr Windows (je crois qu'il y a une commande pour cela, pour vérifier l'OS), j'utilise le plugin, sinon le script du module.

Je crois que ce que voulait dire @Kitai c'est que l'utilisation du plug-in est rédhibitoire pour les joueurs non-Windows ? Et que ce n'est pas uniquement la fonction qu'il apporte qui ne fonctionnera que sur Windows, mais le jeu tout entier. C'est bien ça ?

À vrai dire je me souviens pas trop si ça cause un souci de compatibilité pour le jeu entier, ou juste lorsque le plugin est activement utilisé. Si c'est uniquement lors de l'utilisation, et si la fonction est pas nécessaire au bon fonctionnement du programme, c'est vrai que c'est pas si grave

Oui, il semblerait que le plugin ne fasse pas démarrer le jeu sur d'autres plateformes.

Néanmoins, Snarky (l'auteur du plugin) m'a donné une solution pour contrer cela.

Ne pas activer le plugin lorsque je compile pour Mac ou Linux. Et envelopper mon code qui dépend du plugin de cette manière :

Code:

#ifdef CLIPBOARD_PLUGIN
    String s = Clipboard.PasteText();
    if(!String.IsNullOrEmpty(s))
    {
      lblContent.Text = s;
      return true;
    }
    else return false;
  #endif
  #ifndef CLIPBOARD_PLUGIN
    return false;
  #endif

Salut Kitai !

Je rencontre un petit problème avec ton module, qui par ailleurs est très pratique !!

Je crée un BlocNotes avec la couleur du texte blanche et le fond transparent.

Quand je sélectionne du texte dans ce bloc notes, la sélection est un rectangle noir, et le texte dedans reste blanc. Mais lorsque je relâche le bouton de la souris (donc quand je finis de sélectionner), le rectangle de sélection noir masque totalement le texte sélectionné. Ou alors, le texte sélectionné devient noir ? Bizarre...

Par ailleurs, après sélection du texte, si je réécris (ce qui efface la sélection et la remplace par le texte nouveau), le texte du bloc notes devient noir. Mais si je clique sur le bloc notes, le texte redevient blanc ! (et en fait, pas vraiment blanc : une sorte de blanc/gris).

C'est pas un énorme problème, mais j'imagine que c'est un petit souci dans ton code majestueux

Une idée ?

EDIT : Je me rends compte que le truc du rectangle de sélection qui masque tout le texte, c'est si la souris, toujours en train de sélectionner du texte (donc bouton toujours enfoncé) sort du Bloc Notes. Sinon le texte est bien de la bonne couleur dans la sélection. Et après être sorti du bloc notes, la sélection est donc toute noire (on voit plus le texte), et si alors on réécrit, le nouveau texte devient noir ! Jusqu'à ce qu'on clique sur le bloc notes, ce qui rétablit la couleur voulue.

J'ai plus trop moyen de lancer AGS ces jours-ci, mais si je regarde le code (version 2.0 bêta) je vois que y'a un repeatedly_execute en bas du script, et que y'a une condition sur IsButtonDown, c'est de ce côté là qu'il faudrait regarder. J'ai survolé rapidement et rien vu d'évident qui pourrait expliquer le problème que tu décris, il faudrait tester et déboguer par itérations, si t'es motivé