office-gobmx/canvas
Stephan Bergmann 9ad252b2e7 Drop o3tl::optional wrapper
...now that macOS builds are guaranteed to have std::optional since
358146bbbd "Bump macOS build baseline to
Xcode 11.3 and macOS 10.14.4".

The change is done mostly mechanically with

> for i in $(git grep -Fl optional); do
>  sed -i -e 's:<o3tl/optional\.hxx>\|\"o3tl/optional\.hxx\":<optional>:' \
>   -e 's/\<o3tl::optional\>/std::optional/g' \
>   -e 's/\<o3tl::make_optional\>/std::make_optional/g' "$i"
> done
> for i in $(git grep -Flw o3tl::nullopt); do
>  sed -i -e 's/\<o3tl::nullopt\>/std::nullopt/g' "$i"
> done

(though that causes some of the resulting

  #include <optional>

to appear at different places relative to other includes than if they had been
added manually), plus a few manual modifications:

* adapt bin/find-unneeded-includes
* adapt desktop/IwyuFilter_desktop.yaml
* remove include/o3tl/optional.hxx
* quote resulting "<"/">" as "&lt;"/"&gt;" in officecfg/registry/cppheader.xsl
* and then solenv/clang-format/reformat-formatted-files

Change-Id: I68833d9f7945e57aa2bc703349cbc5a56b342273
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/89165
Tested-by: Jenkins
Reviewed-by: Stephan Bergmann <sbergman@redhat.com>
2020-02-21 14:50:28 +01:00
..
inc move some canvas/ headers inside the module 2020-02-12 11:57:19 +01:00
opengl
source Drop o3tl::optional wrapper 2020-02-21 14:50:28 +01:00
workben
Executable_canvasdemo.mk
IwyuFilter_canvas.yaml move some canvas/ headers inside the module 2020-02-12 11:57:19 +01:00
Library_cairocanvas.mk move some canvas/ headers inside the module 2020-02-12 11:57:19 +01:00
Library_canvasfactory.mk move some canvas/ headers inside the module 2020-02-12 11:57:19 +01:00
Library_canvastools.mk move some canvas/ headers inside the module 2020-02-12 11:57:19 +01:00
Library_directx9canvas.mk move some canvas/ headers inside the module 2020-02-12 11:57:19 +01:00
Library_gdipluscanvas.mk move some canvas/ headers inside the module 2020-02-12 11:57:19 +01:00
Library_oglcanvas.mk move some canvas/ headers inside the module 2020-02-12 11:57:19 +01:00
Library_simplecanvas.mk move some canvas/ headers inside the module 2020-02-12 11:57:19 +01:00
Library_vclcanvas.mk move some canvas/ headers inside the module 2020-02-12 11:57:19 +01:00
Makefile
Module_canvas.mk
Package_opengl.mk
README
README.vars document CANVAS_SPRITE_BOUNDS 2020-02-17 11:41:14 +01:00
StaticLibrary_directxcanvas.mk move some canvas/ headers inside the module 2020-02-12 11:57:19 +01:00

UNO-based graphics backend, lesser impedance to modern graphics APIs
than vcl.

== The Canvas Framework ==

The canvas framework is the successor of the system GUI and graphics
backend VCL. Basic functionality is available, supplying just as much
features as necessary to provide a VCL-equivalent feature set (except
proper BiDi/CTL support).

The canvas framework consists of the following two modules, canvas and
cppcanvas. Additionally, a new generic graphics tooling is used (but
not exclusively by the canvas, Armin's drawinglayer module also make
use of it), which resides in basegfx.

The UNO API used by the canvas is primarily under
css::rendering, with css::rendering::XCanvas
being the central interface.

== The slideshow engine ==

The slideshow engine has replaced the former Impress-embedded
presentation framework with a fully independent UNO component, and it
is based on the canvas. Some features used there are only available
from canvas, like double-buffering, and hardware-accelerated
alpha-blending (currently not on all platforms).

== Cairo canvas ==

cairo canvas is one of backends of canvas component. canvas is mostly
used for slideshow rendering and also for emf+ rendering. we hoped it
will even be used by drawing layer, but it didn't happen (yet?) for
API look at offapi/com/sun/star/rendering/, the implementation is in
canvas and cppcanvas modules.

cairo canvas backend uses cairo library for rendering. main advantage
is support of alpha transparency and in some cases accelerated
rendering.

the backend itself is quite old and stable, not many changes in that
area lately, mostly changes for emf+ rendering, communication with
vcl and bugfixes

FUTURE work: look at cairo canvas and situation when it is used
(mostly slideshow). TODO there still might be more cases when we
can save some roundtrips when exchanging data with vcl.