Module CS/plugins/documentsystem/xmlread/

back to main page

Summary Period: 2003-04-02 to 2003-06-22

Modules

[root]/CS/plugins/documentsystem/xmlread

Lines Of Code


Total Lines Of Code: 2785 (2003-07-11 20:29)

Authors

Author Changes Lines of code Lines per change
Totals 57 (100.0%) 3376 (100.0%) 59.2
jorrit 45 (78.9%) 3329 (98.6%) 73.9
sunshine 7 (12.3%) 20 (0.6%) 2.8
res2002 2 (3.5%) 15 (0.4%) 7.5
matzebraun 2 (3.5%) 10 (0.3%) 5.0
jtarbox 1 (1.8%) 2 (0.1%) 2.0

Most Recent Commits

sunshine 2003-06-22 22:38

Eric Sunshine removed the unused, obsolete, and deprecated top-level <name>
node from the .csplugin files.

0 lines of code changed in:

sunshine 2003-06-05 15:44

Eric Sunshine performed Phase Three of the elimination of the monolithic
scf.cfg:

-*- Eliminated the SCF information which was hardcoded in the .cpp files
of plugin modules, and which duplicated information in the external
.csplugin files.

-*- Plugin modules no longer maintain and export a monolithic class list.
Now, each factory implemented by the code is exported automatically.

-*- Added a new <implementation> child node to the <class> node in
.csplugin files. The value of this node is the name of the C++ class
which implements the SCF class. For instance, C++ class csVFS
implements crystalspace.kernel.vfs.

-*- Eliminated the following SCF macros which were related to exporting
SCF information from .cpp code and/or registering classes manually:

SCF_EXPORT_CLASS_TABLE
SCF_EXPORT_CLASS
SCF_EXPORT_CLASS_DEP
SCF_EXPORT_CLASS_TABLE_END
SCF_REGISTER_STATIC_CLASS_DEP

-*- Eliminated the following methods from iSCF:

RegisterStaticClass
RegisterClassList

-*- Plugin modules are now initialized/shutdown lazily as classes are
requested from them. The first time a class is requested, the plugin
is initialized. The plugin is shutdown after the last class instance
has been destroyed.

-*- Fixed bug in scf.h where SCF_PRINT_CALL_ADDRESS was not being enabled
for gcc 3.x.

-*- Fixed bug in win32.jam where GenerateExportDefs rule failed to ensure
that directory containing output file existed before creating file.
Also fixed bug where it failed to set up a dependency between the
input and output files.

-*- Still To-Do:

- Remove references to scf.cfg and scfreg from documentation. Also
document new .csplugin resources.

- Add platform-specific function to scan and locate plugins
automatically rather than using the ad-hoc approach inherited from
scanning for .scf files.

- Add platform-specific function to query a plugin's meta-information.
This should be used by SCF to do the raw extraction. Provide and
finalize API for higher-level clients to access meta-information.

- Augment static linking to work with the new facility. (Removal of
the hardcoded SCF information, has now broken static linking. It
worked until this time, even with all of the preceding changes.)

1 lines of code changed in:

jorrit 2003-05-29 08:06

Replaced NULL with 0.

48 lines of code changed in:

sunshine 2003-05-26 09:49

Eric Sunshine performed Phase One of the elimination of the monolithic
scf.cfg:

-*- Plugin modules are now self-describing. This information can be
queried at run-time without having to actually load the module.

-*- The plugin maintainer now manages the plugin's meta-information in an
external .csplugin file, rather than hard-coding the information into
the plugin's source code. The mechanism by which the meta-information
is bound to the plugin is platform-dependent. Presently, all
platforms simply lay down the meta-information in a plain text file
alongside the plugin itself; with the same basename and extension
.csplugin. This may change in the future. For example, on MacOS/X,
the meta-information will probably be encapsulated within the plugin's
bundle wrapper.

-*- Plugin meta-information is now maintained in XML format. Here is an
example:

