Revert "update upstream sources"

This reverts commit c7b3127165b9995561d5c7d7d6ca1184f089c797.

Revert "update for begin-mode -> primitive-type"

This reverts commit 54ead4dd26dd07c0d90d6643edb822fa322b4a46.

fix typo

gl: minimal interface to texture objects

* figl/gl.scm (gl-generate-texture, gl-delete-texture):
  (gl-bind-texture): Minimal interface to aid using textures.

update for begin-mode -> primitive-type

update upstream sources

typo in gl.texi

with- helpers return values from their body

* figl/gl.scm (with-gl-push-matrix, with-gl-push-attrib): Return the
  value(s) of the last expression in BODY.

check usage of the term 'OpenGL'

Ensure that early uses of the term in each chapter are distinguished,
and that there is no implication that Figl is or implements 'OpenGL'
-- we are only a language binding to the interface.

<http://www.gnu.org/prep/standards/html_node/Trademarks.html>
<http://www.sgi.com/products/software/opengl/trademarks.pdf>

typos and minor changes to docs

add remaining non-trivial copyright notices

remove primitive glut demo

* examples/glut/demo.scm: Removed.  The null-program demo uses
  GLUT and is nicer.

add copyright notices to docs

add copyright notices to non-trivial files

add particle system example using vertex buffer objects

* examples/particle-system/vbo.scm: New example, using vertex buffer
  objects.

Merge branch 'master' into wip-particles

bind buffer objects

* figl/gl.scm (->pointer): Accept #f as a null pointer.
  (gl-generate-buffer):
  (gl-delete-buffer):
  (set-gl-buffer-data):
  (update-gl-buffer-data):
  (gl-bind-buffer): New bindings.

client array example uses vertex array instead of quad array

* figl/contrib/packed-struct.scm (packed-struct-offset): New export.

* examples/particle-system/client-arrays.scm: Rewrite using a vertex
  array instead of a quad array.  It's the same thing, only a bit
  cleaner.

Merge branch 'master' into wip-particles

add support for client-state vertex arrays

* figl/gl.scm: Add client-state vertex arrays, based on a patch by
  Daniel Hartwig.

add particle-system variant using client-state arrays

* examples/particle-system/legacy.scm: Move here, from
  examples/particle-system.scm.

* examples/particle-system/client-arrays.scm: New version of the
  particle system that uses client arrays.

export packed-struct-size

* figl/contrib/packed-struct.scm (packed-struct-size): Export.

add support for client-state vertex arrays

* figl/gl.scm: Add client-state vertex arrays, based on a patch by
  Daniel Hartwig.

reimplement particle-system using packed structs

* examples/particle-system.scm: Reimplement in terms of packed structs.

add (figl contrib packed-struct)

* Makefile.am:
* figl/contrib/packed-struct.scm: New file.

move around "general" in section title for neater formatting

* doc/figl.texi (API Conventions): Renamed from "General API
  Conventions" to have better formatted menu.

fix typo in previous commit

* doc/figl.texi (General API Conventions): Bindings and text are *not*
  synced.

draft naming conventions

* doc/figl.scm (General API Conventions): New section documenting
  naming, etc. conventions used generally.  Very much a work in
  progress and no solid idea on the final product.

* TODO: Touch.

gl: rename texture-coordinate to texture-coordinates

