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” - or a unique abbreviation of one.

       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 does not contain a
       valid  cap style or an abbreviation of one of these names, then an error message is stored in interpreter
       interp's 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 is not a legal cap style, then “unknown cap
       style” is returned.

KEYWORDS

       butt, cap style, projecting, round