.\" Copyright 1988, 1998  The Open Group
.\"
.\" Permission to use, copy, modify, distribute, and sell this software and its
.\" documentation for any purpose is hereby granted without fee, provided that
.\" the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation.
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of The Open Group shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from The Open Group.
.\"
.TH XREFRESH 1 2025-05-31 "xrefresh 1.1.1" "X Version 11"
.SH "نام (NAME)"
xrefresh \- تازه‌سازی تمام یا بخشی از یک صفحه نمایش X
.SH "خلاصه دستور (SYNOPSIS)"
.B "xrefresh"
[-option ...]
.SH "توضیحات (DESCRIPTION)"
برنامه
.B Xrefresh
یک برنامه ساده برای X است که باعث بازترسیم تمام یا بخشی از صفحه نمایش شما می‌شود.
این ابزار زمانی که پیام‌های سیستم صفحه نمایش شما را به هم ریخته باشند، مفید است.
.B Xrefresh
پنجره‌ای را روی ناحیه مورد نظر از صفحه نگاشت (map) کرده و سپس بلافاصله آن را برمی‌دارد (unmap)، که این امر موجب ارسال رویدادهای بازترسیم و تازه‌سازی به تمام برنامه‌ها می‌شود.
به‌طور پیش‌فرض، پنجره‌ای بدون پس‌زمینه استفاده می‌شود که باعث می‌شود همه برنامه‌ها به شکلی \(lqروان\(rq مجدداً ترسیم شوند.
با این حال، می‌توان از گزینه‌های مختلف برای تعیین این‌که به جای آن از یک پس‌زمینه یکدست (به هر رنگی) یا پس‌زمینه پنجره ریشه (root window) استفاده شود، بهره برد.
.SH "آرگومان‌ها (ARGUMENTS)"
.TP 10
.B \-white
استفاده از یک پس‌زمینه سفید.
صفحه نمایش تنها به نظر می‌رسد که به سرعت چشمک می‌زند و سپس دوباره ترسیم می‌شود.
.TP 10
.B \-black
استفاده از یک پس‌زمینه سیاه.
این حالت ممکن است تا حدی گیج‌کننده باشد زیرا برای لحظه‌ای همه‌چیز سیاه می‌شود.
.TP 10
.B \-solid \fIcolor\fP
استفاده از یک پس‌زمینه یکدست با رنگ مشخص‌شده. رنگ سبز (green) را امتحان کنید.
.TP 10
.B \-root
استفاده از پس‌زمینه پنجره ریشه (root window).
.TP 10
.B \-none
این حالت پیش‌فرض است. تمام پنجره‌ها به سادگی دوباره ترسیم می‌شوند.
.TP 10
.B \-geometry \fIWxH+X+Y\fP
بخشی از صفحه نمایش را که باید بازترسیم شود مشخص می‌کند؛ ببینید:
.BR X (7).
.TP 10
.B \-display \fIdisplay\fP
این آرگومان به شما امکان می‌دهد کارساز و صفحه نمایش را جهت تازه‌سازی مشخص کنید؛ ببینید:
.BR X (7).
.TP 10
.B \-delay \fIms\fP
به میزان \fIms\fP میلی‌ثانیه بین نگاشت (map) و برداشتن (unmap) پنجره درنگ می‌کند.
این گزینه می‌تواند برای صفحه‌نمایش‌هایی با زمان پاسخ‌دهی کند، مانند نمایشگرهای جوهر الکترونیک (e-ink)، مفید باشد.
مقدار پیش‌فرض 0 میلی‌ثانیه است.
.TP 10
.B \-help
این آرگومان گزینه‌های برنامه را چاپ کرده و خارج می‌شود.
.TP 10
.B \-version
این آرگومان نسخه برنامه را چاپ کرده و خارج می‌شود.
.SH "پیش‌فرض‌های X (X DEFAULTS)"
برنامه
.B xrefresh
برای خواندن مقادیر پیش‌فرض از روال
.BR XGetDefault (3)
استفاده می‌کند، بنابراین نام منابع آن همگی با حروف بزرگ نوشته می‌شوند.
.TP 8
.B Black\fP, \fBWhite\fP, \fBSolid\fP, \fBNone\fP, \fBRoot\fP
تعیین می‌کند که از چه نوع پس‌زمینه‌ای برای پنجره استفاده شود.
.TP 8
.B Geometry
ناحیه مورد نظر برای تازه‌سازی را تعیین می‌کند. چندان کاربردی نیست.
.SH "محیط (ENVIRONMENT)"
.TP 8
.B DISPLAY
برای دریافت میزبان و شماره نمایشگر پیش‌فرض استفاده می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.BR X (7)
.SH "گزارش باگ‌ها (BUGS)"
این برنامه باید فقط یک نوع پیش‌فرض برای پس‌زمینه داشته باشد.
.SH "نویسندگان (AUTHORS)"
Jim Gettys, Digital Equipment Corp., MIT Project Athena