English first, dutch follows


CNVS version 2.3
-----------------

A DOS program to convert MSX screen dumps to or from PCX format
Runs on a PC with MS-DOS or in a Windows DOS box. 

Commandline syntax:

CNVS <picturefile> <type> [INVERS]

<picturefile> is any graphics file with the extension:

MSX screen dumps made with BSAVE command

SC5
SC6
SC7
SC8
SCC

MSX screen dumps made with COPY command

CC5
CC6
CC7
CC8
Dynamic publisher stempels

STP

DEC LN03 format

SIXEL

PC format Zsoft Paintbrush

PCX   (limited to 256 colors)
PCT

Type is any of the extensions above and is used to create the output file.
The name of the output file is <inputfilename>.<extension>

Example:

C:> CNVS TEST.PCX SC8

will convert the file TEST.PCX to the file TEST.SC8.

The result file can be read in on the MSX with the command

10 screen 8
20 BLOAD "TEST.SC8",S

Palette files

For output to MSX screen other than screen 8 also a palette file is created
that can be used as follows:
40 BLOAD "plaatje.pl7",s
50 COLOR = RESTORE
60 BLOAD "plaatje.SC7",S

For input from MSX screens the palette file with the same name but extension
LS* (* is screen number ) will be used if it exists, otherwise the default MSX 
palette colors are used in the conversion.

Create palette files on MSX as follows in MSX Basic:

screen 5
  
  BSAVE "filenaam",&H7680,&H769F,S   

screen 7

  BSAVE "filenaam",&HFA80,&HFA9F,S

Create Bsave files as follows in MSX Basic

screen 5 and 6:

BSAVE "filenaam.sc*",0,&H69FF,S

Screen 7, 8, 12

BSAVE "filenaam.sc*",0,&HD3FF,S


Restrictions:

Only graphic formats limited to 256 colors can be used as input.
The screen 12 conversion is limited to grey colors.
For advanced fullcolor conversion for screen 12 the programs 
MSX12CNV and MSXCNV12 are available from me.

Options:

If a monochrome file is converted a third optional parameter INVERS
can be used to reverse black and white.


Copyright: This program is donated to the MSX community.
Do whatever you like with this program and his sources. It is up to you.
You will need Borland Turbo Pascal 5.5 or 6.
The main program is CNVS.PAS, the rest are units. Do a build.

                       CNVS

         Conversie grafische formaten MSX en PC

                      Versie 2.3

           (c) Hans Otten 1991,1999


0. Doel van het programma
=========================

Er zijn vele MSX formaten en vrijwel geen programma's
om deze formaten te gebruiken op de PC.
En in de PC wereld zijn vele afbeeldingen te verkrijgen
die op de MSX niet zijn te gebruiken.
Het doel van dit programma is een brug tussen MSX en PC
te slaan. Conversie van en naar PC formaten en vrijwel alle
MSX formaten is mogelijk.

Het PCX formaat is gekozen op de PC omdat dit formaat veel 
wordt gebruikt in bijvoorbeeld MS-Windows en Desktop Publishing,
redelijk eenvoudig en snel te bewerken is en gemakkelijk weer
met andere converters (GWS, Paintshop PRO) om te zetten is naar 
andere PC formaten zoals GIF.


Inhoudsopgave:

0. Doel van het programma
1. Versies
2. Ondersteunde formaten 
3. Ondersteunde hardware
4. Omzetten van en naar andere PC formaten
5. Installatie
6. Super-VGA
7. Gebruik
8. Palette files
9. Loader files
10. Default extensies
11. Palette beperkingen 
12. MSX Scherm 12
13. Dynamic Publisher PC en MSX
14. Copyright en verkrijgen GWS

1. Versies
==========

Versie 1
--------

Versie 1 is de eerste versie die public domain is. 
Zowel aan het programma als aan de documentatie is nog
wel het een en ander te verbeteren.

Versie 1.1 
----------

Versie 1.1 is de release met bugfixes en een nederlandse
interface. Alleen verspreid aan degenen die de bugs
hebben aangemeld.

Versie 2.0
----------

Versie 2 is van nederlandstalige tekst worden voorzien.
In deze versie is de conversie van PCX naar MSX2+ scherm 12
toegevoegd en de mogelijkheid om scherm 12 plaatjes met
een ruwe benadering te bekijken op een PC. 
Conversie van scherm 12 naar PCX is dermate anders en lastig dan
de conversie die CNVS biedt dat daar een ander programma
voor is geschreven: MSX12CNV. 

