# 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_GetRootCoords - Compute root-window coordinates of window
=for category C Programming
=head1 SYNOPSIS
B<#include E<lt>tk.hE<gt>>
B<Tk_GetRootCoords>(I<tkwin, xPtr, yPtr>)
=head1 ARGUMENTS
=over 4
=item Tk_Window tkwin (in)
Token for window.
=item int *xPtr (out)
Pointer to location in which to store root-window x-coordinate
corresponding to left edge of I<tkwin>'s border.
=item int *yPtr (out)
Pointer to location in which to store root-window y-coordinate
corresponding to top edge of I<tkwin>'s border.
=back
=head1 DESCRIPTION
This procedure scans through the structural information maintained
by Tk to compute the root-window coordinates corresponding to
the upper-left corner of I<tkwin>'s border. If I<tkwin> has
no border, then B<Tk_GetRootCoords> returns the root-window
coordinates corresponding to location (0,0) in I<tkwin>.
B<Tk_GetRootCoords> is relatively efficient, since it doesn't have to
communicate with the X server.
=head1 KEYWORDS
coordinates, root window