dmxlog.h File Reference

Go to the source code of this file.

Enumerations

enum  dmxLogLevel {
  dmxDebug, dmxInfo, dmxWarning, dmxError,
  dmxFatal
}

Functions

dmxLogLevel dmxSetLogLevel (dmxLogLevel newLevel)
dmxLogLevel dmxGetLogLevel (void)
void dmxLog (dmxLogLevel logLevel, const char *format,...)
void dmxLogCont (dmxLogLevel logLevel, const char *format,...)
const char * dmxEventName (int type)
void dmxLogOutput (DMXScreenInfo *dmxScreen, const char *format,...)
void dmxLogOutputCont (DMXScreenInfo *dmxScreen, const char *format,...)
void dmxLogOutputWarning (DMXScreenInfo *dmxScreen, const char *format,...)
void dmxLogInput (DMXInputInfo *dmxInput, const char *format,...)
void dmxLogInputCont (DMXInputInfo *dmxInput, const char *format,...)
void dmxLogArgs (dmxLogLevel logLevel, int argc, char **argv)
void dmxLogVisual (DMXScreenInfo *dmxScreen, XVisualInfo *vi, int defaultVisual)
const char * dmxXInputEventName (int type)

Detailed Description

This header is included by all files that need to use the DMX logging facilities.


Enumeration Type Documentation

Logging levels -- output is tunable with dmxSetLogLevel.

Enumerator:
dmxDebug 

Usually verbose debugging info

dmxInfo 

Non-warning information

dmxWarning 

A warning that may indicate DMX will not function as the user intends.

dmxError 

A non-fatal error that probably indicates DMX will not function as desired.

dmxFatal 

A fatal error that will cause DMX to shut down.


Function Documentation

const char* dmxEventName ( int  type)

Translate an event type into a human-readable string.

Referenced by dmxConsoleUpdateFineCursor(), dmxDump(), and dmxEnqueue().

dmxLogLevel dmxGetLogLevel ( void  )

Returns the log level set by dmxLogLevel.

References dmxCurrentLogLevel.

void dmxLog ( dmxLogLevel  logLevel,
const char *  format,
  ... 
)

Log the specified message at the specified logLevel. format can be a printf-like format expression.

References dmxHeader(), and dmxMessage().

Referenced by ddxProcessArgument(), dmxAddDevice(), dmxAttachScreen(), dmxBackendCollectEvents(), dmxBackendInitPrivate(), dmxBECreateColormap(), dmxBECreateCursor(), dmxBELoadFont(), dmxBERestorePixmap(), dmxBERestoreRenderGlyph(), dmxBESavePixmap(), dmxCheckFunctionKeys(), dmxCheckSpecialKeys(), dmxCommonOthOn(), dmxCommonRestoreState(), dmxComputeWidthHeight(), dmxConfigAddDisplay(), dmxConfigAddInput(), dmxConfigConfigure(), dmxConfigCopyData(), dmxConfigCopyFromWall(), dmxConfigFromCommandLine(), dmxConfigFromConfigFile(), dmxConfigReadFile(), dmxConfigStoreConfig(), dmxConfigStoreDisplay(), dmxConfigStoreFile(), dmxConfigStoreInput(), dmxConfigStoreXInput(), dmxConfigWriteFile(), dmxConnectionBlockCallback(), dmxConsoleCreateEmptyCursor(), dmxConsoleDrawWindows(), dmxConsoleFunctions(), dmxConsoleInit(), dmxConsoleUpdateFineCursor(), dmxDetachScreen(), dmxDeviceOnOff(), dmxDisplayInit(), dmxErrorHandler(), dmxFixup(), dmxGetButtonMapping(), dmxGetFontPath(), dmxInitOrigins(), dmxInitOverlap(), dmxInputCopyLocal(), dmxInputInit(), dmxInputLogDevices(), dmxLogArgs(), dmxLogVisual(), dmxMapInsert(), dmxOnScreen(), dmxPopulateLocal(), dmxPropertyCheckOtherWindows(), dmxPropertyIterate(), dmxPropertySameDisplay(), dmxPropertyWindow(), dmxReInitOrigins(), dmxSigioRegister(), dmxStatCallback(), dmxSwitchReturn(), dmxSync(), dmxSyncInit(), dmxTranslateAndEnqueueExtEvent(), dmxTryComputeScreenOrigins(), dmxUpdateWindowInformation(), dmxWakeupHandler(), InitInput(), InitOutput(), and othUSBGetInfo().

