gnustep/libs-back
0
0
Fork 0
mirror of https://github.com/gnustep/libs-back.git synced 2025-02-23 11:51:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Fix documentation install

Browse source 
git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/back/trunk@17781 72102866-910b-0410-8b05-ffd578937521
This commit is contained in:
Adam Fedor 2003-10-06 03:28:34 +00:00
parent 46c1f411df
commit 5ea990e259
6 changed files with 11 additions and 328 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
ChangeLog
View file

@ -1,3 +1,10 @@
2003-10-05 Adam Fedor <fedor@gnu.org>
* Documentation/GNUmakefile: Make Back documentation
* Documentation/Back/GNUmakefile: Set DocumentationDirectory.
* Source/x11/raster.c (RMakeCenteredImage): Remove (unused).
2003-10-04 14:27 Alexander Malmberg <alexander@malmberg.org>
* Source/art/path.m (-DPSrectclip::::): Move the call to -DPSnewpath

31
Documentation/Back/Back.html
View file

@ -1,31 +0,0 @@
<html>
<head>
<title>Back</title>
</head>
<body>
<br />
<h1><a name="title$Back">Back</a></h1>
<h3>Authors</h3>
<dl>
<dt><a href="http://www.gnustep.org/developers/whoiswho.html">Adam Fedor</a>(<a href="mailto:fedor@gnu.org"><code></code></a>)</dt>
<dd>
</dd>
</dl>
<p><b>Version:</b> $Revision$</p>
<p><b>Date:</b> $Date$</p>
<h1><a name="001000000000">Back</a></h1>
<p>
Documentation for understanding and writting GUI backends.
</p>
<ul>
<li>
<a href="WindowFocus.html">Window Focus</a>
</li>
</ul>
<br />
</body>
</html>

2
Documentation/Back/GNUmakefile
View file

@ -34,7 +34,7 @@ Back_AGSDOC_FILES = \
WindowFocus.gsdoc
Back_AGSDOC_FLAGS = \
-DocumentationDirectory . \
-DocumentationDirectory Back \
-Up Back
Back_DOC_INSTALL_DIR = Developer/Back/Reference

259
Documentation/Back/WindowFocus.html
View file

