Main Page | Namespace List | Class Hierarchy | Alphabetical List | Class List | Directories | File List | Namespace Members | Class Members | File Members | Related Pages

Ogre::CompositorScriptCompiler Class Reference

Compiler for parsing & lexing .compositor scripts. More...

#include <OgreCompositorScriptCompiler.h>

Inheritance diagram for Ogre::CompositorScriptCompiler:

Ogre::Compiler2Pass List of all members.

Public Member Functions

 CompositorScriptCompiler (void)
 ~CompositorScriptCompiler (void)
virtual const StringgetClientBNFGrammer (void)
 gets BNF Grammer for Compositor script.
virtual const StringgetClientGrammerName (void) const
 get the name of the Compositor script BNF grammer.
void parseScript (DataStreamPtr &stream, const String &groupName)
 Compile a compositor script from a data stream using a specific resource group name.
bool compile (const String &source, const String &sourceName)
 compile the source - performs 2 passes.

Protected Types

typedef void(CompositorScriptCompiler::* CSC_Action )(void)
typedef std::map< size_t,
CSC_Action
TokenActionMap
typedef TokenActionMap::iterator TokenActionIterator
enum  TokenID {
  ID_UNKOWN = 0, ID_OPENBRACE, ID_CLOSEBRACE, ID_COMPOSITOR,
  ID_TECHNIQUE, ID_TEXTURE, ID_TARGET_WIDTH, ID_TARGET_HEIGHT,
  ID_PF_A8R8G8B8, ID_PF_R8G8B8A8, ID_PF_R8G8B8, ID_PF_FLOAT16_R,
  ID_PF_FLOAT16_RGB, ID_PF_FLOAT16_RGBA, ID_PF_FLOAT32_R, ID_PF_FLOAT32_RGB,
  ID_PF_FLOAT32_RGBA, ID_TARGET, ID_INPUT, ID_TARGET_OUTPUT,
  ID_ONLY_INITIAL, ID_VISIBILITY_MASK, ID_LOD_BIAS, ID_MATERIAL_SCHEME,
  ID_PREVIOUS, ID_NONE, ID_PASS, ID_MATERIAL,
  ID_RENDER_QUAD, ID_CLEAR, ID_STENCIL, ID_RENDER_SCENE,
  ID_FIRST_RQ, ID_LAST_RQ, ID_IDENTIFIER, ID_CLR_BUFF,
  ID_CLR_COLOUR, ID_CLR_DEPTH, ID_CLR_COLOUR_VAL, ID_CLR_DEPTH_VAL,
  ID_CLR_STENCIL_VAL, ID_ST_CHECK, ID_ST_FUNC, ID_ST_REF_VAL,
  ID_ST_MASK, ID_ST_FAILOP, ID_ST_DEPTH_FAILOP, ID_ST_PASSOP,
  ID_ST_TWOSIDED, ID_ST_ALWAYS_FAIL, ID_ST_ALWAYS_PASS, ID_ST_LESS,
  ID_ST_LESS_EQUAL, ID_ST_EQUAL, ID_ST_NOT_EQUAL, ID_ST_GREATER_EQUAL,
  ID_ST_GREATER, ID_ST_KEEP, ID_ST_ZERO, ID_ST_REPLACE,
  ID_ST_INCREMENT, ID_ST_DECREMENT, ID_ST_INCREMENT_WRAP, ID_ST_DECREMENT_WRAP,
  ID_ST_INVERT, ID_ON, ID_OFF, ID_TRUE,
  ID_FALSE
}
enum  CompositorScriptSection {
  CSS_NONE, CSS_COMPOSITOR, CSS_TECHNIQUE, CSS_TARGET,
  CSS_PASS
}
 Enum to identify compositor sections. More...
typedef std::vector< TokenRule > TokenRuleContainer
typedef TokenRuleContainer::iterator TokenRuleIterator
typedef std::vector< LexemeTokenDef > LexemeTokenDefContainer
typedef LexemeTokenDefContainer::iterator LexemeTokenDefIterator
typedef std::map< std::string,
size_t > 
LexemeTokenMap
typedef LexemeTokenMap::iterator TokenKeyIterator
typedef std::vector< TokenInst > TokenInstContainer
typedef TokenInstContainer::iterator TokenInstIterator
enum  OperationType {
  otUNKNOWN, otRULE, otAND, otOR,
  otOPTIONAL, otREPEAT, otDATA, otNOT_TEST,
  otINSERT_TOKEN, otEND
}
enum  SystemRuleToken { _no_token_ = SystemTokenBase, _character_, _value_, _no_space_skip_ }
enum  BNF_ID {
  BNF_UNKOWN = 0, BNF_SYNTAX, BNF_RULE, BNF_IDENTIFIER,
  BNF_IDENTIFIER_RIGHT, BNF_IDENTIFIER_CHARACTERS, BNF_ID_BEGIN, BNF_ID_END,
  BNF_CONSTANT_BEGIN, BNF_SET_RULE, BNF_EXPRESSION, BNF_AND_TERM,
  BNF_OR_TERM, BNF_TERM, BNF_TERM_ID, BNF_CONSTANT,
  BNF_OR, BNF_TERMINAL_SYMBOL, BNF_TERMINAL_START, BNF_REPEAT_EXPRESSION,
  BNF_REPEAT_BEGIN, BNF_REPEAT_END, BNF_SET, BNF_SET_BEGIN,
  BNF_SET_END, BNF_NOT_TEST, BNF_NOT_TEST_BEGIN, BNF_CONDITIONAL_TOKEN_INSERT,
  BNF_OPTIONAL_EXPRESSION, BNF_NOT_EXPRESSION, BNF_NOT_CHK, BNF_OPTIONAL_BEGIN,
  BNF_OPTIONAL_END, BNF_NO_TOKEN_START, BNF_SINGLEQUOTE, BNF_SINGLE_QUOTE_EXC,
  BNF_SET_END_EXC, BNF_ANY_CHARACTER, BNF_SPECIAL_CHARACTERS1, BNF_SPECIAL_CHARACTERS2,
  BNF_WHITE_SPACE_CHK, BNF_LETTER, BNF_LETTER_DIGIT, BNF_DIGIT,
  BNF_WHITE_SPACE, BNF_ALPHA_SET, BNF_NUMBER_SET, BNF_SPECIAL_CHARACTER_SET1,
  BNF_SPECIAL_CHARACTER_SET2, BNF_SPECIAL_CHARACTER_SET3, BNF_NOT_CHARS
}

