glew/auto/lib/OpenGL/Spec.pm

package OpenGL::Spec;

# A very simple task further complicated by the fact that some people
# can't read, others use legacy Operating Systems, and others don't give
# a damn about using a halfway decent text editor.
#
# The code to parse the _template_ is so simple and straightforward...
# yet the code to parse the real spec files is this mess.

my %typemap = (
    bitfield    => "GLbitfield",
    boolean     => "GLboolean",
    # fsck up in EXT_vertex_array
    Boolean     => "GLboolean",
    byte        => "GLbyte",
    clampd      => "GLclampd",
    clampf      => "GLclampf",
    double      => "GLdouble",
    enum        => "GLenum",
    # Intel fsck up
    Glenum      => "GLenum",
    float       => "GLfloat",
    half        => "GLuint",
    int         => "GLint",
    short       => "GLshort",
    sizei       => "GLsizei",
    ubyte       => "GLubyte",
    uint        => "GLuint",
    ushort      => "GLushort",
    DMbuffer    => "void *",

    # ARB VBO introduces these
    sizeiptrARB => "GLsizeiptrARB",
    intptrARB   => "GLintptrARB",

    # ARB shader objects introduces these, charARB is at least 8 bits,
    # handleARB is at least 32 bits
    charARB     => "GLcharARB",
    handleARB   => "GLhandleARB",

    # GLX 1.3 defines new types which might not be available at compile time
    #GLXFBConfig   => "void*",
    #GLXFBConfigID => "XID",
    #GLXContextID  => "XID",
    #GLXWindow     => "XID",
    #GLXPbuffer    => "XID",

    # Weird stuff for some SGIX extension
    #GLXFBConfigSGIX   => "void*",
    #GLXFBConfigIDSGIX => "XID",
);

my %void_typemap = (
    void    => "GLvoid",
);

my $section_re  = qr{^[A-Z]};
my $function_re = qr{^(.+) ([a-z][a-z0-9_]*) \((.+)\)$}i;
my $token_re    = qr{^([A-Z0-9][A-Z0-9_]*):?\s+((?:0x)?[0-9A-F]+)(.*)$};
my $prefix_re   = qr{^(?:AGL | GLX | WGL)_}x;
my $eofnc_re    = qr{ \);?$ | ^$ }x;
my $function_re = qr{^(.+) ([a-z][a-z0-9_]*) \((.+)\)$}i;
my $prefix_re   = qr{^(?:gl | agl | wgl | glX)}x;
my $types_re    = __compile_wordlist_cap(keys %typemap);
my $voidtype_re = __compile_wordlist_cap(keys %void_typemap);

sub new($)
{
    my $class = shift;
    my $self = { section => {} };
    $self->{filename} = shift;
    local $/;
    open(my $fh, "<$self->{filename}") or die "Can't open $self->{filename}";
    my $content = <$fh>;
    my $section;
    my $s = $self->{section};

    $content =~ s{[ \t]+$}{}mg;
    # Join lines that end with a word-character and ones that *begin*
    # with one
    $content =~ s{(\w)\n(\w)}{$1 $2}sg;

    foreach (split /\n/, $content)
    {
        if (/$section_re/)
        {
            chomp;
            s/^Name String$/Name Strings/; # Fix common mistake
            $section = $_;
            $s->{$section} = "";
        }
        elsif (defined $section and exists $s->{$section})
        {
            s{^\s+}{}mg; # Remove leading whitespace
            $s->{$section} .= $_ . "\n";
        }
    }

    $s->{$_} =~ s{(?:^\n+|\n+$)}{}s foreach keys %$s;

    bless $self, $class;
}

sub sections()
{
    my $self = shift;
    keys %{$self->{section}};
}

sub name()
{
    my $self = shift;
    $self->{section}->{Name};
}

sub name_strings()
{
    my $self = shift;
    split("\n", $self->{section}->{"Name Strings"});
}

sub tokens()
{
    my $self = shift;
    my %tokens = ();
    foreach (split /\n/, $self->{section}->{"New Tokens"})
    {
        next unless /$token_re/;
        my ($name, $value) = ($1, $2);
        $name =~ s{^}{GL_} unless $name =~ /$prefix_re/;
        $tokens{$name} = $value;
    }

    return %tokens;
}

sub functions()
{
    my $self = shift;
    my %functions = ();
    my @fnc = ();

    foreach (split /\n/, $self->{section}->{"New Procedures and Functions"})
    {
        push @fnc, $_ unless ($_ eq "" or $_ eq "None");

        next unless /$eofnc_re/;

        if (__normalize_proto(@fnc) =~ /$function_re/)
        {
            my ($return, $name, $parms) = ($1, $2, $3);
            if (!__ignore_function($name, $extname))
            {
                $name =~ s/^/gl/ unless $name =~ /$prefix_re/;
                if ($name =~ /^gl/ && $name !~ /^glX/)
                {
                    $return =~ s/$types_re/$typemap{$1}/g;
                    $return =~ s/$voidtype_re/$void_typemap{$1}/g;
                    $parms  =~ s/$types_re/$typemap{$1}/g;
                    $parms  =~ s/$voidtype_re/$void_typemap{$1}/g;
                }
                $functions{$name} = {
                    rtype => $return,
                    parms => $parms,
                };
            }
        }
        @fnc = ();
    }

    return %functions;
}

sub __normalize_proto
{
    local $_ = join(" ", @_);
    s/\s+/ /g;                # multiple whitespace -> single space
    s/\s*\(\s*/ \(/;          # exactly one space before ( and none after
    s/\s*\)\s*/\)/;           # no after before or after )
    s/\s*\*([a-zA-Z])/\* $1/; # "* identifier" XXX: g missing?
    s/\*wgl/\* wgl/;          # "* wgl"        XXX: why doesn't the
    s/\*glX/\* glX/;          # "* glX"             previous re catch this?
    s/\.\.\./void/;           # ... -> void
    s/;$//;                   # remove ; at the end of the line
    return $_;
}

sub __ignore_function
{
    return 0;
}

sub __compile_regex
{
    my $regex = join('', @_);
    return qr/$regex/
}

sub __compile_wordlist_cap
{
    __compile_regex('\b(', join('|', @_), ')\b');
}