#pragma once
#ifndef TCOLORSTYLES_H
#define TCOLORSTYLES_H
// TnzCore includes
#include "tfilepath.h"
#include "traster.h"
// Qt includes
#include <QString>
#undef DVAPI
#undef DVVAR
#ifdef TVRENDER_EXPORTS
#define DVAPI DV_EXPORT_API
#define DVVAR DV_EXPORT_VAR
#else
#define DVAPI DV_IMPORT_API
#define DVVAR DV_IMPORT_VAR
#endif
//=================================================
// Forward declarations
class TStroke;
class TRegion;
class TStrokeProp;
class TRegionProp;
class TVectorRenderData;
class TFlash;
class TInputStreamInterface;
class TOutputStreamInterface;
class TRasterStyleFx;
class QStringList;
//=================================================
//************************************************************************
// TRasterStyleFx definition
//************************************************************************
class DVAPI TRasterStyleFx {
public:
struct Params {
TRasterP m_r;
TPoint m_p;
TRasterP m_rOrig;
int m_colorIndex;
int m_frame;
public:
Params(const TRasterP &r, const TPoint &p, const TRasterP &rOrig, int index,
int frame)
: m_r(r), m_p(p), m_rOrig(rOrig), m_colorIndex(index), m_frame(frame) {
assert(m_r);
}
};
public:
virtual ~TRasterStyleFx() {}
virtual bool isInkStyle() const = 0;
virtual bool isPaintStyle() const = 0;
virtual bool inkFxNeedRGBMRaster() const { return false; }
virtual bool compute(const Params ¶ms) const = 0;
virtual void getEnlargement(int &borderIn, int &borderOut) const {
borderIn = borderOut = 0;
}
};
//************************************************************************
// TColorStyle definition
//************************************************************************
/*!
\brief Abstract class representing a color style in a Toonz palette.
*/
class DVAPI TColorStyle : public TSmartObject {
public:
//! Helper class to declare color styles
class Declaration {
public:
Declaration(TColorStyle *style) { declare(style); }
};
enum ParamType {
BOOL, //!< Boolean parameter type.
INT, //!< Integer parameter type.
ENUM, //!< Enum parameter type (maps to integer values).
DOUBLE, //!< Double parameter type (getParamType() default).
FILEPATH //!< TFilePath parameter type.
};
struct double_tag {};
struct bool_tag {};
struct int_tag {};
struct TFilePath_tag {};
private:
std::wstring m_name; //!< User-define style name.
std::wstring m_globalName; //!< User-define style \a global name.
std::wstring m_originalName; //!< If the style is copied from studio palette,
//! its original name is stored
int m_versionNumber; //!< Style's version number.
unsigned int m_flags; //!< Style attributes.
bool m_enabled; //!< Style's \a enabled status.
bool m_isEditedFromOriginal; //<! If the style is copied from studio palette,
// This flag will be set when the
//! style is edited from the original one.
protected:
TRaster32P m_icon; //!< Icon shown on TPalette viewers.
bool m_validIcon; //!< Icon's validity status.
public:
static int m_currentFrame; //!< Time instant in the palette's timeline.
//! \deprecated Should be done better
public:
TColorStyle();
TColorStyle(
const TColorStyle &other); //!< Copies another style \a except its icon
virtual ~TColorStyle();
virtual TColorStyle *clone() const = 0; //!< Polymorphic clone of the style.
virtual TColorStyle ©(
const TColorStyle &other) //!< Polymorphic copy of the style.
{
assignBlend(other, other, 0.0);
return *this;
}
bool operator==(const TColorStyle &cs) const;
bool operator!=(const TColorStyle &cs) { return !operator==(cs); }
// Renderizer-related objects
virtual TStrokeProp *makeStrokeProp(
const TStroke
*stroke) = 0; //!< Allocates a \a new derived TStrokeProp instance
//! used to draw the style on the specified stroke object.
virtual TRegionProp *makeRegionProp(
const TRegion
*region) = 0; //!< Allocates a \a new derived TRegionProp instance
//! used to draw the style on the specified region object.
virtual bool isRasterStyle() const {
return false;
} //!< Returns whether the style is of the raster kind.
virtual TRasterStyleFx *getRasterStyleFx() {
return 0;
} //!< If the style contains raster effects it must return it,
//! else returns 0.
virtual bool isRegionStyle()
const = 0; //!< Returns whether the style applies on regions.
virtual bool isStrokeStyle()
const = 0; //!< Returns whether the style applies on strokes.
// General functions
void setName(std::wstring name) {
m_name = name;
} //!< Sets the style's user-defined name.
std::wstring getName() const {
return m_name;
} //!< Returns the style's user-defined name.
/*! \detail
The \a global name contains information about palette id.
*/
void setGlobalName(std::wstring name) {
m_globalName = name;
} //!< Sets the global name of the style.
std::wstring getGlobalName() const {
return m_globalName;
} //!< Returns the global name of the style.
void setOriginalName(std::wstring name) {
m_originalName = name;
} //!< If the style is originally copied from studio palette, set this.
std::wstring getOriginalName() const {
return m_originalName;
} //!< Returns the original name of the style.
void setIsEditedFlag(bool edited) {
m_isEditedFromOriginal = edited;
} //<! If the style is copied from studio palette, This flag will be set when
// the
//! style is edited from the original one.
bool getIsEditedFlag() const {
return m_isEditedFromOriginal;
} //!< Returns whether the style is edited from the original from studio
//! palette
void assignNames(
const TColorStyle *src); //!< Copies the style names from src.
//! \sa tcolorflags.h
unsigned int getFlags() const { return m_flags; } //!< Sets color attributes.
void setFlags(unsigned int flags) {
m_flags = flags;
} //!< Returns color attributes.
// Color-related functions
/*! \detail
Raster or vector pattern image styles, for example, return false.
*/
virtual bool hasMainColor() const {
return false;
} //!< Returns whether the style has a reference \a main color.
virtual TPixel32 getMainColor() const {
return TPixel32::Black;
} //!< Returns the style's main color, or black if none.
virtual void setMainColor(const TPixel32 &color) {
} //!< Sets the main color, if it has one.
/*! \detail
For example a bubble styles has two colors.
By default it returns \p 1 if the style has only a main color else
returns \p 0 if the style has no color.
*/
virtual int getColorParamCount() const {
return hasMainColor() ? 1 : 0;
} //!< Returns the number of colors (if any) of the style.
/*! \detail
Returns the main color by default.
*/
virtual TPixel32 getColorParamValue(int index) const {
return getMainColor();
} //!< Returns the value of the color of index \e index.
virtual void setColorParamValue(int index, const TPixel32 &color) {
setMainColor(color);
} //!< Sets the \a index-th color value.
virtual TPixel32 getAverageColor() const {
return getMainColor();
} //!< Returns a color representing the average of all the style's colors
// Parameters-related functions
/*! \detail
For example: a the general cleanup style has two parameters, brightness and
contrast and
a black cleanup style has in addition a black and white threshold, therefore
4 parameters.
*/
virtual int getParamCount() const {
return 0;
} //!< Returns the number of parameters necessary
//! to describe the style.
virtual ParamType getParamType(int paramIdx) const {
assert(0 <= paramIdx && paramIdx < getParamCount());
return DOUBLE;
} //!< Returns the type of the specified parameter.
virtual void setParamValue(int index, bool value) {
assert(false);
} //!< Assigns a value to the specified \p bool parameter.
virtual bool getParamValue(bool_tag, int index) const {
assert(false);
return bool();
} //!< Retrieves the specified \p bool parameter value.
virtual void setParamValue(int index, int value) {
assert(false);
} //!< Assigns a value to the specified \p int parameter.
virtual int getParamValue(int_tag, int index) const {
assert(false);
return int();
} //!< Retrieves the specified \p int parameter value.
virtual void getParamRange(int index, int &min, int &max) const {
assert(false);
} //!< Retrieves the specified \p int parameter range.
virtual void getParamRange(int pIndex, QStringList &stringItems) const {
assert(false);
} //!< Returns a description of each supported enum or file
//! extension value in text form.
virtual void setParamValue(int index, double value) {
assert(false);
} //!< Assigns a value to the specified \p double parameter.
virtual double getParamValue(double_tag, int index) const {
assert(false);
return double();
} //!< Retrieves the specified \p double parameter value.
virtual void getParamRange(int index, double &min, double &max) const {
assert(false);
} //!< Retrieves the specified \p double parameter range.
virtual void setParamValue(int index, const TFilePath &fp) {
assert(false);
} //!< Assigns a value to the specified \p TFilePath parameter.
virtual TFilePath getParamValue(TFilePath_tag, int index) const {
assert(false);
return TFilePath();
} //!< Retrieves the specified \p TFilePath parameter value.
/*! \detail
This function is provided to animate a palette style. Given two <I>keyframe
styles</I> \p a and \p b, it calculates their linear interpolation at parameter
\p t and assigns the result to this style instance.
\param a Style value at parameter <TT>t = 0</TT>.
\param b Style value at parameter <TT>t = 1</TT>.
\param t Interpolation parameter.
*/
void assignBlend(const TColorStyle &a, const TColorStyle &b,
double t); //!< Assigns the linear interpolation between the
//! supplied styles.
// Description-related functions
/*! \detail
For example for a stroke style we have "Constant", "Chain", "Rope", "Tulle",
etc...
*/
virtual QString getDescription()
const = 0; //!< Return a brief description of the style.
virtual QString getParamNames(int index)
const; //!< Return the string that identifies the \a index-th parameter.
// Drawing-related functions
virtual void drawStroke(TFlash &flash, const TStroke *stroke)
const; //!< Draws the supplied stroke in flash.
// I/O-related functions
virtual int getTagId()
const = 0; //!< Returns an unique number representing the style.
virtual void getObsoleteTagIds(std::vector<int> &) const {}; //!< \deprecated
void save(TOutputStreamInterface &) const; //!< Calls the local
//! implementation of saveData()
//! passing it also the name and
//! the tagId of the style.
static TColorStyle *load(TInputStreamInterface &); //!< Loads the style from
//! disk. Calls the local
//! implementation of
//! loadData().
static TColorStyle *create(
int tagId); //!< Creates a new style with identifier equal to \a tagId.
static void declare(
TColorStyle *style); //!< Puts the style in the table of actual styles.
static void getAllTags(std::vector<int> &tags);
// Misc functions
/*! \detail
It is used when updates must be done after changes or creation of new styles.
*/
void invalidateIcon() {
m_validIcon = false;
} //!< Sets a flag that defines the style's icon validity.
virtual const TRaster32P &getIcon(
const TDimension &d); //!< Returns an image representing the style.
bool isEnabled() const {
return m_enabled;
} //!< Returns whether the style can be used.
void enable(bool on) {
m_enabled = on;
} //!< Sets the style's \a enabled status
int getVersionNumber() const {
return m_versionNumber;
} //!< Returns the version number of the style.
protected:
virtual void makeIcon(const TDimension &d);
virtual void loadData(TInputStreamInterface &) = 0;
virtual void saveData(TOutputStreamInterface &) const = 0;
virtual void loadData(int, TInputStreamInterface &) {
} //!< \deprecated Backward compatibility
void updateVersionNumber();
protected:
TColorStyle &operator=(
const TColorStyle &other); //!< Copies another style \a except its icon
};
//--------------------------------------------------------------------------
#ifdef _WIN32
template class DVAPI TSmartPointerT<TColorStyle>;
#endif
typedef TSmartPointerT<TColorStyle> TColorStyleP;
#endif // TCOLORSTYLES_H