Category : BBS Programs+Doors
Archive   : RIP.ZIP
Filename : R2.TXT

 
Output of file : R2.TXT contained in archive : RIP.ZIP
---------------------------------------------------------------------
Draw a circular arc in the current color and line thickness
---------------------------------------------------------------------
Symbol: RIP_ARC
Level: 0
Command: A
Arguments: x:2, y:2, start_ang:2, end_ang:2, radius:2
Format: !|A
Example: !|A1E18003G15
Uses Draw Color: YES
Uses Line Patrn: NO
Uses Line Thick: YES
Uses Fill Color: NO
Uses Fill Patrn: NO
Uses Write Mode: NO
Uses Font Sizes: NO

This command draws a circular arc, or a segment of a circle. Drawing
begins at and terminates at . The angles are
represented starting at zero for the 3 o'clock position and
increasing counterclockwise through a full circle to 360:

90
|
180---|--- 0
|
270

The arc drawing begins at the and continues counter-
clockwise to the . A full circle will be displayed if
=0 and =360. This command recognizes aspect
ratios like the circle command does. It does not take advantage of
line patterns but does comply with line thickness.

If both angles are equal, nothing is drawn.





---------------------------------------------------------------------
Draw an Elliptical Arc
---------------------------------------------------------------------
Symbol: RIP_OVAL_ARC
Level: 0
Command: V
Arguments: x:2, y:2, st_ang:2, e_ang:2, radx:2 rady:2
Format: !|A
Example: !|A1E18003G151Q
Uses Draw Color: YES
Uses Line Patrn: NO
Uses Line Thick: YES
Uses Fill Color: NO
Uses Fill Patrn: NO
Uses Write Mode: NO
Uses Font Sizes: NO

This command draws an elliptical arc, or a segment of an ellipse.
Drawing begins at and terminates at . The angles are
represented starting at zero for 3 o'clock position and increasing
counterclockwise through a full ellipse at 360 degrees:

90
|
180---|--- 0
|
270

The arc drawing begins at the and continues counterclockwise
to the . A complete ellipsewill be displayed if =0
and =360. This command does not utilize "aspect ratios"
because of the nature of an Ellipse. It does not take advantage of
line patterns but does comply with line thickness.





---------------------------------------------------------------------
Draw a circular Pie Slice
---------------------------------------------------------------------
Symbol: RIP_PIE_SLICE
Level: 0
Command: I
Arguments: x:2, y:2, start_ang:2, end_ang:2, radius:2
Format: !|A
Example: !|A1E18003G15
Uses Draw Color: YES
Uses Line Patrn: NO
Uses Line Thick: YES
Uses Fill Color: YES
Uses Fill Patrn: YES
Uses Write Mode: NO
Uses Font Sizes: NO

This command draws a "pie slice". The slice is circular. It obeys
all of the same commands as the Arc command described above. The
ends of the arc are connected to the Center-Point of the Arc with two
straight lines. These two lines converge at the Center-Point. The
interior of the Slice is filled with the current Fill Color and
Pattern. The exterior (outline) of the Slice is drawn using the
current drawing color and line thickness. The Line Pattern feature
does not apply to this command.





---------------------------------------------------------------------
Draw an Elliptical Pie Slice
---------------------------------------------------------------------
Symbol: RIP_OVAL_PIE_SLICE
Level: 0
Command: i
Arguments: x:2, y:2, st_ang:2, e_ang:2, radx:2 rady:2
Format: !|A
Example: !|A1E18003G151Q
Uses Draw Color: YES
Uses Line Patrn: NO
Uses Line Thick: YES
Uses Fill Color: YES
Uses Fill Patrn: YES
Uses Write Mode: NO
Uses Font Sizes: NO

This command draws an "elliptical pie slice". It obeys all of the
same commands as the Elliptical Arc command described above. The
ends of the arc are connected to the Center-Point of the Arc with two
straight lines. These two lines converge at the Center-Point. The
interior of the Slice is filled with the current Fill Color and
Pattern. The exterior (outline) of the Slice is drawn using the
current drawing color and line thickness. The Line Pattern feature
does not apply to this command.





