/**
* <summary>
* Changes the display orientation.
* <para>
* Remember to call the <c>saveToFlash()</c>
* method of the module if the modification must be kept.
* </para>
* <para>
* </para>
* </summary>
* <param name="newval">
* a value among <c>YDisplay.ORIENTATION_LEFT</c>, <c>YDisplay.ORIENTATION_UP</c>,
* <c>YDisplay.ORIENTATION_RIGHT</c> and <c>YDisplay.ORIENTATION_DOWN</c> corresponding to the display orientation
* </param>
* <para>
* </para>
* <returns>
* <c>0</c> if the call succeeds.
* </returns>
* <para>
* On failure, throws an exception or returns a negative error code.
* </para>
*/
public int set_orientation(int newval)
{
if (_func == null)
{
throw new YoctoApiProxyException("No Display connected");
}
if (newval == _Orientation_INVALID)
{
return(YAPI.SUCCESS);
}
// our enums start at 0 instead of the 'usual' -1 for invalid
return(_func.set_orientation(newval - 1));
}