Difference between revisions of "Emulators:PindurTI"

From WikiTI
Jump to: navigation, search
m (new category)
(Major rewrite)
Line 1: Line 1:
−
PindurTI is the latest addition to the TI [[emulator]] 'familiy'. It is the only [[emulator]] with accurate 83(+) emulation and has some unique features aswell. However note that this [[emulator]] is still in development. This means that information on this page can change aswell as be incorrect.  
+
PindurTI (commonly referred to as PTI) is the latest addition to the TI [[emulator]] 'family', still in development by Patai Gergely. This page contains the up-to-date documentation.
  
 
==Features==
 
==Features==
 
*Full support for 82 and 83. 83+ support isn't complete yet, but it's already the most accurate of all emulators.
 
*Full support for 82 and 83. 83+ support isn't complete yet, but it's already the most accurate of all emulators.
−
*Virtual Linking of two calcs.
+
*Raw virtual linking of any number of calculators.
−
*Built-in (animated) screenshot-tool.
+
*Built-in (animated) screenshotting ability.
−
*Built-in advanced debug tool.
+
*Debugger.
 
*Scripting for external tools (preliminary in the latest version), which is already used by [[LateNite]]
 
*Scripting for external tools (preliminary in the latest version), which is already used by [[LateNite]]
  
−
If you have ideas you want to incorporate in the tool, you can submit your ideas at the [http://www.hszk.bme.hu/~pg429/pindurti/features/ Pindur TI idea box]. Repetitions and trivialities are frowned upon.
+
If you have ideas you want to incorporate in the tool, you can submit your ideas at the [http://www.hszk.bme.hu/~pg429/pindurti/features/ PindurTI idea box]. Repetitions and trivialities are frowned upon.
  
−
==Help==
+
==Basics==
−
At the moment of writing PindurTI has no graphical user interface (GUI) yet. Therefore it can be a little complicated to use it. Here you can find some help:
+
PindurTI requires no installation; it is a standalone executable you can put anywhere. It will only create a file called pti.conf in its working directory (which is by default the same as the one the executable is located in), so make sure this directory is not read-only for pindurti.exe.
  
−
'''Starting and Initialize PTI'''
+
At the moment of writing PindurTI has no real graphical user interface (GUI) yet, only the absolute minimum required to use all the features. Here are the steps to get going:
  
−
1. Double-click on pindurti.exe.
+
1. Start pindurti.exe. You will see any empty, fully cyan window. The four quarters of the window represent four slots where individual calculators can be run.
  
−
2. Drag-and-drop your calc-rom (mostly a .rom) to the PindurTI window.
+
2. Drag-and-drop a ROM image to one of the quarters, preferably the top left. The quarter chosen will turn grey for the most part, and four icons will appear above the grey area.
  
−
3. Click left on the PindurTI window to turn the 'power' of the calc on.
+
3. Left click the grey part. This is the screen of the calculator, and the left click corresponds to the On key.
  
 +
4. You can drag and drop other ROM images to the other slots. You can switch between the slots by right clicking them. (Left clicking also activates the slot, but it also causes the On key to be pressed.)
  
−
'''Sending files to PTI'''
+
5. Files can be sent by dropping them to the appropriate slot. PTI uses silent linking, so the calculator must be on, somewhere in the TI-OS and ''not in receive mode'' in order for the transmission to succeed. You can also drop a group of files, they will be sent one after the other. Naturally, the file and the running ROM image must be for the same model, e.g. sending an 8xp file to a TI-82 won't work.
  
−
1. Start PTI.
+
'''Pressing calculator keys'''
  
−
2. Drag-and-drop the file (mostly a .83P or .8XP) to the PindurTI window.
+
PTI always acts as if the layout was English, so if you use an alternative layout (e.g. AZERTY or Cyrillic), 'Q' still refers to the button next to the Tab key etc.
  
 +
{| border="1" cellspacing="0" cellpadding="2"
 +
! PC key !! Calculator key
 +
|-
 +
| left mouse button || On
 +
|-
 +
| A..Z || the button that yields the corresponding letter if alpha is on, see below
 +
|-
 +
| Space || 0
 +
|-
 +
| arrows, 0..9, Enter, '.', ',', numpad +-/* || the corresponding calculator key
 +
|-
 +
| [ || (
 +
|-
 +
| ] || )
 +
|-
 +
| F1 || Y=
 +
|-
 +
| F2 || Window
 +
|-
 +
| F3 || Zoom
 +
|-
 +
| F4 || Trace
 +
|-
 +
| F5 || Graph
 +
|-
 +
| Escape || Mode
 +
|-
 +
| Left Shift || 2nd
 +
|-
 +
| Left Control || Alpha
 +
|-
 +
| Right Shift || Clear
 +
|-
 +
| - || (-) (between the decimal point and Enter)
 +
|-
 +
| = || X,T,θ,''n''
 +
|-
 +
| Page Up || Matrx (82/83) or Apps (83+)
 +
|-
 +
| Page Down || Prgm
 +
|-
 +
| Insert || Vars
 +
|-
 +
| Delete || Del
 +
|-
 +
| Home || Math
 +
|-
 +
| End || Stat
 +
|}
  
−
'''Other functions'''
+
'''Mapping of letter keys'''
  
−
''Screenshots'': Press 'tab' to start capturing and press 'tab' again to stop it.
+
{| border="1" cellspacing="0" cellpadding="2"
 +
| '''A''' || Math || '''B''' || Matrx || '''C''' || Prgm ||   ||   ||   ||  
 +
|-
 +
| '''D''' || x<sup>-1</sup> || '''E''' || Sin || '''F''' || Cos || '''G''' || Tan || '''H''' || ^
 +
|-
 +
| '''I''' || x<sup>2</sup> || '''J''' || , || '''K''' || ( || '''L''' || ) || '''M''' || ÷
 +
|-
 +
| '''N''' || Log || '''O''' || 7 || '''P''' || 8 || '''Q''' || 9 || '''R''' || ×
 +
|-
 +
| '''S''' || Ln || '''T''' || 4 || '''U''' || 5 || '''V''' || 6 || '''W''' || -
 +
|-
 +
| '''X''' || Sto→ || '''Y''' || 1 || '''Z''' || 2 || &nbsp; || &nbsp; || &nbsp; || &nbsp;
 +
|}
  
−
''Reset ROM'': Press F9 to reset the rom.
+
==Other keys==
  
−
''Debug'': Press F10 to reveal the debugger. Note that it always shows the state of the calculator in the left slot.
+
{| border="1" cellspacing="0" cellpadding="2"
 +
! Key !! Effect
 +
|-
 +
| Tab || Start crude (9 fps) screenshot/Stop current screenshot
 +
|-
 +
| Alt || Start fine (25 fps) screenshot/Stop current screenshot
 +
|-
 +
| F9 || Reset calculator in active slot (simulates pulling batteries)
 +
|-
 +
| F10 || Open debugger
 +
|-
 +
| F11 || Enable/disable warp mode (fastest possible emulation) of active slot
 +
|}
  
−
''Warp mode'': Press F11 to switch to warp mode (fastest possible emulation).
+
Note that only crude screenshots are displayed properly everywhere. Fine screenshots are only shown at full speed by Firefox.
  
−
''Virtual linking'': Press F12 to establish and disconnect a raw link between the two emulated calculators.
+
==Additional functions==
 +
 
 +
The icons above each calculator screen can be used for the following purposes by left clicking, from left to right:
 +
 
 +
1. Pause/unpause
 +
 
 +
2. Enable/disable warp mode
 +
 
 +
3. Plug into a link hub; plug in two calculators to open a communication line between them. Connecting more than two calculators is not supported by the TI-OS. However, the CLAP linking library allows mass linking.
 +
 
 +
4. Toggle inclusion in screenshotting. If no slot is selected, always the active one will be captured. This feature can be used to allow capturing a slot even if we activate another in the meantime (e.g. to save an animated cutscene while using another calculator) or to record multiplayer games.
 +
 
 +
==Debugger==
 +
 
 +
TODO
 +
 
 +
==Scripting==
 +
 
 +
TODO
  
 
==External Resources==
 
==External Resources==
−
[http://www.hszk.bme.hu/~pg429/pindurti/pindurti.exe Latest Build of PindurTI]
+
[http://www.hszk.bme.hu/~pg429/pindurti/pindurti.exe Latest build of PindurTI]
  
−
[http://www.hszk.bme.hu/~pg429/pindurti/pindurti.txt PindurTI ReadMe]
+
[http://users.hszk.bme.hu/~pg429/pindurti/changelog.txt Changelog]
  
−
[http://www.hszk.bme.hu/~pg429/pindurti/features/ PindurTI IdeaBox]
+
[http://www.hszk.bme.hu/~pg429/pindurti/features/ PindurTI Idea box]
 
[[Category:Emulators]]
 
[[Category:Emulators]]

Revision as of 02:04, 2 September 2006

PindurTI (commonly referred to as PTI) is the latest addition to the TI emulator 'family', still in development by Patai Gergely. This page contains the up-to-date documentation.

Features

  • Full support for 82 and 83. 83+ support isn't complete yet, but it's already the most accurate of all emulators.
  • Raw virtual linking of any number of calculators.
  • Built-in (animated) screenshotting ability.
  • Debugger.
  • Scripting for external tools (preliminary in the latest version), which is already used by LateNite

If you have ideas you want to incorporate in the tool, you can submit your ideas at the PindurTI idea box. Repetitions and trivialities are frowned upon.

Basics

PindurTI requires no installation; it is a standalone executable you can put anywhere. It will only create a file called pti.conf in its working directory (which is by default the same as the one the executable is located in), so make sure this directory is not read-only for pindurti.exe.

At the moment of writing PindurTI has no real graphical user interface (GUI) yet, only the absolute minimum required to use all the features. Here are the steps to get going:

1. Start pindurti.exe. You will see any empty, fully cyan window. The four quarters of the window represent four slots where individual calculators can be run.

2. Drag-and-drop a ROM image to one of the quarters, preferably the top left. The quarter chosen will turn grey for the most part, and four icons will appear above the grey area.

3. Left click the grey part. This is the screen of the calculator, and the left click corresponds to the On key.

4. You can drag and drop other ROM images to the other slots. You can switch between the slots by right clicking them. (Left clicking also activates the slot, but it also causes the On key to be pressed.)

5. Files can be sent by dropping them to the appropriate slot. PTI uses silent linking, so the calculator must be on, somewhere in the TI-OS and not in receive mode in order for the transmission to succeed. You can also drop a group of files, they will be sent one after the other. Naturally, the file and the running ROM image must be for the same model, e.g. sending an 8xp file to a TI-82 won't work.

Pressing calculator keys

PTI always acts as if the layout was English, so if you use an alternative layout (e.g. AZERTY or Cyrillic), 'Q' still refers to the button next to the Tab key etc.

PC key Calculator key
left mouse button On
A..Z the button that yields the corresponding letter if alpha is on, see below
Space 0
arrows, 0..9, Enter, '.', ',', numpad +-/* the corresponding calculator key
[ (
] )
F1 Y=
F2 Window
F3 Zoom
F4 Trace
F5 Graph
Escape Mode
Left Shift 2nd
Left Control Alpha
Right Shift Clear
- (-) (between the decimal point and Enter)
= X,T,θ,n
Page Up Matrx (82/83) or Apps (83+)
Page Down Prgm
Insert Vars
Delete Del
Home Math
End Stat

Mapping of letter keys

A Math B Matrx C Prgm        
D x-1 E Sin F Cos G Tan H ^
I x2 J , K ( L ) M ÷
N Log O 7 P 8 Q 9 R ×
S Ln T 4 U 5 V 6 W -
X Sto→ Y 1 Z 2        

Other keys

Key Effect
Tab Start crude (9 fps) screenshot/Stop current screenshot
Alt Start fine (25 fps) screenshot/Stop current screenshot
F9 Reset calculator in active slot (simulates pulling batteries)
F10 Open debugger
F11 Enable/disable warp mode (fastest possible emulation) of active slot

Note that only crude screenshots are displayed properly everywhere. Fine screenshots are only shown at full speed by Firefox.

Additional functions

The icons above each calculator screen can be used for the following purposes by left clicking, from left to right:

1. Pause/unpause

2. Enable/disable warp mode

3. Plug into a link hub; plug in two calculators to open a communication line between them. Connecting more than two calculators is not supported by the TI-OS. However, the CLAP linking library allows mass linking.

4. Toggle inclusion in screenshotting. If no slot is selected, always the active one will be captured. This feature can be used to allow capturing a slot even if we activate another in the meantime (e.g. to save an animated cutscene while using another calculator) or to record multiplayer games.

Debugger

TODO

Scripting

TODO

External Resources

Latest build of PindurTI

Changelog

PindurTI Idea box

Retrieved from "https://wikiti.brandonw.net/index.php?title=Emulators:PindurTI&oldid=5194"