/*
* Mesa 3-D graphics library
*
* Copyright (C) 2005-2008 Brian Paul All Rights Reserved.
* Copyright (C) 2009 VMware, Inc. All Rights Reserved.
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included
* in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
* BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
* AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
/**
* \file slang_preprocess.c
* slang preprocessor
* \author Michal Krol
*/
#include "main/imports.h"
#include "shader/grammar/grammar_mesa.h"
#include "slang_preprocess.h"
LONGSTRING static const char *slang_pp_directives_syn =
#include "library/slang_pp_directives_syn.h"
;
LONGSTRING static const char *slang_pp_expression_syn =
#include "library/slang_pp_expression_syn.h"
;
LONGSTRING static const char *slang_pp_version_syn =
#include "library/slang_pp_version_syn.h"
;
static GLvoid
grammar_error_to_log (slang_info_log *log)
{
char buf[1024];
GLint pos;
grammar_get_last_error ((byte *) (buf), sizeof (buf), &pos);
if (buf[0] == 0) {
_mesa_snprintf(buf, sizeof(buf), "Preprocessor error");
}
slang_info_log_error (log, buf);
}
GLboolean
_slang_preprocess_version (const char *text, GLuint *version, GLuint *eaten, slang_info_log *log)
{
grammar id;
byte *prod, *I;
unsigned int size;
id = grammar_load_from_text ((const byte *) (slang_pp_version_syn));
if (id == 0) {
grammar_error_to_log (log);
return GL_FALSE;
}
if (!grammar_fast_check (id, (const byte *) (text), &prod, &size, 8)) {
grammar_error_to_log (log);
grammar_destroy (id);
return GL_FALSE;
}
/* there can be multiple #version directives - grab the last one */
I = &prod[size - 6];
*version = (GLuint) (I[0]) + (GLuint) (I[1]) * 100;
*eaten = (GLuint) (I[2]) + ((GLuint) (I[3]) << 8) + ((GLuint) (I[4]) << 16) + ((GLuint) (I[5]) << 24);
grammar_destroy (id);
grammar_alloc_free (prod);
return GL_TRUE;
}
/*
* The preprocessor does the following work.
* 1. Remove comments. Each comment block is replaced with a single space and if the
* block contains new-lines, they are preserved. This ensures that line numbers
* stay the same and if a comment block delimits two tokens, the are delitmited
* by the space after comment removal.
* 2. Remove preprocessor directives from the source string, checking their syntax and
* executing them if appropriate. Again, new-lines are preserved.
* 3. Expand macros.
* 4. Tokenize the source string by ensuring there is at least one space between every
* two adjacent tokens.
*/
#define PP_ANNOTATE 0
static GLvoid
pp_annotate (slang_string *output, const char *fmt, ...)
{
#if PP_ANNOTATE
va_list va;
char buffer[1024];
va_start (va, fmt);
_mesa_vsprintf (buffer, fmt, va);
va_end (va);
slang_string_pushs (output, buffer, _mesa_strlen (buffer));
#else
(GLvoid) (output);
(GLvoid) (fmt);
#endif
}
/*
* The expression is executed on a fixed-sized stack. The PUSH macro makes a runtime
* check if the stack is not overflown by too complex expressions. In that situation the
* GLSL preprocessor should report internal compiler error.
* The BINARYDIV makes a runtime check if the divider is not 0. If it is, it reports
* compilation error.
*/
#define EXECUTION_STACK_SIZE 1024
#define PUSH(x)\
do {\
if (sp == 0) {\
slang_info_log_error (elog, "internal compiler error: preprocessor execution stack overflow.");\
return GL_FALSE;\
}\
stack[--sp] = x;\
} while (GL_FALSE)
#define POP(x)\
do {\
assert (sp < EXECUTION_STACK_SIZE);\
x = stack[sp++];\
} while (GL_FALSE)
#define BINARY(op)\
do {\
GLint a, b;\
POP(b);\
POP(a);\
PUSH(a op b);\
} while (GL_FALSE)
#define BINARYDIV(op)\
do {\
GLint a, b;\
POP(b);\
POP(a);\
if (b == 0) {\
slang_info_log_error (elog, "division by zero in preprocessor expression.");\
return GL_FALSE;\
}\
PUSH(a op b);\
} while (GL_FALSE)
#define UNARY(op)\
do {\
GLint a;\
POP(a);\
PUSH(op a);\
} while (GL_FALSE)
#define OP_END 0
#define OP_PUSHINT 1
#define OP_LOGICALOR 2
#define OP_LOGICALAND 3
#define OP_OR 4
#define OP_XOR 5
#define OP_AND 6
#define OP_EQUAL 7
#define OP_NOTEQUAL 8
#define OP_LESSEQUAL 9
#define OP_GREATEREQUAL 10
#define OP_LESS 11
#define OP_GREATER 12
#define OP_LEFTSHIFT 13
#define OP_RIGHTSHIFT 14
#define OP_ADD 15
#define OP_SUBTRACT 16
#define OP_MULTIPLY 17
#define OP_DIVIDE 18
#define OP_MODULUS 19
#define OP_PLUS 20
#define OP_MINUS 21
#define OP_NEGATE 22
#define OP_COMPLEMENT 23
static GLboolean
execute_expression (slang_string *output, const byte *code, GLuint *pi, GLint *result,
slang_info_log *elog)
{
GLuint i = *pi;
GLint stack[EXECUTION_STACK_SIZE];
GLuint sp = EXECUTION_STACK_SIZE;
while (code[i] != OP_END) {
switch (code[i++]) {
case OP_PUSHINT:
i++;
PUSH(_mesa_atoi ((const char *) (&code[i])));
i += _mesa_strlen ((const char *) (&code[i])) + 1;
break;
case OP_LOGICALOR:
BINARY(||);
break;
case OP_LOGICALAND:
BINARY(&&);
break;
case OP_OR:
BINARY(|);
break;
case OP_XOR:
BINARY(^);
break;
case OP_AND:
BINARY(&);
break;
case OP_EQUAL:
BINARY(==);
break;
case OP_NOTEQUAL:
BINARY(!=);
break;
case OP_LESSEQUAL:
BINARY(<=);
break;
case OP_GREATEREQUAL:
BINARY(>=);
break;
case OP_LESS:
BINARY(<);
break;
case OP_GREATER:
BINARY(>);
break;
case OP_LEFTSHIFT:
BINARY(<<);
break;
case OP_RIGHTSHIFT:
BINARY(>>);
break;
case OP_ADD:
BINARY(+);
break;
case OP_SUBTRACT:
BINARY(-);
break;
case OP_MULTIPLY:
BINARY(*);
break;
case OP_DIVIDE:
BINARYDIV(/);
break;
case OP_MODULUS:
BINARYDIV(%);
break;
case OP_PLUS:
UNARY(+);
break;
case OP_MINUS:
UNARY(-);
break;
case OP_NEGATE:
UNARY(!);
break;
case OP_COMPLEMENT:
UNARY(~);
break;
default:
assert (0);
}
}
/* Write-back the index skipping the OP_END. */
*pi = i + 1;
/* There should be exactly one value left on the stack. This is our result. */
POP(*result);
pp_annotate (output, "%d ", *result);
assert (sp == EXECUTION_STACK_SIZE);
return GL_TRUE;
}
/*
* Function execute_expressions() executes up to 2 expressions. The second expression is there
* for the #line directive which takes 1 or 2 expressions that indicate line and file numbers.
* If it fails, it returns 0. If it succeeds, it returns the number of executed expressions.
*/
#define EXP_END 0
#define EXP_EXPRESSION 1
static GLuint
execute_expressions (slang_string *output, grammar eid, const byte *expr, GLint results[2],
slang_info_log *elog)
{
GLint success;
byte *code;
GLuint size, count = 0;
success = grammar_fast_check (eid, expr, &code, &size, 64);
if (success) {
GLuint i = 0;
while (code[i++] == EXP_EXPRESSION) {
assert (count < 2);
if (!execute_expression (output, code, &i, &results[count], elog)) {
count = 0;
break;
}
count++;
}
grammar_alloc_free (code);
}
else {
slang_info_log_error (elog, "syntax error in preprocessor expression.");\
}
return count;
}
/*
* The pp_symbol structure is used to hold macro definitions and macro formal parameters. The
* pp_symbols strcture is a collection of pp_symbol. It is used both for storing macro formal
* parameters and all global macro definitions. Making this unification wastes some memory,
* becuse macro formal parameters don't need further lists of symbols. We lose 8 bytes per
* formal parameter here, but making this we can use the same code to substitute macro parameters
* as well as macros in the source string.
*/
typedef struct
{
struct pp_symbol_ *symbols;
GLuint count;
} pp_symbols;
static GLvoid
pp_symbols_init (pp_symbols *self)
{
self->symbols = NULL;
self->count = 0;
}
static GLvoid
pp_symbols_free (pp_symbols *);
typedef struct pp_symbol_
{
slang_string name;
slang_string replacement;
pp_symbols parameters;
} pp_symbol;
static GLvoid
pp_symbol_init (pp_symbol *self)
{
slang_string_init (&self->name);
slang_string_init (&self->replacement);
pp_symbols_init (&self->parameters);
}
static GLvoid
pp_symbol_free (pp_symbol *self)
{
slang_string_free (&self->name);
slang_string_free (&self->replacement);
pp_symbols_free (&self->parameters);
}
static GLvoid
pp_symbol_reset (pp_symbol *self)
{
/* Leave symbol name intact. */
slang_string_reset (&self->replacement);
pp_symbols_free (&self->parameters);
pp_symbols_init (&self->parameters);
}
static GLvoid
pp_symbols_free (pp_symbols *self)
{
GLuint i;
for (i = 0; i < self->count; i++)
pp_symbol_free (&self->symbols[i]);
_mesa_free (self->symbols);
}
static pp_symbol *
pp_symbols_push (pp_symbols *self)
{
self->symbols = (pp_symbol *) (_mesa_realloc (self->symbols, self->count * sizeof (pp_symbol),
(self->count + 1) * sizeof (pp_symbol)));
if (self->symbols == NULL)
return NULL;
pp_symbol_init (&self->symbols[self->count]);
return &self->symbols[self->count++];
}
static GLboolean
pp_symbols_erase (pp_symbols *self, pp_symbol *symbol)
{
assert (symbol >= self->symbols && symbol < self->symbols + self->count);
self->count--;
pp_symbol_free (symbol);
if (symbol < self->symbols + self->count)
_mesa_memcpy (symbol, symbol + 1, sizeof (pp_symbol) * (self->symbols + self->count - symbol));
self->symbols = (pp_symbol *) (_mesa_realloc (self->symbols, (self->count + 1) * sizeof (pp_symbol),
self->count * sizeof (pp_symbol)));
return self->symbols != NULL;
}
static pp_symbol *
pp_symbols_find (pp_symbols *self, const char *name)
{
GLuint i;
for (i = 0; i < self->count; i++)
if (_mesa_strcmp (name, slang_string_cstr (&self->symbols[i].name)) == 0)
return &self->symbols[i];
return NULL;
}
/*
* The condition context of a single #if/#else/#endif level. Those can be nested, so there
* is a stack of condition contexts.
* There is a special global context on the bottom of the stack. It is there to simplify
* context handling.
*/
typedef struct
{
GLboolean current; /* The condition value of this level. */
GLboolean effective; /* The effective product of current condition, outer level conditions
* and position within #if-#else-#endif sections. */
GLboolean else_allowed; /* TRUE if in #if-#else section, FALSE if in #else-#endif section
* and for global context. */
GLboolean endif_required; /* FALSE for global context only. */
} pp_cond_ctx;
/* Should be enuff. */
#define CONDITION_STACK_SIZE 64
typedef struct
{
pp_cond_ctx stack[CONDITION_STACK_SIZE];
pp_cond_ctx *top;
} pp_cond_stack;
static GLboolean
pp_cond_stack_push (pp_cond_stack *self, slang_info_log *elog)
{
if (self->top == self->stack) {
slang_info_log_error (elog, "internal compiler error: preprocessor condition stack overflow.");
return GL_FALSE;
}
self->top--;
return GL_TRUE;
}
static GLvoid
pp_cond_stack_reevaluate (pp_cond_stack *self)
{
/* There must be at least 2 conditions on the stack - one global and one being evaluated. */
assert (self->top <= &self->stack[CONDITION_STACK_SIZE - 2]);
self->top->effective = self->top->current && self->top[1].effective;
}
/**
* Extension enables through #extension directive.
* NOTE: Currently, only enable/disable state is stored.
*/
typedef struct
{
GLboolean ARB_draw_buffers;
GLboolean ARB_texture_rectangle;
} pp_ext;
/**
* Disable all extensions. Called at startup and on #extension all: disable.
*/
static GLvoid
pp_ext_disable_all(pp_ext *self)
{
_mesa_memset(self, 0, sizeof(self));
}
/**
* Called during preprocessor initialization to set the initial enable/disable
* state of extensions.
*/
static GLvoid
pp_ext_init(pp_ext *self, const struct gl_extensions *extensions)
{
pp_ext_disable_all (self);
if (extensions->ARB_draw_buffers)
self->ARB_draw_buffers = GL_TRUE;
if (extensions->NV_texture_rectangle)
self->ARB_texture_rectangle = GL_TRUE;
}
/**
* Called in response to #extension directives to enable/disable
* the named extension.
*/
static GLboolean
pp_ext_set(pp_ext *self, const char *name, GLboolean enable)
{
if (_mesa_strcmp (name, "GL_ARB_draw_buffers") == 0)
self->ARB_draw_buffers = enable;
else if (_mesa_strcmp (name, "GL_ARB_texture_rectangle") == 0)
self->ARB_texture_rectangle = enable;
else
return GL_FALSE;
return GL_TRUE;
}
static void
pp_pragmas_init(struct gl_sl_pragmas *pragmas)
{
pragmas->Optimize = GL_TRUE;
pragmas->Debug = GL_FALSE;
}
/**
* Called in response to #pragma. For example, "#pragma debug(on)" would
* call this function as pp_pragma("debug", "on").
* \return GL_TRUE if pragma is valid, GL_FALSE if invalid
*/
static GLboolean
pp_pragma(struct gl_sl_pragmas *pragmas, const char *pragma, const char *param)
{
#if 0
printf("#pragma %s %s\n", pragma, param);
#endif
if (_mesa_strcmp(pragma, "optimize") == 0) {
if (!param)
return GL_FALSE; /* missing required param */
if (_mesa_strcmp(param, "on") == 0) {
pragmas->Optimize = GL_TRUE;
}
else if (_mesa_strcmp(param, "off") == 0) {
pragmas->Optimize = GL_FALSE;
}
else {
return GL_FALSE; /* invalid param */
}
}
else if (_mesa_strcmp(pragma, "debug") == 0) {
if (!param)
return GL_FALSE; /* missing required param */
if (_mesa_strcmp(param, "on") == 0) {
pragmas->Debug = GL_TRUE;
}
else if (_mesa_strcmp(param, "off") == 0) {
pragmas->Debug = GL_FALSE;
}
else {
return GL_FALSE; /* invalid param */
}
}
/* all other pragmas are silently ignored */
return GL_TRUE;
}
/**
* The state of preprocessor: current line, file and version number, list
* of all defined macros and the #if/#endif context.
*/
typedef struct
{
GLint line;
GLint file;
GLint version;
pp_symbols symbols;
pp_ext ext;
slang_info_log *elog;
pp_cond_stack cond;
} pp_state;
static GLvoid
pp_state_init (pp_state *self, slang_info_log *elog,
const struct gl_extensions *extensions)
{
self->line = 0;
self->file = 1;
#if FEATURE_es2_glsl
self->version = 100;
#else
self->version = 110;
#endif
pp_symbols_init (&self->symbols);
pp_ext_init (&self->ext, extensions);
self->elog = elog;
/* Initialize condition stack and create the global context. */
self->cond.top = &self->cond.stack[CONDITION_STACK_SIZE - 1];
self->cond.top->current = GL_TRUE;
self->cond.top->effective = GL_TRUE;
self->cond.top->else_allowed = GL_FALSE;
self->cond.top->endif_required = GL_FALSE;
}
static GLvoid
pp_state_free (pp_state *self)
{
pp_symbols_free (&self->symbols);
}
#define IS_FIRST_ID_CHAR(x) (((x) >= 'a' && (x) <= 'z') || ((x) >= 'A' && (x) <= 'Z') || (x) == '_')
#define IS_NEXT_ID_CHAR(x) (IS_FIRST_ID_CHAR(x) || ((x) >= '0' && (x) <= '9'))
#define IS_WHITE(x) ((x) == ' ' || (x) == '\n')
#define IS_NULL(x) ((x) == '\0')
#define SKIP_WHITE(x) do { while (IS_WHITE(*(x))) (x)++; } while (GL_FALSE)
typedef struct
{
slang_string *output;
const char *input;
pp_state *state;
} expand_state;
static GLboolean
expand_defined (expand_state *e, slang_string *buffer)
{
GLboolean in_paren = GL_FALSE;
const char *id;
/* Parse the optional opening parenthesis. */
SKIP_WHITE(e->input);
if (*e->input == '(') {
e->input++;
in_paren = GL_TRUE;
SKIP_WHITE(e->input);
}
/* Parse operand. */
if (!IS_FIRST_ID_CHAR(*e->input)) {
slang_info_log_error (e->state->elog,
"preprocess error: identifier expected after operator 'defined'.");
return GL_FALSE;
}
slang_string_reset (buffer);
slang_string_pushc (buffer, *e->input++);
while (IS_NEXT_ID_CHAR(*e->input))
slang_string_pushc (buffer, *e->input++);
id = slang_string_cstr (buffer);
/* Check if the operand is defined. Output 1 if it is defined, output 0 if not. */
if (pp_symbols_find (&e->state->symbols, id) == NULL)
slang_string_pushs (e->output, " 0 ", 3);
else
slang_string_pushs (e->output, " 1 ", 3);
/* Parse the closing parentehesis if the opening one was there. */
if (in_paren) {
SKIP_WHITE(e->input);
if (*e->input != ')') {
slang_info_log_error (e->state->elog, "preprocess error: ')' expected.");
return GL_FALSE;
}
e->input++;
SKIP_WHITE(e->input);
}
return GL_TRUE;
}
static GLboolean
expand (expand_state *, pp_symbols *);
static GLboolean
expand_symbol (expand_state *e, pp_symbol *symbol)
{
expand_state es;
/* If the macro has some parameters, we need to parse them. */
if (symbol->parameters.count != 0) {
GLuint i;
/* Parse the opening parenthesis. */
SKIP_WHITE(e->input);
if (*e->input != '(') {
slang_info_log_error (e->state->elog, "preprocess error: '(' expected.");
return GL_FALSE;
}
e->input++;
SKIP_WHITE(e->input);
/* Parse macro actual parameters. This can be anything, separated by a colon.
*/
for (i = 0; i < symbol->parameters.count; i++) {
GLuint nested_paren_count = 0; /* track number of nested parentheses */
if (*e->input == ')') {
slang_info_log_error (e->state->elog, "preprocess error: unexpected ')'.");
return GL_FALSE;
}
/* Eat all characters up to the comma or closing parentheses. */
pp_symbol_reset (&symbol->parameters.symbols[i]);
while (!IS_NULL(*e->input)) {
/* Exit loop only when all nested parens have been eaten. */
if (nested_paren_count == 0 && (*e->input == ',' || *e->input == ')'))
break;
/* Actually count nested parens here. */
if (*e->input == '(')
nested_paren_count++;
else if (*e->input == ')')
nested_paren_count--;
slang_string_pushc (&symbol->parameters.symbols[i].replacement, *e->input++);
}
/* If it was not the last paremeter, skip the comma. Otherwise, skip the
* closing parentheses. */
if (i + 1 == symbol->parameters.count) {
/* This is the last paremeter - skip the closing parentheses. */
if (*e->input != ')') {
slang_info_log_error (e->state->elog, "preprocess error: ')' expected.");
return GL_FALSE;
}
e->input++;
SKIP_WHITE(e->input);
}
else {
/* Skip the separating comma. */
if (*e->input != ',') {
slang_info_log_error (e->state->elog, "preprocess error: ',' expected.");
return GL_FALSE;
}
e->input++;
SKIP_WHITE(e->input);
}
}
}
/* Expand the macro. Use its parameters as a priority symbol list to expand
* macro parameters correctly. */
es.output = e->output;
es.input = slang_string_cstr (&symbol->replacement);
es.state = e->state;
slang_string_pushc (e->output, ' ');
if (!expand (&es, &symbol->parameters))
return GL_FALSE;
slang_string_pushc (e->output, ' ');
return GL_TRUE;
}
/*
* Function expand() expands source text from to