Copyright: (C)Copyright 1995, HYuu


WSVC Help

(C) Copyright HYuu, 1995

Translated by Hitoshi Ozawa

KISS CEL/Palette development tool conforming to KISS/GS .

Creates CEL data from BMP images surrounded by rectangles.

Introduction

Using WSVC

File Menu

Edit Menu

Options Menu

Help Menu

Using a Mouse

Miscellaneous

Support

Distribution

Copyright

GS Manual


Introduction

If don't know what KISS is, but have down-loaded WSVC, put WSVC aside for a while and download WKISS and some KISS data now. Play with it for a while and turn back to WSVC when you feel an urge to make some of your own KISS data.

KISS programs and data are available from: http://www.bekkoame.or.jp/~h_ozawa/

Features

Creates CEL and KCF files conforming to KISS/GS from 16 palette MAG and 16 or 256 palette BMP files.

- Supports CEL grouping, size fixation, margin optimization, and position offset.

- Able to name CEL filenames while viewing drawings.

- Able to save CEL filenames for each drawings to ease CEL modifications.

WSVC creates CEL files and palette file from each image surrounded by a rectangle.

Using WSVC


Using WSVC

First, draw some picture using your favorite painting tool such as PaintBrush.

Next, create KISS CEL and palette files using the following technique.

1.Open the original drawing

-Drawing the original drawing

-Graphics format supported by WSVC

2.Specify how to make CEL and palette files

-Specify grouped CELs

-Specify CEL file name andpalette file name

-Specify directory to create files.

3.Make CEL and palette files

-Created files

Lastly, create a CNF file using a text editor. Refer to saving data section for example on writing a CNF file.

For a complete manual, refer to KISS/GS manual


File

Open

Open a WSC file.

Read WSC file

Read CEL information from an attribute file.

Write WSC file

Save CEL name information to WSC file.

Read SVCEL file

Read CEL information from SVCEL.

Make All...

Create CEL file and Palette file. Perform similar operation as in Palette dialog box.

Make This CEL

Create CEL files for selected items.

Make Palette

Create color palette file (*.KCF).

Exit

Close WSVC window and exit WSVC program.


Edit

Paste

Read graphic data from the clipboard.

Shift Right

Move all files after the selected file 1 place to the right. Used to insert new file.

Shift Left

Move all files after the selected file 1 place to the left. Used to delete selected file.

Left Top Dot

Read graphic data created by SVCEL.

CEL Name

Open CEL definition dialog box corresponding to the selected graphical item. Used to specify File name, Directory, and Size option.

This dialog box may also be opened by double-clicking the graphical item with a mouse.

Color Palette Name

Open Palette Definition dialog box. Used to specify whether to create palette file, File name, and Directory.

If is possible to directly create CEL files from this dialog box.

This dialog box may also be opened by double-clicking anywhere within the client area beside the graphical items.

Save Options

Open Save Options dialog box. Do not alter these setting while you are not familar with KISS and WSVC.


Options

Redisplay

Redisplay client area so client area becomes same as the drawing.

Display CEL Name

Display CEL file name at lower left corner of the CEL.

AutoResize

Auto-resize client area when opening a graphical drawing.


Help

Data Information

Open CEL file information dialog box.

To assist writing CNF file, it is possible to copy CEL file names to the clipboard.

Contents

Display this help file.

About

Display current WSVC version.


Miscellaneous

Acknowledgements

I want to thank everybody at KISS CUG at Local Line YonaYona network for giving me valuable suggestions. I especially want to thank RERE for giving me valuable suggestions and bug reports without which this software would not have been possible. I also want to thank Bakuretu Ken for drawing an icon for WSVC and OKA for providing codes to open MAG files.

Furthermore, I want to thank mio.h, the original developer of KISS and SVCEL, and F.K., the developer of WKISS, and all other developers who have made KISS viewers and tools and all authors who have made KISS data.