<?xml version="1.0"?>
<!-- gl3d.csplugin -->
<plugin>
<name>gl3d</name>
<scf>
<classes>
<class>
<name>crystalspace.graphics3d.opengl</name>
<description>OpenGL 3D graphics driver</description>
<requires>
<class>crystalspace.font.server.</class>
</requires>
</class>
</classes>
</scf>
</plugin>

-*- Since meta-information is now extensible, maintainers can choose to
publish supplementary information about plugins (in addition to the
SCF information already published). For example, image loading
plugins could publish "image indendification" information which would
allow the image loading multiplexor to selectively request image
loading plugins on-demand, rather than requesting all plugins
unconditionally, even if they are not needed. Here is an example of a
possible meta-information table for the PNG loader:

<?xml version="1.0"?>
<!-- cspngimg.csplugin -->
<plugin>
<name>cspngimg</name>
<scf>...</scf>
<imageloader>
<imagetype>
<class>crystalspace.graphic.image.io.png</class>
<identify>
<mimetype>image/png</mimetype>
<extension>png</extension>
<extension>PNG</extension>
<scan length="4" bytes="\0x89PNG"/>
</identify>
</imagetype>
</imageloader>
</plugin>

In this example, the PNG loader meta-information tells the multiplexor
several different ways to identify a PNG image: by checking file
extension, if available; by checking MIME type, if available; by
checking for the magic-string "\0x89PNG" in the raw image data. If
the multiplexor identifies the image as PNG, only then will it
actually request the PNG loader.

-*- Added the --meta-file directive to msvcgen.pl to allow specification
of the meta-information file for a module. The value of this option
is interpolated into template files via the new %metafile% variable.
msvcgen.mak now utilizes this flag with the value of the new
INC.PROJECT makefile variable. Augmented the MSVC6 and MSVC7 plugin
template files (plugin.tpl) to make use of %metafile%.

-*- Changed the file extension for plugins on MacOS/X from .csplugin to
.csbundle to avoid conflict with new meta-information resource which
uses the extension .csplugin.

-*- Still To-Do:

- Augment SCF to utilize the new meta-information resources, and to
understand the new XML format. Presently, these resources are
ignored at run-time.

- Add platform-specific function to scan and locate plugins
automatically, rather than relying upon a monolithic registry such
as scf.cfg.

- Add platform-specific function to query a plugin's meta-information.

- Eliminate the monolithic scf.cfg.

- Augment static linking to work with the new facility.

- Eliminate the hard-coded SCF registration information in each
plugin's source code.

15 lines of code changed in:

res2002 2003-05-08 20:15

- fixed a leak in the XmlRead plugin, analogue to the TinyXML leak.
- fixed a leak when the engine reads the precalc info introduced
after my recent changes related to VFS files.
- changed the sprite3d and genmesh factories analogue to the changes
made to csThingStatic.
- augmented the API modification docs with information about the
iPolygonMesh and procedural textures changes.

15 lines of code changed in:

sunshine 2003-04-27 11:33

Eric Sunshine made the following changes:

-*- Modified configure.ac so that it emits a SRCDIR property to
config.mak. This value represents the --srcdir argument given to the
configure script (or "." if --srcdir is omitted). This points at the
directory containing the CS source code (which may differ from the
build directory, which is typically the current working directory).

-*- Modified makefiles and build scripts throughout the project so that
they respect $(SRCDIR). This allows the project to be built in a
directory other than the source directory, thus it is possible to
place the source directory on a readonly filesystem (such as a
CD-ROM), or to share a single NFS-mounted source directory among
different builds, where each build inhabits its own directory. For
example, if CS resides at /home/CS and you wish to build the project
in /home/build:

% cd /home/build
% ../CS/configure
% make -k all
% make install

(Note that the Jam-base build system already supports this build
paradigm.)

