AviPic/Avimage V2.0 documentation
(Deutscher Text: weiter unten)
This app is commentware: send comments & request to KochAndreas@Yahoo.com
Without (YOUR!) comments, this app won't be developed further.
It is provided without any guarantees; the author will not be responsible for any damage caused by it, in any way.
This app must not be used in mission critical situations.
By using it, you accept this terms.
AviPic is a toolkit designed to view pictures larger than 160*160 on your AVIGO.
Currently pictures with a width of up to 3000 pixels and a total size of nearly 64K (packed!) are supported.
You might note that the packing ratio is nearly as good as ZIP.
It consists of an Windows EXE "AviMage" (should work with 95,98,NT, probably
with ME and 2K too) and a set of empty app files (16,32,48 and 64K size).
The EXE is used to "burn" one(!) image into a app, which is then installed on the Avigo.
Install: just copy the EXE and the APPs into a directory of your choice.
No uncommon DLLs, registry entries etc. are used.
using AviMage
Avimage is pretty easy to use. Start the EXE, load an BMP, add an overview
if you wish, and create a app file by choosing a raw application of suitable size..
you'll get an "unexpected out of segments" error if the raw is too small.
Notes:
In the top line some values are displayed: "Image Processing xx*8 / 1006
pixels (84504 bytes) compression... to zzzzz bytes".
Remember, currently only pics with a packed size zzzzz of less than about 60000
bytes and xx<=400 are supported.
The menu items:
- File/Load BMP Load the picture you want to store on your Avigo. Format needs to be BMP, perferably allready monochrome but
AviMage will (poorly) convert color pictures, too.
- File/Export .C Exports packed picture as C source code. Only usefull for developers.
- File/Repaint re-paints the image from the packed data. Blue=OK, Red=Error. The current version shouldn't produce these
errors anymore, so no need to use it.
- File/Save Icon Saves the generated Icon as a 52*50 BMP file
- File/Create App Saves the image to an app file. To do this, you need to select a RAW file to use as template;
choose the smallest the image will fit in. Then save to an APP name of your choice.
- Edit/Paste Instead of loading a BMP, you can paste a picture from the clipboard here.
- Misc/add overview Extends the picture with an 160*240 pixel overview. Note this makes the picture bigger. In AviPic,
press SCHEDULE to view it - if you don't add one, SCHEDULE won't work.
- Zoom Settings Set how icon and overview are calculated:
- Darker: one black input pixel = black output pixel. recommended for line art
- Equal: more black input pixels than white = black output pixel.recommended for photos
- Brighter: no black input pixel = black output pixel.
using AviPic
The Avigo part is as easy to handle as the Windows one. Just
start the app, and touch a point on the touch screen to center your
view to that point. Use the SCHEDULE key to show the overview
(if you build one in), and click on it to center on that spot.
Press ADDRESS to leave AviPic.
Notes:
When using the included SOUTHSEA example, or any similar pic, your start screen portion will be an empty area. Scroll down/right a few
times to see something.
Question and Answer:
? I tried to use a picture of my girlfriend (600*500 pixels), but it complains about "doesn't fit".
! AviPic is intended for line drawings - photos of the same size can't be packed at the same degree. Be also sure you selected the largest RAW file you have.
? When i use 'repaint' , the EXE shows some parts of the pic in red.
! That indicates that because of a packing error the synchronization was lost - the red parts are a few pixels higher or lower than they should. This should not any longer appear with the current version.
? If i load a color picture, the results are poor.
! AviMage is no image processor. B/W conversion is done in a very simple way - "nearest color". If you need a better conversion, use an image processor such as "Paint Shop Pro".
? I see strange borders on the Avigo
! Don't use pictures smaller than 160*240
? What features will be implemented in future?
! None, without feedback. If no one uses this app, i won't improve it.
? I need larger RAWs than 64K!
! Drop me a mail.
? Can't i use photos, or rastered maps etc.?
! You can, they just can't be packed at the same rate as line art can, therefore they might not fit into any of the RAWs.
Changes from V1.0 -> V2.0
- Major parts rewritten in assembly language, resulting in pretty good speed improvement
- Max picture size now 4 times larger
- Instead of death-slow 50% zoom, we now have an optional fast total zoom. con: needs more mem pro: view code smaller, FASTER
Have fun !
Andreas Koch
Dieses Programm ist Commentware: Kommentare & Vorschlaege bitte an
KochAndreas@Yahoo.com mailen.
Ohne (IHRE!) Kommentare gehe ich davon aus dass sich niemand fuer
dieses Programm interessiert und entwickle es nicht weiter.
Dieses Programm wird ohne jegliche Garantie zur Verfuegung gestellt;
Der Author ist in keinster Weise fuerr Schaeden die durch dieses Programm
bedingt sind verantwortlich zu machen. Der gerichtliche Streitwert ist
in jedem Fall auf den dem Author bezahlten Preis (0,-) beschraenkt.
Dieses Programm darf nicht in kritischen Situationen eingesetzt werden.
Durch Benutzung erklaert sich der Anwender damit einverstanden.
AviPic ist ein Werkzeug um Bilder mit mehr als 160*160 Pixeln auf dem TI Avigo darzustellen.
Momentan sind Bilder mit Breiten bis 3000 pixel und einer Gesamtgroesse von bis zu 64K (gepackt!) moeglich.
Die Packrate ist fast so gut wie ZIP.
AviPic besteht aus der Window-EXE AviMage (sollte auf Win95,98,NT, vermutlich
auch mit ME und 2K laufen) und den "leeren" Avigo-APPs Avipic*.raw.
Die EXE wird verwendet um ein(!) Bild in eine APP zu "brennen", die dann auf dem Avigo installiert wird.
Zur Installation einfach EXE und APPs in ein gemeinsames Verzeichnis
ihrer Wahl kopieren - keine seltenen DLLs oder Registryeintraege noetig.
AviMage verwenden
Avimage is recht einfach zu verwenden. EXE starten, BMP laden, Uebersicht bei Bedarf hinzufuegen,
und eine APP aus einem RAW-File geeigneter Groeße erzeugen..
War das RAW zu klein fuer das Bild, gibt es ein "unexpected out of segments"
Hinweise:
In der Kopfzeile steht nun "Image Processing xx*8 / 1006 pixels (84504 bytes)
compression... to zzzzz bytes".
Nur wenn xx<=400 ist und zzzzz < etwa 60000, ist das Bild klein genug um in
die APP zu passen.
Die Menuepunkte:
- File/Load BMP Laedt das zu bearbeitende Bild. Format BMP, vorzugsweise schwarz/weiss, ansonsten wird mehr schlecht als recht
automatisch konvertiert.
- File/Export .C Exportiert fuer die Programmierer unter uns ein C-File.
- File/Repaint Malt das Bild aus den errechneten Daten neu. Differenzen werden rot angezeigt. Sollten mit der aktuellen
Version nicht mehr vorkommen, also kein Grund diesen Punkt zu verwenden.
- File/Save Icon Speichert das erzeugte Icon as 52*50 BMP-Bild
- File/Create App Speichert das Bild in ein APP-File. Dazu muss erst ein passendes RAW-File als Vorlage
ausgewaehlt werden - am besten das kleinste noch passende.
- Edit/Paste Statt ein BMP zu laden, kann man auch ein Bild aus der Zwischenablage einfuegen.
- Misc/add overview Ergaenzt das Bild um eine 160*240 Pixel grosse Uebersicht. Hinweis: dadurch wird das Bild
groesser. Nur wenn eine Uebersicht hinzugefuegt wurde, kann man sie sich auf dem Avigo anschauen (eigentlich logisch...)
- Zoom Settings Zum Einstellen wie Icon und Uebersicht berechnet werden:
- Darker: ein schwarzer Eingabepixel = Ergebniss schwarz. Fuer Strichzeichnungen empfohlen.
- Equal: mehr schwarze als weisse Eingabepixels = Ergebniss schwarz.Fuer Fotos empfohlen.
- Brighter: keine weissen Eingabepixel = Ergebniss schwarz.
AviPic verwenden
Der Avigo-Teil ist ebenso einfach wie das Windowsprogramm zu verwenden. Einfach starten und einen Punkt auf dem Schirm
antippen um darauf zu zentrieren. Wenn eine Uebersicht eingebaut wurde, kann diese mit SCHEDULE aufgerufen werden - ein
Klick beendet die Uebersicht und zentriert auf dem gewaehlten Punkt.
Per ADDRESS wird AviPic beendet.
Hinweise:
Mit dem beigefuegten SOUTHSEA-Beispiel oder aehnlich leeren Bildern kann der Startschirm schon mal leer sein, weil
in der linken oberen Ecke. In dem Fall nach unten/rechts scrollen um etwas zu sehen zu bekommen.
Frage und Antwort:
? Ich habe es mit einem Bild meiner Freundin versucht (600*500 Pixel), bekomme aber die Meldung dass es nicht passt.
! AviPic ist fuer Strichgrafiken vorgesehen. Photos koennen schlechter komprimiert werden, und sind daher oft zu gross.
? 'Repaint' zeigt mir Bereiche in Rot an.
! Diese Bereiche sind auf Grund von kompressionsfehlern etwas nach oben oder unten verschoben.
? Wenn ich ein farbiges Bild lade, sind die Ergebnisse schwach.
! AviMage ist kein Bildbearbeitungsprogamm, sondern hat nur einesehr einfache Monochrom-Konverterroutine ("naechste Farbe").
Fuer bessere Ergebnisse das Bild vorher z.B. mit PaintShop Pro in Monochrom (2 Farben) umwandeln.
? Auf dem Avigo sehe ich seltsame Raender
! Keine Bilder unter 160*240 verwenden.
? Welche Funktionen werden noch eingebaut?
! Ohne Feedback: keine. Wenn niemand dieses Programm verwendet brauche ich es auch nicht verbessern.
? Ich brauche RAWs mit mehr als 64K!
! Einfach eine Mail an mich schicken.
? Kann ich keine Fotos, gerastere Bilder etc. verwenden ?
! Doch, nur lassen sie sich schlechter komprimieren als Strichgrafiken, und passen deshalb unter Umstaenden in keines der RAW-Files.
Aenderungen von V1.0 -> V2.0
- Grosse Teile in Assembler neu geschrieben, dadurch ordentlicher Geschwindigkeitszuwachs
- Maximale Bildgroesse vervierfacht.
- Statt grottenlahmem 50%-Zoom jetzt eine flotte Totaluebersicht. Nachteil: braucht Platz Vorteil: Betrachter kleiner, SCHNELLER
Viel Spass !
Andreas Koch