Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

Tk_GetJoinStyle (3tk)

Name

Tk_GetJoinStyle - translate between strings and join styles

Synopsis

#include <tk.h>

int
Tk_GetJoinStyle(interp, string, joinPtr)

const char *
Tk_NameOfJoinStyle(join)

Description

Tk_GetJoinStyle(3tk)         Tk Library Procedures        Tk_GetJoinStyle(3tk)



______________________________________________________________________________

NAME
       Tk_GetJoinStyle,  Tk_NameOfJoinStyle  -  translate  between strings and
       join styles

SYNOPSIS
       #include <tk.h>

       int
       Tk_GetJoinStyle(interp, string, joinPtr)

       const char *
       Tk_NameOfJoinStyle(join)

ARGUMENTS
       Tcl_Interp *interp (in)           Interpreter to use for error  report-
                                         ing.

       const char *string (in)           String  containing name of join style
                                         - one of "bevel", "miter", or "round"
                                         - or a unique abbreviation of one.

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

       int join (in)                     Join style: one of  JoinBevel,  Join-
                                         Miter, JoinRound.
______________________________________________________________________________

DESCRIPTION
       Tk_GetJoinStyle  places  in  *joinPtr the X join style corresponding to
       string, which will be one of JoinBevel, JoinMiter, or JoinRound.   Join
       styles  are typically used in X graphics contexts to indicate how adja-
       cent line segments should be joined together.  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 join style or an  abbrevia-
       tion  of  one of these names, then an error message is stored in inter-
       preter interp's result, TCL_ERROR is returned, and *joinPtr is  unmodi-
       fied.

       Tk_NameOfJoinStyle  is the logical inverse of Tk_GetJoinStyle.  Given a
       join style such as JoinBevel it returns a  statically-allocated  string
       corresponding  to  join.   If  join  is  not  a  legal join style, then
       "unknown join style" is returned.

KEYWORDS
       bevel, join style, miter, round



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | runtime/tk-8     |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source        was        downloaded        from         https://source-
       forge.net/projects/tcl/files/Tcl/8.6.7/tk8.6.7-src.tar.gz/download.

       Further information about this software can be found on the open source
       community website at https://www.tcl.tk/.



Tk                                                        Tk_GetJoinStyle(3tk)