1. ----------------------------------------------------------------------- 
  2. --               GtkAda - Ada95 binding for Gtk+/Gnome               -- 
  3. --                                                                   -- 
  4. --   Copyright (C) 1998-2000 E. Briot, J. Brobecker and A. Charlet   -- 
  5. --                Copyright (C) 2000-2007 AdaCore                    -- 
  6. --                                                                   -- 
  7. -- This library is free software; you can redistribute it and/or     -- 
  8. -- modify it under the terms of the GNU General Public               -- 
  9. -- License as published by the Free Software Foundation; either      -- 
  10. -- version 2 of the License, or (at your option) any later version.  -- 
  11. --                                                                   -- 
  12. -- This library is distributed in the hope that it will be useful,   -- 
  13. -- but WITHOUT ANY WARRANTY; without even the implied warranty of    -- 
  14. -- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU -- 
  15. -- General Public License for more details.                          -- 
  16. --                                                                   -- 
  17. -- You should have received a copy of the GNU General Public         -- 
  18. -- License along with this library; if not, write to the             -- 
  19. -- Free Software Foundation, Inc., 59 Temple Place - Suite 330,      -- 
  20. -- Boston, MA 02111-1307, USA.                                       -- 
  21. --                                                                   --
    22. -- -- -- -- -- -- -- -- -- -- -- -- 
  22. ----------------------------------------------------------------------- 
  23.  
  24. --  <description> 
  25. --  The Gtk_Curve widget allows the user to edit a curve covering a range of 
  26. --  values. It is typically used to fine-tune color balances in graphics 
  27. --  applications like the Gimp. 
  28. -- 
  29. --  The Gtk_Curve widget has 3 modes of operation: spline, linear and free. 
  30. --  In spline mode the user places points on the curve which are automatically 
  31. --  connected together into a smooth curve. In linear mode the user places 
  32. --  points on the curve which are connected by straight lines. In free mode the 
  33. --  user can draw the points of the curve freely, and they are not connected at 
  34. --  all. 
  35. --  </description> 
  36. --  <c_version>2.8.17</c_version> 
  37. --  <group>Drawing</group> 
  38.  
  39. with Gtk.Drawing_Area; 
  40. with Gtk.Enums; use Gtk.Enums; 
  41. with Glib.Generic_Properties; use Glib.Generic_Properties; 
  42. pragma Elaborate_All (Glib.Generic_Properties); 
  43. with Glib.Properties; 
  44.  
  45. package Gtk.Curve is 
  46.  
  47.    type Gtk_Curve_Record is new 
  48.      Gtk.Drawing_Area.Gtk_Drawing_Area_Record with private; 
  49.    type Gtk_Curve is access all Gtk_Curve_Record'Class; 
  50.  
  51.    procedure Gtk_New (Curve : out Gtk_Curve); 
  52.    --  Create a new Curve. 
  53.  
  54.    procedure Initialize (Curve : access Gtk_Curve_Record'Class); 
  55.    --  Internal initialization function. 
  56.    --  See the section "Creating your own widgets" in the documentation. 
  57.  
  58.    function Get_Type return Gtk.Gtk_Type; 
  59.    --  Return the internal value associated with a Gtk_Curve. 
  60.  
  61.    procedure Reset (Curve : access Gtk_Curve_Record); 
  62.    --  Reset the curve. 
  63.    --  Reset to a straight line from the minimum x & y values to the maximum 
  64.    --  x & y values (i.e. from the bottom-left to the top-right corners). 
  65.    --  The curve type is not changed. 
  66.  
  67.    procedure Set_Gamma (Curve : access Gtk_Curve_Record; Gamma : Gfloat); 
  68.    --  Recompute the entire curve using the given gamma value. 
  69.    --  A gamma value of 1.0 results in a straight line. Values greater than 1.0 
  70.    --  result in a curve above the straight line. Values less than 1.0 result 
  71.    --  in a curve below the straight line. The curve type is changed to 
  72.    --  Curve_Type_Free. 
  73.  
  74.    procedure Set_Range 
  75.      (Curve : access Gtk_Curve_Record; 
  76.       Min_X : Gfloat; 
  77.       Max_X : Gfloat; 
  78.       Min_Y : Gfloat; 
  79.       Max_Y : Gfloat); 
  80.    --  Set the minimum and maximum x & y values of the curve. 
  81.    --  The curve is also reset with a call to Reset. 
  82.  
  83.    procedure Set_Vector 
  84.      (Curve  : access Gtk_Curve_Record; Vector : Gfloat_Array); 
  85.    procedure Get_Vector 
  86.      (Curve  : access Gtk_Curve_Record; Vector : out Gfloat_Array); 
  87.    --  Set the vector of points on the curve. 
  88.    --  The curve type is set to Curve_Type_Free. 
  89.  
  90.    procedure Set_Curve_Type 
  91.      (Curve      : access Gtk_Curve_Record; 
  92.       Curve_Type : Gtk_Curve_Type); 
  93.    --  Set the type of the curve. 
  94.    --  The curve will remain unchanged except when changing from a free curve 
  95.    --  to a linear or spline curve, in which case the curve will be changed as 
  96.    --  little as possible. 
  97.  
  98.    ---------------- 
  99.    -- Properties -- 
  100.    ---------------- 
  101.  
  102.    --  <properties> 
  103.    --  The following properties are defined for this widget. See 
  104.    --  Glib.Properties for more information on properties. 
  105.    -- 
  106.    --  - Name:  Curve_Type_Property 
  107.    --    Type:  Gtk_Curve_Type 
  108.    --    Flags: read-write 
  109.    --    Descr: Is this curve linear, spline interpolated, or free-form 
  110.    --    See also: Set_Curve_Type 
  111.    -- 
  112.    --  - Name:  Min_X_Property 
  113.    --    Type:  Gfloat 
  114.    --    Flags: read-write 
  115.    --    Descr: Minimum possible value for X 
  116.    --    See also: Set_Range 
  117.    -- 
  118.    --  - Name:  Min_Y_Property 
  119.    --    Type:  Gfloat 
  120.    --    Flags: read-write 
  121.    --    Descr: Minimum possible value for Y 
  122.    --    See also: Set_Range 
  123.    -- 
  124.    --  - Name:  Max_X_Property 
  125.    --    Type:  Gfloat 
  126.    --    Flags: read-write 
  127.    --    Descr: Maximum possible value for X 
  128.    --    See also: Set_Range 
  129.    -- 
  130.    --  - Name:  Max_Y_Property 
  131.    --    Type:  Gfloat 
  132.    --    Flags: read-write 
  133.    --    Descr: Maximum possible value for Y 
  134.    --    See also: Set_Range 
  135.    -- 
  136.    --  </properties> 
  137.  
  138.    package Curve_Type_Properties is new Generic_Internal_Discrete_Property 
  139.      (Gtk_Curve_Type); 
  140.    type Property_Gtk_Curve_Type   is new Curve_Type_Properties.Property; 
  141.  
  142.    Curve_Type_Property : constant Property_Gtk_Curve_Type; 
  143.    Min_X_Property      : constant Glib.Properties.Property_Float; 
  144.    Max_X_Property      : constant Glib.Properties.Property_Float; 
  145.    Min_Y_Property      : constant Glib.Properties.Property_Float; 
  146.    Max_Y_Property      : constant Glib.Properties.Property_Float; 
  147.  
  148.    ------------- 
  149.    -- Signals -- 
  150.    ------------- 
  151.  
  152.    --  <signals> 
  153.    --  The following new signals are defined for this widget: 
  154.    --   - "curve-type-changed" 
  155.    --     procedure Handler (Curve : access Gtk_Curve_Record'Class); 
  156.    -- 
  157.    --  Emitted when the curve type has been changed. The curve type can be 
  158.    --  changed explicitly with a call to Set_Curve_Type. It is also changed as 
  159.    --  a side-effect of calling Reset or Set_Gamma. 
  160.    --  </signals> 
  161.  
  162.    Signal_Curve_Type_Changed : constant Glib.Signal_Name := 
  163.                                  "curve_type_changed"; 
  164.  
  165. private 
  166.    type Gtk_Curve_Record is new Gtk.Drawing_Area.Gtk_Drawing_Area_Record 
  167.      with null record; 
  168.  
  169.    Curve_Type_Property : constant Property_Gtk_Curve_Type := 
  170.      Build ("curve_type"); 
  171.    Min_X_Property      : constant Glib.Properties.Property_Float := 
  172.      Glib.Properties.Build ("min_x"); 
  173.    Max_X_Property      : constant Glib.Properties.Property_Float := 
  174.      Glib.Properties.Build ("max_x"); 
  175.    Min_Y_Property      : constant Glib.Properties.Property_Float := 
  176.      Glib.Properties.Build ("min_y"); 
  177.    Max_Y_Property      : constant Glib.Properties.Property_Float := 
  178.      Glib.Properties.Build ("max_y"); 
  179.  
  180.    pragma Import (C, Get_Type, "gtk_curve_get_type"); 
  181. end Gtk.Curve;