home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma37.dms / ma37.adf / Genius / Dokumentacja.txt < prev    next >
Encoding:
Text File  |  1995-05-05  |  13.3 KB  |  385 lines
  1.  
  2.                          NUMERIC GENIUS v1.4d DEMO
  3.                  (C) Copyright 1994,1995 Paweî Grotowski
  4.                                     ···
  5.                            DEMO wersji SHAREWARE
  6.  
  7.    Ta wersja jest rozpowszechniana na zasadach FREEWARE, tzn. nie musisz nic
  8.  pîaciê za jej uûywanie,lecz ograniczenie moûliwoôci pracy tego programu po-
  9.  przez ustawienie zakresu liczb tylko do  8-mio bitowych, caîkowite wyîâcze-
  10.  nie funkcji edycyjnych,  brak podpowiedzi i innych pozwala tylko na zorien-
  11.  towanie sië w jego moûliwoôciach.
  12.    Rejestracja u autora poprzez przysîanie opîaty rejestracyjnej 10 nzî (100
  13.  tyô. starych zî) nabywa prawo legalnego uûytkownika, tzn. uûytkownik otrzy-
  14.  ma peînowartoôciowâ wersjë programu, instrukcjë uûytkowania która zawiera:
  15.  
  16.  -: opis wszystkich funkcji,
  17.  -: opis wszystkich rozkazów AREXXa,
  18.  -: przykîady ich zastosowania,
  19.  -: dla poczâtkujâcych wiadomoôci z zakresu arytmetyki binarnej i algebry
  20.     Boole'a, takûe poparte przykîadami,
  21.  
  22.   Dziëki rejestracji uûytkownik bëdzie oczywiôcie mógî liczyê zawsze i wszë-
  23.  dzie na pomoc, upgrade'y do tego programu. Rejestracja polega na przysîaniu
  24.  takiej karty:
  25.  
  26.        +------------------------------------------------------------+
  27.        |                                                            |
  28.        |      KARTA REJESTRACYJNA PROGRAMU NUMERIC GENIUS v1.4      |
  29.        |      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~      |
  30.        | [ ]  Zamawiam program Numeric Genius v1.4b.                |
  31.        | [ ]  Jednoczeônie wyraûam chëê otrzymania kolejnych wersji |
  32.        |      tego programu po niûszej  cenie, i zgadzam sië pokryê |
  33.        |      koszty wynikîe z jego dystrybucji.                    |
  34.        |                                                            |
  35.        | Il. szt. : _____                                           |
  36.        | ·························································· |
  37.        | Imië  : __________________  Nazwisko : ___________________ |
  38.        | Kod   : __________________  Miasto   : ___________________ |
  39.        | Ulica : __________________  Dom      : ___________________ |
  40.        | ·························································· |
  41.        |                                                            |
  42.        |                  Podpis zamawiajâcego: ___________________ |
  43.        |                                                            |
  44.        +------------------------------------------------------------+
  45.  
  46.  W nawiasach kwadratowych zaznaczamy  odpowiedniâ opcjë rejestracji.  Drugi
  47.  punkt uîatwia mi wysyîanie upgrade'ów  do zarejestrowanych uûytkowników. W
  48.  ten sposób gdy wprowadzë nowe  rozwiâzania do mojego programu zwiëkszajâce
  49.  np. jego funkcjonalnoôê, to od razu  bëdë wiedziaî kto taki program ma ot-
  50.  rzymaê. Koszty dystrybucji to:
  51.  
  52.  -: opîata za dyskietkë
  53.  -: koszt wysyîki
  54.  -: koszty wîasne
  55.  
  56.  ***************************************************************************
  57.  
  58.                     Kartë rejestracyjnâ wyôlij na adres:
  59.                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  60.                              Paweî Grotowski
  61.                       35-077 Rzeszów ul. Piastów 3/44
  62.  
  63.  ***************************************************************************
  64.  
  65.       Dyskietka z programem zostanie przysîana za zaliczeniem pocztowym
  66.  ___________________________________________________________________________
  67.  \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  68.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  69.                                    ····
  70.       Graficzny Interfejs Uûytkownika zostaî zaprojektowany programem: 
  71.  
  72.                                 GadToolBox
  73.                      (C) Copyright Jan van den Baard
  74.                                    ····
  75.            Program korzysta takûe z biblioteki ReqTools.library
  76.                                 
  77.                              reqtools.library        
  78.                        (C) Copyright Nico Francois
  79.                                    ····
  80.  
  81.                                Zastosowanie
  82.                                ~~~~~~~~~~~~
  83.   * Programowanie,
  84.   * Testowanie programów,
  85.   * Obliczenia przy projektowaniu algorytmów,
  86.   * Nauka arytmetyki stosowanej w komputerze (nie tylko AMIDZE),
  87.   * etc.
  88.  
  89.      Charakterystyka moûliwoôci programu (tylko wersja peînowartoôciowa)
  90.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  91.  
  92.   * Praca na liczbach caîkowitych 32 bitowych z moûliwoôciâ konwersji
  93.     typów do 16 lub 8 bitów, w zakresach:
  94.  
  95.      -: dla liczb ze znakiem : od -2147483648 do 2147483647
  96.      -: dla liczb bez  znaku : od           0 do 4294967295
  97.  
  98.   * Moûliwoôê interpretacji liczb:
  99.  
  100.      -: ze znakiem (Sig), w kodzie uzupeînieï do dwóch (U2) 
  101.      -: bez znaku  (Uns)
  102.  
  103.   * Kontrola przepeînienia i dzielenia przez 0, dla operacji arytmetycznych.
  104.  
  105.   * Moûliwoôê pracy w systemie:
  106.  
  107.      -: dziesiëtnym
  108.      -: dwójkowym
  109.      -: szesnastkowym
  110.      -: ósemkowym
  111.  
  112.   * Dwadzieôcia trzy funkcje przydatne programiôcie:
  113.  
  114.      -: osiem realizujâcych dziaîania logiczne.
  115.      -: cztery realizujâce dziaîania na pojedynczym bicie(testowanie, zmia-
  116.         na,ustawienie,kasowanie).
  117.      -: szeôê innych m.in. obliczenie starszej lub mîodszej czëôci liczby.
  118.      -: piëê opierajâcych sië na tradycyjnej arytmetyce liczb caîkowitych.
  119.  
  120.   * Szeôê funkcji uîatwiajâcych pracë z programem, tzw. funkcje edycyjne.
  121.  
  122.   * Wspóîpraca z AREXX-em(33 rozkazy), np. realizacja czterech funkcji dla
  123.     wîasnych potrzeb w tym jëzyku  i  wywoîywanie ich tak samo jak funkcji
  124.     wbudowanych w program.
  125.  
  126.   * Operacje na podrëcznej pamiëci kalkulatora.
  127.  
  128.   * Szybkie podpowiedzi do kaûdej funkcji.
  129.  
  130.   * Moûliwoôê otwarcia okna kalkulatora na dowolnym ekranie publicznym.
  131.  
  132.   * Moûliwoôê sterowania programem caîkowicie z klawiatury.
  133.  
  134.   * Moûliwoôê uruchomienia programu z CLI lub Workbencha.
  135.  
  136.   * Wykorzystanie nowych cech systemu 3.0 jak:
  137.    
  138.      -: NewLookMenus
  139.      -: Skalowane gadgety MX i CHECKBOX
  140.  
  141.                           Uruchomienie programu
  142.                           ~~~~~~~~~~~~~~~~~~~~~
  143.    Uruchomienie programu jest moûliwe zarówno z CLI jak i Workbencha.  W obu
  144.  przypadkach, opcjonalnie podajemy argumenty:
  145.  
  146.  EKRAN_PUBL/A, AREXX_PLIK/A z CLI.
  147.  EKRAN_PUBL,   AREXX_PLIK   z Workbencha; jako ToolTypes ikony.
  148.  
  149.  EKRAN_PUBL  - argument umoûliwia wybranie ekranu, na którym pojawi sië
  150.                okno kalkulatora w chwili uruchomienia go. Domyôlnie us-
  151.                tawiony jest ekran Workbencha.
  152.  
  153.  AREXX_PLIK  - argument informujâcy o nazwie i szlaku pliku, zawierajâ-
  154.                cego informacje o komendach ARexxa przez nas zdefiniowa-
  155.                nych. Domyôlnie jest to S:NG_rexxcmd.
  156.  
  157.  Przykîad:
  158.  Aby uruchomiê program na ekranie PowerPackera, wykonujemy nastëpujâce czy-
  159.  nnoôci:
  160.  
  161.   - z CLI:
  162.     1. Uruchamiamy PowerPackera,
  163.     2. Uruchamiamy Shella,
  164.     3. Wpisujemy w linii komend rozkaz 'ng PowerPacker S:NG_rexxcmd' lub
  165.        'ng EKRAN_PUBL=PowerPacker AREXX_PLIK=S:NG_rexxcmd',
  166.     4. Naciskamy Enter.
  167.  
  168.   - z Workbencha:
  169.     1. Uruchamiamy PowerPackera,
  170.     Punkty 2,3,4,6 realizujemy tylko wtedy gdy wczeôniej nie zmienialiômy
  171.     nazwy ekranu publicznego na poûâdany.
  172.     2. Zaznaczamy gadget,
  173.     3. Wybieramy z menu Workbencha o nazwie Icons, opcjë Information,
  174.     4. W oknie które sië pokaûe, w gadgecie ToolTypes wpisujemy:
  175.        'EKRAN_PUBL=PowerPacker'.
  176.     5. Zapisujemy zmianë opcjâ 'Save'
  177.     6. Uruchamiamy kalkulator.
  178.  
  179.                           Opis funkcji programu
  180.                           ~~~~~~~~~~~~~~~~~~~~~
  181.  
  182.  Kalkulator podzielony jest na bloki funkcjonalne, które moûna podzieliê na:
  183.  
  184.  -: blok wprowadzania cyfr i edycji (ten w ôrodku),
  185.  -: blok arytmetyki liczb caîkowitych (ten po prawej u doîu),
  186.  -: blok komend AREXXa (cztery gadgety nad blokiem wprowadzania cyfr),
  187.  -: blok operacji na bitach (gadgety nad blokiem komend AREXXa),
  188.  -: blok róûnych funkcji (gadgety nad blokiem arytmetyki liczba caîkowitych)
  189.  
  190.  BLOK OPERACJI NA BITACH
  191.  ~~~~~~~~~~~~~~~~~~~~~~~
  192.  Asl (Arithmetic Shift Left)
  193.  ~~~ Arytmetyczne przesuniëcie bitów w lewo. Podajemy liczbë i iloôê
  194.      miejsc o ile majâ byê przesuniëte liczby.
  195.  
  196.  Lsr (Logical Shift Right)
  197.  ~~~ Logiczne przesuniëcie bitów w prawo. Argumenty j.w.
  198.  
  199.  Rol (Rotate Left)
  200.  ~~~ Rotacja bitów w lewo. Argumenty j.w.
  201.  
  202.  Ror (Rotate Right)
  203.  ~~~ Rotacja bitów w prawo. Argumenty j.w.
  204.  
  205.  Msb (Most Significant Byte) - operacja jednoargumentowa
  206.  ~~~ Obliczenie starszej czëôci liczby.
  207.  
  208.  Lsb (Least Significant Byte) - operacja jednoargumentowa
  209.  ~~~ Obliczenie mîodszej czësci liczby
  210.  
  211.  And (Koniunkcja bitowa)
  212.  ~~~ Wykonanie dziaîania wg. wzoru:
  213.  
  214.      0 And 0 = 0
  215.      0 And 1 = 0
  216.      1 And 0 = 0
  217.      1 And 1 = 1
  218.  
  219.  Or  (Alternatywa bitowa)
  220.  ~~~ Wykonanie dziaîania wg. wzoru:
  221.  
  222.      0 And 0 = 0
  223.      0 And 1 = 1
  224.      1 And 0 = 1
  225.      1 And 1 = 1
  226.      
  227.  Xor (Alternatywa wyîâczajâca bitowa)
  228.  ~~~ Wykonanie dziaîania wg. wzoru:
  229.  
  230.      0 And 0 = 0
  231.      0 And 1 = 1
  232.      1 And 0 = 1
  233.      1 And 1 = 0
  234.  
  235.  Not (Negacja bitów) - funkcja jednoargumentowa
  236.  ~~~ Wykonanie dziaîania wg. wzoru:
  237.  
  238.      Not 1 = 0
  239.      Not 0 = 1
  240.  
  241.  Tst (Test bit)
  242.  ~~~ Testowanie ustawienia bitu. Podajemy testowanâ liczbë i numer
  243.      bitu liczony od zera.
  244.  
  245.  Set (Set bit)
  246.  ~~~ Ustawienie bitu. Argumenty j.w.
  247.  
  248.  Chg (Change bit)
  249.  ~~~ Ustawienie bitu. Argumenty j.w.
  250.  
  251.  Clr (Clear bit)
  252.  ~~~ Skasowanie bitu. Argumenty j.w.
  253.  
  254.  BLOK RÓÛNYCH FUNKCJI
  255.  ~~~~~~~~~~~~~~~~~~~~
  256.  Bnb (Build Number)
  257.  ~~~ Wykonanie operacji odwrotnej do MSB i LSB, tzn. otrzymujemy
  258.      liczbë, podajâc jej czëôê starszâ i mîodszâ.
  259.  
  260.  Swp (Swap)
  261.  ~~~ Zamiana czëôciami liczby. Argumentami jest liczba i iloôê bitów
  262.      mîodszej sekwencji.
  263.  
  264.  Max (Maximum) - operacja jednoargumentowa
  265.  ~~~ Sprawdzenie wartoôci jaka zostanie otrzymana gdy wszystkie bity,
  266.      których liczbë podamy, zostanâ ustawione.
  267.  
  268.  Bcp (Bits Capacity) - operacja jednoargumentowa
  269.  ~~~ Sprawdzenie jaka iloôê bitów jest potrzebna do zapamiëtania podanej
  270.      wartoôci.
  271.  
  272.  BLOK ARYTMETYKI LICZB CAÎKOWITYCH
  273.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  274.  Mod (Modulo divide)
  275.  ~~~ Dzielenie modulo, czyli obliczenie reszty z dzielenia.
  276.  
  277.  Takie operacje jak mnoûenie, dzielenie, dodawanie i odejmowanie majâ
  278.  standardowe oznaczenia.
  279.  
  280.   ±  Zmiana znaku liczby na przeciwny.
  281.  ~~~
  282.   »  Skasowanie ostatniej cyfry z wyôwietlacza.
  283.  ~~~
  284.  
  285.  POZOSTAÎE
  286.  ~~~~~~~~~
  287.  Zmiana systemów liczbowych
  288.  ~~~~~~~~~~~~~~~~~~~~~~~~~~
  289.  Dec |  dziesiëtny
  290.  Bin |  dwójkowy
  291.  Hex |  szesnastkowy
  292.  Oct |  ósemkowy
  293.  
  294.  Tryb interpretacji liczb
  295.  ~~~~~~~~~~~~~~~~~~~~~~~~
  296.  Sig |  ze znakiem w kodzie U2
  297.  Uns |  bez znaku
  298.  
  299.  MS  (Memory Safe)
  300.  ~~~ Zapamiëtanie liczby w pamiëci podrëcznej kalkultaora.
  301.  
  302.  MR  (Memory Read)
  303.  ~~~ Odczytanie liczby z pamiëci podrëcznej kalkulatora i zapisanie
  304.      jej na wyôwietlacz.
  305.  
  306.  MC  (Memory Clear)
  307.  ~~~ Skasowanie liczby, która znajduje sië w pamiëci kalkulatora.
  308.  
  309.  CE  (Clear Entry)
  310.  ~~~ Skasowanie wyôwietlacza kalkulatora.
  311.  
  312.  CA  (Clear All)
  313.  ~~~ Skasowanie wszystkiego tzn. zostnie skasowany pamiëê podrëczna
  314.      kalkulatora, wyôwietlacz, przywrócony zostanie system dziesiëtny(Dec)
  315.      i tryb liczb ze znakiem(Sig).
  316.  
  317.  
  318.                        OPCJE ZNAJDUJÂCE SIË W MENU
  319.                        ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  320.  Skasuj wyôwietlacz
  321.  ~~~~~~~~~~~~~~~~~~
  322.      Odpowiednik funkcji CE.
  323.  
  324.  Skasuj wszystko
  325.  ~~~~~~~~~~~~~~~
  326.      Odpowiednik funkcji CA.
  327.  
  328.  Zmiana systemów liczbowych
  329.  ~~~~~~~~~~~~~~~~~~~~~~~~~~
  330.      Dec  - dziesiëtny
  331.      Bin  - dwójkowy
  332.      Hex  - szesnastkowy
  333.      Oct  - ósemkowy
  334.  
  335.  Zmiana interpretacji liczb
  336.  ~~~~~~~~~~~~~~~~~~~~~~~~~~
  337.      Sig  - liczby ze znakiem
  338.      Uns  - liczby bez znaku
  339.  
  340.  Instalacja komend ARexxa
  341.  ~~~~~~~~~~~~~~~~~~~~~~~~
  342.      Wyôwietlenie okna w którym moûemy zainstalowaê sobie cztery programy
  343.      napisane w AREXXie.  Gadgetem Komenda 1..4 edytujemy gadget pod któ-
  344.      rym bëdzie zainstalowany program AREXXa. Górny StringGadget sîuûy do
  345.      wpisania katalogu z którego bëdzie wywoîywany skrypt,a w pozostaîych
  346.      trójznakowe identyfikatory tych komend.
  347.  
  348.      Gadget o oznaczeniu 'Jeden argum.' informuje program, ile argumentów
  349.      potrzebuje skrypt do wykonania obliczenia.  Nie zaznaczony informuje
  350.      ûe jest to komenda dwuargumentowa.
  351.  
  352.      Gadget o oznaczeniu 'Okno ARexxa' powoduje ûe gdy jest on ustawiony,
  353.      przy wywoîaniu skryptu AREXXa zostanie otwarte okno komunikacyjne.
  354.  
  355.  Ekran publiczny
  356.  ~~~~~~~~~~~~~~~
  357.      Pozwala zmieniê ekran na którym  wyôwietlany jest kalkulator podczas
  358.      jego pracy.  Wybranie tej opcji wyôwietli okno z nazwami ekranów, na
  359.      które moûna "przenieôê" kalkulator.  Wybieramy je wskazujâc kursorem
  360.      myszy i zatwierdzajâc gadgetem "OK".
  361.  
  362.  Kontrola przepeînienia
  363.  ~~~~~~~~~~~~~~~~~~~~~~
  364.      Ta opcja pozwala kontrolowaê wynik i informowaê o tym, gdy bëdzie on
  365.      niezgodny z prawdâ.  Wówczas zostaje wyôwietlony komunikat o bîëdzie
  366.      przepeînienia.  Opcja dziaîa tylko przy wykonywaniu obliczeï arytme-
  367.      tycznych.
  368.  
  369.  Wizytówka
  370.  ~~~~~~~~~
  371.      Aktualne dane o programie i jego autorze.
  372.  
  373.  Wyjôcie
  374.  ~~~~~~~
  375.      Pozwala zakoïczyê dziaîanie programu i wyjôê z procesu.
  376.  
  377.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  378.  Ten krótki opis ma na celu poinformowanie Cië o moûliwoôciach tego programu
  379.  Mam nadziejë, ûe bëdâ one na tyle atrakcyjne i przydatne aby go zarejestro-
  380.  waê (program oczywiôcie).
  381.                                                                  Autor.
  382.  ___________________________________________________________________________
  383.  \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  384.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  385.