From: Matthias Clasen Date: Mon, 18 Apr 2022 15:56:43 +0000 (-0400) Subject: Generate screenshots on the fly X-Git-Tag: archive/raspbian/4.8.3+ds-2+rpi1~3^2~20^2~4^2~214^2~1 X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=a3ac4144658f55d92b68ff7e13c8fd2b9b7b7909;p=gtk4.git Generate screenshots on the fly This commit adds a new meson option -Dupdate_screenshots=true. When it is enabled, and -Dgtk_doc=true is also used, then the build will generate images to include in the API docs from ui files in docs/reference/gtk/images. Note: we still keep a copy of the images in git, in order to allow building without a display connection. To update the images in git, the generated images need to be copied back from the builddir to the srcdir. --- diff --git a/docs/reference/gtk/images/aboutdialog.ui b/docs/reference/gtk/images/aboutdialog.ui new file mode 100644 index 0000000000..651caf83f6 --- /dev/null +++ b/docs/reference/gtk/images/aboutdialog.ui @@ -0,0 +1,16 @@ + + + + GTK Code Demos + 4.8.0 + © 1997-2022 The GTK Team + Program to demonstrate GTK functions + gtk-logo.png + About GTK Code Demos + Peter Mattis +Spencer Kimball +Josh MacDonald +and many more… + + + diff --git a/docs/reference/gtk/images/action-bar.ui b/docs/reference/gtk/images/action-bar.ui new file mode 100644 index 0000000000..3af2a6ba88 --- /dev/null +++ b/docs/reference/gtk/images/action-bar.ui @@ -0,0 +1,47 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 1 + 1 + + + 1 + + + + + + + object-select-symbolic + + + + + call-start-symbolic + + + + + + + + + + diff --git a/docs/reference/gtk/images/appchooserbutton.ui b/docs/reference/gtk/images/appchooserbutton.ui new file mode 100644 index 0000000000..cb8dfc29db --- /dev/null +++ b/docs/reference/gtk/images/appchooserbutton.ui @@ -0,0 +1,43 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + + + text/plain + center + center + + + + + Application Button + + + + + + + + diff --git a/docs/reference/gtk/images/appchooserdialog.ui b/docs/reference/gtk/images/appchooserdialog.ui new file mode 100644 index 0000000000..f355ae2db8 --- /dev/null +++ b/docs/reference/gtk/images/appchooserdialog.ui @@ -0,0 +1,8 @@ + + + + image/png + 200 + 300 + + diff --git a/docs/reference/gtk/images/assistant.ui b/docs/reference/gtk/images/assistant.ui new file mode 100644 index 0000000000..11c3b70d12 --- /dev/null +++ b/docs/reference/gtk/images/assistant.ui @@ -0,0 +1,30 @@ + + + + 0 + 300 + 140 + Assistant + + + Assistant page + 1 + + + Assistant + + + + + + + confirm + + + You sure? + + + + + + diff --git a/docs/reference/gtk/images/box.ui b/docs/reference/gtk/images/box.ui new file mode 100644 index 0000000000..75e5c4a8b7 --- /dev/null +++ b/docs/reference/gtk/images/box.ui @@ -0,0 +1,96 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 10 + 10 + 10 + 10 + vertical + 3 + + + horizontal + 1 + + + + horizontal + 4 + center + center + + + + center + + + + + + center + + + + + ⋯ + + + + + + + + vertical + 4 + center + center + + + + center + + + + + + center + + + + + ⋮ + + + + + + + + + + center + Horizontal and Vertical Boxes + + + + + + + + diff --git a/docs/reference/gtk/images/button.ui b/docs/reference/gtk/images/button.ui new file mode 100644 index 0000000000..9ed81e1860 --- /dev/null +++ b/docs/reference/gtk/images/button.ui @@ -0,0 +1,30 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 1 + 1 + center + center + Button + + + + + + diff --git a/docs/reference/gtk/images/calendar.ui b/docs/reference/gtk/images/calendar.ui new file mode 100644 index 0000000000..5e0651ee9e --- /dev/null +++ b/docs/reference/gtk/images/calendar.ui @@ -0,0 +1,44 @@ + + + + 0 + 0 + + + + + + + vertical + 3 + 1 + 1 + center + center + 10 + 10 + 10 + 10 + + + center + center + + + + + Calendar + + + + + + + + diff --git a/docs/reference/gtk/images/centerbox.ui b/docs/reference/gtk/images/centerbox.ui new file mode 100644 index 0000000000..9d5973f70e --- /dev/null +++ b/docs/reference/gtk/images/centerbox.ui @@ -0,0 +1,63 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 10 + 10 + 20 + 20 + vertical + 3 + + + horizontal + 1 + 1 + fill + + + + center + + + + + + center + + + + + + center + + + + + + + center + Center Box + + + + + + + + diff --git a/docs/reference/gtk/images/check-button.ui b/docs/reference/gtk/images/check-button.ui new file mode 100644 index 0000000000..5a1ad6dfc7 --- /dev/null +++ b/docs/reference/gtk/images/check-button.ui @@ -0,0 +1,43 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + + + 1 + Check Button + + + + + 0 + Check Button + + + + + + + + diff --git a/docs/reference/gtk/images/color-button.ui b/docs/reference/gtk/images/color-button.ui new file mode 100644 index 0000000000..a3894ece10 --- /dev/null +++ b/docs/reference/gtk/images/color-button.ui @@ -0,0 +1,43 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + + + #1e90ff + center + center + + + + + Color Button + + + + + + + + diff --git a/docs/reference/gtk/images/colorchooser.ui b/docs/reference/gtk/images/colorchooser.ui new file mode 100644 index 0000000000..9e7cbeb2d6 --- /dev/null +++ b/docs/reference/gtk/images/colorchooser.ui @@ -0,0 +1,6 @@ + + + + Color Chooser Dialog + + diff --git a/docs/reference/gtk/images/combo-box-entry.ui b/docs/reference/gtk/images/combo-box-entry.ui new file mode 100644 index 0000000000..102f6a5c83 --- /dev/null +++ b/docs/reference/gtk/images/combo-box-entry.ui @@ -0,0 +1,35 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 1 + 1 + center + center + 1 + + + Combo Box Entry + + + + + + + + diff --git a/docs/reference/gtk/images/combo-box-text.ui b/docs/reference/gtk/images/combo-box-text.ui new file mode 100644 index 0000000000..f2fff64fe7 --- /dev/null +++ b/docs/reference/gtk/images/combo-box-text.ui @@ -0,0 +1,33 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 1 + 1 + center + center + + Combo Box Text + + 0 + + + + + + diff --git a/docs/reference/gtk/images/combo-box.ui b/docs/reference/gtk/images/combo-box.ui new file mode 100644 index 0000000000..173ae3ecbd --- /dev/null +++ b/docs/reference/gtk/images/combo-box.ui @@ -0,0 +1,49 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 1 + 1 + center + center + + + + + + + + Combo Box + + + + + + + + + 0 + + + 0 + + + + + + diff --git a/docs/reference/gtk/images/dialog.ui b/docs/reference/gtk/images/dialog.ui new file mode 100644 index 0000000000..9477b6960a --- /dev/null +++ b/docs/reference/gtk/images/dialog.ui @@ -0,0 +1,30 @@ + + + + 0 + 280 + 120 + Dialog + + + Cancel + + + + + Accept + + + + + Content + 1 + center + + + + button_ok + button_cancel + + + diff --git a/docs/reference/gtk/images/drawingarea-content.png b/docs/reference/gtk/images/drawingarea-content.png new file mode 100644 index 0000000000..b9265681e9 Binary files /dev/null and b/docs/reference/gtk/images/drawingarea-content.png differ diff --git a/docs/reference/gtk/images/drawingarea.ui b/docs/reference/gtk/images/drawingarea.ui new file mode 100644 index 0000000000..e41ba3f7e4 --- /dev/null +++ b/docs/reference/gtk/images/drawingarea.ui @@ -0,0 +1,49 @@ + + + + 0 + 0 + + + + + + + vertical + 3 + 1 + 1 + fill + center + 10 + 10 + + + 10 + 10 + + + drawingarea-content.png + center + center + + + + + + + Drawing Area + + + + + + + + diff --git a/docs/reference/gtk/images/drop-down.ui b/docs/reference/gtk/images/drop-down.ui new file mode 100644 index 0000000000..9590ca353a --- /dev/null +++ b/docs/reference/gtk/images/drop-down.ui @@ -0,0 +1,37 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 1 + 1 + center + center + + + + Drop Down + Almost a combo + + + + + + + + + diff --git a/docs/reference/gtk/images/editable-label.ui b/docs/reference/gtk/images/editable-label.ui new file mode 100644 index 0000000000..8e4c5d98bd --- /dev/null +++ b/docs/reference/gtk/images/editable-label.ui @@ -0,0 +1,50 @@ + + + + 0 + 0 + 280 + 120 + editable2 + + + + + + + vertical + 12 + 1 + 1 + center + center + + + Editable Label + + + + + + + + + Editable Label + 1 + + + + + + + + + diff --git a/docs/reference/gtk/images/emojichooser.ui b/docs/reference/gtk/images/emojichooser.ui new file mode 100644 index 0000000000..044a6d510f --- /dev/null +++ b/docs/reference/gtk/images/emojichooser.ui @@ -0,0 +1,6 @@ + + + + 0 + + diff --git a/docs/reference/gtk/images/entry.ui b/docs/reference/gtk/images/entry.ui new file mode 100644 index 0000000000..db7c22ecb6 --- /dev/null +++ b/docs/reference/gtk/images/entry.ui @@ -0,0 +1,34 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 1 + 1 + fill + center + Entry + 10 + 10 + 10 + 10 + + + + + + diff --git a/docs/reference/gtk/images/expander.ui b/docs/reference/gtk/images/expander.ui new file mode 100644 index 0000000000..1bb45c5799 --- /dev/null +++ b/docs/reference/gtk/images/expander.ui @@ -0,0 +1,34 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + Expander + 1 + center + center + + + Hidden Content + + + + + + + + diff --git a/docs/reference/gtk/images/flow-box.ui b/docs/reference/gtk/images/flow-box.ui new file mode 100644 index 0000000000..9968897635 --- /dev/null +++ b/docs/reference/gtk/images/flow-box.ui @@ -0,0 +1,66 @@ + + + + 0 + 0 + 280 + + + + + vertical + 3 + 1 + 1 + + + 2 + 2 + browse + + + Child One + + + + + Child Two + + + + + + + horizontal + 6 + + + Child Three + + + + + 1 + + + + + + + + + + + Flow Box + + + + + + diff --git a/docs/reference/gtk/images/folder.png b/docs/reference/gtk/images/folder.png new file mode 100644 index 0000000000..444d906d2b Binary files /dev/null and b/docs/reference/gtk/images/folder.png differ diff --git a/docs/reference/gtk/images/font-button.ui b/docs/reference/gtk/images/font-button.ui new file mode 100644 index 0000000000..03a5234e75 --- /dev/null +++ b/docs/reference/gtk/images/font-button.ui @@ -0,0 +1,43 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + + + Sans Serif 10 + center + center + + + + + Font Button + + + + + + + + diff --git a/docs/reference/gtk/images/fontchooser.ui b/docs/reference/gtk/images/fontchooser.ui new file mode 100644 index 0000000000..9ffdd8009b --- /dev/null +++ b/docs/reference/gtk/images/fontchooser.ui @@ -0,0 +1,8 @@ + + + + 200 + 300 + Font Chooser Dialog + + diff --git a/docs/reference/gtk/images/frame.ui b/docs/reference/gtk/images/frame.ui new file mode 100644 index 0000000000..9591db2dbd --- /dev/null +++ b/docs/reference/gtk/images/frame.ui @@ -0,0 +1,34 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 10 + 10 + 10 + 10 + 1 + 1 + fill + fill + Frame + + + + + + diff --git a/docs/reference/gtk/images/glarea-content.png b/docs/reference/gtk/images/glarea-content.png new file mode 100644 index 0000000000..dc6367fe5c Binary files /dev/null and b/docs/reference/gtk/images/glarea-content.png differ diff --git a/docs/reference/gtk/images/glarea.ui b/docs/reference/gtk/images/glarea.ui new file mode 100644 index 0000000000..aa9b40dcd5 --- /dev/null +++ b/docs/reference/gtk/images/glarea.ui @@ -0,0 +1,54 @@ + + + + 0 + 0 + 280 + 150 + + + + + + + vertical + 3 + 1 + 1 + fill + center + 10 + 10 + + + 10 + 10 + + + + glarea-content.png + center + center + + + + + + + GL Area + + + + + + + + diff --git a/docs/reference/gtk/images/gnome.png b/docs/reference/gtk/images/gnome.png new file mode 100644 index 0000000000..fbe2a21215 Binary files /dev/null and b/docs/reference/gtk/images/gnome.png differ diff --git a/docs/reference/gtk/images/grid.ui b/docs/reference/gtk/images/grid.ui new file mode 100644 index 0000000000..113f1a4bb4 --- /dev/null +++ b/docs/reference/gtk/images/grid.ui @@ -0,0 +1,101 @@ + + + + 0 + 0 + + + + + + + 10 + 10 + 20 + 20 + vertical + 3 + + + 4 + 4 + center + center + + + + center + + 0 + 0 + + + + + + + center + + 1 + 0 + + + + + + + center + + 0 + 1 + + + + + + + center + + 1 + 1 + + + + + + ⋯ + + 2 + 0 + + + + + + ⋮ + + 0 + 2 + + + + + + + + center + Grid + + + + + + + + diff --git a/docs/reference/gtk/images/headerbar.ui b/docs/reference/gtk/images/headerbar.ui new file mode 100644 index 0000000000..66e7048c7e --- /dev/null +++ b/docs/reference/gtk/images/headerbar.ui @@ -0,0 +1,23 @@ + + + + 0 + 220 + 150 + Header Bar + + + + + bookmark-new-symbolic + + + + + + + 0 + + + + diff --git a/docs/reference/gtk/images/icon-view.ui b/docs/reference/gtk/images/icon-view.ui new file mode 100644 index 0000000000..5d19025104 --- /dev/null +++ b/docs/reference/gtk/images/icon-view.ui @@ -0,0 +1,71 @@ + + + + + + + + + + One + folder.png + + + Two + gnome.png + + + + + 0 + 0 + + + + + + + 10 + 10 + 10 + 10 + vertical + 3 + + + + never + never + 1 + + + 1 + 1 + store + 0 + 1 + horizontal + 0 + + + + + + + Icon View + + + + + + + + diff --git a/docs/reference/gtk/images/image.ui b/docs/reference/gtk/images/image.ui new file mode 100644 index 0000000000..1c8793be90 --- /dev/null +++ b/docs/reference/gtk/images/image.ui @@ -0,0 +1,44 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + + + applications-graphics + large + center + center + + + + + Image + + + + + + + + diff --git a/docs/reference/gtk/images/info-bar.ui b/docs/reference/gtk/images/info-bar.ui new file mode 100644 index 0000000000..b4a784798e --- /dev/null +++ b/docs/reference/gtk/images/info-bar.ui @@ -0,0 +1,40 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 1 + 1 + fill + center + 10 + 10 + 10 + 10 + 1 + info + + + Info Bar + + + + + + + + diff --git a/docs/reference/gtk/images/label.ui b/docs/reference/gtk/images/label.ui new file mode 100644 index 0000000000..a1822964d9 --- /dev/null +++ b/docs/reference/gtk/images/label.ui @@ -0,0 +1,30 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 1 + 1 + center + center + Label + + + + + + diff --git a/docs/reference/gtk/images/levelbar.ui b/docs/reference/gtk/images/levelbar.ui new file mode 100644 index 0000000000..469e76034a --- /dev/null +++ b/docs/reference/gtk/images/levelbar.ui @@ -0,0 +1,45 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + 10 + 10 + fill + center + + + 0.3333 + 1 + fill + + + + + Level Bar + + + + + + + + diff --git a/docs/reference/gtk/images/link-button.ui b/docs/reference/gtk/images/link-button.ui new file mode 100644 index 0000000000..3dce360662 --- /dev/null +++ b/docs/reference/gtk/images/link-button.ui @@ -0,0 +1,31 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 1 + 1 + center + center + Link Button + http://www.gtk.org + + + + + + diff --git a/docs/reference/gtk/images/list-and-tree.ui b/docs/reference/gtk/images/list-and-tree.ui new file mode 100644 index 0000000000..aa290bb7bb --- /dev/null +++ b/docs/reference/gtk/images/list-and-tree.ui @@ -0,0 +1,81 @@ + + + + + + + + + + + Line One + False + A + + + Line Two + True + B + + Line Three + False + C + + + + + + 0 + 0 + 280 + 120 + + + + + 1 + 1 + store + + + List + + + + 0 + + + + + + + and + + + + 1 + + + + + + + Tree + + + + 2 + + + + + 0 + 0 + + + + diff --git a/docs/reference/gtk/images/list-box.ui b/docs/reference/gtk/images/list-box.ui new file mode 100644 index 0000000000..18b3983207 --- /dev/null +++ b/docs/reference/gtk/images/list-box.ui @@ -0,0 +1,96 @@ + + + + 0 + 0 + 280 + 120 + + + + + vertical + 3 + 1 + 1 + + + single + + + 0 + + + 1 + center + List Box + + + + + + + horizontal + 10 + + + 1 + Line One + 0 + + + + + 1 + + + + + + + horizontal + 10 + + + 1 + Line Two + 0 + + + + + 2 + + + + + + + horizontal + 10 + + + Line Three + 0 + + + + + 1 + end + + + + + + + + + + diff --git a/docs/reference/gtk/images/media-controls.ui b/docs/reference/gtk/images/media-controls.ui new file mode 100644 index 0000000000..480012231c --- /dev/null +++ b/docs/reference/gtk/images/media-controls.ui @@ -0,0 +1,51 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 0 + file:///home/mclasen/Sources/gtk-master/docs/reference/gtk/images/gtk-logo.webm + + + + + vertical + 3 + 1 + 1 + center + center + + + center + center + + video + + + + + + Media Controls + + + + + + + + diff --git a/docs/reference/gtk/images/menu-button.ui b/docs/reference/gtk/images/menu-button.ui new file mode 100644 index 0000000000..8039dfc85c --- /dev/null +++ b/docs/reference/gtk/images/menu-button.ui @@ -0,0 +1,44 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + + + emblem-system-symbolic + + center + center + + + + + Menu Button + + + + + + + + diff --git a/docs/reference/gtk/images/menu.ui b/docs/reference/gtk/images/menu.ui new file mode 100644 index 0000000000..12bc173a60 --- /dev/null +++ b/docs/reference/gtk/images/menu.ui @@ -0,0 +1,38 @@ + + + +
+ + Style +
+ + Item + +
+
+ + Transition + misc.toggle-visibility + +
+
+ + Inspector + + + About + text.redo + +
+
+ + + + 0 + model + center + center + + + +
diff --git a/docs/reference/gtk/images/menubar.ui b/docs/reference/gtk/images/menubar.ui new file mode 100644 index 0000000000..7c42da8237 --- /dev/null +++ b/docs/reference/gtk/images/menubar.ui @@ -0,0 +1,54 @@ + + + + + File + + + Edit + + + View + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + + + model + center + center + + + + + Menu Bar + + + + + + + + diff --git a/docs/reference/gtk/images/meson.build b/docs/reference/gtk/images/meson.build new file mode 100644 index 0000000000..d3bff0ce3f --- /dev/null +++ b/docs/reference/gtk/images/meson.build @@ -0,0 +1,91 @@ +# commented-out ui files need more work + +ui_files = [ + 'aboutdialog.ui', + 'action-bar.ui', + 'appchooserbutton.ui', + 'appchooserdialog.ui', + 'assistant.ui', + 'box.ui', + 'button.ui', + 'calendar.ui', + 'centerbox.ui', + 'check-button.ui', + 'colorchooser.ui', + 'color-button.ui', + 'combo-box.ui', + 'combo-box-entry.ui', + 'combo-box-text.ui', + 'dialog.ui', + 'drawingarea.ui', + 'drop-down.ui', + 'editable-label.ui', + 'emojichooser.ui', + 'entry.ui', + 'expander.ui', + 'flow-box.ui', + 'fontchooser.ui', + 'font-button.ui', + 'frame.ui', + 'glarea.ui', + 'grid.ui', + 'headerbar.ui', + 'icon-view.ui', + 'image.ui', + 'info-bar.ui', + 'label.ui', + 'levelbar.ui', + 'link-button.ui', + 'list-box.ui', + 'list-and-tree.ui', + 'media-controls.ui', + 'menu.ui', + 'menubar.ui', + 'menu-button.ui', + 'messagedialog.ui', + 'multiline-text.ui', + 'notebook.ui', + 'overlay.ui', + 'pagesetupdialog.ui', + 'panes.ui', + 'password-entry.ui', + 'picture.ui', + 'popover.ui', + 'printdialog.ui', + 'progressbar.ui', + 'radio-button.ui', + 'scales.ui', + 'scrollbar.ui', + 'scrolledwindow.ui', + 'search-bar.ui', + 'search-entry.ui', + 'separator.ui', + 'shortcuts-window.ui', + 'sidebar.ui', + 'spinbutton.ui', + 'spinner.ui', + 'stack.ui', + 'stackswitcher.ui', + 'statusbar.ui', + 'switch.ui', + 'toggle-button.ui', + 'video.ui', + 'volumebutton.ui', + 'window.ui', + 'windowcontrols.ui', +] + +gtk_builder_tool = find_program('gtk4-builder-tool') + +if get_option('update_screenshots') + foreach ui_file: ui_files + png_file = ui_file.replace('.ui', '.png') + gtk_images += custom_target('@0@ from @1@'.format(png_file, ui_file), + input: [ui_file, 'style.css'], + output: png_file, + command: [ gtk_builder_tool, 'screenshot', + '--force', + '--css', '@INPUT1@', + '@INPUT0@', '@OUTPUT@' ]) + endforeach +endif diff --git a/docs/reference/gtk/images/messagedialog.ui b/docs/reference/gtk/images/messagedialog.ui new file mode 100644 index 0000000000..3637d2be3d --- /dev/null +++ b/docs/reference/gtk/images/messagedialog.ui @@ -0,0 +1,19 @@ + + + + 0 + 280 + 120 + edit-copy + Message Dialog + With secondary text + + + Ok + + + + button_ok + + + diff --git a/docs/reference/gtk/images/multiline-text.ui b/docs/reference/gtk/images/multiline-text.ui new file mode 100644 index 0000000000..8a40f395d7 --- /dev/null +++ b/docs/reference/gtk/images/multiline-text.ui @@ -0,0 +1,44 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 10 + 10 + 10 + 10 + + + 1 + 1 + + + Multiline +Text + + + + + 0 + + + + + + + + diff --git a/docs/reference/gtk/images/notebook.ui b/docs/reference/gtk/images/notebook.ui new file mode 100644 index 0000000000..22c4d51a2d --- /dev/null +++ b/docs/reference/gtk/images/notebook.ui @@ -0,0 +1,58 @@ + + + + 0 + 0 + 280 + 120 + + + + + 1 + 1 + + + Content + center + center + + + + + Tab + + + + + Content + center + center + + + + + Tab + + + + + Content + center + center + + + + + Tab + + + + + + diff --git a/docs/reference/gtk/images/overlay.ui b/docs/reference/gtk/images/overlay.ui new file mode 100644 index 0000000000..f6717eeb7a --- /dev/null +++ b/docs/reference/gtk/images/overlay.ui @@ -0,0 +1,70 @@ + + + + 0 + 0 + 280 + 200 + + + + + + + vertical + 3 + 10 + 10 + 10 + 10 + + + + + + + + + start + center + + + Overlay + + + + + + + 1 + 1 + center + center + Content + + + + + + + + + Overlay + + + + + + + + diff --git a/docs/reference/gtk/images/pagesetupdialog.ui b/docs/reference/gtk/images/pagesetupdialog.ui new file mode 100644 index 0000000000..fc8999a69a --- /dev/null +++ b/docs/reference/gtk/images/pagesetupdialog.ui @@ -0,0 +1,6 @@ + + + + Page Setup Dialog + + diff --git a/docs/reference/gtk/images/panes.ui b/docs/reference/gtk/images/panes.ui new file mode 100644 index 0000000000..e6bc172acc --- /dev/null +++ b/docs/reference/gtk/images/panes.ui @@ -0,0 +1,84 @@ + + + + 0 + 0 + + + + + + + 10 + 10 + 10 + 10 + vertical + 3 + + + horizontal + 1 + 12 + + + + vertical + 96 + 96 + + + + + + + + + 0 + 0 + 0 + 0 + + + + + + horizontal + 96 + 96 + + + + + + + + + 0 + 0 + 0 + 0 + + + + + + + + center + Horizontal and Vertical +Panes + + + + + + + + diff --git a/docs/reference/gtk/images/password-entry.ui b/docs/reference/gtk/images/password-entry.ui new file mode 100644 index 0000000000..45ce835e4b --- /dev/null +++ b/docs/reference/gtk/images/password-entry.ui @@ -0,0 +1,35 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 1 + 1 + fill + center + Entry + 1 + 10 + 10 + 10 + 10 + + + + + + diff --git a/docs/reference/gtk/images/picture.ui b/docs/reference/gtk/images/picture.ui new file mode 100644 index 0000000000..de69f7a27e --- /dev/null +++ b/docs/reference/gtk/images/picture.ui @@ -0,0 +1,46 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + 10 + 10 + + + applications-graphics.png + 1 + center + center + + + + + Picture + + + + + + + + diff --git a/docs/reference/gtk/images/popover.ui b/docs/reference/gtk/images/popover.ui new file mode 100644 index 0000000000..e0403f3e86 --- /dev/null +++ b/docs/reference/gtk/images/popover.ui @@ -0,0 +1,16 @@ + + + + 180 + 180 + center + 0 + + + center + center + Popover + + + + diff --git a/docs/reference/gtk/images/printdialog.ui b/docs/reference/gtk/images/printdialog.ui new file mode 100644 index 0000000000..c5d3cf3f79 --- /dev/null +++ b/docs/reference/gtk/images/printdialog.ui @@ -0,0 +1,8 @@ + + + + 505 + 305 + Print Dialog + + diff --git a/docs/reference/gtk/images/progressbar.ui b/docs/reference/gtk/images/progressbar.ui new file mode 100644 index 0000000000..90a858c5d2 --- /dev/null +++ b/docs/reference/gtk/images/progressbar.ui @@ -0,0 +1,42 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + + + 0.5 + 1 + + + + + Progress Bar + + + + + + + + diff --git a/docs/reference/gtk/images/radio-button.ui b/docs/reference/gtk/images/radio-button.ui new file mode 100644 index 0000000000..2c45704989 --- /dev/null +++ b/docs/reference/gtk/images/radio-button.ui @@ -0,0 +1,44 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + + + 1 + Radio Button + + + + + 0 + Radio Button + radio1 + + + + + + + + diff --git a/docs/reference/gtk/images/scales.ui b/docs/reference/gtk/images/scales.ui new file mode 100644 index 0000000000..324ca4a596 --- /dev/null +++ b/docs/reference/gtk/images/scales.ui @@ -0,0 +1,74 @@ + + + + 0 + 0 + + + + + + + 10 + 10 + 10 + 10 + vertical + 3 + + + horizontal + 1 + 12 + + + + horizontal + 96 + 96 + + + 0 + 100 + 50 + + + + + + + + vertical + 96 + 96 + + + 0 + 100 + 50 + + + + + + + + + + center + Horizontal and Vertical +Scales + + + + + + + + diff --git a/docs/reference/gtk/images/scrollbar.ui b/docs/reference/gtk/images/scrollbar.ui new file mode 100644 index 0000000000..9ee32a9520 --- /dev/null +++ b/docs/reference/gtk/images/scrollbar.ui @@ -0,0 +1,45 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + + + 1 + 200 + fill + 10 + 10 + + + + + Scrollbar + + + + + + + + diff --git a/docs/reference/gtk/images/scrolledwindow.ui b/docs/reference/gtk/images/scrolledwindow.ui new file mode 100644 index 0000000000..bf4bb5676e --- /dev/null +++ b/docs/reference/gtk/images/scrolledwindow.ui @@ -0,0 +1,31 @@ + + + + 0 + 0 + 280 + 120 + + + + never + always + 0 + + 1 + 1 + + + ScrolledWindow + center + center + + + + + + diff --git a/docs/reference/gtk/images/search-bar.ui b/docs/reference/gtk/images/search-bar.ui new file mode 100644 index 0000000000..53ef6c21f0 --- /dev/null +++ b/docs/reference/gtk/images/search-bar.ui @@ -0,0 +1,43 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 1 + 1 + + + 1 + 1 + + + Search Bar + + + + + + + + + + + + + + diff --git a/docs/reference/gtk/images/search-entry.ui b/docs/reference/gtk/images/search-entry.ui new file mode 100644 index 0000000000..07df349cf4 --- /dev/null +++ b/docs/reference/gtk/images/search-entry.ui @@ -0,0 +1,34 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + 1 + 1 + fill + center + Search… + 10 + 10 + 10 + 10 + + + + + + diff --git a/docs/reference/gtk/images/separator.ui b/docs/reference/gtk/images/separator.ui new file mode 100644 index 0000000000..133a1ab888 --- /dev/null +++ b/docs/reference/gtk/images/separator.ui @@ -0,0 +1,61 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + 10 + 10 + 10 + 10 + + + 10 + center + + + 100 + horizontal + center + + + + + 100 + vertical + + + + + + + Horizontal and Vertical +Separators + center + + + + + + + + diff --git a/docs/reference/gtk/images/shortcuts-window.ui b/docs/reference/gtk/images/shortcuts-window.ui new file mode 100644 index 0000000000..c55037a389 --- /dev/null +++ b/docs/reference/gtk/images/shortcuts-window.ui @@ -0,0 +1,120 @@ + + + + 1 + + + shortcuts + 12 + + + Overview + overview + + + F1 + Help + + + + + <Ctrl>n + Create a new box + + + + + <Ctrl>f + Search + + + + + <Ctrl>k + Keyboard shortcuts + + + + + <Ctrl>q + Close Window/Quit Boxes + + + + + + + Box Creation and Properties + wizard + + + ltr + <Alt>Right + Switch to the next page + + + + + ltr + <Alt>Left + Switch to the previous page + + + + + rtl + <Alt>Left + Switch to the next page + + + + + rtl + <Alt>Right + Switch to the previous page + + + + + + + Box Display + display + + + Control_L+Alt_L + Grab/Ungrab keyboard + + + + + ltr + <Alt>Left + Back to overview + + + + + rtl + <Alt>Right + Back to overview + + + + + <Ctrl>q + Close window/Quit Boxes + + + + + F11 + Fullscreen/Restore from fullscreen + + + + + + + + diff --git a/docs/reference/gtk/images/sidebar.ui b/docs/reference/gtk/images/sidebar.ui new file mode 100644 index 0000000000..8bb39cb00f --- /dev/null +++ b/docs/reference/gtk/images/sidebar.ui @@ -0,0 +1,57 @@ + + + + 0 + 0 + + + + + horizontal + 1 + 1 + + + stack + + + + + 120 + 120 + + + page1 + Page 1 + + + center + center + Sidebar + + + + + + + page2 + Page 2 + + + 0 + + + + + + + + + + diff --git a/docs/reference/gtk/images/spinbutton.ui b/docs/reference/gtk/images/spinbutton.ui new file mode 100644 index 0000000000..1e24b18176 --- /dev/null +++ b/docs/reference/gtk/images/spinbutton.ui @@ -0,0 +1,49 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + + + + + 0 + 100 + 0 + + + center + center + + + + + Spin Button + + + + + + + + diff --git a/docs/reference/gtk/images/spinner.ui b/docs/reference/gtk/images/spinner.ui new file mode 100644 index 0000000000..206aa81230 --- /dev/null +++ b/docs/reference/gtk/images/spinner.ui @@ -0,0 +1,43 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + + + 1 + center + center + + + + + Spinner + + + + + + + + diff --git a/docs/reference/gtk/images/stack.ui b/docs/reference/gtk/images/stack.ui new file mode 100644 index 0000000000..e81f3acf73 --- /dev/null +++ b/docs/reference/gtk/images/stack.ui @@ -0,0 +1,63 @@ + + + + 0 + 0 + 280 + 120 + + + + + vertical + 1 + 1 + + + stack + + + + + 120 + 120 + + + page1 + Page 1 + + + 0 + + + + + + + page2 + Page 2 + + + 0 + + + + + + + + + 3 + Stack + + + + + + diff --git a/docs/reference/gtk/images/stackswitcher.ui b/docs/reference/gtk/images/stackswitcher.ui new file mode 100644 index 0000000000..8ef282232b --- /dev/null +++ b/docs/reference/gtk/images/stackswitcher.ui @@ -0,0 +1,63 @@ + + + + 0 + 0 + 280 + 120 + + + + + vertical + 1 + 1 + + + stack + + + + + 120 + 120 + + + page1 + Page 1 + + + 0 + + + + + + + page2 + Page 2 + + + 0 + + + + + + + + + 3 + Stack Switcher + + + + + + diff --git a/docs/reference/gtk/images/statusbar.ui b/docs/reference/gtk/images/statusbar.ui new file mode 100644 index 0000000000..c888303b9c --- /dev/null +++ b/docs/reference/gtk/images/statusbar.ui @@ -0,0 +1,42 @@ + + + + 0 + 0 + 280 + 120 + + + + + vertical + 3 + + + 10 + Status Bar + + + + + 1 + 1 + end + + + Hold on… + start + + + + + + + + diff --git a/docs/reference/gtk/images/style.css b/docs/reference/gtk/images/style.css new file mode 100644 index 0000000000..039dd5258b --- /dev/null +++ b/docs/reference/gtk/images/style.css @@ -0,0 +1,18 @@ +.nobackground { + background: none; +} + +.shadow { + box-shadow: 0 3px 9px 1px rgba(0, 0, 0, 0.5); + margin: 20px; +} + +.black { + background: black; +} + +.small-button { + min-width: 16px; + min-height: 16px; + padding: 0; +} diff --git a/docs/reference/gtk/images/switch.ui b/docs/reference/gtk/images/switch.ui new file mode 100644 index 0000000000..bc7136de18 --- /dev/null +++ b/docs/reference/gtk/images/switch.ui @@ -0,0 +1,41 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + + + 1 + + + + + 0 + + + + + + + + diff --git a/docs/reference/gtk/images/toggle-button.ui b/docs/reference/gtk/images/toggle-button.ui new file mode 100644 index 0000000000..ff1a323aa8 --- /dev/null +++ b/docs/reference/gtk/images/toggle-button.ui @@ -0,0 +1,45 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + horizontal + 1 + 1 + center + center + + + + 1 + Toggle + + + + + 0 + Button + + + + + + + + diff --git a/docs/reference/gtk/images/video.ui b/docs/reference/gtk/images/video.ui new file mode 100644 index 0000000000..8dcee64df8 --- /dev/null +++ b/docs/reference/gtk/images/video.ui @@ -0,0 +1,47 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + 10 + 10 + + + 1 + 128 + center + center + file:///home/mclasen/Sources/gtk-master/docs/reference/gtk/images/gtk-logo.webm + + + + + Video + + + + + + + + diff --git a/docs/reference/gtk/images/volumebutton.ui b/docs/reference/gtk/images/volumebutton.ui new file mode 100644 index 0000000000..db46723818 --- /dev/null +++ b/docs/reference/gtk/images/volumebutton.ui @@ -0,0 +1,43 @@ + + + + 0 + 0 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + + + 33 + center + center + + + + + Volume Button + + + + + + + + diff --git a/docs/reference/gtk/images/window.ui b/docs/reference/gtk/images/window.ui new file mode 100644 index 0000000000..31db76ddab --- /dev/null +++ b/docs/reference/gtk/images/window.ui @@ -0,0 +1,9 @@ + + + + 0 + 280 + 120 + Window + + diff --git a/docs/reference/gtk/images/windowcontrols.ui b/docs/reference/gtk/images/windowcontrols.ui new file mode 100644 index 0000000000..45986e70c3 --- /dev/null +++ b/docs/reference/gtk/images/windowcontrols.ui @@ -0,0 +1,44 @@ + + + + 0 + 1 + 280 + 120 + + + + + + + vertical + 3 + 1 + 1 + center + center + + + end + :minimize,maximize,close + center + center + + + + + Window Controls + + + + + + + + diff --git a/docs/reference/gtk/meson.build b/docs/reference/gtk/meson.build index a7af607b91..f0b0882e44 100644 --- a/docs/reference/gtk/meson.build +++ b/docs/reference/gtk/meson.build @@ -27,6 +27,10 @@ expand_content_md_files = [ 'visual_index.md' ] +gtk_images = [] + +subdir('images') + if get_option('gtk_doc') gtk4_toml = configure_file( input: 'gtk4.toml.in', @@ -46,10 +50,11 @@ if get_option('gtk_doc') '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../gtk'), '--config=@INPUT0@', '--output-dir=@OUTPUT@', + '--content-dir=@0@'.format(meson.current_build_dir()), '--content-dir=@0@'.format(meson.current_source_dir()), '@INPUT1@', ], - depends: [ gdk_gir[0], gsk_gir[0] ], + depends: [ gdk_gir[0], gsk_gir[0] ] + gtk_images, depend_files: [ expand_content_md_files ], build_by_default: true, install: true, diff --git a/meson_options.txt b/meson_options.txt index bb2530d00a..2084ab86e1 100644 --- a/meson_options.txt +++ b/meson_options.txt @@ -85,6 +85,11 @@ option('gtk_doc', value: false, description : 'Build API reference and tools documentation') +option('update_screenshots', + type: 'boolean', + value: false, + description : 'Regenerate screenshots for the documentation') + option('man-pages', type: 'boolean', value: false,