Protected Member Functions

virtual void executeTokenAction (const size_t tokenID)
 Execute an Action associated with a token.
virtual void setupTokenDefinitions (void)
 Associate all the lexemes used in a material script with their corresponding tokens and actions.
void addLexemeTokenAction (const String &lexeme, const size_t token, const CSC_Action action=0)
void logParseError (const String &error)
void parseOpenBrace (void)
void parseCloseBrace (void)
void parseCompositor (void)
void parseTechnique (void)
void parseTexture (void)
void parseTarget (void)
void parseInput (void)
void parseTargetOutput (void)
void parseOnlyInitial (void)
void parseVisibilityMask (void)
void parseLodBias (void)
void parseMaterialScheme (void)
void parsePass (void)
void parseMaterial (void)
void parseFirstRenderQueue (void)
void parseLastRenderQueue (void)
void parseIdentifier (void)
void parseClearBuffers (void)
void parseClearColourValue (void)
void parseClearDepthValue (void)
void parseClearStencilValue (void)
void parseStencilCheck (void)
void parseStencilFunc (void)
void parseStencilRefVal (void)
void parseStencilMask (void)
void parseStencilFailOp (void)
void parseStencilDepthFailOp (void)
void parseStencilPassOp (void)
void parseStencilTwoSided (void)
StencilOperation extractStencilOp (void)
CompareFunction extractCompareFunc (void)
bool doPass1 ()
 perform pass 1 of compile process scans source for lexemes that can be tokenized and then performs general semantic and context verification on each lexeme before it is tokenized.
bool doPass2 ()
 performs Pass 2 of compile process which is execution of the tokens
Remarks:
Pass 2 takes the token instructions generated in Pass 1 and builds the application specific instructions along with verifying symantic and context rules that could not be checked in Pass 1.

const TokenInst & getNextToken (const size_t expectedTokenID=0) const
 Gets the next token from the instruction que.
const TokenInst & getCurrentToken (const size_t expectedTokenID=0) const
 Gets the current token from the instruction que.
bool testNextTokenID (const size_t expectedTokenID) const
 If a next token instruction exist then test if its token ID matches.
bool testCurrentTokenID (const size_t expectedTokenID) const
 If a current token instruction exist then test if its token ID matches.
void skipToken (void) const
 skip to the next token in the pass2 queue.
void replaceToken (void)
 go back to the previous token in the pass2 queue.
float getNextTokenValue (void) const
 Gets the next token's associated floating point value in the instruction que that was parsed from the text source.
float getCurrentTokenValue (void) const
 Gets the current token's associated floating point value in the instruction que that was parsed from the text source.
const StringgetNextTokenLabel (void) const
 Gets the next token's associated text label in the instruction que that was parsed from the text source.
const StringgetCurrentTokenLabel (void) const
 Gets the next token's associated text label in the instruction que that was parsed from the text source.
size_t getNextTokenID (void) const
 Get the next token's ID value.
size_t getCurrentTokenID (void) const
 Get the current token's ID value.
const StringgetNextTokenLexeme (void) const
 Get the next token's lexeme string.
const StringgetCurrentTokenLexeme (void) const
 Get the current token's lexeme string.
size_t getPass2TokenQueCount (void) const
 Gets the number of tokens waiting in the instruction que that need to be processed by an token action in pass 2.
size_t getRemainingTokensForAction (void) const
 Get the number of tokens not processed by action token.
void setPass2TokenQuePosition (size_t pos, const bool activateAction=false)
 Manualy set the Pass2 Token que position.
size_t getPass2TokenQuePosition (void) const
 Get the current position in the Pass2 Token Que.
bool setNextActionQuePosition (size_t pos, const bool search=false)
 Set the position of the next token action in the Pass2 Token Que.
void addLexemeToken (const String &lexeme, const size_t token, const bool hasAction=false, const bool caseSensitive=false)
 Add a lexeme token association.
void setClientBNFGrammer (void)
 Sets up the parser rules for the client based on the BNF Grammer text passed in.
void findEOL ()
 find the eol charater
bool isFloatValue (float &fvalue, size_t &charsize) const
 check to see if the text at the present position in the source is a numerical constant
