eCalc 2.0


eCalc 2.0 est une calculatrice facile  utiliser et nanmoins puissante
pour OS/2 et eComStation. 
Elle est base sur l'application eCalc 1.x dveloppe par Nick Morrow. 
eCalc 1.x faisait partie de eComStation 1.x. eCalc est  prsent
disponible pour OS/2 en plus de eCS. 


Elle requiert REXX et PM. 


Nouveauts de eCalc version 2.0 : 
---------------------------------

En rsum : 
* option : En avant-plan, 
* option : masquer le clavier, 
* champs d'entre et rsultat spars (calcul en temps rel au cours
  de la frappe), 
* copie automatique vers le Presse-papiers, 
* support des expressions (support de REXX, extensible via programmes
  externes), 
* apparence modifiable  l'aide des palettes WPS, 
* ordre des oprations comme sur les calculatrices scientifiques, 
* nombre de dcimales paramtrables par l'utilisateur, 
* sparateur dcimal paramtrable par l'utilisateur, 
* support de "Rexx Math Function Package" ("Paquetage de Fonctions
  Mathmatiques Rexx") par Patrick J. Mueller (fonctions scientifiques), 
* Glisser/Dposer? 


Installation : 
--------------

Dcompressez seulement l'archive dans un rpertoire sur votre disque dur. 
Lancez install.cmd depuis une ligne de commandes pour crer les objets sur
votre bureau. 


Description de eCalc 2.0 : 
--------------------------

* 'En avant-plan'
Activez cette option pour faire en sorte que la fentre de eCalc soit
toujours place devant les autres fentres. 
Limitations : ne fonctionne pas avec les fentres DOS et WinOS/2. 


* 'Masquer le clavier'
Avec cette option, vous avez la possibilit d'activer et dsactiver le
clavier virtuel. 
Elle peut se rvler tre trs pratique allie  la fonction
'En avant-plan', afin de ne conserver en permanence en avan-plan sur le
bureau qu'une petite fentre pour effectuer vos calculs. 


* Calculs en temps rel
Vous n'avez pas besoin d'appuyer sur "=" ou la touche "Entre", le
rsultat est affich immdiatement aprs avoir entr une expression
valide. 


* 'Copie auto. vers Presse-papiers'
Cette option permet de copier immdiatement le rsultat des calculs dans
le Presse-papiers. 


* L'ordre des oprations est le mme que pour les calculatrices 
scientifiques : 

1. parenthses,
2. exponentielles,
3. division,
4. multiplication,
5. addition,
6. soustraction,

(moyen mnmonique "PEDMAS")

Pour plus d'informations, veuillez consulter : 
http://fr.wikipedia.org/wiki/Ordre_des_op%C3%A9rations


* Champs d'entre et de rsultat
L'expression  calculer et le rsultat sont tous les deux toujours
visibles. Il est ais de modifier plusieurs nombres, oprateurs ou
expression sans rentrer  nouveau toute la chane de calcul. 


* Expressions
Le champs du rsultat interprt donne la possibilit d'utiliser ses
propres routines externes ou commandes REXX. 

Voici quelques exemples : 
1. Utilisation de commandes standardes REXX.
1.1. Entrez c2x(7) dans le champ d'entre, le rsultat sera la valeur
     hexadcimale de 7. Comme c2x est une commande REXX, elle sera
     interprte. 
1.2. Entrez "5**2" dans le champ d'entre, et vous obtiendrez 5  la
     puissance 2 (vous pouvez utiliser d'autres exposants). 

     Remarque : l'exposant doit tre entier, il n'est pas possible de
                calculer la racine carre en tapant x**0.5 (vous devez
                pour cela utiliser une fonction externe pour calculer les
                racines carres). 

2. Utilisation de routines externes
2.1. Utilisation de OS/2 2.0 Rexx Math Function Package par Patrick J.
     Mueller
     eCalc prend en charge cette bibliothque qui continet des fonctions
     pour les oprations scientifiques. 

     Ce paquetage contient les fonctions suivantes : 
     * cosinus, sinus, tangente, arc cosinus, arc sinus, arc tangente
       cosinus hyperbolique, sinus hyperbolique, tangente hyperbolique
     * plus petit entier >= x, plus grand entier <= x
     * exponentielle de x (rciproque du logarithme nprien)
     * logarithme nprien
     * logarithme de base 10
     * racine carre
     * pi
     * e

     Remarque : la fonction puissance (pow) du paquetage n'est pas
                supporte. Utilisez  la place l'opration REXX standard
                'x**y'pour obtenir la puissance y de x. 

2.2 Utilisation de vos propres scripts REXX
    Entrez P() dans le champ d'entre. Le rsultat sera 3.14. 
    P.CMD est une routine REXX externe, le code de retour de cette routine
    est '3.14'. 

    Cependant, si vous recherchez un nombre Pi avec plus de chiffres,
    allez jeter un oeil sur : 
    http://3.141592653589793238462643383279502884197169399375105820974944592.com/
    (;-)

    Vous pouvez utiliser cette fonctionnalit pour d'autres fonctions
    plus complexes. 

    Mais prenez garde : n'entrez pas de commandes OS/2 ! Il est par
    contre possible d'entrer votre propre commande, qui sera utilise
    dans eCalc comme variable ou procdure. eCalc utilisant le prfixe
    "_eCalc" pour toutes ses procdures et variables internes, veillez 
    ne pas utiliser cette chane dans vos expressions. 

* Apparence modifiable : 
La fentre principale est redimensionnable et vous pouvez la personnaliser
 votre guise. Par exemple, vous pouvez masquer le clavier et tirer la
fentre en largeur afin de pouvoir voir les longues oprations sans avoir
 les faire dfiler. Vous pouvez aussi modifier les polices ainsi que les 
couleurs d'avant et arrire-plan de tous les lments de la fentre
principale de eCalc. Slectionnez "Autres options..." du menu "Options"; 
dposez ensuite la couleur ou la police de votre choix depuis les palettes
de couleurs ou de polices de OS/2 ou eCS sur l'emplacement correspondant,
et appliquez enfin vos personnalisations. Ces dernires seront alors
sauvegardes. 

Remarque : ne dposez pas de polices ou couleurs directement sur la
           fentre principale de eCalc ! Cela fonctionnera pendant la
           session en cours de eCalc, mais les personnalisations ne seront
           pas conserves. 

* Nombre de dcimales paramtrable par l'utilisateur
Slectionnez le nombre de chiffres aprs la vigule dsir via l'option
"Dcimales" du menu "Options". 
Slectionnez "Hors Fonction" pour utiliser le plus de chiffres possible. 
Utilisez l'option "Par dfaut (systme)" pour utiliser la valeur dfinie
dans les paramtres de votre systme d'exploitation. 


* Sparateur dcimals paramtrable par l'utilisateur
Slectionnez l'option "virgule", "Point" pour dfinir le sparateur entre
les units et les dcimales. 
Utilisez l'option "Par dfaut (systme)" pour utiliser la valeur dfinie
dans les paramtres de votre systme d'exploitation. 


* Glisser/Dposer
Aprs avoir dpos un fichier sur le champ d'entre, la premire ligne de
celui-ci sera insre. 
Si l'utilitaire 'DragText' est install, il est possible de
Glisser/Dposer du texte depuis le champ d'entre ou de rsultat vers
d'autres applications ou dossiers. 
Vous pouvez trouver DragText  cet endroit : 
 http://e-vertise.com/dragtext/


COPYRIGHT & LICENCE
-------------------

Nous vous autorisons  utiliser et distribuer ces fichiers librement  la
condition que nous ne soyons pas tenus responsables pour quelques pertes
ou dommage qui pourraient rsulter de son utilisation. 
Vous utilisez donc ce logiciel  vos risques et prils ! 

eCalc 2.0 est protg par la GPL. 

Le code source et les nouvelles versions sont disponibles sur : 
 http://www.subsys.de/ecalc/

eCALC 2.0 fait usage des modules suivants : 

  OS2apirx - OS/2 API pour Rexx version 03 Avril 2003
  (c) Carsten Arnold (http://www.ca-arnold.de)

   Rexx Math Function Package
   pour toute information sur la licence, voir .\RxMath\license.txt
   (vous trouverez la documentation pour cette bibliothque ici aussi). 



Bugs Connus /  faire / Remarques  l'attention des dveloppeurs : 
------------------------------------------------------------------

* Champ d'entre : 
Le champ d'entre est un champ d'entre  ligne multiple. 
Cela ne *devrait* pas tre modifi puisque cela est ncessaire
pour les oprations d'"insertion  la position du curseur". 

* Touches : 
Pour le moment, le programme ignore l'tat de la touche "Verr Num". 
Dans les deux cas, des nombres seront affichs dans le champ d'entre
lorsque l'utilisateur tape une touche sur le pav numrique. Je pense
qu'il s'agit l d'une fonctionnalit pour la plupart des utilisateurs,
mais ce comportement devrait peut-tre tre optionnel, puisqu'il
casse les standards du systme. 

* Internationalisation : 
Toutes les chanes de texte ont t extraites du code afin qu'elles
soient aisment traduisibles. Vous trouverez le fichier de langue dans
le sous-rpertoire .\lang. 

* Documentation : 
Aucun fichier INF localis n'est pour l'instant disponible. Ce serait
cependant une bonne chose... 

* Polices & Coleurs : 
Pour le moment, les boutons "Rinitialiser" sont sans effet. Ils devraient
rinitialiser les valeurs des couleurs d'avant et arrire-plan ainsi que
les polices  leurs valeurs par dfaut. 

* Fonctionnalits manquantes : 
  - les chiffres internes devraient tre paramtrables,
  - liste externe pour les constantes comem Pi, ventuellement avec une
    Interface Utilisateur Graphique pour une gestion courante. 


Historique
----------

Nouveauts de la version 2 rc1
 - Support multilingue. 
 - Optimisation du code interne. 

Nouveauts de la version v2 preview 2
 - Support de 'Rexx Math Function Package' par Patrick J. Mueller
   (fonctions scientifiques). 
 - 'chap' et 'Verr Num' supprime les contenus des champs d'entre et
   de rsultat. 
 - F3 ferme le programme. 
 - Nouvelles icnes pour le dossier de eCalc. 
 - Correction de bug : il n'est plus possible de coller du texte  lignes
   multiples depuis le Presse-papiers vers le champ d'entre par le biais
   de CTRL+V ou Maj+Inser. Seule la premire ligne du contenu du
   Presse-papiers sera insre. 
   Malheureusement, il est toujours possible d'insrer un tel texte 
   l'aide de la souris (en utilisant les boutons 1 et 2, si la fonction
   est active) et je n'ai aucun moyen de l'empcher. Veuillez donc viter
   de le faire pour le moment. 

Nouveauts de la version v2 preview 1
 - Premire version publique de la srie de versions 2.x. 


Frank Wochatz
Berlin, Dcembre 2005
