نام (NAME)

ctwm - مدیر پنجره کلاود تب‌دار برای سامانه پنجره اکس (X11)

خلاصه دستور (SYNOPSIS)

ctwm [(--display | -d) dpy]  [--replace]  [--single]
     [(--file | -f) initfile]  [--cfgchk]  [--dumpcfg]
     [--nom4 | -n]  [(--keep-defs | -k)]  [(--keep | -K) m4file]
     [--verbose | -v]  [--quiet | -q]  [--mono]  [--xrm resource]
     [--version]  [--info]  [--nowelcome | -W]
     [--clientId clid]  [--restore resfname]
     [--help | -h]

توضیحات (DESCRIPTION)

برنامه ctwm یک مدیر پنجره برای سامانه پنجره اکس (X Window System) است. این برنامه قابلیت‌هایی مانند نوارهای عنوان، پنجره‌های شکل‌دار، صفحه‌های مجازی (فضاهای کاری)، چندین شیوه مدیریت آیکون، توابع ماکروی تعریف‌شده توسط کاربر، فوکوس صفحه‌کلید به‌صورت کلیک برای تایپ یا هدایت‌شده با اشاره‌گر، و مقیدسازی‌های سفارشی کلیدها و دکمه‌های اشاره‌گر توسط کاربر را ارائه می‌دهد. این برنامه در واقع همان twm(1) (مدیر پنجره تب‌دار) از توزیع X11 مؤسسه MIT است که برای تطبیق و بهره‌گیری از چندین صفحه مجازی (فضای کاری) اندکی تغییر یافته است. این برنامه به شدت از مدیر پنجره vuewm متعلق به Hewlett-Packard الهام گرفته است. علاوه بر این، ctwm می‌تواند از آیکون‌های رنگی و شکل‌دار، و نگاشت‌های پیکسلی ریشه (pixmap) پس‌زمینه در قالب XPM [اثر Arnaud Le Hors]، قالب JPEG با استفاده از libjpeg و فایل‌های xwd استفاده کند. ctwm را می‌توان برای استفاده از هر ترکیبی از قالب‌های آیکون/پیکس‌مپ فوق کامپایل کرد.

این برنامه معمولاً توسط مدیر نشست یا اسکریپت راه‌انداز کاربر اجرا می‌شود. هنگام استفاده از xdm(1) یا xinit(1) بدون یک مدیر نشست، ctwm معمولاً در پیش‌زمینه به عنوان آخرین کلاینت اجرا می‌شود. در صورت اجرا به این شیوه، خروج از ctwm موجب پایان یافتن نشست X، خاموش شدن کارساز X و خاتمه دادن به فعالیت سایر کلاینت‌های در حال اجرا می‌شود.

به‌طور پیش‌فرض، پنجره‌های برنامه‌ها با یک «قاب» احاطه می‌شوند که دارای یک نوار عنوان در بالا و یک حاشیه ویژه در اطراف پنجره است. نوار عنوان شامل نام پنجره، مستطیلی که هنگام دریافت ورودی صفحه‌کلید روشن می‌شود، و جعبه‌های تابعی موسوم به «دکمه‌های عنوان» در لبه‌های چپ و راست نوار عنوان است که می‌توان عملیات مختلف را به آن‌ها پیوند داد.

فشردن دکمه شماره ۱ اشاره‌گر (معمولاً چپ‌ترین دکمه، مگر اینکه با xmodmap تغییر یافته باشد) روی یک دکمه عنوان، تابع مرتبط با آن دکمه را فراخوانی می‌کند. در رابط پیش‌فرض، پنجره‌ها با کلیک کردن (فشردن و بلافاصله رها کردن) روی دکمه سمت چپ عنوان (که شبیه یک نقطه است) به آیکون تبدیل می‌شوند. در مقابل، پنجره‌ها با کلیک کردن روی آیکون مربوطه یا مدخل آن در مدیر آیکون، از حالت آیکون خارج می‌شوند (توضیحات متغیر ShowIconManager و تابع f.showiconmgr را ببینید).

تغییر اندازه پنجره‌ها با فشردن دکمه سمت راست عنوان (که شبیه گروهی از مربع‌های تودرتو است)، کشیدن اشاره‌گر روی لبه‌ای که قرار است جابه‌جا شود، و رها کردن اشاره‌گر زمانی که طرح کلی پنجره به اندازه دلخواه رسید انجام می‌شود. به همین ترتیب، پنجره‌ها با فشردن اشاره‌گر در ناحیه عنوان یا هایلایت، کشیدن طرح کلی پنجره به مکان جدید و سپس رها کردن در موقعیت مورد نظر جابه‌جا می‌شوند. صرفاً کلیک کردن در ناحیه عنوان یا هایلایت، پنجره را بدون جابه‌جایی بالا می‌آورد (raise).

