Jekyll2019-08-13T18:14:49+00:00https://sfanxiang.github.io/gsoc-2019/gsoc-2019/feed.xmlXiang Fan2019-08-12T00:00:00+00:002019-08-12T00:00:00+00:00https://sfanxiang.github.io/gsoc-2019/gsoc-2019/2019/08/12/post-6<p>This is the final report on <a href="https://summerofcode.withgoogle.com/projects/#5172521249275904">GTK 4 Rust Bindings</a>. You can find project links and repositories on <a href="https://sfanxiang.github.io/gsoc-2019/about/">the about page</a>.</p> <h2 id="describe-my-work-briefly">Describe my work briefly</h2> <ul> <li>Add Rust support to the gtk4 toolkit, including <ul> <li>gtk4</li> <li>gsk4</li> <li>gdk4</li> <li>graphene</li> </ul> </li> <li>Port gtk3 Rust examples to gtk4.</li> </ul> <h2 id="what-is-done">What is done</h2> <ul> <li>gtk4-rs: <a href="https://github.com/gtk-rs/gtk4">https://github.com/gtk-rs/gtk4</a></li> </ul> <p>The is the main API for gtk4 software development. Changes in gtk4 are reflected here, including new layout managers, deprecation of child properties, and new/removed widgets.</p> <ul> <li>gsk4-rs: <a href="https://github.com/gtk-rs/gsk4">https://github.com/gtk-rs/gsk4</a></li> </ul> <p>The new GTK Scene Kit API callable from Rust, featuring the extensive render nodes type system highlighted in previous posts.</p> <ul> <li>gdk4-rs: <a href="https://github.com/gtk-rs/gdk4">https://github.com/gtk-rs/gdk4</a></li> </ul> <p>gdk4 has undergone a lot of changes since its last version, with refined interaction between gtk. It’s overhauled event system was specially bound in Rust too.</p> <ul> <li>graphene-rs: <a href="https://github.com/gtk-rs/graphene">https://github.com/gtk-rs/graphene</a></li> <li>examples: <a href="https://github.com/sfanxiang/gtk-rs-examples4">https://github.com/sfanxiang/gtk-rs-examples4</a> (will be upstreamed)</li> <li>Low-level, unsafe bindings: <a href="https://github.com/gtk-rs/sys/pull/145">https://github.com/gtk-rs/sys/pull/145</a></li> <li>Automatic creation of gtk4 dependency bundle: <a href="https://github.com/sfanxiang/gtk-bootstrap">https://github.com/sfanxiang/gtk-bootstrap</a></li> </ul> <h2 id="future-work">Future work</h2> <ul> <li>Improve Rust-specific documentation in https://github.com/gtk-rs/lgpl-docs.</li> <li>More bindings. There’s always more we can do.</li> <li>CI support for OSX and Windows.</li> </ul>

This is the final report on GTK 4 Rust Bindings. You can find project links and repositories on the about page.

2019-08-02T00:00:00+00:002019-08-02T00:00:00+00:00https://sfanxiang.github.io/gsoc-2019/gsoc-2019/2019/08/02/post-5<p>This is the fifth post in a series of reports on the progress of <a href="https://summerofcode.withgoogle.com/projects/#5172521249275904">GTK 4 Rust Bindings</a>. You can find project links and repositories on <a href="https://sfanxiang.github.io/gsoc-2019/about/">the about page</a>.</p> <p>Apart from preparing to upstream the crates, I’ve been keeping the shared code of gtk4-rs and gtk3-rs in sync and adding more types to gdk4-rs.</p> <h2 id="merging-graphene-and-graphene-sys-in-one-repo">Merging graphene and graphene-sys in one repo</h2> <p>The idea came from my mentor, Jordan Petridis. Managing graphene and graphene-sys in one place will make these relatively self-contained crates easier to maintain. A build system was set up for them. The graphene repo is now ready for upstreaming.</p> <h2 id="additions-to-gdk4-rs">Additions to gdk4-rs</h2> <ul> <li><code class="highlighter-rouge">ContentDeserializer</code> and <code class="highlighter-rouge">ContentDeserializer</code>, along with their helper functions, are implemented.</li> <li>The <code class="highlighter-rouge">Event</code> typing system is implemented. It was determined from gdk4 source code whether a method applies to a subtype.</li> </ul> <h2 id="rebasing-examples">Rebasing examples</h2> <p>A lot of changes after gtk4 examples branched were merged to gtk4 examples. New examples from upstream, namely <code class="highlighter-rouge">builders</code>, <code class="highlighter-rouge">clipboard_simple</code>, and <code class="highlighter-rouge">entry_completion</code>, are implemented in gtk4.</p>

This is the fifth post in a series of reports on the progress of GTK 4 Rust Bindings. You can find project links and repositories on the about page.