-*- Modified configure.ac so that it emits EXTENSIVE_MEMDEBUG to
config.mak since this variable is used by Makefile.in for the
`showconfig' target.

-*- Modified configure.ac so that it emits MONITOR_MAKEFILE_CACHE when the
value is either "yes" or "no", instead of emitting it only when the
value is "yes". This was necessary because CS/mk/cache.mak prints the
value of this variable as part of $(SYSMODIFIER).

3 lines of code changed in:

jorrit 2003-04-18 11:09

- Made the TinyXML parser thread-safe by moving the node pool from
document system to the document itself (i.e. a pool per document).
Note that this is only thread-safe when using different documents
for different threads. Don't use the same document in different
threads! Also VFS itself is not yet thread-safe. So the parsing
and writing functions on iDocument that use either iFile or
iVFS are not safe!
- The XMLRead parser has been made thread-safe in the same way.

74 lines of code changed in:

sunshine 2003-04-10 17:56

Eric Sunshine made the following changes to the makefiles:

-*- Converted the remaining "application" makefiles so that they place
their generated files in a personalized subdirectory of $(OUT), rather
than placing them directly in $(OUT). This lifts the monolithic
restriction that all applications must use distinct names for their
source files.

-*- Converted the application makefiles to augment OUTDIRS with their
personalized output directories, rather than each having a custom
directory creation rule. Not only does this simplify the makefiles
slightly, but it also fixes a problem where the personalized output
directories of plugin modules were not created when an application
makefile target (such as "make walktest") was invoked explicitly and
when the project had been configured with --disable-plugins.

-*- Updated CS/mk/template.mak to reflect the aforementioned changes.

-*- Fixed formatting of help messages emitted by "make help" for several
makefiles.

1 lines of code changed in:

matzebraun 2003-04-08 20:22

added the Jamfiles

9 lines of code changed in:

jorrit 2003-04-05 21:52

Fixed a bug in xmlread plugin which caused the XML reader to read a
few bytes beyond the end of the input buffer.

2 lines of code changed in:

jtarbox 2003-04-05 20:10

adding Rhad's fix for xmlread asserts in MSVC

2 lines of code changed in:

jorrit 2003-04-04 11:25

Put back to 7000 instead of 10000.

1 lines of code changed in:

jorrit 2003-04-04 11:23

- By pure luck I discovered that both frustvis and dynavis were
not using the correct frustum for culling. They were in all cases
using the top-level frustum instead of the current active
frustum. I fixed this to use the current frustum. The effect of this
is that rendering through portals is now a LOT more efficient
as both frustvis and dynavis will now do frustum culling on a
smaller frustum. For example: in one of the PlaneShift levels,
standing inside the temple looking outside FPS went up from 25
to 40 with this optimization.

3 lines of code changed in:

matzebraun 2003-04-03 15:43

cleaned up csutil as proposed in the crystal-develop list

1 lines of code changed in:

jorrit 2003-04-03 12:38

- Additional optimizations to xmlread. The first text node (which
is very common) is now treated specially.
- Added level load timing code to Walktest.

107 lines of code changed in:

jorrit 2003-04-03 11:49

Small optimization to xmlread.

15 lines of code changed in:

jorrit 2003-04-03 09:56

Fixed bug in xmlread with parsing of attributes values that
have no quotes around them.

1 lines of code changed in:

jorrit 2003-04-03 08:42

- Applied the fix that res did to the TinyXML parser (with CDATA)
also to xmlread.
- Added 'xmlread' to 'make walkall'.

12 lines of code changed in:

jorrit 2003-04-02 14:05

- Changed csloader plugin to use iFile instead of iDataBuffer for
reading. The reason is that the new 'xmlread' plugin can save
considerably memory in that particular case.
- Changed the readxml parser so that it no longer does any string
manipulation. Instead it gets the string data directly from the
XML data it is reading.

210 lines of code changed in:

jorrit 2003-04-02 10:44

Removed some more unused code in readxml.

0 lines of code changed in:

(2 more)


Generated by StatCvs v0.2-dev