هنگام ایجاد پنجره‌های جدید، ctwm هرگونه اطلاعات اندازه و مکان درخواست‌شده توسط کاربر را (معمولاً از طریق آرگومان خط فرمان -geometry یا منابع مربوط به هر برنامه) رعایت می‌کند. در غیر این صورت، طرح کلی از اندازه پیش‌فرض پنجره، نوار عنوان آن و خطوطی که پنجره را به یک شبکه ۳در۳ تقسیم کرده و اشاره‌گر را دنبال می‌کنند نمایش داده می‌شود. کلیک کردن دکمه شماره ۱ اشاره‌گر، پنجره را در موقعیت فعلی قرار داده و اندازه پیش‌فرض را به آن می‌دهد. فشردن دکمه شماره ۲ اشاره‌گر (معمولاً دکمه وسط اشاره‌گر) و کشیدن طرح کلی، پنجره را در موقعیت فعلی قرار می‌دهد اما امکان تغییر اندازه اضلاع را همان‌طور که در بالا توضیح داده شد فراهم می‌کند. کلیک کردن دکمه شماره ۳ اشاره‌گر (معمولاً دکمه راست اشاره‌گر)، پنجره را در موقعیت فعلی قرار می‌دهد اما تلاش می‌کند طول آن را به اندازه‌ای افزایش دهد که به پایین صفحه نمایش برسد.

گزینه‌ها (OPTIONS)

ctwm گزینه‌های خط فرمان زیر را می‌پذیرد:

--help, -h

--display=dpy, -d dpy

--replace

--single

--cfgchk

--dumpcfg

--file=filename, -f filename

--verbose, -v

--quiet, -q

--nom4, -n

--keep-defs, -k

--keep=m4file, -K m4file

--mono

--version

--info

--nowelcome, -W

--clientId=clid, --restore=resfname

--xrm=resource

برنامه ctwm از getopt_long() برای تجزیه گزینه‌های خط فرمان استفاده می‌کند. این بدان معناست که آرگومان‌ها را می‌توان هم از طریق --long=arg و --long arg و هم از طریق -l arg و -larg منتقل کرد؛ همچنین آرگومان‌های کوتاه را می‌توان هم به‌صورت دسته‌ای مانند -vnk و هم به‌صورت جداگانه مانند -v -n -k استفاده کرد.

سفارشی‌سازی (CUSTOMIZATION)

بخش عمده‌ای از ظاهر و رفتار ctwm را می‌توان با ایجاد یک فایل راه‌انداز در یکی از مکان‌های زیر کنترل کرد (هنگام شروع ctwm، برای هر صفحه‌ای که مدیریت می‌شود به ترتیب زیر جستجو می‌گردد):

$HOME/.ctwmrc.screennumber

$HOME/.ctwmrc

$HOME/.twmrc.screennumber, $HOME/.twmrc

/usr/etc/system.ctwmrc

اگر هیچ فایل راه‌اندازی یافت نشود، ctwm از پیش‌فرض‌های تعبیه‌شده داخلی که در بالا توضیح داده شد استفاده می‌کند. تنها منبع مورد استفاده توسط ctwm، گزینه bitmapFilePath است که شامل فهرستی از دایرکتوری‌های جداشده با دونقطه برای جستجوی فایل‌های بیت‌مپ می‌باشد (برای اطلاعات بیشتر، راهنمای Athena Widgets و xrdb(1) را ببینید).

فایل‌های راه‌انداز ctwm از نظر منطقی به سه نوع مشخصه تقسیم می‌شوند: متغیرها (Variables)، مقیدسازی‌ها (Bindings) و منوها (Menus). بخش Variables باید در ابتدا قرار گیرد و برای توصیف قلم‌ها، رنگ‌ها، مکان‌نماها، پهنای حاشیه‌ها، محل قرارگیری آیکون‌ها و پنجره‌ها، هایلایت، بالا آمدن خودکار، چیدمان عنوان‌ها، پرش مکان‌نما و استفاده از مدیر آیکون به کار می‌رود. بخش Bindings معمولاً در رتبه دوم قرار دارد و برای تعیین توابعی به کار می‌رود که هنگام فشردن کلیدهای صفحه‌کلید و دکمه‌های اشاره‌گر در پنجره‌ها، آیکون‌ها، عنوان‌ها و قاب‌ها فراخوانی می‌شوند. بخش Menus هرگونه منوی تعریف‌شده توسط کاربر را مشخص می‌کند (حاوی توابعی برای فراخوانی یا دستوراتی برای اجرا).

