SgArc(3X) UNIX System V SgArc(3X)
NAME
SgArc - Arc widget designed for use with SgGraph.
SYNOPSIS
#include <Xm/Xm.h> #include <Sgm/Graph.h> #include
<Sgm/Arc.h>
VERSION
This page documents the version of Sgm that accompanies
Motif 1.2.
DESCRIPTION
The SgArc widget is a special widget that resembles a gadget
in that it has no window of its own. It draws in the window
of the SgGraph widget, with cooperation of the Graph widget.
The Arc widget can only be used with the Graph widget. An
arc may be undirected, directed, or bidirected.
CLASSES
The Arc widget inherits behavior from the Core widget class.
Its class pointer is sgArcWidgetClass
Its class name is SgArc.
ARC RESOURCES
The Arc widget defines a set of resource types used by the
programmer to specify the data for the arc. These resources
are used to set attributes for arcs when specifying node
parent-child relationships. The following table contains
the set of resources defined by the Arc widget. To specify
any of these resources within the .Xdefaults file, simply
drop the XmN prefix from the resource name.
SgArc Resource Set
Name Class Type Default Access
___________________________________________________________________________
XmNto XmCTo XmRPointer NULL CSG
XmNfrom XmCFrom XmRPointer NULL CSG
XmNtoPosition XmCPosition XmRShort 50 CSG
XmNfromPosition XmCPosition XmRShort 50 CSG
XmNfromSide XmCSide XmRShort XmRIGHT CSG
XmNtoSide XmCSide XmRShort XmLEFT CSG
XmNarcDirection XmCDirection XmRArcDirection XmDIRECTED CSG
XmNforeground XmCForeground Pixel "Black" CSG
XmNhighlight XmCHighlight Boolean "False" CSG
XmNfontList XmCFontList FontList "Fixed "
XmNlabelString XmCXmString XmString dynamic CSG
XmNmapLabel XmCBoolean Boolean "FALSE" CSG
XmNarcWidth XmCArcWidth int 0 CSG
Page 1 (printed 1/22/99)
SgArc(3X) UNIX System V SgArc(3X)
XmNstyle XmCStyle int LineSolid CSG
XmNcapStyle XmCapStyle int CapButt CSG
XmNdashes XmCDashes int 4 CSG
XmNdashOffset XmCDashOffset int 0 CSG
XmNarmCallback XmCCallback Pointer NULL C
XmNdisarmCallback XmCCallback Pointer NULL C
XmNactivateCallback XmCCallback Pointer NULL C
XmNatribute XmCAttribute Atom NULL C
XmNuserData XmCUserData Pointer NULL CSG
XmNto
The widget this arc points to.
XmNfrom
The widget this arc points from.
XmNarcWidth
The width, in pixels, of the line drawn for the arc.
Zero means to draw using the server's fastest algorithm
with a line width of one pixel.
XmNstyle
Specifies whether the line is solid in foreground,
dashed in foreground, or alternating foreground and
background. Possible values are LineSolid (the
default), LineOnOffDash, or LineDoubleDash.
XmNcapStyle
Controls the appearance of the ends of a line. This
characteristic affects the ends of lines drawn in
dashes, and both ends of each dash in some cases.
Possible values are CapNotLast, CapButt (the default),
CapRound, and CapProjecting.
XmNdashes
Specifies the length of the dashes for custom-designed
dashed lines. The default (4) is equivalent to the list
{4,4} (a dash of 4 pixels, followed by a space of 4
pixels).
XmNdashOffset
Specifies the starting point of the dash pattern, from
the parent node, for dashed lines.
XmNlabelString
This resource specifies a compound string which will be
displayed with the arc, if the XmNmapLabel resource is
true. If no labelString is given, the widget defaults
to using the widget name as the label.
Page 2 (printed 1/22/99)
SgArc(3X) UNIX System V SgArc(3X)
XmNmapLabel
If true (the default), the label, if any, will be
displayed.
XmNarcDirection
If XmDIRECTED, will display an arrow head on the child
end, if XmBIDIRECTED will display an arrow head on both
ends, otherwise no arrow head is displayed.
XmNforeground
Color in which the arc and its label will be drawn.
XmNfontList
Font used to write the label with when XmNmapLabel is
true.
XmNarmCallback
XmNdisarmCallback
XmNactivateCallback
These callbacks are equivalent to the pushbutton
callbacks of the same name.
XmNfromSide
If the parent graph widget's XmNdrawMode resource is
set to XmPOSITION_PROPORTIONAL, this resource
determines the side of the "from" node to which this
arc is attached. Possible values are XmLEFT, XmRIGHT,
XmTOP, and XmBOTTOM.
XmNfromPosition
If the parent graph widget's XmNdrawMode resource is
set to XmPOSITION_PROPORTIONAL, this resource
determines the position of the arc at the point it
leaves the "from" node. Values are given in percentages
of the relevant node size, and can range from 0-100.
XmNtoSide
If the parent graph widget's XmNdrawMode resource is
set to XmPOSITION_PROPORTIONAL, this resource
determines the side of the "to" node to which this arc
is attached. Possible values are XmLEFT, XmRIGHT,
XmTOP, and XmBOTTOM.
XmNtoPosition
If the parent graph widget's XmNdrawMode resource is
set to XmPOSITION_PROPORTIONAL, this resource
determines the position of the arc at the point it
leaves the "to" node. Values are given in percentages
of the relevant node size, and can range from 0-100.
Page 3 (printed 1/22/99)
SgArc(3X) UNIX System V SgArc(3X)
INHERITED RESOURCES
The following resources are inherited from the named
superclasses:
Core Resource Set
Name Class Type Default Access
____________________________________________________________________________________________
XmNaccelerators XmCAccelerators XtTranslations NULL CSG
XmNancestorSensitive XmCSensitive Boolean True G
XmNbackground XmCBackground Pixel dynamic CSG
XmNbackgroundPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG
XmNcolormap XmCColormap Colormap XtCopyFromParent CG
XmNdepth XmCDepth int XtCopyFromParent CG
XmNdestroyCallback XmCCallback XtCallbackList NULL C
XmNmappedWhenManaged XmCMappedWhenManaged Boolean True CSG
XmNscreen XmCScreen Pointer XtCopyScreen CG
XmNsensitive XmCSensitive Boolean True CSG
XmNtranslations XmCTranslations XtTranslations NULL CSG
Callback Information
See SgGraph(3x)
UTILITY FUNCTIONS
Widget SgCreateArc (graph, name, args, n_args)
XwGraphWidget graph;
char name;
ArgList args;
int n_args;
A convenience function that creates an SgArc widget named
name whose parent is graph.
Widget SgCreateAttachedArc (graph, name, from, to, args,
n_args)
XwGraphWidget graph;
char name;
Widget from;
Widget to;
ArgList args;
int n_args;
SgCreateAttachedArc creates an arc from from to to with
arguments args, name name, and returns its widget ID. from
and to must be node widgets in graph. Returns NULL if not
successful.
Widget SgArcGetPos (arc, x1, y1, x2, y2)
SgArcWidget arc;
Position *x1, *y1, *x2, *y2;
Page 4 (printed 1/22/99)
SgArc(3X) UNIX System V SgArc(3X)
SgArcGetPos returns the coordinates of the endpoints of the
given arc.
RELATED INFORMATION
Composite(3X), Constraint(3X), Core(3X), XmManager(3X),
SgGrid(3X),
Page 5 (printed 1/22/99)