archive/blender-archive
Archived
1
1
Fork 0
Code Pull Requests Packages Activity

Docs: add API docs for gpu.capabilities

Browse Source 
Adds Python API documentations for gpu.capabilities module.

Ref D12226
This commit is contained in:
nutti
2021-08-17 14:55:05 +10:00
committed by Campbell Barton
parent ba055493a0
commit 69fdcea978
2 changed files with 151 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
doc/python_api/sphinx_doc_gen.py
View File

@@ -255,6 +255,7 @@ else:
"gpu.state", "gpu.state",
"gpu.texture", "gpu.texture",
"gpu.platform", "gpu.platform",
"gpu.capabilities",
"gpu_extras", "gpu_extras",
"idprop.types", "idprop.types",
"mathutils", "mathutils",
@@ -2002,6 +2003,7 @@ def write_rst_importable_modules(basepath):
"gpu.state": "GPU State Utilities", "gpu.state": "GPU State Utilities",
"gpu.texture": "GPU Texture Utilities", "gpu.texture": "GPU Texture Utilities",
"gpu.platform": "GPU Platform Utilities", "gpu.platform": "GPU Platform Utilities",
"gpu.capabilities": "GPU Capabilities Utilities",
"bmesh": "BMesh Module", "bmesh": "BMesh Module",
"bmesh.ops": "BMesh Operators", "bmesh.ops": "BMesh Operators",
"bmesh.types": "BMesh Types", "bmesh.types": "BMesh Types",

162
source/blender/python/gpu/gpu_py_capabilities.c
View File