bool isCharacterLabel (const size_t rulepathIDX)
 Check if source at current position is supposed to be a user defined character label.
bool isLexemeMatch (const String &lexeme, const bool caseSensitive) const
 check to see if the text is in the lexeme text library
bool positionToNextLexeme ()
 position to the next possible valid sysmbol
bool processRulePath (size_t rulepathIDX)
 process input source text using rulepath to determine allowed tokens
void setActiveContexts (const uint contexts)
 setup ActiveContexts - should be called by subclass to setup initial language contexts
void skipComments ()
 comment specifiers are hard coded
void skipEOL ()
 find end of line marker and move past it
void skipWhiteSpace ()
 skip all the white space which includes spaces and tabs
bool ValidateToken (const size_t rulepathIDX, const size_t activeRuleID)
 check if current position in source has the lexeme text equivalent to the TokenID
void verifyTokenRuleLinks (const String &grammerName)
 scan through all the rules and initialize token definition with index to rules for non-terminal tokens.
void checkTokenActionTrigger (void)
 Checks the last token instruction and if it has an action then it triggers the action of the previously found token having an action.
String getBNFGrammerTextFromRulePath (size_t ruleID, const size_t level=0)
 Get the text representation of the rule path.

Protected Attributes

CompositorScriptContext mScriptContext
TokenState * mClientTokenState
TokenState * mActiveTokenState
 Active token que, definitions, rules currntly being used by parser.
size_t mPass2TokenQuePosition
 the location within the token instruction container where pass 2 is
size_t mPreviousActionQuePosition
 the que position of the previous token that had an action.
size_t mNextActionQuePosition
 the que position for the next token that has an action.
const StringmSource
 pointer to the source to be compiled
String mSourceName
 name of the source to be compiled
size_t mEndOfSource
size_t mCurrentLine
size_t mCharPos
 current line number in source being tokenized
size_t mErrorCharPos
 position in current line in source being tokenized
std::map< size_t, float > mConstants
 storage container for constants defined in source container uses Token index as a key associated with a float constant
std::map< size_t, StringmLabels
 storage container for string labels defined in source container uses Token index as a key associated with a label
bool mLabelIsActive
 flag indicates when a label is being parsed.
size_t mActiveLabelKey
 the key of the active label being built during pass 1.
bool mNoSpaceSkip
 flag being true indicates that spaces are not to be skipped automatically gets set to false when mLabelIsActive goes to false
bool mNoTerminalToken
 if flag is true then next terminal token is not added to token que if found but does effect rule path flow
size_t mInsertTokenID
 TokenID to insert if next rule finds a terminal token if zero then no token inserted.
uint mActiveContexts
 Active Contexts pattern used in pass 1 to determine which tokens are valid for a certain context.

Static Protected Attributes

static TokenRule compositorScript_RulePath []
static String compositorScript_BNF
static TokenActionMap mTokenActionMap
 Map of Token value as key to an Action.
static const size_t SystemTokenBase = 1000

Classes

struct  CompositorScriptContext
 Struct for holding the script context while parsing. More...

Detailed Description

Compiler for parsing & lexing .compositor scripts.

Definition at line 38 of file OgreCompositorScriptCompiler.h.


Member Typedef Documentation

typedef void(CompositorScriptCompiler::* Ogre::CompositorScriptCompiler::CSC_Action)(void) [protected]
 

Definition at line 135 of file OgreCompositorScriptCompiler.h.

typedef std::vector<LexemeTokenDef> Ogre::Compiler2Pass::LexemeTokenDefContainer [protected, inherited]
 

Definition at line 221 of file OgreCompiler2Pass.h.

typedef LexemeTokenDefContainer::iterator Ogre::Compiler2Pass::LexemeTokenDefIterator [protected, inherited]
 

Definition at line 222 of file OgreCompiler2Pass.h.

typedef std::map<std::string, size_t> Ogre::Compiler2Pass::LexemeTokenMap [protected, inherited]
 

Definition at line 224 of file OgreCompiler2Pass.h.

typedef TokenActionMap::iterator Ogre::CompositorScriptCompiler::TokenActionIterator [protected]
 

Definition at line 137 of file OgreCompositorScriptCompiler.h.

typedef std::map<size_t, CSC_Action> Ogre::CompositorScriptCompiler::TokenActionMap [protected]
 

Definition at line 136 of file OgreCompositorScriptCompiler.h.

typedef std::vector<TokenInst> Ogre::Compiler2Pass::TokenInstContainer [protected, inherited]
 

Definition at line 239 of file OgreCompiler2Pass.h.

typedef TokenInstContainer::iterator Ogre::Compiler2Pass::TokenInstIterator [protected, inherited]
 

Definition at line 240 of file OgreCompiler2Pass.h.

typedef LexemeTokenMap::iterator Ogre::Compiler2Pass::TokenKeyIterator [protected, inherited]
 

Definition at line 225 of file OgreCompiler2Pass.h.

typedef std::vector<TokenRule> Ogre::Compiler2Pass::TokenRuleContainer [protected, inherited]
 

Definition at line 170 of file OgreCompiler2Pass.h.

typedef TokenRuleContainer::iterator Ogre::Compiler2Pass::TokenRuleIterator [protected, inherited]
 

Definition at line 171 of file OgreCompiler2Pass.h.


