Release Notes for the Microsoft MediaView Software and Title Development Toolkit

  Introduction to MediaView Toolkit

  Installing the MediaView Toolkit

  Listing of All MediaView Toolkit Files

  Known Problems with MediaView


Introduction to Microsoft MediaView Toolkit

Welcome to the the Microsoft MediaView Software and Title Development Toolkit.

What's in the Toolkit:

  Windows 3.1-based versions of the MediaView libraries

  MediaView compiler

  Samples, including:

  MediaView Browser with C source (in the \SAMPLE\C directory) and Visual Basic source (in the \SAMPLE\VB directory)

  Sample multimedia title (in the \SAMPLE\USA directory)

  Sample word breaker, embedded window DLL, and setup files (in the \WORDBRKR, \EWSAMP, and \SETUP sudirectories of the \SAMPLE directory)

  Documentation on how to develop a MediaView title player application and how to author a MediaView title. (Note the online documentation includes a comparison of MediaView with Viewer 2.0.)

What's not in the Toolkit:

  Windows NT-based versions of the MediaView library files or tools

  Macintosh-based versions of the MediaView library files or tools

  The MediaView files have not been tested under Chicago.


Installing the MediaView Toolkit

To install the kit, launch the MSDN Tools Setup program and choose "MediaView Toolkit" from the Tools List.

The setup program will create the an MV12KIT directory on your hard drive and requires you to change your \include and \bin paths to include the appropriate MediaView toolkit directories. This setup program also requires that you set your path to include the \mv12kit\bin directory to use the sample browser and online documentation.

Note for Users of the Beta   If you already have the beta version of the kit installed, and plan to install the final version of the kit in the same directory that you used for the beta, remove all of the beta files and directories before installing the final version. Otherwise, Setup may not install the final version correctly over existing beta files.


Listing of All MediaView Toolkit Files

Here is a list of all files included in the MediaView kit installation.