Versie 2.1
----------

Verschillende bugfixes: - verbeterde monochrome PCX file creatie
                        - automatisch superVGA formaat keuze
                        - support voor Dynamic Publisher op PC
                          door betere documentatie

Versie 2.2
----------

Ook deze versie zal weer de ongetwijfeld noodzakelijke 
bugfixes bevatten. Stuur uw suggesties en bugs svp
naar me toe (zie het eind van dit bestand).

Versie 2.3
----------

Verbeterd:

- Engelse user interface
- andere syntax: volledig commando regel gestuurd, geen prompts meer
- minder meldingen (PC's zijn nu zo snel geworden dat statusinfo  zinloos is


2. Ondersteunde formaten
========================

MSX formaten die als in- en uitvoer worden ondersteund zijn:

 - scherm 5, 6, 7, 8 
                        (gemaakt met bijvoorbeeld het basic commando
                         BLOAD of Videographics)
 - copy 5, 6, 7 en 8   (gemaakt met het basic commando COPY)
 - stempels            (met Dynamic Publisher etc te verwerken)

MSX formaten die als invoer worden ondersteund:

  - Dynamic Publisher pictures op MSX aangemaakt 

MSX formaten die als uitvoer naar PCX in grijs worden ondersteund:

  - scherm 12
  

PC formaten die als in- en uitvoer worden ondersteund:

  - PCX en PCC (PC Paintbrush, MS-Windows V3.0 Paintbrush)
    in monochroom, EGA kleuren (16) en VGA palette (256 kleuren) formaten

Printer formaten voor in- en uitvoer ondersteund:

  - sixel (zoals geaccepteerd door printers van 
           Digital Equipment BV -- DEC --)
    in monochroom en kleuren formaten


3. Ondersteunde hardware
========================

Het programma draait op elke PC onder MS-DOS 3.3 of hoger.
Een grafische kaart (Hercules, CGA, EGA of (super-)VGA
-- monochroom of in kleur--) is handig om de plaatjes
te bekijken maar niet vereist.
Alleen onder (super-)VGA wordt kleur op het scherm ondersteund,
op de andere grafische kaarten wordt een benadering in zwart-wit
gegeven. De conversie zelf is onafhankelijk van de grafische kaart. 

4. Omzetten van en naar andere PC formaten
==========================================

Er zijn vele commerciele, public domain en shareware conversie
programma's beschikbaar die van en naar PCX formaat kunnen
converteren. Een uitstekend shareware programma wat ook kan
vergroten en verkleinen is Graphics Workstation Software (GWS).
Dit programma kan PCX omzetten van en naar onder andere GIF,
TIFF, BMP etc.


5. Installatie
==============

Het programma bestaat uit meerdere bestanden:

  READ.ME    (copyright)
  CNVS.EXE   (programma)
  CNVS.DOC   (deze documentatie)
  AUTO.BAS   (menu gestuurd plaatjes bekijken)
  EGAVGA.BGI (grafische drivers)
  CGA.BGI            "
  HERC.BGI           " 
  VGA256.BGI         "
  SVGA256.BGI        "

Plaats deze bestanden of in de directory waar de plaatjes staan
of (beter) op een via het PATH bereikbare plaats op de schijf.
Het programma is dan gereed voor gebruik. Niet alle BGI files
zijn nodig, de naam geeft al aan welke grafische kaart welke BGI
file vereist. Het programma detecteert automatisch het type van
de grafische kaart. Voor VGA zijn zowel EGAVGA als VGA256 nodig.
Voor super-VGA is alleen SVGA256 nodig.

6. Super-VGA
============

Als een super-VGA kaart beschikbaar is kunnen de hogere resoluties
met 256 kleuren worden ondersteund. Daartoe is een environment
variabele nodig. Neem bv in de AUTOEXEC.BAT het commando op:

  SET SVGA=*

waarbij *  is 1 voor 640x400
              2 voor 640x480
              3 voor 800x600
              4 voor 1024x768 Tseng 4000, Trident 8900 and Ahead Video

Ondersteunde types:
  Ahead, ATI, Chips & Tech, Everex, Paradise, Trident, Tseng, VESA

Controleer welke bovengenoemde resoluties door de kaart worden
ondersteund, 640x400 wordt altijd ondersteund door super-VGA.

Als wordt gekozen voor weergave op het scherm dan wordt de beste
resolutie mogelijkheid automatisch gekozen met zoveel mogelijk
alle kleuren getoond. Het opbouwen van het plaatje op het scherm kan
door een willekeurige toetsindruk worden onderbroken. Als het plaatje
volledig is getoond (met de beperkingen van de grafische kaart)
wordt een  piep gegenereerd. Druk dan een toets in om door te gaan.  

7. Gebruik
==========

Het programnma wordt geaktiveerd door het commando:

  CNVS  <file-naam> <type>

waarbij de optionele filenaam de naam van een bestand met een plaatje is.

Bijvoorbeeld:

  CNVS plaatje.stp PCX

De filenaam mag worden voorafgegaan door een path, bijvoorbeeld:

  CNVS D:\pictures\plaatje.pic

Bij MSX scherm en COPY 5 en 7 wordt om de naam van een optionele
palette file (zie verder) afgeleid van het type 
van de extensie (bijvoorbeeld SC8 of PIC voor scherm 8, zie de paragraaf
extensies)

Als het plaatje is gevonden wordt het onderzocht op aantal gebruikte
kleuren en de afmetingen. De regel wordt als teller getoond. Deze
eerste gang door het plaatje kan door een willekeurige toetsindruk
worden onderbroken. De informatie over kleuren kan dan onvolledig zijn!

Deze informatie wordt dan getoond en de
vraag gesteld naar welk formaat de conversie moet plaatsvinden.

Gekozen kan worden voor:

   - SC* of CC*
     waarbij * is 5, 6, 7, 8 of C(scherm 12) voor scherm, respectievelijk COPY
   - STP 
     voor Dynamic Publisher stempels
   - PCT
     voor Dynamic Publisher schermen
   - PCX 
     voor Paintbrush formaat
   - SIXEL
     voor Digital Equipment BV -- DEC -- printer formaat
   - SCREEN
     om het plaatje te kunnen bekijken


Bij sommige uitvoerformaten kan meer info worden gegeven. 
Een monochrome afbeelding kan bijvoorbeeld geinverteerd worden
door als derde argument INVERS op te geven.

Voor sixel files kan worden gekozen voor LN03 en LA75 (converie
naar monochroom) of LJ250 (kleuren sixel printer formaat) of 
none (alle informatie). Verder kan bij sixel uitvoer voor horizontale
en/of verticale vergroting worden gezorgd. Door eerst naar sixel en
vervolgens naar een ander formaat te converteren is een eenvoudige
bewerking zoals vergroten of tot zwart-wit omvormen mogelijk.

Voor MSX scherm en COPY, 5 en 7 kan een palette file worden geproduceerd
om een betere benadering van de kleuren te krijgen. Zie de beschrijving
bij loader files.

8. Palette files
================

Een palette file kan op MSX worden verkregen door het commando:

voor scherm 5
  
  BSAVE "filenaam",&H7680,&H769F,S   

voor scherm 7

  BSAVE "filenaam",&HFA80,&HFA9F,S

Palette files krijgen bij voorkeur de naam van het plaatje en
de extensie 

   PL* waarbij * is 5 of 7.

Zie default extensies en Loader files beschrijving.

9. Loader files
===============

Als een MSX formaat wordt gekozen wordt automatisch een simpele 
basic loader aangemaakt. De bestandsnaam is gelijk aan die
van het plaatje, de extensie is van de vorm:

  Lxy  waarbij x = C of S voor COPY of scherm formaat
               y = 5, 6, 7 of voor het MSX scherm type

Een voorbeeld van een loader file voor een scherm 7 plaatje
met palette:

10 SCREEN 7
20 VDP(9) = VDP(9) OR 32
30 COLOR ,0,0 : CLS
40 BLOAD "plaatje.pl7",s
50 COLOR = RESTORE
60 BLOAD "plaatje.SC7",S
70 IF INKEY$ = "" THEN 70
80 SCREEN 0 : END

Regel 20 dient om kleur 0 als gewone en niet als transparante kleur
te kunnen gebruiken. In regel 40 wordt de palette file ingelezen
en in regel 60 het plaatje zelf. 
  
Een basic programma dat als AUTOEXEC.BAS kan dienen en
een menukeuze uit beschikbare plaatjes biedt is als AUTO.BAS
in het archief opgenomen.

10. Default extensies
=====================

Het programma herkent en genereert de volgende default extensies:

SC5 voor MSX scherm 5
SC6 voor MSX scherm 6
SC7 voor MSX scherm 7
SC8 voor MSX scherm 8
SCC voor MSX scherm 12
PIC voor MSX scherm 8
CC5 voor MSX COPY 5
CC6 voor MSX COPY 6
CC7 voor MSX COPY 7
CC8 voor MSX COPY 8

STP voor Dynamic Publisher MSX stempels
PCT voor Dynamic Publisher MSX schermen

PCX voor PC Paintbrush formaat 
PCC voor PC Paintbrush formaat 

PL5 voor palette file scherm 5
PL7 voor palette file scherm 7

LS5 voor basic loader scherm 5
LS6 voor basic loader scherm 6
LS7 voor basic loader scherm 7
LS8 voor basic laoder scherm 8
LC5 voor basic loader COPY 5 
LC6 voor basic loader COPY 6
LC7 voor basic loader COPY 7
LC8 voor basic laoder COPY 8

SXL voor sixel files
SLS voor sixel files
SIX voor sixel files

11. Palette beperkingen
=======================

Intern werkt het programma met maximaal 256 kleuren. Voor elke 
kleur wordt een palette van 24 bit bijgehouden (in RGB formaat 3x8 bit).

Alleen in PCX files wordt alle kleurinformatie volledig bewaard in palette formaat!

Let op dat MSX formaten nogal beperkt zijn in kleurweergave. Zelfs 
scherm 8 met 256 kleuren is beperkt door het vaste palette. Een
conversie van een GIF (bijvoorbeeld via GWS naar PCX tussenstap) 
plaatje kan daarom teleurstellende resultaten op MSX geven.

Een overzicht van MSX schermen:

scherm 5  16 kleuren met 3x4 bits RGB palette resolutie 256x212 
scherm 6   4 kleuren met 3x4 bits RGB palette resolutie 512x212
scherm 7  16 kleuren met 3x4 bits RGB palette resolutie 512x212
scherm 8  256 vaste kleuren                   resolutie 256x212
scherm 12 kleuren vrij (niet helemaal)        resolutie 256x212

Bij conversie wordt zoveel mogelijk geprobeerd de kleuren te behouden.
Als het aantal beschikbare kleuren of het aantal mogelijkheden in het
palette beperkt is wordt de best mogelijke benadering gekozen (tot
zwart-wit voor stempels met instelbaar contrast).

12. MSX Scherm 12
=============

Met scherm 12 zijn de fraaiste resultaten te bereiken als het 
naar scherm 12 om te zetten plaatje veel kleuren en veel
vloeiende overgangen bevat, met name gedigitaliseerde foto's.
Scherm 12 is vanwege de beperkingen (vier pixels met dezelfde grondkleur)
nauwelijks geschikt om plaatjes met scherpe overgangen 
(tekenwerk) te tonen. Scherm 5 en 7 doen het dan veel beter.

Gebruiik de programma;s CNVMSX12 en CNV12MSX voor conversie van true color PCX 
naar en van  full color scherm 12.


13. Dynamic Publisher PC en MSX
===============================

Van het pakket Dynamic Publisher van Radarsoft is naast een
MSX versie (ook Euro Publisher wordt ondersteund!) ook een PC
versie. Stempels in MSX formaat zijn anders opgebouwd dan stempels 
in PC formaat. Ga als volgt te werk om een MSX stempel te kunnen
gebruiken in DP op de PC:

1. Converteer de MSX stempel met CNVS naar PCX formaat.
2. Gebruik GWS om de PCX stempel om te zetten naar IFF/LBM formaat.
3. Laad in DP op de PC het .LBM plaatje en maak er een stempel van
   zoals in de handleiding van DP is beschreven.

DP op de PC behandelt PCX (Paintbrush bestanden) formaat niet
goed, vandaar de omzetting naar IFF formaat.
Een volgende versie van CNVS zal rechtstreekse conversie van
MSX stempel naar PC stempel en omgekeerd ondersteunen.

14. Copyright
=============
Dit programma is ontwikkeld door:

Hans Otten

Dit programma mag vrij worden verspreid en gebruikt
Commercieel gebruik is zonder schriftelijke toestenming van de 
auteur niet toegestaan.


