.TH PANEL 9.SH NAMEpanel \- embedded graphics.SH SYNOPSIS\f5panel\fI \fIpathName \fR?\fIoptions\fR?.SH STANDARD OPTIONS.EX-anchor       -borderwidth  -background   -relief.EE.SH "WIDGET-SPECIFIC OPTIONS".TP.B -height \fIdist\fPSpecifies a desired height for the panel.If this option isn't specified, the panel's desired height is computedfrom the image and mask images. If these are replicated,the default is zero..TP.B -width \fIdist\fPSpecifies a desired width for the panel.If this option isn't specified, the panel's desired height is computedfrom the image and mask images. If these are replicated,the default is zero..SH DESCRIPTIONThe \f5panel\fR command creates a new window (given by the \fIpathName\fRargument) and makes it into a panel widget.Additional options, described above, may be specified on thecommand lineto configure aspects of the panel such as its background colour and 3-D relief.The \f5panel\fR command returns its\fIpathName\fR argument.  At the time this command is invoked,there must not exist a window named \fIpathName\fR..PPA panel is a widget that displays arbitrary graphics drawn outsideof Tk. An application is free to use any image or mask that itchooses to create; the panel will display the contents of the imagethrough the mask (see.IR draw (2))..PPA panel widget will not display anything until its image has beenset using.B putimage(see.IR tk (2)). .SH "WIDGET COMMAND"The \f5panel\fR command creates a new Tk command whose nameis \fIpathName\fR. This command may be used to invoke variousoperations on the widget: It has the following general form:.RS.EX\fIpathName option \fR?\fIarg arg ...\fR?.EE.RE\fIOption\fR and the \fIarg\fRsdetermine the exact behaviour of the command.  The followingcommands are possible for panel widgets:.TP\fIpathName \f5cget\fR \fIoption\fRReturns the current value of the configuration option givenby \fIoption\fR.\fIOption\fR may have any of the values accepted by the \f5panel\fRfunction..TP\fIpathName \f5configure\fR ?\fIoption\fR? ?\fIvalue option value ...\fR?Query or modify the configuration options of the widget.If no \fIoption\fR is specified, returns a list of all ofthe available options for \fIpathName\fR.  Ifone or more \fIoption-value\fR pairs are specified, then the commandmodifies the given widget option(s) to have the given value(s);  inthis case the command returns an empty string.\fIOption\fR may have any of the values accepted by the \f5panel\fRfunction.TP\fIpathName \f5dirty\fR ?\fIminx miny maxx maxy\fR?Mark the area inside the given rectangle((\fIminx\fP, \fIminy\fP), (\fImaxx\fP, \fImaxy\fP))to be flushed to the screen. If the rectangle is notgiven, the whole area will be marked.The coordinates are relative to the image's origin..TP\fIpathName \f5origin\fR ?\fIx y\fR?Set the point within the image that will be displayedat the top left of the panel's rectangle.If the area allocated to the panel is more thanthe area drawn by the image, the ``top left'' willpositioned with respect to the value of the.B -anchoroption.If the point is not given, the current originis returned..TP\fIpathName \f5panelx\fR ?\fIscreenx\fR?Given a screen x-coordinate,.IR screenx ,this command returns the image x-coordinate displayedat that location..TP\fIpathName \f5panely\fR ?\fIscreeny\fR?Given a screen y-coordinate,.IR screeny ,this command returns the image y-coordinate displayedat that location..TP\fIpathName \f5screenx\fR ?\fIpanelx\fR?Given an image x-coordinate,.IR panelx ,this command returns theequivalent screen x-coordinate..TP\fIpathName \f5screeny\fR ?\fIpanely\fR?Given an image y-coordinate,.IR panely ,this command returns theequivalent screen y-coordinate..SH BINDINGSWhen a new panel is created, it has no default event bindings..SH SEE ALSO.IR draw (2),.IR tk (2),.IR options (9),.IR types (9)