Functions
PianoRoll *	GuidoAR2PianoRoll (PianoRollType type, ARHandler arh)
	Creates a new piano roll from AR, corresponding to type : simplePianoRoll -> basic piano roll trajectoryPianoRoll -> every event is graphically linked to the previous one.
PianoRoll *	GuidoMidi2PianoRoll (PianoRollType type, const char *midiFileName)
	Creates a new piano roll from Midi, corresponding to type : simplePianoRoll -> basic piano roll trajectoryPianoRoll -> every event is graphically linked to the previous one.
GuidoErrCode	GuidoDestroyPianoRoll (PianoRoll *pr)
	Destroys a guido piano roll and releases all the associated ressources.
GuidoErrCode	GuidoPianoRollSetLimits (PianoRoll *pr, LimitParams limitParams)
	Sets limits to a piano roll (start/end date, lower/higher pitch)
GuidoErrCode	GuidoPianoRollEnableKeyboard (PianoRoll *pr, bool enabled)
	Enables keyboard or not (not enabled by default)
GuidoErrCode	GuidoPianoRollGetKeyboardWidth (PianoRoll *pr, int height, float &keyboardWidth)
	Gets the piano roll keyboard width.
GuidoErrCode	GuidoPianoRollEnableAutoVoicesColoration (PianoRoll *pr, bool enabled)
	Enables or not the automatic voices coloration (not enabled by default) (not for a midi rendering) // REM: � voir If a color is manually set with GuidoPianoRollSetColorToVoice, automatic color will not be applied for this voice.
GuidoErrCode	GuidoPianoRollSetRGBColorToVoice (PianoRoll *pr, int voiceNum, int r, int g, int b, int a)
	Sets a RGB color to a voice (first voice is number 1) (black by default)
GuidoErrCode	GuidoPianoRollSetHtmlColorToVoice (PianoRoll *pr, int voiceNum, long color)
	Sets a html color to a voice (first voice is number 1) (black by default)
GuidoErrCode	GuidoPianoRollEnableMeasureBars (PianoRoll *pr, bool enabled)
	Enables or not measure bars (false by default)
GuidoErrCode	GuidoPianoRollSetPitchLinesDisplayMode (PianoRoll *pr, int mode)
	Sets the pitch lines display mode (automatic by default). Use Pitch lines display mode constants to pick lines which will be be displayed. Example : "kCLine + kGLine" will displayed C and G line. "kNoLine" doesn't display any line. "kAutoLines" adjust line display according to piano roll pitch range (automatic possibilities : no line, C line, C and G line, chromatic scale, diatonic scale);.
GuidoErrCode	GuidoPianoRollGetMap (PianoRoll *pr, int width, int height, Time2GraphicMap &outmap)
	Gets the piano roll map.
GuidoErrCode	GuidoPianoRollOnDraw (PianoRoll pr, int width, int height, VGDevice dev)
	Draw the piano roll on a VGDevice.

Function Documentation

PianoRoll* GuidoAR2PianoRoll	(	PianoRollType	type,
		ARHandler	arh
	)

Creates a new piano roll from AR, corresponding to type : simplePianoRoll -> basic piano roll trajectoryPianoRoll -> every event is graphically linked to the previous one.

Parameters:

PianoRollType	the piano roll type
arh	an AR handler

Returns:: a guido piano roll.

PianoRoll* GuidoMidi2PianoRoll	(	PianoRollType	type,
		const char *	midiFileName
	)

Creates a new piano roll from Midi, corresponding to type : simplePianoRoll -> basic piano roll trajectoryPianoRoll -> every event is graphically linked to the previous one.

Parameters:

type	the piano roll type
midiFileName	a midi file name

Returns:: a guido piano roll.

GuidoErrCode GuidoDestroyPianoRoll ( PianoRoll * pr )

Destroys a guido piano roll and releases all the associated ressources.

Parameters:

pr	a pianoroll previously created with GuidoAR2PianoRoll or GuidoMidi2PianoRoll

Returns:: a Guido error code

GuidoErrCode GuidoPianoRollSetLimits	(	PianoRoll *	pr,
		LimitParams	limitParams
	)

Sets limits to a piano roll (start/end date, lower/higher pitch)

Parameters:

pr a pianoroll previously created with GuidoAR2PianoRoll or GuidoMidi2PianoRoll

limitParams the structure containing limits : start date (GuidoDate) (0/0 to adjust automatically start date to the score's start date) end date (GuidoDate) (0/0 to adjust automatically end date to the score's end date) minimal pitch (midi notation) (-1 to adjust automatically min pitch to the score's minimal pitch) maximal pitch (midi notation) (-1 to adjust automatically max pitch to the score's maximal pitch) Remark : minimal range pitch accepted is 1 octave.