Member Enumeration Documentation

enum Ogre::Compiler2Pass::BNF_ID [protected, inherited]
 

Enumeration values:
BNF_UNKOWN 
BNF_SYNTAX 
BNF_RULE 
BNF_IDENTIFIER 
BNF_IDENTIFIER_RIGHT 
BNF_IDENTIFIER_CHARACTERS 
BNF_ID_BEGIN 
BNF_ID_END 
BNF_CONSTANT_BEGIN 
BNF_SET_RULE 
BNF_EXPRESSION 
BNF_AND_TERM 
BNF_OR_TERM 
BNF_TERM 
BNF_TERM_ID 
BNF_CONSTANT 
BNF_OR 
BNF_TERMINAL_SYMBOL 
BNF_TERMINAL_START 
BNF_REPEAT_EXPRESSION 
BNF_REPEAT_BEGIN 
BNF_REPEAT_END 
BNF_SET 
BNF_SET_BEGIN 
BNF_SET_END 
BNF_NOT_TEST 
BNF_NOT_TEST_BEGIN 
BNF_CONDITIONAL_TOKEN_INSERT 
BNF_OPTIONAL_EXPRESSION 
BNF_NOT_EXPRESSION 
BNF_NOT_CHK 
BNF_OPTIONAL_BEGIN 
BNF_OPTIONAL_END 
BNF_NO_TOKEN_START 
BNF_SINGLEQUOTE 
BNF_SINGLE_QUOTE_EXC 
BNF_SET_END_EXC 
BNF_ANY_CHARACTER 
BNF_SPECIAL_CHARACTERS1 
BNF_SPECIAL_CHARACTERS2 
BNF_WHITE_SPACE_CHK 
BNF_LETTER 
BNF_LETTER_DIGIT 
BNF_DIGIT 
BNF_WHITE_SPACE 
BNF_ALPHA_SET 
BNF_NUMBER_SET 
BNF_SPECIAL_CHARACTER_SET1 
BNF_SPECIAL_CHARACTER_SET2 
BNF_SPECIAL_CHARACTER_SET3 
BNF_NOT_CHARS 

Definition at line 181 of file OgreCompiler2Pass.h.

enum Ogre::CompositorScriptCompiler::CompositorScriptSection [protected]
 

Enum to identify compositor sections.

Enumeration values:
CSS_NONE 
CSS_COMPOSITOR 
CSS_TECHNIQUE 
CSS_TARGET 
CSS_PASS 

Definition at line 109 of file OgreCompositorScriptCompiler.h.

enum Ogre::Compiler2Pass::OperationType [protected, inherited]
 

Enumeration values:
otUNKNOWN 
otRULE 
otAND 
otOR 
otOPTIONAL 
otREPEAT 
otDATA 
otNOT_TEST 
otINSERT_TOKEN 
otEND 

Definition at line 154 of file OgreCompiler2Pass.h.

enum Ogre::Compiler2Pass::SystemRuleToken [protected, inherited]
 

Enumeration values:
_no_token_ 
_character_ 
_value_ 
_no_space_skip_ 

Definition at line 174 of file OgreCompiler2Pass.h.

enum Ogre::CompositorScriptCompiler::TokenID [protected]
 

Enumeration values:
ID_UNKOWN 
ID_OPENBRACE 
ID_CLOSEBRACE 
ID_COMPOSITOR 
ID_TECHNIQUE 
ID_TEXTURE 
ID_TARGET_WIDTH 
ID_TARGET_HEIGHT 
ID_PF_A8R8G8B8 
ID_PF_R8G8B8A8 
ID_PF_R8G8B8 
ID_PF_FLOAT16_R 
ID_PF_FLOAT16_RGB 
ID_PF_FLOAT16_RGBA 
ID_PF_FLOAT32_R 
ID_PF_FLOAT32_RGB 
ID_PF_FLOAT32_RGBA 
ID_TARGET 
ID_INPUT 
ID_TARGET_OUTPUT 
ID_ONLY_INITIAL 
ID_VISIBILITY_MASK 
ID_LOD_BIAS 
ID_MATERIAL_SCHEME 
ID_PREVIOUS 
ID_NONE 
ID_PASS 
ID_MATERIAL 
ID_RENDER_QUAD 
ID_CLEAR 
ID_STENCIL 
ID_RENDER_SCENE 
ID_FIRST_RQ 
ID_LAST_RQ 
ID_IDENTIFIER 
ID_CLR_BUFF 
ID_CLR_COLOUR 
ID_CLR_DEPTH 
ID_CLR_COLOUR_VAL 
ID_CLR_DEPTH_VAL 
ID_CLR_STENCIL_VAL 
ID_ST_CHECK 
ID_ST_FUNC 
ID_ST_REF_VAL 
ID_ST_MASK 
ID_ST_FAILOP 
ID_ST_DEPTH_FAILOP 
ID_ST_PASSOP 
ID_ST_TWOSIDED 
ID_ST_ALWAYS_FAIL 
ID_ST_ALWAYS_PASS 
ID_ST_LESS 
ID_ST_LESS_EQUAL 
ID_ST_EQUAL 
ID_ST_NOT_EQUAL 
ID_ST_GREATER_EQUAL 
ID_ST_GREATER 
ID_ST_KEEP 
ID_ST_ZERO 
ID_ST_REPLACE 
ID_ST_INCREMENT 
ID_ST_DECREMENT 
ID_ST_INCREMENT_WRAP 
ID_ST_DECREMENT_WRAP 
ID_ST_INVERT 
ID_ON 
ID_OFF 
ID_TRUE 
ID_FALSE 