File	Description
*.BMP	Bitmaps
*.CUR	Cursors
*.ICO	Icons
*.M12	Compiled MediaView Title
*.MVP	Title project file
*.STP	Stop word table
*.WAV	Standard sound file
*.AVI	Standard video file
*.SHG	SHED file, bitmap containing one or more hotspots
*.DIB	Device independent bitmap
*.RTF	Rich Text format file containing title text sources
MAKEFILE.	Makefile
SETUP.EXE	Setup file
SETUP.INF	Setup file
SETUP.LST	Setup file
MEDV12.DLL	MediaView DLL, handles topic layout, rendering and navigation.
MVBRKR12.DLL	MediaView DLL, controls word breaking for searching and indexing code.
MVDIB12.DLL	MediaView DLL, displays pictures in topics.
MVFS12.DLL	MediaView DLL, file system.
MVINDX12.DLL	MediaView DLL, indexes every word in a title.
MVMCI12.DLL	MediaView DLL, controls topics audio, video, etc.
MVSRCH12.DLL	MediaView DLL, used to search a title for topics containing specific words.
MVTTL12.DLL	MediaView DLL, used to obtain title information.
WMVC12.EXE	MediaView compiler
WMVC12.HLP	Help file for MediaView compiler
MVKIT.M12	MediaView kit docmentation in MediaView format
MVDOC.EXE	View for MVKIT.M12, this is a copy of MVUI.EXE
README.HLP	Contains last minute changes and information
LIB\MEDV12.LIB	Library file to be used when linking in corresponding Dynamic Link Library
LIB\MVBRKR12.LIB	Library file to be used when linking in corresponding Dynamic Link Library
LIB\MVDIB12.LIB	Library file to be used when linking in corresponding Dynamic Link Library
LIB\MVFS12.LIB	Library file to be used when linking in corresponding Dynamic Link Library
LIB\MVINDX12.LIB	Library file to be used when linking in corresponding Dynamic Link Library
LIB\MVMCI12.LIB	Library file to be used when linking in corresponding Dynamic Link Library
LIB\MVSRCH12.LIB	Library file to be used when linking in corresponding Dynamic Link Library
LIB\MVTTL12.LIB	Library file to be used when linking in corresponding Dynamic Link Library
SLIB\MEDV12.LIB	Static link library to be used in place of corresponding Dynamic Link Library
SLIB\MVDIB12.LIB	Static link library to be used in place of corresponding Dynamic Link Library
SLIB\MVINDX12.LIB	Static link library to be used in place of corresponding Dynamic Link Library
SLIB\MVMCI12.LIB	Static link library to be used in place of corresponding Dynamic Link Library
SLIB\MVSRCH12.LIB	Static link library to be used in place of corresponding Dynamic Link Library
SLIB\MVTTL12.LIB	Static link library to be used in place of corresponding Dynamic Link Library
MEDV12.H	Header file for MEDV12 library
MEDV12.RC	Resource file containing strings for MEDV12 library
MVDIB12.H	Header file for MVDIB12 library
MVDIB12.RC	Resource file containing strings for MVDIB12 library
MVERROR.H	Defines constants used as error codes
MVEW12.H	Header file for MediaView embedded Window DLL handling
MVMCI12.H	Header file for MVMCI12 library
MVMCI12.RC	Resource file containing strings for MVMCI12 library
MVTTL12.H	Header file for MVTTL12 library
MVTTL12.RC	Resource file containing strings for MVTTL12 library
CTL3D.H	Header file for 3D controls
CTL3D32S.LIB	32 bit static link library for 3D controls
CTL3DS.LIB	Static link library for 3D controls
MV.C	Sample C application source code
MVUI.C	Sample C application source code
MVUI.DEF	Sample C application source code
MVUI.EXE	Compiled and linked sample C application
MVUI.H	Sample C application header source code
MVUI.MAK	Sample C application make file
MVUI.RC	Sample C application resource file
PANE.C	Sample C application source code
PANE.H	Sample C application header source code
PROTO.H	Sample C application header source code
NULL.TMP	Temporary file used by make for creating header prototypes
RESOURCE.H	Sample C application header source code
RESRC1.H	Sample C application header source code
VIEW.C	Sample C application source code
VIEW.H	Sample C application header source code
LIBENTRY.OBJ	Embedded window sample, this is a standard init OBJ for DLLs, contains LibMain and WEP.
MVSAMPEW.C	Embedded window sample source code
MVSAMPEW.DEF	Embedded window sample source code def file
MVSAMPEW.DLL	Embedded window sample source code compiled to a DLL
MVSAMPEW.MAK	Embedded window sample source code make file
VFWDIB.C	Embedded window sample source code
VFWDIB.DEF	Embedded window sample source code def file
VFWDIB.DLL	Embedded window sample source code compiled to a DLL
VFWDIB.H	Embedded window sample source code header file
VFWDIB.MAK	Embedded window sample source code make file
USA.OPR	Sample title source file, operator replacement table
SOURCES.M12	Sample compiled title containing RTF sources
USA.M12	Sample compiled title
ALIAS.TXT	Sample alias definition
ANSIUSA.TBL	Sample character table
USA.MVX	Copy of project file to be loaded as baggage for group & group index information
CMDIALOG.VBX	Common dialog Visual Basic extension
VIEWMV.EXE	Visual Basic sample application
MEDVIEW.VBX	MediaView Visual Basic extension
THREED.VBX	Visual Basic extension
MVVBHELP.DLL	MediaView/Visual Basic help file
COMMDLG.DLL	Common dialog control DLL
CTL3D.DLL	3D control DLL
DEFINE.FRM	Visual Basic sample application form
MODULE1.BAS	Visual Basic sample application
ABOUT.FRM	Visual Basic sample application form
CHARS.FRM	Visual Basic sample application form
HISTORY.FRM	Visual Basic sample application form
MAGNIFY.FRM	Visual Basic sample application form
MAIN.FRM	Visual Basic sample application form
MARK.FRM	Visual Basic sample application form
PRINT.FRM	Visual Basic sample application form
RESULTS.FRM	Visual Basic sample application form
SEARCH.FRM	Visual Basic sample application form
TEMPTEXT.FRM	Visual Basic sample application form
MAIN.FRX	Visual Basic sample application compiled form
RESULTS.FRX	Visual Basic sample application compiled form
MAKE.MAK	Visual Basic sample application make file
CONSTANT.TXT	Visual Basic global constant file
INDEX.FRM	Visual Basic sample application form
KEYWORD.FRM	Visual Basic sample application form
KEYWORD.FRX	Visual Basic sample application compiled form
MORE.FRM	Visual Basic sample application form
MORE.FRX	Visual Basic sample application compiled form
MVVBHELP.C	Visual Basic sample application help DLL source code
MVVBHELP.DEF	Visual Basic sample application help DLL def file
MVVBHELP.MAK	Visual Basic sample application help DLL make file
MAKEFILE.VCW	Visual C++ workbench file
MSVC.PDB	Visual C++ workbench file
MVBRKR.H	Breaker sample header source code
PARTBRKR.C	Breaker sample source code
PARTBRKR.DEF	Breaker sample def file
PARTBRKR.DLL	Breaker sample source code, compiled as a DLL
PARTBRKR.H	Breaker sample header file
PARTBRKR.LIB	Library link file
PARTBRKR.MAK	Breaker sample make file
PARTBRKR.MAP	Breaker sample map file
PARTBRKR.OBJ	Breaker sample compiled source code
PARTBRKR.PDB	Visual C++ workbench file
PARTBRKR.VCW	Visual C++ workbench file
PARTBRKR.WSP	Visual C++ workbench file
BRKRTEST.MVP	Breaker sample title project file
BRKRTEST.RTF	Breaker sample title Rich Text Format source
MSCUISTF.DLL	Setup file
MSDETSTF.DL_	Setup file
MSINSSTF.DL_	Setup file
MSSHLSTF.DL_	Setup file
MSUILSTF.DL_	Setup file
_MSTEST.EX_	Setup file
MSDETECT.IN_	Setup file
SETUPAPI.IN_	Setup file
VER.DLL	Setup file
MSCOMSTF.DL_	Setup file
SETUP.MST	Setup file
MVIEW.DOT	Word template for creating MediaView RTF files