نام متغیرها و کلمات کلیدی به بزرگی و کوچکی حروف حساس نیستند. رشته‌ها باید درون نویسه‌های نقل‌قول دوگانه (مانند «blue») قرار گیرند و به بزرگی و کوچکی حروف حساس هستند. علامت هش (#) در خارج از رشته باعث می‌شود ادامه خطی که این نویسه در آن ظاهر شده است به عنوان کامنت در نظر گرفته شود.

پیش‌پردازش M4 (M4 PREPROCESSING)

برنامه ctwm می‌تواند از m4(1) برای پیش‌پردازش فایل‌های پیکربندی خود استفاده کند. در دسترس بودن پیش‌پردازش m4 وابسته به گزینه زمان ساخت USE_M4 است (به‌طور پیش‌فرض فعال است)، و می‌توان آن را به‌صورت انتخابی با آرگومان خط فرمان --nom4 غیرفعال کرد.

هنگامی که ctwm راه‌اندازی می‌شود، فایلی را برای ورودی همان‌طور که در بالا توضیح داده شد باز می‌کند. اما پیش از تجزیه، آن فایل را از طریق m4 پردازش می‌کند. بنابراین، می‌توانید از ماکروهای m4 برای انجام عملیات در زمان اجرا استفاده کنید. این ویژگی کار در شرایط استفاده از چندین نمایشگر با مشخصات گوناگون را بسیار آسان می‌کند. به عنوان مثال، اگر می‌خواهید بخش پایینی سمت راست صفحه نمایشگر را به عنوان IconRegion خود تعیین کنید (برای جزئیات بیشتر به بخش مربوط به متغیر IconRegion در ادامه مراجعه کنید)، می‌توانید از دستورالعمل‌های m4 و نمادهای از پیش تعریف‌شده برای محاسبه ناحیه دلخواه خود بهره ببرید. برای نمونه:

define(IRegion, translit(eval(WIDTH/3)*eval(HEIGHT/2)+eval(WIDTH-WIDTH/3)-0, *, x))
IconRegion  "IRegion" SOUTH EAST 75 25

این دستور نیمه پایینی و یک‌سوم سمت راست صفحه را تعریف می‌کند. کد بالا از نمادهایی استفاده می‌کند که توسط ctwm برای m4 از پیش تعریف شده‌اند. نمادهای WIDTH و HEIGHT از جمله مواردی هستند که توسط ctwm محاسبه شده و در یک فایل موقت برای استفاده m4 نوشته می‌شوند.

اگر راهنمای m4(1) را به خوبی مطالعه کرده و به قدرت m4 پی ببرید، درخواهید یافت که این یک ابزار بسیار سودمند و قدرتمند است. با این حال، اگر از هر یک از نمادهایی که توسط m4 از پیش تعریف شده‌اند استفاده کنید، با خطری جدی روبرو خواهید شد! برای مثال، نگارش سان از m4 نماد shift را از پیش تعریف کرده است؛ بنابراین اگر از این نام در فایل .ctwmrc خود استفاده کنید، دچار مشکل خواهید شد.

نمادهای زیر توسط ctwm از پیش تعریف شده‌اند:

متغیرها (VARIABLES)

بسیاری از جنبه‌های رابط کاربری ctwm توسط متغیرهایی کنترل می‌شوند که می‌توان آن‌ها را در فایل راه‌اندازی کاربر تنظیم کرد. برخی از گزینه‌ها صرفاً با حضور یک کلیدواژه خاص فعال یا غیرفعال می‌شوند. گزینه‌های دیگر نیازمند کلیدواژه‌ها، اعداد، رشته‌ها یا فهرست‌هایی از تمام این موارد هستند.

فهرست‌ها درون آکولاد محصور می‌شوند و معمولاً با فاصله خالی یا خط جدید از یکدیگر جدا می‌گردند. برای مثال:

AutoRaise { "emacs" "XTerm" "Xmh" }

یا

AutoRaise
{
    "emacs"
    "XTerm"
    "Xmh"
}

هنگامی که متغیری حاوی فهرستی از رشته‌های نشان‌دهنده پنجره‌ها جستجو می‌شود (برای نمونه جهت تعیین فعال بودن یا نبودن بالا آمدن خودکار پنجره همان‌طور که در بالا نشان داده شد)، رشته باید تطابق دقیق و حساس به حروف کوچک و بزرگ با نام پنجره (که توسط مشخصه‌های گوناگون پنجره، مانند WM_NAME تعیین می‌شود)، نام منبع یا نام کلاس (هر دو توسط مشخصه پنجره WM_CLASS تعیین می‌شوند) داشته باشد. مثال پیشین، بالا آمدن خودکار را برای پنجره‌هایی با نام “emacs” و همچنین هر پنجره xterm (از آنجا که از کلاس “XTerm” هستند) یا پنجره‌های xmh (که از کلاس “Xmh” هستند) فعال می‌کند.

آرگومان‌های رشته‌ای که به عنوان نام فایل تفسیر می‌شوند (متغیرهای Pixmaps، Cursors و IconDirectory را در ادامه ببینید)، در صورتی که کاراکتر اول آن‌ها یک مدک (~) باشد، دایرکتوری کاربر (مشخص‌شده توسط متغیر محیطی HOME) را به ابتدای مسیر اضافه می‌کنند. اگر در عوض، کاراکتر اول یک دونقطه (:) باشد، نام به عنوان ارجاع به یکی از بیت‌مپ‌های داخلی که برای ایجاد نمادهای پیش‌فرض نوار عنوان استفاده می‌شوند، در نظر گرفته می‌شود: :xlogo یا :iconify (هر دو به X مورد استفاده برای دکمه آیکون‌سازی اشاره دارند)، :resize (مربع‌های تودرتو که توسط دکمه تغییر اندازه استفاده می‌شوند) و :question (علامت سوال مورد استفاده برای فایل‌های بیت‌مپ ناموجود).

متغیرهای زیر را می‌توان در ابتدای فایل راه‌اندازی ctwm مشخص کرد. فهرست رشته‌های پیشوند نام پنجره با win-list نشان داده شده‌اند. آرگومان‌های اختیاری درون کروشه نمایش داده شده‌اند:

AlwaysOnTop { win-list }

AlwaysShowWindowWhenMovingFromWorkspaceManager

AlwaysSqueezeToGravity [{ win-list }]

AnimationSpeed speed

AutoFocusToTransients

AutoLower [{ win-list }]

AutoOccupy

AutoPopup [{ win-list }]

AutoPriority

AutoRaise [{ win-list }]

AutoRaiseIcons

AutoRelativeResize

AutoSqueeze { win-list }

BackingStore

BeNiceToColormap

BorderBottom pixels

BorderColor string [{ wincolorlist }]

BorderColor "gray50"
{
    "XTerm" "red"
    "xmh"   "green"
}

BorderLeft pixels

BorderResizeCursors

BorderRight pixels

BorderShadowDepth pixels

BorderTileBackground string [{ wincolorlist }]

BorderTileForeground string [{ wincolorlist }]

BorderTop pixels

BorderWidth pixels

ButtonIndent pixels

CenterFeedbackWindow

ClearShadowContrast contrast

clear.{RGB} = (65535 - color.{RGB}) * (contrast / 100).

ClickToFocus

ClientBorderWidth

Color { colors-list }

Color
{
    MenuBackground      "gray50"
    MenuForeground      "blue"
    BorderColor         "red"    { "XTerm" "yellow" }
    TitleForeground     "yellow"
    TitleBackground     "blue"
}

ConstrainedMoveTime milliseconds

Cursors { cursor-list }

cursorname "string"

cursorname "image" "mask"

Cursors
{
    Frame       "top_left_arrow"
    Title       "top_left_arrow"
    Icon        "top_left_arrow"
    IconMgr     "top_left_arrow"
    Move        "fleur"
    Resize      "fleur"
    Menu        "sb_left_arrow"
    Button      "hand2"
    Wait        "watch"
    Select      "dot"
    Destroy     "pirate"
}

DarkShadowContrast contrast

dark.{RGB}  = color.{RGB} * ((100 - contrast) / 100),

DecorateTransients

DefaultBackground string

DefaultForeground string

DontIconifyByUnmapping { win-list }

DontMoveOff

DontNameDecorations

DontPaintRootWindow

DontSave { win-list }

DontSetInactive { win-list }

DontShowWelcomeWindow

DontSqueezeTitle [{ win-list }]

DontToggleWorkSpaceManagerState

DontWarpCursorInWMap

EWMHIgnore { message-types }

EWMHIgnore
{
    # Window states
    "STATE_MAXIMIZED_VERT"
    "STATE_MAXIMIZED_HORZ"
    "STATE_FULLSCREEN"
    "STATE_SHADED"
    "STATE_ABOVE"
    "STATE_BELOW"
}

ForceFocus [{ win-list }]

ForceIcons

FramePadding pixels

GrabServer

IconBackground string [{ win-list }]

IconBorderColor string [{ win-list }]

IconBorderWidth pixels

IconDirectory string

IconFont string

IconForeground string [{ win-list }]

IconifyByUnmapping [{ win-list }]

IconifyStyle string

IconJustification string

IconManagerBackground string [{ win-list }]

IconManagerDontShow [{ win-list }]

IconManagerFont string

IconManagerForeground string [{ win-list }]

IconManagerGeometry string [ columns ]

IconManagerHighlight string [{ win-list }]

IconManagers { iconmgr-list }

"winname" ["iconname"] "geometry" columns

IconManagers
{
    "XTerm"  "=300x5+800+5"       5
    "myhost" "HDMI2:400x5+100+5"  2
}

IconManagerShadowDepth pixels

IconManagerShow { win-list }

IconMenuDontShow { win-list }

IconRegion geomstring vgrav hgrav gridwidth gridheight [iconjust] [iconregjust] [iconregalign] [{ win-list }]

IconRegionAlignement string

IconRegionJustification string

Icons { win-list }

Icons
{
    "XTerm"  "xterm.icon"
    "xfd"    "xfd_icon"
}

IconSize string

IgnoreCaseInMenuSelection

IgnoreLockModifier

IgnoreModifier

IgnoreModifier { lock m2 }

IgnoreTransient

IgnoreTransient { "Wine" }

InterpolateMenuColors

Menu "mymenu"
{
    "Title"     ("black":"red")     f.title
    "entry1"                        f.nop
    "entry2"                        f.nop
    "entry3"    ("white":"green")   f.nop
    "entry4"                        f.nop
    "entry5"    ("red":"white")     f.nop
}

MakeTitle { win-list }

MapWindowBackground color [{ win-list }]

MapWindowCurrentWorkSpace { border_color [background] [foreground] [bitmap] }

MapWindowDefaultWorkSpace { border_color [background] [foreground] [bitmap] }

MapWindowForeground color [{ win-list }]

MaxIconTitleWidth width

MaxWindowSize string

MenuBackground string

MenuFont string

MenuForeground string

MenuShadowColor string

MenuShadowDepth pixels

MenuTitleBackground string

MenuTitleForeground string

MonitorLayout { monitor-list }

MonitorLayout
{
    # Imagine a 5000x1000 monitor, that we want to split into two 2k wide
    # sections at the far left and right, with a 1k wide section in the
    # middle.
    "Left:2000x1000+0+0"
    "1000x1000+2000+0"       # Middle section unnamed
    "Right:2000x1000+3000+0"
}

define(LeftWidth, eval(WIDTH / 2))dnl
define(RightWidth, eval(WIDTH - LeftWidth))dnl
MonitorLayout
{
    "`AutoL:'LeftWidth`x'HEIGHT`+0+0'"
    "`AutoR:'RightWidth`x'HEIGHT`+'LeftWidth`+0'"
}

Monochrome { colors }

MoveDelta pixels

MovePackResistance pixels

MoveOffResistance pixels

MWMIgnore

MWMIgnore
{
    # en/disable window borders
    "DECOR_BORDER"
    # en/disable titlebars
    "DECOR_TITLE"
}

NoBackingStore

NoBorder { win-list }

NoCaseSensitive

NoDecorateTransients

NoDefaults

NoGrabServer

NoHighlight [{ win-list }]

NoIconTitle [{ win-list }]

NoIconManagerFocus

NoIconManagers

NoImagesInWorkSpaceManager

NoMenuShadows

NoOpaqueMove [{ window-list }]

NoOpaqueResize [{ window-list }]

NoRaiseOnDeiconify

NoRaiseOnMove

NoRaiseOnResize

NoRaiseOnWarp

NoRestartPreviousState

NoSaveUnders

NoShowOccupyAll

NoSortIconManager

NoStackMode [{ win-list }]

NoTitle [{ win-list }]

NoTitleFocus

NoTitleHighlight [{ win-list }]

NoWarpToMenuTitle

        [Window]   win-name  { wspc1 wspc2 ... }
or      Workspace  wspc-name { win1  win2 ...  }

Occupy
{
               "xload"   {"all"}
    Window     "xterm"   {"here" "there" "elsewhere"}
               "xv"      {"images"}
    WorkSpace  "images"  {"xloadimage"}
}

OccupyAll { window-list }

OccupyAll
{
    "xload"
    "xbiff"
    "xconsole"
}

OnTopPriority [Icons] priority [ { win-list } ]

OnTopPriority Icons -1  # place icons a little in the background
OnTopPriority Icons 1   # place mail icons on top of normal windows
{
    "Exmh"
    "xbiff"
}
OnTopPriority 8         # keep these always on top of other windows
{
    "Emacs Icon Manager" "WorkSpaceManager"
    "TWM Icon Manager" "XDaliClock"
}

OpaqueMove [{ window-list }]

OpaqueMoveThreshold threshold

OpaqueResize [{ window-list }]

OpaqueResizeThreshold threshold

OpenWindowTimeout seconds

PackNewWindows

Pixmaps { pixmaps }

Pixmaps
{
        TitleHighlight  "gray1"
#       TitleHighlight  "supman%.xbm"
}

PixmapDirectory path

PixmapDirectory  "/usr/lib/X11/twm"
Icons
{
    "Axe"    "xpm:edit.xpm"
    "xterm"  "xpm:ball%.xpm"
}

PrioritySwitching [Icons] { win-list }

PriorityNotSwitching [Icons] { win-list }

RaiseDelay milliseconds

RaiseOnClick

RaiseOnClickButton button_number

RaiseWhenAutoUnSqueeze

RandomPlacement [ string1 [ string2 ]]

ReallyMoveInWorkspaceManager

ResizeFont string

RestartPreviousState

ReverseCurrentWorkspace

RplaySoundHost string

RplaySounds { sounds-list }

"EventName"   "/file/to/play.wav"

SaveColor { colors-list }

SaveColor
{
    BorderColor
    TitleBackground
    TitleForeground
    "red"
    "green"
    "blue"
}

ShrinkIconTitles

ShortAllWindowsMenus

ShowIconManager

ShowWorkSpaceManager

SloppyFocus

SaveWorkspaceFocus

SortIconManager

SoundHost string

SqueezeTitle [{ squeeze-list }]

"name"  justification num denom

SqueezeTitle
{
    "XTerm"   left    0  0
    "xterm1"  left    1  3
    "xterm2"  left    2  3
    "oclock"  center  1  2
    "emacs"   right   2  2
}

StartIconified { win-list }

StartInButtonState

StartInMapState

StartSqueezed { win-list }

StayUpMenus

StrictWinNameEncoding

SunkFocusWindowTitle

ThreeDBorderWidth pixels

TitleBackground string [{ win-list }]

TitleButtonBorderWidth pixels

TitleButtonShadowDepth pixels

TitleFont string

TitleForeground string [{ win-list }]

TitleJustification string

TitlePadding pixels

TitleShadowDepth pixels

TransientHasOccupation

TransientOnTop percentage

UnknownIcon string

UnmapByMovingFarAway { win-list }

UsePPosition string

UseSunkTitlePixmap

UseThreeDBorders

UseThreeDIconManagers

UseThreeDMenus

UseThreeDTitles

UseThreeDWMap

WarpCursor [{ win-list }]

WarpOnDeIconify { win-list }

WarpOnDeIconify { "Emacs" }

WarpRingOnScreen

WarpToDefaultMenuEntry

WarpUnmapped

WindowGeometries { win-list }

WindowGeometries {
    "Mozilla*"       "1000x800+10+10"
    "jpilot*"        "HDMI1:800x600-0-0"
}

WindowRegion geomstring vgrav hgrav { win-list }

WindowRing [{ win-list }]

WindowRingExclude [{ win-list }]

WMgrButtonShadowDepth depth

WMgrButtonStyle string

WMgrHorizButtonIndent nb_pixels

WMgrVertButtonIndent nb_pixels

WorkSpaceFont string

WorkSpaceManagerGeometry string [ columns ]

WorkSpaceManagerGeometry        "360x60+60-0" 8
WorkSpaceManagerGeometry        "HDMI1:600x30+1235+0" 12

WorkSpaces { workspace-list }

name [{bg-button [fg-button] [bg-root] [fg-root] [pixmap-root]}]

WorkSpaces
{
  "One"   {"#686B9F" "white" "DeepSkyBlue3" "white" "jpeg:shark.jpg"}
  "Two"   {"#619AAE" "white" "firebrick"}
  "Three" {"#727786" "white" "MidnightBlue" "white" "xpm:ball%.xpm"}
  "Four"  {"#727786" "white" "white"        "white"
                                      "|(giftoppm | pnmtoxwd) < 2010.gif"}
  "Five"  {"#727786" "white" "DeepSkyBlue3" "white" "plaid"}
  "Six"   {"#619AAE" "white" "DeepSkyBlue3" "white" "xpm:background1"}
  "Seven" {"#8C5b7A" "white" "chartreuse4"}
  "Eight" {"#686B9F" "white" "MidnightBlue"}
}

XMoveGrid number

XorValue number

YMoveGrid number

Zoom [ count ]

متغیرهای زیر باید پس از تخصیص قلم‌ها تنظیم شوند، بنابراین معمولاً بهتر است آن‌ها را در انتهای بخش متغیرها یا ابتدای بخش مقیدسازی‌ها (bindings) قرار دهید:

ChangeWorkspaceFunction function

DefaultFunction function

DeIconifyFunction function

IconifyFunction function

WindowFunction function

اتصالات (BINDINGS)

پس از تنظیم متغیرهای مورد نظر، می‌توان توابع را به دکمه‌های نوار عنوان (titlebuttons) و دکمه‌های کلید و اشاره‌گر متصل کرد. دکمه‌های نوار عنوان را می‌توان از سمت چپ یا راست اضافه کرد و آن‌ها بر اساس ترتیبی که مشخص شده‌اند، از چپ به راست در نوار عنوان ظاهر می‌شوند. اتصالات دکمه‌های کلید و اشاره‌گر را می‌توان به هر ترتیبی تعیین کرد.

LeftTitleButton "bitmapname" = function

LeftTitleButton "bitmapname" {
    Buttoni = modlist : function
    ...
    Buttonj = function
}

RightTitleButton "bitmapname" = function

RightTitleButton "bitmapname" {
    Buttoni = modlist : function
    ...
    Buttonj = function
}

Buttoni = function

Buttoni = : function

"FP1"   = modlist : context : function
Button1 = modlist : context : function

"F1"    =       : all : f.iconify
"F2"    =       : all : f.raiselower
"F3"    =       : all : f.warpring "next"
"F4"    =       : all : f.warpto "xmh"
"F5"    =       : all : f.warpto "emacs"
"F6"    =       : all : f.colormap "next"
"F7"    =       : all : f.colormap "default"
"F20"   =       : all : f.warptoscreen "next"
"Left"  = m     : all : f.backiconmgr
"Right" = m | s : all : f.forwiconmgr
"Up"    = m     : all : f.upiconmgr
"Down"  = m | s : all : f.downiconmgr

# Open the "top" menu with a Button1 (usually left mouse button) click in
# the root window
Button1 =        : root : f.menu "top"
# Open the "top2" menu with shift-click
Button1 =     s  : root : f.menu "top2"
# And "top3" when control-shift-click
Button1 = c | s  : root : f.menu "top3"

# Pressing "F1" anywhere on the screen will cause all windows with name
# "xterm" to raise themselves.
"F1" = : "xterm" : f.raise

Button1 =   : root          : f.menu "TwmWindows"
Button1 = m : window | icon : f.function "move-or-lower"
Button2 = m : window | icon : f.iconify
Button3 = m : window | icon : f.function "move-or-raise"
Button1 =   : title         : f.function "move-or-raise"
Button2 =   : title         : f.raiselower
Button1 =   : icon          : f.function "move-or-iconify"
Button2 =   : icon          : f.iconify
Button1 =   : iconmgr       : f.iconify
Button2 =   : iconmgr       : f.iconify

Function "move-or-lower"    { f.move f.deltastop f.lower }
Function "move-or-raise"    { f.move f.deltastop f.raise }
Function "move-or-iconify"  { f.move f.deltastop f.iconify }
Function "restore-colormap" { f.colormap "default" f.lower }

"Return" = m : all   : f.altcontext
"n" =        : alter : f.nextworkspace
"p" =        : alter : f.prevworkspace

"Return" = c : all                  : f.altkeymap "1"
"i" =     a1 : window|icon|iconmgr  : f.iconify
"z" =     a1 : window               : f.zoom
"d" =     a1 : window|icon          : f.delete
"o" =     a1 : window|icon          : f.occupy
"r" =     a1 : window|icon          : f.refresh

"Right"  = c|s : all : f.changesize "right +10"
"Left"   = c|s : all : f.changesize "right -10"
"Down"   = c|s : all : f.changesize "bottom +10"
"Up"     = c|s : all : f.changesize "bottom -10"
"F1"     = c|s : all : f.changesize "640x480"
"F2"     = c|s : all : f.changesize "800x600"
"F3"     = c|s : all : f.changesize "1024x768"

Button1 = m1 : title : f.movetitlebar

منوها (MENUS)

توابع را می‌توان با استفاده از منوهای بالاپر (pop-up، هنگامی که به یکی از کلیدهای اشاره‌گر مقید شده باشد) یا کشویی (pull-down، هنگامی که به دکمه نوار عنوان متصل باشد) گروه‌بندی کرد و به صورت تعاملی انتخاب نمود. هر مشخصه منو شامل نام منو آن‌گونه که با f.menu به آن ارجاع داده خواهد شد، رنگ‌های پیش‌فرض و اختیاری پیش‌زمینه و پس‌زمینه، فهرستی از نام آیتم‌ها و توابعی که باید فراخوانی شوند، و رنگ‌های اختیاری پیش‌زمینه و پس‌زمینه برای تک‌تک آیتم‌ها است:

Menu "menuname" [ ("deffg":"defbg") ]
{
    string1  [ ("fg1":"bg1") ]  function1
    string2  [ ("fg2":"bg2") ]  function2
        .
        .
        .
    stringN  [ ("fgN":"bgN") ]  functionN
}

نام menuname به بزرگ و کوچک بودن حروف حساس است. آرگومان‌های اختیاری deffg و defbg رنگ‌های پیش‌زمینه و پس‌زمینه مورد استفاده در نمایشگرهای رنگی را برای برجسته‌سازی آیتم‌های منو مشخص می‌کنند. بخش string هر ورودی منو، متنی خواهد بود که در منو نمایش داده می‌شود. آرگومان‌های اختیاری fgN و bgN رنگ‌های پیش‌زمینه و پس‌زمینه ورودی منو را زمانی که اشاره‌گر روی آن ورودی قرار ندارد، تعیین می‌کنند. این رنگ‌ها فقط در نمایشگرهای رنگی استفاده خواهند شد. حالت پیش‌فرض، استفاده از رنگ‌های تعیین‌شده توسط متغیرهای MenuForeground و MenuBackground است. بخش function ورودی منو یکی از توابع، از جمله هر تابع تعریف‌شده توسط کاربر، یا منوهای تکمیلی است.

اگر نام یک ورودی با یک “*” (ستاره) آغاز شود، این ستاره نمایش داده نخواهد شد و ورودی مربوطه، ورودی پیش‌فرض این منو خواهد بود. هنگامی که یک منو دارای ورودی پیش‌فرض باشد و به عنوان زیرمنوی یک منوی دیگر به کار رود، کنش این ورودی پیش‌فرض هنگامی که این زیرمنو بدون نمایش داده شدن انتخاب شود، به صورت خودکار اجرا خواهد شد. توضیح آن دشوار است، اما درکش ساده است.

آیکون‌ها (ICONS)

برنامه ctwm از چندین روش مختلف برای مدیریت پنجره‌های آیکون‌شده پشتیبانی می‌کند. سبک متداول نگاشت پیکسلی-و-متن (pixmap-and-text) می‌تواند به صورت دستی چیده شود یا به صورت خودکار همان‌طور که در متغیر IconRegion شرح داده شده است، مرتب گردد. علاوه بر این، یک شبکه فشرده از نام آیکون‌ها به نام مدیر آیکون (icon manager)، استفاده بهینه‌تری از فضای صفحه نمایش و همچنین امکان پیمایش بین پنجره‌ها از طریق صفحه‌کلید را فراهم می‌سازد.

مدیر آیکون پنجره‌ای است که شامل نام پنجره‌های انتخاب‌شده یا تمامی پنجره‌های موجود روی صفحه نمایش است. علاوه بر نام پنجره، هنگامی که پنجره آیکون می‌شود، یک دکمه کوچک با نماد پیش‌فرض آیکون در سمت چپ نام نمایش داده خواهد شد. به طور پیش‌فرض، کلیک کردن روی یک ورودی در مدیر آیکون، تابع f.iconify را اجرا می‌کند. برای تغییر کنش‌های انجام‌شده در مدیر آیکون، هنگام تعیین مقیدسازی‌های دکمه و صفحه‌کلید از بستر iconmgr استفاده کنید.

حرکت دادن اشاره‌گر به داخل مدیر آیکون، تمرکز صفحه‌کلید را نیز به پنجره مربوطه هدایت می‌کند (تنظیم مستقیم تمرکز، یا در صورتی که NoTitleFocus تنظیم شده باشد، ارسال رویدادهای مصنوعی). با استفاده از توابع f.upiconmgr، f.downiconmgr، f.lefticonmgr و f.righticonmgr، تمرکز ورودی را می‌توان مستقیماً از طریق صفحه‌کلید میان پنجره‌ها جابه‌جا کرد.

ویژگی‌های پنجره اکس (X WINDOW PROPERTIES)

به عنوان یک مدیر پنجره، ctwm دامنه گسترده‌ای از ویژگی‌ها را روی پنجره‌هایی که مدیریت می‌کند و پنجره‌هایی که می‌سازد، می‌خواند و تنظیم می‌نماید. بیشتر این موارد فراتر از حیطه راهنمای کاربری است. با این حال، چند نکته ارزش ذکر کردن دارد.

xprop -f CTWM_WM_ICON_NAME 8u -set CTWM_WM_ICON_NAME "I hate this window"

صداها (SOUNDS)

اگر با گزینه USE_SOUND کامپایل شده باشد، ctwm قادر است برای هر رویداد X صدایی پخش کند. این کار را می‌توان به دو روش پیکربندی کرد.

از نسخه 4.0.0، صداها را می‌توان در ctwmrc با پارامتر پیکربندی RplaySounds تنظیم کرد. برای جزئیات بخش‌های بالا را ببینید.

اگر آن پارامتر یافت نشود، یا در نسخه‌های قدیمی‌تر، ctwm به دنبال فایل .ctwm-sounds در دایرکتوری خانگی کاربر می‌گردد تا هر رویداد X را به یک فایل صوتی برای پخش پیوند دهد. هر خط در .ctwm-sounds دارای ساختار نحوی زیر است:

{X event}: {sound file}

اگر RplaySounds در فایل پیکربندی داده شده باشد و .ctwm-sounds موجود باشد، یک هشدار صادر خواهد شد و محتویات .ctwm-sounds نادیده گرفته می‌شود. تمام پشتیبانی از .ctwm-sounds در نسخه‌های آینده حذف خواهد شد و تنها روش پیکربندی ctwmrc در دسترس باقی خواهد ماند.

صرف‌نظر از نحوه پیکربندی، رویدادهای شناخته‌شده فعلی X که می‌توان تعیین کرد عبارتند از:

KeyPress
KeyRelease
ButtonPress
ButtonRelease
MotionNotify
EnterNotify
LeaveNotify
FocusIn
FocusOut
KeymapNotify
Expose
GraphicsExpose
NoExpose
VisibilityNotify
CreateNotify
DestroyNotify
UnmapNotify
MapNotify
MapRequest
ReparentNotify
ConfigureNotify
ConfigureRequest
GravityNotify
ResizeRequest
CirculateNotify
CirculateRequest
PropertyNotify
SelectionClear
SelectionRequest
SelectionNotify
ColormapNotify
ClientMessage
MappingNotify

علاوه بر این، دو مورد زیر نیز شناخته می‌شوند و نمایانگر زمانی هستند که ctwm راه‌اندازی یا خاموش می‌شود:

Startup
Shutdown

اشکالات (BUGS)

به جای تمامی فهرست‌های پنجره، می‌بایست از مدیر منابع (resource manager) استفاده می‌شد.

دوبار کلیک بسیار سریع برای دستیابی به تابع جابه‌جایی مقید (constrained move)، گاهی اوقات حتی با اینکه اشاره‌گر حرکت داده نشده است، باعث جابه‌جایی پنجره می‌شود.

اگر IconifyByUnmapping فعال باشد و پنجره‌ها در IconManagerDontShow فهرست شده باشند ولی در DontIconifyByUnmapping نباشند، در صورتی که آیکون شوند و هیچ مقیدسازی به f.menu "TwmWindows" یا f.warpto تنظیم نشده باشد، ممکن است ناپدید یا گم شوند.

فایل‌ها (FILES)

بخش قبلی سفارشی‌سازی را ببینید.

متغیرهای محیطی (ENVIRONMENT VARIABLES)

DISPLAY

HOME

همچنین ببینید (SEE ALSO)

X(1), Xserver(1), xdm(1), xrdb(1)

حق نشر (COPYRIGHT)

بخش‌هایی از حق نشر ۱۹۸۸ متعلق به Evans & Sutherland Computer Corporation؛ بخش‌هایی از حق نشر ۱۹۸۹ متعلق به Hewlett-Packard Company و Massachusetts Institute of Technology است. برای بیانیه کامل حقوق و مجوزها راهنمای X(1) را ببینید.

برای اطلاعات بیشتر فایل COPYRIGHT را در بسته توزیع بررسی کنید.

نویسندگان (AUTHORS)

نسخه (VERSION)

این راهنما برای ctwm نسخه 4.1.0 تهیه شده است.