Definition at line 67 of file OgreCompositorScriptCompiler.h.


Constructor & Destructor Documentation

Ogre::CompositorScriptCompiler::CompositorScriptCompiler void   ) 
 

Ogre::CompositorScriptCompiler::~CompositorScriptCompiler void   ) 
 


Member Function Documentation

void Ogre::Compiler2Pass::addLexemeToken const String lexeme,
const size_t  token,
const bool  hasAction = false,
const bool  caseSensitive = false
[protected, inherited]
 

Add a lexeme token association.

Remarks:
The backend compiler uses the associations between lexeme and token when building the rule base from the BNF script so all associations must be done prior to compiling a source.
Parameters:
lexeme is the name of the token and use when parsing the source to determin a match for a token.
token is the ID associated with the lexeme
hasAction must be set true if the client wants an action triggered when this token is generated
caseSensitive should be set true if lexeme match should use case sensitivity

void Ogre::CompositorScriptCompiler::addLexemeTokenAction const String lexeme,
const size_t  token,
const CSC_Action  action = 0
[protected]
 

void Ogre::Compiler2Pass::checkTokenActionTrigger void   )  [protected, inherited]
 

Checks the last token instruction and if it has an action then it triggers the action of the previously found token having an action.

bool Ogre::Compiler2Pass::compile const String source,
const String sourceName
[inherited]
 

compile the source - performs 2 passes.

First pass is to tokinize, check semantics and context. The second pass is performed by using tokens to look up function implementors and executing them which convert tokens to application specific instructions.

Remarks:
Pass 2 only gets executed if Pass 1 has built enough tokens to complete a rule path and found no errors
Parameters:
source a pointer to the source text to be compiled
Returns:
true if Pass 1 and Pass 2 are successfull false if any errors occur in Pass 1 or Pass 2

Referenced by Ogre::MaterialScriptCompiler::parseScript(), and parseScript().

bool Ogre::Compiler2Pass::doPass1  )  [protected, inherited]
 

perform pass 1 of compile process scans source for lexemes that can be tokenized and then performs general semantic and context verification on each lexeme before it is tokenized.

A tokenized instruction list is built to be used by Pass 2. A rule path can trigger Pass 2 execution if enough tokens have been generated in Pass 1. Pass 1 will then pass control to pass 2 temporarily until the current tokens have been consumed.

bool Ogre::Compiler2Pass::doPass2  )  [protected, inherited]
 

performs Pass 2 of compile process which is execution of the tokens

Remarks:
Pass 2 takes the token instructions generated in Pass 1 and builds the application specific instructions along with verifying symantic and context rules that could not be checked in Pass 1.

Pass 2 execution consumes tokens and moves the Pass 2 token instruction position towards the end of the token container. Token execution can insert new tokens into the token container.

virtual void Ogre::CompositorScriptCompiler::executeTokenAction const size_t  tokenID  )  [protected, virtual]
 

Execute an Action associated with a token.

Gets called when the compiler finishes tokenizing a section of the source that has been parsed.

Implements Ogre::Compiler2Pass.

CompareFunction Ogre::CompositorScriptCompiler::extractCompareFunc void   )  [protected]
 

StencilOperation Ogre::CompositorScriptCompiler::extractStencilOp void   )  [protected]
 

void Ogre::Compiler2Pass::findEOL  )  [protected, inherited]
 

find the eol charater

String Ogre::Compiler2Pass::getBNFGrammerTextFromRulePath size_t  ruleID,
const size_t  level = 0
[protected, inherited]
 

Get the text representation of the rule path.

This is a good way to way to visually verify that the BNF grammer did compile correctly.

Parameters:
ruleID is the index into the rule path.
level is the number of levels a non-terminal will expand to. Defaults to 0 if not set which will cause non-terminals to not expand.

virtual const String& Ogre::CompositorScriptCompiler::getClientBNFGrammer void   )  [virtual]
 

gets BNF Grammer for Compositor script.

Implements Ogre::Compiler2Pass.

Definition at line 47 of file OgreCompositorScriptCompiler.h.

virtual const String& Ogre::CompositorScriptCompiler::getClientGrammerName void   )  const [virtual]
 

get the name of the Compositor script BNF grammer.

Implements Ogre::Compiler2Pass.

Definition at line 51 of file OgreCompositorScriptCompiler.h.

const TokenInst& Ogre::Compiler2Pass::getCurrentToken const size_t  expectedTokenID = 0  )  const [protected, inherited]
 

Gets the current token from the instruction que.

Remarks:
If an unkown token is found then an exception is raised. The subclass should catch the exception, provide an error message, and attempt recovery.
Parameters:
expectedTokenID if greater than 0 then an exception is raised if tokenID does not match.

size_t Ogre::Compiler2Pass::getCurrentTokenID void   )  const [protected, inherited]
 

Get the current token's ID value.

Definition at line 413 of file OgreCompiler2Pass.h.

const String& Ogre::Compiler2Pass::getCurrentTokenLabel void   )  const [protected, inherited]
 

