Callisto Desktop/User Guide - Revision history

Maia: /* Actions */

2023-02-04T15:55:03Z

Actions

← Older revision		Revision as of 15:55, 4 February 2023
Line 44:		Line 44:
	=== Actions ===		=== Actions ===

	~~Windows are controlled by interacting with their various parts using the keyboard and mouse. The available actions, and their affects, vary depending on the part~~ of ~~the~~ window ~~being manipulated~~.		Each of a window's controls offers a set of related actions.

	==== Frame ====		==== Frame ====

Maia: /* Focus */ Edited for style

2023-02-04T02:24:03Z

Focus: Edited for style

← Older revision		Revision as of 02:24, 4 February 2023
Line 38:		Line 38:
	[[File:Callisto_Window_Focus.png\|right\|A focused and unfocused window.]]		[[File:Callisto_Window_Focus.png\|right\|A focused and unfocused window.]]

	The window under the mouse pointer is considered to have "focus;" it receives all keyboard and mouse input not specifically reserved for the system. Focus changes ~~constantly in an environment containing many~~ windows, ~~and~~ Callisto Desktop aims to ~~avoid all possible ambiguity regarding the location of~~ focus. Up to one window can have focus at a time. When the mouse pointer rests over the Controller, or over ~~an uncovered region of~~ the Desktop, no window has focus.		The window under the mouse pointer is considered to have "focus;" it receives all keyboard and mouse input not specifically reserved for the system. Focus changes frequently with multiple windows onscreen, so Callisto Desktop aims to clearly indicate where focus lies at any given moment. Up to one window can have focus at a time. When the mouse pointer rests over the Controller, or over the Desktop, no window has focus.

	~~The~~ focused window displays a dark frame with control boxes visible, and with added texture on menus, buttons, and other content elements (when using the system toolkit and theme). All other windows display in a flatter, lighter style, with no control boxes visible.		A focused window displays a dark frame with control boxes visible, and with added texture on menus, buttons, and other content elements (when using the system toolkit and theme). All other windows display in a flatter, lighter style, with no control boxes visible.

	=== Actions ===		=== Actions ===

Maia: /* Control boxes */

2023-02-04T02:20:04Z

Control boxes

