GetVisual man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

Tk_GetVisual(3)		     Tk Library Procedures	       Tk_GetVisual(3)


       Tk_GetVisual - translate from string to visual

       #include <tk.h>

       Visual *
       Tk_GetVisual(interp, tkwin, string, depthPtr, colormapPtr)

       Tcl_Interp   *interp	   (in)	     Interpreter   to  use  for	 error

       Tk_Window    tkwin	   (in)	     Token for	window	in  which  the
					     visual will be used.

       char	    *string	   (in)	     String    that   identifies   the
					     desired visual.   See  below  for
					     valid formats.

       int	    *depthPtr	   (out)     Depth  of	returned  visual  gets
					     stored here.

       Colormap	    *colormapPtr   (out)     If non-NULL then a suitable  col‐
					     ormap for visual is found and its
					     identifier is stored here.

       Tk_GetVisual takes a string description of a visual and finds  a	 suit‐
       able  X Visual for use in tkwin, if there is one.  It returns a pointer
       to the X Visual structure for the visual and stores the number of  bits
       per  pixel  for	it at *depthPtr.  If string is unrecognizable or if no
       suitable visual could be found, then NULL is returned and  Tk_GetVisual
       leaves  an  error  message  in interp->result.  If colormap is non-NULL
       then Tk_GetVisual also locates an appropriate colormap for use with the
       result visual and stores its X identifier at *colormapPtr.

       The  string argument specifies the desired visual in one of the follow‐
       ing ways:

       class depth    The string consists of a class name followed by an inte‐
		      ger  depth,  with	 any  amount of white space (including
		      none) in between.	 class selects what sort of visual  is
		      desired  and  must  be  one  of  directcolor, grayscale,
		      greyscale, pseudocolor, staticcolor, staticgray, static‐
		      grey,  or	 truecolor,  or	 a unique abbreviation.	 depth
		      specifies how many bits per pixel	 are  needed  for  the
		      visual.	If possible, Tk_GetVisual will return a visual
		      with this depth; if there is no visual  of  the  desired
		      depth  then  Tk_GetVisual	 looks first for a visual with
		      greater depth, then one with less depth.

       default	      Use the default visual for tkwin's screen.

       pathName	      Use the visual for the window given by pathName.	 path‐
		      Name  must be the name of a window on the same screen as

       number	      Use the visual whose X identifier is number.

       best ?depth?   Choose the ``best possible'' visual, using the following
		      rules,  in  decreasing  order  of priority: (a) a visual
		      that has exactly the desired depth is best, followed  by
		      a	 visual with greater depth than requested (but as lit‐
		      tle extra as possible), followed by a visual  with  less
		      depth than requested (but as great a depth as possible);
		      (b) if no depth is specified, then the deepest available
		      visual  is  chosen; (c) pseudocolor is better than true‐
		      color or directcolor, which are better than staticcolor,
		      which  is	 better	 than staticgray or grayscale; (d) the
		      default visual for the screen is better than  any	 other

       The idea for Tk_GetVisual, and the first implementation, came from Paul

       colormap, screen, visual

Tk				      4.0		       Tk_GetVisual(3)

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net