@ -1,259 +0,0 @@
<html>
<head>
<title>Window Focus Procedures</title>
</head>
<body>
<br />
<h1><a name="title$WindowFocus">Window Focus Procedures</a></h1>
<h3>Authors</h3>
<dl>
<dt><a href="http://www.gnustep.org/developers/whoiswho.html">Adam Fedor</a>(<a href="mailto:fedor@gnu.org"><code></code></a>)</dt>
<dd>
</dd>
</dl>
<p><b>Version:</b> $Revision$</p>
<p><b>Date:</b> $Date$</p>
<h1><a name="001000000000">Window Focus</a></h1>
<p>
This document describes how various events and user actions
affect window focus of GNUstep applications. This document for
the most part describes focus changes that occur outside of
application control, since application window focus changes
are well described in the class documentation.
</p>
<h2><a name="001001000000">Application Focus</a></h2>
<p>
The application can get focus in several ways:
</p>
<ul>
<li>
Launch from the command line or another app
</li>
<li>
Another app looses focus (e.g. by terminating)
</li>
<li>
The user switches screens to the one the app is
displayed on
</li>
<li>
Double-click on the application icon
</li>
</ul>
<p>
The first case does not directly affect window focus (because
there are no windows at startup). However, as the application
begins to create and order front windows (including the main
menu) there will likely be a cascade of focus events generated
by the window manager for each window ordered in.
</p>
<p>
In the second and third case, the window manager will likely try
to give focus to the window that previously had it or perhaps to
some random window based on some internal window manager
code. GNUstep may ignore this request and try to give focus to
another window, typically the application's idea of the current
key window.
</p>
<p>
The last case is handled in the GUI front-end.
</p>
<h2><a name="001002000000">KeyboardFocus</a></h2>
<p>
The Key window is the window that has keyboard focus and has
keyboard events sent to it. When an application receives focus,
the window manager will typically ask one window to take
keyboard focus (see above, Application Focus).
</p>
<p>
When an application is launched, in many cases, only the application
icon and main menu may be displayed. In the OpenStep interface,
neither of these is really supposed to be a key window, and in
fact, many window managers control the application icon so this
cannot be made key anyway. In X-Windows, however, there is no
other way for an application to receive keyboard events unless a
visible window has been made key. This leaves the main menu.
</p>
<p>
When an application receives focus, or if all the windows in an
application are closed (see the private method
[NSWindow-_lossOfKeyOrMainWindow]), then the main menu will request
keyboard focus (see below).
</p>
<p>
The GUI font-end may function differently to accomadate
different window manager behavior. Below is a list of the
changes the front-end makes for different managers and windowing
systems:
</p>
<dl>
<dt>WindowMaker</dt>
<dd>
<p>
WindowMaker controls the application icon so it cannot
receive keyboard events. The main menu is made key if there is
no other window capable of becoming key.
</p>
</dd>
</dl>
<h2><a name="001003000000">Requesting Keyboard Focus</a></h2>
<p>
A window may request to get keyboard focus in serveral
instances. The window requests keyboard focus through the server
method -setinputfocus::
</p>
<ul>
<li>
If the window asks or is asked to become
key, through the [NSWindow-becomeKeyWindow] method
</li>
<li>
If the window is ordered front and the window is the key
window.
</li>
<li>
If during _lossOfKeyOrMainWindow, only the main menu is able to
become key (for window systems where this is required).
</li>
</ul>
<h2><a name="001004000000">Window Focus In/Out</a></h2>
<p>
The GUI front-end receives two types of focus events from the
back-end (through an NSEvent object). Both of these are subsets
of the NSAppKitDefined event: GSAppKitWindowFocusIn and
GSAppKitWindowFocusOut. A FocusIn event can be received for
several reasons:
</p>
<ul>
<li>
The window manager deminiaturized the window. The WM
should really tell the application to do this itself, but many
WMs don't. In this case the window just posts a notification
that it happened.
</li>
<li>
The application is in the process of hidding. As each
window is ordered out, the WM may send a focus message
(spuriously) to the next window in line. In this case the
message is just ignored.
</li>
<li>
If the previous cases do not apply, the window checks if it
can become key or main and activates the application if it is
not active.
</li>
<li>
If this window is the main menu, it looks for another
window to become the key window, if possible, through the
_lossOfKeyOrMainWindow mechanism
</li>
</ul>
<p>
The back-end should keep track of the last window that requested
to become key. This can be important in determining whether the
back-end should send a FocusIn event to a window when it
receives a signal from the window manager or windowing system.
Sending a FocusIn event to a window that already requested it,
msy cause focus confusion in the GUI.
</p>
<p>
The front-end does nothing for FocusOut messages.
</p>
<h2><a name="001005000000">X-Windows messages</a></h2>
<p>
This section describes messages that X-Windows servers and the WM
generally send to the application. Other window servers may send
similar messages.
</p>
<dl>
<dt>Take Focus</dt>
<dd>
<p>
A message from the WM telling a window it should take keyboard
focus. If the app is not active, the back-end should send a
FocusIn event. Otherwise, the back-end should only send a
FocusIn event to the front end if the message is due to a user
action, such as a click on the title bar (i.e. the target
window is not the current key window or the last window that
requested key status). The back-end may
also send an event if the window has just been mapped,
although this is not typically necessary, unless it's due to a
screen change.
</p>
<p>
In other cases, the back-end should do what is necessary to
make sure that the last window to request key status receives
it instead of the one the WM thinks should receive it.
</p>
</dd>
<dt>Focus In</dt>
<dd>
<p>
A message from the server telling the application that
keyboard focus has been set for a window. The back-end
should not send an event to the front-end in this
case. However, the back-end should use this information to
determine when to send a message in other cases (e.g. from a
Take Focus message).
</p>
</dd>
<dt>Focus Out</dt>
<dd>
<p>
A message from the server telling the application that focus
has left a window. If the focus has gone to a window that is
not part of the application, the back-end should tell the
NSApp to deactivate. Otherwise it should do nothing.
</p>
</dd>
</dl>
<br />
</body>
</html>

3
Documentation/GNUmakefile
View file

@ -31,6 +31,8 @@ include ../Version
# The documents to be generated
DOCUMENT_NAME =
SUBPROJECTS = Back
# The text documents to be generated
DOCUMENT_TEXT_NAME = \
INSTALL NEWS README ANNOUNCE
@ -58,6 +60,7 @@ ANNOUNCE_DOC_INSTALL_DIR = Developer/Back/ReleaseNotes/$(VERSION)
-include GNUmakefile.local
include $(GNUSTEP_MAKEFILES)/documentation.make
include $(GNUSTEP_MAKEFILES)/aggregate.make
-include Makefile.postamble

37
Source/x11/raster.c
View file

@ -537,40 +537,3 @@ RMakeTiledImage(RImage *tile, unsigned width, unsigned height)
}
return image;
}
RImage*
RMakeCenteredImage(RImage *image, unsigned width, unsigned height, RColor *color)
{
int x, y, w, h, sx, sy;
RImage *tmp;
tmp = RCreateImage(width, height, False);
if (!tmp) {
return NULL;
}
RClearImage(tmp, color);
if (image->height < height) {
h = image->height;
y = (height - h)/2;
sy = 0;
} else {
sy = (image->height - height)/2;
y = 0;
h = height;
}
if (image->width < width) {
w = image->width;
x = (width - w)/2;
sx = 0;
} else {
sx = (image->width - width)/2;
x = 0;
w = width;
}
RCombineArea(tmp, image, sx, sy, w, h, x, y);
return tmp;
}