isa/mutter
1
0
Fork 0
mirror of https://github.com/brl/mutter.git synced 2024-12-29 14:22:13 +00:00
Code Issues Packages Projects Releases Wiki Activity
ac8ee9a08c
mutter/clutter/clutter/clutter-text.c

6542 lines
186 KiB
C
Raw Normal View History

Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
/*
* Clutter.
*
* An OpenGL based 'interactive canvas' library.
*
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
* Copyright (C) 2008 Intel Corporation.
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
*
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
* Authored By: Øyvind Kolås <pippin@o-hand.com>
* Emmanuele Bassi <ebassi@linux.intel.com>
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
*/
Fix documentation issues Provide a description for the ClutterText section, and fix some misnamed arguments inside the header file.
2008-12-11 15:00:22 +00:00
/**
* SECTION:clutter-text
* @short_description: An actor for displaying and editing text
*
* #ClutterText is an actor that displays custom text using Pango
* as the text rendering engine.
*
* #ClutterText also allows inline editing of the text if the
* actor is set editable using clutter_text_set_editable().
*
* Selection using keyboard or pointers can be enabled using
* clutter_text_set_selectable().
*
* #ClutterText is available since Clutter 1.0
*/
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
#ifdef HAVE_CONFIG_H
Don't use config.h in clutter and cogl In cogl use cogl-config.h and in clutter use clutter-build-config.h. We can't use clutter-config.h in clutter because its already used and installed. https://bugzilla.gnome.org/show_bug.cgi?id=768976
2016-05-05 14:21:51 +00:00
#include "clutter-build-config.h"
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
#endif
#include <string.h>
Clean up clutter-private.h/6 Move all Actor private API to a separate file.
2010-10-21 11:16:05 +00:00
#include <math.h>
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
#include "clutter-text.h"
Use internal headers Since ClutterText is part of Clutter, it can use the internal and private headers instead of the catch-all clutter.h.
2008-12-11 11:15:11 +00:00
Clean up clutter-private.h/6 Move all Actor private API to a separate file.
2010-10-21 11:16:05 +00:00
#include "clutter-actor-private.h"
text: Enable implicit color animations Implement the ClutterAnimatable interface to enable implicit animations for :color, :cursor-color, :selected-text-color and :selection-color. https://bugzilla.gnome.org/show_bug.cgi?id=676963
2012-05-28 12:02:25 +00:00
#include "clutter-animatable.h"
text: Use the keymap direction when focused If the ClutterText actor has key focus then we should ask for the direction of the key map, instead of the direction of the actor. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2014-03-03 23:25:08 +00:00
#include "clutter-backend-private.h"
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
#include "clutter-binding-pool.h"
Clean up the included headers Especially inside ClutterStage.
2012-02-23 17:21:57 +00:00
#include "clutter-color.h"
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
#include "clutter-debug.h"
#include "clutter-enum-types.h"
Group all the integer private fields Integer fields using the ": <bits>" notation should be packed together so that the compiler can optimize the structure size correctly.
2008-12-11 11:15:56 +00:00
#include "clutter-keysyms.h"
Use internal headers Since ClutterText is part of Clutter, it can use the internal and private headers instead of the catch-all clutter.h.
2008-12-11 11:15:11 +00:00
#include "clutter-main.h"
profile: Add profiling points for Text Add a static timer for the text layout code, and two counters for the layout cache hit and miss conditions.
2010-04-22 16:54:05 +00:00
#include "clutter-marshal.h"
Fix include location for cogl-pango.h In Cogl, cogl-pango.h has moved to <cogl-pango/cogl-pango.h>. When using the experimental 2.0 API (which Clutter does) it is no longer possible to include it under the old name of <cogl/cogl-pango.h> so we need to update the include location.
2011-05-16 15:04:27 +00:00
#include "clutter-private.h" /* includes <cogl-pango/cogl-pango.h> */
text: Enable implicit color animations Implement the ClutterAnimatable interface to enable implicit animations for :color, :cursor-color, :selected-text-color and :selection-color. https://bugzilla.gnome.org/show_bug.cgi?id=676963
2012-05-28 12:02:25 +00:00
#include "clutter-property-transition.h"
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
#include "clutter-text-buffer.h"
Use internal headers Since ClutterText is part of Clutter, it can use the internal and private headers instead of the catch-all clutter.h.
2008-12-11 11:15:11 +00:00
#include "clutter-units.h"
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
#include "clutter-paint-volume-private.h"
text: Implement Scriptable interface for font-description This makes ClutterText implement the Scriptable interface so that we can have a custom property parser and setter for the font-description property. This works by simply passing the string description through to clutter_text_set_font_name. Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>
2011-08-16 16:31:42 +00:00
#include "clutter-scriptable.h"
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
#include "clutter-input-focus.h"
Use internal headers Since ClutterText is part of Clutter, it can use the internal and private headers instead of the catch-all clutter.h.
2008-12-11 11:15:11 +00:00
Use units in position_to_coords() We loose precision with a direct conversion for PangoUnits to pixels, so we should do the conversion as needed, inside the callers of clutter_text_position_to_coords().
2008-12-15 18:24:42 +00:00
/* cursor width in pixels */
#define DEFAULT_CURSOR_SIZE 2
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
/* vertical padding for the cursor */
#define CURSOR_Y_PADDING 2
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
/* We need at least three cached layouts to run the allocation without
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
* regenerating a new layout. First the layout will be generated at
* full width to get the preferred width, then it will be generated at
* the preferred width to get the preferred height and then it might
* be regenerated at a different width to get the height for the
* actual allocated width
text: Increase the size of the Layout cache Currently, each ClutterText caches 3 Pango layouts: » one for the preferred, unbounded width » one for the preferred height for a given width » one for the allocated size Some layout managers do a double pass that could flush the whole cache before it has a chance of actually storing relevant data, resulting in a continuous series of misses. We can try to counteract this by doubling the size of the cache, from three slots to six. More than six would be pointless, as well as too memory consuming; but we might get down to a number between 3 and 6 at any later point.
2010-04-16 10:11:50 +00:00
*
* since we might get multiple queries from layout managers doing a
* double-pass allocations, like tabular ones, we should use 6 slots
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
*/
text: Increase the size of the Layout cache Currently, each ClutterText caches 3 Pango layouts: » one for the preferred, unbounded width » one for the preferred height for a given width » one for the allocated size Some layout managers do a double pass that could flush the whole cache before it has a chance of actually storing relevant data, resulting in a continuous series of misses. We can try to counteract this by doubling the size of the cache, from three slots to six. More than six would be pointless, as well as too memory consuming; but we might get down to a number between 3 and 6 at any later point.
2010-04-16 10:11:50 +00:00
#define N_CACHED_LAYOUTS 6
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
typedef struct _LayoutCache LayoutCache;
struct _LayoutCache
{
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
/* Cached layout. Pango internally caches the computed extents
* when they are requested so there is no need to cache that as
* well
*/
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
PangoLayout *layout;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
/* A number representing the age of this cache (so that when a
* new layout is needed the last used cache is replaced)
*/
Support pango_layout_set_height() in ClutterText This is the port of the patch attached to bug 1266: ClutterLabel support for pango_layout_set_height() to the ClutterText actor. This patch adds support for the pango_layout_set_height() function inside the layout creation and caching, so that setting the height of a ClutterText will make PangoLayout try to fill out the given height before ellipsizing the contents of the ClutterText actor. The original patch is from Havoc Pennington. This commit ports the patch to ClutterText and applies a small change to the height computation pointed out by Behdad Esfahbod on GNOME's Bugzilla: http://bugzilla.gnome.org/show_bug.cgi?id=560931 That the layout heights when doing a size request should be set to be G_MAXINT instead of -1. Unfortunately, the patch seems to break the conformance suite when setting the ellipsization on the layout.
2008-12-16 14:02:05 +00:00
guint age;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
};
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
struct _ClutterTextInputFocus
{
ClutterInputFocus parent_instance;
ClutterText *text;
};
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
struct _ClutterTextPrivate
{
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
PangoFontDescription *font_desc;
text: Do not set the markup unconditionally When setting :use-markup we always pass the contents of the Text actor to clutter_text_set_markup_internal(); if string contains any markup, this ends up being parsed and used - even when :use-markup is set to FALSE. http://bugzilla.clutter-project.org/show_bug.cgi?id=2239
2010-08-06 16:04:37 +00:00
/* the displayed text */
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
ClutterTextBuffer *buffer;
text: Do not set the markup unconditionally When setting :use-markup we always pass the contents of the Text actor to clutter_text_set_markup_internal(); if string contains any markup, this ends up being parsed and used - even when :use-markup is set to FALSE. http://bugzilla.clutter-project.org/show_bug.cgi?id=2239
2010-08-06 16:04:37 +00:00
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
gchar *font_name;
text: Do not set the markup unconditionally When setting :use-markup we always pass the contents of the Text actor to clutter_text_set_markup_internal(); if string contains any markup, this ends up being parsed and used - even when :use-markup is set to FALSE. http://bugzilla.clutter-project.org/show_bug.cgi?id=2239
2010-08-06 16:04:37 +00:00
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
gchar *preedit_str;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
ClutterColor text_color;
LayoutCache cached_layouts[N_CACHED_LAYOUTS];
guint cache_age;
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
/* These are the attributes set by the attributes property */
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
PangoAttrList *attrs;
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
/* These are the attributes derived from the text when the
use-markup property is set */
PangoAttrList *markup_attrs;
/* This is the combination of the above two lists. It is set to NULL
whenever either of them changes and then regenerated by merging
the two lists whenever a layout is needed */
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
PangoAttrList *effective_attrs;
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
/* These are the attributes for the preedit string. These are merged
with the effective attributes into a temporary list before
creating a layout */
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
PangoAttrList *preedit_attrs;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
/* current cursor position */
gint position;
/* current 'other end of selection' position */
gint selection_bound;
Comments and whitespace fixes to ClutterText
2009-01-07 00:43:24 +00:00
/* the x position in the PangoLayout, used to
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
* avoid drifting when repeatedly moving up|down
*/
Correctly initialize the initial state of ClutterText Some of the values in ClutterText have an initial state that does not match a zero-ed out ClutterTextPrivate structure.
2008-12-11 11:35:52 +00:00
gint x_pos;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Comments and whitespace fixes to ClutterText
2009-01-07 00:43:24 +00:00
/* the x position of the PangoLayout when in
* single line mode, to scroll the contents of the
* text actor
*/
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
gint text_x;
clutter-text: new clutter_text_get_layout_offsets API This new function can be used to retrieve the coordinates where the ClutterText will draw the PangoLayout representing the text. http://bugzilla.clutter-project.org/show_bug.cgi?id=2553
2011-02-04 11:33:53 +00:00
/* the y position of the PangoLayout, fixed to 0 by
* default for now */
gint text_y;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
/* Where to draw the cursor */
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
ClutterRect cursor_rect;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
ClutterColor cursor_color;
Add :cursor-size property to ClutterText We can control the width of the cursor when painting by using a simple property. The magic -1 number passed to the setter method will reset the cursor size to the default one of 2px. The getter method will return an unsigned integer with the current size.
2008-12-16 10:37:45 +00:00
guint cursor_size;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
/* Box representing the paint volume. The box is lazily calculated
and cached */
ClutterPaintVolume paint_volume;
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
guint preedit_cursor_pos;
gint preedit_n_chars;
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
ClutterColor selection_color;
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
ClutterColor selected_text_color;
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
gunichar password_char;
Listen for the font-changed signal on the backend in ClutterText Whenever a ClutterText is created it now connects to the font-changed signal. When it is emitted the layout cache is dirtied and a relayout is queued. That way changes to the font options or resolution will cause an immediate update to the labels in the scene.
2009-01-27 16:47:20 +00:00
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
guint password_hint_id;
guint password_hint_timeout;
Listen for the font-changed signal on the backend in ClutterText Whenever a ClutterText is created it now connects to the font-changed signal. When it is emitted the layout cache is dirtied and a relayout is queued. That way changes to the font options or resolution will cause an immediate update to the labels in the scene.
2009-01-27 16:47:20 +00:00
/* Signal handler for when the backend changes its font settings */
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
guint settings_changed_id;
text: Dirty layout cache on text direction changes When the text direction changes we should evict the cached layouts to avoid stale entries in case the direction change produces a layout with the same size.
2009-11-10 12:18:32 +00:00
/* Signal handler for when the :text-direction changes */
guint direction_changed_id;
text: Pack all bitfields at the end of the private structure Don't leave them in the middle, to avoid holes.
2011-09-07 14:20:42 +00:00
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
ClutterInputFocus *input_focus;
clutter: Add input-purpose/hint properties to ClutterText So those properties can be changed or queried within shell UI.
2017-12-21 10:34:11 +00:00
ClutterInputContentHintFlags input_hints;
ClutterInputContentPurpose input_purpose;
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
text: Pack all bitfields at the end of the private structure Don't leave them in the middle, to avoid holes.
2011-09-07 14:20:42 +00:00
/* bitfields */
guint alignment : 2;
guint wrap : 1;
guint use_underline : 1;
guint use_markup : 1;
guint ellipsize : 3;
guint single_line_mode : 1;
guint wrap_mode : 3;
guint justify : 1;
guint editable : 1;
guint cursor_visible : 1;
guint activatable : 1;
guint selectable : 1;
guint selection_color_set : 1;
guint in_select_drag : 1;
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
guint in_select_touch : 1;
text: Pack all bitfields at the end of the private structure Don't leave them in the middle, to avoid holes.
2011-09-07 14:20:42 +00:00
guint cursor_color_set : 1;
guint preedit_set : 1;
guint is_default_font : 1;
guint has_focus : 1;
guint selected_text_color_set : 1;
guint paint_volume_valid : 1;
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
guint show_password_hint : 1;
guint password_hint_visible : 1;
text: Use the resolved text direction Now that we compute the effective text direction when creating the Pango layout, we should also use it when painting it. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2014-03-03 19:16:00 +00:00
guint resolved_direction : 4;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
};
enum
{
PROP_0,
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
PROP_BUFFER,
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
PROP_FONT_NAME,
text: Add :font-description High level toolkits might wish to construct a PangoFontDescription and then set it directly on a ClutterText actor proxy or sub-class. ClutterText should have a :font-description property to set (and get) the PangoFontDescription. http://bugzilla.openedhand.com/show_bug.cgi?id=1960
2010-02-03 14:35:45 +00:00
PROP_FONT_DESCRIPTION,
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
PROP_TEXT,
PROP_COLOR,
PROP_USE_MARKUP,
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
PROP_ATTRIBUTES,
[text] Rename :alignment to :line-alignment The :alignment property is prone to generate confusion: developers will set it thinking that the contents of a ClutterText will automagically align themselves. Instead of using the generic term :alignment, and following the GTK+ convention, we should use a more specific term, conveying the actual effect of the property: alignment of the lines with respect to each other, and not to the overall allocated area. See bug 1428: http://bugzilla.openedhand.com/show_bug.cgi?id=1428
2009-02-02 23:55:30 +00:00
PROP_LINE_ALIGNMENT,
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
PROP_LINE_WRAP,
PROP_LINE_WRAP_MODE,
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
PROP_JUSTIFY,
PROP_ELLIPSIZE,
text: Add :cursor-position and deprecate :position The :position property on ClutterText clashes with the same property on ClutterActor; it's also badly named, given that it represents the cursor's position inside the text; finally, it does not match its accessors, violating the API style conventions. https://bugzilla.gnome.org/show_bug.cgi?id=679457
2012-07-05 15:23:52 +00:00
PROP_POSITION, /* XXX:2.0 - remove */
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
PROP_SELECTION_BOUND,
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
PROP_SELECTION_COLOR,
PROP_SELECTION_COLOR_SET,
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
PROP_CURSOR_VISIBLE,
PROP_CURSOR_COLOR,
PROP_CURSOR_COLOR_SET,
Add :cursor-size property to ClutterText We can control the width of the cursor when painting by using a simple property. The magic -1 number passed to the setter method will reset the cursor size to the default one of 2px. The getter method will return an unsigned integer with the current size.
2008-12-16 10:37:45 +00:00
PROP_CURSOR_SIZE,
text: Add :cursor-position and deprecate :position The :position property on ClutterText clashes with the same property on ClutterActor; it's also badly named, given that it represents the cursor's position inside the text; finally, it does not match its accessors, violating the API style conventions. https://bugzilla.gnome.org/show_bug.cgi?id=679457
2012-07-05 15:23:52 +00:00
PROP_CURSOR_POSITION,
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
PROP_EDITABLE,
PROP_SELECTABLE,
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
PROP_ACTIVATABLE,
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
PROP_PASSWORD_CHAR,
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
PROP_MAX_LENGTH,
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
PROP_SINGLE_LINE_MODE,
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
PROP_SELECTED_TEXT_COLOR,
PROP_SELECTED_TEXT_COLOR_SET,
clutter: Add input-purpose/hint properties to ClutterText So those properties can be changed or queried within shell UI.
2017-12-21 10:34:11 +00:00
PROP_INPUT_HINTS,
PROP_INPUT_PURPOSE,
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
PROP_LAST
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
};
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
static GParamSpec *obj_props[PROP_LAST];
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
enum
{
TEXT_CHANGED,
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
CURSOR_EVENT, /* XXX:2.0 - remove */
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
ACTIVATE,
Added ClutterText::insert-text and ClutterText::delete-text signals * clutter/clutter-marshal.list: added new marshaller * clutter/clutter-text.c (clutter_text_class_init): added insert-text and delete-text signals (clutter_text_insert_unichar): emits insert-text signal (clutter_text_insert_text): emits insert-text signal (clutter_text_delete_text): emits delete-text signal (clutter_text_delete_chars): emits delete-text signal (clutter_text_set_markup_internal): emits delete-text and insert-text signals (clutter_text_set_text): emits delete-text and insert-text signals http://bugzilla.openedhand.com/show_bug.cgi?id=1894
2009-11-20 14:17:41 +00:00
INSERT_TEXT,
DELETE_TEXT,
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
CURSOR_CHANGED,
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
LAST_SIGNAL
};
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
static guint text_signals[LAST_SIGNAL] = { 0, };
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
static void clutter_text_settings_changed_cb (ClutterText *text);
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
static void buffer_connect_signals (ClutterText *self);
static void buffer_disconnect_signals (ClutterText *self);
static ClutterTextBuffer *get_buffer (ClutterText *self);
Listen for the font-changed signal on the backend in ClutterText Whenever a ClutterText is created it now connects to the font-changed signal. When it is emitted the layout cache is dirtied and a relayout is queued. That way changes to the font options or resolution will cause an immediate update to the labels in the scene.
2009-01-27 16:47:20 +00:00
Use the new macros for adding private data
2013-07-03 13:14:01 +00:00
static const ClutterColor default_cursor_color = { 0, 0, 0, 255 };
static const ClutterColor default_selection_color = { 0, 0, 0, 255 };
static const ClutterColor default_text_color = { 0, 0, 0, 255 };
static const ClutterColor default_selected_text_color = { 0, 0, 0, 255 };
static ClutterAnimatableIface *parent_animatable_iface = NULL;
static ClutterScriptableIface *parent_scriptable_iface = NULL;
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
/* ClutterTextInputFocus */
#define CLUTTER_TYPE_TEXT_INPUT_FOCUS (clutter_text_input_focus_get_type ())
G_DECLARE_FINAL_TYPE (ClutterTextInputFocus, clutter_text_input_focus,
CLUTTER, TEXT_INPUT_FOCUS, ClutterInputFocus)
G_DEFINE_TYPE (ClutterTextInputFocus, clutter_text_input_focus,
CLUTTER_TYPE_INPUT_FOCUS)
static void
clutter_text_input_focus_request_surrounding (ClutterInputFocus *focus)
{
ClutterText *clutter_text = CLUTTER_TEXT_INPUT_FOCUS (focus)->text;
ClutterTextBuffer *buffer;
const gchar *text;
gint anchor_pos, cursor_pos;
buffer = clutter_text_get_buffer (clutter_text);
text = clutter_text_buffer_get_text (buffer);
cursor_pos = clutter_text_get_cursor_position (clutter_text);
if (cursor_pos < 0)
cursor_pos = clutter_text_buffer_get_length (buffer);
anchor_pos = clutter_text_get_selection_bound (clutter_text);
if (anchor_pos < 0)
anchor_pos = cursor_pos;
clutter_input_focus_set_surrounding (focus, text,
g_utf8_offset_to_pointer (text, cursor_pos) - text,
g_utf8_offset_to_pointer (text, anchor_pos) - text);
}
static void
clutter_text_input_focus_delete_surrounding (ClutterInputFocus *focus,
guint offset,
guint len)
{
ClutterText *clutter_text = CLUTTER_TEXT_INPUT_FOCUS (focus)->text;
if (clutter_text_get_editable (clutter_text))
clutter_text_delete_text (clutter_text, offset, len);
}
static void
clutter_text_input_focus_commit_text (ClutterInputFocus *focus,
const gchar *text)
{
ClutterText *clutter_text = CLUTTER_TEXT_INPUT_FOCUS (focus)->text;
if (clutter_text_get_editable (clutter_text))
{
clutter_text_delete_selection (clutter_text);
clutter_text_insert_text (clutter_text, text,
clutter_text_get_cursor_position (clutter_text));
}
}
static void
clutter_text_input_focus_set_preedit_text (ClutterInputFocus *focus,
const gchar *preedit_text,
guint cursor_pos)
{
ClutterText *clutter_text = CLUTTER_TEXT_INPUT_FOCUS (focus)->text;
if (clutter_text_get_editable (clutter_text))
{
PangoAttrList *list;
list = pango_attr_list_new ();
pango_attr_list_insert (list, pango_attr_underline_new (PANGO_UNDERLINE_SINGLE));
clutter_text_set_preedit_string (clutter_text,
preedit_text, list,
cursor_pos);
pango_attr_list_unref (list);
}
}
static void
clutter_text_input_focus_class_init (ClutterTextInputFocusClass *klass)
{
ClutterInputFocusClass *focus_class = CLUTTER_INPUT_FOCUS_CLASS (klass);
focus_class->request_surrounding = clutter_text_input_focus_request_surrounding;
focus_class->delete_surrounding = clutter_text_input_focus_delete_surrounding;
focus_class->commit_text = clutter_text_input_focus_commit_text;
focus_class->set_preedit_text = clutter_text_input_focus_set_preedit_text;
}
static void
clutter_text_input_focus_init (ClutterTextInputFocus *focus)
{
}
static ClutterInputFocus *
clutter_text_input_focus_new (ClutterText *text)
{
ClutterTextInputFocus *focus;
focus = g_object_new (CLUTTER_TYPE_TEXT_INPUT_FOCUS, NULL);
focus->text = text;
return CLUTTER_INPUT_FOCUS (focus);
}
/* ClutterText */
Use the new macros for adding private data
2013-07-03 13:14:01 +00:00
static void clutter_scriptable_iface_init (ClutterScriptableIface *iface);
static void clutter_animatable_iface_init (ClutterAnimatableIface *iface);
G_DEFINE_TYPE_WITH_CODE (ClutterText,
clutter_text,
CLUTTER_TYPE_ACTOR,
G_ADD_PRIVATE (ClutterText)
G_IMPLEMENT_INTERFACE (CLUTTER_TYPE_SCRIPTABLE,
clutter_scriptable_iface_init)
G_IMPLEMENT_INTERFACE (CLUTTER_TYPE_ANIMATABLE,
clutter_animatable_iface_init));
text: Style cleanups Inline wrapper functions, and remove deep nested if's.
2012-02-07 11:31:28 +00:00
static inline void
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
clutter_text_dirty_paint_volume (ClutterText *text)
{
ClutterTextPrivate *priv = text->priv;
if (priv->paint_volume_valid)
{
clutter_paint_volume_free (&priv->paint_volume);
priv->paint_volume_valid = FALSE;
}
}
text: Style cleanups Inline wrapper functions, and remove deep nested if's.
2012-02-07 11:31:28 +00:00
static inline void
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
clutter_text_queue_redraw (ClutterActor *self)
{
/* This is a wrapper for clutter_actor_queue_redraw that also
dirties the cached paint volume. It would be nice if we could
just override the default implementation of the queue redraw
signal to do this instead but that doesn't work because the
signal isn't immediately emitted when queue_redraw is called.
Clutter will however immediately call get_paint_volume when
queue_redraw is called so we do need to dirty it immediately. */
clutter_text_dirty_paint_volume (CLUTTER_TEXT (self));
clutter_actor_queue_redraw (self);
}
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
static gboolean
clutter_text_should_draw_cursor (ClutterText *self)
{
ClutterTextPrivate *priv = self->priv;
text: Unify conditions for visible cursor We have a bunch of similar checks in various places, and they should all be coalesced into one.
2015-11-30 13:45:45 +00:00
return (priv->editable || priv->selectable) &&
priv->cursor_visible &&
priv->has_focus;
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
}
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
#define clutter_actor_queue_redraw \
Please_use_clutter_text_queue_redraw_instead
Comments and whitespace fixes to ClutterText
2009-01-07 00:43:24 +00:00
#define offset_real(t,p) ((p) == -1 ? g_utf8_strlen ((t), -1) : (p))
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Replace offset_to_bytes() implementation We should re-use the offset_to_bytes() implementation from ClutterEntry as it guaranteed some behaviour and sanity checks that we want to keep inside ClutterText.
2008-12-11 11:47:06 +00:00
static gint
offset_to_bytes (const gchar *text,
gint pos)
{
[clutter-text] Fix offset_to_bytes to work when pos == 0 The old function ended up returning the length of the string when pos was zero. This caused it to insert characters at the end when the cursor was at the beginning of the string.
2009-01-13 18:42:50 +00:00
const gchar *ptr;
Replace offset_to_bytes() implementation We should re-use the offset_to_bytes() implementation from ClutterEntry as it guaranteed some behaviour and sanity checks that we want to keep inside ClutterText.
2008-12-11 11:47:06 +00:00
if (pos < 0)
return strlen (text);
[clutter-text] Fix offset_to_bytes to work when pos == 0 The old function ended up returning the length of the string when pos was zero. This caused it to insert characters at the end when the cursor was at the beginning of the string.
2009-01-13 18:42:50 +00:00
/* Loop over each character in the string until we either reach the
end or the requested position */
for (ptr = text; *ptr && pos-- > 0; ptr = g_utf8_next_char (ptr));
return ptr - text;
Replace offset_to_bytes() implementation We should re-use the offset_to_bytes() implementation from ClutterEntry as it guaranteed some behaviour and sanity checks that we want to keep inside ClutterText.
2008-12-11 11:47:06 +00:00
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Comments and whitespace fixes to ClutterText
2009-01-07 00:43:24 +00:00
#define bytes_to_offset(t,p) (g_utf8_pointer_to_offset ((t), (t) + (p)))
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
static inline void
clutter_text_clear_selection (ClutterText *self)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
ClutterTextPrivate *priv = self->priv;
[text] Queue a redraw when the selection is cleared If you select all the text in a ClutterText, there is an invisible cursor position either at the beginning or end. If it's at the beginning, the bug is that left arrow won't clear the selection. If it's at the end, the bug is that the right arrow won't. Here are the ways to reproduce it: a. Ctrl-A selects all and moves the hidden cursor position to the left. b. For single line: End, Shift-Home does the same. c. Or manually moving to the end and doing Shift-Left Arrow to the beginning. These all put it in the state where right arrow will properly clear selection and move to cursor position 1, but left arrow fails to clear the selection. For b and c above, the opposite will give you the end case where right arrow doesn't work. Anyway, it turns out clear_selection is getting called, it just doesn't show up because it's not doing a queue_redraw. So the attached patch seems to fix things. Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-07-23 17:21:10 +00:00
if (priv->selection_bound != priv->position)
{
priv->selection_bound = priv->position;
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_SELECTION_BOUND]);
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
clutter_text_queue_redraw (CLUTTER_ACTOR (self));
[text] Queue a redraw when the selection is cleared If you select all the text in a ClutterText, there is an invisible cursor position either at the beginning or end. If it's at the beginning, the bug is that left arrow won't clear the selection. If it's at the end, the bug is that the right arrow won't. Here are the ways to reproduce it: a. Ctrl-A selects all and moves the hidden cursor position to the left. b. For single line: End, Shift-Home does the same. c. Or manually moving to the end and doing Shift-Left Arrow to the beginning. These all put it in the state where right arrow will properly clear selection and move to cursor position 1, but left arrow fails to clear the selection. For b and c above, the opposite will give you the end case where right arrow doesn't work. Anyway, it turns out clear_selection is getting called, it just doesn't show up because it's not doing a queue_redraw. So the attached patch seems to fix things. Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-07-23 17:21:10 +00:00
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
clutter-text: prevent text buffer creation if not needed When allocating or asking for preferred width/height on a ClutterText, it can notify a change on buffer/text/max-length if no text has been set. https://bugzilla.gnome.org/show_bug.cgi?id=703882
2013-07-09 15:46:35 +00:00
static gboolean
clutter_text_is_empty (ClutterText *self)
{
if (self->priv->buffer == NULL)
return TRUE;
if (clutter_text_buffer_get_length (self->priv->buffer) == 0)
return TRUE;
return FALSE;
}
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
static gchar *
clutter_text_get_display_text (ClutterText *self)
{
ClutterTextPrivate *priv = self->priv;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
ClutterTextBuffer *buffer;
const gchar *text;
clutter-text: prevent text buffer creation if not needed When allocating or asking for preferred width/height on a ClutterText, it can notify a change on buffer/text/max-length if no text has been set. https://bugzilla.gnome.org/show_bug.cgi?id=703882
2013-07-09 15:46:35 +00:00
/* short-circuit the case where the buffer is unset or it's empty,
* to avoid creating a pointless TextBuffer and emitting
* notifications with it
*/
if (clutter_text_is_empty (self))
return g_strdup ("");
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
buffer = get_buffer (self);
text = clutter_text_buffer_get_text (buffer);
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
text: Clear up priv->text checks The priv->text field cannot ever be NULL, so we don't need to check for that in a series of places. We also need to assert() that pre-condition in the couple of places where we set the contents of the ClutterText actor, namely in set_text_internal() and set_markup_internal(). Based on a patch by: Dan Winship <danw@gnome.org> http://bugzilla.clutter-project.org/show_bug.cgi?id=2629
2011-09-07 12:28:15 +00:00
/* simple short-circuit to avoid going through GString
* with an empty text and a password char set
*/
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
if (text[0] == '\0')
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
return g_strdup ("");
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
if (G_LIKELY (priv->password_char == 0))
return g_strdup (text);
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
else
{
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
GString *str;
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
gunichar invisible_char;
gchar buf[7];
gint char_len, i;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
guint n_chars;
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
n_chars = clutter_text_buffer_get_length (buffer);
str = g_string_sized_new (clutter_text_buffer_get_bytes (buffer));
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
invisible_char = priv->password_char;
/* we need to convert the string built of invisible
* characters into UTF-8 for it to be fed to the Pango
* layout
*/
memset (buf, 0, sizeof (buf));
char_len = g_unichar_to_utf8 (invisible_char, buf);
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
if (priv->show_password_hint && priv->password_hint_visible)
{
char *last_char;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
for (i = 0; i < n_chars - 1; i++)
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
g_string_append_len (str, buf, char_len);
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
last_char = g_utf8_offset_to_pointer (text, n_chars - 1);
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
g_string_append (str, last_char);
}
else
{
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
for (i = 0; i < n_chars; i++)
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
g_string_append_len (str, buf, char_len);
}
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
return g_string_free (str, FALSE);
}
}
text: Style cleanups Inline wrapper functions, and remove deep nested if's.
2012-02-07 11:31:28 +00:00
static inline void
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
clutter_text_ensure_effective_attributes (ClutterText *self)
{
ClutterTextPrivate *priv = self->priv;
/* If we already have the effective attributes then we don't need to
do anything */
text: Style cleanups Inline wrapper functions, and remove deep nested if's.
2012-02-07 11:31:28 +00:00
if (priv->effective_attrs != NULL)
return;
clutter-text: Allow setting attributes for editable text The behaviour imitates GtkEntry and ignores attributes from markup because Pango barfs on invalid markup. Also add an example to the text-field interactive test. https://bugzilla.gnome.org/show_bug.cgi?id=686477
2012-12-17 18:56:57 +00:00
/* Same as if we don't have any attribute at all.
* We also ignore markup attributes for editable. */
if (priv->attrs == NULL && (priv->editable || priv->markup_attrs == NULL))
text: Style cleanups Inline wrapper functions, and remove deep nested if's.
2012-02-07 11:31:28 +00:00
return;
if (priv->attrs != NULL)
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
{
clutter-text: Allow setting attributes for editable text The behaviour imitates GtkEntry and ignores attributes from markup because Pango barfs on invalid markup. Also add an example to the text-field interactive test. https://bugzilla.gnome.org/show_bug.cgi?id=686477
2012-12-17 18:56:57 +00:00
/* If there are no markup attributes, or if this is editable (in which
* case we ignore markup), then we can just use these attrs directly */
if (priv->editable || priv->markup_attrs == NULL)
text: Style cleanups Inline wrapper functions, and remove deep nested if's.
2012-02-07 11:31:28 +00:00
priv->effective_attrs = pango_attr_list_ref (priv->attrs);
else
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
{
text: Style cleanups Inline wrapper functions, and remove deep nested if's.
2012-02-07 11:31:28 +00:00
/* Otherwise we need to merge the two lists */
PangoAttrIterator *iter;
GSList *attributes, *l;
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
text: Style cleanups Inline wrapper functions, and remove deep nested if's.
2012-02-07 11:31:28 +00:00
priv->effective_attrs = pango_attr_list_copy (priv->markup_attrs);
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
text: Style cleanups Inline wrapper functions, and remove deep nested if's.
2012-02-07 11:31:28 +00:00
iter = pango_attr_list_get_iterator (priv->attrs);
do
{
attributes = pango_attr_iterator_get_attrs (iter);
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
text: Style cleanups Inline wrapper functions, and remove deep nested if's.
2012-02-07 11:31:28 +00:00
for (l = attributes; l != NULL; l = l->next)
{
PangoAttribute *attr = l->data;
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
text: Style cleanups Inline wrapper functions, and remove deep nested if's.
2012-02-07 11:31:28 +00:00
pango_attr_list_insert (priv->effective_attrs, attr);
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
}
clutter-text: Fix memory leak
2011-12-19 04:20:04 +00:00
text: Style cleanups Inline wrapper functions, and remove deep nested if's.
2012-02-07 11:31:28 +00:00
g_slist_free (attributes);
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
}
text: Style cleanups Inline wrapper functions, and remove deep nested if's.
2012-02-07 11:31:28 +00:00
while (pango_attr_iterator_next (iter));
pango_attr_iterator_destroy (iter);
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
}
text: Style cleanups Inline wrapper functions, and remove deep nested if's.
2012-02-07 11:31:28 +00:00
}
else if (priv->markup_attrs != NULL)
{
/* We can just use the markup attributes directly */
priv->effective_attrs = pango_attr_list_ref (priv->markup_attrs);
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
}
}
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
static PangoLayout *
text: correct caching logic This patch combines a number of fixes and improvements to the layout caching logic in ClutterText. * Fix: The width must always be set on the PangoLayout when painting. This is necessary because the layout aligns in the width, and even when we think we are left-aligned, the auto-dir feature of PangoLayout may result in right-alignment. * Fix: We should only ever try to reuse a cached layout based on its logical width if layout.width was -1 when computing that logical width. If the layout was already ellipsized, then comparing the logical width to the new width we are trying to wrap to doesn't make sense. (If "abc" ellipsizes to a 15-pixel wide "..." for a width of 1 pixel, that doesn't mean that we should use "..." for a width of 15 pixels. Maybe "abc" itself is 15 pixels wide.) * Improvement: rather than looking up cached layouts based on the input allocation_width/allocation_height, look them up based on the actual width/height/ellipsize that we pass to create a layout. This is simpler and improves the chance we'll get a cache hit when appropriate even if there are small floating point differences. Note because of the first fix this is less aggressive than dd40732 in caching layouts; get_preferred_width() and painting can't share a layout since get_preferred_width() needs to pass a width of -1 to Pango and painting needs to pass the real width. The patch has been updated from the clutter-1.2 branch to current master; using the profiling instrumentation it is possible to verify with test-text-field that the hit/miss counters go from: Name Total Per Frame ---- ----- --------- Text layout cache hit counter 13 6 Text layout cache miss counter 11 5 before applying the patch, to: Name Total Per Frame ---- ----- --------- Text layout cache miss counter 4 2 Text layout cache hit counter 3 1 after applying the patch. https://bugzilla.gnome.org/show_bug.cgi?id=618104 http://bugzilla.openedhand.com/show_bug.cgi?id=2109 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-05-08 17:38:37 +00:00
clutter_text_create_layout_no_cache (ClutterText *text,
gint width,
gint height,
PangoEllipsizeMode ellipsize)
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
{
ClutterTextPrivate *priv = text->priv;
PangoLayout *layout;
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
gchar *contents;
gsize contents_len;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
[text] Use create_pango_layout() Since we added clutter_actor_get_pango_layout() it would be a good idea to use it in the ClutterText actor to cut down the PangoContext-related calls.
2009-02-02 12:04:34 +00:00
layout = clutter_actor_create_pango_layout (CLUTTER_ACTOR (text), NULL);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
pango_layout_set_font_description (layout, priv->font_desc);
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
contents = clutter_text_get_display_text (text);
contents_len = strlen (contents);
if (priv->editable && priv->preedit_set)
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
{
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
GString *tmp = g_string_new (contents);
PangoAttrList *tmp_attrs = pango_attr_list_new ();
gint cursor_index;
if (priv->position == 0)
cursor_index = 0;
[text] Do not use markup on an editable Text An editable ClutterText should not use pango_layout_set_markup(), as the contents of the text actor will not match the text. Only read-only text actors should parse the contents for Pango markup.
2009-01-07 13:48:45 +00:00
else
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
cursor_index = offset_to_bytes (contents, priv->position);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
g_string_insert (tmp, cursor_index, priv->preedit_str);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
pango_layout_set_text (layout, tmp->str, tmp->len);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
[text] Do not apply unset preedit attributes The pre-edit attributes are optional and thus should only be applied if they have been set to avoid assertion failures.
2009-09-19 08:18:06 +00:00
if (priv->preedit_attrs != NULL)
{
pango_attr_list_splice (tmp_attrs, priv->preedit_attrs,
cursor_index,
strlen (priv->preedit_str));
pango_layout_set_attributes (layout, tmp_attrs);
}
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
g_string_free (tmp, TRUE);
pango_attr_list_unref (tmp_attrs);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
}
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
else
text: Discover the direction of the contents We should set the direction on the PangoContext when creating a PangoLayout based on a best effort between the contents of the text itself and the text direction of the widget, in case that fails. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2014-03-03 18:04:19 +00:00
{
PangoDirection pango_dir;
if (priv->password_char != 0)
pango_dir = PANGO_DIRECTION_NEUTRAL;
else
pango_dir = pango_find_base_dir (contents, contents_len);
if (pango_dir == PANGO_DIRECTION_NEUTRAL)
{
text: Use the keymap direction when focused If the ClutterText actor has key focus then we should ask for the direction of the key map, instead of the direction of the actor. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2014-03-03 23:25:08 +00:00
ClutterBackend *backend = clutter_get_default_backend ();
text: Discover the direction of the contents We should set the direction on the PangoContext when creating a PangoLayout based on a best effort between the contents of the text itself and the text direction of the widget, in case that fails. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2014-03-03 18:04:19 +00:00
ClutterTextDirection text_dir;
text: Use the keymap direction when focused If the ClutterText actor has key focus then we should ask for the direction of the key map, instead of the direction of the actor. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2014-03-03 23:25:08 +00:00
if (clutter_actor_has_key_focus (CLUTTER_ACTOR (text)))
pango_dir = _clutter_backend_get_keymap_direction (backend);
text: Discover the direction of the contents We should set the direction on the PangoContext when creating a PangoLayout based on a best effort between the contents of the text itself and the text direction of the widget, in case that fails. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2014-03-03 18:04:19 +00:00
else
text: Use the keymap direction when focused If the ClutterText actor has key focus then we should ask for the direction of the key map, instead of the direction of the actor. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2014-03-03 23:25:08 +00:00
{
text_dir = clutter_actor_get_text_direction (CLUTTER_ACTOR (text));
if (text_dir == CLUTTER_TEXT_DIRECTION_RTL)
pango_dir = PANGO_DIRECTION_RTL;
else
pango_dir = PANGO_DIRECTION_LTR;
}
text: Discover the direction of the contents We should set the direction on the PangoContext when creating a PangoLayout based on a best effort between the contents of the text itself and the text direction of the widget, in case that fails. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2014-03-03 18:04:19 +00:00
}
pango_context_set_base_dir (clutter_actor_get_pango_context (CLUTTER_ACTOR (text)), pango_dir);
text: Use the resolved text direction Now that we compute the effective text direction when creating the Pango layout, we should also use it when painting it. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2014-03-03 19:16:00 +00:00
priv->resolved_direction = pango_dir;
text: Discover the direction of the contents We should set the direction on the PangoContext when creating a PangoLayout based on a best effort between the contents of the text itself and the text direction of the widget, in case that fails. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2014-03-03 18:04:19 +00:00
pango_layout_set_text (layout, contents, contents_len);
}
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
clutter-text: Allow setting attributes for editable text The behaviour imitates GtkEntry and ignores attributes from markup because Pango barfs on invalid markup. Also add an example to the text-field interactive test. https://bugzilla.gnome.org/show_bug.cgi?id=686477
2012-12-17 18:56:57 +00:00
/* This will merge the markup attributes and the attributes
* property if needed */
clutter_text_ensure_effective_attributes (text);
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
clutter-text: Allow setting attributes for editable text The behaviour imitates GtkEntry and ignores attributes from markup because Pango barfs on invalid markup. Also add an example to the text-field interactive test. https://bugzilla.gnome.org/show_bug.cgi?id=686477
2012-12-17 18:56:57 +00:00
if (priv->effective_attrs != NULL)
pango_layout_set_attributes (layout, priv->effective_attrs);
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
pango_layout_set_alignment (layout, priv->alignment);
pango_layout_set_single_paragraph_mode (layout, priv->single_line_mode);
pango_layout_set_justify (layout, priv->justify);
[ClutterText] Fix actors with a width but no wrapping and the wrap modes Setting the wrap mode on the PangoLayout seems to have disappeared during the text-actor-layout-height branch merge so this brings it back. The test for this in test-text-cache no longer needs to be disabled. We also shouldn't set the width on the layout if there is no wrapping or ellipsizing because otherwise it implicitly enables wrapping. This only matters if the actor gets allocated smaller than its natural size.
2009-04-21 13:15:19 +00:00
pango_layout_set_wrap (layout, priv->wrap_mode);
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
text: correct caching logic This patch combines a number of fixes and improvements to the layout caching logic in ClutterText. * Fix: The width must always be set on the PangoLayout when painting. This is necessary because the layout aligns in the width, and even when we think we are left-aligned, the auto-dir feature of PangoLayout may result in right-alignment. * Fix: We should only ever try to reuse a cached layout based on its logical width if layout.width was -1 when computing that logical width. If the layout was already ellipsized, then comparing the logical width to the new width we are trying to wrap to doesn't make sense. (If "abc" ellipsizes to a 15-pixel wide "..." for a width of 1 pixel, that doesn't mean that we should use "..." for a width of 15 pixels. Maybe "abc" itself is 15 pixels wide.) * Improvement: rather than looking up cached layouts based on the input allocation_width/allocation_height, look them up based on the actual width/height/ellipsize that we pass to create a layout. This is simpler and improves the chance we'll get a cache hit when appropriate even if there are small floating point differences. Note because of the first fix this is less aggressive than dd40732 in caching layouts; get_preferred_width() and painting can't share a layout since get_preferred_width() needs to pass a width of -1 to Pango and painting needs to pass the real width. The patch has been updated from the clutter-1.2 branch to current master; using the profiling instrumentation it is possible to verify with test-text-field that the hit/miss counters go from: Name Total Per Frame ---- ----- --------- Text layout cache hit counter 13 6 Text layout cache miss counter 11 5 before applying the patch, to: Name Total Per Frame ---- ----- --------- Text layout cache miss counter 4 2 Text layout cache hit counter 3 1 after applying the patch. https://bugzilla.gnome.org/show_bug.cgi?id=618104 http://bugzilla.openedhand.com/show_bug.cgi?id=2109 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-05-08 17:38:37 +00:00
pango_layout_set_ellipsize (layout, ellipsize);
pango_layout_set_width (layout, width);
pango_layout_set_height (layout, height);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
g_free (contents);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
return layout;
}
static void
clutter_text_dirty_cache (ClutterText *text)
{
ClutterTextPrivate *priv = text->priv;
int i;
/* Delete the cached layouts so they will be recreated the next time
they are needed */
for (i = 0; i < N_CACHED_LAYOUTS; i++)
if (priv->cached_layouts[i].layout)
{
g_object_unref (priv->cached_layouts[i].layout);
priv->cached_layouts[i].layout = NULL;
}
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
clutter_text_dirty_paint_volume (text);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
}
text: Update actors using the default font If a ClutterText actor is using the default font from the backend then we should track font name changes and update it accordingly. This only applies to ClutterText actors with the :font-name property unset or explicitly set to NULL.
2010-06-26 14:49:15 +00:00
/*
* clutter_text_set_font_description_internal:
* @self: a #ClutterText
* @desc: a #PangoFontDescription
*
* Sets @desc as the font description to be used by the #ClutterText
text: Clean up the set_font_description_internal() semantics The current semantics are ridiculous, and clearly a case of (mistaken) premature optimization. All setters should copy, not transfer ownership. https://bugzilla.gnome.org/show_bug.cgi?id=695119
2013-03-04 13:02:44 +00:00
* actor. The #PangoFontDescription is copied.
text: Update actors using the default font If a ClutterText actor is using the default font from the backend then we should track font name changes and update it accordingly. This only applies to ClutterText actors with the :font-name property unset or explicitly set to NULL.
2010-06-26 14:49:15 +00:00
*
* This function will also set the :font-name field as a side-effect
*
* This function will evict the layout cache, and queue a relayout if
* the #ClutterText actor has contents.
*/
static inline void
clutter_text_set_font_description_internal (ClutterText *self,
clutter-text: prevent reset of user set font descriptions on dpi changes When setting the font using clutter_text_set_font_description(), the font settings on a ClutterText actor can be reset when there is a dpi changes signaled by the backend. https://bugzilla.gnome.org/show_bug.cgi?id=702016
2013-06-11 13:01:30 +00:00
PangoFontDescription *desc,
gboolean is_default_font)
text: Update actors using the default font If a ClutterText actor is using the default font from the backend then we should track font name changes and update it accordingly. This only applies to ClutterText actors with the :font-name property unset or explicitly set to NULL.
2010-06-26 14:49:15 +00:00
{
ClutterTextPrivate *priv = self->priv;
clutter-text: prevent reset of user set font descriptions on dpi changes When setting the font using clutter_text_set_font_description(), the font settings on a ClutterText actor can be reset when there is a dpi changes signaled by the backend. https://bugzilla.gnome.org/show_bug.cgi?id=702016
2013-06-11 13:01:30 +00:00
priv->is_default_font = is_default_font;
text: Prevent a relayout if font descriptions or attrs are equal https://bugzilla.gnome.org/show_bug.cgi?id=689399
2012-12-01 01:21:23 +00:00
if (priv->font_desc == desc ||
pango_font_description_equal (priv->font_desc, desc))
text: Update actors using the default font If a ClutterText actor is using the default font from the backend then we should track font name changes and update it accordingly. This only applies to ClutterText actors with the :font-name property unset or explicitly set to NULL.
2010-06-26 14:49:15 +00:00
return;
if (priv->font_desc != NULL)
pango_font_description_free (priv->font_desc);
text: Clean up the set_font_description_internal() semantics The current semantics are ridiculous, and clearly a case of (mistaken) premature optimization. All setters should copy, not transfer ownership. https://bugzilla.gnome.org/show_bug.cgi?id=695119
2013-03-04 13:02:44 +00:00
priv->font_desc = pango_font_description_copy (desc);
text: Update actors using the default font If a ClutterText actor is using the default font from the backend then we should track font name changes and update it accordingly. This only applies to ClutterText actors with the :font-name property unset or explicitly set to NULL.
2010-06-26 14:49:15 +00:00
/* update the font name string we use */
g_free (priv->font_name);
priv->font_name = pango_font_description_to_string (priv->font_desc);
clutter_text_dirty_cache (self);
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
if (clutter_text_buffer_get_length (get_buffer (self)) != 0)
text: Update actors using the default font If a ClutterText actor is using the default font from the backend then we should track font name changes and update it accordingly. This only applies to ClutterText actors with the :font-name property unset or explicitly set to NULL.
2010-06-26 14:49:15 +00:00
clutter_actor_queue_relayout (CLUTTER_ACTOR (self));
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_FONT_DESCRIPTION]);
text: Update actors using the default font If a ClutterText actor is using the default font from the backend then we should track font name changes and update it accordingly. This only applies to ClutterText actors with the :font-name property unset or explicitly set to NULL.
2010-06-26 14:49:15 +00:00
}
Listen for the font-changed signal on the backend in ClutterText Whenever a ClutterText is created it now connects to the font-changed signal. When it is emitted the layout cache is dirtied and a relayout is queued. That way changes to the font options or resolution will cause an immediate update to the labels in the scene.
2009-01-27 16:47:20 +00:00
static void
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
clutter_text_settings_changed_cb (ClutterText *text)
Listen for the font-changed signal on the backend in ClutterText Whenever a ClutterText is created it now connects to the font-changed signal. When it is emitted the layout cache is dirtied and a relayout is queued. That way changes to the font options or resolution will cause an immediate update to the labels in the scene.
2009-01-27 16:47:20 +00:00
{
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
ClutterTextPrivate *priv = text->priv;
guint password_hint_time = 0;
ClutterSettings *settings;
settings = clutter_settings_get_default ();
g_object_get (settings, "password-hint-time", &password_hint_time, NULL);
priv->show_password_hint = password_hint_time > 0;
priv->password_hint_timeout = password_hint_time;
if (priv->is_default_font)
text: Update actors using the default font If a ClutterText actor is using the default font from the backend then we should track font name changes and update it accordingly. This only applies to ClutterText actors with the :font-name property unset or explicitly set to NULL.
2010-06-26 14:49:15 +00:00
{
PangoFontDescription *font_desc;
Do not use deprecated API internally
2010-09-10 13:27:37 +00:00
gchar *font_name = NULL;
g_object_get (settings, "font-name", &font_name, NULL);
text: Update actors using the default font If a ClutterText actor is using the default font from the backend then we should track font name changes and update it accordingly. This only applies to ClutterText actors with the :font-name property unset or explicitly set to NULL.
2010-06-26 14:49:15 +00:00
CLUTTER_NOTE (ACTOR, "Text[%p]: default font changed to '%s'",
text,
font_name);
font_desc = pango_font_description_from_string (font_name);
clutter-text: prevent reset of user set font descriptions on dpi changes When setting the font using clutter_text_set_font_description(), the font settings on a ClutterText actor can be reset when there is a dpi changes signaled by the backend. https://bugzilla.gnome.org/show_bug.cgi?id=702016
2013-06-11 13:01:30 +00:00
clutter_text_set_font_description_internal (text, font_desc, TRUE);
Do not use deprecated API internally
2010-09-10 13:27:37 +00:00
text: Clean up the set_font_description_internal() semantics The current semantics are ridiculous, and clearly a case of (mistaken) premature optimization. All setters should copy, not transfer ownership. https://bugzilla.gnome.org/show_bug.cgi?id=695119
2013-03-04 13:02:44 +00:00
pango_font_description_free (font_desc);
Do not use deprecated API internally
2010-09-10 13:27:37 +00:00
g_free (font_name);
text: Update actors using the default font If a ClutterText actor is using the default font from the backend then we should track font name changes and update it accordingly. This only applies to ClutterText actors with the :font-name property unset or explicitly set to NULL.
2010-06-26 14:49:15 +00:00
}
Listen for the font-changed signal on the backend in ClutterText Whenever a ClutterText is created it now connects to the font-changed signal. When it is emitted the layout cache is dirtied and a relayout is queued. That way changes to the font options or resolution will cause an immediate update to the labels in the scene.
2009-01-27 16:47:20 +00:00
clutter_text_dirty_cache (text);
clutter_actor_queue_relayout (CLUTTER_ACTOR (text));
}
text: Dirty layout cache on text direction changes When the text direction changes we should evict the cached layouts to avoid stale entries in case the direction change produces a layout with the same size.
2009-11-10 12:18:32 +00:00
static void
clutter_text_direction_changed_cb (GObject *gobject,
GParamSpec *pspec)
{
clutter_text_dirty_cache (CLUTTER_TEXT (gobject));
/* no need to queue a relayout: set_text_direction() will do that for us */
}
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
/*
* clutter_text_create_layout:
* @text: a #ClutterText
* @allocation_width: the allocation width
Support pango_layout_set_height() in ClutterText This is the port of the patch attached to bug 1266: ClutterLabel support for pango_layout_set_height() to the ClutterText actor. This patch adds support for the pango_layout_set_height() function inside the layout creation and caching, so that setting the height of a ClutterText will make PangoLayout try to fill out the given height before ellipsizing the contents of the ClutterText actor. The original patch is from Havoc Pennington. This commit ports the patch to ClutterText and applies a small change to the height computation pointed out by Behdad Esfahbod on GNOME's Bugzilla: http://bugzilla.gnome.org/show_bug.cgi?id=560931 That the layout heights when doing a size request should be set to be G_MAXINT instead of -1. Unfortunately, the patch seems to break the conformance suite when setting the ellipsization on the layout.
2008-12-16 14:02:05 +00:00
* @allocation_height: the allocation height
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
*
* Like clutter_text_create_layout_no_cache(), but will also ensure
* the glyphs cache. If a previously cached layout generated using the
* same width is available then that will be used instead of
* generating a new one.
*/
static PangoLayout *
clutter_text_create_layout (ClutterText *text,
Remove Units from the public API With the recent change to internal floating point values, ClutterUnit has become a redundant type, defined to be a float. All integer entry points are being internally converted to floating point values to be passed to the GL pipeline with the least amount of conversion. ClutterUnit is thus exposed as just a "pixel with fractionary bits", and not -- as users might think -- as generic, resolution and device independent units. not that it was the case, but a definitive amount of people was convinced it did provide this "feature", and was flummoxed about the mere existence of this type. So, having ClutterUnit exposed in the public API doubles the entry points and has the following disadvantages: - we have to maintain twice the amount of entry points in ClutterActor - we still do an integer-to-float implicit conversion - we introduce a weird impedance between pixels and "pixels with fractionary bits" - language bindings will have to choose what to bind, and resort to manually overriding the API + *except* for language bindings based on GObject-Introspection, as they cannot do manual overrides, thus will replicate the entire set of entry points For these reason, we should coalesces every Actor entry point for pixels and for ClutterUnit into a single entry point taking a float, like: void clutter_actor_set_x (ClutterActor *self, gfloat x); void clutter_actor_get_size (ClutterActor *self, gfloat *width, gfloat *height); gfloat clutter_actor_get_height (ClutterActor *self); etc. The issues I have identified are: - we'll have a two cases of compiler warnings: - printf() format of the return values from %d to %f - clutter_actor_get_size() taking floats instead of unsigned ints - we'll have a problem with varargs when passing an integer instead of a floating point value, except on 64bit platforms where the size of a float is the same as the size of an int To be clear: the *intent* of the API should not change -- we still use pixels everywhere -- but: - we remove ambiguity in the API with regard to pixels and units - we remove entry points we get to maintain for the whole 1.0 version of the API - we make things simpler to bind for both manual language bindings and automatic (gobject-introspection based) ones - we have the simplest API possible while still exposing the capabilities of the underlying GL implementation
2009-05-06 15:44:47 +00:00
gfloat allocation_width,
gfloat allocation_height)
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
{
ClutterTextPrivate *priv = text->priv;
LayoutCache *oldest_cache = priv->cached_layouts;
gboolean found_free_cache = FALSE;
text: correct caching logic This patch combines a number of fixes and improvements to the layout caching logic in ClutterText. * Fix: The width must always be set on the PangoLayout when painting. This is necessary because the layout aligns in the width, and even when we think we are left-aligned, the auto-dir feature of PangoLayout may result in right-alignment. * Fix: We should only ever try to reuse a cached layout based on its logical width if layout.width was -1 when computing that logical width. If the layout was already ellipsized, then comparing the logical width to the new width we are trying to wrap to doesn't make sense. (If "abc" ellipsizes to a 15-pixel wide "..." for a width of 1 pixel, that doesn't mean that we should use "..." for a width of 15 pixels. Maybe "abc" itself is 15 pixels wide.) * Improvement: rather than looking up cached layouts based on the input allocation_width/allocation_height, look them up based on the actual width/height/ellipsize that we pass to create a layout. This is simpler and improves the chance we'll get a cache hit when appropriate even if there are small floating point differences. Note because of the first fix this is less aggressive than dd40732 in caching layouts; get_preferred_width() and painting can't share a layout since get_preferred_width() needs to pass a width of -1 to Pango and painting needs to pass the real width. The patch has been updated from the clutter-1.2 branch to current master; using the profiling instrumentation it is possible to verify with test-text-field that the hit/miss counters go from: Name Total Per Frame ---- ----- --------- Text layout cache hit counter 13 6 Text layout cache miss counter 11 5 before applying the patch, to: Name Total Per Frame ---- ----- --------- Text layout cache miss counter 4 2 Text layout cache hit counter 3 1 after applying the patch. https://bugzilla.gnome.org/show_bug.cgi?id=618104 http://bugzilla.openedhand.com/show_bug.cgi?id=2109 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-05-08 17:38:37 +00:00
gint width = -1;
gint height = -1;
PangoEllipsizeMode ellipsize = PANGO_ELLIPSIZE_NONE;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
int i;
text: correct caching logic This patch combines a number of fixes and improvements to the layout caching logic in ClutterText. * Fix: The width must always be set on the PangoLayout when painting. This is necessary because the layout aligns in the width, and even when we think we are left-aligned, the auto-dir feature of PangoLayout may result in right-alignment. * Fix: We should only ever try to reuse a cached layout based on its logical width if layout.width was -1 when computing that logical width. If the layout was already ellipsized, then comparing the logical width to the new width we are trying to wrap to doesn't make sense. (If "abc" ellipsizes to a 15-pixel wide "..." for a width of 1 pixel, that doesn't mean that we should use "..." for a width of 15 pixels. Maybe "abc" itself is 15 pixels wide.) * Improvement: rather than looking up cached layouts based on the input allocation_width/allocation_height, look them up based on the actual width/height/ellipsize that we pass to create a layout. This is simpler and improves the chance we'll get a cache hit when appropriate even if there are small floating point differences. Note because of the first fix this is less aggressive than dd40732 in caching layouts; get_preferred_width() and painting can't share a layout since get_preferred_width() needs to pass a width of -1 to Pango and painting needs to pass the real width. The patch has been updated from the clutter-1.2 branch to current master; using the profiling instrumentation it is possible to verify with test-text-field that the hit/miss counters go from: Name Total Per Frame ---- ----- --------- Text layout cache hit counter 13 6 Text layout cache miss counter 11 5 before applying the patch, to: Name Total Per Frame ---- ----- --------- Text layout cache miss counter 4 2 Text layout cache hit counter 3 1 after applying the patch. https://bugzilla.gnome.org/show_bug.cgi?id=618104 http://bugzilla.openedhand.com/show_bug.cgi?id=2109 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-05-08 17:38:37 +00:00
/* First determine the width, height, and ellipsize mode that
* we need for the layout. The ellipsize mode depends on
* allocation_width/allocation_size as follows:
*
* Cases, assuming ellipsize != NONE on actor:
*
* Width request: ellipsization can be set or not on layout,
* doesn't matter.
*
* Height request: ellipsization must never be set on layout
* if wrap=true, because we need to measure the wrapped
* height. It must always be set if wrap=false.
*
* Allocate: ellipsization must always be set.
*
* See http://bugzilla.gnome.org/show_bug.cgi?id=560931
*/
text: Fix typos that were causing false-positive cache hits If a cached layout didn't actually match the layout we're looking for, it would be returned anyway. Remove this return so that it can correctly continue looking and get a cache miss if appropriate. http://bugzilla.openedhand.com/show_bug.cgi?id=2109
2010-05-13 14:51:42 +00:00
if (priv->ellipsize != PANGO_ELLIPSIZE_NONE)
text: correct caching logic This patch combines a number of fixes and improvements to the layout caching logic in ClutterText. * Fix: The width must always be set on the PangoLayout when painting. This is necessary because the layout aligns in the width, and even when we think we are left-aligned, the auto-dir feature of PangoLayout may result in right-alignment. * Fix: We should only ever try to reuse a cached layout based on its logical width if layout.width was -1 when computing that logical width. If the layout was already ellipsized, then comparing the logical width to the new width we are trying to wrap to doesn't make sense. (If "abc" ellipsizes to a 15-pixel wide "..." for a width of 1 pixel, that doesn't mean that we should use "..." for a width of 15 pixels. Maybe "abc" itself is 15 pixels wide.) * Improvement: rather than looking up cached layouts based on the input allocation_width/allocation_height, look them up based on the actual width/height/ellipsize that we pass to create a layout. This is simpler and improves the chance we'll get a cache hit when appropriate even if there are small floating point differences. Note because of the first fix this is less aggressive than dd40732 in caching layouts; get_preferred_width() and painting can't share a layout since get_preferred_width() needs to pass a width of -1 to Pango and painting needs to pass the real width. The patch has been updated from the clutter-1.2 branch to current master; using the profiling instrumentation it is possible to verify with test-text-field that the hit/miss counters go from: Name Total Per Frame ---- ----- --------- Text layout cache hit counter 13 6 Text layout cache miss counter 11 5 before applying the patch, to: Name Total Per Frame ---- ----- --------- Text layout cache miss counter 4 2 Text layout cache hit counter 3 1 after applying the patch. https://bugzilla.gnome.org/show_bug.cgi?id=618104 http://bugzilla.openedhand.com/show_bug.cgi?id=2109 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-05-08 17:38:37 +00:00
{
if (allocation_height < 0 && priv->wrap)
; /* must not set ellipsization on wrap=true height request */
else
{
if (!priv->editable)
ellipsize = priv->ellipsize;
}
}
/* When painting, we always need to set the width, since
* we might need to align to the right. When getting the
* height, however, there are some cases where we know that
* the width won't affect the width.
*
* - editable, single-line text actors, since those can
* scroll the layout.
* - non-wrapping, non-ellipsizing actors.
*/
if (allocation_width >= 0 &&
(allocation_height >= 0 ||
!((priv->editable && priv->single_line_mode) ||
(priv->ellipsize == PANGO_ELLIPSIZE_NONE && !priv->wrap))))
{
clutter-text: Round the layout width to nearest integer not down When converting the floating point allocation width to an integer multiple of PANGO_SCALE to give to the PangoLayout it can sometimes end up slightly short of the allocated size due to rounding errors. This can cause some of the lines to be wrapped differently when a non-integer-aligned position is used (such as when animating text). It works better to round the number to the nearest integer by adding 0.5 instead of letting the default float cast truncate it downwards. http://bugzilla.openedhand.com/show_bug.cgi?id=2170
2010-06-14 10:59:33 +00:00
width = allocation_width * 1024 + 0.5f;
text: correct caching logic This patch combines a number of fixes and improvements to the layout caching logic in ClutterText. * Fix: The width must always be set on the PangoLayout when painting. This is necessary because the layout aligns in the width, and even when we think we are left-aligned, the auto-dir feature of PangoLayout may result in right-alignment. * Fix: We should only ever try to reuse a cached layout based on its logical width if layout.width was -1 when computing that logical width. If the layout was already ellipsized, then comparing the logical width to the new width we are trying to wrap to doesn't make sense. (If "abc" ellipsizes to a 15-pixel wide "..." for a width of 1 pixel, that doesn't mean that we should use "..." for a width of 15 pixels. Maybe "abc" itself is 15 pixels wide.) * Improvement: rather than looking up cached layouts based on the input allocation_width/allocation_height, look them up based on the actual width/height/ellipsize that we pass to create a layout. This is simpler and improves the chance we'll get a cache hit when appropriate even if there are small floating point differences. Note because of the first fix this is less aggressive than dd40732 in caching layouts; get_preferred_width() and painting can't share a layout since get_preferred_width() needs to pass a width of -1 to Pango and painting needs to pass the real width. The patch has been updated from the clutter-1.2 branch to current master; using the profiling instrumentation it is possible to verify with test-text-field that the hit/miss counters go from: Name Total Per Frame ---- ----- --------- Text layout cache hit counter 13 6 Text layout cache miss counter 11 5 before applying the patch, to: Name Total Per Frame ---- ----- --------- Text layout cache miss counter 4 2 Text layout cache hit counter 3 1 after applying the patch. https://bugzilla.gnome.org/show_bug.cgi?id=618104 http://bugzilla.openedhand.com/show_bug.cgi?id=2109 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-05-08 17:38:37 +00:00
}
/* Pango only uses height if ellipsization is enabled, so don't set
* height if ellipsize isn't set. Pango implicitly enables wrapping
* if height is set, so don't set height if wrapping is disabled.
* In other words, only set height if we want to both wrap then
* ellipsize and we're not in single line mode.
*
* See http://bugzilla.gnome.org/show_bug.cgi?id=560931 if this
* seems odd.
*/
if (allocation_height >= 0 &&
priv->wrap &&
priv->ellipsize != PANGO_ELLIPSIZE_NONE &&
!priv->single_line_mode)
{
clutter-text: Round the layout width to nearest integer not down When converting the floating point allocation width to an integer multiple of PANGO_SCALE to give to the PangoLayout it can sometimes end up slightly short of the allocated size due to rounding errors. This can cause some of the lines to be wrapped differently when a non-integer-aligned position is used (such as when animating text). It works better to round the number to the nearest integer by adding 0.5 instead of letting the default float cast truncate it downwards. http://bugzilla.openedhand.com/show_bug.cgi?id=2170
2010-06-14 10:59:33 +00:00
height = allocation_height * 1024 + 0.5f;
text: correct caching logic This patch combines a number of fixes and improvements to the layout caching logic in ClutterText. * Fix: The width must always be set on the PangoLayout when painting. This is necessary because the layout aligns in the width, and even when we think we are left-aligned, the auto-dir feature of PangoLayout may result in right-alignment. * Fix: We should only ever try to reuse a cached layout based on its logical width if layout.width was -1 when computing that logical width. If the layout was already ellipsized, then comparing the logical width to the new width we are trying to wrap to doesn't make sense. (If "abc" ellipsizes to a 15-pixel wide "..." for a width of 1 pixel, that doesn't mean that we should use "..." for a width of 15 pixels. Maybe "abc" itself is 15 pixels wide.) * Improvement: rather than looking up cached layouts based on the input allocation_width/allocation_height, look them up based on the actual width/height/ellipsize that we pass to create a layout. This is simpler and improves the chance we'll get a cache hit when appropriate even if there are small floating point differences. Note because of the first fix this is less aggressive than dd40732 in caching layouts; get_preferred_width() and painting can't share a layout since get_preferred_width() needs to pass a width of -1 to Pango and painting needs to pass the real width. The patch has been updated from the clutter-1.2 branch to current master; using the profiling instrumentation it is possible to verify with test-text-field that the hit/miss counters go from: Name Total Per Frame ---- ----- --------- Text layout cache hit counter 13 6 Text layout cache miss counter 11 5 before applying the patch, to: Name Total Per Frame ---- ----- --------- Text layout cache miss counter 4 2 Text layout cache hit counter 3 1 after applying the patch. https://bugzilla.gnome.org/show_bug.cgi?id=618104 http://bugzilla.openedhand.com/show_bug.cgi?id=2109 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-05-08 17:38:37 +00:00
}
Support pango_layout_set_height() in ClutterText This is the port of the patch attached to bug 1266: ClutterLabel support for pango_layout_set_height() to the ClutterText actor. This patch adds support for the pango_layout_set_height() function inside the layout creation and caching, so that setting the height of a ClutterText will make PangoLayout try to fill out the given height before ellipsizing the contents of the ClutterText actor. The original patch is from Havoc Pennington. This commit ports the patch to ClutterText and applies a small change to the height computation pointed out by Behdad Esfahbod on GNOME's Bugzilla: http://bugzilla.gnome.org/show_bug.cgi?id=560931 That the layout heights when doing a size request should be set to be G_MAXINT instead of -1. Unfortunately, the patch seems to break the conformance suite when setting the ellipsization on the layout.
2008-12-16 14:02:05 +00:00
/* Search for a cached layout with the same width and keep
* track of the oldest one
*/
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
for (i = 0; i < N_CACHED_LAYOUTS; i++)
{
if (priv->cached_layouts[i].layout == NULL)
{
/* Always prefer free cache spaces */
found_free_cache = TRUE;
oldest_cache = priv->cached_layouts + i;
}
text: Check generated size of layouts in cache By comparing the requested size against the computed sized for existing Pango layouts we can avoid creating layouts where the requested size matches that of a previously computed one. In particular this optimisation means that when working with a fixed positioning based layout (with no constraints on the size of the ClutterText) the same PangoLayout can be used to calculate the preferred width, height and also the layout used for the actual painting. http://bugzilla.openedhand.com/show_bug.cgi?id=2078 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-04-13 23:12:02 +00:00
else
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
{
text: correct caching logic This patch combines a number of fixes and improvements to the layout caching logic in ClutterText. * Fix: The width must always be set on the PangoLayout when painting. This is necessary because the layout aligns in the width, and even when we think we are left-aligned, the auto-dir feature of PangoLayout may result in right-alignment. * Fix: We should only ever try to reuse a cached layout based on its logical width if layout.width was -1 when computing that logical width. If the layout was already ellipsized, then comparing the logical width to the new width we are trying to wrap to doesn't make sense. (If "abc" ellipsizes to a 15-pixel wide "..." for a width of 1 pixel, that doesn't mean that we should use "..." for a width of 15 pixels. Maybe "abc" itself is 15 pixels wide.) * Improvement: rather than looking up cached layouts based on the input allocation_width/allocation_height, look them up based on the actual width/height/ellipsize that we pass to create a layout. This is simpler and improves the chance we'll get a cache hit when appropriate even if there are small floating point differences. Note because of the first fix this is less aggressive than dd40732 in caching layouts; get_preferred_width() and painting can't share a layout since get_preferred_width() needs to pass a width of -1 to Pango and painting needs to pass the real width. The patch has been updated from the clutter-1.2 branch to current master; using the profiling instrumentation it is possible to verify with test-text-field that the hit/miss counters go from: Name Total Per Frame ---- ----- --------- Text layout cache hit counter 13 6 Text layout cache miss counter 11 5 before applying the patch, to: Name Total Per Frame ---- ----- --------- Text layout cache miss counter 4 2 Text layout cache hit counter 3 1 after applying the patch. https://bugzilla.gnome.org/show_bug.cgi?id=618104 http://bugzilla.openedhand.com/show_bug.cgi?id=2109 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-05-08 17:38:37 +00:00
PangoLayout *cached = priv->cached_layouts[i].layout;
gint cached_width = pango_layout_get_width (cached);
gint cached_height = pango_layout_get_height (cached);
gint cached_ellipsize = pango_layout_get_ellipsize (cached);
if (cached_width == width &&
cached_height == height &&
cached_ellipsize == ellipsize)
{
/* If this cached layout is using the same size then we can
* just return that directly
profile: Add profiling points for Text Add a static timer for the text layout code, and two counters for the layout cache hit and miss conditions.
2010-04-22 16:54:05 +00:00
*/
text: correct caching logic This patch combines a number of fixes and improvements to the layout caching logic in ClutterText. * Fix: The width must always be set on the PangoLayout when painting. This is necessary because the layout aligns in the width, and even when we think we are left-aligned, the auto-dir feature of PangoLayout may result in right-alignment. * Fix: We should only ever try to reuse a cached layout based on its logical width if layout.width was -1 when computing that logical width. If the layout was already ellipsized, then comparing the logical width to the new width we are trying to wrap to doesn't make sense. (If "abc" ellipsizes to a 15-pixel wide "..." for a width of 1 pixel, that doesn't mean that we should use "..." for a width of 15 pixels. Maybe "abc" itself is 15 pixels wide.) * Improvement: rather than looking up cached layouts based on the input allocation_width/allocation_height, look them up based on the actual width/height/ellipsize that we pass to create a layout. This is simpler and improves the chance we'll get a cache hit when appropriate even if there are small floating point differences. Note because of the first fix this is less aggressive than dd40732 in caching layouts; get_preferred_width() and painting can't share a layout since get_preferred_width() needs to pass a width of -1 to Pango and painting needs to pass the real width. The patch has been updated from the clutter-1.2 branch to current master; using the profiling instrumentation it is possible to verify with test-text-field that the hit/miss counters go from: Name Total Per Frame ---- ----- --------- Text layout cache hit counter 13 6 Text layout cache miss counter 11 5 before applying the patch, to: Name Total Per Frame ---- ----- --------- Text layout cache miss counter 4 2 Text layout cache hit counter 3 1 after applying the patch. https://bugzilla.gnome.org/show_bug.cgi?id=618104 http://bugzilla.openedhand.com/show_bug.cgi?id=2109 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-05-08 17:38:37 +00:00
CLUTTER_NOTE (ACTOR,
"ClutterText: %p: cache hit for size %.2fx%.2f",
text,
allocation_width,
allocation_height);
return priv->cached_layouts[i].layout;
}
/* When getting the preferred height for a specific width,
* we might be able to reuse the layout from getting the
* preferred width. If the width that the layout gives
* unconstrained is less than the width that we are using
* than the height will be unaffected by that width.
*/
if (allocation_height < 0 &&
cached_width == -1 &&
cached_ellipsize == ellipsize)
{
PangoRectangle logical_rect;
pango_layout_get_extents (priv->cached_layouts[i].layout,
NULL,
&logical_rect);
if (logical_rect.width <= width)
{
/* We've been asked for our height for the width we gave as a result
* of a _get_preferred_width call
*/
CLUTTER_NOTE (ACTOR,
"ClutterText: %p: cache hit for size %.2fx%.2f "
"(unwrapped width narrower than given width)",
text,
allocation_width,
allocation_height);
return priv->cached_layouts[i].layout;
}
}
if (!found_free_cache &&
(priv->cached_layouts[i].age < oldest_cache->age))
{
oldest_cache = priv->cached_layouts + i;
}
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
}
}
[text] Add ClutterText::delete_selection() Add a method for deleting the current selection inside a Text actor. This is useful for subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:08:25 +00:00
CLUTTER_NOTE (ACTOR, "ClutterText: %p: cache miss for size %.2fx%.2f",
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
text,
[text] Add ClutterText::delete_selection() Add a method for deleting the current selection inside a Text actor. This is useful for subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:08:25 +00:00
allocation_width,
allocation_height);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
/* If we make it here then we didn't have a cached version so we
need to recreate the layout */
if (oldest_cache->layout)
g_object_unref (oldest_cache->layout);
oldest_cache->layout =
text: correct caching logic This patch combines a number of fixes and improvements to the layout caching logic in ClutterText. * Fix: The width must always be set on the PangoLayout when painting. This is necessary because the layout aligns in the width, and even when we think we are left-aligned, the auto-dir feature of PangoLayout may result in right-alignment. * Fix: We should only ever try to reuse a cached layout based on its logical width if layout.width was -1 when computing that logical width. If the layout was already ellipsized, then comparing the logical width to the new width we are trying to wrap to doesn't make sense. (If "abc" ellipsizes to a 15-pixel wide "..." for a width of 1 pixel, that doesn't mean that we should use "..." for a width of 15 pixels. Maybe "abc" itself is 15 pixels wide.) * Improvement: rather than looking up cached layouts based on the input allocation_width/allocation_height, look them up based on the actual width/height/ellipsize that we pass to create a layout. This is simpler and improves the chance we'll get a cache hit when appropriate even if there are small floating point differences. Note because of the first fix this is less aggressive than dd40732 in caching layouts; get_preferred_width() and painting can't share a layout since get_preferred_width() needs to pass a width of -1 to Pango and painting needs to pass the real width. The patch has been updated from the clutter-1.2 branch to current master; using the profiling instrumentation it is possible to verify with test-text-field that the hit/miss counters go from: Name Total Per Frame ---- ----- --------- Text layout cache hit counter 13 6 Text layout cache miss counter 11 5 before applying the patch, to: Name Total Per Frame ---- ----- --------- Text layout cache miss counter 4 2 Text layout cache hit counter 3 1 after applying the patch. https://bugzilla.gnome.org/show_bug.cgi?id=618104 http://bugzilla.openedhand.com/show_bug.cgi?id=2109 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-05-08 17:38:37 +00:00
clutter_text_create_layout_no_cache (text, width, height, ellipsize);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
cogl_pango_ensure_glyph_cache_for_layout (oldest_cache->layout);
/* Mark the 'time' this cache was created and advance the time */
oldest_cache->age = priv->cache_age++;
return oldest_cache->layout;
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Add the coords_to_position() method The reverse of position_to_coords(). While providing documentation on how to implement it using the PangoLayout API, I realized that the verbosity of it all, plus the usage of the Pango API, was not worth it, and decided to expose the method we are using internally.
2012-02-06 18:23:21 +00:00
/**
* clutter_text_coords_to_position:
* @self: a #ClutterText
* @x: the X coordinate, relative to the actor
* @y: the Y coordinate, relative to the actor
*
* Retrieves the position of the character at the given coordinates.
*
* Return: the position of the character
*
* Since: 1.10
*/
gint
clutter_text_coords_to_position (ClutterText *self,
Remove usage of Units and macros The ClutterUnit and relative macros should not be used when dealing with pixels -- which is to say, all the time when inside Clutter.
2009-06-02 17:44:30 +00:00
gfloat x,
gfloat y)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
gint index_;
gint px, py;
gint trailing;
text: Add the coords_to_position() method The reverse of position_to_coords(). While providing documentation on how to implement it using the PangoLayout API, I realized that the verbosity of it all, plus the usage of the Pango API, was not worth it, and decided to expose the method we are using internally.
2012-02-06 18:23:21 +00:00
g_return_val_if_fail (CLUTTER_IS_TEXT (self), 0);
[text] take scrolling into account when calculating cursor position Account for the scrolling in single line more when calculating the cursor position from coordinates.
2009-05-14 09:51:58 +00:00
text: Add the coords_to_position() method The reverse of position_to_coords(). While providing documentation on how to implement it using the PangoLayout API, I realized that the verbosity of it all, plus the usage of the Pango API, was not worth it, and decided to expose the method we are using internally.
2012-02-06 18:23:21 +00:00
/* Take any offset due to scrolling into account, and normalize
* the coordinates to PangoScale units
*/
px = (x - self->priv->text_x) * PANGO_SCALE;
py = (y - self->priv->text_y) * PANGO_SCALE;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Add the coords_to_position() method The reverse of position_to_coords(). While providing documentation on how to implement it using the PangoLayout API, I realized that the verbosity of it all, plus the usage of the Pango API, was not worth it, and decided to expose the method we are using internally.
2012-02-06 18:23:21 +00:00
pango_layout_xy_to_index (clutter_text_get_layout (self),
Use units in position_to_coords() We loose precision with a direct conversion for PangoUnits to pixels, so we should do the conversion as needed, inside the callers of clutter_text_position_to_coords().
2008-12-15 18:24:42 +00:00
px, py,
&index_, &trailing);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
return index_ + trailing;
}
[text] Expose position_to_coords() The clutter_text_position_to_coords() is useful for ClutterText subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:18:12 +00:00
/**
Use units in position_to_coords() We loose precision with a direct conversion for PangoUnits to pixels, so we should do the conversion as needed, inside the callers of clutter_text_position_to_coords().
2008-12-15 18:24:42 +00:00
* clutter_text_position_to_coords:
* @self: a #ClutterText
* @position: position in characters
introspection: Add missing (out) annotations Comprehensively add (out) annotations to functions parameters returning int/float/double. Not handled here: structure out returns like ClutterColor or ClutterPerspective or GValue that should get (out caller-allocates). Not handled here: Cogl http://bugzilla.clutter-project.org/show_bug.cgi?id=2302
2010-09-08 14:37:58 +00:00
* @x: (out): return location for the X coordinate, or %NULL
* @y: (out): return location for the Y coordinate, or %NULL
* @line_height: (out): return location for the line height, or %NULL
Use units in position_to_coords() We loose precision with a direct conversion for PangoUnits to pixels, so we should do the conversion as needed, inside the callers of clutter_text_position_to_coords().
2008-12-15 18:24:42 +00:00
*
* Retrieves the coordinates of the given @position.
*
* Return value: %TRUE if the conversion was successful
[text] Expose position_to_coords() The clutter_text_position_to_coords() is useful for ClutterText subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:18:12 +00:00
*
* Since: 1.0
Use units in position_to_coords() We loose precision with a direct conversion for PangoUnits to pixels, so we should do the conversion as needed, inside the callers of clutter_text_position_to_coords().
2008-12-15 18:24:42 +00:00
*/
[text] Expose position_to_coords() The clutter_text_position_to_coords() is useful for ClutterText subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:18:12 +00:00
gboolean
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
clutter_text_position_to_coords (ClutterText *self,
gint position,
Remove Units from the public API With the recent change to internal floating point values, ClutterUnit has become a redundant type, defined to be a float. All integer entry points are being internally converted to floating point values to be passed to the GL pipeline with the least amount of conversion. ClutterUnit is thus exposed as just a "pixel with fractionary bits", and not -- as users might think -- as generic, resolution and device independent units. not that it was the case, but a definitive amount of people was convinced it did provide this "feature", and was flummoxed about the mere existence of this type. So, having ClutterUnit exposed in the public API doubles the entry points and has the following disadvantages: - we have to maintain twice the amount of entry points in ClutterActor - we still do an integer-to-float implicit conversion - we introduce a weird impedance between pixels and "pixels with fractionary bits" - language bindings will have to choose what to bind, and resort to manually overriding the API + *except* for language bindings based on GObject-Introspection, as they cannot do manual overrides, thus will replicate the entire set of entry points For these reason, we should coalesces every Actor entry point for pixels and for ClutterUnit into a single entry point taking a float, like: void clutter_actor_set_x (ClutterActor *self, gfloat x); void clutter_actor_get_size (ClutterActor *self, gfloat *width, gfloat *height); gfloat clutter_actor_get_height (ClutterActor *self); etc. The issues I have identified are: - we'll have a two cases of compiler warnings: - printf() format of the return values from %d to %f - clutter_actor_get_size() taking floats instead of unsigned ints - we'll have a problem with varargs when passing an integer instead of a floating point value, except on 64bit platforms where the size of a float is the same as the size of an int To be clear: the *intent* of the API should not change -- we still use pixels everywhere -- but: - we remove ambiguity in the API with regard to pixels and units - we remove entry points we get to maintain for the whole 1.0 version of the API - we make things simpler to bind for both manual language bindings and automatic (gobject-introspection based) ones - we have the simplest API possible while still exposing the capabilities of the underlying GL implementation
2009-05-06 15:44:47 +00:00
gfloat *x,
gfloat *y,
gfloat *line_height)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
[text] Expose position_to_coords() The clutter_text_position_to_coords() is useful for ClutterText subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:18:12 +00:00
ClutterTextPrivate *priv;
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
PangoRectangle rect;
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
gint n_chars;
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
gint password_char_bytes = 1;
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
gint index_;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
gsize n_bytes;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
[text] Expose position_to_coords() The clutter_text_position_to_coords() is useful for ClutterText subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:18:12 +00:00
g_return_val_if_fail (CLUTTER_IS_TEXT (self), FALSE);
priv = self->priv;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
n_chars = clutter_text_buffer_get_length (get_buffer (self));
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
if (priv->preedit_set)
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
n_chars += priv->preedit_n_chars;
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
if (position < -1 || position > n_chars)
[text] Expose position_to_coords() The clutter_text_position_to_coords() is useful for ClutterText subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:18:12 +00:00
return FALSE;
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
if (priv->password_char != 0)
password_char_bytes = g_unichar_to_utf8 (priv->password_char, NULL);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
if (position == -1)
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
{
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
if (priv->password_char == 0)
text: Take pre-edit cursor position into account When determining the cursor position we also need to take into account the pre-edit cursor position as set by the set_preedit_string() function.
2009-10-19 14:31:29 +00:00
{
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
n_bytes = clutter_text_buffer_get_bytes (get_buffer (self));
text: Take pre-edit cursor position into account When determining the cursor position we also need to take into account the pre-edit cursor position as set by the set_preedit_string() function.
2009-10-19 14:31:29 +00:00
if (priv->editable && priv->preedit_set)
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
index_ = n_bytes + strlen (priv->preedit_str);
text: Take pre-edit cursor position into account When determining the cursor position we also need to take into account the pre-edit cursor position as set by the set_preedit_string() function.
2009-10-19 14:31:29 +00:00
else
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
index_ = n_bytes;
text: Take pre-edit cursor position into account When determining the cursor position we also need to take into account the pre-edit cursor position as set by the set_preedit_string() function.
2009-10-19 14:31:29 +00:00
}
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
else
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
index_ = n_chars * password_char_bytes;
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
}
Use units in position_to_coords() We loose precision with a direct conversion for PangoUnits to pixels, so we should do the conversion as needed, inside the callers of clutter_text_position_to_coords().
2008-12-15 18:24:42 +00:00
else if (position == 0)
{
index_ = 0;
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
else
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
{
text: Take pre-edit cursor position into account When determining the cursor position we also need to take into account the pre-edit cursor position as set by the set_preedit_string() function.
2009-10-19 14:31:29 +00:00
gchar *text = clutter_text_get_display_text (self);
Fix cursor position in preedit status http://bugzilla.openedhand.com/show_bug.cgi?id=1871 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-11-09 08:42:15 +00:00
GString *tmp = g_string_new (text);
gint cursor_index;
cursor_index = offset_to_bytes (text, priv->position);
text: Add a NULL preedit string check This commit avoids a critical warning introduced by commit bc51b8ca47ac90e52ab6a27ff791ea97d53f4648
2009-11-09 11:07:27 +00:00
if (priv->preedit_str != NULL)
g_string_insert (tmp, cursor_index, priv->preedit_str);
text: Take pre-edit cursor position into account When determining the cursor position we also need to take into account the pre-edit cursor position as set by the set_preedit_string() function.
2009-10-19 14:31:29 +00:00
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
if (priv->password_char == 0)
Fix cursor position in preedit status http://bugzilla.openedhand.com/show_bug.cgi?id=1871 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-11-09 08:42:15 +00:00
index_ = offset_to_bytes (tmp->str, position);
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
else
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
index_ = position * password_char_bytes;
text: Take pre-edit cursor position into account When determining the cursor position we also need to take into account the pre-edit cursor position as set by the set_preedit_string() function.
2009-10-19 14:31:29 +00:00
g_free (text);
Fix cursor position in preedit status http://bugzilla.openedhand.com/show_bug.cgi?id=1871 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-11-09 08:42:15 +00:00
g_string_free (tmp, TRUE);
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
pango_layout_get_cursor_pos (clutter_text_get_layout (self),
index_,
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
&rect, NULL);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
if (x)
[text] Expose position_to_coords() The clutter_text_position_to_coords() is useful for ClutterText subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:18:12 +00:00
{
Remove usage of Units and macros The ClutterUnit and relative macros should not be used when dealing with pixels -- which is to say, all the time when inside Clutter.
2009-06-02 17:44:30 +00:00
*x = (gfloat) rect.x / 1024.0f;
[text] Expose position_to_coords() The clutter_text_position_to_coords() is useful for ClutterText subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:18:12 +00:00
/* Take any offset due to scrolling into account */
if (priv->single_line_mode)
*x += priv->text_x;
}
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
if (y)
Remove usage of Units and macros The ClutterUnit and relative macros should not be used when dealing with pixels -- which is to say, all the time when inside Clutter.
2009-06-02 17:44:30 +00:00
*y = (gfloat) rect.y / 1024.0f;
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
Use units in position_to_coords() We loose precision with a direct conversion for PangoUnits to pixels, so we should do the conversion as needed, inside the callers of clutter_text_position_to_coords().
2008-12-15 18:24:42 +00:00
if (line_height)
Remove usage of Units and macros The ClutterUnit and relative macros should not be used when dealing with pixels -- which is to say, all the time when inside Clutter.
2009-06-02 17:44:30 +00:00
*line_height = (gfloat) rect.height / 1024.0f;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Use units in position_to_coords() We loose precision with a direct conversion for PangoUnits to pixels, so we should do the conversion as needed, inside the callers of clutter_text_position_to_coords().
2008-12-15 18:24:42 +00:00
return TRUE;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
static inline void
update_cursor_location (ClutterText *self)
{
ClutterTextPrivate *priv = self->priv;
ClutterRect rect;
float x, y;
if (!priv->editable)
return;
rect = priv->cursor_rect;
clutter_actor_get_transformed_position (CLUTTER_ACTOR (self), &x, &y);
clutter_rect_offset (&rect, x, y);
clutter_input_focus_set_cursor_location (priv->input_focus, &rect);
}
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
static inline void
clutter_text_ensure_cursor_position (ClutterText *self)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
ClutterTextPrivate *priv = self->priv;
Remove Units from the public API With the recent change to internal floating point values, ClutterUnit has become a redundant type, defined to be a float. All integer entry points are being internally converted to floating point values to be passed to the GL pipeline with the least amount of conversion. ClutterUnit is thus exposed as just a "pixel with fractionary bits", and not -- as users might think -- as generic, resolution and device independent units. not that it was the case, but a definitive amount of people was convinced it did provide this "feature", and was flummoxed about the mere existence of this type. So, having ClutterUnit exposed in the public API doubles the entry points and has the following disadvantages: - we have to maintain twice the amount of entry points in ClutterActor - we still do an integer-to-float implicit conversion - we introduce a weird impedance between pixels and "pixels with fractionary bits" - language bindings will have to choose what to bind, and resort to manually overriding the API + *except* for language bindings based on GObject-Introspection, as they cannot do manual overrides, thus will replicate the entire set of entry points For these reason, we should coalesces every Actor entry point for pixels and for ClutterUnit into a single entry point taking a float, like: void clutter_actor_set_x (ClutterActor *self, gfloat x); void clutter_actor_get_size (ClutterActor *self, gfloat *width, gfloat *height); gfloat clutter_actor_get_height (ClutterActor *self); etc. The issues I have identified are: - we'll have a two cases of compiler warnings: - printf() format of the return values from %d to %f - clutter_actor_get_size() taking floats instead of unsigned ints - we'll have a problem with varargs when passing an integer instead of a floating point value, except on 64bit platforms where the size of a float is the same as the size of an int To be clear: the *intent* of the API should not change -- we still use pixels everywhere -- but: - we remove ambiguity in the API with regard to pixels and units - we remove entry points we get to maintain for the whole 1.0 version of the API - we make things simpler to bind for both manual language bindings and automatic (gobject-introspection based) ones - we have the simplest API possible while still exposing the capabilities of the underlying GL implementation
2009-05-06 15:44:47 +00:00
gfloat x, y, cursor_height;
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
ClutterRect cursor_rect = CLUTTER_RECT_INIT_ZERO;
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
gint position;
position = priv->position;
text: Take pre-edit cursor position into account When determining the cursor position we also need to take into account the pre-edit cursor position as set by the set_preedit_string() function.
2009-10-19 14:31:29 +00:00
if (priv->editable && priv->preedit_set)
Fix cursor position in preedit status http://bugzilla.openedhand.com/show_bug.cgi?id=1871 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-11-09 08:42:15 +00:00
{
if (position == -1)
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
position = clutter_text_buffer_get_length (get_buffer (self));
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
Fix cursor position in preedit status http://bugzilla.openedhand.com/show_bug.cgi?id=1871 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-11-09 08:42:15 +00:00
position += priv->preedit_cursor_pos;
}
text: Take pre-edit cursor position into account When determining the cursor position we also need to take into account the pre-edit cursor position as set by the set_preedit_string() function.
2009-10-19 14:31:29 +00:00
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
CLUTTER_NOTE (MISC, "Cursor at %d (preedit %s at pos: %d)",
position,
priv->preedit_set ? "set" : "unset",
priv->preedit_set ? priv->preedit_cursor_pos : 0);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Use units in position_to_coords() We loose precision with a direct conversion for PangoUnits to pixels, so we should do the conversion as needed, inside the callers of clutter_text_position_to_coords().
2008-12-15 18:24:42 +00:00
x = y = cursor_height = 0;
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
clutter_text_position_to_coords (self, position,
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
&x, &y,
&cursor_height);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
clutter_rect_init (&cursor_rect,
x,
y + CURSOR_Y_PADDING,
priv->cursor_size,
cursor_height - 2 * CURSOR_Y_PADDING);
[text] Emit ::cursor-event only on changes The documentation for the ::cursor-event says that the signal is emitted only when the cursor position changes. Right now it is being emitted every time we ensure the cursor position during the Text paint sequence. The clutter_text_ensure_cursor_position() function should check whether the stored cursor position has changed since the last paint, and emit the ::cursor-event signal only when there has been a change.
2009-04-21 11:06:14 +00:00
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
if (!clutter_rect_equals (&priv->cursor_rect, &cursor_rect))
[text] Emit ::cursor-event only on changes The documentation for the ::cursor-event says that the signal is emitted only when the cursor position changes. Right now it is being emitted every time we ensure the cursor position during the Text paint sequence. The clutter_text_ensure_cursor_position() function should check whether the stored cursor position has changed since the last paint, and emit the ::cursor-event signal only when there has been a change.
2009-04-21 11:06:14 +00:00
{
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
ClutterGeometry cursor_pos;
[text] Emit ::cursor-event only on changes The documentation for the ::cursor-event says that the signal is emitted only when the cursor position changes. Right now it is being emitted every time we ensure the cursor position during the Text paint sequence. The clutter_text_ensure_cursor_position() function should check whether the stored cursor position has changed since the last paint, and emit the ::cursor-event signal only when there has been a change.
2009-04-21 11:06:14 +00:00
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
priv->cursor_rect = cursor_rect;
/* XXX:2.0 - remove */
cursor_pos.x = clutter_rect_get_x (&priv->cursor_rect);
cursor_pos.y = clutter_rect_get_y (&priv->cursor_rect);
cursor_pos.width = clutter_rect_get_width (&priv->cursor_rect);
cursor_pos.height = clutter_rect_get_height (&priv->cursor_rect);
g_signal_emit (self, text_signals[CURSOR_EVENT], 0, &cursor_pos);
g_signal_emit (self, text_signals[CURSOR_CHANGED], 0);
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
update_cursor_location (self);
[text] Emit ::cursor-event only on changes The documentation for the ::cursor-event says that the signal is emitted only when the cursor position changes. Right now it is being emitted every time we ensure the cursor position during the Text paint sequence. The clutter_text_ensure_cursor_position() function should check whether the stored cursor position has changed since the last paint, and emit the ::cursor-event signal only when there has been a change.
2009-04-21 11:06:14 +00:00
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
[text] Add ClutterText::delete_selection() Add a method for deleting the current selection inside a Text actor. This is useful for subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:08:25 +00:00
/**
* clutter_text_delete_selection:
* @self: a #ClutterText
*
* Deletes the currently selected text
*
* This function is only useful in subclasses of #ClutterText
*
* Return value: %TRUE if text was deleted or if the text actor
* is empty, and %FALSE otherwise
*
* Since: 1.0
*/
gboolean
clutter_text_delete_selection (ClutterText *self)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
[text] Add ClutterText::delete_selection() Add a method for deleting the current selection inside a Text actor. This is useful for subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:08:25 +00:00
ClutterTextPrivate *priv;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
gint start_index;
gint end_index;
text: Notify :position when it changes The :position property is not notified when changed. http://bugzilla.openedhand.com/show_bug.cgi?id=1830
2009-10-16 13:22:15 +00:00
gint old_position, old_selection;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
guint n_chars;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
[text] Add ClutterText::delete_selection() Add a method for deleting the current selection inside a Text actor. This is useful for subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:08:25 +00:00
g_return_val_if_fail (CLUTTER_IS_TEXT (self), FALSE);
priv = self->priv;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
n_chars = clutter_text_buffer_get_length (get_buffer (self));
if (n_chars == 0)
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
return TRUE;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
start_index = priv->position == -1 ? n_chars : priv->position;
end_index = priv->selection_bound == -1 ? n_chars : priv->selection_bound;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
if (end_index == start_index)
return FALSE;
if (end_index < start_index)
{
gint temp = start_index;
start_index = end_index;
end_index = temp;
}
text: Notify :position when it changes The :position property is not notified when changed. http://bugzilla.openedhand.com/show_bug.cgi?id=1830
2009-10-16 13:22:15 +00:00
old_position = priv->position;
old_selection = priv->selection_bound;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter_text_delete_text (self, start_index, end_index);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
priv->position = start_index;
priv->selection_bound = start_index;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
/* Not required to be guarded by g_object_freeze/thaw_notify */
text: Notify :position when it changes The :position property is not notified when changed. http://bugzilla.openedhand.com/show_bug.cgi?id=1830
2009-10-16 13:22:15 +00:00
if (priv->position != old_position)
text: Add :cursor-position and deprecate :position The :position property on ClutterText clashes with the same property on ClutterActor; it's also badly named, given that it represents the cursor's position inside the text; finally, it does not match its accessors, violating the API style conventions. https://bugzilla.gnome.org/show_bug.cgi?id=679457
2012-07-05 15:23:52 +00:00
{
/* XXX:2.0 - remove */
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_POSITION]);
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_CURSOR_POSITION]);
}
text: Notify :position when it changes The :position property is not notified when changed. http://bugzilla.openedhand.com/show_bug.cgi?id=1830
2009-10-16 13:22:15 +00:00
if (priv->selection_bound != old_selection)
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_SELECTION_BOUND]);
text: Notify :position when it changes The :position property is not notified when changed. http://bugzilla.openedhand.com/show_bug.cgi?id=1830
2009-10-16 13:22:15 +00:00
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
return TRUE;
}
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
/*
* Utility function to update both cursor position and selection bound
* at once
*/
static inline void
clutter_text_set_positions (ClutterText *self,
gint new_pos,
gint new_bound)
{
g_object_freeze_notify (G_OBJECT (self));
clutter_text_set_cursor_position (self, new_pos);
clutter_text_set_selection_bound (self, new_bound);
g_object_thaw_notify (G_OBJECT (self));
}
text: Make the :text property not set the :use-markup one Currently, setting the :text property has the side-effect of setting the :use-markup property to FALSE. This prevents constructing a Text actor, or setting its properties, like: g_object_set (text, "use-markup", TRUE, "text", some_string, NULL); as the ordering becomes important. Unfortunately, the ordering of the properties cannot be enforced with ClutterScript or with language bindings. The documentation of the clutter_text_set_text() method should be expanded to properly specify that the set_text() method will change the :use-markup property to FALSE as a side effect.
2009-10-07 20:44:17 +00:00
static inline void
clutter_text_set_markup_internal (ClutterText *self,
const gchar *str)
{
ClutterTextPrivate *priv = self->priv;
GError *error;
gchar *text = NULL;
PangoAttrList *attrs = NULL;
gboolean res;
text: Clear up priv->text checks The priv->text field cannot ever be NULL, so we don't need to check for that in a series of places. We also need to assert() that pre-condition in the couple of places where we set the contents of the ClutterText actor, namely in set_text_internal() and set_markup_internal(). Based on a patch by: Dan Winship <danw@gnome.org> http://bugzilla.clutter-project.org/show_bug.cgi?id=2629
2011-09-07 12:28:15 +00:00
g_assert (str != NULL);
text: Make the :text property not set the :use-markup one Currently, setting the :text property has the side-effect of setting the :use-markup property to FALSE. This prevents constructing a Text actor, or setting its properties, like: g_object_set (text, "use-markup", TRUE, "text", some_string, NULL); as the ordering becomes important. Unfortunately, the ordering of the properties cannot be enforced with ClutterScript or with language bindings. The documentation of the clutter_text_set_text() method should be expanded to properly specify that the set_text() method will change the :use-markup property to FALSE as a side effect.
2009-10-07 20:44:17 +00:00
error = NULL;
res = pango_parse_markup (str, -1, 0,
&attrs,
&text,
NULL,
&error);
text: Clear up priv->text checks The priv->text field cannot ever be NULL, so we don't need to check for that in a series of places. We also need to assert() that pre-condition in the couple of places where we set the contents of the ClutterText actor, namely in set_text_internal() and set_markup_internal(). Based on a patch by: Dan Winship <danw@gnome.org> http://bugzilla.clutter-project.org/show_bug.cgi?id=2629
2011-09-07 12:28:15 +00:00
text: Make the :text property not set the :use-markup one Currently, setting the :text property has the side-effect of setting the :use-markup property to FALSE. This prevents constructing a Text actor, or setting its properties, like: g_object_set (text, "use-markup", TRUE, "text", some_string, NULL); as the ordering becomes important. Unfortunately, the ordering of the properties cannot be enforced with ClutterScript or with language bindings. The documentation of the clutter_text_set_text() method should be expanded to properly specify that the set_text() method will change the :use-markup property to FALSE as a side effect.
2009-10-07 20:44:17 +00:00
if (!res)
{
text: Clear up priv->text checks The priv->text field cannot ever be NULL, so we don't need to check for that in a series of places. We also need to assert() that pre-condition in the couple of places where we set the contents of the ClutterText actor, namely in set_text_internal() and set_markup_internal(). Based on a patch by: Dan Winship <danw@gnome.org> http://bugzilla.clutter-project.org/show_bug.cgi?id=2629
2011-09-07 12:28:15 +00:00
if (G_LIKELY (error != NULL))
text: Make the :text property not set the :use-markup one Currently, setting the :text property has the side-effect of setting the :use-markup property to FALSE. This prevents constructing a Text actor, or setting its properties, like: g_object_set (text, "use-markup", TRUE, "text", some_string, NULL); as the ordering becomes important. Unfortunately, the ordering of the properties cannot be enforced with ClutterScript or with language bindings. The documentation of the clutter_text_set_text() method should be expanded to properly specify that the set_text() method will change the :use-markup property to FALSE as a side effect.
2009-10-07 20:44:17 +00:00
{
text: Clear up priv->text checks The priv->text field cannot ever be NULL, so we don't need to check for that in a series of places. We also need to assert() that pre-condition in the couple of places where we set the contents of the ClutterText actor, namely in set_text_internal() and set_markup_internal(). Based on a patch by: Dan Winship <danw@gnome.org> http://bugzilla.clutter-project.org/show_bug.cgi?id=2629
2011-09-07 12:28:15 +00:00
g_warning ("Failed to set the markup of the actor '%s': %s",
_clutter_actor_get_debug_name (CLUTTER_ACTOR (self)),
text: Make the :text property not set the :use-markup one Currently, setting the :text property has the side-effect of setting the :use-markup property to FALSE. This prevents constructing a Text actor, or setting its properties, like: g_object_set (text, "use-markup", TRUE, "text", some_string, NULL); as the ordering becomes important. Unfortunately, the ordering of the properties cannot be enforced with ClutterScript or with language bindings. The documentation of the clutter_text_set_text() method should be expanded to properly specify that the set_text() method will change the :use-markup property to FALSE as a side effect.
2009-10-07 20:44:17 +00:00
error->message);
g_error_free (error);
}
else
text: Clear up priv->text checks The priv->text field cannot ever be NULL, so we don't need to check for that in a series of places. We also need to assert() that pre-condition in the couple of places where we set the contents of the ClutterText actor, namely in set_text_internal() and set_markup_internal(). Based on a patch by: Dan Winship <danw@gnome.org> http://bugzilla.clutter-project.org/show_bug.cgi?id=2629
2011-09-07 12:28:15 +00:00
g_warning ("Failed to set the markup of the actor '%s'",
_clutter_actor_get_debug_name (CLUTTER_ACTOR (self)));
text: Make the :text property not set the :use-markup one Currently, setting the :text property has the side-effect of setting the :use-markup property to FALSE. This prevents constructing a Text actor, or setting its properties, like: g_object_set (text, "use-markup", TRUE, "text", some_string, NULL); as the ordering becomes important. Unfortunately, the ordering of the properties cannot be enforced with ClutterScript or with language bindings. The documentation of the clutter_text_set_text() method should be expanded to properly specify that the set_text() method will change the :use-markup property to FALSE as a side effect.
2009-10-07 20:44:17 +00:00
return;
}
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
if (text)
{
ClutterText: Fix length passed to clutter_text_buffer_set_text() clutter_text_buffer_set_text() expects a char count, not a byte count, so pass -1 rather than using strlen. https://bugzilla.gnome.org/show_bug.cgi?id=673783
2012-04-09 16:09:59 +00:00
clutter_text_buffer_set_text (get_buffer (self), text, -1);
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
g_free (text);
}
text: Make the :text property not set the :use-markup one Currently, setting the :text property has the side-effect of setting the :use-markup property to FALSE. This prevents constructing a Text actor, or setting its properties, like: g_object_set (text, "use-markup", TRUE, "text", some_string, NULL); as the ordering becomes important. Unfortunately, the ordering of the properties cannot be enforced with ClutterScript or with language bindings. The documentation of the clutter_text_set_text() method should be expanded to properly specify that the set_text() method will change the :use-markup property to FALSE as a side effect.
2009-10-07 20:44:17 +00:00
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
/* Store the new markup attributes */
text: Do not set the markup unconditionally When setting :use-markup we always pass the contents of the Text actor to clutter_text_set_markup_internal(); if string contains any markup, this ends up being parsed and used - even when :use-markup is set to FALSE. http://bugzilla.clutter-project.org/show_bug.cgi?id=2239
2010-08-06 16:04:37 +00:00
if (priv->markup_attrs != NULL)
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
pango_attr_list_unref (priv->markup_attrs);
text: Do not set the markup unconditionally When setting :use-markup we always pass the contents of the Text actor to clutter_text_set_markup_internal(); if string contains any markup, this ends up being parsed and used - even when :use-markup is set to FALSE. http://bugzilla.clutter-project.org/show_bug.cgi?id=2239
2010-08-06 16:04:37 +00:00
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
priv->markup_attrs = attrs;
text: Make the :text property not set the :use-markup one Currently, setting the :text property has the side-effect of setting the :use-markup property to FALSE. This prevents constructing a Text actor, or setting its properties, like: g_object_set (text, "use-markup", TRUE, "text", some_string, NULL); as the ordering becomes important. Unfortunately, the ordering of the properties cannot be enforced with ClutterScript or with language bindings. The documentation of the clutter_text_set_text() method should be expanded to properly specify that the set_text() method will change the :use-markup property to FALSE as a side effect.
2009-10-07 20:44:17 +00:00
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
/* Clear the effective attributes so they will be regenerated when a
layout is created */
text: Do not set the markup unconditionally When setting :use-markup we always pass the contents of the Text actor to clutter_text_set_markup_internal(); if string contains any markup, this ends up being parsed and used - even when :use-markup is set to FALSE. http://bugzilla.clutter-project.org/show_bug.cgi?id=2239
2010-08-06 16:04:37 +00:00
if (priv->effective_attrs != NULL)
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
{
pango_attr_list_unref (priv->effective_attrs);
priv->effective_attrs = NULL;
text: Make the :text property not set the :use-markup one Currently, setting the :text property has the side-effect of setting the :use-markup property to FALSE. This prevents constructing a Text actor, or setting its properties, like: g_object_set (text, "use-markup", TRUE, "text", some_string, NULL); as the ordering becomes important. Unfortunately, the ordering of the properties cannot be enforced with ClutterScript or with language bindings. The documentation of the clutter_text_set_text() method should be expanded to properly specify that the set_text() method will change the :use-markup property to FALSE as a side effect.
2009-10-07 20:44:17 +00:00
}
}
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
static void
clutter_text_set_property (GObject *gobject,
guint prop_id,
const GValue *value,
GParamSpec *pspec)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
ClutterText *self = CLUTTER_TEXT (gobject);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
switch (prop_id)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
case PROP_BUFFER:
clutter_text_set_buffer (self, g_value_get_object (value));
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
case PROP_TEXT:
text: Make :use-markup set idempotent Setting :use-markup and :text is currently not idempotent, and it depends on the ordering, e.g.: g_object_set (actor, "use-markup", TRUE, "text", value, NULL); does not yield the same results as: g_object_set (actor, "text", value, "use-markup", TRUE, NULL); This is particularly jarring when using ClutterText from ClutterScript, but in general GObject properties should not rely on the order when used from g_object_set(). The fix is to store the contents of the ClutterText as a separate string from the displayed text, and use the contents, instead of the displayed text, when toggling the :use-markup property. Let's also add a unit test for good measure, to try and catch regressions. https://bugzilla.gnome.org/show_bug.cgi?id=651940
2011-09-06 11:45:41 +00:00
{
const char *str = g_value_get_string (value);
if (self->priv->use_markup)
text: Consistently protect against NULL strings When calling clutter_text_set_text_internal() or clutter_text_set_markup_internal() we need to make sure to pass a non-NULL string.
2011-09-07 12:08:22 +00:00
clutter_text_set_markup_internal (self, str ? str : "");
text: Make :use-markup set idempotent Setting :use-markup and :text is currently not idempotent, and it depends on the ordering, e.g.: g_object_set (actor, "use-markup", TRUE, "text", value, NULL); does not yield the same results as: g_object_set (actor, "text", value, "use-markup", TRUE, NULL); This is particularly jarring when using ClutterText from ClutterScript, but in general GObject properties should not rely on the order when used from g_object_set(). The fix is to store the contents of the ClutterText as a separate string from the displayed text, and use the contents, instead of the displayed text, when toggling the :use-markup property. Let's also add a unit test for good measure, to try and catch regressions. https://bugzilla.gnome.org/show_bug.cgi?id=651940
2011-09-06 11:45:41 +00:00
else
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
clutter_text_buffer_set_text (get_buffer (self), str ? str : "", -1);
text: Make :use-markup set idempotent Setting :use-markup and :text is currently not idempotent, and it depends on the ordering, e.g.: g_object_set (actor, "use-markup", TRUE, "text", value, NULL); does not yield the same results as: g_object_set (actor, "text", value, "use-markup", TRUE, NULL); This is particularly jarring when using ClutterText from ClutterScript, but in general GObject properties should not rely on the order when used from g_object_set(). The fix is to store the contents of the ClutterText as a separate string from the displayed text, and use the contents, instead of the displayed text, when toggling the :use-markup property. Let's also add a unit test for good measure, to try and catch regressions. https://bugzilla.gnome.org/show_bug.cgi?id=651940
2011-09-06 11:45:41 +00:00
}
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
break;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
case PROP_COLOR:
clutter_text_set_color (self, clutter_value_get_color (value));
break;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
case PROP_FONT_NAME:
clutter_text_set_font_name (self, g_value_get_string (value));
break;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Add :font-description High level toolkits might wish to construct a PangoFontDescription and then set it directly on a ClutterText actor proxy or sub-class. ClutterText should have a :font-description property to set (and get) the PangoFontDescription. http://bugzilla.openedhand.com/show_bug.cgi?id=1960
2010-02-03 14:35:45 +00:00
case PROP_FONT_DESCRIPTION:
clutter_text_set_font_description (self, g_value_get_boxed (value));
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
case PROP_USE_MARKUP:
clutter_text_set_use_markup (self, g_value_get_boolean (value));
break;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
case PROP_ATTRIBUTES:
clutter_text_set_attributes (self, g_value_get_boxed (value));
break;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
[text] Rename :alignment to :line-alignment The :alignment property is prone to generate confusion: developers will set it thinking that the contents of a ClutterText will automagically align themselves. Instead of using the generic term :alignment, and following the GTK+ convention, we should use a more specific term, conveying the actual effect of the property: alignment of the lines with respect to each other, and not to the overall allocated area. See bug 1428: http://bugzilla.openedhand.com/show_bug.cgi?id=1428
2009-02-02 23:55:30 +00:00
case PROP_LINE_ALIGNMENT:
clutter_text_set_line_alignment (self, g_value_get_enum (value));
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
break;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
case PROP_LINE_WRAP:
clutter_text_set_line_wrap (self, g_value_get_boolean (value));
break;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
case PROP_LINE_WRAP_MODE:
clutter_text_set_line_wrap_mode (self, g_value_get_enum (value));
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
case PROP_JUSTIFY:
clutter_text_set_justify (self, g_value_get_boolean (value));
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
case PROP_ELLIPSIZE:
clutter_text_set_ellipsize (self, g_value_get_enum (value));
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
text: Add :cursor-position and deprecate :position The :position property on ClutterText clashes with the same property on ClutterActor; it's also badly named, given that it represents the cursor's position inside the text; finally, it does not match its accessors, violating the API style conventions. https://bugzilla.gnome.org/show_bug.cgi?id=679457
2012-07-05 15:23:52 +00:00
case PROP_POSITION: /* XXX:2.0: remove */
case PROP_CURSOR_POSITION:
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter_text_set_cursor_position (self, g_value_get_int (value));
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
case PROP_SELECTION_BOUND:
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter_text_set_selection_bound (self, g_value_get_int (value));
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
case PROP_SELECTION_COLOR:
clutter_text_set_selection_color (self, g_value_get_boxed (value));
break;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
case PROP_CURSOR_VISIBLE:
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter_text_set_cursor_visible (self, g_value_get_boolean (value));
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
case PROP_CURSOR_COLOR:
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter_text_set_cursor_color (self, g_value_get_boxed (value));
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Add :cursor-size property to ClutterText We can control the width of the cursor when painting by using a simple property. The magic -1 number passed to the setter method will reset the cursor size to the default one of 2px. The getter method will return an unsigned integer with the current size.
2008-12-16 10:37:45 +00:00
case PROP_CURSOR_SIZE:
clutter_text_set_cursor_size (self, g_value_get_int (value));
break;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
case PROP_EDITABLE:
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter_text_set_editable (self, g_value_get_boolean (value));
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
case PROP_ACTIVATABLE:
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter_text_set_activatable (self, g_value_get_boolean (value));
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
case PROP_SELECTABLE:
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter_text_set_selectable (self, g_value_get_boolean (value));
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
break;
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
case PROP_PASSWORD_CHAR:
clutter_text_set_password_char (self, g_value_get_uint (value));
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
break;
Implement Text:max-length The :max-length property establishes the maximum available length for the Text actor's contents, in characters.
2008-12-11 11:54:07 +00:00
case PROP_MAX_LENGTH:
clutter_text_set_max_length (self, g_value_get_int (value));
break;
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
case PROP_SINGLE_LINE_MODE:
clutter_text_set_single_line_mode (self, g_value_get_boolean (value));
break;
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
case PROP_SELECTED_TEXT_COLOR:
clutter_text_set_selected_text_color (self, clutter_value_get_color (value));
break;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);
}
}
static void
clutter_text_get_property (GObject *gobject,
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
guint prop_id,
GValue *value,
GParamSpec *pspec)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
ClutterText *self = CLUTTER_TEXT (gobject);
ClutterTextPrivate *priv = self->priv;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
switch (prop_id)
{
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
case PROP_BUFFER:
g_value_set_object (value, clutter_text_get_buffer (self));
break;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
case PROP_TEXT:
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
g_value_set_string (value, clutter_text_buffer_get_text (get_buffer (self)));
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
case PROP_FONT_NAME:
g_value_set_string (value, priv->font_name);
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
text: Add :font-description High level toolkits might wish to construct a PangoFontDescription and then set it directly on a ClutterText actor proxy or sub-class. ClutterText should have a :font-description property to set (and get) the PangoFontDescription. http://bugzilla.openedhand.com/show_bug.cgi?id=1960
2010-02-03 14:35:45 +00:00
case PROP_FONT_DESCRIPTION:
g_value_set_boxed (value, priv->font_desc);
break;
[text] implement get_property for "use-markup"
2009-09-08 12:06:51 +00:00
case PROP_USE_MARKUP:
g_value_set_boolean (value, priv->use_markup);
break;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
case PROP_COLOR:
clutter_value_set_color (value, &priv->text_color);
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
case PROP_CURSOR_VISIBLE:
g_value_set_boolean (value, priv->cursor_visible);
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
case PROP_CURSOR_COLOR:
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
clutter_value_set_color (value, &priv->cursor_color);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Add :cursor-color-set property declaration The :cursor-color-set property is a read-only property that reflects whether the ClutterText actor is going to use the color set inside the :cursor-color property when painting the cursor.
2008-12-11 11:49:14 +00:00
case PROP_CURSOR_COLOR_SET:
g_value_set_boolean (value, priv->cursor_color_set);
break;
Add :cursor-size property to ClutterText We can control the width of the cursor when painting by using a simple property. The magic -1 number passed to the setter method will reset the cursor size to the default one of 2px. The getter method will return an unsigned integer with the current size.
2008-12-16 10:37:45 +00:00
case PROP_CURSOR_SIZE:
g_value_set_int (value, priv->cursor_size);
break;
text: Add :cursor-position and deprecate :position The :position property on ClutterText clashes with the same property on ClutterActor; it's also badly named, given that it represents the cursor's position inside the text; finally, it does not match its accessors, violating the API style conventions. https://bugzilla.gnome.org/show_bug.cgi?id=679457
2012-07-05 15:23:52 +00:00
case PROP_POSITION: /* XXX:2.0 - remove */
case PROP_CURSOR_POSITION:
[text] Fix GObject properties in ClutterText Some of the read-write properties of ClutterText were missing an implementation in clutter_text_get_property(), as well as the :position and :selection-bound properties being wrongly converted from fixed point to integer, passing through floating point values.
2009-01-08 17:06:04 +00:00
g_value_set_int (value, priv->position);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
case PROP_SELECTION_BOUND:
[text] Fix GObject properties in ClutterText Some of the read-write properties of ClutterText were missing an implementation in clutter_text_get_property(), as well as the :position and :selection-bound properties being wrongly converted from fixed point to integer, passing through floating point values.
2009-01-08 17:06:04 +00:00
g_value_set_int (value, priv->selection_bound);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
case PROP_EDITABLE:
g_value_set_boolean (value, priv->editable);
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
case PROP_SELECTABLE:
g_value_set_boolean (value, priv->selectable);
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
case PROP_SELECTION_COLOR:
clutter_value_set_color (value, &priv->selection_color);
break;
case PROP_SELECTION_COLOR_SET:
g_value_set_boolean (value, priv->selection_color_set);
break;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
case PROP_ACTIVATABLE:
g_value_set_boolean (value, priv->activatable);
break;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
case PROP_PASSWORD_CHAR:
g_value_set_uint (value, priv->password_char);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
break;
Implement Text:max-length The :max-length property establishes the maximum available length for the Text actor's contents, in characters.
2008-12-11 11:54:07 +00:00
case PROP_MAX_LENGTH:
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
g_value_set_int (value, clutter_text_buffer_get_max_length (get_buffer (self)));
Implement Text:max-length The :max-length property establishes the maximum available length for the Text actor's contents, in characters.
2008-12-11 11:54:07 +00:00
break;
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
case PROP_SINGLE_LINE_MODE:
g_value_set_boolean (value, priv->single_line_mode);
break;
[text] Fix GObject properties in ClutterText Some of the read-write properties of ClutterText were missing an implementation in clutter_text_get_property(), as well as the :position and :selection-bound properties being wrongly converted from fixed point to integer, passing through floating point values.
2009-01-08 17:06:04 +00:00
case PROP_ELLIPSIZE:
g_value_set_enum (value, priv->ellipsize);
break;
case PROP_LINE_WRAP:
g_value_set_boolean (value, priv->wrap);
break;
case PROP_LINE_WRAP_MODE:
g_value_set_enum (value, priv->wrap_mode);
break;
[text] Rename :alignment to :line-alignment The :alignment property is prone to generate confusion: developers will set it thinking that the contents of a ClutterText will automagically align themselves. Instead of using the generic term :alignment, and following the GTK+ convention, we should use a more specific term, conveying the actual effect of the property: alignment of the lines with respect to each other, and not to the overall allocated area. See bug 1428: http://bugzilla.openedhand.com/show_bug.cgi?id=1428
2009-02-02 23:55:30 +00:00
case PROP_LINE_ALIGNMENT:
[text] Fix GObject properties in ClutterText Some of the read-write properties of ClutterText were missing an implementation in clutter_text_get_property(), as well as the :position and :selection-bound properties being wrongly converted from fixed point to integer, passing through floating point values.
2009-01-08 17:06:04 +00:00
g_value_set_enum (value, priv->alignment);
break;
case PROP_JUSTIFY:
g_value_set_boolean (value, priv->justify);
break;
case PROP_ATTRIBUTES:
g_value_set_boxed (value, priv->attrs);
break;
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
case PROP_SELECTED_TEXT_COLOR:
clutter_value_set_color (value, &priv->selected_text_color);
break;
case PROP_SELECTED_TEXT_COLOR_SET:
g_value_set_boolean (value, priv->selected_text_color_set);
break;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);
}
}
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
static void
clutter_text_dispose (GObject *gobject)
{
ClutterText *self = CLUTTER_TEXT (gobject);
Listen for the font-changed signal on the backend in ClutterText Whenever a ClutterText is created it now connects to the font-changed signal. When it is emitted the layout cache is dirtied and a relayout is queued. That way changes to the font options or resolution will cause an immediate update to the labels in the scene.
2009-01-27 16:47:20 +00:00
ClutterTextPrivate *priv = self->priv;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
/* get rid of the entire cache */
clutter_text_dirty_cache (self);
text: Dirty layout cache on text direction changes When the text direction changes we should evict the cached layouts to avoid stale entries in case the direction change produces a layout with the same size.
2009-11-10 12:18:32 +00:00
if (priv->direction_changed_id)
{
g_signal_handler_disconnect (self, priv->direction_changed_id);
priv->direction_changed_id = 0;
}
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
if (priv->settings_changed_id)
Listen for the font-changed signal on the backend in ClutterText Whenever a ClutterText is created it now connects to the font-changed signal. When it is emitted the layout cache is dirtied and a relayout is queued. That way changes to the font options or resolution will cause an immediate update to the labels in the scene.
2009-01-27 16:47:20 +00:00
{
g_signal_handler_disconnect (clutter_get_default_backend (),
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
priv->settings_changed_id);
priv->settings_changed_id = 0;
}
if (priv->password_hint_id)
{
g_source_remove (priv->password_hint_id);
priv->password_hint_id = 0;
Listen for the font-changed signal on the backend in ClutterText Whenever a ClutterText is created it now connects to the font-changed signal. When it is emitted the layout cache is dirtied and a relayout is queued. That way changes to the font options or resolution will cause an immediate update to the labels in the scene.
2009-01-27 16:47:20 +00:00
}
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
clutter_text_set_buffer (self, NULL);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
G_OBJECT_CLASS (clutter_text_parent_class)->dispose (gobject);
}
static void
clutter_text_finalize (GObject *gobject)
{
ClutterText *self = CLUTTER_TEXT (gobject);
ClutterTextPrivate *priv = self->priv;
if (priv->font_desc)
pango_font_description_free (priv->font_desc);
text: Free the Pango attribute list resources The ClutterText owns three PangoAttrList resources which were not being unref'd. This adds the unref calls to the finalize method.
2010-01-05 11:44:17 +00:00
if (priv->attrs)
pango_attr_list_unref (priv->attrs);
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
if (priv->markup_attrs)
pango_attr_list_unref (priv->markup_attrs);
text: Free the Pango attribute list resources The ClutterText owns three PangoAttrList resources which were not being unref'd. This adds the unref calls to the finalize method.
2010-01-05 11:44:17 +00:00
if (priv->effective_attrs)
pango_attr_list_unref (priv->effective_attrs);
if (priv->preedit_attrs)
pango_attr_list_unref (priv->preedit_attrs);
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
clutter_text_dirty_paint_volume (self);
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
clutter_text_set_buffer (self, NULL);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_free (priv->font_name);
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
g_clear_object (&priv->input_focus);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
G_OBJECT_CLASS (clutter_text_parent_class)->finalize (gobject);
}
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
typedef void (* ClutterTextSelectionFunc) (ClutterText *text,
const ClutterActorBox *box,
gpointer user_data);
static void
clutter_text_foreach_selection_rectangle (ClutterText *self,
ClutterTextSelectionFunc func,
gpointer user_data)
{
ClutterTextPrivate *priv = self->priv;
PangoLayout *layout = clutter_text_get_layout (self);
gchar *utf8 = clutter_text_get_display_text (self);
gint lines;
gint start_index;
gint end_index;
gint line_no;
if (priv->position == 0)
start_index = 0;
else
start_index = offset_to_bytes (utf8, priv->position);
if (priv->selection_bound == 0)
end_index = 0;
else
end_index = offset_to_bytes (utf8, priv->selection_bound);
if (start_index > end_index)
{
gint temp = start_index;
start_index = end_index;
end_index = temp;
}
lines = pango_layout_get_line_count (layout);
for (line_no = 0; line_no < lines; line_no++)
{
PangoLayoutLine *line;
gint n_ranges;
gint *ranges;
gint i;
gint index_;
gint maxindex;
ClutterActorBox box;
gfloat y, height;
line = pango_layout_get_line_readonly (layout, line_no);
pango_layout_line_x_to_index (line, G_MAXINT, &maxindex, NULL);
if (maxindex < start_index)
continue;
pango_layout_line_get_x_ranges (line, start_index, end_index,
&ranges,
&n_ranges);
pango_layout_line_x_to_index (line, 0, &index_, NULL);
clutter_text_position_to_coords (self,
bytes_to_offset (utf8, index_),
NULL, &y, &height);
box.y1 = y;
box.y2 = y + height;
for (i = 0; i < n_ranges; i++)
{
text: Make sure that the selection box is big enough Do not use integers to store the result of the PANGO_UNITS scaling to avoid rounding issues with the default C rules. We should use cielf() instead.
2011-07-10 09:24:40 +00:00
gfloat range_x;
gfloat range_width;
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
range_x = ranges[i * 2] / PANGO_SCALE;
/* Account for any scrolling in single line mode */
if (priv->single_line_mode)
range_x += priv->text_x;
text: Make sure that the selection box is big enough Do not use integers to store the result of the PANGO_UNITS scaling to avoid rounding issues with the default C rules. We should use cielf() instead.
2011-07-10 09:24:40 +00:00
range_width = ((gfloat) ranges[i * 2 + 1] - (gfloat) ranges[i * 2])
/ PANGO_SCALE;
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
box.x1 = range_x;
text: Make sure that the selection box is big enough Do not use integers to store the result of the PANGO_UNITS scaling to avoid rounding issues with the default C rules. We should use cielf() instead.
2011-07-10 09:24:40 +00:00
box.x2 = ceilf (range_x + range_width + .5f);
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
func (self, &box, user_data);
}
g_free (ranges);
}
g_free (utf8);
}
static void
text: Make sure that the selection box is big enough Do not use integers to store the result of the PANGO_UNITS scaling to avoid rounding issues with the default C rules. We should use cielf() instead.
2011-07-10 09:24:40 +00:00
add_selection_rectangle_to_path (ClutterText *text,
const ClutterActorBox *box,
gpointer user_data)
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
{
cogl_path_rectangle (user_data, box->x1, box->y1, box->x2, box->y2);
}
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
/* Draws the selected text, its background, and the cursor */
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
static void
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
selection_paint (ClutterText *self)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
ClutterTextPrivate *priv = self->priv;
Use the paint opacity when painting a ClutterText ClutterText should use the paint opacity for both text and cursor. ClutterLabel had the wrong behaviour, as it set the actor's opacity using the text color's alpha channel, and ClutterEntry completely disregarded the actor's opacity when painting the cursor. This commit harmonizes the ClutterText behaviour to always use a composition of the actor's paint opacity and the text and cursor alpha channel values, thus behaving more consistently with the rest of Clutter.
2008-12-11 12:18:26 +00:00
ClutterActor *actor = CLUTTER_ACTOR (self);
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
guint8 paint_opacity = clutter_actor_get_paint_opacity (actor);
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
const ClutterColor *color;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
if (!clutter_text_should_draw_cursor (self))
return;
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
if (priv->position == priv->selection_bound)
{
/* No selection, just draw the cursor */
if (priv->cursor_color_set)
color = &priv->cursor_color;
else
color = &priv->text_color;
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
cogl_set_source_color4ub (color->red,
color->green,
color->blue,
paint_opacity * color->alpha / 255);
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
cogl_rectangle (priv->cursor_rect.origin.x,
priv->cursor_rect.origin.y,
priv->cursor_rect.origin.x + priv->cursor_rect.size.width,
priv->cursor_rect.origin.y + priv->cursor_rect.size.height);
}
else
{
/* Paint selection background first */
PangoLayout *layout = clutter_text_get_layout (self);
CoglPath *selection_path = cogl_path_new ();
CoglColor cogl_color = { 0, };
CoglFramebuffer *fb;
fb = _clutter_actor_get_active_framebuffer (actor);
if (G_UNLIKELY (fb == NULL))
return;
/* Paint selection background */
if (priv->selection_color_set)
color = &priv->selection_color;
else if (priv->cursor_color_set)
color = &priv->cursor_color;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
else
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
color = &priv->text_color;
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
cogl_set_source_color4ub (color->red,
color->green,
color->blue,
paint_opacity * color->alpha / 255);
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
clutter_text_foreach_selection_rectangle (self,
add_selection_rectangle_to_path,
selection_path);
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
cogl_path_fill (selection_path);
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
/* Paint selected text */
cogl_framebuffer_push_path_clip (fb, selection_path);
cogl_object_unref (selection_path);
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
if (priv->selected_text_color_set)
color = &priv->selected_text_color;
else
color = &priv->text_color;
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
cogl_color_init_from_4ub (&cogl_color,
color->red,
color->green,
color->blue,
paint_opacity * color->alpha / 255);
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
cogl_pango_render_layout (layout, priv->text_x, 0, &cogl_color, 0);
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
cogl_framebuffer_pop_clip (fb);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
}
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
static gint
clutter_text_move_word_backward (ClutterText *self,
gint start)
{
gint retval = start;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
if (clutter_text_buffer_get_length (get_buffer (self)) > 0 && start > 0)
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
{
PangoLayout *layout = clutter_text_get_layout (self);
PangoLogAttr *log_attrs = NULL;
gint n_attrs = 0;
pango_layout_get_log_attrs (layout, &log_attrs, &n_attrs);
retval = start - 1;
while (retval > 0 && !log_attrs[retval].is_word_start)
retval -= 1;
g_free (log_attrs);
}
return retval;
}
static gint
clutter_text_move_word_forward (ClutterText *self,
gint start)
{
gint retval = start;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
guint n_chars;
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
n_chars = clutter_text_buffer_get_length (get_buffer (self));
if (n_chars > 0 && start < n_chars)
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
{
PangoLayout *layout = clutter_text_get_layout (self);
PangoLogAttr *log_attrs = NULL;
gint n_attrs = 0;
pango_layout_get_log_attrs (layout, &log_attrs, &n_attrs);
[text] move_word_backward/forward fixes clutter_text_move_word_backward/forward() calls did not use the start argument consistently. Also, clutter_text_move_word_forward() bound check checked the wrong end. Fixes #1765 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-08-16 21:00:35 +00:00
retval = start + 1;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
while (retval < n_chars && !log_attrs[retval].is_word_end)
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
retval += 1;
g_free (log_attrs);
}
return retval;
}
static gint
clutter_text_move_line_start (ClutterText *self,
gint start)
{
PangoLayoutLine *layout_line;
PangoLayout *layout;
gint line_no;
gint index_;
gint position;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
const gchar *text;
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
layout = clutter_text_get_layout (self);
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
text = clutter_text_buffer_get_text (get_buffer (self));
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
if (start == 0)
index_ = 0;
else
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
index_ = offset_to_bytes (text, start);
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
pango_layout_index_to_line_x (layout, index_,
0,
&line_no, NULL);
layout_line = pango_layout_get_line_readonly (layout, line_no);
if (!layout_line)
return FALSE;
pango_layout_line_x_to_index (layout_line, 0, &index_, NULL);
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
position = bytes_to_offset (text, index_);
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
return position;
}
static gint
clutter_text_move_line_end (ClutterText *self,
gint start)
{
ClutterTextPrivate *priv = self->priv;
PangoLayoutLine *layout_line;
PangoLayout *layout;
gint line_no;
gint index_;
gint trailing;
gint position;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
const gchar *text;
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
layout = clutter_text_get_layout (self);
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
text = clutter_text_buffer_get_text (get_buffer (self));
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
if (start == 0)
index_ = 0;
else
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
index_ = offset_to_bytes (text, priv->position);
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
pango_layout_index_to_line_x (layout, index_,
0,
&line_no, NULL);
layout_line = pango_layout_get_line_readonly (layout, line_no);
if (!layout_line)
return FALSE;
pango_layout_line_x_to_index (layout_line, G_MAXINT, &index_, &trailing);
index_ += trailing;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
position = bytes_to_offset (text, index_);
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
return position;
}
static void
clutter_text_select_word (ClutterText *self)
{
gint cursor_pos = self->priv->position;
gint start_pos, end_pos;
start_pos = clutter_text_move_word_backward (self, cursor_pos);
end_pos = clutter_text_move_word_forward (self, cursor_pos);
clutter_text_set_selection (self, start_pos, end_pos);
}
static void
clutter_text_select_line (ClutterText *self)
{
ClutterTextPrivate *priv = self->priv;
gint cursor_pos = priv->position;
gint start_pos, end_pos;
if (priv->single_line_mode)
{
start_pos = 0;
end_pos = -1;
}
else
{
start_pos = clutter_text_move_line_start (self, cursor_pos);
end_pos = clutter_text_move_line_end (self, cursor_pos);
}
clutter_text_set_selection (self, start_pos, end_pos);
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
static gboolean
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
clutter_text_press (ClutterActor *actor,
ClutterEvent *event)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
ClutterText *self = CLUTTER_TEXT (actor);
ClutterTextPrivate *priv = self->priv;
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
ClutterEventType type = clutter_event_type (event);
[text] Check text length in ::button-press-event Bug 1529 - Selection bound out of sync with an empty Text actor When the user clicks on a Text actor the cursor position and the selection bound are set using bytes_to_offset(); if the Text is empty, this means placing them both to 0. Setting the selection bound to 0 means that when the user inserts a character by typing it into the Text, the selection will be [0,1]; this will select the first character, which will then be overwritten when typing a new character. The Text actor should, instead, check if there are no contents and set the cursor position and the selection bound to -1. The clutter_text_set_selection_bound() method should also validate the value passed, in case it's bigger than the text lenght, or smaller than -1.
2009-03-30 06:54:42 +00:00
gboolean res = FALSE;
Remove Units from the public API With the recent change to internal floating point values, ClutterUnit has become a redundant type, defined to be a float. All integer entry points are being internally converted to floating point values to be passed to the GL pipeline with the least amount of conversion. ClutterUnit is thus exposed as just a "pixel with fractionary bits", and not -- as users might think -- as generic, resolution and device independent units. not that it was the case, but a definitive amount of people was convinced it did provide this "feature", and was flummoxed about the mere existence of this type. So, having ClutterUnit exposed in the public API doubles the entry points and has the following disadvantages: - we have to maintain twice the amount of entry points in ClutterActor - we still do an integer-to-float implicit conversion - we introduce a weird impedance between pixels and "pixels with fractionary bits" - language bindings will have to choose what to bind, and resort to manually overriding the API + *except* for language bindings based on GObject-Introspection, as they cannot do manual overrides, thus will replicate the entire set of entry points For these reason, we should coalesces every Actor entry point for pixels and for ClutterUnit into a single entry point taking a float, like: void clutter_actor_set_x (ClutterActor *self, gfloat x); void clutter_actor_get_size (ClutterActor *self, gfloat *width, gfloat *height); gfloat clutter_actor_get_height (ClutterActor *self); etc. The issues I have identified are: - we'll have a two cases of compiler warnings: - printf() format of the return values from %d to %f - clutter_actor_get_size() taking floats instead of unsigned ints - we'll have a problem with varargs when passing an integer instead of a floating point value, except on 64bit platforms where the size of a float is the same as the size of an int To be clear: the *intent* of the API should not change -- we still use pixels everywhere -- but: - we remove ambiguity in the API with regard to pixels and units - we remove entry points we get to maintain for the whole 1.0 version of the API - we make things simpler to bind for both manual language bindings and automatic (gobject-introspection based) ones - we have the simplest API possible while still exposing the capabilities of the underlying GL implementation
2009-05-06 15:44:47 +00:00
gfloat x, y;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
gint index_;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Clean up button press handling Event handling should only apply to editable ClutterText actors, but we also have the :selectable property to care about. The button/touch press should position the cursor inside an editable ClutterText; the :selectable property should be used to allow selecting the text, either through pointer or touch dragging, via the keyboard, or by multiple pointer clicks. If neither of these two conditions are met, the ClutterText should just propagate the event handling further.
2012-08-17 18:52:56 +00:00
/* if a ClutterText is just used for display purposes, then we
* should ignore the events we receive
*/
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
if (!(priv->editable || priv->selectable))
text: Bubble up a click and quit early for just static text Static text shouldn't need a cursor position or anything like that, and it always eats a button press event. https://bugzilla.gnome.org/show_bug.cgi?id=673190
2012-03-30 15:19:02 +00:00
return CLUTTER_EVENT_PROPAGATE;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Clean up button press handling Event handling should only apply to editable ClutterText actors, but we also have the :selectable property to care about. The button/touch press should position the cursor inside an editable ClutterText; the :selectable property should be used to allow selecting the text, either through pointer or touch dragging, via the keyboard, or by multiple pointer clicks. If neither of these two conditions are met, the ClutterText should just propagate the event handling further.
2012-08-17 18:52:56 +00:00
clutter_actor_grab_key_focus (actor);
[text] Check text length in ::button-press-event Bug 1529 - Selection bound out of sync with an empty Text actor When the user clicks on a Text actor the cursor position and the selection bound are set using bytes_to_offset(); if the Text is empty, this means placing them both to 0. Setting the selection bound to 0 means that when the user inserts a character by typing it into the Text, the selection will be [0,1]; this will select the first character, which will then be overwritten when typing a new character. The Text actor should, instead, check if there are no contents and set the cursor position and the selection bound to -1. The clutter_text_set_selection_bound() method should also validate the value passed, in case it's bigger than the text lenght, or smaller than -1.
2009-03-30 06:54:42 +00:00
/* if the actor is empty we just reset everything and not
* set up the dragging of the selection since there's nothing
* to select
*/
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
if (clutter_text_buffer_get_length (get_buffer (self)) == 0)
[text] Check text length in ::button-press-event Bug 1529 - Selection bound out of sync with an empty Text actor When the user clicks on a Text actor the cursor position and the selection bound are set using bytes_to_offset(); if the Text is empty, this means placing them both to 0. Setting the selection bound to 0 means that when the user inserts a character by typing it into the Text, the selection will be [0,1]; this will select the first character, which will then be overwritten when typing a new character. The Text actor should, instead, check if there are no contents and set the cursor position and the selection bound to -1. The clutter_text_set_selection_bound() method should also validate the value passed, in case it's bigger than the text lenght, or smaller than -1.
2009-03-30 06:54:42 +00:00
{
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
clutter_text_set_positions (self, -1, -1);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Use the event and source symbolic macros Instead of boolean values.
2012-01-12 10:40:38 +00:00
return CLUTTER_EVENT_STOP;
[text] Check text length in ::button-press-event Bug 1529 - Selection bound out of sync with an empty Text actor When the user clicks on a Text actor the cursor position and the selection bound are set using bytes_to_offset(); if the Text is empty, this means placing them both to 0. Setting the selection bound to 0 means that when the user inserts a character by typing it into the Text, the selection will be [0,1]; this will select the first character, which will then be overwritten when typing a new character. The Text actor should, instead, check if there are no contents and set the cursor position and the selection bound to -1. The clutter_text_set_selection_bound() method should also validate the value passed, in case it's bigger than the text lenght, or smaller than -1.
2009-03-30 06:54:42 +00:00
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
clutter_event_get_coords (event, &x, &y);
res = clutter_actor_transform_stage_point (actor, x, y, &x, &y);
[text] Check text length in ::button-press-event Bug 1529 - Selection bound out of sync with an empty Text actor When the user clicks on a Text actor the cursor position and the selection bound are set using bytes_to_offset(); if the Text is empty, this means placing them both to 0. Setting the selection bound to 0 means that when the user inserts a character by typing it into the Text, the selection will be [0,1]; this will select the first character, which will then be overwritten when typing a new character. The Text actor should, instead, check if there are no contents and set the cursor position and the selection bound to -1. The clutter_text_set_selection_bound() method should also validate the value passed, in case it's bigger than the text lenght, or smaller than -1.
2009-03-30 06:54:42 +00:00
if (res)
{
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
const char *text;
text: Clean up button press handling Event handling should only apply to editable ClutterText actors, but we also have the :selectable property to care about. The button/touch press should position the cursor inside an editable ClutterText; the :selectable property should be used to allow selecting the text, either through pointer or touch dragging, via the keyboard, or by multiple pointer clicks. If neither of these two conditions are met, the ClutterText should just propagate the event handling further.
2012-08-17 18:52:56 +00:00
int offset;
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
Remove usage of Units and macros The ClutterUnit and relative macros should not be used when dealing with pixels -- which is to say, all the time when inside Clutter.
2009-06-02 17:44:30 +00:00
index_ = clutter_text_coords_to_position (self, x, y);
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
text = clutter_text_buffer_get_text (get_buffer (self));
offset = bytes_to_offset (text, index_);
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
/* what we select depends on the number of button clicks we
text: Clean up button press handling Event handling should only apply to editable ClutterText actors, but we also have the :selectable property to care about. The button/touch press should position the cursor inside an editable ClutterText; the :selectable property should be used to allow selecting the text, either through pointer or touch dragging, via the keyboard, or by multiple pointer clicks. If neither of these two conditions are met, the ClutterText should just propagate the event handling further.
2012-08-17 18:52:56 +00:00
* receive, and whether we are selectable:
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
*
* 1: just position the cursor and the selection
* 2: select the current word
* 3: select the contents of the whole actor
*/
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
if (type == CLUTTER_BUTTON_PRESS)
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
{
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
gint click_count = clutter_event_get_click_count (event);
if (click_count == 1)
{
clutter_text_set_positions (self, offset, offset);
}
text: Clean up button press handling Event handling should only apply to editable ClutterText actors, but we also have the :selectable property to care about. The button/touch press should position the cursor inside an editable ClutterText; the :selectable property should be used to allow selecting the text, either through pointer or touch dragging, via the keyboard, or by multiple pointer clicks. If neither of these two conditions are met, the ClutterText should just propagate the event handling further.
2012-08-17 18:52:56 +00:00
else if (priv->selectable && click_count == 2)
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
{
clutter_text_select_word (self);
}
text: Clean up button press handling Event handling should only apply to editable ClutterText actors, but we also have the :selectable property to care about. The button/touch press should position the cursor inside an editable ClutterText; the :selectable property should be used to allow selecting the text, either through pointer or touch dragging, via the keyboard, or by multiple pointer clicks. If neither of these two conditions are met, the ClutterText should just propagate the event handling further.
2012-08-17 18:52:56 +00:00
else if (priv->selectable && click_count == 3)
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
{
clutter_text_select_line (self);
}
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
}
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
else
text: Clean up button press handling Event handling should only apply to editable ClutterText actors, but we also have the :selectable property to care about. The button/touch press should position the cursor inside an editable ClutterText; the :selectable property should be used to allow selecting the text, either through pointer or touch dragging, via the keyboard, or by multiple pointer clicks. If neither of these two conditions are met, the ClutterText should just propagate the event handling further.
2012-08-17 18:52:56 +00:00
{
/* touch events do not have click count */
clutter_text_set_positions (self, offset, offset);
}
[text] Check text length in ::button-press-event Bug 1529 - Selection bound out of sync with an empty Text actor When the user clicks on a Text actor the cursor position and the selection bound are set using bytes_to_offset(); if the Text is empty, this means placing them both to 0. Setting the selection bound to 0 means that when the user inserts a character by typing it into the Text, the selection will be [0,1]; this will select the first character, which will then be overwritten when typing a new character. The Text actor should, instead, check if there are no contents and set the cursor position and the selection bound to -1. The clutter_text_set_selection_bound() method should also validate the value passed, in case it's bigger than the text lenght, or smaller than -1.
2009-03-30 06:54:42 +00:00
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Clean up button press handling Event handling should only apply to editable ClutterText actors, but we also have the :selectable property to care about. The button/touch press should position the cursor inside an editable ClutterText; the :selectable property should be used to allow selecting the text, either through pointer or touch dragging, via the keyboard, or by multiple pointer clicks. If neither of these two conditions are met, the ClutterText should just propagate the event handling further.
2012-08-17 18:52:56 +00:00
/* we don't need to go any further if we're not selectable */
if (!priv->selectable)
return CLUTTER_EVENT_STOP;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
/* grab the pointer */
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
priv->in_select_drag = TRUE;
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
if (type == CLUTTER_BUTTON_PRESS)
clutter_grab_pointer (actor);
else
{
clutter_input_device_sequence_grab (clutter_event_get_device (event),
clutter_event_get_event_sequence (event),
actor);
priv->in_select_touch = TRUE;
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Use the event and source symbolic macros Instead of boolean values.
2012-01-12 10:40:38 +00:00
return CLUTTER_EVENT_STOP;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
static gboolean
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
clutter_text_move (ClutterActor *actor,
ClutterEvent *event)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
Remove usage of Units and macros The ClutterUnit and relative macros should not be used when dealing with pixels -- which is to say, all the time when inside Clutter.
2009-06-02 17:44:30 +00:00
ClutterText *self = CLUTTER_TEXT (actor);
ClutterTextPrivate *priv = self->priv;
Remove Units from the public API With the recent change to internal floating point values, ClutterUnit has become a redundant type, defined to be a float. All integer entry points are being internally converted to floating point values to be passed to the GL pipeline with the least amount of conversion. ClutterUnit is thus exposed as just a "pixel with fractionary bits", and not -- as users might think -- as generic, resolution and device independent units. not that it was the case, but a definitive amount of people was convinced it did provide this "feature", and was flummoxed about the mere existence of this type. So, having ClutterUnit exposed in the public API doubles the entry points and has the following disadvantages: - we have to maintain twice the amount of entry points in ClutterActor - we still do an integer-to-float implicit conversion - we introduce a weird impedance between pixels and "pixels with fractionary bits" - language bindings will have to choose what to bind, and resort to manually overriding the API + *except* for language bindings based on GObject-Introspection, as they cannot do manual overrides, thus will replicate the entire set of entry points For these reason, we should coalesces every Actor entry point for pixels and for ClutterUnit into a single entry point taking a float, like: void clutter_actor_set_x (ClutterActor *self, gfloat x); void clutter_actor_get_size (ClutterActor *self, gfloat *width, gfloat *height); gfloat clutter_actor_get_height (ClutterActor *self); etc. The issues I have identified are: - we'll have a two cases of compiler warnings: - printf() format of the return values from %d to %f - clutter_actor_get_size() taking floats instead of unsigned ints - we'll have a problem with varargs when passing an integer instead of a floating point value, except on 64bit platforms where the size of a float is the same as the size of an int To be clear: the *intent* of the API should not change -- we still use pixels everywhere -- but: - we remove ambiguity in the API with regard to pixels and units - we remove entry points we get to maintain for the whole 1.0 version of the API - we make things simpler to bind for both manual language bindings and automatic (gobject-introspection based) ones - we have the simplest API possible while still exposing the capabilities of the underlying GL implementation
2009-05-06 15:44:47 +00:00
gfloat x, y;
Remove usage of Units and macros The ClutterUnit and relative macros should not be used when dealing with pixels -- which is to say, all the time when inside Clutter.
2009-06-02 17:44:30 +00:00
gint index_, offset;
gboolean res;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
const gchar *text;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
if (!priv->in_select_drag)
text: Use the event and source symbolic macros Instead of boolean values.
2012-01-12 10:40:38 +00:00
return CLUTTER_EVENT_PROPAGATE;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
clutter_event_get_coords (event, &x, &y);
res = clutter_actor_transform_stage_point (actor, x, y, &x, &y);
Remove usage of Units and macros The ClutterUnit and relative macros should not be used when dealing with pixels -- which is to say, all the time when inside Clutter.
2009-06-02 17:44:30 +00:00
if (!res)
text: Use the event and source symbolic macros Instead of boolean values.
2012-01-12 10:40:38 +00:00
return CLUTTER_EVENT_PROPAGATE;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Remove usage of Units and macros The ClutterUnit and relative macros should not be used when dealing with pixels -- which is to say, all the time when inside Clutter.
2009-06-02 17:44:30 +00:00
index_ = clutter_text_coords_to_position (self, x, y);
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
text = clutter_text_buffer_get_text (get_buffer (self));
offset = bytes_to_offset (text, index_);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
if (priv->selectable)
Remove usage of Units and macros The ClutterUnit and relative macros should not be used when dealing with pixels -- which is to say, all the time when inside Clutter.
2009-06-02 17:44:30 +00:00
clutter_text_set_cursor_position (self, offset);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
else
text: Fixes for selection bound The commit ecbb7ce41a1a759e246fce07f146b8bed5e3d730 exposed some issues when positioning the cursor with the mouse pointer: the selection is not moved along with the cursor when inserting a single character or a string. Also, some freeze_notify() are called too early, leading to decoupling from their respective thaw_notify(). http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-02-02 17:07:22 +00:00
clutter_text_set_positions (self, offset, offset);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Use the event and source symbolic macros Instead of boolean values.
2012-01-12 10:40:38 +00:00
return CLUTTER_EVENT_STOP;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
static gboolean
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
clutter_text_release (ClutterActor *actor,
ClutterEvent *event)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
Remove usage of Units and macros The ClutterUnit and relative macros should not be used when dealing with pixels -- which is to say, all the time when inside Clutter.
2009-06-02 17:44:30 +00:00
ClutterText *self = CLUTTER_TEXT (actor);
ClutterTextPrivate *priv = self->priv;
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
ClutterEventType type = clutter_event_type (event);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
if (priv->in_select_drag)
{
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
if (type == CLUTTER_BUTTON_RELEASE)
{
if (!priv->in_select_touch)
{
clutter_ungrab_pointer ();
priv->in_select_drag = FALSE;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
return CLUTTER_EVENT_STOP;
}
}
else
{
if (priv->in_select_touch)
{
ClutterInputDevice *device = clutter_event_get_device (event);
ClutterEventSequence *sequence =
clutter_event_get_event_sequence (event);
clutter_input_device_sequence_ungrab (device, sequence);
priv->in_select_touch = FALSE;
priv->in_select_drag = FALSE;
return CLUTTER_EVENT_STOP;
}
}
}
return CLUTTER_EVENT_PROPAGATE;
}
static gboolean
clutter_text_button_press (ClutterActor *actor,
ClutterButtonEvent *event)
{
return clutter_text_press (actor, (ClutterEvent *) event);
}
static gboolean
clutter_text_motion (ClutterActor *actor,
ClutterMotionEvent *event)
{
return clutter_text_move (actor, (ClutterEvent *) event);
}
static gboolean
clutter_text_button_release (ClutterActor *actor,
ClutterButtonEvent *event)
{
return clutter_text_release (actor, (ClutterEvent *) event);
}
static gboolean
clutter_text_touch_event (ClutterActor *actor,
ClutterTouchEvent *event)
{
switch (event->type)
{
case CLUTTER_TOUCH_BEGIN:
return clutter_text_press (actor, (ClutterEvent *) event);
case CLUTTER_TOUCH_END:
case CLUTTER_TOUCH_CANCEL:
/* TODO: the cancel case probably need a special handler */
return clutter_text_release (actor, (ClutterEvent *) event);
case CLUTTER_TOUCH_UPDATE:
return clutter_text_move (actor, (ClutterEvent *) event);
default:
break;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
text: Use the event and source symbolic macros Instead of boolean values.
2012-01-12 10:40:38 +00:00
return CLUTTER_EVENT_PROPAGATE;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
static gboolean
clutter_text_remove_password_hint (gpointer data)
{
ClutterText *self = data;
self->priv->password_hint_visible = FALSE;
self->priv->password_hint_id = 0;
clutter_text_dirty_cache (data);
clutter_text_queue_redraw (data);
text: Use the event and source symbolic macros Instead of boolean values.
2012-01-12 10:40:38 +00:00
return G_SOURCE_REMOVE;
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
}
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
static gboolean
clutter_text_key_press (ClutterActor *actor,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
ClutterKeyEvent *event)
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
{
Truncate selections on text insertion When inserting text on a key press event we should also truncate the selection. We should not truncate the selection when inserting any Unicode character, since changing the selection also changes the cursor position - and one of the invariants we inherited from ClutterEntry is that inserting characters programmatically does not change the cursor position.
2008-12-11 12:10:46 +00:00
ClutterText *self = CLUTTER_TEXT (actor);
ClutterTextPrivate *priv = self->priv;
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
ClutterBindingPool *pool;
gboolean res;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
if (!priv->editable)
text: Use the event and source symbolic macros Instead of boolean values.
2012-01-12 10:40:38 +00:00
return CLUTTER_EVENT_PROPAGATE;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
[text] Use the base class binding pool Bug 1518 - [Patch] Widget derivied from ClutterText will crash on key_press_event In clutter_text_key_press() we are using G_OBJECT_TYPE_NAME to find out the actor's type name. However, if some widget is derived from ClutterText, when the key press handler is called, G_OBJECT_TYPE_NAME will return the name of the derived widget. The default implementation should get the binding pool for the base class. Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-03-30 15:57:11 +00:00
/* we need to use the ClutterText type name to find our own
* key bindings; subclasses will override or chain up this
* event handler, so they can do whatever they want there
*/
pool = clutter_binding_pool_find (g_type_name (CLUTTER_TYPE_TEXT));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
g_assert (pool != NULL);
Allow only synthetic events with keyval 0 We allow KeyEvents with a key symbol of '0' to fall through only if they are marked as synthetic. Otherwise we discard them without mercy. Synthetic events are useful to test ClutterText behaviour; in fact, we do use them inside the test suite exactly for that reason.
2008-12-11 12:24:45 +00:00
/* we allow passing synthetic events that only contain
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
* the Unicode value and not the key symbol, unless they
* contain the input method flag.
Allow only synthetic events with keyval 0 We allow KeyEvents with a key symbol of '0' to fall through only if they are marked as synthetic. Otherwise we discard them without mercy. Synthetic events are useful to test ClutterText behaviour; in fact, we do use them inside the test suite exactly for that reason.
2008-12-11 12:24:45 +00:00
*/
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
if (event->keyval == 0 && (event->flags & CLUTTER_EVENT_FLAG_SYNTHETIC) &&
!(event->flags & CLUTTER_EVENT_FLAG_INPUT_METHOD))
Allow only synthetic events with keyval 0 We allow KeyEvents with a key symbol of '0' to fall through only if they are marked as synthetic. Otherwise we discard them without mercy. Synthetic events are useful to test ClutterText behaviour; in fact, we do use them inside the test suite exactly for that reason.
2008-12-11 12:24:45 +00:00
res = FALSE;
else
introspection-friendly ClutterEvent accessors ClutterEvent is not really gobject-introspection friendly because of the whole discriminated union thing. In particular, if you get a ClutterEvent in a signal handler, you probably can't access the event-type-specific fields, and you probably can't call methods like clutter_key_event_symbol() either, because you can't cast the ClutterEvent to a ClutterKeyEvent. The cleanest solution is to turn every accessor into ClutterEvent methods, accepting a ClutterEvent* and internally checking the event type. Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1585
2009-06-06 14:27:37 +00:00
res = clutter_binding_pool_activate (pool, event->keyval,
Allow only synthetic events with keyval 0 We allow KeyEvents with a key symbol of '0' to fall through only if they are marked as synthetic. Otherwise we discard them without mercy. Synthetic events are useful to test ClutterText behaviour; in fact, we do use them inside the test suite exactly for that reason.
2008-12-11 12:24:45 +00:00
event->modifier_state,
G_OBJECT (actor));
/* if the key binding has handled the event we bail out
* as fast as we can; otherwise, we try to insert the
* Unicode character inside the key event into the text
* actor
*/
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
if (res)
text: Use the event and source symbolic macros Instead of boolean values.
2012-01-12 10:40:38 +00:00
return CLUTTER_EVENT_STOP;
[text] Don't interpret the unicode value when the control modifier is on When a letter key is pressed with the control key held down one of three things will happen :- a) If the stage is embedded within a GtkClutterEmbed the unicode value will be filled from gdk_keyval_to_unicode. This will be the same value as if control was not pressed (so Ctrl+V will be 'v'). b) If the stage is not in a GtkClutterEmbed and Clutter is running on the X11 backend then it will try to fill in the unicode value from XLookupString. This *will* take into account the control so the unicode value will represent a control character (Ctrl+V will be '\x16'). c) Most other backends will not bother to fill in the unicode value. Therefore clutter_keysym_to_unicode will be used which also does not take into account the control key (so Ctrl+V will be 'v'). For cut and paste to work in Nbtk, the control keys need to bubble up to the parent NbtkEntry container. This works fine for 'b' but not 'a' and 'c'. This patch makes ClutterText always allow the event to bubble if the key is not handled by the binding pool and the control modifier is down. Ideally ClutterText would always get a unicode value that takes into account the modifiers but this is probably best left up to the input methods. Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-08-17 16:43:42 +00:00
else if ((event->modifier_state & CLUTTER_CONTROL_MASK) == 0)
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
{
introspection-friendly ClutterEvent accessors ClutterEvent is not really gobject-introspection friendly because of the whole discriminated union thing. In particular, if you get a ClutterEvent in a signal handler, you probably can't access the event-type-specific fields, and you probably can't call methods like clutter_key_event_symbol() either, because you can't cast the ClutterEvent to a ClutterKeyEvent. The cleanest solution is to turn every accessor into ClutterEvent methods, accepting a ClutterEvent* and internally checking the event type. Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1585
2009-06-06 14:27:37 +00:00
gunichar key_unichar;
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
if (clutter_input_focus_filter_key_event (priv->input_focus, event))
return CLUTTER_EVENT_STOP;
text: Use the event and source symbolic macros Instead of boolean values.
2012-01-12 10:40:38 +00:00
/* Skip keys when control is pressed */
introspection-friendly ClutterEvent accessors ClutterEvent is not really gobject-introspection friendly because of the whole discriminated union thing. In particular, if you get a ClutterEvent in a signal handler, you probably can't access the event-type-specific fields, and you probably can't call methods like clutter_key_event_symbol() either, because you can't cast the ClutterEvent to a ClutterKeyEvent. The cleanest solution is to turn every accessor into ClutterEvent methods, accepting a ClutterEvent* and internally checking the event type. Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1585
2009-06-06 14:27:37 +00:00
key_unichar = clutter_event_get_key_unicode ((ClutterEvent *) event);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
Allow only synthetic events with keyval 0 We allow KeyEvents with a key symbol of '0' to fall through only if they are marked as synthetic. Otherwise we discard them without mercy. Synthetic events are useful to test ClutterText behaviour; in fact, we do use them inside the test suite exactly for that reason.
2008-12-11 12:24:45 +00:00
/* return is reported as CR, but we want LF */
if (key_unichar == '\r')
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
key_unichar = '\n';
text: Don't accept new line characters in single line mode Modified Return key presses don't trigger ::activate so we would end up adding an unprintable character to a single paragraph mode pango layout which renders it as a box. https://bugzilla.gnome.org/show_bug.cgi?id=623344
2012-09-09 18:44:43 +00:00
if ((key_unichar == '\n' && !priv->single_line_mode) ||
[clutter-text] Don't allow control characters to be inserted If an unbound control key is pressed (such as Ctrl+R) it would insert a rectangle into the text. Also zero is considered a valid unicode character by g_unichar_validate so pressing a key such as shift would cause the current selection to be deleted. The character isn't actually inserted because insert_unichar disallows zeroes.
2009-01-13 17:52:38 +00:00
(g_unichar_validate (key_unichar) &&
!g_unichar_iscntrl (key_unichar)))
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
{
Allow only synthetic events with keyval 0 We allow KeyEvents with a key symbol of '0' to fall through only if they are marked as synthetic. Otherwise we discard them without mercy. Synthetic events are useful to test ClutterText behaviour; in fact, we do use them inside the test suite exactly for that reason.
2008-12-11 12:24:45 +00:00
/* truncate the eventual selection so that the
* Unicode character can replace it
*/
[text] Add ClutterText::delete_selection() Add a method for deleting the current selection inside a Text actor. This is useful for subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:08:25 +00:00
clutter_text_delete_selection (self);
Truncate selections on text insertion When inserting text on a key press event we should also truncate the selection. We should not truncate the selection when inserting any Unicode character, since changing the selection also changes the cursor position - and one of the invariants we inherited from ClutterEntry is that inserting characters programmatically does not change the cursor position.
2008-12-11 12:10:46 +00:00
clutter_text_insert_unichar (self, key_unichar);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
if (priv->show_password_hint)
{
if (priv->password_hint_id != 0)
g_source_remove (priv->password_hint_id);
priv->password_hint_visible = TRUE;
priv->password_hint_id =
text: Use the event and source symbolic macros Instead of boolean values.
2012-01-12 10:40:38 +00:00
clutter_threads_add_timeout (priv->password_hint_timeout,
clutter_text_remove_password_hint,
self);
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
}
text: Use the event and source symbolic macros Instead of boolean values.
2012-01-12 10:40:38 +00:00
return CLUTTER_EVENT_STOP;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
}
}
text: Use the event and source symbolic macros Instead of boolean values.
2012-01-12 10:40:38 +00:00
return CLUTTER_EVENT_PROPAGATE;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
}
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
static gboolean
clutter_text_key_release (ClutterActor *actor,
ClutterKeyEvent *event)
{
ClutterText *self = CLUTTER_TEXT (actor);
ClutterTextPrivate *priv = self->priv;
if (clutter_input_focus_filter_key_event (priv->input_focus, event))
return CLUTTER_EVENT_STOP;
return CLUTTER_EVENT_PROPAGATE;
}
text: Use actor alignments when painting the layout ClutterActor's x-align and y-align properties should be used to control the alignment of the PangoLayout when painting it within a larger allocation, and the ClutterText has the x-expand or the y-expand flags set.
2012-06-07 15:14:21 +00:00
static void
clutter_text_compute_layout_offsets (ClutterText *self,
PangoLayout *layout,
const ClutterActorBox *alloc,
int *text_x,
int *text_y)
{
ClutterActor *actor = CLUTTER_ACTOR (self);
ClutterActorAlign x_align, y_align;
PangoRectangle logical_rect;
float alloc_width, alloc_height;
float x, y;
clutter_actor_box_get_size (alloc, &alloc_width, &alloc_height);
pango_layout_get_pixel_extents (layout, NULL, &logical_rect);
if (clutter_actor_needs_expand (actor, CLUTTER_ORIENTATION_HORIZONTAL))
x_align = _clutter_actor_get_effective_x_align (actor);
else
x_align = CLUTTER_ACTOR_ALIGN_FILL;
if (clutter_actor_needs_expand (actor, CLUTTER_ORIENTATION_VERTICAL))
y_align = clutter_actor_get_y_align (actor);
else
y_align = CLUTTER_ACTOR_ALIGN_FILL;
x = 0.f;
switch (x_align)
{
case CLUTTER_ACTOR_ALIGN_FILL:
case CLUTTER_ACTOR_ALIGN_START:
break;
case CLUTTER_ACTOR_ALIGN_END:
if (alloc_width > logical_rect.width)
x = alloc_width - logical_rect.width;
break;
case CLUTTER_ACTOR_ALIGN_CENTER:
if (alloc_width > logical_rect.width)
x = (alloc_width - logical_rect.width) / 2.f;
break;
}
y = 0.f;
switch (y_align)
{
case CLUTTER_ACTOR_ALIGN_FILL:
case CLUTTER_ACTOR_ALIGN_START:
break;
case CLUTTER_ACTOR_ALIGN_END:
if (alloc_height > logical_rect.height)
y = alloc_height - logical_rect.height;
break;
case CLUTTER_ACTOR_ALIGN_CENTER:
if (alloc_height > logical_rect.height)
y = (alloc_height - logical_rect.height) / 2.f;
break;
}
if (text_x != NULL)
*text_x = floorf (x);
if (text_y != NULL)
*text_y = floorf (y);
}
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
#define TEXT_PADDING 2
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
static void
clutter_text_paint (ClutterActor *self)
{
ClutterText *text = CLUTTER_TEXT (self);
ClutterTextPrivate *priv = text->priv;
Use the non-deprecated Cogl clipping API Cogl 1.18 deprecated the global clipping API in favour of the per-framebuffer one, but since we're using the 2.0 API internally we don't have access to the deprecated symbols any more. This is pretty much a mechanical port for all the places where we're still using the old 1.x API.
2013-12-03 12:12:52 +00:00
CoglFramebuffer *fb;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
PangoLayout *layout;
ClutterActorBox alloc = { 0, };
CoglColor color = { 0, };
Use the paint opacity when painting a ClutterText ClutterText should use the paint opacity for both text and cursor. ClutterLabel had the wrong behaviour, as it set the actor's opacity using the text color's alpha channel, and ClutterEntry completely disregarded the actor's opacity when painting the cursor. This commit harmonizes the ClutterText behaviour to always use a composition of the actor's paint opacity and the text and cursor alpha channel values, thus behaving more consistently with the rest of Clutter.
2008-12-11 12:18:26 +00:00
guint8 real_opacity;
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
gint text_x = priv->text_x;
text: Use actor alignments when painting the layout ClutterActor's x-align and y-align properties should be used to control the alignment of the PangoLayout when painting it within a larger allocation, and the ClutterText has the x-expand or the y-expand flags set.
2012-06-07 15:14:21 +00:00
gint text_y = priv->text_y;
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
gboolean clip_set = FALSE;
text: Use the background color when painting If the ClutterActor:background-color-set property is set to TRUE.
2012-03-06 15:06:52 +00:00
gboolean bg_color_set = FALSE;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
guint n_chars;
Use the non-deprecated Cogl clipping API Cogl 1.18 deprecated the global clipping API in favour of the per-framebuffer one, but since we're using the 2.0 API internally we don't have access to the deprecated symbols any more. This is pretty much a mechanical port for all the places where we're still using the old 1.x API.
2013-12-03 12:12:52 +00:00
float alloc_width;
float alloc_height;
text: Add a hacky fallback for the framebuffer The text-cache conformance test breaks because ClutterText gets a paint without an active framebuffer associated to the ClutterStage. Keep a fallback while we investigate the issue.
2013-12-03 13:01:52 +00:00
/* FIXME: this should not be needed, but apparently the text-cache
* test unit manages to get in a situation where the active frame
* buffer is NULL
*/
Use the non-deprecated Cogl clipping API Cogl 1.18 deprecated the global clipping API in favour of the per-framebuffer one, but since we're using the 2.0 API internally we don't have access to the deprecated symbols any more. This is pretty much a mechanical port for all the places where we're still using the old 1.x API.
2013-12-03 12:12:52 +00:00
fb = _clutter_actor_get_active_framebuffer (self);
text: Add a hacky fallback for the framebuffer The text-cache conformance test breaks because ClutterText gets a paint without an active framebuffer associated to the ClutterStage. Keep a fallback while we investigate the issue.
2013-12-03 13:01:52 +00:00
if (fb == NULL)
fb = cogl_get_draw_framebuffer ();
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
/* Note that if anything in this paint method changes it needs to be
reflected in the get_paint_volume implementation which is tightly
tied to the workings of this function */
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
n_chars = clutter_text_buffer_get_length (get_buffer (text));
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
clutter_actor_get_allocation_box (self, &alloc);
Use the non-deprecated Cogl clipping API Cogl 1.18 deprecated the global clipping API in favour of the per-framebuffer one, but since we're using the 2.0 API internally we don't have access to the deprecated symbols any more. This is pretty much a mechanical port for all the places where we're still using the old 1.x API.
2013-12-03 12:12:52 +00:00
alloc_width = alloc.x2 - alloc.x1;
alloc_height = alloc.y2 - alloc.y1;
text: Layouts for single-line-mode entries are boundless A PangoLayout for an editable, single-line text entry is by definition without a given width, since the actor will be clipped when being drawn.
2010-07-09 17:37:34 +00:00
text: Use the background color when painting If the ClutterActor:background-color-set property is set to TRUE.
2012-03-06 15:06:52 +00:00
g_object_get (self, "background-color-set", &bg_color_set, NULL);
if (bg_color_set)
{
ClutterColor bg_color;
clutter_actor_get_background_color (self, &bg_color);
bg_color.alpha = clutter_actor_get_paint_opacity (self)
* bg_color.alpha
/ 255;
cogl_set_source_color4ub (bg_color.red,
bg_color.green,
bg_color.blue,
bg_color.alpha);
Use the non-deprecated Cogl clipping API Cogl 1.18 deprecated the global clipping API in favour of the per-framebuffer one, but since we're using the 2.0 API internally we don't have access to the deprecated symbols any more. This is pretty much a mechanical port for all the places where we're still using the old 1.x API.
2013-12-03 12:12:52 +00:00
cogl_rectangle (0, 0, alloc_width, alloc_height);
text: Use the background color when painting If the ClutterActor:background-color-set property is set to TRUE.
2012-03-06 15:06:52 +00:00
}
clutter-text: Make sure to paint the background of a text actor https://bugzilla.gnome.org/show_bug.cgi?id=682070
2012-07-25 16:34:03 +00:00
/* don't bother painting an empty text actor, unless it's
* editable, in which case we want to paint at least the
* cursor
*/
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
if (n_chars == 0 &&
!clutter_text_should_draw_cursor (text))
clutter-text: Make sure to paint the background of a text actor https://bugzilla.gnome.org/show_bug.cgi?id=682070
2012-07-25 16:34:03 +00:00
return;
text: Layouts for single-line-mode entries are boundless A PangoLayout for an editable, single-line text entry is by definition without a given width, since the actor will be clipped when being drawn.
2010-07-09 17:37:34 +00:00
if (priv->editable && priv->single_line_mode)
layout = clutter_text_create_layout (text, -1, -1);
else
text: Make :line-wrap actually work When we paint a ClutterText we ask the actor for a PangoLayout that fits inside the actor's allocation - both width and height. Sadly, whenever a height is set on a PangoLayout, Pango will wrap its contents - regardless of whether the layout should actually wrap or not. This means that in certain easy to exploit cases, Clutter will paint a Text actor with its contents wrapping even if the :wrap property is set to FALSE. In order to fix this we need to encode some more cases inside the ::paint implementation of ClutterText, and ask the cache for a layout that is sized as the allocation's width, but not as its height; we also need to perform a clip if we detect that the PangoLayout's logical size is going to overflow the allocated size. This clip might cause some performance issue, given that clipping breaks batching in the Cogl journal; hopefully all clips for text are going to be screen-aligned, so at the end of the batch it'll just scissor them out. http://bugzilla.clutter-project.org/show_bug.cgi?id=2339
2011-09-04 16:57:50 +00:00
{
/* the only time when we create the PangoLayout using the full
* width and height of the allocation is when we can both wrap
* and ellipsize
*/
if (priv->wrap && priv->ellipsize)
{
Use the non-deprecated Cogl clipping API Cogl 1.18 deprecated the global clipping API in favour of the per-framebuffer one, but since we're using the 2.0 API internally we don't have access to the deprecated symbols any more. This is pretty much a mechanical port for all the places where we're still using the old 1.x API.
2013-12-03 12:12:52 +00:00
layout = clutter_text_create_layout (text, alloc_width, alloc_height);
text: Make :line-wrap actually work When we paint a ClutterText we ask the actor for a PangoLayout that fits inside the actor's allocation - both width and height. Sadly, whenever a height is set on a PangoLayout, Pango will wrap its contents - regardless of whether the layout should actually wrap or not. This means that in certain easy to exploit cases, Clutter will paint a Text actor with its contents wrapping even if the :wrap property is set to FALSE. In order to fix this we need to encode some more cases inside the ::paint implementation of ClutterText, and ask the cache for a layout that is sized as the allocation's width, but not as its height; we also need to perform a clip if we detect that the PangoLayout's logical size is going to overflow the allocated size. This clip might cause some performance issue, given that clipping breaks batching in the Cogl journal; hopefully all clips for text are going to be screen-aligned, so at the end of the batch it'll just scissor them out. http://bugzilla.clutter-project.org/show_bug.cgi?id=2339
2011-09-04 16:57:50 +00:00
}
else
{
/* if we're not wrapping we cannot set the height of the
* layout, otherwise Pango will happily wrap the text to
* fit in the rectangle - thus making the :wrap property
* useless
*
* see bug:
*
* http://bugzilla.clutter-project.org/show_bug.cgi?id=2339
*
* in order to fix this, we create a layout that would fit
* in the assigned width, then we clip the actor if the
* logical rectangle overflows the allocation.
*/
Use the non-deprecated Cogl clipping API Cogl 1.18 deprecated the global clipping API in favour of the per-framebuffer one, but since we're using the 2.0 API internally we don't have access to the deprecated symbols any more. This is pretty much a mechanical port for all the places where we're still using the old 1.x API.
2013-12-03 12:12:52 +00:00
layout = clutter_text_create_layout (text, alloc_width, -1);
text: Make :line-wrap actually work When we paint a ClutterText we ask the actor for a PangoLayout that fits inside the actor's allocation - both width and height. Sadly, whenever a height is set on a PangoLayout, Pango will wrap its contents - regardless of whether the layout should actually wrap or not. This means that in certain easy to exploit cases, Clutter will paint a Text actor with its contents wrapping even if the :wrap property is set to FALSE. In order to fix this we need to encode some more cases inside the ::paint implementation of ClutterText, and ask the cache for a layout that is sized as the allocation's width, but not as its height; we also need to perform a clip if we detect that the PangoLayout's logical size is going to overflow the allocated size. This clip might cause some performance issue, given that clipping breaks batching in the Cogl journal; hopefully all clips for text are going to be screen-aligned, so at the end of the batch it'll just scissor them out. http://bugzilla.clutter-project.org/show_bug.cgi?id=2339
2011-09-04 16:57:50 +00:00
}
}
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
text: Unify conditions for visible cursor We have a bunch of similar checks in various places, and they should all be coalesced into one.
2015-11-30 13:45:45 +00:00
if (clutter_text_should_draw_cursor (text))
[text] Do not ensure the cursor if not needed If the Text actor is neither editable nor has its cursor set to visible, then we should not be ensuring the cursor position. This fixes a failure in the conformance test unit for the layout cache.
2009-01-07 13:14:13 +00:00
clutter_text_ensure_cursor_position (text);
if (priv->editable && priv->single_line_mode)
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
{
PangoRectangle logical_rect = { 0, };
gint actor_width, text_width;
text: Consider text direction when computing layout offsets Currently this is only the case when the actor's x-expand/x-align flags have been set and clutter_text_compute_layout_offsets() is used. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2013-09-10 18:56:09 +00:00
gboolean rtl;
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
pango_layout_get_extents (layout, NULL, &logical_rect);
Use the non-deprecated Cogl clipping API Cogl 1.18 deprecated the global clipping API in favour of the per-framebuffer one, but since we're using the 2.0 API internally we don't have access to the deprecated symbols any more. This is pretty much a mechanical port for all the places where we're still using the old 1.x API.
2013-12-03 12:12:52 +00:00
cogl_framebuffer_push_rectangle_clip (fb, 0, 0, alloc_width, alloc_height);
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
clip_set = TRUE;
Use the non-deprecated Cogl clipping API Cogl 1.18 deprecated the global clipping API in favour of the per-framebuffer one, but since we're using the 2.0 API internally we don't have access to the deprecated symbols any more. This is pretty much a mechanical port for all the places where we're still using the old 1.x API.
2013-12-03 12:12:52 +00:00
actor_width = alloc_width - 2 * TEXT_PADDING;
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
text_width = logical_rect.width / PANGO_SCALE;
text: Use the resolved text direction Now that we compute the effective text direction when creating the Pango layout, we should also use it when painting it. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2014-03-03 19:16:00 +00:00
rtl = priv->resolved_direction == PANGO_DIRECTION_RTL;
text: Consider text direction when computing layout offsets Currently this is only the case when the actor's x-expand/x-align flags have been set and clutter_text_compute_layout_offsets() is used. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2013-09-10 18:56:09 +00:00
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
if (actor_width < text_width)
{
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
gint cursor_x = clutter_rect_get_x (&priv->cursor_rect);
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
if (priv->position == -1)
{
text: Consider text direction when computing layout offsets Currently this is only the case when the actor's x-expand/x-align flags have been set and clutter_text_compute_layout_offsets() is used. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2013-09-10 18:56:09 +00:00
text_x = rtl ? TEXT_PADDING : actor_width - text_width;
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
}
else if (priv->position == 0)
{
text: Consider text direction when computing layout offsets Currently this is only the case when the actor's x-expand/x-align flags have been set and clutter_text_compute_layout_offsets() is used. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2013-09-10 18:56:09 +00:00
text_x = rtl ? actor_width - text_width : TEXT_PADDING;
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
}
else
{
[text] scroll to the cursor position if it is outside the allocation Adjust the text offset to keep the cursor within the allocation. This means the text will scroll per character
2009-05-14 12:31:51 +00:00
if (cursor_x < 0)
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
{
[text] scroll to the cursor position if it is outside the allocation Adjust the text offset to keep the cursor within the allocation. This means the text will scroll per character
2009-05-14 12:31:51 +00:00
text_x = text_x - cursor_x - TEXT_PADDING;
}
else if (cursor_x > actor_width)
{
text_x = text_x + (actor_width - cursor_x) - TEXT_PADDING;
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
}
}
}
else
{
text: Consider text direction when computing layout offsets Currently this is only the case when the actor's x-expand/x-align flags have been set and clutter_text_compute_layout_offsets() is used. https://bugzilla.gnome.org/show_bug.cgi?id=705779
2013-09-10 18:56:09 +00:00
text_x = rtl ? actor_width - text_width : TEXT_PADDING;
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
}
}
text: Make :line-wrap actually work When we paint a ClutterText we ask the actor for a PangoLayout that fits inside the actor's allocation - both width and height. Sadly, whenever a height is set on a PangoLayout, Pango will wrap its contents - regardless of whether the layout should actually wrap or not. This means that in certain easy to exploit cases, Clutter will paint a Text actor with its contents wrapping even if the :wrap property is set to FALSE. In order to fix this we need to encode some more cases inside the ::paint implementation of ClutterText, and ask the cache for a layout that is sized as the allocation's width, but not as its height; we also need to perform a clip if we detect that the PangoLayout's logical size is going to overflow the allocated size. This clip might cause some performance issue, given that clipping breaks batching in the Cogl journal; hopefully all clips for text are going to be screen-aligned, so at the end of the batch it'll just scissor them out. http://bugzilla.clutter-project.org/show_bug.cgi?id=2339
2011-09-04 16:57:50 +00:00
else if (!priv->editable && !(priv->wrap && priv->ellipsize))
{
PangoRectangle logical_rect = { 0, };
pango_layout_get_pixel_extents (layout, NULL, &logical_rect);
/* don't clip if the layout managed to fit inside our allocation */
Use the non-deprecated Cogl clipping API Cogl 1.18 deprecated the global clipping API in favour of the per-framebuffer one, but since we're using the 2.0 API internally we don't have access to the deprecated symbols any more. This is pretty much a mechanical port for all the places where we're still using the old 1.x API.
2013-12-03 12:12:52 +00:00
if (logical_rect.width > alloc_width ||
logical_rect.height > alloc_height)
text: Make :line-wrap actually work When we paint a ClutterText we ask the actor for a PangoLayout that fits inside the actor's allocation - both width and height. Sadly, whenever a height is set on a PangoLayout, Pango will wrap its contents - regardless of whether the layout should actually wrap or not. This means that in certain easy to exploit cases, Clutter will paint a Text actor with its contents wrapping even if the :wrap property is set to FALSE. In order to fix this we need to encode some more cases inside the ::paint implementation of ClutterText, and ask the cache for a layout that is sized as the allocation's width, but not as its height; we also need to perform a clip if we detect that the PangoLayout's logical size is going to overflow the allocated size. This clip might cause some performance issue, given that clipping breaks batching in the Cogl journal; hopefully all clips for text are going to be screen-aligned, so at the end of the batch it'll just scissor them out. http://bugzilla.clutter-project.org/show_bug.cgi?id=2339
2011-09-04 16:57:50 +00:00
{
Use the non-deprecated Cogl clipping API Cogl 1.18 deprecated the global clipping API in favour of the per-framebuffer one, but since we're using the 2.0 API internally we don't have access to the deprecated symbols any more. This is pretty much a mechanical port for all the places where we're still using the old 1.x API.
2013-12-03 12:12:52 +00:00
cogl_framebuffer_push_rectangle_clip (fb, 0, 0, alloc_width, alloc_height);
text: Make :line-wrap actually work When we paint a ClutterText we ask the actor for a PangoLayout that fits inside the actor's allocation - both width and height. Sadly, whenever a height is set on a PangoLayout, Pango will wrap its contents - regardless of whether the layout should actually wrap or not. This means that in certain easy to exploit cases, Clutter will paint a Text actor with its contents wrapping even if the :wrap property is set to FALSE. In order to fix this we need to encode some more cases inside the ::paint implementation of ClutterText, and ask the cache for a layout that is sized as the allocation's width, but not as its height; we also need to perform a clip if we detect that the PangoLayout's logical size is going to overflow the allocated size. This clip might cause some performance issue, given that clipping breaks batching in the Cogl journal; hopefully all clips for text are going to be screen-aligned, so at the end of the batch it'll just scissor them out. http://bugzilla.clutter-project.org/show_bug.cgi?id=2339
2011-09-04 16:57:50 +00:00
clip_set = TRUE;
}
text: Use actor alignments when painting the layout ClutterActor's x-align and y-align properties should be used to control the alignment of the PangoLayout when painting it within a larger allocation, and the ClutterText has the x-expand or the y-expand flags set.
2012-06-07 15:14:21 +00:00
clutter_text_compute_layout_offsets (text, layout, &alloc, &text_x, &text_y);
text: Make :line-wrap actually work When we paint a ClutterText we ask the actor for a PangoLayout that fits inside the actor's allocation - both width and height. Sadly, whenever a height is set on a PangoLayout, Pango will wrap its contents - regardless of whether the layout should actually wrap or not. This means that in certain easy to exploit cases, Clutter will paint a Text actor with its contents wrapping even if the :wrap property is set to FALSE. In order to fix this we need to encode some more cases inside the ::paint implementation of ClutterText, and ask the cache for a layout that is sized as the allocation's width, but not as its height; we also need to perform a clip if we detect that the PangoLayout's logical size is going to overflow the allocated size. This clip might cause some performance issue, given that clipping breaks batching in the Cogl journal; hopefully all clips for text are going to be screen-aligned, so at the end of the batch it'll just scissor them out. http://bugzilla.clutter-project.org/show_bug.cgi?id=2339
2011-09-04 16:57:50 +00:00
}
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
else
text: Use actor alignments when painting the layout ClutterActor's x-align and y-align properties should be used to control the alignment of the PangoLayout when painting it within a larger allocation, and the ClutterText has the x-expand or the y-expand flags set.
2012-06-07 15:14:21 +00:00
clutter_text_compute_layout_offsets (text, layout, &alloc, &text_x, &text_y);
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
text: Use actor alignments when painting the layout ClutterActor's x-align and y-align properties should be used to control the alignment of the PangoLayout when painting it within a larger allocation, and the ClutterText has the x-expand or the y-expand flags set.
2012-06-07 15:14:21 +00:00
if (priv->text_x != text_x ||
priv->text_y != text_y)
clutter-text: Always update cursor positions when painting The cursor's on-screen rectangle is defined in terms of the text length, the current index, and text_x and text_y, which hold the text offset in overflowing text fields. When deleting large amounts of text, text_x is set to 0. In some edge case branch paths, the cursor rectangle could be calculated after the current index and text length were updated, but before the text_x offset could be. This left a negative x position, which consequently blew up Cogl and the widget. https://bugzilla.gnome.org/show_bug.cgi?id=651079
2011-07-03 20:43:17 +00:00
{
priv->text_x = text_x;
text: Use actor alignments when painting the layout ClutterActor's x-align and y-align properties should be used to control the alignment of the PangoLayout when painting it within a larger allocation, and the ClutterText has the x-expand or the y-expand flags set.
2012-06-07 15:14:21 +00:00
priv->text_y = text_y;
clutter-text: Always update cursor positions when painting The cursor's on-screen rectangle is defined in terms of the text length, the current index, and text_x and text_y, which hold the text offset in overflowing text fields. When deleting large amounts of text, text_x is set to 0. In some edge case branch paths, the cursor rectangle could be calculated after the current index and text length were updated, but before the text_x offset could be. This left a negative x position, which consequently blew up Cogl and the widget. https://bugzilla.gnome.org/show_bug.cgi?id=651079
2011-07-03 20:43:17 +00:00
clutter_text_ensure_cursor_position (text);
}
[text] scroll to the cursor position if it is outside the allocation Adjust the text offset to keep the cursor within the allocation. This means the text will scroll per character
2009-05-14 12:31:51 +00:00
Use the paint opacity when painting a ClutterText ClutterText should use the paint opacity for both text and cursor. ClutterLabel had the wrong behaviour, as it set the actor's opacity using the text color's alpha channel, and ClutterEntry completely disregarded the actor's opacity when painting the cursor. This commit harmonizes the ClutterText behaviour to always use a composition of the actor's paint opacity and the text and cursor alpha channel values, thus behaving more consistently with the rest of Clutter.
2008-12-11 12:18:26 +00:00
real_opacity = clutter_actor_get_paint_opacity (self)
* priv->text_color.alpha
/ 255;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
CLUTTER_NOTE (PAINT, "painting text (text: '%s')",
clutter_text_buffer_get_text (get_buffer (text)));
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
Replace cogl_color_set_from_* with cogl_color_init_from_* The former is not yet "officially" deprecated by the latter, but it's confusing to have them both in the code base.
2010-09-03 15:55:12 +00:00
cogl_color_init_from_4ub (&color,
priv->text_color.red,
priv->text_color.green,
priv->text_color.blue,
real_opacity);
text: Use actor alignments when painting the layout ClutterActor's x-align and y-align properties should be used to control the alignment of the PangoLayout when painting it within a larger allocation, and the ClutterText has the x-expand or the y-expand flags set.
2012-06-07 15:14:21 +00:00
cogl_pango_render_layout (layout, priv->text_x, priv->text_y, &color, 0);
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
text: Check the has_focus flag in selection_paint() It is the only place were it is used, so it should only be checked there, and not in the general paint() implementation.
2011-05-13 13:26:22 +00:00
selection_paint (text);
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
if (clip_set)
Use the non-deprecated Cogl clipping API Cogl 1.18 deprecated the global clipping API in favour of the per-framebuffer one, but since we're using the 2.0 API internally we don't have access to the deprecated symbols any more. This is pretty much a mechanical port for all the places where we're still using the old 1.x API.
2013-12-03 12:12:52 +00:00
cogl_framebuffer_pop_clip (fb);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
}
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
static void
text: Make sure that the selection box is big enough Do not use integers to store the result of the PANGO_UNITS scaling to avoid rounding issues with the default C rules. We should use cielf() instead.
2011-07-10 09:24:40 +00:00
add_selection_to_paint_volume (ClutterText *text,
const ClutterActorBox *box,
gpointer user_data)
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
{
ClutterPaintVolume *total_volume = user_data;
ClutterPaintVolume rect_volume;
ClutterVertex vertex;
_clutter_paint_volume_init_static (&rect_volume, CLUTTER_ACTOR (text));
vertex.x = box->x1;
vertex.y = box->y1;
vertex.z = 0.0f;
clutter_paint_volume_set_origin (&rect_volume, &vertex);
clutter_paint_volume_set_width (&rect_volume, box->x2 - box->x1);
clutter_paint_volume_set_height (&rect_volume, box->y2 - box->y1);
clutter_paint_volume_union (total_volume, &rect_volume);
clutter_paint_volume_free (&rect_volume);
}
static void
clutter_text_get_paint_volume_for_cursor (ClutterText *text,
ClutterPaintVolume *volume)
{
ClutterTextPrivate *priv = text->priv;
ClutterVertex origin;
clutter_text_ensure_cursor_position (text);
if (priv->position == priv->selection_bound)
{
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
origin.x = priv->cursor_rect.origin.x;
origin.y = priv->cursor_rect.origin.y;
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
origin.z = 0;
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
clutter_paint_volume_set_origin (volume, &origin);
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
clutter_paint_volume_set_width (volume, priv->cursor_rect.size.width);
clutter_paint_volume_set_height (volume, priv->cursor_rect.size.height);
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
}
else
{
text: Make sure that the selection box is big enough Do not use integers to store the result of the PANGO_UNITS scaling to avoid rounding issues with the default C rules. We should use cielf() instead.
2011-07-10 09:24:40 +00:00
clutter_text_foreach_selection_rectangle (text,
add_selection_to_paint_volume,
volume);
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
}
}
actor: make default get_paint_volume more conservative There are too many examples where the default assumption that an actor paints inside its allocation isn't true, so we now return FALSE in the base implementation instead. This means that by default we are saying "we don't know the paint volume of the actor", so developers need to implement the get_paint_volume virtual to take advantage of culling and clipped redraws with their actors. This patch provides very conservative get_paint_volume implementations for ClutterTexture, ClutterCairoTexture, ClutterRectangle and ClutterText which all explicitly check the actor's object type to avoid making any assumptions about subclasses.
2010-09-08 18:47:11 +00:00
static gboolean
text: Update get_paint_volume() implementation In commit 9818eee4646e49e99beb5a43f1dafcbdcca41f94 I forgot to update ClutterText as well as the other actors.
2010-09-09 11:38:25 +00:00
clutter_text_get_paint_volume (ClutterActor *self,
actor: make default get_paint_volume more conservative There are too many examples where the default assumption that an actor paints inside its allocation isn't true, so we now return FALSE in the base implementation instead. This means that by default we are saying "we don't know the paint volume of the actor", so developers need to implement the get_paint_volume virtual to take advantage of culling and clipped redraws with their actors. This patch provides very conservative get_paint_volume implementations for ClutterTexture, ClutterCairoTexture, ClutterRectangle and ClutterText which all explicitly check the actor's object type to avoid making any assumptions about subclasses.
2010-09-08 18:47:11 +00:00
ClutterPaintVolume *volume)
{
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
ClutterText *text = CLUTTER_TEXT (self);
ClutterTextPrivate *priv = text->priv;
/* ClutterText uses the logical layout as the natural size of the
actor. This means that it can sometimes paint outside of its
allocation for example with italic fonts with serifs. Therefore
we should use the ink rectangle of the layout instead */
if (!priv->paint_volume_valid)
{
PangoLayout *layout;
PangoRectangle ink_rect;
ClutterVertex origin;
/* If the text is single line editable then it gets clipped to
the allocation anyway so we can just use that */
if (priv->editable && priv->single_line_mode)
return _clutter_actor_set_default_paint_volume (self,
CLUTTER_TYPE_TEXT,
volume);
if (G_OBJECT_TYPE (self) != CLUTTER_TYPE_TEXT)
return FALSE;
if (!clutter_actor_has_allocation (self))
return FALSE;
_clutter_paint_volume_init_static (&priv->paint_volume, self);
layout = clutter_text_get_layout (text);
pango_layout_get_extents (layout, &ink_rect, NULL);
origin.x = ink_rect.x / (float) PANGO_SCALE;
origin.y = ink_rect.y / (float) PANGO_SCALE;
origin.z = 0;
clutter_paint_volume_set_origin (&priv->paint_volume, &origin);
clutter_paint_volume_set_width (&priv->paint_volume,
ink_rect.width / (float) PANGO_SCALE);
clutter_paint_volume_set_height (&priv->paint_volume,
ink_rect.height / (float) PANGO_SCALE);
/* If the cursor is visible then that will likely be drawn
outside of the ink rectangle so we should merge that in */
text: Unify conditions for visible cursor We have a bunch of similar checks in various places, and they should all be coalesced into one.
2015-11-30 13:45:45 +00:00
if (clutter_text_should_draw_cursor (text))
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
{
ClutterPaintVolume cursor_paint_volume;
text: Unify conditions for visible cursor We have a bunch of similar checks in various places, and they should all be coalesced into one.
2015-11-30 13:45:45 +00:00
_clutter_paint_volume_init_static (&cursor_paint_volume, self);
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
clutter_text_get_paint_volume_for_cursor (text, &cursor_paint_volume);
clutter_paint_volume_union (&priv->paint_volume,
&cursor_paint_volume);
clutter_paint_volume_free (&cursor_paint_volume);
}
priv->paint_volume_valid = TRUE;
}
_clutter_paint_volume_copy_static (&priv->paint_volume, volume);
return TRUE;
actor: make default get_paint_volume more conservative There are too many examples where the default assumption that an actor paints inside its allocation isn't true, so we now return FALSE in the base implementation instead. This means that by default we are saying "we don't know the paint volume of the actor", so developers need to implement the get_paint_volume virtual to take advantage of culling and clipped redraws with their actors. This patch provides very conservative get_paint_volume implementations for ClutterTexture, ClutterCairoTexture, ClutterRectangle and ClutterText which all explicitly check the actor's object type to avoid making any assumptions about subclasses.
2010-09-08 18:47:11 +00:00
}
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
static void
clutter_text_get_preferred_width (ClutterActor *self,
Remove Units from the public API With the recent change to internal floating point values, ClutterUnit has become a redundant type, defined to be a float. All integer entry points are being internally converted to floating point values to be passed to the GL pipeline with the least amount of conversion. ClutterUnit is thus exposed as just a "pixel with fractionary bits", and not -- as users might think -- as generic, resolution and device independent units. not that it was the case, but a definitive amount of people was convinced it did provide this "feature", and was flummoxed about the mere existence of this type. So, having ClutterUnit exposed in the public API doubles the entry points and has the following disadvantages: - we have to maintain twice the amount of entry points in ClutterActor - we still do an integer-to-float implicit conversion - we introduce a weird impedance between pixels and "pixels with fractionary bits" - language bindings will have to choose what to bind, and resort to manually overriding the API + *except* for language bindings based on GObject-Introspection, as they cannot do manual overrides, thus will replicate the entire set of entry points For these reason, we should coalesces every Actor entry point for pixels and for ClutterUnit into a single entry point taking a float, like: void clutter_actor_set_x (ClutterActor *self, gfloat x); void clutter_actor_get_size (ClutterActor *self, gfloat *width, gfloat *height); gfloat clutter_actor_get_height (ClutterActor *self); etc. The issues I have identified are: - we'll have a two cases of compiler warnings: - printf() format of the return values from %d to %f - clutter_actor_get_size() taking floats instead of unsigned ints - we'll have a problem with varargs when passing an integer instead of a floating point value, except on 64bit platforms where the size of a float is the same as the size of an int To be clear: the *intent* of the API should not change -- we still use pixels everywhere -- but: - we remove ambiguity in the API with regard to pixels and units - we remove entry points we get to maintain for the whole 1.0 version of the API - we make things simpler to bind for both manual language bindings and automatic (gobject-introspection based) ones - we have the simplest API possible while still exposing the capabilities of the underlying GL implementation
2009-05-06 15:44:47 +00:00
gfloat for_height,
gfloat *min_width_p,
gfloat *natural_width_p)
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
{
ClutterText *text = CLUTTER_TEXT (self);
ClutterTextPrivate *priv = text->priv;
PangoRectangle logical_rect = { 0, };
PangoLayout *layout;
Use units in position_to_coords() We loose precision with a direct conversion for PangoUnits to pixels, so we should do the conversion as needed, inside the callers of clutter_text_position_to_coords().
2008-12-15 18:24:42 +00:00
gint logical_width;
Remove Units from the public API With the recent change to internal floating point values, ClutterUnit has become a redundant type, defined to be a float. All integer entry points are being internally converted to floating point values to be passed to the GL pipeline with the least amount of conversion. ClutterUnit is thus exposed as just a "pixel with fractionary bits", and not -- as users might think -- as generic, resolution and device independent units. not that it was the case, but a definitive amount of people was convinced it did provide this "feature", and was flummoxed about the mere existence of this type. So, having ClutterUnit exposed in the public API doubles the entry points and has the following disadvantages: - we have to maintain twice the amount of entry points in ClutterActor - we still do an integer-to-float implicit conversion - we introduce a weird impedance between pixels and "pixels with fractionary bits" - language bindings will have to choose what to bind, and resort to manually overriding the API + *except* for language bindings based on GObject-Introspection, as they cannot do manual overrides, thus will replicate the entire set of entry points For these reason, we should coalesces every Actor entry point for pixels and for ClutterUnit into a single entry point taking a float, like: void clutter_actor_set_x (ClutterActor *self, gfloat x); void clutter_actor_get_size (ClutterActor *self, gfloat *width, gfloat *height); gfloat clutter_actor_get_height (ClutterActor *self); etc. The issues I have identified are: - we'll have a two cases of compiler warnings: - printf() format of the return values from %d to %f - clutter_actor_get_size() taking floats instead of unsigned ints - we'll have a problem with varargs when passing an integer instead of a floating point value, except on 64bit platforms where the size of a float is the same as the size of an int To be clear: the *intent* of the API should not change -- we still use pixels everywhere -- but: - we remove ambiguity in the API with regard to pixels and units - we remove entry points we get to maintain for the whole 1.0 version of the API - we make things simpler to bind for both manual language bindings and automatic (gobject-introspection based) ones - we have the simplest API possible while still exposing the capabilities of the underlying GL implementation
2009-05-06 15:44:47 +00:00
gfloat layout_width;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
Support pango_layout_set_height() in ClutterText This is the port of the patch attached to bug 1266: ClutterLabel support for pango_layout_set_height() to the ClutterText actor. This patch adds support for the pango_layout_set_height() function inside the layout creation and caching, so that setting the height of a ClutterText will make PangoLayout try to fill out the given height before ellipsizing the contents of the ClutterText actor. The original patch is from Havoc Pennington. This commit ports the patch to ClutterText and applies a small change to the height computation pointed out by Behdad Esfahbod on GNOME's Bugzilla: http://bugzilla.gnome.org/show_bug.cgi?id=560931 That the layout heights when doing a size request should be set to be G_MAXINT instead of -1. Unfortunately, the patch seems to break the conformance suite when setting the ellipsization on the layout.
2008-12-16 14:02:05 +00:00
layout = clutter_text_create_layout (text, -1, -1);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
pango_layout_get_extents (layout, NULL, &logical_rect);
Use units in position_to_coords() We loose precision with a direct conversion for PangoUnits to pixels, so we should do the conversion as needed, inside the callers of clutter_text_position_to_coords().
2008-12-15 18:24:42 +00:00
/* the X coordinate of the logical rectangle might be non-zero
* according to the Pango documentation; hence, we need to offset
* the width accordingly
*/
logical_width = logical_rect.x + logical_rect.width;
layout_width = logical_width > 0
text: Round up the size Converting from Pango units to pixels by using the C conventions might cause us to lose a pixel; since we're doing the same for the height, we should use ceilf() to round up the width and the line height. http://bugzilla.clutter-project.org/show_bug.cgi?id=2573
2011-02-21 17:13:37 +00:00
? ceilf (logical_width / 1024.0f)
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
: 1;
if (min_width_p)
{
[ClutterText] Return 1 for min width when editable Editable ClutterText will scroll when allocated less width than is necessary to lay out the entire layout on a single line, so return 1 for the minimum width in this case. Approved by Emmanuele Bassi, fixes bug #1555.
2009-04-16 15:34:15 +00:00
if (priv->wrap || priv->ellipsize || priv->editable)
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
*min_width_p = 1;
else
*min_width_p = layout_width;
}
if (natural_width_p)
[text] take text padding into account when in single line mode In single line mode, extra padding is added to the text which must be taken into account when reporting the natural size of the actor.
2009-05-14 08:53:41 +00:00
{
if (priv->editable && priv->single_line_mode)
*natural_width_p = layout_width + TEXT_PADDING * 2;
else
*natural_width_p = layout_width;
}
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
}
static void
clutter_text_get_preferred_height (ClutterActor *self,
Remove Units from the public API With the recent change to internal floating point values, ClutterUnit has become a redundant type, defined to be a float. All integer entry points are being internally converted to floating point values to be passed to the GL pipeline with the least amount of conversion. ClutterUnit is thus exposed as just a "pixel with fractionary bits", and not -- as users might think -- as generic, resolution and device independent units. not that it was the case, but a definitive amount of people was convinced it did provide this "feature", and was flummoxed about the mere existence of this type. So, having ClutterUnit exposed in the public API doubles the entry points and has the following disadvantages: - we have to maintain twice the amount of entry points in ClutterActor - we still do an integer-to-float implicit conversion - we introduce a weird impedance between pixels and "pixels with fractionary bits" - language bindings will have to choose what to bind, and resort to manually overriding the API + *except* for language bindings based on GObject-Introspection, as they cannot do manual overrides, thus will replicate the entire set of entry points For these reason, we should coalesces every Actor entry point for pixels and for ClutterUnit into a single entry point taking a float, like: void clutter_actor_set_x (ClutterActor *self, gfloat x); void clutter_actor_get_size (ClutterActor *self, gfloat *width, gfloat *height); gfloat clutter_actor_get_height (ClutterActor *self); etc. The issues I have identified are: - we'll have a two cases of compiler warnings: - printf() format of the return values from %d to %f - clutter_actor_get_size() taking floats instead of unsigned ints - we'll have a problem with varargs when passing an integer instead of a floating point value, except on 64bit platforms where the size of a float is the same as the size of an int To be clear: the *intent* of the API should not change -- we still use pixels everywhere -- but: - we remove ambiguity in the API with regard to pixels and units - we remove entry points we get to maintain for the whole 1.0 version of the API - we make things simpler to bind for both manual language bindings and automatic (gobject-introspection based) ones - we have the simplest API possible while still exposing the capabilities of the underlying GL implementation
2009-05-06 15:44:47 +00:00
gfloat for_width,
gfloat *min_height_p,
gfloat *natural_height_p)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
[text] Return the correct minimum height If text is set, ClutterText should never return less than the layout height for minimum and preferred heights. This holds unless ellipsize and wrap are enabled, in which case the minimum height should be the height of the first line -- which is the height needed to at the very least show the ellipsization. Based on a patch by: Thomas Wood <thomas@openedhand.com> Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1598 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-05-13 22:04:25 +00:00
ClutterTextPrivate *priv = CLUTTER_TEXT (self)->priv;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
if (for_width == 0)
{
if (min_height_p)
*min_height_p = 0;
if (natural_height_p)
*natural_height_p = 0;
}
else
{
PangoLayout *layout;
PangoRectangle logical_rect = { 0, };
Use units in position_to_coords() We loose precision with a direct conversion for PangoUnits to pixels, so we should do the conversion as needed, inside the callers of clutter_text_position_to_coords().
2008-12-15 18:24:42 +00:00
gint logical_height;
Remove Units from the public API With the recent change to internal floating point values, ClutterUnit has become a redundant type, defined to be a float. All integer entry points are being internally converted to floating point values to be passed to the GL pipeline with the least amount of conversion. ClutterUnit is thus exposed as just a "pixel with fractionary bits", and not -- as users might think -- as generic, resolution and device independent units. not that it was the case, but a definitive amount of people was convinced it did provide this "feature", and was flummoxed about the mere existence of this type. So, having ClutterUnit exposed in the public API doubles the entry points and has the following disadvantages: - we have to maintain twice the amount of entry points in ClutterActor - we still do an integer-to-float implicit conversion - we introduce a weird impedance between pixels and "pixels with fractionary bits" - language bindings will have to choose what to bind, and resort to manually overriding the API + *except* for language bindings based on GObject-Introspection, as they cannot do manual overrides, thus will replicate the entire set of entry points For these reason, we should coalesces every Actor entry point for pixels and for ClutterUnit into a single entry point taking a float, like: void clutter_actor_set_x (ClutterActor *self, gfloat x); void clutter_actor_get_size (ClutterActor *self, gfloat *width, gfloat *height); gfloat clutter_actor_get_height (ClutterActor *self); etc. The issues I have identified are: - we'll have a two cases of compiler warnings: - printf() format of the return values from %d to %f - clutter_actor_get_size() taking floats instead of unsigned ints - we'll have a problem with varargs when passing an integer instead of a floating point value, except on 64bit platforms where the size of a float is the same as the size of an int To be clear: the *intent* of the API should not change -- we still use pixels everywhere -- but: - we remove ambiguity in the API with regard to pixels and units - we remove entry points we get to maintain for the whole 1.0 version of the API - we make things simpler to bind for both manual language bindings and automatic (gobject-introspection based) ones - we have the simplest API possible while still exposing the capabilities of the underlying GL implementation
2009-05-06 15:44:47 +00:00
gfloat layout_height;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Optimise get_preferred_height for single-line-mode Don't calculate an extra layout in clutter_text_get_preferred_height for single-line strings, when it's unnecessary. There's no need to set the width of a layout when in single-line mode, as wrapping will not happen.
2010-11-25 15:11:42 +00:00
if (priv->single_line_mode)
for_width = -1;
[text] Return the correct minimum height If text is set, ClutterText should never return less than the layout height for minimum and preferred heights. This holds unless ellipsize and wrap are enabled, in which case the minimum height should be the height of the first line -- which is the height needed to at the very least show the ellipsization. Based on a patch by: Thomas Wood <thomas@openedhand.com> Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1598 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-05-13 22:04:25 +00:00
layout = clutter_text_create_layout (CLUTTER_TEXT (self),
for_width, -1);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
pango_layout_get_extents (layout, NULL, &logical_rect);
Use units in position_to_coords() We loose precision with a direct conversion for PangoUnits to pixels, so we should do the conversion as needed, inside the callers of clutter_text_position_to_coords().
2008-12-15 18:24:42 +00:00
/* the Y coordinate of the logical rectangle might be non-zero
* according to the Pango documentation; hence, we need to offset
* the height accordingly
*/
logical_height = logical_rect.y + logical_rect.height;
text: Round up the size Converting from Pango units to pixels by using the C conventions might cause us to lose a pixel; since we're doing the same for the height, we should use ceilf() to round up the width and the line height. http://bugzilla.clutter-project.org/show_bug.cgi?id=2573
2011-02-21 17:13:37 +00:00
layout_height = ceilf (logical_height / 1024.0f);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
if (min_height_p)
Support pango_layout_set_height() in ClutterText This is the port of the patch attached to bug 1266: ClutterLabel support for pango_layout_set_height() to the ClutterText actor. This patch adds support for the pango_layout_set_height() function inside the layout creation and caching, so that setting the height of a ClutterText will make PangoLayout try to fill out the given height before ellipsizing the contents of the ClutterText actor. The original patch is from Havoc Pennington. This commit ports the patch to ClutterText and applies a small change to the height computation pointed out by Behdad Esfahbod on GNOME's Bugzilla: http://bugzilla.gnome.org/show_bug.cgi?id=560931 That the layout heights when doing a size request should be set to be G_MAXINT instead of -1. Unfortunately, the patch seems to break the conformance suite when setting the ellipsization on the layout.
2008-12-16 14:02:05 +00:00
{
[text] Return the correct minimum height If text is set, ClutterText should never return less than the layout height for minimum and preferred heights. This holds unless ellipsize and wrap are enabled, in which case the minimum height should be the height of the first line -- which is the height needed to at the very least show the ellipsization. Based on a patch by: Thomas Wood <thomas@openedhand.com> Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1598 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-05-13 22:04:25 +00:00
/* if we wrap and ellipsize then the minimum height is
* going to be at least the size of the first line
*/
text: Optimise get_preferred_height for single-line-mode Don't calculate an extra layout in clutter_text_get_preferred_height for single-line strings, when it's unnecessary. There's no need to set the width of a layout when in single-line mode, as wrapping will not happen.
2010-11-25 15:11:42 +00:00
if ((priv->ellipsize && priv->wrap) && !priv->single_line_mode)
[text] Return the correct minimum height If text is set, ClutterText should never return less than the layout height for minimum and preferred heights. This holds unless ellipsize and wrap are enabled, in which case the minimum height should be the height of the first line -- which is the height needed to at the very least show the ellipsization. Based on a patch by: Thomas Wood <thomas@openedhand.com> Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1598 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-05-13 22:04:25 +00:00
{
PangoLayoutLine *line;
Remove usage of Units and macros The ClutterUnit and relative macros should not be used when dealing with pixels -- which is to say, all the time when inside Clutter.
2009-06-02 17:44:30 +00:00
gfloat line_height;
[text] Return the correct minimum height If text is set, ClutterText should never return less than the layout height for minimum and preferred heights. This holds unless ellipsize and wrap are enabled, in which case the minimum height should be the height of the first line -- which is the height needed to at the very least show the ellipsization. Based on a patch by: Thomas Wood <thomas@openedhand.com> Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1598 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-05-13 22:04:25 +00:00
line = pango_layout_get_line_readonly (layout, 0);
pango_layout_line_get_extents (line, NULL, &logical_rect);
logical_height = logical_rect.y + logical_rect.height;
text: Round up the size Converting from Pango units to pixels by using the C conventions might cause us to lose a pixel; since we're doing the same for the height, we should use ceilf() to round up the width and the line height. http://bugzilla.clutter-project.org/show_bug.cgi?id=2573
2011-02-21 17:13:37 +00:00
line_height = ceilf (logical_height / 1024.0f);
[text] Return the correct minimum height If text is set, ClutterText should never return less than the layout height for minimum and preferred heights. This holds unless ellipsize and wrap are enabled, in which case the minimum height should be the height of the first line -- which is the height needed to at the very least show the ellipsization. Based on a patch by: Thomas Wood <thomas@openedhand.com> Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1598 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-05-13 22:04:25 +00:00
*min_height_p = line_height;
}
Support pango_layout_set_height() in ClutterText This is the port of the patch attached to bug 1266: ClutterLabel support for pango_layout_set_height() to the ClutterText actor. This patch adds support for the pango_layout_set_height() function inside the layout creation and caching, so that setting the height of a ClutterText will make PangoLayout try to fill out the given height before ellipsizing the contents of the ClutterText actor. The original patch is from Havoc Pennington. This commit ports the patch to ClutterText and applies a small change to the height computation pointed out by Behdad Esfahbod on GNOME's Bugzilla: http://bugzilla.gnome.org/show_bug.cgi?id=560931 That the layout heights when doing a size request should be set to be G_MAXINT instead of -1. Unfortunately, the patch seems to break the conformance suite when setting the ellipsization on the layout.
2008-12-16 14:02:05 +00:00
else
*min_height_p = layout_height;
}
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
if (natural_height_p)
Use units in position_to_coords() We loose precision with a direct conversion for PangoUnits to pixels, so we should do the conversion as needed, inside the callers of clutter_text_position_to_coords().
2008-12-15 18:24:42 +00:00
*natural_height_p = layout_height;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
}
}
static void
[actor] Use flags to control allocations Instead of passing a boolean value, the ::allocate virtual function should use a bitmask and flags. This gives us room for expansion without breaking API/ABI, and allows to encode more information to the allocation process instead of just changes of absolute origin.
2009-06-03 13:02:06 +00:00
clutter_text_allocate (ClutterActor *self,
const ClutterActorBox *box,
ClutterAllocationFlags flags)
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
{
ClutterText *text = CLUTTER_TEXT (self);
ClutterActorClass *parent_class;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
/* Ensure that there is a cached layout with the right width so
* that we don't need to create the text during the paint run
text: Layouts for single-line-mode entries are boundless A PangoLayout for an editable, single-line text entry is by definition without a given width, since the actor will be clipped when being drawn.
2010-07-09 17:37:34 +00:00
*
* if the Text is editable and in single line mode we don't want
* to have any limit on the layout size, since the paint will clip
* it to the allocation of the actor
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
*/
text: Layouts for single-line-mode entries are boundless A PangoLayout for an editable, single-line text entry is by definition without a given width, since the actor will be clipped when being drawn.
2010-07-09 17:37:34 +00:00
if (text->priv->editable && text->priv->single_line_mode)
clutter_text_create_layout (text, -1, -1);
else
clutter_text_create_layout (text,
box->x2 - box->x1,
box->y2 - box->y1);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
parent_class = CLUTTER_ACTOR_CLASS (clutter_text_parent_class);
[actor] Use flags to control allocations Instead of passing a boolean value, the ::allocate virtual function should use a bitmask and flags. This gives us room for expansion without breaking API/ABI, and allows to encode more information to the allocation process instead of just changes of absolute origin.
2009-06-03 13:02:06 +00:00
parent_class->allocate (self, box, flags);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
}
text: Implement the ::has_overlaps virtual Since ClutterText has overlapping primitives when selecting, or a visible cursor, then we need to report that to Clutter, to avoid bleeding colors through when a Text actor is non-fully opaque.
2011-05-13 13:17:39 +00:00
static gboolean
clutter_text_has_overlaps (ClutterActor *self)
{
text: Allow selectability without editability Being able to select text and being able to edit text are two separate capabilities, but ClutterText only allows the former with the latter. The ClutterText:selectable property is set to TRUE by default, given that it depends on the :editable property; this implies that all ClutterText instances now are going to show a cursor as soon as they get key focused. Obviously, this would make labels look a bit off — but if you have a label then you would not give it key focus, either by explicitly calling clutter_actor_grab_focus(), or by setting it as reactive and allowing it to be clicked. If this turns out to be a problem, we have various ways to avoid showing a cursor — for instance, we could change the default value of the selectable property, and ensure that setting the :editable property to TRUE would also set the :selectable property as a side effect. Or we could hide the cursor until the first button/touch press event. Finally, we could always back this commit out if it proves to be too much of a breakage for existing code bases. https://bugzilla.gnome.org/show_bug.cgi?id=757470
2015-11-02 12:34:39 +00:00
return clutter_text_should_draw_cursor ((ClutterText *) self);
text: Implement the ::has_overlaps virtual Since ClutterText has overlapping primitives when selecting, or a visible cursor, then we need to report that to Clutter, to avoid bleeding colors through when a Text actor is non-fully opaque.
2011-05-13 13:17:39 +00:00
}
text: Only paint cursor if we have key focus If a Text actor does not have key focus then there's no point in showing the cursor at all.
2010-12-21 10:50:24 +00:00
static void
clutter_text_key_focus_in (ClutterActor *actor)
{
ClutterTextPrivate *priv = CLUTTER_TEXT (actor)->priv;
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
ClutterBackend *backend = clutter_get_default_backend ();
ClutterInputMethod *method = clutter_backend_get_input_method (backend);
if (method && priv->editable)
clutter_input_method_focus_in (method, priv->input_focus);
text: Only paint cursor if we have key focus If a Text actor does not have key focus then there's no point in showing the cursor at all.
2010-12-21 10:50:24 +00:00
priv->has_focus = TRUE;
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
clutter_text_queue_redraw (actor);
text: Only paint cursor if we have key focus If a Text actor does not have key focus then there's no point in showing the cursor at all.
2010-12-21 10:50:24 +00:00
}
static void
clutter_text_key_focus_out (ClutterActor *actor)
{
ClutterTextPrivate *priv = CLUTTER_TEXT (actor)->priv;
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
ClutterBackend *backend = clutter_get_default_backend ();
ClutterInputMethod *method = clutter_backend_get_input_method (backend);
text: Only paint cursor if we have key focus If a Text actor does not have key focus then there's no point in showing the cursor at all.
2010-12-21 10:50:24 +00:00
priv->has_focus = FALSE;
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
if (priv->editable && clutter_input_focus_is_focused (priv->input_focus))
clutter_input_method_focus_out (method);
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
clutter_text_queue_redraw (actor);
text: Only paint cursor if we have key focus If a Text actor does not have key focus then there's no point in showing the cursor at all.
2010-12-21 10:50:24 +00:00
}
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
static gboolean
clutter_text_real_move_left (ClutterText *self,
const gchar *action,
guint keyval,
ClutterModifierType modifiers)
{
ClutterTextPrivate *priv = self->priv;
gint pos = priv->position;
[text] Allow key navigation by word When pressing Ctrl with the left and right arrow keys we should skip to (or select until) the previous and next word, respectively. Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1713
2009-07-23 18:04:27 +00:00
gint new_pos = 0;
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
gint len;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
len = clutter_text_buffer_get_length (get_buffer (self));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
g_object_freeze_notify (G_OBJECT (self));
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
if (pos != 0 && len != 0)
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
{
[text] Allow key navigation by word When pressing Ctrl with the left and right arrow keys we should skip to (or select until) the previous and next word, respectively. Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1713
2009-07-23 18:04:27 +00:00
if (modifiers & CLUTTER_CONTROL_MASK)
{
if (pos == -1)
[text] move_word_backward/forward fixes clutter_text_move_word_backward/forward() calls did not use the start argument consistently. Also, clutter_text_move_word_forward() bound check checked the wrong end. Fixes #1765 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-08-16 21:00:35 +00:00
new_pos = clutter_text_move_word_backward (self, len);
[text] Allow key navigation by word When pressing Ctrl with the left and right arrow keys we should skip to (or select until) the previous and next word, respectively. Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1713
2009-07-23 18:04:27 +00:00
else
[text] move_word_backward/forward fixes clutter_text_move_word_backward/forward() calls did not use the start argument consistently. Also, clutter_text_move_word_forward() bound check checked the wrong end. Fixes #1765 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-08-16 21:00:35 +00:00
new_pos = clutter_text_move_word_backward (self, pos);
[text] Allow key navigation by word When pressing Ctrl with the left and right arrow keys we should skip to (or select until) the previous and next word, respectively. Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1713
2009-07-23 18:04:27 +00:00
}
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
else
[text] Allow key navigation by word When pressing Ctrl with the left and right arrow keys we should skip to (or select until) the previous and next word, respectively. Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1713
2009-07-23 18:04:27 +00:00
{
if (pos == -1)
new_pos = len - 1;
else
new_pos = pos - 1;
}
clutter_text_set_cursor_position (self, new_pos);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
}
if (!(priv->selectable && (modifiers & CLUTTER_SHIFT_MASK)))
clutter_text_clear_selection (self);
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
g_object_thaw_notify (G_OBJECT (self));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
return TRUE;
}
static gboolean
clutter_text_real_move_right (ClutterText *self,
const gchar *action,
guint keyval,
ClutterModifierType modifiers)
{
ClutterTextPrivate *priv = self->priv;
gint pos = priv->position;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
gint len = clutter_text_buffer_get_length (get_buffer (self));
Fix some compiler warnings GCC complains that some variable might be used uninitialized.
2010-02-09 16:57:14 +00:00
gint new_pos = 0;
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
g_object_freeze_notify (G_OBJECT (self));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
if (pos != -1 && len !=0)
{
[text] Allow key navigation by word When pressing Ctrl with the left and right arrow keys we should skip to (or select until) the previous and next word, respectively. Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1713
2009-07-23 18:04:27 +00:00
if (modifiers & CLUTTER_CONTROL_MASK)
{
if (pos != len)
[text] move_word_backward/forward fixes clutter_text_move_word_backward/forward() calls did not use the start argument consistently. Also, clutter_text_move_word_forward() bound check checked the wrong end. Fixes #1765 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-08-16 21:00:35 +00:00
new_pos = clutter_text_move_word_forward (self, pos);
[text] Allow key navigation by word When pressing Ctrl with the left and right arrow keys we should skip to (or select until) the previous and next word, respectively. Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1713
2009-07-23 18:04:27 +00:00
}
else
{
if (pos != len)
new_pos = pos + 1;
}
clutter_text_set_cursor_position (self, new_pos);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
}
if (!(priv->selectable && (modifiers & CLUTTER_SHIFT_MASK)))
clutter_text_clear_selection (self);
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
g_object_thaw_notify (G_OBJECT (self));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
return TRUE;
}
static gboolean
clutter_text_real_move_up (ClutterText *self,
const gchar *action,
guint keyval,
ClutterModifierType modifiers)
{
ClutterTextPrivate *priv = self->priv;
PangoLayoutLine *layout_line;
PangoLayout *layout;
gint line_no;
[clutter-text] Fix x-position of cursor when moving up or down ClutterText already has code to try to preserve the x position when moving up or down. A target x-position is stored and the cursor is positioned at the nearest point to that in the appropriate line when up or down is pressed. However the target position was never cleared so it would always target the x-position of the cursor from the first time you pressed up or down. To fix this the patch clears the target position in set_position and then sets it after the call in real_move_up/down. That way pressing up or down sets the target position and any other movement will clear it. To get an index for the pixel position in the line pango_layout_line_x_to_index is used. However when x is greater than the length of the line then the index before the last grapheme is returned which was causing it to jump to the penultimate character. The patch makes it add on the trailing value so that it will jump to the last character.
2009-01-14 11:12:02 +00:00
gint index_, trailing;
text: Fixes for selection bound The commit ecbb7ce41a1a759e246fce07f146b8bed5e3d730 exposed some issues when positioning the cursor with the mouse pointer: the selection is not moved along with the cursor when inserting a single character or a string. Also, some freeze_notify() are called too early, leading to decoupling from their respective thaw_notify(). http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-02-02 17:07:22 +00:00
gint pos;
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
gint x;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
const gchar *text;
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
layout = clutter_text_get_layout (self);
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
text = clutter_text_buffer_get_text (get_buffer (self));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
Fix up/down key navigation The behaviour of ClutterText around the initial position is still a little bit erratic. This commit fixes the key navigation with Up and Down arrows around the first line of text.
2008-12-15 18:46:08 +00:00
if (priv->position == 0)
index_ = 0;
else
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
index_ = offset_to_bytes (text, priv->position);
Fix up/down key navigation The behaviour of ClutterText around the initial position is still a little bit erratic. This commit fixes the key navigation with Up and Down arrows around the first line of text.
2008-12-15 18:46:08 +00:00
pango_layout_index_to_line_x (layout, index_,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
0,
&line_no, &x);
Fix up/down key navigation The behaviour of ClutterText around the initial position is still a little bit erratic. This commit fixes the key navigation with Up and Down arrows around the first line of text.
2008-12-15 18:46:08 +00:00
line_no -= 1;
if (line_no < 0)
return FALSE;
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
if (priv->x_pos != -1)
x = priv->x_pos;
layout_line = pango_layout_get_line_readonly (layout, line_no);
if (!layout_line)
return FALSE;
[clutter-text] Fix x-position of cursor when moving up or down ClutterText already has code to try to preserve the x position when moving up or down. A target x-position is stored and the cursor is positioned at the nearest point to that in the appropriate line when up or down is pressed. However the target position was never cleared so it would always target the x-position of the cursor from the first time you pressed up or down. To fix this the patch clears the target position in set_position and then sets it after the call in real_move_up/down. That way pressing up or down sets the target position and any other movement will clear it. To get an index for the pixel position in the line pango_layout_line_x_to_index is used. However when x is greater than the length of the line then the index before the last grapheme is returned which was causing it to jump to the penultimate character. The patch makes it add on the trailing value so that it will jump to the last character.
2009-01-14 11:12:02 +00:00
pango_layout_line_x_to_index (layout_line, x, &index_, &trailing);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
text: Fixes for selection bound The commit ecbb7ce41a1a759e246fce07f146b8bed5e3d730 exposed some issues when positioning the cursor with the mouse pointer: the selection is not moved along with the cursor when inserting a single character or a string. Also, some freeze_notify() are called too early, leading to decoupling from their respective thaw_notify(). http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-02-02 17:07:22 +00:00
g_object_freeze_notify (G_OBJECT (self));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
pos = bytes_to_offset (text, index_);
text: Fixes for selection bound The commit ecbb7ce41a1a759e246fce07f146b8bed5e3d730 exposed some issues when positioning the cursor with the mouse pointer: the selection is not moved along with the cursor when inserting a single character or a string. Also, some freeze_notify() are called too early, leading to decoupling from their respective thaw_notify(). http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-02-02 17:07:22 +00:00
clutter_text_set_cursor_position (self, pos + trailing);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
[clutter-text] Fix x-position of cursor when moving up or down ClutterText already has code to try to preserve the x position when moving up or down. A target x-position is stored and the cursor is positioned at the nearest point to that in the appropriate line when up or down is pressed. However the target position was never cleared so it would always target the x-position of the cursor from the first time you pressed up or down. To fix this the patch clears the target position in set_position and then sets it after the call in real_move_up/down. That way pressing up or down sets the target position and any other movement will clear it. To get an index for the pixel position in the line pango_layout_line_x_to_index is used. However when x is greater than the length of the line then the index before the last grapheme is returned which was causing it to jump to the penultimate character. The patch makes it add on the trailing value so that it will jump to the last character.
2009-01-14 11:12:02 +00:00
/* Store the target x position to avoid drifting left and right when
moving the cursor up and down */
priv->x_pos = x;
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
if (!(priv->selectable && (modifiers & CLUTTER_SHIFT_MASK)))
clutter_text_clear_selection (self);
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
g_object_thaw_notify (G_OBJECT (self));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
return TRUE;
}
static gboolean
clutter_text_real_move_down (ClutterText *self,
const gchar *action,
guint keyval,
ClutterModifierType modifiers)
{
ClutterTextPrivate *priv = self->priv;
PangoLayoutLine *layout_line;
PangoLayout *layout;
gint line_no;
[clutter-text] Fix x-position of cursor when moving up or down ClutterText already has code to try to preserve the x position when moving up or down. A target x-position is stored and the cursor is positioned at the nearest point to that in the appropriate line when up or down is pressed. However the target position was never cleared so it would always target the x-position of the cursor from the first time you pressed up or down. To fix this the patch clears the target position in set_position and then sets it after the call in real_move_up/down. That way pressing up or down sets the target position and any other movement will clear it. To get an index for the pixel position in the line pango_layout_line_x_to_index is used. However when x is greater than the length of the line then the index before the last grapheme is returned which was causing it to jump to the penultimate character. The patch makes it add on the trailing value so that it will jump to the last character.
2009-01-14 11:12:02 +00:00
gint index_, trailing;
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
gint x;
text: Fixes for selection bound The commit ecbb7ce41a1a759e246fce07f146b8bed5e3d730 exposed some issues when positioning the cursor with the mouse pointer: the selection is not moved along with the cursor when inserting a single character or a string. Also, some freeze_notify() are called too early, leading to decoupling from their respective thaw_notify(). http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-02-02 17:07:22 +00:00
gint pos;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
const gchar *text;
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
layout = clutter_text_get_layout (self);
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
text = clutter_text_buffer_get_text (get_buffer (self));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
Fix up/down key navigation The behaviour of ClutterText around the initial position is still a little bit erratic. This commit fixes the key navigation with Up and Down arrows around the first line of text.
2008-12-15 18:46:08 +00:00
if (priv->position == 0)
index_ = 0;
else
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
index_ = offset_to_bytes (text, priv->position);
Fix up/down key navigation The behaviour of ClutterText around the initial position is still a little bit erratic. This commit fixes the key navigation with Up and Down arrows around the first line of text.
2008-12-15 18:46:08 +00:00
pango_layout_index_to_line_x (layout, index_,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
0,
&line_no, &x);
if (priv->x_pos != -1)
x = priv->x_pos;
layout_line = pango_layout_get_line_readonly (layout, line_no + 1);
if (!layout_line)
return FALSE;
[clutter-text] Fix x-position of cursor when moving up or down ClutterText already has code to try to preserve the x position when moving up or down. A target x-position is stored and the cursor is positioned at the nearest point to that in the appropriate line when up or down is pressed. However the target position was never cleared so it would always target the x-position of the cursor from the first time you pressed up or down. To fix this the patch clears the target position in set_position and then sets it after the call in real_move_up/down. That way pressing up or down sets the target position and any other movement will clear it. To get an index for the pixel position in the line pango_layout_line_x_to_index is used. However when x is greater than the length of the line then the index before the last grapheme is returned which was causing it to jump to the penultimate character. The patch makes it add on the trailing value so that it will jump to the last character.
2009-01-14 11:12:02 +00:00
pango_layout_line_x_to_index (layout_line, x, &index_, &trailing);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
text: Fixes for selection bound The commit ecbb7ce41a1a759e246fce07f146b8bed5e3d730 exposed some issues when positioning the cursor with the mouse pointer: the selection is not moved along with the cursor when inserting a single character or a string. Also, some freeze_notify() are called too early, leading to decoupling from their respective thaw_notify(). http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-02-02 17:07:22 +00:00
g_object_freeze_notify (G_OBJECT (self));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
pos = bytes_to_offset (text, index_);
text: Fixes for selection bound The commit ecbb7ce41a1a759e246fce07f146b8bed5e3d730 exposed some issues when positioning the cursor with the mouse pointer: the selection is not moved along with the cursor when inserting a single character or a string. Also, some freeze_notify() are called too early, leading to decoupling from their respective thaw_notify(). http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-02-02 17:07:22 +00:00
clutter_text_set_cursor_position (self, pos + trailing);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
[clutter-text] Fix x-position of cursor when moving up or down ClutterText already has code to try to preserve the x position when moving up or down. A target x-position is stored and the cursor is positioned at the nearest point to that in the appropriate line when up or down is pressed. However the target position was never cleared so it would always target the x-position of the cursor from the first time you pressed up or down. To fix this the patch clears the target position in set_position and then sets it after the call in real_move_up/down. That way pressing up or down sets the target position and any other movement will clear it. To get an index for the pixel position in the line pango_layout_line_x_to_index is used. However when x is greater than the length of the line then the index before the last grapheme is returned which was causing it to jump to the penultimate character. The patch makes it add on the trailing value so that it will jump to the last character.
2009-01-14 11:12:02 +00:00
/* Store the target x position to avoid drifting left and right when
moving the cursor up and down */
priv->x_pos = x;
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
if (!(priv->selectable && (modifiers & CLUTTER_SHIFT_MASK)))
clutter_text_clear_selection (self);
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
g_object_thaw_notify (G_OBJECT (self));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
return TRUE;
}
static gboolean
clutter_text_real_line_start (ClutterText *self,
const gchar *action,
guint keyval,
ClutterModifierType modifiers)
{
ClutterTextPrivate *priv = self->priv;
gint position;
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
g_object_freeze_notify (G_OBJECT (self));
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
position = clutter_text_move_line_start (self, priv->position);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
clutter_text_set_cursor_position (self, position);
if (!(priv->selectable && (modifiers & CLUTTER_SHIFT_MASK)))
clutter_text_clear_selection (self);
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
g_object_thaw_notify (G_OBJECT (self));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
return TRUE;
}
static gboolean
clutter_text_real_line_end (ClutterText *self,
const gchar *action,
guint keyval,
ClutterModifierType modifiers)
{
ClutterTextPrivate *priv = self->priv;
gint position;
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
g_object_freeze_notify (G_OBJECT (self));
[text] Different selection modes with multiple clicks ClutterText should offer multiple selection modes depending on the number of pointer clicks. Following the GTK+ conventions: - double click selects the current word - triple click selects the current line
2009-03-30 15:46:57 +00:00
position = clutter_text_move_line_end (self, priv->position);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
clutter_text_set_cursor_position (self, position);
if (!(priv->selectable && (modifiers & CLUTTER_SHIFT_MASK)))
clutter_text_clear_selection (self);
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
g_object_thaw_notify (G_OBJECT (self));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
return TRUE;
}
[text] Add select-all binding Bind Ctrl+A to the "select all" action.
2009-01-05 12:27:45 +00:00
static gboolean
clutter_text_real_select_all (ClutterText *self,
const gchar *action,
guint keyval,
ClutterModifierType modifiers)
{
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
guint n_chars = clutter_text_buffer_get_length (get_buffer (self));
clutter_text_set_positions (self, 0, n_chars);
[text] Add select-all binding Bind Ctrl+A to the "select all" action.
2009-01-05 12:27:45 +00:00
return TRUE;
}
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
static gboolean
clutter_text_real_del_next (ClutterText *self,
const gchar *action,
guint keyval,
ClutterModifierType modifiers)
{
ClutterTextPrivate *priv = self->priv;
gint pos;
gint len;
[text] Add ClutterText::delete_selection() Add a method for deleting the current selection inside a Text actor. This is useful for subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:08:25 +00:00
if (clutter_text_delete_selection (self))
Change the binding propagation when truncating a selection If a selection has been truncated inside a key binding handler, we should just return and let the usual key event handler continue. This fixes the case where we deleted a selection using the Delete or the Backspace keys.
2008-12-11 12:08:20 +00:00
return TRUE;
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
pos = priv->position;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
len = clutter_text_buffer_get_length (get_buffer (self));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
if (len && pos != -1 && pos < len)
[text] Fix the deletion actions When using the delete-prev action from the end of the text we end up either missing the first glyph we have to delete or falling through the last one in the text. This commit fixes both issues.
2009-01-06 20:54:20 +00:00
clutter_text_delete_text (self, pos, pos + 1);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
[text] Fix the deletion actions When using the delete-prev action from the end of the text we end up either missing the first glyph we have to delete or falling through the last one in the text. This commit fixes both issues.
2009-01-06 20:54:20 +00:00
return TRUE;
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
}
text: implement del_word_next/del_word_prev() Bind ctrl-backspace and ctrl-del to functions that delete a word before or after the cursor, respectively. Selection does not affect the deletion, but current selection is preserved. This mimicks GTK+ functionality in GtkTextView and GtkEntry. http://bugzilla.openedhand.com/show_bug.cgi?id=1767 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-02-03 17:04:38 +00:00
static gboolean
clutter_text_real_del_word_next (ClutterText *self,
const gchar *action,
guint keyval,
ClutterModifierType modifiers)
{
ClutterTextPrivate *priv = self->priv;
gint pos;
gint len;
pos = priv->position;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
len = clutter_text_buffer_get_length (get_buffer (self));
text: implement del_word_next/del_word_prev() Bind ctrl-backspace and ctrl-del to functions that delete a word before or after the cursor, respectively. Selection does not affect the deletion, but current selection is preserved. This mimicks GTK+ functionality in GtkTextView and GtkEntry. http://bugzilla.openedhand.com/show_bug.cgi?id=1767 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-02-03 17:04:38 +00:00
if (len && pos != -1 && pos < len)
{
gint end;
end = clutter_text_move_word_forward (self, pos);
clutter_text_delete_text (self, pos, end);
if (priv->selection_bound >= end)
{
gint new_bound;
new_bound = priv->selection_bound - (end - pos);
clutter_text_set_selection_bound (self, new_bound);
}
else if (priv->selection_bound > pos)
{
clutter_text_set_selection_bound (self, pos);
}
}
return TRUE;
}
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
static gboolean
clutter_text_real_del_prev (ClutterText *self,
const gchar *action,
guint keyval,
ClutterModifierType modifiers)
{
ClutterTextPrivate *priv = self->priv;
gint pos;
gint len;
[text] Add ClutterText::delete_selection() Add a method for deleting the current selection inside a Text actor. This is useful for subclasses. See bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1521 Based on a patch by: Raymond Liu <raymond.liu@intel.com>
2009-05-06 16:08:25 +00:00
if (clutter_text_delete_selection (self))
Change the binding propagation when truncating a selection If a selection has been truncated inside a key binding handler, we should just return and let the usual key event handler continue. This fixes the case where we deleted a selection using the Delete or the Backspace keys.
2008-12-11 12:08:20 +00:00
return TRUE;
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
pos = priv->position;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
len = clutter_text_buffer_get_length (get_buffer (self));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
if (pos != 0 && len != 0)
{
if (pos == -1)
{
[text] Fix the deletion actions When using the delete-prev action from the end of the text we end up either missing the first glyph we have to delete or falling through the last one in the text. This commit fixes both issues.
2009-01-06 20:54:20 +00:00
clutter_text_delete_text (self, len - 1, len);
[text] Maintain the cursor at the end when deleting If the cursor is already at the end of the Text contents then we need to maintain its position when deleting the previous character using the relative key binding.
2009-05-14 11:00:51 +00:00
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
clutter_text_set_positions (self, -1, -1);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
}
else
{
[text] Maintain the cursor at the end when deleting If the cursor is already at the end of the Text contents then we need to maintain its position when deleting the previous character using the relative key binding.
2009-05-14 11:00:51 +00:00
clutter_text_delete_text (self, pos - 1, pos);
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
clutter_text_set_positions (self, pos - 1, pos - 1);
[text] Fix the deletion actions When using the delete-prev action from the end of the text we end up either missing the first glyph we have to delete or falling through the last one in the text. This commit fixes both issues.
2009-01-06 20:54:20 +00:00
}
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
}
[text] Fix the deletion actions When using the delete-prev action from the end of the text we end up either missing the first glyph we have to delete or falling through the last one in the text. This commit fixes both issues.
2009-01-06 20:54:20 +00:00
return TRUE;
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
}
text: implement del_word_next/del_word_prev() Bind ctrl-backspace and ctrl-del to functions that delete a word before or after the cursor, respectively. Selection does not affect the deletion, but current selection is preserved. This mimicks GTK+ functionality in GtkTextView and GtkEntry. http://bugzilla.openedhand.com/show_bug.cgi?id=1767 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-02-03 17:04:38 +00:00
static gboolean
clutter_text_real_del_word_prev (ClutterText *self,
const gchar *action,
guint keyval,
ClutterModifierType modifiers)
{
ClutterTextPrivate *priv = self->priv;
gint pos;
gint len;
pos = priv->position;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
len = clutter_text_buffer_get_length (get_buffer (self));
text: implement del_word_next/del_word_prev() Bind ctrl-backspace and ctrl-del to functions that delete a word before or after the cursor, respectively. Selection does not affect the deletion, but current selection is preserved. This mimicks GTK+ functionality in GtkTextView and GtkEntry. http://bugzilla.openedhand.com/show_bug.cgi?id=1767 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-02-03 17:04:38 +00:00
if (pos != 0 && len != 0)
{
gint new_pos;
if (pos == -1)
{
new_pos = clutter_text_move_word_backward (self, len);
clutter_text_delete_text (self, new_pos, len);
clutter_text_set_positions (self, -1, -1);
}
else
{
new_pos = clutter_text_move_word_backward (self, pos);
clutter_text_delete_text (self, new_pos, pos);
clutter_text_set_cursor_position (self, new_pos);
if (priv->selection_bound >= pos)
{
gint new_bound;
new_bound = priv->selection_bound - (pos - new_pos);
clutter_text_set_selection_bound (self, new_bound);
}
else if (priv->selection_bound >= new_pos)
{
clutter_text_set_selection_bound (self, new_pos);
}
}
}
return TRUE;
}
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
static gboolean
Code style fixes Fix the arguments alignment whenever not consistent with the coding style rules.
2008-12-11 12:15:49 +00:00
clutter_text_real_activate (ClutterText *self,
const gchar *action,
guint keyval,
ClutterModifierType modifiers)
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
{
Use clutter_text_activate() Instead of repeating the same code for the ::activate signal emission, use the clutter_text_activate() function inside the 'activate' key binding handler.
2008-12-16 12:05:10 +00:00
return clutter_text_activate (self);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
}
Allow selecting with line-start and line-end bindings Instead of installing the line-start and line-end key bindings using the bare ClutterBindingPool API, we can use the internal clutter_text_add_move_binding(), which automatically installs the same key binding with the Shift modifier mask. This allows selecting when pressing Shift+Home or Shift+End. The selection behaviour is still incorrect around the zeroeth position, with all the text after the first line being selected.
2008-12-16 10:39:52 +00:00
static inline void
[text] Allow key navigation by word When pressing Ctrl with the left and right arrow keys we should skip to (or select until) the previous and next word, respectively. Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1713
2009-07-23 18:04:27 +00:00
clutter_text_add_move_binding (ClutterBindingPool *pool,
const gchar *action,
guint key_val,
ClutterModifierType additional_modifiers,
GCallback callback)
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
{
clutter_binding_pool_install_action (pool, action,
[text] Allow key navigation by word When pressing Ctrl with the left and right arrow keys we should skip to (or select until) the previous and next word, respectively. Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1713
2009-07-23 18:04:27 +00:00
key_val,
0,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
callback,
NULL, NULL);
clutter_binding_pool_install_action (pool, action,
[text] Allow key navigation by word When pressing Ctrl with the left and right arrow keys we should skip to (or select until) the previous and next word, respectively. Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1713
2009-07-23 18:04:27 +00:00
key_val,
CLUTTER_SHIFT_MASK,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
callback,
NULL, NULL);
[text] Allow key navigation by word When pressing Ctrl with the left and right arrow keys we should skip to (or select until) the previous and next word, respectively. Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1713
2009-07-23 18:04:27 +00:00
if (additional_modifiers != 0)
{
clutter_binding_pool_install_action (pool, action,
key_val,
additional_modifiers,
callback,
NULL, NULL);
clutter_binding_pool_install_action (pool, action,
key_val,
CLUTTER_SHIFT_MASK |
additional_modifiers,
callback,
NULL, NULL);
}
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
}
text: Implement Scriptable interface for font-description This makes ClutterText implement the Scriptable interface so that we can have a custom property parser and setter for the font-description property. This works by simply passing the string description through to clutter_text_set_font_name. Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>
2011-08-16 16:31:42 +00:00
static gboolean
clutter_text_parse_custom_node (ClutterScriptable *scriptable,
ClutterScript *script,
GValue *value,
const gchar *name,
JsonNode *node)
{
if (strncmp (name, "font-description", 16) == 0)
{
g_value_init (value, G_TYPE_STRING);
g_value_set_string (value, json_node_get_string (node));
return TRUE;
}
text: Chain up in the ScriptableIface implementation We need ClutterActor's implementation to run as well.
2012-06-08 13:13:36 +00:00
return parent_scriptable_iface->parse_custom_node (scriptable, script,
value,
name,
node);
text: Implement Scriptable interface for font-description This makes ClutterText implement the Scriptable interface so that we can have a custom property parser and setter for the font-description property. This works by simply passing the string description through to clutter_text_set_font_name. Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>
2011-08-16 16:31:42 +00:00
}
text: Enable implicit color animations Implement the ClutterAnimatable interface to enable implicit animations for :color, :cursor-color, :selected-text-color and :selection-color. https://bugzilla.gnome.org/show_bug.cgi?id=676963
2012-05-28 12:02:25 +00:00
static void
clutter_text_set_color_internal (ClutterText *self,
GParamSpec *pspec,
const ClutterColor *color)
{
ClutterTextPrivate *priv = CLUTTER_TEXT (self)->priv;
GParamSpec *other = NULL;
switch (pspec->param_id)
{
case PROP_COLOR:
priv->text_color = *color;
break;
case PROP_CURSOR_COLOR:
if (color)
{
priv->cursor_color = *color;
priv->cursor_color_set = TRUE;
}
else
priv->cursor_color_set = FALSE;
other = obj_props[PROP_CURSOR_COLOR_SET];
break;
case PROP_SELECTION_COLOR:
if (color)
{
priv->selection_color = *color;
priv->selection_color_set = TRUE;
}
else
priv->selection_color_set = FALSE;
other = obj_props[PROP_SELECTION_COLOR_SET];
break;
case PROP_SELECTED_TEXT_COLOR:
if (color)
{
priv->selected_text_color = *color;
priv->selected_text_color_set = TRUE;
}
else
priv->selected_text_color_set = FALSE;
other = obj_props[PROP_SELECTED_TEXT_COLOR_SET];
break;
default:
g_assert_not_reached ();
break;
}
clutter_text_queue_redraw (CLUTTER_ACTOR (self));
g_object_notify_by_pspec (G_OBJECT (self), pspec);
if (other)
g_object_notify_by_pspec (G_OBJECT (self), other);
}
static void
clutter_text_set_color_animated (ClutterText *self,
GParamSpec *pspec,
const ClutterColor *color)
{
ClutterActor *actor = CLUTTER_ACTOR (self);
ClutterTextPrivate *priv = self->priv;
const ClutterAnimationInfo *info;
ClutterTransition *transition;
info = _clutter_actor_get_animation_info (actor);
transition = clutter_actor_get_transition (actor, pspec->name);
/* jump to the end if there is no easing state, or if the easing
* state has a duration of 0 msecs
*/
if (info->cur_state == NULL ||
info->cur_state->easing_duration == 0)
{
/* ensure that we remove any currently running transition */
if (transition != NULL)
{
clutter_actor_remove_transition (actor, pspec->name);
transition = NULL;
}
clutter_text_set_color_internal (self, pspec, color);
return;
}
if (transition == NULL)
{
transition = clutter_property_transition_new (pspec->name);
clutter_transition_set_animatable (transition,
CLUTTER_ANIMATABLE (self));
clutter_transition_set_remove_on_complete (transition, TRUE);
/* delay only makes sense if the transition has just been created */
clutter_timeline_set_delay (CLUTTER_TIMELINE (transition),
info->cur_state->easing_delay);
clutter_actor_add_transition (actor, pspec->name, transition);
/* the actor now owns the transition */
g_object_unref (transition);
}
/* if a transition already exist, update its bounds */
switch (pspec->param_id)
{
case PROP_COLOR:
clutter_transition_set_from (transition, CLUTTER_TYPE_COLOR,
&priv->text_color);
break;
case PROP_CURSOR_COLOR:
clutter_transition_set_from (transition, CLUTTER_TYPE_COLOR,
&priv->cursor_color);
break;
case PROP_SELECTION_COLOR:
clutter_transition_set_from (transition, CLUTTER_TYPE_COLOR,
&priv->selection_color);
break;
case PROP_SELECTED_TEXT_COLOR:
clutter_transition_set_from (transition, CLUTTER_TYPE_COLOR,
&priv->selected_text_color);
break;
default:
g_assert_not_reached ();
}
clutter_transition_set_to (transition, CLUTTER_TYPE_COLOR, color);
/* always use the current easing state */
clutter_timeline_set_duration (CLUTTER_TIMELINE (transition),
info->cur_state->easing_duration);
clutter_timeline_set_progress_mode (CLUTTER_TIMELINE (transition),
info->cur_state->easing_mode);
/* ensure that we start from the beginning */
clutter_timeline_rewind (CLUTTER_TIMELINE (transition));
clutter_timeline_start (CLUTTER_TIMELINE (transition));
}
text: Implement Scriptable interface for font-description This makes ClutterText implement the Scriptable interface so that we can have a custom property parser and setter for the font-description property. This works by simply passing the string description through to clutter_text_set_font_name. Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>
2011-08-16 16:31:42 +00:00
static void
clutter_text_set_custom_property (ClutterScriptable *scriptable,
ClutterScript *script,
const gchar *name,
const GValue *value)
{
if (strncmp (name, "font-description", 16) == 0)
{
g_assert (G_VALUE_HOLDS (value, G_TYPE_STRING));
if (g_value_get_string (value) != NULL)
clutter_text_set_font_name (CLUTTER_TEXT (scriptable),
g_value_get_string (value));
}
else
text: Chain up in the ScriptableIface implementation We need ClutterActor's implementation to run as well.
2012-06-08 13:13:36 +00:00
parent_scriptable_iface->set_custom_property (scriptable, script,
name,
value);
text: Implement Scriptable interface for font-description This makes ClutterText implement the Scriptable interface so that we can have a custom property parser and setter for the font-description property. This works by simply passing the string description through to clutter_text_set_font_name. Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>
2011-08-16 16:31:42 +00:00
}
static void
clutter_scriptable_iface_init (ClutterScriptableIface *iface)
{
text: Chain up in the ScriptableIface implementation We need ClutterActor's implementation to run as well.
2012-06-08 13:13:36 +00:00
parent_scriptable_iface = g_type_interface_peek_parent (iface);
text: Implement Scriptable interface for font-description This makes ClutterText implement the Scriptable interface so that we can have a custom property parser and setter for the font-description property. This works by simply passing the string description through to clutter_text_set_font_name. Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>
2011-08-16 16:31:42 +00:00
iface->parse_custom_node = clutter_text_parse_custom_node;
iface->set_custom_property = clutter_text_set_custom_property;
}
text: Enable implicit color animations Implement the ClutterAnimatable interface to enable implicit animations for :color, :cursor-color, :selected-text-color and :selection-color. https://bugzilla.gnome.org/show_bug.cgi?id=676963
2012-05-28 12:02:25 +00:00
static void
clutter_text_set_final_state (ClutterAnimatable *animatable,
const char *property_name,
const GValue *value)
{
if (strcmp (property_name, "color") == 0)
{
const ClutterColor *color = clutter_value_get_color (value);
clutter_text_set_color_internal (CLUTTER_TEXT (animatable),
obj_props[PROP_COLOR], color);
}
else if (strcmp (property_name, "cursor-color") == 0)
{
const ClutterColor *color = clutter_value_get_color (value);
clutter_text_set_color_internal (CLUTTER_TEXT (animatable),
obj_props[PROP_CURSOR_COLOR],
color);
}
else if (strcmp (property_name, "selected-text-color") == 0)
{
const ClutterColor *color = clutter_value_get_color (value);
clutter_text_set_color_internal (CLUTTER_TEXT (animatable),
obj_props[PROP_SELECTED_TEXT_COLOR],
color);
}
else if (strcmp (property_name, "selection-color") == 0)
{
const ClutterColor *color = clutter_value_get_color (value);
clutter_text_set_color_internal (CLUTTER_TEXT (animatable),
obj_props[PROP_SELECTION_COLOR],
color);
}
else
parent_animatable_iface->set_final_state (animatable, property_name, value);
}
static void
clutter_animatable_iface_init (ClutterAnimatableIface *iface)
{
parent_animatable_iface = g_type_interface_peek_parent (iface);
iface->set_final_state = clutter_text_set_final_state;
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
static void
clutter_text_class_init (ClutterTextClass *klass)
{
GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
ClutterActorClass *actor_class = CLUTTER_ACTOR_CLASS (klass);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
ClutterBindingPool *binding_pool;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
GParamSpec *pspec;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
gobject_class->set_property = clutter_text_set_property;
gobject_class->get_property = clutter_text_get_property;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
gobject_class->dispose = clutter_text_dispose;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
gobject_class->finalize = clutter_text_finalize;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
actor_class->paint = clutter_text_paint;
actor: make default get_paint_volume more conservative There are too many examples where the default assumption that an actor paints inside its allocation isn't true, so we now return FALSE in the base implementation instead. This means that by default we are saying "we don't know the paint volume of the actor", so developers need to implement the get_paint_volume virtual to take advantage of culling and clipped redraws with their actors. This patch provides very conservative get_paint_volume implementations for ClutterTexture, ClutterCairoTexture, ClutterRectangle and ClutterText which all explicitly check the actor's object type to avoid making any assumptions about subclasses.
2010-09-08 18:47:11 +00:00
actor_class->get_paint_volume = clutter_text_get_paint_volume;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
actor_class->get_preferred_width = clutter_text_get_preferred_width;
actor_class->get_preferred_height = clutter_text_get_preferred_height;
actor_class->allocate = clutter_text_allocate;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
actor_class->key_press_event = clutter_text_key_press;
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
actor_class->key_release_event = clutter_text_key_release;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
actor_class->button_press_event = clutter_text_button_press;
actor_class->button_release_event = clutter_text_button_release;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
actor_class->motion_event = clutter_text_motion;
text: add touch events support https://bugzilla.gnome.org/show_bug.cgi?id=678278
2012-06-18 01:03:58 +00:00
actor_class->touch_event = clutter_text_touch_event;
text: Only paint cursor if we have key focus If a Text actor does not have key focus then there's no point in showing the cursor at all.
2010-12-21 10:50:24 +00:00
actor_class->key_focus_in = clutter_text_key_focus_in;
actor_class->key_focus_out = clutter_text_key_focus_out;
text: Implement the ::has_overlaps virtual Since ClutterText has overlapping primitives when selecting, or a visible cursor, then we need to report that to Clutter, to avoid bleeding colors through when a Text actor is non-fully opaque.
2011-05-13 13:17:39 +00:00
actor_class->has_overlaps = clutter_text_has_overlaps;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
/**
* ClutterText:buffer:
*
* The buffer which stores the text for this #ClutterText.
*
* If set to %NULL, a default buffer will be created.
*
* Since: 1.8
*/
pspec = g_param_spec_object ("buffer",
P_("Buffer"),
P_("The buffer for the text"),
CLUTTER_TYPE_TEXT_BUFFER,
CLUTTER_PARAM_READWRITE);
obj_props[PROP_BUFFER] = pspec;
g_object_class_install_property (gobject_class, PROP_BUFFER, pspec);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
/**
* ClutterText:font-name:
*
* The font to be used by the #ClutterText, as a string
* that can be parsed by pango_font_description_from_string().
*
text: Document and annotate :font-name for NULL values Update the documentation of :font-name, to make it clear that by setting it to NULL the Text actor will use the default font. Also, set the annotation for the @font_name argument of the setter to be allow-none, and allow passing NULL through bindings.
2010-06-26 22:05:36 +00:00
* If set to %NULL, the default system font will be used instead.
*
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
* Since: 1.0
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
*/
pspec = g_param_spec_string ("font-name",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Font Name"),
P_("The font to be used by the text"),
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
NULL,
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_FONT_NAME] = pspec;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
g_object_class_install_property (gobject_class, PROP_FONT_NAME, pspec);
text: Add :font-description High level toolkits might wish to construct a PangoFontDescription and then set it directly on a ClutterText actor proxy or sub-class. ClutterText should have a :font-description property to set (and get) the PangoFontDescription. http://bugzilla.openedhand.com/show_bug.cgi?id=1960
2010-02-03 14:35:45 +00:00
/**
* ClutterText:font-description:
*
* The #PangoFontDescription that should be used by the #ClutterText
*
* If you have a string describing the font then you should look at
* #ClutterText:font-name instead
*
* Since: 1.2
*/
pspec = g_param_spec_boxed ("font-description",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Font Description"),
P_("The font description to be used"),
text: Add :font-description High level toolkits might wish to construct a PangoFontDescription and then set it directly on a ClutterText actor proxy or sub-class. ClutterText should have a :font-description property to set (and get) the PangoFontDescription. http://bugzilla.openedhand.com/show_bug.cgi?id=1960
2010-02-03 14:35:45 +00:00
PANGO_TYPE_FONT_DESCRIPTION,
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_FONT_DESCRIPTION] = pspec;
text: Add :font-description High level toolkits might wish to construct a PangoFontDescription and then set it directly on a ClutterText actor proxy or sub-class. ClutterText should have a :font-description property to set (and get) the PangoFontDescription. http://bugzilla.openedhand.com/show_bug.cgi?id=1960
2010-02-03 14:35:45 +00:00
g_object_class_install_property (gobject_class,
PROP_FONT_DESCRIPTION,
pspec);
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
/**
* ClutterText:text:
*
* The text to render inside the actor.
*
* Since: 1.0
*/
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
pspec = g_param_spec_string ("text",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Text"),
P_("The text to render"),
Use "" as the default value for the :text property This follows the convention of GtkLabel/GtkEntry in GTK+ and the old ClutterEntry. It makes it easier to use strlen/strcmp etc on the output, since we can assume that it is always a string. This commit also updates the test unit for ClutterText to verify that the clutter_text_get_text() function also returns an empty string when a ClutterText actor has been created.
2008-12-22 13:29:10 +00:00
"",
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_TEXT] = pspec;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
g_object_class_install_property (gobject_class, PROP_TEXT, pspec);
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
/**
* ClutterText:color:
*
* The color used to render the text.
*
* Since: 1.0
*/
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
pspec = clutter_param_spec_color ("color",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Font Color"),
P_("Color of the font used by the text"),
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
&default_text_color,
text: Enable implicit color animations Implement the ClutterAnimatable interface to enable implicit animations for :color, :cursor-color, :selected-text-color and :selection-color. https://bugzilla.gnome.org/show_bug.cgi?id=676963
2012-05-28 12:02:25 +00:00
CLUTTER_PARAM_READWRITE |
CLUTTER_PARAM_ANIMATABLE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_COLOR] = pspec;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
g_object_class_install_property (gobject_class, PROP_COLOR, pspec);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
/**
* ClutterText:editable:
*
* Whether key events delivered to the actor causes editing.
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
*
* Since: 1.0
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
*/
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
pspec = g_param_spec_boolean ("editable",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Editable"),
P_("Whether the text is editable"),
text: Fix the default value of "editable" The "editable" property is documented to default to TRUE, but is initialized to FALSE in the _init() function. Third party code would be affected if we changed the default to be TRUE, so we have to change the default value in the GParamSpec. https://bugzilla.gnome.org/show_bug.cgi?id=654726
2011-07-12 16:32:26 +00:00
FALSE,
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
G_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_EDITABLE] = pspec;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_object_class_install_property (gobject_class, PROP_EDITABLE, pspec);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
/**
* ClutterText:selectable:
*
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
* Whether it is possible to select text, either using the pointer
* or the keyboard.
*
docs: Improve documentation for ClutterText Ensure that the rule for :cursor-visible are documented.
2015-11-30 13:47:15 +00:00
* This property depends on the #ClutterActor:reactive property being
* set to %TRUE.
*
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
* Since: 1.0
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
*/
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
pspec = g_param_spec_boolean ("selectable",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Selectable"),
P_("Whether the text is selectable"),
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
TRUE,
G_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_SELECTABLE] = pspec;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_object_class_install_property (gobject_class, PROP_SELECTABLE, pspec);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
/**
* ClutterText:activatable:
*
* Toggles whether return invokes the activate signal or not.
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
*
* Since: 1.0
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
*/
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
pspec = g_param_spec_boolean ("activatable",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Activatable"),
P_("Whether pressing return causes the activate signal to be emitted"),
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
TRUE,
G_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_ACTIVATABLE] = pspec;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_object_class_install_property (gobject_class, PROP_ACTIVATABLE, pspec);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
/**
* ClutterText:cursor-visible:
*
docs: Improve documentation for ClutterText Ensure that the rule for :cursor-visible are documented.
2015-11-30 13:47:15 +00:00
* Whether the input cursor is visible or not.
*
* The cursor will only be visible if this property and either
* the #ClutterText:editable or the #ClutterText:selectable properties
* are set to %TRUE.
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
*
* Since: 1.0
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
*/
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
pspec = g_param_spec_boolean ("cursor-visible",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Cursor Visible"),
P_("Whether the input cursor is visible"),
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
TRUE,
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_CURSOR_VISIBLE] = pspec;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
g_object_class_install_property (gobject_class, PROP_CURSOR_VISIBLE, pspec);
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
/**
* ClutterText:cursor-color:
*
* The color of the cursor.
*
* Since: 1.0
*/
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
pspec = clutter_param_spec_color ("cursor-color",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Cursor Color"),
P_("Cursor Color"),
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
&default_cursor_color,
text: Enable implicit color animations Implement the ClutterAnimatable interface to enable implicit animations for :color, :cursor-color, :selected-text-color and :selection-color. https://bugzilla.gnome.org/show_bug.cgi?id=676963
2012-05-28 12:02:25 +00:00
CLUTTER_PARAM_READWRITE |
CLUTTER_PARAM_ANIMATABLE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_CURSOR_COLOR] = pspec;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
g_object_class_install_property (gobject_class, PROP_CURSOR_COLOR, pspec);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
/**
* ClutterText:cursor-color-set:
*
* Will be set to %TRUE if #ClutterText:cursor-color has been set.
*
* Since: 1.0
*/
Add :cursor-color-set property declaration The :cursor-color-set property is a read-only property that reflects whether the ClutterText actor is going to use the color set inside the :cursor-color property when painting the cursor.
2008-12-11 11:49:14 +00:00
pspec = g_param_spec_boolean ("cursor-color-set",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Cursor Color Set"),
P_("Whether the cursor color has been set"),
Add :cursor-color-set property declaration The :cursor-color-set property is a read-only property that reflects whether the ClutterText actor is going to use the color set inside the :cursor-color property when painting the cursor.
2008-12-11 11:49:14 +00:00
FALSE,
CLUTTER_PARAM_READABLE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_CURSOR_COLOR_SET] = pspec;
Add :cursor-color-set property declaration The :cursor-color-set property is a read-only property that reflects whether the ClutterText actor is going to use the color set inside the :cursor-color property when painting the cursor.
2008-12-11 11:49:14 +00:00
g_object_class_install_property (gobject_class, PROP_CURSOR_COLOR_SET, pspec);
Add :cursor-size property to ClutterText We can control the width of the cursor when painting by using a simple property. The magic -1 number passed to the setter method will reset the cursor size to the default one of 2px. The getter method will return an unsigned integer with the current size.
2008-12-16 10:37:45 +00:00
/**
* ClutterText:cursor-size:
*
* The size of the cursor, in pixels. If set to -1 the size used will
* be the default cursor size of 2 pixels.
*
* Since: 1.0
*/
pspec = g_param_spec_int ("cursor-size",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Cursor Size"),
P_("The width of the cursor, in pixels"),
Add :cursor-size property to ClutterText We can control the width of the cursor when painting by using a simple property. The magic -1 number passed to the setter method will reset the cursor size to the default one of 2px. The getter method will return an unsigned integer with the current size.
2008-12-16 10:37:45 +00:00
-1, G_MAXINT, DEFAULT_CURSOR_SIZE,
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_CURSOR_SIZE] = pspec;
Add :cursor-size property to ClutterText We can control the width of the cursor when painting by using a simple property. The magic -1 number passed to the setter method will reset the cursor size to the default one of 2px. The getter method will return an unsigned integer with the current size.
2008-12-16 10:37:45 +00:00
g_object_class_install_property (gobject_class, PROP_CURSOR_SIZE, pspec);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
/**
* ClutterText:position:
*
* The current input cursor position. -1 is taken to be the end of the text
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
*
* Since: 1.0
text: Add :cursor-position and deprecate :position The :position property on ClutterText clashes with the same property on ClutterActor; it's also badly named, given that it represents the cursor's position inside the text; finally, it does not match its accessors, violating the API style conventions. https://bugzilla.gnome.org/show_bug.cgi?id=679457
2012-07-05 15:23:52 +00:00
*
* Deprecated: 1.12: Use ClutterText:cursor-position instead.
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
*/
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
pspec = g_param_spec_int ("position",
text: Rename the nick of the position property "Cursor Position" the "position" property of ClutterText is really the position of the cursor. Rename the nick accordingly not to confuse it with the position of the actor itself and be consistent with all the other cursor-related properties.
2010-10-05 07:25:06 +00:00
P_("Cursor Position"),
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("The cursor position"),
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
-1, G_MAXINT,
-1,
text: Add :cursor-position and deprecate :position The :position property on ClutterText clashes with the same property on ClutterActor; it's also badly named, given that it represents the cursor's position inside the text; finally, it does not match its accessors, violating the API style conventions. https://bugzilla.gnome.org/show_bug.cgi?id=679457
2012-07-05 15:23:52 +00:00
G_PARAM_READWRITE |
G_PARAM_STATIC_STRINGS |
G_PARAM_DEPRECATED);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_POSITION] = pspec;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_object_class_install_property (gobject_class, PROP_POSITION, pspec);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Add :cursor-position and deprecate :position The :position property on ClutterText clashes with the same property on ClutterActor; it's also badly named, given that it represents the cursor's position inside the text; finally, it does not match its accessors, violating the API style conventions. https://bugzilla.gnome.org/show_bug.cgi?id=679457
2012-07-05 15:23:52 +00:00
/**
* ClutterText:cursor-position:
*
* The current input cursor position. -1 is taken to be the end of the text
*
* Since: 1.12
*/
pspec = g_param_spec_int ("cursor-position",
P_("Cursor Position"),
P_("The cursor position"),
-1, G_MAXINT,
-1,
CLUTTER_PARAM_READWRITE);
obj_props[PROP_CURSOR_POSITION] = pspec;
g_object_class_install_property (gobject_class, PROP_CURSOR_POSITION, pspec);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
/**
* ClutterText:selection-bound:
*
* The current input cursor position. -1 is taken to be the end of the text
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
*
* Since: 1.0
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
*/
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
pspec = g_param_spec_int ("selection-bound",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Selection-bound"),
P_("The cursor position of the other end of the selection"),
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
-1, G_MAXINT,
-1,
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_SELECTION_BOUND] = pspec;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_object_class_install_property (gobject_class, PROP_SELECTION_BOUND, pspec);
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
/**
* ClutterText:selection-color:
*
* The color of the selection.
*
* Since: 1.0
*/
pspec = clutter_param_spec_color ("selection-color",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Selection Color"),
P_("Selection Color"),
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
&default_selection_color,
text: Enable implicit color animations Implement the ClutterAnimatable interface to enable implicit animations for :color, :cursor-color, :selected-text-color and :selection-color. https://bugzilla.gnome.org/show_bug.cgi?id=676963
2012-05-28 12:02:25 +00:00
CLUTTER_PARAM_READWRITE |
CLUTTER_PARAM_ANIMATABLE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_SELECTION_COLOR] = pspec;
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
g_object_class_install_property (gobject_class, PROP_SELECTION_COLOR, pspec);
/**
* ClutterText:selection-color-set:
*
* Will be set to %TRUE if #ClutterText:selection-color has been set.
*
* Since: 1.0
*/
pspec = g_param_spec_boolean ("selection-color-set",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Selection Color Set"),
P_("Whether the selection color has been set"),
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
FALSE,
CLUTTER_PARAM_READABLE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_SELECTION_COLOR_SET] = pspec;
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
g_object_class_install_property (gobject_class, PROP_SELECTION_COLOR_SET, pspec);
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
/**
* ClutterText:attributes:
*
* A list of #PangoStyleAttribute<!-- -->s to be applied to the
* contents of the #ClutterText actor.
*
* Since: 1.0
*/
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
pspec = g_param_spec_boxed ("attributes",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Attributes"),
P_("A list of style attributes to apply to the contents of the actor"),
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
PANGO_TYPE_ATTR_LIST,
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_ATTRIBUTES] = pspec;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_object_class_install_property (gobject_class, PROP_ATTRIBUTES, pspec);
/**
* ClutterText:use-markup:
*
text: Do not set the markup unconditionally When setting :use-markup we always pass the contents of the Text actor to clutter_text_set_markup_internal(); if string contains any markup, this ends up being parsed and used - even when :use-markup is set to FALSE. http://bugzilla.clutter-project.org/show_bug.cgi?id=2239
2010-08-06 16:04:37 +00:00
* Whether the text includes Pango markup.
*
* For more informations about the Pango markup format, see
* pango_layout_set_markup() in the Pango documentation.
*
docs: Move to markdown We're removing docbook tags in favour of the markdown syntax.
2014-03-17 23:07:58 +00:00
* It is not possible to round-trip this property between
text: Do not set the markup unconditionally When setting :use-markup we always pass the contents of the Text actor to clutter_text_set_markup_internal(); if string contains any markup, this ends up being parsed and used - even when :use-markup is set to FALSE. http://bugzilla.clutter-project.org/show_bug.cgi?id=2239
2010-08-06 16:04:37 +00:00
* %TRUE and %FALSE. Once a string with markup has been set on
* a #ClutterText actor with :use-markup set to %TRUE, the markup
docs: Move to markdown We're removing docbook tags in favour of the markdown syntax.
2014-03-17 23:07:58 +00:00
* is stripped from the string.
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
*
* Since: 1.0
*/
pspec = g_param_spec_boolean ("use-markup",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Use markup"),
P_("Whether or not the text includes Pango markup"),
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
FALSE,
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_USE_MARKUP] = pspec;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_object_class_install_property (gobject_class, PROP_USE_MARKUP, pspec);
/**
* ClutterText:line-wrap:
*
* Whether to wrap the lines of #ClutterText:text if the contents
* exceed the available allocation. The wrapping strategy is
* controlled by the #ClutterText:line-wrap-mode property.
*
* Since: 1.0
*/
pspec = g_param_spec_boolean ("line-wrap",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Line wrap"),
P_("If set, wrap the lines if the text becomes too wide"),
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
FALSE,
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_LINE_WRAP] = pspec;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_object_class_install_property (gobject_class, PROP_LINE_WRAP, pspec);
/**
* ClutterText:line-wrap-mode:
*
* If #ClutterText:line-wrap is set to %TRUE, this property will
* control how the text is wrapped.
*
* Since: 1.0
*/
pspec = g_param_spec_enum ("line-wrap-mode",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Line wrap mode"),
P_("Control how line-wrapping is done"),
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
PANGO_TYPE_WRAP_MODE,
PANGO_WRAP_WORD,
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_LINE_WRAP_MODE] = pspec;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_object_class_install_property (gobject_class, PROP_LINE_WRAP_MODE, pspec);
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
/**
* ClutterText:ellipsize:
*
* The preferred place to ellipsize the contents of the #ClutterText actor
*
* Since: 1.0
*/
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
pspec = g_param_spec_enum ("ellipsize",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Ellipsize"),
P_("The preferred place to ellipsize the string"),
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
PANGO_TYPE_ELLIPSIZE_MODE,
PANGO_ELLIPSIZE_NONE,
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_ELLIPSIZE] = pspec;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_object_class_install_property (gobject_class, PROP_ELLIPSIZE, pspec);
/**
[text] Rename :alignment to :line-alignment The :alignment property is prone to generate confusion: developers will set it thinking that the contents of a ClutterText will automagically align themselves. Instead of using the generic term :alignment, and following the GTK+ convention, we should use a more specific term, conveying the actual effect of the property: alignment of the lines with respect to each other, and not to the overall allocated area. See bug 1428: http://bugzilla.openedhand.com/show_bug.cgi?id=1428
2009-02-02 23:55:30 +00:00
* ClutterText:line-alignment:
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
*
* The preferred alignment for the text. This property controls
* the alignment of multi-line paragraphs.
*
* Since: 1.0
*/
[text] Rename :alignment to :line-alignment The :alignment property is prone to generate confusion: developers will set it thinking that the contents of a ClutterText will automagically align themselves. Instead of using the generic term :alignment, and following the GTK+ convention, we should use a more specific term, conveying the actual effect of the property: alignment of the lines with respect to each other, and not to the overall allocated area. See bug 1428: http://bugzilla.openedhand.com/show_bug.cgi?id=1428
2009-02-02 23:55:30 +00:00
pspec = g_param_spec_enum ("line-alignment",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Line Alignment"),
P_("The preferred alignment for the string, for multi-line text"),
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
PANGO_TYPE_ALIGNMENT,
PANGO_ALIGN_LEFT,
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_LINE_ALIGNMENT] = pspec;
[text] Rename :alignment to :line-alignment The :alignment property is prone to generate confusion: developers will set it thinking that the contents of a ClutterText will automagically align themselves. Instead of using the generic term :alignment, and following the GTK+ convention, we should use a more specific term, conveying the actual effect of the property: alignment of the lines with respect to each other, and not to the overall allocated area. See bug 1428: http://bugzilla.openedhand.com/show_bug.cgi?id=1428
2009-02-02 23:55:30 +00:00
g_object_class_install_property (gobject_class, PROP_LINE_ALIGNMENT, pspec);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
/**
* ClutterText:justify:
*
* Whether the contents of the #ClutterText should be justified
* on both margins.
*
* Since: 1.0
*/
pspec = g_param_spec_boolean ("justify",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Justify"),
P_("Whether the text should be justified"),
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
FALSE,
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_JUSTIFY] = pspec;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_object_class_install_property (gobject_class, PROP_JUSTIFY, pspec);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
/**
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
* ClutterText:password-char:
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
*
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
* If non-zero, the character that should be used in place of
* the actual text in a password text actor.
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
*
* Since: 1.0
*/
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
pspec = g_param_spec_unichar ("password-char",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Password Character"),
P_("If non-zero, use this character to display the actor's contents"),
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
0,
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_PASSWORD_CHAR] = pspec;
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
g_object_class_install_property (gobject_class, PROP_PASSWORD_CHAR, pspec);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
/**
* ClutterText:max-length:
*
* The maximum length of the contents of the #ClutterText actor.
*
* Since: 1.0
*/
Implement Text:max-length The :max-length property establishes the maximum available length for the Text actor's contents, in characters.
2008-12-11 11:54:07 +00:00
pspec = g_param_spec_int ("max-length",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Max Length"),
P_("Maximum length of the text inside the actor"),
Implement Text:max-length The :max-length property establishes the maximum available length for the Text actor's contents, in characters.
2008-12-11 11:54:07 +00:00
-1, G_MAXINT, 0,
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_MAX_LENGTH] = pspec;
Implement Text:max-length The :max-length property establishes the maximum available length for the Text actor's contents, in characters.
2008-12-11 11:54:07 +00:00
g_object_class_install_property (gobject_class, PROP_MAX_LENGTH, pspec);
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
/**
* ClutterText:single-line-mode:
*
* Whether the #ClutterText actor should be in single line mode
* or not. A single line #ClutterText actor will only contain a
* single line of text, scrolling it in case its length is bigger
* than the allocated size.
*
* Setting this property will also set the #ClutterText:activatable
* property as a side-effect.
*
docs: Clarify the scope of Text:single-line-mode Only editable text actors can be in single-line mode.
2010-06-14 13:05:49 +00:00
* The #ClutterText:single-line-mode property is used only if the
* #ClutterText:editable property is set to %TRUE.
*
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
* Since: 1.0
*/
pspec = g_param_spec_boolean ("single-line-mode",
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
P_("Single Line Mode"),
P_("Whether the text should be a single line"),
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
FALSE,
CLUTTER_PARAM_READWRITE);
Conditionally use g_object_notify_by_pspec This adds a wrapper macro to clutter-private that will use g_object_notify_by_pspec if it's compiled against a version of GLib that is sufficiently new. Otherwise it will notify by the property name as before by extracting the name from the pspec. The objects can then store a static array of GParamSpecs and notify using those as suggested in the documentation for g_object_notify_by_pspec. Note that the name of the variable used for storing the array of GParamSpecs is obj_props instead of properties as used in the documentation because some places in Clutter uses 'properties' as the name of a local variable. Mose of the classes in Clutter have been converted using the script in the bug report. Some classes have not been modified even though the script picked them up as described here: json-generator: We probably don't want to modify the internal copy of JSON behaviour-depth: rectangle: score: stage-manager: These aren't using the separate GParamSpec* variable style. blur-effect: win32/device-manager: Don't actually define any properties even though it has the enum. box-layout: flow-layout: Have some per-child properties that don't work automatically with the script. clutter-model: The script gets confused with ClutterModelIter stage: Script gets confused because PROP_USER_RESIZE doesn't match "user-resizable" test-layout: Don't really want to modify the tests http://bugzilla.clutter-project.org/show_bug.cgi?id=2150
2010-06-21 09:20:32 +00:00
obj_props[PROP_SINGLE_LINE_MODE] = pspec;
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
g_object_class_install_property (gobject_class, PROP_SINGLE_LINE_MODE, pspec);
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
/**
* ClutterText:selected-text-color:
*
* The color of selected text.
*
* Since: 1.8
*/
pspec = clutter_param_spec_color ("selected-text-color",
P_("Selected Text Color"),
P_("Selected Text Color"),
&default_selected_text_color,
text: Enable implicit color animations Implement the ClutterAnimatable interface to enable implicit animations for :color, :cursor-color, :selected-text-color and :selection-color. https://bugzilla.gnome.org/show_bug.cgi?id=676963
2012-05-28 12:02:25 +00:00
CLUTTER_PARAM_READWRITE |
CLUTTER_PARAM_ANIMATABLE);
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
obj_props[PROP_SELECTED_TEXT_COLOR] = pspec;
g_object_class_install_property (gobject_class, PROP_SELECTED_TEXT_COLOR, pspec);
/**
* ClutterText:selected-text-color-set:
*
* Will be set to %TRUE if #ClutterText:selected-text-color has been set.
*
* Since: 1.8
*/
pspec = g_param_spec_boolean ("selected-text-color-set",
P_("Selected Text Color Set"),
P_("Whether the selected text color has been set"),
FALSE,
CLUTTER_PARAM_READABLE);
obj_props[PROP_SELECTED_TEXT_COLOR_SET] = pspec;
g_object_class_install_property (gobject_class, PROP_SELECTED_TEXT_COLOR_SET, pspec);
clutter: Add input-purpose/hint properties to ClutterText So those properties can be changed or queried within shell UI.
2017-12-21 10:34:11 +00:00
pspec = g_param_spec_flags ("input-hints",
P_("Input hints"),
P_("Input hints"),
CLUTTER_TYPE_INPUT_CONTENT_HINT_FLAGS,
0, CLUTTER_PARAM_READWRITE);
obj_props[PROP_INPUT_HINTS] = pspec;
g_object_class_install_property (gobject_class, PROP_INPUT_HINTS, pspec);
pspec = g_param_spec_enum ("input-purpose",
P_("Input purpose"),
P_("Input purpose"),
CLUTTER_TYPE_INPUT_CONTENT_PURPOSE,
0, CLUTTER_PARAM_READWRITE);
obj_props[PROP_INPUT_PURPOSE] = pspec;
g_object_class_install_property (gobject_class, PROP_INPUT_PURPOSE, pspec);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
/**
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
* ClutterText::text-changed:
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
* @self: the #ClutterText that emitted the signal
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
*
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
* The ::text-changed signal is emitted after @actor's text changes
*
* Since: 1.0
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
*/
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
text_signals[TEXT_CHANGED] =
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
g_signal_new (I_("text-changed"),
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
G_TYPE_FROM_CLASS (gobject_class),
G_SIGNAL_RUN_LAST,
Group all the integer private fields Integer fields using the ": <bits>" notation should be packed together so that the compiler can optimize the structure size correctly.
2008-12-11 11:15:56 +00:00
G_STRUCT_OFFSET (ClutterTextClass, text_changed),
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
NULL, NULL,
Hide the marshallers The marshallers we use for the signals are declared in a private header, and it stands to reason that they should also be hidden in the shared object by using the common '_' prefix. We are also using some direct g_cclosure_marshal_* symbol from GLib, instead of consistently use the clutter_marshal_* symbol.
2010-06-11 14:49:46 +00:00
_clutter_marshal_VOID__VOID,
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
G_TYPE_NONE, 0);
Added ClutterText::insert-text and ClutterText::delete-text signals * clutter/clutter-marshal.list: added new marshaller * clutter/clutter-text.c (clutter_text_class_init): added insert-text and delete-text signals (clutter_text_insert_unichar): emits insert-text signal (clutter_text_insert_text): emits insert-text signal (clutter_text_delete_text): emits delete-text signal (clutter_text_delete_chars): emits delete-text signal (clutter_text_set_markup_internal): emits delete-text and insert-text signals (clutter_text_set_text): emits delete-text and insert-text signals http://bugzilla.openedhand.com/show_bug.cgi?id=1894
2009-11-20 14:17:41 +00:00
/**
* ClutterText::insert-text:
* @self: the #ClutterText that emitted the signal
* @new_text: the new text to insert
* @new_text_length: the length of the new text, in bytes, or -1 if
* new_text is nul-terminated
* @position: the position, in characters, at which to insert the
* new text. this is an in-out parameter. After the signal
* emission is finished, it should point after the newly
* inserted text.
*
* This signal is emitted when text is inserted into the actor by
* the user. It is emitted before @self text changes.
*
* Since: 1.2
*/
text_signals[INSERT_TEXT] =
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
g_signal_new (I_("insert-text"),
Added ClutterText::insert-text and ClutterText::delete-text signals * clutter/clutter-marshal.list: added new marshaller * clutter/clutter-text.c (clutter_text_class_init): added insert-text and delete-text signals (clutter_text_insert_unichar): emits insert-text signal (clutter_text_insert_text): emits insert-text signal (clutter_text_delete_text): emits delete-text signal (clutter_text_delete_chars): emits delete-text signal (clutter_text_set_markup_internal): emits delete-text and insert-text signals (clutter_text_set_text): emits delete-text and insert-text signals http://bugzilla.openedhand.com/show_bug.cgi?id=1894
2009-11-20 14:17:41 +00:00
G_TYPE_FROM_CLASS (gobject_class),
text: Use G_SIGNAL_ACTION for ::insert-text and ::delete-text Both the ::insert-text and ::delete-text are "action" signals, that is signals that are safe to (and should) be emitted using g_signal_emit() directly.
2010-01-04 12:03:47 +00:00
G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
Added ClutterText::insert-text and ClutterText::delete-text signals * clutter/clutter-marshal.list: added new marshaller * clutter/clutter-text.c (clutter_text_class_init): added insert-text and delete-text signals (clutter_text_insert_unichar): emits insert-text signal (clutter_text_insert_text): emits insert-text signal (clutter_text_delete_text): emits delete-text signal (clutter_text_delete_chars): emits delete-text signal (clutter_text_set_markup_internal): emits delete-text and insert-text signals (clutter_text_set_text): emits delete-text and insert-text signals http://bugzilla.openedhand.com/show_bug.cgi?id=1894
2009-11-20 14:17:41 +00:00
0,
NULL, NULL,
Hide the marshallers The marshallers we use for the signals are declared in a private header, and it stands to reason that they should also be hidden in the shared object by using the common '_' prefix. We are also using some direct g_cclosure_marshal_* symbol from GLib, instead of consistently use the clutter_marshal_* symbol.
2010-06-11 14:49:46 +00:00
_clutter_marshal_VOID__STRING_INT_POINTER,
Added ClutterText::insert-text and ClutterText::delete-text signals * clutter/clutter-marshal.list: added new marshaller * clutter/clutter-text.c (clutter_text_class_init): added insert-text and delete-text signals (clutter_text_insert_unichar): emits insert-text signal (clutter_text_insert_text): emits insert-text signal (clutter_text_delete_text): emits delete-text signal (clutter_text_delete_chars): emits delete-text signal (clutter_text_set_markup_internal): emits delete-text and insert-text signals (clutter_text_set_text): emits delete-text and insert-text signals http://bugzilla.openedhand.com/show_bug.cgi?id=1894
2009-11-20 14:17:41 +00:00
G_TYPE_NONE, 3,
G_TYPE_STRING,
G_TYPE_INT,
G_TYPE_POINTER);
/**
* ClutterText::delete-text:
* @self: the #ClutterText that emitted the signal
* @start_pos: the starting position
* @end_pos: the end position
*
* This signal is emitted when text is deleted from the actor by
* the user. It is emitted before @self text changes.
*
* Since: 1.2
*/
text_signals[DELETE_TEXT] =
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
g_signal_new (I_("delete-text"),
Added ClutterText::insert-text and ClutterText::delete-text signals * clutter/clutter-marshal.list: added new marshaller * clutter/clutter-text.c (clutter_text_class_init): added insert-text and delete-text signals (clutter_text_insert_unichar): emits insert-text signal (clutter_text_insert_text): emits insert-text signal (clutter_text_delete_text): emits delete-text signal (clutter_text_delete_chars): emits delete-text signal (clutter_text_set_markup_internal): emits delete-text and insert-text signals (clutter_text_set_text): emits delete-text and insert-text signals http://bugzilla.openedhand.com/show_bug.cgi?id=1894
2009-11-20 14:17:41 +00:00
G_TYPE_FROM_CLASS (gobject_class),
text: Use G_SIGNAL_ACTION for ::insert-text and ::delete-text Both the ::insert-text and ::delete-text are "action" signals, that is signals that are safe to (and should) be emitted using g_signal_emit() directly.
2010-01-04 12:03:47 +00:00
G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
Added ClutterText::insert-text and ClutterText::delete-text signals * clutter/clutter-marshal.list: added new marshaller * clutter/clutter-text.c (clutter_text_class_init): added insert-text and delete-text signals (clutter_text_insert_unichar): emits insert-text signal (clutter_text_insert_text): emits insert-text signal (clutter_text_delete_text): emits delete-text signal (clutter_text_delete_chars): emits delete-text signal (clutter_text_set_markup_internal): emits delete-text and insert-text signals (clutter_text_set_text): emits delete-text and insert-text signals http://bugzilla.openedhand.com/show_bug.cgi?id=1894
2009-11-20 14:17:41 +00:00
0,
NULL, NULL,
Hide the marshallers The marshallers we use for the signals are declared in a private header, and it stands to reason that they should also be hidden in the shared object by using the common '_' prefix. We are also using some direct g_cclosure_marshal_* symbol from GLib, instead of consistently use the clutter_marshal_* symbol.
2010-06-11 14:49:46 +00:00
_clutter_marshal_VOID__INT_INT,
Added ClutterText::insert-text and ClutterText::delete-text signals * clutter/clutter-marshal.list: added new marshaller * clutter/clutter-text.c (clutter_text_class_init): added insert-text and delete-text signals (clutter_text_insert_unichar): emits insert-text signal (clutter_text_insert_text): emits insert-text signal (clutter_text_delete_text): emits delete-text signal (clutter_text_delete_chars): emits delete-text signal (clutter_text_set_markup_internal): emits delete-text and insert-text signals (clutter_text_set_text): emits delete-text and insert-text signals http://bugzilla.openedhand.com/show_bug.cgi?id=1894
2009-11-20 14:17:41 +00:00
G_TYPE_NONE, 2,
G_TYPE_INT,
G_TYPE_INT);
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
/**
* ClutterText::cursor-event:
* @self: the #ClutterText that emitted the signal
* @geometry: the coordinates of the cursor
*
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
* The ::cursor-event signal is emitted whenever the cursor position
* changes inside a #ClutterText actor. Inside @geometry it is stored
* the current position and size of the cursor, relative to the actor
* itself.
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
*
* Since: 1.0
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
*
* Deprecated: 1.16: Use the #ClutterText::cursor-changed signal instead
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
*/
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
text_signals[CURSOR_EVENT] =
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
g_signal_new (I_("cursor-event"),
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
G_TYPE_FROM_CLASS (gobject_class),
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
G_SIGNAL_RUN_LAST | G_SIGNAL_DEPRECATED,
Group all the integer private fields Integer fields using the ": <bits>" notation should be packed together so that the compiler can optimize the structure size correctly.
2008-12-11 11:15:56 +00:00
G_STRUCT_OFFSET (ClutterTextClass, cursor_event),
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
NULL, NULL,
Hide the marshallers The marshallers we use for the signals are declared in a private header, and it stands to reason that they should also be hidden in the shared object by using the common '_' prefix. We are also using some direct g_cclosure_marshal_* symbol from GLib, instead of consistently use the clutter_marshal_* symbol.
2010-06-11 14:49:46 +00:00
_clutter_marshal_VOID__BOXED,
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
G_TYPE_NONE, 1,
CLUTTER_TYPE_GEOMETRY | G_SIGNAL_TYPE_STATIC_SCOPE);
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
/**
* ClutterText::cursor-changed:
* @self: the #ClutterText that emitted the signal
*
* The ::cursor-changed signal is emitted whenever the cursor
* position or size changes.
*
* Since: 1.16
*/
text_signals[CURSOR_CHANGED] =
g_signal_new (I_("cursor-changed"),
G_TYPE_FROM_CLASS (gobject_class),
G_SIGNAL_RUN_LAST,
G_STRUCT_OFFSET (ClutterTextClass, cursor_changed),
NULL, NULL,
_clutter_marshal_VOID__VOID,
G_TYPE_NONE, 0);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
/**
docs: Annotation fixes The introspection scanner has become slightly more annoying, in the hope that people start fixing their annotations. As it turns out, it was the right move.
2012-04-30 16:12:12 +00:00
* ClutterText::activate:
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
* @self: the #ClutterText that emitted the signal
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
*
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
* The ::activate signal is emitted each time the actor is 'activated'
[docs] Annotate properties and fix signals docs Annotate the properties without gtk-doc description, to get the "Since" attribute. Also, fix the ::cursor-event and ::activate signals documentation.
2008-12-16 11:30:47 +00:00
* by the user, normally by pressing the 'Enter' key. The signal is
* emitted only if #ClutterText:activatable is set to %TRUE.
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
*
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
* Since: 1.0
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
*/
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
text_signals[ACTIVATE] =
Mark property strings for translation Both the nick and the blurb fields should be translatable, for UI builders and other introspection-based tools.
2010-06-03 11:57:50 +00:00
g_signal_new (I_("activate"),
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
G_TYPE_FROM_CLASS (gobject_class),
G_SIGNAL_RUN_LAST,
Group all the integer private fields Integer fields using the ": <bits>" notation should be packed together so that the compiler can optimize the structure size correctly.
2008-12-11 11:15:56 +00:00
G_STRUCT_OFFSET (ClutterTextClass, activate),
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
NULL, NULL,
Hide the marshallers The marshallers we use for the signals are declared in a private header, and it stands to reason that they should also be hidden in the shared object by using the common '_' prefix. We are also using some direct g_cclosure_marshal_* symbol from GLib, instead of consistently use the clutter_marshal_* symbol.
2010-06-11 14:49:46 +00:00
_clutter_marshal_VOID__VOID,
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
G_TYPE_NONE, 0);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
binding_pool = clutter_binding_pool_get_for_class (klass);
clutter_text_add_move_binding (binding_pool, "move-left",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_Left, CLUTTER_CONTROL_MASK,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
G_CALLBACK (clutter_text_real_move_left));
clutter_text_add_move_binding (binding_pool, "move-left",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_KP_Left, CLUTTER_CONTROL_MASK,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
G_CALLBACK (clutter_text_real_move_left));
clutter_text_add_move_binding (binding_pool, "move-right",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_Right, CLUTTER_CONTROL_MASK,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
G_CALLBACK (clutter_text_real_move_right));
clutter_text_add_move_binding (binding_pool, "move-right",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_KP_Right, CLUTTER_CONTROL_MASK,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
G_CALLBACK (clutter_text_real_move_right));
clutter_text_add_move_binding (binding_pool, "move-up",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_Up, 0,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
G_CALLBACK (clutter_text_real_move_up));
clutter_text_add_move_binding (binding_pool, "move-up",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_KP_Up, 0,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
G_CALLBACK (clutter_text_real_move_up));
clutter_text_add_move_binding (binding_pool, "move-down",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_Down, 0,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
G_CALLBACK (clutter_text_real_move_down));
clutter_text_add_move_binding (binding_pool, "move-down",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_KP_Down, 0,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
G_CALLBACK (clutter_text_real_move_down));
Allow selecting with line-start and line-end bindings Instead of installing the line-start and line-end key bindings using the bare ClutterBindingPool API, we can use the internal clutter_text_add_move_binding(), which automatically installs the same key binding with the Shift modifier mask. This allows selecting when pressing Shift+Home or Shift+End. The selection behaviour is still incorrect around the zeroeth position, with all the text after the first line being selected.
2008-12-16 10:39:52 +00:00
clutter_text_add_move_binding (binding_pool, "line-start",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_Home, 0,
Allow selecting with line-start and line-end bindings Instead of installing the line-start and line-end key bindings using the bare ClutterBindingPool API, we can use the internal clutter_text_add_move_binding(), which automatically installs the same key binding with the Shift modifier mask. This allows selecting when pressing Shift+Home or Shift+End. The selection behaviour is still incorrect around the zeroeth position, with all the text after the first line being selected.
2008-12-16 10:39:52 +00:00
G_CALLBACK (clutter_text_real_line_start));
clutter_text_add_move_binding (binding_pool, "line-start",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_KP_Home, 0,
Allow selecting with line-start and line-end bindings Instead of installing the line-start and line-end key bindings using the bare ClutterBindingPool API, we can use the internal clutter_text_add_move_binding(), which automatically installs the same key binding with the Shift modifier mask. This allows selecting when pressing Shift+Home or Shift+End. The selection behaviour is still incorrect around the zeroeth position, with all the text after the first line being selected.
2008-12-16 10:39:52 +00:00
G_CALLBACK (clutter_text_real_line_start));
clutter_text_add_move_binding (binding_pool, "line-start",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_Begin, 0,
Allow selecting with line-start and line-end bindings Instead of installing the line-start and line-end key bindings using the bare ClutterBindingPool API, we can use the internal clutter_text_add_move_binding(), which automatically installs the same key binding with the Shift modifier mask. This allows selecting when pressing Shift+Home or Shift+End. The selection behaviour is still incorrect around the zeroeth position, with all the text after the first line being selected.
2008-12-16 10:39:52 +00:00
G_CALLBACK (clutter_text_real_line_start));
clutter_text_add_move_binding (binding_pool, "line-end",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_End, 0,
Allow selecting with line-start and line-end bindings Instead of installing the line-start and line-end key bindings using the bare ClutterBindingPool API, we can use the internal clutter_text_add_move_binding(), which automatically installs the same key binding with the Shift modifier mask. This allows selecting when pressing Shift+Home or Shift+End. The selection behaviour is still incorrect around the zeroeth position, with all the text after the first line being selected.
2008-12-16 10:39:52 +00:00
G_CALLBACK (clutter_text_real_line_end));
clutter_text_add_move_binding (binding_pool, "line-end",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_KP_End, 0,
Allow selecting with line-start and line-end bindings Instead of installing the line-start and line-end key bindings using the bare ClutterBindingPool API, we can use the internal clutter_text_add_move_binding(), which automatically installs the same key binding with the Shift modifier mask. This allows selecting when pressing Shift+Home or Shift+End. The selection behaviour is still incorrect around the zeroeth position, with all the text after the first line being selected.
2008-12-16 10:39:52 +00:00
G_CALLBACK (clutter_text_real_line_end));
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
[text] Add select-all binding Bind Ctrl+A to the "select all" action.
2009-01-05 12:27:45 +00:00
clutter_binding_pool_install_action (binding_pool, "select-all",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_a, CLUTTER_CONTROL_MASK,
[text] Add select-all binding Bind Ctrl+A to the "select all" action.
2009-01-05 12:27:45 +00:00
G_CALLBACK (clutter_text_real_select_all),
NULL, NULL);
text: Bind <ctrl>A in addition to <ctrl>a The 'select-all' action is currently only bound to <ctrl>a, which makes it awkward to use when caps-lock is active, and is inconsistent with GTK+. Just accept both upper- and lower-case variants. https://bugzilla.gnome.org/show_bug.cgi?id=766326
2016-05-12 13:25:43 +00:00
clutter_binding_pool_install_action (binding_pool, "select-all",
CLUTTER_KEY_A, CLUTTER_CONTROL_MASK,
G_CALLBACK (clutter_text_real_select_all),
NULL, NULL);
[text] Add select-all binding Bind Ctrl+A to the "select all" action.
2009-01-05 12:27:45 +00:00
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
clutter_binding_pool_install_action (binding_pool, "delete-next",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_Delete, 0,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
G_CALLBACK (clutter_text_real_del_next),
NULL, NULL);
text: implement del_word_next/del_word_prev() Bind ctrl-backspace and ctrl-del to functions that delete a word before or after the cursor, respectively. Selection does not affect the deletion, but current selection is preserved. This mimicks GTK+ functionality in GtkTextView and GtkEntry. http://bugzilla.openedhand.com/show_bug.cgi?id=1767 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-02-03 17:04:38 +00:00
clutter_binding_pool_install_action (binding_pool, "delete-next",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_Delete, CLUTTER_CONTROL_MASK,
text: implement del_word_next/del_word_prev() Bind ctrl-backspace and ctrl-del to functions that delete a word before or after the cursor, respectively. Selection does not affect the deletion, but current selection is preserved. This mimicks GTK+ functionality in GtkTextView and GtkEntry. http://bugzilla.openedhand.com/show_bug.cgi?id=1767 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-02-03 17:04:38 +00:00
G_CALLBACK (clutter_text_real_del_word_next),
NULL, NULL);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
clutter_binding_pool_install_action (binding_pool, "delete-next",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_KP_Delete, 0,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
G_CALLBACK (clutter_text_real_del_next),
NULL, NULL);
text: implement del_word_next/del_word_prev() Bind ctrl-backspace and ctrl-del to functions that delete a word before or after the cursor, respectively. Selection does not affect the deletion, but current selection is preserved. This mimicks GTK+ functionality in GtkTextView and GtkEntry. http://bugzilla.openedhand.com/show_bug.cgi?id=1767 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-02-03 17:04:38 +00:00
clutter_binding_pool_install_action (binding_pool, "delete-next",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_KP_Delete, CLUTTER_CONTROL_MASK,
text: implement del_word_next/del_word_prev() Bind ctrl-backspace and ctrl-del to functions that delete a word before or after the cursor, respectively. Selection does not affect the deletion, but current selection is preserved. This mimicks GTK+ functionality in GtkTextView and GtkEntry. http://bugzilla.openedhand.com/show_bug.cgi?id=1767 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-02-03 17:04:38 +00:00
G_CALLBACK (clutter_text_real_del_word_next),
NULL, NULL);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
clutter_binding_pool_install_action (binding_pool, "delete-prev",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_BackSpace, 0,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
G_CALLBACK (clutter_text_real_del_prev),
NULL, NULL);
text: Bind BackSpace + Shift as BackSpace Follow this old GTK+ bug: https://bugzilla.gnome.org/show_bug.cgi?id=80302 and ignore the Shift mask.
2011-01-30 23:00:00 +00:00
clutter_binding_pool_install_action (binding_pool, "delete-prev",
CLUTTER_KEY_BackSpace, CLUTTER_SHIFT_MASK,
G_CALLBACK (clutter_text_real_del_prev),
NULL, NULL);
text: implement del_word_next/del_word_prev() Bind ctrl-backspace and ctrl-del to functions that delete a word before or after the cursor, respectively. Selection does not affect the deletion, but current selection is preserved. This mimicks GTK+ functionality in GtkTextView and GtkEntry. http://bugzilla.openedhand.com/show_bug.cgi?id=1767 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-02-03 17:04:38 +00:00
clutter_binding_pool_install_action (binding_pool, "delete-prev",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_BackSpace, CLUTTER_CONTROL_MASK,
text: implement del_word_next/del_word_prev() Bind ctrl-backspace and ctrl-del to functions that delete a word before or after the cursor, respectively. Selection does not affect the deletion, but current selection is preserved. This mimicks GTK+ functionality in GtkTextView and GtkEntry. http://bugzilla.openedhand.com/show_bug.cgi?id=1767 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2010-02-03 17:04:38 +00:00
G_CALLBACK (clutter_text_real_del_word_prev),
NULL, NULL);
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
clutter_binding_pool_install_action (binding_pool, "activate",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_Return, 0,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
G_CALLBACK (clutter_text_real_activate),
NULL, NULL);
clutter_binding_pool_install_action (binding_pool, "activate",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_KP_Enter, 0,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
G_CALLBACK (clutter_text_real_activate),
NULL, NULL);
clutter_binding_pool_install_action (binding_pool, "activate",
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
CLUTTER_KEY_ISO_Enter, 0,
Use ClutterBindPool inside ClutterText ClutterText should use the newly added ClutterBindingPool API to handle key events, instead of its homegrown code. This commit removes the action/mapping code and defers the entire key binding matching to a ClutterBindingPool created inside the Text class initialization function.
2008-12-11 12:03:17 +00:00
G_CALLBACK (clutter_text_real_activate),
NULL, NULL);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
static void
clutter_text_init (ClutterText *self)
{
Do not use deprecated API internally
2010-09-10 13:27:37 +00:00
ClutterSettings *settings;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
ClutterTextPrivate *priv;
Do not use deprecated API internally
2010-09-10 13:27:37 +00:00
gchar *font_name;
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
int i, password_hint_time;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Use the new macros for adding private data
2013-07-03 13:14:01 +00:00
self->priv = priv = clutter_text_get_instance_private (self);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
Correctly initialize the initial state of ClutterText Some of the values in ClutterText have an initial state that does not match a zero-ed out ClutterTextPrivate structure.
2008-12-11 11:35:52 +00:00
priv->alignment = PANGO_ALIGN_LEFT;
priv->wrap = FALSE;
priv->wrap_mode = PANGO_WRAP_WORD;
priv->ellipsize = PANGO_ELLIPSIZE_NONE;
priv->use_underline = FALSE;
priv->use_markup = FALSE;
priv->justify = FALSE;
for (i = 0; i < N_CACHED_LAYOUTS; i++)
priv->cached_layouts[i].layout = NULL;
Use "" as the default value for the :text property This follows the convention of GtkLabel/GtkEntry in GTK+ and the old ClutterEntry. It makes it easier to use strlen/strcmp etc on the output, since we can assume that it is always a string. This commit also updates the test unit for ClutterText to verify that the clutter_text_get_text() function also returns an empty string when a ClutterText actor has been created.
2008-12-22 13:29:10 +00:00
/* default to "" so that clutter_text_get_text() will
* return a valid string and we can safely call strlen()
* or strcmp() on it
*/
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
priv->buffer = NULL;
Correctly initialize the initial state of ClutterText Some of the values in ClutterText have an initial state that does not match a zero-ed out ClutterTextPrivate structure.
2008-12-11 11:35:52 +00:00
priv->text_color = default_text_color;
priv->cursor_color = default_cursor_color;
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
priv->selection_color = default_selection_color;
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
priv->selected_text_color = default_selected_text_color;
Correctly initialize the initial state of ClutterText Some of the values in ClutterText have an initial state that does not match a zero-ed out ClutterTextPrivate structure.
2008-12-11 11:35:52 +00:00
text: Add :font-description High level toolkits might wish to construct a PangoFontDescription and then set it directly on a ClutterText actor proxy or sub-class. ClutterText should have a :font-description property to set (and get) the PangoFontDescription. http://bugzilla.openedhand.com/show_bug.cgi?id=1960
2010-02-03 14:35:45 +00:00
/* get the default font name from the context; we don't use
* set_font_description() here because we are initializing
* the Text and we don't need notifications and sanity checks
*/
Do not use deprecated API internally
2010-09-10 13:27:37 +00:00
settings = clutter_settings_get_default ();
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
g_object_get (settings,
"font-name", &font_name,
"password-hint-time", &password_hint_time,
NULL);
Do not use deprecated API internally
2010-09-10 13:27:37 +00:00
priv->font_name = font_name; /* font_name is allocated */
Use the default font from the Backend Instead of storing the default font name and size as a pre-processor macro, use the newly added ClutterBackend API to retrieve the current default font from the backend.
2008-12-23 15:05:16 +00:00
priv->font_desc = pango_font_description_from_string (font_name);
text: Update actors using the default font If a ClutterText actor is using the default font from the backend then we should track font name changes and update it accordingly. This only applies to ClutterText actors with the :font-name property unset or explicitly set to NULL.
2010-06-26 14:49:15 +00:00
priv->is_default_font = TRUE;
Correctly initialize the initial state of ClutterText Some of the values in ClutterText have an initial state that does not match a zero-ed out ClutterTextPrivate structure.
2008-12-11 11:35:52 +00:00
Initialize the cursor position By default, the cursor position is initialized to -1, meaning "place the cursor always at the end of the text".
2008-12-11 11:42:33 +00:00
priv->position = -1;
General whitespace fixes in ClutterText Let's keep whitespace fixes to their own commit to avoid polluting git-blame.
2008-12-11 11:48:17 +00:00
priv->selection_bound = -1;
Initialize the cursor position By default, the cursor position is initialized to -1, meaning "place the cursor always at the end of the text".
2008-12-11 11:42:33 +00:00
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
priv->x_pos = -1;
priv->cursor_visible = TRUE;
priv->editable = FALSE;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
priv->selectable = TRUE;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
priv->selection_color_set = FALSE;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
priv->cursor_color_set = FALSE;
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
priv->selected_text_color_set = FALSE;
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
priv->preedit_set = FALSE;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
priv->password_char = 0;
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
priv->show_password_hint = password_hint_time > 0;
priv->password_hint_timeout = password_hint_time;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
clutter-text: new clutter_text_get_layout_offsets API This new function can be used to retrieve the coordinates where the ClutterText will draw the PangoLayout representing the text. http://bugzilla.clutter-project.org/show_bug.cgi?id=2553
2011-02-04 11:33:53 +00:00
priv->text_y = 0;
Use units in position_to_coords() We loose precision with a direct conversion for PangoUnits to pixels, so we should do the conversion as needed, inside the callers of clutter_text_position_to_coords().
2008-12-15 18:24:42 +00:00
priv->cursor_size = DEFAULT_CURSOR_SIZE;
Listen for the font-changed signal on the backend in ClutterText Whenever a ClutterText is created it now connects to the font-changed signal. When it is emitted the layout cache is dirtied and a relayout is queued. That way changes to the font options or resolution will cause an immediate update to the labels in the scene.
2009-01-27 16:47:20 +00:00
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
priv->settings_changed_id =
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
g_signal_connect_swapped (clutter_get_default_backend (),
text: Use the ::settings-changed signal Instead of the ::font-changed one.
2010-06-28 09:43:13 +00:00
"settings-changed",
text: Implement password hint A ClutterText in password mode should have the ability to show the last input character. This feature allows easier password entry on platforms with unreliable keyboards, such as touchscreens or small devices. https://bugzilla.gnome.org/show_bug.cgi?id=652588
2011-09-19 15:44:22 +00:00
G_CALLBACK (clutter_text_settings_changed_cb),
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
self);
text: Dirty layout cache on text direction changes When the text direction changes we should evict the cached layouts to avoid stale entries in case the direction change produces a layout with the same size.
2009-11-10 12:18:32 +00:00
priv->direction_changed_id =
g_signal_connect (self, "notify::text-direction",
G_CALLBACK (clutter_text_direction_changed_cb),
NULL);
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
priv->input_focus = clutter_text_input_focus_new (self);
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
}
[docs] Add more gtk-doc annotations for ClutterText Document the ClutterText constructors and the :editable, :selectable and :activatable properties accessors.
2008-12-16 11:52:57 +00:00
/**
* clutter_text_new:
*
* Creates a new #ClutterText actor. This actor can be used to
* display and edit text.
*
* Return value: the newly created #ClutterText actor
*
* Since: 1.0
*/
Add missing basic constructor ClutterText should have an empty constructor, mostly for bindings to use, that just proxies call to g_object_new() without setting any property.
2008-12-11 11:43:37 +00:00
ClutterActor *
clutter_text_new (void)
{
return g_object_new (CLUTTER_TYPE_TEXT, NULL);
}
[docs] Add more gtk-doc annotations for ClutterText Document the ClutterText constructors and the :editable, :selectable and :activatable properties accessors.
2008-12-16 11:52:57 +00:00
/**
* clutter_text_new_full:
* @font_name: a string with a font description
* @text: the contents of the actor
* @color: the color to be used to render @text
*
* Creates a new #ClutterText actor, using @font_name as the font
* description; @text will be used to set the contents of the actor;
* and @color will be used as the color to render @text.
*
* This function is equivalent to calling clutter_text_new(),
* clutter_text_set_font_name(), clutter_text_set_text() and
* clutter_text_set_color().
*
* Return value: the newly created #ClutterText actor
*
* Since: 1.0
*/
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
ClutterActor *
clutter_text_new_full (const gchar *font_name,
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
const gchar *text,
const ClutterColor *color)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
return g_object_new (CLUTTER_TYPE_TEXT,
"font-name", font_name,
"text", text,
"color", color,
NULL);
}
[docs] Add more gtk-doc annotations for ClutterText Document the ClutterText constructors and the :editable, :selectable and :activatable properties accessors.
2008-12-16 11:52:57 +00:00
/**
* clutter_text_new_with_text:
introspection: add missing introspection data from Vala bindings https://bugzilla.gnome.org/show_bug.cgi?id=655387
2011-07-27 07:14:10 +00:00
* @font_name: (allow-none): a string with a font description
[docs] Add more gtk-doc annotations for ClutterText Document the ClutterText constructors and the :editable, :selectable and :activatable properties accessors.
2008-12-16 11:52:57 +00:00
* @text: the contents of the actor
*
* Creates a new #ClutterText actor, using @font_name as the font
* description; @text will be used to set the contents of the actor.
*
* This function is equivalent to calling clutter_text_new(),
* clutter_text_set_font_name(), and clutter_text_set_text().
*
* Return value: the newly created #ClutterText actor
*
* Since: 1.0
*/
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
ClutterActor *
clutter_text_new_with_text (const gchar *font_name,
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
const gchar *text)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
return g_object_new (CLUTTER_TYPE_TEXT,
"font-name", font_name,
"text", text,
NULL);
}
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
static ClutterTextBuffer*
get_buffer (ClutterText *self)
{
ClutterTextPrivate *priv = self->priv;
if (priv->buffer == NULL)
{
ClutterTextBuffer *buffer;
buffer = clutter_text_buffer_new ();
clutter_text_set_buffer (self, buffer);
g_object_unref (buffer);
}
return priv->buffer;
}
/* GtkEntryBuffer signal handlers
*/
static void
buffer_inserted_text (ClutterTextBuffer *buffer,
guint position,
const gchar *chars,
guint n_chars,
ClutterText *self)
{
ClutterTextPrivate *priv;
gint new_position;
gint new_selection_bound;
priv = self->priv;
if (priv->position >= 0 || priv->selection_bound >= 0)
{
new_position = priv->position;
new_selection_bound = priv->selection_bound;
if (position <= new_position)
new_position += n_chars;
if (position <= new_selection_bound)
new_selection_bound += n_chars;
if (priv->position != new_position || priv->selection_bound != new_selection_bound)
clutter_text_set_positions (self, new_position, new_selection_bound);
}
/* TODO: What are we supposed to with the out value of position? */
}
static void
buffer_deleted_text (ClutterTextBuffer *buffer,
guint position,
guint n_chars,
ClutterText *self)
{
ClutterTextPrivate *priv;
gint new_position;
gint new_selection_bound;
priv = self->priv;
if (priv->position >= 0 || priv->selection_bound >= 0)
{
new_position = priv->position;
new_selection_bound = priv->selection_bound;
if (position < new_position)
new_position -= n_chars;
if (position < new_selection_bound)
new_selection_bound -= n_chars;
if (priv->position != new_position || priv->selection_bound != new_selection_bound)
clutter_text_set_positions (self, new_position, new_selection_bound);
}
}
static void
buffer_notify_text (ClutterTextBuffer *buffer,
GParamSpec *spec,
ClutterText *self)
{
g_object_freeze_notify (G_OBJECT (self));
clutter_text_dirty_cache (self);
clutter_actor_queue_relayout (CLUTTER_ACTOR (self));
g_signal_emit (self, text_signals[TEXT_CHANGED], 0);
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_TEXT]);
g_object_thaw_notify (G_OBJECT (self));
}
static void
buffer_notify_max_length (ClutterTextBuffer *buffer,
GParamSpec *spec,
ClutterText *self)
{
g_object_notify (G_OBJECT (self), "max-length");
}
static void
buffer_connect_signals (ClutterText *self)
{
ClutterTextPrivate *priv = self->priv;
g_signal_connect (priv->buffer, "inserted-text", G_CALLBACK (buffer_inserted_text), self);
g_signal_connect (priv->buffer, "deleted-text", G_CALLBACK (buffer_deleted_text), self);
g_signal_connect (priv->buffer, "notify::text", G_CALLBACK (buffer_notify_text), self);
g_signal_connect (priv->buffer, "notify::max-length", G_CALLBACK (buffer_notify_max_length), self);
}
static void
buffer_disconnect_signals (ClutterText *self)
{
ClutterTextPrivate *priv = self->priv;
g_signal_handlers_disconnect_by_func (priv->buffer, buffer_inserted_text, self);
g_signal_handlers_disconnect_by_func (priv->buffer, buffer_deleted_text, self);
g_signal_handlers_disconnect_by_func (priv->buffer, buffer_notify_text, self);
g_signal_handlers_disconnect_by_func (priv->buffer, buffer_notify_max_length, self);
}
/**
* clutter_text_new_with_buffer:
* @buffer: The buffer to use for the new #ClutterText.
*
* Creates a new entry with the specified text buffer.
*
* Return value: a new #ClutterText
*
Annotate all functions available since 1.10
2012-02-27 16:31:53 +00:00
* Since: 1.10
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
*/
ClutterActor *
clutter_text_new_with_buffer (ClutterTextBuffer *buffer)
{
g_return_val_if_fail (CLUTTER_IS_TEXT_BUFFER (buffer), NULL);
return g_object_new (CLUTTER_TYPE_TEXT, "buffer", buffer, NULL);
}
/**
* clutter_text_get_buffer:
* @self: a #ClutterText
*
* Get the #ClutterTextBuffer object which holds the text for
* this widget.
*
* Returns: (transfer none): A #GtkEntryBuffer object.
*
Annotate all functions available since 1.10
2012-02-27 16:31:53 +00:00
* Since: 1.10
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
*/
ClutterTextBuffer*
clutter_text_get_buffer (ClutterText *self)
{
g_return_val_if_fail (CLUTTER_IS_TEXT (self), NULL);
return get_buffer (self);
}
/**
* clutter_text_set_buffer:
* @self: a #ClutterText
* @buffer: a #ClutterTextBuffer
*
* Set the #ClutterTextBuffer object which holds the text for
* this widget.
*
Annotate all functions available since 1.10
2012-02-27 16:31:53 +00:00
* Since: 1.10
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
*/
void
clutter_text_set_buffer (ClutterText *self,
ClutterTextBuffer *buffer)
{
ClutterTextPrivate *priv;
GObject *obj;
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
if (buffer)
{
g_return_if_fail (CLUTTER_IS_TEXT_BUFFER (buffer));
g_object_ref (buffer);
}
if (priv->buffer)
{
buffer_disconnect_signals (self);
g_object_unref (priv->buffer);
}
priv->buffer = buffer;
if (priv->buffer)
buffer_connect_signals (self);
obj = G_OBJECT (self);
g_object_freeze_notify (obj);
g_object_notify (obj, "buffer");
g_object_notify (obj, "text");
g_object_notify (obj, "max-length");
g_object_thaw_notify (obj);
}
[docs] Add more gtk-doc annotations for ClutterText Document the ClutterText constructors and the :editable, :selectable and :activatable properties accessors.
2008-12-16 11:52:57 +00:00
/**
* clutter_text_set_editable:
* @self: a #ClutterText
* @editable: whether the #ClutterText should be editable
*
* Sets whether the #ClutterText actor should be editable.
*
* An editable #ClutterText with key focus set using
docs: Fixes for cross-references
2011-09-12 12:12:14 +00:00
* clutter_actor_grab_key_focus() or clutter_stage_set_key_focus()
[docs] Add more gtk-doc annotations for ClutterText Document the ClutterText constructors and the :editable, :selectable and :activatable properties accessors.
2008-12-16 11:52:57 +00:00
* will receive key events and will update its contents accordingly.
*
* Since: 1.0
*/
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
void
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
clutter_text_set_editable (ClutterText *self,
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
gboolean editable)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
ClutterBackend *backend = clutter_get_default_backend ();
ClutterInputMethod *method = clutter_backend_get_input_method (backend);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
ClutterTextPrivate *priv;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
if (priv->editable != editable)
{
priv->editable = editable;
clutter: Implement ClutterInputFocus subclass for ClutterText This only applies when the actor is editable. This object will allow editable ClutterText instances to interact with the input method.
2017-12-06 11:49:34 +00:00
if (method)
{
if (!priv->editable && clutter_input_focus_is_focused (priv->input_focus))
clutter_input_method_focus_out (method);
else if (priv->has_focus)
clutter_input_method_focus_in (method, priv->input_focus);
}
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
clutter_text_queue_redraw (CLUTTER_ACTOR (self));
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_EDITABLE]);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
[docs] Add more gtk-doc annotations for ClutterText Document the ClutterText constructors and the :editable, :selectable and :activatable properties accessors.
2008-12-16 11:52:57 +00:00
/**
* clutter_text_get_editable:
* @self: a #ClutterText
*
* Retrieves whether a #ClutterText is editable or not.
*
* Return value: %TRUE if the actor is editable
*
* Since: 1.0
*/
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
gboolean
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
clutter_text_get_editable (ClutterText *self)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
g_return_val_if_fail (CLUTTER_IS_TEXT (self), FALSE);
return self->priv->editable;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
[docs] Add more gtk-doc annotations for ClutterText Document the ClutterText constructors and the :editable, :selectable and :activatable properties accessors.
2008-12-16 11:52:57 +00:00
/**
* clutter_text_set_selectable:
* @self: a #ClutterText
* @selectable: whether the #ClutterText actor should be selectable
*
* Sets whether a #ClutterText actor should be selectable.
*
* A selectable #ClutterText will allow selecting its contents using
* the pointer or the keyboard.
*
* Since: 1.0
*/
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
void
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
clutter_text_set_selectable (ClutterText *self,
gboolean selectable)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
ClutterTextPrivate *priv;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
if (priv->selectable != selectable)
{
priv->selectable = selectable;
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
clutter_text_queue_redraw (CLUTTER_ACTOR (self));
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_SELECTABLE]);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
[docs] Add more gtk-doc annotations for ClutterText Document the ClutterText constructors and the :editable, :selectable and :activatable properties accessors.
2008-12-16 11:52:57 +00:00
/**
* clutter_text_get_selectable:
* @self: a #ClutterText
*
* Retrieves whether a #ClutterText is selectable or not.
*
* Return value: %TRUE if the actor is selectable
*
* Since: 1.0
*/
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
gboolean
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
clutter_text_get_selectable (ClutterText *self)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
g_return_val_if_fail (CLUTTER_IS_TEXT (self), TRUE);
return self->priv->selectable;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
[docs] Add more gtk-doc annotations for ClutterText Document the ClutterText constructors and the :editable, :selectable and :activatable properties accessors.
2008-12-16 11:52:57 +00:00
/**
* clutter_text_set_activatable:
* @self: a #ClutterText
* @activatable: whether the #ClutterText actor should be activatable
*
* Sets whether a #ClutterText actor should be activatable.
*
* An activatable #ClutterText actor will emit the #ClutterText::activate
* signal whenever the 'Enter' (or 'Return') key is pressed; if it is not
* activatable, a new line will be appended to the current content.
*
* An activatable #ClutterText must also be set as editable using
* clutter_text_set_editable().
*
* Since: 1.0
*/
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
void
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
clutter_text_set_activatable (ClutterText *self,
gboolean activatable)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
ClutterTextPrivate *priv;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
if (priv->activatable != activatable)
{
priv->activatable = activatable;
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
clutter_text_queue_redraw (CLUTTER_ACTOR (self));
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_ACTIVATABLE]);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
[docs] Add more gtk-doc annotations for ClutterText Document the ClutterText constructors and the :editable, :selectable and :activatable properties accessors.
2008-12-16 11:52:57 +00:00
/**
* clutter_text_get_activatable:
* @self: a #ClutterText
*
* Retrieves whether a #ClutterText is activatable or not.
*
* Return value: %TRUE if the actor is activatable
*
* Since: 1.0
*/
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
gboolean
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
clutter_text_get_activatable (ClutterText *self)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
g_return_val_if_fail (CLUTTER_IS_TEXT (self), TRUE);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
return self->priv->activatable;
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Add ClutterText::activate() The clutter_text_activate() function will emit the ::activate signal if the :activatable property is set. This function is useful for subclasses or application code, for example if we are going to use ::captured-event or ::key-press-event signal handlers to intercept the Return key and emit the ::activate signal ourselves.
2008-12-16 12:02:58 +00:00
/**
* clutter_text_activate:
* @self: a #ClutterText
*
* Emits the #ClutterText::activate signal, if @self has been set
* as activatable using clutter_text_set_activatable().
*
* This function can be used to emit the ::activate signal inside
* a #ClutterActor::captured-event or #ClutterActor::key-press-event
* signal handlers before the default signal handler for the
* #ClutterText is invoked.
*
* Return value: %TRUE if the ::activate signal has been emitted,
* and %FALSE otherwise
*
* Since: 1.0
*/
gboolean
clutter_text_activate (ClutterText *self)
{
ClutterTextPrivate *priv;
g_return_val_if_fail (CLUTTER_IS_TEXT (self), FALSE);
priv = self->priv;
if (priv->activatable)
{
g_signal_emit (self, text_signals[ACTIVATE], 0);
return TRUE;
}
return FALSE;
}
[docs] Add more gtk-doc annotations Almost reaching full documentation.
2008-12-16 12:25:15 +00:00
/**
* clutter_text_set_cursor_visible:
* @self: a #ClutterText
* @cursor_visible: whether the cursor should be visible
*
* Sets whether the cursor of a #ClutterText actor should be
* visible or not.
*
* The color of the cursor will be the same as the text color
* unless clutter_text_set_cursor_color() has been called.
*
* The size of the cursor can be set using clutter_text_set_cursor_size().
*
* The position of the cursor can be changed programmatically using
* clutter_text_set_cursor_position().
*
* Since: 1.0
*/
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
void
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
clutter_text_set_cursor_visible (ClutterText *self,
gboolean cursor_visible)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
ClutterTextPrivate *priv;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
text: Enforce boolean value We store the cursor-visible value in a bit field, which means that we need to enforce the argument for the setter to either 0 or 1 in order to fit.
2015-11-30 13:47:57 +00:00
cursor_visible = !!cursor_visible;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
if (priv->cursor_visible != cursor_visible)
{
priv->cursor_visible = cursor_visible;
text: relayout on cursor visibility change When the cursor visibility changes, we have to relayout the ClutterText actor instead of just redrawing it - as the cursor changes the PangoLayout size, a size request cycle is needed. https://bugzilla.gnome.org/show_bug.cgi?id=702610
2013-06-18 23:37:31 +00:00
clutter_text_dirty_cache (self);
clutter_actor_queue_relayout (CLUTTER_ACTOR (self));
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_CURSOR_VISIBLE]);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
[docs] Add more gtk-doc annotations Almost reaching full documentation.
2008-12-16 12:25:15 +00:00
/**
* clutter_text_get_cursor_visible:
* @self: a #ClutterText
*
* Retrieves whether the cursor of a #ClutterText actor is visible.
*
* Return value: %TRUE if the cursor is visible
*
* Since: 1.0
*/
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
gboolean
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
clutter_text_get_cursor_visible (ClutterText *self)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
g_return_val_if_fail (CLUTTER_IS_TEXT (self), TRUE);
return self->priv->cursor_visible;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
[docs] Add more gtk-doc annotations Almost reaching full documentation.
2008-12-16 12:25:15 +00:00
/**
* clutter_text_set_cursor_color:
* @self: a #ClutterText
text: Add missing introspection annotations Add allow-none annotations where appropriate
2012-05-14 23:44:51 +00:00
* @color: (allow-none): the color of the cursor, or %NULL to unset it
[docs] Add more gtk-doc annotations Almost reaching full documentation.
2008-12-16 12:25:15 +00:00
*
* Sets the color of the cursor of a #ClutterText actor.
*
* If @color is %NULL, the cursor color will be the same as the
* text color.
*
* Since: 1.0
*/
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
void
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
clutter_text_set_cursor_color (ClutterText *self,
const ClutterColor *color)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
g_return_if_fail (CLUTTER_IS_TEXT (self));
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
text: Enable implicit color animations Implement the ClutterAnimatable interface to enable implicit animations for :color, :cursor-color, :selected-text-color and :selection-color. https://bugzilla.gnome.org/show_bug.cgi?id=676963
2012-05-28 12:02:25 +00:00
clutter_text_set_color_animated (self, obj_props[PROP_CURSOR_COLOR], color);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
[docs] Add more gtk-doc annotations Almost reaching full documentation.
2008-12-16 12:25:15 +00:00
/**
* clutter_text_get_cursor_color:
* @self: a #ClutterText
introspection: add missing introspection data from Vala bindings https://bugzilla.gnome.org/show_bug.cgi?id=655387
2011-07-27 07:14:10 +00:00
* @color: (out): return location for a #ClutterColor
[docs] Add more gtk-doc annotations Almost reaching full documentation.
2008-12-16 12:25:15 +00:00
*
* Retrieves the color of the cursor of a #ClutterText actor.
*
* Since: 1.0
*/
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
void
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
clutter_text_get_cursor_color (ClutterText *self,
ClutterColor *color)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
ClutterTextPrivate *priv;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
g_return_if_fail (CLUTTER_IS_TEXT (self));
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
g_return_if_fail (color != NULL);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
priv = self->priv;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
*color = priv->cursor_color;
}
Add ClutterText::set_selection() The clutter_text_set_selection() function is a convenience method for setting the cursor position and the selection boundary to a given position in a single call, with sanity checks for the positions.
2008-12-16 12:41:20 +00:00
/**
* clutter_text_set_selection:
* @self: a #ClutterText
* @start_pos: start of the selection, in characters
* @end_pos: end of the selection, in characters
*
* Selects the region of text between @start_pos and @end_pos.
*
* This function changes the position of the cursor to match
* @start_pos and the selection bound to match @end_pos.
*
* Since: 1.0
*/
void
clutter_text_set_selection (ClutterText *self,
gssize start_pos,
gssize end_pos)
{
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
guint n_chars;
Add ClutterText::set_selection() The clutter_text_set_selection() function is a convenience method for setting the cursor position and the selection boundary to a given position in a single call, with sanity checks for the positions.
2008-12-16 12:41:20 +00:00
g_return_if_fail (CLUTTER_IS_TEXT (self));
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
n_chars = clutter_text_buffer_get_length (get_buffer (self));
Add ClutterText::set_selection() The clutter_text_set_selection() function is a convenience method for setting the cursor position and the selection boundary to a given position in a single call, with sanity checks for the positions.
2008-12-16 12:41:20 +00:00
if (end_pos < 0)
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
end_pos = n_chars;
Add ClutterText::set_selection() The clutter_text_set_selection() function is a convenience method for setting the cursor position and the selection boundary to a given position in a single call, with sanity checks for the positions.
2008-12-16 12:41:20 +00:00
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
start_pos = MIN (n_chars, start_pos);
end_pos = MIN (n_chars, end_pos);
Add ClutterText::set_selection() The clutter_text_set_selection() function is a convenience method for setting the cursor position and the selection boundary to a given position in a single call, with sanity checks for the positions.
2008-12-16 12:41:20 +00:00
Fix problems with "position" and "selection-bound" change notification Added a "selection-bound" notify on clutter_text_clear_selection as it changes the value. Added utility function clutter_text_set_positions, in order to change both cursor position and selection bound inside a g_object_[freeze/thaw]_notify block Added g_object_[freeze/thaw]_notify in other functions that changes both cursor position and selection bound Solves http://bugzilla.openedhand.com/show_bug.cgi?id=1955
2010-01-25 15:13:58 +00:00
clutter_text_set_positions (self, start_pos, end_pos);
Add ClutterText::set_selection() The clutter_text_set_selection() function is a convenience method for setting the cursor position and the selection boundary to a given position in a single call, with sanity checks for the positions.
2008-12-16 12:41:20 +00:00
}
Fix ClutterText::get_selection() The clutter_text_get_selection() function was not checking the passed argument, and was still accessing the contents of the Text actor using clutter_text_get_text(). This commit also adds the last few gtk-doc annotations missing from ClutterText.
2008-12-16 12:25:45 +00:00
/**
* clutter_text_get_selection:
* @self: a #ClutterText
*
* Retrieves the currently selected text.
*
* Return value: a newly allocated string containing the currently
* selected text, or %NULL. Use g_free() to free the returned
* string.
*
* Since: 1.0
*/
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
gchar *
Fix ClutterText::get_selection() The clutter_text_get_selection() function was not checking the passed argument, and was still accessing the contents of the Text actor using clutter_text_get_text(). This commit also adds the last few gtk-doc annotations missing from ClutterText.
2008-12-16 12:25:45 +00:00
clutter_text_get_selection (ClutterText *self)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
ClutterTextPrivate *priv;
Fix ClutterText::get_selection() The clutter_text_get_selection() function was not checking the passed argument, and was still accessing the contents of the Text actor using clutter_text_get_text(). This commit also adds the last few gtk-doc annotations missing from ClutterText.
2008-12-16 12:25:45 +00:00
gchar *str;
gint len;
gint start_index, end_index;
gint start_offset, end_offset;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
const gchar *text;
Fix ClutterText::get_selection() The clutter_text_get_selection() function was not checking the passed argument, and was still accessing the contents of the Text actor using clutter_text_get_text(). This commit also adds the last few gtk-doc annotations missing from ClutterText.
2008-12-16 12:25:45 +00:00
g_return_val_if_fail (CLUTTER_IS_TEXT (self), NULL);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Fix ClutterText::get_selection() The clutter_text_get_selection() function was not checking the passed argument, and was still accessing the contents of the Text actor using clutter_text_get_text(). This commit also adds the last few gtk-doc annotations missing from ClutterText.
2008-12-16 12:25:45 +00:00
priv = self->priv;
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
start_index = priv->position;
end_index = priv->selection_bound;
if (end_index == start_index)
return g_strdup ("");
Fix line start and line end key binding behaviour Another fix for the key navigation behaviour around the zeroeth glyph in the layout. This commit adds a fast path for for the zero index when the cursor position is set as zero, in case we are using the line-start or line-end key bindings, similarly to what we did in commit be64cbcdc22952ce2fa9f902e153e3bd9f4a08c9 for the move-up and move-down bindings.
2008-12-16 10:15:57 +00:00
[text] Ensure clutter_text_get_selection copes with start/end positions of -1 I was seeing clutter_text_get_selection trying to malloc up to 4Gb due to unexpected negative arithmetic for the start/end offsets which resulted in a crash. This just tests for positions of -1 before deciding if the start/end positions need to be swapped. The conversion from position to byte offset already works with -1.
2009-05-13 11:11:54 +00:00
if ((end_index != -1 && end_index < start_index) ||
start_index == -1)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
gint temp = start_index;
start_index = end_index;
end_index = temp;
}
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
text = clutter_text_buffer_get_text (get_buffer (self));
start_offset = offset_to_bytes (text, start_index);
end_offset = offset_to_bytes (text, end_index);
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
len = end_offset - start_offset;
str = g_malloc (len + 1);
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
g_utf8_strncpy (str, text + start_offset, end_index - start_index);
Fix ClutterText::get_selection() The clutter_text_get_selection() function was not checking the passed argument, and was still accessing the contents of the Text actor using clutter_text_get_text(). This commit also adds the last few gtk-doc annotations missing from ClutterText.
2008-12-16 12:25:45 +00:00
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
return str;
}
Fix ClutterText::get_selection() The clutter_text_get_selection() function was not checking the passed argument, and was still accessing the contents of the Text actor using clutter_text_get_text(). This commit also adds the last few gtk-doc annotations missing from ClutterText.
2008-12-16 12:25:45 +00:00
/**
* clutter_text_set_selection_bound:
* @self: a #ClutterText
* @selection_bound: the position of the end of the selection, in characters
*
* Sets the other end of the selection, starting from the current
* cursor position.
*
* If @selection_bound is -1, the selection unset.
*
* Since: 1.0
*/
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
void
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter_text_set_selection_bound (ClutterText *self,
gint selection_bound)
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
{
ClutterTextPrivate *priv;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_return_if_fail (CLUTTER_IS_TEXT (self));
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
priv = self->priv;
if (priv->selection_bound != selection_bound)
{
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
gint len = clutter_text_buffer_get_length (get_buffer (self));;
[text] Check text length in ::button-press-event Bug 1529 - Selection bound out of sync with an empty Text actor When the user clicks on a Text actor the cursor position and the selection bound are set using bytes_to_offset(); if the Text is empty, this means placing them both to 0. Setting the selection bound to 0 means that when the user inserts a character by typing it into the Text, the selection will be [0,1]; this will select the first character, which will then be overwritten when typing a new character. The Text actor should, instead, check if there are no contents and set the cursor position and the selection bound to -1. The clutter_text_set_selection_bound() method should also validate the value passed, in case it's bigger than the text lenght, or smaller than -1.
2009-03-30 06:54:42 +00:00
if (selection_bound < 0 || selection_bound >= len)
priv->selection_bound = -1;
else
priv->selection_bound = selection_bound;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
clutter_text_queue_redraw (CLUTTER_ACTOR (self));
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_SELECTION_BOUND]);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
}
Fix ClutterText::get_selection() The clutter_text_get_selection() function was not checking the passed argument, and was still accessing the contents of the Text actor using clutter_text_get_text(). This commit also adds the last few gtk-doc annotations missing from ClutterText.
2008-12-16 12:25:45 +00:00
/**
* clutter_text_get_selection_bound:
* @self: a #ClutterText
*
* Retrieves the other end of the selection of a #ClutterText actor,
* in characters from the current cursor position.
*
* Return value: the position of the other end of the selection
*
* Since: 1.0
*/
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
gint
clutter_text_get_selection_bound (ClutterText *self)
{
g_return_val_if_fail (CLUTTER_IS_TEXT (self), -1);
return self->priv->selection_bound;
}
Initial import of the Text actor from Tidy The TidyText actor is meant as a replacement for both ClutterLabel and ClutterText. Any text-displaying and editing actor should derive from ClutterText and implement the various visual cues to differentiate the editable from the non-editable state. Those visual cues usually belong to a high-level toolkit, especially if themeing is involved.
2008-12-11 11:12:48 +00:00
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
/**
* clutter_text_set_selection_color:
* @self: a #ClutterText
text: Add missing introspection annotations Add allow-none annotations where appropriate
2012-05-14 23:44:51 +00:00
* @color: (allow-none): the color of the selection, or %NULL to unset it
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
*
* Sets the color of the selection of a #ClutterText actor.
*
* If @color is %NULL, the selection color will be the same as the
* cursor color, or if no cursor color is set either then it will be
* the same as the text color.
*
* Since: 1.0
*/
void
clutter_text_set_selection_color (ClutterText *self,
const ClutterColor *color)
{
g_return_if_fail (CLUTTER_IS_TEXT (self));
text: Enable implicit color animations Implement the ClutterAnimatable interface to enable implicit animations for :color, :cursor-color, :selected-text-color and :selection-color. https://bugzilla.gnome.org/show_bug.cgi?id=676963
2012-05-28 12:02:25 +00:00
clutter_text_set_color_animated (self, obj_props[PROP_SELECTION_COLOR],
color);
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
}
/**
* clutter_text_get_selection_color:
* @self: a #ClutterText
annotations: Use caller-allocates for color getters This should avoid a separate initialization of a ClutterColor in language bindings.
2011-02-14 18:36:51 +00:00
* @color: (out caller-allocates): return location for a #ClutterColor
[clutter-text] Add a separate property for the selection color Adds a new property so that the selection color can be different from the cursor color. If no selection color is specified it will use the cursor color as before. If no cursor color is specified either it will use the text color.
2009-04-06 14:22:31 +00:00
*
* Retrieves the color of the selection of a #ClutterText actor.
*
* Since: 1.0
*/
void
clutter_text_get_selection_color (ClutterText *self,
ClutterColor *color)
{
ClutterTextPrivate *priv;
g_return_if_fail (CLUTTER_IS_TEXT (self));
g_return_if_fail (color != NULL);
priv = self->priv;
*color = priv->selection_color;
}
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
/**
* clutter_text_set_selected_text_color:
* @self: a #ClutterText
text: Add missing introspection annotations Add allow-none annotations where appropriate
2012-05-14 23:44:51 +00:00
* @color: (allow-none): the selected text color, or %NULL to unset it
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
*
* Sets the selected text color of a #ClutterText actor.
*
* If @color is %NULL, the selected text color will be the same as the
* selection color, which then falls back to cursor, and then text color.
*
* Since: 1.8
*/
void
clutter_text_set_selected_text_color (ClutterText *self,
const ClutterColor *color)
{
g_return_if_fail (CLUTTER_IS_TEXT (self));
text: Enable implicit color animations Implement the ClutterAnimatable interface to enable implicit animations for :color, :cursor-color, :selected-text-color and :selection-color. https://bugzilla.gnome.org/show_bug.cgi?id=676963
2012-05-28 12:02:25 +00:00
clutter_text_set_color_animated (self, obj_props[PROP_SELECTED_TEXT_COLOR],
color);
clutter-text: Add a selected-text-color http://bugzilla.clutter-project.org/show_bug.cgi?id=2595
2011-03-02 17:02:56 +00:00
}
/**
* clutter_text_get_selected_text_color:
* @self: a #ClutterText
* @color: (out caller-allocates): return location for a #ClutterColor
*
* Retrieves the color of selected text of a #ClutterText actor.
*
* Since: 1.8
*/
void
clutter_text_get_selected_text_color (ClutterText *self,
ClutterColor *color)
{
ClutterTextPrivate *priv;
g_return_if_fail (CLUTTER_IS_TEXT (self));
g_return_if_fail (color != NULL);
priv = self->priv;
*color = priv->selected_text_color;
}
text: Add :font-description High level toolkits might wish to construct a PangoFontDescription and then set it directly on a ClutterText actor proxy or sub-class. ClutterText should have a :font-description property to set (and get) the PangoFontDescription. http://bugzilla.openedhand.com/show_bug.cgi?id=1960
2010-02-03 14:35:45 +00:00
/**
* clutter_text_set_font_description:
* @self: a #ClutterText
* @font_desc: a #PangoFontDescription
*
* Sets @font_desc as the font description for a #ClutterText
*
* The #PangoFontDescription is copied by the #ClutterText actor
* so you can safely call pango_font_description_free() on it after
* calling this function.
*
* Since: 1.2
*/
void
clutter_text_set_font_description (ClutterText *self,
PangoFontDescription *font_desc)
{
g_return_if_fail (CLUTTER_IS_TEXT (self));
clutter-text: prevent reset of user set font descriptions on dpi changes When setting the font using clutter_text_set_font_description(), the font settings on a ClutterText actor can be reset when there is a dpi changes signaled by the backend. https://bugzilla.gnome.org/show_bug.cgi?id=702016
2013-06-11 13:01:30 +00:00
clutter_text_set_font_description_internal (self, font_desc,
font_desc == NULL);
text: Add :font-description High level toolkits might wish to construct a PangoFontDescription and then set it directly on a ClutterText actor proxy or sub-class. ClutterText should have a :font-description property to set (and get) the PangoFontDescription. http://bugzilla.openedhand.com/show_bug.cgi?id=1960
2010-02-03 14:35:45 +00:00
}
/**
* clutter_text_get_font_description:
* @self: a #ClutterText
*
* Retrieves the #PangoFontDescription used by @self
*
* Return value: a #PangoFontDescription. The returned value is owned
* by the #ClutterText actor and it should not be modified or freed
*
* Since: 1.2
*/
PangoFontDescription *
clutter_text_get_font_description (ClutterText *self)
{
g_return_val_if_fail (CLUTTER_IS_TEXT (self), NULL);
return self->priv->font_desc;
}
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
/**
* clutter_text_get_font_name:
* @self: a #ClutterText
*
* Retrieves the font name as set by clutter_text_set_font_name().
*
* Return value: a string containing the font name. The returned
* string is owned by the #ClutterText actor and should not be
* modified or freed
*
* Since: 1.0
*/
Eliminate G_CONST_RETURN The G_CONST_RETURN define in GLib is, and has always been, a bit fuzzy. We always used it to conform to the platform, at least for public-facing API. At first I assumed it has something to do with brain-damaged compilers or with weird platforms where const was not really supported; sadly, it's something much, much worse: it's a define that can be toggled at compile-time to remove const from the signature of public API. This is a truly terrifying feature that I assume was added in the past century, and whose inception clearly had something to do with massive doses of absynthe and opium — because any other explanation would make the existence of such a feature even worse than assuming drugs had anything to do with it. Anyway, and pleasing the gods, this dubious feature is being removed/deprecated in GLib; see bug: https://bugzilla.gnome.org/show_bug.cgi?id=644611 Before deprecation, though, we should just remove its usage from the whole API. We should especially remove its usage from Cally's internals, since there it never made sense in the first place.
2011-06-07 14:49:20 +00:00
const gchar *
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
clutter_text_get_font_name (ClutterText *text)
{
g_return_val_if_fail (CLUTTER_IS_TEXT (text), NULL);
return text->priv->font_name;
}
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
/**
* clutter_text_set_font_name:
* @self: a #ClutterText
text: Document and annotate :font-name for NULL values Update the documentation of :font-name, to make it clear that by setting it to NULL the Text actor will use the default font. Also, set the annotation for the @font_name argument of the setter to be allow-none, and allow passing NULL through bindings.
2010-06-26 22:05:36 +00:00
* @font_name: (allow-none): a font name, or %NULL to set the default font name
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
*
* Sets the font used by a #ClutterText. The @font_name string
Use the default font from the Backend Instead of storing the default font name and size as a pre-processor macro, use the newly added ClutterBackend API to retrieve the current default font from the backend.
2008-12-23 15:05:16 +00:00
* must either be %NULL, which means that the font name from the
* default #ClutterBackend will be used; or be something that can
* be parsed by the pango_font_description_from_string() function,
* like:
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
*
* |[
docs: Fix the examples for ClutterText.set_font_name() We shouldn't be using "pt": PangoFontDescription.from_string() assumes points, and only accepts "px" for absolute font sizes. https://bugzilla.gnome.org/show_bug.cgi?id=736826
2014-09-22 10:11:22 +00:00
* // Set the font to the system's Sans, 10 points
* clutter_text_set_font_name (text, "Sans 10");
*
* // Set the font to the system's Serif, 16 pixels
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
* clutter_text_set_font_name (text, "Serif 16px");
docs: Fix the examples for ClutterText.set_font_name() We shouldn't be using "pt": PangoFontDescription.from_string() assumes points, and only accepts "px" for absolute font sizes. https://bugzilla.gnome.org/show_bug.cgi?id=736826
2014-09-22 10:11:22 +00:00
*
* // Set the font to Helvetica, 10 points
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
* clutter_text_set_font_name (text, "Helvetica 10");
* ]|
*
* Since: 1.0
*/
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
void
Coding style consistency Channel mitch's spirit. This is also how I get to have the highest commit count on Clutter's repository.
2008-12-11 11:54:32 +00:00
clutter_text_set_font_name (ClutterText *self,
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
const gchar *font_name)
{
ClutterTextPrivate *priv;
PangoFontDescription *desc;
text: Update actors using the default font If a ClutterText actor is using the default font from the backend then we should track font name changes and update it accordingly. This only applies to ClutterText actors with the :font-name property unset or explicitly set to NULL.
2010-06-26 14:49:15 +00:00
gboolean is_default_font;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
Coding style consistency Channel mitch's spirit. This is also how I get to have the highest commit count on Clutter's repository.
2008-12-11 11:54:32 +00:00
g_return_if_fail (CLUTTER_IS_TEXT (self));
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
Use the default font from the Backend Instead of storing the default font name and size as a pre-processor macro, use the newly added ClutterBackend API to retrieve the current default font from the backend.
2008-12-23 15:05:16 +00:00
/* get the default font name from the backend */
text: Do not segfault with NULL :font-name Make sure that we have a fall back in place for the default font name string, and use g_strcmp0 to protect ourselves from NULL strings. http://bugzilla.clutter-project.org/show_bug.cgi?id=2417
2010-11-14 15:23:36 +00:00
if (font_name == NULL || font_name[0] == '\0')
text: Update actors using the default font If a ClutterText actor is using the default font from the backend then we should track font name changes and update it accordingly. This only applies to ClutterText actors with the :font-name property unset or explicitly set to NULL.
2010-06-26 14:49:15 +00:00
{
Do not use deprecated API internally
2010-09-10 13:27:37 +00:00
ClutterSettings *settings = clutter_settings_get_default ();
gchar *default_font_name = NULL;
text: Do not segfault with NULL :font-name Make sure that we have a fall back in place for the default font name string, and use g_strcmp0 to protect ourselves from NULL strings. http://bugzilla.clutter-project.org/show_bug.cgi?id=2417
2010-11-14 15:23:36 +00:00
g_object_get (settings, "font-name", &default_font_name, NULL);
if (default_font_name != NULL)
font_name = default_font_name;
else
{
/* last fallback */
text: Fix font fallback Spotted by Coverity. https://bugzilla.gnome.org/show_bug.cgi?id=689496
2012-12-01 02:39:10 +00:00
font_name = g_strdup ("Sans 12");
text: Do not segfault with NULL :font-name Make sure that we have a fall back in place for the default font name string, and use g_strcmp0 to protect ourselves from NULL strings. http://bugzilla.clutter-project.org/show_bug.cgi?id=2417
2010-11-14 15:23:36 +00:00
}
text: Update actors using the default font If a ClutterText actor is using the default font from the backend then we should track font name changes and update it accordingly. This only applies to ClutterText actors with the :font-name property unset or explicitly set to NULL.
2010-06-26 14:49:15 +00:00
is_default_font = TRUE;
}
else
is_default_font = FALSE;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
Coding style consistency Channel mitch's spirit. This is also how I get to have the highest commit count on Clutter's repository.
2008-12-11 11:54:32 +00:00
priv = self->priv;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
text: Do not segfault with NULL :font-name Make sure that we have a fall back in place for the default font name string, and use g_strcmp0 to protect ourselves from NULL strings. http://bugzilla.clutter-project.org/show_bug.cgi?id=2417
2010-11-14 15:23:36 +00:00
if (g_strcmp0 (priv->font_name, font_name) == 0)
Do not use deprecated API internally
2010-09-10 13:27:37 +00:00
goto out;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
desc = pango_font_description_from_string (font_name);
text: Clean up the set_font_description_internal() semantics The current semantics are ridiculous, and clearly a case of (mistaken) premature optimization. All setters should copy, not transfer ownership. https://bugzilla.gnome.org/show_bug.cgi?id=695119
2013-03-04 13:02:44 +00:00
if (desc == NULL)
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
{
g_warning ("Attempting to create a PangoFontDescription for "
Remove usage of the grave accent as quotation mark See: http://www.cl.cam.ac.uk/~mgk25/ucs/quotes.html This should make Thomas happy.
2009-03-17 14:12:01 +00:00
"font name '%s', but failed.",
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
font_name);
Do not use deprecated API internally
2010-09-10 13:27:37 +00:00
goto out;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
}
text: Add :font-description High level toolkits might wish to construct a PangoFontDescription and then set it directly on a ClutterText actor proxy or sub-class. ClutterText should have a :font-description property to set (and get) the PangoFontDescription. http://bugzilla.openedhand.com/show_bug.cgi?id=1960
2010-02-03 14:35:45 +00:00
/* this will set the font_name field as well */
clutter-text: prevent reset of user set font descriptions on dpi changes When setting the font using clutter_text_set_font_description(), the font settings on a ClutterText actor can be reset when there is a dpi changes signaled by the backend. https://bugzilla.gnome.org/show_bug.cgi?id=702016
2013-06-11 13:01:30 +00:00
clutter_text_set_font_description_internal (self, desc, is_default_font);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_FONT_NAME]);
Do not use deprecated API internally
2010-09-10 13:27:37 +00:00
text: Clean up the set_font_description_internal() semantics The current semantics are ridiculous, and clearly a case of (mistaken) premature optimization. All setters should copy, not transfer ownership. https://bugzilla.gnome.org/show_bug.cgi?id=695119
2013-03-04 13:02:44 +00:00
pango_font_description_free (desc);
Do not use deprecated API internally
2010-09-10 13:27:37 +00:00
out:
if (is_default_font)
g_free ((gchar *) font_name);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
}
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
/**
* clutter_text_get_text:
* @self: a #ClutterText
*
* Retrieves a pointer to the current contents of a #ClutterText
* actor.
*
* If you need a copy of the contents for manipulating, either
* use g_strdup() on the returned string, or use:
*
* |[
* copy = clutter_text_get_chars (text, 0, -1);
* ]|
*
* Which will return a newly allocated string.
*
text: Clear up priv->text checks The priv->text field cannot ever be NULL, so we don't need to check for that in a series of places. We also need to assert() that pre-condition in the couple of places where we set the contents of the ClutterText actor, namely in set_text_internal() and set_markup_internal(). Based on a patch by: Dan Winship <danw@gnome.org> http://bugzilla.clutter-project.org/show_bug.cgi?id=2629
2011-09-07 12:28:15 +00:00
* If the #ClutterText actor is empty, this function will return
* an empty string, and not %NULL.
*
* Return value: (transfer none): the contents of the actor. The returned
* string is owned by the #ClutterText actor and should never be modified
* or freed
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
*
* Since: 1.0
*/
Eliminate G_CONST_RETURN The G_CONST_RETURN define in GLib is, and has always been, a bit fuzzy. We always used it to conform to the platform, at least for public-facing API. At first I assumed it has something to do with brain-damaged compilers or with weird platforms where const was not really supported; sadly, it's something much, much worse: it's a define that can be toggled at compile-time to remove const from the signature of public API. This is a truly terrifying feature that I assume was added in the past century, and whose inception clearly had something to do with massive doses of absynthe and opium — because any other explanation would make the existence of such a feature even worse than assuming drugs had anything to do with it. Anyway, and pleasing the gods, this dubious feature is being removed/deprecated in GLib; see bug: https://bugzilla.gnome.org/show_bug.cgi?id=644611 Before deprecation, though, we should just remove its usage from the whole API. We should especially remove its usage from Cally's internals, since there it never made sense in the first place.
2011-06-07 14:49:20 +00:00
const gchar *
Coding style consistency Channel mitch's spirit. This is also how I get to have the highest commit count on Clutter's repository.
2008-12-11 11:54:32 +00:00
clutter_text_get_text (ClutterText *self)
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
{
Coding style consistency Channel mitch's spirit. This is also how I get to have the highest commit count on Clutter's repository.
2008-12-11 11:54:32 +00:00
g_return_val_if_fail (CLUTTER_IS_TEXT (self), NULL);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
return clutter_text_buffer_get_text (get_buffer (self));
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
}
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
static inline void
clutter_text_set_use_markup_internal (ClutterText *self,
gboolean use_markup)
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
{
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
ClutterTextPrivate *priv = self->priv;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
if (priv->use_markup != use_markup)
{
priv->use_markup = use_markup;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
text: Do not set the markup unconditionally When setting :use-markup we always pass the contents of the Text actor to clutter_text_set_markup_internal(); if string contains any markup, this ends up being parsed and used - even when :use-markup is set to FALSE. http://bugzilla.clutter-project.org/show_bug.cgi?id=2239
2010-08-06 16:04:37 +00:00
/* reset the attributes lists so that they can be
* re-generated
*/
if (priv->effective_attrs != NULL)
{
pango_attr_list_unref (priv->effective_attrs);
priv->effective_attrs = NULL;
}
if (priv->markup_attrs)
{
pango_attr_list_unref (priv->markup_attrs);
priv->markup_attrs = NULL;
}
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_USE_MARKUP]);
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
}
}
/**
* clutter_text_set_text:
* @self: a #ClutterText
text: Fix annotations Both set_text() and set_markup() have relaxed their preconditions on a non-NULL string as their argument, so we need to update the annotations.
2012-02-07 11:33:12 +00:00
* @text: (allow-none): the text to set. Passing %NULL is the same
* as passing "" (the empty string)
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
*
Allow NULL for clutter_text_set_text() As a convenience, if NULL is passed for the text argument of clutter_text_set_text() (and for consistency, clutter_text_set_markup()), treat that the same as "".
2009-02-27 16:56:39 +00:00
* Sets the contents of a #ClutterText actor.
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
*
text: Make the :text property not set the :use-markup one Currently, setting the :text property has the side-effect of setting the :use-markup property to FALSE. This prevents constructing a Text actor, or setting its properties, like: g_object_set (text, "use-markup", TRUE, "text", some_string, NULL); as the ordering becomes important. Unfortunately, the ordering of the properties cannot be enforced with ClutterScript or with language bindings. The documentation of the clutter_text_set_text() method should be expanded to properly specify that the set_text() method will change the :use-markup property to FALSE as a side effect.
2009-10-07 20:44:17 +00:00
* If the #ClutterText:use-markup property was set to %TRUE it
* will be reset to %FALSE as a side effect. If you want to
* maintain the #ClutterText:use-markup you should use the
* clutter_text_set_markup() function instead
*
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
* Since: 1.0
*/
void
clutter_text_set_text (ClutterText *self,
const gchar *text)
{
g_return_if_fail (CLUTTER_IS_TEXT (self));
text: Avoid changing the contents when possible An editable ClutterText will reset the selection and cursor whenever the contents are changed — even if those contents are the same. As this may confuse the user, we should check if we're setting the exact same string, and bail out if necessary.
2012-02-07 11:36:27 +00:00
/* if the text is editable (i.e. there is not markup flag to reset) then
* changing the contents will result in selection and cursor changes that
* we should avoid
*/
if (self->priv->editable)
{
ClutterText: Cannot pass NULL string to clutter_text_set_text() Passing a NULL buffer to clutter_text_set_text() does not behave the same way as passing an empty string "" (as specified in the documentation). This was working as expected previously, but somehow the behaviour changed at some point and created 2 new issues: - Passing a NULL pointer will not reset the string - If the ClutterText is editable, it will segfault in strcmp Validations have been added to prevent this. https://bugzilla.gnome.org/show_bug.cgi?id=675890
2012-05-11 17:26:50 +00:00
if (g_strcmp0 (clutter_text_buffer_get_text (get_buffer (self)), text) == 0)
text: Avoid changing the contents when possible An editable ClutterText will reset the selection and cursor whenever the contents are changed — even if those contents are the same. As this may confuse the user, we should check if we're setting the exact same string, and bail out if necessary.
2012-02-07 11:36:27 +00:00
return;
}
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
clutter_text_set_use_markup_internal (self, FALSE);
ClutterText: Cannot pass NULL string to clutter_text_set_text() Passing a NULL buffer to clutter_text_set_text() does not behave the same way as passing an empty string "" (as specified in the documentation). This was working as expected previously, but somehow the behaviour changed at some point and created 2 new issues: - Passing a NULL pointer will not reset the string - If the ClutterText is editable, it will segfault in strcmp Validations have been added to prevent this. https://bugzilla.gnome.org/show_bug.cgi?id=675890
2012-05-11 17:26:50 +00:00
clutter_text_buffer_set_text (get_buffer (self), text ? text : "", -1);
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
}
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
/**
* clutter_text_set_markup:
* @self: a #ClutterText
text: Fix annotations Both set_text() and set_markup() have relaxed their preconditions on a non-NULL string as their argument, so we need to update the annotations.
2012-02-07 11:33:12 +00:00
* @markup: (allow-none): a string containing Pango markup.
* Passing %NULL is the same as passing "" (the empty string)
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
*
* Sets @markup as the contents of a #ClutterText.
*
* This is a convenience function for setting a string containing
* Pango markup, and it is logically equivalent to:
*
* |[
text: Consistently protect against NULL strings When calling clutter_text_set_text_internal() or clutter_text_set_markup_internal() we need to make sure to pass a non-NULL string.
2011-09-07 12:08:22 +00:00
* /&ast; the order is important &ast;/
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
* clutter_text_set_text (CLUTTER_TEXT (actor), markup);
text: Make the :text property not set the :use-markup one Currently, setting the :text property has the side-effect of setting the :use-markup property to FALSE. This prevents constructing a Text actor, or setting its properties, like: g_object_set (text, "use-markup", TRUE, "text", some_string, NULL); as the ordering becomes important. Unfortunately, the ordering of the properties cannot be enforced with ClutterScript or with language bindings. The documentation of the clutter_text_set_text() method should be expanded to properly specify that the set_text() method will change the :use-markup property to FALSE as a side effect.
2009-10-07 20:44:17 +00:00
* clutter_text_set_use_markup (CLUTTER_TEXT (actor), TRUE);
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
* ]|
*
* Since: 1.0
*/
void
clutter_text_set_markup (ClutterText *self,
const gchar *markup)
{
g_return_if_fail (CLUTTER_IS_TEXT (self));
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
clutter_text_set_use_markup_internal (self, TRUE);
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
if (markup != NULL && *markup != '\0')
clutter_text_set_markup_internal (self, markup);
else
clutter_text_buffer_set_text (get_buffer (self), "", 0);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
}
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
/**
* clutter_text_get_layout:
* @self: a #ClutterText
*
* Retrieves the current #PangoLayout used by a #ClutterText actor.
*
Add gobject-introspection annotations Add annotations such as (transfer-none) (out) (element-type ClutterActor), and so forth to the doc comments as appropriate. The annotations added here are a combination of the annotations previously in gir-repository for Clutter and annotations found in a review of all return values with that were being parsed with a transfer of "full". http://bugzilla.openedhand.com/show_bug.cgi?id=1452 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-02-17 00:25:20 +00:00
* Return value: (transfer none): a #PangoLayout. The returned object is owned by
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
* the #ClutterText actor and should not be modified or freed
*
* Since: 1.0
*/
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
PangoLayout *
Coding style consistency Channel mitch's spirit. This is also how I get to have the highest commit count on Clutter's repository.
2008-12-11 11:54:32 +00:00
clutter_text_get_layout (ClutterText *self)
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
{
Remove Units from the public API With the recent change to internal floating point values, ClutterUnit has become a redundant type, defined to be a float. All integer entry points are being internally converted to floating point values to be passed to the GL pipeline with the least amount of conversion. ClutterUnit is thus exposed as just a "pixel with fractionary bits", and not -- as users might think -- as generic, resolution and device independent units. not that it was the case, but a definitive amount of people was convinced it did provide this "feature", and was flummoxed about the mere existence of this type. So, having ClutterUnit exposed in the public API doubles the entry points and has the following disadvantages: - we have to maintain twice the amount of entry points in ClutterActor - we still do an integer-to-float implicit conversion - we introduce a weird impedance between pixels and "pixels with fractionary bits" - language bindings will have to choose what to bind, and resort to manually overriding the API + *except* for language bindings based on GObject-Introspection, as they cannot do manual overrides, thus will replicate the entire set of entry points For these reason, we should coalesces every Actor entry point for pixels and for ClutterUnit into a single entry point taking a float, like: void clutter_actor_set_x (ClutterActor *self, gfloat x); void clutter_actor_get_size (ClutterActor *self, gfloat *width, gfloat *height); gfloat clutter_actor_get_height (ClutterActor *self); etc. The issues I have identified are: - we'll have a two cases of compiler warnings: - printf() format of the return values from %d to %f - clutter_actor_get_size() taking floats instead of unsigned ints - we'll have a problem with varargs when passing an integer instead of a floating point value, except on 64bit platforms where the size of a float is the same as the size of an int To be clear: the *intent* of the API should not change -- we still use pixels everywhere -- but: - we remove ambiguity in the API with regard to pixels and units - we remove entry points we get to maintain for the whole 1.0 version of the API - we make things simpler to bind for both manual language bindings and automatic (gobject-introspection based) ones - we have the simplest API possible while still exposing the capabilities of the underlying GL implementation
2009-05-06 15:44:47 +00:00
gfloat width, height;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
Coding style consistency Channel mitch's spirit. This is also how I get to have the highest commit count on Clutter's repository.
2008-12-11 11:54:32 +00:00
g_return_val_if_fail (CLUTTER_IS_TEXT (self), NULL);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
text: Layouts for single-line-mode entries are boundless A PangoLayout for an editable, single-line text entry is by definition without a given width, since the actor will be clipped when being drawn.
2010-07-09 17:37:34 +00:00
if (self->priv->editable && self->priv->single_line_mode)
return clutter_text_create_layout (self, -1, -1);
Remove Units from the public API With the recent change to internal floating point values, ClutterUnit has become a redundant type, defined to be a float. All integer entry points are being internally converted to floating point values to be passed to the GL pipeline with the least amount of conversion. ClutterUnit is thus exposed as just a "pixel with fractionary bits", and not -- as users might think -- as generic, resolution and device independent units. not that it was the case, but a definitive amount of people was convinced it did provide this "feature", and was flummoxed about the mere existence of this type. So, having ClutterUnit exposed in the public API doubles the entry points and has the following disadvantages: - we have to maintain twice the amount of entry points in ClutterActor - we still do an integer-to-float implicit conversion - we introduce a weird impedance between pixels and "pixels with fractionary bits" - language bindings will have to choose what to bind, and resort to manually overriding the API + *except* for language bindings based on GObject-Introspection, as they cannot do manual overrides, thus will replicate the entire set of entry points For these reason, we should coalesces every Actor entry point for pixels and for ClutterUnit into a single entry point taking a float, like: void clutter_actor_set_x (ClutterActor *self, gfloat x); void clutter_actor_get_size (ClutterActor *self, gfloat *width, gfloat *height); gfloat clutter_actor_get_height (ClutterActor *self); etc. The issues I have identified are: - we'll have a two cases of compiler warnings: - printf() format of the return values from %d to %f - clutter_actor_get_size() taking floats instead of unsigned ints - we'll have a problem with varargs when passing an integer instead of a floating point value, except on 64bit platforms where the size of a float is the same as the size of an int To be clear: the *intent* of the API should not change -- we still use pixels everywhere -- but: - we remove ambiguity in the API with regard to pixels and units - we remove entry points we get to maintain for the whole 1.0 version of the API - we make things simpler to bind for both manual language bindings and automatic (gobject-introspection based) ones - we have the simplest API possible while still exposing the capabilities of the underlying GL implementation
2009-05-06 15:44:47 +00:00
clutter_actor_get_size (CLUTTER_ACTOR (self), &width, &height);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
Support pango_layout_set_height() in ClutterText This is the port of the patch attached to bug 1266: ClutterLabel support for pango_layout_set_height() to the ClutterText actor. This patch adds support for the pango_layout_set_height() function inside the layout creation and caching, so that setting the height of a ClutterText will make PangoLayout try to fill out the given height before ellipsizing the contents of the ClutterText actor. The original patch is from Havoc Pennington. This commit ports the patch to ClutterText and applies a small change to the height computation pointed out by Behdad Esfahbod on GNOME's Bugzilla: http://bugzilla.gnome.org/show_bug.cgi?id=560931 That the layout heights when doing a size request should be set to be G_MAXINT instead of -1. Unfortunately, the patch seems to break the conformance suite when setting the ellipsization on the layout.
2008-12-16 14:02:05 +00:00
return clutter_text_create_layout (self, width, height);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
}
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
/**
* clutter_text_set_color:
* @self: a #ClutterText
* @color: a #ClutterColor
*
* Sets the color of the contents of a #ClutterText actor.
*
* The overall opacity of the #ClutterText actor will be the
* result of the alpha value of @color and the composited
* opacity of the actor itself on the scenegraph, as returned
* by clutter_actor_get_paint_opacity().
*
* Since: 1.0
*/
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
void
Coding style consistency Channel mitch's spirit. This is also how I get to have the highest commit count on Clutter's repository.
2008-12-11 11:54:32 +00:00
clutter_text_set_color (ClutterText *self,
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
const ClutterColor *color)
{
Coding style consistency Channel mitch's spirit. This is also how I get to have the highest commit count on Clutter's repository.
2008-12-11 11:54:32 +00:00
g_return_if_fail (CLUTTER_IS_TEXT (self));
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
g_return_if_fail (color != NULL);
text: Enable implicit color animations Implement the ClutterAnimatable interface to enable implicit animations for :color, :cursor-color, :selected-text-color and :selection-color. https://bugzilla.gnome.org/show_bug.cgi?id=676963
2012-05-28 12:02:25 +00:00
clutter_text_set_color_animated (self, obj_props[PROP_COLOR], color);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
}
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
/**
* clutter_text_get_color:
* @self: a #ClutterText
annotations: Use caller-allocates for color getters This should avoid a separate initialization of a ClutterColor in language bindings.
2011-02-14 18:36:51 +00:00
* @color: (out caller-allocates): return location for a #ClutterColor
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
*
Small doc fix to clutter_text_get_color Bug reported by Rob Bradford.
2009-08-05 14:51:49 +00:00
* Retrieves the text color as set by clutter_text_set_color().
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
*
* Since: 1.0
*/
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
void
Coding style consistency Channel mitch's spirit. This is also how I get to have the highest commit count on Clutter's repository.
2008-12-11 11:54:32 +00:00
clutter_text_get_color (ClutterText *self,
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
ClutterColor *color)
{
ClutterTextPrivate *priv;
Coding style consistency Channel mitch's spirit. This is also how I get to have the highest commit count on Clutter's repository.
2008-12-11 11:54:32 +00:00
g_return_if_fail (CLUTTER_IS_TEXT (self));
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
g_return_if_fail (color != NULL);
Coding style consistency Channel mitch's spirit. This is also how I get to have the highest commit count on Clutter's repository.
2008-12-11 11:54:32 +00:00
priv = self->priv;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
*color = priv->text_color;
}
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
/**
* clutter_text_set_ellipsize:
* @self: a #ClutterText
* @mode: a #PangoEllipsizeMode
*
* Sets the mode used to ellipsize (add an ellipsis: "...") to the
* text if there is not enough space to render the entire contents
* of a #ClutterText actor
*
* Since: 1.0
*/
void
clutter_text_set_ellipsize (ClutterText *self,
PangoEllipsizeMode mode)
{
ClutterTextPrivate *priv;
g_return_if_fail (CLUTTER_IS_TEXT (self));
g_return_if_fail (mode >= PANGO_ELLIPSIZE_NONE &&
mode <= PANGO_ELLIPSIZE_END);
priv = self->priv;
if ((PangoEllipsizeMode) priv->ellipsize != mode)
{
priv->ellipsize = mode;
clutter_text_dirty_cache (self);
clutter_actor_queue_relayout (CLUTTER_ACTOR (self));
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_ELLIPSIZE]);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
}
}
/**
* clutter_text_get_ellipsize:
* @self: a #ClutterText
*
* Returns the ellipsizing position of a #ClutterText actor, as
* set by clutter_text_set_ellipsize().
*
* Return value: #PangoEllipsizeMode
*
* Since: 1.0
*/
PangoEllipsizeMode
clutter_text_get_ellipsize (ClutterText *self)
{
g_return_val_if_fail (CLUTTER_IS_TEXT (self), PANGO_ELLIPSIZE_NONE);
return self->priv->ellipsize;
}
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
/**
* clutter_text_get_line_wrap:
* @self: a #ClutterText
*
* Retrieves the value set using clutter_text_set_line_wrap().
*
* Return value: %TRUE if the #ClutterText actor should wrap
* its contents
*
* Since: 1.0
*/
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
gboolean
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter_text_get_line_wrap (ClutterText *self)
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
{
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_return_val_if_fail (CLUTTER_IS_TEXT (self), FALSE);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
return self->priv->wrap;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
}
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
/**
* clutter_text_set_line_wrap:
* @self: a #ClutterText
* @line_wrap: whether the contents should wrap
*
* Sets whether the contents of a #ClutterText actor should wrap,
* if they don't fit the size assigned to the actor.
*
* Since: 1.0
*/
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
void
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter_text_set_line_wrap (ClutterText *self,
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
gboolean line_wrap)
{
ClutterTextPrivate *priv;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_return_if_fail (CLUTTER_IS_TEXT (self));
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
priv = self->priv;
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
if (priv->wrap != line_wrap)
{
priv->wrap = line_wrap;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter_text_dirty_cache (self);
clutter_actor_queue_relayout (CLUTTER_ACTOR (self));
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_LINE_WRAP]);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
}
}
/**
* clutter_text_set_line_wrap_mode:
* @self: a #ClutterText
* @wrap_mode: the line wrapping mode
*
* If line wrapping is enabled (see clutter_text_set_line_wrap()) this
* function controls how the line wrapping is performed. The default is
* %PANGO_WRAP_WORD which means wrap on word boundaries.
*
* Since: 1.0
*/
void
clutter_text_set_line_wrap_mode (ClutterText *self,
PangoWrapMode wrap_mode)
{
ClutterTextPrivate *priv;
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
if (priv->wrap_mode != wrap_mode)
{
priv->wrap_mode = wrap_mode;
clutter_text_dirty_cache (self);
clutter_actor_queue_relayout (CLUTTER_ACTOR (self));
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_LINE_WRAP_MODE]);
Coalesce ClutterLabel API usage ClutterText replaces ClutterLabel, so it should expose the same kind of API - ideally with the minimal amount of changes, so that the porting is trivial.
2008-12-11 11:17:26 +00:00
}
}
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
/**
* clutter_text_get_line_wrap_mode:
* @self: a #ClutterText
*
* Retrieves the line wrap mode used by the #ClutterText actor.
*
* See clutter_text_set_line_wrap_mode ().
*
* Return value: the wrap mode used by the #ClutterText
*
* Since: 1.0
*/
PangoWrapMode
clutter_text_get_line_wrap_mode (ClutterText *self)
{
g_return_val_if_fail (CLUTTER_IS_TEXT (self), PANGO_WRAP_WORD);
return self->priv->wrap_mode;
}
/**
* clutter_text_set_attributes:
* @self: a #ClutterText
text: Add missing introspection annotations Add allow-none annotations where appropriate
2012-05-14 23:44:51 +00:00
* @attrs: (allow-none): a #PangoAttrList or %NULL to unset the attributes
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
*
* Sets the attributes list that are going to be applied to the
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
* #ClutterText contents.
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
*
* The #ClutterText actor will take a reference on the #PangoAttrList
* passed to this function.
*
* Since: 1.0
*/
void
clutter_text_set_attributes (ClutterText *self,
PangoAttrList *attrs)
{
ClutterTextPrivate *priv;
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
text: Prevent a relayout if font descriptions or attrs are equal https://bugzilla.gnome.org/show_bug.cgi?id=689399
2012-12-01 01:21:23 +00:00
/* While we should probably test for equality, Pango doesn't
* provide us an easy method to check for AttrList equality.
*/
if (priv->attrs == attrs)
return;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
if (attrs)
pango_attr_list_ref (attrs);
if (priv->attrs)
pango_attr_list_unref (priv->attrs);
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
priv->attrs = attrs;
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
/* Clear the effective attributes so they will be regenerated when a
layout is created */
if (priv->effective_attrs)
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
{
text: Store the markup attributes separately Previously when the markup property is set it would generate an attribute list from the markup and then merge it with the attributes from the attribute property and store it as the effective attributes. The markup attributes and the marked up text would then be forgotten. This breaks if the application then later changes the attributes property because it would try to regenerate the effective attributes from the markup text but the stored text no longer contains any markup. If the original markup text happened to contain entities like '&lt;' they would end up causing parse errors because they would be converted to the actual symbols. To fix this the attributes from the markup are now stored independently from the effective attributes. The effective attributes are now regenerated if either set of attributes changes right before a layout is created. http://bugzilla.openedhand.com/show_bug.cgi?id=1940
2010-01-05 11:58:12 +00:00
pango_attr_list_unref (priv->effective_attrs);
priv->effective_attrs = NULL;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
}
clutter_text_dirty_cache (self);
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_ATTRIBUTES]);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter_actor_queue_relayout (CLUTTER_ACTOR (self));
}
/**
* clutter_text_get_attributes:
* @self: a #ClutterText
*
* Gets the attribute list that was set on the #ClutterText actor
* clutter_text_set_attributes(), if any.
*
Add gobject-introspection annotations Add annotations such as (transfer-none) (out) (element-type ClutterActor), and so forth to the doc comments as appropriate. The annotations added here are a combination of the annotations previously in gir-repository for Clutter and annotations found in a review of all return values with that were being parsed with a transfer of "full". http://bugzilla.openedhand.com/show_bug.cgi?id=1452 Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>
2009-02-17 00:25:20 +00:00
* Return value: (transfer none): the attribute list, or %NULL if none was set. The
* returned value is owned by the #ClutterText and should not be unreferenced.
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
*
* Since: 1.0
*/
PangoAttrList *
clutter_text_get_attributes (ClutterText *self)
{
g_return_val_if_fail (CLUTTER_IS_TEXT (self), NULL);
return self->priv->attrs;
}
/**
[text] Rename :alignment to :line-alignment The :alignment property is prone to generate confusion: developers will set it thinking that the contents of a ClutterText will automagically align themselves. Instead of using the generic term :alignment, and following the GTK+ convention, we should use a more specific term, conveying the actual effect of the property: alignment of the lines with respect to each other, and not to the overall allocated area. See bug 1428: http://bugzilla.openedhand.com/show_bug.cgi?id=1428
2009-02-02 23:55:30 +00:00
* clutter_text_set_line_alignment:
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
* @self: a #ClutterText
* @alignment: A #PangoAlignment
*
[text] Rename :alignment to :line-alignment The :alignment property is prone to generate confusion: developers will set it thinking that the contents of a ClutterText will automagically align themselves. Instead of using the generic term :alignment, and following the GTK+ convention, we should use a more specific term, conveying the actual effect of the property: alignment of the lines with respect to each other, and not to the overall allocated area. See bug 1428: http://bugzilla.openedhand.com/show_bug.cgi?id=1428
2009-02-02 23:55:30 +00:00
* Sets the way that the lines of a wrapped label are aligned with
* respect to each other. This does not affect the overall alignment
* of the label within its allocated or specified width.
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
*
[text] Rename :alignment to :line-alignment The :alignment property is prone to generate confusion: developers will set it thinking that the contents of a ClutterText will automagically align themselves. Instead of using the generic term :alignment, and following the GTK+ convention, we should use a more specific term, conveying the actual effect of the property: alignment of the lines with respect to each other, and not to the overall allocated area. See bug 1428: http://bugzilla.openedhand.com/show_bug.cgi?id=1428
2009-02-02 23:55:30 +00:00
* To align a #ClutterText actor you should add it to a container
* that supports alignment, or use the anchor point.
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
*
* Since: 1.0
*/
void
[text] Rename :alignment to :line-alignment The :alignment property is prone to generate confusion: developers will set it thinking that the contents of a ClutterText will automagically align themselves. Instead of using the generic term :alignment, and following the GTK+ convention, we should use a more specific term, conveying the actual effect of the property: alignment of the lines with respect to each other, and not to the overall allocated area. See bug 1428: http://bugzilla.openedhand.com/show_bug.cgi?id=1428
2009-02-02 23:55:30 +00:00
clutter_text_set_line_alignment (ClutterText *self,
PangoAlignment alignment)
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
{
ClutterTextPrivate *priv;
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
if (priv->alignment != alignment)
{
priv->alignment = alignment;
clutter_text_dirty_cache (self);
clutter_actor_queue_relayout (CLUTTER_ACTOR (self));
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_LINE_ALIGNMENT]);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
}
}
/**
[text] Rename :alignment to :line-alignment The :alignment property is prone to generate confusion: developers will set it thinking that the contents of a ClutterText will automagically align themselves. Instead of using the generic term :alignment, and following the GTK+ convention, we should use a more specific term, conveying the actual effect of the property: alignment of the lines with respect to each other, and not to the overall allocated area. See bug 1428: http://bugzilla.openedhand.com/show_bug.cgi?id=1428
2009-02-02 23:55:30 +00:00
* clutter_text_get_line_alignment:
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
* @self: a #ClutterText
*
[text] Rename :alignment to :line-alignment The :alignment property is prone to generate confusion: developers will set it thinking that the contents of a ClutterText will automagically align themselves. Instead of using the generic term :alignment, and following the GTK+ convention, we should use a more specific term, conveying the actual effect of the property: alignment of the lines with respect to each other, and not to the overall allocated area. See bug 1428: http://bugzilla.openedhand.com/show_bug.cgi?id=1428
2009-02-02 23:55:30 +00:00
* Retrieves the alignment of a #ClutterText, as set by
* clutter_text_set_line_alignment().
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
*
* Return value: a #PangoAlignment
*
docs: Fix the 'Since' annotation for some functions The 'Since' annotation needs to have a colon after it or gtk-doc won't pick it up.
2009-11-19 11:51:21 +00:00
* Since: 1.0
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
*/
PangoAlignment
[text] Rename :alignment to :line-alignment The :alignment property is prone to generate confusion: developers will set it thinking that the contents of a ClutterText will automagically align themselves. Instead of using the generic term :alignment, and following the GTK+ convention, we should use a more specific term, conveying the actual effect of the property: alignment of the lines with respect to each other, and not to the overall allocated area. See bug 1428: http://bugzilla.openedhand.com/show_bug.cgi?id=1428
2009-02-02 23:55:30 +00:00
clutter_text_get_line_alignment (ClutterText *self)
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
{
g_return_val_if_fail (CLUTTER_IS_TEXT (self), PANGO_ALIGN_LEFT);
return self->priv->alignment;
}
/**
* clutter_text_set_use_markup:
* @self: a #ClutterText
* @setting: %TRUE if the text should be parsed for markup.
*
* Sets whether the contents of the #ClutterText actor contains markup
* in <link linkend="PangoMarkupFormat">Pango's text markup language</link>.
*
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
* Setting #ClutterText:use-markup on an editable #ClutterText will
text: Do not set the markup unconditionally When setting :use-markup we always pass the contents of the Text actor to clutter_text_set_markup_internal(); if string contains any markup, this ends up being parsed and used - even when :use-markup is set to FALSE. http://bugzilla.clutter-project.org/show_bug.cgi?id=2239
2010-08-06 16:04:37 +00:00
* not have any effect except hiding the markup.
*
* See also #ClutterText:use-markup.
[text] Do not use markup on an editable Text An editable ClutterText should not use pango_layout_set_markup(), as the contents of the text actor will not match the text. Only read-only text actors should parse the contents for Pango markup.
2009-01-07 13:48:45 +00:00
*
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
* Since: 1.0
*/
void
clutter_text_set_use_markup (ClutterText *self,
gboolean setting)
{
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
const gchar *text;
text: Do not set the markup unconditionally When setting :use-markup we always pass the contents of the Text actor to clutter_text_set_markup_internal(); if string contains any markup, this ends up being parsed and used - even when :use-markup is set to FALSE. http://bugzilla.clutter-project.org/show_bug.cgi?id=2239
2010-08-06 16:04:37 +00:00
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_return_if_fail (CLUTTER_IS_TEXT (self));
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
text = clutter_text_buffer_get_text (get_buffer (self));
text: Do not set the markup unconditionally When setting :use-markup we always pass the contents of the Text actor to clutter_text_set_markup_internal(); if string contains any markup, this ends up being parsed and used - even when :use-markup is set to FALSE. http://bugzilla.clutter-project.org/show_bug.cgi?id=2239
2010-08-06 16:04:37 +00:00
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
clutter_text_set_use_markup_internal (self, setting);
text: Do not set the markup unconditionally When setting :use-markup we always pass the contents of the Text actor to clutter_text_set_markup_internal(); if string contains any markup, this ends up being parsed and used - even when :use-markup is set to FALSE. http://bugzilla.clutter-project.org/show_bug.cgi?id=2239
2010-08-06 16:04:37 +00:00
if (setting)
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
clutter_text_set_markup_internal (self, text);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
clutter_text_dirty_cache (self);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
[text] Merge the attributes with markup enabled ClutterText should merge the PangoAttributes set by using clutter_text_set_attributes() with the attributes generated by parsing Pango markup. For this to work we must parse the markup and merge the attributes we get out of pango_parse_markup() with the attributes set by the user. Setting the markup or the attributes on an editable text should not work for the time being.
2009-01-29 13:18:57 +00:00
clutter_actor_queue_relayout (CLUTTER_ACTOR (self));
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
}
/**
* clutter_text_get_use_markup:
* @self: a #ClutterText
*
* Retrieves whether the contents of the #ClutterText actor should be
* parsed for the Pango text markup.
*
* Return value: %TRUE if the contents will be parsed for markup
*
* Since: 1.0
*/
gboolean
clutter_text_get_use_markup (ClutterText *self)
{
g_return_val_if_fail (CLUTTER_IS_TEXT (self), FALSE);
return self->priv->use_markup;
}
/**
* clutter_text_set_justify:
* @self: a #ClutterText
* @justify: whether the text should be justified
*
* Sets whether the text of the #ClutterText actor should be justified
* on both margins. This setting is ignored if Clutter is compiled
* against Pango &lt; 1.18.
*
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
* Since: 1.0
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
*/
void
clutter_text_set_justify (ClutterText *self,
gboolean justify)
{
ClutterTextPrivate *priv;
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
if (priv->justify != justify)
{
priv->justify = justify;
clutter_text_dirty_cache (self);
clutter_actor_queue_relayout (CLUTTER_ACTOR (self));
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_JUSTIFY]);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
}
}
/**
* clutter_text_get_justify:
* @self: a #ClutterText
*
* Retrieves whether the #ClutterText actor should justify its contents
* on both margins.
*
* Return value: %TRUE if the text should be justified
*
* Since: 0.6
*/
gboolean
clutter_text_get_justify (ClutterText *self)
{
g_return_val_if_fail (CLUTTER_IS_TEXT (self), FALSE);
return self->priv->justify;
}
/**
* clutter_text_get_cursor_position:
* @self: a #ClutterText
*
* Retrieves the cursor position.
*
* Return value: the cursor position, in characters
*
* Since: 1.0
*/
gint
clutter_text_get_cursor_position (ClutterText *self)
{
g_return_val_if_fail (CLUTTER_IS_TEXT (self), -1);
return self->priv->position;
}
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
/**
* clutter_text_set_cursor_position:
* @self: a #ClutterText
* @position: the new cursor position, in characters
*
* Sets the cursor of a #ClutterText actor at @position.
*
* The position is expressed in characters, not in bytes.
*
* Since: 1.0
*/
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
void
clutter_text_set_cursor_position (ClutterText *self,
gint position)
{
ClutterTextPrivate *priv;
gint len;
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
text: Notify :position when it changes The :position property is not notified when changed. http://bugzilla.openedhand.com/show_bug.cgi?id=1830
2009-10-16 13:22:15 +00:00
if (priv->position == position)
return;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
len = clutter_text_buffer_get_length (get_buffer (self));
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
if (position < 0 || position >= len)
priv->position = -1;
else
priv->position = position;
[clutter-text] Fix x-position of cursor when moving up or down ClutterText already has code to try to preserve the x position when moving up or down. A target x-position is stored and the cursor is positioned at the nearest point to that in the appropriate line when up or down is pressed. However the target position was never cleared so it would always target the x-position of the cursor from the first time you pressed up or down. To fix this the patch clears the target position in set_position and then sets it after the call in real_move_up/down. That way pressing up or down sets the target position and any other movement will clear it. To get an index for the pixel position in the line pango_layout_line_x_to_index is used. However when x is greater than the length of the line then the index before the last grapheme is returned which was causing it to jump to the penultimate character. The patch makes it add on the trailing value so that it will jump to the last character.
2009-01-14 11:12:02 +00:00
/* Forget the target x position so that it will be recalculated next
time the cursor is moved up or down */
priv->x_pos = -1;
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
clutter_text_queue_redraw (CLUTTER_ACTOR (self));
text: Notify :position when it changes The :position property is not notified when changed. http://bugzilla.openedhand.com/show_bug.cgi?id=1830
2009-10-16 13:22:15 +00:00
text: Add :cursor-position and deprecate :position The :position property on ClutterText clashes with the same property on ClutterActor; it's also badly named, given that it represents the cursor's position inside the text; finally, it does not match its accessors, violating the API style conventions. https://bugzilla.gnome.org/show_bug.cgi?id=679457
2012-07-05 15:23:52 +00:00
/* XXX:2.0 - remove */
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_POSITION]);
text: Add :cursor-position and deprecate :position The :position property on ClutterText clashes with the same property on ClutterActor; it's also badly named, given that it represents the cursor's position inside the text; finally, it does not match its accessors, violating the API style conventions. https://bugzilla.gnome.org/show_bug.cgi?id=679457
2012-07-05 15:23:52 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_CURSOR_POSITION]);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
}
Add :cursor-size property to ClutterText We can control the width of the cursor when painting by using a simple property. The magic -1 number passed to the setter method will reset the cursor size to the default one of 2px. The getter method will return an unsigned integer with the current size.
2008-12-16 10:37:45 +00:00
/**
* clutter_text_set_cursor_size:
* @self: a #ClutterText
* @size: the size of the cursor, in pixels, or -1 to use the
* default value
*
* Sets the size of the cursor of a #ClutterText. The cursor
* will only be visible if the #ClutterText:cursor-visible property
* is set to %TRUE.
*
* Since: 1.0
*/
void
clutter_text_set_cursor_size (ClutterText *self,
gint size)
{
ClutterTextPrivate *priv;
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
if (priv->cursor_size != size)
{
if (size < 0)
size = DEFAULT_CURSOR_SIZE;
priv->cursor_size = size;
clutter-text: Use the ink rect in the paint volume Previously ClutterText was just reporting the allocation as the paint volume. The preferred size of a ClutterText is just the logical rectangle of the layout. A pango layout can sometimes draw outside of its logical rectangle for example with an italicised font with large serifs. Additionally, ClutterText doesn't make any attempt to clip the text if the actor gets allocated a size too small for the text so it would also end up drawing outside of the paint volume in that case. To fix this, the paint volume is now reported as the ink rect of the Pango layout. The rectangle for the cursor and selection is also unioned into that because it won't necessarily be within the ink rectangle. The function for drawing the selection rectangles has been split up into a generic function that calculates the rectangles that need to be drawn and a function that draws them. That way the get_paint_volume virtual can share the code to calculate the rectangles. http://bugzilla.clutter-project.org/show_bug.cgi?id=2599
2011-03-07 18:53:07 +00:00
clutter_text_queue_redraw (CLUTTER_ACTOR (self));
Add :cursor-size property to ClutterText We can control the width of the cursor when painting by using a simple property. The magic -1 number passed to the setter method will reset the cursor size to the default one of 2px. The getter method will return an unsigned integer with the current size.
2008-12-16 10:37:45 +00:00
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_CURSOR_SIZE]);
Add :cursor-size property to ClutterText We can control the width of the cursor when painting by using a simple property. The magic -1 number passed to the setter method will reset the cursor size to the default one of 2px. The getter method will return an unsigned integer with the current size.
2008-12-16 10:37:45 +00:00
}
}
/**
* clutter_text_get_cursor_size:
* @self: a #ClutterText
*
* Retrieves the size of the cursor of a #ClutterText actor.
*
* Return value: the size of the cursor, in pixels
*
* Since: 1.0
*/
guint
clutter_text_get_cursor_size (ClutterText *self)
{
g_return_val_if_fail (CLUTTER_IS_TEXT (self), DEFAULT_CURSOR_SIZE);
return self->priv->cursor_size;
}
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
/**
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
* clutter_text_set_password_char:
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
* @self: a #ClutterText
Comments and whitespace fixes to ClutterText
2009-01-07 00:43:24 +00:00
* @wc: a Unicode character, or 0 to unset the password character
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
*
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
* Sets the character to use in place of the actual text in a
* password text actor.
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
*
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
* If @wc is 0 the text will be displayed as it is entered in the
* #ClutterText actor.
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
*
* Since: 1.0
*/
void
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
clutter_text_set_password_char (ClutterText *self,
gunichar wc)
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
{
ClutterTextPrivate *priv;
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
if (priv->password_char != wc)
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
{
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
priv->password_char = wc;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
clutter_text_dirty_cache (self);
clutter_actor_queue_relayout (CLUTTER_ACTOR (self));
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_PASSWORD_CHAR]);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
}
}
/**
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
* clutter_text_get_password_char:
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
* @self: a #ClutterText
*
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
* Retrieves the character to use in place of the actual text
* as set by clutter_text_set_password_char().
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
*
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
* Return value: a Unicode character or 0 if the password
* character is not set
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
*
* Since: 1.0
*/
gunichar
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
clutter_text_get_password_char (ClutterText *self)
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
{
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
g_return_val_if_fail (CLUTTER_IS_TEXT (self), 0);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
[text] Coalesce text visibility and password character Using two properties to set a password entry can be construed as both cumbersome and a gtk-ism. And rightly so on both counts. The :text-visible property has also conflicting semantics with the :cursor-visible one: while the latter hides the cursor, the former changes the display of the contents of the Text actor. It is, thus, not a matter of "visibility" but of "rendering". Instead of setting the :text-visible and :invisible-char properties to have a password text field, the Text actor should just have a single :password-char property holding a Unicode character. If the value of the :password-char is non-zero, the Text actor will use the Unicode character to render the contents of the text entry. This commit removes the following methods: clutter_text_set_text_visible() clutter_text_get_text_visible() clutter_text_set_invisible_char() clutter_text_get_invisible_char() And the following properties: ClutterText:text-visible ClutterText:invisible-char In favour of: clutter_text_set_password_char() clutter_text_get_password_char() And: ClutterText:password-char Thus making obvious what use the property and accessor methods are for and simplifying the process of creating a simple password text field to: text = clutter_text_new (); clutter_text_set_password_char (CLUTTER_TEXT (text), '*');
2009-01-06 15:22:31 +00:00
return self->priv->password_char;
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
}
/**
* clutter_text_set_max_length:
* @self: a #ClutterText
* @max: the maximum number of characters allowed in the text actor; 0
* to disable or -1 to set the length of the current string
*
* Sets the maximum allowed length of the contents of the actor. If the
* current contents are longer than the given length, then they will be
* truncated to fit.
*
Implement Text:max-length The :max-length property establishes the maximum available length for the Text actor's contents, in characters.
2008-12-11 11:54:07 +00:00
* Since: 1.0
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
*/
void
clutter_text_set_max_length (ClutterText *self,
Implement Text:max-length The :max-length property establishes the maximum available length for the Text actor's contents, in characters.
2008-12-11 11:54:07 +00:00
gint max)
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
{
Implement Text:max-length The :max-length property establishes the maximum available length for the Text actor's contents, in characters.
2008-12-11 11:54:07 +00:00
g_return_if_fail (CLUTTER_IS_TEXT (self));
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
clutter_text_buffer_set_max_length (get_buffer (self), max);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
}
/**
* clutter_text_get_max_length:
Implement Text:max-length The :max-length property establishes the maximum available length for the Text actor's contents, in characters.
2008-12-11 11:54:07 +00:00
* @self: a #ClutterText
*
* Gets the maximum length of text that can be set into a text actor.
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
*
* See clutter_text_set_max_length().
*
* Return value: the maximum number of characters.
*
Implement Text:max-length The :max-length property establishes the maximum available length for the Text actor's contents, in characters.
2008-12-11 11:54:07 +00:00
* Since: 1.0
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
*/
gint
clutter_text_get_max_length (ClutterText *self)
{
Implement Text:max-length The :max-length property establishes the maximum available length for the Text actor's contents, in characters.
2008-12-11 11:54:07 +00:00
g_return_val_if_fail (CLUTTER_IS_TEXT (self), 0);
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
return clutter_text_buffer_get_max_length (get_buffer (self));
Add text-visibility accessors for ClutterText A ClutterText can be put in "password mode" by setting the text as "invisible": every character inside the Text actor's contents will be replaced when building the Pango layout with a specific Unicode character. The Unicode character is set to '*' by default, but the user can be changed using the provided API.
2008-12-11 11:40:55 +00:00
}
clutter-text: emitting ClutterText::insert-text before actual changes on the text https://bugzilla.gnome.org/show_bug.cgi?id=722220
2014-01-16 17:04:22 +00:00
static void
clutter_text_real_insert_text (ClutterText *self,
guint start_pos,
const gchar *chars,
guint n_chars)
{
gsize n_bytes;
n_bytes = g_utf8_offset_to_pointer (chars, n_chars) - chars;
/*
* insert-text is emitted here instead of as part of a
* buffer_inserted_text() callback because that should be emitted
* before the buffer changes, while ClutterTextBuffer::deleted-text
* is emitter after. See BG#722220 for more info.
*/
g_signal_emit (self, text_signals[INSERT_TEXT], 0, chars,
n_bytes, &start_pos);
/*
* The actual insertion from the buffer. This will end firing the
* following signal handlers: buffer_inserted_text(),
* buffer_notify_text(), buffer_notify_max_length()
*/
clutter_text_buffer_insert_text (get_buffer (self), start_pos, chars, n_chars);
}
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
/**
* clutter_text_insert_unichar:
* @self: a #ClutterText
* @wc: a Unicode character
*
* Inserts @wc at the current cursor position of a
* #ClutterText actor.
*
* Since: 1.0
*/
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
void
clutter_text_insert_unichar (ClutterText *self,
gunichar wc)
{
ClutterTextPrivate *priv;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
GString *new;
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
priv = self->priv;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
new = g_string_new ("");
g_string_append_unichar (new, wc);
Improve the safety checks inside the text setters We should check that the contents of the Text actor are not NULL when computing the offsets in bytes.
2008-12-11 11:49:45 +00:00
clutter-text: emitting ClutterText::insert-text before actual changes on the text https://bugzilla.gnome.org/show_bug.cgi?id=722220
2014-01-16 17:04:22 +00:00
clutter_text_real_insert_text (self, priv->position, new->str, 1);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
g_string_free (new, TRUE);
}
clutter-text: emitting ClutterText::insert-text before actual changes on the text https://bugzilla.gnome.org/show_bug.cgi?id=722220
2014-01-16 17:04:22 +00:00
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
/**
* clutter_text_insert_text:
* @self: a #ClutterText
* @text: the text to be inserted
* @position: the position of the insertion, or -1
*
* Inserts @text into a #ClutterActor at the given position.
*
* If @position is a negative number, the text will be appended
* at the end of the current contents of the #ClutterText.
*
* The position is expressed in characters, not in bytes.
*
* Since: 1.0
*/
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
void
Add text editing methods Port the text editing methods from ClutterEntry, so that ClutterText exposes the same API.
2008-12-11 11:43:56 +00:00
clutter_text_insert_text (ClutterText *self,
const gchar *text,
gssize position)
{
g_return_if_fail (CLUTTER_IS_TEXT (self));
g_return_if_fail (text != NULL);
clutter-text: emitting ClutterText::insert-text before actual changes on the text https://bugzilla.gnome.org/show_bug.cgi?id=722220
2014-01-16 17:04:22 +00:00
clutter_text_real_insert_text (self, position, text, g_utf8_strlen (text, -1));
Add text editing methods Port the text editing methods from ClutterEntry, so that ClutterText exposes the same API.
2008-12-11 11:43:56 +00:00
}
clutter-text: emitting ClutterText::delete-text before actual changes on the text https://bugzilla.gnome.org/show_bug.cgi?id=722220
2014-01-16 16:39:02 +00:00
static
void clutter_text_real_delete_text (ClutterText *self,
gssize start_pos,
gssize end_pos)
{
/*
* delete-text is emitted here instead of as part of a
* buffer_deleted_text() callback because that should be emitted
* before the buffer changes, while ClutterTextBuffer::deleted-text
* is emitter after. See BG#722220 for more info.
*/
g_signal_emit (self, text_signals[DELETE_TEXT], 0, start_pos, end_pos);
/*
* The actual deletion from the buffer. This will end firing the
* following signal handlers: buffer_deleted_text(),
* buffer_notify_text(), buffer_notify_max_length()
*/
clutter_text_buffer_delete_text (get_buffer (self), start_pos, end_pos - start_pos);
}
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
/**
* clutter_text_delete_text:
* @self: a #ClutterText
* @start_pos: starting position
* @end_pos: ending position
*
* Deletes the text inside a #ClutterText actor between @start_pos
* and @end_pos.
*
* The starting and ending positions are expressed in characters,
* not in bytes.
*
* Since: 1.0
*/
Add text editing methods Port the text editing methods from ClutterEntry, so that ClutterText exposes the same API.
2008-12-11 11:43:56 +00:00
void
clutter_text_delete_text (ClutterText *self,
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
gssize start_pos,
gssize end_pos)
{
Add text editing methods Port the text editing methods from ClutterEntry, so that ClutterText exposes the same API.
2008-12-11 11:43:56 +00:00
g_return_if_fail (CLUTTER_IS_TEXT (self));
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
clutter-text: emitting ClutterText::delete-text before actual changes on the text https://bugzilla.gnome.org/show_bug.cgi?id=722220
2014-01-16 16:39:02 +00:00
clutter_text_real_delete_text (self, start_pos, end_pos);
Add text editing methods Port the text editing methods from ClutterEntry, so that ClutterText exposes the same API.
2008-12-11 11:43:56 +00:00
}
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
/**
* clutter_text_delete_chars:
* @self: a #ClutterText
* @n_chars: the number of characters to delete
*
* Deletes @n_chars inside a #ClutterText actor, starting from the
* current cursor position.
*
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
* Somewhat awkwardly, the cursor position is decremented by the same
* number of characters you've deleted.
*
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
* Since: 1.0
*/
Add text editing methods Port the text editing methods from ClutterEntry, so that ClutterText exposes the same API.
2008-12-11 11:43:56 +00:00
void
clutter_text_delete_chars (ClutterText *self,
guint n_chars)
{
ClutterTextPrivate *priv;
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
text: Fix the implementation of delete_chars() The internal delete_text() implementation takes a start and an end position, whereas the public delete_chars() method takes a number of characters to delete starting from the current cursor position.
2014-01-24 18:49:18 +00:00
clutter_text_real_delete_text (self, priv->position, priv->position + n_chars);
Add text editing methods Port the text editing methods from ClutterEntry, so that ClutterText exposes the same API.
2008-12-11 11:43:56 +00:00
if (priv->position > 0)
clutter_text_set_cursor_position (self, priv->position - n_chars);
Merge the ClutterLabel properties into ClutterText ClutterText should have the same properties as ClutterLabel. While at it, we can finally fix the disconnect between the wrap and wrap-mode properties and its accessors, that we perpetuated from GtkLabel. The ClutterText:line-wrap property and ClutterText:line-wrap-mode are mapped to the set_line_wrap(), get_line_wrap() and set_line_wrap_mode(), get_line_wrap_mode() accessor functions respectively. This should simplify bindings the Vala ones that map a property into a method.
2008-12-11 11:33:10 +00:00
}
Add Text::get_chars() implementation and tests The clutter_text_get_chars() function returns a section of the contents of the Text actor, delimited by a start and an end position. This commit adds the implementation for that function and a test unit that guarantees the offset-to-bytes computations are correct.
2008-12-11 11:59:50 +00:00
/**
* clutter_text_get_chars:
Add documentation annotations ClutterText is heavily under-documented. This commit ports most of the API documentation from ClutterLabel and ClutterEntry to ClutterText.
2008-12-11 12:17:11 +00:00
* @self: a #ClutterText
Add Text::get_chars() implementation and tests The clutter_text_get_chars() function returns a section of the contents of the Text actor, delimited by a start and an end position. This commit adds the implementation for that function and a test unit that guarantees the offset-to-bytes computations are correct.
2008-12-11 11:59:50 +00:00
* @start_pos: start of text, in characters
* @end_pos: end of text, in characters
*
* Retrieves the contents of the #ClutterText actor between
Improve clutter_text_get_chars doc Explicitly explain that end_pos is not included with the resulting string http://bugzilla.clutter-project.org/show_bug.cgi?id=2081
2010-04-14 16:07:21 +00:00
* @start_pos and @end_pos, but not including @end_pos.
Add Text::get_chars() implementation and tests The clutter_text_get_chars() function returns a section of the contents of the Text actor, delimited by a start and an end position. This commit adds the implementation for that function and a test unit that guarantees the offset-to-bytes computations are correct.
2008-12-11 11:59:50 +00:00
*
* The positions are specified in characters, not in bytes.
*
* Return value: a newly allocated string with the contents of
* the text actor between the specified positions. Use g_free()
* to free the resources when done
*
* Since: 1.0
*/
Add text editing methods Port the text editing methods from ClutterEntry, so that ClutterText exposes the same API.
2008-12-11 11:43:56 +00:00
gchar *
clutter_text_get_chars (ClutterText *self,
gssize start_pos,
gssize end_pos)
{
Add Text::get_chars() implementation and tests The clutter_text_get_chars() function returns a section of the contents of the Text actor, delimited by a start and an end position. This commit adds the implementation for that function and a test unit that guarantees the offset-to-bytes computations are correct.
2008-12-11 11:59:50 +00:00
gint start_index, end_index;
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
guint n_chars;
const gchar *text;
Add Text::get_chars() implementation and tests The clutter_text_get_chars() function returns a section of the contents of the Text actor, delimited by a start and an end position. This commit adds the implementation for that function and a test unit that guarantees the offset-to-bytes computations are correct.
2008-12-11 11:59:50 +00:00
Add text editing methods Port the text editing methods from ClutterEntry, so that ClutterText exposes the same API.
2008-12-11 11:43:56 +00:00
g_return_val_if_fail (CLUTTER_IS_TEXT (self), NULL);
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
n_chars = clutter_text_buffer_get_length (get_buffer (self));
text = clutter_text_buffer_get_text (get_buffer (self));
Add Text::get_chars() implementation and tests The clutter_text_get_chars() function returns a section of the contents of the Text actor, delimited by a start and an end position. This commit adds the implementation for that function and a test unit that guarantees the offset-to-bytes computations are correct.
2008-12-11 11:59:50 +00:00
if (end_pos < 0)
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
end_pos = n_chars;
Add Text::get_chars() implementation and tests The clutter_text_get_chars() function returns a section of the contents of the Text actor, delimited by a start and an end position. This commit adds the implementation for that function and a test unit that guarantees the offset-to-bytes computations are correct.
2008-12-11 11:59:50 +00:00
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
start_pos = MIN (n_chars, start_pos);
end_pos = MIN (n_chars, end_pos);
Add Text::get_chars() implementation and tests The clutter_text_get_chars() function returns a section of the contents of the Text actor, delimited by a start and an end position. This commit adds the implementation for that function and a test unit that guarantees the offset-to-bytes computations are correct.
2008-12-11 11:59:50 +00:00
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
start_index = g_utf8_offset_to_pointer (text, start_pos) - text;
end_index = g_utf8_offset_to_pointer (text, end_pos) - text;
Add Text::get_chars() implementation and tests The clutter_text_get_chars() function returns a section of the contents of the Text actor, delimited by a start and an end position. This commit adds the implementation for that function and a test unit that guarantees the offset-to-bytes computations are correct.
2008-12-11 11:59:50 +00:00
text: Implement ClutterTextBuffer * Abstracts the buffer for text in ClutterText * Allows implementation of undo/redo. * Allows use of non-pageable memory for text in the case of sensitive passwords. * Implement a test with two ClutterText using the same buffer. https://bugzilla.gnome.org/show_bug.cgi?id=652653
2011-06-15 09:06:31 +00:00
return g_strndup (text + start_index, end_index - start_index);
Add text editing methods Port the text editing methods from ClutterEntry, so that ClutterText exposes the same API.
2008-12-11 11:43:56 +00:00
}
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
/**
* clutter_text_set_single_line_mode:
* @self: a #ClutterText
* @single_line: whether to enable single line mode
*
* Sets whether a #ClutterText actor should be in single line mode
docs: Clarify the scope of Text:single-line-mode Only editable text actors can be in single-line mode.
2010-06-14 13:05:49 +00:00
* or not. Only editable #ClutterText<!-- -->s can be in single line
* mode.
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
*
* A text actor in single line mode will not wrap text and will clip
Fixed "the the" repetitions in some doc strings http://bugzilla.clutter-project.org/show_bug.cgi?id=2450
2010-11-25 18:13:51 +00:00
* the visible area to the predefined size. The contents of the
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
* text actor will scroll to display the end of the text if its length
* is bigger than the allocated width.
*
* When setting the single line mode the #ClutterText:activatable
* property is also set as a side effect. Instead of entering a new
* line character, the text actor will emit the #ClutterText::activate
* signal.
*
* Since: 1.0
*/
void
clutter_text_set_single_line_mode (ClutterText *self,
gboolean single_line)
{
ClutterTextPrivate *priv;
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
if (priv->single_line_mode != single_line)
{
g_object_freeze_notify (G_OBJECT (self));
priv->single_line_mode = single_line;
if (priv->single_line_mode)
{
priv->activatable = TRUE;
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_ACTIVATABLE]);
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
}
clutter_text_dirty_cache (self);
clutter_actor_queue_relayout (CLUTTER_ACTOR (self));
Remove private helper #define's Finish off the second half of 09a830d294. http://bugzilla.clutter-project.org/show_bug.cgi?id=2596
2011-03-03 11:35:46 +00:00
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_SINGLE_LINE_MODE]);
[text] Add single-line-mode to ClutterText Allow using ClutterText as a single line text field. This is useful for text fields that accept just a single line of contents by default, and respond to the Enter key press to execute some action. The :single-line-mode property enables this behaviour inside ClutterText by clipping and scrolling the contents of the PangoLayout if they do not fit the allocated width of the Text actor.
2009-01-07 00:25:24 +00:00
g_object_thaw_notify (G_OBJECT (self));
}
}
/**
* clutter_text_get_single_line_mode:
* @self: a #ClutterText
*
* Retrieves whether the #ClutterText actor is in single line mode.
*
* Return value: %TRUE if the #ClutterText actor is in single line mode
*
* Since: 1.0
*/
gboolean
clutter_text_get_single_line_mode (ClutterText *self)
{
g_return_val_if_fail (CLUTTER_IS_TEXT (self), FALSE);
return self->priv->single_line_mode;
}
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
/**
* clutter_text_set_preedit_string:
* @self: a #ClutterText
* @preedit_str: (allow-none): the pre-edit string, or %NULL to unset it
* @preedit_attrs: (allow-none): the pre-edit string attributes
* @cursor_pos: the cursor position for the pre-edit string
*
* Sets, or unsets, the pre-edit string. This function is useful
* for input methods to display a string (with eventual specific
* Pango attributes) before it is entered inside the #ClutterText
* buffer.
*
* The preedit string and attributes are ignored if the #ClutterText
* actor is not editable.
*
* This function should not be used by applications
*
* Since: 1.2
*/
void
clutter_text_set_preedit_string (ClutterText *self,
const gchar *preedit_str,
PangoAttrList *preedit_attrs,
guint cursor_pos)
{
ClutterTextPrivate *priv;
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
g_free (priv->preedit_str);
[text] NULL-ify strings to avoid double-frees
2009-09-19 08:19:06 +00:00
priv->preedit_str = NULL;
[text] Add pre-edit string to ClutterText Input Methods require to be able to set a "pre-edit string", that is a string that it's just displayed into the Text actor without being committed to the actor's buffer. The string might require custom Pango attributes, and an update of the cursor position.
2009-09-09 11:15:23 +00:00
if (priv->preedit_attrs != NULL)
{
pango_attr_list_unref (priv->preedit_attrs);
priv->preedit_attrs = NULL;
}
priv->preedit_n_chars = 0;
priv->preedit_cursor_pos = 0;
if (preedit_str == NULL || *preedit_str == '\0')
priv->preedit_set = FALSE;
else
{
priv->preedit_str = g_strdup (preedit_str);
if (priv->preedit_str != NULL)
priv->preedit_n_chars = g_utf8_strlen (priv->preedit_str, -1);
else
priv->preedit_n_chars = 0;
if (preedit_attrs != NULL)
priv->preedit_attrs = pango_attr_list_ref (preedit_attrs);
priv->preedit_cursor_pos =
CLAMP (cursor_pos, 0, priv->preedit_n_chars);
priv->preedit_set = TRUE;
}
clutter_text_dirty_cache (self);
clutter_actor_queue_relayout (CLUTTER_ACTOR (self));
}
clutter-text: new clutter_text_get_layout_offsets API This new function can be used to retrieve the coordinates where the ClutterText will draw the PangoLayout representing the text. http://bugzilla.clutter-project.org/show_bug.cgi?id=2553
2011-02-04 11:33:53 +00:00
/**
* clutter_text_get_layout_offsets:
* @self: a #ClutterText
* @x: (out): location to store X offset of layout, or %NULL
* @y: (out): location to store Y offset of layout, or %NULL
*
* Obtains the coordinates where the #ClutterText will draw the #PangoLayout
* representing the text.
*
docs: Fix up Since annotation We only use stable releases for "since" tags.
2012-02-06 17:34:26 +00:00
* Since: 1.8
*/
clutter-text: new clutter_text_get_layout_offsets API This new function can be used to retrieve the coordinates where the ClutterText will draw the PangoLayout representing the text. http://bugzilla.clutter-project.org/show_bug.cgi?id=2553
2011-02-04 11:33:53 +00:00
void
clutter_text_get_layout_offsets (ClutterText *self,
gint *x,
gint *y)
{
ClutterTextPrivate *priv;
g_return_if_fail (CLUTTER_IS_TEXT (self));
priv = self->priv;
if (x != NULL)
*x = priv->text_x;
if (y != NULL)
*y = priv->text_y;
}
text: Add ::cursor-changed signal Since we are trying to eliminate the ClutterGeometry type, we should replace the only entry point still using it: the ::cursor-event signal of ClutterText. Instead of passing the cursor geometry, we should add an accessor function. The combination of signal and getter for the cursor geometry means that we can deprecate ClutterText::cursor-event, and mark it for removal in Clutter 2.0. https://bugzilla.gnome.org/show_bug.cgi?id=682789
2013-03-26 22:03:19 +00:00
/**
* clutter_text_get_cursor_rect:
* @self: a #ClutterText
* @rect: (out caller-allocates): return location of a #ClutterRect
*
* Retrieves the rectangle that contains the cursor.
*
* The coordinates of the rectangle's origin are in actor-relative
* coordinates.
*
* Since: 1.16
*/
void
clutter_text_get_cursor_rect (ClutterText *self,
ClutterRect *rect)
{
g_return_if_fail (CLUTTER_IS_TEXT (self));
g_return_if_fail (rect != NULL);
*rect = self->priv->cursor_rect;
}
clutter: Add input-purpose/hint properties to ClutterText So those properties can be changed or queried within shell UI.
2017-12-21 10:34:11 +00:00
void
clutter_text_set_input_hints (ClutterText *self,
ClutterInputContentHintFlags hints)
{
g_return_if_fail (CLUTTER_IS_TEXT (self));
self->priv->input_hints = hints;
clutter_input_focus_set_content_hints (self->priv->input_focus, hints);
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_INPUT_HINTS]);
}
ClutterInputContentHintFlags
clutter_text_get_input_hints (ClutterText *self)
{
g_return_val_if_fail (CLUTTER_IS_TEXT (self), 0);
return self->priv->input_hints;
}
void
clutter_text_set_input_purpose (ClutterText *self,
ClutterInputContentPurpose purpose)
{
g_return_if_fail (CLUTTER_IS_TEXT (self));
self->priv->input_purpose = purpose;
clutter_input_focus_set_content_purpose (self->priv->input_focus, purpose);
g_object_notify_by_pspec (G_OBJECT (self), obj_props[PROP_INPUT_PURPOSE]);
}
ClutterInputContentPurpose
clutter_text_get_input_purpose (ClutterText *self)
{
g_return_val_if_fail (CLUTTER_IS_TEXT (self), 0);
return self->priv->input_purpose;
}
clutter: Add clutter_text_has_preedit() This function returns TRUE if there is any preedit going on. This method will be useful in gnome-shell where similar checks are performed on StIMText actors.
2017-12-21 17:15:07 +00:00
gboolean
clutter_text_has_preedit (ClutterText *self)
{
g_return_val_if_fail (CLUTTER_IS_TEXT (self), FALSE);
return self->priv->preedit_set;
}
Reference in New Issue Copy Permalink