git.sur5r.net Git - cc65/blob - src/chrcvt65/main.c

   1 /*****************************************************************************/
   2 /*                                                                           */
   3 /*                                  main.c                                   */
   4 /*                                                                           */
   5 /*            Main program of the chrcvt65 vector font converter             */
   6 /*                                                                           */
   7 /*                                                                           */
   8 /*                                                                           */
   9 /* (C) 2000-2011, Ullrich von Bassewitz                                      */
  10 /*                Roemerstrasse 52                                           */
  11 /*                D-70794 Filderstadt                                        */
  12 /* EMail:         uz@cc65.org                                                */
  13 /*                                                                           */
  14 /*                                                                           */
  15 /* This software is provided 'as-is', without any expressed or implied       */
  16 /* warranty.  In no event will the authors be held liable for any damages    */
  17 /* arising from the use of this software.                                    */
  18 /*                                                                           */
  19 /* Permission is granted to anyone to use this software for any purpose,     */
  20 /* including commercial applications, and to alter it and redistribute it    */
  21 /* freely, subject to the following restrictions:                            */
  22 /*                                                                           */
  23 /* 1. The origin of this software must not be misrepresented; you must not   */
  24 /*    claim that you wrote the original software. If you use this software   */
  25 /*    in a product, an acknowledgment in the product documentation would be  */
  26 /*    appreciated but is not required.                                       */
  27 /* 2. Altered source versions must be plainly marked as such, and must not   */
  28 /*    be misrepresented as being the original software.                      */
  29 /* 3. This notice may not be removed or altered from any source              */
  30 /*    distribution.                                                          */
  31 /*                                                                           */
  32 /*****************************************************************************/
  33
  34
  35
  36 #include <stdio.h>
  37 #include <stdlib.h>
  38 #include <string.h>
  39 #include <errno.h>
  40
  41 /* common */
  42 #include "cmdline.h"
  43 #include "fname.h"
  44 #include "print.h"
  45 #include "strbuf.h"
  46 #include "xmalloc.h"
  47 #include "version.h"
  48
  49 /* chrcvt65 */
  50 #include "error.h"
  51
  52
  53
  54 /*
  55 ** The following is a corrected doc from the BGI font editor toolkit:
  56 **
  57 **                      BGI Stroke File Format
  58 **
  59 ** The structure of Borland .CHR (stroke) files is as follows:
  60 **
  61 ** ;  offset 0h is a Borland header:
  62 ** ;
  63 **         HeaderSize      equ     080h
  64 **         DataSize        equ     (size of font file)
  65 **         descr           equ     "Triplex font"
  66 **         fname           equ     "TRIP"
  67 **         MajorVersion    equ     1
  68 **         MinorVersion    equ     0
  69 **
  70 **         db      'PK',8,8
  71 **         db      'BGI ',descr,'  V'
  72 **         db      MajorVersion+'0'
  73 **         db      (MinorVersion / 10)+'0',(MinorVersion mod 10)+'0'
  74 **         db      ' - 19 October 1987',0DH,0AH
  75 **         db      'Copyright (c) 1987 Borland International', 0dh,0ah
  76 **         db      0,1ah                           ; null & ctrl-Z = end
  77 **
  78 **         dw      HeaderSize                      ; size of header
  79 **         db      fname                           ; font name
  80 **         dw      DataSize                        ; font file size
  81 **         db      MajorVersion,MinorVersion       ; version #'s
  82 **         db      1,0                             ; minimal version #'s
  83 **
  84 **         db      (HeaderSize - $) DUP (0)        ; pad out to header size
  85 **
  86 ** At offset 80h starts data for the file:
  87 **
  88 ** ;               80h     '+'  flags stroke file type
  89 ** ;               81h-82h  number chars in font file (n)
  90 ** ;               83h      undefined
  91 ** ;               84h      ASCII value of first char in file
  92 ** ;               85h-86h  offset to stroke definitions (8+3n)
  93 ** ;               87h      scan flag (normally 0)
  94 ** ;               88h      distance from origin to top of capital
  95 ** ;               89h      distance from origin to baseline
  96 ** ;               8Ah      distance from origin to bottom descender
  97 ** ;               8Bh-8Fh  undefined
  98 ** ;               90h      offsets to individual character definitions
  99 ** ;               90h+2n   width table (one word per character)
 100 ** ;               90h+3n   start of character definitions
 101 ** ;
 102 ** The individual character definitions consist of a variable number of words
 103 ** describing the operations required to render a character. Each word
 104 ** consists of an (x,y) coordinate pair and a two-bit opcode, encoded as shown
 105 ** here:
 106 **
 107 ** Byte 1          7   6   5   4   3   2   1   0     bit #
 108 **                op1  <seven bit signed X coord>
 109 **
 110 ** Byte 2          7   6   5   4   3   2   1   0     bit #
 111 **                op2  <seven bit signed Y coord>
 112 **
 113 **
 114 **           Opcodes
 115 **
 116 **         op1=0  op2=0  End of character definition.
 117 **         op1=1  op2=0  Move the pointer to (x,y)
 118 **         op1=1  op2=1  Draw from current pointer to (x,y)
 119 */
 120
 121
 122
 123 /* The target file format is designed to be read by a cc65 compiled program
 124 ** more easily. It should not be necessary to load the whole file into a
 125 ** buffer to parse it, or seek within the file. Also using less memory if
 126 ** possible would be fine. Therefore we use the following structure:
 127 **
 128 ** Header portion:
 129 **      .byte   $54, $43, $48, $00              ; "TCH" version
 130 **      .word   <size of data portion>
 131 ** Data portion:
 132 **      .byte   <top>                           ; Baseline to top
 133 **      .byte   <bottom>                        ; Baseline to bottom
 134 **      .byte   <height>                        ; Maximum char height
 135 **      .byte   <width>, ...                    ; $5F width bytes
 136 **      .word   <char definition offset>, ...   ; $5F char def offsets
 137 ** Character definitions:
 138 **      .word   <converted opcode>, ...
 139 **      .byte   $80
 140 **
 141 ** The baseline of the character is assume to be at position zero. top and
 142 ** bottom are both positive values. The former extends in positive, the other
 143 ** in negative direction of the baseline. height contains the sum of top and
 144 ** bottom and is stored here just for easier handling.
 145 **
 146 ** The opcodes get converted for easier handling: END is marked by bit 7
 147 ** set in the first byte. The second byte of this opcode is not needed.
 148 ** Bit 7 of the second byte marks a MOVE (bit 7 = 0) or DRAW (bit 7 = 1).
 149 **
 150 ** The number of characters is fixed to $20..$7E (space to tilde), so character
 151 ** widths and offsets can be stored in fixed size preallocated tables. The
 152 ** space for the character definitions is allocated on the heap, it's size
 153 ** is stored in the header.
 154 **
 155 ** Above structure allows a program to read the header portion of the file,
 156 ** validate it, then read the remainder of the file into memory in one chunk.
 157 ** The character definition offsets will then be converted into pointers by
 158 ** adding the character definition base pointer to each.
 159 */
 160
 161
 162
 163 /*****************************************************************************/
 164 /*                                   Data                                    */
 165 /*****************************************************************************/
 166
 167
 168
 169 static unsigned FilesProcessed = 0;
 170
 171
 172
 173 /*****************************************************************************/
 174 /*                                   Code                                    */
 175 /*****************************************************************************/
 176
 177
 178
 179 static void Usage (void)
 180 /* Print usage information and exit */
 181 {
 182     fprintf (stderr,
 183              "Usage: %s [options] file [options] [file]\n"
 184              "Short options:\n"
 185              "  -h\t\t\tHelp (this text)\n"
 186              "  -v\t\t\tBe more verbose\n"
 187              "  -V\t\t\tPrint the version number and exit\n"
 188              "\n"
 189              "Long options:\n"
 190              "  --help\t\tHelp (this text)\n"
 191              "  --verbose\t\tBe more verbose\n"
 192              "  --version\t\tPrint the version number and exit\n",
 193              ProgName);
 194 }
 195
 196
 197
 198 static void OptHelp (const char* Opt attribute ((unused)),
 199                      const char* Arg attribute ((unused)))
 200 /* Print usage information and exit */
 201 {
 202     Usage ();
 203     exit (EXIT_SUCCESS);
 204 }
 205
 206
 207
 208 static void OptVerbose (const char* Opt attribute ((unused)),
 209                         const char* Arg attribute ((unused)))
 210 /* Increase verbosity */
 211 {
 212     ++Verbosity;
 213 }
 214
 215
 216
 217 static void OptVersion (const char* Opt attribute ((unused)),
 218                         const char* Arg attribute ((unused)))
 219 /* Print the assembler version */
 220 {
 221     fprintf (stderr,
 222              "%s V%s\n", ProgName, GetVersionAsString ());
 223 }
 224
 225
 226
 227 static void ConvertChar (StrBuf* Data, const unsigned char* Buf, int Remaining)
 228 /* Convert data for one character. Original data is in Buf, converted data
 229 ** will be placed in Data.
 230 */
 231 {
 232     /* Convert all drawing vectors for this character */
 233     while (1) {
 234
 235         unsigned Op;
 236
 237         /* Check if we have enough data left */
 238         if (Remaining < 2) {
 239             Error ("End of file while parsing character definitions");
 240         }
 241
 242         /* Get the next op word */
 243         Op = (Buf[0] + (Buf[1] << 8)) & 0x8080;
 244
 245         /* Check the opcode */
 246         switch (Op) {
 247
 248             case 0x0000:
 249                 /* End */
 250                 if (SB_IsEmpty (Data)) {
 251                     /* No ops. We need to add an empty one */
 252                     SB_AppendChar (Data, 0x00);
 253                     SB_AppendChar (Data, 0x00);
 254                 }
 255                 /* Add an end marker to the last op in the buffer */
 256                 SB_GetBuf (Data)[SB_GetLen (Data) - 2] |= 0x80;
 257                 return;
 258
 259             case 0x0080:
 260                 /* Move */
 261                 SB_AppendChar (Data, Buf[0] & 0x7F);
 262                 SB_AppendChar (Data, Buf[1] & 0x7F);
 263                 break;
 264
 265             case 0x8000:
 266                 /* Invalid opcode */
 267                 Error ("Input file contains invalid opcode 0x8000");
 268                 break;
 269
 270             case 0x8080:
 271                 /* Draw */
 272                 SB_AppendChar (Data, Buf[0] & 0x7F);
 273                 SB_AppendChar (Data, Buf[1] | 0x80);
 274                 break;
 275         }
 276
 277         /* Next Op */
 278         Buf += 2;
 279         Remaining -= 2;
 280     }
 281 }
 282
 283
 284
 285 static void ConvertFile (const char* Input, const char* Output)
 286 /* Convert one vector font file */
 287 {
 288     /* The header of a BGI vector font file */
 289     static const unsigned char ChrHeader[] = {
 290         /* According to the Borland docs, the following should work, but it
 291         ** doesn't. Seems like there are fonts that work, but don't have the
 292         ** "BGI" string in the header. So we use just the PK\b\b mark as
 293         ** a header.
 294         **
 295         ** 0x50, 0x4B, 0x08, 0x08, 0x42, 0x47, 0x49, 0x20
 296         */
 297         0x50, 0x4B, 0x08, 0x08
 298     };
 299
 300     /* The header of a TGI vector font file */
 301     unsigned char TchHeader[] = {
 302         0x54, 0x43, 0x48, 0x00,         /* "TCH" version */
 303         0x00, 0x00,                     /* size of char definitions */
 304         0x00,                           /* Top */
 305         0x00,                           /* Baseline */
 306         0x00,                           /* Bottom */
 307     };
 308
 309     long           Size;
 310     unsigned char* Buf;
 311     unsigned char* MsgEnd;
 312     unsigned       FirstChar;
 313     unsigned       CharCount;
 314     unsigned       LastChar;
 315     unsigned       Char;
 316     unsigned       Offs;
 317     const unsigned char* OffsetBuf;
 318     const unsigned char* WidthBuf;
 319     const unsigned char* VectorBuf;
 320     StrBuf         Offsets  = AUTO_STRBUF_INITIALIZER;
 321     StrBuf         VectorData = AUTO_STRBUF_INITIALIZER;
 322
 323
 324     /* Try to open the file for reading */
 325     FILE* F = fopen (Input, "rb");
 326     if (F == 0) {
 327         Error ("Cannot open input file `%s': %s", Input, strerror (errno));
 328     }
 329
 330     /* Seek to the end and determine the size */
 331     fseek (F, 0, SEEK_END);
 332     Size = ftell (F);
 333
 334     /* Seek back to the start of the file */
 335     fseek (F, 0, SEEK_SET);
 336
 337     /* Check if the size is reasonable */
 338     if (Size > 32*1024) {
 339         Error ("Input file `%s' is too large (max = 32k)", Input);
 340     } else if (Size < 0x100) {
 341         Error ("Input file `%s' is too small to be a vector font file", Input);
 342     }
 343
 344     /* Allocate memory for the file */
 345     Buf = xmalloc ((size_t) Size);
 346
 347     /* Read the file contents into the buffer */
 348     if (fread (Buf, 1, (size_t) Size, F) != (size_t) Size) {
 349         Error ("Error reading from input file `%s'", Input);
 350     }
 351
 352     /* Close the file */
 353     (void) fclose (F);
 354
 355     /* Verify the header */
 356     if (memcmp (Buf, ChrHeader, sizeof (ChrHeader)) != 0) {
 357         Error ("Invalid format for `%s': invalid header", Input);
 358     }
 359     MsgEnd = memchr (Buf + sizeof (ChrHeader), 0x1A, 0x80);
 360     if (MsgEnd == 0) {
 361         Error ("Invalid format for `%s': description not found", Input);
 362     }
 363     if (MsgEnd[1] != 0x80 || MsgEnd[2] != 0x00) {
 364         Error ("Invalid format for `%s': wrong header size", Input);
 365     }
 366
 367     /* We expect the file to hold chars from 0x20 (space) to 0x7E (tilde) */
 368     FirstChar = Buf[0x84];
 369     CharCount = Buf[0x81] + (Buf[0x82] << 8);
 370     LastChar  = FirstChar + CharCount - 1;
 371     if (FirstChar > 0x20 || LastChar < 0x7E) {
 372         Print (stderr, 1, "FirstChar = $%04X, CharCount = %u\n",
 373                FirstChar, CharCount);
 374         Error ("File `%s' doesn't contain the chars we need", Input);
 375     } else if (LastChar >= 0x100) {
 376         Error ("File `%s' contains too many character definitions", Input);
 377     }
 378
 379     /* Print the copyright from the header */
 380     Print (stderr, 1, "%.*s\n", (int) (MsgEnd - Buf - 4), Buf+4);
 381
 382     /* Get pointers to the width table, the offset table and the vector data
 383     ** table. The first two corrected for 0x20 as first entry.
 384     */
 385     OffsetBuf = Buf + 0x90 + ((0x20 - FirstChar) * 2);
 386     WidthBuf  = Buf + 0x90 + (CharCount * 2) + (0x20 - FirstChar);
 387     VectorBuf = Buf + 0x90 + (CharCount * 3);
 388
 389     /* Convert the characters */
 390     for (Char = 0x20; Char <= 0x7E; ++Char, OffsetBuf += 2) {
 391
 392         int Remaining;
 393
 394         /* Add the offset to the offset table */
 395         Offs = SB_GetLen (&VectorData);
 396         SB_AppendChar (&Offsets, Offs & 0xFF);
 397         SB_AppendChar (&Offsets, (Offs >> 8) & 0xFF);
 398
 399         /* Get the offset of the vector data in the BGI data buffer */
 400         Offs = OffsetBuf[0] + (OffsetBuf[1] << 8);
 401
 402         /* Calculate the remaining data in the buffer for this character */
 403         Remaining = Size - (Offs + (VectorBuf - Buf));
 404
 405         /* Check if the offset is valid */
 406         if (Remaining <= 0) {
 407             Error ("Invalid data offset in input file `%s'", Input);
 408         }
 409
 410         /* Convert the vector data and place it into the buffer */
 411         ConvertChar (&VectorData, VectorBuf + Offs, Remaining);
 412     }
 413
 414     /* Complete the TCH header */
 415     Offs = 3 + 0x5F + 2*0x5F + SB_GetLen (&VectorData);
 416     TchHeader[4] = Offs & 0xFF;
 417     TchHeader[5] = (Offs >> 8) & 0xFF;
 418     TchHeader[6] = Buf[0x88];
 419     TchHeader[7] = (unsigned char) -(signed char)(Buf[0x8A]);
 420     TchHeader[8] = TchHeader[6] + TchHeader[7];
 421
 422     /* The baseline must be zero, otherwise we cannot convert */
 423     if (Buf[0x89] != 0) {
 424         Error ("Baseline of font in `%s' is not zero", Input);
 425     }
 426
 427     /* If the output file is NULL, use the name of the input file with ".tch"
 428     ** appended.
 429     */
 430     if (Output == 0) {
 431         Output = MakeFilename (Input, ".tch");
 432     }
 433
 434     /* Open the output file */
 435     F = fopen (Output, "wb");
 436     if (F == 0) {
 437         Error ("Cannot open output file `%s': %s", Output, strerror (errno));
 438     }
 439
 440     /* Write the header to the output file */
 441     if (fwrite (TchHeader, 1, sizeof (TchHeader), F) != sizeof (TchHeader)) {
 442         Error ("Error writing to `%s' (disk full?)", Output);
 443     }
 444
 445     /* Write the width table to the output file */
 446     if (fwrite (WidthBuf, 1, 0x5F, F) != 0x5F) {
 447         Error ("Error writing to `%s' (disk full?)", Output);
 448     }
 449
 450     /* Write the offsets to the output file */
 451     if (fwrite (SB_GetConstBuf (&Offsets), 1, 0x5F * 2, F) != 0x5F * 2) {
 452         Error ("Error writing to `%s' (disk full?)", Output);
 453     }
 454
 455     /* Write the data to the output file */
 456     Offs = SB_GetLen (&VectorData);
 457     if (fwrite (SB_GetConstBuf (&VectorData), 1, Offs, F) != Offs) {
 458         Error ("Error writing to `%s' (disk full?)", Output);
 459     }
 460
 461     /* Close the output file */
 462     if (fclose (F) != 0) {
 463         Error ("Error closing to `%s': %s", Output, strerror (errno));
 464     }
 465
 466     /* Done */
 467 }
 468
 469
 470
 471 int main (int argc, char* argv [])
 472 /* Assembler main program */
 473 {
 474     /* Program long options */
 475     static const LongOpt OptTab[] = {
 476         { "--help",             0,      OptHelp                 },
 477         { "--verbose",          0,      OptVerbose              },
 478         { "--version",          0,      OptVersion              },
 479     };
 480
 481     unsigned I;
 482
 483     /* Initialize the cmdline module */
 484     InitCmdLine (&argc, &argv, "chrcvt65");
 485
 486     /* Check the parameters */
 487     I = 1;
 488     while (I < ArgCount) {
 489
 490         /* Get the argument */
 491         const char* Arg = ArgVec[I];
 492
 493         /* Check for an option */
 494         if (Arg [0] == '-') {
 495             switch (Arg [1]) {
 496
 497                 case '-':
 498                     LongOption (&I, OptTab, sizeof(OptTab)/sizeof(OptTab[0]));
 499                     break;
 500
 501                 case 'h':
 502                     OptHelp (Arg, 0);
 503                     break;
 504
 505                 case 'v':
 506                     OptVerbose (Arg, 0);
 507                     break;
 508
 509                 case 'V':
 510                     OptVersion (Arg, 0);
 511                     break;
 512
 513                 default:
 514                     UnknownOption (Arg);
 515                     break;
 516
 517             }
 518         } else {
 519             /* Filename. Dump it. */
 520             ConvertFile (Arg, 0);
 521             ++FilesProcessed;
 522         }
 523
 524         /* Next argument */
 525         ++I;
 526     }
 527
 528     /* Print a message if we did not process any files */
 529     if (FilesProcessed == 0) {
 530         fprintf (stderr, "%s: No input files\n", ProgName);
 531     }
 532
 533     /* Success */
 534     return EXIT_SUCCESS;
 535 }
 536
 537
 538