Finally, I want to thank you for down-loading this file.

Development

Japanese NEC PC-9821As + MS-Windows + BC++ 4.0J + HelpCard 94.11


Attribute File (*.WSC)

Attribute File

For each drawing, CEL and palette file names are saved to a different file. This file is created in the same directory as the drawing with the same file name and with a WSC extension.

When a drawing a re-opened, corresponding WSC file is also opened to read in defined drawing attributes.

To not save attributes, turn it off from the Options menu.

Finally, attributes will not be copied to the Clipboard. All attribute information will be lost by a cut and pasted operation.


Graphics Format Supported by WSVC

Supported Graphic Format

Following graphic format files may be opened:

-16 palette (4bit) MAG file(*.MAG)

-16 palette (4 bit) and 256 palette (8 bit) uncompressed bitmap file (*.BMP).

Size is limited to 2048 x 2048 and number of items is limited to 256 items.

Edge of the drawing should all be of the same color. This color will be used as a transparent color.

Drawing is checked for any errors when it is opened. If there is any error, error message will appear in the title bar with coordinates where error occured. In such a case, check to make sure that there are not extraneous dots and to make sure that all rectangles surrounding items are properly drawn.

Drawing Graphic Items

CEL Grouping


Files Created by WSVC

CEL and palette files conforming to KISS/GS are created by WSVC. CEL files are created with an CEL extension and palette files are created with an KCF extension. These extensions may not be changed from WSVC.

CEL files are created with the same bitmap pattern as the original drawing with 4 bit/pixel (16 colors) or 8 bit/pixel (256 colors).

Palette files are created in 12bit/color (4096 colors) or 24bit/color (16,777,216 colors) depending on the  setting.

Number of colors are set by default to number of colors the original drawing is set to. To save in a different number of colors, refer to the Options section.

After generating CEL and palette files, use WCEL to view them.

WARNING:

Current version of WSVC is only capable of producing only 1 palette group. It is necessary to use a different tool to create multiple palette group file.


Drawing the Original Drawing

One color may be specified as a transparent color in KISS. It is recommended to make the first color in the palette (ie. 0th color) this transparent color.

First, draw a picture using some drawing tool. Color the background in a color defined as transparent.

Secondly, draw rectangles with 1 pixel width around each item in the picture using a non-transparent color. This rectangle will not appear in the produced CEL data and rectangles may be in any color as long as it is not a one specified as transparent. Be sure not to overlap these rectangles and to allow an one pixel buffer between the rectangle and the drawing within. WSVC will trim extra margins off from the drawings, so it is recommended to make rectangles larger than the drawing within it.

KISS allows several items to be moved together to create a perception of depth. Clothes usually are displayed in front of a body, but collar on a shirt should be behind a neck. To create a 3 dimensional effect, a collar should move with a shirt. A set of items such as these that should move together are called as an object. It is possible to create objects with even 3 items. Specification to group items are explained in the CNF section.

Items in a object must be created carefully to match exactly or it would not look good. There are 2 methods to creating these objects - using fixed sized CELs and using grouped CELs .

Fixed size CELs are items whose margins are not trimmed. Therefore, the location of the drawing from the top left corner may be matched to match items.

Grouped CELs are created copying the original picture and definining how the original picture is to be divided into parts. Refer to (using grouped CELs) for further details.

After surrounding each item with a rectangle, make CNF and palette files.

Finally, write a CNF file and use WKISS to adjust each object to their default position.

Files format supported by WSVC

Grouped CEL


Grouped CELs

Grouped CELs is a method to separate a drawing into several independent CEL files by creating a template on how it is to be separated. Refer to making a grouped CELs for details on making them.

To use Grouped CELS, it is necessary to copy the item that is to be separated in the original drawing preferably to the right of it. Color the right copy so each part that is to be separated is in a different color. Open this drawing from WSVC and press the right mouse button on the left drawing the move the mouse pointer to the right drawing while pressing the button. A line is drawn between the two drawings to show that they have been linked. The original drawing will have a black circle at the end of the line.

