Designer's tools and capabilities are available via the Design item in the Edit menu, or by typing `design' into the Command window. The display changes to show you everything in the world, you get a number of special privileges (such as the ability to look at and move ANY unit), and you get a designer's tools palette.
In general, palette items use Option-click and Option-Shift-click to cycle through possible values, and many also have a popup menu. Also note that the selection can be changed without changing the tool; you have to click in the tool and get a heavy border around it before the tool is actually changed. Each type of designer tool has a distinct cursor when over a map window, so look for that as well.
Creating Named Features
Setting Brush Size
If you want to change the icons and pictures in an existing game, or if you want to define new ones, you can do this either with a resource editor such as ResEdit, or with a resource compiler such as Rez, or by editing the portable "imf" files. Xconq can use PICTs, icons, and patterns to draw with; collectively these will be called "images". A group of images that all represent different views of the same thing is an "image family". The concept is similar to the icon families used by Macintosh programs, but is much more general, since you can have any number of images of different sizes and depths, as well as images embedded in each other.
The resource file
:lib-mac:Images is the main repository of Mac imagery.
You can resource-edit this file, close it, start up Xconq, and see
the results. For instance, if you want to improve the appearance of the
"city20" image, you will find a 32x32
'cicn' with that name as
well as a 16x16 'sicn'. You can modify these as you like.
Note that the 'sicn' includes a mask sicn, as does the
Masks are optional, but improve the appearance of the images.
If you have a new type in a game and you want an image for it,
just create a resource, such as a
'cicn', give it the name of
the type or its
image-name property, and you're done.
The standard resource types for images are
If a resource of one of these types has a name
image-name (or the type name if no image name is defined)
of a type in a game, then Xconq will use that resource.
There are two additional resource types:
'XCic' resources are named colors that can be referred to via
color properties of types and sides.
'XCif' resources are raw image family forms
in GDL syntax. If the contents of an image family can be totally defined
by the standard resource types,
then there need not be an
but if an image has any embedded subimages, or a specific location for
subimages, then this information will be in the
You can edit by defining this resource type as
which will give you a text editor for the resource, or by just
'TEXT' editor on the resource.
For more details about the syntax of image families in GDL,
see the reference manual.
Warning: don't ever make a
'cicn' with id 256!
For some reason, if there is a
'cicn' 256 in either the application
or in any of the resource files that it has open,
the small color icons in both the apple menu (far left)
and the application menu (far right) become small unrecognizable blobs.
This effect seems to be innocuous behaviorwise, but the appearance is poor,
and users choose menu items by looking at those icons, so trashing them
is a bad thing to do.
If the Resources file has a PICT whose name is "<game-name> game", then if a player selects <game-name> in the new game dialog, this PICT will be displayed in the dialog. This is useful to give prospective players more of an idea of what the game might be like, plus it's a chance to show off your artistry! (If you're a lousy artist, just make a screen shot of the map and use that.) The area for the picture is about 200 pixels across and 100 high; pictures smaller than that will be centered, while larger pictures will be clipped to fit.
IMFApp is a utility for examining and converting the image families used by Xconq.
The general concept of image families is similar to that of the Finder icon families, where several depths and sizes of an icon are available for use in different situations. Xconq adds extra complexity to the concept by including tiling patterns, by allowing icons to be embedded in each other, and by using the same image families on several different platforms.
The platform-independent format would be hard to edit, so IMFApp includes functions to convert between the common format and Mac resources. These functions are available from the File Menu.
In addition, IMFApp also allows you to look at the images. You can control the images' size, overlay, and use of color. The primary use for this is to test how an image works in various situations. Also, if you design games, this is a good place to start when choosing images for your game. Since there are hundreds of images available already, the chances are good that the images you want have already been designed.
The File menu has items to open and save imf and resource files. New clears any existing images. Opening multiple files merges their contents.
The Edit menu is not used.
The View menu includes all image appearance controls. Everything in this menu affects only the display of the images, and does not, in any way, affect the image families themselves. Display options include size of images, color/mono, name, mask, background/emblem images, and more.
Mac Xconq handles sounds in a very simple way. The resource
file `:lib-mac:Sounds' includes a number of named
resources. If an event movie includes a form like
then the event occurs, Mac Xconq will look for a sound resource
pop and play it.