Known Problems with MediaView

Known problems within the MediaView Software and Title Development Kit as of 09/02/94. Following are descriptions of known bugs for:

  Tool Kit

  MediaView Compiler

  Sample Title (USA.M12)

  Sample Title Player - C-Language Version (MVUI.EXE)

  Sample Title Player - Visual Basic Version (VIEWMV.EXE)

  MediaView Libraries

  MediaView Documentation

Tool Kit

SHED Editor: Doesn't Work With User Defined Hash Values (201)

In MediaView, the feature has been added to allow title authors to set their own hash values, by setting a long hex number as the context string.  The SHED2.EXE editor does not have this feature.

SHED.EXE Will Not Ship At This Time (240)

SHED.EXE will not ship for the final release of the kit. Instead it will be posted in Compuserve.

Setup Does Not Delete Previous Directory or Files

The MediaView kits Setup will not delete a previous installation of the kits files. The user should delete previous versions of the files before installing a new version of the kit.

MediaView Compiler (WMVC12.EXE)

WMVC12.EXE Does Not Work with MVBRKR2.DLL (8)

The MediaView compiler will not work with the Viewer 2.0 MVBRKR2.DLL; a GPF may occur if you try to compile using that DLL. Use MVBRKR12.DLL instead.

Progress Indicator Sometimes Does Not Move (71)

As a title is compiling, the progress indicator may not move for a while. This is because the current version of the compiler does as little as possible to slow down the compilation.

Unreleased GM in MediaView Compiler (195)

If the user hits exit while the compiler is doing indexing, debug monitor displays a message Unreleased GM. This is a memory leak, but since this piece of memory is released by Windows itself, there is no overall loss of memory.

Compiler Outputs Messages All on One Line (202)

If the .log file is read only and a compile has errors, then the errors are displayed all on one line in the compiler output window.

Compiler Needs to be Cleared (204)

When compiling two projects in a row, for the second compilation the compiler may display the following warning:

Warning 4686: Style sheet. 'style name', redefined; first definition used.

The work around is to shut down and restart the compiler.

Non-Conformity to Word 6 RTF cs Designations (210)

Media View does not fully accomodate disparate RTF cs numbers for identically named styles in a multi-document title.  This causes compiler warning 4686. While disparate cs numbers don't break a title, they do

