Regular API function

simAuxiliaryConsoleOpen / sim.auxiliaryConsoleOpen

Description Opens an auxiliary console window for text display. This console window is different from the application main console window. Console window handles are shared across all simulator scenes. See also sim.auxiliaryConsolePrint, sim.auxiliaryConsoleClose and sim.addLog.
C/C++
synopsis
simInt simAuxiliaryConsoleOpen(const simChar* title,simInt maxLines,simInt mode,const simInt* position,const simInt* size,const simFloat* textColor,const simFloat* backgroundColor)
C/C++
parameters
title: the title of the console window
maxLines: the number of text lines that can be displayed and buffered
mode: bit-coded value. Bit0 (1) set indicates that the console window will automatically close at simulation end (when called from a simulation script, the console window will always automatically close at simulation end), bit1 (2) set indicates that lines will be wrapped, bit2 (4) set indicates that the user can close the console window, bit3 (8) is not used, bit4 (16) set indicates that the console will not automatically hide when the user switches to another scene (this only applies when called from an add-on or the sandbox script).
position: the initial position of the console window (x and y value). Can be nullptr
size: the initial size of the console window (x and y value). Can be nullptr
textColor: the color of the text (rgb values, 0-1). Can be nullptr
backgroundColor: the background color of the console window (rgb values, 0-1). Can be nullptr
C/C++
return value
-1 if operation was not successful. Otherwise a console window handle
Lua
synopsis
int consoleHandle=sim.auxiliaryConsoleOpen(string title,int maxLines,int mode,int[2] position=nil,int[2] size=nil,float[3] textColor=nil,float[3] backgroundColor=nil)
Lua
parameters
Similar to the C-function counterpart. Last 4 parameters can be omitted too.
Lua
return values
Similar to the C-function counterpart
Python
synopsis
int consoleHandle=sim.auxiliaryConsoleOpen(string title,int maxLines,int mode,list position=None,list size=None,list textColor=None,list backgroundColor=None)