← Older revision		Revision as of 02:20, 4 February 2023
Line 22:		Line 22:
	===== Control boxes =====		===== Control boxes =====

	Three ~~widgets~~ embedded in each title bar provide immediate access to common window management functions.		Three controls embedded in each title bar provide immediate access to common window management functions.

	* The close box, which cleanly closes a window (allowing the application to prompt regarding unsaved data or unfinished tasks).		* The '''close box''', which cleanly closes a window (allowing the application to prompt regarding unsaved data or unfinished tasks).
	* The pin box, which holds a window in place at the top of the stack, or across desks.		* The '''pin box''', which holds a window in place at the top of the stack, or across desks.
	* The zoom box, which adjusts a window's geometry (width and height).		* The '''zoom box''', which adjusts a window's geometry (width and height).

	==== Contents ====		==== Contents ====

Maia: /* Frame */

2023-02-03T16:28:45Z

Frame

← Older revision		Revision as of 16:28, 3 February 2023
Line 58:		Line 58:
	\| Move the window.		\| Move the window.
	\|-		\|-
	\| [[File:Callisto_UserGuide_48pxPlaceholder.png]] [[File:~~Callisto_UserGuide_DoubleClick~~.png]]		\| [[File:Callisto_UserGuide_48pxPlaceholder.png]] [[File:Callisto_DoubleClick.png]]
	\| Hide the window (remove it from the screen without closing it).		\| Hide the window (remove it from the screen without closing it).
	\|-		\|-

Maia: /* Frame */

2023-02-03T05:01:51Z

Frame

← Older revision		Revision as of 05:01, 3 February 2023
Line 57:		Line 57:
	\| [[File:Callisto_UserGuide_48pxPlaceholder.png]] [[File:Callisto_UserGuide_LeftDrag.png]]		\| [[File:Callisto_UserGuide_48pxPlaceholder.png]] [[File:Callisto_UserGuide_LeftDrag.png]]
	\| Move the window.		\| Move the window.
			\|-
			\| [[File:Callisto_UserGuide_48pxPlaceholder.png]] [[File:Callisto_UserGuide_DoubleClick.png]]
			\| Hide the window (remove it from the screen without closing it).
	\|-		\|-
	\| [[File:Callisto_UserGuide_48pxPlaceholder.png]] [[File:Callisto_UserGuide_LeftClick.png]]		\| [[File:Callisto_UserGuide_48pxPlaceholder.png]] [[File:Callisto_UserGuide_LeftClick.png]]

Maia: /* Windows */ Added Focus section stub.

2023-02-03T04:57:12Z

Windows: Added Focus section stub.

← Older revision		Revision as of 04:57, 3 February 2023
Line 28:		Line 28:
	* The zoom box, which adjusts a window's geometry (width and height).		* The zoom box, which adjusts a window's geometry (width and height).

	==== ~~Content area~~ ====		==== Contents ====

	Everything inside of the frame is drawn by the application to which the window belongs. Most applications display a menu bar containing a complete listing of their available commands and features, and a document, tool, or view of some kind in the remaining area beneath. A window's content area may also contain toolbars with shortcuts to various functions, status bars displaying document information, or other elements as the application developers see fit.		Everything inside of the frame is drawn by the application to which the window belongs. Most applications display a menu bar containing a complete listing of their available commands and features, and a document, tool, or view of some kind in the remaining area beneath. A window's content area may also contain toolbars with shortcuts to various functions, status bars displaying document information, or other elements as the application developers see fit.
Line 34:		Line 34:
	Many developers have ideas about how applications should look and feel that conflict with the goals of Callisto Desktop; these developers' applications may exhibit unusual appearances and behavior within their content areas. Unfortunately, not much can be done about this, other than selecting a different application, but Callisto Desktop tries to mitigate it by enforcing consistency in the rest of the environment. The content area is the only place where application developers have free reign.		Many developers have ideas about how applications should look and feel that conflict with the goals of Callisto Desktop; these developers' applications may exhibit unusual appearances and behavior within their content areas. Unfortunately, not much can be done about this, other than selecting a different application, but Callisto Desktop tries to mitigate it by enforcing consistency in the rest of the environment. The content area is the only place where application developers have free reign.

	=== ~~Window actions~~ and ~~states~~ ===		=== Focus ===

			[[File:Callisto_Window_Focus.png\|right\|A focused and unfocused window.]]

			The window under the mouse pointer is considered to have "focus;" it receives all keyboard and mouse input not specifically reserved for the system. Focus changes constantly in an environment containing many windows, and Callisto Desktop aims to avoid all possible ambiguity regarding the location of focus. Up to one window can have focus at a time. When the mouse pointer rests over the Controller, or over an uncovered region of the Desktop, no window has focus.

			The focused window displays a dark frame with control boxes visible, and with added texture on menus, buttons, and other content elements (when using the system toolkit and theme). All other windows display in a flatter, lighter style, with no control boxes visible.

			=== Actions ===

	Windows are controlled by interacting with their various parts using the keyboard and mouse. The available actions, and their affects, vary depending on the part of the window being manipulated.		Windows are controlled by interacting with their various parts using the keyboard and mouse. The available actions, and their affects, vary depending on the part of the window being manipulated.

Maia: /* Windows */ Condensed control box introduction

2023-02-03T04:31:03Z

Windows: Condensed control box introduction

← Older revision		Revision as of 04:31, 3 February 2023
Line 9:		Line 9:
	Windows are floating containers furnished to applications by the system, which applications fill with their own content. The system retains ultimate control over windows, drawing a frame around each to clarify its state to the user and provide a means of manipulation.		Windows are floating containers furnished to applications by the system, which applications fill with their own content. The system retains ultimate control over windows, drawing a frame around each to clarify its state to the user and provide a means of manipulation.

	~~If an application is able to override~~ the window ~~manager~~'s ~~instructions~~, it is a ~~bug in need of correction~~.		Windows float over the Desktop in a "stack." Imagine paper piled on a desk, or a Z axis protruding towards you from the display, with the Desktop at the furthest position. A window's place in the stack determines which windows appear above it, and which appear below it. Any part of a window not obscured by other windows can receive focus and accept user input. The stack can be easily reordered, using various means, to display the desired windows.

	Windows float over the Desktop in a "stack." Imagine paper piled on a desk, or a Z axis protruding towards you from the display, with the Desktop furthest away from you. A window's place in the stack determines which windows appear above it, and which appear below it. Any part of a window not obscured by other windows can receive focus and accept user input. The stack can be easily reordered, using various means, to display the desired windows.

	=== Anatomy of a window ===		=== Anatomy of a window ===
Line 19:		Line 18:
	==== Frame ====		==== Frame ====

	The border portion of a window, drawn and controlled by the system. Most window frames include a title bar at the top, which displays ~~information about~~ the window, provides a convenient space to grab the window with the mouse, and offers several widgets for controlling it. Transient windows, such as dialog boxes, often do not have title bars, but every window has a frame.		The border portion of a window, drawn and controlled by the system. Most window frames include a title bar at the top, which displays the window's title (usually an application name and/or a document name), provides a convenient space to grab the window with the mouse, and offers several widgets for controlling it. Transient windows, such as dialog boxes, often do not have title bars, but every window has a frame.

	~~In addition to housing the window title and control~~ boxes, the frame is a control itself, mostly used for changing the window's position onscreen or in the stack. It can also produce a popup menu, called the "operations menu," presenting a full list of available actions for the window.		===== Control boxes =====

	~~===== Title =====~~		Three widgets embedded in each title bar provide immediate access to common window management functions.

	The window~~'s title, as specified to the system by~~ the application~~. This may be an object name, an application name,~~ or ~~some combination thereof~~.		* The close box, which cleanly closes a window (allowing the application to prompt regarding unsaved data or unfinished tasks).
			* The pin box, which holds a window in place at the top of the stack, or across desks.
	~~===== Close box =====~~		* The zoom box, which adjusts a window's geometry (width and height).

	The ~~simplest of the window controls. Activating this closes the window.~~

	~~===== Pin~~ box ~~=====~~

	~~Pins the~~ window in place~~. This control can be used to fix the window either to~~ the top of the stack, or ~~to the current desk (making it move with you as you change~~ desks).

	~~===== Zoom box =====~~

	~~Controls the size of the window. It can be dragged to resize the window, or clicked to toggle between different sizes.~~ The zoom box ~~also allows using windows as templates to define the size of other windows. This is one of Callisto Desktop's most important controls~~, ~~as windows sized appropriately to fit their contents are an essential component of~~ a ~~multi-~~window ~~desktop environment~~.

	==== Content area ====		==== Content area ====

	Everything inside the frame is drawn by the application to which the window belongs. Most applications display a menu bar containing a complete listing of their available commands and features, and a document, tool, or view of some kind in the remaining area beneath. A window's content area may also contain toolbars with shortcuts to various functions, status bars displaying document information, or other elements as the application developers see fit.		Everything inside of the frame is drawn by the application to which the window belongs. Most applications display a menu bar containing a complete listing of their available commands and features, and a document, tool, or view of some kind in the remaining area beneath. A window's content area may also contain toolbars with shortcuts to various functions, status bars displaying document information, or other elements as the application developers see fit.

	Many developers have ideas about how applications should look and feel that conflict with the goals of Callisto Desktop; these developers' applications may exhibit unusual appearances and behavior within their content areas. Unfortunately, not much can be done about this, other than selecting a different application, but Callisto Desktop tries to mitigate it by enforcing consistency in the rest of the environment. The content area is the only place where application developers have free reign.		Many developers have ideas about how applications should look and feel that conflict with the goals of Callisto Desktop; these developers' applications may exhibit unusual appearances and behavior within their content areas. Unfortunately, not much can be done about this, other than selecting a different application, but Callisto Desktop tries to mitigate it by enforcing consistency in the rest of the environment. The content area is the only place where application developers have free reign.

Maia: /* Windows */ Separated anatomy and actions

2023-02-02T15:05:51Z

Windows: Separated anatomy and actions

← Older revision		Revision as of 15:05, 2 February 2023
Line 7:		Line 7:
	== Windows ==		== Windows ==

	Windows are floating containers furnished to applications by the system, which applications fill with their own content. The system retains ultimate control over windows, drawing a frame around each to clarify its state to the user and provide a means of manipulation. Applications vary in their intentions, and they often do unpredictable things within their windows' content areas, but the window frame belongs to the system. As such, it can be relied upon to behave consistently in all situations.		Windows are floating containers furnished to applications by the system, which applications fill with their own content. The system retains ultimate control over windows, drawing a frame around each to clarify its state to the user and provide a means of manipulation.

	If an application is able to override the window manager's instructions, it is a bug in need of correction.		If an application is able to override the window manager's instructions, it is a bug in need of correction.
Line 13:		Line 13:
	Windows float over the Desktop in a "stack." Imagine paper piled on a desk, or a Z axis protruding towards you from the display, with the Desktop furthest away from you. A window's place in the stack determines which windows appear above it, and which appear below it. Any part of a window not obscured by other windows can receive focus and accept user input. The stack can be easily reordered, using various means, to display the desired windows.		Windows float over the Desktop in a "stack." Imagine paper piled on a desk, or a Z axis protruding towards you from the display, with the Desktop furthest away from you. A window's place in the stack determines which windows appear above it, and which appear below it. Any part of a window not obscured by other windows can receive focus and accept user input. The stack can be easily reordered, using various means, to display the desired windows.

	=== Anatomy of a ~~Window~~ ===		=== Anatomy of a window ===

	[[File:Callisto_generic_window.png\|right\|A window.]]		[[File:Callisto_generic_window.png\|right\|A window.]]

	=== Frame ===		==== Frame ====

	The border portion of a window, drawn and controlled by the system. Most window frames include a title bar at the top, which displays information about the window, provides a convenient space to grab the window with the mouse, and offers several widgets for controlling it. Transient windows, such as dialog boxes, often do not have title bars, but every window has a frame.		The border portion of a window, drawn and controlled by the system. Most window frames include a title bar at the top, which displays information about the window, provides a convenient space to grab the window with the mouse, and offers several widgets for controlling it. Transient windows, such as dialog boxes, often do not have title bars, but every window has a frame.

			In addition to housing the window title and control boxes, the frame is a control itself, mostly used for changing the window's position onscreen or in the stack. It can also produce a popup menu, called the "operations menu," presenting a full list of available actions for the window.

			===== Title =====

			The window's title, as specified to the system by the application. This may be an object name, an application name, or some combination thereof.

			===== Close box =====

			The simplest of the window controls. Activating this closes the window.

			===== Pin box =====

			Pins the window in place. This control can be used to fix the window either to the top of the stack, or to the current desk (making it move with you as you change desks).

			===== Zoom box =====

			Controls the size of the window. It can be dragged to resize the window, or clicked to toggle between different sizes. The zoom box also allows using windows as templates to define the size of other windows. This is one of Callisto Desktop's most important controls, as windows sized appropriately to fit their contents are an essential component of a multi-window desktop environment.

			==== Content area ====

			Everything inside the frame is drawn by the application to which the window belongs. Most applications display a menu bar containing a complete listing of their available commands and features, and a document, tool, or view of some kind in the remaining area beneath. A window's content area may also contain toolbars with shortcuts to various functions, status bars displaying document information, or other elements as the application developers see fit.

			Many developers have ideas about how applications should look and feel that conflict with the goals of Callisto Desktop; these developers' applications may exhibit unusual appearances and behavior within their content areas. Unfortunately, not much can be done about this, other than selecting a different application, but Callisto Desktop tries to mitigate it by enforcing consistency in the rest of the environment. The content area is the only place where application developers have free reign.

			=== Window actions and states ===

			Windows are controlled by interacting with their various parts using the keyboard and mouse. The available actions, and their affects, vary depending on the part of the window being manipulated.

			==== Frame ====

			Control the window's position on the desk.

	{\| class="wikitable" style="font-size: smaller; text-align: left; width: auto;"		{\| class="wikitable" style="font-size: smaller; text-align: left; width: auto;"
Line 48:		Line 80:
	\|}		\|}

	=== Close ~~Box~~ ===		==== Close box ====

	~~The most straightforward window control, located in the upper left corner of each title bar, next to the title. Clicking this button closes~~ the window cleanly, giving the application a chance to interrupt if there are unsaved changes or unfinished actions that must be discarded or canceled in order to do so.		Closes the window cleanly, giving the application a chance to interrupt if there are unsaved changes or unfinished actions that must be discarded or canceled in order to do so. Clicking the close box may do nothing if the application the window belongs to is unresponsive, in which case other means may be used to dismiss the window.

	{\| class="wikitable" style="font-size: smaller; text-align: left; width: auto;"		{\| class="wikitable" style="font-size: smaller; text-align: left; width: auto;"
Line 64:		Line 96:
	\|}		\|}

	=== Pin ~~Box~~ ===		==== Pin box ====

	~~A tool for fixing a~~ window in ~~a certain spatial state. It can pin a window in two ways~~.		Hold the window in place.

	{\| class="wikitable" style="font-size: smaller; text-align: left; width: auto;"		{\| class="wikitable" style="font-size: smaller; text-align: left; width: auto;"
Line 80:		Line 112:
	\|}		\|}

	=== Zoom ~~Box~~ ===		==== Zoom box ====

	~~A tool for controlling a~~ window's geometry (~~its width and height~~).		Control the window's geometry (size).

	{\| class="wikitable" style="font-size: smaller; text-align: left; width: auto;"		{\| class="wikitable" style="font-size: smaller; text-align: left; width: auto;"

Maia: /* Zoom Box */

2023-02-02T04:38:52Z

Zoom Box

← Older revision		Revision as of 04:38, 2 February 2023
Line 88:		Line 88:
	! style=width:10em \| Action		! style=width:10em \| Action
	! Result		! Result
			\|-
			\| [[File:Callisto_UserGuide_48pxPlaceholder.png]] [[File:Callisto_UserGuide_LeftDrag.png]]
			\| Resize this window (moving the mouse off of an edge begins expanding or contracting that dimension).
	\|-		\|-
	\| [[File:Callisto_UserGuide_48pxPlaceholder.png]] [[File:Callisto_UserGuide_LeftClick.png]]		\| [[File:Callisto_UserGuide_48pxPlaceholder.png]] [[File:Callisto_UserGuide_LeftClick.png]]

Maia: /* Frame */

2023-02-02T04:37:06Z

Frame

← Older revision		Revision as of 04:37, 2 February 2023
Line 25:		Line 25:
	! style=width:10em \| Action		! style=width:10em \| Action
	! Result		! Result
			\|-
			\| [[File:Callisto_UserGuide_48pxPlaceholder.png]] [[File:Callisto_UserGuide_LeftDrag.png]]
			\| Move the window.
	\|-		\|-
	\| [[File:Callisto_UserGuide_48pxPlaceholder.png]] [[File:Callisto_UserGuide_LeftClick.png]]		\| [[File:Callisto_UserGuide_48pxPlaceholder.png]] [[File:Callisto_UserGuide_LeftClick.png]]