To resolve the link, double click the right mouse button in the original drawing.

Making grouped CELs

Naming files

Palette files


Save Options

WSC files are created for each drawing. It is also created when CEL files are created.

Offset (fixed size)

Generate a CEL file in the size of the rectangular square surrounding the picture. It is recommended to have this option unchecked to save memory and hard disk spaces.

Clip lower and right edges

Clip the bottom and right margins off the picture. It is recommended to leave this option checked.

Replace transparent color

KISS uses the first (0th) color in the palette file as a transparent color. However, WSVC uses the color of the (0,0) pixel as a transparent color. Check this option to exchange the (0,0) color in the palette with the 0th color.

Auto-process upper left dot

Recognize upper left corner dot. This option is irrevalent to KISS users not previously using SVCEL on Japanese NEC 98 series computer.

Palette file (*.KCF) conversion

KISS/GS support 12bit (4096 colors) and 24bit (16,777,216colors). Select one of the following options to define how many colors the generated CNF files are to have.

Save as 24bit/pixel when screen supports 8bit color

Select this option to automatically make WSVC select which mode to generate CNF file in.

Always save in 24bit/pixel

Select this option to generate CNF files in 24bit/pixel. Select this option if you don't know which option to choose.

Always save in 12bit/pixel

Select this option to generate CNF files 12bit/pixel. If the original picture is in 24bit/colors, selecting this option might not make the CNF file properly.

Change total color

Change the total number of colors in the palette file. Check this option only when creating a palette file that is not either 16 colors or 256 colors. For example, to creat a 64 background file, 128 body file, 16 color clothes file.


CEL File Name

CEL File Name dialog box

CEL files are automatically named by WSVC. However, it is recommended to change these name to make them more understandable.

To change CEL file name, double-click the item of use TAB/Shift + TAB/arrow keys to highlight the graphical item and press the [Enter] key.

A CEL file dialog box will appear. Enter the necessary information.

It is possible to display CEL file name next to the item.

CEL File Name

Specify CEL file name. Do not enter any file extensions. They are appended by the WSVC program.

Offset (fixed size)

When checked, calculate offset margin from the upper right corner of the rectangle.

Check this box to fix item size of a CEL.

To save disk space and reduce memory usage, keep this option unchecked unless it is really needed.

Clip lower and right edges

Clip bottom and right edges. Checked by default to reduce file size.

Only uncheck this option on items that are to have special attributes such as location fixation.

Create this CEL

Create CEL file only for the selected item.

Directory

Specify a directory to create and save files.

Palette File Name


Color Palette Name

Palette File dialog box

Palette File File dialog box is opened by double-clicking a mouse at an drawing area not covered by a CEL item.

Palette File Name

Palette file name excluding the file extension. KCF file extension is automatically appended to every file.

Create Palette File

When checked, palette file is created when CEL files are created.

Save Options

Open Save Options dialog box.

Create Palette Files

Create only a palette file.

Create CEL Files

Create CEL and palette files. CEL and palette files may also be created from File menu.

Directory

Specify a directory to create files.

CEL File Name


Directory Where Files are Saved

WSVC creates and saves all files in the same directory. This directory may be specified from the CEL or Palette options dialog box.

Be sure to check this parameter to find where files are going to be generated before actually generating any files. If will be much more troublesome to weed files out from other files later.

Generated Files


Upper Left Corner Dot

When a dot is drawn 1 pixel to the right of the upper left hand corner:

1. Recoginize picture as a fixed size cell and will not clip margins.

2. Link CNF files.

3. Make fixed size dot transparent.


Making Grouped CELs

Grouped CELs is a method of making several CELs that form an object (items that move together) from a drawing and its patten template.

It make grouped CELs, it is necessary to first make an original drawing and a pattern template on how this drawing should be cut.

