Index

          Bmp Wizard

Use:

Introduction	Script language

Examples	Versions

Menu commands:

File menu	Edit menu	Record menu

View menu	Window menu	Help menu

Andrea Benoni	e-mail	MC5211@MCLINK.IT

Lungadige Trento, 50	Compuserve	100042,1264

37012 Bussolengo Verona

Italy

Home Page: http://ourworld.compuserve.com/homepages/andrea_benoni

This shareware application can be found in the Windows Utility Forum on CompuServe, an official distribution and support online resource for future updates. Go WINUTIL, search for BMP WIZARD.

The Windows Users Group Network [WUGNET], operators of the oldest and largest independent support resource forums for Windows users on CIS with over 1,000,000 active members is recognized in the press, user groups, developers, and Microsoft as the foremost resource for shareware publishers on CompuServe and the Internet.

Go WUGNET on Compuserve

http://www.wugnet.com on Internet


Introduction
Introduction:

As a graphic programs user, I often need to modify/filter bitmap accessing pixel data at low level.

BmpWiz accomplish this need, using a Basic like language to modify raster images in BMP format.

BMP Wizard is a script driven image filter, it can treat BMP files in 1-4-8-24 bit format. BW  use a basic like scrip language, version 1.81 includes 63 script examples, many are ready to use filter other effects.

BW is optimized for speed, the script language is compiled for the fastest execution, depends on algorithm it can reach 1 million pixel per second using a Pentium 100.

BW script language has flow control construct, access directly pixel as RGB value or can use HSB color representation, has 9 image/pixel instruction, 7 general instruction, 27 mathematical operator/functions, 10 logical/boolean operator. The basic like script language has variables, arrays and can treats multiple image simultaneously.Thanks to its interpreted natuture BW permit to study digital image treatment, the various examples could be a good startpoint for new one or experimentation.

Features:

-Treats 1-4-8-24 bit BMP files

-Optimized 32 bit program

-Basic like script language, 10 graphic functions, 7 general, 25 mathematical, 10 logical/boolean

-63 filters/examples ready to use and modify

-Filter for digital image, mosaic, noise reduction, edge,flag, fade,caos,contrast, resize with interpolation ...

-Effect like 3d, Windows 95 tsrtup logo substitute, lens...

-Semi compiler for 1Mpixel sec treatment on a 100Mhz

-RGB or HSB color access

-Irreplaceable for fast prototype graphic algorithm

-Effect preview

-Win95 interface

-Background elaboration

-Clipboard put&get

-Efficient use of memory for large image filtering

This is a shareware software, for professional or commercial use after a trial you must register, for student or other use BMP Wizard is free, with registration you obtain new releases notification, bug-fixing and e-mail assistance.

The registration fee is 40$, if you are on Compuserve you can use (go) SWREG and use Id 8910 for payment.

This is the 32 bit version of BmpWiz that could be used in Windows NT or Windows ´95.


Script language
Script language:

BmpWiz script (BWL) is a basic like language.

There are two main difference from basic, BWL accept only one instruction each row (except expression) and variables must be declared.

Remark:

