                      --------------------------
                               LUGMA 1.0
                      --------------------------
                          (c) 1997 Andres Pons
                      --------------------------


. Thank you for your interest in LUGMA 1.0 !


Introduction
------------

. With LUGMA 1.0 you can preview and print documents generated with
  its own meta-language.

. When developing applications, you can use all the Windows printing
  capabilities without the need of a specific printer module.

. LUGMA suports both DDE conversations and file-command reading.

. You only have to generate a file with commands which describe the
  report, and execute LUGMA to preview or print it, or after 
  executing LUGMA, create a DDE conversation to send those commands.

. LUGMA acts as a print server and you can open as many report windows
  as you want.


System Requirements
-------------------

. Operating System : Windows 95 or Windows NT 


Installing Lugma
----------------

. To install LUGMA, unzip LUGMA10.ZIP then run SETUP.EXE from the 
  Explorer in Windows 95. Follow the on-screen instructions.


Parameters
----------

. When executing LUGMA you can specify a file to be printed, and 
  optionally you can tell it to delete that file after closing
  the program.

. The syntax is :

     LUGMA.EXE [ Lugmafile [ /D ] ]

  where

     Lugmafile is the name of a meta-language file to be printed.
     /D is a switch that will delete the file after closing the program.


Available Commands
------------------

. These are the commands that you can use when creating a 
  meta-language file or into any DDE conversation.

. SETPAGE(cols,rows,aspect)
. SETFONTNAME(fontname)
. SETFONTSIZE(fontsize)
. SETFONTITALIC(switch)
. SETFONTBOLD(switch)
. SETFONTUNDERLINE(switch)
. SETLINEWIDTH(width)
. GOTOXY(col,row)
. PRINT(s)
. PRINTAT(col,s)
. PRINTTO(col,s)
. SKIP(n)
. PAGE
. LINE(col,row)
. BOX(col,row)
. PICTURE(bmpfile)


Command Syntax
--------------

. SETPAGE(cols,rows,aspect)

        cols   = number of logical columns
        rows   = number of logical rows
        aspect = VERTICAL | HORIZONTAL

. SETFONTNAME(fontname)

        fontname = name of the font to be used (ex : Arial)

. SETFONTSIZE(fontsize)

        fontsize = sets the font size for the actual font

. SETFONTITALIC(switch)

        switch = ON | OFF

. SETFONTBOLD(switch)

        switch = ON | OFF

. SETFONTUNDERLINE(switch)

        switch = ON | OFF

. SETLINEWIDTH(width)

        width = width value for the lines

. GOTOXY(col,row)

        col = column number
        row = row number

. PRINT(s)

        s = string to be printed

. PRINTAT(col,s)

        s   = string to be printed
        col = column number where the string has to begin

. PRINTTO(col,s)

        s = string to be printed
        col = column number where the string has to end

. SKIP(n)

        n = number of rows to be skipped

. PAGE

. LINE(col,row)

        col = column number where the line will end
        row = row number where the line will end

. BOX(col,row)

        col = column number of the bottom-left corner
        row = row number of the bottom-left corner

. PICTURE(bmpfile)

        bmpfile = pathname of the image file (bmp or ico)


Two ways to create reports
--------------------------

. You can create a file with LUGMA specific commands and open 
  that file with the 'open-file' button of LUGMA, to preview 
  the final report.

. You cand send DDE commands with the topic 'System' to LUGMA
  and you will get the report on the screen after closing the 
  DDE conversation.


Examples
--------

. Save the next lines in a file and read it from LUGMA 1.0.
  You'll get a good preview on the screen !

	SETPAGE(80,60,VERTICAL)
	GOTOXY(4,2)
	BOX(18,5)
	GOTOXY(65,5)
	LINE(75,5)
	SETFONTNAME(ARIAL)
	SETFONTSIZE(14)
	GOTOXY(5,3)
	PRINT(EXAMPLE 1)
	PRINTTO(75,LUGMA 1.0)
	SETFONTITALIC(ON)
	SETFONTUNDERLINE(ON)
	GOTOXY(1,10)
	PRINTAT( 5,Product)
	PRINTAT(15,Description                            )
	PRINTTO(75,Quantity)
	SETFONTITALIC(OFF)
	SETFONTUNDERLINE(OFF)
	SKIP(1)
	PRINTAT( 5,K-12542)
	PRINTAT(15,DESKJET PRINTER)
	PRINTTO(75,1750)
	SKIP(0)
	PRINTAT( 5,K-12543)
	PRINTAT(15,MOUSE)
	PRINTTO(75,270)
	SKIP(0)
	PRINTAT( 5,K-12544)
	PRINTAT(15,KEYBOARD)
	PRINTTO(75,184)
	SKIP(0)
	PRINTAT( 5,K-12545)
	PRINTAT(15,SOUND CARD)
	PRINTTO(75,442)
	SKIP(1)
	SETFONTBOLD(ON)
	PRINTTO(75,TOTAL ......... 2646)
	SKIP(0)
	SETFONTBOLD(OFF)
	PAGE
	SETFONTNAME(ARIAL)
	SETFONTSIZE(10)
	GOTOXY(5,15)
	PRINT(Arial : SIZE 10 )
	SETFONTNAME(TIMES NEW ROMAN)
	SETFONTSIZE(15)
	SETFONTITALIC(ON)
	GOTOXY(5,20)
	PRINT(Times New Roman : SIZE 15 / ITALIC)
	SETFONTNAME(ARIAL)
	SETFONTSIZE(30)
	SETFONTBOLD(ON)
	GOTOXY(5,25)
	PRINT(ARIAL : SIZE 30 / ITALIC / BOLD)