appear to lie behind loss of color.  This may also complicate use of fGetCharStyle(), fSetCharStyle(),

iCharStyleCount(), etc. This is complicated by the fact that Word 6.0 will not make cs numbers consistent after File | Template | Attach and Automatic Update of Styles.  Documents created from a template may start out in harmony, but any sort of style sheet change  may upset the cs numbering.

Title: Word Breaker: FBreakWords & FBreakAndStemWords Return 1 Less Word Than Sent (254)

Passing either of these functions a string which does not have a terminating character or white space at the  end of the string, causes the last word in the string to be lost. Adding a terminator character or white space to the end of the string causes the functions to return the correct number of words. Flushing the buffer causes the final word to be returned.

Sample Title (USA.M12)

Printing Hypergraphic (.SHG files) from USA.M12 (42)

As noted in the comments under Printing Hypergraphic (.SHG files) Displayed with {bmX} Statements, hypergraphics displayed with {bmX} statements do not print well. The sample title (USA.M12) contains some .SHG graphics displayed with {bmX} statements, and these graphics may not print well. These graphics are displayed in {bmX} statements in order to better illustrate keyboard access to hot spots in a graphic.

Texas Video Resets Immediately At End Of Sequence (82)

Texas State Flower. Flower sequence plays and immediately resets, not giving the viewer enough chance to see the last few frames of the sequence.

Califonia History AVI and ATIRLE.DRV (104)

When viewing the AVI sequence in the California History topic using an ATI driver (ATIRLE.DRV

dated: 9/21/93) your system will hang.

USA Icon Isn't Shown When USA Title Is Minimized (120)

When the USA title is minimized, the MVUI.EXE icon is used rather than the usa title's icon.

GP Fault When Printing to DJ1200C (230)

While trying to print the table of contents from the sample application to an HP DeskJet (DJ1200c) printer a GP fault occured. The problem is trying to print out bitmaps with RLE compression.  Apparently the bitmap must be decompressed before passing it to printers with drivers unable to decompress RLE.

BMP Rendering on IBM XGA (235)

Some of the USA.M12 256 bitmaps dont look their best on an XGA adapter at 1024x768, 256 colors, 512KB. Paintbrush displays this bmp equally poorly.  May be bad combination of hardware and monitor.

Multimedia List Group Missing from USA.M12 (248)

Topic-list searches in the Multimedia List group will fail. Search for any phrase (e.g. California or picture) will display the "No Matches" message-box.

WA State Flower Does Not Word Wrap Correctly (250)

Select WA; Information; State flower. Formatting is wrong.

Text Overlapped By Pictures (251)

In some of the State Tree, State Flower, and State Bird topics parts of the first character of the italic text is covered up.

Sample Title Player - C-Language Version (MVUI.EXE)

Topic Source Window Has No System Menu (165)

The only ways to close the Topic Source window is to uncheck the Topic Source command in MVUI.EXEs View menu, or to press ALT+F4 while the Topic Source window is active.

ALT+TAB and CTRL+ESC Disabled w/ Popups Up (227)

When a popup-window displays, both ALT+TAB task switching and CTRL+ESC

task-manager do not work.

Bad Error Code Searching with DTYPE, THRU (233)

When composing a query with non-zero DTYPE and the un-supported THRU operator, MediaView returned with a random value for an error code. Making the full-text-search query in MVUI.EXE on USA.M12 yields a "no matches" message box.

Index Misses Keywords (261)

MVUI.EXE's IndexDlgProc() essentially performs a full-text search for a keyword index entry.  However, keywords from K-footnotes needn't actually appear in the topic's body, so this search does not pick up such topics.

Sample Title Player - Visual Basic Version (VIEWMV.EXE)

Topic Moves When Going To/From New Topic (223)

For some transitions, when switching from one topic to another the screen jitters. This does not effect the

title's functionality and does not occur with the C version.

Line Appears At Top Of Printout From VBX (249)

In VIEWMV.EXE, bring up TOC for 1st topic. Selct File/Print Topic. Note line at top of topic printout. This does not occur in C version. This is to demonstrate in the VB code how to use the VBX as well as how to render directly to a printed page.

