========================================================================
Ladybug 1.00 for Windows95 Demo
========================================================================
What is New?
1. The newest Ladybug 1.00 for Windows95 Demo includes
some minor revision. The old upload version in the CICA FTP site
did no include the CW32.DLL and WING32.DLL now it is included.

2. The SaveAs can be used to save a MPEG file after playback
with the Netscape.

=======================================================================
Agreement of Using Ladybug 1.00 for Windows95 Demo.

This is the agreement about Ladybug 1.00 for Windows95 Demo 
between you (user) and Neat Software Company.

This is the demo program of Ladybug 1.00 for Windows. 
There are limited MPEG files to playback. You can test it for 
preview purpose. You can free copy and redistribute this Demo 
program but you can not sale it for any commericial purpose
withour written permition. You can only redistribute this
software in original form. This software remains a confidential
trade secret of Neat Software. Any attempts to modify, decompile,
disassemble or reverse engineer this software are not allowed. 

If you do not agree this agreement please do not use this
Demo software.

========================================================================
1. Introduction
========================================================================
MPEG means "Moving Picture Experts Group". This group is working under 
the direction of the International Standards Organization (ISO) for the 
standards of compressed motion pictures and associated audio. MPEG-1 
had been completed in Oct. 92 known as International Standard ISO-11172.

Ladybug 1.00 is a software implementation of MPEG-1 decoder without 
audio associated. It works from reading a .mpg file and then decoding
the code with Huffman decode algorithm, IDCT (Inverse Discrete Cosine
Transform), Motion Compensition for P (Predicated) and B (Bidirectional)
frames, and Halftone algorithms.

Ladybug 1.00 Properties:

Object-Oriented Software System
Friendly Graphic Uesr Interface (GUI)
View MPEG File In Variable Window Size
Used as a MPEG Viewer on Internet with a WWW browser
Decode full MPEG-1 video frame types (all I, P, B frames) 
Graphics Accelerator with WinG in Windows 3.1
32bit Optimization Code For x86 Processor

========================================================================
2. Architecture
========================================================================
Ladybug is designed as an envolution software system that is
portable to many platforms. There are several releases of
Ladybug target at different markets. Network version is
optimized for Internet access. It can connected with a WWW
borwser such as Mosic and Netscape to view the MPEG video
clips through Internet. CDROM version is optimized for CD-ROM
access. It includes some interactive and index fundtions.
It is a basic tool to play titles and games on the CD-ROM.

This release is the Network version of the Ladybug 1.00 for Windows.

Ladybug Architecture
-----------------------------------------------------------------------
USER            CD-ROM titles, Games, Network Browser, Education
SYSTEM		Windows95/NT, Windows 3.1 + Win32s + WinG
ARCHITECTURE	Object-Oriented System, Graphic User Interface
                Graphic Acceleration
MICRO-STRUCTURE	Video --> GOP --> Picture --> Slice --> Microblock 
                --> Block->Huffman --> IDCT-->Bit Stream

========================================================================
3. Object Oriented User Interface
========================================================================
Ladybug is an object-oriented MPEG player. Users view the mpeg
object through a window objcet and select the demanded commands
or operations by menu, button, and dialog box. The mouse and
keyboard are the main pointer devices. After running the ladybug,
a window object is displayed on the screen. It includes

<System menu> can be used to close the object and resize the window.
<Title bar> shows the name of the .mpg file object. When there
        are no open files, the window display "Ladybug for MPEG".
        Users can point at the title bar and drag the window to
        relocate.
<Client area> shows the animation of a MPEG object. It is also an
        interactive area that users can active a pop-up menu to
        operate on the object.
<Menus> are a common way of presenting commands in an interface.
        There are a list of <items> in a menu that represent the
        commands. In the Ladybug pop-up menu is the efficient
        interactive tools to view and command an object. In this
        way Ladybug demonstrates the principle of display on demand.
        Pop-up menu is displayed at the current location of the mouse
        cursor, this eleminates the need to navigate the mouse to
        get commands. It also saves the screen space.

When clicking the client area of the Ladybug window with the right
mouse button, a pop-up menu is displayed. On the down transition
of the right button, the MPEG object is identified. On the up the
menu is displayed to the center and below the cursor location of
the mouse. The menu items in the pop-up menu of the Ladybug are
always connected to the MPEG object.

========================================================================
4. Requirements
========================================================================
Hardware Environment Requirements
Machine        		Minimum 386sx, 
			Better for 486DX, DX2, DX4, 
			Best for Pentium, K86
Memory         		4 MByte memory above                  
Harddisk       		5 MByte free space available                        
Video Card              SVGA or higher with 256 or 16.7 millions colors
			The best picture quality is for 800x600
                        or 1024x768 256 colors
                                                      
Software Environment Requirements
Windows 3.1/Win3.11	win32s 1.20 and WinG 1.0 is required.
Windows NT/Windows95  win32s is not needed. 

