X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fada%2Fterminal_interface-curses__ads.htm;h=b45b93c8bbea2112c675467cd9039a15a9816f3d;hp=208b12a16537387cc3a89c2e9e34e59919012e44;hb=a8987e73ec254703634802b4f7ee30d3a485524d;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34 diff --git a/doc/html/ada/terminal_interface-curses__ads.htm b/doc/html/ada/terminal_interface-curses__ads.htm index 208b12a1..b45b93c8 100644 --- a/doc/html/ada/terminal_interface-curses__ads.htm +++ b/doc/html/ada/terminal_interface-curses__ads.htm @@ -38,9 +38,9 @@ -- sale, use or other dealings in this Software without prior written -- -- authorization. -- ------------------------------------------------------------------------------ --- Author: Jürgen Pfeifer <<juergen.pfeifer@gmx.net>> 1996 +-- Author: Juergen Pfeifer, 1996 -- Version Control: --- @Revision: 1.28 @ +-- @Revision: 1.31 @ -- Binding Version 01.00 ------------------------------------------------------------------------------ -- curses binding. @@ -55,8 +55,8 @@ pragma Linker_Options ("-lncurses"); NC_Major_Version : constant := 5; -- Major version of the library - NC_Minor_Version : constant := 0; -- Minor version of the library - NC_Version : constant String := "5.0"; -- Version of library + NC_Minor_Version : constant := 3; -- Minor version of the library + NC_Version : constant String := "5.3"; -- Version of library type Window is private; Null_Window : constant Window; @@ -278,27 +278,28 @@ ------------------------------------------------------------------------------ - type Color_Number is range 0 .. Integer (Interfaces.C.short'Last); + type Color_Number is range -1 .. Integer (Interfaces.C.short'Last); for Color_Number'Size use Interfaces.C.short'Size; -- (n)curses uses a short for the color index -- The model is, that a Color_Number is an index into an array of -- (potentially) definable colors. Some of those indices are -- predefined (see below), although they may not really exist. - Black : constant Color_Number := 0; - Red : constant Color_Number := 1; - Green : constant Color_Number := 2; - Yellow : constant Color_Number := 3; - Blue : constant Color_Number := 4; - Magenta : constant Color_Number := 5; - Cyan : constant Color_Number := 6; - White : constant Color_Number := 7; - - type RGB_Value is range 0 .. Integer (Interfaces.C.short'Last); + Default_Color : constant Color_Number := -1; + Black : constant Color_Number := 0; + Red : constant Color_Number := 1; + Green : constant Color_Number := 2; + Yellow : constant Color_Number := 3; + Blue : constant Color_Number := 4; + Magenta : constant Color_Number := 5; + Cyan : constant Color_Number := 6; + White : constant Color_Number := 7; + + type RGB_Value is range 0 .. Integer (Interfaces.C.short'Last); for RGB_Value'Size use Interfaces.C.short'Size; -- Some system may allow to redefine a color by setting RGB values. - type Color_Pair is range 0 .. 255; + type Color_Pair is range 0 .. 255; for Color_Pair'Size use 8; subtype Redefinable_Color_Pair is Color_Pair range 1 .. 255; -- (n)curses reserves 1 Byte for the color-pair number. Color Pair 0 @@ -308,22 +309,22 @@ type Character_Attribute_Set is record - Stand_Out : Boolean; - Under_Line : Boolean; - Reverse_Video : Boolean; - Blink : Boolean; - Dim_Character : Boolean; - Bold_Character : Boolean; - Alternate_Character_Set : Boolean; - Invisible_Character : Boolean; - Protected_Character : Boolean; - Horizontal : Boolean; - Left : Boolean; - Low : Boolean; - Right : Boolean; - Top : Boolean; + Stand_Out : Boolean; + Under_Line : Boolean; + Reverse_Video : Boolean; + Blink : Boolean; + Dim_Character : Boolean; + Bold_Character : Boolean; + Alternate_Character_Set : Boolean; + Invisible_Character : Boolean; + Protected_Character : Boolean; + Horizontal : Boolean; + Left : Boolean; + Low : Boolean; + Right : Boolean; + Top : Boolean; Vertical : Boolean; - end record; + end record; pragma Pack (Character_Attribute_Set); pragma Convention (C, Character_Attribute_Set); @@ -354,9 +355,9 @@ type Attributed_Character is record - Attr : Character_Attribute_Set; - Color : Color_Pair; - Ch : Character; + Attr : Character_Attribute_Set; + Color : Color_Pair; + Ch : Character; end record; pragma Convention (C, Attributed_Character); -- This is the counterpart for the chtype in C. @@ -372,7 +373,7 @@ -- different on your system. Default_Character : constant Attributed_Character - := (Ch => Character'First, + := (Ch => Character'First, Color => Color_Pair'First, Attr => (others => False)); -- preelaboratable Normal_Video @@ -383,25 +384,25 @@ ------------------ -- Exceptions -- ------------------ - Curses_Exception : exception; + Curses_Exception : exception; Wrong_Curses_Version : exception; -- Those exceptions are raised by the ETI (Extended Terminal Interface) -- subpackets for Menu and Forms handling. -- - Eti_System_Error : exception; - Eti_Bad_Argument : exception; - Eti_Posted : exception; - Eti_Connected : exception; - Eti_Bad_State : exception; - Eti_No_Room : exception; - Eti_Not_Posted : exception; - Eti_Unknown_Command : exception; - Eti_No_Match : exception; - Eti_Not_Selectable : exception; - Eti_Not_Connected : exception; - Eti_Request_Denied : exception; - Eti_Invalid_Field : exception; + Eti_System_Error : exception; + Eti_Bad_Argument : exception; + Eti_Posted : exception; + Eti_Connected : exception; + Eti_Bad_State : exception; + Eti_No_Room : exception; + Eti_Not_Posted : exception; + Eti_Unknown_Command : exception; + Eti_No_Match : exception; + Eti_Not_Selectable : exception; + Eti_Not_Connected : exception; + Eti_Request_Denied : exception; + Eti_Invalid_Field : exception; Eti_Current : exception; -------------------------------------------------------------------------- @@ -412,7 +413,7 @@ -- this is to use functions. -------------------------------------------------------------------------- - function Lines return Line_Count; + function Lines return Line_Count; pragma Inline (Lines); function Columns return Column_Count; @@ -436,43 +437,43 @@ -- You must use this constants as indices into the ACS_Map array -- to get the corresponding attributed character at runtime. -- - ACS_Upper_Left_Corner : constant Character := 'l'; - ACS_Lower_Left_Corner : constant Character := 'm'; - ACS_Upper_Right_Corner : constant Character := 'k'; - ACS_Lower_Right_Corner : constant Character := 'j'; - ACS_Left_Tee : constant Character := 't'; - ACS_Right_Tee : constant Character := 'u'; - ACS_Bottom_Tee : constant Character := 'v'; - ACS_Top_Tee : constant Character := 'w'; - ACS_Horizontal_Line : constant Character := 'q'; - ACS_Vertical_Line : constant Character := 'x'; - ACS_Plus_Symbol : constant Character := 'n'; - ACS_Scan_Line_1 : constant Character := 'o'; - ACS_Scan_Line_9 : constant Character := 's'; - ACS_Diamond : constant Character := Character'Val (96); - ACS_Checker_Board : constant Character := 'a'; - ACS_Degree : constant Character := 'f'; - ACS_Plus_Minus : constant Character := 'g'; - ACS_Bullet : constant Character := '~'; - ACS_Left_Arrow : constant Character := ','; - ACS_Right_Arrow : constant Character := '+'; - ACS_Down_Arrow : constant Character := '.'; - ACS_Up_Arrow : constant Character := '-'; - ACS_Board_Of_Squares : constant Character := 'h'; - ACS_Lantern : constant Character := 'i'; - ACS_Solid_Block : constant Character := '0'; - ACS_Scan_Line_3 : constant Character := 'p'; - ACS_Scan_Line_7 : constant Character := 'r'; - ACS_Less_Or_Equal : constant Character := 'y'; - ACS_Greater_Or_Equal : constant Character := 'z'; - ACS_PI : constant Character := '{'; - ACS_Not_Equal : constant Character := '|'; + ACS_Upper_Left_Corner : constant Character := 'l'; + ACS_Lower_Left_Corner : constant Character := 'm'; + ACS_Upper_Right_Corner : constant Character := 'k'; + ACS_Lower_Right_Corner : constant Character := 'j'; + ACS_Left_Tee : constant Character := 't'; + ACS_Right_Tee : constant Character := 'u'; + ACS_Bottom_Tee : constant Character := 'v'; + ACS_Top_Tee : constant Character := 'w'; + ACS_Horizontal_Line : constant Character := 'q'; + ACS_Vertical_Line : constant Character := 'x'; + ACS_Plus_Symbol : constant Character := 'n'; + ACS_Scan_Line_1 : constant Character := 'o'; + ACS_Scan_Line_9 : constant Character := 's'; + ACS_Diamond : constant Character := Character'Val (96); + ACS_Checker_Board : constant Character := 'a'; + ACS_Degree : constant Character := 'f'; + ACS_Plus_Minus : constant Character := 'g'; + ACS_Bullet : constant Character := '~'; + ACS_Left_Arrow : constant Character := ','; + ACS_Right_Arrow : constant Character := '+'; + ACS_Down_Arrow : constant Character := '.'; + ACS_Up_Arrow : constant Character := '-'; + ACS_Board_Of_Squares : constant Character := 'h'; + ACS_Lantern : constant Character := 'i'; + ACS_Solid_Block : constant Character := '0'; + ACS_Scan_Line_3 : constant Character := 'p'; + ACS_Scan_Line_7 : constant Character := 'r'; + ACS_Less_Or_Equal : constant Character := 'y'; + ACS_Greater_Or_Equal : constant Character := 'z'; + ACS_PI : constant Character := '{'; + ACS_Not_Equal : constant Character := '|'; ACS_Sterling : constant Character := '}'; -- |===================================================================== -- | Man page curs_initscr.3x -- |===================================================================== - -- | Not implemented: newterm, set_term, delscreen + -- | Not implemented: newterm, set_term, delscreen, curscr -- #1A NAME="AFU_1"#2| function Standard_Window return Window; @@ -485,14 +486,14 @@ -- #1A NAME="AFU_3"#2| procedure Init_Windows renames Init_Screen; -- AKA: initscr() - pragma Inline (Init_Screen); + pragma Inline (Init_Screen); pragma Inline (Init_Windows); -- #1A NAME="AFU_4"#2| procedure End_Windows; -- AKA: endwin() procedure End_Screen renames End_Windows; - pragma Inline (End_Windows); + pragma Inline (End_Windows); pragma Inline (End_Screen); -- #1A NAME="AFU_5"#2| @@ -505,10 +506,11 @@ -- |===================================================================== -- #1A NAME="AFU_6"#2| - procedure Move_Cursor (Win : in Window := Standard_Window; - Line : in Line_Position; + procedure Move_Cursor (Win : in Window := Standard_Window; + Line : in Line_Position; Column : in Column_Position); -- AKA: wmove() + -- AKA: move() pragma Inline (Move_Cursor); -- |===================================================================== @@ -516,39 +518,42 @@ -- |===================================================================== -- #1A NAME="AFU_7"#2| - procedure Add (Win : in Window := Standard_Window; + procedure Add (Win : in Window := Standard_Window; Ch : in Attributed_Character); -- AKA: waddch() + -- AKA: addch() - procedure Add (Win : in Window := Standard_Window; + procedure Add (Win : in Window := Standard_Window; Ch : in Character); -- Add a single character at the current logical cursor position to -- the window. Use the current windows attributes. -- #1A NAME="AFU_8"#2| procedure Add - (Win : in Window := Standard_Window; - Line : in Line_Position; - Column : in Column_Position; + (Win : in Window := Standard_Window; + Line : in Line_Position; + Column : in Column_Position; Ch : in Attributed_Character); -- AKA: mvwaddch() + -- AKA: mvaddch() procedure Add - (Win : in Window := Standard_Window; - Line : in Line_Position; - Column : in Column_Position; + (Win : in Window := Standard_Window; + Line : in Line_Position; + Column : in Column_Position; Ch : in Character); -- Move to the position and add a single character into the window -- There are more Add routines, so the Inline pragma follows later -- #1A NAME="AFU_9"#2| procedure Add_With_Immediate_Echo - (Win : in Window := Standard_Window; + (Win : in Window := Standard_Window; Ch : in Attributed_Character); -- AKA: wechochar() + -- AKA: echochar() procedure Add_With_Immediate_Echo - (Win : in Window := Standard_Window; + (Win : in Window := Standard_Window; Ch : in Character); -- Add a character and do an immediate refresh of the screen. pragma Inline (Add_With_Immediate_Echo); @@ -556,20 +561,23 @@ -- |===================================================================== -- | Man page curs_window.3x -- |===================================================================== + -- Not Implemented: wcursyncup -- #1A NAME="AFU_10"#2| function Create - (Number_Of_Lines : Line_Count; - Number_Of_Columns : Column_Count; - First_Line_Position : Line_Position; + (Number_Of_Lines : Line_Count; + Number_Of_Columns : Column_Count; + First_Line_Position : Line_Position; First_Column_Position : Column_Position) return Window; + -- Not Implemented: Default Number_Of_Lines, Number_Of_Columns + -- the C version lets them be 0, see the man page. -- AKA: newwin() pragma Inline (Create); function New_Window - (Number_Of_Lines : Line_Count; - Number_Of_Columns : Column_Count; - First_Line_Position : Line_Position; + (Number_Of_Lines : Line_Count; + Number_Of_Columns : Column_Count; + First_Line_Position : Line_Position; First_Column_Position : Column_Position) return Window renames Create; pragma Inline (New_Window); @@ -582,20 +590,20 @@ -- #1A NAME="AFU_12"#2| function Sub_Window - (Win : Window := Standard_Window; - Number_Of_Lines : Line_Count; - Number_Of_Columns : Column_Count; - First_Line_Position : Line_Position; + (Win : Window := Standard_Window; + Number_Of_Lines : Line_Count; + Number_Of_Columns : Column_Count; + First_Line_Position : Line_Position; First_Column_Position : Column_Position) return Window; -- AKA: subwin() pragma Inline (Sub_Window); -- #1A NAME="AFU_13"#2| function Derived_Window - (Win : Window := Standard_Window; - Number_Of_Lines : Line_Count; - Number_Of_Columns : Column_Count; - First_Line_Position : Line_Position; + (Win : Window := Standard_Window; + Number_Of_Lines : Line_Count; + Number_Of_Columns : Column_Count; + First_Line_Position : Line_Position; First_Column_Position : Column_Position) return Window; -- AKA: derwin() pragma Inline (Derived_Window); @@ -606,15 +614,15 @@ pragma Inline (Duplicate); -- #1A NAME="AFU_15"#2| - procedure Move_Window (Win : in Window; - Line : in Line_Position; + procedure Move_Window (Win : in Window; + Line : in Line_Position; Column : in Column_Position); -- AKA: mvwin() pragma Inline (Move_Window); -- #1A NAME="AFU_16"#2| - procedure Move_Derived_Window (Win : in Window; - Line : in Line_Position; + procedure Move_Derived_Window (Win : in Window; + Line : in Line_Position; Column : in Column_Position); -- AKA: mvderwin() pragma Inline (Move_Derived_Window); @@ -630,7 +638,7 @@ pragma Import (C, Synchronize_Downwards, "wsyncdown"); -- #1A NAME="AFU_19"#2| - procedure Set_Synch_Mode (Win : in Window := Standard_Window; + procedure Set_Synch_Mode (Win : in Window := Standard_Window; Mode : in Boolean := False); -- AKA: syncok() pragma Inline (Set_Synch_Mode); @@ -640,93 +648,108 @@ -- |===================================================================== -- #1A NAME="AFU_20"#2| - procedure Add (Win : in Window := Standard_Window; - Str : in String; + procedure Add (Win : in Window := Standard_Window; + Str : in String; Len : in Integer := -1); -- AKA: waddnstr() -- AKA: waddstr() + -- AKA: addnstr() + -- AKA: addstr() -- #1A NAME="AFU_21"#2| - procedure Add (Win : in Window := Standard_Window; - Line : in Line_Position; - Column : in Column_Position; - Str : in String; + procedure Add (Win : in Window := Standard_Window; + Line : in Line_Position; + Column : in Column_Position; + Str : in String; Len : in Integer := -1); -- AKA: mvwaddnstr() -- AKA: mvwaddstr() + -- AKA: mvaddnstr() + -- AKA: mvaddstr() -- |===================================================================== -- | Man page curs_addchstr.3x -- |===================================================================== -- #1A NAME="AFU_22"#2| - procedure Add (Win : in Window := Standard_Window; - Str : in Attributed_String; + procedure Add (Win : in Window := Standard_Window; + Str : in Attributed_String; Len : in Integer := -1); -- AKA: waddchnstr() -- AKA: waddchstr() + -- AKA: addchnstr() + -- AKA: addchstr() -- #1A NAME="AFU_23"#2| - procedure Add (Win : in Window := Standard_Window; - Line : in Line_Position; - Column : in Column_Position; - Str : in Attributed_String; + procedure Add (Win : in Window := Standard_Window; + Line : in Line_Position; + Column : in Column_Position; + Str : in Attributed_String; Len : in Integer := -1); -- AKA: mvwaddchnstr() -- AKA: mvwaddchstr() + -- AKA: mvaddchnstr() + -- AKA: mvaddchstr() pragma Inline (Add); -- |===================================================================== -- | Man page curs_border.3x -- |===================================================================== + -- | Not implemented: mvhline, mvwhline, mvvline, mvwvline + -- | use Move_Cursor then Horizontal_Line or Vertical_Line -- #1A NAME="AFU_24"#2| procedure Border - (Win : in Window := Standard_Window; - Left_Side_Symbol : in Attributed_Character := Default_Character; - Right_Side_Symbol : in Attributed_Character := Default_Character; - Top_Side_Symbol : in Attributed_Character := Default_Character; - Bottom_Side_Symbol : in Attributed_Character := Default_Character; - Upper_Left_Corner_Symbol : in Attributed_Character := Default_Character; - Upper_Right_Corner_Symbol : in Attributed_Character := Default_Character; - Lower_Left_Corner_Symbol : in Attributed_Character := Default_Character; + (Win : in Window := Standard_Window; + Left_Side_Symbol : in Attributed_Character := Default_Character; + Right_Side_Symbol : in Attributed_Character := Default_Character; + Top_Side_Symbol : in Attributed_Character := Default_Character; + Bottom_Side_Symbol : in Attributed_Character := Default_Character; + Upper_Left_Corner_Symbol : in Attributed_Character := Default_Character; + Upper_Right_Corner_Symbol : in Attributed_Character := Default_Character; + Lower_Left_Corner_Symbol : in Attributed_Character := Default_Character; Lower_Right_Corner_Symbol : in Attributed_Character := Default_Character ); -- AKA: wborder() + -- AKA: border() pragma Inline (Border); -- #1A NAME="AFU_25"#2| procedure Box - (Win : in Window := Standard_Window; - Vertical_Symbol : in Attributed_Character := Default_Character; + (Win : in Window := Standard_Window; + Vertical_Symbol : in Attributed_Character := Default_Character; Horizontal_Symbol : in Attributed_Character := Default_Character); -- AKA: box() pragma Inline (Box); -- #1A NAME="AFU_26"#2| procedure Horizontal_Line - (Win : in Window := Standard_Window; - Line_Size : in Natural; + (Win : in Window := Standard_Window; + Line_Size : in Natural; Line_Symbol : in Attributed_Character := Default_Character); -- AKA: whline() + -- AKA: hline() pragma Inline (Horizontal_Line); -- #1A NAME="AFU_27"#2| procedure Vertical_Line - (Win : in Window := Standard_Window; - Line_Size : in Natural; + (Win : in Window := Standard_Window; + Line_Size : in Natural; Line_Symbol : in Attributed_Character := Default_Character); -- AKA: wvline() + -- AKA: vline() pragma Inline (Vertical_Line); -- |===================================================================== -- | Man page curs_getch.3x -- |===================================================================== + -- Not implemented: mvgetch, mvwgetch -- #1A NAME="AFU_28"#2| function Get_Keystroke (Win : Window := Standard_Window) return Real_Key_Code; -- AKA: wgetch() + -- AKA: getch() -- Get a character from the keyboard and echo it - if enabled - to the -- window. -- If for any reason (i.e. a timeout) we couldn't get a character the @@ -765,69 +788,88 @@ -- |===================================================================== -- | Man page curs_attr.3x -- |===================================================================== + -- | Not implemented attr_off, wattr_off, + -- | attr_on, wattr_on, attr_set, wattr_set + + -- PAIR_NUMBER + -- PAIR_NUMBER(c) is the same as c.Color -- #1A NAME="AFU_31"#2| + procedure Standout (Win : Window := Standard_Window; + On : Boolean := True); + -- AKA: wstandout() + -- AKA: wstandend() + + -- #1A NAME="AFU_32"#2| procedure Switch_Character_Attribute - (Win : in Window := Standard_Window; - Attr : in Character_Attribute_Set := Normal_Video; + (Win : in Window := Standard_Window; + Attr : in Character_Attribute_Set := Normal_Video; On : in Boolean := True); -- if False we switch Off. + -- Switches those Attributes set to true in the list. -- AKA: wattron() -- AKA: wattroff() + -- AKA: attron() + -- AKA: attroff() - -- #1A NAME="AFU_32"#2| + -- #1A NAME="AFU_33"#2| procedure Set_Character_Attributes - (Win : in Window := Standard_Window; - Attr : in Character_Attribute_Set := Normal_Video; + (Win : in Window := Standard_Window; + Attr : in Character_Attribute_Set := Normal_Video; Color : in Color_Pair := Color_Pair'First); -- AKA: wattrset() + -- AKA: attrset() pragma Inline (Set_Character_Attributes); - -- #1A NAME="AFU_33"#2| + -- #1A NAME="AFU_34"#2| function Get_Character_Attribute (Win : in Window := Standard_Window) return Character_Attribute_Set; -- AKA: wattr_get() + -- AKA: attr_get() - -- #1A NAME="AFU_34"#2| + -- #1A NAME="AFU_35"#2| function Get_Character_Attribute (Win : in Window := Standard_Window) return Color_Pair; -- AKA: wattr_get() pragma Inline (Get_Character_Attribute); - -- #1A NAME="AFU_35"#2| - procedure Set_Color (Win : in Window := Standard_Window; + -- #1A NAME="AFU_36"#2| + procedure Set_Color (Win : in Window := Standard_Window; Pair : in Color_Pair); -- AKA: wcolor_set() + -- AKA: color_set() pragma Inline (Set_Color); - -- #1A NAME="AFU_36"#2| + -- #1A NAME="AFU_37"#2| procedure Change_Attributes - (Win : in Window := Standard_Window; - Count : in Integer := -1; - Attr : in Character_Attribute_Set := Normal_Video; + (Win : in Window := Standard_Window; + Count : in Integer := -1; + Attr : in Character_Attribute_Set := Normal_Video; Color : in Color_Pair := Color_Pair'First); -- AKA: wchgat() + -- AKA: chgat() - -- #1A NAME="AFU_37"#2| + -- #1A NAME="AFU_38"#2| procedure Change_Attributes - (Win : in Window := Standard_Window; - Line : in Line_Position := Line_Position'First; - Column : in Column_Position := Column_Position'First; - Count : in Integer := -1; - Attr : in Character_Attribute_Set := Normal_Video; + (Win : in Window := Standard_Window; + Line : in Line_Position := Line_Position'First; + Column : in Column_Position := Column_Position'First; + Count : in Integer := -1; + Attr : in Character_Attribute_Set := Normal_Video; Color : in Color_Pair := Color_Pair'First); -- AKA: mvwchgat() + -- AKA: mvchgat() pragma Inline (Change_Attributes); -- |===================================================================== -- | Man page curs_beep.3x -- |===================================================================== - -- #1A NAME="AFU_38"#2| + -- #1A NAME="AFU_39"#2| procedure Beep; -- AKA: beep() pragma Inline (Beep); - -- #1A NAME="AFU_39"#2| + -- #1A NAME="AFU_40"#2| procedure Flash_Screen; -- AKA: flash() pragma Inline (Flash_Screen); @@ -838,81 +880,87 @@ -- | Not implemented : typeahead -- - -- #1A NAME="AFU_40"#2| + -- #1A NAME="AFU_41"#2| procedure Set_Cbreak_Mode (SwitchOn : in Boolean := True); -- AKA: cbreak() -- AKA: nocbreak() pragma Inline (Set_Cbreak_Mode); - -- #1A NAME="AFU_41"#2| + -- #1A NAME="AFU_42"#2| procedure Set_Raw_Mode (SwitchOn : in Boolean := True); -- AKA: raw() -- AKA: noraw() pragma Inline (Set_Raw_Mode); - -- #1A NAME="AFU_42"#2| + -- #1A NAME="AFU_43"#2| procedure Set_Echo_Mode (SwitchOn : in Boolean := True); -- AKA: echo() -- AKA: noecho() pragma Inline (Set_Echo_Mode); - -- #1A NAME="AFU_43"#2| - procedure Set_Meta_Mode (Win : in Window := Standard_Window; + -- #1A NAME="AFU_44"#2| + procedure Set_Meta_Mode (Win : in Window := Standard_Window; SwitchOn : in Boolean := True); -- AKA: meta() pragma Inline (Set_Meta_Mode); - -- #1A NAME="AFU_44"#2| - procedure Set_KeyPad_Mode (Win : in Window := Standard_Window; + -- #1A NAME="AFU_45"#2| + procedure Set_KeyPad_Mode (Win : in Window := Standard_Window; SwitchOn : in Boolean := True); -- AKA: keypad() pragma Inline (Set_KeyPad_Mode); + function Get_KeyPad_Mode (Win : in Window := Standard_Window) + return Boolean; + -- This has no pendant in C. There you've to look into the WINDOWS + -- structure to get the value. Bad practice, not repeated in Ada. + type Half_Delay_Amount is range 1 .. 255; - -- #1A NAME="AFU_45"#2| + -- #1A NAME="AFU_46"#2| procedure Half_Delay (Amount : in Half_Delay_Amount); -- AKA: halfdelay() pragma Inline (Half_Delay); - -- #1A NAME="AFU_46"#2| + -- #1A NAME="AFU_47"#2| procedure Set_Flush_On_Interrupt_Mode - (Win : in Window := Standard_Window; + (Win : in Window := Standard_Window; Mode : in Boolean := True); -- AKA: intrflush() pragma Inline (Set_Flush_On_Interrupt_Mode); - -- #1A NAME="AFU_47"#2| + -- #1A NAME="AFU_48"#2| procedure Set_Queue_Interrupt_Mode - (Win : in Window := Standard_Window; + (Win : in Window := Standard_Window; Flush : in Boolean := True); -- AKA: qiflush() -- AKA: noqiflush() pragma Inline (Set_Queue_Interrupt_Mode); - -- #1A NAME="AFU_48"#2| + -- #1A NAME="AFU_49"#2| procedure Set_NoDelay_Mode - (Win : in Window := Standard_Window; + (Win : in Window := Standard_Window; Mode : in Boolean := False); -- AKA: nodelay() pragma Inline (Set_NoDelay_Mode); type Timeout_Mode is (Blocking, Non_Blocking, Delayed); - -- #1A NAME="AFU_49"#2| - procedure Set_Timeout_Mode (Win : in Window := Standard_Window; - Mode : in Timeout_Mode; + -- #1A NAME="AFU_50"#2| + procedure Set_Timeout_Mode (Win : in Window := Standard_Window; + Mode : in Timeout_Mode; Amount : in Natural); -- in Milliseconds -- AKA: wtimeout() + -- AKA: timeout() -- Instead of overloading the semantic of the sign of amount, we -- introduce the Timeout_Mode parameter. This should improve -- readability. For Blocking and Non_Blocking, the Amount is not -- evaluated. -- We don't inline this procedure. - -- #1A NAME="AFU_50"#2| + -- #1A NAME="AFU_51"#2| procedure Set_Escape_Timer_Mode - (Win : in Window := Standard_Window; + (Win : in Window := Standard_Window; Timer_Off : in Boolean := False); -- AKA: notimeout() pragma Inline (Set_Escape_Timer_Mode); @@ -921,50 +969,50 @@ -- | Man page curs_outopts.3x -- |===================================================================== - -- #1A NAME="AFU_51"#2| + -- #1A NAME="AFU_52"#2| procedure Set_NL_Mode (SwitchOn : in Boolean := True); -- AKA: nl() -- AKA: nonl() pragma Inline (Set_NL_Mode); - -- #1A NAME="AFU_52"#2| + -- #1A NAME="AFU_53"#2| procedure Clear_On_Next_Update - (Win : in Window := Standard_Window; + (Win : in Window := Standard_Window; Do_Clear : in Boolean := True); -- AKA: clearok() pragma Inline (Clear_On_Next_Update); - -- #1A NAME="AFU_53"#2| + -- #1A NAME="AFU_54"#2| procedure Use_Insert_Delete_Line - (Win : in Window := Standard_Window; + (Win : in Window := Standard_Window; Do_Idl : in Boolean := True); -- AKA: idlok() pragma Inline (Use_Insert_Delete_Line); - -- #1A NAME="AFU_54"#2| + -- #1A NAME="AFU_55"#2| procedure Use_Insert_Delete_Character - (Win : in Window := Standard_Window; + (Win : in Window := Standard_Window; Do_Idc : in Boolean := True); -- AKA: idcok() pragma Inline (Use_Insert_Delete_Character); - -- #1A NAME="AFU_55"#2| + -- #1A NAME="AFU_56"#2| procedure Leave_Cursor_After_Update - (Win : in Window := Standard_Window; + (Win : in Window := Standard_Window; Do_Leave : in Boolean := True); -- AKA: leaveok() pragma Inline (Leave_Cursor_After_Update); - -- #1A NAME="AFU_56"#2| + -- #1A NAME="AFU_57"#2| procedure Immediate_Update_Mode - (Win : in Window := Standard_Window; + (Win : in Window := Standard_Window; Mode : in Boolean := False); -- AKA: immedok() pragma Inline (Immediate_Update_Mode); - -- #1A NAME="AFU_57"#2| + -- #1A NAME="AFU_58"#2| procedure Allow_Scrolling - (Win : in Window := Standard_Window; + (Win : in Window := Standard_Window; Mode : in Boolean := False); -- AKA: scrollok() pragma Inline (Allow_Scrolling); @@ -973,43 +1021,45 @@ -- There is no such function in the C interface. pragma Inline (Scrolling_Allowed); - -- #1A NAME="AFU_58"#2| + -- #1A NAME="AFU_59"#2| procedure Set_Scroll_Region - (Win : in Window := Standard_Window; - Top_Line : in Line_Position; + (Win : in Window := Standard_Window; + Top_Line : in Line_Position; Bottom_Line : in Line_Position); -- AKA: wsetscrreg() + -- AKA: setscrreg() pragma Inline (Set_Scroll_Region); -- |===================================================================== -- | Man page curs_refresh.3x -- |===================================================================== - -- #1A NAME="AFU_59"#2| + -- #1A NAME="AFU_60"#2| procedure Update_Screen; -- AKA: doupdate() pragma Inline (Update_Screen); - -- #1A NAME="AFU_60"#2| + -- #1A NAME="AFU_61"#2| procedure Refresh (Win : in Window := Standard_Window); -- AKA: wrefresh() -- There is an overloaded Refresh for Pads. -- The Inline pragma appears there + -- AKA: refresh() - -- #1A NAME="AFU_61"#2| + -- #1A NAME="AFU_62"#2| procedure Refresh_Without_Update (Win : in Window := Standard_Window); -- AKA: wnoutrefresh() -- There is an overloaded Refresh_Without_Update for Pads. -- The Inline pragma appears there - -- #1A NAME="AFU_62"#2| + -- #1A NAME="AFU_63"#2| procedure Redraw (Win : in Window := Standard_Window); -- AKA: redrawwin() - -- #1A NAME="AFU_63"#2| - procedure Redraw (Win : in Window := Standard_Window; - Begin_Line : in Line_Position; + -- #1A NAME="AFU_64"#2| + procedure Redraw (Win : in Window := Standard_Window; + Begin_Line : in Line_Position; Line_Count : in Positive); -- AKA: wredrawln() pragma Inline (Redraw); @@ -1018,87 +1068,98 @@ -- | Man page curs_clear.3x -- |===================================================================== - -- #1A NAME="AFU_64"#2| + -- #1A NAME="AFU_65"#2| procedure Erase (Win : in Window := Standard_Window); -- AKA: werase() + -- AKA: erase() pragma Inline (Erase); - -- #1A NAME="AFU_65"#2| + -- #1A NAME="AFU_66"#2| procedure Clear (Win : in Window := Standard_Window); -- AKA: wclear() + -- AKA: clear() pragma Inline (Clear); - -- #1A NAME="AFU_66"#2| + -- #1A NAME="AFU_67"#2| procedure Clear_To_End_Of_Screen (Win : in Window := Standard_Window); -- AKA: wclrtobot() + -- AKA: clrtobot() pragma Inline (Clear_To_End_Of_Screen); - -- #1A NAME="AFU_67"#2| + -- #1A NAME="AFU_68"#2| procedure Clear_To_End_Of_Line (Win : in Window := Standard_Window); -- AKA: wclrtoeol() + -- AKA: clrtoeol() pragma Inline (Clear_To_End_Of_Line); -- |===================================================================== -- | Man page curs_bkgd.3x -- |===================================================================== - -- #1A NAME="AFU_68"#2| + -- #1A NAME="AFU_69"#2| + -- TODO: we could have Set_Background(Window; Character_Attribute_Set) + -- because in C it is common to see bkgdset(A_BOLD) or + -- bkgdset(COLOR_PAIR(n)) procedure Set_Background - (Win : in Window := Standard_Window; + (Win : in Window := Standard_Window; Ch : in Attributed_Character); -- AKA: wbkgdset() + -- AKA: bkgdset() pragma Inline (Set_Background); - -- #1A NAME="AFU_69"#2| + -- #1A NAME="AFU_70"#2| procedure Change_Background - (Win : in Window := Standard_Window; + (Win : in Window := Standard_Window; Ch : in Attributed_Character); -- AKA: wbkgd() + -- AKA: bkgd() pragma Inline (Change_Background); - -- #1A NAME="AFU_70"#2| - function Get_Background (Win : Window := Standard_Window) + -- #1A NAME="AFU_71"#2| + -- ? wbkgdget is not listed in curs_bkgd, getbkgd is thpough. + function Get_Background (Win : Window := Standard_Window) return Attributed_Character; -- AKA: wbkgdget() + -- AKA: bkgdget() pragma Inline (Get_Background); -- |===================================================================== -- | Man page curs_touch.3x -- |===================================================================== - -- #1A NAME="AFU_71"#2| + -- #1A NAME="AFU_72"#2| procedure Untouch (Win : in Window := Standard_Window); -- AKA: untouchwin() pragma Inline (Untouch); - -- #1A NAME="AFU_72"#2| + -- #1A NAME="AFU_73"#2| procedure Touch (Win : in Window := Standard_Window); -- AKA: touchwin() - -- #1A NAME="AFU_73"#2| - procedure Touch (Win : in Window := Standard_Window; - Start : in Line_Position; + -- #1A NAME="AFU_74"#2| + procedure Touch (Win : in Window := Standard_Window; + Start : in Line_Position; Count : in Positive); -- AKA: touchline() pragma Inline (Touch); - -- #1A NAME="AFU_74"#2| - procedure Change_Lines_Status (Win : in Window := Standard_Window; - Start : in Line_Position; - Count : in Positive; + -- #1A NAME="AFU_75"#2| + procedure Change_Lines_Status (Win : in Window := Standard_Window; + Start : in Line_Position; + Count : in Positive; State : in Boolean); -- AKA: wtouchln() pragma Inline (Change_Lines_Status); - -- #1A NAME="AFU_75"#2| - function Is_Touched (Win : Window := Standard_Window; + -- #1A NAME="AFU_76"#2| + function Is_Touched (Win : Window := Standard_Window; Line : Line_Position) return Boolean; -- AKA: is_linetouched() - -- #1A NAME="AFU_76"#2| + -- #1A NAME="AFU_77"#2| function Is_Touched (Win : Window := Standard_Window) return Boolean; -- AKA: is_wintouched() pragma Inline (Is_Touched); @@ -1107,28 +1168,28 @@ -- | Man page curs_overlay.3x -- |===================================================================== - -- #1A NAME="AFU_77"#2| + -- #1A NAME="AFU_78"#2| procedure Copy - (Source_Window : in Window; - Destination_Window : in Window; - Source_Top_Row : in Line_Position; - Source_Left_Column : in Column_Position; - Destination_Top_Row : in Line_Position; - Destination_Left_Column : in Column_Position; - Destination_Bottom_Row : in Line_Position; - Destination_Right_Column : in Column_Position; + (Source_Window : in Window; + Destination_Window : in Window; + Source_Top_Row : in Line_Position; + Source_Left_Column : in Column_Position; + Destination_Top_Row : in Line_Position; + Destination_Left_Column : in Column_Position; + Destination_Bottom_Row : in Line_Position; + Destination_Right_Column : in Column_Position; Non_Destructive_Mode : in Boolean := True); -- AKA: copywin() pragma Inline (Copy); - -- #1A NAME="AFU_78"#2| - procedure Overwrite (Source_Window : in Window; + -- #1A NAME="AFU_79"#2| + procedure Overwrite (Source_Window : in Window; Destination_Window : in Window); -- AKA: overwrite() pragma Inline (Overwrite); - -- #1A NAME="AFU_79"#2| - procedure Overlay (Source_Window : in Window; + -- #1A NAME="AFU_80"#2| + procedure Overlay (Source_Window : in Window; Destination_Window : in Window); -- AKA: overlay() pragma Inline (Overlay); @@ -1137,56 +1198,59 @@ -- | Man page curs_deleteln.3x -- |===================================================================== - -- #1A NAME="AFU_80"#2| + -- #1A NAME="AFU_81"#2| procedure Insert_Delete_Lines - (Win : in Window := Standard_Window; + (Win : in Window := Standard_Window; Lines : in Integer := 1); -- default is to insert one line above -- AKA: winsdelln() + -- AKA: insdelln() pragma Inline (Insert_Delete_Lines); - -- #1A NAME="AFU_81"#2| + -- #1A NAME="AFU_82"#2| procedure Delete_Line (Win : in Window := Standard_Window); -- AKA: wdeleteln() + -- AKA: deleteln() pragma Inline (Delete_Line); - -- #1A NAME="AFU_82"#2| + -- #1A NAME="AFU_83"#2| procedure Insert_Line (Win : in Window := Standard_Window); -- AKA: winsertln() + -- AKA: insertln() pragma Inline (Insert_Line); -- |===================================================================== -- | Man page curs_getyx.3x -- |===================================================================== - -- #1A NAME="AFU_83"#2| + -- #1A NAME="AFU_84"#2| procedure Get_Size - (Win : in Window := Standard_Window; - Number_Of_Lines : out Line_Count; + (Win : in Window := Standard_Window; + Number_Of_Lines : out Line_Count; Number_Of_Columns : out Column_Count); -- AKA: getmaxyx() pragma Inline (Get_Size); - -- #1A NAME="AFU_84"#2| + -- #1A NAME="AFU_85"#2| procedure Get_Window_Position - (Win : in Window := Standard_Window; - Top_Left_Line : out Line_Position; + (Win : in Window := Standard_Window; + Top_Left_Line : out Line_Position; Top_Left_Column : out Column_Position); -- AKA: getbegyx() pragma Inline (Get_Window_Position); - -- #1A NAME="AFU_85"#2| + -- #1A NAME="AFU_86"#2| procedure Get_Cursor_Position - (Win : in Window := Standard_Window; - Line : out Line_Position; + (Win : in Window := Standard_Window; + Line : out Line_Position; Column : out Column_Position); -- AKA: getyx() pragma Inline (Get_Cursor_Position); - -- #1A NAME="AFU_86"#2| + -- #1A NAME="AFU_87"#2| procedure Get_Origin_Relative_To_Parent - (Win : in Window; - Top_Left_Line : out Line_Position; - Top_Left_Column : out Column_Position; + (Win : in Window; + Top_Left_Line : out Line_Position; + Top_Left_Column : out Column_Position; Is_Not_A_Subwindow : out Boolean); -- AKA: getparyx() -- Instead of placing -1 in the coordinates as return, we use a boolean @@ -1197,54 +1261,54 @@ -- | Man page curs_pad.3x -- |===================================================================== - -- #1A NAME="AFU_87"#2| - function New_Pad (Lines : Line_Count; + -- #1A NAME="AFU_88"#2| + function New_Pad (Lines : Line_Count; Columns : Column_Count) return Window; -- AKA: newpad() pragma Inline (New_Pad); - -- #1A NAME="AFU_88"#2| + -- #1A NAME="AFU_89"#2| function Sub_Pad - (Pad : Window; - Number_Of_Lines : Line_Count; - Number_Of_Columns : Column_Count; - First_Line_Position : Line_Position; + (Pad : Window; + Number_Of_Lines : Line_Count; + Number_Of_Columns : Column_Count; + First_Line_Position : Line_Position; First_Column_Position : Column_Position) return Window; -- AKA: subpad() pragma Inline (Sub_Pad); - -- #1A NAME="AFU_89"#2| + -- #1A NAME="AFU_90"#2| procedure Refresh - (Pad : in Window; - Source_Top_Row : in Line_Position; - Source_Left_Column : in Column_Position; - Destination_Top_Row : in Line_Position; - Destination_Left_Column : in Column_Position; - Destination_Bottom_Row : in Line_Position; + (Pad : in Window; + Source_Top_Row : in Line_Position; + Source_Left_Column : in Column_Position; + Destination_Top_Row : in Line_Position; + Destination_Left_Column : in Column_Position; + Destination_Bottom_Row : in Line_Position; Destination_Right_Column : in Column_Position); -- AKA: prefresh() pragma Inline (Refresh); - -- #1A NAME="AFU_90"#2| + -- #1A NAME="AFU_91"#2| procedure Refresh_Without_Update - (Pad : in Window; - Source_Top_Row : in Line_Position; - Source_Left_Column : in Column_Position; - Destination_Top_Row : in Line_Position; - Destination_Left_Column : in Column_Position; - Destination_Bottom_Row : in Line_Position; + (Pad : in Window; + Source_Top_Row : in Line_Position; + Source_Left_Column : in Column_Position; + Destination_Top_Row : in Line_Position; + Destination_Left_Column : in Column_Position; + Destination_Bottom_Row : in Line_Position; Destination_Right_Column : in Column_Position); -- AKA: pnoutrefresh() pragma Inline (Refresh_Without_Update); - -- #1A NAME="AFU_91"#2| + -- #1A NAME="AFU_92"#2| procedure Add_Character_To_Pad_And_Echo_It - (Pad : in Window; + (Pad : in Window; Ch : in Attributed_Character); -- AKA: pechochar() procedure Add_Character_To_Pad_And_Echo_It - (Pad : in Window; + (Pad : in Window; Ch : in Character); pragma Inline (Add_Character_To_Pad_And_Echo_It); @@ -1252,239 +1316,272 @@ -- | Man page curs_scroll.3x -- |===================================================================== - -- #1A NAME="AFU_92"#2| - procedure Scroll (Win : in Window := Standard_Window; + -- #1A NAME="AFU_93"#2| + procedure Scroll (Win : in Window := Standard_Window; Amount : in Integer := 1); -- AKA: wscrl() + -- AKA: scroll() + -- AKA: scrl() pragma Inline (Scroll); -- |===================================================================== -- | Man page curs_delch.3x -- |===================================================================== - -- #1A NAME="AFU_93"#2| + -- #1A NAME="AFU_94"#2| procedure Delete_Character (Win : in Window := Standard_Window); -- AKA: wdelch() + -- AKA: delch() - -- #1A NAME="AFU_94"#2| + -- #1A NAME="AFU_95"#2| procedure Delete_Character - (Win : in Window := Standard_Window; - Line : in Line_Position; + (Win : in Window := Standard_Window; + Line : in Line_Position; Column : in Column_Position); -- AKA: mvwdelch() + -- AKA: mvdelch() pragma Inline (Delete_Character); -- |===================================================================== -- | Man page curs_inch.3x -- |===================================================================== - -- #1A NAME="AFU_95"#2| - function Peek (Win : Window := Standard_Window) + -- #1A NAME="AFU_96"#2| + function Peek (Win : Window := Standard_Window) return Attributed_Character; + -- AKA: inch() -- AKA: winch() - -- #1A NAME="AFU_96"#2| + -- #1A NAME="AFU_97"#2| function Peek - (Win : Window := Standard_Window; - Line : Line_Position; + (Win : Window := Standard_Window; + Line : Line_Position; Column : Column_Position) return Attributed_Character; -- AKA: mvwinch() + -- AKA: mvinch() -- More Peek's follow, pragma Inline appears later. -- |===================================================================== - -- | Man page curs_winch.3x + -- | Man page curs_insch.3x -- |===================================================================== - -- #1A NAME="AFU_97"#2| - procedure Insert (Win : in Window := Standard_Window; + -- #1A NAME="AFU_98"#2| + procedure Insert (Win : in Window := Standard_Window; Ch : in Attributed_Character); - -- AKA: winsch() + -- AKA: winsch() + -- AKA: insch() - -- #1A NAME="AFU_98"#2| - procedure Insert (Win : in Window := Standard_Window; - Line : in Line_Position; - Column : in Column_Position; + -- #1A NAME="AFU_99"#2| + procedure Insert (Win : in Window := Standard_Window; + Line : in Line_Position; + Column : in Column_Position; Ch : in Attributed_Character); - -- AKA: mvwinsch() + -- AKA: mvwinsch() + -- AKA: mvinsch() -- |===================================================================== - -- | Man page curs_winch.3x + -- | Man page curs_insstr.3x -- |===================================================================== - -- #1A NAME="AFU_99"#2| - procedure Insert (Win : in Window := Standard_Window; - Str : in String; + -- #1A NAME="AFU_100"#2| + procedure Insert (Win : in Window := Standard_Window; + Str : in String; Len : in Integer := -1); - -- AKA: winsnstr() + -- AKA: winsnstr() -- AKA: winsstr() + -- AKA: insnstr() + -- AKA: insstr() - -- #1A NAME="AFU_100"#2| - procedure Insert (Win : in Window := Standard_Window; - Line : in Line_Position; - Column : in Column_Position; - Str : in String; + -- #1A NAME="AFU_101"#2| + procedure Insert (Win : in Window := Standard_Window; + Line : in Line_Position; + Column : in Column_Position; + Str : in String; Len : in Integer := -1); - -- AKA: mvwinsnstr() + -- AKA: mvwinsnstr() -- AKA: mvwinsstr() + -- AKA: mvinsnstr() + -- AKA: mvinsstr() pragma Inline (Insert); -- |===================================================================== -- | Man page curs_instr.3x -- |===================================================================== - -- #1A NAME="AFU_101"#2| - procedure Peek (Win : in Window := Standard_Window; - Str : out String; + -- #1A NAME="AFU_102"#2| + procedure Peek (Win : in Window := Standard_Window; + Str : out String; Len : in Integer := -1); -- AKA: winnstr() -- AKA: winstr() + -- AKA: innstr() + -- AKA: instr() - -- #1A NAME="AFU_102"#2| - procedure Peek (Win : in Window := Standard_Window; - Line : in Line_Position; - Column : in Column_Position; - Str : out String; + -- #1A NAME="AFU_103"#2| + procedure Peek (Win : in Window := Standard_Window; + Line : in Line_Position; + Column : in Column_Position; + Str : out String; Len : in Integer := -1); -- AKA: mvwinnstr() -- AKA: mvwinstr() + -- AKA: mvinnstr() + -- AKA: mvinstr() -- |===================================================================== -- | Man page curs_inchstr.3x -- |===================================================================== - -- #1A NAME="AFU_103"#2| - procedure Peek (Win : in Window := Standard_Window; - Str : out Attributed_String; + -- #1A NAME="AFU_104"#2| + procedure Peek (Win : in Window := Standard_Window; + Str : out Attributed_String; Len : in Integer := -1); -- AKA: winchnstr() -- AKA: winchstr() + -- AKA: inchnstr() + -- AKA: inchstr() - -- #1A NAME="AFU_104"#2| - procedure Peek (Win : in Window := Standard_Window; - Line : in Line_Position; - Column : in Column_Position; - Str : out Attributed_String; + -- #1A NAME="AFU_105"#2| + procedure Peek (Win : in Window := Standard_Window; + Line : in Line_Position; + Column : in Column_Position; + Str : out Attributed_String; Len : in Integer := -1); -- AKA: mvwinchnstr() -- AKA: mvwinchstr() + -- AKA: mvinchnstr() + -- AKA: mvinchstr() -- We don't inline the Peek procedures -- |===================================================================== -- | Man page curs_getstr.3x -- |===================================================================== - -- #1A NAME="AFU_105"#2| - procedure Get (Win : in Window := Standard_Window; - Str : out String; + -- #1A NAME="AFU_106"#2| + procedure Get (Win : in Window := Standard_Window; + Str : out String; Len : in Integer := -1); -- AKA: wgetnstr() -- AKA: wgetstr() + -- AKA: getnstr() + -- AKA: getstr() + -- actually getstr is not supported because that results in buffer + -- overflows. - procedure Get (Win : in Window := Standard_Window; - Line : in Line_Position; - Column : in Column_Position; - Str : out String; + -- #1A NAME="AFU_107"#2| + procedure Get (Win : in Window := Standard_Window; + Line : in Line_Position; + Column : in Column_Position; + Str : out String; Len : in Integer := -1); - -- AKA: wgetnstr() - -- not specified in ncurses, should be: mvwgetnstr() - -- and mvwgetstr() (which exists) + -- AKA: mvwgetnstr() + -- AKA: mvwgetstr() + -- AKA: mvgetnstr() + -- AKA: mvgetstr() -- Get is not inlined -- |===================================================================== -- | Man page curs_slk.3x -- |===================================================================== - type Soft_Label_Key_Format is (Three_Two_Three, - Four_Four, - PC_Style, -- ncurses specific - PC_Style_With_Index); -- " - type Label_Number is new Positive range 1 .. 12; + -- Not Implemented: slk_attr_on, slk_attr_off, slk_attr_set + + type Soft_Label_Key_Format is (Three_Two_Three, + Four_Four, + PC_Style, -- ncurses specific + PC_Style_With_Index); -- " + type Label_Number is new Positive range 1 .. 12; type Label_Justification is (Left, Centered, Right); - -- #1A NAME="AFU_106"#2| + -- #1A NAME="AFU_108"#2| procedure Init_Soft_Label_Keys (Format : in Soft_Label_Key_Format := Three_Two_Three); -- AKA: slk_init() pragma Inline (Init_Soft_Label_Keys); - -- #1A NAME="AFU_107"#2| - procedure Set_Soft_Label_Key (Label : in Label_Number; - Text : in String; + -- #1A NAME="AFU_109"#2| + procedure Set_Soft_Label_Key (Label : in Label_Number; + Text : in String; Fmt : in Label_Justification := Left); -- AKA: slk_set() -- We don't inline this procedure - -- #1A NAME="AFU_108"#2| + -- #1A NAME="AFU_110"#2| procedure Refresh_Soft_Label_Keys; -- AKA: slk_refresh() pragma Inline (Refresh_Soft_Label_Keys); - -- #1A NAME="AFU_109"#2| + -- #1A NAME="AFU_111"#2| procedure Refresh_Soft_Label_Keys_Without_Update; -- AKA: slk_noutrefresh() pragma Inline (Refresh_Soft_Label_Keys_Without_Update); - -- #1A NAME="AFU_110"#2| - procedure Get_Soft_Label_Key (Label : in Label_Number; + -- #1A NAME="AFU_112"#2| + procedure Get_Soft_Label_Key (Label : in Label_Number; Text : out String); -- AKA: slk_label() - -- #1A NAME="AFU_111"#2| + -- #1A NAME="AFU_113"#2| function Get_Soft_Label_Key (Label : in Label_Number) return String; -- AKA: slk_label() -- Same as function pragma Inline (Get_Soft_Label_Key); - -- #1A NAME="AFU_112"#2| + -- #1A NAME="AFU_114"#2| procedure Clear_Soft_Label_Keys; -- AKA: slk_clear() pragma Inline (Clear_Soft_Label_Keys); - -- #1A NAME="AFU_113"#2| + -- #1A NAME="AFU_115"#2| procedure Restore_Soft_Label_Keys; -- AKA: slk_restore() pragma Inline (Restore_Soft_Label_Keys); - -- #1A NAME="AFU_114"#2| + -- #1A NAME="AFU_116"#2| procedure Touch_Soft_Label_Keys; -- AKA: slk_touch() pragma Inline (Touch_Soft_Label_Keys); - -- #1A NAME="AFU_115"#2| + -- #1A NAME="AFU_117"#2| procedure Switch_Soft_Label_Key_Attributes - (Attr : in Character_Attribute_Set; + (Attr : in Character_Attribute_Set; On : in Boolean := True); -- AKA: slk_attron() -- AKA: slk_attroff() pragma Inline (Switch_Soft_Label_Key_Attributes); - -- #1A NAME="AFU_116"#2| + -- #1A NAME="AFU_118"#2| procedure Set_Soft_Label_Key_Attributes - (Attr : in Character_Attribute_Set := Normal_Video; + (Attr : in Character_Attribute_Set := Normal_Video; Color : in Color_Pair := Color_Pair'First); -- AKA: slk_attrset() pragma Inline (Set_Soft_Label_Key_Attributes); - -- #1A NAME="AFU_117"#2| + -- #1A NAME="AFU_119"#2| function Get_Soft_Label_Key_Attributes return Character_Attribute_Set; -- AKA: slk_attr() - -- #1A NAME="AFU_118"#2| + -- #1A NAME="AFU_120"#2| function Get_Soft_Label_Key_Attributes return Color_Pair; -- AKA: slk_attr() pragma Inline (Get_Soft_Label_Key_Attributes); - -- #1A NAME="AFU_119"#2| + -- #1A NAME="AFU_121"#2| procedure Set_Soft_Label_Key_Color (Pair : in Color_Pair); -- AKA: slk_color() pragma Inline (Set_Soft_Label_Key_Color); + -- |===================================================================== + -- | Man page keybound.3x + -- |===================================================================== + -- Not Implemented: keybound + -- |===================================================================== -- | Man page keyok.3x -- |===================================================================== - -- #1A NAME="AFU_120"#2| - procedure Enable_Key (Key : in Special_Key_Code; + -- #1A NAME="AFU_122"#2| + procedure Enable_Key (Key : in Special_Key_Code; Enable : in Boolean := True); -- AKA: keyok() pragma Inline (Enable_Key); @@ -1493,8 +1590,8 @@ -- | Man page define_key.3x -- |===================================================================== - -- #1A NAME="AFU_121"#2| - procedure Define_Key (Definition : in String; + -- #1A NAME="AFU_123"#2| + procedure Define_Key (Definition : in String; Key : in Special_Key_Code); -- AKA: define_key() pragma Inline (Define_Key); @@ -1503,37 +1600,39 @@ -- | Man page curs_util.3x -- |===================================================================== - -- | Not implemented : filter, use_env, putwin, getwin + -- | Not implemented : filter, use_env + -- | putwin, getwin are in the child package PutWin -- - -- #1A NAME="AFU_122"#2| - procedure Key_Name (Key : in Real_Key_Code; + + -- #1A NAME="AFU_124"#2| + procedure Key_Name (Key : in Real_Key_Code; Name : out String); -- AKA: keyname() -- The external name for a real keystroke. - -- #1A NAME="AFU_123"#2| + -- #1A NAME="AFU_125"#2| function Key_Name (Key : in Real_Key_Code) return String; -- AKA: keyname() -- Same as function -- We don't inline this routine - -- #1A NAME="AFU_124"#2| - procedure Un_Control (Ch : in Attributed_Character; + -- #1A NAME="AFU_126"#2| + procedure Un_Control (Ch : in Attributed_Character; Str : out String); -- AKA: unctrl() - -- #1A NAME="AFU_125"#2| + -- #1A NAME="AFU_127"#2| function Un_Control (Ch : in Attributed_Character) return String; -- AKA: unctrl() -- Same as function pragma Inline (Un_Control); - -- #1A NAME="AFU_126"#2| + -- #1A NAME="AFU_128"#2| procedure Delay_Output (Msecs : in Natural); -- AKA: delay_output() pragma Inline (Delay_Output); - -- #1A NAME="AFU_127"#2| + -- #1A NAME="AFU_129"#2| procedure Flush_Input; -- AKA: flushinp() pragma Inline (Flush_Input); @@ -1542,51 +1641,51 @@ -- | Man page curs_termattrs.3x -- |===================================================================== - -- #1A NAME="AFU_128"#2| + -- #1A NAME="AFU_130"#2| function Baudrate return Natural; -- AKA: baudrate() pragma Inline (Baudrate); - -- #1A NAME="AFU_129"#2| + -- #1A NAME="AFU_131"#2| function Erase_Character return Character; -- AKA: erasechar() pragma Inline (Erase_Character); - -- #1A NAME="AFU_130"#2| + -- #1A NAME="AFU_132"#2| function Kill_Character return Character; -- AKA: killchar() pragma Inline (Kill_Character); - -- #1A NAME="AFU_131"#2| + -- #1A NAME="AFU_133"#2| function Has_Insert_Character return Boolean; -- AKA: has_ic() pragma Inline (Has_Insert_Character); - -- #1A NAME="AFU_132"#2| + -- #1A NAME="AFU_134"#2| function Has_Insert_Line return Boolean; -- AKA: has_il() pragma Inline (Has_Insert_Line); - -- #1A NAME="AFU_133"#2| + -- #1A NAME="AFU_135"#2| function Supported_Attributes return Character_Attribute_Set; -- AKA: termattrs() pragma Inline (Supported_Attributes); - -- #1A NAME="AFU_134"#2| + -- #1A NAME="AFU_136"#2| procedure Long_Name (Name : out String); -- AKA: longname() - -- #1A NAME="AFU_135"#2| + -- #1A NAME="AFU_137"#2| function Long_Name return String; -- AKA: longname() -- Same as function pragma Inline (Long_Name); - -- #1A NAME="AFU_136"#2| + -- #1A NAME="AFU_138"#2| procedure Terminal_Name (Name : out String); -- AKA: termname() - -- #1A NAME="AFU_137"#2| + -- #1A NAME="AFU_139"#2| function Terminal_Name return String; -- AKA: termname() -- Same as function @@ -1596,47 +1695,53 @@ -- | Man page curs_color.3x -- |===================================================================== - -- #1A NAME="AFU_138"#2| + -- COLOR_PAIR + -- COLOR_PAIR(n) in C is the same as + -- Attributed_Character(Ch => Nul, Color => n, Attr => Normal_Video) + -- In C you often see something like c = c | COLOR_PAIR(n); + -- This is equivalent to c.Color := n; + + -- #1A NAME="AFU_140"#2| procedure Start_Color; -- AKA: start_color() pragma Import (C, Start_Color, "start_color"); - -- #1A NAME="AFU_139"#2| - procedure Init_Pair (Pair : in Redefinable_Color_Pair; - Fore : in Color_Number; + -- #1A NAME="AFU_141"#2| + procedure Init_Pair (Pair : in Redefinable_Color_Pair; + Fore : in Color_Number; Back : in Color_Number); -- AKA: init_pair() pragma Inline (Init_Pair); - -- #1A NAME="AFU_140"#2| - procedure Pair_Content (Pair : in Color_Pair; - Fore : out Color_Number; + -- #1A NAME="AFU_142"#2| + procedure Pair_Content (Pair : in Color_Pair; + Fore : out Color_Number; Back : out Color_Number); -- AKA: pair_content() pragma Inline (Pair_Content); - -- #1A NAME="AFU_141"#2| + -- #1A NAME="AFU_143"#2| function Has_Colors return Boolean; -- AKA: has_colors() pragma Inline (Has_Colors); - -- #1A NAME="AFU_142"#2| - procedure Init_Color (Color : in Color_Number; - Red : in RGB_Value; - Green : in RGB_Value; + -- #1A NAME="AFU_144"#2| + procedure Init_Color (Color : in Color_Number; + Red : in RGB_Value; + Green : in RGB_Value; Blue : in RGB_Value); -- AKA: init_color() pragma Inline (Init_Color); - -- #1A NAME="AFU_143"#2| + -- #1A NAME="AFU_145"#2| function Can_Change_Color return Boolean; -- AKA: can_change_color() pragma Inline (Can_Change_Color); - -- #1A NAME="AFU_144"#2| - procedure Color_Content (Color : in Color_Number; - Red : out RGB_Value; - Green : out RGB_Value; + -- #1A NAME="AFU_146"#2| + procedure Color_Content (Color : in Color_Number; + Red : out RGB_Value; + Green : out RGB_Value; Blue : out RGB_Value); -- AKA: color_content() pragma Inline (Color_Content); @@ -1644,43 +1749,42 @@ -- |===================================================================== -- | Man page curs_kernel.3x -- |===================================================================== - -- | Not implemented: getsyx, setsyx -- type Curses_Mode is (Curses, Shell); - -- #1A NAME="AFU_145"#2| + -- #1A NAME="AFU_147"#2| procedure Save_Curses_Mode (Mode : in Curses_Mode); -- AKA: def_prog_mode() -- AKA: def_shell_mode() pragma Inline (Save_Curses_Mode); - -- #1A NAME="AFU_146"#2| + -- #1A NAME="AFU_148"#2| procedure Reset_Curses_Mode (Mode : in Curses_Mode); -- AKA: reset_prog_mode() -- AKA: reset_shell_mode() pragma Inline (Reset_Curses_Mode); - -- #1A NAME="AFU_147"#2| + -- #1A NAME="AFU_149"#2| procedure Save_Terminal_State; -- AKA: savetty() pragma Inline (Save_Terminal_State); - -- #1A NAME="AFU_148"#2| + -- #1A NAME="AFU_150"#2| procedure Reset_Terminal_State; -- AKA: resetty(); pragma Inline (Reset_Terminal_State); type Stdscr_Init_Proc is access - function (Win : Window; - Columns : Column_Count) return Integer; + function (Win : Window; + Columns : Column_Count) return Integer; pragma Convention (C, Stdscr_Init_Proc); -- N.B.: the return value is actually ignored, but it seems to be -- a good practice to return 0 if you think all went fine -- and -1 otherwise. - -- #1A NAME="AFU_149"#2| - procedure Rip_Off_Lines (Lines : in Integer; + -- #1A NAME="AFU_151"#2| + procedure Rip_Off_Lines (Lines : in Integer; Proc : in Stdscr_Init_Proc); -- AKA: ripoffline() -- N.B.: to be more precise, this uses a ncurses specific enhancement of @@ -1691,12 +1795,12 @@ type Cursor_Visibility is (Invisible, Normal, Very_Visible); - -- #1A NAME="AFU_150"#2| + -- #1A NAME="AFU_152"#2| procedure Set_Cursor_Visibility (Visibility : in out Cursor_Visibility); -- AKA: curs_set() pragma Inline (Set_Cursor_Visibility); - -- #1A NAME="AFU_151"#2| + -- #1A NAME="AFU_153"#2| procedure Nap_Milli_Seconds (Ms : in Natural); -- AKA: napms() pragma Inline (Nap_Milli_Seconds); @@ -1706,9 +1810,9 @@ -- |===================================================================== type Transform_Direction is (From_Screen, To_Screen); procedure Transform_Coordinates - (W : in Window := Standard_Window; - Line : in out Line_Position; - Column : in out Column_Position; + (W : in Window := Standard_Window; + Line : in out Line_Position; + Column : in out Column_Position; Dir : in Transform_Direction := From_Screen); -- This procedure transforms screen coordinates into coordinates relative -- to the window and vice versa, depending on the Dir parameter. @@ -1717,6 +1821,89 @@ -- Window or if you pass the Null_Window as argument. -- We don't inline this procedure + -- |===================================================================== + -- | Man page dft_fgbg.3x + -- |===================================================================== + + -- #1A NAME="AFU_154"#2| + procedure Use_Default_Colors; + -- AKA: use_default_colors() + pragma Inline (Use_Default_Colors); + + -- #1A NAME="AFU_155"#2| + procedure Assume_Default_Colors (Fore : Color_Number := Default_Color; + Back : Color_Number := Default_Color); + -- AKA: assume_default_colors() + pragma Inline (Assume_Default_Colors); + + -- |===================================================================== + -- | Man page curs_extend.3x + -- |===================================================================== + + -- #1A NAME="AFU_156"#2| + function Curses_Version return String; + -- AKA: curses_version() + + -- #1A NAME="AFU_157"#2| + -- The returnvalue is the previous setting of the flag + function Use_Extended_Names (Enable : Boolean) return Boolean; + -- AKA: use_extended_names() + + -- |===================================================================== + -- | Man page curs_scr_dump.3x + -- |===================================================================== + + -- #1A NAME="AFU_158"#2| + procedure Screen_Dump_To_File (Filename : in String); + -- AKA: scr_dump() + + -- #1A NAME="AFU_159"#2| + procedure Screen_Restore_From_File (Filename : in String); + -- AKA: scr_restore() + + -- #1A NAME="AFU_160"#2| + procedure Screen_Init_From_File (Filename : in String); + -- AKA: scr_init() + + -- #1A NAME="AFU_161"#2| + procedure Screen_Set_File (Filename : in String); + -- AKA: scr_set() + + -- |===================================================================== + -- | Man page curs_print.3x + -- |===================================================================== + -- Not implemented: mcprint + + -- |===================================================================== + -- | Man page curs_printw.3x + -- |===================================================================== + -- Not implemented: printw, wprintw, mvprintw, mvwprintw, vwprintw, + -- vw_printw + -- Please use the Ada style Text_IO child packages for formatted + -- printing. It doesn't make a lot of sense to map the printf style + -- C functions to Ada. + + -- |===================================================================== + -- | Man page curs_scanw.3x + -- |===================================================================== + -- Not implemented: scanw, wscanw, mvscanw, mvwscanw, vwscanw, vw_scanw + + + -- |===================================================================== + -- | Man page resizeterm.3x + -- |===================================================================== + -- Not Implemented: resizeterm + + -- |===================================================================== + -- | Man page wresize.3x + -- |===================================================================== + + -- #1A NAME="AFU_162"#2| + procedure Resize (Win : Window := Standard_Window; + Number_Of_Lines : Line_Count; + Number_Of_Columns : Column_Count); + -- AKA: wresize() + private type Window is new System.Storage_Elements.Integer_Address; Null_Window : constant Window := 0; @@ -1724,21 +1911,29 @@ -- The next constants are generated and may be different on your -- architecture. -- - Offset_maxy : constant Natural := 2; -- short - Offset_maxx : constant Natural := 3; -- short - Offset_begy : constant Natural := 4; -- short - Offset_begx : constant Natural := 5; -- short - Offset_cury : constant Natural := 0; -- short - Offset_curx : constant Natural := 1; -- short - Offset_yoffset : constant Natural := 36; -- short - Offset_pary : constant Natural := 13; -- int - Offset_parx : constant Natural := 12; -- int - Offset_scroll : constant Natural := 27; -- char - Sizeof_bool : constant Natural := 1; -- bool - Offset_XY : constant Natural := 1; -- int - - type Curses_Bool is mod 2 ** Interfaces.C.char'Size; + Offset_maxy : constant Natural := 2; -- short + Offset_maxx : constant Natural := 3; -- short + Offset_begy : constant Natural := 4; -- short + Offset_begx : constant Natural := 5; -- short + Offset_cury : constant Natural := 0; -- short + Offset_curx : constant Natural := 1; -- short + Offset_yoffset : constant Natural := 36; -- short + Offset_pary : constant Natural := 13; -- int + Offset_parx : constant Natural := 12; -- int + Offset_notimeout : constant Natural := 24; -- char + Offset_clear : constant Natural := 25; -- char + Offset_leaveok : constant Natural := 26; -- char + Offset_scroll : constant Natural := 27; -- char + Offset_idlok : constant Natural := 28; -- char + Offset_idcok : constant Natural := 29; -- char + Offset_immed : constant Natural := 30; -- char + Offset_sync : constant Natural := 31; -- char + Offset_use_keypad : constant Natural := 32; -- char + Sizeof_bool : constant Natural := 1; -- bool + Offset_XY : constant Natural := 1; -- int + + type Curses_Bool is mod 2 ** Interfaces.C.char'Size; Curses_Bool_False : constant Curses_Bool := 0; end Terminal_Interface.Curses; - \ No newline at end of file +