Returns:: a Guido error code

GuidoErrCode GuidoPianoRollEnableKeyboard	(	PianoRoll *	pr,
		bool	enabled
	)

Enables keyboard or not (not enabled by default)

Parameters:

pr	a pianoroll previously created with GuidoAR2PianoRoll or GuidoMidi2PianoRoll
enabled	a boolean corresponding to the keyboard draw state

Returns:: a Guido error code

GuidoErrCode GuidoPianoRollGetKeyboardWidth	(	PianoRoll *	pr,
		int	height,
		float &	keyboardWidth
	)

Gets the piano roll keyboard width.

Parameters:

pr	a pianoroll previously created with GuidoAR2PianoRoll or GuidoMidi2PianoRoll
height	the height of the canvas (-1 to set the default height : 512)
keyboardWidth	the pianoroll keyboard width

Returns:: a Guido error code

GuidoErrCode GuidoPianoRollEnableAutoVoicesColoration	(	PianoRoll *	pr,
		bool	enabled
	)

Enables or not the automatic voices coloration (not enabled by default) (not for a midi rendering) // REM: � voir If a color is manually set with GuidoPianoRollSetColorToVoice, automatic color will not be applied for this voice.

Parameters:

pr	a pianoroll previously created with GuidoAR2PianoRoll
enabled	a boolean corresponding to the color state

Returns:: a Guido error code

GuidoErrCode GuidoPianoRollSetRGBColorToVoice	(	PianoRoll *	pr,
		int	voiceNum,
		int	r,
		int	g,
		int	b,
		int	a
	)

Sets a RGB color to a voice (first voice is number 1) (black by default)

Parameters:

pr	a pianoroll previously created with GuidoAR2PianoRoll or GuidoMidi2PianoRoll
voiceNum	the voice number (first voice is number 1)
r	the red param of RGB color
g	the green param of RGB color
b	the blue param of RGB color
a	the alpha param of RGB color

Returns:: a Guido error code

GuidoErrCode GuidoPianoRollSetHtmlColorToVoice	(	PianoRoll *	pr,
		int	voiceNum,
		long	color
	)

Sets a html color to a voice (first voice is number 1) (black by default)

Parameters:

pr	a pianoroll previously created with GuidoAR2PianoRoll or GuidoMidi2PianoRoll
voiceNum	the voice number (first voice is number 1)
color	the html color (constants are defined in Colors.h)

Returns:: a Guido error code

GuidoErrCode GuidoPianoRollEnableMeasureBars	(	PianoRoll *	pr,
		bool	enabled
	)

Enables or not measure bars (false by default)

Parameters:

pr	a pianoroll previously created with GuidoAR2PianoRoll or GuidoMidi2PianoRoll
enabled	a boolean corresponding to the measure bars draw state

Returns:: a Guido error code

GuidoErrCode GuidoPianoRollSetPitchLinesDisplayMode	(	PianoRoll *	pr,
		int	mode
	)

Sets the pitch lines display mode (automatic by default). Use Pitch lines display mode constants to pick lines which will be be displayed. Example : "kCLine + kGLine" will displayed C and G line. "kNoLine" doesn't display any line. "kAutoLines" adjust line display according to piano roll pitch range (automatic possibilities : no line, C line, C and G line, chromatic scale, diatonic scale);.

Parameters:

pr	a pianoroll previously created with GuidoAR2PianoRoll or GuidoMidi2PianoRoll
mode	an int corresponding to the pitch lines display mode

Returns:: a Guido error code

GuidoErrCode GuidoPianoRollGetMap	(	PianoRoll *	pr,
		int	width,
		int	height,
		Time2GraphicMap &	outmap
	)

Gets the piano roll map.

Parameters:

pr	a pianoroll previously created with GuidoAR2PianoRoll or GuidoMidi2PianoRoll
width	the width of the piano roll (-1 to set the default width : 1024)
height	the height of the canvas (-1 to set the default height : 512)

Returns:: a Guido error code (returns guidoErrBadParameter if keyboard width is higher than width param)

GuidoErrCode GuidoPianoRollOnDraw	(	PianoRoll *	pr,
		int	width,
		int	height,
		VGDevice *	dev
	)

Draw the piano roll on a VGDevice.

Parameters:

pr	a pianoroll previously created with GuidoAR2PianoRoll or GuidoMidi2PianoRoll
width	the width on which piano roll will be drawn (-1 to set the default width : 1024)
height	the height on which piano roll will be drawn (-1 to set the default height : 512)
dev	the device on which piano will be drawn

Returns:: a Guido error code (returns guidoErrBadParameter if keyboard width is higher than width param)

Create a piano roll

Functions

Function Documentation