Provided by: tk8.4-doc_8.4.19-4_all bug

NAME

       Tk_GetCapStyle, Tk_NameOfCapStyle - translate between strings and cap styles

SYNOPSIS

       #include <tk.h>

       int
       Tk_GetCapStyle(interp, string, capPtr)

       CONST char *
       Tk_NameOfCapStyle(cap)

ARGUMENTS

       Tcl_Interp   *interp   (in)      Interpreter to use for error reporting.

       CONST char   *string   (in)      String  containing  name  of cap style: one of ```butt'',
                                        ``projecting'', or ``round''.

       int          *capPtr   (out)     Pointer to  location  in  which  to  store  X  cap  style
                                        corresponding to string.

       int          cap       (in)      Cap style: one of CapButt, CapProjecting, or CapRound.
_________________________________________________________________

DESCRIPTION

       Tk_GetCapStyle  places  in  *capPtr the X cap style corresponding to string.  This will be
       one of the values CapButt, CapProjecting, or CapRound.  Cap styles are typically used in X
       graphics  contexts  to  indicate  how the end-points of lines should be capped.  See the X
       documentation for information on what each style implies.

       Under normal circumstances the return value is TCL_OK and interp  is  unused.   If  string
       doesn't  contain a valid cap style or an abbreviation of one of these names, then an error
       message is stored in interp->result, TCL_ERROR is returned, and *capPtr is unmodified.

       Tk_NameOfCapStyle is the logical inverse of Tk_GetCapStyle.  Given a  cap  style  such  as
       CapButt  it  returns  a  statically-allocated string corresponding to cap.  If cap isn't a
       legal cap style, then ``unknown cap style'' is returned.

KEYWORDS

       butt, cap style, projecting, round