## Documentation

Table of Contents
Class Inheritance Tree
Widget Screenshots
Package groups

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-2002 ACT-Europe                 --

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.     -- As a special exception, if other files instantiate generics from  --

23.     -- this unit, or you link this unit with other files to produce an   --

24.     -- executable, this  unit  does not  by itself cause  the resulting  --

25.     -- executable to be covered by the GNU General Public License. This  --

26.     -- exception does not however invalidate any other reasons why the   --

27.     -- executable file  might be covered by the  GNU Public License.     --

28.     -----------------------------------------------------------------------

30.     --  <description>

31.     --

32.     --  Pixmaps are off-screen drawables. They can be drawn upon with the standard

33.     --  drawing primitives, then copied to another drawable (such as a Gdk_Window)

34.     --  with Gdk.Drawable.Draw_Drawable. The depth of a pixmap is the number of

35.     --  bits per pixels. Bitmaps are simply pixmaps with a depth of 1. (That is,

36.     --  they are monochrome bitmaps - each pixel can be either on or off).

37.     --  See Gdk.Pixmap for more details on pixmap handling.

38.     --

39.     --  </description>

40.     --  <c_version>1.3.6</c_version>

41.     --  <group>Gdk, the low-level API</group>

43.     with GlibTo API docTo specTo body; use GlibTo API docTo specTo body;

45.     with Gdk.WindowTo API docTo specTo body;

47.     package Gdk.BitmapTo API docTo specTo body is

49.        subtype Gdk_Bitmap is Gdk.Gdk_BitmapTo API docTo spec;

50.        --  A black and white image.

51.        --  This type is mainly used as a mask when drawing other colored images.

52.        --  Each pixel can have two values, 0 or 1.

54.        Null_Bitmap : constant Gdk_BitmapTo API docTo spec;

56.        procedure Gdk_NewTo API docTo body

57.          (Bitmap : out Gdk_BitmapTo API docTo spec;

58.           Window : Gdk.Window.Gdk_WindowTo API docTo spec;

59.           Width  : GintTo API docTo spec;

60.           Height : GintTo API docTo spec);

61.        --  Create a new bitmap with a given size.

62.        --  Window is used to determine default values for the new bitmap.

63.        --  Can be eventually null in which case the root window is used.

64.        --  Width is the width of the new bitmap in pixels.

65.        --  Height is the height of the new bitmap in pixels.

67.        procedure RefTo API docTo body (Bitmap : Gdk_BitmapTo API docTo spec);

68.        --  Add a reference to a bitmap.

70.        procedure UnrefTo API docTo body (Bitmap : Gdk_BitmapTo API docTo spec);

71.        --  This is the usual way to destroy a bitmap. The memory is freed when

72.        --  there is no more reference

74.        procedure Create_From_DataTo API docTo body

75.          (Bitmap : out Gdk_BitmapTo API docTo spec;

76.           Window : Gdk.Window.Gdk_WindowTo API docTo spec;

77.           Data   : String;

78.           Width  : GintTo API docTo spec;

79.           Height : GintTo API docTo spec);

80.        --  Create a bitmap from data in XBM format.

81.        --  Window is used to determine default values for the new bitmap, can be

82.        --  null in which case the root window is used.

83.        --  Data is the XBM data.

84.        --  Width is the width of the new bitmap in pixels.

85.        --  Height is the height of the new bitmap in pixels.

87.     private

88.        Null_BitmapTo API docTo spec : constant Gdk_BitmapTo API docTo spec := null;

89.        pragma Import (C, RefTo API docTo spec, "gdk_drawable_ref");

90.        pragma Import (C, UnrefTo API docTo spec, "gdk_drawable_unref");

91.     end Gdk.BitmapTo API docTo specTo body;