[ENGLISH]
Directory Opus 4 "Vampire Edition"
==================================
The classic two-panel file manager Directory Opus 4.16 (GPL sources by
Jonathan Potter and Jacek Rzeuski), rebuilt with GCC 6.5 and tuned and
tested on a Vampire V4 Standalone (Apollo 68080, AmigaOS 3.2, SAGA,
Picasso96, AHI). It keeps the look and the behaviour of the 1992 program
and adds what a modern Amiga needs.
It installs next to any other Opus: it uses its own library,
dopus4vamp.library, and never touches dopus.library.
WHAT IS NEW
-----------
Sound
* WAV playback: PCM 8/16/24/32 bit, IEEE float 32/64, A-law, mu-law,
WAVE_FORMAT_EXTENSIBLE and files with more than two channels.
Compressed WAVs (ADPCM, MP3) are refused with a clear message in the
status bar instead of being played as noise.
* WAVs are STREAMED: playback starts at once and needs about 400 KB of
memory, whatever the size of the file (a 57 MB file used to need
115 MB and several seconds before the first sound). The blocks are
chained with ahir_Link, so there are no gaps.
* ESC or a mouse click stops a WAV, as it always did for 8SVX.
* 8SVX through AHI: stereo samples now play (they used to be silent on
machines without a working audio.device), multi-octave samples play
only the first octave, and LoopPlay really loops.
Pictures
* On an RTG truecolor Workbench still pictures open in a WINDOW: true
colours, no screen switch, scroll bars, keyboard scrolling.
* HAM6 and HAM8 pictures are decoded to RGB and open in the window too.
* 24 and 32 bit ILBMs ("deep" ILBM, no palette) are now supported; they
used to fail with "Error in IFF file".
* Pictures whose width is not a multiple of 64 pixels are no longer
shown skewed.
* The 1992 full screen viewer is still there (Vampire Center, Picture
page) and is still used for animations and special formats.
Vampire Center (new module)
* Machine: board, core revision, clock, chip id, memory, screen and
library versions, read from the Apollo registers.
* Diagnostics: trace on/off/detailed and trace drawer.
* Optimizations: live measurement of the optimizations listed below.
* Audio: 8-bit, tone and three-note tests, and "WAV info" which tells
you what a WAV file contains and whether DOpus can play it.
* Picture: window or own screen for still pictures; IFF decode test.
AgenteIA (new module) and DOpusCmd
* A command bus on the DOPUS.1 port, served inside DOpus' own task:
C:DOpusCmd status | list | select | func | waitidle | closeviewers.
It lets a script or an AI agent (for example Amigent) read the
listers and run DOpus functions without clicking.
* The module saves a ready-made prompt that explains the bus to an AI.
User interface
* Every module uses the same 1992 style requester, measured on the
system font. No MUI anywhere: the old MUI Vampire Center is gone.
* Keyboard shortcuts on the Vampire Center buttons (underlined letter,
taken from the translated label, so they work in every language).
Localisation
* Catalogs for English (built in), Italian, German, Polish and Finnish.
* Four strings that were never translated because of misspelled
catalog names (Execute, Delete, two messages) are translated again.
* New catalog dopus4_vamp.catalog for the new modules (English built in,
Italian included).
OPTIMIZATIONS (measured on a Vampire V4 SA, see the Vampire Center)
-------------
* Drawer reading: ExAll with a 8 KB buffer instead of ~400 bytes
(282 entries: 1.4 ms -> 1.0 ms, 1.4x).
* Name comparison: table driven case folding instead of Stricmp()
(14400 compares: 16.3 ms -> 4.1 ms, 3.9x), Latin-1 aware so that
accented names sort like the international file system does.
* Sorting a drawer: one stable merge sort after reading instead of an
insertion for every entry (120 names: 3.5 ms -> 1.0 ms, 3.5x; the
gain grows with the size of the drawer).
* Planar to chunky conversion for the picture window: 8 pixels at a
time instead of 1 (640x512x8: 1159 ms -> 204 ms, 5.7x).
* WAV streaming: constant memory and immediate start (see above).
All results are checked against the original code: same order, same
pixels, only faster.
BUG FIXES (selection)
---------
* Out of bounds write in the default configuration (morepadding).
* Uninitialised bitmap pointer in the picture loader.
* Possible crash of DOpusCmd and of the modules if DOpus quit while a
message was being sent (FindPort/PutMsg now inside Forbid).
* The bus listed every file as a drawer.
* Ctrl-C was lost while a WAV was playing.
* Memory freed with the wrong size after sorting a drawer.
INSTALLATION
------------
Double click "Install". The Installer copies the program drawer where you
choose, dopus4vamp.library to LIBS:, the catalogs of the languages you
pick to LOCALE:Catalogs/, and optionally DOpusCmd and DOpusRT to C:.
Your configuration (S:DirectoryOpus.CFG) is never touched.
Manual installation: copy the DOpus4Vamp drawer anywhere, copy
Libs/dopus4vamp.library to LIBS:, start DirectoryOpus.
Note: if the "Vampire" entry is missing from the menu bar (or if you use
your own DirectoryOpus.CFG), you can easily add it in ConfigOpus -> Menus
(or Buttons) by assigning the internal command "Vampire" (just like
"AgenteIA").
REQUIREMENTS
------------
* 68020 or better, AmigaOS 3.0 or newer (3.2 recommended).
* ahi.device for WAV and 8SVX playback through AHI.
* Picasso96 and a 15/16/24/32 bit Workbench for pictures in a window
(otherwise the 1992 screen viewer is used).
* The Vampire Center pages Machine and Audio read Apollo/SAGA registers
and say so when they run on other hardware.
Tested on: Vampire V4 Standalone, core 0x310C, AmigaOS 3.2 (Kickstart
47.115), Picasso96, AHI with the Arne driver.
SOURCE AND LICENSE
------------------
Directory Opus 4 is free software under the GNU General Public License
version 2 (see Docs/COPYING). The complete source of this version,
including the build scripts for the GCC 6.5 cross compiler, is available
as DOpus4Vamp-src.lha next to this archive.
Directory Opus, DOpus and Opus are trademarks of GPSoftware. This is an
unofficial, free, GPL derived version, as allowed by the license.
========================================================================
[ITALIANO]
Directory Opus 4 "Vampire Edition"
==================================
Il classico file manager a due pannelli Directory Opus 4.16 (sorgenti GPL
di Jonathan Potter e Jacek Rzeuski), ricompilato con GCC 6.5, ottimizzato
e testato su Vampire V4 Standalone (Apollo 68080, AmigaOS 3.2, SAGA,
Picasso96, AHI). Mantiene l'aspetto e il comportamento del programma del
1992 aggiungendo tutto cio' che serve a un Amiga moderno.
Si installa accanto a qualsiasi altro Opus: usa una propria libreria,
dopus4vamp.library, e non tocca mai dopus.library.
NOVITA' PRINCIPALI
------------------
Audio
* Riproduzione WAV: PCM 8/16/24/32 bit, IEEE float 32/64, A-law, mu-law,
WAVE_FORMAT_EXTENSIBLE e file con piu' di due canali. I WAV compressi
(ADPCM, MP3) vengono rifiutati con un messaggio chiaro nella barra di
stato invece di essere riprodotti come rumore.
* Streaming WAV: la riproduzione parte subito e richiede solo circa
400 KB di memoria, indipendentemente dalla dimensione del file (un
file da 57 MB prima richiedeva 115 MB e diversi secondi di attesa). I
blocchi sono concatenati con ahir_Link senza interruzioni.
* ESC o un clic del mouse fermano il WAV, come per i file 8SVX.
* 8SVX tramite AHI: ora i campioni stereo vengono riprodotti (prima
erano muti su macchine prive di audio.device funzionante), i campioni
multi-ottava riproducono solo la prima ottava e LoopPlay ripete
davvero in ciclo.
Immagini
* Su Workbench RTG truecolor le immagini fisse si aprono in FINESTRA:
colori reali, nessun cambio schermo, barre di scorrimento e supporto
da tastiera.
* Le immagini HAM6 e HAM8 vengono decodificate in RGB e aperte anch'esse
in finestra.
* Supporto per ILBM a 24 e 32 bit ("deep" ILBM senza palette), che in
precedenza davano "Error in IFF file".
* Le immagini con larghezza non multipla di 64 pixel non vengono piu'
visualizzate inclinate/distorte.
* Il visualizzatore a schermo intero del 1992 resta disponibile (pagina
Picture in Vampire Center) ed e' usato per animazioni e formati
speciali.
Vampire Center (nuovo modulo)
* Machine: scheda, revisione core, clock, chip ID, memoria, versioni di
schermo e librerie lette direttamente dai registri Apollo.
* Diagnostics: attivazione/disattivazione trace dettagliato e cartella
di log.
* Optimizations: misurazione in tempo reale delle ottimizzazioni.
* Audio: test 8-bit, tono e tre note, piu' "WAV info" per analizzare il
formato di un file WAV e verificarne la riproducibilita'.
* Picture: scelta tra finestra o schermo dedicato per le immagini fisse;
test di decodifica IFF.
AgenteIA (nuovo modulo) e DOpusCmd
* Bus comandi sulla porta DOPUS.1, gestito nel task stesso di DOpus:
C:DOpusCmd status | list | select | func | waitidle | closeviewers.
Permette a script o agenti AI (es. Amigent) di leggere le liste file
ed eseguire funzioni di DOpus senza cliccare.
* Il modulo salva un prompt pronto all'uso che spiega il bus all'AI.
Interfaccia utente
* Ogni modulo usa i requester in stile 1992, calcolati sul font di
sistema. Nessuna dipendenza da MUI: il vecchio Vampire Center MUI
e' stato rimosso.
* Scorciatoie da tastiera sui pulsanti del Vampire Center (lettera
sottolineata ricavata dalla traduzione, funzionante in ogni lingua).
Localizzazione
* Cataloghi per Inglese (integrato), Italiano, Tedesco, Polacco e
Finlandese.
* Ripristinata la traduzione di quattro stringhe che non venivano mai
tradotte a causa di nomi errati nei cataloghi (Execute, Delete e due
messaggi).
* Nuovo catalogo dopus4_vamp.catalog per i nuovi moduli (Inglese
integrato, Italiano incluso).
OTTIMIZZAZIONI (misurate su Vampire V4 SA, visibili nel Vampire Center)
--------------
* Lettura directory: ExAll con buffer da 8 KB invece di ~400 byte
(282 elementi: 1.4 ms -> 1.0 ms, 1.4x).
* Confronto nomi: case folding tramite tabella invece di Stricmp()
(14400 confronti: 16.3 ms -> 4.1 ms, 3.9x), compatibile Latin-1 per
ordinare correttamente i caratteri accentati.
* Ordinamento directory: un singolo merge sort stabile a fine lettura
invece di un inserimento per ogni voce (120 nomi: 3.5 ms -> 1.0 ms,
3.5x; il guadagno cresce con la dimensione della cartella).
* Conversione Planar-to-Chunky per la finestra immagini: 8 pixel alla
volta invece di 1 (640x512x8: 1159 ms -> 204 ms, 5.7x).
* Streaming WAV: memoria costante e avvio immediato.
CORREZIONI DI BUG (selezione)
-----------------
* Risolta scrittura fuori dai limiti nella configurazione predefinita
(morepadding).
* Risolto puntatore bitmap non inizializzato nel caricatore immagini.
* Evitato possibile crash di DOpusCmd e dei moduli alla chiusura di
DOpus durante l'invio di un messaggio (FindPort/PutMsg ora in Forbid).
* Il bus comandi elencava ogni file come se fosse una directory.
* Ctrl-C veniva perso durante la riproduzione di un file WAV.
* Memoria liberata con dimensione errata dopo l'ordinamento di una
cartella.
INSTALLAZIONE
-------------
Fai doppio clic su "Install". L'Installer copia la cartella del programma
dove preferisci, dopus4vamp.library in LIBS:, i cataloghi delle lingue
scelte in LOCALE:Catalogs/ e, opzionalmente, DOpusCmd e DOpusRT in C:.
La tua configurazione (S:DirectoryOpus.CFG) non viene mai modificata.
Installazione manuale: copia la cartella DOpus4Vamp dove desideri, copia
Libs/dopus4vamp.library in LIBS: e avvia DirectoryOpus.
Nota: se la voce "Vampire" non compare nella barra dei menu (o se usi un
tuo file DirectoryOpus.CFG personale), puoi aggiungerla facilmente da
ConfigOpus -> Menus (o Buttons) associando il comando interno "Vampire"
(proprio come per "AgenteIA").
REQUISITI
---------
* CPU 68020 o superiore, AmigaOS 3.0 o successivo (consigliato 3.2).
* ahi.device per la riproduzione WAV e 8SVX tramite AHI.
* Picasso96 e Workbench a 15/16/24/32 bit per le immagini in finestra
(altrimenti viene usato il visualizzatore a schermo del 1992).
* Le pagine Machine e Audio del Vampire Center leggono i registri
Apollo/SAGA e lo segnalano se eseguite su altro hardware.
Testato su: Vampire V4 Standalone, core 0x310C, AmigaOS 3.2 (Kickstart
47.115), Picasso96, AHI con driver Arne.
SORGENTI E LICENZA
------------------
Directory Opus 4 e' software libero sotto licenza GNU General Public
License versione 2 (vedi Docs/COPYING). I sorgenti completi di questa
versione, inclusi gli script di compilazione per il cross-compilatore
GCC 6.5, sono disponibili nell'archivio DOpus4Vamp-src.lha accanto a
questo pacchetto.
Directory Opus, DOpus e Opus sono marchi registrati di GPSoftware. Questa
e' una versione derivata non ufficiale e libera sotto licenza GPL.
|
aminet net>