2017-02-06 14:41:10 +00:00
|
|
|
/*
|
|
|
|
* Copyright 2017 Google Inc.
|
|
|
|
*
|
|
|
|
* Use of this source code is governed by a BSD-style license that can be
|
|
|
|
* found in the LICENSE file.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef SkVertices_DEFINED
|
|
|
|
#define SkVertices_DEFINED
|
|
|
|
|
2019-04-23 17:05:21 +00:00
|
|
|
#include "include/core/SkColor.h"
|
|
|
|
#include "include/core/SkRect.h"
|
|
|
|
#include "include/core/SkRefCnt.h"
|
2017-02-06 14:41:10 +00:00
|
|
|
|
2020-03-31 14:38:31 +00:00
|
|
|
class SkData;
|
|
|
|
struct SkPoint;
|
|
|
|
class SkVerticesPriv;
|
|
|
|
|
2017-02-06 14:41:10 +00:00
|
|
|
/**
|
2017-03-16 18:38:48 +00:00
|
|
|
* An immutable set of vertex data that can be used with SkCanvas::drawVertices.
|
2017-02-06 14:41:10 +00:00
|
|
|
*/
|
2018-10-30 15:23:00 +00:00
|
|
|
class SK_API SkVertices : public SkNVRefCnt<SkVertices> {
|
2020-03-04 14:48:08 +00:00
|
|
|
struct Desc;
|
|
|
|
struct Sizes;
|
2017-02-06 14:41:10 +00:00
|
|
|
public:
|
2017-04-03 15:11:09 +00:00
|
|
|
enum VertexMode {
|
|
|
|
kTriangles_VertexMode,
|
|
|
|
kTriangleStrip_VertexMode,
|
|
|
|
kTriangleFan_VertexMode,
|
2018-01-23 16:50:25 +00:00
|
|
|
|
|
|
|
kLast_VertexMode = kTriangleFan_VertexMode,
|
2017-04-03 15:11:09 +00:00
|
|
|
};
|
|
|
|
|
2017-03-14 16:04:16 +00:00
|
|
|
/**
|
2020-03-02 19:57:09 +00:00
|
|
|
* Create a vertices by copying the specified arrays. texs, colors may be nullptr,
|
|
|
|
* and indices is ignored if indexCount == 0.
|
2017-03-14 16:04:16 +00:00
|
|
|
*/
|
2017-04-03 15:11:09 +00:00
|
|
|
static sk_sp<SkVertices> MakeCopy(VertexMode mode, int vertexCount,
|
2017-03-14 16:04:16 +00:00
|
|
|
const SkPoint positions[],
|
|
|
|
const SkPoint texs[],
|
|
|
|
const SkColor colors[],
|
|
|
|
int indexCount,
|
2020-03-11 16:26:56 +00:00
|
|
|
const uint16_t indices[]);
|
2017-02-06 14:41:10 +00:00
|
|
|
|
2018-06-29 18:32:21 +00:00
|
|
|
static sk_sp<SkVertices> MakeCopy(VertexMode mode, int vertexCount,
|
|
|
|
const SkPoint positions[],
|
|
|
|
const SkPoint texs[],
|
2020-03-11 16:26:56 +00:00
|
|
|
const SkColor colors[]) {
|
2018-06-29 18:32:21 +00:00
|
|
|
return MakeCopy(mode,
|
|
|
|
vertexCount,
|
|
|
|
positions,
|
|
|
|
texs,
|
|
|
|
colors,
|
|
|
|
0,
|
2020-03-11 16:26:56 +00:00
|
|
|
nullptr);
|
2018-06-29 18:32:21 +00:00
|
|
|
}
|
|
|
|
|
2017-03-16 18:38:48 +00:00
|
|
|
enum BuilderFlags {
|
|
|
|
kHasTexCoords_BuilderFlag = 1 << 0,
|
|
|
|
kHasColors_BuilderFlag = 1 << 1,
|
2017-03-14 16:04:16 +00:00
|
|
|
};
|
|
|
|
class Builder {
|
|
|
|
public:
|
2017-04-03 15:11:09 +00:00
|
|
|
Builder(VertexMode mode, int vertexCount, int indexCount, uint32_t flags);
|
2020-03-06 17:52:52 +00:00
|
|
|
|
2017-03-16 18:38:48 +00:00
|
|
|
bool isValid() const { return fVertices != nullptr; }
|
2017-03-14 16:04:16 +00:00
|
|
|
|
2017-03-16 18:38:48 +00:00
|
|
|
SkPoint* positions();
|
2020-03-05 18:01:00 +00:00
|
|
|
uint16_t* indices(); // returns null if there are no indices
|
|
|
|
|
2020-03-30 13:57:53 +00:00
|
|
|
// If we have custom attributes, these will always be null
|
2018-06-29 18:32:21 +00:00
|
|
|
SkPoint* texCoords(); // returns null if there are no texCoords
|
|
|
|
SkColor* colors(); // returns null if there are no colors
|
2017-03-14 16:04:16 +00:00
|
|
|
|
2017-03-16 18:38:48 +00:00
|
|
|
// Detach the built vertices object. After the first call, this will always return null.
|
2017-03-14 16:04:16 +00:00
|
|
|
sk_sp<SkVertices> detach();
|
|
|
|
|
|
|
|
private:
|
2020-03-04 14:48:08 +00:00
|
|
|
Builder(const Desc&);
|
2017-03-16 18:38:48 +00:00
|
|
|
|
2020-03-04 14:48:08 +00:00
|
|
|
void init(const Desc&);
|
2017-03-16 18:38:48 +00:00
|
|
|
|
|
|
|
// holds a partially complete object. only completed in detach()
|
|
|
|
sk_sp<SkVertices> fVertices;
|
2018-04-28 20:13:08 +00:00
|
|
|
// Extra storage for intermediate vertices in the case where the client specifies indexed
|
|
|
|
// triangle fans. These get converted to indexed triangles when the Builder is finalized.
|
|
|
|
std::unique_ptr<uint8_t[]> fIntermediateFanIndices;
|
2017-03-16 18:38:48 +00:00
|
|
|
|
|
|
|
friend class SkVertices;
|
2020-06-01 20:33:28 +00:00
|
|
|
friend class SkVerticesPriv;
|
2017-03-14 16:04:16 +00:00
|
|
|
};
|
2017-02-06 14:41:10 +00:00
|
|
|
|
2017-03-16 18:38:48 +00:00
|
|
|
uint32_t uniqueID() const { return fUniqueID; }
|
|
|
|
const SkRect& bounds() const { return fBounds; }
|
|
|
|
|
|
|
|
// returns approximate byte size of the vertices object
|
|
|
|
size_t approximateSize() const;
|
2017-02-06 14:41:10 +00:00
|
|
|
|
2020-03-31 14:38:31 +00:00
|
|
|
// Provides access to functions that aren't part of the public API.
|
|
|
|
SkVerticesPriv priv();
|
2020-08-07 17:05:14 +00:00
|
|
|
const SkVerticesPriv priv() const; // NOLINT(readability-const-return-type)
|
2020-03-13 00:33:21 +00:00
|
|
|
|
2017-02-06 14:41:10 +00:00
|
|
|
private:
|
2017-03-14 16:04:16 +00:00
|
|
|
SkVertices() {}
|
2017-02-06 14:41:10 +00:00
|
|
|
|
2020-03-13 00:33:21 +00:00
|
|
|
friend class SkVerticesPriv;
|
|
|
|
|
2017-03-16 18:38:48 +00:00
|
|
|
// these are needed since we've manually sized our allocation (see Builder::init)
|
2018-10-30 15:23:00 +00:00
|
|
|
friend class SkNVRefCnt<SkVertices>;
|
2018-04-20 12:44:43 +00:00
|
|
|
void operator delete(void* p);
|
2017-03-16 18:38:48 +00:00
|
|
|
|
2020-03-04 14:48:08 +00:00
|
|
|
Sizes getSizes() const;
|
|
|
|
|
2017-03-16 18:38:48 +00:00
|
|
|
// we store this first, to pair with the refcnt in our base-class, so we don't have an
|
|
|
|
// unnecessary pad between it and the (possibly 8-byte aligned) ptrs.
|
2017-03-15 01:05:17 +00:00
|
|
|
uint32_t fUniqueID;
|
2017-03-16 18:38:48 +00:00
|
|
|
|
|
|
|
// these point inside our allocation, so none of these can be "freed"
|
2020-03-05 18:01:00 +00:00
|
|
|
SkPoint* fPositions; // [vertexCount]
|
|
|
|
uint16_t* fIndices; // [indexCount] or null
|
|
|
|
SkPoint* fTexs; // [vertexCount] or null
|
|
|
|
SkColor* fColors; // [vertexCount] or null
|
2017-03-16 18:38:48 +00:00
|
|
|
|
|
|
|
SkRect fBounds; // computed to be the union of the fPositions[]
|
2020-03-04 14:48:08 +00:00
|
|
|
int fVertexCount;
|
|
|
|
int fIndexCount;
|
2017-03-16 18:38:48 +00:00
|
|
|
|
2017-04-03 15:11:09 +00:00
|
|
|
VertexMode fMode;
|
2017-03-16 18:38:48 +00:00
|
|
|
// below here is where the actual array data is stored.
|
2017-02-06 14:41:10 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
#endif
|