Extract Packages 1.2 ©1995–6 ∑-Soft, Markus Fritze

Welcome

EP is a tiny little tool to extract packages from a NCK backup file. This makes it possible for you to erase the card and still upload a single package of the original card, if necessary. Very nice especially for MP120 owners with FilePad and Notion and lot’s of demos in their internal RAM. Now you can restore only FilePad or Notion and not all the other stuff.

The format of the backup is not as simple as the package-format of the Newton. It takes me some time to get EP fully working.

To use EP; start it and open a backup (card or internal memory) in your NCK folder. EP will scan the backup and present you a file selector for every package it found. You may save the packages where you want. The filename may help you to identify a package – it’s the internal name of the package.

Since version 1.1 EP is capable of recoding a package! This means, that EP produces a readable text output of all frames, arrays, etc. of a package. But the absolute highlight is the feature to decode the P-Code of packages!!! Extremly nice for programmers, who lost one of there sources (like me :-() Programmers may move the “NTK Definitions” file from the NTK into the EP directory, EP will use it for recoding.

Version 1.1 is no longer a fat binary. There is no need for speed in EP, but the size of the programm doubles in a fat binary.

(now the german version of this text)

EP ist ein kleines Programm, welches Packages aus einem NCK Backup file extrahiert. Dies ermöglicht es das RAM zu löschen und bei Bedarf ein einzelnes Package upzuloaden. Dies ist besonders für MP120 Besitzer praktisch, bei denen sich ja FilePad und Notion zusammen mit diversen Demos im Speicher befindet. Endlich kann man den ganzen Kram löschen und später z.B. nur FilePad oder Notion in den Newton uploaden.

Das Format des NCK Backups ist nicht so einfach aufgebaut, wie das Format der Packages. Es hat mich einige Zeit gekostet EP zum Laufen zu bringen.

Um EP zu nutzen, startet man es einfach und öffnet ein Backup (der Karte oder des internen Speichers) aus dem NCK Ordner. EP durchsucht das Backup und zeigt für jedes gefundene Package einen Fileselector. Die Packages kann man überall hin speichern. Der Filename entspricht dem internen Namen des Packages und hilft dabei das Packet zu identifizieren.

Seit Version 1.1 kann EP Packages dekodieren! Dies bedeutet, daß EP aus einem Package eine Textdatei mit allen Frames, Arrays, etc. erzeugen kann. Aber das absolute Highlight daran ist, daß auch der P-Code dekodiert werden kann! Sehr praktisch für Programmierer, die einen ihrer Sourcen verloren haben (wie ich z.B. :-() Programmierer können die “NTK Definitions” Datei des NTK ins EP Verzeichnis schieben, EP benutzt es bei der Dekodierung.

Version 1.1 ist kein fat Binary mehr. EP braucht die Geschwindigkeit nicht, aber die Programmlänge verdoppelt sich bei einem fat Binary.

The current version

• Extract-Packages–1.2.sit (32kb)

I developed this small ANSI C program at the university. It is a simple formula parser, useful for many situations, like an intelligent input in dialog boxes.

The gag in this parser is the possibility to compile formulas into p-code to get a major performance improvement while calculating. This is useful for formula plotters, etc., that uses the same formula only with different values.

In Parse.h some configurations can be done:

• ‘‘Dbl’’ is a typedef for the type of the calculation of the parser. Normally it should be ‘‘float’’ or ‘‘double’’. ‘‘TERM_COMPILER’’ activates the p-code compiler. If you use the formula only once, than you should disable it, otherwise enable it.
• buildTerm is called to compile an ASCII expression into p-code. If the ‘‘TERM_COMPILER’’ is not active, this routine does nothing.
• ‘‘calcTerm’’, ‘‘calcTerm1’’, ‘‘calcTerm2’’, ‘‘calcTerm3’’ calculates the current expression with no, 1, 2 or 3 parameters. The parameters are put into the variables ‘‘X’’, ‘‘Y’’ and ‘‘Z’’. Undefined variables have the value ‘‘HUGE_VAL’’.

Besides the trivial operations (‘’+‘’, ‘’-‘’, ‘’*‘’, ‘’/‘’, ‘’^‘’, with brackets) the parser also know the following functions:

Name	Description
‘‘PI’’	the value PI (3.1415926…)
‘‘E’’	the value e (2.7182818)
‘‘X’’, ‘‘Y’’, ‘‘Z’’	the values X, Y, Z
‘‘acos’’, ‘‘arccos’’	the function cos–1(a)
‘‘asin’’, ‘‘arcsin’’	the function sin–1(a)
‘‘atan’’, ‘‘arctan’’	the function tan–1(a)
‘‘atan2’’, ‘‘arctan2’’	the function tan–1(a,b)
‘‘ceil’’	the function ceil(a)
‘‘cos’’	the function cos(a)
‘‘cosh’’	the function cosh(a)
‘‘exp’’	the function exp(a)
‘‘floor’’	the function floor(a)
‘‘fmod’’	the function fmod(a)
‘‘log’’	the function log(a)
‘‘log10’’	the function log10(a)
‘‘pow’’	the function pow(a,b)
‘‘sin’’	the function sin(a)
‘‘sinh’’	the function sinh(a)
‘‘sqrt’’	the function sqrt(a)
‘‘tan’’	the function tan(a)
‘‘tanh’’	the function tanh(a)

Sourcecode for the Parser

• Parse.c
• Parse.h