Bug fixes for lcs.diff2html; xml.writer
[factor/jcg.git] / basis / opengl / capabilities / capabilities-docs.factor
blobf5424e19da879465bd20c7906b5a1e65a8198222
1 USING: help.markup help.syntax io kernel math quotations
2 opengl.gl multiline assocs ;
3 IN: opengl.capabilities
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." } ;
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." } ;
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" } "." } ;
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" } "." } ;
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." } ;
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." } ;
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" } "." } ;
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" } "." } ;
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." } ;
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 } "." } ;
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." } ;
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" } "." } ;
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." } ;
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
59 ABOUT: "gl-utilities"