WIDTH,HEIGHT,ELE1,ELE2,ELE3,ELE4,ELE5...

به عبارت دیگر، ماتریس به صورت فهرستی از اعداد که با کاما از هم جدا شده‌اند قالب‌بندی می‌شود. دو عدد نخست باید عدد صحیح باشند و عرض و ارتفاع ماتریس را مشخص می‌کنند. این اعداد باید فرد باشند. سپس، width * height - 1 عدد بعدی، مقادیر ماتریس را سطر به سطر، بدون احتساب عنصر مرکزی، مشخص می‌کنند.

عناصر از نوع اعداد ممیز شناور متناهی هستند. ممیز اعشاری باید حتماً . (نقطه) باشد؛ نشانه‌گذاری علمی پشتیبانی نمی‌شود.

عنصر مرکزی بسته به اینکه از --blur-background-fixed استفاده کنید یا خیر، برابر با 1.0 یا متغیر بر اساس میزان کدر بودن خواهد بود. با این حال تنظیم خودکار ضریب محوسازی ممکن است با یک هستهٔ محوسازی سفارشی به خوبی کار نکند.

یک هستهٔ محوسازی گوسی 7x7 (با سیگما = 0.84089642) به این صورت است:

--blur-kern '7,7,0.000003,0.000102,0.000849,0.001723,0.000849,0.000102,0.000003,0.000102,0.003494,0.029143,0.059106,0.029143,0.003494,0.000102,0.000849,0.029143,0.243117,0.493069,0.243117,0.029143,0.000849,0.001723,0.059106,0.493069,0.493069,0.059106,0.001723,0.000849,0.029143,0.243117,0.493069,0.243117,0.029143,0.000849,0.000102,0.003494,0.029143,0.059106,0.029143,0.003494,0.000102,0.000003,0.000102,0.000849,0.001723,0.000849,0.000102,0.000003'

همچنین می‌تواند یکی از هسته‌های از پیش تعریف‌شده باشد: 3x3box (پیش‌فرض)، 5x5box، 7x7box، 3x3gaussian، 5x5gaussian، 7x7gaussian، 9x9gaussian، 11x11gaussian. تمامی هسته‌های گوسی با مقدار سیگما = 0.84089642 تولید شده‌اند. چنانچه نیاز به تولید هسته‌های محوسازی سفارشی پیدا کردید، می‌توانید پیکربندی جدید محوسازی را بررسی کنید (بخش BLUR را ببینید).

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

در ادامه فهرستی از تمام گزینه‌هایی که قواعد پنجره جایگزین آن‌ها شده‌اند آمده است:

--shadow-ignore-shaped, -i, --inactive-opacity=OPACITY, --active-opacity OPACITY, --inactive-opacity-override, --inactive-dim VALUE, --mark-wmwin-focused, --mark-ovredir-focused, --invert-color-include CONDITION, --shadow-exclude CONDITION, --fade-exclude CONDITION, --focus-exclude CONDITION, --rounded-corners-exclude CONDITION, --blur-background-exclude CONDITION, --opacity-rule OPACITY:CONDITION, --corner-radius-rules RADIUS:CONDITION, --window-shader-fg-rule SHADER:CONDITION, --clip-shadow-above CONDITION. و همچنین گزینهٔ فایل پیکربندی wintypes.

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

اگر در حال حاضر از برخی از این گزینه‌ها استفاده می‌کنید و می‌خواهید به قواعد پنجره مهاجرت کنید، یا اگر می‌خواهید رفتار فعلی را حفظ کنید، برای چگونگی تبدیل آن‌ها به بخش Migrating old rules مراجعه کنید.

Condition <- Term ('||' Term)*
Term <- Item ('&&' Item)*
Item <- '!'? Target '@'? ('[' Index ']')? (Operator Pattern)? | '(' Condition ')'

اهداف از پیش‌تعریف‌شدهٔ پشتیبانی‌شده عبارتند از:

اگر مشخصهٔ پنجره باید روی پنجرهٔ کلاینت (client window) جستجو شود، Target می‌تواند با یک علامت اختیاری @ همراه باشد. در غیر این صورت پنجرهٔ قاب (frame window) استفاده خواهد شد.

عملگرهای در دسترس بسته به نوع Target مورد تطبیق تغییر می‌کنند. اگر هدف یک عدد باشد، عملگرها عبارتند از =، >، <، >=، <= و همچنین نقیض آن‌ها که با قرار دادن پیشوند ! قبل از عملگر به دست می‌آید (مانند !=، !> و غیره). اگر هدف یک رشته باشد، عملگرها عبارتند از = (برابری دقیق)، *= (تطبیق زیررشته)، ^= (شروع با)، %= (تطبیق با glob)، ~= (تطبیق با regex)، و همچنین نسخه‌های غیرحساس به بزرگ و کوچکی حروف شامل ?=، *?=، ^?=، %?= و ~?=. عملگرهای رشته‌ای را نیز می‌توان با قرار دادن پیشوند ! قبل از عملگر نقیض کرد (مانند !=، !*= و غیره).

مقدار Pattern یا یک عدد صحیح است یا رشته‌ای که درون علامت‌های نقل‌قول تکی یا دوتایی قرار گرفته است. توالی‌های گریز (escape sequences) به سبک Python-3 برای رشته‌ها پشتیبانی می‌شوند. مقادیر بولی به صورت عدد صحیح تفسیر می‌شوند، بدین معنا که نوشتن true معادل 1 و false معادل 0 است.

