blob: b493252fd6cb5eb2b2661c82d82d69bf4f09b1bd [file] [log] [blame]
* Copyright 2006 The Android Open Source Project
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
#ifndef SkMetaData_DEFINED
#define SkMetaData_DEFINED
#include "include/core/SkScalar.h"
/** A map from c-string keys to arrays of POD (int32_t, kScalar, void*, or bool)
class SkMetaData {
SkMetaData() {}
~SkMetaData() { if (fRec) { this->reset(); } }
void reset();
bool findS32(const char name[], int32_t* value = nullptr) const;
bool findScalar(const char name[], SkScalar* value = nullptr) const;
const SkScalar* findScalars(const char name[], int* count,
SkScalar values[] = nullptr) const;
bool findPtr(const char name[], void** value = nullptr) const;
bool findBool(const char name[], bool* value = nullptr) const;
bool hasS32(const char name[], int32_t value) const {
int32_t v;
return this->findS32(name, &v) && v == value;
bool hasScalar(const char name[], SkScalar value) const {
SkScalar v;
return this->findScalar(name, &v) && v == value;
bool hasPtr(const char name[], void* value) const {
void* v;
return this->findPtr(name, &v) && v == value;
bool hasBool(const char name[], bool value) const {
bool v;
return this->findBool(name, &v) && v == value;
void setS32(const char name[], int32_t value);
void setScalar(const char name[], SkScalar value);
SkScalar* setScalars(const char name[], int count, const SkScalar values[] = nullptr);
void setPtr(const char name[], void* value);
void setBool(const char name[], bool value);
bool removeS32(const char name[]);
bool removeScalar(const char name[]);
bool removePtr(const char name[]);
bool removeBool(const char name[]);
enum Type {
struct Rec;
class Iter;
friend class Iter;
class Iter {
Iter() : fRec(nullptr) {}
Iter(const SkMetaData&);
/** Reset the iterator, so that calling next() will return the first
data element. This is done implicitly in the constructor.
void reset(const SkMetaData&);
/** Each time next is called, it returns the name of the next data element,
or null when there are no more elements. If non-null is returned, then the
element's type is returned (if not null), and the number of data values
is returned in count (if not null).
const char* next(Type*, int* count);
Rec* fRec;
struct Rec {
Rec* fNext;
uint16_t fDataCount; // number of elements
uint8_t fDataLen; // sizeof a single element
uint8_t fType;
const void* data() const { return (this + 1); }
void* data() { return (this + 1); }
const char* name() const { return (const char*)this->data() + fDataLen * fDataCount; }
char* name() { return (char*)this->data() + fDataLen * fDataCount; }
static Rec* Alloc(size_t);
static void Free(Rec*);
Rec* fRec = nullptr;
const Rec* find(const char name[], Type) const;
void* set(const char name[], const void* data, size_t len, Type, int count);
bool remove(const char name[], Type);
SkMetaData(const SkMetaData&) = delete;
SkMetaData& operator=(const SkMetaData&) = delete;
struct FindResult {
SkMetaData::Rec* rec;
SkMetaData::Rec* prev;
FindResult findWithPrev(const char name[], Type type) const;
void remove(FindResult);