ShapeWindow Xtra documentation

What will shapeWindow Xtra do?
Sales
Technical Support
Legal Disclaimer
Licensing
Version History
ShapeWindow Xtra Functions Reference
How to use ShapeWindow Xtra

The ShapeWindow Xtra allows Director developers to change the shape of the display window for a projector and during the authoring. The display window can be reshaped into complex outlines, that is traced from a monochrome bitmap mask. The bitmap mask can also be used to create a transparent stage effect that is accurate down to a pixel. Stage borders are removed. The Xtra allows developers to add a user defined activation area using any Director cast Member to act as a handle bar for dragging the projector. The Xtra provides the ability to drag, to move the window from lingo and to minimalize shaped window. The ShapeWindow Xtra works in MIAW, in the full screen and in the floating window mode. The ShapeWindow Xtra gives you the ability to customize your projector window to a shape more appropriate and natural to your application's theme for unique Director applications.The ShapeWindow Xtra works with versions 6,7 i 8 in Windows 95/98/2000/NT environment.

back to toc

Sales

To purchase ShapeWindow Xtra electronically please visit http://www.intermedia.pl/xtraen.php3 or order it by http://www.kagi.com All Intermedia Sp. z o.o. products can be purchased using all payment methods accepted by Kagi.com. All Intermedia Sp. z o.o. products are available in demo form to allow you to evaluate them before purchase, for this reason these products are not returnable or refundable.

For sales questions please contact zm@intermedia.pl

back to toc

Technical Support

Intermedia Sp. z o.o. provides support only through email. Questions will be answered as soon as possible and in a timely manner. Support is available from 8:00 A.M. CET to 6:00 P.M. CET CENTRAL EUROPEAN TIME (US Eastern time/EST - 6) and Monday through Friday excluding any holidays or vacation. Please provide the product serial number with any questions.
If you have any suggestions for a future product feature or an idea for simplifying the use of the product, please e-mail to Intermedia Sp. z o.o. at zm@intermedia.pl

back to toc

Legal Disclaimer

This software is provided "as is", without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability or fitness for a particular purpose. The software or its documentation or samples may include errors or technical inaccuracies.
Changes are periodically made to this software, its documentation and samples, and may be incorporated in new versions. Intermedia sp. z o.o.may improve or change products at any time without notice. Intermedia sp. z o.o. does not assume responsibility for, and disclaims all liability for, errors in this software or its documentation and samples. Intermedia sp. z o.o. will not be responsible for any damages of any sort under any conditions and is not liable for lost profits,or any special, indirect, consequential, or incidental damages. While the software contains no known bugs, you will use it at your own risk.
Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you.

back to toc

Licensing

Purchasing the software entitles the registered user to an unlimited royalty free runtime license for distributing the Xtra in a compiled Director application the registered user develops. For development the registered user is licensed to possess and operate a single installed copy of the software. The registered user may not redistribute any documents, human-readable product serial numbers, or any files accompanying the Xtra.
The Xtra is serialized for identification. The demo version of the Xtra is only to be used for evaluation purposes. The demo may be redistributed, provided no charge is made and can not be altered in any manner and must distributed intact as is, including all files.
Violation of this licensing agreement automatically terminates your right to use this software. Intermedia Sp. z o.o. will take any legal action necessary for loss profits or infringement of intellectual property.

back to toc

Version History

v. 1.0 - First Version April 31, 2000

v. 1.0.1 - May 31, 2000 - removing minor bugs

back to toc

ShapeWindow Xtra Function Reference

PrepareWindow object me, string serialNumber Defines neccesary variables. This function must be called before you call any other function of the Xtras. The variable serialnumber is the serialnumber, you get when you register Xtra. When you want to evaluate xtra, you can write there any text. In the case Xtra will show in runtime mode dialog that will remind you to register.

ChangeWindowPos object me,int x,int y to move the window to any location of the screen defined with x, y coordinates