. If your developing tool supports DDE, you can probably execute
  something similar to the next lines from it.

	canal := DDE-Initiate("Lugma","System")
	if canal = 0 then
		winexec("c:\lugma\lugma.exe")
		canal := DDE-initiate("Lugma","System")
		if canal = 0 then
			message "Error"
			return
		endif
	endif
	DDE-execute(canal,"SETPAGE(80,60,VERTICAL)")
	DDE-execute(canal,"GOTOXY(4,2)")
		...
	DDE-execute(canal,"PRINT(ARIAL : SIZE 30 / ITALIC / BOLD)")
	DDE-close(canal)


License
-------

. LUGMA 1.0 IS *NOT* FREE SOFTWARE.
          
. LUGMA 1.0 is released as SHAREWARE. This means that you may
  use it as long as :

       [1] You PAY THE REQUIRED REGISTRATION FEE

       and,

       [2] My name does NOT appear ANYWHERE in your application's
           documentation

   The REGISTRATION FEE is $59.99 (US) or equivalent.


How to register
---------------

. You can register LUGMA 1.0 at the 'ShareIt' web page.

. Registration fee: $59.99

. If you would like to register LUGMA, you can do the registration
  online on the Internet at http://www.shareit.com/programs/100491.htm
  Alternatively, you can go to http://www.shareit.com and enter
  the program number there: 100491.

. If you do not have access to the Internet, you can register via phone,
  fax or postal mail. Please print out the following form, and fax or
  mail it to:

  Reimold&Schumann Internet Services
  ShareIt!
  Jahnstrasse 24
  50676 Koeln
  Germany

  Phone:          +49-221-2407279 
                  +49-172-7229837
  Fax:            +49-221-2407278
  E-Mail:         register@shareit.com


. Registration form for LUGMA

Program No.: 100491

Last name: ___________________________________

First name: ____________________________________

Company: ____________________________________

Street and #: ______________________________________

City, State, postal code: ________________________________

Country: _______________________________________

Phone: _____________________________________

Fax: ________________________________________

E-Mail: ______________________________________


How would like to receive the registration key/full version?

e-mail 	- fax	- postal mail


How would you like to pay the registration fee of $59.99:

credit card - wire transfer - EuroCheque - cash


Credit card information (if applicable)

Credit card: Visa - Eurocard/Mastercard - American Express - Diners Club

Card holder: ________________________________

Card No.: ___________________________________

Date of Expiration : ___________________________________



Date / Signature ___________________________



------------------------------------------------------------------------------


Shareware Distribution
----------------------

. You may distribute the package freely to FTP sites, Bulletin
  Boards, Shareware/Freeware/Public Domain archives, CD-ROMS, 
  Magazine, Cover Disks and CD-ROMS, etc. Shareware disk vendors 
  also may also freely distribute the package.

DISCLAIMER
----------

. I DO NOT WARANTEE ANYTHING CONCERNING ANY OF THE PROGRAMS OR FILES
  WHICH MAKE UP "LUGMA 1.0". 

. I ACCEPT NO RESPONSIBILITY FOR ANY LOSS OR DAMAGE OF ANY KIND, 
  INCLUDING, BUT NOT LIMITED TO, LOSSES OF A PHYSICAL, MENTAL, 
  SOCIAL, FINANCIAL, MARITAL, OR OF WHATEVER NATURE, RESULTING 
  FROM THE USE, OR THE PURPORTED USE OF "LUGMA 1.0", OR ANY OF 
  THE FILES IN THE PACKAGE, FOR ANY PURPOSE WHATSOEVER. 

. YOU USE "LUGMA 1.0" ENTIRELY AT YOUR OWN RISK, AND YOU SUPPLY 
  IT TO YOUR CUSTOMERS, FRIENDS, FAMILY, ACQUAINTANCES, OR ENEMIES, 
  ENTIRELY AT YOUR OWN RISK.

. IF THESE TERMS ARE NOT ACCEPTABLE TO YOU, THEN PLEASE DELETE ALL
  THE FILES FROM YOUR DISKS IMMEDIATELY AND PERMANENTLY.


How to contact the Author
-------------------------

. If you need further help, or would like to add features, 
  please send email to

        andrespons@arconet.es

. Enjoy LUGMA 1.0 !!!
