summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
...
* renderer: Add cogl_renderer_get_n_fragment_texture_units()Damien Lespiau2011-09-051-0/+1
| | | | | | | | | Add a method on the renderer to know how many texture image units are accessible from fragment shaders. https://bugzilla.gnome.org/show_bug.cgi?id=657347 Reviewed-by: Robert Bragg <robert@linux.intel.com>
* display: Add an accessor to get the renderer out of a displayDamien Lespiau2011-09-051-0/+1
| | | | | | https://bugzilla.gnome.org/show_bug.cgi?id=657347 Reviewed-by: Robert Bragg <robert@linux.intel.com>
* context: Add an accessor to get display associated with the contextDamien Lespiau2011-09-051-0/+1
| | | | | | https://bugzilla.gnome.org/show_bug.cgi?id=657347 Reviewed-by: Robert Bragg <robert@linux.intel.com>
* matrix: Add cogl_matrix_look_atRobert Bragg2011-08-121-0/+1
| | | | | | | | | Similar to the widely used gluLookAt API, this adds a CoglMatrix utility for setting up a view transform in terms of positioning a camera/eye position that points to a given object position aligned to a given world-up vector. Reviewed-by: Neil Roberts <neil@linux.intel.com>
* framebuffer: Make framebuffer_clear APIs public experimentalRobert Bragg2011-08-121-0/+2
| | | | | | | | | | This makes cogl_framebuffer_clear and cogl_framebuffer_clear4f public as experimental API. Since these functions take explicit framebuffer pointers you don't need to push/pop a framebuffer just to clear it. Also these functions are implicitly tied to a specific CoglContext via the framebuffer pointer unlike cogl_clear. Reviewed-by: Neil Roberts <neil@linux.intel.com>
* framebuffer: Adds a context getter for CoglFramebufferRobert Bragg2011-08-121-0/+1
| | | | | | | | | | This adds a function to query what CoglContext a given framebuffer belongs too. This can be useful if you pass framebuffer pointers around and at some point you want to create another framebuffer as part of the same context as a given framebuffer without assuming there is a single default context. Reviewed-by: Neil Roberts <neil@linux.intel.com>
* dist: enable more features for distcheckRobert Bragg2011-07-201-1/+1
| | | | | | | As a bare minimum we want to ensure that are releases are able to build with support for gles1, gles2, gl, egl and glx. Previously we only checked the build with gl + glx enabled and our last release actually missed a header file required for building with egl.
* Add note about updating libtool versioning in doc/RELEASINGRobert Bragg2011-07-201-0/+1
|
* Adds ColorMask support to CoglRobert Bragg2011-07-191-0/+6
| | | | | | | | | | | | | This adds CoglPipeline and CoglFramebuffer support for setting a color mask which is a bit mask defining which color channels should be written to the current framebuffer. The final color mask is the intersection of the framebuffer color mask and the pipeline color mask. The framebuffer mask affects all rendering to the framebuffer while the pipeline masks can be used to affect individual primitives. Reviewed-by: Neil Roberts <neil@linux.intel.com>
* dist: give 2.0 manual unique DOC_MODULE nameRobert Bragg2011-07-113-1/+1
| | | | | | | | | | | | The experimental 2.0 reference manual was setup with DOC_MODULE name of "cogl" which conflicted with the 1.x API manual. This meant that when running make install for both the reference manuals all the html files would end up bundled together in the same location. The 2.0 API reference now has a DOC_MODULE name of "cogl-2.0-experimental" the corresponding -sections.txt and -docs.xml.in files have also been renamed to match this. Signed-off-by: Neil Roberts <neil@linux.intel.com>
* onscreen: make platform specific onscreen apis consistentRobert Bragg2011-07-111-5/+5
| | | | | | | | | There were several CoglOnscreen functions named like: cogl_onscreen_<platform>_blah instead of cogl_<platform>_onscreen_blah so this patch updates those to be consistent with other platform specific apis we have in cogl. Signed-off-by: Neil Roberts <neil@linux.intel.com>
* docs: update cogl-context 2.0 docsRobert Bragg2011-07-042-3/+1
| | | | | | | | | | This fixes the 2.0 reference manual Makefile to not ignore cogl-context.h; it also adds cogl_context_new to cogl-sections.txt and removes cogl_begin/end_gl. (For using raw GL with Cogl 2.0 the plan was to add some API for creating additional GL contexts via some Cogl API and a way to push/pop those contexts.) Signed-off-by: Neil Roberts <neil@linux.intel.com>
* docs: Adds missing cogl_framebuffer syms to referenceRobert Bragg2011-07-041-0/+37
| | | | | | | This adds a description for the cogl-framebuffer section and adds lots of missing symbols to the 2.0 reference manual. Signed-off-by: Neil Roberts <neil@linux.intel.com>
* doc: Adds missing cogl_matrix syms to 2.0 referenceRobert Bragg2011-07-041-2/+7
| | | | | | | There were a few cogl_matrix symbols missing from the cogl-sections.txt for the 2.0 reference manual. Signed-off-by: Neil Roberts <neil@linux.intel.com>
* matrix: Adds cogl_matrix_is_identity APIRobert Bragg2011-07-042-0/+2
| | | | | | | This adds a function called cogl_matrix_is_identity that can determine if a given matrix is an identity matrix or not. Signed-off-by: Neil Roberts <neil@linux.intel.com>
* Updates wayland symbol names to be consistentRobert Bragg2011-06-301-4/+4
| | | | | | | This updates the public wayland symbols to follow the pattern cogl_wayland_blah instead of cogl_blah_wayland. Signed-off-by: Neil Roberts <neil@linux.intel.com>
* work towards consistent platform file/symbol namingRobert Bragg2011-06-301-2/+2
| | | | | | | | | | | | | we've got into a bit of a mess with how we name platform specific symbols and files, so this is a first pass at trying to tidy that up. All platform specific symbols should be named like cogl_<platform>_symbol_name and similarly files should be named like cogl-<platform>-filename.c This patch tackles the X11 specific renderer/display APIs as a start. Signed-off-by: Neil Roberts <neil@linux.intel.com>
* replace public native_event APIs with typesafe APIsRobert Bragg2011-06-301-3/+10
| | | | | | | | | This adds Xlib and Win32 typesafe replacements for cogl_renderer_handle_native_event, cogl_renderer_add_native_filter, cogl_renderer_remove_native_filter. The old functions are kept as an implementation detail so we can share code. Signed-off-by: Neil Roberts <neil@linux.intel.com>
* 2.0 reference: make various fixups in cogl-sections.txtRobert Bragg2011-06-302-40/+20
| | | | | | | This does some minor gardening in cogl-sections.txt, tweaking some of the section titles and removing some stale api references. Signed-off-by: Neil Roberts <neil@linux.intel.com>
* docs: Adds cogl-index/attribute-buffer syms to 2.0 referenceRobert Bragg2011-06-301-0/+16
| | | | Signed-off-by: Neil Roberts <neil@linux.intel.com>
* docs: fix stale include linksRobert Bragg2011-06-301-2/+2
| | | | Signed-off-by: Neil Roberts <neil@linux.intel.com>
* docs: Fix typo to avoid duplicate section nameRobert Bragg2011-06-301-1/+1
| | | | Signed-off-by: Neil Roberts <neil@linux.intel.com>
* docs: Add swap-chain/onscreen-template to 2.0 referenceRobert Bragg2011-06-301-0/+14
| | | | | | | This adds the cogl_swap_chain and cogl_onscreen_template symbols to the experimental 2.0 reference manual. Signed-off-by: Neil Roberts <neil@linux.intel.com>
* docs: Adds CoglDisplay symbols to 2.0 referenceRobert Bragg2011-06-301-0/+13
| | | | | | Adds the cogl_display symbols to the experimental 2.0 reference manual. Signed-off-by: Neil Roberts <neil@linux.intel.com>
* docs: Add CoglRenderer documentation to 2.0 referenceRobert Bragg2011-06-301-0/+22
| | | | | | | This lists the cogl_renderer symbols in the cogl-sections.txt for the experimental 2.0 reference manual. Signed-off-by: Neil Roberts <neil@linux.intel.com>
* doc/RELEASING: Fix the check for diffs from origin/masterNeil Roberts2011-06-291-1/+1
| | | | | | | | | The recommended command to check for differences from master to the remote master was using git log with a range from the local master to the remote master but this wouldn't work if the local master is ahead of the remote master because the range is backwards. This patch changes it to recommend git diff --stat instead because then the command would work even if the two branches have diverged.
* doc: Fix EXTRA_DIST variable setupRobert Bragg2011-06-142-14/+6
| | | | | | | | | Since gtk-doc is an optional dependency for Cogl then we need to special case how EXTRA_DIST is initialized. It shouldn't be set when using gtk-doc since gtk-doc.make expects to initialize EXTRA_DIST. If we aren't using gtk-doc then it should be initialized to an empty value instead of including gtk-doc.make so that the later lines that append various extra png files to EXTRA_DIST won't fail.
* doc: Adds doc/RELEASINGRobert Bragg2011-06-141-0/+86
| | | | This adds some notes for maintainers about how to make a Cogl release.
* Make it clearer that the 2.0 API is experimentalRobert Bragg2011-06-1410-1/+1
| | | | | | | This explicitly renames the cogl-2.0 reference manual to cogl-2.0-experimental and renames the cogl-2.0 pkg-config file to cogl-2.0-experimental.pc. Hopefully this should avoid miss-understandings.
* Make CoglTexture2D public as experimental APIRobert Bragg2011-06-011-0/+10
| | | | | | | | | | | | | | | | | This exposes a CoglTexture2D typedef and adds the following experimental API: cogl_is_texture_2d cogl_texture_2d_new_with_size cogl_texture_2d_new_from_data cogl_texture_2d_new_from_foreign Since this is experimental API you need to define COGL_ENABLE_EXPERIMENTAL_API before including cogl.h. Note: With these new entrypoints we now expect a CoglContext pointer to be passed in, instead of assuming there is a default context. The aim is that for Cogl 2.0 we won't have a default context so this is a step in that direction.
* build: Fix generation of the documentation MakefilesDamien Lespiau2011-05-182-2/+6
| | | | | | | | | Automake seems a bit fragile when trying to do cunning things like including a file with "-include". It does not recurse into that file (if it exists) to generate the final Makefiles. Let's add a if BUILD_GTK_DOC guard around the gtk-doc.make inclusion instead, hopefully should work as intended.
* Add CoglDepthState APIRobert Bragg2011-05-164-8/+30
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Instead of simply extending the cogl_pipeline_ namespace to add api for controlling the depth testing state we now break the api out. This adds a CoglDepthState type that can be stack allocated. The members of the structure are private but we have the following API to setup the state: cogl_depth_state_init cogl_depth_state_set_test_enabled cogl_depth_state_get_test_enabled cogl_depth_state_set_test_function cogl_depth_state_get_test_function cogl_depth_state_set_writing_enabled cogl_depth_state_get_writing_enabled cogl_depth_state_set_range cogl_depth_state_get_range This removes the following experimental API which is now superseded: cogl_material_set_depth_test_enabled cogl_material_get_depth_test_enabled cogl_material_set_depth_test_function cogl_material_get_depth_test_function cogl_material_set_depth_writing_enabled cogl_material_get_depth_writing_enabled cogl_material_set_depth_range cogl_material_get_depth_range Once a CoglDepthState structure is setup it can be set on a pipeline using cogl_pipeline_set_depth_state().
* Rename CoglIndexArray to CoglIndexBufferRobert Bragg2011-05-161-1/+1
| | | | | | | | | This is part of a broader cleanup of some of the experimental Cogl API. One of the reasons for this particular rename is to switch away from using the term "Array" which implies a regular, indexable layout which isn't the case. We also want to strongly imply a relationship between CoglBuffers and CoglIndexBuffers and be consistent with the CoglAttributeBuffer and CoglPixelBuffer APIs.
* Rename CoglPixelArray to CoglPixelBufferRobert Bragg2011-05-161-1/+1
| | | | | | | | | This is part of a broader cleanup of some of the experimental Cogl API. One of the reasons for this particular rename is to switch away from using the term "Array" which implies a regular, indexable layout which isn't the case. We also want to strongly imply a relationship between CoglBuffers and CoglPixelBuffers and be consistent with the CoglAttributeBuffer and CoglIndexBuffer APIs.
* math: Adds an experimental euler APIRobert Bragg2011-05-162-0/+23
| | | | | | | | | | | | | | | | This adds an experimental CoglEuler data type and the following new functions: cogl_euler_init cogl_euler_init_from_matrix cogl_euler_init_from_quaternion cogl_euler_equal cogl_euler_copy cogl_euler_free cogl_quaternion_init_from_euler Since this is experimental API you need to define COGL_ENABLE_EXPERIMENTAL_API before including cogl.h
* math: Adds an experimental quaternion APIRobert Bragg2011-05-164-0/+58
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This adds an experimental quaternion utility API. It's not yet fully documented but it's complete enough that people can start to experiment with using it. It adds the following functions: cogl_quaternion_init_identity cogl_quaternion_init cogl_quaternion_init_from_angle_vector cogl_quaternion_init_from_array cogl_quaternion_init_from_x_rotation cogl_quaternion_init_from_y_rotation cogl_quaternion_init_from_z_rotation cogl_quaternion_equal cogl_quaternion_copy cogl_quaternion_free cogl_quaternion_get_rotation_angle cogl_quaternion_get_rotation_axis cogl_quaternion_normalize cogl_quaternion_dot_product cogl_quaternion_invert cogl_quaternion_multiply cogl_quaternion_pow cogl_quaternion_slerp cogl_quaternion_nlerp cogl_quaternion_squad cogl_get_static_identity_quaternion cogl_get_static_zero_quaternion Since it's experimental API you'll need to define COGL_ENABLE_EXPERIMENTAL_API before including cogl.h.
* build: Allow to compile a git checkout without gtk-docDamien Lespiau2011-05-122-2/+4
| | | | | | Gtk-doc can be hard to install on Windows. This patch enables people wanting to hack on Cogl itself from a Windows system to do so without the hassle to get gtk-doc installed first.
* Adds experimental cogl 2.0 referenceRobert Bragg2011-05-1010-1/+963
| | | | | | This pulls in the experimental cogl 2.0 reference manual from the clutter repository since it wasn't included in the filter-branch when we split cogl out.
* build: Distribute CODING_STYLEDamien Lespiau2011-05-061-0/+2
|
* build: Enable building the documentation againDamien Lespiau2011-05-064-7/+15
| | | | | At least the 1.6.0 documentation. The 2.0 one has been missed by the filter-branch and will be re-added later.
* docs: Adds bitmap section to cogl reference manualRobert Bragg2011-01-211-0/+1
| | | | This adds an include for the cogl-bitmap section to cogl-docs.xml.in
* docs: Fixes for the Cogl API referenceEmmanuele Bassi2010-12-221-4/+35
|
* build: Ignore private headers when building the Cogl referenceEmmanuele Bassi2010-12-211-5/+17
| | | | Otherwise gtk-doc will try to look up private symbols.
* docs: Add 1.6 index to the API referencesEmmanuele Bassi2010-12-091-0/+5
|
* matrix gtype: registers a boxed type for CoglMatrixRobert Bragg2010-12-072-0/+7
| | | | | | | | | To allow us to have gobject properties that accept a CoglMatrix value we need to register a GType. This adds a cogl_gtype_matrix_get_type function that will register a static boxed type called "CoglMatrix". This adds a new section to the reference manual for GType integration functions.
* matrix: Adds experimental cogl_matrix_{transform,project}_pointsRobert Bragg2010-11-231-1/+1
| | | | | | | | | | | | | | | This add two new function that allows us to transform or project an array of points instead of only transforming one point at a time. Recent benchmarking has shown cogl_matrix_transform_point to be a bottleneck sometimes, so this should allow us to reduce the overhead when transforming lots of vertices at the same time, and also reduce the cost of 3 component, non-projective transforms. For now they are marked as experimental (you have to define COGL_ENABLE_EXPERIMENTAL_API) because there is some concern that it introduces some inconsistent naming. cogl_matrix_transform_point would have to be renamed cogl_matrix_project_point to be consistent, but that would be an API break.
* cogl: Adds {push,pop,get}_source functionsRobert Bragg2010-10-261-0/+3
| | | | | | | | | This exposes the idea of a stack of source materials instead of just having a single current material. This allows the writing of orthogonal code that can change the current source material and restore it to its previous state. It also allows the implementation of new composite primitives that may want to validate the current source material and possibly make override changes in a derived material.
* docs: Put deprecated Cogl symbols into new sectionRobert Bragg2010-09-232-31/+96
| | | | | | | This adds a "Cogl deprecated API" chapter to the Cogl reference manual so we can group all the documentation for deprecated symbols together instead of having them clutter up the documentation of symbols we would rather developers used.
* docs: update the overview paragraph for CoglRobert Bragg2010-09-231-5/+7
| | | | | Instead of describing OpenGL as "a low level OpenGL abstraction library" it is now summarised as "modern 3D graphics API".
* docs: cogl-texture-3d wasn't listed as experimentalRobert Bragg2010-09-231-1/+1
| | | | | | The CoglTexture3D API is only available when defining COGL_ENABLE_EXPERIMENTAL_API so it should be listed in the experimental section of the API reference.