home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Datafile PD-CD 5
/
DATAFILE_PDCD5.iso
/
utilities
/
d
/
dubmodule
/
DUBmodule
/
DUBmodInfo
< prev
next >
Wrap
Text File
|
1996-03-24
|
3KB
|
82 lines
DUBmodInfo:
introductory documentation for DrawUtilsB module V1.00 (14 Feb 96)
------------------------------------------------------------------
This module provides a number of swi calls concerned with the creation and -
to a lesser extent - editing of drawfiles. The module can handle all of the
standard object types used by !Draw (up to V0.99 - RISC OS 3.5) but does not
currently support unknown object types.
The basic function of the module is to organize data into the correct format
as a drawfile with the minimum of code in the calling application. For
example, a single call (DF_InitialiseFile) will write the drawfile header,
font table object (for a supplied list of fonts) and options object (for a
supplied page size code). Similarly, DF_PathStart allows all attributes of a
path object to be specified in a single call and creates a path object
header; e.g. one of the four standard dash patterns used by !Draw can be
selected simply by number or others can be defined if required. Other
features include:
•Automatic insertion/extension of the font table when text objects are
created - particularly useful if you do not know what fonts will be used in
advance.
•Choice of units (although currently they must be integer values).
•Path objects can contain bezier curves defined by points on the curve - the
module works out where the control points go (even within a subpath, it is
possible to have some control points set by the module and others by the
calling application).
•Group objects nested to a depth of 127 and tagged objects to a depth of 15.
•Transformed text & sprite objects created simply by adding a rotation value
or transformation matrix parameter to the appropriate swi call.
•Transformation facilities which can be applied to any object (e.g. a group
object) - transformation can be applied about a specified point (e.g. to
rotate an object about its centre).
•Bounding boxes set correctly on completion of an object.
•Extensive error trapping with support for error-recovery.
See the second documentation file ('DUBmodSWIs') for details of the module
swi calls.
History
-------
V1.00 (14 Feb 96): First release.
Copyright Notice: The DrawUtilsB module and the accompanying documentation
files ('DUBmodInfo' and 'DUBmodSWIs') are copyright © of the author (James
McQueen) 1996.
This software is supplied "as is"; no warranty of any kind concerning the
merchantability of this software or its fitness for any particular purpose
is given. In no circumstances shall the author or any provider or
distributor of this software be liable for any damage, loss of profits, or
any indirect or consequential loss arising out of the use of this software
or inability to use this software.
You are free to give this software to anyone you wish via any medium
including electronic bulletin board or public domain (PD) library providing
it is delivered with both documentation files unaltered. You may not sell
this software, except that PD libraries may make a nominal charge to cover
magnetic media and postage. The module may also be distributed as a
functional part of a larger application with or without its documentation
files providing that authorship of the module is acknowledged in the
documentation accompanying that application.
Comments concerning this software to:
James McQueen
9/2 15 Croftbank Street
Springburn
Glasgow
G21 4LP