Allows explanatory remarks to be inserted in a program preceding them with a single quotation mark ['].

Variables & constants:

Variables must be defined before their use with the syntax:

var_type var_name[,var_name]

es:

float 	x,y

Characters allowed in a variable name are only letters, the parser is case sensitive so var and Var is not the same variable.

There are two family of variables type:

Simple:

float	floating point number

string	character string

Structured:

DevCon	image

Width	image width (read only)

Height	image height (read only)

BitCount	bit number per pixel (read only)

Res	resolution

ClrImp	colors importants (for image rendering)

RGB	color info in RedGreenBlue format

Lum	luminosity (0-255) or (Red+Green+Blue)/3

Red	red component (0-255)

Green	green component (0-255)

Blue	blue component (0-255)

HBS	color info in HueBrightSaturation format

Hue	color (0-240)

Bri	bright (0-240)

Sat	saturation (0-240)

Structured variables could receive data using assignment.

To access single components you must specify component name after variable name separated by a dot.

es:

define a color variable

RGB	pix

set pix red component to max:

pix.Red=255

HBS struct cannot be used with graphical instructions, the color information must be assigned to a RGB variable before its use.

You can define arrays of float using [n] int the definition line, n is the elements number.

To use arrays in the program you must specify the index (0 based), es:

float ar[10]

ar[0]=1

ar[1]=ar[0]+1

Costants could be numbers or string, numbers must be in the n.n form, strings must be enclosed in double quotation marks.

Predefined constants:

float 	ClNum	Number of arguments on command line

string	ClArg[n]	Argument received on command line

float	PI	Return the π (3,14159)

Statement & functions:

Graphics commands:

DevCon=LoadImage(string Name):

Reads a bitmap from disk returning a DevCon value.

Name could be a variable or a constant that point to a file in the Windows BMP format, 1/4/8/24 bits.

Memory bitmap pointed by DevCon have the same width lenght and color limits of the BMP file.

To get a bitmap from clipboard you must specify its name as file to read (es: Ibmp=LoadImage("CLIPBOARD") ), then program flow stop waiting a bitmap in the clipboard.

Reading/writing to clipboard allow to build macro like script that operate inside other graphic programs, ClpBrd.Bas demotrate this use.

DevCon=CreateImage(float Xdim,float Ydim,float bit)

Creates a bitmap in memory with the specified limits.

Return a DevCon value that must be used as reference.

In the 1/4/8 bit format a gray palette will be associated to the image.

SaveImage(DevCon img,string Name)

Saves the img memory bitmap in a file.

If file name is "CLIPBOARD" destination will be the clipboard.

RGB=GetPalette(DevCon img,float enum)

Obtains the RGB value of the enum element from palette associated to the img bitmap.

SetPalette(DevCon img,float enum,RGB pix)

Sets the RGB value of the enum element in the palette associated to the img bitmap.

Pixel access:

RGB=GetPixel(DevCon img,float x,float y)

Reads the RGB value of the x,y pixel inside img bitmap.

val=GetPixelVal(DevCon img,float x,float y)

Reads the numeric value of the x,y pixel inside img bitmap, usefull to get pixel numeric values (palette index) of 1/4/8 bit images.

SetPixel(DevCon img,float x,float y, RGB pix)

Sets the RGB value of the x,y pixel inside img bitmap.

SetPixelVal(DevCon img,float x,float y, float val)

Sets the numeric value of the x,y pixel inside img bitmap, faster than SetPixel bypassing palette.

Flow:

If (cond)

...

[else

...]

endif

If cond is TRUE (not  0) execute following commands until else, if cond is FALSE program flow skip to the command following else. Cond could be any sequence of operator evaluated from left to right, operator inside bracket are evaluated first.

For var=(exp1) To (exp2) [Step (exp3)]

Next var

Executes a loop from exp1 to exp2 counting in var, increment is exp3 or 1 if not specified.

Exit

Exit from BmpWiz, it is used for batch called image filters that needs automatic program exit (see the External batch operation chapter for more information).

Application declared functions:

Declaring function permit to expand the BW script command set, using program defined function in a BW program impose to construct the script as:

Main body	all the instruction that compose the body

Return	terminates the program

for each declared function:

Function args

Function declaration
Function body
Return

Function funcname[(args,...)]

This is the construct that declares a function, follow the arguments declaration and precedes the instructions.

Function can compare in formula or stand alone (like subroutine), in the declaration there isnt any difference,

All variables in BW script are globals also if declared in function body, you must use different name to avoid conflict, then if a function recall itself can modify its variables.

Function name is case sensitive and cannot contain spaces.

Return must have a parameter if a returned value is required and havent if the function is a subroutine.

Function are declared using the syntax:

argument variable declaration

Function FuncName[(args,...)]

Return[(variable|constant)]

Function with returned value example:

float p	Main body

p=Average(5,10)

DspMes(p)

Return

float arf,ars

Function Average(arf,ars)

Return(arf+ars/2)

Function as subroutine (no return value) example:

Print(Hello world) 	Main body

Return

string Message

Function Print(Message)

DspMes(Message)

Return

Return [(constant|variable)]

Return from function or terminate program execution if used in main body.

Optionally can return a constant or the content of a variable in this case you must assign the returned value to a variable:

col=MyGetPix(10,10)

...

float mx,my

function MyGetPixel(mx,my)

return(1)

Not assign a returned value can fill the p-code stack with an Uncoverable Application Error in Bmp Wizard (stack is not checked for best performances).

Display & I/O:

string=GetFileName(string Title)

Asks a file name using the Windows common dialog, return a string value.

string=FileFind(string Mask)

Return a file name, command could be iterate to return all files names.

DspMes(...)

Displays a sequence of variable and constants in any order.

Debug()

Suspend program execution and shows variables contents in a window.

[if]/[val=] DspWhile(string text,float perc)

Displays a dialog with a message and a cursor with a percentage value.

Value returned is TRUE if stop button has been pressed.

Preview(DevCon img,string title,float x, float y [, float xdim,float ydim])

Displays the img bitmap in a window with the specified characteristics.

Other:

float=GetTickCount()

Return milliseconds from last computer startup, usefull for timeout or SRand function.

Operators:

Operators are evaluated in expression from the left to the right, operator inside bracket are evaluated first.

Arithmetic operators:

+	 	sum

- 	subtract

* 	multiply

/ 	divide

% 	module

Sin(exp) 	sines

ASin(exp) 	arcsine

HSin(exp) 	hyperbolic sine

Cos(exp) 	cosine

ACos(exp) 	arcosine

HCos(exp) 	hyperbolic cosine

Tan(exp) 	tangent

ATan(exp) 	arctangent

HTan(exp) 	hyperbolic tangent

Sqr(exp) 	square root

Abs(exp) 	absolute

Exp(exp) 	exponential

Log(exp) 	logarithm

LogT(exp) 	logarithm base 10

Pow(x,y) 	x raised to the power of y

Rand(exp)	random number in 0-exp range

SRand(exp)	seek random number usually to GetTickCount()

Min(a,b)	minimum between a e b

Max(a,b)	maximum between a e b

Int(a)	integral part of a

Logical:

>	greater

<	less

=	equal

>=	greater or equal

<=	less or equal

<>	not equal7

&	and

|	or

^	xor

!	not

External batch operation:

Using command line is possible to load and execute a script, es. BmpWiz caos.bas.

It as also possible to concatenate multiple file filtering using the new START comand present on WIN95 batch language:

multif.bat

START /w BmpWiz caos.bas inp1.bmp out1.bmp

START /w BmpWiz caos.bas inp2.bmp out2.bmp

...

caos.bas

inpFile=ClArg[2]

outFile=ClArg[3]

...

exit()


File menu commands

The File menu offers the following commands:

New	Creates a new document.
Open	Opens an existing document.
Close	Closes an opened document.
Save	Saves an opened document using the same file name.
Save As	Saves an opened document to a specified file name.
Print	Prints a document.
Print Preview	Displays the document on the screen as it would appear printed.
Print Setup	Selects a printer and printer connection.
Send...	Sends the active document through electronic mail.
Exit	Exits <<YourApp>>.


Edit menu commands

The Edit menu offers the following commands:

Undo	Reverse previous editing operation.
Cut	Deletes data from the document and moves it to the clipboard.
Copy	Copies data from the document to the clipboard.
Paste	Pastes data from the clipboard into the document.
Paste Link	Pastes from the clipboard a link to data in another application.
Insert New Object	Inserts and embeds an object, such as a chart or an equation in a document.
Links	List and edit links to embedded documents.


View menu commands

The View menu offers the following commands:

Toolbar	Shows or hides the toolbar.
Status Bar	Shows or hides the status bar.


Window menu commands

The Window menu offers the following commands, which enable you to arrange multiple views of multiple documents in the application window:

New Window	Creates a new window that views the same document.
Cascade	Arranges windows in an overlapped fashion.
Tile	Arranges windows in non-overlapped tiles.
Arrange Icons	Arranges icons of closed windows.
Split	Split the active window into panes.
Window 1, 2, ...	Goes to specified window.


Help menu commands

The Help menu offers the following commands, which provide you assistance with this application:

Help Topics	Offers you an index to topics on which you can get help.
About	Displays the version number of this application.


File New command
New command (File menu)

Use this command to create a new document in <<YourApp>>.  Select the type of new file you want to create in the File New dialog box.  << Remove previous sentence if your application supports only one document type. >>

You can open an existing document with the Open command.

Shortcuts

Toolbar:

Keys:	CTRL+N


File New dialog box

<< Delete this help topic if your application supports only one document type. >>

Specify the type of document you wish to create:

<< List your application's document types here >>


File Open command
Open command (File menu)

Use this command to open an existing document in a new window.  You can open multiple documents at once.  Use the Window menu to switch among the multiple open documents.  See Window 1, 2, ... command.

You can create new documents with the New command.

Shortcuts

Toolbar:

Keys:	CTRL+O


File Open dialog box

The following options allow you to specify which file to open:

File Name

Type or select the filename you want to open.  This box lists files with the extension you select in the List Files of Type box.

List Files of Type

Select the type of file you want to open:

<< List your application's file types here. >>

Drives

Select the drive in which <<YourApp>> stores the file that you want to open.

Directories

Select the directory in which <<YourApp>> stores the file that you want to open.

Network...

Choose this button to connect to a network location, assigning it a new drive letter.


File Close command
Close command (File menu)

Use this command to close all windows containing the active document.  <<YourApp>> suggests that you save changes to your document before you close it.  If you close a document without saving, you lose all changes made since the last time you saved it.  Before closing an untitled document, <<YourApp>> displays the Save As dialog box and suggests that you name and save the document.

You can also close a document by using the Close icon on the document's window, as shown below:


File Save command
Save command (File menu)

Use this command to save the active document to its current name and directory.  When you save a document for the first time, <<YourApp>> displays the Save As dialog box so you can name your document.  If you want to change the name and directory of an existing document before you save it, choose the Save As command.

Shortcuts

Toolbar:

Keys:	CTRL+S


Exec command
Run/Stop

Pressing this buttons execute current script language or stop the running one.

Shortcuts

Toolbar:

Keys:	CTRL+R


File Save As command
Save As command (File menu)

Use this command to save and name the active document.  <<YourApp>> displays the Save As dialog box so you can name your document.

To save a document with its existing name and directory, use the Save command.


Send command (File menu)

Use this command to send the active document through electronic mail.  This command presents a mail window with the active document attached to it.  You may then fill out the To: field, Subject: field, etc., and add text to the body of the message if you wish.  When you are finished you may click the "Send" button to send the message.


File Save As dialog box

The following options allow you to specify the name and location of the file you're about to save:

File Name

Type a new filename to save a document with a different name.  A filename can contain up to eight characters and an extension of up to three characters.  <<YourApp>> adds the extension you specify in the Save File As Type box.

Drives

Select the drive in which you want to store the document.

Directories

Select the directory in which you want to store the document.

Network...

Choose this button to connect to a network location, assigning it a new drive letter.

<< Add other File Save As dialog box options depending on which ones your application chooses via the OFN_ flags of the OPENFILENAME structure used by the CFileDialog. >>


File 1, 2, 3, 4 command
1, 2, 3, 4 command (File menu)

Use the numbers and filenames listed at the bottom of the File menu to open the last four documents you closed.  Choose the number that corresponds with the document you want to open.


File Exit command
Exit command (File menu)

Use this command to end your <<YourApp>> session.  You can also use the Close command on the application Control menu.  <<YourApp>> prompts you to save documents with unsaved changes.

Shortcuts

Mouse:	Double-click the application's Control menu button.

Keys:	ALT+F4


Undo/Can't Undo command (Edit menu)

<< Your application's user interface for Undo may differ from the one described below.  Modify this help text accordingly. >>

Use this command to reverse the last editing action, if possible.   The name of the command changes, depending on what the last action was.  The Undo command changes to Can't Undo on the menu if you cannot reverse your last action.

Shortcuts

Toolbar:

Keys:	CTRL+Z or

ALT-BACKSPACE


Redo command (Edit menu)

<< Write application-specific help here. >>


Cut command (Edit menu)

Use this command to remove the currently selected data from the document and put it on the clipboard.  This command is unavailable if there is no data currently selected.

Cutting data to the clipboard replaces the contents previously stored there.

Shortcuts

Toolbar:

Keys:	CTRL+X


Copy command (Edit menu)

Use this command to copy selected data onto the clipboard.  This command is unavailable if there is no data currently selected.

Copying data to the clipboard replaces the contents previously stored there.

Shortcuts

Toolbar:

Keys:	CTRL+C


Paste command (Edit menu)

Use this command to insert a copy of the clipboard contents at the insertion point.  This command is unavailable if the clipboard is empty.

Shortcuts

Toolbar:

Keys:	CTRL+V


View Toolbar command
Toolbar command (View menu)

Use this command to display and hide the Toolbar, which includes buttons for some of the most common commands in <<YourApp>>, such as File Open.  A check mark appears next to the menu item when the Toolbar is displayed.

See Toolbar for help on using the toolbar.


Toolbar

The toolbar is displayed across the top of the application window, below the menu bar.  The toolbar provides quick mouse access to many tools used in <<YourApp>>,

To hide or display the Toolbar, choose Toolbar from the View menu (ALT, V, T).

<< Add or remove toolbar buttons from the list below according to which ones your application offers. >>

Click	To

Open a new document.

Open an existing document.  <<YourApp>> displays the Open dialog box, in which you can locate and open the desired file.

Save the active document or template with its current name.  If you have not named the document, <<YourApp>> displays the Save As dialog box.

Print the active document.

Remove selected data from the document and stores it on the clipboard.

Copy the selection to the clipboard.

Insert the contents of the clipboard at the insertion point.

Reverse the last editing.  Note:  You cannot undo some actions.

Go to the first record in the current selection.

Go to the previous record in the current selection.

Go to the next record in the current selection.

Go to the last record in the current selection.


View Status Bar Command
Status Bar command (View menu)

Use this command to display and hide the Status Bar, which describes the action to be executed by the selected menu item or depressed toolbar button, and keyboard latch state. A check mark appears next to the menu item when the Status Bar is displayed.

See Status Bar for help on using the status bar.


Status Bar

The status bar is displayed at the bottom of the <<YourApp>> window.  To display or hide the status bar, use the Status Bar command in the View menu.

The left area of the status bar describes actions of menu items as you use the arrow keys to navigate through menus.  This area similarly shows messages that describe the actions of toolbar buttons as you depress them, before releasing them.  If after viewing the description of the toolbar button command you wish not to execute the command, then release the mouse button while the pointer is off the toolbar button.

The right areas of the status bar indicate which of the following keys are latched down:

Indicator	Description

CAP	The Caps Lock key is latched down.

NUM	The Num Lock key is latched down.

SCRL	The Scroll Lock key is latched down.


New command (Window menu)

Use this command to open a new window with the same contents as the active window.  You can open multiple document windows to display different parts or views of a document at the same time.  If you change the contents in one window, all other windows containing the same document reflect those changes.  When you open a new window, it becomes the active window and is displayed on top of all other open windows.


Cascade command (Window menu)

Use this command to arrange multiple opened windows in an overlapped fashion.


Tile command (Window menu)

Use this command to arrange multiple opened windows in a non-overlapped fashion.


Tile Horizontal command (Window menu)

Use this command to vertically arrange multiple opened windows in a non-overlapped fashion.


Tile Vertical command (Window menu)

Use this command to arrange multiple opened windows side by side.


Window Arrange Icons Command

Use this command to arrange the icons for minimized windows at the bottom of the main window.  If there is an open document window at the bottom of the main window, then some or all of the icons may not be visible because they will be underneath this document window.


Split Command (Window menu)

Use this command to split the active window into panes.  You may then use the mouse or the keyboard arrows to move the splitter bars.  When you are finished, press the mouse button or enter to leave the splitter bars in their new location.  Pressing escape keeps the splitter bars in their original location.  << In a single document interface application, this command will appear on the View menu. >>


1, 2, ... command (Window menu)

<<YourApp>> displays a list of currently open document windows at the bottom of the Window menu.  A check mark appears in front of the document name of the active window.  Choose a document from this list to make its window active.


Index command (Help menu)

Use this command to display the opening screen of Help.  From the opening screen, you can jump to step-by-step instructions for using <<YourApp>> and various types of reference information.

Once you open Help, you can click the Contents button whenever you want to return to the opening screen.


Using Help command (Help menu)

Use this command for instructions about using Help.


About command (Help menu)

Use this command to display the copyright notice and version number of your copy of <<YourApp>>.


Help Using Help Command
Context Help command

Use the Context Help command to obtain help on some portion of <<YourApp>>.  When you choose the Toolbar's Context Help button, the mouse pointer will change to an arrow and question mark.  Then click somewhere in the <<YourApp>> window, such as another Toolbar button.  The Help topic will be shown for the item you clicked.

Shortcut

Keys:	SHIFT+F1


Title Bar

<< Show your application's title bar here. >>

The title bar is located along the top of a window.  It contains the name of the application and document.

To move the window, drag the title bar.  Note: You can also move dialog boxes by dragging their title bars.

A title bar may contain the following elements:

Application Control-menu button

Document Control-menu button

Maximize button

Minimize button

Name of the application

Name of the document

Restore button


Scroll bars

Displayed at the right and bottom edges of the document window.  The scroll boxes inside the scroll bars indicate your vertical and horizontal location in the document.  You can use the mouse to scroll to other parts of the document.

<< Describe the actions of the various parts of the scrollbar, according to how they behave in your application. >>


Size command (System menu)

Use this command to display a four-headed arrow so you can size the active window with the arrow keys.

After the pointer changes to the four-headed arrow:

1.	Press one of the DIRECTION keys (left, right, up, or down arrow key) to move the pointer to the border you want to move.

2.	Press a DIRECTION key to move the border.

3.	Press ENTER when the window is the size you want.

Note:  This command is unavailable if you maximize the window.

Shortcut

Mouse:	Drag the size bars at the corners or edges of the window.


Move command (Control menu)

Use this command to display a four-headed arrow so you can move the active window or dialog box with the arrow keys.

Note:  This command is unavailable if you maximize the window.

Shortcut

Keys:	CTRL+F7


System Minimize Command
Minimize command (application Control menu)

Use this command to reduce the <<YourApp>> window to an icon.

Shortcut

Mouse:	Click the minimize icon [image] on the title bar.

Keys:	ALT+F9


Maximize command (System menu)

Use this command to enlarge the active window to fill the available space.

Shortcut

Mouse:	Click the maximize icon [image] on the title bar; or double-click the title bar.

Keys:	CTRL+F10 enlarges a document window.


Next Window command (document Control menu)

Use this command to switch to the next open document window.  <<YourApp>> determines which window is next according to the order in which you opened the windows.

Shortcut

Keys:	CTRL+F6


Previous Window command (document Control menu)

Use this command to switch to the previous open document window.  <<YourApp>> determines which window is previous according to the order in which you opened the windows.

Shortcut

Keys:	SHIFT+CTRL+F6


Close command (Control menus)

Use this command to close the active window or dialog box.

Double-clicking a Control-menu box is the same as choosing the Close command.

Note:  If you have multiple windows open for a single document, the Close command on the document Control menu closes only one window at a time.  You can close all windows at once with the Close command on the File menu.

Shortcuts

Keys: 	CTRL+F4 closes a document window

ALT+F4 closes the <<YourType>> window or dialog box


Restore command (Control menu)

Use this command to return the active window to its size and position before you chose the Maximize or Minimize command.


Switch to command (application Control menu)

Use this command to display a list of all open applications.  Use this "Task List" to switch to or close an application on the list.

Shortcut

Keys:	CTRL+ESC

Dialog Box Options

When you choose the Switch To command, you will be presented with a dialog box with the following options:

Task List

Select the application you want to switch to or close.

Switch To

Makes the selected application active.

End Task

Closes the selected application.

Cancel

Closes the Task List box.

Cascade

Arranges open applications so they overlap and you can see each title bar.  This option does not affect applications reduced to icons.

Tile

Arranges open applications into windows that do not overlap.  This option does not affect applications reduced to icons.

Arrange Icons

Arranges the icons of all minimized applications across the bottom of the screen.


View Ruler Command
Ruler command (View menu)

<< Write application-specific help here. >>


Choose Font Dialog
Choose Font dialog box

<< Write application-specific help here. >>


Choose Color Dialog
Choose Color dialog box

<< Write application-specific help here. >>


Edit Find Command
Find command (Edit menu)

<< Write application-specific help here. >>


Find Dialog
Find dialog box

<< Write application-specific help here. >>


Edit Replace Command
Replace command (Edit menu)

<< Write application-specific help here. >>


Replace Dialog
Replace dialog box

<< Write application-specific help here. >>


Edit Repeat Command
Repeat command (Edit menu)

Use this command to repeat the last editing command carried out.  The Repeat menu item changes to Can't Repeat if you cannot repeat your last action.

Shortcut

Key:	F4


Edit Clear Command
Clear command (Edit menu)

<< Write application-specific help here. >>


Edit Clear All
Clear All command (Edit menu)

<< Write application-specific help here. >>


Next Pane Command
Next Pane

<< Write application-specific help here. >>


Prev Pane Command
Prev Pane

<< Write application-specific help here. >>


Modifying the Document

<< Write application-specific help here that provides an overview of how the user should modify a document using your application.

If your application supports multiple document types and you want to have a distinct help topic for each, then use the help context i.d. generated by running the MAKEHELP.BAT file produced by AppWizard.  Alternatively, run MAKEHM as follows:

makehm IDR_HIDR_,0x2000 resource.h

If the IDR_ symbol for one of your document types is, for example, IDR_CHARTTYPE, then the help context i.d. generated by MAKEHM will be HIDR_CHARTTYPE.

Note, AppWizard defines the HIDR_DOC1TYPE help context i.d. used by this help topic for the first document type supported by your application.  AppWizard produces an alias in the .HPJ file for your application, mapping HIDR_DOC1TYPE to the HIDR_ produced by MAKEHM for that document type. >>


No Help Available

No help is available for this area of the window.


No Help Available

No help is available for this message box.

<< If you wish to author help specific to each message box prompt, then remove the AFX_HIDP_xxx values from the [ALIAS] section of your .HPJ file, and author a topic for each AFX_HIDP_xxx value.  For example, AFX_HIDP_INVALID_FILENAME is the help topic for the Invalid Filename message box. >>


Versions
Versions:

1.3

32 bit version

Clipboard support

1.50

New  filters

1.51

Minor bug fix

Error editing scripts of different len.

1.6

New feature

Arrays

Negative numeric constant

New instructions

Debug

GetPixelVal

SetPixelVal

New filter

Pattern

Fern

Stats

StatsBN

Logo

1.7

New feature

Pentium optimisation

An interface more Win95 compliant

Automatic execution of the script specified on the command line.

New instructions

New function

Exit

New constants

PI, ClArg[], ClNum

New aritmetic functions

Sqr, ASin, HSin, ACos,HCos,Tan

ATan, HTan, Abs, Exp,Log, LogT, Pow

New filter

logo1

3D

1.8

New feature

Bigger program and stack support.

Bug fixing

Saving script UAE

Function + operator -> wrong memory allocation

New instruction

Functions implementation (subroutine).

SRand seed random

GetTickCount, milliseconds from computer startup

New filter

Screen capture & reduction via clipboard

Shadow algorithms

Other Win 95 startup logo substitute

Outline

Better antialiasing filter

1.81

-Free for student and non commercial/professional use.

-End of Win32s support.

-Optimization (10%-20%)

-New filter

Rect


Examples
Examples:

3D 	3d effect on B/N images

BRI_SAT 	Demostrate how to modify pixel brightness an saturation

LOGO	Substitute Win95 startup logo with a fern and a moving background

LOGO1	An other startup logo substitute

LOGO2	An other startup logo substitute, lava/plasma effect

LOGO3	An other startup logo substitute

MOSAIC	Mosaic effect with black line separator

MOSAIC1 	Mosaic effect with black line separator with variable size tessera.

LAKE 	Simulate water reflection

CATODE 	Scompose RGB components in separate pixel like CRT

FLAG 	Flag distortion

LUMINOSI 	Modify brightness

ANTILIAS 	Antialias on B/W  images

RAND	Modify randomly pixel brightness

RAND1    	Random BW image

TAP 	Distortion

SPHERE	Distortion

SPHERE1 	Distortion

SPHERE2	Colored spheres

SPHERE3	Distortion

SEPARATE 	Separate RGB colors components.

BRICK	Pattern blend

PEAKS	Pattern blend

EROSION 	Eliminate noise from BW images

CAOS 	Random mix pixel

CAOS1	Random mix pixel

SEPPIA 	Modify to purple tone

FADE	Brightness fade

FADE1    	Color fade

BNSCALE	Gray scale

GRANITE	Granite pattern blend

PATTERN	Repeats image as a pattern

CLPBRD	Demostrate Clipboard interaction

CUBE	Construct a cube

TO16GRY	Reduct with antialiasing

EXT	Chroma key with background change

EXT1	Modify color image

TRIANGOL	Pattern blend

SIZE2-	Resize image

SIZE4-	Resize image

SIZE2X 	Double size

SIZE2XT	Double with interpolation

ITALICO 	Image distortion

SHADE 	Shade on BW image

CNV16GRY 	Convert to 4 bit gray scale

SWITCH	Switch color components

CNV24BIT	Convert to 24 bit images

NEG 	Invert brightness

SPECULA	Mirror

SCAL8RGB 	RGB scale

RIS_DEF  	Demostration of resolution vs. definition

SCALA8CO 	Color scale

SCALABN  	Gray scale

SCALACO  	24 bit color scale

SCALAHBS 	24 bit color scale

SCALARGB 	24 bit color scale

SCOMPONE 	Color separtion

STATS	Calculate single palette element use

STATSBN  	Count black pixel

FERN 	Calculate a fern (fractal)

CLPCAPn	Screen capture & reduction via clipboard

SHADOW	Shadow on text

SHADOW1	Only shadow

SHADOW2	An other type of shadow

OUTLINE	Extract outlines from an image

RECT 	A simply effect


File Print command
Print command (File menu)

Use this command to print a document.   This command presents a Print dialog box, where you may specify the range of pages to be printed, the number of copies, the destination printer, and other printer setup options.

Shortcuts

Toolbar:

Keys:	CTRL+P


Print dialog box

The following options allow you to specify how the document should be printed:

Printer

This is the active printer and printer connection.  Choose the Setup option to change the printer and printer connection.

Setup

Displays a Print Setup dialog box, so  you can select a printer and printer connection.

Print Range

Specify the pages you want to print:

All	Prints the entire document.
Selection	Prints the currently selected text.
Pages	Prints the range of pages you specify in the From and To boxes.
Copies

Specify the number of copies you want to print for the above page range.

Collate Copies

Prints copies in page number order, instead of separated multiple copies of each page.

Print Quality

Select the quality of the printing.  Generally, lower quality printing takes less time to produce.


Print Progress Dialog

The Printing dialog box is shown during the time that <<YourApp>> is sending output to the printer.  The page number indicates the progress of the printing.

To abort printing, choose Cancel.


File Print Preview command
Print Preview command (File menu)

Use this command to display the active document as it would appear when printed.  When you choose this command, the main window will be replaced with a print preview window in which one or two pages will be displayed in their printed format.  The print preview toolbar offers you options to view either one or two pages at a time; move back and forth through the document; zoom in and out of pages; and initiate a print job.


Print Preview toolbar

The print preview toolbar offers you the following options:

Print

Bring up the print dialog box, to start a print job.

Next Page

Preview the next printed page.

Prev Page

Preview the previous printed page.

One Page / Two Page

Preview one or two printed pages at a time.

Zoom In

Take a closer look at the printed page.

Zoom Out

Take a larger look at the printed page.

Close

Return from print preview to the editing window.


File Print Setup command
Print Setup command (File menu)

Use this command to select a printer and a printer connection.  This command presents a Print Setup dialog box, where you specify the printer and its connection.


Print Setup dialog box

The following options allow you to select the destination printer and its connection.

Printer

Select the printer you want to use.  Choose the Default Printer; or choose the Specific Printer option and select one of the current installed printers shown in the box.  You install printers and configure ports using the Windows Control Panel.

Orientation

Choose Portrait or Landscape.

Paper Size

Select the size of paper that the document is to be printed on.

Paper Source

Some printers offer multiple trays for different paper sources.  Specify the tray here.

Options

Displays a dialog box where you can make additional choices about printing, specific to the type of printer you have selected.

Network...

Choose this button to connect to a network location, assigning it a new drive letter.


File Page Setup Command
Page Setup command (File menu)

<< Write application-specific help here. >>