---------------------------------------------------------------------
Draw a custom "Bezier" curve
---------------------------------------------------------------------
Symbol: RIP_BEZIER
Level: 0
Command: Z
Arguments: x1:2 y1:2 x2:2 y2:2 x3:2 y3:2 x4:2 y4:2 cnt:2
Format: !|Z
Example: !|Z0A0B0C0D0E0F0G0H1G
Uses Draw Color: YES
Uses Line Patrn: YES
Uses Line Thick: YES
Uses Fill Color: NO
Uses Fill Patrn: NO
Uses Write Mode: YES
Uses Font Sizes: NO

This command provides customizable Curves. Four "control points" are
used to create the shape of the curve. The curves beginning point is
at point (x1,y1) and it ends at (x4,y4). Points (x2,y2) and (x3,y3)
are not necessarily "on" the curve, but are used to "pull" the curve
in their direction. The diagram below indicates how points 2 and 3
can be utilized to form the desired curve. Note that points 2 and 3
are not actually "on" the curve, but points 1 and 4 are.

X2

*****
** ****
* ** X4
* ** *
X1 * **
* **
****

X3

NOTE: That points 2 and 3 are not actually "on" the curve, but points
1 and 4 are.

The last parameter of this command is the parameter. This
determines how many "segments" the curve should be drawn in. Each
segment is in fact, a straight line. The more segments you allow,
the smoother the curve may be. If a curve does not have a
significant amount of "curviness" then a low "count" can improve
performance of the curve drawing. Bezier Curves use "floating point"
math internally for its processing. All paramters specified for this
command are simple integers however.





---------------------------------------------------------------------
Draws a polygon using the current color and line style/thickness
---------------------------------------------------------------------
Symbol: RIP_POLYGON
Level: 0
Command: P
Arguments: npoints:2, x1:2, y1:2, ... xn:2, yn:2
Format: !|P ...
Example: !|P03010105090905
Uses Draw Color: YES
Uses Line Patrn: YES
Uses Line Thick: YES
Uses Fill Color: NO
Uses Fill Patrn: NO
Uses Write Mode: YES
Uses Font Sizes: NO

This command will draw a multi-sided closed polygon. The polygon is
drawn using the current drawing color, line pattern and thickness.
The parameter is between 2 and 512 and indicates how many
(x,y) coordinate pairs will follow, which is also the number of sides
of the polygon. The polygon interior is not filled by RIP_POLYGON.

The polygon is enclosed by the last vertex between xn,yn and x1,y1.
In other words, you do not have to connect the end to the beginning -
it is automatically done for you.





---------------------------------------------------------------------
Draws a filled polygon, using drawing color, current fill settings
---------------------------------------------------------------------
Symbol: RIP_FILL_POLY
Level: 0
Command: p
Arguments: npoints:2, x1:2, y1:2, ... xn:2, yn:2
Format: !|p ...
Example: !|p03010105050909
Uses Draw Color: YES
Uses Line Patrn: YES
Uses Line Thick: YES
Uses Fill Color: YES
Uses Fill Patrn: YES
Uses Write Mode: YES
Uses Font Sizes: NO

This command is identical to RIP_POLYGON, except that the interior of
the polygon is filled with the current fill color and fill pattern.
The actual outline of the polygon is drawn using the current drawing
color, line pattern and thickness.

NOTE: You will get unusual effects if the lines of the polygon
overlap, creating a polygon with internal "gaps". (The rule is
this: regions that are "inside" the polygon an even number of times
due to overlap are NOT filled.) The interior fill does not utilize
Write Mode, but the outline of the polygon does.





---------------------------------------------------------------------
Flood Fills a given area of the screen with the current fill settings
---------------------------------------------------------------------
Symbol: RIP_FILL
Level: 0
Command: F
Arguments: x:2, y:2, border:2
Format: !|F
Example: !|F25090F
Uses Draw Color: NO
Uses Line Patrn: NO
Uses Line Thick: NO
Uses Fill Color: YES
Uses Fill Patrn: YES
Uses Write Mode: NO
Uses Font Sizes: NO

This command performs a "flood fill" emanating from the given
point. The fill "oozes" in all directions up to color, but
the border itself is not changed. Whatever is inside the border
that's not the border color gets changed to the current fill color
and fill pattern. If the border color does not completely enclose
the point, the fill will continue to the edges of the viewport.





---------------------------------------------------------------------
Defines a line style and thickness
---------------------------------------------------------------------
Symbol: RIP_LINE_STYLE
Level: 0
Command: =
Arguments: style:2, user_pat:4, thick:2
Format: !|=