Gets the next token's associated text label in the instruction que that was parsed from the text source.

If an unkown token is found or no associated label was found then an exception is raised. The subclass should catch the exception, provide an error message, and attempt recovery.

const String& Ogre::Compiler2Pass::getCurrentTokenLexeme void   )  const [protected, inherited]
 

Get the current token's lexeme string.

Handy when you don't want the ID but want the string representation.

float Ogre::Compiler2Pass::getCurrentTokenValue void   )  const [protected, inherited]
 

Gets the current token's associated floating point value in the instruction que that was parsed from the text source.

Remarks:
If an unkown token is found or no associated value was found then an exception is raised. The subclass should catch the exception, provide an error message, and attempt recovery.

const TokenInst& Ogre::Compiler2Pass::getNextToken const size_t  expectedTokenID = 0  )  const [protected, inherited]
 

Gets the next token from the instruction que.

Remarks:
If an unkown token is found then an exception is raised but the instruction pointer is still moved passed the unknown token. The subclass should catch the exception, provide an error message, and attempt recovery.
Parameters:
expectedTokenID if greater than 0 then an exception is raised if tokenID does not match.

Definition at line 339 of file OgreCompiler2Pass.h.

size_t Ogre::Compiler2Pass::getNextTokenID void   )  const [protected, inherited]
 

Get the next token's ID value.

Definition at line 410 of file OgreCompiler2Pass.h.

const String& Ogre::Compiler2Pass::getNextTokenLabel void   )  const [protected, inherited]
 

Gets the next token's associated text label in the instruction que that was parsed from the text source.

Remarks:
If an unkown token is found or no associated label was found then an exception is raised but the instruction pointer is still moved passed the unknown token. The subclass should catch the exception, provide an error message, and attempt recovery.

Definition at line 398 of file OgreCompiler2Pass.h.

const String& Ogre::Compiler2Pass::getNextTokenLexeme void   )  const [protected, inherited]
 

Get the next token's lexeme string.

Handy when you don't want the ID but want the string representation.

Definition at line 417 of file OgreCompiler2Pass.h.

float Ogre::Compiler2Pass::getNextTokenValue void   )  const [protected, inherited]
 

Gets the next token's associated floating point value in the instruction que that was parsed from the text source.

If an unkown token is found or no associated value was found then an exception is raised but the instruction pointer is still moved passed the unknown token. The subclass should catch the exception, provide an error message, and attempt recovery.

Definition at line 379 of file OgreCompiler2Pass.h.

size_t Ogre::Compiler2Pass::getPass2TokenQueCount void   )  const [protected, inherited]
 

Gets the number of tokens waiting in the instruction que that need to be processed by an token action in pass 2.

size_t Ogre::Compiler2Pass::getPass2TokenQuePosition void   )  const [protected, inherited]
 

Get the current position in the Pass2 Token Que.

Definition at line 447 of file OgreCompiler2Pass.h.

size_t Ogre::Compiler2Pass::getRemainingTokensForAction void   )  const [protected, inherited]
 

Get the number of tokens not processed by action token.

Client Actions should use this method to retreive the number of parameters(tokens) remaining to be processed in the action.

bool Ogre::Compiler2Pass::isCharacterLabel const size_t  rulepathIDX  )  [protected, inherited]
 

Check if source at current position is supposed to be a user defined character label.

A new label is processed when previous operation was not _character_ otherwise the processed character (if match was found) is added to the current label. This allows _character_ operations to be chained together to form a crude regular expression to build a label.

Parameters:
rulepathIDX index into rule path database of token to validate.
Returns:
true if token was found for character label.

bool Ogre::Compiler2Pass::isFloatValue float &  fvalue,
size_t &  charsize
const [protected, inherited]
 

check to see if the text at the present position in the source is a numerical constant

Parameters:
fvalue is a reference that will receive the float value that is in the source
charsize reference to receive number of characters that make of the value in the source
Returns:
true if characters form a valid float representation false if a number value could not be extracted

bool Ogre::Compiler2Pass::isLexemeMatch const String lexeme,
const bool  caseSensitive
const [protected, inherited]
 

check to see if the text is in the lexeme text library

Parameters:
lexeme points to begining of text where a lexem token might exist
caseSensitive set to true if match should be case sensitive
Returns:
true if a matching token could be found in the token type library false if could not be tokenized

void Ogre::CompositorScriptCompiler::logParseError const String error  )  [protected]
 

void Ogre::CompositorScriptCompiler::parseClearBuffers void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseClearColourValue void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseClearDepthValue void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseClearStencilValue void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseCloseBrace void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseCompositor void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseFirstRenderQueue void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseIdentifier void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseInput void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseLastRenderQueue void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseLodBias void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseMaterial void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseMaterialScheme void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseOnlyInitial void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseOpenBrace void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parsePass void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseScript DataStreamPtr stream,
const String groupName
 

Compile a compositor script from a data stream using a specific resource group name.

Parameters:
stream Weak reference to a data stream which is the source of the material script
groupName The name of the resource group that resources which are parsed are to become a member of. If this group is loaded or unloaded, then the resources discovered in this script will be loaded / unloaded with it.

Definition at line 59 of file OgreCompositorScriptCompiler.h.

References Ogre::Compiler2Pass::compile().

