basis/opengl/capabilities/capabilities-docs.factor

   1 USING: help.markup help.syntax io kernel math quotations
   2 opengl.gl multiline assocs ;
   3 IN: opengl.capabilities
   4
   5 HELP: gl-version
   6 { $values { "version" "The version string from the OpenGL implementation" } }
   7 { $description "Wrapper for " { $snippet "GL_VERSION glGetString" } " that removes the vendor-specific information from the version string." } ;
   8
   9 HELP: gl-vendor-version
  10 { $values { "version" "The vendor-specific version information from the OpenGL implementation" } }
  11 { $description "Wrapper for " { $snippet "GL_VERSION glGetString" } " that returns only the vendor-specific information from the version string." } ;
  12
  13 HELP: has-gl-version?
  14 { $values { "version" "A version string" } { "?" "A boolean value" } }
  15 { $description "Compares the version string returned by " { $link gl-version } " to " { $snippet "version" } ". Returns true if the implementation version meets or exceeds " { $snippet "version" } "." } ;
  16
  17 HELP: require-gl-version
  18 { $values { "version" "A version string" } }
  19 { $description "Throws an exception if " { $link has-gl-version? } " returns false for " { $snippet "version" } "." } ;
  20
  21 HELP: glsl-version
  22 { $values { "version" "The GLSL version string from the OpenGL implementation" } }
  23 { $description "Wrapper for " { $snippet "GL_SHADING_LANGUAGE_VERSION glGetString" } " that removes the vendor-specific information from the version string." } ;
  24
  25 HELP: glsl-vendor-version
  26 { $values { "version" "The vendor-specific GLSL version information from the OpenGL implementation" } }
  27 { $description "Wrapper for " { $snippet "GL_SHADING_LANGUAGE_VERSION glGetString" } " that returns only the vendor-specific information from the version string." } ;
  28
  29 HELP: has-glsl-version?
  30 { $values { "version" "A version string" } { "?" "A boolean value" } }
  31 { $description "Compares the version string returned by " { $link glsl-version } " to " { $snippet "version" } ". Returns true if the implementation version meets or exceeds " { $snippet "version" } "." } ;
  32
  33 HELP: require-glsl-version
  34 { $values { "version" "A version string" } }
  35 { $description "Throws an exception if " { $link has-glsl-version? } " returns false for " { $snippet "version" } "." } ;
  36
  37 HELP: gl-extensions
  38 { $values { "seq" "A sequence of strings naming the implementation-supported OpenGL extensions" } }
  39 { $description "Wrapper for " { $snippet "GL_EXTENSIONS glGetString" } " that returns a sequence of extension names supported by the OpenGL implementation." } ;
  40
  41 HELP: has-gl-extensions?
  42 { $values { "extensions" "A sequence of extension name strings" } { "?" "A boolean value" } }
  43 { $description "Returns true if the set of " { $snippet "extensions" } " is a subset of the implementation-supported extensions returned by " { $link gl-extensions } "." } ;
  44
  45 HELP: has-gl-version-or-extensions?
  46 { $values { "version" "A version string" } { "extensions" "A sequence of extension name strings" } { "?" "a boolean" } }
  47 { $description "Returns true if either " { $link has-gl-version? } " or " { $link has-gl-extensions? } " returns true for " { $snippet "version" } " or " { $snippet "extensions" } ", respectively. Intended for use when required OpenGL functionality can be verified either by a minimum version or a set of equivalent extensions." } ;
  48
  49 HELP: require-gl-extensions
  50 { $values { "extensions" "A sequence of extension name strings" } }
  51 { $description "Throws an exception if " { $link has-gl-extensions? } " returns false for " { $snippet "extensions" } "." } ;
  52
  53 HELP: require-gl-version-or-extensions
  54 { $values { "version" "A version string" } { "extensions" "A sequence of extension name strings" } }
  55 { $description "Throws an exception if neither " { $link has-gl-version? } " nor " { $link has-gl-extensions? } " returns true for " { $snippet "version" } " or " { $snippet "extensions" } ", respectively. Intended for use when required OpenGL functionality can be verified either by a minimum version or a set of equivalent extensions." } ;
  56
  57 { require-gl-version require-glsl-version require-gl-extensions require-gl-version-or-extensions has-gl-version? has-glsl-version? has-gl-extensions? has-gl-version-or-extensions? gl-version glsl-version gl-extensions } related-words
  58
  59 ABOUT: "gl-utilities"