JavaScool:ProgletProcessing

Cette page a pour but d'expliquer comment créer une proglet avec processing, consulter aussi à la documentation générale sur la création de proglet pour voir les principes généraux.

Principe général

Tous les fichiers sont définis comme pour une standard, sauf :

• Panel.java puisque l'objet graphique vient de processing.
• <name>Functions.java au lieu de Functions.java come expliqué ci dessous.

Lancer processing

Il faut que la jarre javascool*.jar soit dans le class-path de processing pour qu'il puisse compiler les classes liées à javascool.

Le fichier de description de la proglet

Par rapport à un fichier standard il comporte en plus:

1. la mention "processing" : "true"
2. les largeur width et hauteur height, qui doivent être spécifiées.

Le fichier <name>Functions.java

Plusieurs choses diffère dans ce cas:

• La classe doit se nommer <name>Functions.java ou <name> est le nom de la proglet.
• La classe ne doit pas être déclarée dans un package
• La fonction qui renvoie l'instance de la proglet ne renvoie un objet de nom sampleCode si sampleCode est le nom de la proglet.

Pour comprendre cela il faut noter que, avec processing:

• une applete de nom sampleCode génère une classe (sans package) de nom sampleCode (qui étend la classe Applet), donc:
  • il faut bien récupérer ici un objet de ce nom
  • il faut définir la classe sans package pour qu'elle accède à l'applete sans package
  • il faut lui donner un nom qui soit différent pour chaque proglet.

Voici un exemple de header d'un fichier <name>Functions.java:

public class sampleCodeFunctions {
  /** Renvoie l'instance de la proglet. */
  private static sampleCode getPane() {
    return org.javascool.macros.Macros.getProgletPane();
  }
  /** ../.. */
}

Le fichier Translator.java

Il n'est pas possible de faire un import java des fonctions processing car elles ne sont pas dans un package. Il faut donc définir l'ajout de préfixe aux méthodes statiques par translation du code, comme ici dans l'exemple de la proglet exploSonore.

package org.javascool.proglets.exploSonore;
public class Translator extends org.javascool.core.Translator {
  @Override
  public String translate(String code) {
    return code.replaceAll("\\s(playSignal|playRecord|playStop)\\(", " exploSonoreFunctions.$1(");
  }
}

La méthode pas à pas

1. S'assurer que le répertoire «sketchbook» de processing est bien le même que celui des proglets.
   • Voir la [JavaScool:DocJavaScoolBuilder mise en place du «sketchbook» ] pour plus de détails
   • C'est dans File -> Preferences -> Sketchbook location que cette option est donnée.
   • Voir les éléments de documentation pour Linux si besoin
2. Lancer processing et travailler au développement de l'applete
   • Exporter le travail sous forme d'applete
   • C'est dans File -> Export qui effectue cette action
3. Dans le même répertoire générer les fichiers usuel pour définir une proglet.
   • puis construire la proglet comme pour une proglet standard

• Note: éviter de mettre dans le répertoire des fichiers inutiles ou trop volumineux car tous les fichiers sont intégrés à la jarre Java finale.

Processing et Svn

Si vos fichiers sont contrôlés par un système de versionning comme subversion (dit «svn») une difficulté survient: processing détruit les fichiers .svn qui permettent d'administrer l'archive (donc plus rien ne marche côté svn) ! La soluce:

1. Avant d'exporter l'applete sauver le dossier caché applet/.svn par exemple sur le bureau
2. Après l'export le remettre en place ou ne pas inclure le dossier applet dans le svn.

Discussion

• Utiliser processing permet de
  • programmer facilement des proglets multimédia (son, 3D, vidéos, ..) et de profiter d'un très large panel existant;
  • de déplacer la vision de "programmeur" à "créateur d'objets numériques" qui est le fondement de la démarche de processing;
  • celà établi aussi que la plateforme Javas'Cool est techniquement et dans son principe "ouverte" et s'interopère avec d'autres plateformes de développement.

• Cette démarche dans Javas'Cool est due à Cécile Picard-Limpens qui a créé les premières «proglets» et «educlets»