void Ogre::CompositorScriptCompiler::parseStencilCheck void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseStencilDepthFailOp void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseStencilFailOp void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseStencilFunc void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseStencilMask void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseStencilPassOp void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseStencilRefVal void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseStencilTwoSided void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseTarget void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseTargetOutput void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseTechnique void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseTexture void   )  [protected]
 

void Ogre::CompositorScriptCompiler::parseVisibilityMask void   )  [protected]
 

bool Ogre::Compiler2Pass::positionToNextLexeme  )  [protected, inherited]
 

position to the next possible valid sysmbol

bool Ogre::Compiler2Pass::processRulePath size_t  rulepathIDX  )  [protected, inherited]
 

process input source text using rulepath to determine allowed tokens

Remarks:
the method is reentrant and recursive if a non-terminal token is encountered in the current rule path then the method is called using the new rule path referenced by the non-terminal token Tokens can have the following operation states which effects the flow path of the rule RULE: defines a rule path for the non-terminal token AND: the token is required for the rule to pass OR: if the previous tokens failed then try these ones OPTIONAL: the token is optional and does not cause the rule to fail if the token is not found REPEAT: the token is required but there can be more than one in a sequence DATA: Used by a previous token ie for character sets NOTTEST: performs negative lookahead ie make sure the next token is not of a certain type END: end of the rule path - the method returns the succuss of the rule
Parameters:
rulepathIDX index into an array of Token Rules that define a rule path to be processed
Returns:
true if rule passed - all required tokens found false if one or more tokens required to complete the rule were not found

void Ogre::Compiler2Pass::replaceToken void   )  [protected, inherited]
 

go back to the previous token in the pass2 queue.

void Ogre::Compiler2Pass::setActiveContexts const uint  contexts  )  [protected, inherited]
 

setup ActiveContexts - should be called by subclass to setup initial language contexts

Definition at line 540 of file OgreCompiler2Pass.h.

void Ogre::Compiler2Pass::setClientBNFGrammer void   )  [protected, inherited]
 

Sets up the parser rules for the client based on the BNF Grammer text passed in.

Remarks:
Raises an exception if the grammer did not compile successfully. This method gets called when a call to compile occurs and no compiled BNF grammer exists, otherwise nothing will happen since the compiler has no rules to work with. The grammer only needs to be set once during the lifetime of the compiler unless the grammer changes.
Note:
BNF Grammer rules are cached once the BNF grammer source is compiled. The client should never have to call this method directly.

bool Ogre::Compiler2Pass::setNextActionQuePosition size_t  pos,
const bool  search = false
[protected, inherited]
 

Set the position of the next token action in the Pass2 Token Que.

Remarks:
If the position is not within the que or there is no action associated with the token at the position in the que then NextActionQuePosition is not set.
Parameters:
pos is the position in the Pass2 Token Que where the next action is.
search if true then the que is searched from pos until an action is found. If the end of the que is reached and no action has been found then NextActionQuePosition is set to the end of the que and false is returned.

void Ogre::Compiler2Pass::setPass2TokenQuePosition size_t  pos,
const bool  activateAction = false
[protected, inherited]
 

Manualy set the Pass2 Token que position.

Remarks:
This method will also set the position of the next token in the pass2 que that has an action ensuring that getRemainingTokensForAction works currectly. This method is useful for when the token que must be reprocessed after pass1 and the position in the que must be changed so that an action will be triggered.
Parameters:
pos is the new position within the Pass2 que
activateAction if set true and the token at the new position has an action then the action is activated.

virtual void Ogre::CompositorScriptCompiler::setupTokenDefinitions void   )  [protected, virtual]
 

Associate all the lexemes used in a material script with their corresponding tokens and actions.

Implements Ogre::Compiler2Pass.

void Ogre::Compiler2Pass::skipComments  )  [protected, inherited]
 

comment specifiers are hard coded

void Ogre::Compiler2Pass::skipEOL  )  [protected, inherited]
 

find end of line marker and move past it

void Ogre::Compiler2Pass::skipToken void   )  const [protected, inherited]
 

skip to the next token in the pass2 queue.

void Ogre::Compiler2Pass::skipWhiteSpace  )  [protected, inherited]
 

skip all the white space which includes spaces and tabs

bool Ogre::Compiler2Pass::testCurrentTokenID const size_t  expectedTokenID  )  const [protected, inherited]
 

If a current token instruction exist then test if its token ID matches.

Parameters:
expectedTokenID is the ID of the token to match.

Definition at line 364 of file OgreCompiler2Pass.h.

bool Ogre::Compiler2Pass::testNextTokenID const size_t  expectedTokenID  )  const [protected, inherited]
 

If a next token instruction exist then test if its token ID matches.

Remarks:
This method is usefull for peeking ahead during pass 2 to see if a certain token exists.
Parameters:
expectedTokenID is the ID of the token to match.

bool Ogre::Compiler2Pass::ValidateToken const size_t  rulepathIDX,
const size_t  activeRuleID
[protected, inherited]
 

check if current position in source has the lexeme text equivalent to the TokenID

Parameters:
rulepathIDX index into rule path database of token to validate
activeRuleID index of non-terminal rule that generated the token
Returns:
true if token was found false if token lexeme text does not match the source text if token is non-terminal then processRulePath is called

void Ogre::Compiler2Pass::verifyTokenRuleLinks const String grammerName  )  [protected, inherited]
 