Unable to Select a Word By Double Clicking On It (253)

If you double click on any word, anywere in the title you are unable to

select the word by double clicking on it.

MediaView Libraries

Scrolling and Scroll Bars (28)

Scrolling small topics will produce a lot of thumb jumping when using the scroll bar thumb. Scrolling large topics however, where the thumb is the most useful, should give a fairly accurate thumb position. In cases where the window is almost large enough to display the entire topic, but not quite,  the thumb may jump from a halfway down to the bottom of the scroll bar.

Printing Hypergraphic (.SHG files) Displayed with {bmX} Statements (42)

If a topic contains a bitmap {bmX} statement that displays a hypergraphic (.SHG) file created with SHED12.EXE, the graphic may not print very well; i.e. the colors that print out may look unattractive.

The work-around is to display .SHG files with {ewX} statements using MVDIB12.DLL. A topic containing an embedded window {ewX} statement that displays a hypergraphic (.SHG) file created with SHED12.EXE will print just fine.

Note, though, that unlike {bmX} statements, {ewX} statements do not allow for keyboard access to the hot spots in a hypergraphic.

256-Color Bitmaps (108,243)

We recommend you use the {bmX} statements for displaying 16 color bitmaps only, and embedded window {ewX} statements using MVDIB12 for displaying 256 color images.

Text Selected by MVSelectPoint Differs Based on Order of Points (143)

The amount of text selected by MVSelectPoint may differ depending on order of points

and characters to be selected. e.g  when selecting from right-to-left vs. left-to-right.

Header Files Prototype fMVSetPolygon, No Documentation (180)

The MEDV12.H header file contains a prototype for fMVSetPolygon, the MVPOLYGON strucure, and the MVERROR.H file contains a definition for wERRS_BADPOLYGON; the MediaView Kit help does not document this function. The fMVSetPolygon function is of limited use, and may not lay out text and white space correctly.

Lines with Embedded {bmX} Statements Cause Layout Problems (190)

If a line in a topic contains an embedded {bmX} statement and the bitmap

fits on the screen but the text would be clipped, MediaView appears

to layout the bitmaps but not the text.

Unable to Select Text (226)

If topic text contains a blank line (a paragraph to MS Word) with paragraph formatting with either a left or right indent, and if the trailing paragraph (containing text) has a different indent, selecting text doesn't work. The work around is to make sure that any blank lines contain exactly the same indent formatting as the paragraph that follows. The values must be an exact match in both the left and right indent.

Search Hit Color DBWin Warnings (237)

Changing highlight color by Options | Search Hit Color... causes 2 dbwin.exe messages. This occurs in the hMVSetHighlightLook call.

yMVScrollY(SB_THUMBPOSITION) Changes fMVGetHighlightRect() Rectangle Coordinates (241)

After scolling pages to find a highlight rectangle with fMVGetHighlightRect(), if the application then gets the thumb position with yMVGetYScrollPos() and resets it with yMVScrollY(SB_THUMBPOSITION) the layout is not necessarily in the same place as it was for the page scroll down. The call to yMVScrollY(SB_THUMBPOSITION) may change the layout slightly, and another call to fMVGetHighlightRect() would report that the highlight was once again off the screen . The work-around is to simply not call the yMVScrollY() with the SB_THUMBPOSITION after paging down to find a highlight rectangle.

MVMCI12 with WaveAudio and [device XXX] (244)

The [device XXX] option does not work with non-video devices since it makes MVMCI think it can do a quick open, which it can't because it never completes it.  The work-around is to omit this option from embedded window authoring statements for non-video devices.

Contiguous Topic Groups Break TopicListLoad (252)

When a [GROUPS] entry appears only in consecutive topics, whether in the

browse or topic-group fields of the '+'-footnote, TopicListLoad() will fail

to load the group.

MediaView Documentation (MVKIT.M12)

Hot Spots Different Styles

The jump hot spots in the MVKIT.M12 title are different styles. Some appear in large green text, some in normal-sized green text, some in bold green text, some with and some without underlines.

Table Cells Not Aligned

Some table cells in the MVKIT.M12 title are not aligned.