#LyX 2.2 created this file. For more info see http://www.lyx.org/
\lyxformat 508
\begin_document
\begin_header
\save_transient_properties true
\origin /systemlyxdir/examples/
\textclass scrartcl
\begin_preamble
% if pdflatex is used
\usepackage{ifpdf}
\ifpdf

% set fonts for nicer pdf view
\IfFileExists{lmodern.sty}
 {\usepackage{lmodern}}{}

\fi % end if pdflatex is used

\@ifpackageloaded{babel}{
 % increase link area for cross-references and autoname them,
 \AtBeginDocument{\renewcommand{\ref}[1]{\mbox{\autoref{#1}}}}
 \@ifundefined{extrasenglish}{\usepackage[english]{babel}}{}
 \addto\extrasenglish{%
  \renewcommand*{\equationautorefname}[1]{}%
  \renewcommand{\sectionautorefname}{sec.\negthinspace}%
  \renewcommand{\subsectionautorefname}{sec.\negthinspace}%
  \renewcommand{\subsubsectionautorefname}{sec.\negthinspace}%
 }
}{}
\end_preamble
\options BCOR8mm, most, usenames, dvipsnames
\use_default_options false
\begin_modules
tcolorbox
\end_modules
\maintain_unincluded_children false
\language english
\language_package default
\inputencoding auto
\fontencoding global
\font_roman "default" "default"
\font_sans "default" "default"
\font_typewriter "default" "default"
\font_math "auto" "auto"
\font_default_family default
\use_non_tex_fonts false
\font_sc false
\font_osf false
\font_sf_scale 100 100
\font_tt_scale 100 100
\graphics default
\default_output_format default
\output_sync 0
\bibtex_command bibtex
\index_command default
\paperfontsize 12
\spacing single
\use_hyperref true
\pdf_title "Description of the module tcolorbox"
\pdf_author "Uwe Stöhr"
\pdf_subject "fancy colored boxes"
\pdf_keywords "LyX, tcolorbox, colored boxes"
\pdf_bookmarks true
\pdf_bookmarksnumbered true
\pdf_bookmarksopen true
\pdf_bookmarksopenlevel 3
\pdf_breaklinks false
\pdf_pdfborder true
\pdf_colorlinks true
\pdf_backref false
\pdf_pdfusetitle false
\pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue, pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false, urlbordercolor={1 0 0}"
\papersize a4paper
\use_geometry false
\use_package amsmath 1
\use_package amssymb 1
\use_package cancel 0
\use_package esint 1
\use_package mathdots 1
\use_package mathtools 1
\use_package mhchem 1
\use_package stackrel 0
\use_package stmaryrd 0
\use_package undertilde 0
\cite_engine basic
\cite_engine_type default
\biblio_style plain
\use_bibtopic false
\use_indices false
\paperorientation portrait
\suppress_date true
\justification true
\use_refstyle 0
\notefontcolor #0000ff
\index Index
\shortcut idx
\color #008000
\end_index
\secnumdepth 3
\tocdepth 3
\paragraph_separation skip
\defskip medskip
\quotes_language english
\papercolumns 1
\papersides 1
\paperpagestyle default
\tracking_changes false
\output_changes false
\html_math_output 0
\html_css_as_file 0
\html_be_strict false
\end_header

\begin_body

\begin_layout Title
Description of the module Fancy Colored Boxes
\end_layout

\begin_layout Author
Uwe Stöhr
\end_layout

\begin_layout Standard
With the module 
\emph on
Fancy
\begin_inset space ~
\end_inset

Colored
\begin_inset space ~
\end_inset

Boxes
\emph default
 you have access to a huge variety of colored boxes.
 They are particularly useful for presentations or educational texts where
 you might for example highlight results or equations.
 This document describes how these boxes are used with \SpecialChar LyX
.
\end_layout

\begin_layout Standard
The fancy boxes are generated by the \SpecialChar LaTeX
 package 
\series bold
tcolorbox
\series default
.
 This package has so many features that its manual exceeds 400
\begin_inset space ~
\end_inset

pages.
 \SpecialChar LyX
 can therefore only provide access to its basic features.
 For more advanced features and examples have a loot at the 
\series bold
tcolorbox
\series default
 manual, 
\begin_inset CommandInset citation
LatexCommand cite
key "tcolorbox"

\end_inset

.
\end_layout

\begin_layout Section
Preparation
\end_layout

\begin_layout Standard
At first load the module 
\family sans
Fancy
\begin_inset space ~
\end_inset

Colored
\begin_inset space ~
\end_inset

Boxes
\family default
 in the document settings of your file.
\end_layout

\begin_layout Standard
Add the following options to the document class options in the document
 settings of your file:
\end_layout

\begin_layout Standard

\series bold
most, usenames, dvipsnames
\end_layout

\begin_layout Standard
The option 
\series bold
most
\series default
 loads most of the libraries of the \SpecialChar LaTeX
 package 
\series bold
tcolorbox
\series default
.
 The options 
\series bold
usenames, dvipsnames
\series default
 load additional colors, see Appendix
\begin_inset space ~
\end_inset

C of the 
\emph on
Embedded
\begin_inset space ~
\end_inset

Objects
\emph default
 manual for a list.
\end_layout

\begin_layout Section
Basics
\end_layout

\begin_layout Subsection
Box types
\end_layout

\begin_layout Subsubsection
Static (Standard)
\end_layout

\begin_layout Standard
A static color box is inserted via the menu 
\family sans
Insert\SpecialChar menuseparator
Custom Insets\SpecialChar menuseparator
Color
\begin_inset space ~
\end_inset

Box
\family default
.
\end_layout

\begin_layout Standard
This is a static color box: 
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
A basic color box.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
It has by default a frame with round corners and consumes the full text
 width.
 It can contain several paragraphs and math.
\end_layout

\begin_layout Standard
\begin_inset Note Greyedout
status open

\begin_layout Plain Layout

\series bold
Note:
\series default
 The box can contain forced page breaks but they will be ignored.
 To get breakable boxes, see 
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:Beakable-boxes"

\end_inset

.
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Dynamic
\end_layout

\begin_layout Standard
A dynamic color box is inserted via inset via the menu 
\family sans
Insert\SpecialChar menuseparator
Custom Insets\SpecialChar menuseparator
Dynamic
\begin_inset space ~
\end_inset

Color
\begin_inset space ~
\end_inset

Box
\family default
.
\end_layout

\begin_layout Standard
This is a dynamic color box: 
\begin_inset Flex Dynamic Color Box
status open

\begin_layout Plain Layout
A dynamic color box.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
In contrary to static boxes dynamic boxes cannot have parts, see 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Box-parts"

\end_inset

, and they cannot made breakable but one can set their vertical placement,
 see 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Vertical"

\end_inset

.
 Their width is by default the width of the content.
\end_layout

\begin_layout Subsubsection
Fit
\end_layout

\begin_layout Standard
A fit color box is inserted via the menu 
\family sans
Insert\SpecialChar menuseparator
Custom Insets\SpecialChar menuseparator
Fit
\begin_inset space ~
\end_inset

Color
\begin_inset space ~
\end_inset

Box
\family default
.
\end_layout

\begin_layout Standard
Fit boxes are dynamic boxes but their content is automatically decreased
 or increased to fit into the specified box width and heigh.
 How to specify a width and height is described in 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Geometry"

\end_inset

.
 If no width and height is specified the result is a square box consuming
 the full available width of the page.
 If only a width is specified, the result is a square box.
\end_layout

\begin_layout Standard
These are fit color boxes:
\end_layout

\begin_layout Standard
\begin_inset Flex Fit Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=3cm
\end_layout

\end_inset

A 3
\begin_inset space \thinspace{}
\end_inset

cm wide fit color box with some text.
 A 3
\begin_inset space \thinspace{}
\end_inset

cm wide fit color box with some text.
 A 3
\begin_inset space \thinspace{}
\end_inset

cm wide fit color box with some text.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset Flex Fit Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=5cm, height=3cm
\end_layout

\end_inset

A 5
\begin_inset space \thinspace{}
\end_inset

cm wide and 3
\begin_inset space \thinspace{}
\end_inset

cm high fit color box.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
The examples show that the text will be shrinked to fit into the box but
 it will not be increased.
\end_layout

\begin_layout Subsubsection
Custom
\end_layout

\begin_layout Standard
A custom color box is inserted via the menu 
\family sans
Insert\SpecialChar menuseparator
Custom Insets\SpecialChar menuseparator
Custom Color
\begin_inset space ~
\end_inset

Box
\begin_inset space ~
\end_inset

#
\family default
 where # is the number.
\end_layout

\begin_layout Standard
How to use and customize custom color boxes, see 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:General"

\end_inset

.
\end_layout

\begin_layout Subsection
Titles
\end_layout

\begin_layout Standard
To add a title to a box add an options inset via the menu Insert\SpecialChar menuseparator
Color
\begin_inset space ~
\end_inset

Box
\begin_inset space ~
\end_inset

Options.
 There write 
\series bold
title=
\series default
 followed by your title.
\end_layout

\begin_layout Standard
This is a titled box: 
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A title
\end_layout

\end_inset

A basic box with a title.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
A subtitle is added with the inset 
\family sans
Subtitle
\family default
 via the menu 
\family sans
Insert\SpecialChar menuseparator
Custom Insets
\family default
:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=The title
\end_layout

\end_inset

A basic box with a subtitle.
 
\begin_inset Flex Subtitle
status open

\begin_layout Plain Layout
The subtitle
\end_layout

\end_inset

 The content below the subtitle.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
The title and subtitle text is by default white.
 How to change its color, see 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Title-text"

\end_inset

.
\end_layout

\begin_layout Subsection
Box parts
\begin_inset CommandInset label
LatexCommand label
name "subsec:Box-parts"

\end_inset


\end_layout

\begin_layout Standard
The content of the box can be divided into an upper and a lower part by
 using the environment 
\family sans
Color Box Separator
\family default
 in \SpecialChar LyX
's environment selection combobox.
 The idea behind this is that both parts can be treated and customized separatel
y.
 An application would be that the upper part contains a description and
 the lower part an equation.
\end_layout

\begin_layout Standard
This is a box where the content is separated:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
Upper content
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content
\end_layout

\end_inset


\end_layout

\begin_layout Standard
The separation line can be customized as described in 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Lines"

\end_inset

.
\end_layout

\begin_layout Standard
The separation can also be made side by side with the box option 
\series bold
sidebyside
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
sidebyside
\end_layout

\end_inset

Upper content at the left
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content at the right
\end_layout

\end_inset


\end_layout

\begin_layout Standard
The separation can be made invisible with the box option 
\series bold
lower separated=false
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
sidebyside, lower separated=false
\end_layout

\end_inset

Upper content invisibly separated
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content at the right
\end_layout

\end_inset


\end_layout

\begin_layout Standard
There are several layout skins available for colored boxes, see 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Beamer"

\end_inset

, that affects also the layout of the box parts.
 For example with the box option 
\series bold
beamer
\series default
 the box parts are separated this way:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
beamer
\end_layout

\end_inset

Upper content
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content
\end_layout

\end_inset


\end_layout

\begin_layout Subsection
Lines
\begin_inset CommandInset label
LatexCommand label
name "subsec:Lines"

\end_inset


\end_layout

\begin_layout Standard
To draw a line in a box use the environment 
\family sans
Color Box Line
\family default
.
 The line is by default dashed.
 Note that it is just a line and does not separate box parts!
\end_layout

\begin_layout Standard
This is a box with a line:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
Some text
\end_layout

\begin_layout Color Box Line

\end_layout

\begin_layout Plain Layout
Some text
\end_layout

\end_inset


\end_layout

\begin_layout Standard
The line style can only be changed if a skin is specified, see 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Enhanced"

\end_inset

.
 Then one can use the box option 
\series bold
segmentation style={commands}
\series default
 where 
\series bold
commands
\series default
 are commands to define the style.
 See section 
\family sans
Library
\begin_inset space ~
\end_inset

skins
\family default
 of the 
\series bold
tcolorbox
\series default
 manual for possible commands, 
\begin_inset CommandInset citation
LatexCommand cite
key "tcolorbox"

\end_inset

.
\end_layout

\begin_layout Standard
Here is an example in the 
\emph on
enhanced
\emph default
 skin with a double blue line:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
enhanced, segmentation style={double=white,draw=blue,double distance=1pt,solid}
\end_layout

\end_inset

Some text
\end_layout

\begin_layout Color Box Line

\end_layout

\begin_layout Plain Layout
Some text
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset Newpage newpage
\end_inset


\end_layout

\begin_layout Section
Breakable boxes
\begin_inset CommandInset label
LatexCommand label
name "sec:Beakable-boxes"

\end_inset


\end_layout

\begin_layout Standard
To make a box breakable the option 
\series bold
breakable
\series default
 is added.
 If a page break occurs within a box, the box will get broken this way:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A breakable box, breakable, title after break=continued...
\end_layout

\end_inset

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
In the above example the special title 
\emph on
continued...

\emph default
 was added for the second page of the box with the option 
\series bold
title after break
\series default
.
\end_layout

\begin_layout Standard
If boxes are inside boxes, only the outer box can made breakable.
\end_layout

\begin_layout Standard
\begin_inset Note Greyedout
status open

\begin_layout Plain Layout

\series bold
Note:
\series default
 Dynamic boxes and fit boxes cannot made breakable!
\end_layout

\end_inset


\end_layout

\begin_layout Section
Customization
\end_layout

\begin_layout Subsection
General
\begin_inset CommandInset label
LatexCommand label
name "subsec:General"

\end_inset


\end_layout

\begin_layout Standard
The following subsections show many possibilities to customize boxes.
\end_layout

\begin_layout Standard
To avoid to write the box commands all the time, you can use the environment
 
\family sans
Color
\begin_inset space ~
\end_inset

Box
\begin_inset space ~
\end_inset

Setup
\family default
.
 It is inserted via \SpecialChar LyX
's style selection combobox.
 There you can write all options that should be applied for 
\emph on
all
\emph default
 boxes of the document 
\emph on
following
\emph default
 the environment.
 For example writing there 
\series bold
width=3cm, height=8cm
\series default
 forces all following boxes to have a height of 8
\begin_inset space \thinspace{}
\end_inset

cm and a width of 3
\begin_inset space \thinspace{}
\end_inset

cm.
 However, this is not useful if one needs several box types since the changes
 would affect 
\emph on
all
\emph default
 boxes.
\end_layout

\begin_layout Standard
In most documents one need a few types of boxes and all boxes of a type
 should look identical.
 To achieve this the module 
\emph on
Fancy
\begin_inset space ~
\end_inset

Colored
\begin_inset space ~
\end_inset

Boxes
\emph default
 predefines 5
\begin_inset space ~
\end_inset

different box types which you can customize.
 To change their appearance use the environment 
\family sans
New
\begin_inset space ~
\end_inset

Color
\begin_inset space ~
\end_inset

Box
\begin_inset space ~
\end_inset

Type
\family default
.
 It is inserted via \SpecialChar LyX
's style selection combobox.
\end_layout

\begin_layout Standard
If you want for example a box type that looks like the fancy colored one
 in 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Enhanced"

\end_inset

 use these options in the environment:
\end_layout

\begin_layout Standard

\series bold
enhanced, frame style={left color=red!75!black, right color=blue!75!black},
 interior style={left color=red!20!white, right color=yellow!50!white}
\end_layout

\begin_layout Standard
Into the 
\family sans
Name
\family default
 inset write 
\series bold
cBoxA
\series default
 (cBoxA is custom box type
\begin_inset space ~
\end_inset

1, cBoxB type
\begin_inset space ~
\end_inset

2 etc.).
 Because you want to customize every box of this type (e.
\begin_inset space \thinspace{}
\end_inset

g.
\begin_inset space \space{}
\end_inset

every box should have its own title), you need one argument.
 Therefore add 
\series bold
1
\series default
 into the Arguments inset of the environment.
\end_layout

\begin_layout Standard
\begin_inset Note Greyedout
status open

\begin_layout Plain Layout

\series bold
Note:
\series default
 If you use an argument, the inset 
\family sans
Default Value
\family default
 must also be inserted but left empty!
\end_layout

\end_inset


\end_layout

\begin_layout New Color Box Type
\begin_inset Argument 2
status open

\begin_layout Plain Layout
cBoxA
\end_layout

\end_inset


\begin_inset Argument 3
status open

\begin_layout Plain Layout
1
\end_layout

\end_inset


\begin_inset Argument 4
status open

\begin_layout Plain Layout

\end_layout

\end_inset

enhanced, frame style={left color=red!75!black, right color=blue!75!black},
 interior style={left color=red!20!white, right color=yellow!50!white},
 #1
\end_layout

\begin_layout Standard
This way you defined the box type 
\family sans
Custom
\begin_inset space ~
\end_inset

Color
\begin_inset space ~
\end_inset

Box
\begin_inset space ~
\end_inset

1
\family default
.
 Boxes of this type will look like this:
\end_layout

\begin_layout Standard
\begin_inset Flex Custom Color Box 1
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=Custom box
\end_layout

\end_inset

Custom color box 1
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset

Another example:
\begin_inset Newline newline
\end_inset

Assuming you need a box type that can be numbered, you insert
\end_layout

\begin_layout Standard

\series bold
auto counter, number within=section
\end_layout

\begin_layout Standard
into the 
\family sans
New
\series bold
 
\series default
Box Options
\family default
 inset of the 
\family sans
New
\begin_inset space ~
\end_inset

Color
\begin_inset space ~
\end_inset

Box
\begin_inset space ~
\end_inset

Type
\family default
 environment.
 The 
\family sans
Name
\family default
 is 
\series bold
cBoxB
\series default
, 
\family sans
Arguments
\family default
 is 
\series bold
1
\series default
.
 Now write
\end_layout

\begin_layout Standard

\series bold
colback=red!5!white, colframe=red!75!black, title=Example~
\backslash
thetcbcounter : #1
\end_layout

\begin_layout Standard
into the environment.
 This predefines a title prefix.
 
\series bold

\backslash
tcbcounter
\series default
 is hereby the counter of colored boxes.
 In your 
\family sans
Custom
\begin_inset space ~
\end_inset

Color
\begin_inset space ~
\end_inset

Box
\begin_inset space ~
\end_inset

2
\family default
 you specify the title via the options inset:
\end_layout

\begin_layout New Color Box Type
\begin_inset Argument 1
status open

\begin_layout Plain Layout
auto counter, number within=section
\end_layout

\end_inset


\begin_inset Argument 2
status open

\begin_layout Plain Layout
cBoxB
\end_layout

\end_inset


\begin_inset Argument 3
status open

\begin_layout Plain Layout
1
\end_layout

\end_inset


\begin_inset Argument 4
status open

\begin_layout Plain Layout

\end_layout

\end_inset

colback=red!5!white, colframe=red!75!black, title=Example~
\backslash
thetcbcounter : #1
\end_layout

\begin_layout Standard
\begin_inset Flex Custom Color Box 2
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
Custom numbered title
\end_layout

\end_inset

Custom color box 2
\end_layout

\end_inset


\end_layout

\begin_layout Standard
Note that you must not write 
\series bold
title=
\series default
 because this is already done in the definition.
\end_layout

\begin_layout Standard
You can still customize the box by adding options 
\emph on
behind
\emph default
 the title:
\end_layout

\begin_layout Standard
\begin_inset Flex Custom Color Box 2
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
Bold numbered title, colback=lime, fonttitle=
\backslash
bfseries
\end_layout

\end_inset

Custom color box 2
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset

At last a more advanced example:
\begin_inset Newline newline
\end_inset

Assuming you need the type we just defined as 
\family sans
Custom
\begin_inset space ~
\end_inset

Color
\begin_inset space ~
\end_inset

Box
\begin_inset space ~
\end_inset

2
\family default
 but want to add more than one option.
 This is for example useful for options that require another option before
 in the options list.
\begin_inset Newline newline
\end_inset

Like before, add 
\end_layout

\begin_layout Standard

\series bold
auto counter, number within=section
\end_layout

\begin_layout Standard
into the 
\family sans
New
\series bold
 
\series default
Box Options
\family default
 inset of the 
\family sans
New
\begin_inset space ~
\end_inset

Color
\begin_inset space ~
\end_inset

Box
\begin_inset space ~
\end_inset

Type
\family default
 environment.
 The 
\family sans
Name
\family default
 is 
\series bold
cBoxC
\series default
.
 Now we need 2
\begin_inset space ~
\end_inset

Arguments, 
\family sans
Arguments
\family default
 is therefore 
\series bold
2
\series default
.
 Now write
\end_layout

\begin_layout Standard

\series bold
nobeforeafter, width=#1, square, colframe=orange!50!black, 
\begin_inset Newline newline
\end_inset

title=Example~
\backslash
thetcbcounter : #2
\end_layout

\begin_layout Standard
into the environment.
 In your 
\family sans
Custom
\begin_inset space ~
\end_inset

Color
\begin_inset space ~
\end_inset

Box
\begin_inset space ~
\end_inset

3
\family default
 you specify the width via the 
\family sans
Color Box Options
\family default
 inset and the title (and further options if you like) via the 
\family sans
More Color Box Options
\family default
 inset:
\end_layout

\begin_layout New Color Box Type
\begin_inset Argument 1
status open

\begin_layout Plain Layout
auto counter, number within=section
\end_layout

\end_inset


\begin_inset Argument 2
status open

\begin_layout Plain Layout
cBoxC
\end_layout

\end_inset


\begin_inset Argument 3
status open

\begin_layout Plain Layout
2
\end_layout

\end_inset


\begin_inset Argument 4
status open

\begin_layout Plain Layout

\end_layout

\end_inset

nobeforeafter, width=#1, square, colframe=orange!50!black, title=Example~
\backslash
thetcbcounter : #2
\end_layout

\begin_layout Standard
\begin_inset Flex Custom Color Box 3
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
4cm
\end_layout

\end_inset


\begin_inset Argument 2
status open

\begin_layout Plain Layout
The title
\end_layout

\end_inset

4
\begin_inset space \thinspace{}
\end_inset

cm wide custom color box 3
\end_layout

\end_inset


\begin_inset Flex Custom Color Box 3
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
4cm
\end_layout

\end_inset


\begin_inset Argument 2
status open

\begin_layout Plain Layout
The title, beamer
\end_layout

\end_inset

4
\begin_inset space \thinspace{}
\end_inset

cm wide custom color box 3 with the 
\emph on
beamer
\emph default
 skin
\end_layout

\end_inset


\end_layout

\begin_layout Subsection
Skins
\end_layout

\begin_layout Standard
The \SpecialChar LaTeX
 package 
\series bold
tcolorbox
\series default
 provides different skins.
 For a full list, see the 
\series bold
tcolorbox
\series default
 manual, section 
\family sans
Library
\begin_inset space ~
\end_inset

skins
\family default
, 
\begin_inset CommandInset citation
LatexCommand cite
key "tcolorbox"

\end_inset

.
 Only the most important skins are listed in the following.
\end_layout

\begin_layout Subsubsection
Enhanced
\begin_inset CommandInset label
LatexCommand label
name "subsec:Enhanced"

\end_inset


\end_layout

\begin_layout Standard
This skin is enabled by adding the option enhanced.
 Without further options it looks like the standard skin.
 Its advantage are some extra features like the customization of lines,
 see 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Lines"

\end_inset

 or the ability to have shadows, see 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Shadows"

\end_inset

.
 Another feature is a nicer style of breakable boxes:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=An 
\emph on
enhanced
\emph default
 breakable box, breakable, enhanced
\end_layout

\end_inset

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
 voluptua.
 At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
 sit amet.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
Another feature you might like is to add color gradients with the options
 
\series bold
frame style
\series default
 and 
\series bold
interior style
\series default
.
 Their syntax is
\begin_inset Newline newline
\end_inset


\series bold
frame style={left color=color, right color=color}
\begin_inset Newline newline
\end_inset


\series default
where 
\series bold
color
\series default
 is a color name or definition, see 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Color"

\end_inset

.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=An 
\emph on
enhanced
\emph default
 box with a color gradient, enhanced, frame style={left color=red!75!black,
 right color=blue!75!black}, interior style={left color=red!20!white, right
 color=yellow!50!white}
\end_layout

\end_inset

Upper content
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content
\end_layout

\end_inset


\end_layout

\begin_layout Standard
Alternatively one can use a PNG image as background for boxes with the option
 
\series bold
frame style image=file name
\series default
 where 
\series bold
file
\begin_inset space ~
\end_inset

name
\series default
 is the file name of the image.
\end_layout

\begin_layout Subsubsection
Bicolor
\end_layout

\begin_layout Standard
With this skin the lower content gets another background color than the
 upper part.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A box with the skin 
\emph on
bicolor
\emph default
, bicolor
\end_layout

\end_inset

Upper content
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content
\end_layout

\end_inset


\end_layout

\begin_layout Standard
The color of the lower part can be changed with the option 
\series bold
colbacklower
\series default
.
 See 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Color"

\end_inset

 for color customization.
\end_layout

\begin_layout Subsubsection
Beamer
\begin_inset CommandInset label
LatexCommand label
name "subsec:Beamer"

\end_inset


\end_layout

\begin_layout Standard
This is a skin that simulates the appearance of the beamer presentation
 document class.
 Its appearance can be changed like for the enhanced skin, 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Enhanced"

\end_inset

:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A 
\emph on
beamer
\emph default
 box with a color gradient, beamer, frame style={left color=red!75!black,
 right color=blue!75!black}
\end_layout

\end_inset

Upper content
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Widget
\end_layout

\begin_layout Standard
This skin is like the standard skin but the background colors are automatically
 shaded:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A 
\emph on
widget
\emph default
 box, widget
\end_layout

\end_inset

Upper content
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Empty
\end_layout

\begin_layout Standard
This skin has no colors.
 To make the title visible (because it is by default white) you have to
 change its color, see 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Title-text"

\end_inset

:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A box with the 
\emph on
empty
\emph default
 skin, empty, coltitle=orange
\end_layout

\end_inset

Upper content
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content
\end_layout

\end_inset


\end_layout

\begin_layout Subsection
Placement
\end_layout

\begin_layout Subsubsection
Side by side
\end_layout

\begin_layout Standard
Normally the boxes are a paragraph of its own.
 They will therefore appear by default one upon another separated by vertical
 space.
 To change this behavior, to place for example boxes side by side, use the
 placement options 
\series bold
before=code
\series default
 and 
\series bold
after=code
\series default
.
 By default there is a paragraph break before and after the box.
 By using the options 
\series bold
before=, after=
\series default
 nothing will be added besides the boxes so that they can be places side
 by side:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=3cm, square, valign=center, before=, after=
\end_layout

\end_inset

A 3
\begin_inset space \thinspace{}
\end_inset

cm wide, square box.
\end_layout

\end_inset


\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=3cm, square, valign=center, before=, after=
\end_layout

\end_inset

A 3
\begin_inset space \thinspace{}
\end_inset

cm wide, square box.
\end_layout

\end_inset


\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=3cm, square, valign=center, before=, after=
\end_layout

\end_inset

A 3
\begin_inset space \thinspace{}
\end_inset

cm wide, square box.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
The option 
\series bold
nobeforeafter
\series default
 is an alternative for 
\series bold
before=, after=
\series default
.
\end_layout

\begin_layout Standard
To separate the boxes one can use the normal \SpecialChar LyX
 spacing features like a horizontal
 fill:
\end_layout

\begin_layout Standard
\begin_inset space \hfill{}
\end_inset


\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=3cm, square, valign=center, nobeforeafter
\end_layout

\end_inset

A 3
\begin_inset space \thinspace{}
\end_inset

cm wide, square box.
\end_layout

\end_inset


\begin_inset space \hfill{}
\end_inset


\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=3cm, square, valign=center, nobeforeafter
\end_layout

\end_inset

A 3
\begin_inset space \thinspace{}
\end_inset

cm wide, square box.
\end_layout

\end_inset


\begin_inset space \hfill{}
\end_inset


\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=3cm, square, valign=center, nobeforeafter
\end_layout

\end_inset

A 3
\begin_inset space \thinspace{}
\end_inset

cm wide, square box.
\end_layout

\end_inset


\begin_inset space \hfill{}
\end_inset


\end_layout

\begin_layout Standard
If you prefer \SpecialChar TeX
 code you can alternatively use the option 
\series bold
after=
\backslash
hfill
\series default
 to add a a horizontal fill.
\end_layout

\begin_layout Subsubsection
Floating
\end_layout

\begin_layout Standard
Like for tables and figures in a document it is very helpful if boxes could
 float in the text to be placed at the optimal position.
 This is achieved by the option 
\series bold
float=options
\series default
 where 
\series bold
options
\series default
 are the optional \SpecialChar TeX
 floating placement options 
\begin_inset Quotes eld
\end_inset


\family sans
h
\family default

\begin_inset Quotes erd
\end_inset

, 
\begin_inset Quotes eld
\end_inset


\family sans
t
\family default

\begin_inset Quotes erd
\end_inset

, 
\begin_inset Quotes eld
\end_inset


\family sans
b
\family default

\begin_inset Quotes erd
\end_inset

 and 
\begin_inset Quotes eld
\end_inset


\family sans
p
\family default

\begin_inset Quotes erd
\end_inset

.
 They correspond to the float placement options described in section 
\family sans
Float
\begin_inset space ~
\end_inset

Placement
\family default
 of the 
\emph on
Embedded
\begin_inset space ~
\end_inset

Objects
\emph default
 manual.
 The placement options can be mixed and are inserted without any separation,
 e.
\begin_inset space \thinspace{}
\end_inset

g.
\begin_inset space \space{}
\end_inset


\begin_inset Quotes eld
\end_inset


\family sans
htbp
\family default

\begin_inset Quotes erd
\end_inset

.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A floating box, float, width=5cm, valign=center
\end_layout

\end_inset

A 5
\begin_inset space \thinspace{}
\end_inset

cm wide floating box.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
For floating boxes the options 
\series bold
before=code
\series default
 and 
\series bold
after=code 
\series default
are ignored.
 One can instead insert code with the command 
\series bold
every float=code
\series default
 before the box.
 If the box is breakable the code is inserted before every part of the break
 sequence.
 A typical application is to center the floating box with 
\series bold
every float=
\backslash
centering:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A floating box, float, width=5cm, valign=center, every float=
\backslash
centering
\end_layout

\end_inset

A 5
\begin_inset space \thinspace{}
\end_inset

cm wide floating box.
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Vertical
\begin_inset CommandInset label
LatexCommand label
name "subsec:Vertical"

\end_inset


\end_layout

\begin_layout Standard
The vertical placement of a box in respect to the surrounding text line
 can only be set for dynamic boxes.
 The option 
\series bold
tcbox raise=length
\series default
 raises or lowers the box.
 
\series bold
length
\series default
 is a value.
 The allowed units for values are listed in Appendix
\begin_inset space ~
\end_inset

A of the 
\emph on
Embedded
\begin_inset space ~
\end_inset

Objects
\emph default
 manual.
 The default width is 
\series bold
tcbox raise=0pt
\series default
.
 With the option 
\series bold
tcbox raise base
\series default
 the box is lowered so that the base of the box content matches the base
 of the surrounding line.
\end_layout

\begin_layout Standard
An example:
\end_layout

\begin_layout Standard
A line......
\begin_inset Flex Dynamic Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
tcbox raise base, nobeforeafter
\end_layout

\end_inset

Lowered to base
\end_layout

\end_inset

......
\begin_inset Flex Dynamic Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
nobeforeafter
\end_layout

\end_inset

Default placement
\end_layout

\end_inset

......
\begin_inset Flex Dynamic Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
tcbox raise=1cm, nobeforeafter
\end_layout

\end_inset

Raised 1
\begin_inset space \thinspace{}
\end_inset

cm
\end_layout

\end_inset

...
\end_layout

\begin_layout Subsubsection
Raster
\end_layout

\begin_layout Standard
The easiest way to place boxes in a table-like raster is to put them into
 a raster box.
 The 
\family sans
Raster
\begin_inset space ~
\end_inset

Color
\begin_inset space ~
\end_inset

Box
\family default
 inset is inserted via the menu 
\family sans
Insert\SpecialChar menuseparator
Custom Insets
\family default
.
\end_layout

\begin_layout Standard
The number of columns is specified with the option 
\series bold
raster columns=number
\series default
 where 
\series bold
number
\series default
 is the number of columns.
 All boxes inserted to the raster box will now automatically be output in
 a raster with 3 columns and their width is automatically adjusted.
\end_layout

\begin_layout Standard
\begin_inset Flex Raster Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
raster columns=3
\end_layout

\end_inset


\end_layout

\begin_layout Plain Layout
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A box
\end_layout

\end_inset

A simple box.
\end_layout

\end_inset


\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A box
\end_layout

\end_inset

A simple box.
\end_layout

\end_inset


\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A box
\end_layout

\end_inset

A simple box.
\end_layout

\end_inset


\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A box
\end_layout

\end_inset

A simple box.
\end_layout

\end_inset


\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A box
\end_layout

\end_inset

A simple box.
\end_layout

\end_inset


\end_layout

\end_inset


\end_layout

\begin_layout Standard
For more info about options of the raster color box, please consult the
 
\series bold
tcolorbox
\series default
 manual, section 
\family sans
Library
\begin_inset space ~
\end_inset

raster
\family default
, 
\begin_inset CommandInset citation
LatexCommand cite
key "tcolorbox"

\end_inset

.
\end_layout

\begin_layout Subsection
Geometry
\begin_inset CommandInset label
LatexCommand label
name "subsec:Geometry"

\end_inset


\end_layout

\begin_layout Subsubsection
Width
\end_layout

\begin_layout Subsubsection*
Complete box
\end_layout

\begin_layout Standard
The width of the box is changed with the option 
\series bold
width=length
\series default
 where 
\series bold
length
\series default
 is a value.
 The allowed units for values are listed in Appendix
\begin_inset space ~
\end_inset

A of the 
\emph on
Embedded
\begin_inset space ~
\end_inset

Objects
\emph default
 manual.
 The default width is 
\series bold
width=1
\backslash
linewidth
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=6cm
\end_layout

\end_inset

A 6
\begin_inset space \thinspace{}
\end_inset

cm wide box.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
One can also set a width only for the text of the box with the option 
\series bold
text width=length
\series default
.
 If the width is shorter than required for the text, new lines will be created
 automatically.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
text width=4cm
\end_layout

\end_inset

Some longer text to fill the box with a width of 4
\begin_inset space \thinspace{}
\end_inset

cm.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
One cannot combine 
\series bold
width
\series default
 and 
\series bold
text width
\series default
; only the last given width option is taken into account.
\end_layout

\begin_layout Standard
To extend the width of the box one must use the 
\series bold
width
\series default
 option and can then use the option 
\series bold
add to width=length
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=10cm, add to width=2cm
\end_layout

\end_inset

A 10
\begin_inset space \thinspace{}
\end_inset

cm wide box with additional width of 2
\begin_inset space \thinspace{}
\end_inset

cm.
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection*
Content
\end_layout

\begin_layout Standard
For boxes with parts side by side one can control the width of the box parts
 with the options 
\series bold
sidebyside gap
\series default
, 
\series bold
lefthand width
\series default
, 
\series bold
righthand width
\series default
, 
\series bold
lefthand ratio
\series default
 and 
\series bold
righthand ratio
\series default
.
 The syntax is 
\series bold
sidebyside gap=length
\series default
 where 
\series bold
length
\series default
 is a value.
 The allowed units for the values are listed in Appendix
\begin_inset space ~
\end_inset

A of the 
\emph on
Embedded
\begin_inset space ~
\end_inset

Objects
\emph default
 manual.
 All options require of course the option 
\series bold
sidebyside
\series default
.
\end_layout

\begin_layout Standard

\series bold
sidebyside gap
\series default
 sets the space between the left and the right part:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
sidebyside, sidebyside gap=2cm
\end_layout

\end_inset

Upper content divided by 2
\begin_inset space \thinspace{}
\end_inset

cm
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content
\end_layout

\end_inset


\end_layout

\begin_layout Standard

\series bold
lefthand width
\series default
 and 
\series bold
righthand width
\series default
 set the absolute width of the left and right part, respectively:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
sidebyside, lefthand width=3cm
\end_layout

\end_inset

Upper content with a width of 3
\begin_inset space \thinspace{}
\end_inset

cm
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content
\end_layout

\end_inset


\end_layout

\begin_layout Standard

\series bold
lefthand ratio
\series default
 and 
\series bold
righthand ratio
\series default
 set the relative width of the left and right part, respectively:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
sidebyside, lefthand ratio=0.3
\end_layout

\end_inset

Upper content with a width of 30
\begin_inset space \thinspace{}
\end_inset

% of the box width.
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Height
\begin_inset CommandInset label
LatexCommand label
name "subsec:Height"

\end_inset


\end_layout

\begin_layout Subsubsection*
Complete box
\end_layout

\begin_layout Standard
The height of the box is changed with the option 
\series bold
height=length
\series default
 where 
\series bold
length
\series default
 is a value.
 The default height is the height consumed by the box content.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height=2cm
\end_layout

\end_inset

A 2
\begin_inset space \thinspace{}
\end_inset

cm high box.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
If the specified height is smaller than the one consumed by the content,
 the content will be placed below the box:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height=2mm
\end_layout

\end_inset

A 2
\begin_inset space \thinspace{}
\end_inset

mm high box.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset

With the option 
\series bold
square
\series default
 the height will automatically be set to the same value than the box width.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=3cm, square
\end_layout

\end_inset

A squared box.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset

To extend the height of the box in case the content might consume more height
 than expected one must use the 
\series bold
height
\series default
 option and can then uses the option 
\series bold
height plus=length
\series default
.
 An application would be to set a maximal possible height in case you write
 a book where the spacing is defined and should not be overwritten by any
 value.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height=2cm, height plus=2cm
\end_layout

\end_inset

A 2
\begin_inset space \thinspace{}
\end_inset

cm high box with additional height of 2
\begin_inset space \thinspace{}
\end_inset

cm.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height=2cm, height plus=2cm
\end_layout

\end_inset

A 2
\begin_inset space \thinspace{}
\end_inset

cm high box with additional height of 2
\begin_inset space \thinspace{}
\end_inset

cm.
 Its content consumes 3
\begin_inset space \thinspace{}
\end_inset

cm therefore the box height will also be 3
\begin_inset space \thinspace{}
\end_inset

cm.
 A 2
\begin_inset space \thinspace{}
\end_inset

cm high box with additional height of 2
\begin_inset space \thinspace{}
\end_inset

cm.
 Its content consumes 3
\begin_inset space \thinspace{}
\end_inset

cm therefore the box height will also be 3
\begin_inset space \thinspace{}
\end_inset

cm.
 A 2
\begin_inset space \thinspace{}
\end_inset

cm high box with additional height of 2
\begin_inset space \thinspace{}
\end_inset

cm.
 Its content consumes 3
\begin_inset space \thinspace{}
\end_inset

cm therefore the box height will also be 3
\begin_inset space \thinspace{}
\end_inset

cm.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset

In some cases it might be useful to specify an allowed range for the height
 with the option 
\series bold
height from=min to max
\series default
 where 
\series bold
min
\series default
 and 
\series bold
max
\series default
 are values.
 The height will then be at least the given minimal value or the height
 consumed by the content.
 It does not exceed the maximum, independent of the content:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height from=1cm to 3cm
\end_layout

\end_inset

A box with minimal height of 1
\begin_inset space \thinspace{}
\end_inset

cm and maximal height of 3
\begin_inset space \thinspace{}
\end_inset

cm.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height from=1cm to 3cm
\end_layout

\end_inset

A box with minimal height of 1
\begin_inset space \thinspace{}
\end_inset

cm and maximal height of 3
\begin_inset space \thinspace{}
\end_inset

cm.
 The content consumes more space than 3
\begin_inset space \thinspace{}
\end_inset

cm.
 A box with minimal height of 1
\begin_inset space \thinspace{}
\end_inset

cm and maximal height of 3
\begin_inset space \thinspace{}
\end_inset

cm.
 The content consumes more space than 3
\begin_inset space \thinspace{}
\end_inset

cm.
 A box with minimal height of 1
\begin_inset space \thinspace{}
\end_inset

cm and maximal height of 3
\begin_inset space \thinspace{}
\end_inset

cm.
 The content consumes more space than 3
\begin_inset space \thinspace{}
\end_inset

cm.
 A box with minimal height of 1
\begin_inset space \thinspace{}
\end_inset

cm and maximal height of 3
\begin_inset space \thinspace{}
\end_inset

cm.
 The content consumes more space than 3
\begin_inset space \thinspace{}
\end_inset

cm.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset

With the option 
\series bold
add to height=length
\series default
 one can add defined height to the box.
 To use this the 
\series bold
height
\series default
 option must be added 
\emph on
before
\emph default
 it.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height=1cm, add to height=1cm
\end_layout

\end_inset

A 1
\begin_inset space \thinspace{}
\end_inset

cm high box with 1
\begin_inset space \thinspace{}
\end_inset

cm additional height.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset

With the option 
\series bold
height fill=value
\series default
 one can force the box to consume the rest of the available height of the
 document parts where it is in.
 
\series bold
value
\series default
 can either be 
\series bold
true
\series default
 or 
\series bold
maximum
\series default
.
 The latter works like 
\series bold
true
\series default
 but compresses the content of the page before the box as much as possible
 to maximize the box.
\begin_inset Newline newline
\end_inset

In this example the box is in the main text and therefore consumes the rest
 of the current page:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height fill=true
\end_layout

\end_inset

A box that fills the remaining height of the current page.
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection*
Content
\end_layout

\begin_layout Standard
One can set a height only for the text of the box with the option
\begin_inset Newline newline
\end_inset


\series bold
text height=length
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
text height=1.5cm
\end_layout

\end_inset

A box with 1.5
\begin_inset space \thinspace{}
\end_inset

cm high content.
 Due to the frame separation and the frame width the box height is larger
 than 1.5
\begin_inset space \thinspace{}
\end_inset

cm.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
One cannot combine 
\series bold
height
\series default
 and 
\series bold
text height
\series default
; only the last given width option is taken into account.
\end_layout

\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset

With the options 
\series bold
space=fraction
\series default
, 
\series bold
space to upper
\series default
, 
\series bold
space to lower
\series default
, 
\series bold
space to both
\series default
 and 
\series bold
split=fraction
\series default
 one can specify how the height should be divided between the upper and
 the lower part.
 For the 
\series bold
space
\series default
 option 
\series bold
fraction
\series default
 is the fraction of the additional height (the specified height minus the
 height consumed by the content).
\begin_inset Newline newline
\end_inset

For example 
\series bold
space=0.75
\series default
 adds 75
\begin_inset space \thinspace{}
\end_inset

% of the additional space to the upper part:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height=3cm, space=0.75
\end_layout

\end_inset

A 3
\begin_inset space \thinspace{}
\end_inset

cm high box where 75 % of the additional height is set to the upper content.
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content
\end_layout

\end_inset


\end_layout

\begin_layout Standard

\series bold
space to upper
\series default
 is equal to 
\series bold
space=1
\series default
, 
\series bold
space to lower
\series default
 is equal to 
\series bold
space=0
\series default
, 
\series bold
space to both
\series default
 is equal to 
\series bold
space=0
\series default
.5.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height=3cm, space to upper
\end_layout

\end_inset

A 3
\begin_inset space \thinspace{}
\end_inset

cm high box where all additional height is set to the upper content.
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content
\end_layout

\end_inset


\end_layout

\begin_layout Standard
For the 
\series bold
split
\series default
 option 
\series bold
fraction
\series default
 is the fraction of the complete height (not the additional height).
 Therefore one must be careful if e.
\begin_inset space \thinspace{}
\end_inset

g.
\begin_inset space \space{}
\end_inset

the upper part consumes more height than one set via 
\series bold
split
\series default
:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height=3cm, split=0.1
\end_layout

\end_inset

A 3
\begin_inset space \thinspace{}
\end_inset

cm high box where the height is split by 10
\begin_inset space \thinspace{}
\end_inset

%.
 A 3
\begin_inset space \thinspace{}
\end_inset

cm high box where the height is split by 10
\begin_inset space \thinspace{}
\end_inset

%.
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset

With the option 
\series bold
equal height group=id
\series default
 it is possible to set the same height for all boxes in a group.
 
\series bold
id
\series default
 is a name to reference the group.
 This is for example useful if one has 3
\begin_inset space ~
\end_inset

boxes side by side inside a box:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
adjusted title=ace, width=0.3
\backslash
columnwidth, nobeforeafter, equal height group=A
\end_layout

\end_inset

A box.
\end_layout

\end_inset


\begin_inset space \hfill{}
\end_inset


\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
adjusted title=Grapefruit, width=0.3
\backslash
columnwidth, space to upper, nobeforeafter, equal height group=A
\end_layout

\end_inset

A box with parts.
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content
\end_layout

\end_inset


\begin_inset space \hfill{}
\end_inset


\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
adjusted title=, width=0.3
\backslash
columnwidth, nobeforeafter, equal height group=A
\end_layout

\end_inset

A box with longer text.
 A box with longer text.
 A box with longer text.
 A box with longer text.
 A box with longer text.
\end_layout

\end_inset


\end_layout

\end_inset


\end_layout

\begin_layout Standard
The above example was typeset by adding the option 
\series bold
equal height group=A
\series default
 to all 3
\begin_inset space ~
\end_inset

boxes.
 
\series bold
A
\series default
 is hereby the name of the group.
\end_layout

\begin_layout Standard
If you have a title that needs only a single line, it is recommended to
 use the option 
\series bold
adjusted title
\series default
 instead of 
\series bold
title
\series default
 for all boxes to assure that the title height will be the same for all
 boxes.
 Otherwise the height would be different in the above example because 
\begin_inset Quotes eld
\end_inset

Grapefruit
\begin_inset Quotes erd
\end_inset

 needs more height than 
\begin_inset Quotes eld
\end_inset

ace
\begin_inset Quotes erd
\end_inset

.
\end_layout

\begin_layout Subsubsection
Frame
\end_layout

\begin_layout Standard
The width of the box frame can be changed with the options 
\series bold
toprule
\series default
, 
\series bold
bottomrule
\series default
, 
\series bold
leftrule
\series default
, 
\series bold
rightrule
\series default
 and 
\series bold
titlerule
\series default
.
 Each option changes the corresponding part of the frame.
 The syntax is 
\series bold
toprule=length
\series default
 where 
\series bold
length
\series default
 is a value.
 The allowed units for the values are listed in Appendix
\begin_inset space ~
\end_inset

A of the 
\emph on
Embedded
\begin_inset space ~
\end_inset

Objects
\emph default
 manual.
 The default length for all parts is 0.5
\begin_inset space \thinspace{}
\end_inset

mm.
 To set all frame parts to the same value use the option 
\series bold
boxrule
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
leftrule=3mm, rightrule=4mm, toprule=2mm, bottomrule=1mm
\end_layout

\end_inset

3
\begin_inset space \thinspace{}
\end_inset

mm wide left rule, 4
\begin_inset space \thinspace{}
\end_inset

mm wide right rule, 2
\begin_inset space \thinspace{}
\end_inset

mm top rule and 1
\begin_inset space \thinspace{}
\end_inset

mm bottom rule.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
boxrule=6mm
\end_layout

\end_inset

A box with a 6
\begin_inset space \thinspace{}
\end_inset

mm wide frame line.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
The title rule is the separation between the title and the box content.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A title, titlerule=8mm, colbacktitle=blue
\end_layout

\end_inset

A box with a 8
\begin_inset space \thinspace{}
\end_inset

mm wide title rule.
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Shape
\end_layout

\begin_layout Standard
By default boxes are rectangular with rounded edges.
 The radius of the edges can be changed with the option 
\series bold
arc=length
\series default
 where 
\series bold
length
\series default
 is a value.
 The allowed units for the values are listed in Appendix
\begin_inset space ~
\end_inset

A of the 
\emph on
Embedded
\begin_inset space ~
\end_inset

Objects
\emph default
 manual.
 The default is 
\series bold
arc=1mm
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
arc=0mm
\end_layout

\end_inset

A rectangular box (
\series bold
arc=0
\begin_inset space \thinspace{}
\end_inset

mm
\series default
).
\end_layout

\end_inset


\end_layout

\begin_layout Standard
With the option 
\series bold
outer arc=length
\series default
 one can set the outer radius independently:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
arc=5mm, outer arc=0mm
\end_layout

\end_inset

A box with 
\series bold
arc=5
\begin_inset space \thinspace{}
\end_inset

mm,
\series default
 
\series bold
outer arc=0
\begin_inset space \thinspace{}
\end_inset

mm
\series default
.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
arc=0mm, outer arc=0mm
\end_layout

\end_inset

A really rectangular box (
\series bold
arc
\series default
 
\emph on
and
\emph default
 
\series bold
outer arc=0
\begin_inset space \thinspace{}
\end_inset

mm
\series default
).
 The same can alternatively be achieved with the option 
\series bold
sharp corners=all
\series default
, see below.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset

The general shape can be changed with the options 
\series bold
circular arc
\series default
, 
\series bold
bean arc
\series default
 and 
\series bold
octogon arc
\series default
.
\end_layout

\begin_layout Standard
The option 
\series bold
circular arc
\series default
 sets the edge radius to half of the box width.
 It is therefore required to specify at least the width.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=3.5cm, circular arc
\end_layout

\end_inset

A 3.5
\begin_inset space \thinspace{}
\end_inset

cm wide circular arc box.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
As you can see circular arc box looks ugly when the box is wider than high.
 It is therefore recommended to add the option 
\series bold
square
\series default
, see 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Height"

\end_inset

, to get the same width and height.
 The result is a perfect circle.
 To center the text in the box use the text alignment options described
 in 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Alignment"

\end_inset

.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=4cm, square, valign=center, circular arc
\end_layout

\end_inset

A 4
\begin_inset space \thinspace{}
\end_inset

cm wide circular arc box.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
The option 
\series bold
bean arc
\series default
 sets the edge radius to half of the minimum of the box width and height.
 The result is a semicircle.
 
\series bold
bean arc
\series default
 requires the options 
\series bold
width
\series default
 and 
\series bold
height
\series default
 or 
\series bold
square
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=3.5cm, height=5cm, bean arc, nobeforeafter, valign=center
\end_layout

\end_inset

A 3.5
\begin_inset space \thinspace{}
\end_inset

cm wide, 5
\begin_inset space \thinspace{}
\end_inset

cm high box with 
\series bold
bean arc
\series default
.
\end_layout

\end_inset


\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=5cm, height=3.5cm, bean arc, nobeforeafter, valign=center
\end_layout

\end_inset

A 5
\begin_inset space \thinspace{}
\end_inset

cm wide, 3.5
\begin_inset space \thinspace{}
\end_inset

cm high box with 
\series bold
bean arc
\series default
.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
Using bean arc for a square box leads to the same result as 
\series bold
circular arc
\series default
:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=4cm, square, bean arc, valign=center
\end_layout

\end_inset

A 4
\begin_inset space \thinspace{}
\end_inset

cm wide, square box as bean arc.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
The option 
\series bold
octogon arc
\series default
 is useful to get an octagon.
 For an octagon one needs a square box and the option 
\series bold
arc is angular
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=4cm, square, octogon arc, valign=center, arc is angular
\end_layout

\end_inset

A 4
\begin_inset space \thinspace{}
\end_inset

cm wide, square box with 
\series bold
octogon arc
\series default
.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset Note Greyedout
status open

\begin_layout Plain Layout

\series bold
Note:
\series default
 The option 
\series bold
arc is angular
\series default
 is experimental and might cause problems on some \SpecialChar LaTeX
 systems.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset

It is also possible to change only some of the box edges.
 To make an edge a corner there is the option 
\series bold
sharp corners=position
\series default
 where 
\series bold
position
\series default
 is the position of the edge.
 The positions 
\series bold
northwest
\series default
, 
\series bold
northeast
\series default
, 
\series bold
southwest
\series default
 and 
\series bold
southeast
\series default
 change only the corresponding edge.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
sharp corners=northeast
\end_layout

\end_inset

A box with a corner at the upper right (
\series bold
northeast
\series default
).
\end_layout

\end_inset


\end_layout

\begin_layout Standard
The positions 
\series bold
north
\series default
, 
\series bold
south
\series default
, 
\series bold
east
\series default
, 
\series bold
west
\series default
, 
\series bold
downhill
\series default
 and 
\series bold
uphill
\series default
 change 2
\begin_inset space ~
\end_inset

edges.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=0.4
\backslash
columnwidth,sharp corners=east, nobeforeafter
\end_layout

\end_inset

A box with 2
\begin_inset space ~
\end_inset

corners at the right (
\series bold
east
\series default
).
\end_layout

\end_inset


\begin_inset space \hfill{}
\end_inset


\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
width=0.4
\backslash
columnwidth,sharp corners=uphill, nobeforeafter
\end_layout

\end_inset

A box with 2
\begin_inset space ~
\end_inset

corners, one at the lower left, one at the upper right (
\series bold
uphill
\series default
).
\end_layout

\end_inset


\end_layout

\begin_layout Standard
The position 
\series bold
all
\series default
 change all edges.
\end_layout

\begin_layout Subsection
Alignment
\begin_inset CommandInset label
LatexCommand label
name "subsec:Alignment"

\end_inset


\end_layout

\begin_layout Subsubsection
Horizontal
\end_layout

\begin_layout Standard
The option
\series bold
 halign=alignment
\series default
 sets the alignment for the whole box content if there are not box parts,
 otherwise the options 
\series bold
halign upper
\series default
 and 
\series bold
halign lower
\series default
 can be used.
 The 
\series bold
alignment
\series default
 is one of the following:
\end_layout

\begin_layout Description
right the content is right-aligned
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
halign=right
\end_layout

\end_inset

A right-aligned box.
\end_layout

\end_inset


\end_layout

\begin_layout Description
left the content is left-aligned
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
halign=left
\end_layout

\end_inset

A left-aligned box.
\end_layout

\end_inset


\end_layout

\begin_layout Description
center the content is centered
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
halign=center
\end_layout

\end_inset

A horizontally centered box.
\end_layout

\end_inset


\end_layout

\begin_layout Description
justify the content is justified (is the default value)
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
halign=justify
\end_layout

\end_inset

A justified box.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
An example with box parts:
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
halign upper=left, halign lower=center
\end_layout

\end_inset

Upper content left-aligned
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content centered
\end_layout

\end_inset


\end_layout

\begin_layout Standard
The title alignment can be changed with the option 
\series bold
halign title
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A right-aligned title, halign title=right, halign upper=left, halign
 lower=center
\end_layout

\end_inset

Upper content left-aligned
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content centered
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Vertical
\end_layout

\begin_layout Standard
The vertical alignment can only be changed if the box height is explicitly
 set larger than the height consumed by the box content.
 See 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Height"

\end_inset

 how this is done.
\end_layout

\begin_layout Standard
The option
\series bold
 valign=alignment
\series default
 sets the alignment for the whole box content if there are no box parts,
 otherwise the options 
\series bold
valign upper
\series default
 and 
\series bold
valign lower
\series default
 can be used.
 The 
\series bold
alignment
\series default
 is one of the following:
\end_layout

\begin_layout Description
top the content is top-aligned
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height=2cm, valign=top
\end_layout

\end_inset

A top-aligned box.
\end_layout

\end_inset


\end_layout

\begin_layout Description
bottom the content is bottom-aligned
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height=2cm, valign=bottom
\end_layout

\end_inset

A bottom-aligned box.
\end_layout

\end_inset


\end_layout

\begin_layout Description
center the content is vertically centered
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height=2cm, valign=center
\end_layout

\end_inset

A vertically centered box.
\end_layout

\end_inset


\end_layout

\begin_layout Description
scale the content is vertically scaled to fit the height
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height=2cm, valign=scale
\end_layout

\end_inset

A box with scaled content.
\end_layout

\end_inset


\end_layout

\begin_layout Standard
An example with box parts:
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
height=4cm, space=0.5, valign upper=bottom, valign lower=center
\end_layout

\end_inset

Upper content bottom-aligned
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower content centered
\end_layout

\end_inset


\end_layout

\begin_layout Subsection
Fonts
\end_layout

\begin_layout Standard
The font changing options have the syntax 
\series bold
option=code
\series default
 where 
\series bold
code
\series default
 are \SpecialChar LaTeX
's font changing commands.
 For example the code
\begin_inset Newline newline
\end_inset


\series bold

\backslash
sffamily
\backslash
bfseries
\backslash
large
\series default

\begin_inset Newline newline
\end_inset

makes the font sans-serif, bold and increases the font size to the level
 
\series bold

\backslash
large
\series default
.
\end_layout

\begin_layout Subsubsection
Title 
\end_layout

\begin_layout Standard
The title font can be changed with the option 
\series bold
fonttitle
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A title, fonttitle=
\backslash
sffamily
\backslash
bfseries
\backslash
large
\end_layout

\end_inset

Changed title font
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Text
\end_layout

\begin_layout Standard
The font for the upper and lower part text can be changed with the options
 
\series bold
fontupper
\series default
 and 
\series bold
fontlower
\series default
, respectively.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A title, fontupper=
\backslash
ttfamily, fontlower=
\backslash
small
\end_layout

\end_inset

Changed upper text font
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Changed lower text font
\end_layout

\end_inset


\end_layout

\begin_layout Subsection
Color
\begin_inset CommandInset label
LatexCommand label
name "subsec:Color"

\end_inset


\end_layout

\begin_layout Standard
The color is specified in one of these schemes:
\end_layout

\begin_layout Enumerate

\series bold
Name
\series default

\begin_inset VSpace 3mm
\end_inset


\begin_inset Newline newline
\end_inset

For example 
\series bold
red
\series default
 means
\begin_inset Newline newline
\end_inset

100
\begin_inset space \thinspace{}
\end_inset

% red
\begin_inset Newline newline
\end_inset

An example:
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
colback=red
\end_layout

\end_inset

red
\end_layout

\end_inset


\begin_inset VSpace defskip
\end_inset


\end_layout

\begin_layout Enumerate

\series bold
Name!PercentOfName
\series default

\begin_inset VSpace 3mm
\end_inset


\begin_inset Newline newline
\end_inset

For example 
\series bold
geen!30
\series default
 means
\begin_inset Newline newline
\end_inset

30
\begin_inset space \thinspace{}
\end_inset

% red
\begin_inset Newline newline
\end_inset

70
\begin_inset space \thinspace{}
\end_inset

% white (or 
\begin_inset Quotes eld
\end_inset

transparency
\begin_inset Quotes erd
\end_inset

)
\begin_inset Newline newline
\end_inset

An example:
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
colback=green!30
\end_layout

\end_inset

green!30
\end_layout

\end_inset


\begin_inset VSpace defskip
\end_inset


\end_layout

\begin_layout Enumerate

\series bold
Name1!PercentOfName1!Name2
\series default

\begin_inset VSpace 3mm
\end_inset


\begin_inset Newline newline
\end_inset

For example 
\series bold
red!30!blue
\series default
 means
\begin_inset Newline newline
\end_inset

30
\begin_inset space \thinspace{}
\end_inset

% red
\begin_inset Newline newline
\end_inset

70
\begin_inset space \thinspace{}
\end_inset

% blue
\begin_inset Newline newline
\end_inset

An example:
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
colback=red!30!blue
\end_layout

\end_inset

red!30!blue
\end_layout

\end_inset


\begin_inset VSpace defskip
\end_inset


\end_layout

\begin_layout Enumerate

\series bold
Name1!PercentName1!Name2!PercentName3!Name3
\series default

\begin_inset VSpace 3mm
\end_inset


\begin_inset Newline newline
\end_inset

For example 
\series bold
red!71.4!green!70!blue
\series default
 means
\begin_inset Newline newline
\end_inset


\begin_inset Formula $1-0.70=30\,$
\end_inset

% blue
\begin_inset Newline newline
\end_inset


\begin_inset Formula $\left(1-0.714\right)\cdot0.70=20.02\thinspace$
\end_inset

% green
\begin_inset Newline newline
\end_inset


\begin_inset Formula $0.714\cdot0.70=49.98\thinspace$
\end_inset

% red
\begin_inset Newline newline
\end_inset

An example:
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
colback=red!71.4!green!70!blue
\end_layout

\end_inset

red!71.4!green!70!blue
\end_layout

\end_inset


\begin_inset VSpace defskip
\end_inset


\end_layout

\begin_layout Standard
The possible color names are:
\end_layout

\begin_layout Standard
\noindent
\begin_inset Tabular
<lyxtabular version="3" rows="4" columns="5">
<features tabularvalignment="middle">
<column alignment="left" valignment="top" width="18col%">
<column alignment="left" valignment="top" width="18col%">
<column alignment="left" valignment="top" width="18col%">
<column alignment="left" valignment="top" width="18col%">
<column alignment="left" valignment="top" width="18col%">
<row>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

red
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 red
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

green
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 green
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

blue
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 blue
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

cyan
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 cyan
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

magenta
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 magenta
\end_layout

\end_inset
</cell>
</row>
<row>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

yellow
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 yellow
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

black
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 black
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

gray
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 gray
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

white
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 white
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

darkgray
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 darkgray
\end_layout

\end_inset
</cell>
</row>
<row>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

lightgray
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 lightgray
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

brown
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 brown
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

lime
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 lime
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

olive
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 olive
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

orange
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 orange
\end_layout

\end_inset
</cell>
</row>
<row>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

pink
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 pink
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

purple
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 purple
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

teal
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 teal
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
fcolorbox{black}{
\end_layout

\end_inset

violet
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}{
\end_layout

\end_inset


\begin_inset Phantom Phantom
status open

\begin_layout Plain Layout
W
\end_layout

\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout

}
\end_layout

\end_inset

 violet
\end_layout

\end_inset
</cell>
<cell alignment="left" valignment="top" usebox="none">
\begin_inset Text

\begin_layout Plain Layout

\end_layout

\end_inset
</cell>
</row>
</lyxtabular>

\end_inset


\end_layout

\begin_layout Standard
, and the ones listed in Appendix
\begin_inset space ~
\end_inset

C of the 
\emph on
Embedded
\begin_inset space ~
\end_inset

Objects
\emph default
 manual.
\end_layout

\begin_layout Subsubsection
Background
\end_layout

\begin_layout Standard
The background color is changed with the option 
\series bold
colback
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
colback=red!66!green!70!blue
\end_layout

\end_inset

Background color
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Frame
\end_layout

\begin_layout Standard
The frame color is changed with the option 
\series bold
colframe
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
colframe=red!30!blue
\end_layout

\end_inset

Frame color
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Title background
\end_layout

\begin_layout Standard
The title background color is changed with the option 
\series bold
colbacktitle
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A title, colbacktitle=green!30
\end_layout

\end_inset

Title background color
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Title text
\begin_inset CommandInset label
LatexCommand label
name "subsec:Title-text"

\end_inset


\end_layout

\begin_layout Standard
The color for the title text is changed with the option 
\series bold
coltitle
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
title=A title, coltitle=orange
\end_layout

\end_inset

Title text color
\end_layout

\begin_layout Plain Layout
\begin_inset Flex Subtitle
status open

\begin_layout Plain Layout
The subtitle
\end_layout

\end_inset


\end_layout

\begin_layout Plain Layout
Text
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Complete text
\end_layout

\begin_layout Standard
The color for the complete text is changed with the option 
\series bold
coltext
\series default
.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
coltext=red
\end_layout

\end_inset

Text color
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Upper and lower text
\end_layout

\begin_layout Standard
The color for the upper and lower part text is changed with the option 
\series bold
colupper
\series default
 and 
\series bold
collower
\series default
, respectively.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
colupper=green!30!blue, collower=green!70!blue
\end_layout

\end_inset

Upper text color
\end_layout

\begin_layout Color Box Separator

\end_layout

\begin_layout Plain Layout
Lower text color
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset Newpage newpage
\end_inset


\end_layout

\begin_layout Subsection
Shadows
\begin_inset CommandInset label
LatexCommand label
name "subsec:Shadows"

\end_inset


\end_layout

\begin_layout Standard
Boxes can only be decorated with shadows if a skin is specified, see 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Enhanced"

\end_inset

.
\end_layout

\begin_layout Subsubsection
Shadow
\end_layout

\begin_layout Standard
A shadow is added with the box option 
\series bold
drop shadow=color
\series default
 where 
\series bold
color
\series default
 is a color name or definition, see 
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:Color"

\end_inset

.
 One can omit the color, the shadow color is then black!50!white.
 The option 
\series bold
drop fuzzy shadow
\series default
 creates a semi-transparent shadow.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
enhanced, drop shadow, nobeforeafter
\end_layout

\end_inset

A box with a shadow
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset VSpace defskip
\end_inset


\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
enhanced, drop fuzzy shadow=purple, nobeforeafter
\end_layout

\end_inset

A box with a fuzzy, purple shadow
\end_layout

\end_inset


\end_layout

\begin_layout Standard
The default shadow is placed right below the box.
 For other shadow placements have a look at section 
\family sans
Shadow Option Keys
\family default
 of the 
\series bold
tcolorbox
\series default
 manual, 
\begin_inset CommandInset citation
LatexCommand cite
key "tcolorbox"

\end_inset

.
\end_layout

\begin_layout Subsubsection
Halo
\end_layout

\begin_layout Standard
A halo is added with the box option 
\series bold
halo=size with color
\series default
 where 
\series bold
size
\series default
 is a value and 
\series bold
color
\series default
 is a color name or definition.
 One can omit the size and color, the halo is then 0.9
\begin_inset space \thinspace{}
\end_inset

mm thick and has the color yellow.
 Note that one cannot omit only the size or color, either both is omitted
 or both is specified.
 The option 
\series bold
fuzzy halo
\series default
 creates a semi-transparent halo.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
enhanced, halo, nobeforeafter
\end_layout

\end_inset

A box with a halo
\end_layout

\end_inset


\end_layout

\begin_layout Standard
\begin_inset VSpace defskip
\end_inset


\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
enhanced, fuzzy halo=5mm with green, nobeforeafter
\end_layout

\end_inset

A box with a 5
\begin_inset space \thinspace{}
\end_inset

mm thick, green fuzzy halo
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Generic
\end_layout

\begin_layout Standard
Generic shadows/halos can be created with the box option 
\series bold
shadow
\series default
 or 
\series bold
fuzzy shadow
\series default
.
 For a brief description of these options consult section 
\family sans
Generic Shadows
\family default
 of the 
\series bold
tcolorbox
\series default
 manual, 
\begin_inset CommandInset citation
LatexCommand cite
key "tcolorbox"

\end_inset

.
\end_layout

\begin_layout Standard
\begin_inset Flex Color Box
status open

\begin_layout Plain Layout
\begin_inset Argument 1
status open

\begin_layout Plain Layout
enhanced, title=Double shadow, shadow={-2.5mm}{-2.5mm}{0mm}{fill=blue, opacity=0.25
}, shadow={1.5mm}{1.5mm}{0mm}{fill=red, opacity=0.25}
\end_layout

\end_inset

A box with 2
\begin_inset space ~
\end_inset

generic shadows
\end_layout

\end_inset


\end_layout

\begin_layout Bibliography
\begin_inset CommandInset bibitem
LatexCommand bibitem
key "tcolorbox"

\end_inset


\begin_inset CommandInset href
LatexCommand href
name "Documentation"
target "http://mirrors.ctan.org/macros/latex/contrib/tcolorbox/tcolorbox.pdf"

\end_inset

 of the \SpecialChar LaTeX
 package 
\series bold
tcolorbox
\end_layout

\end_body
\end_document
