Server : Apache/2.4.41 (Ubuntu) System : Linux absol.cf 5.4.0-198-generic #218-Ubuntu SMP Fri Sep 27 20:18:53 UTC 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.33 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, Directory : /usr/share/GNUstep/Documentation/Developer/Gui/ProgrammingManual/AppKit/
Upload File :
Current File : //usr/share/GNUstep/Documentation/Developer/Gui/ProgrammingManual/AppKit/Introduction.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- (C) 2005-2006 Christopher Armstrong.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2, as published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".
This documentation is provided on an "AS IS" BASIS, WITHOUT WARRANTY
OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED
TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND USEFULNESS
OF THE DOCUMENTATION IS WITH YOU (THE LICENSEE). IN NO EVENT WILL THE COPYRIGHT
HOLDERS BE LIABLE FOR DAMAGES, INCLUDING ANY DIRECT, INDIRECT,
SPECIAL, GENERAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF
THE USE OR INABILITY TO USE THIS DOCUMENTATION (INCLUDING BUT NOT
LIMITED TO LOSS OF DATA, USE, OR PROFITS; PROCUREMENT OF SUBSTITUTE
GOODS AND SERVICES; OR BUSINESS INTERUPTION) HOWEVER CAUSED, EVEN
IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -->
<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Introduction (Using the GNUstep AppKit 0.1)</title>
<meta name="description" content="Introduction (Using the GNUstep AppKit 0.1)">
<meta name="keywords" content="Introduction (Using the GNUstep AppKit 0.1)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="index.html" rel="start" title="Top">
<link href="conceptindex.html" rel="index" title="conceptindex">
<link href="index.html" rel="up" title="Top">
<link href="basicconcepts.html" rel="next" title="basicconcepts">
<link href="index.html" rel="prev" title="Top">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<span id="Introduction"></span><div class="header">
<p>
Next: <a href="basicconcepts.html" accesskey="n" rel="next">basicconcepts</a>, Previous: <a href="index.html" accesskey="p" rel="prev">Top</a>, Up: <a href="index.html" accesskey="u" rel="up">Top</a> [<a href="conceptindex.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<span id="Introduction-1"></span><h2 class="chapter">1 Introduction</h2>
<p>This manual documents some configuration and installation issues
with the GNUstep GUI Library and also differences between the GUI
Library and libraries that implement the OpenStep AppKit specification
and the MacOS-X AppKit implementation.
</p>
<span id="Overview"></span><h3 class="section">1.1 Overview</h3>
<p>The GNUstep GUI Library is a library of objects useful for writing
graphical applications. For example, it includes classes for drawing
and manipulating graphics objects on the screen: windows, menus,
buttons, sliders, text fields, and events. There are also many
peripheral classes that offer operating-system-independent interfaces to
images, cursors, colors, fonts, pasteboards, printing. There are also
workspace support classes such as data links, open/save panels,
context-dependent help, spell checking.
</p>
<p>It provides functionality that aims to implement the ‘<samp>AppKit</samp>’
portion of the OpenStep standard. However the implementation has
been written to take advantage of GNUstep enhancements wherever possible.
</p>
<p>The GNUstep GUI Library is divided into a front and back-end. The
front-end contains the majority of implementation, but leaves out the
low-level drawing and event code. Different back-ends will make GNUstep
available on various platforms. The default GNU back-end currently runs
on top of the X Window System and uses only Xlib calls for
graphics. Another backend uses a Display Postscript Server for graphics.
Much work will be saved by this clean separation between front and
back-end, because it allows different platforms to share the large
amount of front-end code. Documentation for how the individual backends
work is coverered in a separate document.
</p>
<span id="Implementation-Details"></span><h3 class="section">1.2 Implementation Details</h3>
<p>Following are some implementation details of the GUI library. These will
mostly be of interest to developers of the GUI library itself.
</p>
<span id="Drag-and-Drop"></span><h4 class="subsection">1.2.1 Drag and Drop</h4>
<p>The drag types info for each view is kept in a global map table (protected by
locks) and can be accessed by the backend library using the function -
</p>
<div class="example">
<pre class="example">NSArray *GSGetDragTypes(Nsview *aView);
</pre></div>
<p>Drag type information for each window (a union of the drag type info for all
the views in the window) is maintained in the graphics context.
The backend can get this information (as a counted set) using -
</p>
<div class="example">
<pre class="example">- (NSCountedSet*) _dragTypesForWindow: (int)winNum;
</pre></div>
<p>Whenever a DnD aware view is added to, or removed from a window, the type
information for that view is added to/removed from the type information
for the window, altering the counted set. If the alteration results in a
change in the types for the window, the method making the change returns YES.
</p>
<div class="example">
<pre class="example">- (BOOL) _addDragTypes: (NSArray*)types toWindow: (int)winNum;
- (BOOL) _removeDragTypes: (NSArray*)types fromWindow: (int)winNum;
</pre></div>
<p>The backend library should therefore override these methods and call ’super’
to handle the update. If the call to the super method returns YES, the
backend should make any changes as appropriate (in the case of the xdnd
protocol this means altering the XdndAware property of the X window).
</p>
<p>You will notice that these methods use the integer window number rather
than the NSWindow object - this is for the convenience of the backend
library which should (eventually) use window numbers for everything
</p>
<span id="NSWorkspace"></span><h4 class="subsection">1.2.2 NSWorkspace</h4>
<p>Here is (I think) the current state of the code (largely untested) -
</p>
<p>The make_services tool examines all applications (anything with a .app,
.debug, or .profile suffix) in the system, local, and user Apps Directories.
</p>
<p>In addition to the cache of services information, it builds a cache of
information about known applications (including information about file types
they handle).
</p>
<p>NSWorkspace reads the cache and uses it to determine which application to use
to open a document and which icon to use to represent that document.
</p>
<p>The NSWorkspace API has been extended to provide methods for finding/setting
the preferred icon/application for a particular file type. NSWorkspace will
use the ’best’ icon/application available.
</p>
<p>To determine the executable to launch, if there was an
Info-gnustep.plist/Info.plist in the app wrapper and it had an
NSExecutable field - use that name. Otherwise, try to use the name of
the app - eg. foo.app/foo The executable is launched by NSTask, which
handles the addition of machine/os/library path components as necessary.
</p>
<p>To determine the icon for a file, use the value from the cache of icons
for the file extension, or use an ’unknown’ icon.
</p>
<p>To determine the icon for a folder, if the folder has a ’.app’, ’.debug’
or ’.profile’ extension - examine the Info.plist file for an ’NSIcon’
value and try to use that. If there is no value specified - try
foo.app/foo.tiff’ or ’foo.app/.dir.tiff’
</p>
<p>If the folder was not an application wrapper, just try the .dir.tiff file.
</p>
<p>If no icon was available, use a default folder icon or a special icon for the
root directory.
</p>
<p>The information about what file types an app can handle needs to be in
the MacOS-X format in the Info-gnustep.plist/Info.plist for the app -
see
<a href="http://developer.apple.com/techpubs/macosxserver/System/Documentation/Developer/YellowBox/ReleaseNotes/InfoPlist.html">http://developer.apple.com/techpubs/macosxserver/System/Documentation/Developer/YellowBox/ReleaseNotes/InfoPlist.html</a>.
</p>
<p>In the NSTypes fields, I used NSIcon (the icon to use for the type)
NSUnixExtensions (a list of file extensions corresponding to the type)
and NSRole (what the app can do with documents of this type). In the
AppList cache, I generate a dictionary, keyed by file extension, whose
values are the dictionaries containing the NSTypes dictionaries of each
of the apps that handle the extension.
</p>
<p>I tested the code briefly with the FileViewer app, and it seemed to
provide the icons as expected.
</p>
<p>With this model the software doesn’t need to monitor loads of
different files, just register to recieve notifications when the
defaults database changes, and check an appropriate default value. At
present, there are four hidden files used by the software:
</p>
<dl compact="compact">
<dt>‘<samp>~/GNUstep/Services/.GNUstepAppList</samp>’</dt>
<dd><p>Cached information about applications and file extensions.
</p></dd>
<dt>‘<samp>~/GNUstep/Services/.GNUstepExtPrefs</samp>’</dt>
<dd><p>User preferences for which apps/icons should be used for each file
extension.
</p></dd>
<dt>‘<samp>~/GNUstep/Services/.GNUstepServices</samp>’</dt>
<dd><p>Cache of services provides by apps and services daemons
</p></dd>
<dt>‘<samp>~/GNUstep/Services/.GNUstepDisabled</samp>’</dt>
<dd><p>User settings to determine which services should not appear in the
services menu.
</p></dd>
</dl>
<p>Each of these is a serialized property list.
</p>
<p>Almost forgot - Need to modify NSApplication to understand ’-GSOpenFile ...’
as an instruction to open the specified file on launching. Need to modify
NSWorkspace to supply the appropriate arguments when launching a task rather
than using the existing mechanism of using DO to request that the app opens
the file. When these changes are made, we can turn any program into a
pseudo-GNUstep app by creating the appropriate app wrapper.
An app wrapper then need only contain a shell-script that understands the
-GSOpenFile argument and uses it to start the program - though provision of
a GNUstep-info.plist and various icons would obviously make things prettier.
</p>
<p>For instance - you could set up xv.app to contain a shellscript ’xv’ that
would start the real xv binary passing it a file to open if the -GSOpenFile
argument was given. The Info-gnustep.plist file could look like this:
</p>
<div class="example">
<pre class="example">{
NSExecutable = "xv";
NSIcon = "xv.tiff";
NSTypes = (
{
NSIcon = "tiff.tiff";
NSUnixExtensions = ( tiff, tif );
},
{
NSIcon = "xbm.tiff";
NSUnixExtensions = ( xbm );
}
);
}
</pre></div>
<span id="Contributing"></span><h3 class="section">1.3 Contributing</h3>
<p>Contributing code is not difficult. Here are
some general guidelines:
</p>
<ul>
<li> FSF must maintain the right to accept or reject potential contributions.
Generally, the only reasons for rejecting contributions are cases where
they duplicate existing or nearly-released code, contain unremovable
specific machine dependencies, or are somehow incompatible with the
rest of the library.
</li><li> Acceptance of contributions means that the code is accepted for adaptation
into libgnustep-gui. FSF must reserve the right to make various editorial
changes in code. Very often, this merely entails formatting, maintenance of
various conventions, etc. Contributors are always given authorship credit and
shown the final version for approval.
</li><li> Contributors must assign their copyright to FSF via a form sent out
upon acceptance. Assigning copyright to FSF ensures that the code
may be freely distributed.
</li><li> Assistance in providing documentation, test files, and debugging
support is strongly encouraged.
</li></ul>
<p>Extensions, comments, and suggested modifications of existing libgnustep-gui
features are also very welcome.
</p>
<hr>
<div class="header">
<p>
Next: <a href="basicconcepts.html" accesskey="n" rel="next">basicconcepts</a>, Previous: <a href="index.html" accesskey="p" rel="prev">Top</a>, Up: <a href="index.html" accesskey="u" rel="up">Top</a> [<a href="conceptindex.html" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
Server : Apache/2.4.41 (Ubuntu)