mirror of
https://github.com/brl/mutter.git
synced 2024-11-24 09:00:42 -05:00
59a2bff8e2
If a test is not expected to succeed, then running it could be considered to be a waste of resources, particularly if the failure might manifest as an indefinite hang (see cogl!11), or if the test is likely to dump core and trigger "expensive" crash-reporting mechanisms like systemd-coredump, corekeeper, abrt or apport. Skip the tests that are expected to fail. They can still be requested via an environment variable, which can be set after fixing a bug to check which tests are now passing. Originally cogl!15, adapted for mutter's fork of cogl to use gboolean instead of CoglBool. https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1272 Signed-off-by: Simon McVittie <smcv@debian.org>
287 lines
10 KiB
C
287 lines
10 KiB
C
#ifndef _TEST_UTILS_H_
|
|
#define _TEST_UTILS_H_
|
|
|
|
/* NB: This header is for private and public api testing and so
|
|
* we need consider that if we are testing the public api we should
|
|
* just include <cogl/cogl.h> but since that will only provide
|
|
* opaque typedefs we need to include the specific internal headers
|
|
* for testing private apis...
|
|
*/
|
|
#ifdef COGL_COMPILATION
|
|
#include <cogl/cogl-context.h>
|
|
#include <cogl/cogl-onscreen.h>
|
|
#include <cogl/cogl-offscreen.h>
|
|
#include <cogl/cogl-texture-2d.h>
|
|
#include <cogl/cogl-primitive-texture.h>
|
|
#include <cogl/cogl-texture-2d-sliced.h>
|
|
#include <cogl/cogl-meta-texture.h>
|
|
#include <cogl/cogl-atlas-texture.h>
|
|
#else
|
|
#include <cogl/cogl.h>
|
|
#endif
|
|
|
|
#include <glib.h>
|
|
|
|
/* We don't really care about functions that are defined without a
|
|
header for the unit tests so we can just disable it here */
|
|
#ifdef __GNUC__
|
|
#pragma GCC diagnostic ignored "-Wmissing-declarations"
|
|
#endif
|
|
|
|
typedef enum _TestFlags
|
|
{
|
|
TEST_KNOWN_FAILURE = 1<<0,
|
|
TEST_REQUIREMENT_GL = 1<<1,
|
|
TEST_REQUIREMENT_NPOT = 1<<2,
|
|
TEST_REQUIREMENT_TEXTURE_RECTANGLE = 1<<4,
|
|
TEST_REQUIREMENT_TEXTURE_RG = 1<<5,
|
|
TEST_REQUIREMENT_POINT_SPRITE = 1<<6,
|
|
TEST_REQUIREMENT_MAP_WRITE = 1<<8,
|
|
TEST_REQUIREMENT_GLSL = 1<<9,
|
|
TEST_REQUIREMENT_OFFSCREEN = 1<<10,
|
|
TEST_REQUIREMENT_FENCE = 1<<11,
|
|
TEST_REQUIREMENT_PER_VERTEX_POINT_SIZE = 1<<12
|
|
} TestFlags;
|
|
|
|
/**
|
|
* TestUtilsTextureFlags:
|
|
* @TEST_UTILS_TEXTURE_NONE: No flags specified
|
|
* @TEST_UTILS_TEXTURE_NO_AUTO_MIPMAP: Disables the automatic generation of
|
|
* the mipmap pyramid from the base level image whenever it is
|
|
* updated. The mipmaps are only generated when the texture is
|
|
* rendered with a mipmap filter so it should be free to leave out
|
|
* this flag when using other filtering modes
|
|
* @TEST_UTILS_TEXTURE_NO_SLICING: Disables the slicing of the texture
|
|
* @TEST_UTILS_TEXTURE_NO_ATLAS: Disables the insertion of the texture inside
|
|
* the texture atlas used by Cogl
|
|
*
|
|
* Flags to pass to the test_utils_texture_new_* family of functions.
|
|
*/
|
|
typedef enum
|
|
{
|
|
TEST_UTILS_TEXTURE_NONE = 0,
|
|
TEST_UTILS_TEXTURE_NO_AUTO_MIPMAP = 1 << 0,
|
|
TEST_UTILS_TEXTURE_NO_SLICING = 1 << 1,
|
|
TEST_UTILS_TEXTURE_NO_ATLAS = 1 << 2
|
|
} TestUtilsTextureFlags;
|
|
|
|
extern CoglContext *test_ctx;
|
|
extern CoglFramebuffer *test_fb;
|
|
|
|
gboolean
|
|
test_utils_init (TestFlags requirement_flags,
|
|
TestFlags known_failure_flags);
|
|
|
|
void
|
|
test_utils_fini (void);
|
|
|
|
/*
|
|
* test_utils_texture_new_with_size:
|
|
* @context: A #CoglContext
|
|
* @width: width of texture in pixels.
|
|
* @height: height of texture in pixels.
|
|
* @flags: Optional flags for the texture, or %TEST_UTILS_TEXTURE_NONE
|
|
* @components: What texture components are required
|
|
*
|
|
* Creates a new #CoglTexture with the specified dimensions and pixel format.
|
|
*
|
|
* The storage for the texture is not necesarily created before this
|
|
* function returns. The storage can be explicitly allocated using
|
|
* cogl_texture_allocate() or preferably you can let Cogl
|
|
* automatically allocate the storage lazily when uploading data when
|
|
* Cogl may know more about how the texture will be used and can
|
|
* optimize how it is allocated.
|
|
*
|
|
* Return value: A newly created #CoglTexture
|
|
*/
|
|
CoglTexture *
|
|
test_utils_texture_new_with_size (CoglContext *ctx,
|
|
int width,
|
|
int height,
|
|
TestUtilsTextureFlags flags,
|
|
CoglTextureComponents components);
|
|
|
|
/*
|
|
* test_utils_texture_new_from_data:
|
|
* @context: A #CoglContext
|
|
* @width: width of texture in pixels
|
|
* @height: height of texture in pixels
|
|
* @flags: Optional flags for the texture, or %TEST_UTILS_TEXTURE_NONE
|
|
* @format: the #CoglPixelFormat the buffer is stored in in RAM
|
|
* @rowstride: the memory offset in bytes between the starts of
|
|
* scanlines in @data
|
|
* @data: pointer the memory region where the source buffer resides
|
|
* @error: A #GError to catch exceptional errors or %NULL
|
|
*
|
|
* Creates a new #CoglTexture based on data residing in memory.
|
|
*
|
|
* Note: If the given @format has an alpha channel then the data
|
|
* will be loaded into a premultiplied internal format. If you want
|
|
* to avoid having the source data be premultiplied then you can
|
|
* either specify that the data is already premultiplied or use
|
|
* test_utils_texture_new_from_bitmap which lets you explicitly
|
|
* request whether the data should internally be premultipled or not.
|
|
*
|
|
* Return value: A newly created #CoglTexture or %NULL on failure
|
|
*/
|
|
CoglTexture *
|
|
test_utils_texture_new_from_data (CoglContext *ctx,
|
|
int width,
|
|
int height,
|
|
TestUtilsTextureFlags flags,
|
|
CoglPixelFormat format,
|
|
int rowstride,
|
|
const uint8_t *data);
|
|
|
|
/*
|
|
* test_utils_texture_new_from_bitmap:
|
|
* @bitmap: A #CoglBitmap pointer
|
|
* @flags: Optional flags for the texture, or %TEST_UTILS_TEXTURE_NONE
|
|
* @premultiplied: Whether the texture should hold premultipled data.
|
|
* (if the bitmap already holds premultiplied data
|
|
* and %TRUE is given then no premultiplication will
|
|
* be done. The data will be premultipled while
|
|
* uploading if the bitmap has an alpha channel but
|
|
* does not already have a premultiplied format.)
|
|
*
|
|
* Creates a #CoglTexture from a #CoglBitmap.
|
|
*
|
|
* Return value: A newly created #CoglTexture or %NULL on failure
|
|
*/
|
|
CoglTexture *
|
|
test_utils_texture_new_from_bitmap (CoglBitmap *bitmap,
|
|
TestUtilsTextureFlags flags,
|
|
gboolean premultiplied);
|
|
|
|
/*
|
|
* test_utils_check_pixel:
|
|
* @framebuffer: The #CoglFramebuffer to read from
|
|
* @x: x co-ordinate of the pixel to test
|
|
* @y: y co-ordinate of the pixel to test
|
|
* @pixel: An integer of the form 0xRRGGBBAA representing the expected
|
|
* pixel value
|
|
*
|
|
* This performs reads a pixel on the given cogl @framebuffer and
|
|
* asserts that it matches the given color. The alpha channel of the
|
|
* color is ignored. The pixels are converted to a string and compared
|
|
* with g_assert_cmpstr so that if the comparison fails then the
|
|
* assert will display a meaningful message
|
|
*/
|
|
void
|
|
test_utils_check_pixel (CoglFramebuffer *framebuffer,
|
|
int x, int y, uint32_t expected_pixel);
|
|
|
|
/**
|
|
* @framebuffer: The #CoglFramebuffer to read from
|
|
* @x: x co-ordinate of the pixel to test
|
|
* @y: y co-ordinate of the pixel to test
|
|
* @pixel: An integer of the form 0xRRGGBBAA representing the expected
|
|
* pixel value
|
|
*
|
|
* This performs reads a pixel on the given cogl @framebuffer and
|
|
* asserts that it matches the given color. The alpha channel is also
|
|
* checked unlike with test_utils_check_pixel(). The pixels are
|
|
* converted to a string and compared with g_assert_cmpstr so that if
|
|
* the comparison fails then the assert will display a meaningful
|
|
* message.
|
|
*/
|
|
void
|
|
test_utils_check_pixel_and_alpha (CoglFramebuffer *fb,
|
|
int x, int y, uint32_t expected_pixel);
|
|
|
|
/*
|
|
* test_utils_check_pixel:
|
|
* @framebuffer: The #CoglFramebuffer to read from
|
|
* @x: x co-ordinate of the pixel to test
|
|
* @y: y co-ordinate of the pixel to test
|
|
* @pixel: An integer of the form 0xrrggbb representing the expected pixel value
|
|
*
|
|
* This performs reads a pixel on the given cogl @framebuffer and
|
|
* asserts that it matches the given color. The alpha channel of the
|
|
* color is ignored. The pixels are converted to a string and compared
|
|
* with g_assert_cmpstr so that if the comparison fails then the
|
|
* assert will display a meaningful message
|
|
*/
|
|
void
|
|
test_utils_check_pixel_rgb (CoglFramebuffer *framebuffer,
|
|
int x, int y, int r, int g, int b);
|
|
|
|
/*
|
|
* test_utils_check_region:
|
|
* @framebuffer: The #CoglFramebuffer to read from
|
|
* @x: x co-ordinate of the region to test
|
|
* @y: y co-ordinate of the region to test
|
|
* @width: width of the region to test
|
|
* @height: height of the region to test
|
|
* @pixel: An integer of the form 0xrrggbb representing the expected region color
|
|
*
|
|
* Performs a read pixel on the specified region of the given cogl
|
|
* @framebuffer and asserts that it matches the given color. The alpha
|
|
* channel of the color is ignored. The pixels are converted to a
|
|
* string and compared with g_assert_cmpstr so that if the comparison
|
|
* fails then the assert will display a meaningful message
|
|
*/
|
|
void
|
|
test_utils_check_region (CoglFramebuffer *framebuffer,
|
|
int x, int y,
|
|
int width, int height,
|
|
uint32_t expected_rgba);
|
|
|
|
/*
|
|
* test_utils_compare_pixel:
|
|
* @screen_pixel: A pixel stored in memory
|
|
* @expected_pixel: The expected RGBA value
|
|
*
|
|
* Compares a pixel from a buffer to an expected value. The pixels are
|
|
* converted to a string and compared with g_assert_cmpstr so that if
|
|
* the comparison fails then the assert will display a meaningful
|
|
* message.
|
|
*/
|
|
void
|
|
test_utils_compare_pixel (const uint8_t *screen_pixel, uint32_t expected_pixel);
|
|
|
|
/*
|
|
* test_utils_compare_pixel_and_alpha:
|
|
* @screen_pixel: A pixel stored in memory
|
|
* @expected_pixel: The expected RGBA value
|
|
*
|
|
* Compares a pixel from a buffer to an expected value. This is
|
|
* similar to test_utils_compare_pixel() except that it doesn't ignore
|
|
* the alpha component.
|
|
*/
|
|
void
|
|
test_utils_compare_pixel_and_alpha (const uint8_t *screen_pixel,
|
|
uint32_t expected_pixel);
|
|
|
|
/*
|
|
* test_utils_create_color_texture:
|
|
* @context: A #CoglContext
|
|
* @color: A color to put in the texture
|
|
*
|
|
* Creates a 1x1-pixel RGBA texture filled with the given color.
|
|
*/
|
|
CoglTexture *
|
|
test_utils_create_color_texture (CoglContext *context,
|
|
uint32_t color);
|
|
|
|
/* cogl_test_verbose:
|
|
*
|
|
* Queries if the user asked for verbose output or not.
|
|
*/
|
|
gboolean
|
|
cogl_test_verbose (void);
|
|
|
|
/* test_util_is_pot:
|
|
* @number: A number to test
|
|
*
|
|
* Returns whether the given integer is a power of two
|
|
*/
|
|
static inline gboolean
|
|
test_utils_is_pot (unsigned int number)
|
|
{
|
|
/* Make sure there is only one bit set */
|
|
return (number & (number - 1)) == 0;
|
|
}
|
|
|
|
#endif /* _TEST_UTILS_H_ */
|