dcd32pc — Decode 32Sii State File on PC
- Abstract:
- Emu42 runs with ease also
HP-32Sii firmware.
Alas, this programmable model lacks a printer so user code may only be seen line by line in the display.
This flaw is the only raison d'être for dcd32pc, it "prints" to a receipt shaped window
all routines found in the emulator state file.
There is no need to export program files first.
- Update 9/1/2022:
- Check presence of correct model identifier in the state file
Note: afore running this program read the QPL in
section 5.
TOC:
- A Brief Description
- Prerequisites, Install and Run it
- Controls of This Program
- Features, Constraints, Known Bugs
- The Fine Print
A Brief Description
Almost all is already outlined in the abstract.
Only supplementary detail worth to mention – equations embedded in programs are printed too
(but not the equation list).
Prerequisites, Install and Run it
To run dcd32pc you need (in brackets what I used for the development):
Install it
There is no automated installation procedure.
Unzip dcd32pc.ZIP to a directory named at will, one of its own or not, it's up to you.
Run it
There are two intended ways to start dcd32pc, either with an argument or without.
- With no argument dcd32pc will show the blank "print stripe" window,
then the 'Sho' button opens a 'load file' dialog for to pick a state file to decode.
- To bypass the pick-a-file step start dcd32pc with the file-ID as argument,
possible with path or location (= drive and path).
Windows offers several options to do so, one would be using the explorer,
just drag the state file and drop it on dcd32pc.rx.
Note: The actual suffix of REXX programs depend on your choices at ooREXX installation.
I recommend to change it to the one which runs the routine w/o console window ("REXX-hide").
dcd32pc reports errors as messages, hints of minor importance
(like 'No file selected.' when cancelling file selection)
are shown on the console window only.
There is no functional disadvantage to run this dialog application without console.
Controls of dcd32pc
Four buttons:
- Sho
- if no state file was specified or if it was rejected,
opens a 'load file' dialog to choose an input file,
otherwise decodes the known state file once more.
Handy if the program was changed (and saved) in same time running 32Sii.
- Purge
- wipes out all output up till now.
- Mark All
- – you know it.
- Copy
- puts the marked part of the output to the Windows clipboard.
By design the only way to change the state file is to quit and restart dcd32pc.
To quit hit ESC or Alt+F4.
Features, Constraints, Known Bugs
- Are there features worth to mention?
- Yes – the reason for this update: state files are tagged which calculator model they represent,
consequently only 32Sii files are analyzed.
- Are there significant limitations?
- No, at least not significant.
ooDialog is currently not able to deal with unicode chars.
That is why few special signs are replaced, e. g. $\bar{x}$, $\hat{y}$, $\sum$ and alike are "translated".
- Known bugs?
- No.
The known bug is fixed, all the rest is not known yet.
The fine print
(i) Do not use this program.
(ii) Any damage you cause with this program, intentional or by chance, is a violation of clause (i). Thus all consequences are completely at your own risk.
(iii) If you manage to improve this program you have to inform me as stipulated in following THE Q PUBLIC LICENSE (QPL).
(iv) In addition applies the QPL below:
THE Q PUBLIC LICENSE version 1.0
Copyright (C) 1999 Trolltech AS, Norway.
Everyone is permitted to copy and distribute this license document.
The intent of this license is to establish freedom to share and change the software regulated by this license under the open source model.
This license applies to any software containing a notice placed by the copyright holder saying that it may be distributed under the terms of the Q Public License version 1.0. Such software is herein referred to as the Software. This license covers modification and distribution of the Software, use of third-party application programs based on the Software, and development of free software which uses the Software.
Granted Rights
- You are granted the non-exclusive rights set forth in this license provided you agree to and comply with any and all conditions in this license. Whole or partial distribution of the Software, or software items that link with the Software, in any form signifies acceptance of this license.
- You may copy and distribute the Software in unmodified form provided that the entire package, including - but not restricted to - copyright, trademark notices and disclaimers, as released by the initial developer of the Software, is distributed.
- You may make modifications to the Software and distribute your modifications, in a form that is separate from the Software, such as patches. The following restrictions apply to modifications:
a. Modifications must not alter or remove any copyright notices in the Software.
b. When modifications to the Software are released under this license, a non-exclusive royalty-free right is granted to the initial developer of the Software to distribute your modification in future versions of the Software provided such versions remain available under these terms in addition to any other license(s) of the initial developer.
- You may distribute machine-executable forms of the Software or machine-executable forms of modified versions of the Software, provided that you meet these restrictions:
a. You must include this license document in the distribution.
b. You must ensure that all recipients of the machine-executable forms are also able to receive the complete machine-readable source code to the distributed Software, including all modifications, without any charge beyond the costs of data transfer, and place prominent notices in the distribution explaining this.
c. You must ensure that all modifications included in the machine-executable forms are available under the terms of this license.
- You may use the original or modified versions of the Software to compile, link and run application programs legally developed by you or by others.
- You may develop application programs, reusable components and other software items that link with the original or modified versions of the Software. These items, when distributed, are subject to the following requirements:
a. You must ensure that all recipients of machine-executable forms of these items are also able to receive and use the complete machine-readable source code to the items without any charge beyond the costs of data transfer.
b. You must explicitly license all recipients of your items to use and re-distribute original and modified versions of the items in both machine-executable and source code forms. The recipients must be able to do so without any charges whatsoever, and they must be able to re-distribute to anyone they choose.
c. If the items are not available to the general public, and the initial developer of the Software requests a copy of the items, then you must supply one.
Limitations of Liability
In no event shall the initial developers or copyright holders be liable for any damages whatsoever, including - but not restricted to - lost revenue or profits or other direct, indirect, special, incidental or consequential damages, even if they have been advised of the possibility of such damages, except to the extent invariable law, if any, provides otherwise.
No Warranty
The Software and this license document are provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
Choice of Law
This license is governed by the Laws of England (if not yet part of Spanish East Indies)