Second, a file containing these 2 drawings must be opened from WSVC and linked. To link these 2 drawing, press the right mouse button on the original drawing and drag the mouse to the pattern template drawing. A line showing that the link has been established should appear.

When CEL files are created, the original drawing is cut into several different pieces according to the pattern template. Furthermore, margins of each CEL representing a piece will be trimmed to reduce necessary file and memory space. To compensate for these trimming, a margin offset each defined for each pieces so they overlap properly.

Example:

The picture to the right contains an original drawing of a dress and its pattern template. Transparent color is defined as light blue in this drawing.

After opening this drawing from WSVC, it is necessary to link these 2 pictures by pressing the right mouse button on the left picture and moving the mouse to the right picture. A line should be drawn between these 2 pictures. When CEL files are created from this drawing, 6 different CEL files are created. They correspond to 6 different colors used in the pattern template drawing.

 - light blue	(underside of the dress)

 - green	(left sleeve)

 - red	(main dress)

 - yellow	(collars)

 - dark green	(inside left sleeve)

 - dark yellow	(inside collars)

CEL files are named based on the name provided specified in the original item. If the original CEL name is named NAME, generated CEL files are named NAME.CEL, NAME_.CEL, NAME2.CEL, NAME3.CEL, ..., NAME9.CEL. If the original item is assigned a 8 character CEL name or when there are more than 11 generated CEL data, error message will appear and CEL files will not be created. Please rename the original item to have few characters in the CEL name.

CEL files are generated in order of system color paletter order that are used in the pattern template. Therefore, red part are generated before light blue which are generated before dark blue. However, background color is moved to the front of the order.

Finally, it is possible to set an picture both as grouped CELs and as a fixed size CEL.

Grouped CELs


Fixing the CEL size

Fixed Size CELs

To fix the size of a picture:

 1. Open the CEL dialog box

 2. Check Offset

CEL sizes are fixed to make them overlap nicely with other CELs. Grouped CELs, which is supported by WSVC is actually a nicer and better method to create overlapping CELs.

However, to create an animation kind of effect between sets, it is sometimes better to fix the size of a CEL.

Lastly, it is possible to fix size of CELs that are grouped.


Using a Mouse

Left Click

Select the picture underneath the mouse pointer.

Left Double Click

Open CEL dialog box if the mouse pointer is within a rectangular picture area. If it is outside, palette dialog box is opened.

CEL dialog box will not open if a picture is a pattern template for a grouped CEL. CEL specifications may only be entered in the actual picture.

Left Drag

Exchange picture attributes. Press the left mouse button on a picture and release it at on a different picture. Picture attributes are  between these 2 pictures.

It is often used after inserting or deleting a picture to preserve layout.

Right Double Click

Unlink grouped CELs. Click the right mouse button twice on an original picture of a grouped CELs to ungroup it.

Right Drag

If the Shift key is not pressed, pictures are grouped. Press the right mouse button on the original picture and move and release the button of the pattern template picture. A line appears between there two pictures to show that they have been grouped.

If the Shift key is pressed while the Right mouse is pressed, CEL name is changed in the following order:

If the original picture is named HAT, the next picture is named HAT_, HAT2, ...,HAT9,HAT0,...