@@ -33,66 +33,166 @@
/** \name Functions /** \name Functions
* \{ */ * \{ */
PyDoc_STRVAR(pygpu_max_texture_size_get_doc,
".. function:: max_texture_size_get()\n"
"\n"
" Get estimated maximum texture size to be able to handle.\n"
"\n"
" :return: Texture size.\n"
" :rtype: int\n");
static PyObject *pygpu_max_texture_size_get(PyObject *UNUSED(self)) static PyObject *pygpu_max_texture_size_get(PyObject *UNUSED(self))
{ {
return PyLong_FromLong(GPU_max_texture_size()); return PyLong_FromLong(GPU_max_texture_size());
} }
PyDoc_STRVAR(pygpu_max_texture_layers_get_doc,
".. function:: max_texture_layers_get()\n"
"\n"
" Get maximum number of layers in texture.\n"
"\n"
" :return: Number of layers.\n"
" :rtype: int\n");
static PyObject *pygpu_max_texture_layers_get(PyObject *UNUSED(self)) static PyObject *pygpu_max_texture_layers_get(PyObject *UNUSED(self))
{ {
return PyLong_FromLong(GPU_max_texture_layers()); return PyLong_FromLong(GPU_max_texture_layers());
} }
PyDoc_STRVAR(pygpu_max_textures_get_doc,
".. function:: max_textures_get()\n"
"\n"
" Get maximum supported texture image units used for\n"
" accessing texture maps from the vertex shader and the\n"
" fragment processor.\n"
"\n"
" :return: Texture image units.\n"
" :rtype: int\n");
static PyObject *pygpu_max_textures_get(PyObject *UNUSED(self)) static PyObject *pygpu_max_textures_get(PyObject *UNUSED(self))
{ {
return PyLong_FromLong(GPU_max_textures()); return PyLong_FromLong(GPU_max_textures());
} }
PyDoc_STRVAR(pygpu_max_textures_vert_get_doc,
".. function:: max_textures_vert_get()\n"
"\n"
" Get maximum supported texture image units used for\n"
" accessing texture maps from the vertex shader.\n"
"\n"
" :return: Texture image units.\n"
" :rtype: int\n");
static PyObject *pygpu_max_textures_vert_get(PyObject *UNUSED(self)) static PyObject *pygpu_max_textures_vert_get(PyObject *UNUSED(self))
{ {
return PyLong_FromLong(GPU_max_textures_vert()); return PyLong_FromLong(GPU_max_textures_vert());
} }
PyDoc_STRVAR(pygpu_max_textures_geom_get_doc,
".. function:: max_textures_geom_get()\n"
"\n"
" Get maximum supported texture image units used for\n"
" accessing texture maps from the geometry shader.\n"
"\n"
" :return: Texture image units.\n"
" :rtype: int\n");
static PyObject *pygpu_max_textures_geom_get(PyObject *UNUSED(self)) static PyObject *pygpu_max_textures_geom_get(PyObject *UNUSED(self))
{ {
return PyLong_FromLong(GPU_max_textures_geom()); return PyLong_FromLong(GPU_max_textures_geom());
} }
PyDoc_STRVAR(pygpu_max_textures_frag_get_doc,
".. function:: max_textures_frag_get()\n"
"\n"
" Get maximum supported texture image units used for\n"
" accessing texture maps from the fragment shader.\n"
"\n"
" :return: Texture image units.\n"
" :rtype: int\n");
static PyObject *pygpu_max_textures_frag_get(PyObject *UNUSED(self)) static PyObject *pygpu_max_textures_frag_get(PyObject *UNUSED(self))
{ {
return PyLong_FromLong(GPU_max_textures_frag()); return PyLong_FromLong(GPU_max_textures_frag());
} }
PyDoc_STRVAR(pygpu_max_uniforms_vert_get_doc,
".. function:: max_uniforms_vert_get()\n"
"\n"
" Get maximum number of values held in uniform variable\n"
" storage for a vertex shader.\n"
"\n"
" :return: Number of values.\n"
" :rtype: int\n");
static PyObject *pygpu_max_uniforms_vert_get(PyObject *UNUSED(self)) static PyObject *pygpu_max_uniforms_vert_get(PyObject *UNUSED(self))
{ {
return PyLong_FromLong(GPU_max_uniforms_vert()); return PyLong_FromLong(GPU_max_uniforms_vert());
} }
PyDoc_STRVAR(pygpu_max_uniforms_frag_get_doc,
".. function:: max_uniforms_frag_get()\n"
"\n"
" Get maximum number of values held in uniform variable\n"
" storage for a fragment shader.\n"
"\n"
" :return: Number of values.\n"
" :rtype: int\n");
static PyObject *pygpu_max_uniforms_frag_get(PyObject *UNUSED(self)) static PyObject *pygpu_max_uniforms_frag_get(PyObject *UNUSED(self))
{ {
return PyLong_FromLong(GPU_max_uniforms_frag()); return PyLong_FromLong(GPU_max_uniforms_frag());
} }
PyDoc_STRVAR(pygpu_max_batch_indices_get_doc,
".. function:: max_batch_indices_get()\n"
"\n"
" Get maximum number of vertex array indices.\n"
"\n"
" :return: Number of indices.\n"
" :rtype: int\n");
static PyObject *pygpu_max_batch_indices_get(PyObject *UNUSED(self)) static PyObject *pygpu_max_batch_indices_get(PyObject *UNUSED(self))
{ {
return PyLong_FromLong(GPU_max_batch_indices()); return PyLong_FromLong(GPU_max_batch_indices());
} }
PyDoc_STRVAR(pygpu_max_batch_vertices_get_doc,
".. function:: max_batch_vertices_get()\n"
"\n"
" Get maximum number of vertex array vertices.\n"
"\n"
" :return: Number of vertices.\n"
" :rtype: int\n");
static PyObject *pygpu_max_batch_vertices_get(PyObject *UNUSED(self)) static PyObject *pygpu_max_batch_vertices_get(PyObject *UNUSED(self))
{ {
return PyLong_FromLong(GPU_max_batch_vertices()); return PyLong_FromLong(GPU_max_batch_vertices());
} }
PyDoc_STRVAR(pygpu_max_vertex_attribs_get_doc,
".. function:: max_vertex_attribs_get()\n"
"\n"
" Get maximum number of vertex attributes accessible to\n"
" a vertex shader.\n"
"\n"
" :return: Number of attributes.\n"
" :rtype: int\n");
static PyObject *pygpu_max_vertex_attribs_get(PyObject *UNUSED(self)) static PyObject *pygpu_max_vertex_attribs_get(PyObject *UNUSED(self))
{ {
return PyLong_FromLong(GPU_max_vertex_attribs()); return PyLong_FromLong(GPU_max_vertex_attribs());
} }
PyDoc_STRVAR(pygpu_max_varying_floats_get_doc,
".. function:: max_varying_floats_get()\n"
"\n"
" Get maximum number of varying variables used by\n"
" vertex and fragment shaders.\n"
"\n"
" :return: Number of variables.\n"
" :rtype: int\n");
static PyObject *pygpu_max_varying_floats_get(PyObject *UNUSED(self)) static PyObject *pygpu_max_varying_floats_get(PyObject *UNUSED(self))
{ {
return PyLong_FromLong(GPU_max_varying_floats()); return PyLong_FromLong(GPU_max_varying_floats());
} }
PyDoc_STRVAR(pygpu_extensions_get_doc,
".. function:: extensions_get()\n"
"\n"
" Get supported extensions in the current context.\n"
"\n"
" :return: Extensions.\n"
" :rtype: tuple of string\n");
static PyObject *pygpu_extensions_get(PyObject *UNUSED(self)) static PyObject *pygpu_extensions_get(PyObject *UNUSED(self))
{ {
int extensions_len = GPU_extensions_len(); int extensions_len = GPU_extensions_len();
@@ -112,19 +212,55 @@ static PyObject *pygpu_extensions_get(PyObject *UNUSED(self))
* \{ */ * \{ */
static struct PyMethodDef pygpu_capabilities__tp_methods[] = { static struct PyMethodDef pygpu_capabilities__tp_methods[] = {
{"max_texture_size_get", (PyCFunction)pygpu_max_texture_size_get, METH_NOARGS, NULL}, {"max_texture_size_get",
{"max_texture_layers_get", (PyCFunction)pygpu_max_texture_layers_get, METH_NOARGS, NULL}, (PyCFunction)pygpu_max_texture_size_get,
{"max_textures_get", (PyCFunction)pygpu_max_textures_get, METH_NOARGS, NULL}, METH_NOARGS,
{"max_textures_vert_get", (PyCFunction)pygpu_max_textures_vert_get, METH_NOARGS, NULL}, pygpu_max_texture_size_get_doc},
{"max_textures_geom_get", (PyCFunction)pygpu_max_textures_geom_get, METH_NOARGS, NULL}, {"max_texture_layers_get",
{"max_textures_frag_get", (PyCFunction)pygpu_max_textures_frag_get, METH_NOARGS, NULL}, (PyCFunction)pygpu_max_texture_layers_get,
{"max_uniforms_vert_get", (PyCFunction)pygpu_max_uniforms_vert_get, METH_NOARGS, NULL}, METH_NOARGS,
{"max_uniforms_frag_get", (PyCFunction)pygpu_max_uniforms_frag_get, METH_NOARGS, NULL}, pygpu_max_texture_layers_get_doc},
{"max_batch_indices_get", (PyCFunction)pygpu_max_batch_indices_get, METH_NOARGS, NULL}, {"max_textures_get",
{"max_batch_vertices_get", (PyCFunction)pygpu_max_batch_vertices_get, METH_NOARGS, NULL}, (PyCFunction)pygpu_max_textures_get,
{"max_vertex_attribs_get", (PyCFunction)pygpu_max_vertex_attribs_get, METH_NOARGS, NULL}, METH_NOARGS,
{"max_varying_floats_get", (PyCFunction)pygpu_max_varying_floats_get, METH_NOARGS, NULL}, pygpu_max_textures_get_doc},
{"extensions_get", (PyCFunction)pygpu_extensions_get, METH_NOARGS, NULL}, {"max_textures_vert_get",
(PyCFunction)pygpu_max_textures_vert_get,
METH_NOARGS,
pygpu_max_textures_vert_get_doc},
{"max_textures_geom_get",
(PyCFunction)pygpu_max_textures_geom_get,
METH_NOARGS,
pygpu_max_textures_geom_get_doc},
{"max_textures_frag_get",
(PyCFunction)pygpu_max_textures_frag_get,
METH_NOARGS,
pygpu_max_textures_frag_get_doc},
{"max_uniforms_vert_get",
(PyCFunction)pygpu_max_uniforms_vert_get,
METH_NOARGS,
pygpu_max_uniforms_vert_get_doc},
{"max_uniforms_frag_get",
(PyCFunction)pygpu_max_uniforms_frag_get,
METH_NOARGS,
pygpu_max_uniforms_frag_get_doc},
{"max_batch_indices_get",
(PyCFunction)pygpu_max_batch_indices_get,
METH_NOARGS,
pygpu_max_batch_indices_get_doc},
{"max_batch_vertices_get",
(PyCFunction)pygpu_max_batch_vertices_get,
METH_NOARGS,
pygpu_max_batch_vertices_get_doc},
{"max_vertex_attribs_get",
(PyCFunction)pygpu_max_vertex_attribs_get,
METH_NOARGS,
pygpu_max_vertex_attribs_get_doc},
{"max_varying_floats_get",
(PyCFunction)pygpu_max_varying_floats_get,
METH_NOARGS,
pygpu_max_varying_floats_get_doc},
{"extensions_get", (PyCFunction)pygpu_extensions_get, METH_NOARGS, pygpu_extensions_get_doc},
{NULL, NULL, 0, NULL}, {NULL, NULL, 0, NULL},
}; };