.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "yambar\-decorations" "5" "2026\-10\-30"
.PP
.SH NAME
yambar\-decorations \- configuration file
.PP
.SH DESCRIPTION
.PP
Decorations are optional additions to particles, enabling you to
e.\&g.\& change the background color of the entire particle, draw an
underline and so on.\&
.PP
Decorations are applied to the particle'\&s margins as well.\&
.PP
All decorations define their own configuration attributes, and there
are no common attributes.\&
.PP
.SH BACKGROUND
.PP
This decoration sets the particles background color.\&
.PP
.SS CONFIGURATION
.PP
.TS
allbox;l l l lx
l l l lx.
T{
\fBName\fR
T}	T{
\fBType\fR
T}	T{
\fBReq\fR
T}	T{
\fBDescription\fR
T}
T{
color
T}	T{
color
T}	T{
yes
T}	T{
The background color.\& See \fByambar\fR(5) for format.\&
T}
.TE
.sp 1
.SS EXAMPLES
.PP
.nf
.RS 4
content:
  string:
    deco:
      background:
        color: 00ff00ff
.fi
.RE
.PP
.SH UNDERLINE
.PP
This decoration renders a line of configurable size and color at the
bottom of the particle.\&
.PP
.SS CONFIGURATION
.PP
.TS
allbox;l l l lx
l l l lx
l l l lx.
T{
\fBName\fR
T}	T{
\fBType\fR
T}	T{
\fBReq\fR
T}	T{
\fBDescription\fR
T}
T{
size
T}	T{
int
T}	T{
yes
T}	T{
The size (height/thickness) of the line, in pixels
T}
T{
color
T}	T{
color
T}	T{
yes
T}	T{
The color of the line.\& See \fByambar\fR(5) for format.\&
T}
.TE
.sp 1
.SS EXAMPLES
.PP
.nf
.RS 4
content:
  string:
    deco:
      underline:
        size: 2
        color: ff0000ff
.fi
.RE
.PP
.PP
.SH OVERLINE
.PP
Similar to \fIunderline\fR, this decoration renders a line of configurable
size and color at the top of the particle.\&
.PP
.SS CONFIGURATION
.PP
.TS
allbox;l l l lx
l l l lx
l l l lx.
T{
\fBName\fR
T}	T{
\fBType\fR
T}	T{
\fBReq\fR
T}	T{
\fBDescription\fR
T}
T{
size
T}	T{
int
T}	T{
yes
T}	T{
The size (height/thickness) of the line, in pixels
T}
T{
color
T}	T{
color
T}	T{
yes
T}	T{
The color of the line.\& See \fByambar\fR(5) for format.\&
T}
.TE
.sp 1
.SS EXAMPLES
.PP
.nf
.RS 4
content:
  string:
    deco:
      overline:
        size: 2
        color: ff0000ff
.fi
.RE
.PP
.PP
.SH BORDER
.PP
This decoration renders a border of configurable size (i.\&e border
width) around the particle.\&
.PP
.SS CONFIGURATION
.PP
.TS
allbox;l l l lx
l l l lx
l l l lx.
T{
\fBName\fR
T}	T{
\fBType\fR
T}	T{
\fBReq\fR
T}	T{
\fBDescription\fR
T}
T{
color
T}	T{
color
T}	T{
yes
T}	T{
The color of the line.\& See \fByambar\fR(5) for format.\&
T}
T{
size
T}	T{
int
T}	T{
no
T}	T{
Border width, in pixels.\& Defaults to 1px.\&
T}
.TE
.sp 1
.SS EXAMPLES
.PP
.nf
.RS 4
content:
  string:
    deco:
      border:
        size: 2
        color: ff0000ff
.fi
.RE
.PP
.PP
.SH STACK
.PP
This particles combines multiple decorations.\&
.PP
.SS CONFIGURATION
.PP
No configuration attributes available.\& The \fIstack\fR is just a \fBlist\fR of
the decorations that should be combined.\&
.PP
.SS EXAMPLES
.PP
.nf
.RS 4
content:
  string:
    deco:
      stack:
        \- background: \&.\&.\&.
        \- underline: \&.\&.\&.
.fi
.RE
.PP
.SH SEE ALSO
.PP
\fByambar\-particles\fR(5)