2019-07-19T00:00:00+00:002019-07-19T00:00:00+00:00https://sfanxiang.github.io/gsoc-2019/gsoc-2019/2019/07/19/post-4<p>This is the fourth post in a series of reports on the progress of <a href="https://summerofcode.withgoogle.com/projects/#5172521249275904">GTK 4 Rust Bindings</a>. You can find project links and repositories on <a href="https://sfanxiang.github.io/gsoc-2019/about/">the about page</a>.</p> <p>Since the last post, the progress has been focused on adding in more objects to all of the gtk4 family. We’re also working to integrate gtk4 into the existing gtk-rs ecosystem, starting from <code class="highlighter-rouge">gir-files</code>, the root dependency of all crates.</p> <h2 id="upstreaming-builder-signals">Upstreaming builder signals</h2> <p>Although the pull request is still under review, once it’s merged, we will be able to designate signal handlers in the builder file with <code class="highlighter-rouge">Builder::connect_signals()</code>. Unlike the GModule magic often used in C, the Rust version asks you to provide a callback to map each handler name to the handler to avoid breaking safety guarantees. We also plan to add an example similar to <a href="https://github.com/sfanxiang/gtk-rs-examples4/blob/6ee2e6b3087c01cdc3a766feafb3d5520cd8ca01/src/bin/builder_signal.rs">this</a> to demonstrate its use.</p> <h2 id="additions-in-gdk4-rs">Additions in gdk4-rs</h2> <p>The following are implemented:</p> <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>DrawContext::get_frame_region() pango_layout_get_clip_region() pango_layout_line_get_clip_region() Surface::create_similar_surface() Surface::set_opaque_region() </code></pre></div></div> <p><code class="highlighter-rouge">cairo::Region</code> is added to gdk4.</p> <p>GDK events in gdk4 have been made into opaque types. I’m working on a simple typing system for them, similar to the one created for <code class="highlighter-rouge">RenderNode</code> in gsk4-rs.</p> <h2 id="integration-with-gtk-rs">Integration with gtk-rs</h2> <p>The ultimate goal of this project is, of course, to integrate all the work back into <a href="https://gtk-rs.org/">the gtk-rs ecosystem</a>. The relevant gir files from gtk 3.96 (gtk4 development version) have been merged in <a href="https://github.com/gtk-rs/gir-files/pull/39">#39</a>. The next step is to merge sys crates (low-level API) in <a href="https://github.com/gtk-rs/sys/pull/145">#145</a>, and eventually upstream all the crates.</p>

This is the fourth post in a series of reports on the progress of GTK 4 Rust Bindings. You can find project links and repositories on the about page.

2019-07-05T00:00:00+00:002019-07-05T00:00:00+00:00https://sfanxiang.github.io/gsoc-2019/gsoc-2019/2019/07/05/post-3<p>This is the third post in a series of reports on the progress of <a href="https://summerofcode.withgoogle.com/projects/#5172521249275904">GTK 4 Rust Bindings</a>. You can find project links and repositories on <a href="https://sfanxiang.github.io/gsoc-2019/about/">the about page</a>.</p> <p>gtk4-rs, by now, should be relatively complete, with a few remaining functions to manually investigate and implement. All additions listed below are imported to the other crates as well if needed.</p> <h2 id="gtk4-rs">gtk4-rs</h2> <ul> <li><code class="highlighter-rouge">AccelMap::foreach()</code> and <code class="highlighter-rouge">AccelMap::foreach_unfiltered()</code> are implemented.</li> <li><code class="highlighter-rouge">Actionable::set_action_target()</code> is implemented and upstreamed to gtk3.</li> <li><code class="highlighter-rouge">Builder::connect_signals_full()</code> is implemented. This addition will make it possible to designate which signal handler to use in builder files. It’s planned to be upstreamed to gtk3 too.</li> <li><code class="highlighter-rouge">Editable::delegate_get_property()</code> and <code class="highlighter-rouge">Editable::delegate_set_property()</code> are implemented.</li> <li><code class="highlighter-rouge">Text</code> signals are implemented.</li> </ul> <h2 id="gdk4-rs">gdk4-rs</h2> <ul> <li><code class="highlighter-rouge">Geometry</code> is implemented.</li> <li><code class="highlighter-rouge">KeymapKey</code> is implemented.</li> <li><code class="highlighter-rouge">Rectangle</code> is implemented and added to gtk4-rs.</li> <li><code class="highlighter-rouge">TimeCoord</code> is implemented and added to gtk4-rs.</li> </ul> <h2 id="gsk4-rs">gsk4-rs</h2> <ul> <li><code class="highlighter-rouge">ColorStop</code> is implemented and added to gtk4-rs.</li> <li><code class="highlighter-rouge">RenderNode</code> is implemented and added to gtk4-rs. It uses an <em>ad hoc</em> subtyping system for different types of render nodes, similar to <a href="https://github.com/gtk-rs/cairo/blob/804aad8b2fc00eaa99644bc03a381c7bd6a88d5c/src/patterns.rs">cairo patterns</a>.</li> <li><code class="highlighter-rouge">RoundedRect</code> is implemented and added to gtk4-rs.</li> <li><code class="highlighter-rouge">Shadow</code> is implemented and added to gtk4-rs.</li> </ul>

