OS4 DepotLogo by DaveyD 
(anonymous IP:,2219) 

   Bug tracker
   Locale browser


   o Audio (343)
   o Datatype (51)
   o Demo (203)
   o Development (600)
   o Document (22)
   o Driver (97)
   o Emulation (148)
   o Game (1005)
   o Graphics (499)
   o Library (116)
   o Network (233)
   o Office (66)
   o Utility (927)
   o Video (69)

Total files: 4379

Full index file
Recent index file



Support the site

 Readme for:  Graphics » Convert » ppmtovtx.zip


Description: PPM to Videotex (Teletext/Viewdata)
Download: ppmtovtx.zip       (TIPS: Use the right click menu if your browser takes you back here all the time)
Size: 21kb
Version: 1.4
Date: 22 Jan 2021
Author: Chris Young
Submitter: Chris Young
Email: chris/unsatisfactorysoftware co uk
Homepage: http://www.unsatisfactorysoftware.co.uk/ppmtovtx/
Category: graphics/convert
Replaces: graphics/convert/ppmtovtx.zip
License: Other
Distribute: yes
Min OS Version: 4.0
FileID: 11562
Comments: 0
Snapshots: 0
Videos: 0
Downloads: 58  (Current version)
315  (Accumulated)
Votes: 0 (0/0)  (30 days/7 days)

Show comments Show snapshots Show videos Show content Show crashlogs Replace file 
ppmtovtx converts pictures into Videotex (CEPT-3) format.  The Videotex format
is shared with Teletext (Level 1) services such as Ceefax, and Viewdata
services such as Prestel or Minitel.

A Videotex frame is made up of 24 rows of 40 characters.  These characters can
be either printable ASCII characters, mosaic graphics or formatting commands.
The format allows for 8 colours including black, and a graphics resolution of
80x72.  Typically the first row on a Videotex service is a header row showing
the page number and service name, so the actual useable height is reduced to
23 rows, or 69 mosaic pixels.

ppmtovtx expects binary PPM files with a width of 80 pixels.  The height can
be anything up to 72 pixels, and should be divisible by three.  The behaviour
of the program in other cases is undocumented.  You can scale pictures to this
size using the following command:

pnmscale -xsize 80 -ysize 72 picture.ppm >scaledpicture.ppm

Where "picture.ppm" is the name of the original file, and "scaledpicture.ppm"
is the destination (NB: the ">" is required).  pnmscale and tools to convert
to and from PPM format files are available in the NetPBM package. (NetPBM is
available from http://netpbm.sourceforge.net and an Amiga port is on Aminet)

You can then convert this into a Videotex frame using:

ppmtovtx scaledpicture.ppm scaledpicture.bin

Where "scaledpicture.ppm" is the input file, and "scaledpicture.bin" is the
output file in raw data format.

There are more options for ppmtocept3:

ppmtovtx <input file> <output file> [options [threshold]]

The output filename should end in ".vtx" for an ESC coded file, ".tti" for a
TTI format file and anything else for raw binary.  The ESC coded files (which
I call .vtx format) can be loaded by PstView amongst others, but .bin format
is more widely used.

Options are one or more of {SHADNKRGYBMCW} (case sensitive), as follows:

S - Separate mode
    Separates the mosaic graphics pixels.

H - Held graphics mode
    During colour changes the block with the colour change will be a
    duplicate of the previous block.  Probably not very useful.

A - Automatic background colour changes
    Changes the background colour to improve the colour resolution of the

D - Disable black foreground
    Prevents ppmtovtx using the code for black foreground colour (more
    Only works with "A" mode enabled.

N - No colour
    Monochrome mode, foreground colour is set to white

K - Black background (default)
R - Red background
G - Green background
Y - Yellow background
B - Blue background
M - Magenta background
C - Cyan background
W - White background

It makes no sense to specify more than one of {AKRGYBMCW}.  Later colours
override earlier ones, and in conjunction with A at most only the start of the
first row will be of the specified colour.


1.4 (23.11.2020)
* Fix segfault
* Add TTI format output
* Add monochrome mode

1.3 (01.08.2002)
* Changes for OS4

1.2 (23.03.2002)
* Added an option to prevent ppmtovtx inserting a code for black foreground
  Black foreground is not officially supported.  ppmtovtx will use a workaround

* Defaulted output to use .bin format if an extension was not recognised, rather
than .vtx

1.1 (16.03.2002)
* Fixed a bug where full foreground colour blocks would sometimes be in the
  background colour

* Fixed another bug which caused some of the picture to be in the background
  thus not being visible.

1.0 (07.01.2002)
* First release

Additional notes for included executables:

AmigaOS 4
Copy the file Amiga/ppmtovtx to somewhere in your path (eg. SYS:C)
You should increase the stack before running this program (issue the
command "STACK 50000")

Raspberry Pi
Built for Raspberry Pi OS 32-bit

These executable files and source code (in ANSI C) can be freely distributed
provided no money changes hands (excluding reasonable costs for media or
delivery) and the author is acknowledged and this .readme file is included with
the distribution.  The executable MUST NOT be distributed without the source
code, although it is permitted to distribute the source code without any
binaries.  Modified binaries and source code MUST NOT be distributed without
reasonable contact details for the person who modified them (eg email address).
The author does not accept any responsibility for loss of data or other events
arising from the use of this software.  All use is at your own risk.  Any
made by third parties are their responsibility and not that of the original
The original author retains copyright for the original source and any binary
created using that source code.  Although unlikely, permission to distribute or
use this source code or a resulting executable can be revoked at any time and
without warning.  This licence covers both commercial and non-commercial use. 
you do not agree with these terms you must immediately delete this software

-- Chris Young, 13th January 2002

Copyright © 2004-2024 by Björn Hagström All Rights Reserved