void dmxLogArgs ( dmxLogLevel  logLevel,
int  argc,
char **  argv 
)

Print argc messages, each describing an element in argv. This is maingly for debugging purposes.

References dmxLog().

void dmxLogCont ( dmxLogLevel  logLevel,
const char *  format,
  ... 
)

Continue a log message without printing the message prefix.

References dmxMessage().

Referenced by dmxInputLogDevices(), and dmxStatCallback().

void dmxLogInput ( DMXInputInfo dmxInput,
const char *  format,
  ... 
)

Log an informational message (at level dmxInfo) related to input. The message prefix will contain information from dmxInput.

References dmxHeader(), dmxInfo, and dmxMessage().

Referenced by dmxAddDevice(), dmxCommonKbdGetInfo(), dmxCommonRestoreState(), dmxCommonSaveState(), dmxEnqueue(), dmxInputAttachBackend(), dmxInputAttachConsole(), dmxInputAttachOld(), dmxInputDetach(), dmxInputInit(), dmxInputScanForExtensions(), and dmxKeyboardOn().

void dmxLogInputCont ( DMXInputInfo dmxInput,
const char *  format,
  ... 
)

Continue a message related to input without printing the message prefix.

References dmxInfo, and dmxMessage().

Referenced by dmxKeyboardOn().

void dmxLogOutput ( DMXScreenInfo dmxScreen,
const char *  format,
  ... 
)

Log an informational message (at level dmxInfo) related to ouput. The message prefix will contain backend information from dmxScreen.

References dmxHeader(), dmxInfo, and dmxMessage().

Referenced by _dmxDPMSInit(), dmxAttachScreen(), dmxDetachScreen(), dmxGetScreenAttribs(), dmxInitOrigins(), dmxInitOverlap(), dmxLogVisual(), dmxPrintScreenInfo(), dmxPropertyCheckOtherServers(), and dmxReInitOrigins().

void dmxLogOutputCont ( DMXScreenInfo dmxScreen,
const char *  format,
  ... 
)

Continue a message related to output without printing the message prefix.

References dmxInfo, and dmxMessage().

Referenced by dmxInitOverlap(), dmxPrintOverlap(), and dmxPrintScreenInfo().

void dmxLogOutputWarning ( DMXScreenInfo dmxScreen,
const char *  format,
  ... 
)

Log a warning message (at level dmxWarning) related to output. The message prefix will contain backend information from dmxScreen.

References dmxHeader(), dmxMessage(), and dmxWarning.

Referenced by dmxGetScreenAttribs(), dmxPrintScreenInfo(), and dmxPropertyCheckOtherServers().

void dmxLogVisual ( DMXScreenInfo dmxScreen,
XVisualInfo *  vi,
int  defaultVisual 
)

Print messages at level dmxInfo describing the visuals in vi.

References dmxInfo, dmxLog(), and dmxLogOutput().

Referenced by dmxConnectionBlockCallback(), and dmxGetVisualInfo().

dmxLogLevel dmxSetLogLevel ( dmxLogLevel  newLevel)

Set the default level for logging to dmxLogLevel. Returns the previous log level.

References dmxCurrentLogLevel, and dmxFatal.

const char* dmxXInputEventName ( int  type)

Translate a (normalized) XInput event type into a human-readable string.