SelectionNext - hossimo/GMA3Plugins GitHub Wiki

SelectionNext(int: current) : int, int, int, int

Brief:

Returns the first selected fxtures SubfixtureIndex, X, Y and, Z grid positions. The Fixtures subfixture ID is a representation of the fixture within the patch and does not directly reflect the fixtures FID or CID, for example. A fixture with no FID or CID still does have a valid SubfixtureIndex.

Paramiters:

Name	Description	Optional
int:current	an int that represents the current selected SubfixtureIndex

Returns:

int, int, int, int : SubfixtureIndex, GridX, GridY, GridZ

Returns nil after the last selected fixture.

Examples:

Patched Fixtures:

FID	Gird	Description
101	0/0/0	Dimmer 1
102	1/0/0	Dimmer 2
103	0/1/0	Dimmer 3
104	1/1/0	Dimmer 4

Fixture 1 thru 4

local index, x, y, z = SelectionFirst()
Echo("index: %d %d/%d/%d", index, x, y, z) -- index: 1 0/0/0
index, x, y, z = SelectionNext(index)
Echo("index: %d %d/%d/%d", index, x, y, z) -- index: 2 1/0/0