# اگر پنجره دارای فوکوس باشد
focused
focused = 1
# اگر پنجره override-redirect نباشد
!override_redirect
override_redirect = false
override_redirect != true
override_redirect != 1
# اگر پنجره یک منو باشد
window_type *= "menu"
_NET_WM_WINDOW_TYPE@ *= "MENU"
# اگر پنجره به عنوان پنهان علامت‌گذاری شده باشد: _NET_WM_STATE شامل _NET_WM_STATE_HIDDEN است
_NET_WM_STATE@[*] = "_NET_WM_STATE_HIDDEN"
# اگر پنجره به عنوان چسبان علامت‌گذاری شده باشد: _NET_WM_STATE شامل اتومی است که شامل
# "sticky" است، بدون در نظر گرفتن بزرگی و کوچکی حروف
_NET_WM_STATE@[*] *?= "sticky"
# اگر نام پنجره شامل "Firefox" باشد، بدون در نظر گرفتن بزرگی و کوچکی حروف
name *?= "Firefox"
_NET_WM_NAME@ *?= "Firefox"
# اگر نام پنجره به "Firefox" ختم شود
name %= "*Firefox"
name ~= "Firefox$"
# اگر پنجره روی پنجرهٔ قاب خود مشخصهٔ _COMPTON_SHADOW با مقدار 0، نوع CARDINAL،
# قالب 32، مقدار 0 داشته باشد
_COMPTON_SHADOW = 0
# اگر سومین مقدار _NET_FRAME_EXTENTS کمتر از 20 باشد، یا هیچ مشخصهٔ
# _NET_FRAME_EXTENTS روی پنجرهٔ کلاینت وجود نداشته باشد
_NET_FRAME_EXTENTS@[2] < 20 || !_NET_FRAME_EXTENTS@
# الگوی اینجا به صورت "dd4" تجزیه خواهد شد
name = "\x64\x64\o64"
# این دو معادل یکدیگر هستند
name = 'Firefox' || name = 'Chromium' && class_i = 'Navigator'
name = 'Firefox' || (name = 'Chromium' && class_i = 'Navigator')

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

نحو پایه‌ای گزینه animations به صورت زیر است:

animations = ({
        triggers = [ ... ];
        suppressions = [ ... ];
        # more options follow
        ...
}, {
        # another animation script
}, ...)

عبارت animations = ( ... ) گزینه animations را روی یک فهرست تنظیم می‌کند که می‌تواند شامل چندین زیرآیتم باشد و هر آیتم یک اسکریپت پویانمایی است. یک اسکریپت پویانمایی، گروهی شامل چندین مدخل است (مانند { key = value; ... }). همه اسکریپت‌های پویانمایی در برخی گزینه‌های مشترک، مانند triggers و suppressions، اشتراک دارند؛ آن‌ها همچنین شامل گزینه‌های دیگری هستند که یا پویانمایی واقعی را تعریف کرده، یا یک پیش‌تنظیم پویانمایی را انتخاب می‌کنند.

in vec2 texcoord;             // texture coordinate of the fragment
uniform float opacity;        // opacity of the window (0.0 - 1.0)
uniform float dim;            // dimming factor of the window (0.0 - 1.0, higher means more dim)
uniform float corner_radius;  // corner radius of the window (pixels)
uniform float border_width;   // estimated border width of the window (pixels)
uniform bool invert_color;    // whether to invert the color of the window
uniform sampler2D tex;        // texture of the window
uniform vec2 effective_size;  // effective dimensions of the texture (repeats pixels if larger than tex)
uniform sampler2D brightness; // estimated brightness of the window, 1x1 texture
uniform float max_brightness; // configured maximum brightness of the window (0.0 - 1.0)
uniform float time;           // time in milliseconds, counting from an unspecified starting point

#version 330
in vec2 texcoord;             // texture coordinate of the fragment
uniform sampler2D tex;        // texture of the window
// Default window post-processing:
// 1) invert color
// 2) opacity / transparency
// 3) max-brightness clamping
// 4) rounded corners
vec4 default_post_processing(vec4 c);
// Default window shader:
// 1) fetch the specified pixel
// 2) apply default post-processing
vec4 window_shader() {
    vec2 texsize = textureSize(tex, 0);
    vec4 c = texture2D(tex, texcoord / texsize, 0);
    return default_post_processing(c);
}

wintypes:
{
  WINDOW_TYPE = { fade = BOOL; shadow = BOOL; opacity = FLOAT; focus = BOOL; blur-background = BOOL; full-shadow = BOOL; clip-shadow-above = BOOL; redir-ignore = BOOL; };
};

استفاده از این روش به هیچ عنوان توصیه نمی‌شود؛ برای روش پیشنهادی تنظیم گزینه‌های مختص پنجره، به بخش قوانین پنجره (WINDOW RULES) مراجعه کنید.

بر اساس استانداردهای مدیر پنجره، یک پنجره می‌تواند چندین نوع مختلف داشته باشد. اما با توجه به محدودیت نحوه پیاده‌سازی wintypes، اگر یک پنجره چندین نوع داشته باشد، برای اعمال گزینه‌های wintypes یکی از آن نوع‌ها به شکل تصادفی انتخاب خواهد شد. باز هم توصیه می‌شود که به جای آن از بخش قوانین پنجره (WINDOW RULES) استفاده کنید.

fade, shadow

opacity

focus

blur-background

full-shadow

clip-shadow-above

redir-ignore

می‌توانید نحوهٔ مات شدن پس‌زمینهٔ پنجره را با استفاده از بخش 'blur' در فایل پیکربندی خود تنظیم کنید. در اینجا یک مثال آورده شده است:

blur:
{
  method = "gaussian";
  size = 10;
  deviation = 5.0;
};

گزینه‌های موجود برای بخش blur عبارت‌اند از:

$ picom --backend glx --vsync

لطفاً گزارش باگ‌ها را ارسال کنید به https://github.com/yshui/picom.

اطلاعات قدیمی در این صفحه راهنما یک باگ محسوب می‌شود.