========================================================================
5. Installation
========================================================================
It is very easy to install on Windows95.
1.  Get Ladybug file
        In DOS prompt:          C:>
	Make a sub-directory:	C:>md c:\ladybug
        Copy ladybug.zip:       C:>copy a:\ladybug.zip  c:\ladybug
				or Download from Network to c:\ladybug
	Uncompress:		C:>pkunzip ladybug.zip                         
2. Install
        In DOS prompt           C:>install                                                  
3. Test
        In Windos95:            Double Click ladybug.exe to begin

Notes:
The Ladybug 1.00 for Windows95 Demo can only play MPEG files
less than 800KB and some special files. The special files can
be retrived with Netscape or Mosic by open the local file demo.htm.
These files are very nice MPEG movies on the Internet. Your Netscape
or Mosaic browser should set the .mpg browser function.  

Tips:
------------------------------------------------------------------------
Set your Display in 800*600 or 1024*768, 256 colors model for high
        quality video.
Run Ladybug for Windows95 on Pentium will show best performance.
Try resize the window in every size or check double window
Try to use Ladybug 1.00 for Windows95 with Netscape or Mosaic.
Try to run 3 or 4 Ladybugs to demostrate the multitask in Windows95

========================================================================
6. Playback
========================================================================
Playback with Disk or CD-ROM File

Click the Ladybug 1.00 Shortcut or Run ladybug.exe a initial
window is displayed. Click RIGHT MOUSE BUTTON in the area of
the initial window, there is a floating popup menu appeared.
There are several menu items on the popup menu.


Command		Action

Open            to open a .mpg file select a .mpg file from a file
                list box
SaveAs          to save the MPEG file.
Play            to play a opened .mpg file if you press the right                
                button of the mouse the player will pause and display            
                the popup menu. If you select the Stop item, when 
                you press the left button of the mouse, the player will                  
                stop, otherwise the player will continue.
Step            to play forward step by step.
Stop            to stop the palyer.
Options         to make the choice of a checklist you could choice 2                     
                times image and so on.
Infomation?     to display ladybug information when you finish a                         
                .mpg play. You could read the timing result and the rate 
                of frames per second. Clicking the Help button you can           
                read online help file.
Exit            to exit the Ladybug


While you are playing if you press right mouse button down, the
popup menu appeared and the player pause. When you press left
mouse button again without choice any items, the playing procedure
continue. If you select stop item, the Ladybug shows the demo window
and stop.

Playback With A WWW Browser

MIME (Multipurpose Internet Mail Extensions) is a method to organize
file types. Mosaic and Netscape can not handle all the MIME file
types internally. So you need external viewers to associate some
MIME files and read them.

Name				MIME TYPE
---------------------------------------------------------------------
HTML				.html
Compressed File			.zip
Rich Text Format                .rtf
PostScript 			.ps
MPEG				.mpg or .mpeg
JPEG				.jpg
Word Doc			.doc
Audio				.au or aiff

In the Mosaic:
---------------------------------------------------------------------
You need a external viewer and associate these file types to
an application in the MOSAIC.INI file. When active a file
Mosaic will invoke the viewer.

Edit the MOSAIC.INI
In the [Viewers] section of the MOSAIC.INI file add

	TYPE1023="video/mpeg"
	
where we set n=1023 make sure it is a unique integer.

	video/mpeg="c:\ladybug\ladybug.exe %ls"

c:\ladybug is the directory where the ladybug.exe is in.

In the [Suffixes] section define the file type extensions. 

	video/mpeg=.mpeg, .mpg

Save the MOSAIC.INI file and restart the mosaic.

In the Netscape:
------------------------------------------------------------------------
Start Netscape, choose Options|Preferences item. Push the
first button with panel (default is Styles), select the item
Helper Applications. To have Netscape start an external viewer,
select the Mime Type in the list, then choose the radio button
Launch Application. Choose ladybug.exe as the .mpg external viewer.

========================================================================
7. Copyright
========================================================================
Neat Software Company owns the copyright of Ladybug 1.00 for
Windows. It is co in the United States in 

Ladybug 1.00 for Windows/Windows95  is a motion video (MPEG)
player running on Windows 3.1./NT/Windows95. It is a commercial
version of the Ladybug, including technical support from Neat
Software Company. Ladybug 1.00 is protected by the copyright
law in the United States from 1994. The software in source code
form remains a confidential trade secret of Neat Software.
Any attempts to decompile, disassemble or reverse engineer this
software are not allowed. 

Windows 3.1, Win32s, WinG, Windows95, Wnidows NT are trade 
marks of Microsoft Corp. Pentium is the trade mark of Intel Corp.
Mosaic is the trade mark of NCSA. Netscape is the trade mark of the 
Netscape communication.

========================================================================
8. Contact
========================================================================
Neat Software Co.			Tel: (204)269-3593			
616 Townsend Ave.                       Fax: (204)269-3593
Winnipeg, Manitoba R3T 2V2	
Canada
Attn: Chang LI		

Email: changl@cs.umanitoba.ca
WWW: http://www.cs.umanitoba.ca/~changl/neat/neat.html

Have fun with Ladybug 1.00 for Windows95.