# Copyright (c) 1990 The Regents of the University of California. # Copyright (c) 1994-1996 Sun Microsystems, Inc. # See the file "license.terms" for information on usage and redistribution # of this file, and for a DISCLAIMER OF ALL WARRANTIES. # # =head1 NAME Tk_GetCapStyle, Tk_NameOfCapStyle - translate between strings and cap styles =for category C Programming =head1 SYNOPSIS B<#include Etk.hE> int BIB<)> char * BIB<)> =head1 ARGUMENTS =over 4 =item Tcl_Interp *interp (in) Interpreter to use for error reporting. =item char *string (in) String containing name of cap style: one of ```butt'', ``projecting'', or ``round''. =item int *capPtr (out) Pointer to location in which to store X cap style corresponding to I. =item int cap (in) Cap style: one of B, B, or B. =back =head1 DESCRIPTION B places in I<*capPtr> the X cap style corresponding to I. This will be one of the values B, B, or B. 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 B and I is unused. If I doesn't contain a valid cap style or an abbreviation of one of these names, then an error message is stored in Iresult>, B is returned, and I<*capPtr> is unmodified. B is the logical inverse of B. Given a cap style such as B it returns a statically-allocated string corresponding to I. If I isn't a legal cap style, then ``unknown cap style'' is returned. =head1 KEYWORDS butt, cap style, projecting, round