17.5.1995
The Image Studio v0.5, May 1995
================================
Remember to read README.1st first. See file INSTALL for compiling and
installing info.
Contents
--------
1. Copyright, distributing and other Legal things.
2. Introduction: What TIS is, and what it isn't.
3. TIS philosophy
4. Functions
5. Keyboard shortcuts
6. Usage examples.
7. Other things to notify, bugs
1. Copyright, distributing and other legal things.
--------------------------------------------------
TIS is Copyright (C) 1995 by Heikki Tienari.
All rights reserved, except for the following:
Anyone can redistribute TIS, but all the documentations and all the
sources must allways be distributed with it.
Necessary files are:
INSTALL externs.h load_save.c other.c sxbm.c
Makefile get_string.c main.c panel.c tis.doc
README.1st icon.h menue.c question.c tools.c
effects.c image.h mesg.c region.c
empty.c lmesg.c misc.c rxbm.c
If you are missing some of these files, you are having illegal distribution.
Please, try to find the official version from somewhere.
You may do whatever you want with the sources in personal use. But you
are not allowed to distribute any modified versions of TIS.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. I have no
responsibility for any problems or damages caused by use of TIS.
2. Introduction: What TIS is, and what it isn't.
------------------------------------------------
The Image Studio (TIS) can be used to create a special trick pictures
by joining several pictures in one. Besides, it can be used to make
simple drawings and paintings. Especially it is fun to join a couple of
scanned pictures in one trick picture. At the moment TIS supports only
X11 bitmaps, which are of course black and white. This may sound pretty
stupid and limited to you. Just remember that most printers are black and
white anyway, so in some cases TIS really is useful tool.
So, TIS really is *not* any great, colorfull, painting and/or drawing
program. Simple drawing and painting functions are included, but they are
very limited. Main purpose of this program is to join several pictures in
one or more result pictures. This feature can be used to make great tricks.
Besides, TIS does have posibility to flip and rotate pictures and to
change picture sizes.
3. TIS philosophy
-----------------
When using TIS, you are always hanging with three differen images. They
are called Master, Primary and Secondary Images. Primary and Secondary
Images are mainly 'input images'. You can load pictures to these and make
all the normal drawing, cutting, pasting etc. functions.
Master Image is the place where you are creating, what ever you are
creating. You can easily join parts of Primary and Secondary Images to Master.
Also all ordinary functions will work here. Master Image can be saved.
Primary and Secondary Images cannot be saved and Master Image cannot be
loaded. This is because, it forces you to use the different images for
the right purposes.
You may change between different images by selecting images from 'Images'
menu or by pressing function keys F1-F3.
Note that TIS it not necessary refreshing whole window all the time.
So, you will have some mess in the window by the times. Mess will allways
be out of current image. To get ride of mess you will have to refresh the
window. It can be done by selecting 'Refresh Window' from 'Other' menu or by
pressing 'r' key. At the beginning, you may be little confused because of
this working method, but don't worry.
Note that the reason why TIS working like this is speed.
Other quite a important thing to mentione is that Image size is not
automatically same as the size of the window. This may also cause some
problems at the beginning. If you want to set Image size to be same as
current window size, select 'Auto Set' from 'Other' menu.
The default image size is very small, because we are supposing that you
will load an image or set the suitable size by yourself. This also may
cause some questions if you don't what you are doing.
So, TIS is not very easy to use. But it is very many-sided: The tools
and functions are decided so, that they can be used in many different
ways. Use you imagination, is the direction number one.
4. Functions
------------
4.1 Picture menu
Load.
Load is used to load Primary and Secondary Images. Image files will
have to be in the X11 bitmap (XBM) format. Whew load is selected the
requester will appear and ask the filename. You will have to remember
whole path and filename, because TIS is not having good file selector.
Keyboard shortcut for Load is 'l'. That means that you can load also by
pressing 'l' key.
Save.
Save is used to save Master Image. Otherwise it works a much like load
function. Keyboard shortcut is 's'.
About.
By selecting 'About' you will get requester with some info about TIS.
Shortcut is 'a'.
Quit.
Select quit when you are going to finish using TIS. TIS will ask you if
you are sure or not. That is the way to reject accidental 'Quits'.
Shortcut is 'q'.
4.2 Tools menu
Pen.
Pen is like pencil or brush. It obeys Modes.
Rectangle.
Rectangle is used to draw rectangles. After you have selected this
tool, you will have to press mouse button in the image. Then you
can move the mouse, still pressing the button. When you have selected
right area you just pull up the mouse button and the rectangle will appear.
Filled rect
is used to draw filled rectangles. It operates as other rectangles.
4.3 Images menu
Master.
This is used to select Master Image to be the current, active image.
Current image will allways appear to the front of window. Note that if image
is very small, you may not even notice that it had been changed, because
old image is not removed. Refreshing may help sometimes.
Shorcut is 'F1'
Primary.
This selects Primary Image to be the current one. 'F2'
Secondary.
This selects Secondary Image to be the current one. 'F3'
4.4 Modes menu
Unite.
This sets unite/paint mode to unite. When unite mode is selected you
are joining Primary and Secondary Images to Master. All tools will obey
unite order. So, when you are for examples painting plots using pen, the
plots will be copied from Primary/Secondary image. Pressing left mouse
button will cause tools to copy from Secondary Image, right button copies
from Primary. This is the original usage of TIS. It may not be easy to
undestand how this actually works. Note that unite is default mode, it is
set when TIS starts.
Paint.
This sets unite/paint mode to paint. When paint mode is selected you
are using black&white pencils. If paint mode is set all tools will obey
it and draw with a color. Left mouse button causes black color, right is
white.
Well, if your X is having some other colors set, then you may have some
other colors.
Paint mode is used if you just want to paint/draw, not to join images.
Area (20x20).
This is one of drawing modes. It causes all the tools to use 20x20
pixels wide filled brush. Shortcut is '1'.
Note that drawing modes are having effect also when uniting/joining images.
Area (5x5).
This is a little smaller brush. 5x5 pixels. Shortcut is '2'.
Grid (10x10|2).
This is a few rarity brush. The size is 10x10 pixels and it paints
every second pixel. '3'
Grid (6x6|3).
This is more fewer brush. '4'
The best way to see what all these different modes are is to try.
Single dots.
This drawing mode draws sigle dots. Shortcut is '5'.
4.5 Region menu
Here are we having standard cut, copy and paste functions. Try these to
find out how they works.
Note that Paste funstion works like the following:
You can place the image by pressing left mouse button. When right place
is selected press right mouse button. 'Change Handle' changes the corner
of the image where mouse cursor is set. It can also be changed by
pressing 'TAB' key.
4.6 Effects menu
Flip, rotate and negative functions are doing exactly what could be
expected. If you for example want to flip a part of image do the
following: Select 'Select' from 'Region' menu and select the area. Now
select 'Copy' from 'Region' menu and 'Flip *' from 'Effects' menu. Then
select 'Paste' from 'Region' menu and place the image somewhere.
4.7 Other menu
Primary->Master copies Primary Image to Master Image.
Secondary->Master copies Secondary Image to Master Image.
Master->Primary copies Master Image to Primary Image.
Master<->Primary swaps places of Master and Primary Images.
Master<->Secondary swaps places of Master and Secondary Images.
Primary<->Secondary swaps places of Primary and Secondary Images.
Image Info views some information about current image.
Set Size is used to set image size.
Set Offset is used to set image offset, the place of the image in the
window. Image offset can also be changed by using cursor keys. Image
offsets are having very important meaning in TIS. Because they are used
to set suitable places for images towards each others. It is important
when uniting, because Images will have to be placed on top of other.
Auto Set is used to automatically set the Image size to fit the window.
Offset Origo sets current Image offset to (0,0).
Auto Resize Window resizes window so that whole Image fits on it.
Keyboard shortcut is 'w'.
Refresh Window refreshes window. Shortcut is 'r'.
5. Keyboard shortcuts
---------------------
Here is the list of all keyboard shortcuts:
l - Load
s - Save
a - About
q - Quit
F1 - Master Image
F2 - Primary Image
F3 - Secondary Image
1 - Set drawing mode to Area (20x20)
2 - Set drawing mode to Area (5x5)
3 - Set drawing mode to Grid (10x10|2)
4 - Set drawing mode to Grid (6x6|3)
5 - Set drawing mode to Single dots
TAB- Changes cut image handler place
w - Auto Resize Window
r - Refresh Window
6. Usage examples.
------------------
Here is some HOWTO usage examples:
HOWTO clear whole image:
Select 'Select all' and 'Clear' from 'Region' menu
HOWTO rotate whole image to the right:
Select 'Select all' and 'Cut' from 'Region' menu. Select 'Rotate right'
from 'Effects' menu and 'Crop to Image' from 'Region' menu.
HOWTO have a kind of undo effect:
Copy Master Image to Primary Image by the times. And when need to undo
copy it back. This is not of course useful if you are having some other
picture in Primary Image.
HOWTO do the famous joining on two pictures:
Let's suppose that you are having two pictures you want to unite. First
is for example picture of monkey's head and other is pic of your faces.
And you are going to put your own faces to the monkeys face. Note that
the faces will have to be in the same size.
Now load the First image in Primary Image and copy it to Master. And
load Other image to Secondary Image. Now move the Secondary Image around
so that the faces are on top of other. It can be checked by changing
between Primary and Secondary Images.
When that is done go to the Master Image. Now if unite mode is set you
can unite images very easily. Select suitable drawing mode, at the
beginning it could be for example Area (20x20) and it can be later changed.
Now you can paint your own face to the monkeys face by using tools
with left mouse button and you can remove changes and paint the moneky
face back by pressing right mouse button.
7. Other things to notify, bugs
-------------------------------
One thing to notify is not to resize window too small. If window is too
small the requesters will not fit on it. It causes that it is for example
impossible to Quit, because the 'Are you sure?' requester will not fit on
the window.
If you run TIS from shell window, TIS will print a lot of debugging and
other info on it.
Note that when you are using TIS requesters, the 'RETURN' key always
means something like 'YES', 'OK' or 'Sure'. 'ESC' key means 'CANCEL' or
'NO I'M NOT' or something like that, it is the negative alternative.
You can of course select the alternatives also by mouse pointer.
There is not any known bugs in TIS. A lot of stupid things is, but not
bugs.
Hessu, Heikki Tienari
hessu@lyseo.otol.fi