This is the third post in a series of reports on the progress of GTK 4 Rust Bindings. You can find project links and repositories on the about page.

2019-06-21T00:00:00+00:002019-06-21T00:00:00+00:00https://sfanxiang.github.io/gsoc-2019/gsoc-2019/2019/06/21/post-2<p>This is the second post in a series of reports on the progress of <a href="https://summerofcode.withgoogle.com/projects/#5172521249275904">GTK 4 Rust Bindings</a>. You can find project links and repositories on <a href="https://sfanxiang.github.io/gsoc-2019/about/">the about page</a>.</p> <p>This development cycle focuses on gtk4-rs itself, while I continue to add more objects from gdk4 and gsk4 where needed. Another highlight is setting up continuous integration.</p> <h2 id="gtk4-rs">gtk4-rs</h2> <p>The original plan for gtk4-rs includes adding some remaining objects that initially prevented gir codegen (mostly <code class="highlighter-rouge">missing memory management</code>), but many of them turned out to be private objects, implementation details, or otherwise supposed to be used within C. Objects that are useful among them were implemented manually.</p> <p>Another part of the change is integrating existing manually-implemented bindings from gtk3. Despite differences between gtk3 and gtk4, they do share a considerable amount of code.</p> <h2 id="continuous-integration">Continuous Integration</h2> <p>It became neccessary to set up CI when the project structure began to stabilize. After some try-and-error, I enabled CI for linux targets with gtk 3.96 (pre-release version), and rust 1.34.0 (stable), beta, and nightly. Without the distro providing gtk4, the entire gtk dependencies are built from source and stored in this <a href="https://github.com/sfanxiang/gtk-bootstrap">repo</a>. Apart from keeping the project coherent itself, CI also helps track upstream changes. Many errors were found immediately after it went up.</p> <h2 id="misc">Misc.</h2> <p>Other changes include retroactive bugfixes in gtk3-rs &amp; gtk4-rs, and adapting to new upstream <code class="highlighter-rouge">Boxed</code> models.</p>

This is the second post in a series of reports on the progress of GTK 4 Rust Bindings. You can find project links and repositories on the about page.

2019-06-07T00:00:00+00:002019-06-07T00:00:00+00:00https://sfanxiang.github.io/gsoc-2019/gsoc-2019/2019/06/07/post-1<p>Hi and welcome to my GSoC blog! This is the first post in a series of reports on the progress of <a href="https://summerofcode.withgoogle.com/projects/#5172521249275904">GTK 4 Rust Bindings</a>.</p> <p>The initial development is driven by making simple programs and existing examples work, so that we have a set of core features to develop from.</p> <h2 id="examples">Examples</h2> <p>You can find example gtk4-rs programs at <a href="https://github.com/sfanxiang/gtk-rs-examples4">https://github.com/sfanxiang/gtk-rs-examples4</a>. It’s based on <a href="https://github.com/gtk-rs/examples">gtk-rs examples</a>. Available examples include:</p> <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>accessibility basic builder_basics cairotest cairo_threads clock css drag_and_drop drag_and_drop_textview grid gtktest listbox_model list_store menu_bar menu_bar_system multithreading_context multi_windows notebook overlay pango_attributes progress_tracker simple_treeview sync_widgets text_viewer transparent_main_window tree_model_sort treeview </code></pre></div></div> <h2 id="gtk4-rs">gtk4-rs</h2> <p>The gtk4-rs repository is at <a href="https://github.com/sfanxiang/gtk-rs-gtk4">https://github.com/sfanxiang/gtk-rs-gtk4</a>. Currently this is a work in progress. Changes here most closely follows upstream gtk4. If there’s anything special to point out, I’ll note it in a future post.</p> <h2 id="graphene-rs">graphene-rs</h2> <p>The repository is at <a href="https://github.com/sfanxiang/gtk-rs-graphene">https://github.com/sfanxiang/gtk-rs-graphene</a>. It’s feature-complete, with the exception of simd4f and simd4x4f. These are C structures and do not use the glib model.</p>

Hi and welcome to my GSoC blog! This is the first post in a series of reports on the progress of GTK 4 Rust Bindings.