ChangeMask object me, string filename, int x , int y Change the Shape of window by changing the mask identified by a path and file name. Variables x, y are the width and hight of the mask.

DragWindow object me You can drag the window using this handler

RestoreMaskobject me Restore the shape of window to the default Director mask

WindowMinimize object me Minimize the window (use this in Director 6 ,7 - in Director 8 use system function appminimize)

back to toc

How to use ShapeWindow Xtra

The first thing you have to do is to define the mask. You can define it with any graphic software. And you have to save it as *.raw in a grayscale. Color black RGB (0,0,0) defines the area where you can see the desktop and color white defines RGB (255,255,255) window Shape.

Global gShapedWindow - defining the global varaiable where the object will be stored during the runtime.

On prepareMovie
set gShapedWindow = new (xtra "ShapeWindow")
PrepareWindow(gShapedWindow”demo”)
ChangeMask(gShapedWindow,the pathname&”xtras\mask”,500,500)
End - initializing of neccesary variables
- we change the shape of window to the shape described in file mask.raw in catalogue Xtras. The width of shape is 500 pixels. The hight of shape is 500 pixels.

On StopMovie
If the runmode contains "Author" then
RestoreMask(gShapedWindow)
end if
End
- When you use it in authoring mode restore the mask to the Director default mask.

On MouseDown
DragWindow(gShapedWindow)
End - It is your handler bar. You put the behaviour to any Director sprite or castMember, which is on the stage. When click and hold down the mouse you can do drag the window over the screen. When you release the mouse button the window will stay in the new position.

On MouseUp
ChangeWindowPos (gShapedWindow,400,500)
end
- The window move to the location defined by horizontal coordinates x and vertical coordinates y. Origin point of window is the left upper corner of shape image.

Create projector with no title bar

back to toc
Back to xtras site

PrepareWindow object me, string serialNumber	Defines neccesary variables. This function must be called before you call any other function of the Xtras. The variable serialnumber is the serialnumber, you get when you register Xtra. When you want to evaluate xtra, you can write there any text. In the case Xtra will show in runtime mode dialog that will remind you to register.
ChangeWindowPos object me,int x,int y	to move the window to any location of the screen defined with x, y coordinates
ChangeMask object me, string filename, int x , int y	Change the Shape of window by changing the mask identified by a path and file name. Variables x, y are the width and hight of the mask.
DragWindow object me	You can drag the window using this handler
RestoreMaskobject me	Restore the shape of window to the default Director mask
WindowMinimize object me	Minimize the window (use this in Director 6 ,7 - in Director 8 use system function appminimize)

	The first thing you have to do is to define the mask. You can define it with any graphic software. And you have to save it as *.raw in a grayscale. Color black RGB (0,0,0) defines the area where you can see the desktop and color white defines RGB (255,255,255) window Shape.
Global gShapedWindow	- defining the global varaiable where the object will be stored during the runtime.
On prepareMovie set gShapedWindow = new (xtra "ShapeWindow") PrepareWindow(gShapedWindow”demo”) ChangeMask(gShapedWindow,the pathname&”xtras\mask”,500,500) End	- initializing of neccesary variables - we change the shape of window to the shape described in file mask.raw in catalogue Xtras. The width of shape is 500 pixels. The hight of shape is 500 pixels.
On StopMovie If the runmode contains "Author" then RestoreMask(gShapedWindow) end if End	- When you use it in authoring mode restore the mask to the Director default mask.
On MouseDown DragWindow(gShapedWindow) End	- It is your handler bar. You put the behaviour to any Director sprite or castMember, which is on the stage. When click and hold down the mouse you can do drag the window over the screen. When you release the mouse button the window will stay in the new position.
On MouseUp ChangeWindowPos (gShapedWindow,400,500) end	- The window move to the location defined by horizontal coordinates x and vertical coordinates y. Origin point of window is the left upper corner of shape image.
	Create projector with no title bar