add_frame

add_frame( [ChipsId,][attributes]);
add_frame( [ChipsId,] x1, y1, x2, y2 [,attributes]);

Description

• ChipsId - an optional ChipsId structure containing values to modify the currency state for the command.
• x1, y1, x2, y2 - the lower left (x1,y1) and upper right (x2,y2) corners of the frame in window normalized coordinates.
• attributes - optional parameters which allow the user to configure properties though a structure, list, or attribute string.

The add_frame command creates a frame whose attributes are specified by user preferences or in an attribute list. The new frame becomes current by default; providing a ChipsId overrides the currency state.

The frame takes up the full size of the window in which it is created, unless the corner values (x1, y1) and (x2, y2) are supplied.

Customizing the Frame

There are several attributes that control the frame characteristics. The attributes can be set to the ChIPS defaults, values provided in the add_frame command, or values from the user's preference file.

The attributes may also be modified with the set_frame command at any time; see "ahelp set_frame" and "ahelp setget" for more information.

The attributes associated with frames are:

Attribute	Description	Options	default
aspect	Maintain the aspect ration of the frame when changing modes?	see the Booleans section of "ahelp chipsopt"	true
bgcolor	Background color of the frame.	name or hex; see the Color section of "ahelp chipsopt"	default
border.color	Color of the border denoting the location of a frame in the window.	name or hex; see the Color section of "ahelp chipsopt"	default
border.visible	Boolean flag indicating if the frame border should be visible.	see the Booleans section of "ahelp chipsopt"	false
scale	If set to true, all labels inside a window are rescaled as the window size is altered by the user.	see the Booleans section of "ahelp chipsopt"	true
stem	Default stem for newly created frames	Alphanumeric	frm
transparency	Boolean flag indicating whether any object behind the frame is visible.	see the Booleans section of "ahelp chipsopt"	false

chips> add_frame();

chips> add_frame( .1, .1, .4, .7, "bgcolor=red");
chips> add_frame({"bgcolor", "red"});

chips> id = ChipsId();
chips> add_window( "id=MM300500");
chips> add_window( "id=Window2");
chips> id.window = "MM300500";
chips> add_frame(id);

chips> settings = ChipsCurve;
chips> settings.bgcolor = "red";
chips> add_frame(settings);