libvirt/docs/logos
Michal Privoznik ac7f3667f2 meson: Work around configure_file(copy:true) deprecation
In our meson scripts, we use configure_file(copy:true) to copy
files from srcdir into builddir. However, as of meson-0.64.0,
this is deprecated [1] in favor of using:

  fs = import('fs')
  fs.copyfile(in, out)

Except, the submodule's new method wasn't introduced until
0.64.0. And since we can't bump the minimal meson version we
require, we have to work with both: new and old versions.

Now, the fun part: fs.copyfile() is not a drop in replacement as
it returns different type (a custom_target object). This is
incompatible with places where we store the configure_file()
retval in a variable to process it further.

While we could just replace 'copy:true' with a dummy
'configuration:...' (say 'configuration: configmake_conf') we
can't do that for binary files (like src/fonts/ or src/images/).

Therefore, places where we are not interested in the retval can
be switched to fs.copyfile() and places where we are interested
in the retval will just use a dummy 'configuration:'.

Except, src/network/meson.build. In here we not just copy the
file but also specify alternative install dir and that's not
something that fs.copyfile() can handle. Yet, using 'copy: true'
is viewed wrong [2].

1: https://mesonbuild.com/Release-notes-for-0-64-0.html#fscopyfile-to-replace-configure_filecopy-true
2: https://github.com/mesonbuild/meson/pull/10042

Signed-off-by: Michal Privoznik <mprivozn@redhat.com>
Reviewed-by: Martin Kletzander <mkletzan@redhat.com>
2023-04-20 15:30:18 +02:00
..
README.rst docs: logos: Turn 'README' into rST, generate an index and link to images 2023-02-15 12:38:45 +01:00
logo-banner-dark-256.png docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-banner-dark-800.png docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-banner-dark.svg docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-banner-light-256.png docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-banner-light-800.png docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-banner-light.svg docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-base.svg docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-square-96.png docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-square-128.png docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-square-192.png docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-square-256.png docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-square-powered-96.png docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-square-powered-128.png docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-square-powered-192.png docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-square-powered-256.png docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-square-powered.svg docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-square.svg docs: add master SVG for libvirt logo 2016-11-11 09:31:10 +00:00
logo-sticker-hexagon.svg docs: add SVGs for sticker logos 2019-08-29 12:46:33 +01:00
logo-sticker-square.svg docs: add SVGs for sticker logos 2019-08-29 12:46:33 +01:00
meson.build meson: Work around configure_file(copy:true) deprecation 2023-04-20 15:30:18 +02:00

README.rst

===================
Libvirt Logo README
===================

The master SVG files were created in InkScape, using the Overpass font from Red
Hat:

   https://overpassfont.org/


.. contents::


Logo formats
============

The following SVG files are provided, along with standard bitmap sizes in PNG
format:

``logo-base.svg``
-----------------

.. image:: logo-base.svg

The basic "sardine tin" graphic used to create the other forms of the
libvirt logo.

The tin is rotated by 20 degrees, so its angle matches the angle of the left
side of the letter "v" in the Overpass font

Never use this logo file directly. It exists merely as a base for building
the other logos

``logo-square.svg``
-------------------

.. image:: logo-square.svg

The minimal square format logo for libvirt. Simply embeds the word "libvirt"
into the basic logo graphic.

This is intended for use where a compact, square format representation of
the logo is required.

Bitmap sizes: 96, 128, 192, 256 px square

- 96px:

.. image:: logo-square-96.png

- 128px:

.. image:: logo-square-128.png

- 192px:

.. image:: logo-square-192.png

- 256px:

.. image:: logo-square-256.png



``logo-square-powered.svg``
---------------------------

.. image:: logo-square-powered.svg

A variant of the square logo for use by 3rd party applications, to advertise
their use of libvirt.

Bitmap sizes: 96, 128, 192, 256 px square

- 96px:

.. image:: logo-square-powered-96.png

- 128px:

.. image:: logo-square-powered-128.png

- 192px:

.. image:: logo-square-powered-192.png

- 256px:

.. image:: logo-square-powered-256.png

``logo-banner-light.svg``
-------------------------

.. image:: logo-banner-light.svg

A wide banner format of the logo. Embeds the words "libvirt virtualization
API" into the basic logo graphic. The text is rendered in a light color, so
suitable for placement over a dark background.

Bitmap sizes: 256x92, 800x286 px

- 256x92px:

.. image:: logo-banner-light-256.png

- 800x286px:

.. image:: logo-banner-light-800.png

``logo-banner-dark.svg``
------------------------

.. image:: logo-banner-dark.svg

A wide banner format of the logo. Embeds the words "libvirt virtualization
API" into the basic logo graphic. The text is rendered in a dark color, so
suitable for placement over a light background.

Bitmap sizes: 256x92, 800x286 px

- 256x92px:

.. image:: logo-banner-dark-256.png

- 800x286px:

.. image:: logo-banner-dark-800.png

``logo-sticker-square.svg``
---------------------------

.. image:: logo-sticker-square.svg

A logo formatted into a square shape with outline, suitable for printing
as a sticker. See https://github.com/terinjokes/StickerConstructorSpec

``logo-sticker-hexagon.svg``
----------------------------

.. image:: logo-sticker-hexagon.svg

A logo formatted into a hexagon shape with outline, suitable for printing
as a sticker. See https://github.com/terinjokes/StickerConstructorSpec

PNG file creation
=================

The bitmap images should not be created in Inkscape, since its anti-aliasing of
the rendered bitmaps is too aggressive, resulting in fuzzy images. Instead the
GIMP is used to create bitmaps as follows:

 - File -> Open, select the SVG file

   When prompted for the image size, enter 1024 as the width and allow height
   to be auto-set based on aspect ratio

 - Image -> Scale Image

   Enter desired final bitmap size and use "Cubic" as scaling method.

 - File -> Export As


It is important to let GIMP render initially at 1024 and then scale down, rather
than rendering directly at the target size, since this the manual scaling step
produces better quality