[librsvg: 7/8] Update the man page for rsvg-convert for the new sizing logic
- From: Marge Bot <marge-bot src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [librsvg: 7/8] Update the man page for rsvg-convert for the new sizing logic
- Date: Fri, 1 Oct 2021 19:08:11 +0000 (UTC)
commit 2cf46310ed5a04fd8d7317e5e41e275461765c53
Author: Federico Mena Quintero <federico gnome org>
Date: Fri Oct 1 13:43:31 2021 -0500
Update the man page for rsvg-convert for the new sizing logic
Part-of: <https://gitlab.gnome.org/GNOME/librsvg/-/merge_requests/595>
rsvg-convert.1 | 23 ++++++++++-------------
1 file changed, 10 insertions(+), 13 deletions(-)
---
diff --git a/rsvg-convert.1 b/rsvg-convert.1
index b4b13ecd..61bb29e6 100644
--- a/rsvg-convert.1
+++ b/rsvg-convert.1
@@ -342,7 +342,8 @@ and
.B --dpi-y
options). For PDF/PS/EPS output, the width/height in physical units define the size of the PDF
unless you specify options for the page size; see
-.B "PAGE SIZE" below.
+.B "SPECIFYING A PAGE SIZE"
+above.
.IP \(bu 2
.B SVG with viewBox only:
.B <svg viewBox="0 0 20 30">
@@ -351,20 +352,16 @@ The size of the
attribute gets used for the pixel size of the image as in the first case above.
.IP \(bu 2
.B SVG with width and height in percentages:
-If the
-.B width
+.B <svg width="100%" height="100%" viewBox="0 0 20 30">
+Percentages are meaningless unless you specify a viewport size with the
+.B --width
and
-.B height
-attributes of the toplevel
-.B <svg>
-element are in percentage units, for example
-.BR width="100%" ,
-then they will be multiplied by the size of the
+.B --height
+options. In their absence,
+.B rsvg-convert
+will just use the size of the
.B viewBox
-attribute. For example,
-.B <svg width="50%" height="100" viewBox="0 0 20 30">
-will be rendered as a 10*30\ pixel PNG.
-.B Note that this behavior may change in the future.
+for the pixel size, as described above.
.IP \(bu 2
.B SVG with no width, height, or viewBox:
.B rsvg-convert
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]