MaCoPiX Install & Starting
      - Make and Install of Program
      - Install of Mascots
      - Starting, Commandline Options
      - Popup Menu


Make and Install of Program
When you install from the source code tar-ball, please follow these instructions.
This package supports automake & autoconf. So, I expect you can easily install it.
1. extract source archive, change directory to the created one.
2. ./configure (or ./configure --with-gtk2 for Gtk+2)
3. make
4. su
5. make install
If you need to internationalize your menu message (using gettext), you have to do "make install" as a root.

The configure script makes Makefiles for Gtk+3 compiling. If you want to make with Gtk+2, you should run "./configure --with-gtk2" .


Installation of Mascots

You cannot enjoy MaCoPiX without mascots. So please install one mascot at least.
Ver3.0.0 or later can download and install official mascots (distributed in this web site) directly via HTTP. So, you can ignore the following explanation.


(a) Installation the all of mascots in the menu
Likely in this web-site, you may find a series of mascots with a menu file. In that case, please follow instruction below.
a-1. At first, please install the program of MaCoPiX, following the above instruction.
a-2. Download the archive of the mascots. (no need to extract)
a-3. From the right click menu of the mascot, "Install" -> "Launcher Menu". You can appoint the archived mascots file (tar.gz) in the file chooser.
a-4. Mascots are automatically extracted and installed.
By this procedure, the all mascots listed in the menu will be installed into your HOME$/.macopix/ directory (If this directory does not exist, it will be created.). If the mascots to be installed already exists, it will be overwritten.

(b) Instllation, and Starting of individual Mascot
Mascots don't need such installation with a menu always. In the case that you prepare a mascot w/o any menu files, or that you want to start individual installed mascot, you can type only the following in the command line.
macopix (nanika).mcpx



Starting, Commandline Options
At the starting up, the loading mascot will be selected by the following priority.
1. Directly Appointment in the Command Line
If you appoint a mascot file (*.mcpx) in the starting up of MaCoPiX from the command line, MaCoPiX will load the appointed mascot. And the mascot file will be automatically seached in accordance with the priority explained in the following paragraph "About Mascots".
2. Selected at Random from the Menu
If you have written the default menu in your resource file (you can do it in the popup menu), or appoint a menu file in the command line, and if you did not appoint any mascots in the command line, MaCoPiX will start with a mascots selected at random from that menu.
3. None of the above
Printed HELP messages, it will be over.


Starting MaCoPiX with "-h" option, you can verify its command line options.
Option
   & arguments
verbose Contents
-h --help Print help message.
-c --common-dir Print COMMON Directory.
-b --biff Turn on the biff function.
-s --signal Turn on the time signal.
-o offset[%] --offset Set offset-value for Focus Following.
-r rc-file --offset Set the resource file.
-m menu-file --menu Set magnification percentage of mascot.
-mg magnify --magnify Set magnification percentage of mascot.
-i (0|1|2|3) --ip-style Set interpolation style for magnification.
-a --auto-install Set mascot auto install ON.
-na --no-auto-install Set mascot auto install OFF.
-O --over-write Permit to overwrite files in user dir.



Popup Menu
You can find the popup menu of MaCoPiX with the right click on the mascot (see the figure on the right).
You can load, save, and change the setting of MaCoPiX form here.

In the case that you use the window manager whose focus is following the mouse pointer and that you use MaCoPiX with the focus follow mode, it might be hard for you to click on the MaCoPiX mascot. In such case, you had better use the
Home Position function of MaCoPiX.

The contents of the popup menu is as follows...

Open Open Mascot
Select and start a mascot (File extension : mcpx). This starts a file selection dialog.
Launcher Menu
File Select
Select a menu file (File extension : menu). And reconstruce the mascot launcher menu in the popup. This starts a file selection dialog.
Launcher
Open the launcher menu selection dialog which automatically searches installed menus in your environment.
For Developper
Convert from Nokkari-Chara
Import Nokkari-Chara data (an window sitter for MS Windows) to MaCoPiX.
Please read this carefully when you use this function (sorry, this is Japanese).
Save Save Mascot
Save the current status of the mascot into the current loaded mascot file (overwritten).
Save Mascot AS...
Select a destination mascot file and save the current status of the mascot. This starts a file selection dialog.
Launcher Menu Save
Select a destination menu file and save the current status of the launcher menu. This starts a file selection dialog.
Set as Default
Save the current menu file as default in the current loaded resource file.
Remove from Default
Remove the setting of the default menu file from the current loaded resource file.
Save Resource
Select a destination resourcde file (File extension : rc) and save the current loaded resources in it. This starts a file selection dialog.
For Developper Save for Release
Save the current loaded mascot as a version for release. This starts a file selection dialog. Image files for mascot will be automatically copied into the same directry as the mascot's.
Convert to Nokkari-Chara
Convert current MaCoPiX data to Nokkari-Chara data (an window sitter application for MS Windows) and save it.
Please read this carefully when you use this function (sorry, this is Japanese).
Save All
Save the current status of mascot / resource / launcher menu / default menu setting into the each files.
New Create New Mascot
Create a new mascot. You should appoint a new mascot file to be saved and a image file for the new mascot according to the guidance of dialogs.
Create New Launcher Menu
Create a new menu file. A created menu file contains only one mascot, which are loaded currently. So, you should edit the menu setting in the configuration dialog after created it.
Config
Start the configuration dialog.
Biff Check
If you want to use the biff check function of MaCoPiX, you should check here.
Time Signal
If you want to use the time signal function of MaCoPiX, you should check here.
Mascot Launcher
The mascot launcher for the quick selection of mascots.
Exit
Exit from MaCoPiX.

Kurumi Chimari
Last modified: 2007/04/23 18:47:13 HST