docs: Improve docs for gskrendernode.c

This commit is contained in:
Maximiliano Sandoval R 2022-01-05 12:43:06 +01:00
parent 6d80135342
commit ad73e2d07b
No known key found for this signature in database
GPG Key ID: D64A8D747F6FE706

View File

@ -20,7 +20,7 @@
* GskRenderNode: (ref-func gsk_render_node_ref) (unref-func gsk_render_node_unref) (set-value-func gsk_value_set_render_node) (get-value-func gsk_value_get_render_node) * GskRenderNode: (ref-func gsk_render_node_ref) (unref-func gsk_render_node_unref) (set-value-func gsk_value_set_render_node) (get-value-func gsk_value_get_render_node)
* *
* `GskRenderNode` is the basic block in a scene graph to be * `GskRenderNode` is the basic block in a scene graph to be
* rendered using `GskRenderer`. * rendered using [class@Gsk.Renderer].
* *
* Each node has a parent, except the top-level node; each node may have * Each node has a parent, except the top-level node; each node may have
* children nodes. * children nodes.
@ -424,7 +424,7 @@ gsk_render_node_get_bounds (GskRenderNode *node,
* *
* Typically, you'll use this function to implement fallback rendering * Typically, you'll use this function to implement fallback rendering
* of `GskRenderNode`s on an intermediate Cairo context, instead of using * of `GskRenderNode`s on an intermediate Cairo context, instead of using
* the drawing context associated to a `GdkSurface`'s rendering buffer. * the drawing context associated to a [class@Gdk.Surface]'s rendering buffer.
* *
* For advanced nodes that cannot be supported using Cairo, in particular * For advanced nodes that cannot be supported using Cairo, in particular
* for nodes doing 3D operations, this function may fail. * for nodes doing 3D operations, this function may fail.
@ -565,8 +565,8 @@ gsk_render_node_diff (GskRenderNode *node1,
* @filename: (type filename): the file to save it to. * @filename: (type filename): the file to save it to.
* @error: Return location for a potential error * @error: Return location for a potential error
* *
* This function is equivalent to calling gsk_render_node_serialize() * This function is equivalent to calling [method@Gsk.RenderNode.serialize]
* followed by g_file_set_contents(). * followed by [func@GLib.file_set_contents].
* *
* See those two functions for details on the arguments. * See those two functions for details on the arguments.
* *
@ -603,7 +603,7 @@ gsk_render_node_write_to_file (GskRenderNode *node,
* @error_func: (nullable) (scope call): Callback on parsing errors * @error_func: (nullable) (scope call): Callback on parsing errors
* @user_data: (closure error_func): user_data for @error_func * @user_data: (closure error_func): user_data for @error_func
* *
* Loads data previously created via gsk_render_node_serialize(). * Loads data previously created via [method@Gsk.RenderNode.serialize].
* *
* For a discussion of the supported format, see that function. * For a discussion of the supported format, see that function.
* *
@ -623,12 +623,12 @@ gsk_render_node_deserialize (GBytes *bytes,
/** /**
* gsk_value_set_render_node: * gsk_value_set_render_node:
* @value: a `GValue` initialized with type `GSK_TYPE_RENDER_NODE` * @value: a [struct@GObject.Value] initialized with type `GSK_TYPE_RENDER_NODE`
* @node: a `GskRenderNode` * @node: a `GskRenderNode`
* *
* Stores the given `GskRenderNode` inside `value`. * Stores the given `GskRenderNode` inside `value`.
* *
* The `GValue` will acquire a reference to the `node`. * The [struct@GObject.Value] will acquire a reference to the `node`.
* *
* Since: 4.6 * Since: 4.6
*/ */
@ -659,7 +659,7 @@ gsk_value_set_render_node (GValue *value,
/** /**
* gsk_value_take_render_node: * gsk_value_take_render_node:
* @value: a `GValue` initialized with type `GSK_TYPE_RENDER_NODE` * @value: a [struct@GObject.Value] initialized with type `GSK_TYPE_RENDER_NODE`
* @node: (transfer full) (nullable): a `GskRenderNode` * @node: (transfer full) (nullable): a `GskRenderNode`
* *
* Stores the given `GskRenderNode` inside `value`. * Stores the given `GskRenderNode` inside `value`.
@ -713,7 +713,7 @@ gsk_value_get_render_node (const GValue *value)
/** /**
* gsk_value_dup_render_node: * gsk_value_dup_render_node:
* @value: a `GValue` initialized with type `GSK_TYPE_RENDER_NODE` * @value: a [struct@GObject.Value] initialized with type `GSK_TYPE_RENDER_NODE`
* *
* Retrieves the `GskRenderNode` stored inside the given `value`, and acquires * Retrieves the `GskRenderNode` stored inside the given `value`, and acquires
* a reference to it. * a reference to it.