scan through all the rules and initialize token definition with index to rules for non-terminal tokens.

Gets called when internal grammer is being verified or after client grammer has been parsed.

Parameters:
grammerName is the name of the grammer the token rules are for


Member Data Documentation

String Ogre::CompositorScriptCompiler::compositorScript_BNF [static, protected]
 

Definition at line 133 of file OgreCompositorScriptCompiler.h.

TokenRule Ogre::CompositorScriptCompiler::compositorScript_RulePath[] [static, protected]
 

Definition at line 131 of file OgreCompositorScriptCompiler.h.

uint Ogre::Compiler2Pass::mActiveContexts [protected, inherited]
 

Active Contexts pattern used in pass 1 to determine which tokens are valid for a certain context.

Definition at line 298 of file OgreCompiler2Pass.h.

size_t Ogre::Compiler2Pass::mActiveLabelKey [protected, inherited]
 

the key of the active label being built during pass 1.

a new key is calculated when mLabelIsActive switches from false to true

Definition at line 286 of file OgreCompiler2Pass.h.

TokenState* Ogre::Compiler2Pass::mActiveTokenState [protected, inherited]
 

Active token que, definitions, rules currntly being used by parser.

Definition at line 254 of file OgreCompiler2Pass.h.

size_t Ogre::Compiler2Pass::mCharPos [protected, inherited]
 

current line number in source being tokenized

Definition at line 272 of file OgreCompiler2Pass.h.

TokenState* Ogre::Compiler2Pass::mClientTokenState [protected, inherited]
 

Definition at line 251 of file OgreCompiler2Pass.h.

std::map<size_t, float> Ogre::Compiler2Pass::mConstants [protected, inherited]
 

storage container for constants defined in source container uses Token index as a key associated with a float constant

Definition at line 277 of file OgreCompiler2Pass.h.

size_t Ogre::Compiler2Pass::mCurrentLine [protected, inherited]
 

Definition at line 271 of file OgreCompiler2Pass.h.

size_t Ogre::Compiler2Pass::mEndOfSource [protected, inherited]
 

Definition at line 269 of file OgreCompiler2Pass.h.

size_t Ogre::Compiler2Pass::mErrorCharPos [protected, inherited]
 

position in current line in source being tokenized

Definition at line 273 of file OgreCompiler2Pass.h.

size_t Ogre::Compiler2Pass::mInsertTokenID [protected, inherited]
 

TokenID to insert if next rule finds a terminal token if zero then no token inserted.

Definition at line 295 of file OgreCompiler2Pass.h.

bool Ogre::Compiler2Pass::mLabelIsActive [protected, inherited]
 

flag indicates when a label is being parsed.

It gets set false when a terminal token not of _character_ is encountered

Definition at line 283 of file OgreCompiler2Pass.h.

std::map<size_t, String> Ogre::Compiler2Pass::mLabels [protected, inherited]
 

storage container for string labels defined in source container uses Token index as a key associated with a label

Definition at line 280 of file OgreCompiler2Pass.h.

size_t Ogre::Compiler2Pass::mNextActionQuePosition [protected, inherited]
 

the que position for the next token that has an action.

Definition at line 263 of file OgreCompiler2Pass.h.

bool Ogre::Compiler2Pass::mNoSpaceSkip [protected, inherited]
 

flag being true indicates that spaces are not to be skipped automatically gets set to false when mLabelIsActive goes to false

Definition at line 289 of file OgreCompiler2Pass.h.

bool Ogre::Compiler2Pass::mNoTerminalToken [protected, inherited]
 

if flag is true then next terminal token is not added to token que if found but does effect rule path flow

Definition at line 292 of file OgreCompiler2Pass.h.

size_t Ogre::Compiler2Pass::mPass2TokenQuePosition [mutable, protected, inherited]
 

the location within the token instruction container where pass 2 is

Definition at line 256 of file OgreCompiler2Pass.h.

size_t Ogre::Compiler2Pass::mPreviousActionQuePosition [protected, inherited]
 

the que position of the previous token that had an action.

A token's action is fired on the next token having an action.

Definition at line 260 of file OgreCompiler2Pass.h.

CompositorScriptContext Ogre::CompositorScriptCompiler::mScriptContext [protected]
 

Definition at line 128 of file OgreCompositorScriptCompiler.h.

const String* Ogre::Compiler2Pass::mSource [protected, inherited]
 

pointer to the source to be compiled

Definition at line 266 of file OgreCompiler2Pass.h.

String Ogre::Compiler2Pass::mSourceName [protected, inherited]
 

name of the source to be compiled

Definition at line 268 of file OgreCompiler2Pass.h.

TokenActionMap Ogre::CompositorScriptCompiler::mTokenActionMap [static, protected]
 

Map of Token value as key to an Action.

An Action converts tokens into the final format. All instances use the same Token Action Map.

Definition at line 142 of file OgreCompositorScriptCompiler.h.

const size_t Ogre::Compiler2Pass::SystemTokenBase = 1000 [static, protected, inherited]
 

Definition at line 173 of file OgreCompiler2Pass.h.


The documentation for this class was generated from the following file:

Copyright © 2000-2005 by The OGRE Team
Creative Commons License
This work is licensed under a Creative Commons Attribution-ShareAlike 2.5 License.
Last modified Sun Sep 17 15:39:36 2006