#pragma once
#include "trastercm.h"
#include "texception.h"
#undef DVAPI
#undef DVVAR
#ifdef TROP_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 TPalette;
typedef TSmartPointerT<TPalette> TPaletteP;
extern "C" {
struct _RASTER;
}
//===============================================================
//********************************************************************************
// TRopException definition
//********************************************************************************
class DVAPI TRopException final : public TException {
std::string message;
public:
TRopException(const std::string &s) : message(s) {}
~TRopException() {}
TString getMessage() const override;
};
//********************************************************************************
// TRop namespace
//********************************************************************************
//! The TRop namespace provides various algorithms to operate with Toonz's
//! raster types
namespace TRop {
enum ResampleFilterType {
None,
//! triangle filter
Triangle,
//! Mitchell-Netravali filter
Mitchell,
//! cubic convolution, a = .5
Cubic5,
//! cubic convolution, a = .75
Cubic75,
//! cubic convolution, a = 1
Cubic1,
//! Hann window, rad = 2
Hann2,
//! Hann window, rad = 3
Hann3,
//! Hamming window, rad = 2
Hamming2,
//! Hamming window, rad = 3
Hamming3,
//! Lanczos window, rad = 2
Lanczos2,
//! Lanczos window, rad = 3
Lanczos3,
//! Gaussian convolution
Gauss,
//! 'Quick' filter
ClosestPixel,
//! 'Quick' filter
Bilinear,
HowMany
};
enum ColorMask { RChan = 0x1, GChan = 0x2, BChan = 0x4, MChan = 0x8 };
enum ErodilateMaskType { ED_rectangular, ED_circular };
//! Applies first order mappings to each of \b rin's channels.
/*! \note The input and output rasters must have the same size and pixel type.
Supports rout == rin. */
DVAPI void rgbmScale(TRasterP rout, TRasterP rin, const double *k,
const double *a, const int *out0, const int *out1);
DVAPI void rgbmScale(TRasterP rout, TRasterP rin, double kr, double kg,
double kb, double km, double ar = 0.0, double ag = 0.0,
double ab = 0.0, double am = 0.0);
/*! Transforms each input channel interval into the corresponding channel
interval,
cropping values if necessary.
Specified pointers are associated to int[5] arrays representing the 5-ple
(RGB, R, G, B, M) - where RGBM adjustment apply first. Then, Global apply
equally on RGB channels (but not on M).*/
/*! \note The input and output rasters must have the same size and pixel type.
Supports rout == rin. */
DVAPI void rgbmAdjust(TRasterP rout, TRasterP rin, const int *in0,
const int *in1, const int *out0, const int *out1);
//! Make a checkoboard in \b rout
/*! Two variables \b TPixel32 describe the checkboard color,
\b TDimension are checkboard dimension and \b TPoinD the position
\include checkBoard_ex.cpp*/
DVAPI void checkBoard(TRasterP rout, const TPixel32 &, const TPixel32 &,
const TDimensionD &, const TPointD &);
//! Make the image over of the \b up raster on the \b dn raster and put the
//! resulting raster in \b rout
/*! \include over_ex1.cpp*/
DVAPI void over(const TRasterP &out, const TRasterP &dn, const TRasterP &up);
//! Make the image over of the \b up raster on the \b out raster starting from
//! \b pos
DVAPI void over(const TRasterP &out, const TRasterP &up,
const TPoint &pos = TPoint());
//! Make the image over of the \b up raster on the \b out raster
DVAPI void over(const TRasterP &out, const TRasterP &up, const TAffine &aff,
ResampleFilterType filterType = Triangle);
//! Make the image over of the \b up raster on the \b out raster starting from
//! \b pos.
//! Position \b pos must be already transformed using \b aff.
DVAPI void over(const TRasterP &out, const TRasterP &up, const TPoint &pos,
const TAffine &aff, ResampleFilterType filterType = Triangle);
//! Make the image over of the \b up raster on the \b dn raster using a \b mask
//! and put the resulting raster in \b rout
DVAPI void over(const TRasterP &out, const TRasterP &dn, const TRasterP &up,
const TRasterGR8P &mask);
//! Make a coloring of \b rup with \b color and put the resulting raster in \b
//! rout
DVAPI void over(TRaster32P rout, const TRasterGR8P &rup, const TPixel32 &color);
DVAPI void over(TRasterP rout, const TRasterCM32P &rup, TPalette *palette,
const TPoint &point = TPoint(), const TAffine &aff = TAffine());
//! Apply the transformation \b aff to the raster \b in and put the resulting
//! raster in \b rout
/*!
It can be specified a resample filter type and a blur factor.
\include resample_ex.cpp
*/
DVAPI void resample(const TRasterP &out, const TRasterP &in, const TAffine &aff,
ResampleFilterType filterType = Triangle, double blur = 1.);
//! Like the over function, but only uses closest_pixel filter
DVAPI void quickPut(const TRasterP &out, const TRasterP &up, const TAffine &aff,
const TPixel32 &colorScale = TPixel::Black,
bool doPremultiply = false, bool whiteTransp = false,
bool firstColumn = false,
bool doRasterDarkenBlendedView = false);
//! Like the over function but up image must be cmapped.
/*! Only uses closest_pixel filter.
GlobalMatte is the opacity, used for onionskinning
*/
DVAPI void quickPut(const TRasterP &out, const TRasterCM32P &up,
const TPaletteP &plt, const TAffine &aff,
const TPixel32 &globalColorScale = TPixel::Black,
bool inksOnly = false);
// for trasparency check, ink check and paint check
class CmappedQuickputSettings {
public:
TPixel32 m_globalColorScale, m_transpCheckPaint, m_transpCheckBg,
m_transpCheckInk;
int m_inkIndex, m_paintIndex;
bool m_inksOnly, m_transparencyCheck, m_blackBgCheck;
CmappedQuickputSettings()
: m_globalColorScale(TPixel32::Black)
, m_inksOnly(false)
, m_transparencyCheck(false)
, m_blackBgCheck(false)
, m_inkIndex(-1)
, m_paintIndex(-1) {}
};
DVAPI void quickPut(const TRasterP &dn, const TRasterCM32P &upCM32,
const TPaletteP &plt, const TAffine &aff,
const CmappedQuickputSettings &settings);
DVAPI void quickResampleColorFilter(const TRasterP &dn, const TRasterP &up,
const TAffine &aff, const TPaletteP &plt,
UCHAR colorMask);
DVAPI void convolve_3_i(TRasterP rout, TRasterP rin, int dx, int dy,
double conv[]);
DVAPI void convolve_i(TRasterP rout, TRasterP rin, int dx, int dy,
double conv[], int radius);
DVAPI void fracmove(TRasterP rout, TRasterP rin, double dx, double dy);
//! Convert \b src raster in raster type \b dst
DVAPI void convert(TRasterP dst, const TRasterP &src);
//! Copy \b src in \b dst
DVAPI void copy(TRasterP dst, const TRasterP &src);
DVAPI void brush(TRaster32P ras, const TPoint &a, const TPoint &b, int radius,
const TPixel32 &color);
//! Get \b bbox of \b ras raster
DVAPI void computeBBox(TRasterP ras, TRect &bbox);
//! Add background of color \b col to the \b ras raster
DVAPI void addBackground(TRasterP ras, const TPixel32 &col);
//! Return true if \b ras is opaque
DVAPI bool isOpaque(TRasterP ras);
//! Invert \b ras color in according with \b invRed, \b invGreen, \b invBlue, \b
//! invMatte
DVAPI void invert(TRasterP ras, bool invRed = true, bool invGreen = true,
bool invBlue = true, bool invMatte = false);
//! Add \b rdown pixels to \b rup pixels in according with the factor \b v and
//! put the resulting raster in \b rout
DVAPI void add(const TRasterP &rup, const TRasterP &rdown, const TRasterP &rout,
double v);
//! Add \b rdown pixels to \b rup pixels and put the resulting raster in \b rout
DVAPI void add(const TRasterP &rup, const TRasterP &rdown,
const TRasterP &rout);
DVAPI void colordodge(const TRasterP &rup, const TRasterP &rdown,
const TRasterP &rout);
DVAPI void colorburn(const TRasterP &rup, const TRasterP &rdown,
const TRasterP &rout);
DVAPI void screen(const TRasterP &rup, const TRasterP &rdown,
const TRasterP &rout);
//! Subtract \b rdown pixels to \b rup pixels and put the resulting raster in \b
//! rout
DVAPI void sub(const TRasterP &rup, const TRasterP &rdown, const TRasterP &rout,
bool matte);
DVAPI void mult(const TRasterP &rup, const TRasterP &rdown,
const TRasterP &rout, int v, bool matte); //[-255..+255]
DVAPI void ropin(const TRasterP &source, const TRasterP &matte,
const TRasterP &rout);
DVAPI void ropout(const TRasterP &source, const TRasterP &matte,
const TRasterP &rout);
DVAPI void atop(const TRasterP &rup, const TRasterP &rdown,
const TRasterP &rout);
DVAPI void txor(const TRasterP &rup, const TRasterP &rdown,
const TRasterP &rout);
DVAPI void crossDissolve(const TRasterP &rup, const TRasterP &rdown,
const TRasterP &rout, UCHAR v); //[0..255]
DVAPI void lighten(const TRasterP &rup, const TRasterP &rdown,
const TRasterP &rout);
DVAPI void darken(const TRasterP &rup, const TRasterP &rdown,
const TRasterP &rout);
DVAPI void ropmin(const TRasterP &rup, const TRasterP &rdown,
const TRasterP &rout, bool matte);
DVAPI void ropmax(const TRasterP &rup, const TRasterP &rdown,
const TRasterP &rout);
DVAPI void linearburn(const TRasterP &rup, const TRasterP &rdown,
const TRasterP &rout);
DVAPI void overlay(const TRasterP &rup, const TRasterP &rdown,
const TRasterP &rout);
//! Make a premultiply of all raster pixels
DVAPI void premultiply(const TRasterP &ras);
//! Make a depremultiply of all raster pixels
DVAPI void depremultiply(const TRasterP &ras);
// called from meshtexturizer in order to remove unwanted black contour
// appears at the border of the plastic-deformed texture.
// this function will "expand" color channels of the border pixels to
// neighbor full-transparent pixels.
// by doing this the linear interpolation at the border pixels will not
// decay color info and can get ideal antialiased result
DVAPI void expandColor(const TRaster32P &ras32, bool precise);
//! all white pixels are set to transparent
DVAPI void whiteTransp(const TRasterP &ras);
//! apply color filter and semi-transparency of column to the render result
// implemented in toperators.cpp
DVAPI void applyColorScale(const TRasterP &ras, const TPixel32 &colorScale);
DVAPI TRasterP shrink(TRasterP rin, int shrink);
//! Make a \b gamma correct in the \b raster
DVAPI void gammaCorrect(TRasterP raster, double gamma);
//! Make a \b gamma correct in the \b raster
DVAPI void gammaCorrectRGBM(TRasterP raster, double gammar, double gammag,
double gammab, double gammam);
//! Return the pixel size of the \b blur border
DVAPI int getBlurBorder(double blur);
//! Inserts antialias around jaggy lines. Threshold is a pixel distance intended
//! from 0 to 256.
//! Softness may vary from 0 to 100.
DVAPI void antialias(const TRasterP &src, const TRasterP &dst, int threshold,
int softness);
//! Performs despeckling by replacing the color of small uniform areas (those
//! enclosable in a
//! square of specified edge length) with that most occurring along the area
//! border.
DVAPI void majorityDespeckle(const TRasterP &ras, int sizeThreshold);
//! Make blur effect on \b srcRas raster and put the result in \b dstRas.
DVAPI void blur(const TRasterP &dstRas, const TRasterP &srcRas, double blur,
int dx, int dy, bool useSSE = false);
struct RaylitParams {
TPixel m_color;
T3DPoint m_lightOriginSrc;
T3DPoint m_lightOriginDst;
double m_smoothness;
double m_decay;
double m_intensity;
double m_scale;
bool m_invert;
bool m_includeInput;
};
//! Make raylit effect on \b srcRas raster and put the result in \b dstRas.
DVAPI void raylit(const TRasterP &dstRas, const TRasterP &srcRas,
const RaylitParams ¶ms);
DVAPI void glassRaylit(const TRasterP &dstRas, const TRasterP &srcRas,
const RaylitParams ¶ms);
DVAPI void despeckle(const TRasterP &ras, int sizeThreshold, bool check,
bool trasparentIsWhite = false);
DVAPI void despeckle(const TRasterP &rout, const TRasterP &rin,
int sizeThreshold, bool check);
//! Return a raster with r b channels swapped
DVAPI TRaster32P copyAndSwapRBChannels(const TRaster32P &srcRaster);
// result in 'left'
DVAPI void makeStereoRaster(const TRasterP &left, const TRasterP &right);
DVAPI void setChannel(const TRasterP &rin, TRasterP rout, UCHAR chan,
bool greytones);
/*!
Applies classical morphological erosion/dilation to the specified input
raster.
\note Supports rin == rout.
*/
DVAPI void erodilate(const TRasterP &rin, const TRasterP &rout, double radius,
ErodilateMaskType type);
#ifdef TNZ_MACHINE_CHANNEL_ORDER_MRGB
DVAPI void swapRBChannels(const TRaster32P &r);
#endif
///////////////////////////////////////
// Utilities for Toonz 4.6 porting //
///////////////////////////////////////
//! Convert TRasterP in an old toonz raster!
/*! Use the same buffer, not creates a new raster (the palette is new instead!)
*/
DVAPI _RASTER *convertRaster50to46(const TRasterP &inRas,
const TPaletteP &inPalette);
//! Release the old toonz raster.
/*! If the \b doReleaseBuffer is true, the buffer is released
(the palette is always deleted!)
*/
DVAPI void releaseRaster46(_RASTER *&r, bool doReleaseBuffer = false);
//! Read an image in the path \b filename and put it in an old toonz raster
DVAPI _RASTER *readRaster46(const char *filename);
//! Retrieves the input raster from Toonz internal cache. Need to call it before
//! using the raster.
DVAPI void lockRaster(_RASTER *raster);
//! Surrenders the input raster's buffer to the cache. Should be called before
//! inactivity periods.
DVAPI void unlockRaster(_RASTER *raster);
} // TRop namespace