(Please don't ask me what this naming is useful for.) :)


KISS Data
Many KISS data are uploaded onto a local private personal computer networks. They are also available from the KISS Home Page on the internet: http://www.bekkoame.or.jp/~h_ozawa/kiss.html

After playing with a KISS data, please mail comments and suggestions to its author. They are eagerly waiting to hearing from you. They would become very encourage and might develop more data.


WKISS
You already have a WKISS viewer for KISS data, haven't you? If you haven't, download it right away. It is available from http://www.bekkoame.or.jp/~h_ozawa/kiss.html

WKISS is a KISS viewer for MS-Windows systems that was developed by F.K.. Please thank him for making it a freeware for all of us to use and enjoy.


What is KISS?
KISS is a 2.5 dimensional graphics program to play doll cloth changing on a personal computer. Their are many fans who collects KISS data. Please be warned that it is very catching.

The original KISS program run only on Japanese NEC PC9801 personal computers, but there are now viewers for MS-Windows, Sharp X68K, Fujitsu FM-Towns, Macintosh, DOS/V, X-Window, and Amiga.

An English KISS viewer, WKISS is now available for MS-Windows system. Developers are encouraged to write their own tools for KISS.


CEL File (*.CEL)
Contains pixel color information for an item. CEL files have an CEL file extension.


Palette File (*.KCF)
Contains color palette information. Maximum of 10 settings may be defined within each palette file. Palette file have an KCF extension.


ICON
Hi there. I'm HYuu, the developer of WSVC. Thank you for downloading WSVC.

I hope that you'll make many KISS data using this tool for all of us to enjoy.

I especially recommend using the CEL grouping to create neat data. :)


KISS/GS
Ever since it was released, KISS has been ported to many different platforms. To maintain

data interoperativity between these various platforms, KISS/GS has been defined.

Most KISS viewers and tools, now, conform to this specification.

256 color palette, margin offset, and multipalette files that were added when the specification was

announced. WSVC is a KISS tool conforming to KISS/GS v1.00. All CEL and KCF files created by WSVC

are in KISS/GS format.

For further information, refer to  KISS/GS manual.


KISS General Specification
Abbreviation of KISS General Specification.


KISekae Set system
KISS is an abbreviation of KISekae Set system - doll cloth changing system.


SVCEL
SVCEL is a KISS data construction tool for Japanese NEC PC98 series personal computer.

It was developed by the original developer of KISS, mio.h.


File Name Conventions
File should be named in conformance with the KISS/GS. It should consist of at most 8 character name + 3 character extension. Character should be within  [_0-9a-z] with no distinction between upper and lower case characters.

WSVC is accept other characters, but please do not use them. File name with characters outside this range may not be capable of being viewed on some platforms.

WSVC will automatically add CEL and KCF extensions to CEL data file names and palette file names respectively.


c1


c2


c3


c4


c5


c6


k
 Actually, it is not strictly necessary to outline all groups and it is also permissible to let some lines enter into the transparent areas. The drawing to the right produces same CEL files eventhough it has some extra drawing around the drawing.


Support

  Support for  WSVC is provided by E-mail. If you have any question, opinion, suggestions, or any other comments, please send an E-mail to:

Japanese support and all comments and suggestions:

HYuu

YEN0635 Local Line YonaYona

kis00283 / KISSin'BBS

VFE06123@niftyserve.or.jp

English support:

Hitoshi Ozawa

h_ozawa@bekkoame.or.jp


Distribution

  WSVC may be freely distributed if the following conditions are obeyed:

1. If it is to be copied to another forum or to another distribution

   channel, please contact the developer to let us know exactly

   where it is to be copied.  We will need this information to

   maintain and upgrade WSVC at all locations.

2. This program can be distributed only in the original archived

   WSVC011.LZH formatted file.  Do not change this file or any files

   within.

3. Please make it apparent that WSVC is a FREE  SOFTWARE.

              It is necessary to state this in the program description.

4. If this program is to be mentioned in any article, please send

   an E-mail to one of the developers.

  If it is going to be distributed in any other ways (e.g. CD-ROM), please contact the developer.  The developer is willing to discuss other means of distribution.


Copyright

  Files contained within WSVC is copyrighted by each individual authors.  No part of this program or data may be reproduced, in any form or by any means, without a written permission from each authors.

  KISS is copyrighted by K.O.S.(Kawaii Onnanoko System)

  Microsoft is a registered trademark and Windows is a trademark of Microsoft Corporation in the United States of America and other countries. Other brand and product names are trademarks or registered trademarks of their respective holders.