* figl/gl.scm (gl-texture-coordinates, gl-multi-texture-coordinates):
  Renamed from non-plural names.  Not `fog-coordinate', as that is
  only a single coordinate.

* doc/gl.texi (Vertex Specification): Update.

update TODO

* TODO: Add notes on .spec parsing, enumeration usage.

add packed structures to TODO

* TODO (Packed structures.): New note, with pointers to some existing work.

add simple particle system example

* examples/particle-system.scm: Add a simple particle system.

#f is a null pointer for glut callbacks

* figl/glut/types.scm (coerce-callback-pointer/ephemeral):
  (coerce-callback-pointer/sticky): Allow #f to indicate a null pointer.

expand TODO

* TODO: Add some more notes, expand on others.

add TODO

* TODO: New file.

beginnings of glut documentation

* Makefile.am:
* doc/figl.texi:
* doc/glut.texi:
* doc/glx.texi: Factor GLX and GLUT documentation out into separate
  files.  Start documenting GLUT.

fix export typo for glut

* figl/glut.scm (window-rgba?): Fix export typo.

high-level glu documentation

* Makefile.am:
* doc/figl.texi:
* doc/glu.texi: Factor GLU docs into separate file, and add high-level
  documentation.

add high-level GL docs

* Makefile.am:
* doc/figl.texi:
* doc/gl.texi: Factor GL docs into a separate file.  Add documentation
  for the high-level interface.

remove gl-push-matrix and gl-pop-matrix

* figl/gl.scm: Remove gl-push-matrix and gl-pop-matrix, as there is
  with-gl-push-matrix.

more high-level gl bindings

* figl/gl.scm (set-gl-matrix-mode): Rename from gl-matrix-mode.
  (set-gl-shade-model): New export.
  (with-gl-push-attrib): New export.

add (figl glu)

* figl/glu.scm: New file.
* Makefile.am: Add to build.

glut: rename sub-window?

* figl/glut.scm (subwindow?): Renamed from sub-window?, as per recent
  commits.

glut: clean up window state getters

* figl/glut.scm (define-glut-state, define-glut-states):
  (define-glut-window-state, define-glut-window-states): New helpers
  to define integer glut state.

  (window-color-buffer-red-size, etc.): Renamed from window-red-size.

  (window-accumulation-buffer-red-size): Add getters for accumulation
  buffer color state.

glut: actually manage subwindows

* figl/glut.scm (%make-window): No longer memoized in favour of
  manually keeping a table of created windows.  Dropped live?
  argument.  When managing subwindows, the high-level interface no
  longer support windows created with the low-level bindings.

  (lookup-window): New procedure.  Clears up some logic when expecting
  to find an existing window.
  (current-window, window-parent): Use lookup-window.

  (make-subwindow): Renamed from make-sub-window to use the exact term
  formally defined and more commonly used in the specification.

  (window): New field subwindows.
  (destroy-window): Recursively mark subwindows.

pass pairs to set-initial-window-{position,size}

* figl/glut.scm (set-initial-window-position):
  (set-initial-window-size): Change arguments to a pair, matching the
  output of the corresponding getters and initialize-glut keyword
  arguments.

add null-program example

* Makefile.am: Dist examples and upstream-doc.

* examples/null-program.scm: New example.

fix callback pointer wrapping in glut

* figl/glut/types.scm (coerce-callback-pointer/ephemeral):
  (coerce-callback-pointer/sticky): Fix to protect the pointer in
  addition to the procedure.

automatic glut initialization

* figl/glut/runtime.scm (resolve): Run a hook before resolving glut
  symbols.  Remove the plural define-glut-procedures.

* figl/glut.scm: Rename glut-init to initialize-glut, and add keyword
  arguments for initial window size, position, and display mode.
  Default to (program-arguments) for args.  Make the glut-init? marker
  global, not thread-local.  Add resolve hook to initialize-glut as
  needed.

* examples/glut/demo.scm: Update.

add high-level interfaces to glut callback registration funcs

* figl/glut/types.scm (define-ephemeral-callback-pointer-type)
  (define-sticky-callback-pointer-type): Provide a way to protect
  procedures passed into GLUT from being GC'd.  Change the definitions
  of the pointer types to use these new helpers.

* figl/glut/low-level.scm: Use the pointer types defined in (figl glut
  types).

* figl/glut.scm: Add exports for the callback registration functions.

* examples/glut/demo.scm: Use set-display-callback.  Now the demo uses
  no low-level GLUT interfaces.

update gitignore

* .gitignore: Ignore any number of info fragments.

use ptrdiff_t if available, otherwise keep compat with released Guile

* figl/gl/types.scm (%ptr): Back-compatible definitions for Guile <
  2.0.8.

map GLboolean to Scheme boolean

* figl/gl/types.scm (GLboolean): Convert to and from appropriate
  Scheme values.

add glut callback-pointer types

* figl/glut/types.scm: New file.  Contains types previously defined in
  low-level.  Add callback-pointer types, but not used yet.

* figl/glut/low-level.scm: Move previous type definitions to new types
  module.

* Makefile.am: Update for new file.

add high-level glut bindings for init., windows

* figl/glut.scm: Add high-level bindings for more initialization
  procedures.  Bindings and data type for managing windows.  Some
  procedures to set and retrieve state relating to these.

* examples/glut/demo.scm: Update to use high-level bindings.

add high-level gl bindings for fragment and framebuffer operations

* figl/gl.scm (gl-clear, set-gl-clear-color, etc.): High-level
  bindings for functions pertaining to fragment and framebuffer
  operations.  There is now enough high-level to run the fixed
  function pipeline.

* examples/glut/demo.scm: Use high-level gl bindings.

remove low-level gl-begin/end from high-level bindings

* figl/gl.scm (gl-begin): Replace low-level re-export with syntax form
  like 'begin'.  Return final value from body expressions.  Require at
  least one body expression.

rename modifier-key-state to modifiers

* figl/glut/enums.scm (modifiers): Renamed from modifier-key-state.

use pairs in renaming re-exports

* figl/gl.scm: Use the correct pair syntax, not lists, for renaming
  re-exports.  Remove note about possible Guile bug.

add note about re-export bug

* figl/gl.scm: Note that there appears to be a bug in re-export
  syntax, chase up tomorrow.

add transformation bindings

* figl/gl.scm: Add transformation bindings; load-matrix, etc.

add bindings for begin/end and vertex specification

* figl/gl.scm: Initial work on high-level bindings for begin/end and
  vertex specification.  Choosing to only export unpacked float
  variants at this time.  Refer to inline comments for details.

use ptrdiff_t, not guesswork

* figl/gl/types.scm (GLintptr, GLsizeiptr): Define as ptrdiff_t from
  recent Guile.  Fixed a bug where this was set to an unsigned type.
  Add note that about non-Mesa platforms.

array parameters also accept pointers

* figl/gl/types.scm (coerce-array-pointer): Renamed from
  array->pointer.  Also accept pointers, and perhaps typed-arrays in
  the future.  Removed excess lambda.

restore type hack for glGetString.xml typo

* figl/gl/types.scm (const-GLubyte*): Restore this redundant type to
  work around a typo in glGetString.xml.

rename some glut enums

* figl/glut/enums.scm (button-name, layer-name, cursor-name): Renamed
  to be less generic, and more inline with gl enums.

update low-level docs

* doc/low-level-gl.texi: Update docs.  It seems I have some unpushed
  changes to Guile that make Daniel unable to do this.  Sorry about
  that!

typo in update-enumerations

* maint/update-enumerations (write-texi): Insert missing space in
  generated text.

* doc/low-level-gl-enums.texi:
* doc/low-level-glx-enums.texi: Update.

include all low-level bindings

* figl/parse.scm (parse-prototypes, skip?): Remove the skip? function,
  include all low-level bindings.  In many cases automatic skip is not
  possible, such as glMaterial that requires both packed and unpacked
  variants depending on the parameter.  Some variants are encouraged
  to be optimized (such as glColor3b).  Any low-level consumer can
  decide whether to use packed/unpacked, and what format to store data
  in.  Let the foot shooting commence.

* figl/gl/types.scm: Include more possible type combinations, whether
  used directly by gl or not.

* figl/gl/low-level.scm: Update.

* doc/: Not updated due to problems with line wrapping in texi output.

add remaining glut enumerations

* figl/glut/enums.scm: Add remaining.

Partially revert "typo fixes in parse.scm"

This reverts commit 940b3bea6a7d1ac5f388bdb9a402aab94f211f0c.

* figl/parse.scm (string->directions, string->transfer-types): If
  input is not a wildcard it must be within the valid-directions
  (valid-transfer-types), "expansion" is unrelated to this.

typo fixes in parse.scm

* figl/parse.scm (string->directions, string->transfer-types): Fix what
  appear to be a couple of typos.  Please revert if this is not
  correct.

debump version

* configure.ac: Version back to 0.1; 2.0 only really applies to GL
  bindings, and we want to provide a broader subset anyway.

create stub of glut enums

* figl/glut/enums.spec: New file.

* examples/glut/demo.scm: Use glut enums.  Use clear-buffer-mask, not
  attrib-mask, now that it is correctly picked up as a bitfield.

* Makefile.am: Update.

use type maps in update-enumerations

* maint/update-enumerations (type-map, use-type-map): New procedures
  to set and use an appropriate type map.
  (bitfield?): Use type-map when possible.
  (write-scm, write-texi): Handle strip-bit failures gracefully.

* doc/low-level-gl-enums.texi:
* figl/gl/enums.scm: Regenerate, picking up more bitfields.

add type map parser

* figl/parse.scm (parse-gl-type-map): New parser for type map files.

add module contrib with some helpers

* figl/contrib.scm: New file.
  (memoize): Wrapper to create memoized procedures.
  (string-split): Regexp-enhanced, until Guile core gets one.

* Makefile.am: Update.

remove top low-level.scm from tree

* figl/low-level.scm: Remove this old file from tree.

generate glx enums

* Makefile.am (update-enums): Add update-enums target.  Add enums files
  to build and dist.

* maint/update-enumerations (main): Also generate glx enums.
* figl/parse.scm: Add more hacks to be able to parse glxenums.spec.

* doc/low-level-glx-enums.texi:
* figl/glx/enums.scm: New generated files.

examples use enums module

* examples/glut/demo.scm: Use the enums module.

docs for enumerated values

* maint/update-enumerations: Generate documentation as well.

* doc/low-level-gl-enums.texi: New docs.
* doc/figl.texi: Include the new docs.

add enumerated values module

* figl/parse.scm (parse-gl-enumerations): New routine to parse
  enumerations from a spec file.

* maint/update-enumerations: New tool.

* figl/runtime.scm (define-enumeration, define-bitfield): New runtime
  macros.

* figl/gl/enums.scm: New generated file.

* Makefile.am (SOURCES): Add gl/enums to build.

update spec files from upstream

* upstream-doc/spec/: Update.

patch enum.spec for syntactic validity

* upstream-doc/spec/enum.spec: Patch spec until
  http://www.khronos.org/bugzilla/show_bug.cgi?id=786 is fixed.

add spec files from upstream

* upstream-doc/update-spec: New script.
* upstream-doc/spec: Download spec files.

rename upstream-man-pages to upstream-doc

* upstream-doc/: Rename from upstream-man-pages.

* figl/parse.scm:
* figl/config.scm.in: Adapt.

include more low-level bindings

* figl/parse.scm (parse-prototypes): Relax the skip? function to include
  more bindings.

* figl/gl/low-level.scm:
* doc/low-level-gl.texi: Regenerate.

* figl/gl/types.scm (GLvoid-**): New definition.

a #f array is the null pointer

* figl/gl/types.scm (array->pointer, define-array-foreign-type): Allow
  #f to indicate a null pointer.

add glut demo

* examples/glut/demo.scm: Copied GLUT demo from Daniel Hartwig.

documentation work

* doc/figl.texi: Reorganize and flesh out.

update loader comment

* figl/gl/runtime.scm: Update comment about loaders.

fix the resolver mess, and add glut to the build

* maint/update-low-level-bindings (write-scm): Update to use
  module-specific runtimes, and to generate define-FOO-procedure forms.
  This way modules can control how their symbols are loaded.

* figl/runtime.scm: Remove the default resolver; instead have
  define-foreign-procedure take a resolver form.

* figl/gl/runtime.scm:
* figl/glu/runtime.scm:
* figl/glut/runtime.scm:
* figl/glx/runtime.scm: New support modules.

* figl/gl/low-level.scm:
* figl/glu/low-level.scm:
* figl/glx/low-level.scm: Regenerate.

* figl/glut/low-level.scm: Change to use define-glut-procedure, and to
  delegate all the resolver business to the runtime module.

* Makefile.am: Add new files, and add glut to the build.

add comment about how loaders should work

* figl/runtime.scm: Add a big comment about loaders and how they should
  work.

initial glut bindings

* figl/glut/low-level.scm: Low-level bindings.

* figl/glut.scm: Initial high-level bindings; only one helper for
  glut-init.

documentation work

* doc/figl.texi: Add some docs.

beginnings of high-level modules

* Makefile.am: Add the new modules.
* figl/gl.scm:
* figl/glx.scm: Add high-level modules.  Nothing in them yet except a
  resolver.

better handling of array arguments, strings

* figl/gl/types.scm: Array arguments are passed as bytevectors.  Strings
  use pointer<->string.

type-specific wrapping and unwrapping of scheme values

* figl/runtime.scm (foreign-trampoline):
  (define-foreign-procedure):
  (define-foreign-type):
  (define-simple-foreign-type): Provide for a way for types to wrap and
  unwrap foreign values.

* figl/glx/types.scm:
* figl/glu/types.scm:
* figl/gl/types.scm: Adapt to define types with the runtime's macros.

define-foreign-procedure makes one def.; add define-foreign-procedures

* figl/runtime.scm (define-foreign-procedure):
  (define-foreign-procedures): Split define-foreign-procedure into two
  parts: one that handles the variants, and one "core" macro.

* maint/update-low-level-bindings: Update to generate
  define-foreign-procedures invocations.

* figl/gl/low-level.scm:
* figl/glu/low-level.scm:
* figl/glx/low-level.scm: Regenerate.

simplify gl type name creation

* figl/parse.scm (string->gl-type): Simplify.

* figl/glx/types.scm (const-GLXContext): Missing decl.

* figl/glx/low-level.scm: Regenerate.