iConsoleOutput Struct Reference
This is the Crystal Space Console interface. More...
#include <ivaria/conout.h>
Inheritance diagram for iConsoleOutput:

Public Member Functions | |
virtual void | AutoUpdate (bool autoUpdate)=0 |
Enable or disable automatic console updates. | |
virtual void | Clear (bool wipe=false)=0 |
Clear console. | |
virtual void | Draw2D (csRect *oRect=0)=0 |
Display the console and return the dirty rectangle. | |
virtual void | Draw3D (csRect *oRect=0)=0 |
Update the 3D part of the console on the window. | |
virtual int | GetCursorStyle () const =0 |
Retrieve the cursor style. | |
virtual iFont * | GetFont () const =0 |
Gets the current font. | |
virtual const char * | GetLine (int line=-1) const =0 |
Return a line from the buffer. | |
virtual int | GetMaxLineWidth ()=0 |
Query maximal line width in characters. | |
virtual int | GetTopLine () const =0 |
Get the current top line being displayed. | |
virtual bool | GetTransparency () const =0 |
Retrieve the transparency setting. | |
virtual bool | GetVisible ()=0 |
Query whether the console is visible or hidden. | |
virtual bool | PerformExtension (const char *command,...)=0 |
Implement simple extension commands. | |
virtual bool | PerformExtensionV (const char *command, va_list)=0 |
Implement simple extension commands. | |
virtual void | PutText (const char *text,...)=0 |
Put some text to the console. | |
virtual void | PutTextV (const char *text, va_list args)=0 |
Var_args version of PutText. | |
virtual void | RegisterWatcher (iConsoleWatcher *)=0 |
Tell console that this object should be notified when console visibility status changes. | |
virtual void | ScrollTo (int topLine, bool snap=true)=0 |
Set the current top line, or use of the constants above for scrolling. | |
virtual void | SetBufferSize (int maxLines)=0 |
Set the buffer size in lines. | |
virtual void | SetCursorPos (int charNo)=0 |
Set cursor horizontal position (-1 == follow output). | |
virtual void | SetCursorStyle (int style)=0 |
Assign the cursor style. | |
virtual void | SetFont (iFont *font)=0 |
Sets the font. | |
virtual void | SetTransparency (bool transp)=0 |
Set transparency. | |
virtual void | SetVisible (bool show)=0 |
Show/hide the console. |
Detailed Description
This is the Crystal Space Console interface.It is an output only system. It can be used in conjunction with the iConsoleInput interface to form an interactive console.
Main creators of instances implementing this interface:
- Simple output console plugin (crystalspace.console.output.simple)
- Standard output console plugin (crystalspace.console.output.standard)
- Fancy output console plugin (crystalspace.console.output.fancy)
Main ways to get pointers to this interface:
Main users of this interface:
Definition at line 83 of file conout.h.
Member Function Documentation
|
Enable or disable automatic console updates. When the console is in console auto-update mode, it automatically calls BeginDraw/Console->Draw methods on every PutText call. Otherwise it is your responsability to call Draw() at appropiate times. Initially this mode is enabled. Note that some implementations of the output consoles may be thread-safe. But in that case you MUST use AutoUpdate(false) because access to graphics is not thread-safe. |
|
Clear console.
|
|
Display the console and return the dirty rectangle. The graphics driver should be in 2D draw mode. Only call this function from the same thread that maintains the graphics subsystem!
|
|
Update the 3D part of the console on the window. The graphics driver should be in 3D draw mode. Only call this function from the same thread that maintains the graphics subsystem!
|
|
Retrieve the cursor style.
|
|
Gets the current font.
|
|
Return a line from the buffer.
|
|
Query maximal line width in characters.
|
|
Get the current top line being displayed.
|
|
Retrieve the transparency setting.
|
|
Query whether the console is visible or hidden.
|
|
Implement simple extension commands.
|
|
Implement simple extension commands.
|
|
Put some text to the console. Console acts like a simple TTY and should interpret basical symbols like '\n' and '\b'. The '\r' character has a special meaning: it sets a flag that tells console to clear the current line before next character is output. That is, you can emmit non-persistent messages this way: PutText ("some text@\r"); This message will disappear as soon as any other message will be sent to console. Remember that if you are not using the printf-style functionality, and the string may include '' signs, you should do PutText("%s", str) instead of PutText(str). |
|
Var_args version of PutText.
|
|
Tell console that this object should be notified when console visibility status changes.
|
|
Set the current top line, or use of the constants above for scrolling.
|
|
Set the buffer size in lines.
|
|
Set cursor horizontal position (-1 == follow output).
|
|
Assign the cursor style.
|
|
Sets the font.
|
|
Set transparency.
|
|
Show/hide the console. In 'hidden' state console should not display anything at all (when Draw() is called) or draw some minimal information |
The documentation for this struct was generated from the following file:
- ivaria/conout.h
Generated for Crystal Space by doxygen 1.4.6