NSISMultiMon plug-in - Revision history

Tinsold at 11:58, 16 December 2006

2006-12-16T11:58:37Z

â† Older revision		Revision as of 11:58, 16 December 2006
Line 127:		Line 127:
	E-Mail: Please see readme.txt to prevent spam.		E-Mail: Please see readme.txt to prevent spam.

	[Category:Plugins]		[[Category:Plugins]]

Tinsold at 11:57, 16 December 2006

2006-12-16T11:57:48Z

â† Older revision		Revision as of 11:57, 16 December 2006
Line 126:		Line 126:

	E-Mail: Please see readme.txt to prevent spam.		E-Mail: Please see readme.txt to prevent spam.

			[Category:Plugins]

Tinsold at 11:38, 16 December 2006

2006-12-16T11:38:47Z

â† Older revision		Revision as of 11:38, 16 December 2006
Line 4:		Line 4:

	[[File:Exe.gif]] [http://www.unitedbytes.de/download.php?file=nsisMultiMon110 nsisMultiMon-1_1_0.zip] (12 KB)		[[File:Exe.gif]] [http://www.unitedbytes.de/download.php?file=nsisMultiMon110 nsisMultiMon-1_1_0.zip] (12 KB)

			[http://forums.winamp.com/showthread.php?s=&threadid=261777 Forum thread]

	[http://www.unitedbytes.de/ United Bytes Website]		[http://www.unitedbytes.de/ United Bytes Website]

Tinsold at 11:35, 16 December 2006

2006-12-16T11:35:48Z

â† Older revision		Revision as of 11:35, 16 December 2006
Line 1:		Line 1:
			{{PageAuthor\|Tinsold}}

	== Links ==		== Links ==

Line 122:		Line 124:

	E-Mail: Please see readme.txt to prevent spam.		E-Mail: Please see readme.txt to prevent spam.

	~~Stuttgart, Germany, 2006~~

	~~--[[User:Tinsold\|Tinsold]] 09:47, 14 December 2006 (PST)~~

Tinsold at 11:34, 16 December 2006

2006-12-16T11:34:49Z

â† Older revision		Revision as of 11:34, 16 December 2006
Line 1:		Line 1:
			== Links ==

			[[File:Exe.gif]] [http://www.unitedbytes.de/download.php?file=nsisMultiMon110 nsisMultiMon-1_1_0.zip] (12 KB)

			[http://www.unitedbytes.de/ United Bytes Website]

	== What Is nsisMultiMon ==		== What Is nsisMultiMon ==

Line 4:		Line 10:

	nsisMultiMon was developed by Andreas Loeffler.		nsisMultiMon was developed by Andreas Loeffler.

	It was tested on Windows 2000 and Windows XP so far.		It was tested on Windows 2000 and Windows XP so far.

Line 113:		Line 120:

	Web: http://www.unitedbytes.de		Web: http://www.unitedbytes.de

	E-Mail: Please see readme.txt to prevent spam.		E-Mail: Please see readme.txt to prevent spam.

Tinsold at 17:47, 14 December 2006

2006-12-14T17:47:41Z

New page

== What Is nsisMultiMon ==

nsisMultiMon is a plugin for NSIS (Nullsoft Scriptable Install System) that provides easy multi monitor management for installers. With this plugin, you can determine the number of monitors, get various coordinates and sizes, monitor namings or simply put the complete installer on another connected monitor.

nsisMultiMon was developed by Andreas Loeffler.
It was tested on Windows 2000 and Windows XP so far.

Please check out my homepage at http://www.unitedbytes.de or http://nsis.sourceforge.net for further updates of nsisMultiMon.

== Usage And Installation ==

Simply copy the nsisMultiMon.dll in the "Plugins" folder of the NSIS installation directory. If you don't want to put it there, you have to add a "!addplugindir" directive on the top of your install script. Read the NSIS manual for more information.

== Reference ==

'''Examples'''

Please also consider the provided example script "ExampleMultiMon.nsi" for how to use the above functions in a real world installer.

== Available functions ==

'''nsisMultiMon::GetAllMonitorCount'''

Description:
Returns all available monitors.

Return values:
$R0 = Number of all available monitors.

'''nsisMultiMon::GetActiveMonitorCount'''

Description:
Returns all active monitors.

Return values:
$R0 = Number of all active monitors.

'''nsisMultiMon::GetVirtualDesktopRect'''

Description:
Returns the position and size of the virtual desktop (all monitors).

Return values:
$R0,$R1 = Start X, Start Y
$R2,$R3 = Size X, Size Y

'''nsisMultiMon::GetMonitorRect [ID:int]'''

Description:
Returns the rectangle of the monitor with the given ID (zero-based).

Return values:
$R0,$R1 = Left, Top
$R2,$R3 = Right, Bottom

'''nsisMultiMon::GetWorkArea [ID:int]'''

Description:
Returns the work area of the monitor with the given ID (zero-based).
Note: The work area is the "pure" desktop without task bar and other
status bars docked to the desktop.

Return values:
$R0,$R1 = Left, Top
$R2,$R3 = Right, Bottom

'''nsisMultiMon::IsPointOnMonitor [ID:int] [X:int] [Y:int]'''

Description:
Verifies if the given point X,Y is on the monitor with the given
ID (zero-based).

Return values:
$R0 = "true" means, that the point is on the given monitor.
$R0 = "false" means, that the point is NOT on the given monitor.

'''nsisMultiMon::GetMonitorName [ID:int]'''

Description:
Returns the name of the monitor with the given ID (zero-based).

Return values:
$R0 = Name of the monitor.

'''nsisMultiMon::CenterInstallerOnMonitor [ID:int] [UseWorkarea:int]'''

Description:
Centers the installer window on the monitor with the
given ID (zero-based).

If parameter "UseWorkarea" is 0, the window will be centered on
the monitor's real coordinates & sizes.

If parameter "UseWorkarea" is 1, the window will be centered on
the monitor's workspace.

Note: The work area is the "pure" desktop without task bar and other
status bars docked to the desktop.

== Version History ==

'''v1.1.0 - 06/12/14'''

First public version.

== License ==

nsisMultiMon is Freeware.

== Contact ==

nsisMultiMon was developed in C++ by Andreas Loeffler in December 2006.

Web: http://www.unitedbytes.de
E-Mail: Please see readme.txt to prevent spam.

Stuttgart, Germany, 2006

--[[User:Tinsold|Tinsold]] 09:47, 14 December 2006 (PST)