Short:    Tool library. Gadgets,text,converting +
Author:   Kenneth C. Nilsen (kenneth@norconnect.no)
Uploader: Kenneth C. Nilsen (kenneth@norconnect.no)
Type:     util/libs


dfunc.library ver. 37.14


Manual
======

	dfunc.library

	Copyright © 1994, 1995 by Kenneth C. Nilsen/Digital Surface.
	All rights reserved.

	This library is freely distributable as long as no charges is made
	except from a little fee covering media expenses.

	This archive is allowed to be distributed with the Fred Fish
	collection, AmiNet, BBSes and PD libraries.

	Feel free to use it with your own application. I'll feel happy if you
	credit my work. Not allowed to be used with commercial software
	without a written permission. Shareware authors can also use it, but
	not without a deal (I am not greedy though).


	The library requires v37 and 68000 to run.


About
=====


This library is a multipurpose library.  It covers aspects from low functions
to functions rendering graphics, gadgets and texts.  For use with interactive
programs, multimedia programs, utilities and entertainment.

The  gadgets  are powerful, fully scalable and allows customizing and images.
The  gadgets  can  start processes independed on the main program, has a mask
field which is useful with interactiv application and eg.  games.

It  has  many  powerful text routines, for example the DFStripText() function
which  stripps  any  type  of  comments.  It has also text rendering routines
where  you  can  give  a  pointer  to  a normal text file and print it in the
rastport  centered or not, of a window or to printer directly.  It will later
support ansi texts.

It has most function needed for making life easier.

It is 100% system friendly and it's written in assembler to make speed affort
and small size.

It contains example sources.

It is freeware!



Notes
=====


It  contains  full  developer  information.   One  note thow:  The autodoc is
written  after  the  library  was  written.   That  means there might be some
mistyping,  wrong  explinations  and  the C prototypes are not correctly yet.
This  is  the  first beta version of the autodoc so don't blame me yet.  It's
anyway useful for most programmers.

I  correct  all  this  faults  in  a  later version.  Boy one get tired of an
autodoc after writting 80K text...

I have also used "struct gadlist *" in the C prototypes.  This is not correct
since  the gadgetlists are not a structure.  Will be corrected along with all
the other C prototypes errors (wonder why I am programming assembler ;).



Archive
=======


This  archive  contains BETA version of the library.  That means there may be
some bugs in the library and/or bad explinations in the autodocs.

Most private functions are not explained and they don't have to be. :)
See the FD file file for PRIVATE functions. They may change in new releases.



Explainations
=============


"List of gadget structures" (<input> in the autodocs)

	This is one of the powers with this library. You can set up a list og
	gadget structures after each other and end the list with a -1. In
	this way you don't have to mess around with complicated routines to
	set up system gadgets. See example sources to see how this is done.



Overview
========


The library is still at its beta stage. I haven't had time to test all
functions, but I haven't discovered major bugs yet.

Please report any kind of bugs you find via e-mail.

Questions about the usage?  E-mail me and I'll be happy to explain.

I  am trying to use the registers so they will be easy to remember.  I always
start  with  the  lowest register number and uses Ax regs for pointers and Dx
for  flags,  options  and values.  The regs start with 0 from left and the fd
are sorted so the address registers start first.  Example:

Example(Buffer,Text,FileName,size,options,mask) will have this reg layout:

(a0,a1,a2,d0,d1,d2)



Author
======


To report any bugs, critism, questions :


	e-mail: kenneth@norconnect.no


	Digital Surface
	attn: Kenneth C. Nilsen
	Kvernhusrenen 31
	N-5227 S-Neset
	(Norway)


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
    4808    2220 53.8% 12-Oct-95 03:02:02 +CIFF
    4552    2472 45.6% 19-Oct-95 07:31:16 +DemoX
    2548    1559 38.8% 23-Apr-95 14:03:02 +DumpMem
   23000   22256  3.2% 05-Sep-95 02:14:16 +Gadtest
    2780    1569 43.5% 30-Sep-95 14:29:24 +StripCom
   87130   23806 72.6% 14-Dec-95 15:43:48 +dfunc.doc
   14468    7607 47.4% 14-Dec-95 15:32:18 +dfunc.library
    3242    1553 52.0% 14-Dec-95 15:40:58 +dfunc.history
     847     464 45.2% 30-Sep-95 14:28:54 +StripCom.txt
    6429    1604 75.0% 01-Oct-95 17:11:56 +Selector.s
    3594    1114 69.0% 01-Oct-95 16:02:32 +StripCom.S
      28      28  0.0% 01-Oct-95 15:48:08 +Sorry_No_C_examples_yet...
    4055    1966 51.5% 14-Dec-95 15:58:26 +Dfunc.readme
    7892    3078 60.9% 01-Oct-95 17:14:08 +dfunc.i
    2308     877 62.0% 01-Nov-95 06:44:58 +dfunc_lib.i
    3320    1199 63.8% 04-Aug-95 14:45:18 +Digital.i
      30      30  0.0% 01-Oct-95 16:00:52 +Sources_Here_Are_PublicDomain
    3980    1369 65.6% 14-Dec-95 15:42:28 +dfunc_lib.fd
    5560    1829 67.1% 23-Apr-95 14:06:08 +19
    1587     523 67.0% 09-Aug-95 03:27:58 +Digital.macs
   12072    4212 65.1% 01-Nov-95 05:13:46 +Startup.asm
    1065     498 53.2% 26-Apr-95 00:22:22 +Startup.i
    2308     877 62.0% 01-Nov-95 06:44:58 +dfunc.lvo
    1304      67 94.8% 24-Jul-95 19:46:18 +InterACT.font
     264      34 87.1% 24-Jul-95 18:02:50 +Interconti.font
     524      43 91.7% 24-Jul-95 18:02:52 +mEuro.font
    7584    2825 62.7% 23-Apr-95 14:05:58 +23
     524      41 92.1% 24-Jul-95 18:02:56 +Topaz.font
    3192    1582 50.4% 23-Apr-95 11:03:48 +11
-------- ------- ----- --------- --------
  210995   87302 58.6% 15-Dec-95 10:33:06   29 files